@pellux/goodvibes-sdk 0.30.3 → 0.33.1

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

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

package/dist/platform/core/orchestrator.js

@@ -16,7 +16,7 @@ import { CacheHitTracker } from '../providers/cache-strategy.js';
 import { IdempotencyStore } from '../runtime/idempotency/index.js';
 import {} from './tool-reconciliation.js';
 import { HelperModel } from '../config/helper-model.js';
-import { emitStreamEnd, emitTurnCancel, emitTurnError, emitTurnSubmitted, } from '../runtime/emitters/index.js';
+import { emitPreflightFail, emitStreamEnd, emitTurnCancel, emitTurnError, emitTurnSubmitted, } from '../runtime/emitters/index.js';
 import { autoSpawnPendingItems, executeToolCalls, reconcileUnresolvedToolCalls, } from './orchestrator-tool-runtime.js';
 import { checkContextWindowPreflight, emitContextOverflowError, handlePostTurnContextMaintenance, } from './orchestrator-context-runtime.js';
 import { createEmitterContext, estimateFreshTurnInputTokens, getCacheHitTracker, getIdempotencyStore, getSessionLineageTracker, normalizeUsage, requireConfigManager, requireProviderRegistry, } from './orchestrator-runtime.js';
@@ -328,13 +328,18 @@ export class Orchestrator {
         this.streamingInputTokens = estimatedInputTokens ?? this.lastRequestInputTokens;
         this.streamingOutputTokens = 0;
         this.abortController = new AbortController();
+        // animInterval is always (re)started on every think call to reset the frame
+        // counter and ensure a fresh animation cycle — even if already running.
         if (this.animInterval)
             clearInterval(this.animInterval);
         this.animInterval = setInterval(() => {
             this.thinkingFrame++;
             this.requestRender();
         }, 80);
-        // Don't block clean process exit (PERF-07).
+        // unref() prevents this timer from holding the event loop open after the
+        // process has otherwise completed all work. The cast is required
+        // because the TypeScript setInterval return type does not expose unref();
+        // Bun and Node.js both implement it on their timer handle objects.
         this.animInterval.unref?.();
         this.requestRender();
     }
@@ -353,17 +358,33 @@ export class Orchestrator {
         const turnStartTime = Date.now();
         const configManager = requireConfigManager(this.coreServices);
         const providerRegistry = requireProviderRegistry(this.coreServices);
-        // --- Submission key — per-turn idempotency fence ---
+        // --- Phase 1: Preflight — idempotency, event emission, plan injection ---
+        const preflight = this.runTurnPreflight(text, content, options, providerRegistry);
+        if (!preflight)
+            return; // duplicate in-flight turn was rejected and reported
+        const { submissionKey, turnId, preTurnPlan } = preflight;
+        // --- Phase 2: Stream + tool dispatch ---
+        try {
+            await this.runTurnStream(text, content, turnId, preTurnPlan, configManager, providerRegistry);
+            // --- Phase 3: Post-turn reconciliation ---
+            await this.runTurnReconcile(turnId, configManager, providerRegistry);
+        }
+        catch (err) {
+            this.handleTurnError(err, turnId, configManager, providerRegistry);
+        }
+        finally {
+            this.finalizeTurn(turnStartTime, submissionKey, turnId, configManager);
+        }
+    }
+    /** Phase 1: Idempotency fence, event emission, adaptive planner, plan injection, thinking start.
+     *  Returns null when the turn is a duplicate in-flight submission that should not execute. */
+    runTurnPreflight(text, content, options, providerRegistry) {
         // Generates a stable, deterministic key for this turn using a SHA-256 hash
         // of the message content (first 512 chars) + conversation length as context.
         // If the same physical turn is replayed (reconnect/restart) before the
         // prior execution completes, the second attempt hits 'in-flight' and is
-        // silently dropped. After completion the key expires via TTL.
-        // Note: turnId is deliberately pre-hashed here (SHA-256, sliced to 16 chars) so
-        // that long message text does not bloat the intermediate string passed to
-        // generateKey — which applies its own SHA-256 internally. The double-hash is
-        // intentional and harmless: the outer hash provides key isolation and the
-        // inner hash ensures the final store key is a uniform 64-char hex digest.
+        // rejected with a preflight failure event. After completion the key expires
+        // via TTL.
         const turnId = createHash('sha256')
             .update(`${this.sessionId}:${this.conversation.getMessageCount()}:${text.slice(0, 512)}`)
             .digest('hex')
@@ -377,12 +398,26 @@ export class Orchestrator {
         const submissionCheck = idempotencyStore.checkAndRecord(submissionKey);
         this.currentSubmissionKey = submissionKey;
         if (submissionCheck.status === 'in-flight') {
-            logger.warn('Orchestrator: duplicate turn submission detected (in-flight) — dropping', {
+            const reason = 'Duplicate turn submission rejected because an equivalent turn is already in flight.';
+            logger.warn('Orchestrator: duplicate turn submission detected (in-flight) — rejecting', {
                 sessionId: this.sessionId,
                 submissionKey,
             });
+            if (this.runtimeBus) {
+                const ctx = createEmitterContext(this.sessionId, turnId);
+                emitTurnSubmitted(this.runtimeBus, ctx, {
+                    turnId,
+                    prompt: text,
+                    ...(options?.origin ? { origin: options.origin } : {}),
+                });
+                emitPreflightFail(this.runtimeBus, ctx, {
+                    turnId,
+                    reason,
+                    stopReason: 'preflight_failed',
+                });
+            }
             this.currentSubmissionKey = null;
-            return;
+            return null;
         }
         // 'duplicate' (completed/failed) — allow re-run (user sent same text intentionally).
         // We just let it proceed; the prior record will be overwritten.
@@ -393,12 +428,8 @@ export class Orchestrator {
                 ...(options?.origin ? { origin: options.origin } : {}),
             });
         }
-        // Adaptive Execution Planner.
-        // If the feature flag is enabled, score and select the execution strategy
-        // before the turn proceeds. The selected strategy and reason code are
-        // emitted for the Ops panel and logged for observability.
+        // Adaptive Execution Planner: score and select the execution strategy before the turn proceeds.
         maybeEmitAdaptivePlannerDecision(text, this.flagManager?.isEnabled('adaptive-execution-planner') ?? false, this.coreServices.adaptivePlanner ?? null, this.runtimeBus, (id) => createEmitterContext(this.sessionId, id), turnId);
-        // ────────────────────────────────────────────────────────────────────────
         // Pre-turn plan injection: if an active plan exists, inject its current state into
         // the conversation so the LLM can refer to it and update item statuses.
         const preTurnPlan = prepareConversationForTurn(this.conversation, providerRegistry, text, content, this.sessionId, this.coreServices.planManager ?? null);
@@ -406,159 +437,166 @@ export class Orchestrator {
         this.scrollToEnd(this.getViewportHeight());
         const initialEstimatedTokens = estimateConversationTokens(this.conversation.getMessagesForLLM());
         this.startThinking(estimateFreshTurnInputTokens(this.lastInputTokens, initialEstimatedTokens, text, content));
-        try {
-            await executeOrchestratorTurnLoop({
-                conversation: this.conversation,
-                toolRegistry: this.toolRegistry,
-                getSystemPrompt: this.getSystemPrompt,
-                getAbortSignal: () => this.abortController?.signal,
-                hookDispatcher: this.hookDispatcher,
-                requestRender: this.requestRender,
-                runtimeBus: this.runtimeBus,
-                agentManager: this.agentManager,
-                configManager,
-                providerRegistry,
-                favoritesStore: this.coreServices.favoritesStore,
-                cacheHitTracker: getCacheHitTracker(this.coreServices, this.ownedCacheHitTracker),
-                helperModel: new HelperModel({ configManager, providerRegistry }),
-                sessionId: this.sessionId,
-                preTurnPlan,
-                planManager: this.coreServices.planManager ?? null,
-                text,
-                content,
-                turnId,
-                emitterContext: (id) => createEmitterContext(this.sessionId, id),
-                executeToolCalls: (id, calls) => this.executeToolCalls(id, calls),
-                checkContextWindowPreflight: (id, model) => this.checkContextWindowPreflight(id, model),
-                normalizeUsage,
-                estimateFreshTurnInputTokens: (currentEstimatedTokens, nextText, nextContent) => estimateFreshTurnInputTokens(this.lastInputTokens, currentEstimatedTokens, nextText, nextContent),
-                getMessageQueueLength: () => this.messageQueue.length,
-                isReconciliationEnabled: () => this.isReconciliationEnabled(),
-                setPendingToolCalls: (calls) => { this._pendingToolCalls = calls; },
-                setAutoSpawnTimeout: (timeout) => { this.autoSpawnTimeout = timeout; },
-                setStreamingActive: (value) => { this.isStreaming = value; },
-                setStreamingInputTokens: (value) => { this.streamingInputTokens = value; },
-                addStreamingOutputTokens: (value) => { this.streamingOutputTokens += value; },
-                setLastRequestInputTokens: (value) => { this.lastRequestInputTokens = value; },
-                setLastInputTokens: (value) => { this.lastInputTokens = value; },
-                markTurnFailed: () => { this._turnFailed = true; },
-                usage: this.usage,
-            });
-            await handlePostTurnContextMaintenance({
-                conversation: this.conversation,
-                agentManager: this.agentManager,
-                wrfcController: this.wrfcController,
-                planManager: this.coreServices.planManager ?? null,
-                sessionMemoryStore: this.coreServices.sessionMemoryStore ?? null,
-                configManager,
-                providerRegistry,
-                sessionLineageTracker: getSessionLineageTracker(this.coreServices, this.ownedSessionLineageTracker),
-                runtimeBus: this.runtimeBus,
-                emitterContext: (id) => createEmitterContext(this.sessionId, id),
-                hookDispatcher: this.hookDispatcher,
-                sessionId: this.sessionId,
-                requestRender: this.requestRender,
-                isCompacting: this.isCompacting,
-                setIsCompacting: (value) => { this.isCompacting = value; },
-                lastWarningBracket: this.lastWarningBracket,
-                setLastWarningBracket: (value) => { this.lastWarningBracket = value; },
-            }, turnId, this.lastInputTokens);
-        }
-        catch (err) {
-            if (this.abortController?.signal.aborted) {
-                // Clean up streaming block if one was active when aborted
-                if (this.isStreaming) {
-                    this.isStreaming = false;
-                    this.conversation.finalizeStreamingBlock();
-                    if (this.runtimeBus) {
-                        emitStreamEnd(this.runtimeBus, createEmitterContext(this.sessionId, turnId), { turnId });
-                    }
-                }
-                // Remove any partial LLM response, keep user message but mark it cancelled
-                this.conversation.removeMessagesAfter(this.turnStartMessageCount);
-                this.conversation.markLastUserMessageCancelled();
-                this.conversation.addSystemMessage('[Response cancelled]');
+        return { submissionKey, turnId, preTurnPlan };
+    }
+    /** Phase 2: Execute the LLM streaming loop and tool dispatch. */
+    async runTurnStream(text, content, turnId, preTurnPlan, configManager, providerRegistry) {
+        await executeOrchestratorTurnLoop({
+            conversation: this.conversation,
+            toolRegistry: this.toolRegistry,
+            getSystemPrompt: this.getSystemPrompt,
+            getAbortSignal: () => this.abortController?.signal,
+            hookDispatcher: this.hookDispatcher,
+            requestRender: this.requestRender,
+            runtimeBus: this.runtimeBus,
+            agentManager: this.agentManager,
+            configManager,
+            providerRegistry,
+            favoritesStore: this.coreServices.favoritesStore,
+            cacheHitTracker: getCacheHitTracker(this.coreServices, this.ownedCacheHitTracker),
+            helperModel: new HelperModel({ configManager, providerRegistry }),
+            sessionId: this.sessionId,
+            preTurnPlan,
+            planManager: this.coreServices.planManager ?? null,
+            text,
+            content,
+            turnId,
+            emitterContext: (id) => createEmitterContext(this.sessionId, id),
+            executeToolCalls: (id, calls) => this.executeToolCalls(id, calls),
+            checkContextWindowPreflight: (id, model) => this.checkContextWindowPreflight(id, model),
+            normalizeUsage,
+            estimateFreshTurnInputTokens: (currentEstimatedTokens, nextText, nextContent) => estimateFreshTurnInputTokens(this.lastInputTokens, currentEstimatedTokens, nextText, nextContent),
+            getMessageQueueLength: () => this.messageQueue.length,
+            isReconciliationEnabled: () => this.isReconciliationEnabled(),
+            setPendingToolCalls: (calls) => { this._pendingToolCalls = calls; },
+            setAutoSpawnTimeout: (timeout) => { this.autoSpawnTimeout = timeout; },
+            setStreamingActive: (value) => { this.isStreaming = value; },
+            setStreamingInputTokens: (value) => { this.streamingInputTokens = value; },
+            addStreamingOutputTokens: (value) => { this.streamingOutputTokens += value; },
+            setLastRequestInputTokens: (value) => { this.lastRequestInputTokens = value; },
+            setLastInputTokens: (value) => { this.lastInputTokens = value; },
+            markTurnFailed: () => { this._turnFailed = true; },
+            usage: this.usage,
+        });
+    }
+    /** Phase 3: Post-turn context maintenance (compaction, memory, plan updates). */
+    async runTurnReconcile(turnId, configManager, providerRegistry) {
+        await handlePostTurnContextMaintenance({
+            conversation: this.conversation,
+            agentManager: this.agentManager,
+            wrfcController: this.wrfcController,
+            planManager: this.coreServices.planManager ?? null,
+            sessionMemoryStore: this.coreServices.sessionMemoryStore ?? null,
+            configManager,
+            providerRegistry,
+            sessionLineageTracker: getSessionLineageTracker(this.coreServices, this.ownedSessionLineageTracker),
+            runtimeBus: this.runtimeBus,
+            emitterContext: (id) => createEmitterContext(this.sessionId, id),
+            hookDispatcher: this.hookDispatcher,
+            sessionId: this.sessionId,
+            requestRender: this.requestRender,
+            isCompacting: this.isCompacting,
+            setIsCompacting: (value) => { this.isCompacting = value; },
+            lastWarningBracket: this.lastWarningBracket,
+            setLastWarningBracket: (value) => { this.lastWarningBracket = value; },
+        }, turnId, this.lastInputTokens);
+    }
+    /** Catch handler: route to abort path or error path. */
+    handleTurnError(err, turnId, configManager, providerRegistry) {
+        if (this.abortController?.signal.aborted) {
+            // Clean up streaming block if one was active when aborted
+            if (this.isStreaming) {
+                this.isStreaming = false;
+                this.conversation.finalizeStreamingBlock();
                 if (this.runtimeBus) {
-                    emitTurnCancel(this.runtimeBus, createEmitterContext(this.sessionId, turnId), {
-                        turnId,
-                        reason: 'cancelled',
-                        stopReason: 'cancelled',
-                    });
+                    emitStreamEnd(this.runtimeBus, createEmitterContext(this.sessionId, turnId), { turnId });
                 }
-                return;
             }
-            const error = err instanceof Error ? err : new Error(summarizeError(err));
-            const msg = formatError(error, {
-                ...(error instanceof ProviderError
-                    ? { provider: providerRegistry.getCurrentModel().provider, source: 'provider' }
-                    : {}),
-            });
-            this.conversation.addSystemMessage(msg);
-            this.requestRender();
-            // Graceful degradation — suggest alternative when provider fails non-transiently
-            const autoSwitch = configManager.get('behavior.suggestAlternativeOnProviderFail');
-            if (autoSwitch && isNonTransientProviderFailure(err)) {
-                const currentModel = providerRegistry.getCurrentModel();
-                const alt = currentModel ? providerRegistry.findAlternativeModel(currentModel.id) : null;
-                if (alt) {
-                    this.conversation.addSystemMessage(`[Provider] ${currentModel?.provider ?? 'Unknown'} failed. Alternative available: ${alt.displayName} (${alt.provider}). Use /model to switch.`);
-                }
-            }
-            this._turnFailed = true;
+            // Remove any partial LLM response, keep user message but mark it cancelled
+            this.conversation.removeMessagesAfter(this.turnStartMessageCount);
+            this.conversation.markLastUserMessageCancelled();
+            this.conversation.addSystemMessage('[Response cancelled]');
             if (this.runtimeBus) {
-                emitTurnError(this.runtimeBus, createEmitterContext(this.sessionId, turnId), {
+                emitTurnCancel(this.runtimeBus, createEmitterContext(this.sessionId, turnId), {
                     turnId,
-                    error: summarizeError(error),
-                    stopReason: err instanceof ProviderError ? 'provider_error' : 'unexpected_error',
+                    reason: 'cancelled',
+                    stopReason: 'cancelled',
                 });
             }
+            return;
+        }
+        const error = err instanceof Error ? err : new Error(summarizeError(err));
+        const msg = formatError(error, {
+            ...(error instanceof ProviderError
+                ? { provider: providerRegistry.getCurrentModel().provider, source: 'provider' }
+                : {}),
+        });
+        this.conversation.addSystemMessage(msg);
+        this.requestRender();
+        // Graceful degradation — suggest alternative when provider fails non-transiently
+        const autoSwitch = configManager.get('behavior.suggestAlternativeOnProviderFail');
+        if (autoSwitch && isNonTransientProviderFailure(err)) {
+            const currentModel = providerRegistry.getCurrentModel();
+            const alt = currentModel ? providerRegistry.findAlternativeModel(currentModel.registryKey) : null;
+            if (alt) {
+                this.conversation.addSystemMessage(`[Provider] ${currentModel?.provider ?? 'Unknown'} failed. Alternative available: ${alt.displayName} (${alt.provider}). Use /model to switch.`);
+            }
         }
-        finally {
-            // ── GC-ORCH-015: Terminal-state tool-call reconciliation ───────────────────
-            // If the turn threw an exception between addAssistantMessage (which sets
-            // _pendingToolCalls) and addToolResults (which clears it), there are
-            // unresolved tool-call blocks in the conversation. Reconcile them now
-            // so the conversation is always in a valid state on turn exit.
-            if (this._pendingToolCalls.length > 0) {
-                this.reconcileUnresolvedToolCalls([], 'exception-before-results');
+        this._turnFailed = true;
+        if (this.runtimeBus) {
+            emitTurnError(this.runtimeBus, createEmitterContext(this.sessionId, turnId), {
+                turnId,
+                error: summarizeError(error),
+                stopReason: err instanceof ProviderError ? 'provider_error' : 'unexpected_error',
+            });
+        }
+    }
+    /** Finally handler: tool-call reconciliation, submission key finalization, notifications, replay queue. */
+    finalizeTurn(turnStartTime, submissionKey, turnId, configManager) {
+        // ── GC-ORCH-015: Terminal-state tool-call reconciliation ───────────────────
+        // If the turn threw an exception between addAssistantMessage (which sets
+        // _pendingToolCalls) and addToolResults (which clears it), there are
+        // unresolved tool-call blocks in the conversation. Reconcile them now
+        // so the conversation is always in a valid state on turn exit.
+        if (this._pendingToolCalls.length > 0) {
+            this.reconcileUnresolvedToolCalls([], 'exception-before-results');
+        }
+        // --- Submission key: mark turn complete or failed ---
+        // Success: markComplete caches the result for duplicate callers.
+        // Failure: markFailed allows retry on the next submission.
+        if (this.currentSubmissionKey) {
+            if (this._turnFailed) {
+                getIdempotencyStore(this.coreServices, this.ownedIdempotencyStore).markFailed(this.currentSubmissionKey);
+            }
+            else {
+                getIdempotencyStore(this.coreServices, this.ownedIdempotencyStore).markComplete(this.currentSubmissionKey);
             }
-            // --- Submission key: mark turn complete or failed ---
-            // Success: markComplete caches the result for duplicate callers.
-            // Failure: markFailed allows retry on the next submission.
-            if (this.currentSubmissionKey) {
-                if (this._turnFailed) {
-                    getIdempotencyStore(this.coreServices, this.ownedIdempotencyStore).markFailed(this.currentSubmissionKey);
+            this.currentSubmissionKey = null;
+            this._turnFailed = false;
+        }
+        this.stopThinking();
+        const durationMs = Date.now() - turnStartTime;
+        const notifyEnabled = configManager.get('behavior.notifyOnComplete');
+        if (notifyEnabled !== false) {
+            notifyCompletion('GoodVibes', `Response complete (${Math.round(durationMs / 1000)}s)`, durationMs);
+        }
+        // ── Event replay queue ────────────────────────────────────────────────
+        // Signal turn completion; if any tracked events went unacknowledged,
+        // inject them as system messages so the model sees them next turn.
+        const eventsToReplay = this.replayQueue.onTurnComplete();
+        if (eventsToReplay.length > 0) {
+            const messages = this.replayQueue.formatReplays(eventsToReplay);
+            for (const msg of messages) {
+                if (this.systemMessageRouter) {
+                    this.systemMessageRouter.low(msg);
                 }
                 else {
-                    getIdempotencyStore(this.coreServices, this.ownedIdempotencyStore).markComplete(this.currentSubmissionKey);
+                    this.conversation.addSystemMessage(msg);
                 }
-                this.currentSubmissionKey = null;
-                this._turnFailed = false;
             }
-            this.stopThinking();
-            const durationMs = Date.now() - turnStartTime;
-            const notifyEnabled = configManager.get('behavior.notifyOnComplete');
-            if (notifyEnabled !== false) {
-                notifyCompletion('GoodVibes', `Response complete (${Math.round(durationMs / 1000)}s)`, durationMs);
-            }
-            // ── Event replay queue ────────────────────────────────────────────────
-            // Signal turn completion; if any tracked events went unacknowledged,
-            // inject them as system messages so the model sees them next turn.
-            const eventsToReplay = this.replayQueue.onTurnComplete();
-            if (eventsToReplay.length > 0) {
-                const messages = this.replayQueue.formatReplays(eventsToReplay);
-                for (const msg of messages) {
-                    if (this.systemMessageRouter) {
-                        this.systemMessageRouter.low(msg);
-                    }
-                    else {
-                        this.conversation.addSystemMessage(msg);
-                    }
-                }
-                this.requestRender();
-            }
-            this.followUpRuntime.scheduleFlush();
+            this.requestRender();
         }
+        this.followUpRuntime.scheduleFlush();
     }
     /**
      * Pre-flight context window check.

package/dist/platform/core/plan-command-handler.d.ts

@@ -19,7 +19,7 @@ export interface PlanCommandResult {
 }
 export interface PlanCommandDeps {
     adaptivePlanner: Pick<AdaptivePlannerType, 'getMode' | 'setMode' | 'explain' | 'override' | 'clearOverride' | 'getOverride' | 'getLatest'>;
-    runtimeBus?: RuntimeEventBus | null;
+    runtimeBus?: RuntimeEventBus | null | undefined;
 }
 /**
  * Dispatch a parsed /plan subcommand.

package/dist/platform/core/plan-command-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-command-handler.d.ts","sourceRoot":"","sources":["../../../src/platform/core/plan-command-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,IAAI,CACnB,mBAAmB,EACnB,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAC/F,CAAC;IACF,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACrC;AAcD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,iBAAiB,CAgHnB"}
+{"version":3,"file":"plan-command-handler.d.ts","sourceRoot":"","sources":["../../../src/platform/core/plan-command-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,IAAI,CACnB,mBAAmB,EACnB,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAC/F,CAAC;IACF,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;CACjD;AAcD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,iBAAiB,CAgHnB"}

package/dist/platform/core/replay-command-handler.js

@@ -67,7 +67,7 @@ export function handleReplayCommand(deps, subcommand, args, ledger) {
             // Here we use an empty-domain snapshot as the baseline; domain state will be
             // populated incrementally as events are replayed.
             const syntheticSnapshot = {
-                capturedAt: entries[0].ts,
+                capturedAt: entries[0]?.ts ?? Date.now(),
                 domains: [],
             };
             engine.load(runId, syntheticSnapshot, entries);
@@ -77,8 +77,8 @@ export function handleReplayCommand(deps, subcommand, args, ledger) {
                 output: [
                     `Run "${runId}" loaded.`,
                     `  Events: ${entries.length}`,
-                    `  First: ${new Date(entries[0].ts).toISOString()}`,
-                    `  Last:  ${new Date(entries[entries.length - 1].ts).toISOString()}`,
+                    `  First: ${new Date(entries[0]?.ts ?? Date.now()).toISOString()}`,
+                    `  Last:  ${new Date(entries[entries.length - 1]?.ts ?? Date.now()).toISOString()}`,
                     '',
                     'Use /replay step to advance, /replay seek <rev> to jump, /replay diff to compare.',
                 ].join('\n'),

package/dist/platform/core/session-lineage.d.ts

@@ -10,8 +10,7 @@
  *   - Owned instance: wire a `SessionLineageTracker` through bootstrap/services.
  *   - Session-scoped: call `reset()` when starting a new session.
  *   - Append-only: entries are never modified or removed after being added.
- *   - `setOriginalTask()` is idempotent — subsequent calls are silently ignored
- *     to support multiple init paths that may each attempt to set the task.
+ *   - `setOriginalTask()` is idempotent — only the first call takes effect.
  */
 export declare class SessionLineageTracker {
     private originalTask;
@@ -25,7 +24,7 @@ export declare class SessionLineageTracker {
     /**
      * Add a compaction entry. Called after each successful compaction.
      * Increments the internal counter and appends one line: `- #N: {summary}`
-     * Empty or whitespace-only summaries are silently ignored.
+     * Empty or whitespace-only summaries do not create entries.
      */
     addCompactionEntry(summary: string): void;
     /** Reset to initial state. Use when starting a new session. */

package/dist/platform/core/session-lineage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-lineage.d.ts","sourceRoot":"","sources":["../../../src/platform/core/session-lineage.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAKb,+CAA+C;IAC/C,kBAAkB,IAAI,MAAM;IAI5B,8DAA8D;IAC9D,UAAU,IAAI,MAAM,EAAE;IAItB;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;CAcxB"}
+{"version":3,"file":"session-lineage.d.ts","sourceRoot":"","sources":["../../../src/platform/core/session-lineage.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAKb,+CAA+C;IAC/C,kBAAkB,IAAI,MAAM;IAI5B,8DAA8D;IAC9D,UAAU,IAAI,MAAM,EAAE;IAItB;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;CAcxB"}

package/dist/platform/core/session-lineage.js

@@ -10,8 +10,7 @@
  *   - Owned instance: wire a `SessionLineageTracker` through bootstrap/services.
  *   - Session-scoped: call `reset()` when starting a new session.
  *   - Append-only: entries are never modified or removed after being added.
- *   - `setOriginalTask()` is idempotent — subsequent calls are silently ignored
- *     to support multiple init paths that may each attempt to set the task.
+ *   - `setOriginalTask()` is idempotent — only the first call takes effect.
  */
 export class SessionLineageTracker {
     originalTask = null;
@@ -29,7 +28,7 @@ export class SessionLineageTracker {
     /**
      * Add a compaction entry. Called after each successful compaction.
      * Increments the internal counter and appends one line: `- #N: {summary}`
-     * Empty or whitespace-only summaries are silently ignored.
+     * Empty or whitespace-only summaries do not create entries.
      */
     addCompactionEntry(summary) {
         const trimmed = summary.trim();

package/dist/platform/core/tool-reconciliation.d.ts

@@ -21,7 +21,7 @@ export interface SyntheticToolResult extends ToolResult {
      * LLM-directed guidance for the model — separate from the operational `error`
      * field so telemetry and rendering can treat them independently.
      */
-    readonly instruction?: string;
+    readonly instruction?: string | undefined;
 }
 /**
  * Describes why the reconciler had to synthesize a tool result.
@@ -57,7 +57,7 @@ export interface ReconciliationEvent {
      * `true` when the event was triggered by a malformed provider response
      * (stopReason=tool_use with zero tool calls). Useful for telemetry triage.
      */
-    isMalformed?: boolean;
+    isMalformed?: boolean | undefined;
 }
 /**
  * Builds a synthetic error result for a tool call that was never executed.

package/dist/platform/core/tool-reconciliation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-reconciliation.d.ts","sourceRoot":"","sources":["../../../src/platform/core/tool-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,uBAAuB,GACvB,0BAA0B,GAC1B,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CASrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,GACpB,QAAQ,EAAE,CAGZ"}
+{"version":3,"file":"tool-reconciliation.d.ts","sourceRoot":"","sources":["../../../src/platform/core/tool-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,uBAAuB,GACvB,0BAA0B,GAC1B,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CASrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,GACpB,QAAQ,EAAE,CAGZ"}

package/dist/platform/core/transcript-events/types.d.ts

@@ -7,6 +7,6 @@ export interface TranscriptEvent {
     readonly groupKey: string;
     readonly title: string;
     readonly detail: string;
-    readonly relatedCallId?: string;
+    readonly relatedCallId?: string | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/platform/core/transcript-events/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/core/transcript-events/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,kBAAkB,GAClB,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/core/transcript-events/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,kBAAkB,GAClB,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C"}

package/dist/platform/daemon/cli.js

@@ -88,7 +88,10 @@ async function main() {
     ]);
     const shutdown = async () => {
         await Promise.allSettled([listener.stop(), daemon.stop()]);
-        process.exit(0);
+        // Set exitCode rather than calling process.exit(0) so that any
+        // already-queued I/O (log flushes, connection drains) can complete
+        // before the process terminates naturally.
+        process.exitCode = 0;
     };
     process.on('SIGINT', () => void shutdown());
     process.on('SIGTERM', () => void shutdown());