@zhin.js/agent 1.0.2 → 1.0.4

package/lib/session/agent-session-host-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-host-port.js","sourceRoot":"","sources":["../../src/session/agent-session-host-port.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAA+B,MAAM,+BAA+B,CAAC;AAkBxG,MAAM,UAAU,0BAA0B,CACxC,OAA0C;IAE1C,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACtD,MAAM,WAAW,GAAuC,OAAO,CAAC,OAAO;QACrE,CAAC,CAAC,IAAI,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,QAAQ,GAA8C,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9E,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC,CAAC,SAAiB,EAAE,EAAE,GAAG,KAAK,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,KAAK,GAAG,IAAI,qBAAqB,CAAC;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG;QACH,IAAI;QACJ,mBAAmB;QACnB,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC;QAC7D,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE;QAChC,GAAG;QACH,IAAI;QACJ,SAAS;KACV,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI;QACJ,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE;QAChC,SAAS;KACV,CAAC,CAAC;IACH,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhC,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,KAAK,CAAC,eAAe,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,KAAK;QACL,mBAAmB;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,uBAAuB,CAAC,SAAS,EAAE,KAAK;YACtC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/session/http-agent-session-store.d.ts

@@ -0,0 +1,76 @@
+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 { ZhinAgent } from '../zhin-agent/index.js';
+import type { HttpApprovalAdapter } from './http-approval-adapter.js';
+import type { ParkController, HttpSessionParkState } from './park-controller.js';
+import type { SessionEventLog } from './session-event-log.js';
+import type { HttpSessionPersistence } from './http-session-persistence.js';
+import type { HttpTurnRunner } from './http-turn-runner.js';
+export type HttpAgentSessionStatus = 'running' | 'waiting' | 'completed' | 'failed';
+export interface HttpAgentSessionRecord {
+    sessionId: string;
+    continuationToken: string;
+    status: HttpAgentSessionStatus;
+    events: AgentStreamEvent[];
+    steps: AgentStepCheckpoint[];
+    parked: boolean;
+    pendingRequestIds: string[];
+    turnRunning: boolean;
+}
+export interface HttpAgentSessionStoreOptions {
+    getAgent: () => ZhinAgent | null;
+    maxSessions?: number;
+    log: SessionEventLog;
+    park: ParkController;
+    httpApprovalAdapter: HttpApprovalAdapter;
+    persistence?: HttpSessionPersistence;
+    onPersist?: (sessionId: string) => void;
+}
+export declare class HttpAgentSessionStore {
+    private readonly sessions;
+    private readonly getAgent;
+    private readonly maxSessions;
+    private readonly log;
+    private readonly park;
+    private readonly httpApprovalAdapter;
+    private readonly persistence?;
+    private readonly onPersist?;
+    private turnRunner?;
+    private bus?;
+    constructor(options: HttpAgentSessionStoreOptions);
+    setTurnRunner(runner: HttpTurnRunner): void;
+    setBus(bus: AgentStreamBus): void;
+    getSessionsMap(): Map<string, HttpSessionParkState>;
+    getSession(sessionId: string): HttpAgentSessionRecord | undefined;
+    hydrateSession(sessionId: string): Promise<HttpAgentSessionRecord | undefined>;
+    restoreFromDisk(): Promise<number>;
+    listEventSlice(sessionId: string, startIndex: number): AgentStreamEvent[];
+    subscribe(sessionId: string, listener: (event: AgentStreamEvent, index: number) => void): () => void;
+    startSession(message: string): Promise<{
+        sessionId: string;
+        continuationToken: string;
+    }>;
+    continueSession(sessionId: string, continuationToken: string, message: string): Promise<{
+        ok: true;
+        continuationToken: string;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    submitInput(sessionId: string, requestId: string, approved: boolean): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    persistSession(sessionId: string): Promise<void>;
+    dispose(): void;
+    private requireBus;
+    private createState;
+    private ingestSnapshot;
+    private hydrateState;
+    private toRecord;
+    private evictIfNeeded;
+}
+//# sourceMappingURL=http-agent-session-store.d.ts.map

package/lib/session/http-agent-session-store.d.ts.map

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

package/lib/session/http-agent-session-store.js

@@ -0,0 +1,211 @@
+/**
+ * HTTP agent session facade — continuationToken + NDJSON log (ADR 0039 P0 / ADR 0041).
+ */
+import { randomUUID } from 'node:crypto';
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+import { HttpStepProjector } from './http-step-projector.js';
+export class HttpAgentSessionStore {
+    sessions = new Map();
+    getAgent;
+    maxSessions;
+    log;
+    park;
+    httpApprovalAdapter;
+    persistence;
+    onPersist;
+    turnRunner;
+    bus;
+    constructor(options) {
+        this.getAgent = options.getAgent;
+        this.maxSessions = options.maxSessions ?? 500;
+        this.log = options.log;
+        this.park = options.park;
+        this.httpApprovalAdapter = options.httpApprovalAdapter;
+        this.persistence = options.persistence;
+        this.onPersist = options.onPersist;
+    }
+    setTurnRunner(runner) {
+        this.turnRunner = runner;
+    }
+    setBus(bus) {
+        this.bus = bus;
+    }
+    getSessionsMap() {
+        return this.sessions;
+    }
+    getSession(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state)
+            return undefined;
+        return this.toRecord(state);
+    }
+    async hydrateSession(sessionId) {
+        const existing = this.sessions.get(sessionId);
+        if (existing)
+            return this.toRecord(existing);
+        if (!this.persistence)
+            return undefined;
+        const snapshot = await this.persistence.load(sessionId);
+        if (!snapshot)
+            return undefined;
+        return this.ingestSnapshot(snapshot);
+    }
+    async restoreFromDisk() {
+        if (!this.persistence)
+            return 0;
+        const ids = await this.persistence.listSessionIds();
+        let n = 0;
+        for (const sessionId of ids) {
+            if (this.sessions.has(sessionId))
+                continue;
+            const snapshot = await this.persistence.load(sessionId);
+            if (snapshot) {
+                this.ingestSnapshot(snapshot);
+                n++;
+            }
+        }
+        return n;
+    }
+    listEventSlice(sessionId, startIndex) {
+        return this.log.slice(sessionId, startIndex);
+    }
+    subscribe(sessionId, listener) {
+        return this.log.subscribe(sessionId, listener);
+    }
+    async startSession(message) {
+        this.evictIfNeeded();
+        const sessionId = `ses_${randomUUID().replace(/-/g, '').slice(0, 16)}`;
+        const continuationToken = this.park.newContinuationToken();
+        const state = this.createState(sessionId, continuationToken);
+        this.sessions.set(sessionId, state);
+        const bus = this.requireBus();
+        await bus.publish({
+            type: AgentStreamEventType.SESSION_STARTED,
+            data: { sessionId },
+        }, { sessionId, httpSessionId: sessionId });
+        void this.turnRunner?.run(sessionId, message);
+        return { sessionId, continuationToken };
+    }
+    async continueSession(sessionId, continuationToken, message) {
+        const state = this.sessions.get(sessionId) ?? await this.hydrateState(sessionId);
+        if (!state) {
+            return { ok: false, error: 'SESSION_NOT_FOUND' };
+        }
+        if (state.continuationToken !== continuationToken) {
+            return { ok: false, error: 'CONTINUATION_TOKEN_STALE' };
+        }
+        if (state.turnRunning) {
+            return { ok: false, error: 'SESSION_BUSY' };
+        }
+        if (state.status === 'completed' || state.status === 'failed') {
+            return { ok: false, error: 'SESSION_TERMINAL' };
+        }
+        state.status = 'running';
+        state.parked = false;
+        await this.turnRunner?.run(sessionId, message);
+        const updated = this.sessions.get(sessionId);
+        if (!updated || updated.status === 'failed') {
+            return { ok: false, error: 'SESSION_FAILED' };
+        }
+        return { ok: true, continuationToken: updated.continuationToken };
+    }
+    async submitInput(sessionId, requestId, approved) {
+        const state = this.sessions.get(sessionId) ?? await this.hydrateState(sessionId);
+        if (!state) {
+            return { ok: false, error: 'SESSION_NOT_FOUND' };
+        }
+        const resolved = this.httpApprovalAdapter.resolveApproval(requestId, approved);
+        if (!resolved) {
+            return { ok: false, error: 'REQUEST_NOT_FOUND' };
+        }
+        state.pendingRequestIds = state.pendingRequestIds.filter((id) => id !== requestId);
+        this.park.refreshParked(state);
+        this.onPersist?.(sessionId);
+        return { ok: true };
+    }
+    async persistSession(sessionId) {
+        if (!this.persistence)
+            return;
+        const state = this.sessions.get(sessionId);
+        if (!state)
+            return;
+        const snapshot = {
+            sessionId: state.sessionId,
+            continuationToken: state.continuationToken,
+            status: state.status,
+            events: this.log.getEvents(sessionId),
+            steps: state.stepProjector.getSteps(),
+            parked: state.parked,
+            pendingRequestIds: state.pendingRequestIds,
+            turnRunning: false,
+            updatedAt: Date.now(),
+        };
+        await this.persistence.save(snapshot);
+    }
+    dispose() {
+        this.sessions.clear();
+    }
+    requireBus() {
+        if (!this.bus) {
+            throw new Error('HttpAgentSessionStore: AgentStreamBus not wired');
+        }
+        return this.bus;
+    }
+    createState(sessionId, continuationToken) {
+        return {
+            sessionId,
+            continuationToken,
+            status: 'running',
+            parked: false,
+            pendingRequestIds: [],
+            turnRunning: false,
+            stepProjector: new HttpStepProjector(),
+        };
+    }
+    ingestSnapshot(snapshot) {
+        const projector = new HttpStepProjector();
+        projector.restoreSteps(snapshot.steps);
+        const state = {
+            sessionId: snapshot.sessionId,
+            continuationToken: snapshot.continuationToken,
+            status: snapshot.status,
+            parked: snapshot.parked,
+            pendingRequestIds: [...snapshot.pendingRequestIds],
+            turnRunning: false,
+            stepProjector: projector,
+        };
+        this.sessions.set(snapshot.sessionId, state);
+        this.log.replaceEvents(snapshot.sessionId, [...snapshot.events]);
+        return this.toRecord(state);
+    }
+    async hydrateState(sessionId) {
+        const record = await this.hydrateSession(sessionId);
+        if (!record)
+            return undefined;
+        return this.sessions.get(sessionId);
+    }
+    toRecord(state) {
+        return {
+            sessionId: state.sessionId,
+            continuationToken: state.continuationToken,
+            status: state.status,
+            events: this.log.getEvents(state.sessionId),
+            steps: state.stepProjector.getSteps(),
+            parked: state.parked,
+            pendingRequestIds: [...state.pendingRequestIds],
+            turnRunning: state.turnRunning,
+        };
+    }
+    evictIfNeeded() {
+        if (this.sessions.size <= this.maxSessions)
+            return;
+        const sorted = [...this.sessions.entries()].sort((a, b) => (this.log.getEvents(a[0])[0]?.timestamp ?? 0) - (this.log.getEvents(b[0])[0]?.timestamp ?? 0));
+        const excess = this.sessions.size - Math.floor(this.maxSessions * 0.8);
+        for (let i = 0; i < excess && i < sorted.length; i++) {
+            const id = sorted[i][0];
+            this.sessions.delete(id);
+            this.log.deleteSession(id);
+        }
+    }
+}
+//# sourceMappingURL=http-agent-session-store.js.map

package/lib/session/http-agent-session-store.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * HTTP approval park adapter — instance-scoped waiter (ADR 0041).
+ */
+import { HttpApprovalWaiter } from './http-approval-waiter.js';
+import type { ApprovalRequestInput, SessionInteractionPort } from './session-interaction-port.js';
+export declare class HttpApprovalAdapter implements SessionInteractionPort {
+    readonly waiter: HttpApprovalWaiter;
+    requestApproval(input: ApprovalRequestInput): Promise<boolean>;
+    resolveApproval(requestId: string, approved: boolean): boolean;
+}
+//# sourceMappingURL=http-approval-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-approval-adapter.d.ts","sourceRoot":"","sources":["../../src/session/http-approval-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAElG,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE,QAAQ,CAAC,MAAM,qBAA4B;IAErC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO;CAG/D"}

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

@@ -0,0 +1,19 @@
+/**
+ * HTTP approval park adapter — instance-scoped waiter (ADR 0041).
+ */
+import { HttpApprovalWaiter } from './http-approval-waiter.js';
+export class HttpApprovalAdapter {
+    waiter = new HttpApprovalWaiter();
+    async requestApproval(input) {
+        try {
+            return await this.waiter.wait(input.requestId, input.timeoutMs ?? 300_000);
+        }
+        catch {
+            return false;
+        }
+    }
+    resolveApproval(requestId, approved) {
+        return this.waiter.resolve(requestId, approved);
+    }
+}
+//# sourceMappingURL=http-approval-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-approval-adapter.js","sourceRoot":"","sources":["../../src/session/http-approval-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,MAAM,OAAO,mBAAmB;IACrB,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE3C,KAAK,CAAC,eAAe,CAAC,KAA2B;QAC/C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,QAAiB;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;CACF"}

package/lib/session/http-approval-waiter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * In-process park/resume for HTTP tool approval (ADR 0040 P3 / ADR 0041).
+ */
+export declare class HttpApprovalWaiter {
+    private readonly pending;
+    wait(requestId: string, timeoutMs?: number): Promise<boolean>;
+    resolve(requestId: string, approved: boolean): boolean;
+    has(requestId: string): boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=http-approval-waiter.d.ts.map

package/lib/session/http-approval-waiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-approval-waiter.d.ts","sourceRoot":"","sources":["../../src/session/http-approval-waiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO;IAStD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,IAAI,IAAI;CAOhB"}

package/lib/session/http-approval-waiter.js

@@ -0,0 +1,38 @@
+/**
+ * In-process park/resume for HTTP tool approval (ADR 0040 P3 / ADR 0041).
+ */
+export class HttpApprovalWaiter {
+    pending = new Map();
+    wait(requestId, timeoutMs = 300_000) {
+        if (this.pending.has(requestId)) {
+            return Promise.reject(new Error(`Duplicate approval request: ${requestId}`));
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(requestId);
+                reject(new Error(`Approval timed out: ${requestId}`));
+            }, timeoutMs);
+            this.pending.set(requestId, { resolve, reject, timer });
+        });
+    }
+    resolve(requestId, approved) {
+        const entry = this.pending.get(requestId);
+        if (!entry)
+            return false;
+        clearTimeout(entry.timer);
+        this.pending.delete(requestId);
+        entry.resolve(approved);
+        return true;
+    }
+    has(requestId) {
+        return this.pending.has(requestId);
+    }
+    dispose() {
+        for (const [, entry] of this.pending) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error('HttpApprovalWaiter disposed'));
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=http-approval-waiter.js.map

package/lib/session/http-approval-waiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-approval-waiter.js","sourceRoot":"","sources":["../../src/session/http-approval-waiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,OAAO,kBAAkB;IACZ,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE1D,IAAI,CAAC,SAAiB,EAAE,SAAS,GAAG,OAAO;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,QAAiB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import type { AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import type { AgentStepCheckpoint } from '@zhin.js/ai/agent-step-checkpoint';
+import type { HttpAgentSessionStatus } from './http-agent-session-store.js';
+export interface PersistedHttpSessionSnapshot {
+    sessionId: string;
+    continuationToken: string;
+    status: HttpAgentSessionStatus;
+    events: AgentStreamEvent[];
+    steps: AgentStepCheckpoint[];
+    parked: boolean;
+    pendingRequestIds: string[];
+    turnRunning: boolean;
+    updatedAt: number;
+}
+export interface HttpSessionPersistence {
+    save(snapshot: PersistedHttpSessionSnapshot): Promise<void>;
+    load(sessionId: string): Promise<PersistedHttpSessionSnapshot | null>;
+    listSessionIds(): Promise<string[]>;
+}
+export declare class FileHttpSessionPersistence implements HttpSessionPersistence {
+    private readonly dataDir;
+    constructor(dataDir: string);
+    private sessionPath;
+    save(snapshot: PersistedHttpSessionSnapshot): Promise<void>;
+    load(sessionId: string): Promise<PersistedHttpSessionSnapshot | null>;
+    listSessionIds(): Promise<string[]>;
+}
+//# sourceMappingURL=http-session-persistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-session-persistence.d.ts","sourceRoot":"","sources":["../../src/session/http-session-persistence.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,QAAQ,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IACtE,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACrC;AAED,qBAAa,0BAA2B,YAAW,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,OAAO,CAAC,WAAW;IAKb,IAAI,CAAC,QAAQ,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAWrE,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAmB1C"}

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"}