@otto-code/protocol 0.8.5 → 0.8.6

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
@@ -1561,6 +1575,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 +2725,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 +3729,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 +3799,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 +6033,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,6 +6153,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     FetchRecentProviderSessionsRequestMessageSchema,
     FetchWorkspacesRequestMessageSchema,
     ProjectListRequestMessageSchema,
+    ProjectResolveWorkspaceForPathRequestSchema,
     FetchAgentRequestMessageSchema,
     DeleteAgentRequestMessageSchema,
     ArchiveAgentRequestMessageSchema,
@@ -5992,6 +6242,15 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     StatsActivityGetRequestMessageSchema,
     ContextReportGetRequestMessageSchema,
     ContextPromptPreviewGetRequestMessageSchema,
+    ProjectKnowledgeListRequestMessageSchema,
+    ProjectKnowledgeGetRequestMessageSchema,
+    ProjectKnowledgeCreateRequestMessageSchema,
+    ProjectKnowledgeApplyRequestMessageSchema,
+    ProjectKnowledgeStatusRequestMessageSchema,
+    ProjectKnowledgeProjectApplyRequestMessageSchema,
+    ProjectKnowledgeReferenceApplyRequestMessageSchema,
+    ProjectKnowledgeRootApplyRequestMessageSchema,
+    ProjectKnowledgeDeleteRequestMessageSchema,
     ContextEdgeConvertRequestMessageSchema,
     ContextFindingsFixRequestMessageSchema,
     PersonalityMemoryListRequestMessageSchema,
@@ -6327,6 +6586,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 +6616,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 +6763,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
@@ -7327,6 +7599,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 +10675,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     WorkspaceUpdateMessageSchema,
     ProjectUpdateMessageSchema,
     ProjectListResponseMessageSchema,
+    ProjectResolveWorkspaceForPathResponseSchema,
     ScriptStatusUpdateMessageSchema,
     WorkspaceSetupProgressMessageSchema,
     WorkspaceSetupStatusResponseMessageSchema,
@@ -10644,6 +10924,15 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     StatsActivityGetResponseMessageSchema,
     ContextReportGetResponseMessageSchema,
     ContextPromptPreviewGetResponseMessageSchema,
+    ProjectKnowledgeListResponseMessageSchema,
+    ProjectKnowledgeGetResponseMessageSchema,
+    ProjectKnowledgeCreateResponseMessageSchema,
+    ProjectKnowledgeApplyResponseMessageSchema,
+    ProjectKnowledgeStatusResponseMessageSchema,
+    ProjectKnowledgeProjectApplyResponseMessageSchema,
+    ProjectKnowledgeReferenceApplyResponseMessageSchema,
+    ProjectKnowledgeRootApplyResponseMessageSchema,
+    ProjectKnowledgeDeleteResponseMessageSchema,
     ContextEdgeConvertResponseMessageSchema,
     ContextFindingsFixResponseMessageSchema,
     PersonalityMemoryListResponseMessageSchema,