{ "contractVersion": "1.0", "tools": [ { "name": "studio_project_context", "authority": "authenticated", "description": "Read the open project's manifest-driven language, capability, reference and edit-scope context.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." } }, "required": [ "projectRoot" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game" }, "exampleValue": { "projectRoot": "/projects/game", "projectName": "game", "languages": [], "libraries": [], "editableRoots": [ "/projects/game" ], "readOnlyRoots": [], "references": [], "limitations": [ "Example context; installed provider supplies real support." ] } }, { "name": "studio_reference_read", "authority": "authenticated", "description": "Read only an indexed local language/SDK reference, paginated in Unicode code points.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "referenceId": { "type": "string", "minLength": 1 }, "offset": { "type": "integer", "minimum": 0, "maximum": 2147483647, "default": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 16000, "default": 4000 } }, "required": [ "projectRoot", "referenceId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "referenceId": "pbs:quickstart", "offset": 0, "limit": 4000 }, "exampleValue": { "referenceId": "pbs:quickstart", "offset": 0, "total": 7, "nextOffset": null, "text": "Example" } }, { "name": "studio_control_acquire", "authority": "granted", "description": "Acquire the task after explicit human grant in DEV. Authentication alone is insufficient.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." } }, "required": [ "projectRoot" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game" }, "exampleValue": { "taskId": "task-example", "state": "AGENT_WORKING" } }, { "name": "studio_control_release", "authority": "task", "description": "Invalidate this task, stop managed work and refresh documents before manual return.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "state": "MANUAL" } }, { "name": "studio_language_query", "authority": "task", "description": "Query project LSP capabilities using saved project files or task-owned read-only external sources. readExternalSource reads an external URI returned by definition; hover and definition can continue inside it. Returns refactoring proposals, never applies edits.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "operation": { "type": "string", "minLength": 1 }, "parameters": { "type": "object", "properties": { "uri": { "type": "string", "minLength": 1 }, "position": { "type": "object", "properties": { "line": { "type": "integer", "minimum": 0 }, "character": { "type": "integer", "minimum": 0 } }, "required": [ "line", "character" ], "additionalProperties": false }, "range": { "type": "object", "properties": { "start": { "type": "object", "properties": { "line": { "type": "integer", "minimum": 0 }, "character": { "type": "integer", "minimum": 0 } }, "required": [ "line", "character" ], "additionalProperties": false }, "end": { "type": "object", "properties": { "line": { "type": "integer", "minimum": 0 }, "character": { "type": "integer", "minimum": 0 } }, "required": [ "line", "character" ], "additionalProperties": false } }, "required": [ "start", "end" ], "additionalProperties": false }, "positions": { "type": "array", "items": { "type": "object", "properties": { "line": { "type": "integer", "minimum": 0 }, "character": { "type": "integer", "minimum": 0 } }, "required": [ "line", "character" ], "additionalProperties": false } }, "query": { "type": "string" }, "newName": { "type": "string", "minLength": 1 }, "includeDeclaration": { "type": "boolean" }, "itemId": { "type": "string", "minLength": 1 } }, "required": [], "additionalProperties": false } }, "required": [ "projectRoot", "taskId", "operation", "parameters" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "operation": "definition", "parameters": { "uri": "file:///projects/game/src/main.pbs", "position": { "line": 0, "character": 0 } } }, "exampleValue": { "operation": "definition", "result": [], "limitations": [] } }, { "name": "studio_build_start", "authority": "task", "description": "Start saved-source compile and pack; return operationId promptly. Reuse clientRequestId only for identical parameters.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "clientRequestId": { "type": "string", "minLength": 1 } }, "required": [ "projectRoot", "taskId", "clientRequestId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "clientRequestId": "build-example" }, "exampleValue": { "operationId": "operation-build", "clientRequestId": "build-example", "state": "PENDING" } }, { "name": "studio_headless_boot", "authority": "task", "description": "Boot the project's known build artifact in one managed headless session. Never accepts an arbitrary cartridge path.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "buildId": { "type": "string", "minLength": 1 } }, "required": [ "projectRoot", "taskId", "buildId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "buildId": "build-example" }, "exampleValue": { "sessionId": "runtime-example", "buildId": "build-example" } }, { "name": "studio_headless_reset", "authority": "task", "description": "reset the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "sessionId": "runtime-example" } }, { "name": "studio_headless_clear_input", "authority": "task", "description": "clear_input the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "sessionId": "runtime-example" } }, { "name": "studio_headless_capture", "authority": "task", "description": "capture the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "sessionId": "runtime-example", "buildId": "build-example", "logicalFrameIndex": 9, "frameId": 4, "width": 1, "height": 1, "stridePixels": 1, "pixelFormat": "RGBA8888", "mimeType": "image/png", "stale": false } }, { "name": "studio_headless_state", "authority": "task", "description": "state the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "sessionId": "runtime-example" } }, { "name": "studio_headless_fault", "authority": "task", "description": "fault the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "fault": null } }, { "name": "studio_headless_shutdown", "authority": "task", "description": "shutdown the task-owned headless session; preserve runtime semantics and task authority.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example" }, "exampleValue": { "sessionId": "runtime-example" } }, { "name": "studio_headless_set_input", "authority": "task", "description": "Replace normalized input. Omitted controls become false/zero, not a partial patch.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "input": { "type": "object", "properties": { "up": { "type": "boolean", "default": false }, "down": { "type": "boolean", "default": false }, "left": { "type": "boolean", "default": false }, "right": { "type": "boolean", "default": false }, "a": { "type": "boolean", "default": false }, "b": { "type": "boolean", "default": false }, "x": { "type": "boolean", "default": false }, "y": { "type": "boolean", "default": false }, "l": { "type": "boolean", "default": false }, "r": { "type": "boolean", "default": false }, "start": { "type": "boolean", "default": false }, "select": { "type": "boolean", "default": false }, "touch": { "type": "boolean", "default": false }, "touchX": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647, "default": 0 }, "touchY": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647, "default": 0 } }, "required": [], "additionalProperties": false } }, "required": [ "projectRoot", "taskId", "input" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "input": { "a": true, "touchX": 0, "touchY": 0 } }, "exampleValue": { "sessionId": "runtime-example" } }, { "name": "studio_headless_advance", "authority": "task", "description": "Start bounded frame advancement and return operationId promptly; results include the canonical PNG. Do not blindly retry lost responses.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "clientRequestId": { "type": "string", "minLength": 1 }, "frames": { "type": "integer", "minimum": 0 } }, "required": [ "projectRoot", "taskId", "clientRequestId", "frames" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "clientRequestId": "advance-example", "frames": 60 }, "exampleValue": { "operationId": "operation-advance", "clientRequestId": "advance-example", "state": "PENDING" } }, { "name": "studio_operation_get", "authority": "task", "description": "Read a task-local operation by exactly one of operationId or clientRequestId, including known progress, typed result and image.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "operationId": { "type": "string", "minLength": 1 }, "clientRequestId": { "type": "string", "minLength": 1 } }, "required": [ "projectRoot", "taskId" ], "additionalProperties": false, "oneOf": [ { "required": [ "operationId" ], "not": { "required": [ "clientRequestId" ] } }, { "required": [ "clientRequestId" ], "not": { "required": [ "operationId" ] } } ] }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": true, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "operationId": "operation-advance" }, "exampleValue": { "operationId": "operation-advance", "clientRequestId": "advance-example", "state": "RUNNING", "progress": { "requestedFrames": 60, "completedFrames": 12 }, "result": null } }, { "name": "studio_operation_cancel", "authority": "task", "description": "Request cancellation of an owned operation. Acknowledgement is not worker termination or task release.", "inputSchema": { "type": "object", "properties": { "projectRoot": { "type": "string", "minLength": 1, "description": "Absolute root of an open project. Never inferred from UI focus." }, "taskId": { "type": "string", "minLength": 1, "description": "Current task identity obtained after human grant." }, "operationId": { "type": "string", "minLength": 1 } }, "required": [ "projectRoot", "taskId", "operationId" ], "additionalProperties": false }, "outputSchema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "status": { "const": "ok" }, "value": { "type": "object" } }, "required": [ "status", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "const": "error" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "status", "error" ], "additionalProperties": false } ] }, "annotations": { "readOnlyHint": false, "openWorldHint": false }, "exampleArguments": { "projectRoot": "/projects/game", "taskId": "task-example", "operationId": "operation-advance" }, "exampleValue": { "operationId": "operation-advance", "cancellationRequested": true } } ] }