viberoom 0.3.0 → 0.4.0

package/vendor/acp/claude-agent-sdk/sdk-tools.d.ts

@@ -0,0 +1,4129 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+
+/**
+ * JSON Schema definitions for Claude CLI tool inputs
+ */
+export type ToolInputSchemas =
+  | AgentInput
+  | BashInput
+  | TaskOutputInput
+  | ExitPlanModeInput
+  | FileEditInput
+  | FileReadInput
+  | FileWriteInput
+  | GlobInput
+  | GrepInput
+  | TaskStopInput
+  | ListMcpResourcesInput
+  | RefreshMcpToolsInput
+  | McpInput
+  | NotebookEditInput
+  | ReadMcpResourceDirInput
+  | ReadMcpResourceInput
+  | ReportFindingsInput
+  | TodoWriteInput
+  | WebFetchInput
+  | WebSearchInput
+  | AskUserQuestionInput
+  | SendFeedbackInput
+  | ClaudeDesignInput
+  | ProjectsInput
+  | EnterPlanModeInput
+  | TaskCreateInput
+  | TaskGetInput
+  | TaskUpdateInput
+  | TaskListInput
+  | REPLInput
+  | WorkflowInput
+  | CronCreateInput
+  | CronDeleteInput
+  | CronListInput
+  | ScheduleWakeupInput
+  | RemoteTriggerInput
+  | ShowOnboardingRolePickerInput
+  | ReadNotificationsInput
+  | MonitorInput
+  | ProposeSkillsInput
+  | ProposeGoalInput
+  | ArtifactInput
+  | PushNotificationInput
+  | EnterWorktreeInput
+  | ExitWorktreeInput
+  | ToolOutputSchemas;
+export type ToolOutputSchemas =
+  | AgentOutput
+  | BashOutput
+  | ExitPlanModeOutput
+  | FileEditOutput
+  | FileReadOutput
+  | FileWriteOutput
+  | GlobOutput
+  | GrepOutput
+  | TaskStopOutput
+  | ListMcpResourcesOutput
+  | RefreshMcpToolsOutput
+  | McpOutput
+  | NotebookEditOutput
+  | ReadMcpResourceDirOutput
+  | ReadMcpResourceOutput
+  | ReportFindingsOutput
+  | TodoWriteOutput
+  | WebFetchOutput
+  | WebSearchOutput
+  | AskUserQuestionOutput
+  | SendFeedbackOutput
+  | EnterWorktreeOutput
+  | ExitWorktreeOutput
+  | TaskCreateOutput
+  | TaskGetOutput
+  | TaskUpdateOutput
+  | TaskListOutput
+  | ArtifactOutput
+  | RemoteTriggerOutput
+  | ShowOnboardingRolePickerOutput
+  | ReadNotificationsOutput
+  | ScheduleWakeupOutput
+  | MonitorOutput
+  | ProposeSkillsOutput
+  | ProposeGoalOutput
+  | EnterPlanModeOutput
+  | REPLOutput
+  | WorkflowOutput
+  | CronCreateOutput
+  | CronDeleteOutput
+  | CronListOutput
+  | PushNotificationOutput
+  | ClaudeDesignOutput
+  | ProjectsOutput;
+export type AgentOutput =
+  | {
+      agentId: string;
+      agentType?: string;
+      content: {
+        type: "text";
+        text: string;
+        citations?: unknown[] | null;
+      }[];
+      resolvedModel?: string;
+      modelsUsed?: string[];
+      totalToolUseCount: number;
+      totalDurationMs: number;
+      totalTokens: number;
+      usage: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens: number | null;
+        cache_read_input_tokens: number | null;
+        server_tool_use: {
+          web_search_requests: number;
+          web_fetch_requests: number;
+        } | null;
+        service_tier: string | null;
+        cache_creation: {
+          ephemeral_1h_input_tokens: number;
+          ephemeral_5m_input_tokens: number;
+        } | null;
+        inference_geo?: string | null;
+        speed?: string | null;
+        iterations?: unknown;
+        output_tokens_details?: {
+          thinking_tokens?: number | null;
+        } | null;
+      };
+      toolStats?: {
+        readCount: number;
+        searchCount: number;
+        bashCount: number;
+        editFileCount: number;
+        linesAdded: number;
+        linesRemoved: number;
+        otherToolCount: number;
+        frameCount?: number;
+      };
+      status: "completed";
+      prompt: string;
+      worktreePath?: string;
+      worktreeBranch?: string;
+    }
+  | {
+      status: "async_launched";
+      isAsync?: true;
+      /**
+       * The ID of the async agent
+       */
+      agentId: string;
+      /**
+       * The description of the task
+       */
+      description: string;
+      /**
+       * Model in use at the backgrounding transition (a pre-background swap is reflected here)
+       */
+      resolvedModel?: string;
+      /**
+       * Ordered distinct models used before backgrounding (length > 1 means a mid-run swap)
+       */
+      modelsUsed?: string[];
+      /**
+       * The prompt for the agent
+       */
+      prompt: string;
+      /**
+       * Path to the output file for checking agent progress
+       */
+      outputFile: string;
+      /**
+       * Whether the calling agent has Read/Bash tools to check progress
+       */
+      canReadOutputFile?: boolean;
+    }
+  | {
+      status: "remote_launched";
+      /**
+       * The ID of the remote agent task
+       */
+      taskId: string;
+      /**
+       * The URL of the cloud session
+       */
+      sessionUrl: string;
+      /**
+       * The description of the task
+       */
+      description: string;
+      /**
+       * The prompt for the agent
+       */
+      prompt: string;
+      /**
+       * Path to the output file for checking agent progress
+       */
+      outputFile: string;
+    };
+export type FileReadOutput =
+  | {
+      type: "text";
+      file: {
+        /**
+         * The path to the file that was read
+         */
+        filePath: string;
+        /**
+         * The content of the file
+         */
+        content: string;
+        /**
+         * Number of lines in the returned content
+         */
+        numLines: number;
+        /**
+         * The starting line number
+         */
+        startLine: number;
+        /**
+         * Total number of lines in the file
+         */
+        totalLines: number;
+        /**
+         * True when a whole-file read was auto-paginated because it exceeded the token cap (the content is a partial first page). A programmatic signal for internal consumers; survives output reconstruction (unlike the render-time banner).
+         */
+        truncatedByTokenCap?: boolean;
+      };
+      /**
+       * Set when this Read completed a saved Artifact source file: the Artifact and the version of it that now counts as viewed.
+       */
+      artifactRead?: {
+        slug: string;
+        ver: string;
+      };
+    }
+  | {
+      type: "image";
+      file: {
+        /**
+         * Base64-encoded image data
+         */
+        base64: string;
+        /**
+         * The MIME type of the image
+         */
+        type: "image/jpeg" | "image/png" | "image/gif" | "image/webp";
+        /**
+         * Original file size in bytes
+         */
+        originalSize: number;
+        /**
+         * Image dimension info for coordinate mapping
+         */
+        dimensions?: {
+          /**
+           * Original image width in pixels
+           */
+          originalWidth?: number;
+          /**
+           * Original image height in pixels
+           */
+          originalHeight?: number;
+          /**
+           * Displayed image width in pixels (after resizing)
+           */
+          displayWidth?: number;
+          /**
+           * Displayed image height in pixels (after resizing)
+           */
+          displayHeight?: number;
+        };
+      };
+    }
+  | {
+      type: "notebook";
+      file: {
+        /**
+         * The path to the notebook file
+         */
+        filePath: string;
+        /**
+         * Array of notebook cells
+         */
+        cells: unknown[];
+      };
+    }
+  | {
+      type: "pdf";
+      file: {
+        /**
+         * The path to the PDF file
+         */
+        filePath: string;
+        /**
+         * Base64-encoded PDF data
+         */
+        base64: string;
+        /**
+         * Original file size in bytes
+         */
+        originalSize: number;
+      };
+    }
+  | {
+      type: "parts";
+      file: {
+        /**
+         * The path to the PDF file
+         */
+        filePath: string;
+        /**
+         * Original file size in bytes
+         */
+        originalSize: number;
+        /**
+         * Number of pages extracted
+         */
+        count: number;
+        /**
+         * Directory containing extracted page images
+         */
+        outputDir: string;
+      };
+      /**
+       * Document page number of the first extracted page (1 when no range was requested); labels the page images in the model-facing tool_result
+       */
+      firstPage?: number;
+      /**
+       * Extracted page images, in page order. Present only transiently in-process: the page image bytes are delivered solely as image blocks in the model-facing tool_result content and are not retained on the tool_use_result, so this key is absent on the emitted/persisted result
+       */
+      pages?: {
+        /**
+         * Base64-encoded page image; empty when the page could not be processed
+         */
+        base64: string;
+        /**
+         * The MIME type of the image
+         */
+        mediaType: "image/jpeg" | "image/png" | "image/gif" | "image/webp";
+        /**
+         * Why the page could not be processed as an image; set only when base64 is empty
+         */
+        error?: string;
+      }[];
+    }
+  | {
+      type: "file_unchanged";
+      file: {
+        /**
+         * The path to the file
+         */
+        filePath: string;
+      };
+      /**
+       * Set when the dedup matched a startup-seeded entry (CLAUDE.md / nested memory) rather than a prior Read tool_result
+       */
+      source?: "seeded";
+    };
+export type ListMcpResourcesOutput = {
+  /**
+   * Resource URI
+   */
+  uri: string;
+  /**
+   * Resource name
+   */
+  name: string;
+  /**
+   * MIME type of the resource
+   */
+  mimeType?: string;
+  /**
+   * Resource description
+   */
+  description?: string;
+  /**
+   * Server that provides this resource
+   */
+  server: string;
+}[];
+export type RefreshMcpToolsOutput = {
+  /**
+   * Server name
+   */
+  server: string;
+  /**
+   * refreshed: tool list re-queried and applied. error: the re-query failed and the previous tool set was kept. not_connected: the server has no live connection to query (this tool never dials).
+   */
+  status: "refreshed" | "error" | "not_connected";
+  /**
+   * Number of tools now available from this server
+   */
+  toolCount?: number;
+  /**
+   * Tool names this refresh added
+   */
+  added?: string[];
+  /**
+   * Tool names this refresh removed
+   */
+  removed?: string[];
+  /**
+   * Why the refresh failed or the server was unavailable
+   */
+  error?: string;
+}[];
+/**
+ * MCP tool execution result
+ */
+export type McpOutput =
+  | string
+  | {
+      type: string;
+      [k: string]: unknown;
+    }[]
+  | {
+      [k: string]: unknown;
+    };
+export type ArtifactOutput =
+  | {
+      url: string;
+      path: string;
+      artifact_id?: string;
+      title?: string;
+      version?: string;
+      capabilities?: unknown;
+      stored?: {
+        contract: string;
+        preferredContract?: string;
+        capabilities?: {
+          [k: string]: unknown;
+        };
+        carried?: boolean;
+        read?: string;
+      };
+      warnings?: string[];
+      contract?: string;
+      updated?: boolean;
+      audience?: string;
+      liveSubscription?: string;
+    }
+  | {
+      artifacts: {
+        title: string;
+        url: string;
+        favicon?: string;
+        updatedAt?: string;
+        rel?: "mine" | "shared";
+      }[];
+      truncated?: boolean;
+      scope?: "shared" | "all";
+    }
+  | {
+      read: {
+        url: string;
+        bytes: number;
+        code: number;
+        codeText: string;
+        result: string;
+        durationMs: number;
+      };
+      artifactRead?: {
+        slug: string;
+        ver?: string;
+        seeded?: false;
+      };
+    }
+  | {
+      watch: {
+        url: string;
+        watching: boolean;
+        outcome: string;
+        reason?: string;
+        durable_skip_reason?: string;
+        task_id?: string;
+        since?: number;
+        token_expires_at?: number;
+        rail?: string;
+        trigger_id?: string;
+        durable_since?: string;
+        status?: number;
+        detail?: string;
+        note?: string;
+        events?: string[];
+      };
+    }
+  | {
+      unwatch: {
+        url: string;
+        was_watching: boolean;
+      };
+    }
+  | {
+      watches: (
+        | {
+            url: string;
+            task_id: string;
+            since: number;
+            explicit: boolean;
+            connected: boolean;
+            connecting?: boolean;
+            token_expires_at: number;
+            armed_via?: string;
+          }
+        | {
+            url: string;
+            rail: "durable_wake";
+            trigger_id: string;
+            since: string;
+            events?: string[];
+            restored?: boolean;
+          }
+        | {
+            url: string;
+            rail: "live_stopped";
+            since?: number;
+            explicit?: boolean;
+            armed_via?: string;
+            stop_kind: string;
+          }
+      )[];
+      filter_url?: string;
+      arms?: {
+        url: string;
+        rail?: string;
+        state: string;
+        reconnect?: boolean;
+        failures?: number;
+        max_failures?: number;
+        next_in_s?: number;
+        last_failure?: string;
+        reason?: string;
+        detail?: string;
+        server_message?: string;
+        at?: number;
+      }[];
+    }
+  | {
+      asset_upload: {
+        id: string;
+        url: string;
+        size_bytes: number;
+        content_type: string;
+        sha256?: string;
+        file_name: string;
+      };
+    }
+  | {
+      asset_list: {
+        url: string;
+        /**
+         * @maxItems 1000
+         */
+        assets: {
+          id: string;
+          url: string;
+          content_type: string;
+          size_bytes: number;
+          sha256?: string;
+          created_at: string;
+        }[];
+        usage: {
+          files: number;
+          bytes: number;
+          max_files: number;
+          max_bytes: number;
+        };
+        next?: string;
+      };
+    }
+  | {
+      asset_read: {
+        id: string;
+        path: string;
+        size_bytes: number;
+        content_type: string;
+        sha256: string;
+      };
+    }
+  | {
+      asset_delete: {
+        id: string;
+        deleted: boolean;
+      };
+    };
+export type ProjectsOutput =
+  | {
+      method: "project_info";
+      notice?: string;
+      name: string;
+      description: string;
+      instructions: string;
+      docs: {
+        path: string;
+        created_at: string | null;
+      }[];
+      files?: {
+        path: string;
+        file_kind: string;
+        created_at: string | null;
+      }[];
+      sync_sources?: {
+        type: string | null;
+        config: {
+          [k: string]: unknown;
+        };
+      }[];
+      knowledge: {
+        knowledge_size: number;
+        max_knowledge_size: number;
+      };
+    }
+  | {
+      method: "project_read";
+      notice?: string;
+      path: string;
+      file_kind?: string;
+      content?: string;
+      local_file?: string;
+      created_at: string | null;
+    }
+  | {
+      method: "project_search";
+      notice?: string;
+      rag: boolean;
+      hits?: {
+        name?: string;
+        doc_uuid?: string;
+        text?: string;
+      }[];
+      docs?: string[];
+    }
+  | {
+      method: "project_write";
+      notice?: string;
+      path: string;
+      doc_uuid: string;
+      replaced: boolean;
+      present_to_user?: boolean;
+      local_path?: string;
+    }
+  | {
+      method: "project_delete";
+      notice?: string;
+      path: string;
+      deleted: boolean;
+    };
+
+export interface AgentInput {
+  /**
+   * A short (3-5 word) description of the task
+   */
+  description: string;
+  /**
+   * The task for the agent to perform
+   */
+  prompt: string;
+  /**
+   * The type of specialized agent to use for this task
+   */
+  subagent_type?: string;
+  /**
+   * Optional model override for this agent. Takes precedence over the agent definition's model frontmatter and the configured default subagent model. If omitted, uses the agent definition's model, else the default (inherits from the parent unless a default subagent model is configured). Ignored for subagent_type: "fork" — forks always inherit the parent model.
+   */
+  model?: "sonnet" | "opus" | "haiku" | "fable";
+  /**
+   * Agents run in the background by default; you will be notified when one completes. Set to false only when your very next action depends on this agent's result and nothing else could usefully happen while it runs — otherwise leave it in the background so the user can hand you other work.
+   */
+  run_in_background?: boolean;
+  /**
+   * Name for the spawned agent. Makes it addressable via SendMessage({to: name}) while running.
+   */
+  name?: string;
+  /**
+   * Deprecated; ignored. The session has a single implicit team.
+   */
+  team_name?: string;
+  /**
+   * Deprecated; ignored. Subagents inherit the parent session's permission mode; agent-definition frontmatter may override it.
+   */
+  mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+  /**
+   * Isolation mode. "worktree" creates a temporary git worktree so the agent works on an isolated copy of the repo. "remote" launches the agent in a remote cloud environment (always runs in background; availability is gated).
+   */
+  isolation?: "worktree" | "remote";
+}
+export interface BashInput {
+  /**
+   * The command to execute
+   */
+  command: string;
+  /**
+   * Optional timeout in milliseconds (max 600000)
+   */
+  timeout?: number;
+  /**
+   * Clear, concise description of what this command does in active voice. Never use words like "complex" or "risk" in the description - just describe what it does.
+   *
+   * For simple commands (git, npm, standard CLI tools), keep it brief (5-10 words):
+   * - ls → "List files in current directory"
+   * - git status → "Show working tree status"
+   * - npm install → "Install package dependencies"
+   *
+   * For commands that are harder to parse at a glance (piped commands, obscure flags, etc.), add enough context to clarify what it does:
+   * - find . -name "*.tmp" -exec rm {} \; → "Find and delete all .tmp files recursively"
+   * - git reset --hard origin/main → "Discard all local changes and match remote main"
+   * - curl -s url | jq '.data[]' → "Fetch JSON from URL and extract data array elements"
+   */
+  description?: string;
+  /**
+   * Set to true to run this command in the background.
+   */
+  run_in_background?: boolean;
+  /**
+   * Set this to true to dangerously override sandbox mode and run commands without sandboxing.
+   */
+  dangerouslyDisableSandbox?: boolean;
+}
+export interface TaskOutputInput {
+  /**
+   * The task ID to get output from
+   */
+  task_id: string;
+  /**
+   * Whether to wait for completion
+   */
+  block: boolean;
+  /**
+   * Max wait time in ms
+   */
+  timeout: number;
+}
+export interface ExitPlanModeInput {
+  /**
+   * Deprecated: no longer used.
+   */
+  allowedPrompts?: {
+    /**
+     * The tool this prompt applies to
+     */
+    tool: "Bash";
+    /**
+     * Semantic description of the action, e.g. "run tests", "install dependencies"
+     */
+    prompt: string;
+  }[];
+  [k: string]: unknown;
+}
+export interface FileEditInput {
+  /**
+   * The absolute path to the file to modify
+   */
+  file_path: string;
+  /**
+   * The text to replace
+   */
+  old_string: string;
+  /**
+   * The text to replace it with (must be different from old_string)
+   */
+  new_string: string;
+  /**
+   * Replace all occurrences of old_string (default false)
+   */
+  replace_all?: boolean;
+}
+export interface FileReadInput {
+  /**
+   * The absolute path to the file to read
+   */
+  file_path: string;
+  /**
+   * The line number to start reading from. Only provide if the file is too large to read at once
+   */
+  offset?: number;
+  /**
+   * The number of lines to read. Only provide if the file is too large to read at once.
+   */
+  limit?: number;
+  /**
+   * Page range for PDF files (e.g., "1-5", "3", "10-20"). Only applicable to PDF files. Maximum 20 pages per request.
+   */
+  pages?: string;
+}
+export interface FileWriteInput {
+  /**
+   * The absolute path to the file to write (must be absolute, not relative)
+   */
+  file_path: string;
+  /**
+   * The content to write to the file
+   */
+  content: string;
+}
+export interface GlobInput {
+  /**
+   * The glob pattern to match files against
+   */
+  pattern: string;
+  /**
+   * The directory to search in. If not specified, the current working directory will be used. IMPORTANT: Omit this field to use the default directory. DO NOT enter "undefined" or "null" - simply omit it for the default behavior. Must be a valid directory path if provided.
+   */
+  path?: string;
+}
+export interface GrepInput {
+  /**
+   * The regular expression pattern to search for in file contents
+   */
+  pattern: string;
+  /**
+   * File or directory to search in (rg PATH). Defaults to current working directory.
+   */
+  path?: string;
+  /**
+   * Glob pattern to filter files (e.g. "*.js", "*.{ts,tsx}") - maps to rg --glob
+   */
+  glob?: string;
+  /**
+   * Output mode: "content" shows matching lines (supports -A/-B/-C context, -n line numbers, head_limit), "files_with_matches" shows file paths (supports head_limit), "count" shows match counts (supports head_limit). Defaults to "files_with_matches".
+   */
+  output_mode?: "content" | "files_with_matches" | "count";
+  /**
+   * Number of lines to show before each match (rg -B). Requires output_mode: "content", ignored otherwise.
+   */
+  "-B"?: number;
+  /**
+   * Number of lines to show after each match (rg -A). Requires output_mode: "content", ignored otherwise.
+   */
+  "-A"?: number;
+  /**
+   * Alias for context.
+   */
+  "-C"?: number;
+  /**
+   * Number of lines to show before and after each match (rg -C). Requires output_mode: "content", ignored otherwise.
+   */
+  context?: number;
+  /**
+   * Show line numbers in output (rg -n). Requires output_mode: "content", ignored otherwise. Defaults to true.
+   */
+  "-n"?: boolean;
+  /**
+   * Case insensitive search (rg -i)
+   */
+  "-i"?: boolean;
+  /**
+   * Print only the matched (non-empty) parts of each matching line, one match per output line (rg -o / --only-matching). Requires output_mode: "content", ignored otherwise. Defaults to false.
+   */
+  "-o"?: boolean;
+  /**
+   * File type to search (rg --type). Common types: js, py, rust, go, java, etc. More efficient than include for standard file types.
+   */
+  type?: string;
+  /**
+   * Limit output to first N lines/entries, equivalent to "| head -N". Works across all output modes: content (limits output lines), files_with_matches (limits file paths), count (limits count entries). Defaults to 250 when unspecified. Pass 0 for unlimited (use sparingly — large result sets waste context).
+   */
+  head_limit?: number;
+  /**
+   * Skip first N lines/entries before applying head_limit, equivalent to "| tail -n +N | head -N". Works across all output modes. Defaults to 0.
+   */
+  offset?: number;
+  /**
+   * Enable multiline mode where . matches newlines and patterns can span lines (rg -U --multiline-dotall). Default: false.
+   */
+  multiline?: boolean;
+}
+export interface TaskStopInput {
+  /**
+   * The ID of the background task to stop. Agent-team teammates and named background agents are also accepted by agent ID or name.
+   */
+  task_id?: string;
+  /**
+   * Deprecated: use task_id instead
+   */
+  shell_id?: string;
+}
+export interface ListMcpResourcesInput {
+  /**
+   * Optional server name to filter resources by
+   */
+  server?: string;
+}
+export interface RefreshMcpToolsInput {
+  /**
+   * Optional server name: refresh only this server. Omit to refresh all connected servers.
+   */
+  server?: string;
+}
+export interface McpInput {
+  [k: string]: unknown;
+}
+export interface NotebookEditInput {
+  /**
+   * The absolute path to the Jupyter notebook file to edit (must be absolute, not relative)
+   */
+  notebook_path: string;
+  /**
+   * The ID of the cell to edit. When inserting a new cell, the new cell will be inserted after the cell with this ID, or at the beginning if not specified.
+   */
+  cell_id?: string;
+  /**
+   * The new source for the cell
+   */
+  new_source: string;
+  /**
+   * The type of the cell (code or markdown). If not specified, it defaults to the current cell type. If using edit_mode=insert, this is required.
+   */
+  cell_type?: "code" | "markdown";
+  /**
+   * The type of edit to make (replace, insert, delete). Defaults to replace.
+   */
+  edit_mode?: "replace" | "insert" | "delete";
+}
+export interface ReadMcpResourceDirInput {
+  /**
+   * The MCP server name
+   */
+  server: string;
+  /**
+   * The directory resource URI to list
+   */
+  uri: string;
+}
+export interface ReadMcpResourceInput {
+  /**
+   * The MCP server name
+   */
+  server: string;
+  /**
+   * The resource URI to read
+   */
+  uri: string;
+}
+export interface ReportFindingsInput {
+  /**
+   * Effort level the review ran at
+   */
+  level?: "low" | "medium" | "high" | "xhigh" | "max";
+  /**
+   * Verified findings, most-severe first; empty if none survived
+   *
+   * @maxItems 32
+   */
+  findings: {
+    /**
+     * Repo-relative path of the file the finding is in
+     */
+    file: string;
+    /**
+     * 1-indexed line the finding anchors to
+     */
+    line?: number;
+    /**
+     * One-sentence statement of the defect
+     */
+    summary: string;
+    /**
+     * Compressed label for compact UI (≤60 chars): the claim alone, no rationale or consequence clause
+     */
+    short_summary?: string;
+    /**
+     * Concrete inputs/state → wrong output/crash
+     */
+    failure_scenario: string;
+    /**
+     * Short kebab-case slug of the finding type, e.g. "correctness", "simplification", "efficiency", "test-coverage"
+     */
+    category?: string;
+    /**
+     * Set when a verify pass ran; absent on inline-only reviews
+     */
+    verdict?: "CONFIRMED" | "PLAUSIBLE";
+    /**
+     * Set ONLY when re-reporting after applying fixes: what happened to this finding
+     */
+    outcome?: "fixed" | "skipped" | "no_change_needed";
+  }[];
+}
+export interface TodoWriteInput {
+  /**
+   * The updated todo list
+   */
+  todos: {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    activeForm: string;
+  }[];
+}
+export interface WebFetchInput {
+  /**
+   * The URL to fetch content from
+   */
+  url: string;
+  /**
+   * The prompt to run on the fetched content
+   */
+  prompt: string;
+}
+export interface WebSearchInput {
+  /**
+   * The search query to use
+   */
+  query: string;
+  /**
+   * Only include search results from these domains
+   */
+  allowed_domains?: string[];
+  /**
+   * Never include search results from these domains
+   */
+  blocked_domains?: string[];
+}
+export interface AskUserQuestionInput {
+  /**
+   * Questions to ask the user (1-4 questions)
+   *
+   * @minItems 1
+   * @maxItems 4
+   */
+  questions:
+    | [
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        }
+      ]
+    | [
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        }
+      ]
+    | [
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        }
+      ]
+    | [
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        },
+        {
+          /**
+           * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+           */
+          question: string;
+          /**
+           * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+           */
+          header: string;
+          /**
+           * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+           *
+           * @minItems 2
+           * @maxItems 4
+           */
+          options:
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ]
+            | [
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                },
+                {
+                  /**
+                   * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+                   */
+                  label: string;
+                  /**
+                   * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+                   */
+                  description: string;
+                  /**
+                   * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+                   */
+                  preview?: string;
+                }
+              ];
+          /**
+           * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+           */
+          multiSelect: boolean;
+        }
+      ];
+  /**
+   * User answers collected by the permission component
+   */
+  answers?: {
+    [k: string]: string;
+  };
+  /**
+   * Optional per-question annotations from the user (e.g., notes on preview selections). Keyed by question text.
+   */
+  annotations?: {
+    [k: string]: {
+      /**
+       * The preview content of the selected option, if the question used previews.
+       */
+      preview?: string;
+      /**
+       * Free-text notes the user added to their selection.
+       */
+      notes?: string;
+    };
+  };
+  /**
+   * Optional metadata for tracking and analytics purposes. Not displayed to user.
+   */
+  metadata?: {
+    /**
+     * Optional identifier for the source of this question (e.g., "remember" for /remember command). Used for analytics tracking.
+     */
+    source?: string;
+  };
+}
+export interface SendFeedbackInput {
+  /**
+   * What kind of feedback this is.
+   */
+  type: "bug" | "idea" | "missing_capability";
+  /**
+   * Short, specific one-line summary of the issue.
+   */
+  title: string;
+  /**
+   * Labeled bullets, in order: **What happened:** (observed vs. expected, exact error text if short); **What the user said:** (quoted, or "User didn't comment; observed by the model."); **Repro:** (minimal steps); **Evidence:** (request IDs, timestamps, paths, versions; omit if none); optionally a final **Cause:** only if verified in-session. One to three lines per bullet. No narrative paragraphs, no speculation, no secrets.
+   */
+  details: string;
+  /**
+   * Optional short tag naming the part of Claude Code this is about (e.g. "hooks config", "/help", "file editing"). Leave blank if unclear.
+   */
+  area?: string;
+  /**
+   * When the report is about MODEL BEHAVIOR (not a product bug), the closest failure mode, or `other` when it is a model-behavior issue that fits no listed value. Omit only when the report is a product/tool bug with no model-behavior component.
+   */
+  failure_mode?:
+    | "instruction_following"
+    | "destructive_actions"
+    | "code_quality"
+    | "repetition_and_looping"
+    | "model_regression"
+    | "overconfidence_and_hallucination"
+    | "context_and_memory"
+    | "overeager"
+    | "over_correction"
+    | "stopping_short"
+    | "dispute_or_decline"
+    | "subagent_overspawn"
+    | "tone_or_preachiness"
+    | "excessive_questions"
+    | "unwanted_scope"
+    | "other";
+  /**
+   * What kind of task the session was doing when the issue occurred, or `other` when it is a clear task that fits no listed value. Omit only if genuinely unclear.
+   */
+  task_category?: "code_edit" | "debug" | "explain" | "plan" | "shell" | "search" | "review" | "other";
+}
+export interface ClaudeDesignInput {
+  /**
+   * Claude Design action to perform. Call with "list" first to discover the available operations and their argument schemas.
+   */
+  operation: string;
+  /**
+   * Action input object (server-validated). Pass {} for operations that take no input.
+   */
+  arguments: {
+    [k: string]: unknown;
+  };
+}
+export interface ProjectsInput {
+  method: "project_info" | "project_read" | "project_search" | "project_write" | "project_delete";
+  /**
+   * project_read/project_write/project_delete: doc path. project_write: an existing path is replaced in place; a new bare filename (no "/") is namespaced to "claude/<name>".
+   */
+  path?: string;
+  /**
+   * project_write: inline doc text. Mutually exclusive with local_path. Use local_path for anything you have on disk.
+   */
+  content?: string;
+  /**
+   * project_write: a file inside the working directory to upload. The tool reads, encodes, and uploads directly — contents never enter your context. Mutually exclusive with content.
+   */
+  local_path?: string;
+  /**
+   * project_write: true marks this doc as the file the user needs to see — the deliverable they asked for or must act on. Defaults to false; leave it unset for routine saves, notes, and bulk writes.
+   */
+  present_to_user?: boolean;
+  /**
+   * project_search: knowledge-base query
+   */
+  query?: string;
+  /**
+   * project_search: number of hits (default 5)
+   */
+  n?: number;
+}
+export interface EnterPlanModeInput {}
+export interface TaskCreateInput {
+  /**
+   * A brief title for the task
+   */
+  subject: string;
+  /**
+   * What needs to be done
+   */
+  description: string;
+  /**
+   * Present continuous form shown in spinner when in_progress (e.g., "Running tests")
+   */
+  activeForm?: string;
+  /**
+   * Arbitrary metadata to attach to the task
+   */
+  metadata?: {
+    [k: string]: unknown;
+  };
+}
+export interface TaskGetInput {
+  /**
+   * The ID of the task to retrieve
+   */
+  taskId: string;
+}
+export interface TaskUpdateInput {
+  /**
+   * The ID of the task to update
+   */
+  taskId: string;
+  /**
+   * New subject for the task
+   */
+  subject?: string;
+  /**
+   * New description for the task
+   */
+  description?: string;
+  /**
+   * Present continuous form shown in spinner when in_progress (e.g., "Running tests")
+   */
+  activeForm?: string;
+  /**
+   * New status for the task
+   */
+  status?: ("pending" | "in_progress" | "completed") | "deleted";
+  /**
+   * Task IDs that this task blocks
+   */
+  addBlocks?: string[];
+  /**
+   * Task IDs that block this task
+   */
+  addBlockedBy?: string[];
+  /**
+   * New owner for the task
+   */
+  owner?: string;
+  /**
+   * Metadata keys to merge into the task. Set a key to null to delete it.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  };
+}
+export interface TaskListInput {}
+export interface REPLInput {
+  /**
+   * JavaScript code to execute. Supports top-level await. State persists across calls.
+   */
+  code: string;
+  /**
+   * Clear, concise description of what this script does in active voice (5-10 words). E.g. "Trace upgrade message to its GrowthBook flag"
+   */
+  description?: string;
+  /**
+   * Optional timeout in milliseconds (default 30000, max 600000)
+   */
+  timeout?: number;
+}
+export interface WorkflowInput {
+  /**
+   * Self-contained workflow script. Must begin with `export const meta = { name, description, phases }` (pure literal, no computed values) followed by the script body using agent()/parallel()/pipeline()/phase().
+   */
+  script?: string;
+  /**
+   * Name of a predefined workflow (built-in or from .claude/workflows/). Resolves to a self-contained script.
+   */
+  name?: string;
+  /**
+   * Ignored — set the workflow description in the script's `meta` block.
+   */
+  description?: string;
+  /**
+   * Ignored — set the workflow title in the script's `meta` block.
+   */
+  title?: string;
+  /**
+   * Optional input value exposed to the script as the global `args`, verbatim. Pass arrays/objects as actual JSON values, NOT as a JSON-encoded string — a stringified list breaks `args.filter`/`args.map` in the script. Use for parameterized named workflows (e.g. a research question).
+   */
+  args?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Path to a workflow script file on disk. Every Workflow invocation persists its script under the session directory and returns the path in the tool result. To iterate, edit that file with Write/Edit and re-invoke Workflow with the same `scriptPath` instead of re-sending the full script. Takes precedence over `script` and `name`.
+   */
+  scriptPath?: string;
+  /**
+   * Run ID of a prior Workflow invocation to resume from. Completed agent() calls with unchanged (prompt, opts) return their cached results instantly; only edited or new calls re-run. Same-session only. Stop the prior run first (TaskStop) before resuming.
+   */
+  resumeFromRunId?: string;
+}
+export interface CronCreateInput {
+  /**
+   * Standard 5-field cron expression in local time: "M H DoM Mon DoW" (e.g. "* /5 * * * *" = every 5 minutes, "30 14 28 2 *" = Feb 28 at 2:30pm local once).
+   */
+  cron: string;
+  /**
+   * The prompt to enqueue at each fire time.
+   */
+  prompt: string;
+  /**
+   * true (default) = fire on every cron match until deleted or auto-expired after 7 days. false = fire once at the next match, then auto-delete. Use false for "remind me at X" one-shot requests with pinned minute/hour/dom/month.
+   */
+  recurring?: boolean;
+  /**
+   * true = persist to .claude/scheduled_tasks.json and survive restarts. false (default) = in-memory only, dies when this Claude session ends. Use true only when the user asks the task to survive across sessions.
+   */
+  durable?: boolean;
+}
+export interface CronDeleteInput {
+  /**
+   * Job ID returned by CronCreate.
+   */
+  id: string;
+}
+export interface CronListInput {}
+export interface ScheduleWakeupInput {
+  /**
+   * Seconds from now to wake up. Clamped to [60, 3600] by the runtime. Required unless `stop` is true.
+   */
+  delaySeconds?: number;
+  /**
+   * One short sentence explaining the chosen delay. Goes to telemetry and is shown to the user. Be specific. Required unless `stop` is true.
+   */
+  reason?: string;
+  /**
+   * The /loop input to fire on wake-up. Pass the same /loop input verbatim each turn so the next firing re-enters the skill and continues the loop. For autonomous /loop (no user prompt), pass the literal sentinel `<<autonomous-loop-dynamic>>` instead (the dynamic-pacing variant, not the CronCreate-mode `<<autonomous-loop>>`). Required unless `stop` is true.
+   */
+  prompt?: string;
+  /**
+   * Set to true to end the dynamic loop immediately instead of scheduling another wakeup. When true, all other fields are ignored and no further wakeups fire.
+   */
+  stop?: boolean;
+  /**
+   * true = nothing changed (you checked and there is nothing to report). false = something happened worth keeping (edited a file, posted a message, advanced state, surfaced a finding). Consecutive noop:true ticks are collapsed in the user's terminal view and tracked as a streak. Required unless `stop` is true.
+   */
+  noop?: boolean;
+}
+export interface RemoteTriggerInput {
+  action: "list" | "get" | "create" | "update" | "run" | "create_webhook_trigger" | "list_runs" | "get_run_log";
+  /**
+   * Required for get, update, run, and list_runs
+   */
+  trigger_id?: string;
+  /**
+   * Required for get_run_log: a run session id (cse_… or session_…, from list_runs)
+   */
+  session_id?: string;
+  /**
+   * next_cursor from a previous list_runs or get_run_log page
+   */
+  cursor?: string;
+  /**
+   * Required for create and update; optional for run
+   */
+  body?: {
+    [k: string]: unknown;
+  };
+}
+export interface ShowOnboardingRolePickerInput {}
+export interface ReadNotificationsInput {}
+export interface MonitorInput {
+  /**
+   * Short human-readable description of what you are monitoring (shown in notifications).
+   */
+  description: string;
+  /**
+   * Kill the monitor after this deadline. Default 300000ms, max 3600000ms. Ignored when persistent is true.
+   */
+  timeout_ms: number;
+  /**
+   * Run for the lifetime of the session (no timeout). Use for session-length watches like PR monitoring or log tails. Stop with TaskStop.
+   */
+  persistent: boolean;
+  /**
+   * Shell command or script. Each stdout line is an event; exit ends the watch.
+   */
+  command?: string;
+  /**
+   * WebSocket to open. Each text frame is an event; binary frames are reported as a placeholder line. Socket close ends the watch. Cannot be combined with command.
+   */
+  ws?: {
+    url: string;
+    protocols?: string[];
+  };
+}
+export interface ProposeSkillsInput {
+  /**
+   * @minItems 1
+   * @maxItems 3
+   */
+  proposals:
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        }
+      ]
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        }
+      ]
+    | [
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        },
+        {
+          /**
+           * kebab-case skill slug
+           */
+          name: string;
+          kind: "new" | "improvement";
+          /**
+           * Name of the existing skill to update. Required when kind is 'improvement'; omit for 'new'.
+           */
+          target?: string;
+          /**
+           * One line saying when to use this skill. Shown on the review card and saved as the skill's description, which is what decides when the skill is used; for an improvement, restate or update the existing skill's description.
+           */
+          description: string;
+          /**
+           * memory file paths where this procedure was observed
+           */
+          evidence?: string[];
+          /**
+           * The complete SKILL.md exactly as it should be saved: frontmatter plus the full body. When the user saves, the body below the frontmatter becomes the skill's entire instructions and the name and description come from the fields above; other frontmatter keys are not kept. For an improvement this replaces the existing skill's SKILL.md entirely, so read that skill's current SKILL.md first and include everything worth keeping, not only the changes.
+           */
+          skillMd: string;
+        }
+      ];
+}
+export interface ProposeGoalInput {
+  /**
+   * The completion condition to propose, written so a separate evaluator can verify it from the conversation (e.g. "all tests in test/auth pass (bun test exits 0)"). At most 500 characters — the user must be able to read the whole condition in the approval dialog.
+   */
+  condition: string;
+  /**
+   * Whether to ask the user for approval before the goal is set. Defaults to true — an approval dialog is shown. Set false ONLY when the user's own words in this conversation stated this outcome as what they want; the goal is then set directly, with a visible notice in the transcript, and the user can clear it with /goal clear.
+   */
+  ask_user?: boolean;
+}
+export interface ArtifactInput {
+  /**
+   * Omit (or 'publish') to publish file_path. 'list' enumerates artifacts — the user's own by default, see `scope`; only `limit` and `scope` may accompany it. 'read' returns the content of the published artifact at `url` (raw HTML for the user's own; an isolated summary, steered by the optional `prompt`, for one shared with them, though a page published in this session's own Slack channel can come back in full as untrusted content) — see **To read an existing artifact's content**. 'watch', 'unwatch', and 'status' manage live-update subscriptions that notify a session when an artifact is republished elsewhere, and those aren't available in this session: 'watch' only reports that — no republish notification reaches this session — and 'status' lists this session's artifact watches (pass `url` to check one). 'upload_asset' adds one local media, PDF, font, or text file to an existing artifact — pass `url` and `file_path`. 'list_assets' lists the files in an artifact's asset store (pass `url`; `after` continues a listing), 'read_asset' saves one of them to a local file named by its id (pass `url` and `asset_id`, optionally `out_dir`), and 'delete_asset' permanently removes one (pass `url` and `asset_id`). See **Artifact assets** above.
+   */
+  action?:
+    | "publish"
+    | "list"
+    | "read"
+    | "watch"
+    | "unwatch"
+    | "status"
+    | "upload_asset"
+    | "list_assets"
+    | "read_asset"
+    | "delete_asset";
+  /**
+   * Path to the .html file to render. Required to publish (the default action). Use a short, distinctive basename — it is the last-resort title when the HTML has no <title> and no `title` parameter is given. For 'upload_asset', the local image, video, PDF, font, or text (CSV, Markdown, JSON, plain text) file to upload.
+   */
+  file_path?: string;
+  /**
+   * Browser-tab icon: one or two emoji (e.g. "📊"). No markup. Required on a page's first publish; omit on a redeploy (same file path this session, or `url`) to keep the artifact's icon — pass a new one only when the user asks.
+   */
+  favicon?: string;
+  /**
+   * list only: maximum artifacts to return (default 25).
+   */
+  limit?: number;
+  /**
+   * list only: 'mine' (default) lists artifacts the user owns — the only ones the update flow can target; 'shared' lists artifacts other people shared with the user (read-only); 'all' lists both. Rows are labeled (mine)/(shared) whenever scope is not 'mine'.
+   */
+  scope?: "mine" | "shared" | "all";
+  /**
+   * Title for the artifact — the name shown in the browser tab and gallery. A short, distinctive noun-phrase name — not a generic label, a summary, or a name with an appended explainer. Prefer a <title> tag at the top of the HTML itself; this parameter fills in only when the file lacks one in the first 8KB of the file, and never overrides the tag. HTML publishes only — Markdown pages keep their filename identity. Content always comes from file_path — there is no inline content parameter.
+   */
+  title?: string;
+  /**
+   * One-sentence subtitle shown on the gallery card. Say what the page is or does.
+   */
+  description?: string;
+  /**
+   * A short name for the version this publish makes, max 60 chars (e.g. "Draft to legal"). Shown in the version picker. Optional — a few words, not a description.
+   */
+  label?: string;
+  /**
+   * Existing artifact URL to update in place. Pass whenever the user wants to update an artifact this conversation did not publish — "update my artifact", "keep the same link", a pasted artifact URL — and find the URL with action: "list" or ask the user for the link if you don't have it; without this, the publish creates a separate artifact instead of updating the existing one. Omit for new artifacts and same-conversation redeploys. Must be an artifact the user owns. For 'read' and the other url-addressed actions: the artifact to act on.
+   */
+  url?: string;
+  /**
+   * read only: what to extract from an artifact shared with the user — its content reaches you as an isolated summary answering this. Ignored for artifacts the user owns and for a page published in this session's own Slack channel (raw content is returned); optional.
+   */
+  prompt?: string;
+  /**
+   * Last-resort overwrite that DISCARDS the newer published version's page — another session's publish, or someone's save from a page that can publish new versions of itself. On a conflict the fix is to merge your changes onto the newer content (handed to you in the rejection, or re-read) and publish again — not force. Pass force:true only when the user has explicitly said to discard that specific version; never to get past a conflict on your own judgment. The tracked baseVersion is still sent; with force:true the server treats it as informational and overwrites, unless it refuses force over a version saved from inside the page. Omit (or false) so a concurrent write conflicts instead of being silently clobbered.
+   */
+  force?: boolean;
+  /**
+   * read_asset: directory to save the file into (default: the working directory); the file is named by the asset id plus the extension for its type.
+   */
+  out_dir?: string;
+  /**
+   * read_asset and delete_asset: the asset's id (32 hex characters), from a list_assets or upload_asset result.
+   */
+  asset_id?: string;
+  /**
+   * list_assets only: the `next` value from a previous list_assets result, to continue that listing.
+   */
+  after?: string;
+  /**
+   * Runtime capabilities this page declares, as {name: config}. The control plane is the authority on valid names and config shapes. An empty object clears any previously stored declaration; omit the field on a redeploy to carry the stored declaration forward unchanged. Before declaring any capability, load the `artifact-capabilities` skill for the current contract and per-capability guidance.
+   */
+  capabilities?: {
+    [k: string]: unknown;
+  };
+  /**
+   * The artifact's runtime version. Omit to keep its current version (the default); 'latest' to upgrade; a specific version to pin or roll back. Changing it changes how the published page behaves — pass only when the author explicitly intends the change, never as a side effect of editing.
+   */
+  contract?: "latest" | string;
+}
+export interface PushNotificationInput {
+  /**
+   * The notification body. Keep it under 200 characters; mobile OSes truncate.
+   */
+  message: string;
+  status: "proactive";
+}
+export interface EnterWorktreeInput {
+  /**
+   * Optional name for a new worktree. Each "/"-separated segment may contain only letters, digits, dots, underscores, and dashes; max 64 chars total. A random name is generated if not provided. Mutually exclusive with `path`.
+   */
+  name?: string;
+  /**
+   * Path to an existing worktree to switch into instead of creating a new one. Must appear in `git worktree list` for the current repo — or, on first entry from the launch directory, for a repo nested inside it (multi-repo workspace). Mutually exclusive with `name`.
+   */
+  path?: string;
+}
+export interface ExitWorktreeInput {
+  /**
+   * "keep" leaves the worktree and branch on disk; "remove" deletes both.
+   */
+  action: "keep" | "remove";
+  /**
+   * Required true when action is "remove" and the worktree has uncommitted files or unmerged commits. The tool will refuse and list them otherwise.
+   */
+  discard_changes?: boolean;
+}
+export interface BashOutput {
+  /**
+   * The standard output of the command
+   */
+  stdout: string;
+  /**
+   * The standard error output of the command
+   */
+  stderr: string;
+  /**
+   * Path to raw output file for large MCP tool outputs
+   */
+  rawOutputPath?: string;
+  /**
+   * Whether the command was interrupted
+   */
+  interrupted: boolean;
+  /**
+   * Flag to indicate if stdout contains image data
+   */
+  isImage?: boolean;
+  /**
+   * ID of the background task if command is running in background
+   */
+  backgroundTaskId?: string;
+  /**
+   * True if the user manually backgrounded the command with Ctrl+B
+   */
+  backgroundedByUser?: boolean;
+  /**
+   * Set when the command hit its timeout and was auto-backgrounded; the timeout value in ms
+   */
+  timedOutAfterMs?: number;
+  /**
+   * Model-facing note that the session cwd was not changed by a backgrounded command containing a directory-change builtin (cd/pushd/popd/chdir)
+   */
+  backgroundCwdHint?: string;
+  /**
+   * True when this backgrounded command is owned by a synchronous subagent and is therefore terminated when that agent gives its final response; absent when the command survives (main loop, async subagents)
+   */
+  backgroundEndsWithFinalResponse?: true;
+  /**
+   * Flag to indicate if sandbox mode was overridden
+   */
+  dangerouslyDisableSandbox?: boolean;
+  /**
+   * Semantic interpretation for non-error exit codes with special meaning
+   */
+  returnCodeInterpretation?: string;
+  /**
+   * Whether the command is expected to produce no output on success
+   */
+  noOutputExpected?: boolean;
+  /**
+   * Structured content blocks
+   */
+  structuredContent?: unknown[];
+  /**
+   * Path to the persisted full output in tool-results dir (set when output is too large for inline)
+   */
+  persistedOutputPath?: string;
+  /**
+   * Total size of the output in bytes (set when output is too large for inline)
+   */
+  persistedOutputSize?: number;
+  /**
+   * Model-facing note listing readFileState entries whose mtime bumped during this command (set when WRITE_COMMAND_MARKERS matches)
+   */
+  staleReadFileStateHint?: string;
+  /**
+   * Model-facing system-reminder appended when a gh command reports a GitHub API rate-limit error
+   */
+  ghRateLimitHint?: string;
+  /**
+   * Structured classification of git/gh operations detected in this command (commit/push/merge/rebase/PR). Client-facing — lets clients render git activity without re-parsing stdout; not surfaced to the model.
+   */
+  gitOperation?: {
+    commit?: {
+      sha: string;
+      kind: "committed" | "amended" | "cherry-picked";
+      branch?: string;
+    };
+    push?: {
+      branch: string;
+    };
+    branch?: {
+      ref: string;
+      action: "merged" | "rebased";
+    };
+    pr?: {
+      number: number;
+      url?: string;
+      action:
+        | "created"
+        | "edited"
+        | "merged"
+        | "commented"
+        | "closed"
+        | "reopened"
+        | "ready"
+        | "draft"
+        | "auto-merge-enabled"
+        | "auto-merge-disabled";
+    };
+  };
+}
+export interface ExitPlanModeOutput {
+  /**
+   * The plan that was presented to the user
+   */
+  plan: string | null;
+  isAgent: boolean;
+  /**
+   * The file path where the plan was saved
+   */
+  filePath?: string;
+  /**
+   * Whether the Agent tool is available in the current context
+   */
+  hasTaskTool?: boolean;
+  /**
+   * True when the user edited the plan (CCR web UI or Ctrl+G); determines whether the plan is echoed back in tool_result
+   */
+  planWasEdited?: boolean;
+  /**
+   * When true, the teammate has sent a plan approval request to the team leader
+   */
+  awaitingLeaderApproval?: boolean;
+  /**
+   * Unique identifier for the plan approval request
+   */
+  requestId?: string;
+}
+export interface FileEditOutput {
+  /**
+   * The file path that was edited
+   */
+  filePath: string;
+  /**
+   * The original string that was replaced
+   */
+  oldString: string;
+  /**
+   * The new string that replaced it
+   */
+  newString: string;
+  /**
+   * The original file contents before editing
+   */
+  originalFile: string | null;
+  /**
+   * Diff patch showing the changes
+   */
+  structuredPatch: {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+  }[];
+  /**
+   * Whether the user modified the proposed changes
+   */
+  userModified: boolean;
+  /**
+   * Whether all occurrences were replaced
+   */
+  replaceAll: boolean;
+  gitDiff?: {
+    filename: string;
+    status: "modified" | "added";
+    additions: number;
+    deletions: number;
+    changes: number;
+    patch: string;
+    /**
+     * GitHub owner/repo when available
+     */
+    repository?: string | null;
+  };
+}
+export interface FileWriteOutput {
+  /**
+   * Whether a new file was created or an existing file was updated
+   */
+  type: "create" | "update";
+  /**
+   * The path to the file that was written
+   */
+  filePath: string;
+  /**
+   * The content that was written to the file
+   */
+  content: string;
+  /**
+   * Diff patch showing the changes (empty when nothing changed, the diff timed out, or — with originalFile null on an update — the previous content was too large to diff)
+   */
+  structuredPatch: {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+  }[];
+  /**
+   * The original file content before the write (null for new files, or when the previous content was too large to include)
+   */
+  originalFile: string | null;
+  gitDiff?: {
+    filename: string;
+    status: "modified" | "added";
+    additions: number;
+    deletions: number;
+    changes: number;
+    patch: string;
+    /**
+     * GitHub owner/repo when available
+     */
+    repository?: string | null;
+  };
+  /**
+   * True when the user edited the proposed content in the permission dialog before accepting
+   */
+  userModified?: boolean;
+}
+export interface GlobOutput {
+  /**
+   * Time taken to execute the search in milliseconds
+   */
+  durationMs: number;
+  /**
+   * Number of file paths returned (after any truncation)
+   */
+  numFiles: number;
+  /**
+   * Array of file paths that match the pattern
+   */
+  filenames: string[];
+  /**
+   * Whether results were truncated (limited to 100 files)
+   */
+  truncated: boolean;
+  /**
+   * Total number of matching files before truncation. A lower bound when countIsComplete is false. Absent on results persisted by CLI versions predating this field.
+   */
+  totalMatches?: number;
+  /**
+   * Whether totalMatches is the exact total (true) or a floor because the underlying search truncated its own output (false). Absent on results persisted by CLI versions predating this field.
+   */
+  countIsComplete?: boolean;
+}
+export interface GrepOutput {
+  mode?: "content" | "files_with_matches" | "count";
+  numFiles: number;
+  filenames: string[];
+  content?: string;
+  numLines?: number;
+  numMatches?: number;
+  totalFiles?: number;
+  totalLines?: number;
+  appliedLimit?: number;
+  appliedOffset?: number;
+}
+export interface TaskStopOutput {
+  /**
+   * Status message about the operation
+   */
+  message: string;
+  /**
+   * The ID of the task that was stopped
+   */
+  task_id: string;
+  /**
+   * The type of the task that was stopped
+   */
+  task_type: string;
+  /**
+   * The command or description of the stopped task
+   */
+  command?: string;
+}
+export interface NotebookEditOutput {
+  /**
+   * The new source code that was written to the cell
+   */
+  new_source: string;
+  /**
+   * The previous cell source (replace/delete only). Enables cell-relative diff rendering without re-reading the notebook.
+   */
+  old_source?: string;
+  /**
+   * The ID of the cell that was edited
+   */
+  cell_id?: string;
+  /**
+   * The type of the cell
+   */
+  cell_type: "code" | "markdown";
+  /**
+   * The programming language of the notebook
+   */
+  language: string;
+  /**
+   * The edit mode that was used
+   */
+  edit_mode: string;
+  /**
+   * Error message if the operation failed
+   */
+  error?: string;
+  /**
+   * The path to the notebook file
+   */
+  notebook_path: string;
+  /**
+   * The original notebook content before modification
+   */
+  original_file: string;
+  /**
+   * The updated notebook content after modification
+   */
+  updated_file: string;
+}
+export interface ReadMcpResourceDirOutput {
+  /**
+   * Direct children of the directory resource. Subdirectories appear with mimeType "inode/directory".
+   */
+  resources: {
+    /**
+     * Child resource URI
+     */
+    uri: string;
+    /**
+     * Child resource name
+     */
+    name: string;
+    /**
+     * Child MIME type
+     */
+    mimeType?: string;
+  }[];
+  /**
+   * Human-readable error when the server could not list the directory
+   */
+  error?: string;
+}
+export interface ReadMcpResourceOutput {
+  contents: {
+    /**
+     * Resource URI
+     */
+    uri: string;
+    /**
+     * MIME type of the content
+     */
+    mimeType?: string;
+    /**
+     * Text content of the resource
+     */
+    text?: string;
+    /**
+     * Path where binary blob content was saved
+     */
+    blobSavedTo?: string;
+  }[];
+  /**
+   * Human-readable error when the server could not read the resource
+   */
+  error?: string;
+}
+export interface ReportFindingsOutput {
+  /**
+   * Number of findings reported
+   */
+  count: number;
+  /**
+   * Effort level the review ran at
+   */
+  level?: "low" | "medium" | "high" | "xhigh" | "max";
+  /**
+   * Echoed for the result body
+   */
+  findings: {
+    /**
+     * Repo-relative path of the file the finding is in
+     */
+    file: string;
+    /**
+     * 1-indexed line the finding anchors to
+     */
+    line?: number;
+    /**
+     * One-sentence statement of the defect
+     */
+    summary: string;
+    /**
+     * Compressed label for compact UI (≤60 chars): the claim alone, no rationale or consequence clause
+     */
+    short_summary?: string;
+    /**
+     * Concrete inputs/state → wrong output/crash
+     */
+    failure_scenario: string;
+    /**
+     * Short kebab-case slug of the finding type, e.g. "correctness", "simplification", "efficiency", "test-coverage"
+     */
+    category?: string;
+    /**
+     * Set when a verify pass ran; absent on inline-only reviews
+     */
+    verdict?: "CONFIRMED" | "PLAUSIBLE";
+    /**
+     * Set ONLY when re-reporting after applying fixes: what happened to this finding
+     */
+    outcome?: "fixed" | "skipped" | "no_change_needed";
+  }[];
+}
+export interface TodoWriteOutput {
+  /**
+   * The todo list before the update
+   */
+  oldTodos: {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    activeForm: string;
+  }[];
+  /**
+   * The todo list after the update
+   */
+  newTodos: {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    activeForm: string;
+  }[];
+}
+export interface WebFetchOutput {
+  /**
+   * Size of the fetched content in bytes
+   */
+  bytes: number;
+  /**
+   * HTTP response code
+   */
+  code: number;
+  /**
+   * HTTP response code text
+   */
+  codeText: string;
+  /**
+   * Processed result from applying the prompt to the content
+   */
+  result: string;
+  /**
+   * Time taken to fetch and process the content
+   */
+  durationMs: number;
+  /**
+   * The URL that was fetched
+   */
+  url: string;
+  artifactRead?: {
+    slug: string;
+    ver?: string;
+    seeded?: false;
+  };
+}
+export interface WebSearchOutput {
+  /**
+   * The search query that was executed
+   */
+  query: string;
+  /**
+   * Search results and/or text commentary from the model
+   */
+  results: (
+    | {
+        /**
+         * ID of the tool use
+         */
+        tool_use_id: string;
+        /**
+         * Array of search hits
+         */
+        content: {
+          /**
+           * The title of the search result
+           */
+          title: string;
+          /**
+           * The URL of the search result
+           */
+          url: string;
+        }[];
+      }
+    | string
+  )[];
+  /**
+   * Time taken to complete the search operation
+   */
+  durationSeconds: number;
+  /**
+   * Number of web searches performed
+   */
+  searchCount?: number;
+}
+export interface AskUserQuestionOutput {
+  /**
+   * The questions that were asked
+   */
+  questions: {
+    /**
+     * The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"
+     */
+    question: string;
+    /**
+     * Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".
+     */
+    header: string;
+    /**
+     * The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.
+     *
+     * @minItems 2
+     * @maxItems 4
+     */
+    options:
+      | [
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          }
+        ]
+      | [
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          }
+        ]
+      | [
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          },
+          {
+            /**
+             * The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.
+             */
+            label: string;
+            /**
+             * Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.
+             */
+            description: string;
+            /**
+             * Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format.
+             */
+            preview?: string;
+          }
+        ];
+    /**
+     * Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.
+     */
+    multiSelect: boolean;
+  }[];
+  /**
+   * The answers provided by the user (question text -> answer string; multi-select answers are comma-separated)
+   */
+  answers: {
+    [k: string]: string;
+  };
+  /**
+   * Freeform text the user typed instead of selecting a structured option
+   */
+  response?: string;
+  /**
+   * Optional per-question annotations from the user (e.g., notes on preview selections). Keyed by question text.
+   */
+  annotations?: {
+    [k: string]: {
+      /**
+       * The preview content of the selected option, if the question used previews.
+       */
+      preview?: string;
+      /**
+       * Free-text notes the user added to their selection.
+       */
+      notes?: string;
+    };
+  };
+  /**
+   * Set when the dialog auto-resolved after this many milliseconds of idle (user away from keyboard). Absent on every human-resolved path.
+   */
+  afkTimeoutMs?: number;
+}
+export interface SendFeedbackOutput {
+  success: boolean;
+  message: string;
+}
+export interface EnterWorktreeOutput {
+  worktreePath: string;
+  worktreeBranch?: string;
+  message: string;
+}
+export interface ExitWorktreeOutput {
+  action: "keep" | "remove";
+  originalCwd: string;
+  worktreePath: string;
+  worktreeBranch?: string;
+  tmuxSessionName?: string;
+  discardedFiles?: number;
+  discardedCommits?: number;
+  message: string;
+}
+export interface TaskCreateOutput {
+  task: {
+    id: string;
+    subject: string;
+  };
+}
+export interface TaskGetOutput {
+  task: {
+    id: string;
+    subject: string;
+    description: string;
+    status: "pending" | "in_progress" | "completed";
+    blocks: string[];
+    blockedBy: string[];
+  } | null;
+}
+export interface TaskUpdateOutput {
+  success: boolean;
+  taskId: string;
+  updatedFields: string[];
+  error?: string;
+  statusChange?: {
+    from: string;
+    to: string;
+  };
+}
+export interface TaskListOutput {
+  tasks: {
+    id: string;
+    subject: string;
+    status: "pending" | "in_progress" | "completed";
+    owner?: string;
+    blockedBy: string[];
+  }[];
+}
+export interface RemoteTriggerOutput {
+  status: number;
+  json: string;
+  summary?: string;
+}
+export interface ShowOnboardingRolePickerOutput {
+  role?: string;
+  dismissed?: boolean;
+}
+export interface ReadNotificationsOutput {
+  notifications: {
+    /**
+     * Server-assigned stable id — the dedup key across redeliveries.
+     */
+    notification_id: string;
+    /**
+     * Server-attested source token: "github_webhook" | "trigger_fire" | "mcp_send_message" (open set; unknown well-formed tokens pass through verbatim, off-grammar values coerce to "unknown").
+     */
+    origin: string;
+    /**
+     * RFC3339 timestamp of when the backend queued it.
+     */
+    queued_at: string;
+    /**
+     * Verbatim notification body.
+     */
+    content: string;
+  }[];
+  /**
+   * Notifications still queued after this drain (drains are size-budgeted); call the tool again to read them.
+   */
+  remaining: number;
+}
+export interface ScheduleWakeupOutput {
+  /**
+   * Epoch ms timestamp when the next wakeup will fire
+   */
+  scheduledFor: number;
+  /**
+   * Actual delay used after clamping to runtime bounds
+   */
+  clampedDelaySeconds: number;
+  /**
+   * True if the requested delaySeconds was outside [60, 3600]
+   */
+  wasClamped: boolean;
+  /**
+   * True when the model ended the loop via `stop: true`
+   */
+  stopped?: boolean;
+  /**
+   * How many pending dynamic-loop wakeups stop:true cancelled. 0 means nothing was pending — a recurring /loop cron is not cancelled by stop:true.
+   */
+  cancelledWakeups?: number;
+}
+export interface MonitorOutput {
+  /**
+   * ID of the background monitor task.
+   */
+  taskId: string;
+  /**
+   * Timeout deadline in milliseconds (0 when persistent).
+   */
+  timeoutMs: number;
+  /**
+   * No timeout — runs until TaskStop or session end.
+   */
+  persistent?: boolean;
+}
+export interface ProposeSkillsOutput {
+  /**
+   * Number of proposals shown on the review card
+   */
+  proposalCount: number;
+}
+export interface ProposeGoalOutput {
+  /**
+   * The condition shown to the user for approval, or set directly when ask_user was false
+   */
+  condition: string;
+  /**
+   * Whether the user was asked for approval (true) or the goal was set directly (false)
+   */
+  askUser: boolean;
+}
+export interface EnterPlanModeOutput {
+  /**
+   * Confirmation that plan mode was entered
+   */
+  message: string;
+}
+export interface REPLOutput {
+  /**
+   * The code that was executed
+   */
+  code: string;
+  /**
+   * Return value from the code execution
+   */
+  result?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Captured console.log output
+   */
+  stdout: string;
+  /**
+   * Captured console.error output
+   */
+  stderr: string;
+  /**
+   * Error message if execution failed
+   */
+  error?: string;
+  /**
+   * True on an async-dispatch receipt or refusal: the script was handed to the async dispatcher (queued — outcome arrives later as a poll event — or refused at the queue cap), so this Output carries no execution output and resume replay must skip the block
+   */
+  asyncDispatched?: boolean;
+  /**
+   * Names of tools registered during this execution
+   */
+  registeredTools?: string[];
+  /**
+   * Images returned by inner Read calls — surfaced as image content blocks
+   */
+  images?: {
+    base64: string;
+    mediaType: string;
+  }[];
+  /**
+   * Count of inner-Read images dropped by the per-result image cap; surfaced as a note in the tool_result
+   */
+  imagesOmitted?: number;
+  /**
+   * Pages of inner page-range Reads that could not be processed as an image; surfaced as one note each in the tool_result
+   */
+  imagePagesFailed?: {
+    page: number;
+    file?: string;
+    error?: string;
+  }[];
+  /**
+   * Count of failed-page notes dropped by the per-result note cap; surfaced as a note in the tool_result
+   */
+  imagePagesFailedOmitted?: number;
+  /**
+   * PDFs returned by inner Read calls — surfaced as document content blocks
+   */
+  documents?: {
+    base64: string;
+  }[];
+  /**
+   * Count of inner-Read PDFs dropped by the per-result document cap; surfaced as a note in the tool_result
+   */
+  documentsOmitted?: number;
+}
+export interface WorkflowOutput {
+  status: "async_launched" | "remote_launched";
+  taskId: string;
+  /**
+   * TaskType of the registered background task — 'local_workflow' for in-process runs, 'remote_agent' when remote:true dispatches to CCR. Set on all new writes; absent only on transcripts written before this field existed.
+   */
+  taskType?: "local_workflow" | "remote_agent";
+  /**
+   * meta.name from the workflow script — same value as task_started.workflow_name. Set on all new writes; absent only on transcripts written before this field existed.
+   */
+  workflowName?: string;
+  /**
+   * Local workflow run identifier for resumeFromRunId. Absent for remote_launched (the CCR session URL is the resume handle there) and on transcripts written before this field existed.
+   */
+  runId?: string;
+  summary?: string;
+  /**
+   * Directory where subagent transcripts are written during execution
+   */
+  transcriptDir?: string;
+  /**
+   * Path to the persisted workflow script for this invocation. Editable via Write/Edit; pass back as `scriptPath` to re-run without resending the script.
+   */
+  scriptPath?: string;
+  /**
+   * CCR session URL when status is remote_launched
+   */
+  sessionUrl?: string;
+  /**
+   * Non-blocking heads-up (e.g. local git state diverges from the pushed branch the cloud session will clone)
+   */
+  warning?: string;
+  /**
+   * Set if syntax check failed
+   */
+  error?: string;
+}
+export interface CronCreateOutput {
+  id: string;
+  humanSchedule: string;
+  recurring: boolean;
+  durable?: boolean;
+}
+export interface CronDeleteOutput {
+  id: string;
+}
+export interface CronListOutput {
+  jobs: {
+    id: string;
+    cron: string;
+    humanSchedule: string;
+    prompt: string;
+    recurring?: boolean;
+    durable?: boolean;
+  }[];
+}
+export interface PushNotificationOutput {
+  message: string;
+  pushSent?: boolean;
+  localSent?: boolean;
+  disabledReason?: "config_off" | "user_present" | "no_transport";
+  /**
+   * ISO timestamp captured at tool execution on the emitting process. Optional — resumed sessions replay pre-sentAt outputs verbatim.
+   */
+  sentAt?: string;
+}
+export interface ClaudeDesignOutput {
+  operation: string;
+  content: {
+    [k: string]: unknown;
+  }[];
+  isError?: boolean;
+}