Tool tree
gradeNot graded
desktop_get_contextAnswer
Read desktop apps, windows, selections, drafts and project IDs; use desktop_describe_tool for full usage before unfamiliar tools.
View tool JSON
{
"name": "desktop_get_context",
"kind": "answer",
"impl": "imperative",
"description": "Read desktop apps, windows, selections, drafts and project IDs; use desktop_describe_tool for full usage before unfamiliar tools.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}desktop_revealAction
Bring an app forward or open a file in its matching app.
View tool JSON
{
"name": "desktop_reveal",
"kind": "act",
"impl": "imperative",
"description": "Bring an app forward or open a file in its matching app.",
"inputSchema": {
"type": "object",
"properties": {
"target": {
"type": "string",
"enum": [
"home",
"inbox",
"shortcuts",
"studio",
"projects",
"finder",
"textedit",
"documents",
"sheets",
"preview",
"tasks",
"canvas",
"terminal",
"activity",
"calculator",
"wallpapers"
]
},
"path": {
"type": "string"
}
},
"additionalProperties": false
}
}home_navigateAction
Open Home Preferences, Toolbox or Workspace packs; select a skill by path.
View tool JSON
{
"name": "home_navigate",
"kind": "act",
"impl": "imperative",
"description": "Open Home Preferences, Toolbox or Workspace packs; select a skill by path.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"pane": {
"type": "string",
"enum": [
"preferences",
"toolbox",
"packs"
]
},
"skillPath": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}projects_navigateAction
Show project overview, Handoff, Work or Context and optionally a historical run.
View tool JSON
{
"name": "projects_navigate",
"kind": "act",
"impl": "imperative",
"description": "Show project overview, Handoff, Work or Context and optionally a historical run.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"view": {
"type": "string",
"enum": [
"overview",
"handoff",
"work",
"context"
]
},
"runId": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}tasks_navigateAction
Open a task list, select a task and set its visible status filter.
View tool JSON
{
"name": "tasks_navigate",
"kind": "act",
"impl": "imperative",
"description": "Open a task list, select a task and set its visible status filter.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"taskId": {
"type": "string",
"maxLength": 2048
},
"filter": {
"type": "string",
"enum": [
"all",
"todo",
"in-progress",
"done"
]
}
},
"additionalProperties": false
}
}inbox_navigateAction
Open an Inbox request and choose the visible request status filter.
View tool JSON
{
"name": "inbox_navigate",
"kind": "act",
"impl": "imperative",
"description": "Open an Inbox request and choose the visible request status filter.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"filter": {
"type": "string",
"enum": [
"all",
"new",
"filed",
"done"
]
}
},
"additionalProperties": false
}
}finder_navigateAction
Show a folder or file, search within the current folder, and select a visible result.
View tool JSON
{
"name": "finder_navigate",
"kind": "act",
"impl": "imperative",
"description": "Show a folder or file, search within the current folder, and select a visible result.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"query": {
"type": "string",
"maxLength": 500
},
"selectedPath": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}notepad_navigateAction
Open a note, choose formatted/markdown view (plain files stay plain), and optionally select source character offsets.
View tool JSON
{
"name": "notepad_navigate",
"kind": "act",
"impl": "imperative",
"description": "Open a note, choose formatted/markdown view (plain files stay plain), and optionally select source character offsets.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"mode": {
"type": "string",
"enum": [
"formatted",
"markdown",
"plain"
]
},
"sidebar": {
"type": "boolean"
},
"selection": {
"type": "object",
"properties": {
"start": {
"type": "integer",
"minimum": 0
},
"end": {
"type": "integer",
"minimum": 0
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
}preview_navigateAction
Set Preview zoom from 0.5 to 2 (1 fits the page) or show PDF text view.
View tool JSON
{
"name": "preview_navigate",
"kind": "act",
"impl": "imperative",
"description": "Set Preview zoom from 0.5 to 2 (1 fits the page) or show PDF text view.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"zoom": {
"type": "number",
"minimum": 0.5,
"maximum": 2
},
"textView": {
"type": "boolean"
}
},
"additionalProperties": false
}
}activity_navigateAction
Show Activity or Review; filter events or open a saved version or work summary by ID.
View tool JSON
{
"name": "activity_navigate",
"kind": "act",
"impl": "imperative",
"description": "Show Activity or Review; filter events or open a saved version or work summary by ID.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"enum": [
"activity",
"review"
]
},
"filter": {
"type": "string",
"enum": [
"all",
"human",
"agent",
"terminal",
"system",
"terminal-events"
]
},
"versionId": {
"type": "string",
"maxLength": 2048
},
"sessionId": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}desktop_windowAction
Close, minimize, maximize, restore or move an open app window.
View tool JSON
{
"name": "desktop_window",
"kind": "act",
"impl": "imperative",
"description": "Close, minimize, maximize, restore or move an open app window.",
"inputSchema": {
"type": "object",
"properties": {
"target": {
"type": "string",
"enum": [
"home",
"projects",
"inbox",
"finder",
"shortcuts",
"textedit",
"documents",
"sheets",
"preview",
"tasks",
"canvas",
"studio",
"terminal",
"activity",
"calculator",
"wallpapers"
]
},
"action": {
"type": "string",
"enum": [
"close",
"minimize",
"maximize",
"restore",
"move"
]
},
"x": {
"type": "integer",
"minimum": 0
},
"y": {
"type": "integer",
"minimum": 0
}
},
"required": [
"target",
"action"
],
"additionalProperties": false
}
}canvas_selectAction
Select object IDs in a Canvas and optionally fit them in view.
View tool JSON
{
"name": "canvas_select",
"kind": "act",
"impl": "imperative",
"description": "Select object IDs in a Canvas and optionally fit them in view.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 2000
},
"fit": {
"type": "boolean"
}
},
"required": [
"ids"
],
"additionalProperties": false
}
}calculator_readAnswer
Read the shared Calculator display, precise numeric value, pending operation and repeat state.
View tool JSON
{
"name": "calculator_read",
"kind": "answer",
"impl": "imperative",
"description": "Read the shared Calculator display, precise numeric value, pending operation and repeat state.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}calculator_calculateAction
Calculate from the displayed number or explicit value; binary operations require operand. Updates the visible Calculator.
View tool JSON
{
"name": "calculator_calculate",
"kind": "act",
"impl": "imperative",
"description": "Calculate from the displayed number or explicit value; binary operations require operand. Updates the visible Calculator.",
"inputSchema": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"enum": [
"set",
"clear",
"sign",
"percent",
"equals",
"add",
"subtract",
"multiply",
"divide"
]
},
"value": {
"type": "number"
},
"operand": {
"type": "number"
}
},
"required": [
"operation"
],
"additionalProperties": false
}
}wallpapers_readAction
List available wallpaper IDs and read the selected wallpaper, theme matching, color scheme and reduced-motion preference.
View tool JSON
{
"name": "wallpapers_read",
"kind": "act",
"impl": "imperative",
"description": "List available wallpaper IDs and read the selected wallpaper, theme matching, color scheme and reduced-motion preference.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}wallpapers_setAction
Change wallpaper, theme matching, color scheme or reduced motion.
View tool JSON
{
"name": "wallpapers_set",
"kind": "act",
"impl": "imperative",
"description": "Change wallpaper, theme matching, color scheme or reduced motion.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"enum": [
"ventura",
"monterey",
"big-sur-graphic",
"big-sur",
"catalina",
"mojave",
"desert",
"dome",
"peak",
"iridescence",
"lake",
"solar-grad",
"kryptonian-demise",
"nahargarh-sunset",
"somber-forest",
"blade-runner-2149",
"lone-dune-wolf",
"childhood-innocence",
"fox-in-somber-forest",
"blood-diamond",
"black-bird-in-a-city",
"sunrise-of-dreams",
"how-do-we-get-down",
"cozy-night-with-cat",
"age-of-titans",
"dune",
"vibrant-night",
"cabin-in-woods",
"asgardian-sunrise",
"asura-lok",
"my-neighbour-totoro",
"tron",
"leopard",
"retro-90s",
"lost-lands",
"flower-field",
"cherry-blossoms",
"indian-gardens",
"along-the-ganges"
]
},
"matchTheme": {
"type": "boolean"
},
"theme": {
"type": "string",
"enum": [
"light",
"dark"
]
},
"reducedMotion": {
"type": "boolean"
}
},
"additionalProperties": false
}
}files_downloadAction
Request a browser download of a saved workspace file, preserving original bytes and filename.
View tool JSON
{
"name": "files_download",
"kind": "act",
"impl": "imperative",
"description": "Request a browser download of a saved workspace file, preserving original bytes and filename.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
}
},
"required": [
"path"
],
"additionalProperties": false
}
}home_get_contextAnswer
Read /Home/profile.json, revision, briefText, link warnings, 20 skill summaries and omittedSkills count.
View tool JSON
{
"name": "home_get_context",
"kind": "answer",
"impl": "imperative",
"description": "Read /Home/profile.json, revision, briefText, link warnings, 20 skill summaries and omittedSkills count.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}home_save_preferencesAction
Replace /Home/profile.json with user-requested preferences at home_get_context revision; null creates.
View tool JSON
{
"name": "home_save_preferences",
"kind": "act",
"impl": "imperative",
"description": "Replace /Home/profile.json with user-requested preferences at home_get_context revision; null creates.",
"inputSchema": {
"type": "object",
"required": [
"preferences",
"expectedRevision"
],
"additionalProperties": false,
"properties": {
"expectedRevision": {
"type": [
"string",
"null"
],
"pattern": "^sha256:[a-f0-9]{64}$"
},
"preferences": {
"type": "object",
"additionalProperties": false,
"required": [
"displayName",
"instructions",
"language",
"timeZone",
"outputFolder",
"referencePaths",
"preferredSkillPaths"
],
"properties": {
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"instructions": {
"type": "string",
"maxLength": 12000
},
"language": {
"type": "string",
"maxLength": 100
},
"timeZone": {
"type": "string",
"maxLength": 100
},
"outputFolder": {
"$ref": "#/$defs/s0"
},
"referencePaths": {
"$ref": "#/$defs/s1"
},
"preferredSkillPaths": {
"$ref": "#/$defs/s1"
}
}
}
},
"$defs": {
"s0": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"s1": {
"type": "array",
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2048
}
}
}
}
}home_list_skillsAction
List 100 SKILL.md names/descriptions under /Home/Skills, with malformed-file warnings.
View tool JSON
{
"name": "home_list_skills",
"kind": "act",
"impl": "imperative",
"description": "List 100 SKILL.md names/descriptions under /Home/Skills, with malformed-file warnings.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}home_read_skillAction
Read /Home/Skills/<name>/SKILL.md and revision.
View tool JSON
{
"name": "home_read_skill",
"kind": "act",
"impl": "imperative",
"description": "Read /Home/Skills/<name>/SKILL.md and revision.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}home_save_skillAction
Save /Home/Skills/<name>/SKILL.md instructions/frontmatter/links for Toolbox and Files.
View tool JSON
{
"name": "home_save_skill",
"kind": "act",
"impl": "imperative",
"description": "Save /Home/Skills/<name>/SKILL.md instructions/frontmatter/links for Toolbox and Files.",
"inputSchema": {
"type": "object",
"required": [
"name",
"description",
"instructions",
"expectedRevision"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"instructions": {
"type": "string",
"minLength": 1,
"maxLength": 40000
},
"expectedRevision": {
"type": [
"string",
"null"
],
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
}inbox_listAction
List 200 Inbox requests max, new first, with attachments, projects, warnings/truncation.
View tool JSON
{
"name": "inbox_list",
"kind": "act",
"impl": "imperative",
"description": "List 200 Inbox requests max, new first, with attachments, projects, warnings/truncation.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}inbox_readAction
Read request/revision, inputs, bookmark, project/output existence.
View tool JSON
{
"name": "inbox_read",
"kind": "act",
"impl": "imperative",
"description": "Read request/revision, inputs, bookmark, project/output existence.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}inbox_createAction
Save/open a new Inbox request with notes, unfetched bookmark, and 20 files max.
View tool JSON
{
"name": "inbox_create",
"kind": "act",
"impl": "imperative",
"description": "Save/open a new Inbox request with notes, unfetched bookmark, and 20 files max.",
"inputSchema": {
"type": "object",
"required": [
"title",
"request"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"request": {
"type": "string",
"minLength": 1,
"maxLength": 6000
},
"projectPath": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"note": {
"type": "string",
"maxLength": 100000
},
"sourceUrl": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"files": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"required": [
"name",
"content",
"encoding"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"content": {
"type": "string",
"maxLength": 13333336
},
"encoding": {
"type": "string",
"enum": [
"utf8",
"base64"
]
}
}
}
}
},
"additionalProperties": false
}
}inbox_updateAction
Update/open at current revision; arrays replace.
View tool JSON
{
"name": "inbox_update",
"kind": "act",
"impl": "imperative",
"description": "Update/open at current revision; arrays replace.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"changes"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"changes": {
"type": "object",
"minProperties": 1,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"request": {
"type": "string",
"minLength": 1,
"maxLength": 6000
},
"state": {
"type": "string",
"enum": [
"new",
"filed",
"done"
]
},
"projectPath": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"outputPaths": {
"type": "array",
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
}shortcuts_listAction
List up to 100 shortcuts, input counts, and malformed-file warnings.
View tool JSON
{
"name": "shortcuts_list",
"kind": "act",
"impl": "imperative",
"description": "List up to 100 shortcuts, input counts, and malformed-file warnings.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}shortcuts_readAnswer
Read procedure guidance, inputs, outputs, source existence, and revision for update/prepare.
View tool JSON
{
"name": "shortcuts_read",
"kind": "answer",
"impl": "imperative",
"description": "Read procedure guidance, inputs, outputs, source existence, and revision for update/prepare.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}shortcuts_createAction
Save/open a new .shortcut.json procedure, inputs, existing templates, and outputs.
View tool JSON
{
"name": "shortcuts_create",
"kind": "act",
"impl": "imperative",
"description": "Save/open a new .shortcut.json procedure, inputs, existing templates, and outputs.",
"inputSchema": {
"type": "object",
"required": [
"path",
"title",
"procedure",
"outputGuidance"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"description": {
"type": "string",
"maxLength": 1000
},
"procedure": {
"type": "string",
"minLength": 1,
"maxLength": 16000
},
"requiredInputs": {
"type": "array",
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"sourcePaths": {
"type": "array",
"maxItems": 30,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
},
"outputGuidance": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"additionalProperties": false
}
}shortcuts_updateAction
Update at current revision; arrays replace.
View tool JSON
{
"name": "shortcuts_update",
"kind": "act",
"impl": "imperative",
"description": "Update at current revision; arrays replace.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"changes"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"changes": {
"type": "object",
"minProperties": 1,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"description": {
"type": "string",
"maxLength": 1000
},
"procedure": {
"type": "string",
"minLength": 1,
"maxLength": 16000
},
"requiredInputs": {
"type": "array",
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"sourcePaths": {
"type": "array",
"maxItems": 30,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
},
"outputGuidance": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
}shortcuts_prepareAction
Save a Markdown procedure/input/Home snapshot and linked paused run with pending steps.
View tool JSON
{
"name": "shortcuts_prepare",
"kind": "act",
"impl": "imperative",
"description": "Save a Markdown procedure/input/Home snapshot and linked paused run with pending steps.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"projectPath",
"workOrderPath"
],
"additionalProperties": false,
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"projectPath": {
"type": "string",
"maxLength": 2048
},
"projectRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"newProject": {
"type": "object",
"required": [
"title",
"objective"
],
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"context": {
"type": "string",
"maxLength": 12000
}
}
},
"inputPaths": {
"type": "array",
"maxItems": 40,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
},
"inputText": {
"type": "string",
"maxLength": 12000
},
"workOrderPath": {
"type": "string",
"maxLength": 2048
}
}
}
}studio_queryAction
Open an explorer and read/change its live search, exact filter, or cards/table view.
View tool JSON
{
"name": "studio_query",
"kind": "act",
"impl": "imperative",
"description": "Open an explorer and read/change its live search, exact filter, or cards/table view.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"query": {
"type": "string",
"maxLength": 1000
},
"filter": {
"type": [
"string",
"null"
],
"maxLength": 12000
},
"view": {
"enum": [
"cards",
"table"
]
},
"reload": {
"type": "boolean"
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 1000
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
}
}studio_listAction
List 100 .app.json explorers max and malformed-manifest warnings.
View tool JSON
{
"name": "studio_list",
"kind": "act",
"impl": "imperative",
"description": "List 100 .app.json explorers max and malformed-manifest warnings.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}studio_readAction
Read named/last manifest, revision, sources, data count/revision, and data errors.
View tool JSON
{
"name": "studio_read",
"kind": "act",
"impl": "imperative",
"description": "Read named/last manifest, revision, sources, data count/revision, and data errors.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}studio_createAction
Create/open a .app.json explorer with selected JSON fields/sources and search/filter/views/source opening.
View tool JSON
{
"name": "studio_create",
"kind": "act",
"impl": "imperative",
"description": "Create/open a .app.json explorer with selected JSON fields/sources and search/filter/views/source opening.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"description": {
"type": "string",
"maxLength": 2000
},
"view": {
"type": "string",
"enum": [
"cards",
"table"
]
},
"dataPath": {
"type": "string",
"maxLength": 2048
},
"columns": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"type": "object",
"properties": {
"key": {
"$ref": "#/$defs/s0"
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
}
},
"titleField": {
"$ref": "#/$defs/s0"
},
"filterField": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"sourceField": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"sourcePaths": {
"type": "array",
"maxItems": 100,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
}
},
"required": [
"path",
"title",
"description",
"view",
"dataPath",
"columns",
"titleField",
"filterField",
"sourceField",
"sourcePaths"
],
"additionalProperties": false,
"$defs": {
"s0": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "^[a-zA-Z][a-zA-Z0-9_ -]*$"
}
}
}
}studio_updateAction
Revision-check and save explorer settings; arrays replace and drafts block updates.
View tool JSON
{
"name": "studio_update",
"kind": "act",
"impl": "imperative",
"description": "Revision-check and save explorer settings; arrays replace and drafts block updates.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"changes": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"description": {
"type": "string",
"maxLength": 2000
},
"view": {
"type": "string",
"enum": [
"cards",
"table"
]
},
"dataPath": {
"type": "string",
"maxLength": 2048
},
"columns": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"type": "object",
"properties": {
"key": {
"$ref": "#/$defs/s0"
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
}
},
"titleField": {
"$ref": "#/$defs/s0"
},
"filterField": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"sourceField": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"sourcePaths": {
"type": "array",
"maxItems": 100,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
}
},
"minProperties": 1,
"additionalProperties": false
}
},
"required": [
"path",
"expectedRevision",
"changes"
],
"additionalProperties": false,
"$defs": {
"s0": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "^[a-zA-Z][a-zA-Z0-9_ -]*$"
}
}
}
}studio_openAction
Open/remember .app.json with latest data and selected sources in read-only preview.
View tool JSON
{
"name": "studio_open",
"kind": "act",
"impl": "imperative",
"description": "Open/remember .app.json with latest data and selected sources in read-only preview.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"required": [
"path"
],
"additionalProperties": false
}
}packs_exportAction
Save files/binary/empty folders at exact paths in a new .desktop-pack.json, default /Exports.
View tool JSON
{
"name": "packs_export",
"kind": "act",
"impl": "imperative",
"description": "Save files/binary/empty folders at exact paths in a new .desktop-pack.json, default /Exports.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"additionalProperties": false
}
}packs_inspectAnswer
Inspect .desktop-pack.json contents/bytes/conflicts.
View tool JSON
{
"name": "packs_inspect",
"kind": "answer",
"impl": "imperative",
"description": "Inspect .desktop-pack.json contents/bytes/conflicts.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"additionalProperties": false
}
}packs_importAction
Restore exact paths; merge folders/skip identical files.
View tool JSON
{
"name": "packs_import",
"kind": "act",
"impl": "imperative",
"description": "Restore exact paths; merge folders/skip identical files.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"conflictMode": {
"type": "string",
"enum": [
"stop",
"preserve"
]
}
},
"additionalProperties": false
}
}projects_listAction
List 100 local projects max, attention first, with reported checkpoints, step/decision counts and warnings/truncation.
View tool JSON
{
"name": "projects_list",
"kind": "act",
"impl": "imperative",
"description": "List 100 local projects max, attention first, with reported checkpoints, step/decision counts and warnings/truncation.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}projects_readAnswer
Read current/remembered/named project revision and bounded resume brief with run/step IDs, decisions and tasks.
View tool JSON
{
"name": "projects_read",
"kind": "answer",
"impl": "imperative",
"description": "Read current/remembered/named project revision and bounded resume brief with run/step IDs, decisions and tasks.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
}
}projects_createAction
Create/open recoverable .project.json with stable ID/context.
View tool JSON
{
"name": "projects_create",
"kind": "act",
"impl": "imperative",
"description": "Create/open recoverable .project.json with stable ID/context.",
"inputSchema": {
"type": "object",
"required": [
"path",
"title",
"objective"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"context": {
"type": "string",
"maxLength": 12000
},
"taskListPath": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"references": {
"type": "array",
"maxItems": 40,
"items": {
"type": "object",
"required": [
"label",
"target",
"detail"
],
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"target": {
"type": "string",
"maxLength": 2048
},
"detail": {
"type": "string",
"maxLength": 2000
}
}
}
}
},
"additionalProperties": false
}
}projects_updateAction
Update lasting context at revision; arrays replace.
View tool JSON
{
"name": "projects_update",
"kind": "act",
"impl": "imperative",
"description": "Update lasting context at revision; arrays replace.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"changes"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"changes": {
"type": "object",
"minProperties": 1,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"context": {
"type": "string",
"maxLength": 12000
},
"taskListPath": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"references": {
"type": "array",
"maxItems": 40,
"items": {
"type": "object",
"required": [
"label",
"target",
"detail"
],
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"target": {
"type": "string",
"maxLength": 2048
},
"detail": {
"type": "string",
"maxLength": 2000
}
}
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
}projects_startAction
Save/open reported run/plan with generated IDs, first step active.
View tool JSON
{
"name": "projects_start",
"kind": "act",
"impl": "imperative",
"description": "Save/open reported run/plan with generated IDs, first step active.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"agent",
"objective",
"steps"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"agent": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"steps": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"basedOn": {
"type": [
"string",
"null"
],
"maxLength": 80
}
},
"additionalProperties": false
}
}projects_checkpointAction
Checkpoint latest unfinished run at current revision; arrays replace.
View tool JSON
{
"name": "projects_checkpoint",
"kind": "act",
"impl": "imperative",
"description": "Checkpoint latest unfinished run at current revision; arrays replace.",
"inputSchema": {
"type": "object",
"required": [
"path",
"runId",
"expectedRevision"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"runId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"status": {
"type": "string",
"enum": [
"working",
"waiting",
"paused",
"completed"
]
},
"summary": {
"type": "string",
"maxLength": 6000
},
"nextAction": {
"type": "string",
"maxLength": 2000
},
"steps": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "object",
"required": [
"id",
"title",
"status"
],
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"status": {
"type": "string",
"enum": [
"pending",
"in-progress",
"done",
"skipped"
]
}
}
}
},
"evidence": {
"type": "array",
"maxItems": 40,
"items": {
"type": "object",
"required": [
"label",
"target",
"detail"
],
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"target": {
"type": "string",
"maxLength": 2048
},
"detail": {
"type": "string",
"maxLength": 2000
}
}
}
},
"decision": {
"type": "object",
"required": [
"question"
],
"additionalProperties": false,
"properties": {
"question": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"options": {
"type": "array",
"maxItems": 8,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"additionalProperties": false
}
}projects_answerAction
Save authorized user answer at revision for next brief; opens Projects.
View tool JSON
{
"name": "projects_answer",
"kind": "act",
"impl": "imperative",
"description": "Save authorized user answer at revision for next brief; opens Projects.",
"inputSchema": {
"type": "object",
"required": [
"path",
"decisionId",
"expectedRevision",
"answer"
],
"properties": {
"path": {
"type": "string",
"maxLength": 2048
},
"decisionId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"answer": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"additionalProperties": false
}
}documents_selectAction
Reveal a paragraph or select its text in Writer at the latest documents_read revision.
View tool JSON
{
"name": "documents_select",
"kind": "act",
"impl": "imperative",
"description": "Reveal a paragraph or select its text in Writer at the latest documents_read revision.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"index"
],
"properties": {
"path": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
},
"index": {
"type": "integer",
"minimum": 0
},
"start": {
"type": "integer",
"minimum": 0
},
"end": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
}documents_createAction
Create ODT/DOCX with styled paragraphs/tables; opens Writer and saves.
View tool JSON
{
"name": "documents_create",
"kind": "act",
"impl": "imperative",
"description": "Create ODT/DOCX with styled paragraphs/tables; opens Writer and saves.",
"inputSchema": {
"type": "object",
"required": [
"path",
"blocks"
],
"properties": {
"path": {
"type": "string"
},
"blocks": {
"type": "array",
"maxItems": 200,
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"type": {
"const": "paragraph"
},
"text": {
"type": "string"
},
"style": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"rows"
],
"properties": {
"type": {
"const": "table"
},
"rows": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "string"
}
}
}
},
"additionalProperties": false
}
]
}
}
},
"additionalProperties": false
}
}documents_readAction
Open/save Writer and read paged text, paragraphs, tables, images and revision; follow nextOffset/nextTextOffset for complete content.
View tool JSON
{
"name": "documents_read",
"kind": "act",
"impl": "imperative",
"description": "Open/save Writer and read paged text, paragraphs, tables, images and revision; follow nextOffset/nextTextOffset for complete content.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"includeFormatting": {
"type": "boolean"
},
"path": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"overview",
"text",
"paragraphs",
"tables",
"table",
"images"
]
},
"offset": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"textOffset": {
"type": "integer",
"minimum": 0
},
"maxChars": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"table": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
}documents_editAction
Revision-checked Writer text, formatting, paragraphs, table dimensions, images or page layout; saves changes.
View tool JSON
{
"name": "documents_edit",
"kind": "act",
"impl": "imperative",
"description": "Revision-checked Writer text, formatting, paragraphs, table dimensions, images or page layout; saves changes.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"operation"
],
"properties": {
"path": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
},
"operation": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"index",
"start",
"end"
],
"properties": {
"type": {
"const": "text-range"
},
"index": {
"$ref": "#/$defs/s0"
},
"start": {
"$ref": "#/$defs/s0"
},
"end": {
"$ref": "#/$defs/s0"
},
"text": {
"type": "string",
"maxLength": 50000
},
"bold": {
"type": "boolean"
},
"italic": {
"type": "boolean"
},
"underline": {
"type": "boolean"
},
"fontSize": {
"type": "number",
"minimum": 1,
"maximum": 300
},
"fontName": {
"$ref": "#/$defs/s1"
},
"color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"link": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"index",
"text"
],
"properties": {
"type": {
"const": "insert-paragraph"
},
"index": {
"$ref": "#/$defs/s0"
},
"text": {
"type": "string",
"maxLength": 50000
},
"style": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"index",
"delta"
],
"properties": {
"type": {
"const": "move-paragraph"
},
"index": {
"$ref": "#/$defs/s0"
},
"delta": {
"type": "integer",
"minimum": -32767,
"maximum": 32767
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"table",
"action",
"axis",
"index",
"count"
],
"properties": {
"type": {
"const": "table-structure"
},
"table": {
"$ref": "#/$defs/s1"
},
"action": {
"enum": [
"insert",
"remove"
]
},
"axis": {
"enum": [
"rows",
"columns"
]
},
"index": {
"$ref": "#/$defs/s0"
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"name",
"action"
],
"properties": {
"type": {
"const": "image"
},
"name": {
"$ref": "#/$defs/s1"
},
"action": {
"enum": [
"resize",
"remove"
]
},
"widthMm": {
"$ref": "#/$defs/s2"
},
"heightMm": {
"$ref": "#/$defs/s2"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"widthMm",
"heightMm",
"marginMm"
],
"properties": {
"type": {
"const": "page-layout"
},
"widthMm": {
"$ref": "#/$defs/s2"
},
"heightMm": {
"$ref": "#/$defs/s2"
},
"marginMm": {
"type": "number",
"minimum": 0,
"maximum": 400
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"imagePath"
],
"properties": {
"type": {
"const": "insert-image"
},
"imagePath": {
"type": "string"
},
"position": {
"type": "string",
"enum": [
"end",
"cursor"
],
"default": "end"
},
"description": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"find",
"replace"
],
"properties": {
"type": {
"const": "replace"
},
"find": {
"type": "string"
},
"replace": {
"type": "string"
},
"expectedOccurrences": {
"type": "integer",
"minimum": 1,
"default": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"index"
],
"properties": {
"type": {
"const": "paragraph"
},
"index": {
"type": "integer",
"minimum": 0
},
"text": {
"type": "string"
},
"style": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"table",
"cell",
"text"
],
"properties": {
"type": {
"const": "table-cell"
},
"table": {
"type": "string"
},
"cell": {
"type": "string"
},
"text": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"blocks"
],
"properties": {
"type": {
"const": "append"
},
"blocks": {
"type": "array",
"maxItems": 200,
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"type": {
"const": "paragraph"
},
"text": {
"type": "string"
},
"style": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"rows"
],
"properties": {
"type": {
"const": "table"
},
"rows": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "string"
}
}
}
},
"additionalProperties": false
}
]
}
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false,
"$defs": {
"s0": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"s1": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"s2": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
}
}
}
}documents_exportAction
Export new ODT/DOCX/PDF by destination extension.
View tool JSON
{
"name": "documents_export",
"kind": "act",
"impl": "imperative",
"description": "Export new ODT/DOCX/PDF by destination extension.",
"inputSchema": {
"type": "object",
"required": [
"path",
"destination"
],
"properties": {
"path": {
"type": "string"
},
"destination": {
"type": "string"
}
},
"additionalProperties": false
}
}sheets_selectAction
Show a sheet and select its cell range at the latest sheets_read revision.
View tool JSON
{
"name": "sheets_select",
"kind": "act",
"impl": "imperative",
"description": "Show a sheet and select its cell range at the latest sheets_read revision.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"range"
],
"properties": {
"path": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
},
"sheet": {
"type": "string",
"maxLength": 31
},
"range": {
"type": "string"
}
},
"additionalProperties": false
}
}sheets_createAction
Create ODS/XLSX sheets with text/numbers/formulas; opens Sheets and saves.
View tool JSON
{
"name": "sheets_create",
"kind": "act",
"impl": "imperative",
"description": "Create ODS/XLSX sheets with text/numbers/formulas; opens Sheets and saves.",
"inputSchema": {
"type": "object",
"required": [
"path",
"sheets"
],
"properties": {
"path": {
"type": "string"
},
"sheets": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"required": [
"name",
"values"
],
"properties": {
"name": {
"type": "string",
"maxLength": 31
},
"values": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"oneOf": [
{
"type": "string",
"maxLength": 10000
},
{
"type": "number"
},
{
"type": "null"
},
{
"type": "object",
"required": [
"formula"
],
"properties": {
"formula": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
}
]
}
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}sheets_readAnswer
Read cells/values/formulas/errors, sheets/charts, selection/revision.
View tool JSON
{
"name": "sheets_read",
"kind": "answer",
"impl": "imperative",
"description": "Read cells/values/formulas/errors, sheets/charts, selection/revision.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"sheet": {
"type": "string",
"maxLength": 31
},
"range": {
"type": "string"
},
"includeFormatting": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}sheets_editAction
Revision-checked cells, formatting, sheets, rows/columns, sorting, filtering and merging; selects and saves Calc.
View tool JSON
{
"name": "sheets_edit",
"kind": "act",
"impl": "imperative",
"description": "Revision-checked cells, formatting, sheets, rows/columns, sorting, filtering and merging; selects and saves Calc.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"operation"
],
"properties": {
"path": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
},
"operation": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"action"
],
"properties": {
"type": {
"const": "sheet"
},
"action": {
"enum": [
"add",
"rename",
"remove",
"move"
]
},
"sheet": {
"$ref": "#/$defs/s0"
},
"name": {
"$ref": "#/$defs/s0"
},
"index": {
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"axis",
"action",
"index",
"count"
],
"properties": {
"type": {
"const": "structure"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"axis": {
"enum": [
"rows",
"columns"
]
},
"action": {
"enum": [
"insert",
"remove"
]
},
"index": {
"type": "integer",
"minimum": 0
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"range",
"column"
],
"properties": {
"type": {
"const": "sort"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"range": {
"type": "string"
},
"column": {
"type": "integer",
"minimum": 0
},
"ascending": {
"type": "boolean",
"default": true
},
"header": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"range",
"value"
],
"properties": {
"type": {
"const": "filter"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"range": {
"type": "string"
},
"column": {
"type": "integer",
"minimum": 0
},
"value": {
"type": [
"string",
"number",
"null"
]
},
"header": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"range"
],
"properties": {
"type": {
"const": "merge"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"range": {
"type": "string"
},
"merge": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"range",
"values"
],
"properties": {
"type": {
"const": "cells"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"range": {
"type": "string"
},
"values": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"oneOf": [
{
"type": "string",
"maxLength": 10000
},
{
"type": "number"
},
{
"type": "null"
},
{
"type": "object",
"required": [
"formula"
],
"properties": {
"formula": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
}
]
}
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"range"
],
"properties": {
"type": {
"const": "format"
},
"sheet": {
"$ref": "#/$defs/s0"
},
"range": {
"type": "string"
},
"bold": {
"type": "boolean"
},
"italic": {
"type": "boolean"
},
"underline": {
"type": "boolean"
},
"wrap": {
"type": "boolean"
},
"fontName": {
"type": "string",
"maxLength": 200
},
"fontSize": {
"$ref": "#/$defs/s1"
},
"align": {
"enum": [
"left",
"center",
"right"
]
},
"columnWidthMm": {
"$ref": "#/$defs/s1"
},
"rowHeightMm": {
"$ref": "#/$defs/s1"
},
"autoFit": {
"type": "boolean"
},
"background": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"numberFormat": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false,
"$defs": {
"s0": {
"type": "string",
"maxLength": 31
},
"s1": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 500
}
}
}
}sheets_chartAction
Create/update/remove a linked chart at fresh revision.
View tool JSON
{
"name": "sheets_chart",
"kind": "act",
"impl": "imperative",
"description": "Create/update/remove a linked chart at fresh revision.",
"inputSchema": {
"type": "object",
"required": [
"path",
"expectedRevision",
"name"
],
"properties": {
"action": {
"enum": [
"create",
"update",
"remove"
],
"default": "create"
},
"kind": {
"enum": [
"column",
"bar",
"line",
"pie",
"area"
]
},
"path": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 0
},
"sheet": {
"type": "string",
"maxLength": 31
},
"range": {
"type": "string"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"title": {
"type": "string",
"maxLength": 200
}
},
"additionalProperties": false
}
}sheets_exportAction
Export new ODS/XLSX/PDF or chart PNG snapshot.
View tool JSON
{
"name": "sheets_export",
"kind": "act",
"impl": "imperative",
"description": "Export new ODS/XLSX/PDF or chart PNG snapshot.",
"inputSchema": {
"type": "object",
"required": [
"path",
"destination"
],
"properties": {
"path": {
"type": "string"
},
"destination": {
"type": "string"
},
"sheet": {
"type": "string",
"maxLength": 31
},
"chart": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"additionalProperties": false
}
}preview_readAction
Read source beside Documents: PDF text/pages, revision, citation, selection.
View tool JSON
{
"name": "preview_read",
"kind": "act",
"impl": "imperative",
"description": "Read source beside Documents: PDF text/pages, revision, citation, selection.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"page": {
"type": "integer",
"minimum": 1
},
"includeImage": {
"type": "boolean",
"default": false
},
"pageCount": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 1
},
"maxChars": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"default": 20000
}
},
"additionalProperties": false
}
}preview_searchAction
Literal case-insensitive PDF search: excerpt/page, scannedPages, truncation, nextPage.
View tool JSON
{
"name": "preview_search",
"kind": "act",
"impl": "imperative",
"description": "Literal case-insensitive PDF search: excerpt/page, scannedPages, truncation, nextPage.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"startPage": {
"type": "integer",
"minimum": 1,
"default": 1
},
"maxPages": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 25
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50
}
},
"additionalProperties": false
}
}preview_revealAction
Show sources in Preview independently of Documents.
View tool JSON
{
"name": "preview_reveal",
"kind": "act",
"impl": "imperative",
"description": "Show sources in Preview independently of Documents.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
},
"page": {
"type": "integer",
"minimum": 1
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
}review_listAnswer
List version IDs, paths, authors, recovery state, summaries.
View tool JSON
{
"name": "review_list",
"kind": "answer",
"impl": "imperative",
"description": "List version IDs, paths, authors, recovery state, summaries.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 30
}
},
"additionalProperties": false
}
}review_readAction
Read current.token, canRestore, blockers/copy path.
View tool JSON
{
"name": "review_read",
"kind": "act",
"impl": "imperative",
"description": "Read current.token, canRestore, blockers/copy path.",
"inputSchema": {
"type": "object",
"required": [
"versionId"
],
"properties": {
"versionId": {
"type": "string"
},
"includeRawDiff": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}review_restoreAction
Restore a version as a new copy or replace current contents at a checked token; rejects drafts and conflicts.
View tool JSON
{
"name": "review_restore",
"kind": "act",
"impl": "imperative",
"description": "Restore a version as a new copy or replace current contents at a checked token; rejects drafts and conflicts.",
"inputSchema": {
"type": "object",
"required": [
"versionId",
"mode"
],
"properties": {
"versionId": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"replace",
"copy"
]
},
"side": {
"type": "string",
"enum": [
"before",
"after"
],
"default": "before"
},
"destination": {
"type": "string"
},
"expectedCurrentToken": {
"type": "string"
}
},
"additionalProperties": false
}
}review_sessionAction
Save reported work summary/related evidence IDs.
View tool JSON
{
"name": "review_session",
"kind": "act",
"impl": "imperative",
"description": "Save reported work summary/related evidence IDs.",
"inputSchema": {
"type": "object",
"required": [
"title",
"status",
"summary"
],
"properties": {
"id": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 1
},
"title": {
"type": "string",
"maxLength": 120
},
"status": {
"type": "string",
"enum": [
"working",
"completed"
]
},
"summary": {
"type": "string",
"maxLength": 4000
},
"questions": {
"$ref": "#/$defs/s0"
},
"results": {
"$ref": "#/$defs/s0"
},
"versionIds": {
"$ref": "#/$defs/s0"
},
"activityIds": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": false,
"$defs": {
"s0": {
"type": "array",
"maxItems": 50,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 2048
}
}
}
}
}activity_listAnswer
List recent human/agent/Terminal/system actions, newest first.
View tool JSON
{
"name": "activity_list",
"kind": "answer",
"impl": "imperative",
"description": "List recent human/agent/Terminal/system actions, newest first.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 30
}
},
"additionalProperties": false
}
}tasks_listAnswer
Read tasks/IDs/revision/evidence checks.
View tool JSON
{
"name": "tasks_list",
"kind": "answer",
"impl": "imperative",
"description": "Read tasks/IDs/revision/evidence checks.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"todo",
"in-progress",
"done"
]
},
"query": {
"type": "string",
"maxLength": 200
}
},
"additionalProperties": false
}
}tasks_createAction
Create a task in a named list; existing lists require their read revision. Opens Tasks and records a recoverable save.
View tool JSON
{
"name": "tasks_create",
"kind": "act",
"impl": "imperative",
"description": "Create a task in a named list; existing lists require their read revision. Opens Tasks and records a recoverable save.",
"inputSchema": {
"type": "object",
"required": [
"path",
"title"
],
"properties": {
"path": {
"type": "string"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"todo",
"in-progress",
"done"
]
},
"dueDate": {
"type": [
"string",
"null"
]
},
"notes": {
"type": "string",
"maxLength": 5000
},
"sourcePath": {
"type": [
"string",
"null"
]
},
"outputPath": {
"type": [
"string",
"null"
]
},
"listTitle": {
"type": "string",
"maxLength": 120
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
}tasks_updateAction
Update stable ID at list revision; rejects stale writes.
View tool JSON
{
"name": "tasks_update",
"kind": "act",
"impl": "imperative",
"description": "Update stable ID at list revision; rejects stale writes.",
"inputSchema": {
"type": "object",
"required": [
"path",
"id",
"expectedRevision"
],
"properties": {
"path": {
"type": "string"
},
"id": {
"type": "string",
"maxLength": 80
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"changes": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"todo",
"in-progress",
"done"
]
},
"dueDate": {
"type": [
"string",
"null"
]
},
"notes": {
"type": "string",
"maxLength": 5000
},
"sourcePath": {
"type": [
"string",
"null"
]
},
"outputPath": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"remove": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}canvas_readAnswer
Read scene IDs/geometry/bindings/revision/selection; omit path for current/last.
View tool JSON
{
"name": "canvas_read",
"kind": "answer",
"impl": "imperative",
"description": "Read scene IDs/geometry/bindings/revision/selection; omit path for current/last.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"includeImage": {
"type": "boolean",
"default": false
},
"includePoints": {
"type": "boolean",
"default": false
},
"scope": {
"type": "string",
"enum": [
"all",
"selection"
]
},
"offset": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"additionalProperties": false
}
}canvas_editAction
Create or revision-check edits to Canvas objects, styles, bindings and layer order; preserves unrelated objects and saves with recovery.
View tool JSON
{
"name": "canvas_edit",
"kind": "act",
"impl": "imperative",
"description": "Create or revision-check edits to Canvas objects, styles, bindings and layer order; preserves unrelated objects and saves with recovery.",
"inputSchema": {
"type": "object",
"required": [
"path",
"operations"
],
"properties": {
"path": {
"type": "string"
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"create": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"width": {
"type": "number",
"minimum": 320,
"maximum": 4096
},
"height": {
"type": "number",
"minimum": 240,
"maximum": 4096
}
},
"additionalProperties": false
},
"operations": {
"type": "array",
"maxItems": 100,
"items": {
"oneOf": [
{
"type": "object",
"required": [
"op",
"ids"
],
"properties": {
"op": {
"const": "reorder"
},
"ids": {
"type": "array",
"maxItems": 2000,
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"object"
],
"properties": {
"op": {
"const": "add"
},
"object": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"$ref": "#/$defs/s0"
},
"type": {
"type": "string",
"enum": [
"text",
"sticky",
"rectangle",
"diamond",
"ellipse",
"connector",
"arrow",
"line",
"freedraw",
"image"
]
},
"x": {
"$ref": "#/$defs/s1"
},
"y": {
"$ref": "#/$defs/s1"
},
"width": {
"$ref": "#/$defs/s2"
},
"height": {
"$ref": "#/$defs/s2"
},
"text": {
"type": "string",
"maxLength": 20000
},
"fill": {
"$ref": "#/$defs/s3"
},
"color": {
"$ref": "#/$defs/s3"
},
"fontFamily": {
"type": "integer",
"enum": [
1,
2,
3,
5,
6,
7,
8,
9
]
},
"fillStyle": {
"$ref": "#/$defs/s4"
},
"strokeStyle": {
"type": "string",
"enum": [
"solid",
"dashed",
"dotted"
]
},
"textAlign": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"verticalAlign": {
"type": "string",
"enum": [
"top",
"middle",
"bottom"
]
},
"startArrowhead": {
"$ref": "#/$defs/s5"
},
"endArrowhead": {
"$ref": "#/$defs/s5"
},
"fontSize": {
"type": "number",
"minimum": 12,
"maximum": 72
},
"link": {
"type": [
"string",
"null"
]
},
"imagePath": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"points": {
"$ref": "#/$defs/s6"
},
"angle": {
"type": "number",
"minimum": -100,
"maximum": 100
},
"strokeWidth": {
"$ref": "#/$defs/s7"
},
"roughness": {
"type": "number",
"minimum": 0,
"maximum": 10
},
"opacity": {
"$ref": "#/$defs/s7"
},
"groupIds": {
"$ref": "#/$defs/s8"
},
"locked": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"id",
"changes"
],
"properties": {
"op": {
"const": "update"
},
"id": {
"$ref": "#/$defs/s0"
},
"changes": {
"type": "object",
"properties": {
"x": {
"$ref": "#/$defs/s1"
},
"y": {
"$ref": "#/$defs/s1"
},
"width": {
"$ref": "#/$defs/s2"
},
"height": {
"$ref": "#/$defs/s2"
},
"text": {
"type": "string",
"maxLength": 20000
},
"fill": {
"$ref": "#/$defs/s3"
},
"color": {
"$ref": "#/$defs/s3"
},
"fontFamily": {
"type": "integer",
"enum": [
1,
2,
3,
5,
6,
7,
8,
9
]
},
"fillStyle": {
"$ref": "#/$defs/s4"
},
"strokeStyle": {
"type": "string",
"enum": [
"solid",
"dashed",
"dotted"
]
},
"textAlign": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"verticalAlign": {
"type": "string",
"enum": [
"top",
"middle",
"bottom"
]
},
"startArrowhead": {
"$ref": "#/$defs/s5"
},
"endArrowhead": {
"$ref": "#/$defs/s5"
},
"fontSize": {
"type": "number",
"minimum": 12,
"maximum": 72
},
"link": {
"type": [
"string",
"null"
]
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"points": {
"$ref": "#/$defs/s6"
},
"angle": {
"type": "number",
"minimum": -100,
"maximum": 100
},
"strokeWidth": {
"$ref": "#/$defs/s7"
},
"roughness": {
"type": "number",
"minimum": 0,
"maximum": 10
},
"opacity": {
"$ref": "#/$defs/s7"
},
"groupIds": {
"$ref": "#/$defs/s8"
},
"locked": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"id"
],
"properties": {
"op": {
"const": "delete"
},
"id": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": false
}
]
}
}
},
"additionalProperties": false,
"$defs": {
"s0": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"s1": {
"type": "number",
"minimum": -1000000,
"maximum": 1000000
},
"s2": {
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"s3": {
"type": "string",
"pattern": "^#[a-fA-F0-9]{6}$"
},
"s4": {
"type": "string",
"enum": [
"solid",
"hachure",
"cross-hatch",
"zigzag"
]
},
"s5": {
"type": [
"string",
"null"
],
"enum": [
null,
"arrow",
"bar",
"dot",
"circle",
"circle_outline",
"triangle",
"triangle_outline",
"diamond",
"diamond_outline",
"crowfoot_one",
"crowfoot_many",
"crowfoot_one_or_many"
]
},
"s6": {
"type": "array",
"minItems": 2,
"maxItems": 20000,
"items": {
"type": "array",
"minItems": 2,
"maxItems": 2,
"items": {
"type": "number"
}
}
},
"s7": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"s8": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"maxLength": 100
}
}
}
}
}canvas_exportAction
Export revision-checked PNG; keep editable scene.
View tool JSON
{
"name": "canvas_export",
"kind": "act",
"impl": "imperative",
"description": "Export revision-checked PNG; keep editable scene.",
"inputSchema": {
"type": "object",
"required": [
"path",
"destination",
"expectedRevision"
],
"properties": {
"path": {
"type": "string"
},
"destination": {
"type": "string"
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
}notes_get_contextAnswer
Read current/last Notepad draft, revision, save state, selection; no opens/saves.
View tool JSON
{
"name": "notes_get_context",
"kind": "answer",
"impl": "imperative",
"description": "Read current/last Notepad draft, revision, save state, selection; no opens/saves.",
"inputSchema": {
"type": "object",
"properties": {
"maxChars": {
"type": "integer",
"minimum": 1,
"maximum": 200000,
"default": 20000
}
},
"additionalProperties": false
}
}files_listAnswer
List immediate workspace folder contents.
View tool JSON
{
"name": "files_list",
"kind": "answer",
"impl": "imperative",
"description": "List immediate workspace folder contents.",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"default": "/"
}
},
"additionalProperties": false
}
}files_statAnswer
Get type, size, modified time and normalized file/folder path.
View tool JSON
{
"name": "files_stat",
"kind": "answer",
"impl": "imperative",
"description": "Get type, size, modified time and normalized file/folder path.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
},
"additionalProperties": false
}
}files_readAnswer
Read saved UTF-8 lines and whole-file revision.
View tool JSON
{
"name": "files_read",
"kind": "answer",
"impl": "imperative",
"description": "Read saved UTF-8 lines and whole-file revision.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
},
"startLine": {
"type": "integer",
"minimum": 1,
"default": 1
},
"maxLines": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 500
}
},
"additionalProperties": false
}
}files_writeAction
Create or replace workspace UTF-8 text; replacement needs its read revision, and createOnly rejects existing files. Saves safe Notepad edits.
View tool JSON
{
"name": "files_write",
"kind": "act",
"impl": "imperative",
"description": "Create or replace workspace UTF-8 text; replacement needs its read revision, and createOnly rejects existing files. Saves safe Notepad edits.",
"inputSchema": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string"
},
"content": {
"type": "string",
"maxLength": 200000
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"createOnly": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}files_patchAction
Replace exact text at files_read/notes_get_context revision.
View tool JSON
{
"name": "files_patch",
"kind": "act",
"impl": "imperative",
"description": "Replace exact text at files_read/notes_get_context revision.",
"inputSchema": {
"type": "object",
"required": [
"path",
"find",
"replace"
],
"properties": {
"path": {
"type": "string"
},
"find": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"replace": {
"type": "string",
"maxLength": 50000
},
"expectedOccurrences": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 1
},
"expectedRevision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"additionalProperties": false
}
}files_searchAnswer
Search names and UTF-8 text below a folder; includeTrash enables Trash results.
View tool JSON
{
"name": "files_search",
"kind": "answer",
"impl": "imperative",
"description": "Search names and UTF-8 text below a folder; includeTrash enables Trash results.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"path": {
"type": "string",
"default": "/"
},
"includeTrash": {
"type": "boolean",
"default": false
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50
}
},
"additionalProperties": false
}
}files_mkdirAction
Create a folder and missing parents.
View tool JSON
{
"name": "files_mkdir",
"kind": "act",
"impl": "imperative",
"description": "Create a folder and missing parents.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
},
"additionalProperties": false
}
}files_moveAction
Move/rename a file or folder; overwrite replaces the destination.
View tool JSON
{
"name": "files_move",
"kind": "act",
"impl": "imperative",
"description": "Move/rename a file or folder; overwrite replaces the destination.",
"inputSchema": {
"type": "object",
"required": [
"source",
"destination"
],
"properties": {
"source": {
"type": "string"
},
"destination": {
"type": "string"
},
"overwrite": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}files_copyAction
Copy a file or folder; overwrite replaces the destination.
View tool JSON
{
"name": "files_copy",
"kind": "act",
"impl": "imperative",
"description": "Copy a file or folder; overwrite replaces the destination.",
"inputSchema": {
"type": "object",
"required": [
"source",
"destination"
],
"properties": {
"source": {
"type": "string"
},
"destination": {
"type": "string"
},
"overwrite": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}files_trashAction
Move to /Trash.
View tool JSON
{
"name": "files_trash",
"kind": "act",
"impl": "imperative",
"description": "Move to /Trash.",
"inputSchema": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
},
"additionalProperties": false
}
}terminal_runAction
Run a short workspace Bash command and return final output.
View tool JSON
{
"name": "terminal_run",
"kind": "act",
"impl": "imperative",
"description": "Run a short workspace Bash command and return final output.",
"inputSchema": {
"type": "object",
"required": [
"command"
],
"properties": {
"command": {
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"cwd": {
"type": "string"
}
},
"additionalProperties": false
}
}terminal_startAction
Start a workspace Bash job and return its ID immediately.
View tool JSON
{
"name": "terminal_start",
"kind": "act",
"impl": "imperative",
"description": "Start a workspace Bash job and return its ID immediately.",
"inputSchema": {
"type": "object",
"required": [
"command"
],
"properties": {
"command": {
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"cwd": {
"type": "string"
},
"timeoutSeconds": {
"type": "integer",
"minimum": 1,
"maximum": 300,
"default": 300
}
},
"additionalProperties": false
}
}terminal_waitAction
Wait for newer job state or completion using the latest afterRevision.
View tool JSON
{
"name": "terminal_wait",
"kind": "act",
"impl": "imperative",
"description": "Wait for newer job state or completion using the latest afterRevision.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"afterRevision": {
"type": "integer",
"minimum": 0
},
"timeoutMs": {
"type": "integer",
"minimum": 100,
"maximum": 30000,
"default": 20000
}
},
"additionalProperties": false
}
}terminal_cancelSensitive Action
Cancel a queued/running job.
View tool JSON
{
"name": "terminal_cancel",
"kind": "transact",
"impl": "imperative",
"description": "Cancel a queued/running job.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"additionalProperties": false
}
}terminal_jobsAnswer
List recent job IDs, commands, status, revisions, and timing; optionally filter status.
View tool JSON
{
"name": "terminal_jobs",
"kind": "answer",
"impl": "imperative",
"description": "List recent job IDs, commands, status, revisions, and timing; optionally filter status.",
"inputSchema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"queued",
"running",
"completed",
"failed",
"cancelled",
"timed_out"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 30
}
},
"additionalProperties": false
}
}desktop_describe_toolAnswer
Get full tool usage, side effects, parameter guidance and defaults before using unfamiliar tools.
View tool JSON
{
"name": "desktop_describe_tool",
"kind": "answer",
"impl": "imperative",
"description": "Get full tool usage, side effects, parameter guidance and defaults before using unfamiliar tools.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}
}