Tool tree
Publish your idea once. Explain Him helps each person's AI agent explain it at the right depth without changing the original.
Implementation
gradeNot graded
gradeNot graded
explain_toolAction
Call this directly for every request to explain, clarify, ask why or how, compare, show, or walk through page-related content unless the user explicitly forbids page changes or scrolling. The tool inspects the current page state during the action: focus an existing correct explanation, or add, update, replace, or restore a safe browser-local explanation. Mutations automatically focus the visible result. Authored focus targets: flow-model, personal-agent, workflow-diagram, action-originator, action-user, action-agent-read, action-agent-answer, action-agent-adapt, action-original-safe, question-loop, grounding-contract, browser-workspace. Mutable targets: flow-model, personal-agent, workflow-diagram, question-loop, grounding-contract, browser-workspace.
View tool JSON
{
"name": "explain_tool",
"kind": "act",
"impl": "imperative",
"description": "Call this directly for every request to explain, clarify, ask why or how, compare, show, or walk through page-related content unless the user explicitly forbids page changes or scrolling. The tool inspects the current page state during the action: focus an existing correct explanation, or add, update, replace, or restore a safe browser-local explanation. Mutations automatically focus the visible result. Authored focus targets: flow-model, personal-agent, workflow-diagram, action-originator, action-user, action-agent-read, action-agent-answer, action-agent-adapt, action-original-safe, question-loop, grounding-contract, browser-workspace. Mutable targets: flow-model, personal-agent, workflow-diagram, question-loop, grounding-contract, browser-workspace.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"required": [
"requestId",
"topicId",
"decision",
"operations"
],
"properties": {
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"topicId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^[A-Za-z][A-Za-z0-9._:-]*$"
},
"decision": {
"enum": [
"existing",
"missing",
"partial",
"inconsistent",
"restore"
]
},
"primaryOperationIndex": {
"type": "integer",
"minimum": 0,
"maximum": 7
},
"operations": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"op",
"targetId",
"block"
],
"properties": {
"op": {
"const": "add"
},
"targetId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"blockId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^local-[A-Za-z0-9._:-]+$"
},
"block": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"body"
],
"properties": {
"type": {
"const": "callout"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"tone": {
"enum": [
"neutral",
"example",
"warning",
"insight"
]
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"columns"
],
"properties": {
"type": {
"const": "comparison"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"columns": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title",
"items"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"steps"
],
"properties": {
"type": {
"const": "workflow"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"steps": {
"type": "array",
"minItems": 2,
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"items"
],
"properties": {
"type": {
"const": "timeline"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"items": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"label",
"body"
],
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"nodes"
],
"properties": {
"type": {
"const": "diagram"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"variant": {
"enum": [
"concept",
"architecture",
"sequence",
"flow"
]
},
"nodes": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 140
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 600
}
}
}
},
"edges": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"from",
"to"
],
"properties": {
"from": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"to": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
}
]
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"op",
"targetId",
"block"
],
"properties": {
"op": {
"const": "replace"
},
"targetId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"blockId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^local-[A-Za-z0-9._:-]+$"
},
"block": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"body"
],
"properties": {
"type": {
"const": "callout"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"tone": {
"enum": [
"neutral",
"example",
"warning",
"insight"
]
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"columns"
],
"properties": {
"type": {
"const": "comparison"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"columns": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title",
"items"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"steps"
],
"properties": {
"type": {
"const": "workflow"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"steps": {
"type": "array",
"minItems": 2,
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"items"
],
"properties": {
"type": {
"const": "timeline"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"items": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"label",
"body"
],
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"nodes"
],
"properties": {
"type": {
"const": "diagram"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"variant": {
"enum": [
"concept",
"architecture",
"sequence",
"flow"
]
},
"nodes": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 140
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 600
}
}
}
},
"edges": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"from",
"to"
],
"properties": {
"from": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"to": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
}
]
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"op",
"blockId",
"block"
],
"properties": {
"op": {
"const": "update"
},
"blockId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^local-[A-Za-z0-9._:-]+$"
},
"block": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"body"
],
"properties": {
"type": {
"const": "callout"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"tone": {
"enum": [
"neutral",
"example",
"warning",
"insight"
]
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"columns"
],
"properties": {
"type": {
"const": "comparison"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"columns": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title",
"items"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"steps"
],
"properties": {
"type": {
"const": "workflow"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"steps": {
"type": "array",
"minItems": 2,
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"items"
],
"properties": {
"type": {
"const": "timeline"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"items": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"label",
"body"
],
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 800
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"type",
"title",
"nodes"
],
"properties": {
"type": {
"const": "diagram"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"variant": {
"enum": [
"concept",
"architecture",
"sequence",
"flow"
]
},
"nodes": {
"type": "array",
"minItems": 2,
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 140
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 600
}
}
}
},
"edges": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"from",
"to"
],
"properties": {
"from": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"to": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
}
},
"sources": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path"
],
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"section": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
}
}
}
}
}
]
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"op",
"blockId"
],
"properties": {
"op": {
"const": "remove"
},
"blockId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^local-[A-Za-z0-9._:-]+$"
}
}
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"const": "focus"
},
"targetId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"blockId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^local-[A-Za-z0-9._:-]+$"
}
},
"oneOf": [
{
"required": [
"op",
"targetId"
]
},
{
"required": [
"op",
"blockId"
]
}
]
}
]
}
}
}
},
"page": "/explain-him/"
}