Tool tree
gradeNot graded
get_intent_stateAnswer
Inspect the current Intent Contract (goal, non-negotiable constraints, flexible preferences), active proposals, conflicts, human decisions, and the agreed plan. Call this before acting and after any human decision to adapt.
View tool JSON
{
"name": "get_intent_state",
"kind": "answer",
"impl": "imperative",
"description": "Inspect the current Intent Contract (goal, non-negotiable constraints, flexible preferences), active proposals, conflicts, human decisions, and the agreed plan. Call this before acting and after any human decision to adapt.",
"inputSchema": {
"type": "object",
"properties": {}
}
}create_intent_contractAction
Create or extend the human's visible Intent Contract with a goal, non-negotiable constraints, flexible preferences, and actions that require human approval. Use when the human asks to set up or adjust the overall intent agreement.
View tool JSON
{
"name": "create_intent_contract",
"kind": "act",
"impl": "imperative",
"description": "Create or extend the human's visible Intent Contract with a goal, non-negotiable constraints, flexible preferences, and actions that require human approval. Use when the human asks to set up or adjust the overall intent agreement.",
"inputSchema": {
"type": "object",
"properties": {
"goal": {
"type": "string",
"description": "What the human wants to achieve, in one sentence."
},
"constraints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Non-negotiable rules the agent must never violate."
},
"preferences": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"label",
"value"
]
},
"description": "Flexible preferences the agent may decide within."
},
"approvalRequiredActions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Keywords of actions that always require explicit human approval (e.g. \"publish\")."
}
},
"required": [
"goal"
]
}
}add_constraintAction
Add one new non-negotiable constraint to the Intent Contract (e.g. "Do not use fabricated customer testimonials."). It appears in the UI immediately and is enforced on all future proposals.
View tool JSON
{
"name": "add_constraint",
"kind": "act",
"impl": "imperative",
"description": "Add one new non-negotiable constraint to the Intent Contract (e.g. \"Do not use fabricated customer testimonials.\"). It appears in the UI immediately and is enforced on all future proposals.",
"inputSchema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The constraint, phrased as a prohibition or rule."
},
"category": {
"type": "string",
"enum": [
"budget",
"authenticity",
"legal",
"process",
"audience",
"custom"
],
"description": "What kind of constraint this is. Use \"custom\" if unsure."
}
},
"required": [
"text"
]
}
}propose_actionAction
Propose an action before taking it (e.g. "Add customer testimonials" / "Publish the website"). IntentOS evaluates it against the Intent Contract and returns SAFE, REQUIRES_APPROVAL, or CONFLICT. On CONFLICT, never proceed: the human must decide, and you must adapt.
View tool JSON
{
"name": "propose_action",
"kind": "act",
"impl": "imperative",
"description": "Propose an action before taking it (e.g. \"Add customer testimonials\" / \"Publish the website\"). IntentOS evaluates it against the Intent Contract and returns SAFE, REQUIRES_APPROVAL, or CONFLICT. On CONFLICT, never proceed: the human must decide, and you must adapt.",
"inputSchema": {
"type": "object",
"properties": {
"action": {
"type": "string",
"description": "The concrete action you want to take."
},
"reason": {
"type": "string",
"description": "Why this action helps the goal."
}
},
"required": [
"action",
"reason"
]
}
}resolve_intent_conflictAction
Get the human's authoritative decision on a conflicted or gated proposal (approved / rejected / constraint_modified). The human decides in the IntentOS UI; this tool reports that decision back to you in structured form. Call it after proposing an action that returned CONFLICT or REQUIRES_APPROVAL.
View tool JSON
{
"name": "resolve_intent_conflict",
"kind": "act",
"impl": "imperative",
"description": "Get the human's authoritative decision on a conflicted or gated proposal (approved / rejected / constraint_modified). The human decides in the IntentOS UI; this tool reports that decision back to you in structured form. Call it after proposing an action that returned CONFLICT or REQUIRES_APPROVAL.",
"inputSchema": {
"type": "object",
"properties": {
"proposalId": {
"type": "string",
"description": "The proposalId returned by propose_action. Omit to use the latest conflict."
},
"note": {
"type": "string",
"description": "Optional context from the agent."
}
}
}
}update_intent_contractAction
Propose updates to the Intent Contract. Flexible preferences (and the goal) are applied immediately. Changes to NON-NEGOTIABLE constraints always require explicit human confirmation — they become pending requests in the human's Approval Queue until accepted.
View tool JSON
{
"name": "update_intent_contract",
"kind": "act",
"impl": "imperative",
"description": "Propose updates to the Intent Contract. Flexible preferences (and the goal) are applied immediately. Changes to NON-NEGOTIABLE constraints always require explicit human confirmation — they become pending requests in the human's Approval Queue until accepted.",
"inputSchema": {
"type": "object",
"properties": {
"goal": {
"type": "string",
"description": "Replacement goal, if the human asked to change it."
},
"preferences": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Existing preference id to update, if known."
},
"label": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"label",
"value"
]
}
},
"addConstraints": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"category": {
"type": "string",
"enum": [
"budget",
"authenticity",
"legal",
"process",
"audience",
"custom"
]
}
},
"required": [
"text"
]
}
},
"editConstraints": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Existing constraint id (see get_intent_state)."
},
"text": {
"type": "string",
"description": "The new constraint text."
}
},
"required": [
"id",
"text"
]
}
},
"removeConstraintIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Ids of constraints to remove (requires human confirmation)."
}
}
}
}