@otto-code/protocol 0.8.12 → 0.8.13

package/dist/agent-labels.d.ts

@@ -1,4 +1,6 @@
 export declare const PARENT_AGENT_ID_LABEL = "otto.parent-agent-id";
+export declare function getOpenAgentTabLabel(clientId: string): string;
+export declare function isOpenAgentTabLabel(label: string): boolean;
 export interface AgentLabelSource {
     labels?: Record<string, unknown> | null;
 }
@@ -30,4 +32,5 @@ export interface OrchestrationQueryToolLabel {
     path?: string;
 }
 export declare function getQueryToolsFromLabels(labels: Record<string, unknown> | null | undefined): OrchestrationQueryToolLabel[] | null;
+export declare function hasOpenAgentTab(labels: Record<string, unknown> | null | undefined): boolean;
 //# sourceMappingURL=agent-labels.d.ts.map

package/dist/agent-labels.js

@@ -1,4 +1,11 @@
 export const PARENT_AGENT_ID_LABEL = "otto.parent-agent-id";
+const OPEN_AGENT_TAB_LABEL_PREFIX = "otto.open-agent-tab.";
+export function getOpenAgentTabLabel(clientId) {
+    return `${OPEN_AGENT_TAB_LABEL_PREFIX}${clientId}`;
+}
+export function isOpenAgentTabLabel(label) {
+    return label.startsWith(OPEN_AGENT_TAB_LABEL_PREFIX);
+}
 export function getParentAgentIdFromLabels(labels) {
     const parentAgentId = labels?.[PARENT_AGENT_ID_LABEL];
     return typeof parentAgentId === "string" && parentAgentId.trim().length > 0
@@ -90,4 +97,7 @@ function parseJsonArrayLabel(labels, key, isValid) {
     });
     return entries.length > 0 ? entries : null;
 }
+export function hasOpenAgentTab(labels) {
+    return Object.entries(labels ?? {}).some(([label, value]) => isOpenAgentTabLabel(label) && value === "true");
+}
 //# sourceMappingURL=agent-labels.js.map

package/dist/agent-personalities.d.ts

@@ -3,8 +3,8 @@ export declare function isPersonalityRole(value: string): value is PersonalityRo
 /**
  * Filter an arbitrary role array (roles ride the wire as plain strings) down to
  * the known set, deduped and returned in canonical `PERSONALITY_ROLES` order.
- * Retired role names are mapped through `LEGACY_ROLE_ALIASES`; anything else
- * unknown (e.g. a role from a newer peer) is dropped rather than trusted.
+ * Unknown roles (for example, a role from a newer peer) are dropped rather
+ * than trusted.
  */
 export declare function normalizePersonalityRoles(roles: readonly string[] | undefined): PersonalityRole[];
 export declare function personalityHasRole(personality: Pick<AgentPersonality, "roles">, role: PersonalityRole): boolean;
@@ -34,11 +34,12 @@ export interface PersonalitySelectionSummary {
  * deciding agent can pick the right teammate from the list alone.
  */
 export declare function summarizePersonalityForSelection(personality: Pick<AgentPersonality, "roles">): PersonalitySelectionSummary;
+export declare const OTTO_WORK_VOCABULARY_DIRECTIVE = "Otto work vocabulary: a suggested task is deferred work for the user and does not start work; a chat is an active Otto chat session; a child chat is created by another chat; a personality profile is a reusable provider, model, mode, effort, and behavior template; an orchestration coordinates multiple chats; a schedule starts a background chat when due; a heartbeat sends a reminder or prompt and does not start a chat. Use suggest_task for concrete work to preserve for later, create_chat to start one chat now, and start_orchestration only for managed multi-chat coordination. Use list_personalities, optionally filtered by roles, before choosing a personality profile. Never substitute a harness-native agent-spawn tool for suggest_task, and when a user names an Otto tool exactly, use that exact Otto tool.";
 export declare const ORCHESTRATOR_METHOD_DIRECTIVE: string;
 /**
  * The in-context "role directive" injected into a personality's system prompt at
  * spawn. The orchestrator gets the full conductor method; other coordinators
- * (chatter/artificer/scheduler) get a lighter delegate nudge; focused workers
+ * (chatter/artificer/scheduler) get a lighter delegate nudge; focused personalities
  * are told to stay on the task someone is waiting on. Roleless spawns get
  * nothing. This is guidance, not a gate - the tools stay available either way.
  */

package/dist/agent-personalities.js

@@ -4,22 +4,14 @@ import { PERSONALITY_ROLES } from "./messages.js";
 // resolution is NOT here - it needs the model's advertised thinking options and
 // lives with the daemon's effort resolver; availability does not depend on it.
 const ROLE_SET = new Set(PERSONALITY_ROLES);
-// Retired role names, mapped to their canonical replacement. "worker" was split
-// into "writer" (fast small-text generation) and "coder" (sub-agent coding); a
-// personality that still carries the old tag resolves to "coder", the closer
-// heir of what a worker did. Normalization applies these before filtering so
-// personalities persisted before the split keep a real role.
-const LEGACY_ROLE_ALIASES = {
-    worker: "coder",
-};
 export function isPersonalityRole(value) {
     return ROLE_SET.has(value);
 }
 /**
  * Filter an arbitrary role array (roles ride the wire as plain strings) down to
  * the known set, deduped and returned in canonical `PERSONALITY_ROLES` order.
- * Retired role names are mapped through `LEGACY_ROLE_ALIASES`; anything else
- * unknown (e.g. a role from a newer peer) is dropped rather than trusted.
+ * Unknown roles (for example, a role from a newer peer) are dropped rather
+ * than trusted.
  */
 export function normalizePersonalityRoles(roles) {
     if (!roles || roles.length === 0) {
@@ -27,7 +19,7 @@ export function normalizePersonalityRoles(roles) {
     }
     const present = new Set();
     for (const raw of roles) {
-        const canonical = LEGACY_ROLE_ALIASES[raw] ?? (isPersonalityRole(raw) ? raw : null);
+        const canonical = isPersonalityRole(raw) ? raw : null;
         if (canonical) {
             present.add(canonical);
         }
@@ -51,7 +43,7 @@ export const PERSONALITY_ROLE_INFO = {
         tier: "coordinator",
         guidance: "Creates and manages schedules; may orchestrate recurring or multi-step jobs. Pick for scheduling.",
     },
-    // ── Thinking workers (read-only, structured findings) ─────────────────────
+    // ── Thinking specialists (read-only, structured findings) ────────────────
     researcher: {
         tier: "focused",
         guidance: "Read-only surveyor - maps the code or domain and reports files, types, patterns, and gotchas. Pick to gather facts; proposes no solutions and edits nothing.",
@@ -68,7 +60,7 @@ export const PERSONALITY_ROLE_INFO = {
         tier: "focused",
         guidance: "Read-only second opinion - weighs the trade-offs and returns one recommendation. Pick for advice; never edits and does not fan out.",
     },
-    // ── Making workers (produce code, design, or text) ────────────────────────
+    // ── Making specialists (produce code, design, or text) ───────────────────
     coder: {
         tier: "focused",
         guidance: "Focused implementer - writes code for one sub-task others are waiting on. Pick to get a coding job done; stays on task.",
@@ -84,7 +76,7 @@ export const PERSONALITY_ROLE_INFO = {
     // ── Conductor ─────────────────────────────────────────────────────────────
     orchestrator: {
         tier: "coordinator",
-        guidance: "The sole conductor - plans team-shaped work, dispatches typed tasks to the right teammates, gathers, and synthesizes. Pick to run a multi-agent workflow.",
+        guidance: "The sole conductor - plans team-shaped work, dispatches typed tasks to the right teammates, gathers, and synthesizes. Pick to coordinate a multi-chat workflow.",
     },
 };
 /**
@@ -113,17 +105,18 @@ export function summarizePersonalityForSelection(personality) {
 }
 // The conductor's standing directive - the distilled `/epic` method taught to
 // the sole orchestrator role at spawn. It chooses direct work, a dedicated
-// worker, a follow-up task, or a Run by the task's actual needs rather than
+// chat, a suggested task, or an orchestration by the task's actual needs rather than
 // treating orchestration as the default. Kept here as one exported constant so
 // the wording is testable and shared. See projects/agent-orchestration/agent-orchestration.md.
+export const OTTO_WORK_VOCABULARY_DIRECTIVE = "Otto work vocabulary: a suggested task is deferred work for the user and does not start work; a chat is an active Otto chat session; a child chat is created by another chat; a personality profile is a reusable provider, model, mode, effort, and behavior template; an orchestration coordinates multiple chats; a schedule starts a background chat when due; a heartbeat sends a reminder or prompt and does not start a chat. Use suggest_task for concrete work to preserve for later, create_chat to start one chat now, and start_orchestration only for managed multi-chat coordination. Use list_personalities, optionally filtered by roles, before choosing a personality profile. Never substitute a harness-native agent-spawn tool for suggest_task, and when a user names an Otto tool exactly, use that exact Otto tool.";
 export const ORCHESTRATOR_METHOD_DIRECTIVE = "You are the orchestrator - the team's sole conductor. Choose tools because the task needs their specific capability, never because a tool is available or named. " +
-    "Do a small, self-contained task directly. Use create_agent only for an independently executable piece of active work that benefits from a dedicated worker. Use spawn_task only to preserve a concrete, out-of-scope follow-up for later. Use start_run only when the active work needs a declared multi-agent plan with daemon-managed fan-out, gathering, judging, loops, or approval gates. " +
-    "For work that genuinely needs orchestration: (1) if the shape is unclear, dispatch a researcher to survey and a planner to draft a typed plan; (2) declare that plan as a Run with start_run - phases typed research/plan/implement/design/verify/gate/deliver, fanning out candidates where several angles help and attaching a judger to grade them, looping until enough pass; (3) put a gate before irreversible or costly steps so the user approves; (4) synthesize the passing results into the deliverable. " +
+    "Do a small, self-contained task directly. Use create_chat only for an independently executable piece of active work that benefits from its own chat. Use suggest_task only to preserve a concrete, out-of-scope follow-up for later. Use start_orchestration only when the active work needs a declared multi-chat plan with daemon-managed fan-out, gathering, judging, loops, or approval gates. " +
+    "For work that genuinely needs orchestration: (1) if the shape is unclear, dispatch research and planning chats; (2) declare the plan with start_orchestration - phases typed research/plan/implement/design/verify/gate/deliver, fanning out where several angles help and attaching a judger to grade them, looping until enough pass; (3) put a gate before irreversible or costly steps so the user approves; (4) synthesize the passing results into the deliverable. " +
     "Every phase maps to a teammate's role; if the active team lacks a role a phase needs, say so plainly and stop rather than papering over the gap.";
 /**
  * The in-context "role directive" injected into a personality's system prompt at
  * spawn. The orchestrator gets the full conductor method; other coordinators
- * (chatter/artificer/scheduler) get a lighter delegate nudge; focused workers
+ * (chatter/artificer/scheduler) get a lighter delegate nudge; focused personalities
  * are told to stay on the task someone is waiting on. Roleless spawns get
  * nothing. This is guidance, not a gate - the tools stay available either way.
  */
@@ -137,9 +130,9 @@ export function composeRoleFocusDirective(roles) {
         return `${ORCHESTRATOR_METHOD_DIRECTIVE} (Your roles: ${roleList}.)`;
     }
     if (normalized.some((role) => PERSONALITY_ROLE_INFO[role].tier === "coordinator")) {
-        return `You are a coordinator personality (roles: ${roleList}). You front interactive work and may delegate when the task benefits from it: use list_personalities to see who else is available, then either do the work directly, spawn a dedicated worker for an independent active piece, or hand off genuinely multi-agent work to the team's orchestrator.`;
+        return `You are a coordinator personality (roles: ${roleList}). You front interactive work and may delegate when the task benefits from it: use list_personalities to see who else is available, then either do the work directly, create a child chat for an independent active piece, or hand off genuinely multi-chat work to the team's orchestrator.`;
     }
-    return `You are a focused worker personality (roles: ${roleList}). Someone is waiting on this specific task - stay on it and finish it. You can still call list_personalities to see the roster, but don't spawn sub-agents or start side workflows unless it is genuinely essential to completing this job.`;
+    return `You are a focused personality (roles: ${roleList}). Someone is waiting on this specific task - stay on it and finish it. You can still call list_personalities to see the roster, but don't create child chats or start side workflows unless it is genuinely essential to completing this job.`;
 }
 /**
  * Decide whether a personality is usable against a provider's current snapshot.

package/dist/agent-types.d.ts

@@ -77,6 +77,8 @@ export type ModelTier = "deep" | "standard" | "fast";
 export interface AgentModelDefinition {
     provider: AgentProvider;
     id: string;
+    aliases?: string[];
+    isSelectable?: boolean;
     label: string;
     description?: string;
     /** Catalog-owned model-family identity, currently emitted by Otto Brain only. */
@@ -372,6 +374,13 @@ export interface CompactionTimelineItem {
     preTokens?: number;
     postTokens?: number;
 }
+export interface AgentTaskItem {
+    text: string;
+    completed: boolean;
+    id?: string;
+    status?: "pending" | "in_progress" | "completed";
+    activeForm?: string;
+}
 export type AgentTimelineItem = {
     type: "user_message";
     text: string;
@@ -386,10 +395,7 @@ export type AgentTimelineItem = {
     text: string;
 } | ToolCallTimelineItem | {
     type: "todo";
-    items: {
-        text: string;
-        completed: boolean;
-    }[];
+    items: AgentTaskItem[];
 } | {
     type: "error";
     message: string;
@@ -581,6 +587,18 @@ export interface AgentRunResult {
 export declare const WORKSPACE_ACCESS_LEVELS: readonly ["none", "read", "write"];
 export type WorkspaceAccess = (typeof WORKSPACE_ACCESS_LEVELS)[number];
 export declare function isWorkspaceAccess(value: unknown): value is WorkspaceAccess;
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ProviderOptions = Record<string, JsonValue>;
+export interface McpToolRef {
+    kind: "mcp";
+    server: string;
+    tool: string;
+}
+export interface ToolPolicy {
+    preapproved: McpToolRef[];
+}
 export interface AgentSessionConfig {
     provider: AgentProvider;
     cwd: string;
@@ -609,6 +627,8 @@ export interface AgentSessionConfig {
         codex?: AgentMetadata;
         claude?: AgentMetadata;
     };
+    providerOptions?: ProviderOptions;
+    toolPolicy?: ToolPolicy;
     mcpServers?: Record<string, McpServerConfig>;
     /**
      * Internal agents are hidden from listings and don't trigger notifications.

package/dist/binary-frames/terminal.d.ts

@@ -3,6 +3,10 @@ import { TerminalStateSchema } from "../messages.js";
 export declare const TerminalStreamResizeSchema: z.ZodObject<{
     rows: z.ZodNumber;
     cols: z.ZodNumber;
+    intent: z.ZodOptional<z.ZodEnum<{
+        claim: "claim";
+        update: "update";
+    }>>;
 }, z.core.$strip>;
 export declare const TerminalStreamOpcode: {
     readonly Output: 1;

package/dist/binary-frames/terminal.js

@@ -3,6 +3,7 @@ import { TerminalStateSchema } from "../messages.js";
 export const TerminalStreamResizeSchema = z.object({
     rows: z.number().int().positive(),
     cols: z.number().int().positive(),
+    intent: z.enum(["claim", "update"]).optional(),
 });
 export const TerminalStreamOpcode = {
     Output: 0x01,

package/dist/brain.d.ts

@@ -95,12 +95,14 @@ export declare const BrainCapabilitiesSchema: z.ZodObject<{
     writable: z.ZodDefault<z.ZodBoolean>;
     jobs: z.ZodDefault<z.ZodBoolean>;
     restart: z.ZodDefault<z.ZodBoolean>;
+    processPool: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
 export type BrainCapabilities = z.infer<typeof BrainCapabilitiesSchema>;
 export declare const BrainHostStatusSchema: z.ZodObject<{
     running: z.ZodBoolean;
     pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -109,6 +111,14 @@ export declare const BrainHostStatusSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        state: z.ZodString;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>;
     vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -130,6 +140,7 @@ export declare const BrainHostStatusSchema: z.ZodObject<{
         writable: z.ZodDefault<z.ZodBoolean>;
         jobs: z.ZodDefault<z.ZodBoolean>;
         restart: z.ZodDefault<z.ZodBoolean>;
+        processPool: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$loose>>>;
     resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -173,6 +184,7 @@ export declare const BrainHostStatusResultSchema: z.ZodObject<{
         running: z.ZodBoolean;
         pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -181,6 +193,14 @@ export declare const BrainHostStatusResultSchema: z.ZodObject<{
         state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            state: z.ZodString;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>>;
         vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -202,6 +222,7 @@ export declare const BrainHostStatusResultSchema: z.ZodObject<{
             writable: z.ZodDefault<z.ZodBoolean>;
             jobs: z.ZodDefault<z.ZodBoolean>;
             restart: z.ZodDefault<z.ZodBoolean>;
+            processPool: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$loose>>>;
         resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -254,6 +275,7 @@ export declare const BrainHostStatusResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -262,6 +284,14 @@ export declare const BrainHostStatusResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -283,6 +313,7 @@ export declare const BrainHostStatusResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -336,6 +367,7 @@ export declare const BrainHostStartResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -344,6 +376,14 @@ export declare const BrainHostStartResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -365,6 +405,7 @@ export declare const BrainHostStartResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -417,6 +458,7 @@ export declare const BrainHostStopResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -425,6 +467,14 @@ export declare const BrainHostStopResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -446,6 +496,7 @@ export declare const BrainHostStopResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -499,6 +550,7 @@ export declare const BrainHostRestartResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -507,6 +559,14 @@ export declare const BrainHostRestartResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -528,6 +588,7 @@ export declare const BrainHostRestartResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1886,6 +1947,7 @@ export declare const BrainModelLoadResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1894,6 +1956,14 @@ export declare const BrainModelLoadResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1915,6 +1985,7 @@ export declare const BrainModelLoadResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1994,6 +2065,7 @@ export declare const BrainModelUnloadResponseSchema: z.ZodObject<{
             running: z.ZodBoolean;
             pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2002,6 +2074,14 @@ export declare const BrainModelUnloadResponseSchema: z.ZodObject<{
             state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                state: z.ZodString;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>;
             vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2023,6 +2103,7 @@ export declare const BrainModelUnloadResponseSchema: z.ZodObject<{
                 writable: z.ZodDefault<z.ZodBoolean>;
                 jobs: z.ZodDefault<z.ZodBoolean>;
                 restart: z.ZodDefault<z.ZodBoolean>;
+                processPool: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$loose>>>;
             resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2180,6 +2261,7 @@ export declare const BrainStatusChangedStatusPayloadSchema: z.ZodObject<{
         running: z.ZodBoolean;
         pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        runtime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         apiVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         port: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2188,6 +2270,14 @@ export declare const BrainStatusChangedStatusPayloadSchema: z.ZodObject<{
         state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        residents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            state: z.ZodString;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            upstream: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>>;
         vramBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         loadSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2209,6 +2299,7 @@ export declare const BrainStatusChangedStatusPayloadSchema: z.ZodObject<{
             writable: z.ZodDefault<z.ZodBoolean>;
             jobs: z.ZodDefault<z.ZodBoolean>;
             restart: z.ZodDefault<z.ZodBoolean>;
+            processPool: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$loose>>>;
         resources: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         logLineCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

package/dist/brain.js

@@ -143,6 +143,8 @@ export const BrainCapabilitiesSchema = z
     jobs: z.boolean().default(false),
     /** The brain can ask its owning daemon to restart it. */
     restart: z.boolean().default(false),
+    /** The host can keep multiple independently supervised model processes resident. */
+    processPool: z.boolean().default(false),
 })
     .passthrough();
 // The brain's host status, as the daemon derives it: liveness plus the fields
@@ -153,6 +155,8 @@ export const BrainHostStatusSchema = z
     running: z.boolean(),
     pid: z.number().nullable().optional(),
     version: z.string().nullable().optional(),
+    /** The llama.cpp runtime resolved by the Brain host, or "not installed". */
+    runtime: z.string().nullable().optional(),
     /**
      * Which generation of the brain's management contract the far side speaks.
      *
@@ -168,6 +172,19 @@ export const BrainHostStatusSchema = z
     state: z.string().nullable().optional(),
     model: z.string().nullable().optional(),
     modelId: z.string().nullable().optional(),
+    /** Every independently hosted resident model process. */
+    residents: z
+        .array(z
+        .object({
+        state: z.string(),
+        model: z.string().nullable().optional(),
+        modelId: z.string().nullable().optional(),
+        pid: z.number().nullable().optional(),
+        upstream: z.string().nullable().optional(),
+        vramBytes: z.number().nullable().optional(),
+    })
+        .passthrough())
+        .optional(),
     vramBytes: z.number().nullable().optional(),
     loadSeconds: z.number().nullable().optional(),
     startedAt: z.string().nullable().optional(),
@@ -380,7 +397,8 @@ export const BrainModelsListResponseSchema = z.object({
 });
 // Read/write a *remote* brain's own config (its /__host/config). Only valid in
 // brain.mode "remote"; the config is the remote brain's effective config with
-// secrets redacted. Editable fields are model-related (defaultModel, lockModel);
+// secrets redacted. Editable fields are model-related (defaultModel,
+// maxLoadedModels, lockedModels, lockModel);
 // network/TLS/auth stay host-owned. Gated by features.brainRemote.
 export const BrainRemoteConfigSchema = z.record(z.string(), z.unknown());
 export const BrainRemoteConfigGetRequestSchema = z.object({

package/dist/chat/rpc-schemas.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { ChatMessageSchema, ChatRoomDetailSchema } from "./types.js";
+// COMPAT(chatRooms): retained after the v0.3.0 feature removal; remove after 2027-02-09 when mixed-version peers no longer send legacy messages.
 export const ChatCreateRequestSchema = z.object({
     type: z.literal("chat/create"),
     requestId: z.string(),

package/dist/chat/types.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+// COMPAT(chatRooms): retained after the v0.3.0 feature removal; remove after 2027-02-09 when mixed-version peers no longer send legacy messages.
 export const ChatRoomSchema = z.object({
     id: z.string(),
     name: z.string(),

package/dist/client-capabilities.d.ts

@@ -7,6 +7,7 @@ export declare const CLIENT_CAPS: {
     readonly projectUpdates: "project_updates";
     readonly communicationsPresenceUpdates: "communications_presence_updates";
     readonly brainLogWatch: "brain_log_watch";
+    readonly compactProviderSnapshots: "compact_provider_snapshots";
     readonly browserHost: "browser_host";
 };
 export type ClientCapability = (typeof CLIENT_CAPS)[keyof typeof CLIENT_CAPS];

package/dist/client-capabilities.js

@@ -30,6 +30,10 @@ export const CLIENT_CAPS = {
     // Logs tab opens; a client without it keeps the old unconditional feed,
     // because it has no way to ask and would otherwise lose live logs entirely.
     brainLogWatch: "brain_log_watch",
+    // COMPAT(compactProviderSnapshots): added in v0.2.X. Capable clients receive
+    // provider catalogs with shared thinking sets and may revalidate by content hash.
+    // Remove the legacy snapshot encoding after 2027-02-04.
+    compactProviderSnapshots: "compact_provider_snapshots",
     browserHost: "browser_host",
 };
 //# sourceMappingURL=client-capabilities.js.map

package/dist/daemon-config.d.ts

@@ -222,6 +222,8 @@ export declare const MutableBrainConfigSchema: z.ZodObject<{
         port: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
     defaultModel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    maxLoadedModels: z.ZodDefault<z.ZodNumber>;
+    lockedModels: z.ZodDefault<z.ZodArray<z.ZodString>>;
     runtime: z.ZodDefault<z.ZodObject<{
         source: z.ZodDefault<z.ZodEnum<{
             auto: "auto";
@@ -297,6 +299,8 @@ export declare const MutableBrainConfigPatchSchema: z.ZodObject<{
         port: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>>;
     defaultModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLoadedModels: z.ZodOptional<z.ZodNumber>;
+    lockedModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtime: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<{
             auto: "auto";
@@ -344,6 +348,8 @@ export declare const DEFAULT_MUTABLE_BRAIN_CONFIG: {
         port: number;
     };
     defaultModel: null;
+    maxLoadedModels: number;
+    lockedModels: never[];
     runtime: {
         source: "auto";
         path: null;