@wrongstack/cli 0.302.2 → 0.305.0

package/dist/execute-deps.d.ts

@@ -48,6 +48,7 @@ export interface ToolPickerItem {
     owner: string;
     category: string;
     enabled: boolean;
+    exposure: 'direct' | 'lazy' | 'disabled';
     mutating: boolean;
     permission: string;
     descMode: 'extend' | 'simple';
@@ -89,6 +90,21 @@ export interface CoreDeps {
     positional: string[];
     slashRegistry: SlashCommandRegistry;
     tokenCounter: TokenCounter;
+    /**
+     * Forward-declared session ref owned by the host (cli-main). When an
+     * in-process `/resume` swaps the agent's active writer, the resume
+     * handler repoints `sessionRef.current` so provider-side
+     * `getSessionId: () => sessionRef.current?.id` callbacks and the
+     * record-mode `bindReplayToContainer` binding follow the resumed
+     * session instead of staying pinned to the boot session.
+     *
+     * Optional: hosts that don't need post-resume propagation (or tests
+     * that predate the refactor) can omit it; provider calls then stay
+     * pinned to the boot session — same behavior as before this existed.
+     */
+    sessionRef?: {
+        current: import('@wrongstack/core/types').SessionWriter | undefined;
+    } | undefined;
     /** Atomically move this process's SessionRegistry ownership after explicit resume. */
     activateSessionIdentity?: ((sessionId: string, target?: import('./wiring/session-registry.js').SessionIdentityTarget) => Promise<void>) | undefined;
     /**

package/dist/{execution-LZRYRGDD.js → execution-YMBD7YWC.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-V3XH6XBJ.js";
 import {
   startCliHqConnection
-} from "./chunk-JW75HY4F.js";
+} from "./chunk-FKWHSFX4.js";
 import "./chunk-WHOIR577.js";
 import {
   advanceToNextTask,
@@ -25,17 +25,17 @@ import {
   trySaveSpecFromAIOutput,
   trySaveTasksFromAIOutput
 } from "./chunk-DGXNL7OT.js";
-import {
-  WEBUI_SESSION_CHILD_CAPABILITIES,
-  writeWebuiSessionChildError,
-  writeWebuiSessionChildReady
-} from "./chunk-3JPTNADJ.js";
 import {
   theme
 } from "./chunk-QD544J2B.js";
 import {
   fmtTok
 } from "./chunk-TYO2OVAD.js";
+import {
+  WEBUI_SESSION_CHILD_CAPABILITIES,
+  writeWebuiSessionChildError,
+  writeWebuiSessionChildReady
+} from "./chunk-3JPTNADJ.js";
 import {
   resolveActiveApiKey
 } from "./chunk-SZ42FYPT.js";
@@ -52,7 +52,7 @@ import {
 import "./chunk-7OCVIDC7.js";
 
 // src/execution.ts
-import * as path12 from "node:path";
+import * as path13 from "node:path";
 import { effectiveFallbackChain as effectiveFallbackChain2, setQueuedMessagesSnapshot as setQueuedMessagesSnapshot2 } from "@wrongstack/core/agent";
 import { attachTodosCheckpoint as attachTodosCheckpoint2 } from "@wrongstack/core/storage";
 import { normalizeTokenSavingTier as normalizeTokenSavingTier2 } from "@wrongstack/core/types";
@@ -203,7 +203,7 @@ async function runWebUIDispatch(ctx) {
   const isSimpleUi = !isSessionChild && flags["simpleui"] === true;
   agent.disableInteractiveConfirmation();
   renderer.setSilent(true);
-  const { runWebUI } = await import("./webui-server-E3OPEKU5.js");
+  const { runWebUI } = await import("./webui-server-FTG7JAZU.js");
   const flagValue = (names) => {
     for (const name of names) {
       if (!Object.hasOwn(flags, name)) continue;
@@ -985,8 +985,13 @@ import {
   DefaultSystemPromptBuilder,
   setQueuedMessagesSnapshot
 } from "@wrongstack/core/agent";
+import { TOKENS } from "@wrongstack/core/kernel";
 import { DefaultSessionStore } from "@wrongstack/core/storage";
-import { resolveWstackPaths, sessionScopedPath } from "@wrongstack/core/utils";
+import {
+  activateProjectStateGuard,
+  resolveWstackPaths,
+  sessionScopedPath
+} from "@wrongstack/core/utils";
 async function switchProjectInPlace(ctx, targetRoot, displayName) {
   const {
     state,
@@ -1064,6 +1069,7 @@ async function switchProjectInPlace(ctx, targetRoot, displayName) {
     });
     targetActivated = true;
     await state.activateSessionIdentity(nextWriter.id, target);
+    await activateProjectStateGuard(resolved);
   } catch (err) {
     if (!targetActivated) await targetClaim?.cancel().catch(() => void 0);
     else if (oldWriter) {
@@ -1124,6 +1130,13 @@ async function switchProjectInPlace(ctx, targetRoot, displayName) {
       modeStore,
       modeId: modeId ?? "default",
       modePrompt: switchMode?.prompt ?? "",
+      tokenSavingMode: config.features.tokenSavingMode,
+      modelCapabilities: {
+        maxContextTokens: context.provider.capabilities.maxContext,
+        supportsTools: !!context.provider.capabilities.tools,
+        supportsVision: !!context.provider.capabilities.vision,
+        supportsReasoning: !!context.provider.capabilities.reasoning
+      },
       instructionPaths: {
         globalDir: nextWpaths.globalInstructions,
         projectDir: nextWpaths.inProjectInstructions,
@@ -1138,6 +1151,11 @@ async function switchProjectInPlace(ctx, targetRoot, displayName) {
       provider: context.provider.id,
       model: context.model
     });
+    if (agent.container.has(TOKENS.SystemPromptBuilder)) {
+      agent.container.override(TOKENS.SystemPromptBuilder, () => switchBuilder, {
+        owner: "tui-project-switch"
+      });
+    }
   } catch (err) {
     console.error(
       JSON.stringify({
@@ -1298,6 +1316,7 @@ async function resumeSession(ctx, sessionId) {
       throw err;
     }
     writerSwapped = true;
+    state.sessionRef && (state.sessionRef.current = resumed.writer);
     await agent.ctx.flushConversationJournal().catch((err) => {
       console.error(
         JSON.stringify({
@@ -1851,6 +1870,57 @@ function createSettingsAdapter(ctx) {
   return { getSettings, saveSettings };
 }
 
+// src/boot/tui-theme-adapter.ts
+import * as fs4 from "node:fs/promises";
+import * as path9 from "node:path";
+import { atomicWrite as atomicWrite2 } from "@wrongstack/core/utils";
+var VALID_PRESETS = /* @__PURE__ */ new Set([
+  "catppuccin",
+  "tokyo-night",
+  "nord",
+  "cyberpunk",
+  "dracula",
+  "gruvbox-dark",
+  "solarized-dark",
+  "one-dark",
+  "monokai",
+  "rose-pine",
+  "kanagawa",
+  "ayu-dark",
+  "everforest",
+  "night-owl",
+  "synthwave"
+]);
+function createThemeAdapter({ configStore, wpaths }) {
+  return {
+    getThemePreset: () => {
+      const live = configStore.get();
+      const candidate = live.themePreset;
+      return candidate && VALID_PRESETS.has(candidate) ? candidate : void 0;
+    },
+    saveThemePreset: async (preset) => {
+      if (!VALID_PRESETS.has(preset)) {
+        throw new Error(`Unknown theme preset: ${preset}`);
+      }
+      configStore.update({ themePreset: preset });
+      const configPath = activeProfileConfigPath(wpaths, configStore.get());
+      let parsed = {};
+      try {
+        const raw = await fs4.readFile(configPath, "utf8");
+        parsed = JSON.parse(raw);
+      } catch (err) {
+        const e = err;
+        if (e.code !== "ENOENT") {
+          throw err;
+        }
+      }
+      parsed.themePreset = preset;
+      await fs4.mkdir(path9.dirname(configPath), { recursive: true });
+      await atomicWrite2(configPath, JSON.stringify(parsed, null, 2), { mode: 384 });
+    }
+  };
+}
+
 // src/brain-menu/panel-service.ts
 import { BUILTIN_COUNCIL_PERSONAS } from "@wrongstack/core/execution";
 var PERSONA_CATALOG = BUILTIN_COUNCIL_PERSONAS.map((persona) => ({
@@ -2268,7 +2338,9 @@ async function finalizeExecutionCleanup(input) {
 
 // src/execution-kanban-dispatch.ts
 import { randomUUID } from "node:crypto";
+import { missingRequiredRuntimeTools } from "@wrongstack/core/agent-catalog";
 import { WIDE_SUBAGENT_CAPABILITIES } from "@wrongstack/core/security";
+import { stripFrontmatter } from "@wrongstack/core/skills";
 
 // src/kanban-dispatch-route.ts
 import { fallbackProfileChain, parseModelRef as parseModelRef2 } from "@wrongstack/core/agent";
@@ -2307,21 +2379,43 @@ function createKanbanDispatchHandler({
     } = resolveKanbanDispatchRoute(config, spawnOpts);
     let agentDescription = description;
     if (spawnOpts?.skills?.length && skillLoader) {
-      const loaded = await Promise.all(
-        spawnOpts.skills.map(async (skillName) => {
+      const availableToolNames = spawnOpts.tools;
+      const loaded = [];
+      for (const skillName of spawnOpts.skills) {
+        try {
           const manifest = await skillLoader.find(skillName);
-          if (!manifest) throw new Error(`Kanban skill not found: ${skillName}`);
-          const body = await skillLoader.readBody(skillName);
-          return `## Required skill: ${skillName}
+          if (!manifest) {
+            process.emitWarning(`Kanban dispatch skill not found, skipped: ${skillName}`, {
+              code: "WRONGSTACK_KANBAN_SKILL_SKIPPED"
+            });
+            continue;
+          }
+          if (availableToolNames !== void 0 && missingRequiredRuntimeTools(manifest.requiredTools, availableToolNames).length > 0) {
+            process.emitWarning(
+              `Kanban dispatch skill "${skillName}" needs tools this worker does not have, skipped.`,
+              { code: "WRONGSTACK_KANBAN_SKILL_SKIPPED" }
+            );
+            continue;
+          }
+          const body = stripFrontmatter(await skillLoader.readBody(skillName)).trim();
+          if (!body) continue;
+          loaded.push(`## Required skill: ${skillName}
 
-${body}`;
-        })
-      );
-      agentDescription = `${description}
+${body}`);
+        } catch (err) {
+          process.emitWarning(
+            `Kanban dispatch skill "${skillName}" could not be loaded, skipped: ${err instanceof Error ? err.message : String(err)}`,
+            { code: "WRONGSTACK_KANBAN_SKILL_SKIPPED" }
+          );
+        }
+      }
+      if (loaded.length > 0) {
+        agentDescription = `${description}
 
 # Required agentic skill instructions
 
 ${loaded.join("\n\n")}`;
+      }
     }
     void (async () => {
       const built = await sddSubagentFactory({
@@ -2664,7 +2758,7 @@ function createChimeraWorkRegistry() {
 
 // src/execution-chimera-cascade.ts
 import * as fsp from "node:fs/promises";
-import * as path9 from "node:path";
+import * as path10 from "node:path";
 import { emitReviewIfChanged } from "@wrongstack/core/plugin";
 
 // src/chimera-review-task.ts
@@ -3027,7 +3121,7 @@ async function maybeReReviewCascade({
       const reReadFiles = [];
       for (const f of bundle.files) {
         try {
-          const absPath = path9.join(bundle.cwd, f.path);
+          const absPath = path10.join(bundle.cwd, f.path);
           const content = await fsp.readFile(absPath, "utf8");
           reReadFiles.push({ path: f.path, status: "modified", content });
         } catch {
@@ -3096,7 +3190,7 @@ async function maybeReReviewCascade({
 
 // src/execution-chimera-review.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
-import path10 from "node:path";
+import path11 from "node:path";
 import { effectiveFallbackChain } from "@wrongstack/core/agent";
 import {
   CHIMERA_REVIEW_PROMPT,
@@ -3109,7 +3203,7 @@ import {
 function normalizeFileKeyForCitation(raw, cwd) {
   const forward = raw.replace(/\\/g, "/").replace(/^\.\//, "");
   const isAbsolute = forward.startsWith("/") || /^[a-zA-Z]:\//.test(forward);
-  const pathMod = process.platform === "win32" ? path10.win32 : path10;
+  const pathMod = process.platform === "win32" ? path11.win32 : path11;
   const relative = isAbsolute ? pathMod.relative(cwd, forward).replace(/\\/g, "/").replace(/^\.\//, "") : forward;
   return process.platform === "win32" ? relative.toLowerCase() : relative;
 }
@@ -3307,7 +3401,7 @@ function installChimeraReviewHandler({
             const changedBasenameIndex = /* @__PURE__ */ new Map();
             for (const file of p.files) {
               const normalized = normalizeFileKeyForCitation(file.path, p.cwd);
-              const basename7 = path10.basename(file.path).toLowerCase();
+              const basename7 = path11.basename(file.path).toLowerCase();
               const bucket = changedBasenameIndex.get(basename7);
               if (bucket) bucket.push(normalized);
               else changedBasenameIndex.set(basename7, [normalized]);
@@ -3315,7 +3409,7 @@ function installChimeraReviewHandler({
             const droppedCitations = citedFindings.filter((finding) => {
               const citedKey = normalizeFileKeyForCitation(finding.location.file, p.cwd);
               if (citedPaths.has(citedKey)) return false;
-              const basename7 = path10.basename(finding.location.file).toLowerCase();
+              const basename7 = path11.basename(finding.location.file).toLowerCase();
               const bucket = changedBasenameIndex.get(basename7);
               return !(bucket && bucket.length === 1);
             });
@@ -3616,6 +3710,7 @@ import {
 } from "@wrongstack/core/utils";
 import { readClipboardImage, routeImagesForModel } from "@wrongstack/runtime";
 import { createAutoProceedLoopGuard } from "@wrongstack/tools/auto-proceed-loop-guard";
+import { todoTool } from "@wrongstack/tools/todo";
 
 // src/repl-auto-proceed.ts
 import { color as color6, estimateRequestTokensCalibrated } from "@wrongstack/core/utils";
@@ -3791,7 +3886,7 @@ async function runContextCompaction(opts, _signal) {
 
 // src/repl-client-registration.ts
 import * as crypto from "node:crypto";
-import * as path11 from "node:path";
+import * as path12 from "node:path";
 import { getSharedProjectMailbox, resolveProjectDir } from "@wrongstack/core/coordination";
 import { wstackGlobalRoot } from "@wrongstack/core/utils";
 function registerReplClient(opts) {
@@ -3801,7 +3896,7 @@ function registerReplClient(opts) {
   const hqConnection = startCliHqConnection({
     clientKind: "repl",
     projectRoot: replProjectRoot,
-    projectName: path11.basename(replProjectRoot),
+    projectName: path12.basename(replProjectRoot),
     appConfig: opts.appConfig,
     capabilities: ["telemetry.publish", "mailbox.summary"]
   });
@@ -3815,7 +3910,7 @@ function registerReplClient(opts) {
   clientMailbox.registerClient({
     clientId,
     sessionId: opts.getSessionId?.() ?? replProjectRoot,
-    name: `REPL [${path11.basename(replProjectRoot)}]`,
+    name: `REPL [${path12.basename(replProjectRoot)}]`,
     source: "repl",
     pid: process.pid
   }).then(() => {
@@ -4117,10 +4212,14 @@ ${lines.join("\n")}
             if (resolved.source === "todo" && resolved.todoId) {
               const selected = todos.find((todo) => todo.id === resolved.todoId);
               if (selected?.status === "pending") {
-                opts.agent.ctx.state.replaceTodos(
-                  todos.map(
-                    (todo) => todo.id === resolved.todoId ? { ...todo, status: "in_progress" } : todo.status === "in_progress" ? { ...todo, status: "pending" } : todo
-                  )
+                await todoTool.execute(
+                  {
+                    todos: todos.map(
+                      (todo) => todo.id === resolved.todoId ? { ...todo, status: "in_progress" } : todo.status === "in_progress" ? { ...todo, status: "pending" } : todo
+                    )
+                  },
+                  opts.agent.ctx,
+                  { signal: AbortSignal.timeout(3e4) }
                 );
               }
             }
@@ -4293,10 +4392,14 @@ ${color9.dim(taskList2)}
         if (resolved.source === "todo" && resolved.todoId) {
           const selected = opts.agent.ctx.todos.find((todo) => todo.id === resolved.todoId);
           if (selected?.status === "pending") {
-            opts.agent.ctx.state.replaceTodos(
-              opts.agent.ctx.todos.map(
-                (todo) => todo.id === resolved.todoId ? { ...todo, status: "in_progress" } : todo.status === "in_progress" ? { ...todo, status: "pending" } : todo
-              )
+            await todoTool.execute(
+              {
+                todos: opts.agent.ctx.todos.map(
+                  (todo) => todo.id === resolved.todoId ? { ...todo, status: "in_progress" } : todo.status === "in_progress" ? { ...todo, status: "pending" } : todo
+                )
+              },
+              opts.agent.ctx,
+              { signal: AbortSignal.timeout(3e4) }
             );
           }
         }
@@ -4678,6 +4781,7 @@ async function execute(deps) {
       positional,
       slashRegistry,
       tokenCounter,
+      sessionRef,
       activateSessionIdentity,
       updateInfo: initialUpdateInfo,
       webuiSessionChild
@@ -4874,6 +4978,12 @@ async function execute(deps) {
         activeSessionStore,
         activateSessionIdentity,
         detachActiveTodosCheckpoint,
+        // Plumbed from cli-main.ts so `resumeSession` can repoint the ref
+        // when an in-process `/resume` swaps the active writer. Optional
+        // on TuiRuntimeState; tests/hosts that omit it revert to the
+        // pre-refactor behavior where provider calls stay pinned to the
+        // boot session.
+        sessionRef,
         pendingProjectSwitch: null,
         autonomousCoordinator: null,
         coordinatorRun: null,
@@ -4988,6 +5098,8 @@ async function execute(deps) {
             fleetStreamController,
             applyLiveSettings
           }),
+          ...createThemeAdapter({ configStore, wpaths }),
+          configStore,
           effectiveMaxContext,
           titleAnimation: config.autonomy?.["terminalTitleAnimation"] ?? true,
           chime: config.autonomy?.["chime"] ?? false,
@@ -5191,7 +5303,7 @@ async function execute(deps) {
           attachments,
           effectiveMaxContext,
           getEffectiveMaxContext,
-          projectName: path12.basename(projectRoot) || void 0,
+          projectName: path13.basename(projectRoot) || void 0,
           projectRoot,
           appConfig: config,
           getSessionId: () => agent.ctx.session?.id ?? session.id,
@@ -5250,4 +5362,4 @@ export {
   execute,
   resolveReviewerFallbackModels
 };
-//# sourceMappingURL=execution-LZRYRGDD.js.map
+//# sourceMappingURL=execution-YMBD7YWC.js.map

package/dist/fleet/host-context.d.ts

@@ -1,5 +1,16 @@
 import type { SubagentConfig } from '@wrongstack/core/types';
 import type { MultiAgentDeps } from './host-types.js';
+/** Skills whose bodies were requested but did not make it into the prompt. */
+export interface SkillResolutionReport {
+    content: string;
+    selected: string[];
+    /** skill → why it was dropped, so the omission is never silent. */
+    dropped: Record<string, 'not-found' | 'missing-capability' | 'missing-tool' | 'budget' | 'empty'>;
+    /** Skills kept under budget by shortening their bundled body. */
+    trimmed: string[];
+}
+export declare function resolveHostSubagentSkillResolution(deps: MultiAgentDeps, roster: Record<string, SubagentConfig>, subCfg: SubagentConfig, availableToolNames?: readonly string[]): Promise<SkillResolutionReport>;
+/** Backwards-compatible wrapper for callers that only need the prompt text. */
 export declare function resolveHostSubagentSkillContent(deps: MultiAgentDeps, roster: Record<string, SubagentConfig>, subCfg: SubagentConfig, availableToolNames?: readonly string[]): Promise<string>;
 export declare function retrieveHostSubagentMemory(deps: MultiAgentDeps, getLeaderMode: (() => string | undefined) | undefined, subCfg: SubagentConfig, taskContext?: Record<string, unknown>): Promise<string[]>;
 //# sourceMappingURL=host-context.d.ts.map

package/dist/fleet/host-learning-tracker.d.ts

@@ -5,7 +5,7 @@ export declare class HostLearningRoleTracker {
     private readonly roles;
     private readonly accessOrder;
     constructor(maxEntries?: number);
-    record(subagentId: string, role: string): void;
-    capture(result: TaskResult, deps: Pick<MultiAgentDeps, 'container' | 'projectRoot'>): void;
+    record(subagentId: string, role: string, skills?: readonly string[]): void;
+    capture(result: TaskResult, deps: Pick<MultiAgentDeps, 'container' | 'projectRoot'>, onCaptured?: (role: string) => void): void;
 }
 //# sourceMappingURL=host-learning-tracker.d.ts.map

package/dist/fleet/host-learning.d.ts

@@ -1,4 +1,15 @@
 import type { TaskResult } from '@wrongstack/core/types';
 import type { MultiAgentDeps } from './host-types.js';
-export declare function captureCompletedTaskLearningForHost(result: TaskResult, deps: Pick<MultiAgentDeps, 'container' | 'projectRoot'>, subagentLearningRoles: ReadonlyMap<string, string>): void;
+/** What a spawn recorded about the agent that will produce this result. */
+export interface LearningSubject {
+    role: string;
+    skills: readonly string[];
+}
+export declare function captureCompletedTaskLearningForHost(result: TaskResult, deps: Pick<MultiAgentDeps, 'container' | 'projectRoot'>, subjects: ReadonlyMap<string, LearningSubject>, 
+/**
+ * Called when a capture persisted at least one directive. The auto-optimize
+ * scheduler uses it as its trigger, so distillation follows learning without
+ * anyone pressing a button.
+ */
+onCaptured?: (role: string) => void): void;
 //# sourceMappingURL=host-learning.d.ts.map

package/dist/fleet/host-session-writer.d.ts

@@ -1,3 +1,36 @@
 import type { SessionWriter } from '@wrongstack/core/types';
+/**
+ * Session writer for a subagent that has no journal of its own: its events are
+ * interleaved into the parent's JSONL.
+ *
+ * Lifecycle and rewind *control* stay no-ops — `writeCheckpoint`,
+ * `writeInFlightMarker`, `truncateToCheckpoint`, `clearSession` and `close`
+ * belong to the parent, and a subagent driving them would corrupt the parent's
+ * checkpoint chain and crash-recovery markers.
+ *
+ * Rewind *evidence* is a different thing and is forwarded. A subagent's file
+ * mutations are real edits to the user's working tree, made under the parent
+ * prompt that spawned it; dropping their `file_snapshot` records left `/rewind`
+ * quietly unable to undo them, with nothing in the transcript saying so. The
+ * parent writer files them against its own `activePromptIndex`, which is
+ * exactly the prompt a user rewinding this work would target.
+ */
 export declare function createParentSubagentSessionWriter(parentSession: SessionWriter): SessionWriter;
+/**
+ * Wrap a subagent's own `SessionWriter` so its file mutations are ALSO recorded
+ * against the parent session.
+ *
+ * When a subagent gets a real per-subagent JSONL, its `file_snapshot` events
+ * land in that file — under the director run directory, which
+ * `DefaultSessionRewinder` never reads: it resolves one path, the session being
+ * rewound. So the richer, "proper" subagent-session path was the one that lost
+ * rewind coverage entirely, while the fallback shim above at least had the
+ * parent handle in reach.
+ *
+ * Recording to the parent as well keeps one authority for undo (the session the
+ * user actually rewinds) without taking anything away from the subagent's own
+ * transcript, which still receives every other event including the conversation
+ * that produced the edit.
+ */
+export declare function withParentFileSnapshots(subagentSession: SessionWriter, parentSession: SessionWriter): SessionWriter;
 //# sourceMappingURL=host-session-writer.d.ts.map

package/dist/fleet/host-subagent-factory.d.ts

@@ -9,7 +9,7 @@ export interface HostSubagentFactoryContext {
     sessionFactory?: DirectorSessionFactory | undefined;
     filterTools: (allow?: string[]) => Tool[];
     mailboxProjectDir: () => string;
-    recordLearningRole: (subagentId: string, role: string) => void;
+    recordLearningRole: (subagentId: string, role: string, skills?: readonly string[]) => void;
     subagentToolRegistry: (allow?: string[]) => ToolRegistry;
 }
 export declare function createHostSubagentFactory(config: Config, host: HostSubagentFactoryContext): AgentFactory;

package/dist/fleet/host.d.ts

@@ -39,6 +39,9 @@ export declare class MultiAgentHost {
      *  Bounded to 20 entries with LRU eviction to prevent unbounded memory growth. */
     private readonly acpRunnerCache;
     private readonly learningRoles;
+    /** Background distillation of captured learning into per-skill addenda. */
+    private learningOptimizer;
+    private learningSwept;
     /** Adaptive concurrency controller — created in buildDirector() when config has
      *  adaptiveConcurrency.enabled = true. Monitors FleetBus for 429 errors and
      *  automatically adjusts maxConcurrent to prevent rate limiting. */
@@ -202,6 +205,35 @@ export declare class MultiAgentHost {
     private emitLifecycleCompleted;
     private recordLearningRole;
     private captureCompletedTaskLearning;
+    /**
+     * Lazily built so a session that never spawns a subagent pays nothing, and
+     * so the policy is read from the live config rather than frozen at boot.
+     * Returns null when auto-optimization is switched off.
+     */
+    private getLearningOptimizer;
+    /**
+     * Break a dispatch tie with a model when the keyword heuristic is ambiguous.
+     *
+     * Routes through the `dispatcher` model-matrix slot when one is configured —
+     * picking a role is a short classification, so it belongs on a cheap fast
+     * model rather than the leader's — and the session default otherwise.
+     * Returning `null` on any failure leaves the dispatcher on its heuristic
+     * result, so routing degrades rather than breaking a spawn.
+     */
+    private classifyDispatch;
+    /**
+     * Resolve a model for the distillation pass. Uses the `memory-curator` slot
+     * of the model matrix when one is configured — curating learned knowledge is
+     * exactly that role's job — and the session default otherwise. A failure
+     * here is not fatal: the pass still writes the deterministic skill addenda.
+     */
+    private resolveOptimizerLlm;
+    /**
+     * Evaluate every role with learning data once per session. Without it, a
+     * role that became eligible before this session would wait for its next
+     * capture — which for a rarely-used role can be never.
+     */
+    private sweepLearningOptimization;
     status(): FleetHostStatus;
     /**
      * Read-only concurrency + lifetime spawn budget for `/fleet status` and

package/dist/{hq-AHPAE7EN.js → hq-5G6D5YIU.js}

@@ -47,7 +47,7 @@ var hqCmd = async (args, deps) => {
   return 1;
 };
 async function startServer(deps) {
-  const { startHqServer } = await import("./hq-server-KU2Z54QU.js");
+  const { startHqServer } = await import("./hq-server-IVZLVCFV.js");
   const dataDir = resolveDataDir(deps);
   const flags = deps.flags ?? {};
   const host = typeof flags["host"] === "string" ? flags["host"] : HQ_CLI_DEFAULT_HOST;
@@ -612,4 +612,4 @@ export {
   hqCmd,
   resolveAuditActor
 };
-//# sourceMappingURL=hq-AHPAE7EN.js.map
+//# sourceMappingURL=hq-5G6D5YIU.js.map

package/dist/{hq-server-KU2Z54QU.js → hq-server-IVZLVCFV.js}

@@ -15,7 +15,7 @@ import {
   readLocalSubagentTranscript,
   sanitizeApiError,
   startHqServer
-} from "./chunk-WOXUE2CN.js";
+} from "./chunk-RHLQT3EV.js";
 import "./chunk-KE7E7DPX.js";
 import "./chunk-Q5GTM25S.js";
 import "./chunk-7OCVIDC7.js";
@@ -37,4 +37,4 @@ export {
   sanitizeApiError,
   startHqServer
 };
-//# sourceMappingURL=hq-server-KU2Z54QU.js.map
+//# sourceMappingURL=hq-server-IVZLVCFV.js.map