@otto-code/protocol 0.8.7 → 0.8.9

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,
@@ -751,6 +761,7 @@ const AgentSelectOptionSchema = z.object({
     id: z.string(),
     label: z.string(),
     description: z.string().optional(),
+    family: z.string().optional(),
     isDefault: z.boolean().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
@@ -803,6 +814,7 @@ const AgentModelDefinitionSchema = z.object({
     id: z.string(),
     label: z.string(),
     description: z.string().optional(),
+    family: z.string().optional(),
     isDefault: z.boolean().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
     contextWindowMaxTokens: z.number().optional(),
@@ -1898,6 +1910,7 @@ export const BrainCatalogModelSchema = z
     .object({
     id: z.string(),
     name: z.string().default(""),
+    family: z.string().nullable().optional(),
     installed: z.boolean().default(false),
     publisher: z.string().default(""),
     repo: z.string().default(""),
@@ -1911,12 +1924,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(""),
@@ -1929,6 +1960,7 @@ export const BrainRuntimeSchema = z
 export const BrainJobKindSchema = z.enum([
     "pull",
     "runtime-install",
+    "runtime-remove",
     "calibrate",
     "sweep",
     "bench",
@@ -2007,6 +2039,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({
@@ -2024,6 +2059,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({
@@ -2088,6 +2132,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),
 })
@@ -2099,8 +2145,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>`.
@@ -2137,6 +2198,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({
@@ -2167,8 +2230,27 @@ 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),
+    contextMultiplier: z.number().default(1),
+    calibrationRequired: z.boolean().default(true),
+    hostingProfileId: z.string().nullable().default(null),
+    /** Matches the brain's own default: a profile written before this field
+     * existed meant "use the family default", which is `inherit`. */
+    hostingProfileMode: z.enum(["inherit", "off", "custom"]).default("inherit"),
+})
+    .passthrough();
+/** A Brain-owned, named llama-server template composition. */
+export const BrainHostingProfileSchema = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    family: z.string(),
+    description: z.string().default(""),
+    template: z.string().nullable().default(null),
+    systemPromptAddendum: z.string().nullable().default(null),
+    templateKwargs: z.record(z.string(), z.unknown()).default({}),
 })
     .passthrough();
 /** One editable field, as the brain describes it, so the editor cannot drift. */
@@ -2213,6 +2295,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),
@@ -2248,6 +2333,7 @@ export const BrainInventoryModelSchema = z
     .object({
     id: z.string(),
     displayName: z.string().default(""),
+    family: z.string().nullable().optional(),
     publisher: z.string().nullable().default(null),
     quant: z.string().nullable().default(null),
     sizeBytes: z.number().default(0),
@@ -2258,6 +2344,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),
@@ -2306,6 +2408,10 @@ export const BrainModelProfileGetResponseSchema = z.object({
         fields: z.array(BrainProfileFieldSchema).default([]),
         warnings: z.array(BrainProfileWarningSchema).default([]),
         calibration: BrainCalibrationInfoSchema.nullable().default(null),
+        /** True when a previous resident-model edit still awaits a reload. */
+        requiresRestart: z.boolean().default(false),
+        hostingProfiles: z.array(BrainHostingProfileSchema).default([]),
+        familyHostingProfileId: z.string().nullable().default(null),
         error: z.string().nullable(),
         requestId: z.string(),
     }),
@@ -2323,6 +2429,7 @@ export const BrainModelProfileSetResponseSchema = z.object({
     type: z.literal("brain.model.profile.set.response"),
     payload: z.object({
         profile: BrainProfileSchema.nullable().default(null),
+        fields: z.array(BrainProfileFieldSchema).default([]),
         /** Human-readable notes about anything clamped or ignored. */
         adjustments: z.array(z.string()).default([]),
         warnings: z.array(BrainProfileWarningSchema).default([]),
@@ -2331,6 +2438,8 @@ export const BrainModelProfileSetResponseSchema = z.object({
         maxContextThatFits: z.number().nullable().default(null),
         /** True when the edited model is the resident one, so a restart applies it. */
         requiresRestart: z.boolean().default(false),
+        hostingProfiles: z.array(BrainHostingProfileSchema).default([]),
+        familyHostingProfileId: z.string().nullable().default(null),
         error: z.string().nullable(),
         requestId: z.string(),
     }),
@@ -2403,6 +2512,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
@@ -3821,6 +3945,7 @@ export const ProjectKnowledgeKindSchema = z.enum([
     "constraint",
     "requirement",
     "architecture",
+    "finding",
     "project",
     "reference",
 ]);
@@ -3873,10 +3998,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({
@@ -3896,7 +4024,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()),
@@ -5447,6 +5575,11 @@ const ParsedDiffFileSchema = z.object({
     additions: z.number(),
     deletions: z.number(),
     hunks: z.array(DiffHunkSchema),
+    // Optional so older daemons remain wire-compatible. Whole snapshots are
+    // size-bounded by the daemon and let Structural parse files, never isolated
+    // patch hunks.
+    beforeSource: z.string().optional(),
+    afterSource: z.string().optional(),
     status: z.enum(["ok", "too_large", "binary"]).optional(),
 });
 const FileExplorerEntrySchema = z.object({
@@ -6031,6 +6164,10 @@ export const CreateTerminalRequestSchema = z.object({
     agentId: z.string().optional(),
     command: z.string().optional(),
     args: z.array(z.string()).optional(),
+    /** An embedded terminal renders inside another pane and never gets its own workspace tab. */
+    presentation: z.enum(["embedded"]).optional(),
+    /** Stable owner identity used to adopt an embedded terminal after a renderer reload. */
+    presentationOwner: z.string().optional(),
     // Initial PTY size. Added in v0.1.107; the app no longer sends it (the estimate cache that fed
     // it was removed - the pane-focus resize claim sizes the PTY instead). Kept and honored
     // permanently: released v0.1.107 clients still send it, and programmatic callers may pass an
@@ -6133,6 +6270,10 @@ export const CaptureTerminalRequestSchema = z.object({
     stripAnsi: z.boolean().default(true),
     requestId: z.string(),
 });
+export const TerminalCompatibilityDiagnosticRequestSchema = z.object({
+    type: z.literal("terminal.compatibility.diagnostic.request"),
+    requestId: z.string(),
+});
 export const HubExecutionAgentCreateRequestSchema = z.object({
     type: z.literal("hub.execution.agent.create.request"),
     requestId: z.string(),
@@ -6190,6 +6331,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     BrainRuntimeListRequestSchema,
     BrainModelsPullRequestSchema,
     BrainRuntimeInstallRequestSchema,
+    BrainRuntimeRemoveRequestSchema,
     BrainCalibrateRequestSchema,
     BrainSweepRequestSchema,
     BrainBenchRequestSchema,
@@ -6205,6 +6347,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     BrainModelLoadRequestSchema,
     BrainModelUnloadRequestSchema,
     BrainModelDeleteRequestSchema,
+    BrainModelComponentDeleteRequestSchema,
     BrainModelRenameRequestSchema,
     BrainModelRenameResetRequestSchema,
     BrainLogsTailRequestSchema,
@@ -6432,6 +6575,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     TerminalInputSchema,
     KillTerminalRequestSchema,
     CaptureTerminalRequestSchema,
+    TerminalCompatibilityDiagnosticRequestSchema,
     ChatCreateRequestSchema,
     ChatListRequestSchema,
     ChatInspectRequestSchema,
@@ -6631,6 +6775,9 @@ 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(terminalCompatibilityDiagnostic): added in v0.8.9, remove gate after 2027-02-12.
+        terminalCompatibilityDiagnostic: z.boolean().optional(),
+        terminalEmbeddedPresentation: 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.
@@ -7344,6 +7491,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(),
@@ -7441,6 +7591,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,
@@ -10469,6 +10629,8 @@ const TerminalInfoSchema = z.object({
     workspaceId: z.string().optional(),
     title: z.string().optional(),
     activity: TerminalActivitySchema.nullable().optional(),
+    presentation: z.enum(["embedded"]).optional(),
+    presentationOwner: z.string().optional(),
 });
 export const TerminalCellSchema = z.object({
     char: z.string(),
@@ -10570,6 +10732,32 @@ export const CaptureTerminalResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const TerminalCompatibilityDiagnosticStatusSchema = z.enum([
+    "pass",
+    "fail",
+    "warn",
+    "unknown",
+]);
+export const TerminalCompatibilityDiagnosticCheckSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    status: TerminalCompatibilityDiagnosticStatusSchema,
+    detail: z.string(),
+    evidence: z.string().optional(),
+});
+export const TerminalCompatibilityDiagnosticResponseSchema = z.object({
+    type: z.literal("terminal.compatibility.diagnostic.response"),
+    payload: z.object({
+        requestId: z.string(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        generatedAt: z.string(),
+        platform: z.string().optional(),
+        term: z.string().nullable().optional(),
+        termProgram: z.string().nullable().optional(),
+        checks: z.array(TerminalCompatibilityDiagnosticCheckSchema),
+    }),
+});
 export const TerminalStreamExitSchema = z.object({
     type: z.literal("terminal_stream_exit"),
     payload: z.object({
@@ -10808,6 +10996,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     BrainRuntimeListResponseSchema,
     BrainModelsPullResponseSchema,
     BrainRuntimeInstallResponseSchema,
+    BrainRuntimeRemoveResponseSchema,
     BrainCalibrateResponseSchema,
     BrainSweepResponseSchema,
     BrainBenchResponseSchema,
@@ -10823,6 +11012,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     BrainModelLoadResponseSchema,
     BrainModelUnloadResponseSchema,
     BrainModelDeleteResponseSchema,
+    BrainModelComponentDeleteResponseSchema,
     BrainModelRenameResponseSchema,
     BrainModelRenameResetResponseSchema,
     BrainLogsTailResponseSchema,
@@ -10969,6 +11159,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     SubscribeTerminalResponseSchema,
     KillTerminalResponseSchema,
     CaptureTerminalResponseSchema,
+    TerminalCompatibilityDiagnosticResponseSchema,
     TerminalStreamExitSchema,
     TerminalAttentionRequiredSchema,
     ChatCreateResponseSchema,

package/dist/provider-config.d.ts

@@ -269,6 +269,7 @@ export declare const ProviderCompactionConfigSchema: z.ZodObject<{
     autoCompact: z.ZodOptional<z.ZodBoolean>;
     thresholdPercent: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<60>, z.ZodLiteral<70>, z.ZodLiteral<80>, z.ZodLiteral<90>]>>;
     keepRecentTokens: z.ZodOptional<z.ZodNumber>;
+    summaryMaxTokens: z.ZodOptional<z.ZodNumber>;
     hideSelector: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ProviderCompactionConfig = z.infer<typeof ProviderCompactionConfigSchema>;
@@ -340,6 +341,7 @@ export declare const ProviderOverrideSchema: z.ZodObject<{
         autoCompact: z.ZodOptional<z.ZodBoolean>;
         thresholdPercent: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<60>, z.ZodLiteral<70>, z.ZodLiteral<80>, z.ZodLiteral<90>]>>;
         keepRecentTokens: z.ZodOptional<z.ZodNumber>;
+        summaryMaxTokens: z.ZodOptional<z.ZodNumber>;
         hideSelector: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     maxToolRounds: z.ZodOptional<z.ZodNumber>;
@@ -414,6 +416,7 @@ export declare const ProviderOverridesSchema: z.ZodRecord<z.ZodString, z.ZodObje
         autoCompact: z.ZodOptional<z.ZodBoolean>;
         thresholdPercent: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<60>, z.ZodLiteral<70>, z.ZodLiteral<80>, z.ZodLiteral<90>]>>;
         keepRecentTokens: z.ZodOptional<z.ZodNumber>;
+        summaryMaxTokens: z.ZodOptional<z.ZodNumber>;
         hideSelector: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     maxToolRounds: z.ZodOptional<z.ZodNumber>;

package/dist/provider-config.js

@@ -235,6 +235,8 @@ export const ProviderCompactionConfigSchema = z.object({
         .optional(),
     /** Recent-conversation budget kept verbatim through compaction. Default 20000. */
     keepRecentTokens: z.number().int().positive().optional(),
+    /** Maximum tokens the compaction summary may generate. Omitted leaves the endpoint default. */
+    summaryMaxTokens: z.number().int().positive().optional(),
     /**
      * true hides the per-agent "Auto-compact" feature select in chats; agents
      * always run with the provider-level default above (persisted per-agent