{ "$schema": "http://json-schema.org/draft-07/schema#", "title": "ThreadForkParams", "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using a non-empty path, the thread_id param will be ignored. Empty string path values are treated as absent.\n\nPrefer using thread_id whenever possible.", "type": "object", "required": [ "threadId" ], "properties": { "approvalPolicy": { "anyOf": [ { "$ref": "#/definitions/AskForApproval" }, { "type": "null" } ] }, "approvalsReviewer": { "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" }, { "type": "null" } ] }, "baseInstructions": { "type": [ "string", "null" ] }, "config": { "type": [ "object", "null" ], "additionalProperties": true }, "cwd": { "type": [ "string", "null" ] }, "developerInstructions": { "type": [ "string", "null" ] }, "ephemeral": { "type": "boolean" }, "sandbox": { "anyOf": [ { "$ref": "#/definitions/SandboxMode" }, { "type": "null" } ] }, "model": { "description": "Configuration overrides for the forked thread, if any.", "type": [ "string", "null" ] }, "modelProvider": { "type": [ "string", "null" ] }, "serviceTier": { "type": [ "string", "null" ] }, "threadId": { "type": "string" }, "threadSource": { "description": "Optional client-supplied analytics source classification for this forked thread.", "anyOf": [ { "$ref": "#/definitions/ThreadSource" }, { "type": "null" } ] } }, "definitions": { "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" ] }, "AskForApproval": { "oneOf": [ { "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" ] }, { "type": "object", "required": [ "granular" ], "properties": { "granular": { "type": "object", "required": [ "mcp_elicitations", "rules", "sandbox_approval" ], "properties": { "mcp_elicitations": { "type": "boolean" }, "request_permissions": { "default": false, "type": "boolean" }, "rules": { "type": "boolean" }, "sandbox_approval": { "type": "boolean" }, "skill_approval": { "default": false, "type": "boolean" } } } }, "additionalProperties": false, "title": "GranularAskForApproval" } ] }, "SandboxMode": { "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" ] }, "ThreadSource": { "type": "string", "enum": [ "user", "subagent", "memory_consolidation" ] } } }