@otto-code/protocol 0.8.12 → 0.8.13

package/dist/messages.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { MutableAgentBehaviorsConfigSchema, MutableLspConfigSchema, MutableDotnetSolutionConfigSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainConfigSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, } from "./daemon-config.js";
-import { VisualizerVoiceCuesGenerateRequestSchema, VisualizerVoiceCuesGenerateResponseSchema, AgentPersonalitySpinnerSchema, AgentPersonalitiesGetStatsRequestSchema, AgentPersonalitiesGenerateProfileRequestSchema, AgentPersonalitiesGetStatsResponseSchema, AgentPersonalitiesGenerateProfileResponseSchema, PersonalityMemoryListRequestMessageSchema, PersonalityMemoryListResponseMessageSchema, PersonalityMemoryUpdateRequestMessageSchema, PersonalityMemoryUpdateResponseMessageSchema, PersonalityMemoryTransferRequestMessageSchema, PersonalityMemoryTransferResponseMessageSchema, PersonalityMemoryStatsRequestMessageSchema, PersonalityMemoryStatsResponseMessageSchema, } from "./personality-schemas.js";
+import { VisualizerVoiceCuesGenerateRequestSchema, VisualizerVoiceCuesGenerateResponseSchema, AgentPersonalitySpinnerSchema, AgentPersonalityVoiceSchema, AgentPersonalityVoiceCuesSchema, AgentPersonalitiesGetStatsRequestSchema, AgentPersonalitiesGenerateProfileRequestSchema, AgentPersonalitiesGetStatsResponseSchema, AgentPersonalitiesGenerateProfileResponseSchema, PersonalityMemoryListRequestMessageSchema, PersonalityMemoryListResponseMessageSchema, PersonalityMemoryUpdateRequestMessageSchema, PersonalityMemoryUpdateResponseMessageSchema, PersonalityMemoryTransferRequestMessageSchema, PersonalityMemoryTransferResponseMessageSchema, PersonalityMemoryStatsRequestMessageSchema, PersonalityMemoryStatsResponseMessageSchema, } from "./personality-schemas.js";
 import { TerminalCompatibilityDiagnosticRequestSchema, TerminalCompatibilityDiagnosticResponseSchema, } from "./terminal-compatibility.js";
 import { HostingPrAttachmentSchema, HostingIssueAttachmentSchema, HostingSearchRequestSchema, HostingAuthStatusRequestSchema, HostingListRepositoriesRequestSchema, HostingListOwnersRequestSchema, HostingListRepositoriesResponseSchema, HostingListOwnersResponseSchema, HostingAuthStatusResponseSchema, GitHostingCapabilitiesSchema, GitHostingProviderIdWireSchema, } from "./git-hosting.js";
 import { ProjectKanbanTargetSchema, KanbanProjectTargetSetRequestSchema, KanbanProjectTargetSetResponseSchema, KanbanBoardsListRequestSchema, KanbanBoardsListResponseSchema, KanbanBoardGetRequestSchema, KanbanBoardGetResponseSchema, KanbanCardMoveRequestSchema, KanbanCardMoveResponseSchema, KanbanCardCreateRequestSchema, KanbanCardCreateResponseSchema, KanbanTaskLinkRequestSchema, KanbanTaskLinkResponseSchema, } from "./kanban.js";
@@ -87,6 +87,47 @@ export const TerminalProfileSchema = z
     icon: z.string().optional(),
 })
     .passthrough();
+/**
+ * A named launch bundle: a provider plus the agent-config values a client would
+ * otherwise set one control at a time. Field names mirror `AgentSessionConfig`
+ * so applying a profile is a copy rather than a translation table.
+ *
+ * There is deliberately no system prompt here. `AgentSessionConfig.systemPrompt`
+ * is creation-only, so a profile carrying one would apply when starting a new
+ * agent and silently do nothing when applied to a running one.
+ */
+export const AgentProfileSchema = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    /** A key into the client's icon registry, not a glyph. Unknown keys draw the default. */
+    icon: z.string().optional(),
+    /** An identity colour name shared with host badges. Unknown values draw unthemed. */
+    color: z.string().optional(),
+    provider: z.string(),
+    model: z.string().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+    /** Legacy Otto effort alias retained while profile callers converge on thinkingOptionId. */
+    effortLevel: z.string().optional(),
+    featureValues: z.record(z.string(), z.unknown()).optional(),
+    /** Free text, surfaced to orchestrating agents by the `list_profiles` MCP tool. */
+    notes: z.string().optional(),
+    /** Otto behavior and identity fields. All remain optional for older v0.4 peers. */
+    personalityPrompt: z.string().optional(),
+    respectGlobalAppendPrompt: z.boolean().optional(),
+    roles: z.array(z.string().min(1)).optional(),
+    spinner: AgentPersonalitySpinnerSchema.optional(),
+    voice: AgentPersonalityVoiceSchema.optional(),
+    voiceCues: AgentPersonalityVoiceCuesSchema.optional(),
+    memoryEnabled: z.boolean().optional(),
+})
+    .passthrough();
+const MutableRelayConfigSchema = z
+    .object({
+    enabled: z.boolean(),
+})
+    .passthrough();
 const MutableBrowserToolsConfigSchema = z
     .object({
     enabled: z.boolean().default(false),
@@ -130,6 +171,8 @@ export const SavedProviderEndpointSchema = z
     .passthrough();
 export const MutableDaemonConfigSchema = z
     .object({
+    // COMPAT(relayConfig): added in v0.2.6, remove after 2027-01-31 when old daemons are unsupported.
+    relay: MutableRelayConfigSchema.optional(),
     mcp: z
         .object({
         injectIntoAgents: z.boolean(),
@@ -239,10 +282,12 @@ export const MutableDaemonConfigSchema = z
     // Kanban board surface credentials (provider tokens). Gated by
     // server_info features.kanbanBoard; absent on older daemons.
     kanban: MutableKanbanConfigSchema.optional(),
+    agentProfiles: z.array(AgentProfileSchema).optional(),
 })
     .passthrough();
 export const MutableDaemonConfigPatchSchema = z
     .object({
+    relay: MutableRelayConfigSchema.partial().optional(),
     mcp: MutableDaemonConfigSchema.shape.mcp.partial().optional(),
     browserTools: MutableBrowserToolsConfigSchema.partial().optional(),
     // Gated by server_info features.agentBehaviorToggles; patches deep-merge.
@@ -304,6 +349,7 @@ export const MutableDaemonConfigPatchSchema = z
     // (read-modify-write), matching modelTierOverrides/savedProviderEndpoints, so
     // enabling/disabling a connector or a tool is a whole-array rewrite.
     connectors: z.array(ConnectorConfigSchema).optional(),
+    agentProfiles: z.array(AgentProfileSchema).optional(),
 })
     .partial()
     .passthrough();
@@ -376,6 +422,8 @@ export const AgentFeatureSchema = z.discriminatedUnion("type", [
 const AgentModelDefinitionSchema = z.object({
     provider: AgentProviderSchema,
     id: z.string(),
+    aliases: z.array(z.string()).optional(),
+    isSelectable: z.boolean().optional(),
     label: z.string(),
     description: z.string().optional(),
     family: z.string().optional(),
@@ -404,6 +452,25 @@ export const ProviderSnapshotEntrySchema = z.object({
     description: z.string().optional(),
     defaultModeId: z.string().nullable().optional(),
 });
+export const CompactProviderSnapshotModelSchema = AgentModelDefinitionSchema.omit({
+    provider: true,
+    thinkingOptions: true,
+}).extend({
+    thinkingSet: z.number().int().nonnegative().optional(),
+});
+export const ProviderSnapshotThinkingSetSchema = z.object({
+    options: z.array(AgentSelectOptionSchema),
+    defaultOptionId: z.string().optional(),
+});
+export const CompactProviderSnapshotEntrySchema = ProviderSnapshotEntrySchema.omit({
+    models: true,
+}).extend({
+    models: z.array(CompactProviderSnapshotModelSchema).optional(),
+});
+export const CompactProviderSnapshotSchema = z.object({
+    entries: z.array(CompactProviderSnapshotEntrySchema),
+    thinkingSets: z.array(ProviderSnapshotThinkingSetSchema),
+});
 const AgentCapabilityFlagsSchema = z
     .object({
     supportsStreaming: z.boolean(),
@@ -453,6 +520,19 @@ const AgentUsageSchema = z.object({
     // contextComposition; absent ⇒ fall back to the estimate, then to occupancy.
     contextCategories: z.array(AgentContextCategorySchema).optional(),
 });
+const ProviderOptionsSchema = z.record(z.string(), z.json());
+const McpToolRefSchema = z
+    .object({
+    kind: z.literal("mcp"),
+    server: z.string().trim().min(1),
+    tool: z.string().trim().min(1),
+})
+    .strict();
+const ToolPolicySchema = z
+    .object({
+    preapproved: z.array(McpToolRefSchema),
+})
+    .strict();
 const AgentSessionConfigSchema = z.object({
     provider: AgentProviderSchema,
     cwd: z.string(),
@@ -461,17 +541,8 @@ const AgentSessionConfigSchema = z.object({
     thinkingOptionId: z.string().optional(),
     featureValues: z.record(z.string(), z.unknown()).optional(),
     title: z.string().trim().min(1).max(MAX_EXPLICIT_AGENT_TITLE_CHARS).optional().nullable(),
-    approvalPolicy: z.string().optional(),
-    sandboxMode: z.string().optional(),
-    networkAccess: z.boolean().optional(),
-    webSearch: z.boolean().optional(),
-    extra: z
-        .object({
-        codex: z.record(z.string(), z.unknown()).optional(),
-        claude: z.record(z.string(), z.unknown()).optional(),
-    })
-        .partial()
-        .optional(),
+    providerOptions: ProviderOptionsSchema.optional(),
+    toolPolicy: ToolPolicySchema.optional(),
     systemPrompt: z.string().optional(),
     mcpServers: z.record(z.string(), McpServerConfigSchema).optional(),
 });
@@ -686,6 +757,9 @@ export const AgentTimelineItemPayloadSchema = z.union([
         items: z.array(z.object({
             text: z.string(),
             completed: z.boolean(),
+            id: z.string().optional(),
+            status: z.enum(["pending", "in_progress", "completed"]).optional(),
+            activeForm: z.string().optional(),
         })),
     }),
     z.object({
@@ -714,15 +788,18 @@ export const AgentStreamEventPayloadSchema = z.discriminatedUnion("type", [
     z.object({
         type: z.literal("turn_started"),
         provider: AgentProviderSchema,
+        turnId: z.string().optional(),
     }),
     z.object({
         type: z.literal("turn_completed"),
         provider: AgentProviderSchema,
+        turnId: z.string().optional(),
         usage: AgentUsageSchema.optional(),
     }),
     z.object({
         type: z.literal("turn_failed"),
         provider: AgentProviderSchema,
+        turnId: z.string().optional(),
         error: z.string(),
         code: z.string().optional(),
         diagnostic: z.string().optional(),
@@ -730,6 +807,7 @@ export const AgentStreamEventPayloadSchema = z.discriminatedUnion("type", [
     z.object({
         type: z.literal("turn_canceled"),
         provider: AgentProviderSchema,
+        turnId: z.string().optional(),
         reason: z.string(),
     }),
     z.object({
@@ -833,6 +911,10 @@ export const AgentCumulativeUsageSchema = z.object({
      */
     costCoverage: z.enum(["complete", "partial", "none"]).optional(),
 });
+const AgentActiveTurnPayloadSchema = z.object({
+    turnId: z.string(),
+    startedAt: z.string().nullable(),
+});
 export const AgentSnapshotPayloadSchema = z.object({
     id: z.string(),
     provider: AgentProviderSchema,
@@ -846,6 +928,7 @@ export const AgentSnapshotPayloadSchema = z.object({
     updatedAt: z.string(),
     lastUserMessageAt: z.string().nullable(),
     status: AgentStatusSchema,
+    activeTurn: AgentActiveTurnPayloadSchema.nullable().optional(),
     capabilities: AgentCapabilityFlagsSchema,
     currentModeId: z.string().nullable(),
     availableModes: z.array(AgentModeSchema),
@@ -1020,6 +1103,12 @@ export const UpdateAgentRequestMessageSchema = z.object({
 // correlated request/response; the download runs as a `pull` job. Gated by
 // server_info.features.brainHfSearch. The brain resolves its own HF token (env
 // HF_TOKEN or its config), so no secret crosses this boundary.
+// The daemon accepts only image bytes chosen or acquired by the client. It must
+// never fetch a user-provided URL on the host's network.
+export const ProjectIconSourceSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("automatic") }),
+    z.object({ type: z.literal("upload"), data: z.string() }),
+]);
 export const ProjectRenameRequestSchema = z.object({
     type: z.literal("project.rename.request"),
     projectId: z.string(),
@@ -1027,6 +1116,12 @@ export const ProjectRenameRequestSchema = z.object({
     customName: z.string().nullable(),
     requestId: z.string(),
 });
+export const ProjectIconSetRequestSchema = z.object({
+    type: z.literal("project.icon.set.request"),
+    projectId: z.string(),
+    source: ProjectIconSourceSchema,
+    requestId: z.string(),
+});
 export const ProjectRemoveRequestSchema = z.object({
     type: z.literal("project.remove.request"),
     projectId: z.string(),
@@ -1264,6 +1359,10 @@ export const FetchAgentHistoryRequestMessageSchema = z.object({
     type: z.literal("fetch_agent_history_request"),
     requestId: z.string(),
     filter: AgentDirectoryFilterSchema.optional(),
+    // A ranked free-text query over agent title, workspace name, branch, and
+    // project name. Present only on history: agent subscriptions filter on
+    // structure, not on relevance. Ranking replaces `sort` when it is set.
+    search: z.string().optional(),
     sort: z
         .array(z.object({
         key: z.enum(["status_priority", "created_at", "updated_at", "title"]),
@@ -1541,6 +1640,8 @@ export const ListAvailableProvidersRequestMessageSchema = z.object({
 export const GetProvidersSnapshotRequestMessageSchema = z.object({
     type: z.literal("get_providers_snapshot_request"),
     cwd: z.string().optional(),
+    // COMPAT(compactProviderSnapshots): old daemons ignore this field and return a full snapshot.
+    ifNoneMatch: z.string().optional(),
     requestId: z.string(),
 });
 export const RefreshProvidersSnapshotRequestMessageSchema = z.object({
@@ -1618,6 +1719,13 @@ export const FetchAgentTimelineRequestMessageSchema = z.object({
     limit: z.number().int().nonnegative().optional(),
     // Default should be projected for app timeline loading.
     projection: z.enum(["projected", "canonical"]).optional(),
+    // Allow the client to merge this bounded page outside its contiguous loaded range.
+    mergeWindow: z.boolean().optional(),
+});
+export const AgentTimelineListPromptsRequestMessageSchema = z.object({
+    type: z.literal("agent.timeline.list_prompts.request"),
+    agentId: z.string(),
+    requestId: z.string(),
 });
 export const ProviderSubagentListRequestMessageSchema = z.object({
     type: z.literal("agent.provider_subagents.list.request"),
@@ -1693,6 +1801,33 @@ export const SetAgentFeatureResponseMessageSchema = z.object({
     type: z.literal("set_agent_feature_response"),
     payload: AgentActionResponsePayloadSchema,
 });
+/**
+ * Every agent-config value a client can change in one shot. Each field is
+ * optional and an omitted field is left alone; `null` on model and thinking
+ * clears them, matching the single-field RPCs above.
+ */
+export const AgentConfigApplySchema = z.object({
+    modelId: z.string().nullable().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().nullable().optional(),
+    featureValues: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Applies a whole config bundle to one agent. The four single-field RPCs above
+ * stay for individual control edits. One request prevents client interruption
+ * and other mutations from interleaving between bundle steps; provider-level
+ * rejection can still leave earlier steps applied.
+ */
+export const AgentConfigApplyRequestMessageSchema = z.object({
+    type: z.literal("agent.config.apply.request"),
+    agentId: z.string(),
+    config: AgentConfigApplySchema,
+    requestId: z.string(),
+});
+export const AgentConfigApplyResponseMessageSchema = z.object({
+    type: z.literal("agent.config.apply.response"),
+    payload: AgentActionResponsePayloadSchema,
+});
 export const AgentDetachRequestMessageSchema = z.object({
     type: z.literal("agent.detach.request"),
     agentId: z.string(),
@@ -1839,6 +1974,15 @@ export const ProjectRenameResponseSchema = z.object({
     type: z.literal("project.rename.response"),
     payload: ProjectRenameResponsePayloadSchema,
 });
+export const ProjectIconSetResponseSchema = z.object({
+    type: z.literal("project.icon.set.response"),
+    payload: z.object({
+        requestId: z.string(),
+        projectId: z.string(),
+        accepted: z.boolean(),
+        error: z.string().nullable(),
+    }),
+});
 export const ProjectRemoveResponsePayloadSchema = z.object({
     requestId: z.string(),
     projectId: z.string(),
@@ -2060,6 +2204,12 @@ export const CheckoutGitFetchRequestSchema = z.object({
     cwd: z.string(),
     requestId: z.string(),
 });
+export const CheckoutDiscardChangesRequestSchema = z.object({
+    type: z.literal("checkout.discard_changes.request"),
+    cwd: z.string(),
+    paths: z.array(z.string()).min(1),
+    requestId: z.string(),
+});
 export const CheckoutPrCreateRequestSchema = z.object({
     type: z.literal("checkout_pr_create_request"),
     cwd: z.string(),
@@ -2550,6 +2700,8 @@ const DiffHunkSchema = z.object({
 });
 const ParsedDiffFileSchema = z.object({
     path: z.string(),
+    // COMPAT(diffOldPath): added in v0.3.0, remove gate after 2027-02-09.
+    oldPath: z.string().optional(),
     isNew: z.boolean(),
     isDeleted: z.boolean(),
     additions: z.number(),
@@ -2692,11 +2844,43 @@ export const FsFileWriteBinaryRequestSchema = z.object({
     overwrite: z.boolean().optional(),
     requestId: z.string(),
 });
+export const FileEntryCreateRequestSchema = z.object({
+    type: z.literal("fs.entry.create.request"),
+    cwd: z.string(),
+    parentPath: z.string(),
+    name: z.string(),
+    kind: z.enum(["file", "directory"]),
+    requestId: z.string(),
+});
+export const FileEntryRenameRequestSchema = z.object({
+    type: z.literal("fs.entry.rename.request"),
+    cwd: z.string(),
+    path: z.string(),
+    name: z.string(),
+    requestId: z.string(),
+});
+export const FileEntryDuplicateRequestSchema = z.object({
+    type: z.literal("fs.entry.duplicate.request"),
+    cwd: z.string(),
+    path: z.string(),
+    requestId: z.string(),
+});
+export const FileEntryDeleteRequestSchema = z.object({
+    type: z.literal("fs.entry.delete.request"),
+    cwd: z.string(),
+    path: z.string(),
+    requestId: z.string(),
+});
 export const ProjectIconRequestSchema = z.object({
     type: z.literal("project_icon_request"),
     cwd: z.string(),
     requestId: z.string(),
 });
+export const ProjectIconGetRequestSchema = z.object({
+    type: z.literal("project.icon.get.request"),
+    projectId: z.string(),
+    requestId: z.string(),
+});
 export const FileDownloadTokenRequestSchema = z.object({
     type: z.literal("file_download_token_request"),
     cwd: z.string(),
@@ -2775,6 +2959,17 @@ export const RegisterPushTokenMessageSchema = z.object({
     type: z.literal("register_push_token"),
     token: z.string(),
 });
+export const PushUnregisterRequestSchema = z.object({
+    type: z.literal("push.unregister.request"),
+    token: z.string(),
+    requestId: z.string(),
+});
+export const PushUnregisterResponseSchema = z.object({
+    type: z.literal("push.unregister.response"),
+    payload: z.object({
+        requestId: z.string(),
+    }),
+});
 // ============================================================================
 // Terminal Messages
 // ============================================================================
@@ -2881,7 +3076,12 @@ export const UnsubscribeTerminalRequestSchema = z.object({
 });
 const TerminalClientMessageSchema = z.discriminatedUnion("type", [
     z.object({ type: z.literal("input"), data: z.string() }),
-    z.object({ type: z.literal("resize"), rows: z.number(), cols: z.number() }),
+    z.object({
+        type: z.literal("resize"),
+        rows: z.number(),
+        cols: z.number(),
+        intent: z.enum(["claim", "update"]).optional(),
+    }),
     z.object({
         type: z.literal("mouse"),
         row: z.number(),
@@ -2915,14 +3115,47 @@ export const HubExecutionAgentCreateRequestSchema = z.object({
     provider: z.string(),
     cwd: z.string(),
     prompt: z.string(),
+    // COMPAT(hubExecutionWorkspaceSelection): semantics retired in v0.3.1; remove after 2027-08-08 once the Hub floor no longer sends it.
     workspaceId: z.string().optional(),
     model: z.string().optional(),
     modeId: z.string().optional(),
     thinkingOptionId: z.string().optional(),
     featureValues: z.record(z.string(), z.unknown()).optional(),
+    providerOptions: ProviderOptionsSchema.optional(),
+    toolPolicy: ToolPolicySchema.optional(),
     env: z.record(z.string(), z.string()).optional(),
+    mcpServers: z.record(z.string(), McpServerConfigSchema).optional(),
     worktree: CreateAgentWorktreeTargetSchema.optional(),
 });
+export const HubExecutionAgentValidateRequestSchema = z.object({
+    type: z.literal("hub.execution.agent.validate.request"),
+    requestId: z.string(),
+    provider: z.string(),
+    model: z.string().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+    providerOptions: ProviderOptionsSchema.optional(),
+});
+const HubExecutionAgentCreateErrorSchema = z.discriminatedUnion("code", [
+    z.object({
+        code: z.literal("provider_options_invalid"),
+        provider: z.string(),
+        issues: z.array(z.object({
+            path: z.array(z.union([z.string(), z.number()])),
+            message: z.string(),
+        })),
+        message: z.string(),
+    }),
+    z.object({
+        code: z.literal("tool_policy_unsupported"),
+        provider: z.string(),
+        message: z.string(),
+    }),
+    z.object({
+        code: z.literal("create_failed"),
+        message: z.string(),
+    }),
+]);
 export const HubExecutionControlActionSchema = z.enum(["interrupt", "archive"]);
 export const HubExecutionControlRequestSchema = z.object({
     type: z.literal("hub.execution.control.request"),
@@ -2932,6 +3165,7 @@ export const HubExecutionControlRequestSchema = z.object({
 });
 export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateRequestSchema,
+    HubExecutionAgentValidateRequestSchema,
     HubExecutionControlRequestSchema,
     BrowserAutomationExecuteResponseSchema,
     VoiceAudioChunkMessageSchema,
@@ -2989,6 +3223,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     UpdateAgentRequestMessageSchema,
     ProjectRenameRequestSchema,
     KanbanProjectTargetSetRequestSchema,
+    ProjectIconSetRequestSchema,
     ProjectRemoveRequestSchema,
     ProjectLinksListRequestSchema,
     ProjectLinksSetRequestSchema,
@@ -3084,6 +3319,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     RestartServerRequestMessageSchema,
     DaemonUpdateRequestMessageSchema,
     FetchAgentTimelineRequestMessageSchema,
+    AgentTimelineListPromptsRequestMessageSchema,
     ProviderSubagentListRequestMessageSchema,
     ProviderSubagentTimelineRequestMessageSchema,
     SetAgentTimelineSubscriptionRequestMessageSchema,
@@ -3092,6 +3328,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     SetAgentModelRequestMessageSchema,
     SetAgentThinkingRequestMessageSchema,
     SetAgentFeatureRequestMessageSchema,
+    AgentConfigApplyRequestMessageSchema,
     AgentDetachRequestMessageSchema,
     AgentWorkspaceTransferRequestMessageSchema,
     AgentSubagentStopRequestMessageSchema,
@@ -3135,6 +3372,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPushRequestSchema,
     CheckoutRefreshRequestSchema,
     CheckoutGitFetchRequestSchema,
+    CheckoutDiscardChangesRequestSchema,
     CheckoutPrCreateRequestSchema,
     CheckoutPrMergeRequestSchema,
     CheckoutForgeSetAutoMergeRequestSchema,
@@ -3192,7 +3430,12 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     FileUnsubscribeRequestSchema,
     FsFileWriteRequestSchema,
     FsFileWriteBinaryRequestSchema,
+    FileEntryCreateRequestSchema,
+    FileEntryRenameRequestSchema,
+    FileEntryDuplicateRequestSchema,
+    FileEntryDeleteRequestSchema,
     ProjectIconRequestSchema,
+    ProjectIconGetRequestSchema,
     FileDownloadTokenRequestSchema,
     FileUploadRequestSchema,
     FileWriteRequestSchema,
@@ -3225,6 +3468,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     PingMessageSchema,
     ListCommandsRequestSchema,
     RegisterPushTokenMessageSchema,
+    PushUnregisterRequestSchema,
     ListTerminalsRequestSchema,
     SubscribeTerminalsRequestSchema,
     UnsubscribeTerminalsRequestSchema,
@@ -3425,6 +3669,8 @@ export const ServerInfoStatusPayloadSchema = z
     features: z
         .object({
         providersSnapshot: z.boolean().optional(),
+        // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
+        providersSnapshotCwd: z.boolean().optional(),
         // COMPAT(checkoutForgeSetAutoMerge): added in v0.1.106, remove old
         // checkoutGithubSetAutoMerge fallback after 2026-12-28.
         checkoutForgeSetAutoMerge: z.boolean().optional(),
@@ -3437,6 +3683,10 @@ export const ServerInfoStatusPayloadSchema = z
         forgeSearch: z.boolean().optional(),
         // COMPAT(daemonStatusRpc): added in v0.1.76, remove gate after 2026-11-18.
         daemonStatusRpc: z.boolean().optional(),
+        // COMPAT(relayConfig): added in v0.2.6, remove gate after 2027-01-31.
+        relayConfig: z.boolean().optional(),
+        // COMPAT(pushTokenRevocation): added in v0.3.2, remove gate after 2027-02-10.
+        pushTokenRevocation: z.boolean().optional(),
         // COMPAT(terminalRestoreModes): added in v0.1.81, remove gate after 2026-11-23.
         "terminal-restore-modes": z.boolean().optional(),
         // COMPAT(terminalCompatibilityDiagnostic): added in v0.8.9, remove gate after 2027-02-12.
@@ -3444,8 +3694,16 @@ export const ServerInfoStatusPayloadSchema = z
         terminalEmbeddedPresentation: z.boolean().optional(),
         // COMPAT(terminalTitleSettings): added in v0.8.5, remove gate after 2027-02-07.
         terminalTitleSettings: z.boolean().optional(),
+        // COMPAT(terminalInputModeReplay): added in v0.2.6, remove gate after 2027-02-02.
+        "terminal-input-mode-replay": z.boolean().optional(),
+        // COMPAT(terminalSizeOwnership): added in v0.2.6, remove gate after 2027-02-02.
+        "terminal-size-ownership": z.boolean().optional(),
         // COMPAT(rewind): added in v0.1.X, drop the gate when floor >= v0.1.X.
         rewind: z.boolean().optional(),
+        // COMPAT(agentTimelinePromptIndex): added in v0.2.X, drop the gate when floor >= v0.2.X.
+        agentTimelinePromptIndex: z.boolean().optional(),
+        // COMPAT(agentHistorySearch): added in v0.3.0, remove gate after 2027-02-07.
+        agentHistorySearch: z.boolean().optional(),
         // COMPAT(checkoutRefresh): added in v0.1.86, remove gate after 2026-11-29.
         checkoutRefresh: z.boolean().optional(),
         // COMPAT(gitFetchControl): added in v0.8.11, remove gate after 2027-02-14.
@@ -3493,6 +3751,10 @@ export const ServerInfoStatusPayloadSchema = z
         // older daemons, whose Brain config rejects the field.
         // COMPAT(brainRuntimeLogVerbosity): added in v0.8.10, drop the gate when daemon floor >= v0.8.10.
         brainRuntimeLogVerbosity: z.boolean().optional(),
+        // The Brain host can keep multiple independent model processes resident
+        // and exposes maxLoadedModels/lockedModels in local and remote settings.
+        // COMPAT(brainModelProcessPool): added in v0.8.12, remove after 2027-02-21.
+        brainModelProcessPool: z.boolean().optional(),
         // Daemon streams the brain's live status/telemetry via
         // subscribe_brain_status + brain_status_changed, and serves brain.evals.get.
         // Separate from brainControl because status/eval watching can ship after
@@ -3930,10 +4192,29 @@ export const ServerInfoStatusPayloadSchema = z
         forgeProviders: z.boolean().optional(),
         // COMPAT(selectiveAgentTimeline): added in v0.1.106, remove after 2027-01-12.
         selectiveAgentTimeline: z.boolean().optional(),
+        // COMPAT(canonicalSubmittedPrompts): added in v0.2.6, remove gate after 2027-01-30.
+        canonicalSubmittedPrompts: z.boolean().optional(),
+        // COMPAT(agentTurnIdentity): accept peers that observed pre-release v0.2.6 through 2027-01-31.
+        agentTurnIdentity: z.boolean().optional(),
         // COMPAT(stableProjectIdentity): added in v0.1.109, remove gate after 2027-01-15.
         stableProjectIdentity: z.boolean().optional(),
         // COMPAT(workspaceScriptManagement): added in v0.1.105, remove gate after 2027-01-10.
         workspaceScriptManagement: z.boolean().optional(),
+        // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
+        projectCustomIcon: z.boolean().optional(),
+        // COMPAT(fsEntryOps): added in v0.3.0, remove gate after 2027-02-08.
+        fsEntryOps: z.boolean().optional(),
+        // COMPAT(fsEntryDuplicate): added in v0.3.0, remove gate after 2027-02-09.
+        fsEntryDuplicate: z.boolean().optional(),
+        // COMPAT(checkoutDiscardChanges): added in v0.3.0, remove gate after 2027-02-08.
+        checkoutDiscardChanges: z.boolean().optional(),
+        // COMPAT(agentProfiles): added in v0.3.2, remove gate after 2027-02-11.
+        // An older daemon parses its persisted config strictly, so writing
+        // agentProfiles to one is silently dropped. The client hides the feature
+        // rather than letting a save appear to succeed.
+        agentProfiles: z.boolean().optional(),
+        // COMPAT(agentConfigApply): added in v0.3.2, remove gate after 2027-02-11.
+        agentConfigApply: z.boolean().optional(),
     })
         .optional(),
 })
@@ -4226,8 +4507,14 @@ export const WorkspaceDescriptorPayloadSchema = z
     // COMPAT(projectKanbanTarget): added in v0.8.11, drop the optional gate when
     // floor >= v0.8.11.
     projectKanban: ProjectKanbanTargetSchema.nullable().optional(),
+    // Identifies the project's stored custom icon; null means automatic.
+    // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
+    projectCustomIconRevision: z.string().nullable().optional(),
     projectRootPath: z.string(),
     workspaceDirectory: z.string().optional(),
+    // COMPAT(worktreeSlug): added in v0.2.6, remove optional after 2027-01-31.
+    // Present only for Otto-owned worktrees; this is the basename of their root directory.
+    worktreeSlug: z.string().optional(),
     projectKind: z.enum(["git", "non_git", "directory"]),
     // COMPAT(workspaces): keep the legacy "directory" workspace kind parseable.
     // Persisted registries still carry it and there is no migration, so this
@@ -4328,9 +4615,25 @@ export const AgentListMessageSchema = z.object({
         agents: z.array(AgentSnapshotPayloadSchema),
     }),
 });
+export const AgentSearchMatchFieldSchema = z.enum(["workspace", "title", "branch", "project"]);
+export const AgentSearchMatchSchema = z.object({
+    field: AgentSearchMatchFieldSchema,
+    ranges: z.array(z.object({
+        start: z.number().int().nonnegative(),
+        length: z.number().int().positive(),
+    })),
+});
 const AgentDirectoryResponseEntrySchema = z.object({
     agent: AgentSnapshotPayloadSchema,
     project: ProjectPlacementPayloadSchema,
+    // Relevance of this entry to the request's `search`, lower being better.
+    // Set only when the request carried a query; a client merging results from
+    // several hosts needs it to interleave their separately ranked pages.
+    searchScore: z.number().optional(),
+    // Where the query matched, so the row can mark it. The ranker computes this
+    // anyway; sending it keeps the client from re-deriving a second opinion that
+    // could disagree with the ranking it is explaining.
+    searchMatches: z.array(AgentSearchMatchSchema).optional(),
 });
 const AgentDirectoryPageInfoSchema = z.object({
     nextCursor: z.string().nullable(),
@@ -4352,6 +4655,10 @@ export const FetchAgentHistoryResponseMessageSchema = z.object({
         requestId: z.string(),
         entries: z.array(AgentDirectoryResponseEntrySchema),
         pageInfo: AgentDirectoryPageInfoSchema,
+        // More sessions matched the request's `search` than the page could hold.
+        // Distinct from `pageInfo.hasMore`, which promises a fetchable next page —
+        // a ranked result set has none, and the way on is a narrower query.
+        searchTruncated: z.boolean().optional(),
     }),
 });
 export const FetchRecentProviderSessionsResponseMessageSchema = z.object({
@@ -4378,6 +4685,8 @@ export const WorkspaceProjectDescriptorPayloadSchema = z.object({
     // COMPAT(projectKanbanTarget): added in v0.8.11, drop the optional gate when
     // floor >= v0.8.11.
     projectKanban: ProjectKanbanTargetSchema.nullable().optional(),
+    // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
+    projectCustomIconRevision: z.string().nullable().optional(),
     projectRootPath: z.string(),
     projectKind: z.enum(["git", "non_git", "directory"]),
 });
@@ -4755,10 +5064,25 @@ export const FetchAgentTimelineResponseMessageSchema = z.object({
         endCursor: AgentTimelineCursorSchema.nullable(),
         hasOlder: z.boolean(),
         hasNewer: z.boolean(),
+        mergeWindow: z.boolean().optional(),
         entries: z.array(AgentTimelineEntryPayloadSchema),
         error: z.string().nullable(),
     }),
 });
+export const AgentTimelineListPromptsResponseMessageSchema = z.object({
+    type: z.literal("agent.timeline.list_prompts.response"),
+    payload: z.object({
+        requestId: z.string(),
+        agentId: z.string(),
+        epoch: z.string(),
+        prompts: z.array(z.object({
+            seq: z.number().int().nonnegative(),
+            timestamp: z.string(),
+            preview: z.string(),
+        })),
+        error: z.string().nullable(),
+    }),
+});
 export const ProviderSubagentDescriptorPayloadSchema = z.object({
     id: z.string(),
     parentAgentId: z.string(),
@@ -4770,6 +5094,9 @@ export const ProviderSubagentDescriptorPayloadSchema = z.object({
     updatedAt: z.string(),
     toolCallId: z.string().nullable(),
     cwd: z.string().nullable().optional(),
+    // Compact provider-owned context for the shared track. Providers choose what belongs here and
+    // format it for display; clients must not parse provider-specific facts out of this string.
+    subtitle: z.string().nullable().optional(),
 });
 export const ProviderSubagentListResponseMessageSchema = z.object({
     type: z.literal("agent.provider_subagents.list.response"),
@@ -5054,6 +5381,7 @@ export const ReadProjectConfigResponseMessageSchema = z.object({
             ok: z.literal(true),
             config: OttoConfigRawSchema.nullable(),
             revision: OttoConfigRevisionSchema.nullable(),
+            hasUncommittedWorktreeSetupChanges: z.boolean().optional(),
         }),
         z.object({
             requestId: z.string(),
@@ -5074,6 +5402,7 @@ export const WriteProjectConfigResponseMessageSchema = z.object({
             ok: z.literal(true),
             config: OttoConfigRawSchema,
             revision: OttoConfigRevisionSchema,
+            hasUncommittedWorktreeSetupChanges: z.boolean().optional(),
         }),
         z.object({
             requestId: z.string(),
@@ -5152,6 +5481,13 @@ const CheckoutStatusCommonSchema = z.object({
     // client inferred from isOttoOwnedWorktree.
     // COMPAT(checkoutDiffBaseAnyRepo): added in v0.7.4.
     isBaseEditable: z.boolean().optional(),
+    // The full ref currentBranch tracks, as git resolves `<branch>@{upstream}`:
+    // "refs/remotes/origin/main", "refs/remotes/upstream/main" on a fork, or a
+    // "refs/heads/..." ref for a branch tracking a local branch. Null when there is no
+    // upstream. Clients use it verbatim — the remote is not necessarily origin and the
+    // upstream branch name is not necessarily currentBranch, so composing one is wrong.
+    // aheadOfOrigin/behindOfOrigin are measured against exactly this ref.
+    upstreamRef: z.string().nullable().optional(),
 });
 const CheckoutStatusNotGitSchema = CheckoutStatusCommonSchema.extend({
     isGit: z.literal(false),
@@ -5547,6 +5883,15 @@ export const CheckoutGithubSetAutoMergeResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const CheckoutDiscardChangesResponseSchema = z.object({
+    type: z.literal("checkout.discard_changes.response"),
+    payload: z.object({
+        cwd: z.string(),
+        success: z.boolean(),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
+});
 export const CheckoutCommitsListResponseSchema = z.object({
     type: z.literal("checkout.commits.list.response"),
     payload: z.object({
@@ -5845,6 +6190,8 @@ export const BranchSuggestionsResponseSchema = z.object({
             // older daemons, in which case pickers disable nothing (today's
             // behavior).
             checkedOutElsewhere: z.boolean().optional(),
+            localAhead: z.number().int().nonnegative().optional(),
+            localBehind: z.number().int().nonnegative().optional(),
         }))
             .optional(),
         error: z.string().nullable(),
@@ -5996,6 +6343,49 @@ export const FsFileWriteBinaryResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const FileEntryCreateResponseSchema = z.object({
+    type: z.literal("fs.entry.create.response"),
+    payload: z.object({
+        cwd: z.string(),
+        parentPath: z.string(),
+        path: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryRenameResponseSchema = z.object({
+    type: z.literal("fs.entry.rename.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        renamedPath: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryDuplicateResponseSchema = z.object({
+    type: z.literal("fs.entry.duplicate.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        duplicatedPath: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryDeleteResponseSchema = z.object({
+    type: z.literal("fs.entry.delete.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 export const FileUpdateSchema = z.object({
     type: z.literal("fs.file.update"),
     payload: z.object({
@@ -6016,6 +6406,15 @@ export const ProjectIconResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const ProjectIconGetResponseSchema = z.object({
+    type: z.literal("project.icon.get.response"),
+    payload: z.object({
+        projectId: z.string(),
+        icon: ProjectIconSchema.nullable(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 export const FileDownloadTokenResponseSchema = z.object({
     type: z.literal("file_download_token_response"),
     payload: z.object({
@@ -6118,7 +6517,11 @@ export const ListAvailableProvidersResponseSchema = z.object({
 export const GetProvidersSnapshotResponseMessageSchema = z.object({
     type: z.literal("get_providers_snapshot_response"),
     payload: z.object({
+        cwd: z.string().optional(),
         entries: z.array(ProviderSnapshotEntrySchema),
+        compactSnapshot: CompactProviderSnapshotSchema.optional(),
+        snapshotHash: z.string().optional(),
+        notModified: z.boolean().optional(),
         generatedAt: z.string(),
         requestId: z.string(),
     }),
@@ -6129,6 +6532,8 @@ export const ProvidersSnapshotUpdateMessageSchema = z.object({
     payload: z.object({
         cwd: z.string().optional(),
         entries: z.array(ProviderSnapshotEntrySchema),
+        compactSnapshot: CompactProviderSnapshotSchema.optional(),
+        snapshotHash: z.string().optional(),
         generatedAt: z.string(),
     }),
 });
@@ -6370,6 +6775,20 @@ export const HubExecutionAgentCreateResponseSchema = z.object({
         agentId: z.string().nullable(),
         agent: AgentSnapshotPayloadSchema.nullable(),
         success: z.boolean(),
+        toolPolicyApplied: z.literal(true).optional(),
+        error: HubExecutionAgentCreateErrorSchema.nullable(),
+    }),
+});
+export const HubExecutionAgentValidationIssueSchema = z.object({
+    path: z.array(z.union([z.string(), z.number()])),
+    message: z.string(),
+});
+export const HubExecutionAgentValidateResponseSchema = z.object({
+    type: z.literal("hub.execution.agent.validate.response"),
+    payload: z.object({
+        requestId: z.string(),
+        valid: z.boolean(),
+        issues: z.array(HubExecutionAgentValidationIssueSchema),
         error: z.string().nullable(),
     }),
 });
@@ -6401,6 +6820,7 @@ export const HubExecutionAgentStreamSchema = z.object({
 });
 export const HubExecutionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateResponseSchema,
+    HubExecutionAgentValidateResponseSchema,
     HubExecutionControlResponseSchema,
     HubExecutionAgentUpdateSchema,
     HubExecutionAgentStreamSchema,
@@ -6425,6 +6845,7 @@ export function parseHubExecutionOutboundMessage(value) {
 }
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateResponseSchema,
+    HubExecutionAgentValidateResponseSchema,
     HubExecutionControlResponseSchema,
     HubExecutionAgentUpdateSchema,
     HubExecutionAgentStreamSchema,
@@ -6441,6 +6862,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     DictationStreamErrorMessageSchema,
     StatusMessageSchema,
     PongMessageSchema,
+    PushUnregisterResponseSchema,
     RpcErrorMessageSchema,
     ArtifactMessageSchema,
     ArtifactUpdateMessageSchema,
@@ -6478,6 +6900,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     WorktreeReattachResponseSchema,
     FetchAgentResponseMessageSchema,
     FetchAgentTimelineResponseMessageSchema,
+    AgentTimelineListPromptsResponseMessageSchema,
     ProviderSubagentListResponseMessageSchema,
     ProviderSubagentTimelineResponseMessageSchema,
     ProviderSubagentUpdateMessageSchema,
@@ -6538,6 +6961,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     SetAgentModelResponseMessageSchema,
     SetAgentThinkingResponseMessageSchema,
     SetAgentFeatureResponseMessageSchema,
+    AgentConfigApplyResponseMessageSchema,
     AgentDetachResponseMessageSchema,
     AgentWorkspaceTransferResponseMessageSchema,
     AgentQueueRemoveResponseMessageSchema,
@@ -6557,6 +6981,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectRenameResponseSchema,
     KanbanProjectTargetSetResponseSchema,
     ProjectUpdatedNotificationSchema,
+    ProjectIconSetResponseSchema,
     ProjectRemoveResponseSchema,
     ProjectLinksListResponseSchema,
     ProjectLinksSetResponseSchema,
@@ -6647,6 +7072,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPushResponseSchema,
     CheckoutRefreshResponseSchema,
     CheckoutGitFetchResponseSchema,
+    CheckoutDiscardChangesResponseSchema,
     CheckoutPrCreateResponseSchema,
     CheckoutPrMergeResponseSchema,
     CheckoutForgeSetAutoMergeResponseSchema,
@@ -6688,8 +7114,13 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     FileUnsubscribeResponseSchema,
     FsFileWriteResponseSchema,
     FsFileWriteBinaryResponseSchema,
+    FileEntryCreateResponseSchema,
+    FileEntryRenameResponseSchema,
+    FileEntryDuplicateResponseSchema,
+    FileEntryDeleteResponseSchema,
     FileUpdateSchema,
     ProjectIconResponseSchema,
+    ProjectIconGetResponseSchema,
     FileDownloadTokenResponseSchema,
     FileUploadResponseSchema,
     FileWriteResponseSchema,
@@ -6824,6 +7255,7 @@ export const WSHelloMessageSchema = z.object({
         [CLIENT_CAPS.terminalReflowableSnapshot]: z.boolean().optional(),
         [CLIENT_CAPS.providerSubagents]: z.boolean().optional(),
         [CLIENT_CAPS.projectUpdates]: z.boolean().optional(),
+        [CLIENT_CAPS.compactProviderSnapshots]: z.boolean().optional(),
         [CLIENT_CAPS.browserHost]: BrowserAutomationHostCapabilitySchema.optional(),
     })
         .passthrough()