@kmmao/happy-wire 0.13.2 → 0.16.1

package/dist/index.cjs

@@ -273,7 +273,16 @@ const MessageMetaSchema = z__namespace.object({
    * an assistant turn. Requires @anthropic-ai/claude-agent-sdk 0.2.110+ on CLI.
    * Defaults to true when unset (normal turn-triggering message).
    */
-  shouldQuery: z__namespace.boolean().optional()
+  shouldQuery: z__namespace.boolean().optional(),
+  /**
+   * Worktree context for sessions running in a git worktree branch.
+   * Injected by the CLI when the session directory is inside a git worktree.
+   * Used by the server to enrich push notification titles with branch info.
+   */
+  worktree: z__namespace.object({
+    branch: z__namespace.string(),
+    path: z__namespace.string().optional()
+  }).optional()
 });
 
 const UserMessageSchema = z__namespace.object({
@@ -785,261 +794,6 @@ const VoiceTokenResponseSchema = z__namespace.discriminatedUnion("allowed", [
   VoiceTokenDeniedSchema
 ]);
 
-const TaskPrioritySchema = z__namespace.enum([
-  "urgent",
-  // User-initiated, needs immediate execution
-  "user",
-  // Normal user-created task (default)
-  "background"
-  // Automated / scheduled tasks
-]);
-const TaskStatusSchema = z__namespace.enum([
-  "queued",
-  // Waiting in queue
-  "dispatching",
-  // Being sent to CLI daemon
-  "running",
-  // Executing on CLI
-  "completed",
-  // Finished successfully
-  "failed",
-  // Execution failed
-  "cancelled"
-  // Cancelled by user
-]);
-const TaskTriggerTypeSchema = z__namespace.enum([
-  "manual",
-  // Created from App by user
-  "cron",
-  // Created by TriggerSchedule
-  "webhook"
-  // Created by WebhookTrigger
-]);
-const TaskSummarySchema = z__namespace.object({
-  id: z__namespace.string(),
-  projectId: z__namespace.string().nullable(),
-  machineId: z__namespace.string(),
-  priority: TaskPrioritySchema,
-  status: TaskStatusSchema,
-  triggerType: TaskTriggerTypeSchema,
-  triggerRef: z__namespace.string().optional(),
-  attempt: z__namespace.number(),
-  maxAttempts: z__namespace.number(),
-  sessionId: z__namespace.string().optional(),
-  errorMessage: z__namespace.string().optional(),
-  dispatchedAt: z__namespace.number().optional(),
-  completedAt: z__namespace.number().optional(),
-  createdAt: z__namespace.number(),
-  updatedAt: z__namespace.number(),
-  // Encrypted prompt preview (first 100 chars)
-  promptPreview: z__namespace.string().optional(),
-  // Names of bound skills for display
-  skillNames: z__namespace.array(z__namespace.string()).optional()
-});
-const CreateTaskBodySchema = z__namespace.object({
-  projectId: z__namespace.string().optional(),
-  machineId: z__namespace.string(),
-  prompt: z__namespace.string().min(1),
-  // Encrypted by App
-  priority: TaskPrioritySchema.default("user"),
-  maxAttempts: z__namespace.number().int().min(1).max(10).default(3),
-  skillIds: z__namespace.array(z__namespace.string()).max(10).default([])
-});
-const TaskTriggerDataSchema = z__namespace.object({
-  type: z__namespace.literal("task-trigger"),
-  taskId: z__namespace.string(),
-  prompt: z__namespace.string(),
-  // Encrypted prompt
-  directory: z__namespace.string(),
-  // Project directory on machine
-  priority: TaskPrioritySchema,
-  projectId: z__namespace.string().optional(),
-  resultToken: z__namespace.string().optional(),
-  skillContents: z__namespace.array(z__namespace.object({
-    name: z__namespace.string(),
-    content: z__namespace.string()
-  })).optional(),
-  agentType: z__namespace.string().nullable().optional(),
-  // "claude" | "codex" | "gemini" — null = inherit CLI default
-  modelOverride: z__namespace.string().nullable().optional()
-  // e.g. "claude-sonnet-4-20250514" — null = agent default
-});
-const TaskOutcomeSchema = z__namespace.enum([
-  "completed",
-  "failed",
-  "blocked"
-]);
-const TaskStatusReportSchema = z__namespace.object({
-  taskId: z__namespace.string(),
-  status: TaskStatusSchema,
-  outcome: TaskOutcomeSchema.optional(),
-  sessionId: z__namespace.string().optional(),
-  errorMessage: z__namespace.string().optional()
-});
-const TaskStatusChangedSchema = z__namespace.object({
-  type: z__namespace.literal("task-status-changed"),
-  taskId: z__namespace.string(),
-  machineId: z__namespace.string().optional(),
-  status: TaskStatusSchema,
-  sessionId: z__namespace.string().optional(),
-  errorMessage: z__namespace.string().optional(),
-  completedAt: z__namespace.number().optional()
-});
-
-const SkillSummarySchema = z__namespace.object({
-  id: z__namespace.string(),
-  projectId: z__namespace.string().nullable(),
-  name: z__namespace.string(),
-  description: z__namespace.string().optional(),
-  content: z__namespace.string(),
-  attachments: z__namespace.array(z__namespace.string()),
-  sourceKnowledgeId: z__namespace.string().optional(),
-  archived: z__namespace.boolean(),
-  createdAt: z__namespace.number(),
-  updatedAt: z__namespace.number()
-});
-const CreateSkillBodySchema = z__namespace.object({
-  projectId: z__namespace.string().optional(),
-  name: z__namespace.string().min(1).max(100),
-  description: z__namespace.string().max(500).optional(),
-  content: z__namespace.string().min(1).max(5e4),
-  attachments: z__namespace.array(z__namespace.string()).max(10).default([]),
-  sourceKnowledgeId: z__namespace.string().optional()
-});
-const UpdateSkillBodySchema = z__namespace.object({
-  name: z__namespace.string().min(1).max(100).optional(),
-  description: z__namespace.string().max(500).optional(),
-  content: z__namespace.string().min(1).max(5e4).optional(),
-  attachments: z__namespace.array(z__namespace.string()).max(10).optional(),
-  archived: z__namespace.boolean().optional()
-});
-const SkillContentSchema = z__namespace.object({
-  name: z__namespace.string(),
-  content: z__namespace.string()
-});
-
-const InboxCategorySchema = z__namespace.enum([
-  "task",
-  // Task queue events (completed, failed, cancelled)
-  "trigger",
-  // Cron/webhook trigger fired
-  "supervisor",
-  // Supervisor run results
-  "session",
-  // Session lifecycle events
-  "knowledge",
-  // Knowledge base changes
-  "system"
-  // System notifications
-]);
-const InboxSeveritySchema = z__namespace.enum([
-  "info",
-  "warning",
-  "error"
-]);
-const InboxItemSummarySchema = z__namespace.object({
-  id: z__namespace.string(),
-  category: InboxCategorySchema,
-  eventType: z__namespace.string(),
-  // e.g. "task.completed", "trigger.cron.fired"
-  severity: InboxSeveritySchema,
-  title: z__namespace.string(),
-  body: z__namespace.string().optional(),
-  read: z__namespace.boolean(),
-  referenceUrl: z__namespace.string().optional(),
-  // Deep link, e.g. "/machine/xxx/tasks"
-  refType: z__namespace.string().optional(),
-  // Polymorphic ref: "task" | "trigger" | "session" | ...
-  refId: z__namespace.string().optional(),
-  // ID of referenced entity
-  groupKey: z__namespace.string().optional(),
-  // Dedup key (same source within 1h → skip)
-  createdAt: z__namespace.number()
-});
-const InboxNewItemSchema = z__namespace.object({
-  type: z__namespace.literal("inbox-new-item"),
-  item: InboxItemSummarySchema
-});
-const InboxUnreadCountSchema = z__namespace.object({
-  type: z__namespace.literal("inbox-unread-count"),
-  count: z__namespace.number()
-});
-
-const SessionEventTypeSchema = z__namespace.enum([
-  "file_edit",
-  // File created/modified/deleted
-  "bash_command",
-  // Shell command executed
-  "tool_call",
-  // Tool invocation (Read, Grep, etc.)
-  "git_operation",
-  // Git commit, push, branch, etc.
-  "error",
-  // Error occurred during session
-  "session_start",
-  // Session started
-  "session_end"
-  // Session ended
-]);
-const SessionEventSummarySchema = z__namespace.object({
-  id: z__namespace.string(),
-  sessionId: z__namespace.string(),
-  eventType: SessionEventTypeSchema,
-  summary: z__namespace.string(),
-  // Human-readable one-liner
-  detail: z__namespace.record(z__namespace.string(), z__namespace.unknown()).optional(),
-  // Structured metadata (JSON)
-  createdAt: z__namespace.number()
-});
-const SessionEventReportSchema = z__namespace.object({
-  sessionId: z__namespace.string(),
-  eventType: SessionEventTypeSchema,
-  summary: z__namespace.string().max(500),
-  detail: z__namespace.record(z__namespace.string(), z__namespace.unknown()).optional()
-});
-const SessionEventCreatedSchema = z__namespace.object({
-  type: z__namespace.literal("session-event-created"),
-  event: SessionEventSummarySchema
-});
-
-const terminalSpawnRequestSchema = z__namespace.object({
-  /** Shell to use (defaults to user's default shell) */
-  shell: z__namespace.string().optional(),
-  /** Working directory */
-  cwd: z__namespace.string().optional(),
-  /** Initial terminal dimensions */
-  cols: z__namespace.number().int().min(1).max(500).optional(),
-  rows: z__namespace.number().int().min(1).max(200).optional()
-});
-const terminalSpawnResponseSchema = z__namespace.object({
-  success: z__namespace.boolean(),
-  terminalId: z__namespace.string().optional(),
-  error: z__namespace.string().optional()
-});
-const terminalResizeRequestSchema = z__namespace.object({
-  terminalId: z__namespace.string(),
-  cols: z__namespace.number().int().min(1).max(500),
-  rows: z__namespace.number().int().min(1).max(200)
-});
-const terminalCloseRequestSchema = z__namespace.object({
-  terminalId: z__namespace.string()
-});
-const terminalInputPayloadSchema = z__namespace.object({
-  machineId: z__namespace.string(),
-  terminalId: z__namespace.string(),
-  data: z__namespace.string()
-});
-const terminalOutputPayloadSchema = z__namespace.object({
-  machineId: z__namespace.string(),
-  terminalId: z__namespace.string(),
-  data: z__namespace.string()
-});
-const terminalExitPayloadSchema = z__namespace.object({
-  machineId: z__namespace.string(),
-  terminalId: z__namespace.string(),
-  exitCode: z__namespace.number()
-});
-
 const CODEX_APP_SERVER_BACKEND = "codex-app-server";
 const CODEX_MCP_LEGACY_BACKEND = "codex-mcp-legacy";
 const CodexBackendModeSchema = z__namespace.enum([
@@ -1634,6 +1388,285 @@ function isTrustedRuntimeProfile(runtimeProfile) {
   return runtimeProfile?.trust === "trusted";
 }
 
+const TaskPrioritySchema = z__namespace.enum([
+  "urgent",
+  // User-initiated, needs immediate execution
+  "user",
+  // Normal user-created task (default)
+  "background"
+  // Automated / scheduled tasks
+]);
+const TaskStatusSchema = z__namespace.enum([
+  "queued",
+  // Waiting in queue
+  "dispatching",
+  // Being sent to CLI daemon
+  "running",
+  // Executing on CLI
+  "completed",
+  // Finished successfully
+  "failed",
+  // Execution failed
+  "cancelled"
+  // Cancelled by user
+]);
+const TaskTriggerTypeSchema = z__namespace.enum([
+  "manual",
+  // Created from App by user
+  "cron",
+  // Created by TriggerSchedule
+  "webhook"
+  // Created by WebhookTrigger
+]);
+const TaskSummarySchema = z__namespace.object({
+  id: z__namespace.string(),
+  projectId: z__namespace.string().nullable(),
+  machineId: z__namespace.string(),
+  priority: TaskPrioritySchema,
+  status: TaskStatusSchema,
+  triggerType: TaskTriggerTypeSchema,
+  triggerRef: z__namespace.string().optional(),
+  attempt: z__namespace.number(),
+  maxAttempts: z__namespace.number(),
+  sessionId: z__namespace.string().optional(),
+  errorMessage: z__namespace.string().optional(),
+  dispatchedAt: z__namespace.number().optional(),
+  completedAt: z__namespace.number().optional(),
+  createdAt: z__namespace.number(),
+  updatedAt: z__namespace.number(),
+  // Encrypted prompt preview (first 100 chars)
+  promptPreview: z__namespace.string().optional(),
+  // Names of bound skills for display
+  skillNames: z__namespace.array(z__namespace.string()).optional()
+});
+const CreateTaskBodySchema = z__namespace.object({
+  projectId: z__namespace.string().optional(),
+  machineId: z__namespace.string(),
+  prompt: z__namespace.string().min(1),
+  // Encrypted by App
+  priority: TaskPrioritySchema.default("user"),
+  maxAttempts: z__namespace.number().int().min(1).max(10).default(3),
+  skillIds: z__namespace.array(z__namespace.string()).max(10).default([]),
+  // Profile binding (wire 0.15.0). Business key — built-in id like
+  // "anthropic" or AiBackendProfile.profileKey for the account. Optional:
+  // when omitted the server falls back to Project.supervisorConfig.defaultProfileId
+  // via the unified runtimeProfileResolver (feature-flagged).
+  profileId: z__namespace.string().optional()
+});
+const TaskTriggerDataSchema = z__namespace.object({
+  type: z__namespace.literal("task-trigger"),
+  taskId: z__namespace.string(),
+  prompt: z__namespace.string(),
+  // Encrypted prompt
+  directory: z__namespace.string(),
+  // Project directory on machine
+  priority: TaskPrioritySchema,
+  projectId: z__namespace.string().optional(),
+  resultToken: z__namespace.string().optional(),
+  skillContents: z__namespace.array(z__namespace.object({
+    name: z__namespace.string(),
+    content: z__namespace.string()
+  })).optional(),
+  agentType: z__namespace.string().nullable().optional(),
+  // "claude" | "codex" | "gemini" — null = inherit CLI default
+  modelOverride: z__namespace.string().nullable().optional(),
+  // e.g. "claude-sonnet-4-20250514" — null = agent default
+  // Profile binding for this task. `profileId` references the AIBackendProfile
+  // selected when the task was created (Task.profileId column). `runtimeProfile`
+  // is the resolved snapshot (env vars, startup script, permission mode, etc.)
+  // that the CLI should honor when spawning the session. Both optional for
+  // backward compatibility; starting from wire 0.14.0 + server unified resolver
+  // these are always populated for scheduled/webhook/manual tasks.
+  profileId: z__namespace.string().optional(),
+  runtimeProfile: ResolvedRuntimeProfileSchema.optional()
+});
+const TaskOutcomeSchema = z__namespace.enum([
+  "completed",
+  "failed",
+  "blocked"
+]);
+const TaskStatusReportSchema = z__namespace.object({
+  taskId: z__namespace.string(),
+  status: TaskStatusSchema,
+  outcome: TaskOutcomeSchema.optional(),
+  sessionId: z__namespace.string().optional(),
+  errorMessage: z__namespace.string().optional()
+});
+const TaskStatusChangedSchema = z__namespace.object({
+  type: z__namespace.literal("task-status-changed"),
+  taskId: z__namespace.string(),
+  machineId: z__namespace.string().optional(),
+  status: TaskStatusSchema,
+  sessionId: z__namespace.string().optional(),
+  errorMessage: z__namespace.string().optional(),
+  completedAt: z__namespace.number().optional()
+});
+
+const SkillSummarySchema = z__namespace.object({
+  id: z__namespace.string(),
+  projectId: z__namespace.string().nullable(),
+  name: z__namespace.string(),
+  description: z__namespace.string().optional(),
+  content: z__namespace.string(),
+  attachments: z__namespace.array(z__namespace.string()),
+  sourceKnowledgeId: z__namespace.string().optional(),
+  archived: z__namespace.boolean(),
+  createdAt: z__namespace.number(),
+  updatedAt: z__namespace.number()
+});
+const CreateSkillBodySchema = z__namespace.object({
+  projectId: z__namespace.string().optional(),
+  name: z__namespace.string().min(1).max(100),
+  description: z__namespace.string().max(500).optional(),
+  content: z__namespace.string().min(1).max(5e4),
+  attachments: z__namespace.array(z__namespace.string()).max(10).default([]),
+  sourceKnowledgeId: z__namespace.string().optional()
+});
+const UpdateSkillBodySchema = z__namespace.object({
+  name: z__namespace.string().min(1).max(100).optional(),
+  description: z__namespace.string().max(500).optional(),
+  content: z__namespace.string().min(1).max(5e4).optional(),
+  attachments: z__namespace.array(z__namespace.string()).max(10).optional(),
+  archived: z__namespace.boolean().optional()
+});
+const SkillContentSchema = z__namespace.object({
+  name: z__namespace.string(),
+  content: z__namespace.string()
+});
+
+const InboxCategorySchema = z__namespace.enum([
+  "task",
+  // Task queue events (completed, failed, cancelled)
+  "trigger",
+  // Cron/webhook trigger fired
+  "supervisor",
+  // Supervisor run results
+  "session",
+  // Session lifecycle events
+  "knowledge",
+  // Knowledge base changes
+  "system"
+  // System notifications
+]);
+const InboxSeveritySchema = z__namespace.enum([
+  "info",
+  "warning",
+  "error"
+]);
+const InboxItemSummarySchema = z__namespace.object({
+  id: z__namespace.string(),
+  category: InboxCategorySchema,
+  eventType: z__namespace.string(),
+  // e.g. "task.completed", "trigger.cron.fired"
+  severity: InboxSeveritySchema,
+  title: z__namespace.string(),
+  body: z__namespace.string().optional(),
+  read: z__namespace.boolean(),
+  referenceUrl: z__namespace.string().optional(),
+  // Deep link, e.g. "/machine/xxx/tasks"
+  refType: z__namespace.string().optional(),
+  // Polymorphic ref: "task" | "trigger" | "session" | ...
+  refId: z__namespace.string().optional(),
+  // ID of referenced entity
+  groupKey: z__namespace.string().optional(),
+  // Dedup key (same source within 1h → skip)
+  createdAt: z__namespace.number()
+});
+const InboxNewItemSchema = z__namespace.object({
+  type: z__namespace.literal("inbox-new-item"),
+  item: InboxItemSummarySchema
+});
+const InboxUnreadCountSchema = z__namespace.object({
+  type: z__namespace.literal("inbox-unread-count"),
+  count: z__namespace.number()
+});
+
+const SessionEventTypeSchema = z__namespace.enum([
+  "file_edit",
+  // File created/modified/deleted
+  "bash_command",
+  // Shell command executed
+  "tool_call",
+  // Tool invocation (Read, Grep, etc.)
+  "git_operation",
+  // Git commit, push, branch, etc.
+  "error",
+  // Error occurred during session
+  "session_start",
+  // Session started
+  "session_end"
+  // Session ended
+]);
+const SessionEventSummarySchema = z__namespace.object({
+  id: z__namespace.string(),
+  sessionId: z__namespace.string(),
+  eventType: SessionEventTypeSchema,
+  summary: z__namespace.string(),
+  // Human-readable one-liner
+  detail: z__namespace.record(z__namespace.string(), z__namespace.unknown()).optional(),
+  // Structured metadata (JSON)
+  createdAt: z__namespace.number()
+});
+const SessionEventReportSchema = z__namespace.object({
+  sessionId: z__namespace.string(),
+  eventType: SessionEventTypeSchema,
+  summary: z__namespace.string().max(500),
+  detail: z__namespace.record(z__namespace.string(), z__namespace.unknown()).optional()
+});
+const SessionEventCreatedSchema = z__namespace.object({
+  type: z__namespace.literal("session-event-created"),
+  event: SessionEventSummarySchema
+});
+
+const terminalSpawnRequestSchema = z__namespace.object({
+  /** Shell to use (defaults to user's default shell) */
+  shell: z__namespace.string().optional(),
+  /** Working directory */
+  cwd: z__namespace.string().optional(),
+  /** Initial terminal dimensions */
+  cols: z__namespace.number().int().min(1).max(500).optional(),
+  rows: z__namespace.number().int().min(1).max(200).optional()
+});
+const terminalSpawnResponseSchema = z__namespace.object({
+  success: z__namespace.boolean(),
+  terminalId: z__namespace.string().optional(),
+  error: z__namespace.string().optional()
+});
+const terminalResizeRequestSchema = z__namespace.object({
+  terminalId: z__namespace.string(),
+  cols: z__namespace.number().int().min(1).max(500),
+  rows: z__namespace.number().int().min(1).max(200)
+});
+const terminalCloseRequestSchema = z__namespace.object({
+  terminalId: z__namespace.string()
+});
+const terminalInputPayloadSchema = z__namespace.object({
+  machineId: z__namespace.string(),
+  terminalId: z__namespace.string(),
+  data: z__namespace.string()
+});
+const terminalOutputPayloadSchema = z__namespace.object({
+  machineId: z__namespace.string(),
+  terminalId: z__namespace.string(),
+  data: z__namespace.string()
+});
+const terminalExitPayloadSchema = z__namespace.object({
+  machineId: z__namespace.string(),
+  terminalId: z__namespace.string(),
+  exitCode: z__namespace.number()
+});
+
+const HAPPY_PROFILE_ENV_KEYS = {
+  /** `"true" | "false"` — toggle Claude extended thinking */
+  claudeThinkingEnabled: "HAPPY_CLAUDE_THINKING_ENABLED",
+  /** integer as string — Claude extended thinking budget tokens */
+  claudeThinkingBudgetTokens: "HAPPY_CLAUDE_THINKING_BUDGET_TOKENS",
+  /** integer as string — max conversation turns before stop */
+  maxTurns: "HAPPY_MAX_TURNS",
+  /** DefaultPermissionMode literal — permission mode override */
+  permissionMode: "HAPPY_PERMISSION_MODE"
+};
+
 const sessionProgressTodoStatusSchema = z__namespace.enum([
   "pending",
   "in_progress",
@@ -1955,6 +1988,98 @@ const CodexMetadataSchema = z__namespace.object({
   mcpServers: z__namespace.array(CodexMcpServerSummarySchema).optional()
 });
 
+const CLAUDE_CONTROL_SCOPE = "claude-control";
+const GetSessionCostRequestSchema = z.z.object({}).strict();
+const GetSessionCostResponseSchema = z.z.object({
+  /** Pre-formatted single-line summary (same text `/usage` prints in non-interactive mode). */
+  formatted: z.z.string(),
+  /** Total USD spent on this session so far. */
+  totalUsd: z.z.number().nonnegative(),
+  /** Optional breakdown by model. */
+  byModel: z.z.record(z.z.string(), z.z.object({
+    inputTokens: z.z.number().int().nonnegative(),
+    outputTokens: z.z.number().int().nonnegative(),
+    cacheCreationInputTokens: z.z.number().int().nonnegative().optional(),
+    cacheReadInputTokens: z.z.number().int().nonnegative().optional(),
+    costUsd: z.z.number().nonnegative()
+  })).optional()
+}).strict();
+const GetBinaryVersionRequestSchema = z.z.object({}).strict();
+const GetBinaryVersionResponseSchema = z.z.object({
+  /** Remote Claude Code binary version string, e.g. "2.1.119". */
+  version: z.z.string(),
+  /** Path to the binary if resolvable, informational only. */
+  binaryPath: z.z.string().optional(),
+  /** Happy-cli package version for context. */
+  happyCliVersion: z.z.string().optional()
+}).strict();
+const SetColorRequestSchema = z.z.object({
+  /** Agent color name or the literal "default" to reset. */
+  color: z.z.string().min(1).max(64)
+}).strict();
+const SetColorResponseSchema = z.z.object({
+  success: z.z.literal(true),
+  color: z.z.string()
+}).strict();
+const ReadFileRequestSchema = z.z.object({
+  /** Path relative to cwd or absolute. CLI applies path blacklist + Read-tool permission gating. */
+  path: z.z.string().min(1).max(4096),
+  /** Optional max bytes to return; server-side hard cap enforces <= 1 MiB. */
+  maxBytes: z.z.number().int().positive().max(1024 * 1024).optional()
+}).strict();
+const ReadFileResponseSchema = z.z.object({
+  /** Null when permission denied / missing / blocked by CLI path blacklist. */
+  result: z.z.object({
+    contents: z.z.string(),
+    absPath: z.z.string(),
+    truncated: z.z.boolean().optional()
+  }).nullable(),
+  /** Machine-readable reason when result is null. */
+  deniedReason: z.z.enum(["not_found", "permission_denied", "blacklisted_path", "too_large", "error"]).optional()
+}).strict();
+const McpCallRequestSchema = z.z.object({
+  /** Fully-qualified MCP tool name, e.g. `mcp__fs__read`. Must pass CLI whitelist. */
+  tool: z.z.string().regex(/^mcp__[a-z0-9_-]+__[a-z0-9_.-]+$/i, "must be of form mcp__<server>__<tool>"),
+  /** Tool arguments; schema-free, CLI passes through to MCP server. */
+  arguments: z.z.record(z.z.string(), z.z.unknown()).optional(),
+  /**
+   * Client-nonce that App must have displayed to the user in a 2-step
+   * confirm dialog. CLI uses this only for audit logging — the actual
+   * confirmation happens on App side and is logged for security review.
+   */
+  clientConfirmToken: z.z.string().min(8).max(128)
+}).strict();
+const McpCallResponseSchema = z.z.object({
+  success: z.z.boolean(),
+  /** Tool response payload, shape defined by each MCP tool. */
+  result: z.z.unknown().optional(),
+  /** Error code for UI to localize; see CLI handler for enum values. */
+  errorCode: z.z.enum([
+    "not_whitelisted",
+    "server_unavailable",
+    "tool_not_found",
+    "invalid_arguments",
+    "permission_denied",
+    /**
+     * SDK 0.2.119 defines the `mcp_call` control protocol type but does
+     * not expose a public runtime method on the `Query` interface. Until
+     * upstream lands a `callMcpTool()` / equivalent, the CLI handler
+     * returns this code so the App can surface an honest "waiting on
+     * SDK" state instead of masking the gap as a server error.
+     */
+    "sdk_not_implemented",
+    "unknown"
+  ]).optional(),
+  errorMessage: z.z.string().optional()
+}).strict();
+const CLAUDE_CONTROL_METHODS = [
+  "get_session_cost",
+  "get_binary_version",
+  "set_color",
+  "read_file",
+  "mcp_call"
+];
+
 exports.AIBackendProfileSchema = AIBackendProfileSchema;
 exports.AgentLoopSummarySchema = AgentLoopSummarySchema;
 exports.AgentMessageSchema = AgentMessageSchema;
@@ -1979,6 +2104,8 @@ exports.BUILT_IN_AI_BACKEND_PROFILE_IDS = BUILT_IN_AI_BACKEND_PROFILE_IDS;
 exports.BootstrapProfileSummarySchema = BootstrapProfileSummarySchema;
 exports.BriefMessageSchema = BriefMessageSchema;
 exports.BuiltInAIBackendProfileIdSchema = BuiltInAIBackendProfileIdSchema;
+exports.CLAUDE_CONTROL_METHODS = CLAUDE_CONTROL_METHODS;
+exports.CLAUDE_CONTROL_SCOPE = CLAUDE_CONTROL_SCOPE;
 exports.CODEX_APP_SERVER_BACKEND = CODEX_APP_SERVER_BACKEND;
 exports.CODEX_MCP_LEGACY_BACKEND = CODEX_MCP_LEGACY_BACKEND;
 exports.CODEX_REQUESTED_BACKEND_ALIASES = CODEX_REQUESTED_BACKEND_ALIASES;
@@ -2009,10 +2136,15 @@ exports.CustomModelSchema = CustomModelSchema;
 exports.DaemonStateSchema = DaemonStateSchema;
 exports.DefaultPermissionModeSchema = DefaultPermissionModeSchema;
 exports.EnvironmentVariableSchema = EnvironmentVariableSchema;
+exports.GetBinaryVersionRequestSchema = GetBinaryVersionRequestSchema;
+exports.GetBinaryVersionResponseSchema = GetBinaryVersionResponseSchema;
+exports.GetSessionCostRequestSchema = GetSessionCostRequestSchema;
+exports.GetSessionCostResponseSchema = GetSessionCostResponseSchema;
 exports.HAPPY_MCP_AUTO_APPROVE_TOOL_NAMES = HAPPY_MCP_AUTO_APPROVE_TOOL_NAMES;
 exports.HAPPY_MCP_SILENT_SUCCESS_TOOL_NAMES = HAPPY_MCP_SILENT_SUCCESS_TOOL_NAMES;
 exports.HAPPY_MCP_TOOL_NAMES = HAPPY_MCP_TOOL_NAMES;
 exports.HAPPY_MCP_TOOL_SPECS = HAPPY_MCP_TOOL_SPECS;
+exports.HAPPY_PROFILE_ENV_KEYS = HAPPY_PROFILE_ENV_KEYS;
 exports.InboxCategorySchema = InboxCategorySchema;
 exports.InboxItemSummarySchema = InboxItemSummarySchema;
 exports.InboxNewItemSchema = InboxNewItemSchema;
@@ -2031,6 +2163,8 @@ exports.KnowledgeInjectionResponseSchema = KnowledgeInjectionResponseSchema;
 exports.KnowledgeStatusSchema = KnowledgeStatusSchema;
 exports.LegacyMessageContentSchema = LegacyMessageContentSchema;
 exports.MachineMetadataSchema = MachineMetadataSchema;
+exports.McpCallRequestSchema = McpCallRequestSchema;
+exports.McpCallResponseSchema = McpCallResponseSchema;
 exports.MessageContentSchema = MessageContentSchema;
 exports.MessageMetaSchema = MessageMetaSchema;
 exports.OpenAIConfigSchema = OpenAIConfigSchema;
@@ -2038,6 +2172,8 @@ exports.ProfileCompatibilitySchema = ProfileCompatibilitySchema;
 exports.ProjectProfileSchema = ProjectProfileSchema;
 exports.QueryKnowledgeParamsSchema = QueryKnowledgeParamsSchema;
 exports.RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION = RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION;
+exports.ReadFileRequestSchema = ReadFileRequestSchema;
+exports.ReadFileResponseSchema = ReadFileResponseSchema;
 exports.ResolvedRuntimeProfileSchema = ResolvedRuntimeProfileSchema;
 exports.RuntimeProfileSourceSchema = RuntimeProfileSourceSchema;
 exports.RuntimeProfileTrustSchema = RuntimeProfileTrustSchema;
@@ -2048,6 +2184,8 @@ exports.SessionEventTypeSchema = SessionEventTypeSchema;
 exports.SessionMessageContentSchema = SessionMessageContentSchema;
 exports.SessionMessageSchema = SessionMessageSchema;
 exports.SessionProtocolMessageSchema = SessionProtocolMessageSchema;
+exports.SetColorRequestSchema = SetColorRequestSchema;
+exports.SetColorResponseSchema = SetColorResponseSchema;
 exports.SkillContentSchema = SkillContentSchema;
 exports.SkillSummarySchema = SkillSummarySchema;
 exports.TailscaleInfoSchema = TailscaleInfoSchema;