@qduc/term2 0.7.3 → 0.8.0

package/dist/services/session/turn-executor.d.ts

@@ -0,0 +1,28 @@
+import type { ConversationEvent } from '../conversation/conversation-events.js';
+import type { ShellAutoApprovalResolver } from '../approval/shell-auto-approval-resolver.js';
+import type { UserTurn } from '../../types/user-turn.js';
+import type { InitialTurnRunOptions } from './turn-attempt-factory.js';
+import type { InitialTurnRunner } from './initial-turn-runner.js';
+import type { ContinuationDriver } from './continuation-driver.js';
+import { type TurnOutcome } from './turn-transition.js';
+export interface ApprovalContinuationInput {
+    answer: string;
+    rejectionReason?: string;
+    generation: number;
+}
+export interface TurnExecutor {
+    executeInitial(input: string | UserTurn, options: InitialTurnRunOptions): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
+    executeContinuation(input: ApprovalContinuationInput): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
+}
+export interface DefaultTurnExecutorDeps {
+    initialTurnRunner: InitialTurnRunner;
+    continuationDriver: ContinuationDriver;
+    shellAutoApproval: ShellAutoApprovalResolver;
+}
+export declare class DefaultTurnExecutor implements TurnExecutor {
+    private readonly deps;
+    constructor(deps: DefaultTurnExecutorDeps);
+    executeInitial(input: string | UserTurn, options?: InitialTurnRunOptions): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
+    executeContinuation({ answer, rejectionReason, generation, }: ApprovalContinuationInput): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
+}
+//# sourceMappingURL=turn-executor.d.ts.map

package/dist/services/session/turn-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-executor.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAE7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,CACZ,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAExD,mBAAmB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;CAC7G;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,yBAAyB,CAAC;CAC9C;AAED,qBAAa,mBAAoB,YAAW,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,uBAAuB;IAEnD,cAAc,CACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC;IAkDhD,mBAAmB,CAAC,EACzB,MAAM,EACN,eAAe,EACf,UAAU,GACX,EAAE,yBAAyB,GAAG,cAAc,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC;CAyBpF"}

package/dist/services/session/turn-executor.js

@@ -0,0 +1,67 @@
+import { ShellAutoApprovalDecisionPolicy } from '../approval/approval-decision-policy.js';
+import { decideTurnTransition } from './turn-transition.js';
+export class DefaultTurnExecutor {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async *executeInitial(input, options = {}) {
+        let currentInput = input;
+        let currentOptions = options;
+        while (true) {
+            const initialOutcome = yield* this.deps.initialTurnRunner.run(currentInput, currentOptions);
+            if (initialOutcome.kind !== 'abort_resolution_required' && initialOutcome.kind !== 'auto_approval_required') {
+                return initialOutcome;
+            }
+            const generation = initialOutcome.generation;
+            let driveResult;
+            if (initialOutcome.kind === 'abort_resolution_required') {
+                driveResult = yield* this.deps.continuationDriver.drive({
+                    kind: 'abort_resolution',
+                    abortedContext: initialOutcome.abortedContext,
+                    userText: initialOutcome.userText,
+                    generation,
+                }, new ShellAutoApprovalDecisionPolicy(this.deps.shellAutoApproval));
+            }
+            else {
+                driveResult = yield* this.deps.continuationDriver.drive({
+                    kind: 'approval_decision',
+                    answer: 'y',
+                    generation,
+                }, new ShellAutoApprovalDecisionPolicy(this.deps.shellAutoApproval));
+            }
+            if (driveResult.kind !== 'fresh_start_required') {
+                return driveResult;
+            }
+            const transition = decideTurnTransition('continuing', driveResult);
+            if (transition.command.kind !== 're_drive') {
+                throw new Error(`Expected re_drive command, received ${transition.command.kind}`);
+            }
+            currentInput = { text: '' };
+            currentOptions = {
+                ...transition.command.options,
+                token: generation,
+            };
+        }
+    }
+    async *executeContinuation({ answer, rejectionReason, generation, }) {
+        const driveResult = yield* this.deps.continuationDriver.drive({
+            kind: 'approval_decision',
+            answer,
+            rejectionReason,
+            generation,
+        });
+        if (driveResult.kind !== 'fresh_start_required') {
+            return driveResult;
+        }
+        const transition = decideTurnTransition('continuing', driveResult);
+        if (transition.command.kind !== 're_drive') {
+            throw new Error(`Expected re_drive command, received ${transition.command.kind}`);
+        }
+        return yield* this.executeInitial({ text: '' }, {
+            ...transition.command.options,
+            token: generation,
+        });
+    }
+}
+//# sourceMappingURL=turn-executor.js.map

package/dist/services/session/turn-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-executor.js","sourceRoot":"","sources":["../../../source/services/session/turn-executor.ts"],"names":[],"mappings":"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"}

package/dist/services/session/turn-item-accumulator.d.ts

@@ -0,0 +1,21 @@
+import type { NormalizedUsage } from '../../utils/ai/token-usage.js';
+import type { PersistedAssistantTurnItem } from '../conversation/conversation-persistence-types.js';
+export declare class TurnItemAccumulator {
+    private items;
+    private reasoningBuffer;
+    private assistantTextBuffer;
+    private displayUsage;
+    flushReasoningItem(): void;
+    flushAssistantTextItem(): void;
+    recordToolCallItem(callId: string, toolName: string, args: unknown): void;
+    recordToolResultItem(callId: string, toolName: string, status: 'completed' | 'failed' | 'aborted', output: unknown): void;
+    resetPersistedTurnState(): void;
+    getTurnItems(): PersistedAssistantTurnItem[];
+    getDisplayUsage(): NormalizedUsage | undefined;
+    setDisplayUsage(usage: NormalizedUsage): void;
+    appendTextDelta(delta: string): void;
+    appendReasoningDelta(delta: string): void;
+    hasReasoningBuffer(): boolean;
+    hasTextBuffer(): boolean;
+}
+//# sourceMappingURL=turn-item-accumulator.d.ts.map

package/dist/services/session/turn-item-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-item-accumulator.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-item-accumulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAEpG,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,YAAY,CAA8B;IAElD,kBAAkB,IAAI,IAAI;IAO1B,sBAAsB,IAAI,IAAI;IAO9B,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAMzE,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,EAC1C,MAAM,EAAE,OAAO,GACd,IAAI;IAMP,uBAAuB,IAAI,IAAI;IAO/B,YAAY,IAAI,0BAA0B,EAAE;IAI5C,eAAe,IAAI,eAAe,GAAG,SAAS;IAI9C,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI7C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,kBAAkB,IAAI,OAAO;IAI7B,aAAa,IAAI,OAAO;CAGzB"}

package/dist/services/session/turn-item-accumulator.js

@@ -0,0 +1,56 @@
+export class TurnItemAccumulator {
+    items = [];
+    reasoningBuffer = '';
+    assistantTextBuffer = '';
+    displayUsage;
+    flushReasoningItem() {
+        if (this.reasoningBuffer) {
+            this.items.push({ type: 'reasoning', text: this.reasoningBuffer });
+            this.reasoningBuffer = '';
+        }
+    }
+    flushAssistantTextItem() {
+        if (this.assistantTextBuffer) {
+            this.items.push({ type: 'assistant_text', text: this.assistantTextBuffer });
+            this.assistantTextBuffer = '';
+        }
+    }
+    recordToolCallItem(callId, toolName, args) {
+        this.flushReasoningItem();
+        this.flushAssistantTextItem();
+        this.items.push({ type: 'tool_call', callId, toolName, arguments: args });
+    }
+    recordToolResultItem(callId, toolName, status, output) {
+        this.flushReasoningItem();
+        this.flushAssistantTextItem();
+        this.items.push({ type: 'tool_result', callId, toolName, status, output });
+    }
+    resetPersistedTurnState() {
+        this.items = [];
+        this.reasoningBuffer = '';
+        this.assistantTextBuffer = '';
+        this.displayUsage = undefined;
+    }
+    getTurnItems() {
+        return this.items;
+    }
+    getDisplayUsage() {
+        return this.displayUsage;
+    }
+    setDisplayUsage(usage) {
+        this.displayUsage = usage;
+    }
+    appendTextDelta(delta) {
+        this.assistantTextBuffer += delta;
+    }
+    appendReasoningDelta(delta) {
+        this.reasoningBuffer += delta;
+    }
+    hasReasoningBuffer() {
+        return this.reasoningBuffer.length > 0;
+    }
+    hasTextBuffer() {
+        return this.assistantTextBuffer.length > 0;
+    }
+}
+//# sourceMappingURL=turn-item-accumulator.js.map

package/dist/services/session/turn-item-accumulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-item-accumulator.js","sourceRoot":"","sources":["../../../source/services/session/turn-item-accumulator.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAiC,EAAE,CAAC;IACzC,eAAe,GAAG,EAAE,CAAC;IACrB,mBAAmB,GAAG,EAAE,CAAC;IACzB,YAAY,CAA8B;IAElD,kBAAkB;QAChB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,sBAAsB;QACpB,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,QAAgB,EAAE,IAAa;QAChE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,oBAAoB,CAClB,MAAc,EACd,QAAgB,EAChB,MAA0C,EAC1C,MAAe;QAEf,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,uBAAuB;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,eAAe,CAAC,KAAsB;QACpC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,eAAe,CAAC,KAAa;QAC3B,IAAI,CAAC,mBAAmB,IAAI,KAAK,CAAC;IACpC,CAAC;IAED,oBAAoB,CAAC,KAAa;QAChC,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC;IAChC,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/services/session/turn-item-accumulator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turn-item-accumulator.test.d.ts.map

package/dist/services/session/turn-item-accumulator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-item-accumulator.test.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-item-accumulator.test.ts"],"names":[],"mappings":""}

package/dist/services/session/turn-item-accumulator.test.js

@@ -0,0 +1,75 @@
+import { it, expect } from 'vitest';
+import { TurnItemAccumulator } from './turn-item-accumulator.js';
+it('flushReasoningItem flushes non-empty buffer and is a no-op when empty', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.flushReasoningItem();
+    expect(accumulator.getTurnItems()).toEqual([]);
+    accumulator.appendReasoningDelta('thinking');
+    accumulator.flushReasoningItem();
+    expect(accumulator.getTurnItems()).toEqual([{ type: 'reasoning', text: 'thinking' }]);
+});
+it('flushAssistantTextItem flushes non-empty buffer and is a no-op when empty', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.flushAssistantTextItem();
+    expect(accumulator.getTurnItems()).toEqual([]);
+    accumulator.appendTextDelta('hello');
+    accumulator.flushAssistantTextItem();
+    expect(accumulator.getTurnItems()).toEqual([{ type: 'assistant_text', text: 'hello' }]);
+});
+it('recordToolCallItem flushes both buffers before recording the tool call', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.appendReasoningDelta('reason');
+    accumulator.appendTextDelta('text');
+    accumulator.recordToolCallItem('call-1', 'search', { query: 'term2' });
+    expect(accumulator.getTurnItems()).toEqual([
+        { type: 'reasoning', text: 'reason' },
+        { type: 'assistant_text', text: 'text' },
+        { type: 'tool_call', callId: 'call-1', toolName: 'search', arguments: { query: 'term2' } },
+    ]);
+});
+it('recordToolResultItem flushes both buffers before recording the tool result', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.appendReasoningDelta('reason');
+    accumulator.appendTextDelta('text');
+    accumulator.recordToolResultItem('call-1', 'search', 'completed', { answer: 'done' });
+    expect(accumulator.getTurnItems()).toEqual([
+        { type: 'reasoning', text: 'reason' },
+        { type: 'assistant_text', text: 'text' },
+        { type: 'tool_result', callId: 'call-1', toolName: 'search', status: 'completed', output: { answer: 'done' } },
+    ]);
+});
+it('resetPersistedTurnState clears all state', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.appendReasoningDelta('reason');
+    accumulator.appendTextDelta('text');
+    accumulator.setDisplayUsage({ prompt_tokens: 1 });
+    accumulator.recordToolCallItem('call-1', 'search', {});
+    accumulator.resetPersistedTurnState();
+    expect(accumulator.getTurnItems()).toEqual([]);
+    expect(accumulator.getDisplayUsage()).toBe(undefined);
+    expect(accumulator.hasReasoningBuffer()).toBe(false);
+    expect(accumulator.hasTextBuffer()).toBe(false);
+});
+it('appendTextDelta and appendReasoningDelta accumulate deltas', () => {
+    const accumulator = new TurnItemAccumulator();
+    accumulator.appendTextDelta('hel');
+    accumulator.appendTextDelta('lo');
+    accumulator.appendReasoningDelta('th');
+    accumulator.appendReasoningDelta('ink');
+    expect(accumulator.hasTextBuffer()).toBe(true);
+    expect(accumulator.hasReasoningBuffer()).toBe(true);
+    accumulator.flushAssistantTextItem();
+    accumulator.flushReasoningItem();
+    expect(accumulator.getTurnItems()).toEqual([
+        { type: 'assistant_text', text: 'hello' },
+        { type: 'reasoning', text: 'think' },
+    ]);
+});
+it('getDisplayUsage and setDisplayUsage track display usage', () => {
+    const accumulator = new TurnItemAccumulator();
+    const usage = { prompt_tokens: 12, completion_tokens: 34 };
+    expect(accumulator.getDisplayUsage()).toBe(undefined);
+    accumulator.setDisplayUsage(usage);
+    expect(accumulator.getDisplayUsage()).toEqual(usage);
+});
+//# sourceMappingURL=turn-item-accumulator.test.js.map

package/dist/services/session/turn-item-accumulator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-item-accumulator.test.js","sourceRoot":"","sources":["../../../source/services/session/turn-item-accumulator.test.ts"],"names":[],"mappings":"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"}

package/dist/services/session/turn-outcome-adapters.d.ts

@@ -0,0 +1,26 @@
+import type { InitialTurnOutcome } from './initial-turn-runner.js';
+import type { ContinuationDriveResult } from './continuation-driver.js';
+import type { ContinuingTurnOutcome, StreamingTurnOutcome } from './turn-transition.js';
+export type DirectInitialTurnOutcome = Exclude<InitialTurnOutcome, {
+    kind: 'abort_resolution_required' | 'auto_approval_required';
+}>;
+/**
+ * Convert an InitialTurnOutcome (from initial-turn-runner.ts) to the
+ * canonical TurnOutcome type used by the transition engine.
+ *
+ * The mapping is nearly 1:1 — both types share the same field names
+ * for `response` and `approval_required`, and the `failed` / `stale`
+ * variants translate directly.
+ */
+export declare function fromInitialOutcome(outcome: DirectInitialTurnOutcome): StreamingTurnOutcome;
+/**
+ * Convert a ContinuationDriveResult (from continuation-driver.ts) to the
+ * canonical TurnOutcome type.
+ *
+ * Field names now match directly (`terminal` in both), so `response`,
+ * `approval_required`, and `stale` pass through unchanged.
+ * `fresh_start_required` spreads `RecoveryInstructions` fields
+ * (`delayMs`, `useStandardServiceTier`) alongside `retryCounts`.
+ */
+export declare function fromDriveResult(result: ContinuationDriveResult): ContinuingTurnOutcome;
+//# sourceMappingURL=turn-outcome-adapters.d.ts.map

package/dist/services/session/turn-outcome-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-outcome-adapters.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-outcome-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIxF,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,kBAAkB,EAClB;IAAE,IAAI,EAAE,2BAA2B,GAAG,wBAAwB,CAAA;CAAE,CACjE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,wBAAwB,GAAG,oBAAoB,CAc1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,qBAAqB,CAetF"}

package/dist/services/session/turn-outcome-adapters.js

@@ -0,0 +1,45 @@
+/**
+ * Convert an InitialTurnOutcome (from initial-turn-runner.ts) to the
+ * canonical TurnOutcome type used by the transition engine.
+ *
+ * The mapping is nearly 1:1 — both types share the same field names
+ * for `response` and `approval_required`, and the `failed` / `stale`
+ * variants translate directly.
+ */
+export function fromInitialOutcome(outcome) {
+    switch (outcome.kind) {
+        case 'response':
+            return { kind: 'response', terminal: outcome.terminal };
+        case 'approval_required':
+            return { kind: 'approval_required', terminal: outcome.terminal };
+        case 'failed':
+            return { kind: 'failed' };
+        case 'stale':
+            return { kind: 'stale' };
+    }
+}
+/**
+ * Convert a ContinuationDriveResult (from continuation-driver.ts) to the
+ * canonical TurnOutcome type.
+ *
+ * Field names now match directly (`terminal` in both), so `response`,
+ * `approval_required`, and `stale` pass through unchanged.
+ * `fresh_start_required` spreads `RecoveryInstructions` fields
+ * (`delayMs`, `useStandardServiceTier`) alongside `retryCounts`.
+ */
+export function fromDriveResult(result) {
+    switch (result.kind) {
+        case 'response':
+        case 'approval_required':
+        case 'stale':
+            return result;
+        case 'fresh_start_required':
+            return {
+                kind: 'fresh_start_required',
+                retryCounts: result.retryCounts,
+                ...(result.delayMs !== undefined ? { delayMs: result.delayMs } : {}),
+                ...(result.useStandardServiceTier ? { useStandardServiceTier: true } : {}),
+            };
+    }
+}
+//# sourceMappingURL=turn-outcome-adapters.js.map

package/dist/services/session/turn-outcome-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-outcome-adapters.js","sourceRoot":"","sources":["../../../source/services/session/turn-outcome-adapters.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAiC;IAClE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QAE1D,KAAK,mBAAmB;YACtB,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEnE,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAE5B,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC;QAChB,KAAK,mBAAmB,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC;QAEhB,KAAK,sBAAsB;YACzB,OAAO;gBACL,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/services/session/turn-outcome-adapters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turn-outcome-adapters.test.d.ts.map

package/dist/services/session/turn-outcome-adapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-outcome-adapters.test.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-outcome-adapters.test.ts"],"names":[],"mappings":""}

package/dist/services/session/turn-outcome-adapters.test.js

@@ -0,0 +1,101 @@
+import { it, expect } from 'vitest';
+import { fromInitialOutcome, fromDriveResult } from './turn-outcome-adapters.js';
+// ── Helpers ────────────────────────────────────────────────────
+const terminalResponse = {
+    type: 'response',
+    commandMessages: [],
+    finalText: 'hello',
+};
+const terminalApproval = {
+    type: 'approval_required',
+    approval: {
+        agentName: 'test',
+        toolName: 'shell',
+        argumentsText: 'ls',
+        rawInterruption: {},
+    },
+};
+const defaultRetryCounts = {
+    transientRetryCount: 1,
+    serviceTierFallbackCount: 0,
+    modelRetryCount: 0,
+    transportDowngradeCount: 0,
+};
+// ── fromInitialOutcome ─────────────────────────────────────────
+it('fromInitialOutcome maps response correctly', () => {
+    const outcome = { kind: 'response', terminal: terminalResponse };
+    const result = fromInitialOutcome(outcome);
+    expect(result.kind).toBe('response');
+    if (result.kind === 'response') {
+        expect(result.terminal).toBe(terminalResponse);
+    }
+});
+it('fromInitialOutcome maps approval_required correctly', () => {
+    const outcome = { kind: 'approval_required', terminal: terminalApproval };
+    const result = fromInitialOutcome(outcome);
+    expect(result.kind).toBe('approval_required');
+    if (result.kind === 'approval_required') {
+        expect(result.terminal).toBe(terminalApproval);
+    }
+});
+it('fromInitialOutcome maps failed correctly', () => {
+    const outcome = { kind: 'failed' };
+    const result = fromInitialOutcome(outcome);
+    expect(result.kind).toBe('failed');
+});
+it('fromInitialOutcome maps stale correctly', () => {
+    const outcome = { kind: 'stale' };
+    const result = fromInitialOutcome(outcome);
+    expect(result.kind).toBe('stale');
+});
+// ── fromDriveResult ────────────────────────────────────────────
+it('fromDriveResult maps response correctly', () => {
+    const driveResult = { kind: 'response', terminal: terminalResponse };
+    const result = fromDriveResult(driveResult);
+    expect(result.kind).toBe('response');
+    if (result.kind === 'response') {
+        expect(result.terminal).toBe(terminalResponse);
+    }
+});
+it('fromDriveResult maps approval_required correctly', () => {
+    const driveResult = { kind: 'approval_required', terminal: terminalApproval };
+    const result = fromDriveResult(driveResult);
+    expect(result.kind).toBe('approval_required');
+    if (result.kind === 'approval_required') {
+        expect(result.terminal).toBe(terminalApproval);
+    }
+});
+it('fromDriveResult maps stale correctly', () => {
+    const driveResult = { kind: 'stale' };
+    const result = fromDriveResult(driveResult);
+    expect(result.kind).toBe('stale');
+});
+it('fromDriveResult maps fresh_start_required with retryCounts only', () => {
+    const driveResult = {
+        kind: 'fresh_start_required',
+        retryCounts: defaultRetryCounts,
+    };
+    const result = fromDriveResult(driveResult);
+    expect(result.kind).toBe('fresh_start_required');
+    if (result.kind === 'fresh_start_required') {
+        expect(result.retryCounts).toBe(defaultRetryCounts);
+        expect(result.delayMs).toBe(undefined);
+        expect(result.useStandardServiceTier).toBe(undefined);
+    }
+});
+it('fromDriveResult maps fresh_start_required with retryCounts + delayMs + useStandardServiceTier', () => {
+    const driveResult = {
+        kind: 'fresh_start_required',
+        retryCounts: defaultRetryCounts,
+        delayMs: 500,
+        useStandardServiceTier: true,
+    };
+    const result = fromDriveResult(driveResult);
+    expect(result.kind).toBe('fresh_start_required');
+    if (result.kind === 'fresh_start_required') {
+        expect(result.retryCounts).toBe(defaultRetryCounts);
+        expect(result.delayMs).toBe(500);
+        expect(result.useStandardServiceTier).toBe(true);
+    }
+});
+//# sourceMappingURL=turn-outcome-adapters.test.js.map

package/dist/services/session/turn-outcome-adapters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-outcome-adapters.test.js","sourceRoot":"","sources":["../../../source/services/session/turn-outcome-adapters.test.ts"],"names":[],"mappings":"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"}

package/dist/services/session/turn-status-machine.d.ts

@@ -0,0 +1,25 @@
+export type SessionStatus = 'idle' | 'streaming' | 'awaiting_approval' | 'continuing';
+/**
+ * Transition validator for turn status.
+ *
+ * Only this class may mutate turn status. Resource cleanup remains with the
+ * use case that acquired the resource.
+ */
+export declare class TurnStatusMachine {
+    #private;
+    private status;
+    get current(): SessionStatus;
+    is(status: SessionStatus): boolean;
+    beginTurn(): void;
+    requestApproval(): void;
+    beginContinuation(): void;
+    /**
+     * Transitions to idle when the current status is streaming or continuing.
+     * When the status is awaiting_approval this is a no-op so the caller can
+     * safely call complete() in a finally block without losing the pending
+     * approval state.
+     */
+    complete(): void;
+    abort(): void;
+}
+//# sourceMappingURL=turn-status-machine.d.ts.map

package/dist/services/session/turn-status-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-status-machine.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAEtF;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAC5B,OAAO,CAAC,MAAM,CAAyB;IAEvC,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,EAAE,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIlC,SAAS,IAAI,IAAI;IAKjB,eAAe,IAAI,IAAI;IAOvB,iBAAiB,IAAI,IAAI;IAKzB;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;IAMhB,KAAK,IAAI,IAAI;CASd"}

package/dist/services/session/turn-status-machine.js

@@ -0,0 +1,49 @@
+/**
+ * Transition validator for turn status.
+ *
+ * Only this class may mutate turn status. Resource cleanup remains with the
+ * use case that acquired the resource.
+ */
+export class TurnStatusMachine {
+    status = 'idle';
+    get current() {
+        return this.status;
+    }
+    is(status) {
+        return this.status === status;
+    }
+    beginTurn() {
+        this.#assertTransition('idle', 'streaming');
+        this.status = 'streaming';
+    }
+    requestApproval() {
+        if (this.status !== 'streaming' && this.status !== 'continuing') {
+            throw new Error(`Cannot request approval from ${this.status}`);
+        }
+        this.status = 'awaiting_approval';
+    }
+    beginContinuation() {
+        this.#assertTransition('awaiting_approval', 'continuing');
+        this.status = 'continuing';
+    }
+    /**
+     * Transitions to idle when the current status is streaming or continuing.
+     * When the status is awaiting_approval this is a no-op so the caller can
+     * safely call complete() in a finally block without losing the pending
+     * approval state.
+     */
+    complete() {
+        if (this.status === 'streaming' || this.status === 'continuing') {
+            this.status = 'idle';
+        }
+    }
+    abort() {
+        this.status = 'idle';
+    }
+    #assertTransition(from, to) {
+        if (this.status !== from) {
+            throw new Error(`Invalid transition: ${this.status} -> ${to}`);
+        }
+    }
+}
+//# sourceMappingURL=turn-status-machine.js.map

package/dist/services/session/turn-status-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-status-machine.js","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAkB,MAAM,CAAC;IAEvC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,EAAE,CAAC,MAAqB;QACtB,OAAO,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;IAChC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC;IACpC,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,iBAAiB,CAAC,IAAmB,EAAE,EAAiB;QACtD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,OAAO,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}

package/dist/services/session/turn-status-machine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turn-status-machine.test.d.ts.map

package/dist/services/session/turn-status-machine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-status-machine.test.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.test.ts"],"names":[],"mappings":""}