@qduc/term2 0.7.2 → 0.8.0

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

@@ -0,0 +1,95 @@
+import { it, expect } from 'vitest';
+import { TurnStatusMachine } from './turn-status-machine.js';
+it('begins turn from idle', () => {
+    const machine = new TurnStatusMachine();
+    expect(machine.current).toBe('idle');
+    machine.beginTurn();
+    expect(machine.current).toBe('streaming');
+});
+it('beginTurn from non-idle throws', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    expect(() => machine.beginTurn()).toThrow(/Invalid transition.*streaming.*streaming/);
+});
+it('requestApproval from streaming succeeds', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    machine.requestApproval();
+    expect(machine.current).toBe('awaiting_approval');
+});
+it('requestApproval from continuing succeeds', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.beginContinuation();
+    machine.requestApproval();
+    expect(machine.current).toBe('awaiting_approval');
+});
+it('requestApproval from idle or awaiting_approval throws', () => {
+    const machine = new TurnStatusMachine();
+    expect(() => machine.requestApproval()).toThrow(/Cannot request approval from idle/);
+    machine.beginTurn();
+    machine.requestApproval();
+    expect(() => machine.requestApproval()).toThrow(/Cannot request approval from awaiting_approval/);
+});
+it('beginContinuation from awaiting_approval succeeds', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.beginContinuation();
+    expect(machine.current).toBe('continuing');
+});
+it('beginContinuation from non-awaiting_approval throws', () => {
+    const machine = new TurnStatusMachine();
+    expect(() => machine.beginContinuation()).toThrow(/Invalid transition.*idle.*continuing/);
+    machine.beginTurn();
+    expect(() => machine.beginContinuation()).toThrow(/Invalid transition.*streaming.*continuing/);
+});
+it('complete from streaming returns to idle', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    machine.complete();
+    expect(machine.current).toBe('idle');
+});
+it('complete from continuing returns to idle', () => {
+    const machine = new TurnStatusMachine();
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.beginContinuation();
+    machine.complete();
+    expect(machine.current).toBe('idle');
+});
+it('complete from idle and awaiting_approval is a no-op', () => {
+    const machine = new TurnStatusMachine();
+    machine.complete();
+    expect(machine.current).toBe('idle');
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.complete();
+    expect(machine.current).toBe('awaiting_approval');
+});
+it('abort from any state returns to idle', () => {
+    const machine = new TurnStatusMachine();
+    machine.abort();
+    expect(machine.current).toBe('idle');
+    machine.beginTurn();
+    machine.abort();
+    expect(machine.current).toBe('idle');
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.abort();
+    expect(machine.current).toBe('idle');
+    machine.beginTurn();
+    machine.requestApproval();
+    machine.beginContinuation();
+    machine.abort();
+    expect(machine.current).toBe('idle');
+});
+it('is helper matches current status', () => {
+    const machine = new TurnStatusMachine();
+    expect(machine.is('idle')).toBe(true);
+    machine.beginTurn();
+    expect(machine.is('streaming')).toBe(true);
+    expect(machine.is('idle')).toBe(false);
+});
+//# sourceMappingURL=turn-status-machine.test.js.map

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

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

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

@@ -0,0 +1,57 @@
+import type { ConversationTerminal } from '../../contracts/conversation.js';
+import type { AbortedApprovalContext } from '../approval/approval-state.js';
+import type { RetryCounts } from '../retry/retry-contracts.js';
+export type TurnState = 'idle' | 'streaming' | 'awaiting_approval' | 'continuing';
+export type TurnOutcome = {
+    kind: 'response';
+    terminal: ConversationTerminal;
+} | {
+    kind: 'approval_required';
+    terminal: ConversationTerminal;
+} | {
+    kind: 'stale';
+} | {
+    kind: 'failed';
+} | {
+    kind: 'fresh_start_required';
+    retryCounts: RetryCounts;
+    delayMs?: number;
+    useStandardServiceTier?: boolean;
+} | {
+    kind: 'abort_resolution_required';
+    abortedContext: AbortedApprovalContext;
+    userText: string;
+    generation: number;
+} | {
+    kind: 'auto_approval_required';
+    generation: number;
+    callId?: string;
+    command?: string;
+};
+export type TurnCommand = {
+    kind: 'emit_terminal';
+    terminal: ConversationTerminal;
+} | {
+    kind: 're_drive';
+    options: {
+        skipUserMessage: true;
+        retries: RetryCounts;
+        delayMs?: number;
+        useStandardServiceTier?: boolean;
+    };
+} | {
+    kind: 'none';
+};
+export interface TurnTransition {
+    next: TurnState;
+    command: TurnCommand;
+}
+/**
+ * Pure function that determines the next turn state and command
+ * given the current state and the outcome of a turn attempt.
+ *
+ * Throws on invalid state/outcome combinations (e.g. outcomes
+ * received while in `idle` or `awaiting_approval`).
+ */
+export declare function decideTurnTransition(current: TurnState, outcome: TurnOutcome): TurnTransition;
+//# sourceMappingURL=turn-transition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-transition.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAElF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9G;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,cAAc,EAAE,sBAAsB,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QAAE,eAAe,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9G,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB;AAQD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CAwD7F"}

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

@@ -0,0 +1,67 @@
+const assertNever = (value) => {
+    throw new Error(`Unhandled turn outcome: ${JSON.stringify(value)}`);
+};
+// ── Transition function ────────────────────────────────────────
+/**
+ * Pure function that determines the next turn state and command
+ * given the current state and the outcome of a turn attempt.
+ *
+ * Throws on invalid state/outcome combinations (e.g. outcomes
+ * received while in `idle` or `awaiting_approval`).
+ */
+export function decideTurnTransition(current, outcome) {
+    if (outcome.kind === 'abort_resolution_required' || outcome.kind === 'auto_approval_required') {
+        throw new Error(`Invalid transition: outcome ${outcome.kind} is not allowed in transition rules`);
+    }
+    switch (current) {
+        case 'idle':
+        case 'awaiting_approval':
+            throw new Error(`Invalid transition from ${current}: received ${outcome.kind}`);
+        case 'streaming': {
+            switch (outcome.kind) {
+                case 'response':
+                    return { next: 'idle', command: { kind: 'emit_terminal', terminal: outcome.terminal } };
+                case 'approval_required':
+                    return { next: 'awaiting_approval', command: { kind: 'emit_terminal', terminal: outcome.terminal } };
+                case 'stale':
+                    return { next: 'streaming', command: { kind: 'none' } };
+                case 'failed':
+                    return { next: 'idle', command: { kind: 'none' } };
+                case 'fresh_start_required':
+                    throw new Error('Invalid outcome fresh_start_required for state streaming');
+                default:
+                    return assertNever(outcome);
+            }
+        }
+        case 'continuing': {
+            switch (outcome.kind) {
+                case 'response':
+                    return { next: 'idle', command: { kind: 'emit_terminal', terminal: outcome.terminal } };
+                case 'approval_required':
+                    return { next: 'awaiting_approval', command: { kind: 'emit_terminal', terminal: outcome.terminal } };
+                case 'stale':
+                    return { next: 'continuing', command: { kind: 'none' } };
+                case 'fresh_start_required':
+                    return {
+                        next: 'streaming',
+                        command: {
+                            kind: 're_drive',
+                            options: {
+                                skipUserMessage: true,
+                                retries: outcome.retryCounts,
+                                delayMs: outcome.delayMs,
+                                useStandardServiceTier: outcome.useStandardServiceTier,
+                            },
+                        },
+                    };
+                case 'failed':
+                    throw new Error('Invalid outcome failed for state continuing');
+                default:
+                    return assertNever(outcome);
+            }
+        }
+        default:
+            return assertNever(current);
+    }
+}
+//# sourceMappingURL=turn-transition.js.map

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

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

package/dist/services/session/turn-transition.test.d.ts

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

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

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

package/dist/services/session/turn-transition.test.js

@@ -0,0 +1,123 @@
+import { it, expect } from 'vitest';
+import { decideTurnTransition } from './turn-transition.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,
+};
+// ── Valid transitions: streaming ───────────────────────────────
+it('streaming + response → idle + emit_terminal', () => {
+    const result = decideTurnTransition('streaming', { kind: 'response', terminal: terminalResponse });
+    expect(result.next).toBe('idle');
+    expect(result.command.kind).toBe('emit_terminal');
+    if (result.command.kind === 'emit_terminal') {
+        expect(result.command.terminal).toBe(terminalResponse);
+    }
+});
+it('streaming + approval_required → awaiting_approval + emit_terminal', () => {
+    const result = decideTurnTransition('streaming', { kind: 'approval_required', terminal: terminalApproval });
+    expect(result.next).toBe('awaiting_approval');
+    expect(result.command.kind).toBe('emit_terminal');
+    if (result.command.kind === 'emit_terminal') {
+        expect(result.command.terminal).toBe(terminalApproval);
+    }
+});
+it('streaming + stale → streaming + none', () => {
+    const result = decideTurnTransition('streaming', { kind: 'stale' });
+    expect(result.next).toBe('streaming');
+    expect(result.command.kind).toBe('none');
+});
+it('streaming + failed → idle + none', () => {
+    const result = decideTurnTransition('streaming', { kind: 'failed' });
+    expect(result.next).toBe('idle');
+    expect(result.command.kind).toBe('none');
+});
+// ── Valid transitions: continuing ──────────────────────────────
+it('continuing + response → idle + emit_terminal', () => {
+    const result = decideTurnTransition('continuing', { kind: 'response', terminal: terminalResponse });
+    expect(result.next).toBe('idle');
+    expect(result.command.kind).toBe('emit_terminal');
+    if (result.command.kind === 'emit_terminal') {
+        expect(result.command.terminal).toBe(terminalResponse);
+    }
+});
+it('continuing + approval_required → awaiting_approval + emit_terminal', () => {
+    const result = decideTurnTransition('continuing', { kind: 'approval_required', terminal: terminalApproval });
+    expect(result.next).toBe('awaiting_approval');
+    expect(result.command.kind).toBe('emit_terminal');
+    if (result.command.kind === 'emit_terminal') {
+        expect(result.command.terminal).toBe(terminalApproval);
+    }
+});
+it('continuing + stale → continuing + none', () => {
+    const result = decideTurnTransition('continuing', { kind: 'stale' });
+    expect(result.next).toBe('continuing');
+    expect(result.command.kind).toBe('none');
+});
+it('continuing + fresh_start_required → streaming + re_drive', () => {
+    const result = decideTurnTransition('continuing', {
+        kind: 'fresh_start_required',
+        retryCounts: defaultRetryCounts,
+    });
+    expect(result.next).toBe('streaming');
+    expect(result.command.kind).toBe('re_drive');
+    if (result.command.kind === 're_drive') {
+        expect(result.command.options.skipUserMessage).toBe(true);
+        expect(result.command.options.retries).toBe(defaultRetryCounts);
+        expect(result.command.options.delayMs).toBe(undefined);
+        expect(result.command.options.useStandardServiceTier).toBe(undefined);
+    }
+});
+it('continuing + fresh_start_required with delayMs and useStandardServiceTier', () => {
+    const result = decideTurnTransition('continuing', {
+        kind: 'fresh_start_required',
+        retryCounts: defaultRetryCounts,
+        delayMs: 500,
+        useStandardServiceTier: true,
+    });
+    expect(result.next).toBe('streaming');
+    expect(result.command.kind).toBe('re_drive');
+    if (result.command.kind === 're_drive') {
+        expect(result.command.options.skipUserMessage).toBe(true);
+        expect(result.command.options.delayMs).toBe(500);
+        expect(result.command.options.useStandardServiceTier).toBe(true);
+    }
+});
+// ── Invalid transitions ───────────────────────────────────────
+it('idle + any outcome throws', () => {
+    expect(() => decideTurnTransition('idle', { kind: 'stale' })).toThrow(/Invalid transition from idle/);
+    expect(() => decideTurnTransition('idle', { kind: 'failed' })).toThrow(/Invalid transition from idle/);
+    expect(() => decideTurnTransition('idle', { kind: 'response', terminal: terminalResponse })).toThrow(/Invalid transition from idle/);
+});
+it('awaiting_approval + any outcome throws', () => {
+    expect(() => decideTurnTransition('awaiting_approval', { kind: 'stale' })).toThrow(/Invalid transition from awaiting_approval/);
+    expect(() => decideTurnTransition('awaiting_approval', { kind: 'failed' })).toThrow(/Invalid transition from awaiting_approval/);
+    expect(() => decideTurnTransition('awaiting_approval', { kind: 'response', terminal: terminalResponse })).toThrow(/Invalid transition from awaiting_approval/);
+});
+// ── Invalid outcome for state (compile-time checks) ───────────
+it('streaming + fresh_start_required throws', () => {
+    expect(() => decideTurnTransition('streaming', {
+        kind: 'fresh_start_required',
+        retryCounts: defaultRetryCounts,
+    })).toThrow();
+});
+it('continuing + failed throws', () => {
+    expect(() => decideTurnTransition('continuing', { kind: 'failed' })).toThrow();
+});
+//# sourceMappingURL=turn-transition.test.js.map

package/dist/services/session/turn-transition.test.js.map

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

package/dist/services/session-context-service.d.ts

@@ -0,0 +1,8 @@
+import type { ISessionContextService, SessionTrafficContext } from './service-interfaces.js';
+export declare class SessionContextService implements ISessionContextService {
+    #private;
+    runWithContext<T>(context: SessionTrafficContext, fn: () => T): T;
+    getContext(): SessionTrafficContext | null;
+}
+export declare const NULL_SESSION_CONTEXT_SERVICE: ISessionContextService;
+//# sourceMappingURL=session-context-service.d.ts.map

package/dist/services/session-context-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.d.ts","sourceRoot":"","sources":["../../source/services/session-context-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE7F,qBAAa,qBAAsB,YAAW,sBAAsB;;IAGlE,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIjE,UAAU,IAAI,qBAAqB,GAAG,IAAI;CAG3C;AAED,eAAO,MAAM,4BAA4B,EAAE,sBAO1C,CAAC"}

package/dist/services/session-context-service.js

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export class SessionContextService {
+    #storage = new AsyncLocalStorage();
+    runWithContext(context, fn) {
+        return this.#storage.run(context, fn);
+    }
+    getContext() {
+        return this.#storage.getStore() ?? null;
+    }
+}
+export const NULL_SESSION_CONTEXT_SERVICE = {
+    runWithContext(_context, fn) {
+        return fn();
+    },
+    getContext() {
+        return null;
+    },
+};
+//# sourceMappingURL=session-context-service.js.map

package/dist/services/session-context-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.js","sourceRoot":"","sources":["../../source/services/session-context-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,OAAO,qBAAqB;IACvB,QAAQ,GAAG,IAAI,iBAAiB,EAAyB,CAAC;IAEnE,cAAc,CAAI,OAA8B,EAAE,EAAW;QAC3D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,cAAc,CAAI,QAA+B,EAAE,EAAW;QAC5D,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/services/session-context-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-context-service.test.d.ts.map

package/dist/services/session-context-service.test.d.ts.map

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

package/dist/services/session-context-service.test.js

@@ -0,0 +1,38 @@
+import test from 'ava';
+import { SessionContextService } from './session-context-service.js';
+test('getContext returns null outside runWithContext', (t) => {
+    const service = new SessionContextService();
+    t.is(service.getContext(), null);
+});
+test('context is visible inside runWithContext', (t) => {
+    const service = new SessionContextService();
+    const context = { sessionId: 'session-1', sessionStartedAt: '2025-01-01T00:00:00.000Z' };
+    const result = service.runWithContext(context, () => {
+        t.deepEqual(service.getContext(), context);
+        return 'ok';
+    });
+    t.is(result, 'ok');
+});
+test('context survives across an awaited promise', async (t) => {
+    const service = new SessionContextService();
+    const context = { sessionId: 'session-2', sessionStartedAt: '2025-01-02T00:00:00.000Z', traceId: 'trace-1' };
+    await service.runWithContext(context, async () => {
+        await Promise.resolve();
+        t.deepEqual(service.getContext(), context);
+    });
+});
+test('nested runWithContext restores the outer context after inner completes', async (t) => {
+    const service = new SessionContextService();
+    const outer = { sessionId: 'outer', sessionStartedAt: '2025-01-03T00:00:00.000Z' };
+    const inner = { sessionId: 'inner', sessionStartedAt: '2025-01-04T00:00:00.000Z', evaluator: true };
+    await service.runWithContext(outer, async () => {
+        t.deepEqual(service.getContext(), outer);
+        await service.runWithContext(inner, async () => {
+            t.deepEqual(service.getContext(), inner);
+            await Promise.resolve();
+            t.deepEqual(service.getContext(), inner);
+        });
+        t.deepEqual(service.getContext(), outer);
+    });
+});
+//# sourceMappingURL=session-context-service.test.js.map

package/dist/services/session-context-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.test.js","sourceRoot":"","sources":["../../source/services/session-context-service.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,IAAI,CAAC,gDAAgD,EAAE,CAAC,CAAC,EAAE,EAAE;IAC3D,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAE5C,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,CAAC,CAAC,EAAE,EAAE;IACrD,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAEzF,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE;QAClD,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC7D,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAE7G,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IACzF,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IACnF,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,SAAS,EAAE,IAAa,EAAE,CAAC;IAE7G,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;QAC7C,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;QAEzC,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YAC7C,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;YACzC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/session-input-planner.d.ts

@@ -0,0 +1,87 @@
+import type { AgentInputItem } from '@openai/agents';
+import type { ISettingsService } from './service-interfaces.js';
+import type { ConversationAgentClient } from './conversation-agent-client.js';
+import type { SessionToolTracker } from './session-tool-tracker.js';
+import type { ProviderContinuity } from './provider-continuity.js';
+import { type InputSurgeInputKind, type InputSurgeDecision } from './input-surge-guard.js';
+import { type LargeUncachedInputDecision } from './large-uncached-input-guard.js';
+import { type UserTurn } from '../types/user-turn.js';
+export type SessionInputPlan = {
+    streamInput: string | AgentInputItem | AgentInputItem[];
+    inputSurgeKind: 'delta' | 'full_history';
+    effectiveTurn: UserTurn;
+};
+/**
+ * Owns all input construction and guard logic for a conversation session.
+ *
+ * Decides what to send to the provider (delta vs full history, chaining vs not),
+ * handles mode-notice prepending, image-aware user-input items, provider
+ * capability queries, large-uncached-input previews, and input surge guard
+ * recording.
+ *
+ * `ConversationSession` asks this object for an input plan instead of knowing
+ * how chaining, full-history mode, images, provider capability, and large-input
+ * guards work.
+ */
+export declare class SessionInputPlanner {
+    #private;
+    constructor(deps: {
+        settingsService?: ISettingsService;
+        agentClient: ConversationAgentClient;
+        toolTracker: SessionToolTracker;
+        providerContinuity: ProviderContinuity;
+    });
+    /**
+     * Inspect the input for a potential input surge condition.
+     * Used by the session after building a plan to decide whether to block.
+     */
+    inspectForSurge(input: unknown, kind: InputSurgeInputKind): InputSurgeDecision;
+    /**
+     * Record a successful input delivery for both surge and uncached-input guards.
+     */
+    recordSuccess(input: unknown, options: {
+        kind: 'delta' | 'full_history';
+        previousInput?: unknown;
+    }): void;
+    /**
+     * Reset both surge and uncached-input guards (e.g. after undo or import).
+     */
+    reset(): void;
+    /**
+     * Mark a resumed session on the large-uncached-input guard.
+     */
+    markResumedSession(options: {
+        updatedAtMs: number | null;
+    }): void;
+    /**
+     * Mark an undo/rewind on the large-uncached-input guard.
+     */
+    markUndoOrRewind(): void;
+    /**
+     * Seed the input surge guard baseline for testing.
+     */
+    seedInputSurgeBaseline(data: unknown[], kind: 'delta' | 'full_history'): void;
+    /**
+     * Build an input plan for the given user turn.
+     *
+     * @param turn - The user turn to build input for (already normalized by the session).
+     * @param options.includeTurn - Whether to include the turn in the outgoing history.
+     *   When `true` the turn is appended to the reconciled history as a user-input item.
+     *   When `false` only the reconciled history is used (the turn is already in the store).
+     * @param options.pendingModeNotice - An optional mode notice to prepend to the turn text.
+     * @returns A plan describing what to send to the provider.
+     */
+    build(turn: UserTurn, options: {
+        includeTurn: boolean;
+        pendingModeNotice: string | null;
+    }): SessionInputPlan;
+    /**
+     * Preview what the large-uncached-input guard would decide for the given input.
+     *
+     * Does not mutate any state or consume the pending mode notice.
+     */
+    previewLargeUncachedInput(input: string | UserTurn, now?: number, context?: {
+        pendingModeNotice?: string | null;
+    }): LargeUncachedInputDecision;
+}
+//# sourceMappingURL=session-input-planner.d.ts.map

package/dist/services/session-input-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-input-planner.d.ts","sourceRoot":"","sources":["../../source/services/session-input-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAG3G,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;IACxD,cAAc,EAAE,OAAO,GAAG,cAAc,CAAC;IACzC,aAAa,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;;gBAQlB,IAAI,EAAE;QAChB,eAAe,CAAC,EAAE,gBAAgB,CAAC;QACnC,WAAW,EAAE,uBAAuB,CAAC;QACrC,WAAW,EAAE,kBAAkB,CAAC;QAChC,kBAAkB,EAAE,kBAAkB,CAAC;KACxC;IAOD;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,kBAAkB;IAI9E;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAYzG;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAIjE;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI;IAI7E;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,gBAAgB;IAoB5G;;;;OAIG;IACH,yBAAyB,CACvB,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC9C,0BAA0B;CA4E9B"}