@otto-code/protocol 0.8.6 → 0.8.8

package/dist/messages.js

@@ -462,6 +462,12 @@ export const MutableBrainConfigSchema = z
         .passthrough()
         .default({ host: "127.0.0.1", port: 1234 }),
     defaultModel: z.string().nullable().default(null),
+    runtime: z
+        .object({
+        source: z.enum(["auto", "managed", "lmstudio"]).default("auto"),
+        path: z.string().nullable().default(null),
+    })
+        .default({ source: "auto", path: null }),
     // Pin the host to one model: serve only the default/resident model and
     // refuse completion requests that ask for a different one.
     lockModel: z.boolean().default(false),
@@ -533,6 +539,9 @@ export const MutableBrainConfigPatchSchema = z
     remote: MutableBrainRemotePatchSchema,
     listen: MutableBrainListenPatchSchema,
     defaultModel: z.string().nullable(),
+    runtime: z
+        .object({ source: z.enum(["auto", "managed", "lmstudio"]), path: z.string().nullable() })
+        .partial(),
     lockModel: z.boolean(),
     allowRemoteConfig: z.boolean(),
     allowInsecureBind: z.boolean(),
@@ -549,6 +558,7 @@ export const DEFAULT_MUTABLE_BRAIN_CONFIG = {
     remote: { host: "", port: 1234, secure: false, authToken: null, certFingerprint: null },
     listen: { host: "127.0.0.1", port: 1234 },
     defaultModel: null,
+    runtime: { source: "auto", path: null },
     lockModel: false,
     allowRemoteConfig: false,
     allowInsecureBind: false,
@@ -1337,6 +1347,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 -
@@ -1444,12 +1457,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"),
@@ -1475,6 +1484,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({
@@ -1897,12 +1921,30 @@ export const BrainCatalogModelSchema = z
     tier: z.string().default(""),
     useCases: z.array(z.string()).default([]),
     why: z.string().default(""),
+    components: z
+        .array(z.object({
+        id: z.string(),
+        label: z.string().default(""),
+        description: z.string().default(""),
+        role: z.string().default(""),
+        hfRepo: z.string().optional(),
+        file: z.string().default(""),
+        bytes: z.number().nullable().optional(),
+        required: z.boolean().default(false),
+        defaultDownload: z.boolean().default(false),
+        defaultLoad: z.boolean().default(false),
+        minRuntimeBuild: z.number().optional(),
+    }))
+        .optional(),
 })
     .passthrough();
 // An installed llama.cpp runtime, from `otto-brain runtime list`.
 export const BrainRuntimeSchema = z
     .object({
     label: z.string().default(""),
+    // A human-readable runtime identity. The filesystem-safe `label` remains
+    // for older hosts and destructive operations, not for UI presentation.
+    displayName: z.string().default(""),
     version: z.string().default(""),
     source: z.string().default(""),
     dir: z.string().default(""),
@@ -1915,6 +1957,7 @@ export const BrainRuntimeSchema = z
 export const BrainJobKindSchema = z.enum([
     "pull",
     "runtime-install",
+    "runtime-remove",
     "calibrate",
     "sweep",
     "bench",
@@ -1993,6 +2036,9 @@ export const BrainModelsPullRequestSchema = z.object({
     type: z.literal("brain.models.pull.request"),
     // Catalog id or name fragment.
     model: z.string(),
+    quant: z.string().optional(),
+    // COMPAT(brainModelBundles): added in v0.8.7, drop the gate when floor >= v0.8.7.
+    components: z.array(z.string()).optional(),
     requestId: z.string(),
 });
 export const BrainModelsPullResponseSchema = z.object({
@@ -2010,6 +2056,15 @@ export const BrainRuntimeInstallResponseSchema = z.object({
     type: z.literal("brain.runtime.install.response"),
     payload: BrainJobResultSchema,
 });
+export const BrainRuntimeRemoveRequestSchema = z.object({
+    type: z.literal("brain.runtime.remove.request"),
+    name: z.string(),
+    requestId: z.string(),
+});
+export const BrainRuntimeRemoveResponseSchema = z.object({
+    type: z.literal("brain.runtime.remove.response"),
+    payload: BrainJobResultSchema,
+});
 // Measure real KV bytes/token for a model - starts a `calibrate` job. Needs a
 // runtime + GPU; refused with a helpful error otherwise.
 export const BrainCalibrateRequestSchema = z.object({
@@ -2074,6 +2129,8 @@ export const BrainHfSearchResultSchema = z
     downloads: z.number().default(0),
     likes: z.number().default(0),
     gated: z.boolean().default(false),
+    // A short, source-authored excerpt extracted from the repository's model card.
+    summary: z.string().nullable().optional(),
     // True when any quant of this repo is already on disk.
     installed: z.boolean().default(false),
 })
@@ -2085,8 +2142,23 @@ export const BrainRepoQuantSchema = z
     size: z.string().default(""),
     sizeBytes: z.number().default(0),
     files: z.number().default(0),
+    fileNames: z.array(z.string()).optional(),
     // True when this specific quant is already on disk.
     installed: z.boolean().default(false),
+    // The installed model's stable id, when this quant is already on disk.
+    // Optional so daemons predating quant deletion remain compatible.
+    modelId: z.string().nullable().optional(),
+    // The shared projector detected in this repository. It is repeated on
+    // each quant row because the quant picker is the unit that discovers and
+    // presents a downloadable Hugging Face bundle.
+    projector: z
+        .object({
+        file: z.string(),
+        sizeBytes: z.number(),
+        // COMPAT(brainDiscoveredProjectorState): added in v0.8.7, remove after 2027-02-11.
+        installed: z.boolean().optional(),
+    })
+        .optional(),
 })
     .passthrough();
 // Search Hugging Face for GGUF models - `otto-brain search <query>`.
@@ -2123,6 +2195,8 @@ export const BrainModelsAddRequestSchema = z.object({
     type: z.literal("brain.models.add.request"),
     repo: z.string(),
     quant: z.string(),
+    // COMPAT(brainDiscoveredBundleComponents): added in v0.8.7, remove after 2027-02-11.
+    components: z.array(z.string()).optional(),
     requestId: z.string(),
 });
 export const BrainModelsAddResponseSchema = z.object({
@@ -2153,6 +2227,7 @@ export const BrainProfileSchema = z
     flashAttention: z.boolean().default(true),
     gpuLayers: z.number().default(0),
     vision: z.boolean().default(false),
+    enabledComponents: z.array(z.string()).optional(),
     reasoningBudget: z.number().default(0),
     parallelSlots: z.number().default(1),
 })
@@ -2199,6 +2274,9 @@ export const BrainBudgetSchema = z
     .object({
     weightsBytes: z.number().default(0),
     mmprojBytes: z.number().default(0),
+    componentBytes: z.number().optional(),
+    drafterKvBytes: z.number().optional(),
+    imageProcessingBytes: z.number().optional(),
     kvBytes: z.number().default(0),
     overheadBytes: z.number().default(0),
     totalBytes: z.number().default(0),
@@ -2244,6 +2322,22 @@ export const BrainInventoryModelSchema = z
     blockCount: z.number().nullable().default(null),
     headCountKv: z.number().nullable().default(null),
     hasProjector: z.boolean().default(false),
+    components: z
+        .array(z.object({
+        id: z.string(),
+        label: z.string().default(""),
+        description: z.string().default(""),
+        role: z.string().default(""),
+        bytes: z.number().default(0),
+        available: z.boolean().default(false),
+        unavailableReason: z.string().optional(),
+        required: z.boolean().default(false),
+        defaultDownload: z.boolean().default(false),
+        defaultLoad: z.boolean().default(false),
+        minRuntimeBuild: z.number().optional(),
+    }))
+        .nullable()
+        .optional(),
     reasoning: z.boolean().default(false),
     mtp: z.boolean().default(false),
     distilled: z.boolean().default(false),
@@ -2389,6 +2483,21 @@ export const BrainModelDeleteResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const BrainModelComponentDeleteRequestSchema = z.object({
+    type: z.literal("brain.model.component.delete.request"),
+    modelId: z.string(),
+    componentId: z.string(),
+    requestId: z.string(),
+});
+export const BrainModelComponentDeleteResponseSchema = z.object({
+    type: z.literal("brain.model.component.delete.response"),
+    payload: z.object({
+        deleted: z.array(z.string()).default([]),
+        freedBytes: z.number().default(0),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 // Rename a model's display name. The brain rejects a collision with another
 // model's current id/displayName: /v1/models keys its id on displayName, and
 // both the completion path and defaultModel/switchTo resolve a model by
@@ -3807,6 +3916,7 @@ export const ProjectKnowledgeKindSchema = z.enum([
     "constraint",
     "requirement",
     "architecture",
+    "finding",
     "project",
     "reference",
 ]);
@@ -3859,10 +3969,13 @@ export const ProjectKnowledgeRecordSchema = z.object({
         .optional(),
     path: z.string().optional(),
 });
-export const ProjectKnowledgeFindingSchema = z.object({
+/** Review health, not a persisted project-knowledge finding record. */
+export const ProjectKnowledgeHealthSchema = z.object({
     kind: z.enum(["stale", "overlapping_tags", "overlapping_statement"]),
     recordId: z.string(),
     relatedRecordId: z.string().optional(),
+    tagOverlap: z.enum(["complete", "partial"]).optional(),
+    sharedTags: z.array(z.string()).optional(),
     message: z.string(),
 });
 export const ProjectKnowledgeRootPageSchema = z.object({
@@ -3882,7 +3995,7 @@ export const ProjectKnowledgeListResponseMessageSchema = z.object({
         requestId: z.string(),
         records: z.array(ProjectKnowledgeRecordSchema),
         rootPages: z.array(ProjectKnowledgeRootPageSchema).optional(),
-        findings: z.array(ProjectKnowledgeFindingSchema),
+        findings: z.array(ProjectKnowledgeHealthSchema),
         brief: z.string(),
         briefTokens: z.number(),
         includedIds: z.array(z.string()),
@@ -6159,6 +6272,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ArchiveAgentRequestMessageSchema,
     CloseItemsRequestMessageSchema,
     HistoryAgentsClearArchivedRequestSchema,
+    HistoryAgentsStorageStatsRequestSchema,
     AttachmentsImagesStatsRequestSchema,
     AttachmentsImagesClearRequestSchema,
     BrainHostStatusRequestSchema,
@@ -6175,6 +6289,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     BrainRuntimeListRequestSchema,
     BrainModelsPullRequestSchema,
     BrainRuntimeInstallRequestSchema,
+    BrainRuntimeRemoveRequestSchema,
     BrainCalibrateRequestSchema,
     BrainSweepRequestSchema,
     BrainBenchRequestSchema,
@@ -6190,6 +6305,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     BrainModelLoadRequestSchema,
     BrainModelUnloadRequestSchema,
     BrainModelDeleteRequestSchema,
+    BrainModelComponentDeleteRequestSchema,
     BrainModelRenameRequestSchema,
     BrainModelRenameResetRequestSchema,
     BrainLogsTailRequestSchema,
@@ -6987,6 +7103,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 +7445,9 @@ const WorkspaceGitRuntimePayloadSchema = z
     remoteUrl: z.string().nullable().optional(),
     isOttoOwnedWorktree: z.boolean().optional(),
     isDirty: z.boolean().nullable().optional(),
+    // COMPAT(workspaceGitBaseRef): added in v0.8.7, remove after 2027-02-10.
+    // The branch-history label is useful only when its comparison base is explicit.
+    baseRef: z.string().nullable().optional(),
     aheadBehind: z
         .object({
         ahead: z.number(),
@@ -7424,6 +7545,16 @@ export const WorkspaceDescriptorPayloadSchema = z
     })
         .nullable()
         .optional(),
+    // COMPAT(workspaceWorkingTreeDiffStat): added in v0.8.7, remove after 2027-02-10.
+    // `diffStat` is retained for older clients and means branch-versus-base.
+    // This field is only the working tree relative to HEAD, so it clears on commit.
+    workingTreeDiffStat: z
+        .object({
+        additions: z.number(),
+        deletions: z.number(),
+    })
+        .nullable()
+        .optional(),
     scripts: z.array(WorkspaceScriptPayloadSchema).default([]),
     gitRuntime: WorkspaceGitRuntimePayloadSchema,
     githubRuntime: WorkspaceGitHubRuntimePayloadSchema,
@@ -10774,6 +10905,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentPermissionResolvedMessageSchema,
     AgentDeletedMessageSchema,
     HistoryAgentsClearArchivedResponseSchema,
+    HistoryAgentsStorageStatsResponseSchema,
     AttachmentsImagesStatsResponseSchema,
     AttachmentsImagesClearResponseSchema,
     BrainHostStatusResponseSchema,
@@ -10790,6 +10922,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     BrainRuntimeListResponseSchema,
     BrainModelsPullResponseSchema,
     BrainRuntimeInstallResponseSchema,
+    BrainRuntimeRemoveResponseSchema,
     BrainCalibrateResponseSchema,
     BrainSweepResponseSchema,
     BrainBenchResponseSchema,
@@ -10805,6 +10938,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     BrainModelLoadResponseSchema,
     BrainModelUnloadResponseSchema,
     BrainModelDeleteResponseSchema,
+    BrainModelComponentDeleteResponseSchema,
     BrainModelRenameResponseSchema,
     BrainModelRenameResetResponseSchema,
     BrainLogsTailResponseSchema,