@qduc/term2 0.7.3 → 0.9.0

package/dist/services/session/session-composition.test.js

@@ -0,0 +1,200 @@
+import { it, expect } from 'vitest';
+import { createConversationSession, createConversationSessionComposition } from './session-composition.js';
+const noop = () => { };
+const makeLogger = () => ({
+    info: noop,
+    warn: noop,
+    error: noop,
+    debug: noop,
+    security: noop,
+    setCorrelationId: noop,
+    getCorrelationId: () => undefined,
+    clearCorrelationId: noop,
+});
+const sessionContextService = {
+    runWithContext: (_ctx, fn) => fn(),
+    getContext: () => null,
+};
+const makeMockClient = (overrides = {}) => ({
+    async startStream(_input, _opts) {
+        return {
+            interruptions: [],
+            state: null,
+            history: [],
+            newItems: [],
+            finalOutput: 'ok',
+            lastResponseId: null,
+            [Symbol.asyncIterator]() {
+                let done = false;
+                return {
+                    next() {
+                        if (!done) {
+                            done = true;
+                            return Promise.resolve({
+                                done: false,
+                                value: { type: 'response.output_text.delta', delta: 'ok' },
+                            });
+                        }
+                        return Promise.resolve({ done: true, value: undefined });
+                    },
+                };
+            },
+        };
+    },
+    abort: noop,
+    continueRunStream: noop,
+    setModel: noop,
+    addToolInterceptor: noop,
+    chat: noop,
+    ...overrides,
+});
+// ── Factory return shape ───────────────────────────────────────────
+it('createConversationSession returns bundle with correct sessionId', () => {
+    const { sessionId } = createConversationSession({
+        sessionId: 'test-123',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(sessionId).toBe('test-123');
+});
+it('createConversationSession is the public name for the session composition root', () => {
+    expect(createConversationSession).toBe(createConversationSessionComposition);
+});
+it('createConversationSession returns bundle with correct sessionStartedAt when provided', () => {
+    const ts = '2024-01-01T00:00:00.000Z';
+    const { sessionStartedAt } = createConversationSession({
+        sessionId: 'test-ts',
+        sessionStartedAt: ts,
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(sessionStartedAt).toBe(ts);
+});
+it('createConversationSession returns bundle with auto sessionStartedAt when not provided', () => {
+    const before = new Date().toISOString();
+    const { sessionStartedAt } = createConversationSession({
+        sessionId: 'auto-ts',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    const after = new Date().toISOString();
+    expect(sessionStartedAt >= before).toBe(true);
+    expect(sessionStartedAt <= after).toBe(true);
+});
+it('createConversationSession returns a terminalAdapter with sendMessage', () => {
+    const { terminalAdapter } = createConversationSession({
+        sessionId: 'ta-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(typeof terminalAdapter.sendMessage).toBe('function');
+    expect(typeof terminalAdapter.handleApprovalDecision).toBe('function');
+});
+it('createConversationSessionComposition composes a plain appState object with a statusMachine', () => {
+    const { appState } = createConversationSessionComposition({
+        sessionId: 'app-state-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+        turnAccumulator: {
+            append: () => undefined,
+            reset: () => undefined,
+            resetPersistedTurnState: () => undefined,
+            addPending: () => undefined,
+            addAssistant: () => undefined,
+            addTool: () => undefined,
+            addReasoning: () => undefined,
+            addCommandMessage: () => undefined,
+            addToolStarted: () => undefined,
+            addUser: () => undefined,
+            getTurnItems: () => [],
+            getPendingTurnItems: () => [],
+            getPersistedTurnState: () => [],
+        },
+    });
+    expect(Object.getPrototypeOf(appState)).toBe(Object.prototype);
+    expect(appState.statusMachine.current).toBe('idle');
+});
+it('createConversationSession returns stateFacade with undo/snapshot operations', () => {
+    const { stateFacade } = createConversationSession({
+        sessionId: 'sf-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(typeof stateFacade.reset).toBe('function');
+    expect(typeof stateFacade.undoLastUserTurn).toBe('function');
+    expect(typeof stateFacade.listUserTurns).toBe('function');
+    expect(typeof stateFacade.undoNUserTurns).toBe('function');
+    expect(typeof stateFacade.getCurrentSnapshot).toBe('function');
+    expect(typeof stateFacade.exportState).toBe('function');
+    expect(typeof stateFacade.importState).toBe('function');
+    expect(typeof stateFacade.addShellContext).toBe('function');
+    expect(typeof stateFacade.queueModeNotice).toBe('function');
+});
+it('createConversationSession returns runtimeController with model/provider operations', () => {
+    const { runtimeController } = createConversationSession({
+        sessionId: 'rc-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(typeof runtimeController.setModel).toBe('function');
+    expect(typeof runtimeController.setProvider).toBe('function');
+    expect(typeof runtimeController.switchProvider).toBe('function');
+    expect(typeof runtimeController.setRetryCallback).toBe('function');
+});
+it('createConversationSession returns a dispose function', () => {
+    const { dispose } = createConversationSession({
+        sessionId: 'dispose-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(typeof dispose).toBe('function');
+});
+// ── Disposal ─────────────────────────────────────────────────────
+it('dispose() is idempotent — safe to call twice without throwing', () => {
+    const { dispose } = createConversationSession({
+        sessionId: 'idempotent',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    expect(() => {
+        dispose();
+        dispose();
+    }).not.toThrow();
+});
+it('dispose() resets previousResponseId so next run starts fresh', () => {
+    const { dispose } = createConversationSession({
+        sessionId: 'prev-resp-id',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // We'll just check that dispose doesn't throw
+    expect(() => dispose()).not.toThrow();
+});
+// ── No callback into partially-constructed session ────────────────
+it('turnCoordinator.abort() does not throw', () => {
+    const abortCalled = { value: false };
+    const mockClient = makeMockClient({
+        abort: () => {
+            abortCalled.value = true;
+        },
+    });
+    const { turnCoordinator } = createConversationSession({
+        sessionId: 'abort-test',
+        agentClient: mockClient,
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // Should not throw
+    expect(() => turnCoordinator.abort()).not.toThrow();
+});
+// ── Non-interactive path ──────────────────────────────────────────
+it('createConversationSession can be used as ConversationSessionLike', () => {
+    const { terminalAdapter } = createConversationSession({
+        sessionId: 'ni-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // Verify the shape matches what runWithSession expects
+    expect(typeof terminalAdapter.sendMessage).toBe('function');
+    expect(typeof terminalAdapter.handleApprovalDecision).toBe('function');
+});
+//# sourceMappingURL=session-composition.test.js.map

package/dist/services/session/session-composition.test.js.map

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

package/dist/services/session/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/session-context-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.d.ts","sourceRoot":"","sources":["../../../source/services/session/session-context-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,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/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/session-context-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.js","sourceRoot":"","sources":["../../../source/services/session/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/session-context-service.test.d.ts

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

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

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

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

@@ -0,0 +1,38 @@
+import { it, expect } from 'vitest';
+import { SessionContextService } from './session-context-service.js';
+it('getContext returns null outside runWithContext', () => {
+    const service = new SessionContextService();
+    expect(service.getContext()).toBe(null);
+});
+it('context is visible inside runWithContext', () => {
+    const service = new SessionContextService();
+    const context = { sessionId: 'session-1', sessionStartedAt: '2025-01-01T00:00:00.000Z' };
+    const result = service.runWithContext(context, () => {
+        expect(service.getContext()).toEqual(context);
+        return 'ok';
+    });
+    expect(result).toBe('ok');
+});
+it('context survives across an awaited promise', async () => {
+    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();
+        expect(service.getContext()).toEqual(context);
+    });
+});
+it('nested runWithContext restores the outer context after inner completes', async () => {
+    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 () => {
+        expect(service.getContext()).toEqual(outer);
+        await service.runWithContext(inner, async () => {
+            expect(service.getContext()).toEqual(inner);
+            await Promise.resolve();
+            expect(service.getContext()).toEqual(inner);
+        });
+        expect(service.getContext()).toEqual(outer);
+    });
+});
+//# sourceMappingURL=session-context-service.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-service.test.js","sourceRoot":"","sources":["../../../source/services/session/session-context-service.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;IACxD,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAE5C,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;IAClD,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,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC1D,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,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;IACtF,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,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5C,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/session/session-factory.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compatibility entry point for callers that still import `session-factory`.
+ * The composition root lives in `session-composition`.
+ */
+export { createConversationSession, createConversationSessionComposition, type ConversationSessionBundle, type ConversationSessionComposition, type ConversationSessionRetryOptions, type CreateConversationSessionCompositionOptions, type CreateConversationSessionOptions, } from './session-composition.js';
+//# sourceMappingURL=session-factory.d.ts.map

package/dist/services/session/session-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-factory.d.ts","sourceRoot":"","sources":["../../../source/services/session/session-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,oCAAoC,EACpC,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,2CAA2C,EAChD,KAAK,gCAAgC,GACtC,MAAM,0BAA0B,CAAC"}

package/dist/services/session/session-factory.js

@@ -0,0 +1,6 @@
+/**
+ * Compatibility entry point for callers that still import `session-factory`.
+ * The composition root lives in `session-composition`.
+ */
+export { createConversationSession, createConversationSessionComposition, } from './session-composition.js';
+//# sourceMappingURL=session-factory.js.map

package/dist/services/session/session-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-factory.js","sourceRoot":"","sources":["../../../source/services/session/session-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,oCAAoC,GAMrC,MAAM,0BAA0B,CAAC"}

package/dist/services/session/session-factory.test.d.ts

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

package/dist/services/session/session-factory.test.d.ts.map

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

package/dist/services/session/session-factory.test.js

@@ -0,0 +1,198 @@
+// @ts-nocheck - Complex mock patterns
+import test from 'ava';
+import { createConversationSession } from './session-factory.js';
+import { createConversationSessionComposition } from './session-composition.js';
+const noop = () => { };
+const makeLogger = () => ({
+    info: noop,
+    warn: noop,
+    error: noop,
+    debug: noop,
+    security: noop,
+    setCorrelationId: noop,
+    getCorrelationId: () => undefined,
+    clearCorrelationId: noop,
+});
+const sessionContextService = {
+    runWithContext: (_ctx, fn) => fn(),
+    getContext: () => null,
+};
+const makeMockClient = (overrides = {}) => ({
+    async startStream(_input, _opts) {
+        return {
+            interruptions: [],
+            state: null,
+            history: [],
+            newItems: [],
+            finalOutput: 'ok',
+            lastResponseId: null,
+            [Symbol.asyncIterator]() {
+                let done = false;
+                return {
+                    next() {
+                        if (!done) {
+                            done = true;
+                            return Promise.resolve({
+                                done: false,
+                                value: { type: 'response.output_text.delta', delta: 'ok' },
+                            });
+                        }
+                        return Promise.resolve({ done: true, value: undefined });
+                    },
+                };
+            },
+        };
+    },
+    abort: noop,
+    ...overrides,
+});
+// ── Factory return shape ───────────────────────────────────────────
+test('createConversationSession returns bundle with correct sessionId', (t) => {
+    const { sessionId } = createConversationSession({
+        sessionId: 'test-123',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(sessionId, 'test-123');
+});
+test('createConversationSession is the public name for the session composition root', (t) => {
+    t.is(createConversationSession, createConversationSessionComposition);
+});
+test('createConversationSession returns bundle with correct sessionStartedAt when provided', (t) => {
+    const ts = '2024-01-01T00:00:00.000Z';
+    const { sessionStartedAt } = createConversationSession({
+        sessionId: 'test-ts',
+        sessionStartedAt: ts,
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(sessionStartedAt, ts);
+});
+test('createConversationSession returns bundle with auto sessionStartedAt when not provided', (t) => {
+    const before = new Date().toISOString();
+    const { sessionStartedAt } = createConversationSession({
+        sessionId: 'auto-ts',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    const after = new Date().toISOString();
+    t.true(sessionStartedAt >= before);
+    t.true(sessionStartedAt <= after);
+});
+test('createConversationSession returns a terminalAdapter with sendMessage', (t) => {
+    const { terminalAdapter } = createConversationSession({
+        sessionId: 'ta-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(typeof terminalAdapter.sendMessage, 'function');
+    t.is(typeof terminalAdapter.handleApprovalDecision, 'function');
+});
+test('createConversationSessionComposition composes a plain appState object with a statusMachine', (t) => {
+    const { appState } = createConversationSessionComposition({
+        sessionId: 'app-state-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+        turnAccumulator: {
+            append: () => undefined,
+            reset: () => undefined,
+            resetPersistedTurnState: () => undefined,
+            addPending: () => undefined,
+            addAssistant: () => undefined,
+            addTool: () => undefined,
+            addReasoning: () => undefined,
+            addCommandMessage: () => undefined,
+            addToolStarted: () => undefined,
+            addUser: () => undefined,
+            getTurnItems: () => [],
+            getPendingTurnItems: () => [],
+            getPersistedTurnState: () => [],
+        },
+    });
+    t.is(Object.getPrototypeOf(appState), Object.prototype);
+    t.is(appState.statusMachine.current, 'idle');
+});
+test('createConversationSession returns stateFacade with undo/snapshot operations', (t) => {
+    const { stateFacade } = createConversationSession({
+        sessionId: 'sf-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(typeof stateFacade.reset, 'function');
+    t.is(typeof stateFacade.undoLastUserTurn, 'function');
+    t.is(typeof stateFacade.listUserTurns, 'function');
+    t.is(typeof stateFacade.undoNUserTurns, 'function');
+    t.is(typeof stateFacade.getCurrentSnapshot, 'function');
+    t.is(typeof stateFacade.exportState, 'function');
+    t.is(typeof stateFacade.importState, 'function');
+    t.is(typeof stateFacade.addShellContext, 'function');
+    t.is(typeof stateFacade.queueModeNotice, 'function');
+});
+test('createConversationSession returns runtimeController with model/provider operations', (t) => {
+    const { runtimeController } = createConversationSession({
+        sessionId: 'rc-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(typeof runtimeController.setModel, 'function');
+    t.is(typeof runtimeController.setProvider, 'function');
+    t.is(typeof runtimeController.switchProvider, 'function');
+    t.is(typeof runtimeController.setRetryCallback, 'function');
+});
+test('createConversationSession returns a dispose function', (t) => {
+    const { dispose } = createConversationSession({
+        sessionId: 'dispose-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.is(typeof dispose, 'function');
+});
+// ── Disposal ─────────────────────────────────────────────────────
+test('dispose() is idempotent — safe to call twice without throwing', (t) => {
+    const { dispose } = createConversationSession({
+        sessionId: 'idempotent',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    t.notThrows(() => {
+        dispose();
+        dispose();
+    });
+});
+test('dispose() resets previousResponseId so next run starts fresh', (t) => {
+    const { dispose } = createConversationSession({
+        sessionId: 'prev-resp-id',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // We'll just check that dispose doesn't throw
+    t.notThrows(() => dispose());
+});
+// ── No callback into partially-constructed session ────────────────
+test('turnCoordinator.abort() does not throw', (t) => {
+    const abortCalled = { value: false };
+    const mockClient = makeMockClient({
+        abort: () => {
+            abortCalled.value = true;
+        },
+    });
+    const { turnCoordinator } = createConversationSession({
+        sessionId: 'abort-test',
+        agentClient: mockClient,
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // Should not throw
+    t.notThrows(() => turnCoordinator.abort());
+});
+// ── Non-interactive path ──────────────────────────────────────────
+test('createConversationSession can be used as ConversationSessionLike', (t) => {
+    const { terminalAdapter } = createConversationSession({
+        sessionId: 'ni-test',
+        agentClient: makeMockClient(),
+        deps: { logger: makeLogger(), sessionContextService },
+    });
+    // Verify the shape matches what runWithSession expects
+    t.is(typeof terminalAdapter.sendMessage, 'function');
+    t.is(typeof terminalAdapter.handleApprovalDecision, 'function');
+});
+//# sourceMappingURL=session-factory.test.js.map

package/dist/services/session/session-factory.test.js.map

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

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

@@ -0,0 +1,95 @@
+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;
+    /**
+     * Preview what the input surge guard would decide for the given input.
+     *
+     * Does not mutate any state or consume the pending mode notice.
+     */
+    previewInputSurge(input: string | UserTurn, context?: {
+        pendingModeNotice?: string | null;
+    }): 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/session-input-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-input-planner.d.ts","sourceRoot":"","sources":["../../../source/services/session/session-input-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAmB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAG5G,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAY5E,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;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,kBAAkB;IAShH;;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;IAyC5G;;;;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"}