@pellux/goodvibes-sdk 0.37.2 → 1.0.0

package/dist/platform/agents/orchestrator-runner.js

@@ -13,8 +13,10 @@ import { ConsecutiveErrorBreaker } from '../core/circuit-breaker.js';
 import { isRateLimitOrQuotaError, isContextSizeExceededError, isNetworkTransportError } from '../types/errors.js';
 import { AgentSession } from './session.js';
 import { estimateTokens, estimateConversationTokens, compactSmallWindow, } from '../core/context-compaction.js';
+import { emitCommunicationConsumed } from '../runtime/emitters/index.js';
 import { summarizeToolArgs } from './orchestrator-utils.js';
 import { buildLayeredOrchestratorSystemPrompt, buildOrchestratorSystemPrompt } from './orchestrator-prompts.js';
+import { buildPerTurnKnowledgeInjection, defaultTurnKnowledgeBudgetTokens, recordTurnInjection, DEFAULT_TURN_KNOWLEDGE_RELEVANCE_FLOOR, } from './turn-knowledge-injection.js';
 import { summarizeError } from '../utils/error-display.js';
 import { resolveScopedDirectory } from '../runtime/surface-root.js';
 import { appendGoodVibesRuntimeAwarenessPrompt } from '../tools/goodvibes-runtime/index.js';
@@ -133,8 +135,16 @@ async function executeToolCalls(toolCalls, toolRegistry, session, turn, record,
         }
         const callSig = `${call.name}::${JSON.stringify(call.arguments)}`;
         try {
-            const result = await toolRegistry.execute(call.id, call.name, call.arguments);
+            const signal = context.getCancellationSignal?.(record.id);
+            const result = await toolRegistry.execute(call.id, call.name, call.arguments, signal ? { signal } : undefined);
             results.push({ ...result, callId: call.id });
+            // Stage B: schedule a debounced reindex of any touched file(s). Never awaited.
+            try {
+                context.onToolExecuted?.(call.name, call.arguments, result.success !== false);
+            }
+            catch (hookErr) {
+                logger.warn('onToolExecuted hook error', { tool: call.name, error: summarizeError(hookErr) });
+            }
             session.appendMessage({
                 type: 'tool_execution',
                 turn,
@@ -291,7 +301,23 @@ export async function runAgentTask(context, record) {
             : 0;
         conversation = new ConversationManager();
         conversation.addUserMessage(record.task);
+        // Wave-3 Part C6 bridge: hand AgentManager a live accessor onto THIS
+        // ConversationManager instance so a fleet tab can render a full-fidelity
+        // transcript while the agent runs. `activeConversation` is a separate
+        // const (rather than closing over the outer `let conversation`) so the
+        // closure's type is non-nullable without a runtime assertion.
+        const activeConversation = conversation;
+        context.registerConversationSource?.(record.id, () => activeConversation.getMessageSnapshot());
         let systemPrompt = buildOrchestratorSystemPrompt(record, undefined, context);
+        // Wave-5 (wo801, W5.1) per-turn passive-injection state. `knowledgeIdsAlreadySurfaced`
+        // seeds from the spawn-time baseline (record.knowledgeInjections, just populated by the
+        // call above) and grows with every id a later turn injects, so no record is ever listed
+        // twice across the whole run. `priorTurnKnowledgeBlock` is the last successfully-built
+        // block, reused verbatim on turns where nothing new arrived (see newUserInputThisTurn
+        // below) — it is composed onto the CURRENT `systemPrompt` fresh every turn (see
+        // composeTurnSystemPrompt), never written back into the cached `systemPrompt` let itself.
+        const knowledgeIdsAlreadySurfaced = new Set((record.knowledgeInjections ?? []).map((entry) => entry.id));
+        let priorTurnKnowledgeBlock = null;
         let continueLoop = true;
         let turn = 0;
         record.progress = 'Turn 1 · Thinking…';
@@ -338,6 +364,16 @@ export async function runAgentTask(context, record) {
             }
             session.appendMessage({ type: 'llm_request', turn, messageCount: conversation.getMessagesForLLM().length, timestamp: new Date().toISOString() });
             const pending = context.messageBus.getMessages(record.id);
+            // Steers drained into the conversation THIS turn, awaiting the "consumed"
+            // signal below — deferred until the turn's chat call actually succeeds.
+            // See the comment at the emission site for why this can't fire here.
+            const drainedSteerMessageIds = [];
+            // Wave-5 (wo801, W5.1): true when this turn actually added new content to the
+            // conversation the model will see — turn 1 (the initial task) or any steer/directive
+            // drained just above. Gates per-turn knowledge re-retrieval: no new input means the
+            // evolving-conversation query would be identical to last turn's, so the prior turn's
+            // block is reused verbatim instead of re-running retrieval for no behavioral gain.
+            let newUserInputThisTurn = turn === 1;
             for (const msg of pending) {
                 // Skip the agent's own broadcasts and any message already injected on a
                 // prior turn so each directive is surfaced to the model exactly once.
@@ -346,14 +382,116 @@ export async function runAgentTask(context, record) {
                 if (injectedMessageIds.has(msg.id))
                     continue;
                 injectedMessageIds.add(msg.id);
-                const kindLabel = (msg.kind[0] ?? '').toUpperCase() + msg.kind.slice(1);
-                conversation.addUserMessage(`[${kindLabel} from ${msg.from}]: ${msg.content}`);
+                newUserInputThisTurn = true;
+                if (msg.kind === 'steer') {
+                    // A human steer (ProcessRegistry.steer) is a genuine user turn, not
+                    // an inter-agent directive — inject it verbatim, with none of the
+                    // "[Kind from sender]" framing used for agent-to-agent messages.
+                    conversation.addUserMessage(msg.content);
+                    drainedSteerMessageIds.push(msg.id);
+                }
+                else {
+                    const kindLabel = (msg.kind[0] ?? '').toUpperCase() + msg.kind.slice(1);
+                    conversation.addUserMessage(`[${kindLabel} from ${msg.from}]: ${msg.content}`);
+                }
             }
-            if (context.featureFlagManager?.isEnabled('agent-context-window-awareness') ?? true) {
+            const contextWindowAwarenessEnabled = context.featureFlagManager?.isEnabled('agent-context-window-awareness') ?? true;
+            const passiveKnowledgeInjectionEnabled = context.featureFlagManager?.isEnabled('agent-passive-knowledge-injection') ?? true;
+            // Resolved once per turn (used by both the awareness check below and the per-turn
+            // knowledge budget), rather than only inside the awareness branch, so the passive-
+            // injection budget can derive "3% of context window" even when context-window
+            // awareness itself is disabled.
+            let contextWindowForTurn = 0;
+            if (contextWindowAwarenessEnabled || passiveKnowledgeInjectionEnabled) {
                 const modelDef = resolveContextWindowModelDefinition(providerRegistry, activeRoute);
-                const contextWindow = context.providerRegistry.getContextWindowForModel(modelDef);
-                systemPrompt = applyContextWindowAwareness(context, record, activeRoute.modelId, contextWindow, conversation, systemPrompt, toolTokens, turn);
+                contextWindowForTurn = context.providerRegistry.getContextWindowForModel(modelDef);
             }
+            if (contextWindowAwarenessEnabled) {
+                systemPrompt = applyContextWindowAwareness(context, record, activeRoute.modelId, contextWindowForTurn, conversation, systemPrompt, toolTokens, turn);
+            }
+            // Wave-5 (wo801, W5.1): per-turn passive knowledge injection. Gated on the feature
+            // flag AND on there being new conversation input this turn; otherwise
+            // priorTurnKnowledgeBlock (unchanged) is reused. `priorTurnKnowledgeBlock` and
+            // `systemPrompt` are combined into a request-time-only string just below
+            // (composeTurnSystemPrompt) — the block is NEVER written back into the `systemPrompt`
+            // let, so it cannot compound turn over turn even across the emergency-compaction
+            // retry path (which DOES reassign `systemPrompt`) inside the chat-retry loop.
+            if (passiveKnowledgeInjectionEnabled && newUserInputThisTurn && context.memoryRegistry) {
+                const configuredBudget = context.passiveKnowledgeInjectionBudgetTokens
+                    ?? defaultTurnKnowledgeBudgetTokens(contextWindowForTurn);
+                let turnBudgetTokens = configuredBudget;
+                if (contextWindowAwarenessEnabled && contextWindowForTurn > 0) {
+                    // Clamp the block's budget to whatever headroom is left under the SAME 85%
+                    // compaction threshold applyContextWindowAwareness just enforced on the base
+                    // prompt, so base+block can never silently exceed it even though the block is
+                    // composed after that check ran (risk: B-tier token dishonesty otherwise).
+                    const msgTokensForBudget = estimateConversationTokens(conversation.getMessagesForLLM());
+                    const sysTokensForBudget = estimateTokens(systemPrompt);
+                    const threshold = Math.floor(contextWindowForTurn * CONTEXT_COMPACT_THRESHOLD);
+                    const headroomTokens = threshold - msgTokensForBudget - sysTokensForBudget - toolTokens;
+                    turnBudgetTokens = Math.max(0, Math.min(configuredBudget, headroomTokens));
+                }
+                if (turnBudgetTokens > 0) {
+                    const relevanceFloor = context.passiveKnowledgeInjectionRelevanceFloor ?? DEFAULT_TURN_KNOWLEDGE_RELEVANCE_FLOOR;
+                    // Stage B: code hits share this turn's SAME budget/floor. Gated on the separate
+                    // (default-off) code-injection flag AND the embedder's storage.codeIndexEnabled setting.
+                    const codeInjectionEnabled = !!context.codeIndex
+                        && (context.featureFlagManager?.isEnabled('agent-passive-code-injection') ?? false)
+                        && (context.isCodeInjectionSettingEnabled?.() ?? true);
+                    const { block, record: turnInjectionRecord } = buildPerTurnKnowledgeInjection({
+                        memoryRegistry: context.memoryRegistry,
+                        task: record.task,
+                        writeScope: record.writeScope ?? [],
+                        conversationTail: conversation.getMessagesForLLM(),
+                        budgetTokens: turnBudgetTokens,
+                        relevanceFloor,
+                        alreadyInjectedIds: [...knowledgeIdsAlreadySurfaced],
+                        turn,
+                        codeIndex: context.codeIndex,
+                        codeInjectionEnabled,
+                    });
+                    priorTurnKnowledgeBlock = block;
+                    for (const id of turnInjectionRecord.injectedIds)
+                        knowledgeIdsAlreadySurfaced.add(id);
+                    record.turnInjections = recordTurnInjection(record.turnInjections, turnInjectionRecord);
+                    session.appendMessage({ type: 'knowledge_injection', ...turnInjectionRecord });
+                }
+                else {
+                    // Hard no-op: no budget headroom this turn. Never call into retrieval for a
+                    // budget that's already known to be zero, and never claim a block that can't
+                    // exist — no record, no session message, prior block cleared so the composed
+                    // prompt below falls back to the base systemPrompt exactly.
+                    priorTurnKnowledgeBlock = null;
+                }
+            }
+            // Wave-5 (wo801, W5.1): compose the per-turn knowledge block onto the base
+            // systemPrompt fresh at EVERY call site (including each chat-retry iteration below),
+            // instead of hoisting a single `const turnSystemPrompt` computed once before the
+            // retry loop. This matters because the emergency-compaction retry path inside that
+            // loop reassigns the outer `systemPrompt` let (buildLayeredOrchestratorSystemPrompt)
+            // — a hoisted const would go stale and keep resubmitting the pre-compaction prompt,
+            // silently defeating that retry. Composing here also re-validates fit on every call:
+            // if base+block would exceed the SAME 85% compaction threshold applyContextWindowAwareness
+            // enforces (using live, current-call token counts, not turn-start estimates), the block
+            // is dropped for that call only — this is the safety net for a REUSED block (one that
+            // was sized against a headroom estimate one or more turns ago and may no longer fit,
+            // e.g. after several no-new-input turns of tool-result growth). It never mutates
+            // `priorTurnKnowledgeBlock` or the stored TurnInjectionRecord, both of which honestly
+            // reflect what retrieval computed at the time it ran.
+            const composeTurnSystemPrompt = (base) => {
+                if (!priorTurnKnowledgeBlock)
+                    return base;
+                if (contextWindowAwarenessEnabled && contextWindowForTurn > 0) {
+                    const liveMsgTokens = estimateConversationTokens(activeConversation.getMessagesForLLM());
+                    const liveSysTokens = estimateTokens(base);
+                    const liveBlockTokens = estimateTokens(priorTurnKnowledgeBlock);
+                    const threshold = Math.floor(contextWindowForTurn * CONTEXT_COMPACT_THRESHOLD);
+                    if (liveMsgTokens + liveSysTokens + liveBlockTokens + toolTokens > threshold) {
+                        return base;
+                    }
+                }
+                return `${base}\n\n${priorTurnKnowledgeBlock}`;
+            };
             let response;
             {
                 let networkAttempt = 0;
@@ -380,7 +518,7 @@ export async function runAgentTask(context, record) {
                             model: activeRoute.modelId,
                             messages: conversation.getMessagesForLLM(),
                             tools: toolDefinitions.length > 0 ? toolDefinitions : undefined,
-                            systemPrompt: appendGoodVibesRuntimeAwarenessPrompt(systemPrompt),
+                            systemPrompt: appendGoodVibesRuntimeAwarenessPrompt(composeTurnSystemPrompt(systemPrompt)),
                             ...(record.reasoningEffort ? { reasoningEffort: record.reasoningEffort } : {}),
                             onDelta,
                         });
@@ -461,6 +599,24 @@ export async function runAgentTask(context, record) {
                 record.streamingContent = undefined;
                 record.progress = `Turn ${turn} · Thinking…`;
             }
+            // Honest "consumed at boundary" signal, emitted here (not at drain time
+            // above) because this is the first point in the turn where the chat
+            // call is KNOWN to have succeeded. If the call above exhausted its
+            // retries/fallbacks, it throws and unwinds out of this function (caught
+            // by the outer try/catch → handleAgentRunFailure) without ever reaching
+            // this line — so a steer drained into a turn whose chat then fails
+            // never gets a consumed signal it didn't earn. Never emit this from
+            // AgentMessageBus.send() itself — that fires eagerly, before the agent
+            // has any chance to see the message.
+            if (context.runtimeBus) {
+                for (const messageId of drainedSteerMessageIds) {
+                    emitCommunicationConsumed(context.runtimeBus, context.emitterContext(record.id), {
+                        messageId,
+                        agentId: record.id,
+                        turn,
+                    });
+                }
+            }
             session.appendMessage({ type: 'llm_response', turn, contentLength: response.content.length, toolCallCount: response.toolCalls.length, usage: response.usage, timestamp: new Date().toISOString() });
             record.usage = {
                 inputTokens: (record.usage?.inputTokens ?? 0) + response.usage.inputTokens,
@@ -539,4 +695,13 @@ export async function runAgentTask(context, record) {
     catch (err) {
         await handleAgentRunFailure(context, record, conversation, session, preAgentProcessIds, err);
     }
+    finally {
+        // Wave-3 Part C6 bridge: release on EVERY exit path (normal completion,
+        // the mid-loop cancellation/MAX_TURNS early returns above, and the catch
+        // above) so the live source is never retained past the run and a final
+        // snapshot always lands in AgentManager's retention ring. A no-op when
+        // register was never called (e.g. failure before the ConversationManager
+        // was created).
+        context.releaseConversationSource?.(record.id);
+    }
 }

package/dist/platform/agents/orchestrator.d.ts

@@ -1,5 +1,6 @@
 import { ToolRegistry } from '../tools/registry.js';
 import type { ConfigManager } from '../config/manager.js';
+import type { ConversationMessageSnapshot } from '../core/conversation.js';
 import type { ProviderRegistry } from '../providers/registry.js';
 import { AgentMessageBus } from './message-bus.js';
 import type { ChannelPluginRegistry } from '../channels/index.js';
@@ -10,6 +11,29 @@ import type { ToolLLM } from '../config/tool-llm.js';
 import type { FeatureFlagManager } from '../runtime/feature-flags/manager.js';
 import type { RuntimeEventBus } from '../runtime/events/index.js';
 export { summarizeToolArgs } from './orchestrator-utils.js';
+/**
+ * Wave-3 Part C6 bridge: where AgentOrchestrator forwards a running agent's
+ * live conversation-snapshot accessor. In production this is AgentManager's
+ * registerConversationSource/releaseConversationSource, wired post-
+ * construction in runtime/services.ts (AgentOrchestrator is constructed
+ * before AgentManager there, so this is a setter rather than a constructor
+ * dependency — same pattern as setRuntimeBus).
+ */
+export interface AgentConversationSink {
+    readonly register: (agentId: string, source: () => ConversationMessageSnapshot[]) => void;
+    readonly release: (agentId: string) => void;
+}
+/**
+ * Wave-4 cooperative cancellation bridge (wo701): where AgentOrchestrator
+ * looks up a per-agent AbortSignal registered by an orchestration engine's
+ * work-item run. Same shape/wiring precedent as AgentConversationSink — a
+ * setter rather than a constructor dependency, wired post-construction in
+ * runtime/services.ts (production backing is
+ * AgentManager.registerCancellationSignal/getCancellationSignal).
+ */
+export interface AgentCancellationSource {
+    readonly get: (agentId: string) => AbortSignal | undefined;
+}
 type AgentOrchestratorToolDeps = {
     readonly fileCache: FileStateCache;
     readonly projectIndex: ProjectIndex;
@@ -24,6 +48,9 @@ type AgentOrchestratorToolDeps = {
     readonly remoteRunnerRegistry?: import('../runtime/remote/index.js').RemoteRunnerRegistry | undefined;
     readonly knowledgeService?: import('../knowledge/index.js').KnowledgeService | undefined;
     readonly memoryRegistry?: import('../state/index.js').MemoryRegistry | undefined;
+    readonly codeIndex?: import('./turn-knowledge-injection.js').TurnCodeIndexSource | undefined;
+    readonly isCodeInjectionSettingEnabled?: (() => boolean) | undefined;
+    readonly codeIndexReindexScheduler?: Pick<import('../state/code-index-reindex.js').CodeIndexReindexScheduler, 'onToolExecuted'> | undefined;
     readonly sessionOrchestration: import('../sessions/orchestration/index.js').CrossSessionTaskRegistry;
     readonly archetypeLoader?: import('./archetypes.js').ArchetypeLoader | undefined;
     readonly configManager?: ConfigManager | undefined;
@@ -45,11 +72,22 @@ type AgentOrchestratorToolDeps = {
  * `orchestrator-runner.ts`; this class owns shared registry/state wiring.
  */
 export declare class AgentOrchestrator {
-    private fullRegistry;
+    /**
+     * Keyed by working directory. A ToolRegistry is permanently bound to one
+     * cwd at construction (every tool factory closes over it — see
+     * tools/index.ts registerAllTools), so a distinct cwd genuinely needs its
+     * own registry, not a mutable field. The default cwd
+     * (`this.toolDeps.workingDirectory`) is cached under its own key exactly
+     * like the single `fullRegistry` field this replaces — same lazy-build,
+     * same channel-version invalidation, same object identity once built.
+     */
+    private fullRegistries;
     private fullRegistryChannelVersion;
     private toolDeps;
     private featureFlagManager;
     private runtimeBus;
+    private conversationSink;
+    private cancellationSource;
     private readonly channelRegistry;
     private readonly messageBus;
     constructor(config?: {
@@ -59,6 +97,20 @@ export declare class AgentOrchestrator {
     setRuntimeBus(runtimeBus: RuntimeEventBus | null): void;
     /** Set the FeatureFlagManager for context-window awareness gating. */
     setFeatureFlagManager(manager: FeatureFlagManager): void;
+    /**
+     * Wire the Wave-3 Part C6 conversation-snapshot bridge (see
+     * AgentConversationSink). Pass null to detach — createRunContext() then
+     * omits the register/release callbacks entirely and orchestrator-runner's
+     * `?.()` calls become no-ops.
+     */
+    setConversationSink(sink: AgentConversationSink | null): void;
+    /**
+     * Wire the Wave-4 cancellation bridge (see AgentCancellationSource). Pass
+     * null to detach — createRunContext() then omits getCancellationSignal
+     * entirely and orchestrator-runner's `?.()` call becomes a no-op, so every
+     * tool call runs with `opts` undefined exactly as before this change.
+     */
+    setCancellationSource(source: AgentCancellationSource | null): void;
     private emitterContext;
     private emitAgentProgress;
     private emitOrchestrationProgress;
@@ -76,12 +128,22 @@ export declare class AgentOrchestrator {
      */
     setDependencies(toolDeps: AgentOrchestratorToolDeps): void;
     /**
-     * Returns the fully-populated ToolRegistry for this orchestrator.
-     * Used by companion chat to execute tool calls emitted by the LLM.
-     * Delegates to the lazy-initialized internal registry.
+     * Returns the fully-populated ToolRegistry for this orchestrator's DEFAULT
+     * working directory. Used by companion chat to execute tool calls emitted
+     * by the LLM — companion chat has no per-call cwd override, so this always
+     * resolves to `this.toolDeps.workingDirectory`. Delegates to the
+     * lazy-initialized internal registry cache.
      */
     getToolRegistry(): ToolRegistry;
-    /** Lazily build and cache the full ToolRegistry. */
+    /**
+     * Lazily build and cache the full ToolRegistry for `workingDirectory`
+     * (default: `this.toolDeps.workingDirectory`, unchanged from before this
+     * cache became keyed). A non-default cwd — a spawned agent's dedicated
+     * worktree (AgentRecord.workingDirectory, see AgentInput.workingDirectory)
+     * — gets its OWN fresh fileCache/projectIndex rather than reusing the
+     * shared session's: those are scoped to the default cwd and would
+     * otherwise silently index/search the wrong directory.
+     */
     private getFullRegistry;
     /**
      * Build a ToolRegistry containing only the tools whose names appear in
@@ -97,8 +159,18 @@ export declare class AgentOrchestrator {
     private assertProviderQualifiedModel;
     private resolveChatModelId;
     private resolveFallbackModelRoutes;
+    /**
+     * @param workingDirectory Per-call cwd override (AgentRecord.workingDirectory).
+     * Absent ⇒ `this.toolDeps.workingDirectory`, byte-identical to every run
+     * context built before this parameter existed.
+     */
     private createRunContext;
-    /** Run an agent task described by the given record. */
+    /**
+     * Run an agent task described by the given record. Honors
+     * `record.workingDirectory` when set (see AgentInput.workingDirectory) —
+     * every tool this run's registry exposes is bound to that cwd instead of
+     * the orchestrator's default.
+     */
     runAgent(record: AgentRecord): Promise<void>;
 }
 //# sourceMappingURL=orchestrator.d.ts.map

package/dist/platform/agents/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/platform/agents/orchestrator.js

@@ -19,11 +19,22 @@ export { summarizeToolArgs } from './orchestrator-utils.js';
  * `orchestrator-runner.ts`; this class owns shared registry/state wiring.
  */
 export class AgentOrchestrator {
-    fullRegistry = null;
+    /**
+     * Keyed by working directory. A ToolRegistry is permanently bound to one
+     * cwd at construction (every tool factory closes over it — see
+     * tools/index.ts registerAllTools), so a distinct cwd genuinely needs its
+     * own registry, not a mutable field. The default cwd
+     * (`this.toolDeps.workingDirectory`) is cached under its own key exactly
+     * like the single `fullRegistry` field this replaces — same lazy-build,
+     * same channel-version invalidation, same object identity once built.
+     */
+    fullRegistries = new Map();
     fullRegistryChannelVersion = -2;
     toolDeps = null;
     featureFlagManager = null;
     runtimeBus = null;
+    conversationSink = null;
+    cancellationSource = null;
     channelRegistry;
     messageBus;
     constructor(config = {
@@ -39,6 +50,24 @@ export class AgentOrchestrator {
     setFeatureFlagManager(manager) {
         this.featureFlagManager = manager;
     }
+    /**
+     * Wire the Wave-3 Part C6 conversation-snapshot bridge (see
+     * AgentConversationSink). Pass null to detach — createRunContext() then
+     * omits the register/release callbacks entirely and orchestrator-runner's
+     * `?.()` calls become no-ops.
+     */
+    setConversationSink(sink) {
+        this.conversationSink = sink;
+    }
+    /**
+     * Wire the Wave-4 cancellation bridge (see AgentCancellationSource). Pass
+     * null to detach — createRunContext() then omits getCancellationSignal
+     * entirely and orchestrator-runner's `?.()` call becomes a no-op, so every
+     * tool call runs with `opts` undefined exactly as before this change.
+     */
+    setCancellationSource(source) {
+        this.cancellationSource = source;
+    }
     emitterContext(agentId) {
         return {
             sessionId: 'agent-orchestrator',
@@ -138,30 +167,53 @@ export class AgentOrchestrator {
      */
     setDependencies(toolDeps) {
         this.toolDeps = toolDeps;
-        this.fullRegistry = null;
+        this.fullRegistries = new Map();
         this.fullRegistryChannelVersion = -2;
     }
     /**
-     * Returns the fully-populated ToolRegistry for this orchestrator.
-     * Used by companion chat to execute tool calls emitted by the LLM.
-     * Delegates to the lazy-initialized internal registry.
+     * Returns the fully-populated ToolRegistry for this orchestrator's DEFAULT
+     * working directory. Used by companion chat to execute tool calls emitted
+     * by the LLM — companion chat has no per-call cwd override, so this always
+     * resolves to `this.toolDeps.workingDirectory`. Delegates to the
+     * lazy-initialized internal registry cache.
      */
     getToolRegistry() {
         return this.getFullRegistry();
     }
-    /** Lazily build and cache the full ToolRegistry. */
-    getFullRegistry() {
+    /**
+     * Lazily build and cache the full ToolRegistry for `workingDirectory`
+     * (default: `this.toolDeps.workingDirectory`, unchanged from before this
+     * cache became keyed). A non-default cwd — a spawned agent's dedicated
+     * worktree (AgentRecord.workingDirectory, see AgentInput.workingDirectory)
+     * — gets its OWN fresh fileCache/projectIndex rather than reusing the
+     * shared session's: those are scoped to the default cwd and would
+     * otherwise silently index/search the wrong directory.
+     */
+    getFullRegistry(workingDirectory) {
         const channelVersion = this.channelRegistry?.getVersion() ?? -1;
-        if (!this.fullRegistry || this.fullRegistryChannelVersion !== channelVersion) {
+        if (this.fullRegistryChannelVersion !== channelVersion) {
+            this.fullRegistries.clear();
+            this.fullRegistryChannelVersion = channelVersion;
+        }
+        const defaultCwd = this.toolDeps?.workingDirectory ?? '';
+        const cwd = workingDirectory ?? defaultCwd;
+        let registry = this.fullRegistries.get(cwd);
+        if (!registry) {
             if (!this.toolDeps?.configManager || !this.toolDeps?.providerRegistry || !this.toolDeps?.toolLLM) {
                 throw new Error('AgentOrchestrator requires configManager, providerRegistry, and toolLLM dependencies before tool registration');
             }
-            this.fullRegistry = new ToolRegistry();
-            registerAllTools(this.fullRegistry, this.toolDeps);
-            registerChannelAgentTools(this.fullRegistry, this.toolDeps?.channelRegistry ?? this.channelRegistry);
-            this.fullRegistryChannelVersion = channelVersion;
+            registry = new ToolRegistry();
+            const isDefaultCwd = cwd === defaultCwd;
+            registerAllTools(registry, {
+                ...this.toolDeps,
+                workingDirectory: cwd,
+                fileCache: isDefaultCwd ? this.toolDeps.fileCache : undefined,
+                projectIndex: isDefaultCwd ? this.toolDeps.projectIndex : undefined,
+            });
+            registerChannelAgentTools(registry, this.toolDeps?.channelRegistry ?? this.channelRegistry);
+            this.fullRegistries.set(cwd, registry);
         }
-        return this.fullRegistry;
+        return registry;
     }
     /**
      * Build a ToolRegistry containing only the tools whose names appear in
@@ -327,9 +379,15 @@ export class AgentOrchestrator {
         }
         return routes;
     }
-    createRunContext() {
+    /**
+     * @param workingDirectory Per-call cwd override (AgentRecord.workingDirectory).
+     * Absent ⇒ `this.toolDeps.workingDirectory`, byte-identical to every run
+     * context built before this parameter existed.
+     */
+    createRunContext(workingDirectory) {
+        const cwd = workingDirectory ?? this.toolDeps?.workingDirectory ?? '';
         return {
-            workingDirectory: this.toolDeps?.workingDirectory ?? '',
+            workingDirectory: cwd,
             surfaceRoot: this.toolDeps?.surfaceRoot ?? '',
             runtimeBus: this.runtimeBus,
             featureFlagManager: this.featureFlagManager,
@@ -344,21 +402,40 @@ export class AgentOrchestrator {
             emitAgentCompletedEvent: (recordId, durationMs, output, toolCallsMade, usage) => this.emitAgentCompletedEvent(recordId, durationMs, output, toolCallsMade, usage),
             emitOrchestrationCompleted: (record, output) => this.emitOrchestrationCompleted(record, output),
             emitStreamDelta: (recordId, content, accumulated) => this.emitStreamDelta(recordId, content, accumulated),
+            registerConversationSource: this.conversationSink
+                ? (agentId, source) => this.conversationSink.register(agentId, source)
+                : undefined,
+            releaseConversationSource: this.conversationSink
+                ? (agentId) => this.conversationSink.release(agentId)
+                : undefined,
+            getCancellationSignal: this.cancellationSource
+                ? (agentId) => this.cancellationSource.get(agentId)
+                : undefined,
             processManager: this.toolDeps?.processManager,
             messageBus: this.messageBus,
             knowledgeService: this.toolDeps?.knowledgeService,
             memoryRegistry: this.toolDeps?.memoryRegistry,
+            codeIndex: this.toolDeps?.codeIndex,
+            isCodeInjectionSettingEnabled: this.toolDeps?.isCodeInjectionSettingEnabled,
+            onToolExecuted: this.toolDeps?.codeIndexReindexScheduler
+                ? (toolName, args, success) => this.toolDeps.codeIndexReindexScheduler.onToolExecuted(toolName, args, success)
+                : undefined,
             archetypeLoader: this.toolDeps?.archetypeLoader,
             providerOptimizer: this.toolDeps?.providerOptimizer,
             providerRegistry: this.toolDeps.providerRegistry,
-            getFullRegistry: () => this.getFullRegistry(),
+            getFullRegistry: () => this.getFullRegistry(cwd),
             buildScopedRegistry: (allowedNames, fullRegistry) => this.buildScopedRegistry(allowedNames, fullRegistry),
             resolveProviderForRecord: (providerRegistry, record, currentModel) => this.resolveProviderForRecord(providerRegistry, record, currentModel),
             resolveFallbackModelRoutes: (providerRegistry, record, currentModel, primaryRequestedModelId) => this.resolveFallbackModelRoutes(providerRegistry, record, currentModel, primaryRequestedModelId),
         };
     }
-    /** Run an agent task described by the given record. */
+    /**
+     * Run an agent task described by the given record. Honors
+     * `record.workingDirectory` when set (see AgentInput.workingDirectory) —
+     * every tool this run's registry exposes is bound to that cwd instead of
+     * the orchestrator's default.
+     */
     async runAgent(record) {
-        await runAgentTask(this.createRunContext(), record);
+        await runAgentTask(this.createRunContext(record.workingDirectory), record);
     }
 }

package/dist/platform/agents/planner-decomposition-runner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Production `DecompositionRunner` backed by the real `AgentManager`.
+ *
+ * This is the concrete driver that spawns a bounded, READ-ONLY `planner`
+ * agent through the existing agents machinery and polls it to completion. It
+ * lives in the agents layer (not `core`) precisely so `core/plan-decomposition.ts`
+ * can stay free of any agent-machinery import and be unit-tested against a
+ * stubbed runner. The planning agent it spawns is an ordinary `AgentManager`
+ * agent, so it surfaces in the fleet like any other and honours kill/steer;
+ * an external kill lands here as a `'cancelled'` result → heuristic fallback.
+ *
+ * Bounds are enforced cooperatively by polling `AgentRecord.usage`:
+ *   - wall-clock: `cancel()` once `now() >= start + wallTimeoutMs`
+ *   - token ceiling: `cancel()` once input+output tokens exceed the ceiling
+ *   - turns: `cancel()` once `usage.turnCount` exceeds `maxTurns`
+ * All three collapse to a `'cancelled'` run result (with a `detail`), which the
+ * service turns into an honest `fallbackReason`.
+ */
+import type { AgentManager } from '../tools/agent/manager.js';
+import type { DecompositionRunner } from '../core/plan-decomposition.js';
+/** The read-only tool set the planner template resolves to. Kept in lockstep
+ *  with AGENT_TEMPLATES.planner and passed with restrictTools for a hard cap. */
+export declare const PLANNER_DECOMPOSITION_TOOLS: readonly ["read", "find", "analyze", "inspect"];
+export interface AgentManagerDecompositionRunnerDeps {
+    agentManager: Pick<AgentManager, 'spawn' | 'getStatus' | 'cancel'>;
+    /** Injectable clock (tests). */
+    now?: () => number;
+    /** Injectable sleep (tests). */
+    sleep?: (ms: number) => Promise<void>;
+    /** Poll interval in ms (default 50). */
+    pollIntervalMs?: number;
+    /** Optional model registry key override for the planner agent. */
+    model?: string | undefined;
+    /** Optional provider override for the planner agent. */
+    provider?: string | undefined;
+}
+export declare function createAgentManagerDecompositionRunner(deps: AgentManagerDecompositionRunnerDeps): DecompositionRunner;
+//# sourceMappingURL=planner-decomposition-runner.d.ts.map

package/dist/platform/agents/planner-decomposition-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-decomposition-runner.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/planner-decomposition-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,+BAA+B,CAAC;AAGvC;iFACiF;AACjF,eAAO,MAAM,2BAA2B,iDAAkD,CAAC;AAE3F,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IACnE,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAyBD,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,mCAAmC,GACxC,mBAAmB,CA+ErB"}