@coralai/sps-cli 0.63.6 → 0.65.1

package/dist/openai-agent/storage/session.js

@@ -0,0 +1,216 @@
+import { resolve } from 'node:path';
+import { unlink } from 'node:fs/promises';
+import { protocol, } from '@openai/agents';
+import { atomicWriteJson, readJsonFile, requireInteger, requireRecord, requireString, } from './atomic.js';
+import { OpenAIAgentStorageError } from './errors.js';
+import { ExclusiveFileLock } from './lock.js';
+const SESSION_SCHEMA_VERSION = 1;
+const HISTORY_SCHEMA_VERSION = 1;
+export async function ensureSessionMetadata(start) {
+    const path = resolve(start.sessionRoot, 'session.json');
+    const lock = await ExclusiveFileLock.acquire(resolve(start.sessionRoot, '.metadata.lock'));
+    try {
+        const existing = await readJsonFile(path, parseSessionMetadata);
+        if (existing) {
+            if (JSON.stringify(existing.conversationOwner) !==
+                JSON.stringify(start.conversationOwner)) {
+                throw new OpenAIAgentStorageError('provider_state_unavailable', 'Conversation ownership cannot change within a logical session');
+            }
+            return { metadata: existing, resumed: true };
+        }
+        const now = new Date().toISOString();
+        const metadata = {
+            schemaVersion: SESSION_SCHEMA_VERSION,
+            sessionId: start.sessionId,
+            conversationOwner: start.conversationOwner,
+            providerCapabilityPlan: {
+                providerId: start.provider.providerId,
+                model: start.provider.model,
+                transport: start.provider.transport,
+            },
+            agentBundleVersion: start.agentBundleVersion,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await atomicWriteJson(path, metadata, parseSessionMetadata);
+        return { metadata, resumed: false };
+    }
+    finally {
+        await lock.release();
+    }
+}
+export class DurableAgentSession {
+    sessionId;
+    historyPath;
+    currentRevision;
+    constructor(sessionId, historyPath, currentRevision) {
+        this.sessionId = sessionId;
+        this.historyPath = historyPath;
+        this.currentRevision = currentRevision;
+    }
+    static async open(sessionRoot, sessionId) {
+        const historyPath = resolve(sessionRoot, 'history.json');
+        const history = await readJsonFile(historyPath, parseHistory);
+        if (history && history.sessionId !== sessionId) {
+            throw new OpenAIAgentStorageError('corrupt', 'History belongs to a different session');
+        }
+        return new DurableAgentSession(sessionId, historyPath, history?.revision ?? 0);
+    }
+    async getSessionId() {
+        return this.sessionId;
+    }
+    get revision() {
+        return this.currentRevision;
+    }
+    async getItems(limit) {
+        const history = await this.load();
+        const items = structuredClone(history.items);
+        return limit === undefined ? items : items.slice(-Math.max(0, limit));
+    }
+    async addItems(items) {
+        validateItems(items);
+        await this.mutate((history) => [...history.items, ...structuredClone(items)]);
+    }
+    async popItem() {
+        let popped;
+        await this.mutate((history) => {
+            const items = [...history.items];
+            popped = items.pop();
+            return items;
+        });
+        return popped;
+    }
+    async clearSession() {
+        await this.mutate(() => []);
+    }
+    async delete(expectedRevision = this.currentRevision) {
+        const lock = await ExclusiveFileLock.acquire(resolve(this.historyPath, '..', '.history.lock'));
+        try {
+            const latest = await readJsonFile(this.historyPath, parseHistory);
+            if ((latest?.revision ?? 0) !== expectedRevision) {
+                throw new OpenAIAgentStorageError('conflict', 'History revision changed before delete');
+            }
+            await unlink(this.historyPath).catch((error) => {
+                if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+                    throw error;
+                }
+            });
+            this.currentRevision = 0;
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async load() {
+        const history = await readJsonFile(this.historyPath, parseHistory);
+        if (!history) {
+            return {
+                schemaVersion: HISTORY_SCHEMA_VERSION,
+                sessionId: this.sessionId,
+                revision: 0,
+                items: [],
+            };
+        }
+        if (history.sessionId !== this.sessionId) {
+            throw new OpenAIAgentStorageError('corrupt', 'History session identity mismatch');
+        }
+        this.currentRevision = history.revision;
+        return history;
+    }
+    async mutate(update) {
+        const lock = await ExclusiveFileLock.acquire(resolve(this.historyPath, '..', '.history.lock'));
+        try {
+            const latest = (await readJsonFile(this.historyPath, parseHistory)) ?? {
+                schemaVersion: HISTORY_SCHEMA_VERSION,
+                sessionId: this.sessionId,
+                revision: 0,
+                items: [],
+            };
+            if (latest.revision !== this.currentRevision) {
+                throw new OpenAIAgentStorageError('conflict', `History revision changed from ${this.currentRevision} to ${latest.revision}`);
+            }
+            const nextItems = update(latest);
+            validateItems(nextItems);
+            const next = {
+                schemaVersion: HISTORY_SCHEMA_VERSION,
+                sessionId: this.sessionId,
+                revision: latest.revision + 1,
+                items: nextItems,
+            };
+            await atomicWriteJson(this.historyPath, next, parseHistory);
+            this.currentRevision = next.revision;
+        }
+        finally {
+            await lock.release();
+        }
+    }
+}
+function parseSessionMetadata(value) {
+    const record = requireRecord(value, 'session metadata');
+    if (record.schemaVersion !== SESSION_SCHEMA_VERSION) {
+        throw new OpenAIAgentStorageError('corrupt', 'Unsupported session metadata schema');
+    }
+    const owner = parseConversationOwner(record.conversationOwner);
+    const capability = requireRecord(record.providerCapabilityPlan, 'providerCapabilityPlan');
+    return {
+        schemaVersion: SESSION_SCHEMA_VERSION,
+        sessionId: requireString(record, 'sessionId'),
+        conversationOwner: owner,
+        providerCapabilityPlan: {
+            providerId: requireString(capability, 'providerId'),
+            model: requireString(capability, 'model'),
+            transport: requireString(capability, 'transport'),
+        },
+        agentBundleVersion: requireString(record, 'agentBundleVersion'),
+        createdAt: requireString(record, 'createdAt'),
+        updatedAt: requireString(record, 'updatedAt'),
+    };
+}
+function parseConversationOwner(value) {
+    const record = requireRecord(value, 'conversationOwner');
+    if (record.kind === 'local_session')
+        return { kind: 'local_session' };
+    if (record.kind === 'openai_conversation') {
+        return {
+            kind: 'openai_conversation',
+            ...(typeof record.conversationId === 'string'
+                ? { conversationId: record.conversationId }
+                : {}),
+        };
+    }
+    if (record.kind === 'previous_response') {
+        return {
+            kind: 'previous_response',
+            ...(typeof record.previousResponseId === 'string'
+                ? { previousResponseId: record.previousResponseId }
+                : {}),
+        };
+    }
+    throw new OpenAIAgentStorageError('corrupt', 'Unknown conversation owner kind');
+}
+function parseHistory(value) {
+    const record = requireRecord(value, 'history');
+    if (record.schemaVersion !== HISTORY_SCHEMA_VERSION) {
+        throw new OpenAIAgentStorageError('corrupt', 'Unsupported history schema');
+    }
+    if (!Array.isArray(record.items)) {
+        throw new OpenAIAgentStorageError('corrupt', 'history.items must be an array');
+    }
+    validateItems(record.items);
+    return {
+        schemaVersion: HISTORY_SCHEMA_VERSION,
+        sessionId: requireString(record, 'sessionId'),
+        revision: requireInteger(record, 'revision'),
+        items: record.items,
+    };
+}
+function validateItems(items) {
+    try {
+        for (const item of items)
+            protocol.ModelItem.parse(item);
+    }
+    catch (error) {
+        throw new OpenAIAgentStorageError('corrupt', 'History contains an invalid AgentInputItem', error);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/openai-agent/storage/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/openai-agent/storage/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,QAAQ,GAGT,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAuBjC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAC7C,CAAC;IACF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,IACE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAC1C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,EACvC,CAAC;gBACD,MAAM,IAAI,uBAAuB,CAC/B,4BAA4B,EAC5B,+DAA+D,CAChE,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAA2B;YACvC,aAAa,EAAE,sBAAsB;YACrC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,sBAAsB,EAAE;gBACtB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;gBACrC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;gBAC3B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS;aACpC;YACD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;YAC5C,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAC5D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,mBAAmB;IAEnB;IACQ;IACT;IAHV,YACW,SAAiB,EACT,WAAmB,EAC5B,eAAuB;QAFtB,cAAS,GAAT,SAAS,CAAQ;QACT,gBAAW,GAAX,WAAW,CAAQ;QAC5B,oBAAe,GAAf,eAAe,CAAQ;IAC9B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,WAAmB,EACnB,SAAiB;QAEjB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,wCAAwC,CACzC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,mBAAmB,CAC5B,SAAS,EACT,WAAW,EACX,OAAO,EAAE,QAAQ,IAAI,CAAC,CACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAc;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAuB;QACpC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,MAAkC,CAAC;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe;QAClD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAC1C,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,CAAC,CACjD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAClE,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,KAAK,gBAAgB,EAAE,CAAC;gBACjD,MAAM,IAAI,uBAAuB,CAC/B,UAAU,EACV,wCAAwC,CACzC,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtD,IACE,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,EACvE,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,aAAa,EAAE,sBAAsB;gBACrC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,MAAqD;QAErD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAC1C,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,CAAC,CACjD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GACV,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,IAAI;gBACtD,aAAa,EAAE,sBAAsB;gBACrC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,EAAE;aACV,CAAC;YACJ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC7C,MAAM,IAAI,uBAAuB,CAC/B,UAAU,EACV,iCAAiC,IAAI,CAAC,eAAe,OAAO,MAAM,CAAC,QAAQ,EAAE,CAC9E,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,MAAM,IAAI,GAAmB;gBAC3B,aAAa,EAAE,sBAAsB;gBACrC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC;gBAC7B,KAAK,EAAE,SAAS;aACjB,CAAC;YACF,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC5D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,aAAa,KAAK,sBAAsB,EAAE,CAAC;QACpD,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,qCAAqC,CACtC,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,aAAa,CAC9B,MAAM,CAAC,sBAAsB,EAC7B,wBAAwB,CACzB,CAAC;IACF,OAAO;QACL,aAAa,EAAE,sBAAsB;QACrC,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7C,iBAAiB,EAAE,KAAK;QACxB,sBAAsB,EAAE;YACtB,UAAU,EAAE,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC;YACnD,KAAK,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC;YACzC,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC;SAClD;QACD,kBAAkB,EAAE,aAAa,CAAC,MAAM,EAAE,oBAAoB,CAAC;QAC/D,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7C,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,GAAG,CAAC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;gBAC3C,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE;gBAC3C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,GAAG,CAAC,OAAO,MAAM,CAAC,kBAAkB,KAAK,QAAQ;gBAC/C,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,iCAAiC,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,aAAa,KAAK,sBAAsB,EAAE,CAAC;QACpD,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IACjF,CAAC;IACD,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO;QACL,aAAa,EAAE,sBAAsB;QACrC,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7C,QAAQ,EAAE,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC;QAC5C,KAAK,EAAE,MAAM,CAAC,KAAyB;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAgB;IACrC,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,4CAA4C,EAC5C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/openai-agent/storage/toolLedger.d.ts

@@ -0,0 +1,64 @@
+import type { JsonValue } from '../../runtime/index.js';
+export type ToolSideEffectClass = 'read_only' | 'idempotent' | 'non_idempotent';
+export type ToolLedgerStatus = 'started' | 'completed';
+export interface ToolLedgerRecord {
+    ledgerId: string;
+    sessionId: string;
+    runId: string;
+    qualifiedToolName: string;
+    providerCallId: string;
+    inputHash: string;
+    status: ToolLedgerStatus;
+    sideEffectClass: ToolSideEffectClass;
+    revision: number;
+    attempts: number;
+    startedAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    normalizedResult?: JsonValue;
+    reconciliationNote?: string;
+}
+export type ToolLedgerBeginResult = {
+    action: 'execute';
+    record: ToolLedgerRecord;
+    retry: boolean;
+} | {
+    action: 'replay';
+    record: ToolLedgerRecord;
+    result: JsonValue;
+} | {
+    action: 'operator_reconciliation';
+    record: ToolLedgerRecord;
+};
+export interface ToolLedgerBeginInput {
+    sessionId: string;
+    runId: string;
+    qualifiedToolName: string;
+    providerCallId: string;
+    input: unknown;
+    sideEffectClass: ToolSideEffectClass;
+}
+export declare class ToolExecutionLedger {
+    private readonly path;
+    private readonly lockPath;
+    constructor(sessionRoot: string);
+    begin(input: ToolLedgerBeginInput): Promise<ToolLedgerBeginResult>;
+    complete(ledgerId: string, expectedRevision: number, result: unknown): Promise<ToolLedgerRecord>;
+    noteUnknownResult(ledgerId: string, note: string): Promise<ToolLedgerRecord>;
+    reconcile(ledgerId: string, resolution: {
+        outcome: 'safe_to_retry';
+        note?: string;
+    } | {
+        outcome: 'effect_completed';
+        result: unknown;
+        note?: string;
+    }): Promise<void>;
+    assessSafety(): Promise<{
+        safeToResume: boolean;
+        unresolved: ToolLedgerRecord[];
+    }>;
+    list(): Promise<ToolLedgerRecord[]>;
+    private loadDocument;
+    private writeDocument;
+}
+//# sourceMappingURL=toolLedger.d.ts.map

package/dist/openai-agent/storage/toolLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolLedger.d.ts","sourceRoot":"","sources":["../../../src/openai-agent/storage/toolLedger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAaxD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,gBAAgB,CAAC;AACrB,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,mBAAmB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,yBAAyB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,mBAAmB,CAAC;CACtC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,WAAW,EAAE,MAAM;IAKzB,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmFlE,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,gBAAgB,CAAC;IA6CtB,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IA2BtB,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EACN;QAAE,OAAO,EAAE,eAAe,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE,OAAO,CAAC,IAAI,CAAC;IAoCV,YAAY,IAAI,OAAO,CAAC;QAC5B,YAAY,EAAE,OAAO,CAAC;QACtB,UAAU,EAAE,gBAAgB,EAAE,CAAC;KAChC,CAAC;IAUI,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAI3B,YAAY;IAU1B,OAAO,CAAC,aAAa;CAGtB"}

package/dist/openai-agent/storage/toolLedger.js

@@ -0,0 +1,281 @@
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+import { atomicWriteJson, readJsonFile, requireInteger, requireRecord, requireString, } from './atomic.js';
+import { OpenAIAgentStorageError } from './errors.js';
+import { ExclusiveFileLock } from './lock.js';
+const TOOL_LEDGER_SCHEMA_VERSION = 1;
+export class ToolExecutionLedger {
+    path;
+    lockPath;
+    constructor(sessionRoot) {
+        this.path = resolve(sessionRoot, 'tool-ledger.json');
+        this.lockPath = resolve(sessionRoot, '.tool-ledger.lock');
+    }
+    async begin(input) {
+        const normalizedInput = normalizeJson(input.input, 'tool input');
+        const inputHash = hashJson(normalizedInput);
+        const ledgerId = ledgerKey(input);
+        const lock = await ExclusiveFileLock.acquire(this.lockPath);
+        try {
+            const document = await this.loadDocument();
+            const conflictingCall = Object.values(document.records).find((record) => record.sessionId === input.sessionId &&
+                record.providerCallId === input.providerCallId &&
+                record.ledgerId !== ledgerId);
+            if (conflictingCall) {
+                throw new OpenAIAgentStorageError('corrupt', `Tool call ${input.providerCallId} changed identity from ${conflictingCall.qualifiedToolName} to ${input.qualifiedToolName}`);
+            }
+            const existing = document.records[ledgerId];
+            if (existing) {
+                if (existing.inputHash !== inputHash ||
+                    existing.sideEffectClass !== input.sideEffectClass) {
+                    throw new OpenAIAgentStorageError('corrupt', `Tool call ${input.providerCallId} changed input or side-effect class`);
+                }
+                if (existing.status === 'completed') {
+                    if (existing.normalizedResult === undefined) {
+                        throw new OpenAIAgentStorageError('corrupt', `Completed tool call ${input.providerCallId} has no result`);
+                    }
+                    return {
+                        action: 'replay',
+                        record: existing,
+                        result: existing.normalizedResult,
+                    };
+                }
+                if (existing.sideEffectClass === 'non_idempotent') {
+                    return { action: 'operator_reconciliation', record: existing };
+                }
+                const retried = {
+                    ...existing,
+                    attempts: existing.attempts + 1,
+                    revision: existing.revision + 1,
+                    updatedAt: new Date().toISOString(),
+                    reconciliationNote: 'Previous execution had no durable result; retry is allowed by side-effect policy.',
+                };
+                document.records[ledgerId] = retried;
+                document.revision += 1;
+                await this.writeDocument(document);
+                return { action: 'execute', record: retried, retry: true };
+            }
+            const now = new Date().toISOString();
+            const record = {
+                ledgerId,
+                sessionId: input.sessionId,
+                runId: input.runId,
+                qualifiedToolName: input.qualifiedToolName,
+                providerCallId: input.providerCallId,
+                inputHash,
+                status: 'started',
+                sideEffectClass: input.sideEffectClass,
+                revision: 1,
+                attempts: 1,
+                startedAt: now,
+                updatedAt: now,
+            };
+            document.records[ledgerId] = record;
+            document.revision += 1;
+            await this.writeDocument(document);
+            return { action: 'execute', record, retry: false };
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async complete(ledgerId, expectedRevision, result) {
+        const normalizedResult = normalizeJson(result, 'tool result');
+        const lock = await ExclusiveFileLock.acquire(this.lockPath);
+        try {
+            const document = await this.loadDocument();
+            const record = document.records[ledgerId];
+            if (!record) {
+                throw new OpenAIAgentStorageError('not_found', `Tool ledger record ${ledgerId} was not found`);
+            }
+            if (record.status === 'completed') {
+                if (hashJson(record.normalizedResult) === hashJson(normalizedResult)) {
+                    return record;
+                }
+                throw new OpenAIAgentStorageError('conflict', `Tool ledger record ${ledgerId} already has a different result`);
+            }
+            if (record.revision !== expectedRevision) {
+                throw new OpenAIAgentStorageError('conflict', `Tool ledger revision changed from ${expectedRevision} to ${record.revision}`);
+            }
+            const now = new Date().toISOString();
+            const completed = {
+                ...record,
+                status: 'completed',
+                revision: record.revision + 1,
+                normalizedResult,
+                completedAt: now,
+                updatedAt: now,
+            };
+            document.records[ledgerId] = completed;
+            document.revision += 1;
+            await this.writeDocument(document);
+            return completed;
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async noteUnknownResult(ledgerId, note) {
+        const lock = await ExclusiveFileLock.acquire(this.lockPath);
+        try {
+            const document = await this.loadDocument();
+            const record = document.records[ledgerId];
+            if (!record) {
+                throw new OpenAIAgentStorageError('not_found', `Tool ledger record ${ledgerId} was not found`);
+            }
+            if (record.status === 'completed')
+                return record;
+            const next = {
+                ...record,
+                revision: record.revision + 1,
+                updatedAt: new Date().toISOString(),
+                reconciliationNote: note.slice(0, 2_000),
+            };
+            document.records[ledgerId] = next;
+            document.revision += 1;
+            await this.writeDocument(document);
+            return next;
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async reconcile(ledgerId, resolution) {
+        const lock = await ExclusiveFileLock.acquire(this.lockPath);
+        try {
+            const document = await this.loadDocument();
+            const record = document.records[ledgerId];
+            if (!record || record.status !== 'started') {
+                throw new OpenAIAgentStorageError('conflict', `Tool ledger record ${ledgerId} is not awaiting reconciliation`);
+            }
+            if (resolution.outcome === 'safe_to_retry') {
+                delete document.records[ledgerId];
+            }
+            else {
+                const now = new Date().toISOString();
+                document.records[ledgerId] = {
+                    ...record,
+                    status: 'completed',
+                    revision: record.revision + 1,
+                    normalizedResult: normalizeJson(resolution.result, 'reconciled tool result'),
+                    completedAt: now,
+                    updatedAt: now,
+                    reconciliationNote: resolution.note ?? 'Operator confirmed the effect completed.',
+                };
+            }
+            document.revision += 1;
+            await this.writeDocument(document);
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    async assessSafety() {
+        const records = Object.values((await this.loadDocument()).records);
+        const unresolved = records.filter((record) => record.status === 'started' &&
+            record.sideEffectClass === 'non_idempotent');
+        return { safeToResume: unresolved.length === 0, unresolved };
+    }
+    async list() {
+        return Object.values((await this.loadDocument()).records);
+    }
+    async loadDocument() {
+        return ((await readJsonFile(this.path, parseDocument)) ?? {
+            schemaVersion: TOOL_LEDGER_SCHEMA_VERSION,
+            revision: 0,
+            records: {},
+        });
+    }
+    writeDocument(document) {
+        return atomicWriteJson(this.path, document, parseDocument);
+    }
+}
+function ledgerKey(input) {
+    return `tool_${createHash('sha256')
+        .update(`${input.sessionId}\0${input.qualifiedToolName}\0${input.providerCallId}`)
+        .digest('hex')
+        .slice(0, 40)}`;
+}
+function hashJson(value) {
+    return createHash('sha256').update(stableStringify(value)).digest('hex');
+}
+function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function normalizeJson(value, label) {
+    try {
+        const serialized = JSON.stringify(value);
+        if (serialized === undefined) {
+            throw new Error(`${label} is undefined`);
+        }
+        return JSON.parse(serialized);
+    }
+    catch (error) {
+        throw new OpenAIAgentStorageError('persistence_error', `${label} is not JSON serializable`, error);
+    }
+}
+function parseDocument(value) {
+    const document = requireRecord(value, 'tool ledger');
+    if (document.schemaVersion !== TOOL_LEDGER_SCHEMA_VERSION) {
+        throw new OpenAIAgentStorageError('corrupt', 'Unsupported tool ledger schema');
+    }
+    const rawRecords = requireRecord(document.records, 'tool ledger records');
+    return {
+        schemaVersion: TOOL_LEDGER_SCHEMA_VERSION,
+        revision: requireInteger(document, 'revision'),
+        records: Object.fromEntries(Object.entries(rawRecords).map(([key, value]) => {
+            const record = parseRecord(value);
+            if (record.ledgerId !== key) {
+                throw new OpenAIAgentStorageError('corrupt', 'Tool ledger key does not match ledgerId');
+            }
+            return [key, record];
+        })),
+    };
+}
+function parseRecord(value) {
+    const record = requireRecord(value, 'tool ledger record');
+    const status = record.status;
+    const sideEffectClass = record.sideEffectClass;
+    if (status !== 'started' && status !== 'completed') {
+        throw new OpenAIAgentStorageError('corrupt', 'Invalid tool ledger status');
+    }
+    if (sideEffectClass !== 'read_only' &&
+        sideEffectClass !== 'idempotent' &&
+        sideEffectClass !== 'non_idempotent') {
+        throw new OpenAIAgentStorageError('corrupt', 'Invalid tool side-effect class');
+    }
+    const normalizedResult = record.normalizedResult === undefined
+        ? undefined
+        : normalizeJson(record.normalizedResult, 'tool result');
+    return {
+        ledgerId: requireString(record, 'ledgerId'),
+        sessionId: requireString(record, 'sessionId'),
+        runId: requireString(record, 'runId'),
+        qualifiedToolName: requireString(record, 'qualifiedToolName'),
+        providerCallId: requireString(record, 'providerCallId'),
+        inputHash: requireString(record, 'inputHash'),
+        status,
+        sideEffectClass,
+        revision: requireInteger(record, 'revision', 1),
+        attempts: requireInteger(record, 'attempts', 1),
+        startedAt: requireString(record, 'startedAt'),
+        updatedAt: requireString(record, 'updatedAt'),
+        ...(typeof record.completedAt === 'string'
+            ? { completedAt: record.completedAt }
+            : {}),
+        ...(normalizedResult === undefined ? {} : { normalizedResult }),
+        ...(typeof record.reconciliationNote === 'string'
+            ? { reconciliationNote: record.reconciliationNote }
+            : {}),
+    };
+}
+//# sourceMappingURL=toolLedger.js.map

package/dist/openai-agent/storage/toolLedger.js.map

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

package/dist/openai-agent/storage/workerStorage.d.ts

@@ -0,0 +1,21 @@
+import type { AgentProcessStartCommandV1 } from '../../runtime/index.js';
+import { RunCheckpointStore } from './checkpoint.js';
+import { InteractionStore } from './interaction.js';
+import { WorkerOutputStore } from './output.js';
+import { DurableAgentSession } from './session.js';
+import { WorkspaceStateStore } from './workspace.js';
+import { ToolExecutionLedger } from './toolLedger.js';
+import { WorkerRunMetricsStore } from './metrics.js';
+export interface OpenAIAgentWorkerStorage {
+    resumed: boolean;
+    session?: DurableAgentSession;
+    checkpoint: RunCheckpointStore;
+    interactions: InteractionStore;
+    ledger: ToolExecutionLedger;
+    metrics: WorkerRunMetricsStore;
+    output: WorkerOutputStore;
+    workspace: WorkspaceStateStore;
+    close(): Promise<void>;
+}
+export declare function prepareOpenAIAgentWorkerStorage(start: AgentProcessStartCommandV1): Promise<OpenAIAgentWorkerStorage>;
+//# sourceMappingURL=workerStorage.d.ts.map

package/dist/openai-agent/storage/workerStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerStorage.d.ts","sourceRoot":"","sources":["../../../src/openai-agent/storage/workerStorage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAqCnC"}