comisai 1.0.45 → 1.0.46

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-registry.d.ts

@@ -57,11 +57,11 @@ export interface AgentsResult {
     /** Daemon-level OAuthCredentialStore handle. Threaded into RpcDispatchDeps so agents.update
      * can validate oauthProfiles patches via has(). */
     oauthCredentialStore: OAuthCredentialStorePort;
-    /** Per-agent OAuthTokenManager instances (184) — the SAME managers the executors use (no 2nd
+    /** Per-agent OAuthTokenManager instances — the SAME managers the executors use (no 2nd
      * instance). daemon.ts threads the DEFAULT agent's into buildImageGenBundle → the Codex image
-     * adapter (CDX-01). Only OAuth-configured agents appear (setupSingleAgent's `oauth` is undefined). */
+     * adapter. Only OAuth-configured agents appear (setupSingleAgent's `oauth` is undefined). */
     oauthManagers: Map<string, OAuthTokenManager>;
-    /** FLAG-3: per-agent pi AuthStorage (piAuthStorage) → the memory.ask dialectic OAuth resolver's
+    /** Per-agent pi AuthStorage (piAuthStorage) → the memory.ask dialectic OAuth resolver's
      *  runtime-override target. Mirrors oauthManagers (every agent has one). */
     authStorages: Map<string, AuthStorage>;
     /** Session-scoped trajectory recorder registry. Daemon shutdown MUST call `closeAll()` to
@@ -86,6 +86,8 @@ export declare function setupAgents(deps: {
     memoryAdapter: SqliteMemoryAdapter;
     sessionStore: ReturnType<typeof createSessionStore>;
     agentLogger: ComisLogger;
+    /** The daemon package.json version → each agent's trace.metadata build stamp. */
+    daemonVersion?: string;
     /** When true, executor includes MEDIA: directive instructions in system prompt. */
     outboundMediaEnabled?: boolean;
     /** When true, executor system prompt includes attachment hint processing guidance.
@@ -113,18 +115,18 @@ export declare function setupAgents(deps: {
     /** Entity-associative store. Threaded into each per-agent createPiExecutor
      *  like memoryPort (the recall read path). Built in setup-memory on the shared db. */
     entityStore?: import("@comis/core").MemoryEntityStore;
-    /** LCD lossless context store (Phase 128). Threaded into each per-agent
+    /** LCD lossless context store. Threaded into each per-agent
      *  createPiExecutor like entityStore — as `contextStore` (the dag-mode assembly
      *  read path -> context-engine.ts `dag` branch). Built in setup-memory on the
      *  shared db (`createLcdStore(db)`); injected as the core `ContextStorePort` TYPE
      *  (agent↛memory cut). Opt-in (`contextEngine.version: "dag"`); default pipeline. */
     lcdStore?: import("@comis/core").ContextStorePort;
-    /** R1 (132-05): the daemon-owned per-tenant summarizer spend+breaker; threaded
+    /** The daemon-owned per-tenant summarizer spend+breaker; threaded
      *  into each per-agent createPiExecutor -> setupContextEngine (the getSummarizerDeps
      *  leaf-seam gate). ONE daemon instance, partitions by tenantId. */
     summarizerSpendBreaker?: import("@comis/agent").SummarizerSpendBreaker;
     spendAccumulator?: import("@comis/agent").SpendAccumulator;
-    /** Phase 213-08 (BUDGET-01/02): the late-bound per-root budget holder + rootRunId
+    /** The late-bound per-root budget holder + rootRunId
      *  resolver, forwarded into each SingleAgentDeps (every bridge holds the SAME
      *  holder, populated by the cap layer); absent ⇒ the per-root reserve is a no-op. */
     boundedAutonomyBudget?: import("@comis/agent").BoundedAutonomyBudgetHolder;
@@ -144,7 +146,7 @@ export declare function setupAgents(deps: {
     /** Pinned-memory store (the `MemoryPinnedStore` face of `memoryAdapter`). Threaded into
      *  each per-agent createPiExecutor so the recall pipeline's Step-0 pinned-first lane can fire.
      *  Without this the lane gate is always false and pinned memories are silently absent from every
-     *  agent response (R6 blocker). The same `SqliteMemoryAdapter` already passed as `memoryPort`
+     *  agent response (a blocking defect). The same `SqliteMemoryAdapter` already passed as `memoryPort`
      *  implements `MemoryPinnedStore`; the daemon supplies it here as the segregated port TYPE.
      *  Built in setup-memory on the shared db. */
     pinnedStore?: import("@comis/core").MemoryPinnedStore;
@@ -196,15 +198,15 @@ export declare function setupAgents(deps: {
      * block is a no-op.
      */
     obsStore?: import("@comis/memory").ObservabilityStore;
-    /** Ollama served context-window probe result from bootAgents (CWF-03).
+    /** Ollama served context-window probe result from bootAgents.
      *  Map from provider config key (e.g. "qwen36-local") to discovered num_ctx.
      *  Absent → probe not run or all failed; executors fall back to configured window. */
     servedWindowByProvider?: Map<string, number>;
-    /** KNOB-01/03: daemon-owned collector — one served-vs-configured comparison per
+    /** Daemon-owned collector — one served-vs-configured comparison per
      *  provider; daemon.ts derives servedBelowConfiguredCount from it at the posture
      *  write (one comparison, two surfaces — no drift). */
     servedWindowComparisons?: Map<string, import("@comis/agent").ServedWindowComparison>;
-    /** FLOOR-01: daemon-owned collector of per-agent boot window info (registry-mirrored
+    /** Daemon-owned collector of per-agent boot window info (registry-mirrored
      *  configured window + reconciled effective window + profile) — consumed by the
      *  daemon's viable-floor loop after setupTools. */
     agentBootWindowInfo?: Map<string, import("@comis/agent").AgentBootWindowInfo>;

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-registry.js

@@ -100,9 +100,9 @@ export async function setupAgents(deps) {
     // into ChannelsDeps.executionPlanPort. Same reference across ACP + chat
     // (Pitfall 1 single-shared-holder invariant).
     const executionPlanPorts = new Map();
-    // Per-agent OAuthTokenManager map (184) — see AgentsResult.oauthManagers.
+    // Per-agent OAuthTokenManager map — see AgentsResult.oauthManagers.
     const oauthManagers = new Map();
-    // FLAG-3: per-agent pi AuthStorage map — see AgentsResult.authStorages.
+    // Per-agent pi AuthStorage map — see AgentsResult.authStorages.
     const authStorages = new Map();
     // Resolve sub-agent tool names from config for delegation awareness
     const subAgentToolGroups = container.config.security?.agentToAgent?.subAgentToolGroups ?? [];
@@ -180,6 +180,7 @@ export async function setupAgents(deps) {
     // Construct shared deps struct once before the loop (for hot-add reuse)
     const singleAgentDeps = {
         container,
+        ...(deps.daemonVersion !== undefined ? { appVersion: deps.daemonVersion } : {}),
         memoryAdapter,
         sessionStore,
         agentLogger,
@@ -201,7 +202,7 @@ export async function setupAgents(deps) {
         entityStore: deps.entityStore,
         lcdStore: deps.lcdStore,
         summarizerSpendBreaker: deps.summarizerSpendBreaker, spendAccumulator: deps.spendAccumulator,
-        // Phase 213-08 (BUDGET-01/02): forward the per-root budget holder + resolver per-agent (daemon-wide REF; absent ⇒ no-op).
+        // Forward the per-root budget holder + resolver per-agent (daemon-wide REF; absent ⇒ no-op).
         ...(deps.boundedAutonomyBudget ? { boundedAutonomyBudget: deps.boundedAutonomyBudget } : {}),
         ...(deps.resolveRootRunId ? { resolveRootRunId: deps.resolveRootRunId } : {}),
         temporalStore: deps.temporalStore,
@@ -239,9 +240,9 @@ export async function setupAgents(deps) {
         // Session-scoped trajectory recorder registry — threaded into every
         // per-agent executor so the same registry is shared across agents.
         trajectoryRegistry,
-        // CWF-03: Ollama served-window probe result from bootAgents.
+        // Ollama served-window probe result from bootAgents.
         servedWindowByProvider: deps.servedWindowByProvider,
-        // KNOB-01/03 + FLOOR-01: the daemon-owned boot-honesty collector maps —
+        // The daemon-owned boot-honesty collector maps —
         // populated per-agent in setupSingleAgent beside the pi ModelRegistry.
         servedWindowComparisons: deps.servedWindowComparisons,
         agentBootWindowInfo: deps.agentBootWindowInfo,
@@ -265,9 +266,9 @@ export async function setupAgents(deps) {
         toolCapabilityPorts.set(agentId, result.toolCapabilityPort);
         executionPlanPorts.set(agentId, result.executionPlanPort);
         if (result.oauth)
-            oauthManagers.set(agentId, result.oauth); // 184: per-agent OAuth manager (when present)
+            oauthManagers.set(agentId, result.oauth); // per-agent OAuth manager (when present)
         if (result.authStorage)
-            authStorages.set(agentId, result.authStorage); // FLAG-3: per-agent pi AuthStorage
+            authStorages.set(agentId, result.authStorage); // per-agent pi AuthStorage
     }
     const defaultAgentId = routingConfig.defaultAgentId;
     const defaultWorkspaceDir = workspaceDirs.get(defaultAgentId);
@@ -327,8 +328,8 @@ export async function setupAgents(deps) {
         // daemon threads the DEFAULT agent's holder into ChannelsDeps so the
         // chat plan-stream reads from the SAME object SEP publishes into.
         executionPlanPorts,
-        oauthManagers, // 184: per-agent OAuth managers → buildImageGenBundle (Codex image adapter)
-        authStorages, // FLAG-3: per-agent pi AuthStorage → memory.ask dialectic OAuth resolver
+        oauthManagers, // per-agent OAuth managers → buildImageGenBundle (Codex image adapter)
+        authStorages, // per-agent pi AuthStorage → memory.ask dialectic OAuth resolver
     };
 }
 // OAuth credential store selection: @comis/agent/src/model/oauth-credential-store-selector.ts

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-runtime.js

@@ -175,11 +175,11 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
     // descriptions resolved" INFO; channelType resolution deferred to runtime).
     // Resolved BEFORE the boot-window block so convertTools can ride into it.
     const resolvedDescriptions = resolveLeanDescriptionsForAgent(agentConfig, perAgentLogger);
-    // WR-03 (176 review): the ONE tool-conversion closure for BOTH consumers — PiExecutorDeps.convertTools
-    // (turn-time S corpus) AND AgentBootWindowInfo's (FLOOR-01 boot corpus). Single reference below = corpus-identity pin.
+    // The ONE tool-conversion closure for BOTH consumers — PiExecutorDeps.convertTools
+    // (turn-time S corpus) AND AgentBootWindowInfo's (boot corpus). Single reference below = corpus-identity pin.
     const convertTools = buildSharedConvertTools(resolvedDescriptions);
-    // KNOB-01 + FLOOR-01 (v2.21): extracted to setup-agents-boot-window.ts (600-line cap split, 177 wave 1).
-    // Fail-open inside; convertTools reference identity preserved (WR-03).
+    // Extracted to setup-agents-boot-window.ts (600-line file cap split).
+    // Fail-open inside; convertTools reference identity preserved.
     runBootWindowHonestyChecks({
         agentId,
         providerId: resolved.provider,
@@ -199,7 +199,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
         lockDir,
         cwd: dir,
         // Resolved daemon data dir: without it the session-index writer falls back
-        // to the REAL ~/.comis, diverging from COMIS_DATA_DIR installs (260611 live-fire).
+        // to the REAL ~/.comis, diverging from COMIS_DATA_DIR installs.
         dataDir: dataDirAbs,
         // Same FileLockPort instance the OAuth path uses — single proper-lockfile
         // adapter per daemon process.
@@ -233,7 +233,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
     // Resolve discovery paths + force-include the two daemon-controlled dirs (workspace skills,
     // prepended; the bundled-skill install target <dataDir>/skills, appended). The latter keeps the
     // daemon's bundled prompt skills (claude-code, codex, …) discoverable even when a CUSTOM
-    // `discoveryPaths` replaces the default `./skills` (webhook-claude-cli-tdd-20260630-rerun).
+    // `discoveryPaths` replaces the default `./skills`.
     const resolvedPaths = resolveSkillDiscoveryPaths(skillsConfig.discoveryPaths, dataDir, agentSkillsDir);
     const resolvedSkillsConfig = {
         ...skillsConfig,
@@ -241,8 +241,8 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
     };
     const skillRegistry = createSkillRegistry(resolvedSkillsConfig, container.eventBus, { agentId, tenantId: container.config.tenantId, userId: "system" }, perAgentLogger, eligibilityContext);
     skillRegistry.init();
-    // SURFACE-01/03 (v2.26): per-agent cache of promoted read-only learned procedures, refreshed out-of-band (the sync seam reads `.current`). WR-03: gated on learning.enabled × the master cost switch (memory.enabled, renamed in Phase 226) so default-OFF does ZERO surface work (no list()/rmSync) and stays byte-identical; WR-01: registers its refresh so the promote/demote loop re-refreshes it (next-session pickup).
-    const learnedSurface = wireAgentLearnedSkillSurface({ enabled: container.config.memory?.enabled !== false && effectiveConfig.learning?.enabled === true, agentId, learnedSkillStore: deps.learnedSkillStore, scope: { tenantId: container.config.tenantId, agentId }, workspaceDir: dir, logger: perAgentLogger, registry: deps.learnedSkillSurfaceRegistry });
+    // Per-agent cache of promoted read-only learned procedures, refreshed out-of-band (the sync seam reads `.current`). Gated on learning.enabled × the master cost switch (memory.enabled) so default-OFF does ZERO surface work (no list()/rmSync) and stays byte-identical; registers its refresh so the promote/demote loop re-refreshes it (next-session pickup).
+    const learnedSurface = wireAgentLearnedSkillSurface({ enabled: container.config.memory?.enabled !== false && effectiveConfig.learning?.enabled === true, agentId, learnedSkillStore: deps.learnedSkillStore, scope: { tenantId: container.config.tenantId, agentId }, workspaceDir: dir, logger: perAgentLogger, registry: deps.learnedSkillSurfaceRegistry, maxProcedureDocsSurfaced: effectiveConfig.learning?.reflect?.maxProcedureDocsSurfaced });
     // Per-agent ToolCapabilityPort adapter. Construction sits here so the adapter can close
     // over this agent's skillRegistry; reused by pi-executor (capability-index renderer) AND
     // by exec/process tools (install-detour parser via setupTools.getCapabilityPortForAgent).
@@ -289,7 +289,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
     // Uses default config: mediumThreshold=0.4, highThreshold=0.7, action="warn"
     // Operator can override via agent config in the future
     // (resolvedDescriptions + the shared convertTools closure are created above,
-    // before the boot-window honesty block — WR-03.)
+    // before the boot-window honesty block.)
     // Tool pipeline for PiExecutor. Platform tools (memory, cron, messaging, sessions) come
     // per-request via executor.execute(msg, sessionKey, tools) -- assembled by setupTools (runs
     // after setupAgents). The convertTools callback converts per-request AgentTool[] to
@@ -320,14 +320,15 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
         executionPlanHolder,
         lastKnownModel: deps.lastKnownModel,
         budgetGuard,
-        costTracker, spendAccumulator: deps.spendAccumulator, spendConfig: container.config.observability.spend, // Phase 177 kill-switch: daemon-wide accumulator REF (Pitfall 4 — same instance every bridge) + config; absent ⇒ no-op.
-        // Phase 213-08 (BUDGET-01/02): per-root budget holder + rootRunId resolver (same daemon-wide-REF pattern as spendAccumulator; absent ⇒ no-op).
+        costTracker, spendAccumulator: deps.spendAccumulator, spendConfig: container.config.observability.spend, // the spend kill-switch: daemon-wide accumulator REF (Pitfall 4 — same instance every bridge) + config; absent ⇒ no-op.
+        // Per-root budget holder + rootRunId resolver (same daemon-wide-REF pattern as spendAccumulator; absent ⇒ no-op).
         ...(deps.boundedAutonomyBudget && deps.resolveRootRunId
             ? { boundedAutonomyBudget: deps.boundedAutonomyBudget, resolveRootRunId: deps.resolveRootRunId }
             : {}),
         stepCounter,
         eventBus: container.eventBus,
         logger: perAgentLogger,
+        ...(deps.appVersion !== undefined ? { appVersion: deps.appVersion } : {}),
         authStorage: piAuthStorage,
         // Thread OAuthTokenManager into the executor so the per-LLM-call
         // dispatch hook (PiExecutor.execute pre-hook + the two compaction
@@ -341,21 +342,21 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
         sessionAdapter,
         workspaceDir: dir,
         // Resolved daemon data dir → PiExecutorDeps.dataDir → the pi-event-bridge
-        // session-index writer (else it falls back to the REAL ~/.comis — 260611
-        // live-fire) + prompt-assembly's recall-trace containment base.
+        // session-index writer (else it falls back to the REAL ~/.comis) +
+        // prompt-assembly's recall-trace containment base.
         dataDir: dataDirAbs,
         agentDir: resolvedAgentDir,
         customTools: [],
-        // WR-03: the SAME closure bound into AgentBootWindowInfo.convertTools above
+        // The SAME closure bound into AgentBootWindowInfo.convertTools above
         // (corpus-identity pin — see the shared const's comment).
         convertTools,
         subAgentToolNames: deps.subAgentToolNames,
         mcpToolsInherited: deps.mcpToolsInherited,
         memoryPort: memoryAdapter,
         reranker: deps.rerankerPort, // Cross-encoder reranker (built in setup-memory only when an agent enables rerank).
-        entityStore: deps.entityStore, temporalStore: deps.temporalStore, causalStore: deps.causalStore, tripleStore: deps.tripleStore, embeddingStore: deps.embeddingStore, usefulnessStore: deps.usefulnessStore, pinnedStore: deps.pinnedStore, provenanceStore: deps.provenanceStore, mentalModelStore: deps.learnedSkillStore, // rag.entityLane + rag.lanes.temporal + rag.lanes.causal + rag.lanes.graphSpread + rag.mmr + rag.feedback + rag.pinned (R6 — the pinned-first lane; pinnedStore is the same memoryAdapter cast as MemoryPinnedStore) + DIST-03 provenance down-weighting (Phase 173; provenanceStore is the LcdProvenanceReadStore from buildProvenanceReadStore — the built-but-not-wired carry-in activation) + mentalModelStore is the v2.31 kind:"profile" read source for the rewired <user_profile> block (FOLD-01, Phase 225 — the standalone userRepresentationStore was deleted in Plan 05; the SAME MentalModelStorePort already wired for the learned-skill surface). (The socialModeling standing-block + its relationshipStore read were DELETED in Phase 226-04 with the rest of that subsystem; rag.onlineTuning's tuned-vector read was deleted in Phase 224.)
-        contextStore: deps.lcdStore, // Phase 128 LCD store (ContextStorePort) -> PiExecutorDeps.contextStore -> setupContextEngine -> the `dag` branch (context-engine.ts). The daemon-injected CONCRETE createLcdStore; the agent sees only the core port TYPE (agent↛memory cut). Opt-in (version: "dag"); default stays pipeline. Absent ⇒ pipeline fallback.
-        summarizerSpendBreaker: deps.summarizerSpendBreaker, // R1 (132-05): the daemon-owned per-tenant summarizer spend+breaker -> PiExecutorDeps.summarizerSpendBreaker -> setupContextEngine (getSummarizerDeps wraps the leaf seam with gate(tenantId, inner) → truncation-only degrade on open-breaker/over-cap). ONE daemon instance, partitions by tenantId.
+        entityStore: deps.entityStore, temporalStore: deps.temporalStore, causalStore: deps.causalStore, tripleStore: deps.tripleStore, embeddingStore: deps.embeddingStore, usefulnessStore: deps.usefulnessStore, pinnedStore: deps.pinnedStore, provenanceStore: deps.provenanceStore, mentalModelStore: deps.learnedSkillStore, // rag.entityLane + rag.lanes.temporal + rag.lanes.causal + rag.lanes.graphSpread + rag.mmr + rag.feedback + rag.pinned (the pinned-first lane; pinnedStore is the same memoryAdapter cast as MemoryPinnedStore) + provenance down-weighting (provenanceStore is the LcdProvenanceReadStore from buildProvenanceReadStore) + mentalModelStore is the kind:"profile" read source for the <user_profile> block (the SAME MentalModelStorePort already wired for the learned-skill surface).
+        contextStore: deps.lcdStore, // LCD store (ContextStorePort) -> PiExecutorDeps.contextStore -> setupContextEngine -> the `dag` branch (context-engine.ts). The daemon-injected CONCRETE createLcdStore; the agent sees only the core port TYPE (agent↛memory cut). Opt-in (version: "dag"); default stays pipeline. Absent ⇒ pipeline fallback.
+        summarizerSpendBreaker: deps.summarizerSpendBreaker, // the daemon-owned per-tenant summarizer spend+breaker -> PiExecutorDeps.summarizerSpendBreaker -> setupContextEngine (getSummarizerDeps wraps the leaf seam with gate(tenantId, inner) → truncation-only degrade on open-breaker/over-cap). ONE daemon instance, partitions by tenantId.
         secretManager: scopedManager,
         envelopeConfig: container.config.envelope,
         senderTrustDisplayConfig: container.config.senderTrustDisplay,
@@ -446,7 +447,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
         fastMode: effectiveConfig.fastMode,
         storeCompletions: effectiveConfig.storeCompletions,
         providerCapabilities: container.config.providers?.entries?.[resolved.provider]?.capabilities,
-        // CWF-03 + WR-02: the probed Ollama served window, PAIRED with the provider
+        // The probed Ollama served window, PAIRED with the provider
         // key it was probed from so the executor's reconcile can gate the clamp
         // per-execution (override models on other providers keep their full window
         // and never get "Ollama serves only N" attribution).
@@ -455,7 +456,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
             return probed !== undefined ? { providerKey: resolved.provider, window: probed } : undefined;
         })(),
         // Resolver form (config is runtime-mutable / per-exec variable): providers
-        // switch mid-agent (GBNF-01, WR-04) + authoring flips via config.write. getGbnfConstrain off-default ⇒ FLAGS-OFF identical (CR-01).
+        // switch mid-agent + authoring flips via config.write. getGbnfConstrain off-default ⇒ FLAGS-OFF identical.
         getProviderType: (p) => container.config.providers?.entries?.[p]?.type,
         getModelCompat: (p, id) => container.config.providers?.entries?.[p]?.models?.find((m) => m.id === id)?.comisCompat,
         getGbnfConstrain: () => container.config.orchestration?.authoring?.gbnfConstrain ?? false,
@@ -487,7 +488,7 @@ export async function setupSingleAgent(agentId, agentConfigInput, deps, rawReran
         skillRegistry,
         toolCapabilityPort,
         executionPlanPort: executionPlanHolder, // SAME ref as PiExecutorDeps + AcpServerDeps (Pitfall 1).
-        oauth: authProvider.oauth, // 184: SAME manager consumed at :439 — surfaced for the Codex image path (no 2nd instance)
-        authStorage: piAuthStorage, // FLAG-3: the runtime-override target for the memory.ask dialectic OAuth credential resolver
+        oauth: authProvider.oauth, // SAME manager consumed at :439 — surfaced for the Codex image path (no 2nd instance)
+        authStorage: piAuthStorage, // the runtime-override target for the memory.ask dialectic OAuth credential resolver
     };
 }

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-tooling.d.ts

@@ -39,11 +39,10 @@ export declare function resolveAgentModel(agentConfig: {
     provider: string;
 };
 /**
- * Resolve an agent's MAIN provider id in lockstep with the completion path
- * (RES-01 / I4) — the handler-side accessor for provider-following image
- * generation (Phase 183). Delegates to the EXACT completion-path
- * `resolveAgentModel`, so the id it returns is the same one the completion
- * runner resolves for the agent.
+ * Resolve an agent's MAIN provider id in lockstep with the completion path —
+ * the handler-side accessor for provider-following image generation. Delegates
+ * to the EXACT completion-path `resolveAgentModel`, so the id it returns is the
+ * same one the completion runner resolves for the agent.
  *
  * Fallback is the operator-configurable `defaultAgentId` — NOT the literal
  * string `"default"`. A deployment's default agent may be renamed (CLAUDE.md
@@ -56,7 +55,7 @@ export declare function resolveAgentModel(agentConfig: {
  * misconfigured deployment), this returns an honest sentinel
  * `{ providerId: "unknown" }` rather than throwing — `"unknown"` has no
  * `IMAGE_CAPABILITY` entry, so downstream resolution surfaces the honest
- * RES-03 unavailable path (with the knob-naming hint) instead of crashing the
+ * unavailable path (with the knob-naming hint) instead of crashing the
  * RPC handler.
  */
 export declare function resolveAgentMainProvider(agents: Record<string, {

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-tooling.js

@@ -11,7 +11,7 @@
  * @module
  */
 import { createHmac } from "node:crypto";
-import { getModels, getProviders } from "@earendil-works/pi-ai";
+import { getModels, getProviders } from "@earendil-works/pi-ai/compat";
 import { resolveOperationDefaults } from "@comis/agent";
 import { TOOL_PROFILES } from "@comis/skills";
 /**
@@ -80,11 +80,10 @@ export function resolveAgentModel(agentConfig, modelsConfig) {
     return { model, provider };
 }
 /**
- * Resolve an agent's MAIN provider id in lockstep with the completion path
- * (RES-01 / I4) — the handler-side accessor for provider-following image
- * generation (Phase 183). Delegates to the EXACT completion-path
- * `resolveAgentModel`, so the id it returns is the same one the completion
- * runner resolves for the agent.
+ * Resolve an agent's MAIN provider id in lockstep with the completion path —
+ * the handler-side accessor for provider-following image generation. Delegates
+ * to the EXACT completion-path `resolveAgentModel`, so the id it returns is the
+ * same one the completion runner resolves for the agent.
  *
  * Fallback is the operator-configurable `defaultAgentId` — NOT the literal
  * string `"default"`. A deployment's default agent may be renamed (CLAUDE.md
@@ -97,7 +96,7 @@ export function resolveAgentModel(agentConfig, modelsConfig) {
  * misconfigured deployment), this returns an honest sentinel
  * `{ providerId: "unknown" }` rather than throwing — `"unknown"` has no
  * `IMAGE_CAPABILITY` entry, so downstream resolution surfaces the honest
- * RES-03 unavailable path (with the knob-naming hint) instead of crashing the
+ * unavailable path (with the knob-naming hint) instead of crashing the
  * RPC handler.
  */
 export function resolveAgentMainProvider(agents, modelsConfig, agentId, defaultAgentId) {

package/node_modules/@comis/daemon/dist/wiring/setup-agents/setup-agents-types.d.ts

@@ -19,6 +19,9 @@ type PiSessionAdapter = ReturnType<typeof createComisSessionManager>;
  *  the struct in a closure for hot-add without re-deriving deps. */
 export interface SingleAgentDeps {
     container: AppContainer;
+    /** The daemon package.json version, threaded into createPiExecutor as
+     *  appVersion so trace.metadata records which build produced the session. */
+    appVersion?: string;
     memoryAdapter: SqliteMemoryAdapter;
     sessionStore: ReturnType<typeof createSessionStore>;
     agentLogger: ComisLogger;
@@ -55,7 +58,7 @@ export interface SingleAgentDeps {
      *  shared db handle; the entity lane stays dormant until an operator enables
      *  `agents.<id>.rag.entityLane.enabled` (default OFF). */
     entityStore?: import("@comis/core").MemoryEntityStore;
-    /** LCD lossless context store (Phase 128 dag-mode write-path + assembly).
+    /** LCD lossless context store (dag-mode write-path + assembly).
      *  Threaded into each per-agent createPiExecutor as `contextStore` (the
      *  PiExecutorDeps.contextStore landing site) — flows on to setupContextEngine
      *  -> the `dag` branch in context-engine.ts. Built in setup-memory on the shared
@@ -64,18 +67,18 @@ export interface SingleAgentDeps {
      *  @comis/memory). Absent ⇒ the `dag` branch falls back to pipeline. The `dag`
      *  engine is opt-in (`contextEngine.version: "dag"`); the default stays pipeline. */
     lcdStore?: import("@comis/core").ContextStorePort;
-    /** R1 (132-05): the daemon-owned per-tenant summarizer spend+breaker. Threaded
+    /** The daemon-owned per-tenant summarizer spend+breaker. Threaded
      *  into each per-agent createPiExecutor (PiExecutorDeps.summarizerSpendBreaker)
      *  -> setupContextEngine so getSummarizerDeps gates the leaf seam per tenant.
      *  ONE daemon instance partitions by tenantId (aggregate per-tenant spend across
      *  sessions/agents); absent ⇒ the raw seam. */
     summarizerSpendBreaker?: import("@comis/agent").SummarizerSpendBreaker;
-    /** Phase 177: the single daemon-wide spend accumulator (the dollars
+    /** The single daemon-wide spend accumulator (the dollars
      *  kill-switch). ONE instance (constructed in setupObservability); threaded
      *  into each per-agent createPiExecutor so every bridge holds the SAME
      *  reference (Pitfall 4). Absent ⇒ the bridge's spend path is a no-op. */
     spendAccumulator?: import("@comis/agent").SpendAccumulator;
-    /** Phase 213-08 (BUDGET-01/02): the late-bound per-root budget holder + the
+    /** The late-bound per-root budget holder + the
      *  run's rootRunId resolver. ONE daemon-wide holder created early (before
      *  setupAgents) and populated by the cap layer after construction (the
      *  onCronWake late-bind pattern); threaded into each per-agent createPiExecutor
@@ -114,28 +117,27 @@ export interface SingleAgentDeps {
      *  Supplied HERE as the segregated `MemoryPinnedStore` port so each per-agent
      *  createPiExecutor can inject it into createMemoryRecall's Step-0 pinned-first lane.
      *  Without this field, the lane gate (`cfg_pinned?.enabled === true && deps.pinnedStore !== undefined`)
-     *  is always false and pinned memories are silently absent from every recall result (R6 blocker).
+     *  is always false and pinned memories are silently absent from every recall result (a blocking defect).
      *  DEFAULT-OFF BYTE-IDENTITY: with `rag.pinned.enabled=false` (the default), no pinnedStore
      *  query runs even when the store is injected. The segregated port TYPE is from @comis/core
      *  (the agent↛memory cut) — the agent package never imports @comis/memory. */
     pinnedStore?: import("@comis/core").MemoryPinnedStore;
-    /** LCD provenance READ store (Phase 173, DIST-03 read side). Supplied to each
+    /** LCD provenance READ store (read side). Supplied to each
      *  per-agent createPiExecutor so createMemoryRecall's post-fusion provenance
-     *  down-weighting pass fires (gate `deps.provenanceStore != null`) — it was BUILT
-     *  but never injected in Phase 172 (the built-but-not-wired class the milestone
-     *  hit 3×). Byte-identical no-op when absent OR when no lcd_distilled result is
+     *  down-weighting pass fires (gate `deps.provenanceStore != null`).
+     *  Byte-identical no-op when absent OR when no lcd_distilled result is
      *  present. The core LcdProvenanceReadStore TYPE only (the agent↛memory cut). */
     provenanceStore?: import("@comis/core").LcdProvenanceReadStore;
-    /** Learned-skill store (v2.26 SURFACE-01/03). Threaded into setupSingleAgent so the
+    /** Learned-skill store. Threaded into setupSingleAgent so the
      *  `getPromptSkillsXml` seam can surface promoted read-only learned procedures
      *  (append-after-platform, materialized read-only). The segregated `MentalModelStorePort`
      *  TYPE from @comis/core (the agent↛memory cut); the daemon injects the concrete
      *  @comis/memory adapter. Default-OFF byte-identity: absent ⇒ the listing is the
      *  platform-only snapshot, unchanged. */
     learnedSkillStore?: import("@comis/core").MentalModelStorePort;
-    /** WR-01: the shared per-agent learned-skill SURFACE registry. setupSingleAgent
+    /** The shared per-agent learned-skill SURFACE registry. setupSingleAgent
      *  registers this agent's surface refresh closure into it (only when learningSkills
-     *  is enabled — WR-03); the resolve-seam promote/demote loop (wireLearningOutcome,
+     *  is enabled); the resolve-seam promote/demote loop (wireLearningOutcome,
      *  wired earlier in setup-memory) calls `refresh(agentId)` on it after a real
      *  transition so the next session sees the new active set. Absent ⇒ no re-refresh. */
     learnedSkillSurfaceRegistry?: import("./learned-skill-surface-registry.js").LearnedSkillSurfaceRegistry;
@@ -219,15 +221,15 @@ export interface SingleAgentDeps {
      * drain open recorders.
      */
     trajectoryRegistry: import("@comis/observability").SessionTrajectoryHandleRegistry;
-    /** Ollama served context-window probe result from bootAgents (CWF-03).
+    /** Ollama served context-window probe result from bootAgents.
      *  Map from provider config key (e.g. "qwen36-local") to discovered num_ctx.
      *  Absent → probe not run or all failed; executors fall back to configured window. */
     servedWindowByProvider?: Map<string, number>;
-    /** KNOB-01/03: daemon-owned collector — one served-vs-configured comparison per
+    /** Daemon-owned collector — one served-vs-configured comparison per
      *  provider; daemon.ts derives servedBelowConfiguredCount from it at the posture
      *  write (one comparison, two surfaces — no drift). */
     servedWindowComparisons?: Map<string, import("@comis/agent").ServedWindowComparison>;
-    /** FLOOR-01: daemon-owned collector of per-agent boot window info (registry-mirrored
+    /** Daemon-owned collector of per-agent boot window info (registry-mirrored
      *  configured window + reconciled effective window + profile) — consumed by the
      *  daemon's viable-floor loop after setupTools. */
     agentBootWindowInfo?: Map<string, import("@comis/agent").AgentBootWindowInfo>;
@@ -258,7 +260,7 @@ export interface SingleAgentResult {
      */
     executionPlanPort: ExecutionPlanPort;
     /**
-     * Per-agent OAuthTokenManager (184). The SAME instance consumed for the
+     * Per-agent OAuthTokenManager. The SAME instance consumed for the
      * executor's OAuth resolution — surfaced so the registry collects it into
      * AgentsResult.oauthManagers and the image path can resolve the Codex bearer
      * through the agent's exact manager (no second instance). Undefined when the
@@ -266,7 +268,7 @@ export interface SingleAgentResult {
      */
     oauth?: OAuthTokenManager;
     /**
-     * FLAG-3: the per-agent pi AuthStorage (piAuthStorage). The SAME instance the executor's
+     * The per-agent pi AuthStorage (piAuthStorage). The SAME instance the executor's
      * model auth uses — surfaced so the registry collects it into AgentsResult.authStorages and the
      * memory.ask dialectic OAuth resolver can call resolveProviderApiKey → authStorage.setRuntimeApiKey
      * (the runtime-override the dialectic's pi model reads). Always present (every runtime builds one).

package/node_modules/@comis/daemon/dist/wiring/setup-agents/skill-discovery-paths.js

@@ -14,8 +14,8 @@
  * `discoveryPaths` (e.g. `["/srv/team-skills"]`) REPLACES that default, silently dropping the
  * daemon's own bundled prompt skills: they're seeded on disk but never discovered, so a
  * description-matched skill like `claude-code` never surfaces into `<available_skills>` and the agent
- * can't follow it (webhook-claude-cli-tdd-20260630-rerun: a leftover `discoveryPaths:[<sim-dir>]`
- * from a prior run hid claude-code/codex/gsd-builder/skill-creator entirely). Force-including the
+ * can't follow it (a leftover `discoveryPaths:[<custom-dir>]` from a prior run can
+ * hide claude-code/codex/gsd-builder/skill-creator entirely). Force-including the
  * install target makes the bundled skills robust to any `discoveryPaths` override, mirroring how the
  * per-agent workspace dir is always prepended.
  *

package/node_modules/@comis/daemon/dist/wiring/setup-audio-provider.d.ts

@@ -1,6 +1,6 @@
 /**
- * Audio-provider SELECTION (RES-01/02/04/05, STEER-01/02, CRED-01) — the daemon
- * selector that threads the Plan-01 pure resolvers
+ * Audio-provider SELECTION — the daemon
+ * selector that threads the pure resolvers
  * (`resolveTranscriptionProvider`/`resolveTtsProvider`) + the injected
  * `audioKeyAvailable` closure (a lookup over `SecretManager`) + the
  * `localEngineAvailable`/`edgeAvailable` seams, and returns the discriminated
@@ -14,7 +14,7 @@
  * → 401 is NEVER reached for a Codex/OAuth-only (or any keyless) main. This is
  * THE headline keyless-first / OAuth-steering fix.
  *
- * Purity by injection (the RES-01 keystone): the resolver stays pure; the daemon
+ * Purity by injection is the keystone: the resolver stays pure; the daemon
  * supplies `audioKeyAvailable` as a closure over `SecretManager` (NOT process.env —
  * the globals gate; setup-media/main-helpers are not sanctioned process.env roots).
  * There is NO codex branch in the predicate — `MAIN_PROVIDER_AUDIO["openai-codex"]`
@@ -23,7 +23,7 @@
  * Placement: `@comis/daemon`. Kept in a dedicated file (NOT folded into
  * setup-media.ts) so the skills-only setup-media module gains no `@comis/core`
  * media-resolver import edge — mirroring `setup-image-provider.ts`'s rationale.
- * `localEngineAvailable` is the Phase 194 seam — `buildAudioResolverDeps` now runs
+ * `localEngineAvailable` is the local-engine seam — `buildAudioResolverDeps` runs
  * the one-shot `detectLocalSttEngine` boot probe and passes the captured boolean
  * (a reachable `transcription.local.baseUrl` OR the importable in-process whisper
  * engine + ffmpeg). `edgeAvailable` is the keyless TTS rung (the daemon passes
@@ -66,11 +66,11 @@ export declare function createAudioProviderSelector(deps: {
     transcriptionConfig: AudioSttConfig;
     ttsConfig: AudioTtsConfig;
     secretManager: SecretManager;
-    /** Resolved at boot for the DEFAULT agent (the common case for Phase 193). */
+    /** Resolved at boot for the DEFAULT agent (the common case). */
     mainProviderId: string;
     /**
-     * The Phase 194 seam: TRUE once the local whisper engine is wired. FALSE in
-     * 193, so `auto` STT honest-degrades to unavailable (no engine yet).
+     * The local-engine seam: TRUE once the local whisper engine is wired. When
+     * FALSE, `auto` STT honest-degrades to unavailable (no engine yet).
      */
     localEngineAvailable?: () => boolean;
     /**
@@ -82,13 +82,13 @@ export declare function createAudioProviderSelector(deps: {
     /**
      * The injected key-presence predicate (purity keystone). When omitted the
      * selector builds the default `SecretManager`-backed closure below. There is
-     * NO codex branch — codex has no audio env key (Pattern 3 / Pitfall 2).
+     * NO codex branch — codex has no audio env key.
      */
     audioKeyAvailable?: (provider: string) => boolean;
 }): {
     resolveStt: () => ReturnType<typeof resolveTranscriptionProvider>;
     resolveTts: () => ReturnType<typeof resolveTtsProvider>;
-    /** OBS-03 (196): the skip reasons collected during the LAST `resolveStt()` /
+    /** The skip reasons collected during the LAST `resolveStt()` /
      *  `resolveTts()` call (the same closed rung-list the logging closures emit).
      *  The boot caller (`setupMedia`) reads these AFTER resolving and threads them
      *  onto the handler's `media.stt.requested`/`media.tts.requested` trajectory
@@ -98,23 +98,23 @@ export declare function createAudioProviderSelector(deps: {
     ttsSkips: () => string[];
 };
 /**
- * Boot-composition shim (Phase 193 + 194): build the keyless-first audio selector
+ * Boot-composition shim: build the keyless-first audio selector
  * from the boot container + the DEFAULT agent id, resolving `mainProviderId` via
  * the SAME `resolveAgentMainProvider` accessor the image/video/vision paths use
- * (I4 lockstep). Extracted here (NOT inlined in daemon.ts) so the composition root
+ * (lockstep). Extracted here (NOT inlined in daemon.ts) so the composition root
  * stays under its 3000-line cap — the daemon `await`s this once at boot and threads
  * the result into setupMedia.
  *
- * Phase 194 (LOCAL-02/03): this runs the one-shot `detectLocalSttEngine` boot probe
+ * This runs the one-shot `detectLocalSttEngine` boot probe
  * ONCE (mirroring `detectFfmpeg` — never throws, never downloads a model), logs
  * availability exactly once at INFO (`step: stt_local_probe`), and CAPTURES the
  * boolean as the synchronous `localEngineAvailable: () => probe.available` predicate
  * the pure resolver consumes (Pitfall 4 — NO per-resolution I/O). The probe is true
  * when a configured `transcription.local.baseUrl` server is reachable OR the
  * in-process whisper engine is importable AND ffmpeg is present; otherwise the
- * `auto`/`local` STT rung honest-degrades to unavailable (the Phase-193 behavior).
+ * `auto`/`local` STT rung honest-degrades to unavailable.
  * A local server that comes up AFTER boot needs a daemon restart to be picked up
- * (the boolean is captured once; Open Question Q3 — acceptable). The
+ * (the boolean is captured once — acceptable). The
  * audio-wiring-guard pins the real probe + the absence of the hardcoded `() => false`.
  *
  * `detectEngine` is an injected test seam (defaults to the real