@otto-code/protocol 0.8.5 → 0.8.7

package/dist/messages.js

@@ -608,6 +608,15 @@ export const MutableDaemonConfigSchema = z
     attachmentImageMaxAgeDays: z.number().int().min(0).default(30),
     attachmentImageMaxTotalMb: z.number().int().min(0).default(512),
     enableTerminalAgentHooks: z.boolean().default(false),
+    // Gated by server_info.features.terminalTitleSettings. The daemon owns
+    // title policy because terminals can be created from any connected client.
+    terminalTitleMode: z.enum(["auto", "default"]).optional(),
+    terminalTitleIncludePaths: z.boolean().optional(),
+    // Windows-only preference for ordinary interactive terminals. Absent keeps
+    // the operating system's normal default shell on every platform.
+    defaultTerminalShell: z
+        .enum(["command-prompt", "windows-powershell", "powershell-7"])
+        .optional(),
     appendSystemPrompt: z.string().default(""),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
     // Absent on daemons without the speechSettings feature.
@@ -681,6 +690,11 @@ export const MutableDaemonConfigPatchSchema = z
     attachmentImageMaxAgeDays: z.number().int().min(0).optional(),
     attachmentImageMaxTotalMb: z.number().int().min(0).optional(),
     enableTerminalAgentHooks: z.boolean().optional(),
+    terminalTitleMode: z.enum(["auto", "default"]).optional(),
+    terminalTitleIncludePaths: z.boolean().optional(),
+    defaultTerminalShell: z
+        .enum(["command-prompt", "windows-powershell", "powershell-7"])
+        .optional(),
     appendSystemPrompt: z.string().optional(),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
     // Gated by server_info features.speechSettings; every field is optional so
@@ -1323,6 +1337,9 @@ export const AgentSnapshotPayloadSchema = z.object({
     attentionReason: z.enum(["finished", "error", "permission"]).nullable().optional(),
     attentionTimestamp: z.string().nullable().optional(),
     archivedAt: z.string().nullable().optional(),
+    // Bytes in Otto's record captured at archive time. This is a projection,
+    // never a transcript rescan during rendering.
+    archiveBytes: z.number().int().nonnegative().optional(),
     providerUnavailable: z.boolean().optional(),
     // Attendability. "observed" marks a provider-managed subagent (Claude Task /
     // ultracode fan-out) that the user can watch but not prompt or reconfigure -
@@ -1430,12 +1447,8 @@ export const CloseItemsRequestMessageSchema = z.object({
 // to be server-side because the history list is cursor-paginated across hosts,
 // so the client never holds the whole archived set.
 //
-// Deleting a chat removes OTTO's record only. The provider's own on-disk
-// transcript (Claude's `~/.claude/projects/**/<sessionId>.jsonl`, Codex threads,
-// OpenCode sessions) is deliberately left in place: Otto never created it,
-// another tool still reads it, and silently deleting another tool's state is not
-// ours to do. There is intentionally **no** opt-in flag for provider data on the
-// wire - the UI discloses what stays behind instead. See docs/chat-lifecycle.md.
+// Deleting a chat removes Otto's record only. Provider-owned session data is
+// deliberately left in place. See docs/chat-lifecycle.md.
 // Gated by server_info.features.historyDelete.
 export const HistoryAgentsClearArchivedRequestSchema = z.object({
     type: z.literal("history.agents.clear_archived.request"),
@@ -1461,6 +1474,21 @@ export const HistoryAgentsClearArchivedResponseSchema = z.object({
         dryRun: z.boolean(),
         error: z.string().nullable(),
         requestId: z.string(),
+        ottoBytes: z.number().int().nonnegative().optional(),
+        reclaimedBytes: z.number().int().nonnegative().optional(),
+    }),
+});
+export const HistoryAgentsStorageStatsRequestSchema = z.object({
+    type: z.literal("history.agents.get_storage_stats.request"),
+    requestId: z.string(),
+});
+export const HistoryAgentsStorageStatsResponseSchema = z.object({
+    type: z.literal("history.agents.get_storage_stats.response"),
+    payload: z.object({
+        archivedCount: z.number().int().nonnegative(),
+        totalBytes: z.number().nonnegative(),
+        error: z.string().nullable(),
+        requestId: z.string(),
     }),
 });
 export const UpdateAgentRequestMessageSchema = z.object({
@@ -1561,6 +1589,10 @@ export const BrainCapabilitiesSchema = z
     liveInference: z.boolean().default(false),
     /** Whether writes are permitted right now (the brain's allowRemoteConfig). */
     writable: z.boolean().default(false),
+    /** The remote brain owns benchmark jobs and can list/cancel them. */
+    jobs: z.boolean().default(false),
+    /** The brain can ask its owning daemon to restart it. */
+    restart: z.boolean().default(false),
 })
     .passthrough();
 // The brain's host status, as the daemon derives it: liveness plus the fields
@@ -2707,6 +2739,11 @@ export const ProjectListRequestMessageSchema = z.object({
     type: z.literal("project.list.request"),
     requestId: z.string(),
 });
+export const ProjectResolveWorkspaceForPathRequestSchema = z.object({
+    type: z.literal("project.resolveWorkspaceForPath.request"),
+    requestId: z.string(),
+    path: z.string(),
+});
 export const FetchAgentHistoryRequestMessageSchema = z.object({
     type: z.literal("fetch_agent_history_request"),
     requestId: z.string(),
@@ -3706,6 +3743,9 @@ export const ContextReportSchema = z.object({
     // is a z.enum travelling daemon->client, so a new member would make a new
     // daemon's report unparseable by an older client.
     personalityMemoryTokens: z.number().optional(),
+    // COMPAT(projectKnowledge): additive; repo-owned knowledge is folded into
+    // otto_injected, while this field keeps its recurring cost inspectable.
+    projectKnowledgeTokens: z.number().optional(),
 });
 // Pushed with the full current report whenever a watched context file changes.
 // Full-report reconciliation, same idiom as suggested_tasks_changed.
@@ -3773,6 +3813,226 @@ export const ContextPromptPreviewGetResponseMessageSchema = z.object({
         preview: ContextPromptPreviewSchema.nullable(),
     }),
 });
+// Repo-owned project knowledge is canonical Markdown under `.otto/knowledge`,
+// with daemon-owned writes so worktrees resolve to one store and every truth
+// change retains its timeline evidence.
+export const ProjectKnowledgeKindSchema = z.enum([
+    "decision",
+    "constraint",
+    "requirement",
+    "architecture",
+    "project",
+    "reference",
+]);
+export const ProjectKnowledgeStatusSchema = z.enum(["proposed", "confirmed", "superseded"]);
+export const ProjectDeliveryStatusSchema = z.enum([
+    "charter",
+    "in_build",
+    "partial",
+    "blocked",
+    "complete",
+    "reference",
+    "deferred",
+    "cancelled",
+]);
+export const ProjectReferenceDispositionSchema = z.enum([
+    "unevaluated",
+    "read",
+    "adopted",
+    "rejected",
+    "dependency",
+]);
+export const ProjectProgressSchema = z.object({
+    completed: z.number().int().nonnegative(),
+    total: z.number().int().positive(),
+    unit: z.string().min(1).max(48),
+});
+export const ProjectKnowledgeRecordSchema = z.object({
+    id: z.string(),
+    kind: ProjectKnowledgeKindSchema,
+    title: z.string(),
+    statement: z.string(),
+    statementDigest: z.string().optional(),
+    evidence: z.string().optional(),
+    tags: z.array(z.string()),
+    status: ProjectKnowledgeStatusSchema,
+    deliveryStatus: ProjectDeliveryStatusSchema.optional(),
+    progress: ProjectProgressSchema.optional(),
+    referenceDisposition: ProjectReferenceDispositionSchema.optional(),
+    sourceUrl: z.string().optional(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    provenance: z
+        .array(z.object({
+        text: z.string(),
+        recordedAt: z.string(),
+        source: z.string().optional(),
+        kind: z.string().optional(),
+        affects: z.array(z.string()).optional(),
+    }))
+        .optional(),
+    path: z.string().optional(),
+});
+export const ProjectKnowledgeFindingSchema = z.object({
+    kind: z.enum(["stale", "overlapping_tags", "overlapping_statement"]),
+    recordId: z.string(),
+    relatedRecordId: z.string().optional(),
+    message: z.string(),
+});
+export const ProjectKnowledgeRootPageSchema = z.object({
+    slug: z.string(),
+    title: z.string(),
+    path: z.string(),
+    body: z.string(),
+});
+export const ProjectKnowledgeListRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.list.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+});
+export const ProjectKnowledgeListResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.list.response"),
+    payload: z.object({
+        requestId: z.string(),
+        records: z.array(ProjectKnowledgeRecordSchema),
+        rootPages: z.array(ProjectKnowledgeRootPageSchema).optional(),
+        findings: z.array(ProjectKnowledgeFindingSchema),
+        brief: z.string(),
+        briefTokens: z.number(),
+        includedIds: z.array(z.string()),
+        omittedCount: z.number(),
+    }),
+});
+export const ProjectKnowledgeGetRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.get.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+});
+export const ProjectKnowledgeGetResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.get.response"),
+    payload: z.object({ requestId: z.string(), record: ProjectKnowledgeRecordSchema.nullable() }),
+});
+export const ProjectKnowledgeCreateRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.create.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string().optional(),
+    kind: ProjectKnowledgeKindSchema,
+    title: z.string().max(160),
+    statement: z.string(),
+    evidence: z.string().optional(),
+    tags: z.array(z.string().max(48)).max(32).optional(),
+    affects: z.array(z.string()).optional(),
+    status: ProjectKnowledgeStatusSchema.optional(),
+    deliveryStatus: ProjectDeliveryStatusSchema.optional(),
+    progress: ProjectProgressSchema.optional(),
+    referenceDisposition: ProjectReferenceDispositionSchema.optional(),
+    sourceUrl: z.string().optional(),
+});
+export const ProjectKnowledgeCreateResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.create.response"),
+    payload: z.object({ requestId: z.string(), record: ProjectKnowledgeRecordSchema }),
+});
+export const ProjectKnowledgeApplyRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.apply.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+    title: z.string().max(160).optional(),
+    statement: z.string().optional(),
+    evidence: z.string().optional(),
+    provenanceText: z.string().optional(),
+    provenanceSource: z.string().max(160).optional(),
+    provenanceAffects: z.array(z.string()).optional(),
+    expectedUpdatedAt: z.string().optional(),
+});
+export const ProjectKnowledgeApplyResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.apply.response"),
+    payload: z.object({
+        requestId: z.string(),
+        record: ProjectKnowledgeRecordSchema.nullable(),
+        error: z.string().optional(),
+    }),
+});
+export const ProjectKnowledgeStatusRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.status.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+    status: ProjectKnowledgeStatusSchema,
+    reason: z.string().optional(),
+});
+export const ProjectKnowledgeStatusResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.status.response"),
+    payload: z.object({ requestId: z.string(), record: ProjectKnowledgeRecordSchema.nullable() }),
+});
+export const ProjectKnowledgeProjectApplyRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.project.apply.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+    deliveryStatus: ProjectDeliveryStatusSchema.optional(),
+    progress: ProjectProgressSchema.nullable().optional(),
+    reason: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+});
+export const ProjectKnowledgeProjectApplyResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.project.apply.response"),
+    payload: z.object({
+        requestId: z.string(),
+        record: ProjectKnowledgeRecordSchema.nullable(),
+        error: z.string().optional(),
+    }),
+});
+export const ProjectKnowledgeReferenceApplyRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.reference.apply.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+    disposition: ProjectReferenceDispositionSchema.optional(),
+    sourceUrl: z.string().nullable().optional(),
+    reason: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+});
+export const ProjectKnowledgeReferenceApplyResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.reference.apply.response"),
+    payload: z.object({
+        requestId: z.string(),
+        record: ProjectKnowledgeRecordSchema.nullable(),
+        error: z.string().optional(),
+    }),
+});
+export const ProjectKnowledgeRootApplyRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.root.apply.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    slug: z.string(),
+    body: z.string(),
+});
+export const ProjectKnowledgeRootApplyResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.root.apply.response"),
+    payload: z.object({
+        requestId: z.string(),
+        page: ProjectKnowledgeRootPageSchema.nullable(),
+    }),
+});
+export const ProjectKnowledgeDeleteRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.delete.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    id: z.string(),
+    reason: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+});
+export const ProjectKnowledgeDeleteResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.delete.response"),
+    payload: z.object({
+        requestId: z.string(),
+        deleted: z.boolean(),
+        error: z.string().optional(),
+    }),
+});
 // Converts one edge between "always loaded" and "link only". Server-side
 // because the parent file may live outside the workspace root.
 export const ContextEdgeConvertRequestMessageSchema = z.object({
@@ -5787,6 +6047,9 @@ export const RenameTerminalRequestSchema = z.object({
     type: z.literal("terminal.rename.request"),
     terminalId: z.string(),
     title: z.string(),
+    // COMPAT(terminalTitleSettings): old daemons ignore this field and retain
+    // their existing rename behavior.
+    clear: z.boolean().optional(),
     requestId: z.string(),
 });
 export const StartWorkspaceScriptRequestSchema = z.object({
@@ -5904,11 +6167,13 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     FetchRecentProviderSessionsRequestMessageSchema,
     FetchWorkspacesRequestMessageSchema,
     ProjectListRequestMessageSchema,
+    ProjectResolveWorkspaceForPathRequestSchema,
     FetchAgentRequestMessageSchema,
     DeleteAgentRequestMessageSchema,
     ArchiveAgentRequestMessageSchema,
     CloseItemsRequestMessageSchema,
     HistoryAgentsClearArchivedRequestSchema,
+    HistoryAgentsStorageStatsRequestSchema,
     AttachmentsImagesStatsRequestSchema,
     AttachmentsImagesClearRequestSchema,
     BrainHostStatusRequestSchema,
@@ -5992,6 +6257,15 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     StatsActivityGetRequestMessageSchema,
     ContextReportGetRequestMessageSchema,
     ContextPromptPreviewGetRequestMessageSchema,
+    ProjectKnowledgeListRequestMessageSchema,
+    ProjectKnowledgeGetRequestMessageSchema,
+    ProjectKnowledgeCreateRequestMessageSchema,
+    ProjectKnowledgeApplyRequestMessageSchema,
+    ProjectKnowledgeStatusRequestMessageSchema,
+    ProjectKnowledgeProjectApplyRequestMessageSchema,
+    ProjectKnowledgeReferenceApplyRequestMessageSchema,
+    ProjectKnowledgeRootApplyRequestMessageSchema,
+    ProjectKnowledgeDeleteRequestMessageSchema,
     ContextEdgeConvertRequestMessageSchema,
     ContextFindingsFixRequestMessageSchema,
     PersonalityMemoryListRequestMessageSchema,
@@ -6327,6 +6601,15 @@ export const ServerInfoStatusPayloadSchema = z
     serverId: z.string().trim().min(1),
     hostname: ServerInfoHostnameSchema.optional(),
     version: ServerInfoVersionSchema.optional(),
+    // The daemon's OS and detected interactive shells. Optional so older hosts
+    // remain parseable; only Windows hosts advertise terminalShells.
+    platform: z.string().optional(),
+    terminalShells: z
+        .array(z.object({
+        id: z.enum(["command-prompt", "windows-powershell", "powershell-7"]),
+        label: z.string(),
+    }))
+        .optional(),
     // COMPAT(desktopManaged): added in v0.1.X, remove optional parsing after 2027-01-16.
     desktopManaged: z.boolean().optional(),
     capabilities: ServerCapabilitiesFromUnknownSchema.optional(),
@@ -6348,6 +6631,8 @@ export const ServerInfoStatusPayloadSchema = z
         daemonStatusRpc: z.boolean().optional(),
         // COMPAT(terminalRestoreModes): added in v0.1.81, remove gate after 2026-11-23.
         "terminal-restore-modes": z.boolean().optional(),
+        // COMPAT(terminalTitleSettings): added in v0.8.5, remove gate after 2027-02-07.
+        terminalTitleSettings: z.boolean().optional(),
         // COMPAT(rewind): added in v0.1.X, drop the gate when floor >= v0.1.X.
         rewind: z.boolean().optional(),
         // COMPAT(checkoutRefresh): added in v0.1.86, remove gate after 2026-11-29.
@@ -6493,6 +6778,8 @@ export const ServerInfoStatusPayloadSchema = z
         // client-side fallback could read.
         // COMPAT(personalityMemory): added in v0.7.0, drop the gate when daemon floor >= v0.7.0.
         personalityMemory: z.boolean().optional(),
+        // COMPAT(projectKnowledge): added in v0.8.5, drop the gate when daemon floor >= v0.8.5.
+        projectKnowledge: z.boolean().optional(),
         // Script discovery - the daemon scans a workspace for the Scripts its
         // project files already declare (package.json scripts, and later
         // Makefile targets, .NET launch profiles) and serves them from
@@ -6715,6 +7002,8 @@ export const ServerInfoStatusPayloadSchema = z
         // the daemon half of the Storage section; the app-side preview cache row
         // is local and always shown.
         attachmentStorage: z.boolean().optional(),
+        // COMPAT(historyStorage): added in v0.7.2, drop the gate when daemon floor >= v0.7.2.
+        historyStorage: z.boolean().optional(),
         // COMPAT(agentWorkspaceTransfer): added in v0.7.4, drop the gate when
         // daemon floor >= v0.7.4. Set when the daemon serves
         // `agent.workspace.transfer` - moving a chat to another workspace over
@@ -7327,6 +7616,13 @@ export const ProjectListResponseMessageSchema = z.object({
         projects: z.array(WorkspaceProjectDescriptorPayloadSchema),
     }),
 });
+export const ProjectResolveWorkspaceForPathResponseSchema = z.object({
+    type: z.literal("project.resolveWorkspaceForPath.response"),
+    payload: z.object({
+        requestId: z.string(),
+        workspaceId: z.string().nullable(),
+    }),
+});
 export const ScriptStatusUpdateMessageSchema = z.object({
     type: z.literal("script_status_update"),
     payload: z.object({
@@ -10396,6 +10692,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     WorkspaceUpdateMessageSchema,
     ProjectUpdateMessageSchema,
     ProjectListResponseMessageSchema,
+    ProjectResolveWorkspaceForPathResponseSchema,
     ScriptStatusUpdateMessageSchema,
     WorkspaceSetupProgressMessageSchema,
     WorkspaceSetupStatusResponseMessageSchema,
@@ -10494,6 +10791,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentPermissionResolvedMessageSchema,
     AgentDeletedMessageSchema,
     HistoryAgentsClearArchivedResponseSchema,
+    HistoryAgentsStorageStatsResponseSchema,
     AttachmentsImagesStatsResponseSchema,
     AttachmentsImagesClearResponseSchema,
     BrainHostStatusResponseSchema,
@@ -10644,6 +10942,15 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     StatsActivityGetResponseMessageSchema,
     ContextReportGetResponseMessageSchema,
     ContextPromptPreviewGetResponseMessageSchema,
+    ProjectKnowledgeListResponseMessageSchema,
+    ProjectKnowledgeGetResponseMessageSchema,
+    ProjectKnowledgeCreateResponseMessageSchema,
+    ProjectKnowledgeApplyResponseMessageSchema,
+    ProjectKnowledgeStatusResponseMessageSchema,
+    ProjectKnowledgeProjectApplyResponseMessageSchema,
+    ProjectKnowledgeReferenceApplyResponseMessageSchema,
+    ProjectKnowledgeRootApplyResponseMessageSchema,
+    ProjectKnowledgeDeleteResponseMessageSchema,
     ContextEdgeConvertResponseMessageSchema,
     ContextFindingsFixResponseMessageSchema,
     PersonalityMemoryListResponseMessageSchema,