@zhin.js/agent 1.0.2 → 1.0.3

package/lib/session/http-session-persistence.js

@@ -0,0 +1,60 @@
+/**
+ * JSON file persistence for HTTP agent sessions (ADR 0040 P3).
+ */
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export class FileHttpSessionPersistence {
+    dataDir;
+    constructor(dataDir) {
+        this.dataDir = dataDir;
+    }
+    sessionPath(sessionId) {
+        const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return join(this.dataDir, `${safe}.json`);
+    }
+    async save(snapshot) {
+        await mkdir(this.dataDir, { recursive: true });
+        const payload = {
+            ...snapshot,
+            turnRunning: false,
+            updatedAt: Date.now(),
+        };
+        await writeFile(this.sessionPath(snapshot.sessionId), `${JSON.stringify(payload)}\n`, 'utf8');
+    }
+    async load(sessionId) {
+        try {
+            const raw = await readFile(this.sessionPath(sessionId), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!parsed?.sessionId)
+                return null;
+            return { ...parsed, turnRunning: false };
+        }
+        catch {
+            return null;
+        }
+    }
+    async listSessionIds() {
+        try {
+            const names = await readdir(this.dataDir);
+            const ids = [];
+            for (const name of names) {
+                if (!name.endsWith('.json'))
+                    continue;
+                try {
+                    const raw = await readFile(join(this.dataDir, name), 'utf8');
+                    const parsed = JSON.parse(raw);
+                    if (parsed?.sessionId)
+                        ids.push(parsed.sessionId);
+                }
+                catch {
+                    /* skip corrupt */
+                }
+            }
+            return ids;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=http-session-persistence.js.map

package/lib/session/http-session-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-session-persistence.js","sourceRoot":"","sources":["../../src/session/http-session-persistence.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAuBjC,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAExC,WAAW,CAAC,SAAiB;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAsC;QAC/C,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAC;YAC/D,IAAI,CAAC,MAAM,EAAE,SAAS;gBAAE,OAAO,IAAI,CAAC;YACpC,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,SAAS;gBACtC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;oBAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAC;oBAC/D,IAAI,MAAM,EAAE,SAAS;wBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACpD,CAAC;gBAAC,MAAM,CAAC;oBACP,kBAAkB;gBACpB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/lib/session/http-session-sink.d.ts

@@ -0,0 +1,11 @@
+import type { AgentStreamSink } from '../event/agent-stream-bus.js';
+import type { ParkController, HttpSessionParkState } from './park-controller.js';
+import type { SessionEventLog } from './session-event-log.js';
+export interface HttpSessionSinkDeps {
+    sessions: Map<string, HttpSessionParkState>;
+    log: SessionEventLog;
+    park: ParkController;
+    onPersist?: (sessionId: string) => void;
+}
+export declare function createHttpSessionSink(deps: HttpSessionSinkDeps): AgentStreamSink;
+//# sourceMappingURL=http-session-sink.d.ts.map

package/lib/session/http-session-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-session-sink.d.ts","sourceRoot":"","sources":["../../src/session/http-session-sink.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA6B,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC5C,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CA8BhF"}

package/lib/session/http-session-sink.js

@@ -0,0 +1,32 @@
+/**
+ * HttpSessionSink — bus adapter writing HTTP session event log (ADR 0041).
+ */
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export function createHttpSessionSink(deps) {
+    const ingest = (sessionId, event, skipMidTurnPark = false) => {
+        const state = deps.sessions.get(sessionId);
+        if (!state)
+            return;
+        deps.log.append(sessionId, event);
+        for (const stepEvent of state.stepProjector.onStreamEvent(event)) {
+            deps.log.append(sessionId, stepEvent);
+        }
+        deps.park.syncPendingFromEvent(state, event);
+        deps.park.refreshParked(state);
+        if (!skipMidTurnPark && deps.park.shouldEmitMidTurnPark(state, event)) {
+            deps.park.emitSessionWaiting(state, 'parked');
+        }
+        deps.onPersist?.(sessionId);
+    };
+    return {
+        name: 'http-session',
+        handle(event, ctx) {
+            const sessionId = ctx.httpSessionId;
+            if (!sessionId)
+                return;
+            const skipMidTurnPark = event.type === AgentStreamEventType.SESSION_WAITING;
+            ingest(sessionId, event, skipMidTurnPark);
+        },
+    };
+}
+//# sourceMappingURL=http-session-sink.js.map

package/lib/session/http-session-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-session-sink.js","sourceRoot":"","sources":["../../src/session/http-session-sink.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAyB,MAAM,0BAA0B,CAAC;AAYvF,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAE,KAAuB,EAAE,eAAe,GAAG,KAAK,EAAQ,EAAE;QAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAElC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,CAAC,KAAK,EAAE,GAA8B;YAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC;YACpC,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe,CAAC;YAC5E,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/session/http-step-projector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Projects turn-scoped steps from AgentStream events (ADR 0040 P3 / ADR 0041).
+ */
+import { type AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import { type AgentStepCheckpoint } from '@zhin.js/ai/agent-step-checkpoint';
+export declare class HttpStepProjector {
+    private steps;
+    private current;
+    getSteps(): AgentStepCheckpoint[];
+    restoreSteps(steps: AgentStepCheckpoint[]): void;
+    /** Returns extra step wire events to append after the triggering event. */
+    onStreamEvent(event: AgentStreamEvent): AgentStreamEvent[];
+    pendingRequestIds(): string[];
+    isParked(): boolean;
+}
+//# sourceMappingURL=http-step-projector.d.ts.map

package/lib/session/http-step-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-step-projector.d.ts","sourceRoot":"","sources":["../../src/session/http-step-projector.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,mCAAmC,CAAC;AAQ3C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAoC;IAEnD,QAAQ,IAAI,mBAAmB,EAAE;IAIjC,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAWhD,2EAA2E;IAC3E,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,EAAE;IAkF1D,iBAAiB,IAAI,MAAM,EAAE;IAU7B,QAAQ,IAAI,OAAO;CAIpB"}

package/lib/session/http-step-projector.js

@@ -0,0 +1,118 @@
+/**
+ * Projects turn-scoped steps from AgentStream events (ADR 0040 P3 / ADR 0041).
+ */
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+import { AgentStepStatus, createStepId, } from '@zhin.js/ai/agent-step-checkpoint';
+function interruptKindFromEvent(event) {
+    if (event.type === AgentStreamEventType.INPUT_REQUESTED)
+        return 'approval';
+    if (event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED)
+        return 'authorization';
+    return 'unknown';
+}
+export class HttpStepProjector {
+    steps = [];
+    current = null;
+    getSteps() {
+        return [...this.steps];
+    }
+    restoreSteps(steps) {
+        this.steps = [...steps];
+        this.current = null;
+        for (let i = this.steps.length - 1; i >= 0; i--) {
+            if (this.steps[i].status === AgentStepStatus.RUNNING) {
+                this.current = { ...this.steps[i] };
+                break;
+            }
+        }
+    }
+    /** Returns extra step wire events to append after the triggering event. */
+    onStreamEvent(event) {
+        const extras = [];
+        const ts = event.timestamp ?? Date.now();
+        if (event.type === AgentStreamEventType.TURN_STARTED) {
+            const turnId = typeof event.data?.turnId === 'string' ? event.data.turnId : undefined;
+            const step = {
+                stepId: createStepId(),
+                turnId,
+                status: AgentStepStatus.RUNNING,
+                startedAt: ts,
+            };
+            this.current = step;
+            this.steps.push(step);
+            extras.push({
+                type: AgentStreamEventType.STEP_STARTED,
+                timestamp: ts,
+                data: { stepId: step.stepId, turnId, status: step.status },
+            });
+            return extras;
+        }
+        if (!this.current)
+            return extras;
+        if (event.type === AgentStreamEventType.INPUT_REQUESTED
+            || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED) {
+            const requestId = typeof event.data?.requestId === 'string' ? event.data.requestId : undefined;
+            this.current.status = AgentStepStatus.INTERRUPTED;
+            this.current.interruptKind = interruptKindFromEvent(event);
+            this.current.requestId = requestId;
+            extras.push({
+                type: AgentStreamEventType.STEP_INTERRUPTED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                    interruptKind: this.current.interruptKind,
+                    requestId,
+                },
+            });
+            return extras;
+        }
+        if (event.type === AgentStreamEventType.TURN_COMPLETED) {
+            this.current.status = AgentStepStatus.COMPLETED;
+            this.current.completedAt = ts;
+            extras.push({
+                type: AgentStreamEventType.STEP_COMPLETED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                },
+            });
+            this.current = null;
+            return extras;
+        }
+        if (event.type === AgentStreamEventType.TURN_FAILED) {
+            this.current.status = AgentStepStatus.INTERRUPTED;
+            this.current.completedAt = ts;
+            extras.push({
+                type: AgentStreamEventType.STEP_INTERRUPTED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                    interruptKind: 'unknown',
+                },
+            });
+            this.current = null;
+            return extras;
+        }
+        return extras;
+    }
+    pendingRequestIds() {
+        const ids = new Set();
+        for (const step of this.steps) {
+            if (step.status === AgentStepStatus.INTERRUPTED && step.requestId) {
+                ids.add(step.requestId);
+            }
+        }
+        return [...ids];
+    }
+    isParked() {
+        return this.pendingRequestIds().length > 0
+            || (this.current?.status === AgentStepStatus.INTERRUPTED);
+    }
+}
+//# sourceMappingURL=http-step-projector.js.map

package/lib/session/http-step-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-step-projector.js","sourceRoot":"","sources":["../../src/session/http-step-projector.ts"],"names":[],"mappings":"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"}

package/lib/session/http-turn-runner.d.ts

@@ -0,0 +1,16 @@
+import type { AgentStreamBus } from '../event/agent-stream-bus.js';
+import type { ZhinAgent } from '../zhin-agent/index.js';
+import type { ParkController, HttpSessionParkState } from './park-controller.js';
+export interface HttpTurnRunnerDeps {
+    getAgent: () => ZhinAgent | null;
+    bus: AgentStreamBus;
+    park: ParkController;
+    sessions: Map<string, HttpSessionParkState>;
+    onPersist?: (sessionId: string) => void;
+}
+export declare class HttpTurnRunner {
+    private readonly deps;
+    constructor(deps: HttpTurnRunnerDeps);
+    run(sessionId: string, message: string): Promise<void>;
+}
+//# sourceMappingURL=http-turn-runner.d.ts.map

package/lib/session/http-turn-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-turn-runner.d.ts","sourceRoot":"","sources":["../../src/session/http-turn-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAE/C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C7D"}

package/lib/session/http-turn-runner.js

@@ -0,0 +1,57 @@
+/**
+ * HTTP turn runner — processStream without duplicate TurnEvent mapping (ADR 0041).
+ */
+import { createSyntheticMessage } from '@zhin.js/core';
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export class HttpTurnRunner {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async run(sessionId, message) {
+        const state = this.deps.sessions.get(sessionId);
+        if (!state)
+            return;
+        const agent = this.deps.getAgent();
+        if (!agent) {
+            state.status = 'failed';
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.SESSION_FAILED,
+                data: { code: 'AGENT_UNAVAILABLE', message: 'ZhinAgent runtime 未就绪' },
+            }, { sessionId, httpSessionId: sessionId });
+            return;
+        }
+        state.turnRunning = true;
+        const commMessage = createSyntheticMessage({
+            adapter: 'host',
+            endpoint: 'zhin-v1',
+            sender: { id: 'http-client', isMaster: true },
+            channel: { type: 'private', id: sessionId },
+            extra: { httpSessionId: sessionId },
+        });
+        try {
+            for await (const _turnEvent of agent.processStream(message, commMessage)) {
+                /* wire events arrive via HttpSessionSink */
+            }
+            state.status = 'waiting';
+            this.deps.park.emitSessionWaiting(state, state.parked ? 'parked' : 'idle');
+        }
+        catch (err) {
+            state.status = 'failed';
+            const msg = err instanceof Error ? err.message : String(err);
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.TURN_FAILED,
+                data: { code: 'TURN_ERROR', message: msg },
+            }, { sessionId, httpSessionId: sessionId });
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.SESSION_FAILED,
+                data: { code: 'TURN_ERROR', message: msg },
+            }, { sessionId, httpSessionId: sessionId });
+        }
+        finally {
+            state.turnRunning = false;
+            this.deps.onPersist?.(sessionId);
+        }
+    }
+}
+//# sourceMappingURL=http-turn-runner.js.map

package/lib/session/http-turn-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-turn-runner.js","sourceRoot":"","sources":["../../src/session/http-turn-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,OAAe;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;YACxB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,cAAc;gBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,uBAAuB,EAAE;aACtE,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAEzB,MAAM,WAAW,GAAG,sBAAsB,CAAC;YACzC,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;YAC3C,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,UAAU,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBACzE,4CAA4C;YAC9C,CAAC;YACD,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,WAAW;gBACtC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE;aAC3C,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,cAAc;gBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE;aAC3C,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/lib/session/im-approval-adapter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * IM ask_user adapter for SessionInteractionPort (ADR 0041).
+ */
+import type { Message, Plugin } from '@zhin.js/core';
+import type { ApprovalRequestInput, SessionInteractionPort } from './session-interaction-port.js';
+export declare class ImApprovalAdapter implements SessionInteractionPort {
+    private readonly plugin;
+    private readonly commMessage;
+    constructor(plugin: Plugin | undefined, commMessage: Message);
+    requestApproval(input: ApprovalRequestInput): Promise<boolean>;
+}
+//# sourceMappingURL=im-approval-adapter.d.ts.map

package/lib/session/im-approval-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-approval-adapter.d.ts","sourceRoot":"","sources":["../../src/session/im-approval-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAElG,qBAAa,iBAAkB,YAAW,sBAAsB;IAE5D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,OAAO;IAGjC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBrE"}

package/lib/session/im-approval-adapter.js

@@ -0,0 +1,24 @@
+import { AskUserBuiltinTool } from '../builtin/ask-user-tool.js';
+export class ImApprovalAdapter {
+    plugin;
+    commMessage;
+    constructor(plugin, commMessage) {
+        this.plugin = plugin;
+        this.commMessage = commMessage;
+    }
+    async requestApproval(input) {
+        if (!this.plugin) {
+            throw new Error('approval required but Host plugin is unavailable');
+        }
+        const askTool = new AskUserBuiltinTool(this.plugin);
+        const raw = await askTool.run({
+            question: input.question,
+            type: 'confirm',
+            timeout: input.timeoutMs ?? 120,
+            sensitive: true,
+        }, this.commMessage);
+        const answer = typeof raw === 'string' ? raw.trim().toLowerCase() : String(raw);
+        return answer === 'yes';
+    }
+}
+//# sourceMappingURL=im-approval-adapter.js.map

package/lib/session/im-approval-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-approval-adapter.js","sourceRoot":"","sources":["../../src/session/im-approval-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,MAA0B,EAC1B,WAAoB;QADpB,WAAM,GAAN,MAAM,CAAoB;QAC1B,gBAAW,GAAX,WAAW,CAAS;IACpC,CAAC;IAEJ,KAAK,CAAC,eAAe,CAAC,KAA2B;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B;YACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;YAC/B,SAAS,EAAE,IAAI;SAChB,EACD,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChF,OAAO,MAAM,KAAK,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/lib/session/park-controller.d.ts

@@ -0,0 +1,24 @@
+import { type AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import type { AgentStepCheckpoint } from '@zhin.js/ai/agent-step-checkpoint';
+import type { AgentStreamBus } from '../event/agent-stream-bus.js';
+import type { HttpStepProjector } from './http-step-projector.js';
+export interface HttpSessionParkState {
+    sessionId: string;
+    continuationToken: string;
+    status: 'running' | 'waiting' | 'completed' | 'failed';
+    parked: boolean;
+    pendingRequestIds: string[];
+    turnRunning: boolean;
+    stepProjector: HttpStepProjector;
+}
+export declare class ParkController {
+    private readonly bus;
+    constructor(bus: AgentStreamBus);
+    newContinuationToken(): string;
+    syncPendingFromEvent(state: HttpSessionParkState, event: AgentStreamEvent): void;
+    refreshParked(state: HttpSessionParkState): void;
+    shouldEmitMidTurnPark(state: HttpSessionParkState, event: AgentStreamEvent): boolean;
+    emitSessionWaiting(state: HttpSessionParkState, reason: 'idle' | 'parked'): void;
+    getSteps(state: HttpSessionParkState): AgentStepCheckpoint[];
+}
+//# sourceMappingURL=park-controller.d.ts.map

package/lib/session/park-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"park-controller.d.ts","sourceRoot":"","sources":["../../src/session/park-controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEhD,oBAAoB,IAAI,MAAM;IAI9B,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAsBhF,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAIhD,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO;IASpF,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAgBhF,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE;CAG7D"}

package/lib/session/park-controller.js

@@ -0,0 +1,58 @@
+/**
+ * Park / waiting semantics for HTTP sessions (ADR 0040 P3 / ADR 0041).
+ */
+import { randomUUID } from 'node:crypto';
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export class ParkController {
+    bus;
+    constructor(bus) {
+        this.bus = bus;
+    }
+    newContinuationToken() {
+        return `zhin:${randomUUID()}`;
+    }
+    syncPendingFromEvent(state, event) {
+        const requestId = typeof event.data?.requestId === 'string' ? event.data.requestId : '';
+        if (!requestId)
+            return;
+        if (event.type === AgentStreamEventType.INPUT_REQUESTED
+            || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED) {
+            if (!state.pendingRequestIds.includes(requestId)) {
+                state.pendingRequestIds = [...state.pendingRequestIds, requestId];
+            }
+            return;
+        }
+        if (event.type === AgentStreamEventType.INPUT_COMPLETED
+            || event.type === AgentStreamEventType.AUTHORIZATION_COMPLETED) {
+            state.pendingRequestIds = state.pendingRequestIds.filter((id) => id !== requestId);
+        }
+    }
+    refreshParked(state) {
+        state.parked = state.pendingRequestIds.length > 0 || state.stepProjector.isParked();
+    }
+    shouldEmitMidTurnPark(state, event) {
+        return state.turnRunning
+            && state.parked
+            && (event.type === AgentStreamEventType.INPUT_REQUESTED
+                || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED);
+    }
+    emitSessionWaiting(state, reason) {
+        state.status = 'waiting';
+        state.continuationToken = this.newContinuationToken();
+        void this.bus.publish({
+            type: AgentStreamEventType.SESSION_WAITING,
+            data: {
+                sessionId: state.sessionId,
+                continuationToken: state.continuationToken,
+                parked: reason === 'parked',
+                reason,
+                pendingRequestIds: state.pendingRequestIds,
+                steps: state.stepProjector.getSteps(),
+            },
+        }, { sessionId: state.sessionId, httpSessionId: state.sessionId });
+    }
+    getSteps(state) {
+        return state.stepProjector.getSteps();
+    }
+}
+//# sourceMappingURL=park-controller.js.map

package/lib/session/park-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"park-controller.js","sourceRoot":"","sources":["../../src/session/park-controller.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAyB,MAAM,0BAA0B,CAAC;AAevF,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAmB;QAAnB,QAAG,GAAH,GAAG,CAAgB;IAAG,CAAC;IAEpD,oBAAoB;QAClB,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;IAChC,CAAC;IAED,oBAAoB,CAAC,KAA2B,EAAE,KAAuB;QACvE,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IACE,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;eAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,sBAAsB,EAC7D,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,iBAAiB,GAAG,CAAC,GAAG,KAAK,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;YACpE,CAAC;YACD,OAAO;QACT,CAAC;QAED,IACE,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;eAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,uBAAuB,EAC9D,CAAC;YACD,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAA2B;QACvC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACtF,CAAC;IAED,qBAAqB,CAAC,KAA2B,EAAE,KAAuB;QACxE,OAAO,KAAK,CAAC,WAAW;eACnB,KAAK,CAAC,MAAM;eACZ,CACD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;mBAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,sBAAsB,CAC9D,CAAC;IACN,CAAC;IAED,kBAAkB,CAAC,KAA2B,EAAE,MAAyB;QACvE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,oBAAoB,CAAC,eAAe;YAC1C,IAAI,EAAE;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,MAAM,EAAE,MAAM,KAAK,QAAQ;gBAC3B,MAAM;gBACN,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE;aACtC;SACF,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,QAAQ,CAAC,KAA2B;QAClC,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF"}

package/lib/session/resolve-session-interaction-port.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve SessionInteractionPort from transport context (ADR 0041).
+ */
+import { type Message, type Plugin } from '@zhin.js/core';
+import type { HttpApprovalAdapter } from './http-approval-adapter.js';
+import type { SessionInteractionPort } from './session-interaction-port.js';
+export declare function readHttpSessionId(commMessage: Message): string | undefined;
+export declare function resolveSessionInteractionPort(commMessage: Message, plugin: Plugin | undefined, httpApprovalAdapter?: HttpApprovalAdapter): SessionInteractionPort;
+//# sourceMappingURL=resolve-session-interaction-port.d.ts.map

package/lib/session/resolve-session-interaction-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session-interaction-port.d.ts","sourceRoot":"","sources":["../../src/session/resolve-session-interaction-port.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,sBAAsB,CAMxB"}

package/lib/session/resolve-session-interaction-port.js

@@ -0,0 +1,13 @@
+import { ImApprovalAdapter } from './im-approval-adapter.js';
+export function readHttpSessionId(commMessage) {
+    const extra = commMessage.extra;
+    return typeof extra?.httpSessionId === 'string' ? extra.httpSessionId : undefined;
+}
+export function resolveSessionInteractionPort(commMessage, plugin, httpApprovalAdapter) {
+    const httpSessionId = readHttpSessionId(commMessage);
+    if (httpSessionId && httpApprovalAdapter) {
+        return httpApprovalAdapter;
+    }
+    return new ImApprovalAdapter(plugin, commMessage);
+}
+//# sourceMappingURL=resolve-session-interaction-port.js.map

package/lib/session/resolve-session-interaction-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session-interaction-port.js","sourceRoot":"","sources":["../../src/session/resolve-session-interaction-port.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,MAAM,KAAK,GAAI,WAAmD,CAAC,KAAK,CAAC;IACzE,OAAO,OAAO,KAAK,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,WAAoB,EACpB,MAA0B,EAC1B,mBAAyC;IAEzC,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,aAAa,IAAI,mBAAmB,EAAE,CAAC;QACzC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/lib/session/session-event-log.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Append-only HTTP session event log (ADR 0041).
+ */
+import type { AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+export type SessionEventListener = (event: AgentStreamEvent, index: number) => void;
+export declare class SessionEventLog {
+    private readonly events;
+    private readonly listeners;
+    getEvents(sessionId: string): AgentStreamEvent[];
+    append(sessionId: string, event: AgentStreamEvent): number;
+    slice(sessionId: string, startIndex: number): AgentStreamEvent[];
+    subscribe(sessionId: string, listener: SessionEventListener): () => void;
+    replaceEvents(sessionId: string, events: AgentStreamEvent[]): void;
+    deleteSession(sessionId: string): void;
+    private notify;
+}
+//# sourceMappingURL=session-event-log.d.ts.map

package/lib/session/session-event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-log.d.ts","sourceRoot":"","sources":["../../src/session/session-event-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAE1E,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIhD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAgB1D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMhE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAaxE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAIlE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC,OAAO,CAAC,MAAM;CAOf"}

package/lib/session/session-event-log.js

@@ -0,0 +1,56 @@
+export class SessionEventLog {
+    events = new Map();
+    listeners = new Map();
+    getEvents(sessionId) {
+        return this.events.get(sessionId) ?? [];
+    }
+    append(sessionId, event) {
+        const stamped = {
+            ...event,
+            timestamp: event.timestamp ?? Date.now(),
+        };
+        let list = this.events.get(sessionId);
+        if (!list) {
+            list = [];
+            this.events.set(sessionId, list);
+        }
+        list.push(stamped);
+        const index = list.length - 1;
+        this.notify(sessionId, stamped, index);
+        return index;
+    }
+    slice(sessionId, startIndex) {
+        const list = this.events.get(sessionId) ?? [];
+        const from = Math.max(0, Math.floor(startIndex));
+        return list.slice(from);
+    }
+    subscribe(sessionId, listener) {
+        let set = this.listeners.get(sessionId);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(sessionId, set);
+        }
+        set.add(listener);
+        return () => {
+            set?.delete(listener);
+            if (set?.size === 0)
+                this.listeners.delete(sessionId);
+        };
+    }
+    replaceEvents(sessionId, events) {
+        this.events.set(sessionId, [...events]);
+    }
+    deleteSession(sessionId) {
+        this.events.delete(sessionId);
+        this.listeners.delete(sessionId);
+    }
+    notify(sessionId, event, index) {
+        const set = this.listeners.get(sessionId);
+        if (!set)
+            return;
+        for (const listener of set) {
+            listener(event, index);
+        }
+    }
+}
+//# sourceMappingURL=session-event-log.js.map

package/lib/session/session-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-log.js","sourceRoot":"","sources":["../../src/session/session-event-log.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/C,SAAS,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE1E,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,KAAuB;QAC/C,MAAM,OAAO,GAAqB;YAChC,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SACzC,CAAC;QACF,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,UAAkB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,QAA8B;QACzD,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,IAAI,GAAG,EAAE,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,SAAiB,EAAE,MAA0B;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEO,MAAM,CAAC,SAAiB,EAAE,KAAuB,EAAE,KAAa;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;YAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/lib/session/session-interaction-port.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SessionInteractionPort — blocking HITL only (ADR 0041).
+ * Stream events publish via AgentStreamBus separately.
+ */
+export interface ApprovalRequestInput {
+    requestId: string;
+    toolName: string;
+    question: string;
+    timeoutMs?: number;
+}
+export interface SessionInteractionPort {
+    requestApproval(input: ApprovalRequestInput): Promise<boolean>;
+    resolveApproval?(requestId: string, approved: boolean): boolean;
+}
+//# sourceMappingURL=session-interaction-port.d.ts.map

package/lib/session/session-interaction-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-interaction-port.d.ts","sourceRoot":"","sources":["../../src/session/session-interaction-port.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;CACjE"}