Persist cartridge identity and slot configuration, add MemcardBoot and the MemcardBuffer SDK, and consume the runtime's negotiated memcard host controls with protected teardown. Qualify save/reopen and version upgrades through distinct configured runtime processes. Include specs, examples, regression evidence and the consolidated discussion lesson.
2384 lines
63 KiB
JSON
2384 lines
63 KiB
JSON
{
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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. Memcard requires an explicit choice and protocol 1.1 capability. Optional memcard prepares media before boot; create never replaces existing media.",
|
|
"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
|
|
},
|
|
"memcard": {
|
|
"type": "object",
|
|
"properties": {
|
|
"path": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "Explicit image path; omitted selects .studio/memcard.pmc in this project."
|
|
},
|
|
"action": {
|
|
"enum": [
|
|
"open",
|
|
"create"
|
|
]
|
|
},
|
|
"access": {
|
|
"enum": [
|
|
"read_write",
|
|
"read_only"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"action",
|
|
"access"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"memcardChoice": {
|
|
"enum": [
|
|
"persistent",
|
|
"memory_fresh",
|
|
"memory_existing"
|
|
]
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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. A native memcard refusal preserves the session and structured state for a later explicit decision.",
|
|
"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."
|
|
},
|
|
"discardUnsaved": {
|
|
"type": "boolean",
|
|
"description": "Explicit consent to discard remaining dirty game RAM. Default false."
|
|
},
|
|
"pendingWrites": {
|
|
"enum": [
|
|
"wait",
|
|
"cancel"
|
|
]
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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. A native memcard refusal preserves the session and structured state for a later explicit decision.",
|
|
"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."
|
|
},
|
|
"discardUnsaved": {
|
|
"type": "boolean",
|
|
"description": "Explicit consent to discard remaining dirty game RAM. Default false."
|
|
},
|
|
"pendingWrites": {
|
|
"enum": [
|
|
"wait",
|
|
"cancel"
|
|
]
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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
|
|
}
|
|
},
|
|
{
|
|
"name": "studio_headless_memcard_state",
|
|
"authority": "task",
|
|
"description": "Observe native media, session, dirty RAM, request, IO and recovery state without executing the guest. Requires negotiated protocol 1.1 memcard capability.",
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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_memcard_mount",
|
|
"authority": "task",
|
|
"description": "Explicitly open or create media after reset and before boot; create never replaces existing media. Requires negotiated protocol 1.1 memcard capability.",
|
|
"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."
|
|
},
|
|
"path": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "Explicit image path; omitted selects .studio/memcard.pmc in this project."
|
|
},
|
|
"action": {
|
|
"enum": [
|
|
"open",
|
|
"create"
|
|
]
|
|
},
|
|
"access": {
|
|
"enum": [
|
|
"read_write",
|
|
"read_only"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"projectRoot",
|
|
"taskId",
|
|
"action",
|
|
"access"
|
|
],
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"required": [
|
|
"code",
|
|
"message"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"required": [
|
|
"status",
|
|
"error"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
]
|
|
},
|
|
"annotations": {
|
|
"readOnlyHint": true,
|
|
"openWorldHint": false
|
|
},
|
|
"exampleArguments": {
|
|
"projectRoot": "/projects/game",
|
|
"taskId": "task-example",
|
|
"action": "open",
|
|
"access": "read_write"
|
|
},
|
|
"exampleValue": {
|
|
"sessionId": "runtime-example"
|
|
}
|
|
},
|
|
{
|
|
"name": "studio_headless_memcard_unmount",
|
|
"authority": "task",
|
|
"description": "Unmount idle media outside a resident game session. Requires negotiated protocol 1.1 memcard capability.",
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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_memcard_reconcile",
|
|
"authority": "task",
|
|
"description": "Ask the runtime to revalidate the selected same card while suspended; preserves RAM and continuation. Requires negotiated protocol 1.1 memcard capability.",
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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_memcard_continue_in_memory",
|
|
"authority": "task",
|
|
"description": "Explicitly continue a suspended session in RAM through the runtime; no durability claim. Requires negotiated protocol 1.1 memcard capability.",
|
|
"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"
|
|
},
|
|
"runtimeError": {
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
},
|
|
"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"
|
|
}
|
|
}
|
|
]
|
|
}
|