@otto-code/protocol 0.9.0 → 0.9.2

package/dist/messages.js

@@ -1,3 +1,7 @@
+import { AgentRateLimitInfoSchema } from "./agent-rate-limit.js";
+export { AgentRateLimitInfoSchema } from "./agent-rate-limit.js";
+import { WSPingMessageSchema, WSPongMessageSchema, WSHelloMessageSchema, WSRecordingStateMessageSchema, } from "./websocket-control.js";
+export { WSPingMessageSchema, WSPongMessageSchema, WSHelloMessageSchema, WSRecordingStateMessageSchema, } from "./websocket-control.js";
 import { z } from "zod";
 import { MutableAgentBehaviorsConfigSchema, MutableAgentBehaviorsConfigPatchSchema, MutableLspConfigSchema, MutableLspConfigPatchSchema, MutableDotnetSolutionConfigSchema, MutableDotnetSolutionConfigPatchSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, MutableProjectKnowledgeConfigSchema, MutableProjectKnowledgeConfigPatchSchema, MutableProjectArtifactsConfigSchema, MutableProjectArtifactsConfigPatchSchema, MutableProjectWorkflowsConfigSchema, MutableProjectWorkflowsConfigPatchSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainConfigSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, } from "./daemon-config.js";
 import { VisualizerVoiceCuesGenerateRequestSchema, VisualizerVoiceCuesGenerateResponseSchema, AgentProfileSpinnerSchema, AgentPersonalityVoiceSchema, AgentPersonalityVoiceCuesSchema, AgentPersonalitiesGetStatsRequestSchema, AgentPersonalitiesGenerateProfileRequestSchema, AgentPersonalitiesGetStatsResponseSchema, AgentPersonalitiesGenerateProfileResponseSchema, AgentProfileStatsRequestSchema, AgentProfileStatsResponseSchema, AgentProfileGeneratePromptRequestSchema, AgentProfileGeneratePromptResponseSchema, AgentProfileGenerateVoiceCuesRequestSchema, AgentProfileGenerateVoiceCuesResponseSchema, PersonalityMemoryListRequestMessageSchema, PersonalityMemoryListResponseMessageSchema, PersonalityMemoryUpdateRequestMessageSchema, PersonalityMemoryUpdateResponseMessageSchema, PersonalityMemoryTransferRequestMessageSchema, PersonalityMemoryTransferResponseMessageSchema, PersonalityMemoryStatsRequestMessageSchema, PersonalityMemoryStatsResponseMessageSchema, ProfileMemoryListRequestMessageSchema, ProfileMemoryListResponseMessageSchema, ProfileMemoryUpdateRequestMessageSchema, ProfileMemoryUpdateResponseMessageSchema, ProfileMemoryTransferRequestMessageSchema, ProfileMemoryTransferResponseMessageSchema, ProfileMemoryStatsRequestMessageSchema, ProfileMemoryStatsResponseMessageSchema, } from "./personality-schemas.js";
@@ -13,7 +17,7 @@ import { QueuedAgentMessagePayloadSchema, AgentQueueRemoveRequestMessageSchema,
 import { FileEolSchema, FileCreateRequestSchema, FileDeleteRequestSchema, FileRenameRequestSchema, FileWatchSubscribeRequestSchema, FileWatchUnsubscribeRequestSchema, FileSearchRequestSchema, FileReplaceRequestSchema, FileCreateResponseSchema, FileDeleteResponseSchema, FileRenameResponseSchema, FileWatchSubscribeResponseSchema, FileWatchUnsubscribeResponseSchema, FileSearchResultEventSchema, FileSearchResponseSchema, FileReplaceResponseSchema, FileWatchEventSchema, } from "./file-operations.js";
 import { FileRefineRequestSchema, FileRefineResponseSchema } from "./refine.js";
 import { MutableSpeechConfigSchema, SpeechSettingsGetOptionsRequestSchema, SpeechTtsPreviewRequestSchema, SpeechTtsSpeakRequestSchema, SpeechTtsSpeakCancelRequestSchema, SpeechSettingsGetOptionsResponseSchema, SpeechTtsPreviewResponseSchema, SpeechTtsSpeakResponseSchema, SpeechTtsSpeakCancelResponseSchema, } from "./speech.js";
-import { ProjectKnowledgeListRequestMessageSchema, ProjectKnowledgeListResponseMessageSchema, ProjectKnowledgeGetRequestMessageSchema, ProjectKnowledgeGetResponseMessageSchema, ProjectKnowledgeCreateRequestMessageSchema, ProjectKnowledgeCreateResponseMessageSchema, ProjectKnowledgeApplyRequestMessageSchema, ProjectKnowledgeApplyResponseMessageSchema, ProjectKnowledgeStatusRequestMessageSchema, ProjectKnowledgeStatusResponseMessageSchema, ProjectKnowledgeProjectApplyRequestMessageSchema, ProjectKnowledgeProjectApplyResponseMessageSchema, ProjectKnowledgeReferenceApplyRequestMessageSchema, ProjectKnowledgeReferenceApplyResponseMessageSchema, ProjectKnowledgeRootApplyRequestMessageSchema, ProjectKnowledgeRootApplyResponseMessageSchema, ProjectKnowledgeRefineApplyRequestMessageSchema, ProjectKnowledgeRefineApplyResponseMessageSchema, ProjectKnowledgeRefinementProposeRequestMessageSchema, ProjectKnowledgeRefinementProposeResponseMessageSchema, ProjectKnowledgeDeleteRequestMessageSchema, ProjectKnowledgeStoreLocationValueSchema, ProjectKnowledgeStoreGetRequestMessageSchema, ProjectKnowledgeStoreGetResponseMessageSchema, ProjectKnowledgeStoreSetRequestMessageSchema, ProjectKnowledgeStoreSetResponseMessageSchema, ProjectKnowledgeDeleteResponseMessageSchema, } from "./project-knowledge.js";
+import { ProjectKnowledgeListRequestMessageSchema, ProjectKnowledgeListResponseMessageSchema, ProjectKnowledgeGetRequestMessageSchema, ProjectKnowledgeGetResponseMessageSchema, ProjectKnowledgeRootGetRequestMessageSchema, ProjectKnowledgeRootGetResponseMessageSchema, ProjectKnowledgeCreateRequestMessageSchema, ProjectKnowledgeCreateResponseMessageSchema, ProjectKnowledgeApplyRequestMessageSchema, ProjectKnowledgeApplyResponseMessageSchema, ProjectKnowledgeStatusRequestMessageSchema, ProjectKnowledgeStatusResponseMessageSchema, ProjectKnowledgeProjectApplyRequestMessageSchema, ProjectKnowledgeProjectApplyResponseMessageSchema, ProjectKnowledgeReferenceApplyRequestMessageSchema, ProjectKnowledgeReferenceApplyResponseMessageSchema, ProjectKnowledgeRootApplyRequestMessageSchema, ProjectKnowledgeRootApplyResponseMessageSchema, ProjectKnowledgeRefineApplyRequestMessageSchema, ProjectKnowledgeRefineApplyResponseMessageSchema, ProjectKnowledgeRefinementProposeRequestMessageSchema, ProjectKnowledgeRefinementProposeResponseMessageSchema, ProjectKnowledgeDeleteRequestMessageSchema, ProjectKnowledgeStoreLocationValueSchema, ProjectKnowledgeStoreGetRequestMessageSchema, ProjectKnowledgeStoreGetResponseMessageSchema, ProjectKnowledgeStoreSetRequestMessageSchema, ProjectKnowledgeStoreSetResponseMessageSchema, ProjectKnowledgeDeleteResponseMessageSchema, } from "./project-knowledge.js";
 import { CheckoutGitGetOperationLogRequestSchema, CheckoutGitGetOperationLogResponseSchema, CheckoutGitLogAppendedNotificationSchema, CheckoutGitCommitRequestSchema, CheckoutGitCommitAgentRequestSchema, CheckoutGitRollbackRequestSchema, CheckoutGitCommitResponseSchema, CheckoutGitCommitAgentResponseSchema, CheckoutGitRollbackResponseSchema, GitFileHistoryEntrySchema, GitBlameLineSchema, GitBlameCommitSchema, } from "./git-operations.js";
 import { LspServersListRequestSchema, LspServerStopRequestSchema, LspActivityChangedStatusPayloadSchema, LspDiagnosticsChangedStatusPayloadSchema, LspServersListResponseSchema, LspServerStopResponseSchema, CodeListFilesRequestSchema, CodeSymbolsRequestSchema, CodeOutlineRequestSchema, CodeDefinitionRequestSchema, CodeDocumentSyncRequestSchema, CodeDocumentCloseRequestSchema, CodeHoverRequestSchema, CodeReferencesRequestSchema, CodeRenamePreviewRequestSchema, CodeRenameApplyRequestSchema, CodeRenameUndoRequestSchema, CodeSolutionListRequestSchema, CodeSolutionGetTreeRequestSchema, CodeSolutionLoadProjectRequestSchema, CodeListFilesResponseSchema, CodeSymbolsResponseSchema, CodeDefinitionResponseSchema, CodeDocumentSyncResponseSchema, CodeDocumentCloseResponseSchema, CodeHoverResponseSchema, CodeReferencesResponseSchema, CodeRenamePreviewResponseSchema, CodeRenameUndoResponseSchema, CodeRenameApplyResponseSchema, CodeSolutionListResponseSchema, CodeSolutionGetTreeResponseSchema, CodeSolutionLoadProjectResponseSchema, CodeOutlineResponseSchema, } from "./code-intelligence.js";
 import { CommunicationsGetOverviewRequestSchema, CommunicationsGetOverviewResponseSchema, CommunicationsInboxGetHomeRequestSchema, CommunicationsInboxGetHomeResponseSchema, CommunicationsInboxSearchRequestSchema, CommunicationsInboxSearchResponseSchema, CommunicationsInboxSetFavoriteRequestSchema, CommunicationsInboxSetFavoriteResponseSchema, CommunicationsInboxNotificationsAcknowledgeRequestSchema, CommunicationsInboxNotificationsAcknowledgeResponseSchema, CommunicationsInboxGetPresenceRequestSchema, CommunicationsInboxGetPresenceResponseSchema, CommunicationsInboxPresenceChangedNotificationSchema, CommunicationsInboxSetPresenceRequestSchema, CommunicationsInboxSetPresenceResponseSchema, CommunicationsInboxSetEnabledRequestSchema, CommunicationsInboxSetEnabledResponseSchema, CommunicationsInboxGetMessagesRequestSchema, CommunicationsInboxGetMessagesResponseSchema, CommunicationsInboxSendMessageRequestSchema, CommunicationsInboxSendMessageResponseSchema, CommunicationsRoomGetRequestSchema, CommunicationsRoomGetResponseSchema, CommunicationsRoomThreadGetRequestSchema, CommunicationsRoomThreadGetResponseSchema, CommunicationsRoomMessageSendRequestSchema, CommunicationsRoomMessageSendResponseSchema, CommunicationsRoomReactionSetRequestSchema, CommunicationsRoomReactionSetResponseSchema, } from "./communications.js";
@@ -25,8 +29,7 @@ import { BrainLogsWatchRequestSchema, BrainLogLineAddedStatusPayloadSchema, Brai
 import { TerminalActivitySchema } from "./terminal-activity.js";
 import { ArtifactMetadataSchema, ProjectArtifactStoreLocationValueSchema, } from "./artifacts/types.js";
 import { ArtifactListRequestSchema, ArtifactCreateRequestSchema, ArtifactUpdateRequestSchema, ArtifactRegenerateRequestSchema, ArtifactCancelRequestSchema, ArtifactDeleteRequestSchema, ArtifactStarRequestSchema, ArtifactGetContentRequestSchema, ArtifactRepairRequestSchema, ArtifactDataGetRequestSchema, ArtifactDataUpdateRequestSchema, ArtifactStoreMoveRequestSchema, ProjectArtifactStoreSetRequestSchema, ArtifactListResponseSchema, ArtifactCreateResponseSchema, ArtifactUpdateResponseSchema, ArtifactRegenerateResponseSchema, ArtifactCancelResponseSchema, ArtifactDeleteResponseSchema, ArtifactStarResponseSchema, ArtifactGetContentResponseSchema, ArtifactRepairResponseSchema, ArtifactDataGetResponseSchema, ArtifactDataUpdateResponseSchema, ArtifactStoreMoveResponseSchema, ProjectArtifactStoreSetResponseSchema, ArtifactCreatedNotificationSchema, ArtifactUpdatedNotificationSchema, ArtifactDeletedNotificationSchema, } from "./artifacts/rpc-schemas.js";
-import { ArchitecturalViewsDeliverRequestSchema, ArchitecturalViewsDeliverResponseSchema, ArchitecturalViewsGetContentRequestSchema, ArchitecturalViewsGetContentResponseSchema, ArchitecturalViewsListRequestSchema, ArchitecturalViewsListResponseSchema, ArchitecturalViewsDraftCreateRequestSchema, ArchitecturalViewsDraftCreateResponseSchema, ArchitecturalViewsDraftUpdateRequestSchema, ArchitecturalViewsDraftUpdateResponseSchema, ArchitecturalViewsDraftPublishRequestSchema, ArchitecturalViewsDraftPublishResponseSchema, ArchitecturalViewsDraftDiscardRequestSchema, ArchitecturalViewsDraftDiscardResponseSchema, ArchitecturalViewsDraftGetContentRequestSchema, ArchitecturalViewsDraftGetContentResponseSchema, ArchitecturalViewsOpenNotificationSchema, } from "./architectural-views/rpc-schemas.js";
-import { CLIENT_CAPS } from "./client-capabilities.js";
+import { ArchitecturalViewsDeliverRequestSchema, ArchitecturalViewsDeliverResponseSchema, ArchitecturalViewsGetContentRequestSchema, ArchitecturalViewsGetContentResponseSchema, ArchitecturalViewsListRequestSchema, ArchitecturalViewsListResponseSchema, ArchitecturalViewsDraftCreateRequestSchema, ArchitecturalViewsDraftCreateResponseSchema, ArchitecturalViewsDraftUpdateRequestSchema, ArchitecturalViewsDraftUpdateResponseSchema, ArchitecturalViewsDraftPublishRequestSchema, ArchitecturalViewsDraftPublishResponseSchema, ArchitecturalViewsDraftDiscardRequestSchema, ArchitecturalViewsDraftDiscardResponseSchema, ArchitecturalViewsDraftGetContentRequestSchema, ArchitecturalViewsDraftGetContentResponseSchema, ArchitecturalViewsDraftListRequestSchema, ArchitecturalViewsDraftListResponseSchema, ArchitecturalViewsOpenNotificationSchema, } from "./architectural-views/rpc-schemas.js";
 import { AGENT_LIFECYCLE_STATUSES } from "./agent-lifecycle.js";
 import { MAX_EXPLICIT_AGENT_TITLE_CHARS } from "./agent-title-limits.js";
 import { AgentProviderSchema } from "./provider-manifest.js";
@@ -37,7 +40,6 @@ import { ChatCreateRequestSchema, ChatListRequestSchema, ChatInspectRequestSchem
 import { ScheduleCreateRequestSchema, ScheduleListRequestSchema, ScheduleInspectRequestSchema, ScheduleLogsRequestSchema, SchedulePauseRequestSchema, ScheduleResumeRequestSchema, ScheduleDeleteRequestSchema, ScheduleRunOnceRequestSchema, ScheduleUpdateRequestSchema, ScheduleCreateResponseSchema, ScheduleListResponseSchema, ScheduleInspectResponseSchema, ScheduleLogsResponseSchema, SchedulePauseResponseSchema, ScheduleResumeResponseSchema, ScheduleDeleteResponseSchema, ScheduleRunOnceResponseSchema, ScheduleUpdateResponseSchema, } from "./schedule/rpc-schemas.js";
 import { LoopRunRequestSchema, LoopListRequestSchema, LoopInspectRequestSchema, LoopLogsRequestSchema, LoopStopRequestSchema, LoopRunResponseSchema, LoopListResponseSchema, LoopInspectResponseSchema, LoopLogsResponseSchema, LoopStopResponseSchema, } from "./loop/rpc-schemas.js";
 import { BrowserAutomationExecuteRequestSchema, BrowserAutomationExecuteResponseSchema, } from "./browser-automation/rpc-schemas.js";
-import { BrowserAutomationHostCapabilitySchema } from "./browser-automation/capabilities.js";
 import { OttoConfigRawSchema, OttoLifecycleCommandRawSchema, OttoMetadataGenerationEntrySchema, OttoMetadataGenerationSchema, OttoScriptEntryRawSchema, OttoWorktreeConfigRawSchema, OttoConfigRevisionSchema, ProjectConfigRpcErrorSchema, } from "./otto-config-schema.js";
 export * from "./git-hosting.js";
 export { OttoConfigRawSchema, OttoLifecycleCommandRawSchema, OttoMetadataGenerationEntrySchema, OttoMetadataGenerationSchema, OttoScriptEntryRawSchema, OttoWorktreeConfigRawSchema, };
@@ -157,51 +159,8 @@ const MutableBrowserToolsConfigPatchSchema = z
     .object({ enabled: z.boolean() })
     .partial()
     .passthrough();
-export const ModelTierSchema = z.enum(["deep", "standard", "fast"]);
-// A user's explicit tier tag for one model of one provider. The daemon stamps
-// `model.tier` at ingest, preferring a matching override here over inference
-// (see model-tiers.ts). Stored as an array (not a nested record) so a patch
-// replaces it wholesale - that's how a tag gets cleared, since deep-merge can't
-// delete a record key.
-export const ModelTierOverrideSchema = z
-    .object({
-    provider: z.string().min(1),
-    modelId: z.string().min(1),
-    tier: ModelTierSchema,
-})
-    .passthrough();
-// A host-owned model-picker visibility choice. Stored as an array so a patch
-// replaces it wholesale and removing the final hidden-model entry sticks.
-export const ModelVisibilityOverrideSchema = z
-    .object({
-    provider: z.string().min(1),
-    modelId: z.string().min(1),
-    visible: z.boolean(),
-})
-    .passthrough();
-// A remembered provider endpoint: a base URL together with the credential it
-// was saved with, so pointing a provider back at a previous endpoint is one
-// pick instead of re-typing the key. Entries are scoped by the connection
-// env-var pair they belong to (OPENAI_BASE_URL/OPENAI_API_KEY vs
-// ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN), which is exactly what the provider
-// settings sheet keys its dropdown off - so every openai-compatible provider
-// entry on the host shares one pool, and Claude-compatible entries share
-// another. Deliberately `z.string()` rather than an enum: a future env-var
-// family must not make old entries unparseable.
-export const SavedProviderEndpointSchema = z
-    .object({
-    /** Stable identity, `${baseUrlKey}::${baseUrl}` - dedupes on re-save. */
-    id: z.string().min(1),
-    baseUrlKey: z.string().min(1),
-    apiKeyKey: z.string().min(1),
-    baseUrl: z.string().min(1),
-    apiKey: z.string().default(""),
-    /** User-facing name; the UI falls back to the URL when absent. */
-    label: z.string().optional(),
-    /** Epoch ms of the last save, used to order the dropdown newest-first. */
-    savedAt: z.number().optional(),
-})
-    .passthrough();
+import { ModelTierOverrideSchema, ModelTierSchema, ModelVisibilityOverrideSchema, SavedProviderEndpointSchema, } from "./model-preferences.js";
+export { ModelTierSchema, ModelTierOverrideSchema, ModelVisibilityOverrideSchema, SavedProviderEndpointSchema, } from "./model-preferences.js";
 export const PluginIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/);
 export const DirectoryPluginSourceSchema = z
     .object({
@@ -479,22 +438,6 @@ const AgentProviderNoticeSchema = z.discriminatedUnion("type", [
     z.object({ type: z.literal("warning"), message: z.string() }),
     z.object({ type: z.literal("error"), message: z.string() }),
 ]);
-// Provider-reported plan rate-limit status (e.g. Claude claude.ai plan
-// windows), pushed on the agent stream when it changes. Presentation-only:
-// the app decides whether to show it (rateLimitWarningsEnabled setting).
-export const AgentRateLimitInfoSchema = z.object({
-    status: z.enum(["allowed", "warning", "rejected"]),
-    // Percentage of the limit window used, 0-100. Absent when the provider
-    // does not report it (Claude only includes it near the limit).
-    utilizationPercent: z.number().optional(),
-    // Provider-reported window identifier, e.g. "five_hour" | "seven_day".
-    // Open set - display code falls back to a generic label for unknown values.
-    limitType: z.string().optional(),
-    // ISO 8601 timestamp when the window resets.
-    resetsAt: z.string().optional(),
-    // True when usage is currently drawing from overage/extra usage credits.
-    isUsingOverage: z.boolean().optional(),
-});
 export const AgentFeatureToggleSchema = z.object({
     type: z.literal("toggle"),
     id: z.string(),
@@ -851,6 +794,10 @@ const ToolCallTimelineItemPayloadSchema = z.discriminatedUnion("status", [
     ToolCallFailedPayloadSchema,
     ToolCallCanceledPayloadSchema,
 ]);
+const AgentTimelineImageAttachmentSchema = z.object({
+    path: z.string(),
+    mimeType: z.string(),
+});
 // zod-aot 0.20.4 miscompiles this as a nested discriminated union by omitting
 // the inner tool_call branch from the generated outer dispatch.
 export const AgentTimelineItemPayloadSchema = z.union([
@@ -859,6 +806,7 @@ export const AgentTimelineItemPayloadSchema = z.union([
         text: z.string(),
         messageId: z.string().optional(),
         clientMessageId: z.string().optional(),
+        images: z.array(AgentTimelineImageAttachmentSchema).optional(),
     }),
     z.object({
         type: z.literal("assistant_message"),
@@ -2015,6 +1963,9 @@ export const FetchAgentTimelineRequestMessageSchema = z.object({
     projection: z.enum(["projected", "canonical"]).optional(),
     // Allow the client to merge this bounded page outside its contiguous loaded range.
     mergeWindow: z.boolean().optional(),
+    // The initial chat hydration can carry this compact full-history index without
+    // loading every transcript row into the client.
+    includePromptIndex: z.boolean().optional(),
 });
 export const AgentTimelineListPromptsRequestMessageSchema = z.object({
     type: z.literal("agent.timeline.list_prompts.request"),
@@ -3622,6 +3573,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ContextPromptPreviewGetRequestMessageSchema,
     ProjectKnowledgeListRequestMessageSchema,
     ProjectKnowledgeGetRequestMessageSchema,
+    ProjectKnowledgeRootGetRequestMessageSchema,
     ProjectKnowledgeCreateRequestMessageSchema,
     ProjectKnowledgeApplyRequestMessageSchema,
     ProjectKnowledgeStatusRequestMessageSchema,
@@ -3875,6 +3827,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ArchitecturalViewsDraftPublishRequestSchema,
     ArchitecturalViewsDraftDiscardRequestSchema,
     ArchitecturalViewsDraftGetContentRequestSchema,
+    ArchitecturalViewsDraftListRequestSchema,
 ]);
 // ============================================================================
 // Session Outbound Messages (Session emits these)
@@ -4203,6 +4156,13 @@ export const ServerInfoStatusPayloadSchema = z
         artifacts: z.boolean().optional(),
         // COMPAT(architecturalViews): added in v0.9.0, remove after 2027-02-28.
         architecturalViews: z.boolean().optional(),
+        // COMPAT(interactiveViewTypes): added in v0.9.0 on 2026-09-06; remove
+        // after 2027-03-06 once every supported host writes typed Interactive Views.
+        interactiveViewTypes: z.boolean().optional(),
+        // COMPAT(architecturalViewDraftDiscovery): added in v0.9.0, remove after 2027-03-05.
+        // A host with Architectural Views but without this gate cannot serve the
+        // draft-list RPC introduced for the Knowledge toolbar.
+        architecturalViewDraftDiscovery: z.boolean().optional(),
         // COMPAT(observedSubagents): added in v0.4.3, drop the gate when daemon floor >= v0.4.3.
         observedSubagents: z.boolean().optional(),
         // COMPAT(backgroundShellTasks): added in v0.5.3, drop the gate when daemon floor >= v0.5.3.
@@ -4213,6 +4173,7 @@ export const ServerInfoStatusPayloadSchema = z
         retainedTranscripts: z.boolean().optional(),
         // COMPAT(suggestedTasks): added in v0.5.6, drop the gate when daemon floor >= v0.5.6.
         suggestedTasks: z.boolean().optional(),
+        suggestedTaskModelSelection: z.boolean().optional(),
         // COMPAT(steerQueue): added in v0.6.8, drop the gate when daemon floor >= v0.6.8.
         // Daemon owns a per-agent queue of steering messages, accepts
         // `delivery: "queue"` on send, reports `queuedMessages` on the agent
@@ -4257,6 +4218,10 @@ export const ServerInfoStatusPayloadSchema = z
         personalityMemory: z.boolean().optional(),
         // COMPAT(projectKnowledge): added in v0.8.5, drop the gate when daemon floor >= v0.8.5.
         projectKnowledge: z.boolean().optional(),
+        // COMPAT(projectKnowledgeDeferredRootBodies): added in v0.9.1, remove
+        // after 2027-03-04. A new client asks the catalog for root summaries
+        // and fetches the selected root body separately.
+        projectKnowledgeDeferredRootBodies: z.boolean().optional(),
         // COMPAT(projectKnowledgeRefinement): added in v0.8.19, drop the gate
         // when floor >= v0.8.19.
         projectKnowledgeRefinement: z.boolean().optional(),
@@ -5602,6 +5567,14 @@ export const AgentTimelineEntryPayloadSchema = z.object({
     sourceSeqRanges: z.array(AgentTimelineSeqRangeSchema),
     collapsed: z.array(z.enum(["assistant_merge", "reasoning_merge", "tool_lifecycle"])),
 });
+export const AgentTimelinePromptIndexSchema = z.object({
+    epoch: z.string(),
+    prompts: z.array(z.object({
+        seq: z.number().int().nonnegative(),
+        timestamp: z.string(),
+        preview: z.string(),
+    })),
+});
 export const FetchAgentTimelineResponseMessageSchema = z.object({
     type: z.literal("fetch_agent_timeline_response"),
     payload: z.object({
@@ -5624,6 +5597,7 @@ export const FetchAgentTimelineResponseMessageSchema = z.object({
         hasOlder: z.boolean(),
         hasNewer: z.boolean(),
         mergeWindow: z.boolean().optional(),
+        promptIndex: AgentTimelinePromptIndexSchema.optional(),
         entries: z.array(AgentTimelineEntryPayloadSchema),
         error: z.string().nullable(),
     }),
@@ -5633,12 +5607,7 @@ export const AgentTimelineListPromptsResponseMessageSchema = z.object({
     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(),
-        })),
+        ...AgentTimelinePromptIndexSchema.shape,
         error: z.string().nullable(),
     }),
 });
@@ -7876,6 +7845,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ContextPromptPreviewGetResponseMessageSchema,
     ProjectKnowledgeListResponseMessageSchema,
     ProjectKnowledgeGetResponseMessageSchema,
+    ProjectKnowledgeRootGetResponseMessageSchema,
     ProjectKnowledgeCreateResponseMessageSchema,
     ProjectKnowledgeApplyResponseMessageSchema,
     ProjectKnowledgeStatusResponseMessageSchema,
@@ -7960,6 +7930,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ArchitecturalViewsDraftPublishResponseSchema,
     ArchitecturalViewsDraftDiscardResponseSchema,
     ArchitecturalViewsDraftGetContentResponseSchema,
+    ArchitecturalViewsDraftListResponseSchema,
     ArchitecturalViewsOpenNotificationSchema,
 ]);
 export * from "./kanban.js";
@@ -7967,38 +7938,6 @@ export * from "./kanban.js";
 // WebSocket Level Messages (wraps session messages)
 // ============================================================================
 // WebSocket-only messages (not session messages)
-export const WSPingMessageSchema = z.object({
-    type: z.literal("ping"),
-});
-export const WSPongMessageSchema = z.object({
-    type: z.literal("pong"),
-});
-export const WSHelloMessageSchema = z.object({
-    type: z.literal("hello"),
-    clientId: z.string().min(1),
-    clientType: z.enum(["mobile", "browser", "cli", "mcp"]),
-    protocolVersion: z.number().int(),
-    appVersion: z.string().optional(),
-    capabilities: z
-        .object({
-        voice: z.boolean().optional(),
-        pushNotifications: z.boolean().optional(),
-        [CLIENT_CAPS.reasoningMergeEnum]: z.boolean().optional(),
-        [CLIENT_CAPS.selectiveAgentTimeline]: z.boolean().optional(),
-        [CLIENT_CAPS.customModeIcons]: z.boolean().optional(),
-        [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()
-        .optional(),
-});
-export const WSRecordingStateMessageSchema = z.object({
-    type: z.literal("recording_state"),
-    isRecording: z.boolean(),
-});
 // Wrapped session message
 export const WSSessionInboundSchema = z.object({
     type: z.literal("session"),

package/dist/model-preferences.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { ModelTier } from "./agent-types.js";
+export declare const ModelTierSchema: z.ZodType<ModelTier>;
+export declare const ModelTierOverrideSchema: z.ZodObject<{
+    provider: z.ZodString;
+    modelId: z.ZodString;
+    tier: z.ZodType<ModelTier, unknown, z.core.$ZodTypeInternals<ModelTier, unknown>>;
+}, z.core.$loose>;
+export type ModelTierOverride = z.infer<typeof ModelTierOverrideSchema>;
+export declare const ModelVisibilityOverrideSchema: z.ZodObject<{
+    provider: z.ZodString;
+    modelId: z.ZodString;
+    visible: z.ZodBoolean;
+}, z.core.$loose>;
+export type ModelVisibilityOverride = z.infer<typeof ModelVisibilityOverrideSchema>;
+export declare const SavedProviderEndpointSchema: z.ZodObject<{
+    id: z.ZodString;
+    baseUrlKey: z.ZodString;
+    apiKeyKey: z.ZodString;
+    baseUrl: z.ZodString;
+    apiKey: z.ZodDefault<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    savedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type SavedProviderEndpoint = z.infer<typeof SavedProviderEndpointSchema>;
+//# sourceMappingURL=model-preferences.d.ts.map

package/dist/model-preferences.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export const ModelTierSchema = z.enum(["deep", "standard", "fast"]);
+// A user's explicit tier tag for one model of one provider. The daemon stamps
+// `model.tier` at ingest, preferring a matching override here over inference
+// (see model-tiers.ts). Stored as an array (not a nested record) so a patch
+// replaces it wholesale - that's how a tag gets cleared, since deep-merge can't
+// delete a record key.
+export const ModelTierOverrideSchema = z
+    .object({
+    provider: z.string().min(1),
+    modelId: z.string().min(1),
+    tier: ModelTierSchema,
+})
+    .passthrough();
+// A host-owned model-picker visibility choice. Stored as an array so a patch
+// replaces it wholesale and removing the final hidden-model entry sticks.
+export const ModelVisibilityOverrideSchema = z
+    .object({
+    provider: z.string().min(1),
+    modelId: z.string().min(1),
+    visible: z.boolean(),
+})
+    .passthrough();
+// A remembered provider endpoint: a base URL together with the credential it
+// was saved with, so pointing a provider back at a previous endpoint is one
+// pick instead of re-typing the key. Entries are scoped by the connection
+// env-var pair they belong to (OPENAI_BASE_URL/OPENAI_API_KEY vs
+// ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN), which is exactly what the provider
+// settings sheet keys its dropdown off - so every openai-compatible provider
+// entry on the host shares one pool, and Claude-compatible entries share
+// another. Deliberately `z.string()` rather than an enum: a future env-var
+// family must not make old entries unparseable.
+export const SavedProviderEndpointSchema = z
+    .object({
+    /** Stable identity, `${baseUrlKey}::${baseUrl}` - dedupes on re-save. */
+    id: z.string().min(1),
+    baseUrlKey: z.string().min(1),
+    apiKeyKey: z.string().min(1),
+    baseUrl: z.string().min(1),
+    apiKey: z.string().default(""),
+    /** User-facing name; the UI falls back to the URL when absent. */
+    label: z.string().optional(),
+    /** Epoch ms of the last save, used to order the dropdown newest-first. */
+    savedAt: z.number().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=model-preferences.js.map

package/dist/personality-schemas.d.ts

@@ -222,8 +222,8 @@ export declare const VisualizerVoiceCuesGenerateResponseSchema: z.ZodObject<{
 export type VisualizerVoiceCuesResult = z.infer<typeof VisualizerVoiceCuesGenerateResponseSchema>["payload"];
 export declare const ProfileMemoryListRequestMessageSchema: z.ZodObject<{
     workspaceId: z.ZodOptional<z.ZodString>;
-    projectRoot: z.ZodOptional<z.ZodString>;
     requestId: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
     personalityId: z.ZodString;
     type: z.ZodLiteral<"profile.memory.list.request">;
 }, z.core.$strip>;
@@ -254,9 +254,9 @@ export declare const ProfileMemoryListResponseMessageSchema: z.ZodObject<{
 export declare const ProfileMemoryUpdateRequestMessageSchema: z.ZodObject<{
     workspaceId: z.ZodOptional<z.ZodString>;
     text: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodString;
     scope: z.ZodOptional<z.ZodString>;
     projectRoot: z.ZodOptional<z.ZodString>;
-    requestId: z.ZodString;
     personalityId: z.ZodString;
     entryId: z.ZodOptional<z.ZodString>;
     drop: z.ZodOptional<z.ZodBoolean>;
@@ -311,11 +311,11 @@ export declare const AgentProfileStatsResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const AgentProfileGeneratePromptRequestSchema: z.ZodObject<{
     name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
     requestId: z.ZodString;
     roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     glowA: z.ZodOptional<z.ZodString>;
     glowB: z.ZodOptional<z.ZodString>;
-    cwd: z.ZodOptional<z.ZodString>;
     type: z.ZodLiteral<"agent.profile.generate_prompt.request">;
 }, z.core.$strip>;
 export declare const AgentProfileGeneratePromptResponseSchema: z.ZodObject<{
@@ -329,9 +329,9 @@ export declare const AgentProfileGeneratePromptResponseSchema: z.ZodObject<{
 export declare const AgentProfileGenerateVoiceCuesRequestSchema: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
     requestId: z.ZodString;
     roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    cwd: z.ZodOptional<z.ZodString>;
     moment: z.ZodOptional<z.ZodEnum<{
         join: "join";
         thinking: "thinking";

package/dist/project-knowledge.d.ts

@@ -44,9 +44,9 @@ export declare const ProjectDeliveryStatusSchema: z.ZodEnum<{
 }>;
 export declare const ProjectReferenceDispositionSchema: z.ZodEnum<{
     read: "read";
+    rejected: "rejected";
     unevaluated: "unevaluated";
     adopted: "adopted";
-    rejected: "rejected";
     dependency: "dependency";
 }>;
 export declare const ProjectProgressSchema: z.ZodObject<{
@@ -92,9 +92,9 @@ export declare const ProjectKnowledgeRecordSchema: z.ZodObject<{
     }, z.core.$strip>>;
     referenceDisposition: z.ZodOptional<z.ZodEnum<{
         read: "read";
+        rejected: "rejected";
         unevaluated: "unevaluated";
         adopted: "adopted";
-        rejected: "rejected";
         dependency: "dependency";
     }>>;
     sourceUrl: z.ZodOptional<z.ZodString>;
@@ -131,13 +131,14 @@ export declare const ProjectKnowledgeRootPageSchema: z.ZodObject<{
     title: z.ZodString;
     path: z.ZodString;
     absolutePath: z.ZodOptional<z.ZodString>;
-    body: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
     bodyDigest: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ProjectKnowledgeListRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"project.knowledge.list.request">;
     requestId: z.ZodString;
     workspaceId: z.ZodString;
+    includeRootBodies: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const ProjectKnowledgeListResponseMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"project.knowledge.list.response">;
@@ -181,9 +182,9 @@ export declare const ProjectKnowledgeListResponseMessageSchema: z.ZodObject<{
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -204,7 +205,7 @@ export declare const ProjectKnowledgeListResponseMessageSchema: z.ZodObject<{
             title: z.ZodString;
             path: z.ZodString;
             absolutePath: z.ZodOptional<z.ZodString>;
-            body: z.ZodString;
+            body: z.ZodOptional<z.ZodString>;
             bodyDigest: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         findings: z.ZodArray<z.ZodObject<{
@@ -276,9 +277,9 @@ export declare const ProjectKnowledgeGetResponseMessageSchema: z.ZodObject<{
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -296,6 +297,26 @@ export declare const ProjectKnowledgeGetResponseMessageSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const ProjectKnowledgeRootGetRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.root.get.request">;
+    requestId: z.ZodString;
+    workspaceId: z.ZodString;
+    slug: z.ZodString;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeRootGetResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.root.get.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        page: z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            title: z.ZodString;
+            path: z.ZodString;
+            absolutePath: z.ZodOptional<z.ZodString>;
+            body: z.ZodOptional<z.ZodString>;
+            bodyDigest: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const ProjectKnowledgeCreateRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"project.knowledge.create.request">;
     requestId: z.ZodString;
@@ -337,9 +358,9 @@ export declare const ProjectKnowledgeCreateRequestMessageSchema: z.ZodObject<{
     }, z.core.$strip>>;
     referenceDisposition: z.ZodOptional<z.ZodEnum<{
         read: "read";
+        rejected: "rejected";
         unevaluated: "unevaluated";
         adopted: "adopted";
-        rejected: "rejected";
         dependency: "dependency";
     }>>;
     sourceUrl: z.ZodOptional<z.ZodString>;
@@ -386,9 +407,9 @@ export declare const ProjectKnowledgeCreateResponseMessageSchema: z.ZodObject<{
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -462,9 +483,9 @@ export declare const ProjectKnowledgeApplyResponseMessageSchema: z.ZodObject<{
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -537,9 +558,9 @@ export declare const ProjectKnowledgeStatusResponseMessageSchema: z.ZodObject<{
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -622,9 +643,9 @@ export declare const ProjectKnowledgeProjectApplyResponseMessageSchema: z.ZodObj
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -650,9 +671,9 @@ export declare const ProjectKnowledgeReferenceApplyRequestMessageSchema: z.ZodOb
     id: z.ZodString;
     disposition: z.ZodOptional<z.ZodEnum<{
         read: "read";
+        rejected: "rejected";
         unevaluated: "unevaluated";
         adopted: "adopted";
-        rejected: "rejected";
         dependency: "dependency";
     }>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -701,9 +722,9 @@ export declare const ProjectKnowledgeReferenceApplyResponseMessageSchema: z.ZodO
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -738,7 +759,7 @@ export declare const ProjectKnowledgeRootApplyResponseMessageSchema: z.ZodObject
             title: z.ZodString;
             path: z.ZodString;
             absolutePath: z.ZodOptional<z.ZodString>;
-            body: z.ZodString;
+            body: z.ZodOptional<z.ZodString>;
             bodyDigest: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -806,9 +827,9 @@ export declare const ProjectKnowledgeRefineApplyResponseMessageSchema: z.ZodObje
             }, z.core.$strip>>;
             referenceDisposition: z.ZodOptional<z.ZodEnum<{
                 read: "read";
+                rejected: "rejected";
                 unevaluated: "unevaluated";
                 adopted: "adopted";
-                rejected: "rejected";
                 dependency: "dependency";
             }>>;
             sourceUrl: z.ZodOptional<z.ZodString>;
@@ -829,7 +850,7 @@ export declare const ProjectKnowledgeRefineApplyResponseMessageSchema: z.ZodObje
             title: z.ZodString;
             path: z.ZodString;
             absolutePath: z.ZodOptional<z.ZodString>;
-            body: z.ZodString;
+            body: z.ZodOptional<z.ZodString>;
             bodyDigest: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         demoted: z.ZodBoolean;
@@ -927,6 +948,7 @@ export declare const ProjectKnowledgeDeleteResponseMessageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ProjectKnowledgeListResponseMessage = z.infer<typeof ProjectKnowledgeListResponseMessageSchema>;
 export type ProjectKnowledgeGetResponseMessage = z.infer<typeof ProjectKnowledgeGetResponseMessageSchema>;
+export type ProjectKnowledgeRootGetResponseMessage = z.infer<typeof ProjectKnowledgeRootGetResponseMessageSchema>;
 export type ProjectKnowledgeCreateResponseMessage = z.infer<typeof ProjectKnowledgeCreateResponseMessageSchema>;
 export type ProjectKnowledgeApplyResponseMessage = z.infer<typeof ProjectKnowledgeApplyResponseMessageSchema>;
 export type ProjectKnowledgeRefinementProposeResponseMessage = z.infer<typeof ProjectKnowledgeRefinementProposeResponseMessageSchema>;

package/dist/project-knowledge.js

@@ -98,7 +98,10 @@ export const ProjectKnowledgeRootPageSchema = z.object({
     // COMPAT(projectKnowledgeStoreLocation): added in v0.8.18. See the same field
     // on ProjectKnowledgeRecordSchema.
     absolutePath: z.string().optional(),
-    body: z.string(),
+    // COMPAT(projectKnowledgeDeferredRootBodies): added in v0.9.1; legacy list
+    // responses keep sending this. New clients request root summaries and fetch
+    // the one selected document through project.knowledge.root.get.request.
+    body: z.string().optional(),
     /** Conditional-write precondition for a reviewed root-page refinement. */
     bodyDigest: z.string().optional(),
 });
@@ -106,6 +109,9 @@ export const ProjectKnowledgeListRequestMessageSchema = z.object({
     type: z.literal("project.knowledge.list.request"),
     requestId: z.string(),
     workspaceId: z.string(),
+    // A catalog normally needs root titles and paths, not six full Markdown
+    // documents. Optional so older clients keep receiving the original shape.
+    includeRootBodies: z.boolean().optional(),
 });
 export const ProjectKnowledgeListResponseMessageSchema = z.object({
     type: z.literal("project.knowledge.list.response"),
@@ -130,6 +136,16 @@ export const ProjectKnowledgeGetResponseMessageSchema = z.object({
     type: z.literal("project.knowledge.get.response"),
     payload: z.object({ requestId: z.string(), record: ProjectKnowledgeRecordSchema.nullable() }),
 });
+export const ProjectKnowledgeRootGetRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.root.get.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    slug: z.string(),
+});
+export const ProjectKnowledgeRootGetResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.root.get.response"),
+    payload: z.object({ requestId: z.string(), page: ProjectKnowledgeRootPageSchema.nullable() }),
+});
 export const ProjectKnowledgeCreateRequestMessageSchema = z.object({
     type: z.literal("project.knowledge.create.request"),
     requestId: z.string(),