@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/persistence/file-store.js

@@ -1,758 +1,3 @@
-import path from "node:path";
-import { appendFile, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import { ensureDir, fileExists, readJson, writeJson } from "../utils/fs.js";
-import { resolveRuntimeArtifactsRoot } from "../runtime/layout/runtime-layout.js";
-function nowIso() {
-    return new Date(Date.now()).toISOString();
-}
-export class FilePersistence {
-    runtimeRoot;
-    constructor(runtimeRoot) {
-        this.runtimeRoot = runtimeRoot;
-    }
-    artifactsRoot() {
-        return resolveRuntimeArtifactsRoot(this.runtimeRoot);
-    }
-    sessionIndexPath(sessionId) {
-        return path.join(this.artifactsRoot(), "indexes", "sessions", `${sessionId}.json`);
-    }
-    requestIndexPath(requestId) {
-        return path.join(this.artifactsRoot(), "indexes", "requests", `${requestId}.json`);
-    }
-    approvalIndexPath(approvalId) {
-        return path.join(this.artifactsRoot(), "indexes", "approvals", `${approvalId}.json`);
-    }
-    requestQueuePath(requestId) {
-        return path.join(this.artifactsRoot(), "indexes", "requests-queue", `${requestId}.json`);
-    }
-    requestControlPath(requestId) {
-        return path.join(this.artifactsRoot(), "indexes", "requests-control", `${requestId}.json`);
-    }
-    traceItemsPath(sessionId, requestId) {
-        return path.join(this.requestDir(sessionId, requestId), "trace-items.ndjson");
-    }
-    requestPlanStatePath(sessionId, requestId) {
-        return path.join(this.requestDir(sessionId, requestId), "plan-state.json");
-    }
-    async writeSessionHead(sessionId, input) {
-        const sessionMetaPath = path.join(this.sessionDir(sessionId), "meta.json");
-        const sessionMeta = await readJson(sessionMetaPath);
-        await Promise.all([
-            writeJson(sessionMetaPath, {
-                ...sessionMeta,
-                status: input.status,
-                latestRequestId: input.latestRequestId,
-                updatedAt: input.updatedAt,
-            }),
-            writeJson(this.sessionIndexPath(sessionId), {
-                sessionId,
-                status: input.status,
-                latestRequestId: input.latestRequestId,
-                updatedAt: input.updatedAt,
-            }),
-        ]);
-    }
-    async initialize() {
-        await Promise.all([
-            "indexes/sessions",
-            "indexes/requests",
-            "indexes/approvals",
-            "indexes/requests-queue",
-            "indexes/requests-control",
-            "sessions",
-        ].map((segment) => ensureDir(path.join(this.artifactsRoot(), segment))));
-    }
-    sessionDir(sessionId) {
-        return path.join(this.artifactsRoot(), "sessions", sessionId);
-    }
-    requestDir(sessionId, requestId) {
-        return path.join(this.sessionDir(sessionId), "requests", requestId);
-    }
-    async createSession(input) {
-        const meta = {
-            sessionId: input.sessionId,
-            workspaceId: "default",
-            entryAgentId: input.agentId,
-            createdAt: input.createdAt,
-            updatedAt: input.createdAt,
-            status: input.status,
-            latestRequestId: input.requestId,
-        };
-        await writeJson(path.join(this.sessionDir(input.sessionId), "meta.json"), meta);
-        await writeJson(path.join(this.sessionDir(input.sessionId), "messages.json"), {
-            sessionId: input.sessionId,
-            items: [],
-        });
-        await writeJson(this.sessionIndexPath(input.sessionId), {
-            sessionId: input.sessionId,
-            status: input.status,
-            latestRequestId: input.requestId,
-            updatedAt: input.createdAt,
-        });
-    }
-    async createRequest(input) {
-        const requestDir = this.requestDir(input.sessionId, input.requestId);
-        await ensureDir(path.join(requestDir, "events"));
-        await ensureDir(path.join(requestDir, "approvals"));
-        const sessionMeta = await this.getSessionMeta(input.sessionId);
-        const parentRequestId = sessionMeta?.latestRequestId === input.requestId
-            ? null
-            : sessionMeta?.latestRequestId ?? null;
-        const meta = {
-            requestId: input.requestId,
-            sessionId: input.sessionId,
-            agentId: input.agentId,
-            parentRequestId,
-            executionMode: input.executionMode,
-            adapterKind: input.adapterKind ?? input.executionMode,
-            createdAt: input.createdAt,
-            updatedAt: input.createdAt,
-        };
-        const lifecycle = {
-            state: "running",
-            previousState: null,
-            stateEnteredAt: input.createdAt,
-            lastTransitionAt: input.createdAt,
-            resumable: false,
-            checkpointRef: null,
-        };
-        const inspection = {
-            startedAt: input.startedAt ?? input.createdAt,
-            endedAt: null,
-            lastActivityAt: input.createdAt,
-            currentAgentId: input.currentAgentId ?? input.agentId,
-            delegationChain: input.delegationChain ?? [input.currentAgentId ?? input.agentId],
-            runtimeSnapshot: input.runtimeSnapshot ?? null,
-            traceItems: [],
-        };
-        await Promise.all([
-            writeJson(path.join(requestDir, "meta.json"), meta),
-            writeJson(path.join(requestDir, "lifecycle.json"), lifecycle),
-            writeJson(path.join(requestDir, "inspection.json"), inspection),
-            writeFile(this.traceItemsPath(input.sessionId, input.requestId), "", "utf8"),
-            writeJson(path.join(requestDir, "checkpoint-ref.json"), {
-                sessionId: input.sessionId,
-                requestId: input.requestId,
-                checkpointRef: null,
-                savedAt: input.createdAt,
-                kind: "langgraph-checkpoint",
-            }),
-            writeJson(path.join(requestDir, "artifacts.json"), {
-                sessionId: input.sessionId,
-                requestId: input.requestId,
-                items: [],
-            }),
-            writeJson(path.join(requestDir, "error.json"), {
-                hasError: false,
-                lastError: null,
-            }),
-            writeJson(this.requestIndexPath(input.requestId), {
-                requestId: input.requestId,
-                sessionId: input.sessionId,
-                state: "running",
-                resumable: false,
-                updatedAt: input.createdAt,
-            }),
-            writeJson(this.requestControlPath(input.requestId), {
-                requestId: input.requestId,
-                cancelRequested: false,
-                cancelReason: null,
-                cancelRequestedAt: null,
-                heartbeatAt: null,
-                workerId: null,
-                workerStartedAt: null,
-            }),
-        ]);
-        await this.writeSessionHead(input.sessionId, {
-            latestRequestId: input.requestId,
-            status: "running",
-            updatedAt: input.createdAt,
-        });
-    }
-    async setRequestState(sessionId, requestId, state, checkpointRef) {
-        const lifecyclePath = path.join(this.requestDir(sessionId, requestId), "lifecycle.json");
-        const requestMetaPath = path.join(this.requestDir(sessionId, requestId), "meta.json");
-        const inspectionPath = path.join(this.requestDir(sessionId, requestId), "inspection.json");
-        const [lifecycle, requestMeta, inspection] = await Promise.all([
-            readJson(lifecyclePath),
-            readJson(requestMetaPath),
-            readJson(inspectionPath),
-        ]);
-        const now = nowIso();
-        const next = {
-            state,
-            previousState: lifecycle.state,
-            stateEnteredAt: now,
-            lastTransitionAt: now,
-            resumable: state === "waiting_for_approval",
-            checkpointRef: checkpointRef ?? lifecycle.checkpointRef,
-        };
-        await Promise.all([
-            writeJson(lifecyclePath, next),
-            writeJson(requestMetaPath, {
-                ...requestMeta,
-                updatedAt: now,
-            }),
-            writeJson(inspectionPath, {
-                ...inspection,
-                endedAt: state === "completed" || state === "failed" || state === "cancelled" ? now : inspection.endedAt,
-                lastActivityAt: now,
-            }),
-        ]);
-        if (checkpointRef !== undefined) {
-            await writeJson(path.join(this.requestDir(sessionId, requestId), "checkpoint-ref.json"), {
-                sessionId,
-                requestId,
-                checkpointRef,
-                savedAt: now,
-                kind: "langgraph-checkpoint",
-            });
-        }
-        await writeJson(this.requestIndexPath(requestId), {
-            requestId,
-            sessionId,
-            state,
-            resumable: next.resumable,
-            updatedAt: now,
-        });
-        await this.writeSessionHead(sessionId, {
-            latestRequestId: requestId,
-            status: state,
-            updatedAt: now,
-        });
-    }
-    async appendEvent(event) {
-        const sequenceId = String(event.sequence).padStart(6, "0");
-        const inspectionPath = path.join(this.requestDir(event.sessionId, event.requestId), "inspection.json");
-        const inspection = await readJson(inspectionPath);
-        await Promise.all([
-            writeJson(path.join(this.requestDir(event.sessionId, event.requestId), "events", `${sequenceId}.json`), event),
-            writeJson(inspectionPath, {
-                ...inspection,
-                lastActivityAt: event.timestamp,
-            }),
-        ]);
-    }
-    async listSessions(filter = {}) {
-        const sessionIndexDir = path.join(this.artifactsRoot(), "indexes", "sessions");
-        if (!(await fileExists(sessionIndexDir))) {
-            return [];
-        }
-        const entries = await readdir(sessionIndexDir);
-        const records = await Promise.all(entries.map(async (entry) => {
-            const index = await readJson(path.join(sessionIndexDir, entry));
-            const [meta, runInspection] = await Promise.all([
-                readJson(path.join(this.sessionDir(index.sessionId), "meta.json")),
-                readJson(path.join(this.requestDir(index.sessionId, index.latestRequestId), "inspection.json")).catch(() => null),
-            ]);
-            return {
-                agentId: meta.entryAgentId,
-                sessionId: index.sessionId,
-                latestRequestId: index.latestRequestId,
-                createdAt: meta.createdAt,
-                updatedAt: index.updatedAt,
-                status: index.status,
-                currentAgentId: runInspection?.currentAgentId ?? undefined,
-            };
-        }));
-        return records
-            .filter((record) => !filter.agentId || record.agentId === filter.agentId)
-            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
-    }
-    async listSessionSummaries(filter = {}) {
-        const sessions = await this.listSessions(filter);
-        const summaries = await Promise.all(sessions.map(async (session) => {
-            const [meta, messageBundle] = await Promise.all([
-                readJson(path.join(this.sessionDir(session.sessionId), "meta.json")),
-                readJson(path.join(this.sessionDir(session.sessionId), "messages.json"))
-                    .catch(() => ({ sessionId: session.sessionId, items: [] })),
-            ]);
-            const items = messageBundle.items;
-            return {
-                ...session,
-                entryAgentId: meta.entryAgentId,
-                messageCount: items.length,
-                firstMessage: items[0],
-                lastMessage: items.at(-1),
-            };
-        }));
-        return summaries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
-    }
-    async listRequestIndexes() {
-        const runIndexDir = path.join(this.artifactsRoot(), "indexes", "requests");
-        if (!(await fileExists(runIndexDir))) {
-            return [];
-        }
-        const entries = (await readdir(runIndexDir)).sort();
-        return Promise.all(entries.map((entry) => readJson(path.join(runIndexDir, entry))));
-    }
-    async readRequestSummary(sessionId, requestId) {
-        const requestDir = this.requestDir(sessionId, requestId);
-        const [meta, lifecycle, inspection] = await Promise.all([
-            readJson(path.join(requestDir, "meta.json")),
-            readJson(path.join(requestDir, "lifecycle.json")),
-            readJson(path.join(requestDir, "inspection.json")),
-        ]);
-        return {
-            requestId: meta.requestId,
-            sessionId: meta.sessionId,
-            agentId: meta.agentId,
-            ...(meta.parentRequestId ? { parentRequestId: meta.parentRequestId } : {}),
-            executionMode: meta.executionMode,
-            adapterKind: meta.adapterKind ?? meta.executionMode,
-            createdAt: meta.createdAt,
-            updatedAt: meta.updatedAt,
-            state: lifecycle.state,
-            checkpointRef: lifecycle.checkpointRef,
-            resumable: lifecycle.resumable,
-            startedAt: inspection.startedAt,
-            ...(inspection.endedAt ? { endedAt: inspection.endedAt } : {}),
-            lastActivityAt: inspection.lastActivityAt,
-            ...(inspection.currentAgentId ? { currentAgentId: inspection.currentAgentId } : {}),
-            delegationChain: inspection.delegationChain,
-            ...(inspection.runtimeSnapshot ? { runtimeSnapshot: inspection.runtimeSnapshot } : {}),
-        };
-    }
-    async listRequests(filter = {}) {
-        const indexes = await this.listRequestIndexes();
-        const requests = await Promise.all(indexes.map((record) => this.readRequestSummary(record.sessionId, record.requestId)));
-        return requests
-            .filter((request) => {
-            if (filter.agentId && request.agentId !== filter.agentId) {
-                return false;
-            }
-            if (filter.sessionId && request.sessionId !== filter.sessionId) {
-                return false;
-            }
-            if (filter.state && request.state !== filter.state) {
-                return false;
-            }
-            return true;
-        })
-            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    }
-    async getRequest(requestId) {
-        const indexPath = this.requestIndexPath(requestId);
-        if (!(await fileExists(indexPath))) {
-            return null;
-        }
-        const index = await readJson(indexPath);
-        return this.readRequestSummary(index.sessionId, index.requestId);
-    }
-    async getSession(sessionId) {
-        const filePath = this.sessionIndexPath(sessionId);
-        if (!(await fileExists(filePath))) {
-            return null;
-        }
-        const [index, meta] = await Promise.all([
-            readJson(filePath),
-            readJson(path.join(this.sessionDir(sessionId), "meta.json")),
-        ]);
-        const runInspection = await readJson(path.join(this.requestDir(sessionId, index.latestRequestId), "inspection.json")).catch(() => null);
-        return {
-            agentId: meta.entryAgentId,
-            sessionId,
-            latestRequestId: index.latestRequestId,
-            createdAt: meta.createdAt,
-            updatedAt: index.updatedAt,
-            status: index.status,
-            currentAgentId: runInspection?.currentAgentId ?? undefined,
-        };
-    }
-    async getSessionMeta(sessionId) {
-        const filePath = path.join(this.sessionDir(sessionId), "meta.json");
-        if (!(await fileExists(filePath))) {
-            return null;
-        }
-        return readJson(filePath);
-    }
-    async listSessionRequests(sessionId) {
-        const requestsDir = path.join(this.sessionDir(sessionId), "requests");
-        if (!(await fileExists(requestsDir))) {
-            return [];
-        }
-        const requestIds = (await readdir(requestsDir)).sort();
-        const requests = await Promise.all(requestIds.map(async (requestId) => this.readRequestSummary(sessionId, requestId)));
-        return requests.sort((left, right) => right.createdAt.localeCompare(left.createdAt));
-    }
-    async listRequestEvents(sessionId, requestId) {
-        const eventsDir = path.join(this.requestDir(sessionId, requestId), "events");
-        if (!(await fileExists(eventsDir))) {
-            return [];
-        }
-        const entries = (await readdir(eventsDir))
-            .filter((entry) => entry.endsWith(".json"))
-            .sort((left, right) => left.localeCompare(right));
-        return Promise.all(entries.map((entry) => readJson(path.join(eventsDir, entry))));
-    }
-    async listApprovals(filter = {}) {
-        const approvalsDir = path.join(this.artifactsRoot(), "indexes", "approvals");
-        if (!(await fileExists(approvalsDir))) {
-            return [];
-        }
-        const entries = (await readdir(approvalsDir)).sort();
-        const approvals = await Promise.all(entries.map((entry) => readJson(path.join(approvalsDir, entry))));
-        return approvals.filter((approval) => {
-            if (filter.status && approval.status !== filter.status) {
-                return false;
-            }
-            if (filter.sessionId && approval.sessionId !== filter.sessionId) {
-                return false;
-            }
-            if (filter.requestId && approval.requestId !== filter.requestId) {
-                return false;
-            }
-            return true;
-        });
-    }
-    async getApproval(approvalId) {
-        const approvalPath = this.approvalIndexPath(approvalId);
-        if (!(await fileExists(approvalPath))) {
-            return null;
-        }
-        return readJson(approvalPath);
-    }
-    async getRequestApprovals(sessionId, requestId) {
-        const approvalsDir = path.join(this.requestDir(sessionId, requestId), "approvals");
-        if (!(await fileExists(approvalsDir))) {
-            return [];
-        }
-        const entries = (await readdir(approvalsDir)).sort();
-        return Promise.all(entries.map((entry) => readJson(path.join(approvalsDir, entry))));
-    }
-    async getRequestMeta(sessionId, requestId) {
-        return readJson(path.join(this.requestDir(sessionId, requestId), "meta.json"));
-    }
-    async getRequestLifecycle(sessionId, requestId) {
-        return readJson(path.join(this.requestDir(sessionId, requestId), "lifecycle.json"));
-    }
-    async getRequestInspection(sessionId, requestId) {
-        const inspection = await readJson(path.join(this.requestDir(sessionId, requestId), "inspection.json"));
-        const traceItems = await this.listRequestTraceItems(sessionId, requestId);
-        return {
-            ...inspection,
-            traceItems,
-        };
-    }
-    async updateRequestInspection(sessionId, requestId, patch) {
-        const inspectionPath = path.join(this.requestDir(sessionId, requestId), "inspection.json");
-        const current = await readJson(inspectionPath);
-        const traceItems = Array.isArray(current.traceItems)
-            ? current.traceItems
-            : Array.isArray(current.upstreamEvents)
-                ? current.upstreamEvents
-                : [];
-        await writeJson(inspectionPath, {
-            ...current,
-            ...(patch.endedAt !== undefined ? { endedAt: patch.endedAt } : {}),
-            ...(patch.lastActivityAt ? { lastActivityAt: patch.lastActivityAt } : {}),
-            ...(patch.currentAgentId !== undefined ? { currentAgentId: patch.currentAgentId } : {}),
-            ...(patch.delegationChain ? { delegationChain: patch.delegationChain } : {}),
-            ...(patch.runtimeSnapshot !== undefined ? { runtimeSnapshot: patch.runtimeSnapshot } : {}),
-            traceItems,
-        });
-    }
-    async appendRequestTraceItem(sessionId, requestId, item) {
-        await appendFile(this.traceItemsPath(sessionId, requestId), `${JSON.stringify(item)}\n`, "utf8");
-    }
-    async listRequestTraceItems(sessionId, requestId) {
-        const traceItemsPath = this.traceItemsPath(sessionId, requestId);
-        if (await fileExists(traceItemsPath)) {
-            const contents = await readFile(traceItemsPath, "utf8");
-            const traceItems = contents
-                .split("\n")
-                .map((line) => line.trim())
-                .filter((line) => line.length > 0)
-                .map((line) => JSON.parse(line));
-            if (traceItems.length > 0) {
-                return traceItems;
-            }
-        }
-        const inspection = await readJson(path.join(this.requestDir(sessionId, requestId), "inspection.json"));
-        return Array.isArray(inspection.traceItems)
-            ? inspection.traceItems
-            : Array.isArray(inspection.upstreamEvents)
-                ? inspection.upstreamEvents
-                : [];
-    }
-    async deleteSession(sessionId) {
-        const sessionDir = this.sessionDir(sessionId);
-        const sessionIndexPath = this.sessionIndexPath(sessionId);
-        if (!(await fileExists(sessionDir)) && !(await fileExists(sessionIndexPath))) {
-            return false;
-        }
-        const [runIndexes, approvals] = await Promise.all([
-            this.listRequestIndexes(),
-            this.listApprovals(),
-        ]);
-        await Promise.all([
-            ...runIndexes
-                .filter((record) => record.sessionId === sessionId)
-                .map((record) => rm(this.requestIndexPath(record.requestId), { force: true })),
-            ...approvals
-                .filter((record) => record.sessionId === sessionId)
-                .map((record) => rm(this.approvalIndexPath(record.approvalId), { force: true })),
-            ...runIndexes
-                .filter((record) => record.sessionId === sessionId)
-                .flatMap((record) => [rm(this.requestQueuePath(record.requestId), { force: true }), rm(this.requestControlPath(record.requestId), { force: true })]),
-            rm(sessionIndexPath, { force: true }),
-            rm(sessionDir, { recursive: true, force: true }),
-        ]);
-        return true;
-    }
-    async saveRequestInput(sessionId, requestId, request) {
-        await writeJson(path.join(this.requestDir(sessionId, requestId), "request.json"), request);
-    }
-    async getRequestInput(sessionId, requestId) {
-        const requestPath = path.join(this.requestDir(sessionId, requestId), "request.json");
-        if (!(await fileExists(requestPath))) {
-            return null;
-        }
-        return readJson(requestPath);
-    }
-    async clearRequestInput(sessionId, requestId) {
-        const requestPath = path.join(this.requestDir(sessionId, requestId), "request.json");
-        if (await fileExists(requestPath)) {
-            await rm(requestPath, { force: true });
-        }
-    }
-    async createApproval(record) {
-        const sessionId = record.sessionId;
-        const requestId = record.requestId;
-        const normalized = {
-            ...record,
-            sessionId,
-            requestId,
-        };
-        await Promise.all([
-            writeJson(path.join(this.requestDir(sessionId, requestId), "approvals", `${record.approvalId}.json`), normalized),
-            writeJson(this.approvalIndexPath(record.approvalId), normalized),
-        ]);
-    }
-    async resolveApproval(sessionId, requestId, approvalId, status) {
-        const approvalPath = path.join(this.requestDir(sessionId, requestId), "approvals", `${approvalId}.json`);
-        const current = await readJson(approvalPath);
-        const updated = {
-            ...current,
-            status,
-            resolvedAt: nowIso(),
-        };
-        await Promise.all([
-            writeJson(approvalPath, updated),
-            writeJson(this.approvalIndexPath(approvalId), updated),
-        ]);
-        return updated;
-    }
-    async saveRequestPlanState(sessionId, requestId, planState) {
-        await writeJson(this.requestPlanStatePath(sessionId, requestId), planState);
-    }
-    async getRequestPlanState(sessionId, requestId) {
-        const planStatePath = this.requestPlanStatePath(sessionId, requestId);
-        if (!(await fileExists(planStatePath))) {
-            return null;
-        }
-        return readJson(planStatePath);
-    }
-    async clearRequestPlanState(sessionId, requestId) {
-        await rm(this.requestPlanStatePath(sessionId, requestId), { force: true });
-    }
-    async createRequestArtifact(sessionId, requestId, artifact, content) {
-        const requestDir = this.requestDir(sessionId, requestId);
-        await writeJson(path.join(requestDir, artifact.path), content);
-        const artifactsPath = path.join(requestDir, "artifacts.json");
-        const current = await readJson(artifactsPath);
-        current.items.push(artifact);
-        await writeJson(artifactsPath, current);
-        return artifact;
-    }
-    async listRequestArtifacts(sessionId, requestId) {
-        return readJson(path.join(this.requestDir(sessionId, requestId), "artifacts.json"));
-    }
-    async readRequestArtifact(sessionId, requestId, artifactPath) {
-        const filePath = path.join(this.requestDir(sessionId, requestId), artifactPath);
-        if (!(await fileExists(filePath))) {
-            return null;
-        }
-        return readJson(filePath);
-    }
-    async appendSessionMessage(sessionId, message) {
-        const messagesPath = path.join(this.sessionDir(sessionId), "messages.json");
-        const current = (await fileExists(messagesPath))
-            ? await readJson(messagesPath)
-            : { sessionId, items: [] };
-        current.items.push(message);
-        await writeJson(messagesPath, {
-            sessionId: current.sessionId ?? sessionId,
-            items: current.items,
-        });
-    }
-    async listSessionMessages(sessionId, limit = 12) {
-        const messagesPath = path.join(this.sessionDir(sessionId), "messages.json");
-        if (!(await fileExists(messagesPath))) {
-            return [];
-        }
-        const current = await readJson(messagesPath);
-        return current.items.slice(-limit);
-    }
-    async saveRequestRecoveryIntent(sessionId, requestId, intent) {
-        await writeJson(path.join(this.requestDir(sessionId, requestId), "recovery-intent.json"), intent);
-    }
-    async getRequestRecoveryIntent(sessionId, requestId) {
-        const intentPath = path.join(this.requestDir(sessionId, requestId), "recovery-intent.json");
-        if (!(await fileExists(intentPath))) {
-            return null;
-        }
-        return readJson(intentPath);
-    }
-    async clearRequestRecoveryIntent(sessionId, requestId) {
-        const intentPath = path.join(this.requestDir(sessionId, requestId), "recovery-intent.json");
-        if (!(await fileExists(intentPath))) {
-            return;
-        }
-        await rm(intentPath, { force: true });
-    }
-    async enqueueRequest(input) {
-        const current = (await this.getQueuedRequest(input.requestId)) ?? {
-            requestId: input.requestId,
-            sessionId: input.sessionId,
-            priority: input.priority ?? 0,
-            queueKey: input.queueKey ?? null,
-            enqueuedAt: nowIso(),
-            availableAt: input.availableAt ?? nowIso(),
-            claimedBy: null,
-            claimedAt: null,
-            leaseExpiresAt: null,
-            attemptCount: 0,
-            lastError: null,
-        };
-        await writeJson(this.requestQueuePath(input.requestId), {
-            ...current,
-            sessionId: input.sessionId,
-            priority: input.priority ?? current.priority,
-            queueKey: input.queueKey ?? current.queueKey,
-            availableAt: input.availableAt ?? current.availableAt,
-            claimedBy: null,
-            claimedAt: null,
-            leaseExpiresAt: null,
-            lastError: null,
-        });
-    }
-    async getQueuedRequest(requestId) {
-        const filePath = this.requestQueuePath(requestId);
-        if (!(await fileExists(filePath))) {
-            return null;
-        }
-        return readJson(filePath);
-    }
-    async claimQueuedRequest(input) {
-        const current = await this.getQueuedRequest(input.requestId);
-        if (!current) {
-            throw new Error(`Missing queued request ${input.requestId}`);
-        }
-        const claimedAt = input.claimedAt ?? nowIso();
-        const next = {
-            ...current,
-            sessionId: input.sessionId,
-            claimedBy: input.workerId,
-            claimedAt,
-            leaseExpiresAt: input.leaseExpiresAt,
-            attemptCount: current.attemptCount + 1,
-        };
-        await writeJson(this.requestQueuePath(input.requestId), next);
-        await writeJson(this.requestControlPath(input.requestId), {
-            ...(await this.getRequestControl(input.requestId) ?? {
-                requestId: input.requestId,
-                cancelRequested: false,
-                cancelReason: null,
-                cancelRequestedAt: null,
-                heartbeatAt: null,
-                workerId: null,
-                workerStartedAt: null,
-            }),
-            heartbeatAt: claimedAt,
-            workerId: input.workerId,
-            workerStartedAt: claimedAt,
-        });
-        return next;
-    }
-    async renewRequestLease(input) {
-        const current = await this.getQueuedRequest(input.requestId);
-        if (current) {
-            await writeJson(this.requestQueuePath(input.requestId), {
-                ...current,
-                claimedBy: input.workerId,
-                claimedAt: current.claimedAt ?? input.heartbeatAt ?? nowIso(),
-                leaseExpiresAt: input.leaseExpiresAt,
-            });
-        }
-        await writeJson(this.requestControlPath(input.requestId), {
-            ...(await this.getRequestControl(input.requestId) ?? {
-                requestId: input.requestId,
-                cancelRequested: false,
-                cancelReason: null,
-                cancelRequestedAt: null,
-                heartbeatAt: null,
-                workerId: null,
-                workerStartedAt: null,
-            }),
-            heartbeatAt: input.heartbeatAt ?? nowIso(),
-            workerId: input.workerId,
-            workerStartedAt: (await this.getRequestControl(input.requestId))?.workerStartedAt ?? input.heartbeatAt ?? nowIso(),
-        });
-    }
-    async releaseRequestClaim(requestId) {
-        await rm(this.requestQueuePath(requestId), { force: true });
-        const current = await this.getRequestControl(requestId);
-        if (!current) {
-            return;
-        }
-        await writeJson(this.requestControlPath(requestId), {
-            ...current,
-            heartbeatAt: null,
-            workerId: null,
-            workerStartedAt: null,
-        });
-    }
-    async listExpiredClaimedRequests(cutoffIso) {
-        const queueDir = path.join(this.artifactsRoot(), "indexes", "requests-queue");
-        if (!(await fileExists(queueDir))) {
-            return [];
-        }
-        const entries = (await readdir(queueDir)).sort();
-        const records = await Promise.all(entries.map((entry) => readJson(path.join(queueDir, entry))));
-        return records.filter((record) => record.claimedBy && record.leaseExpiresAt && record.leaseExpiresAt <= cutoffIso);
-    }
-    async getRequestControl(requestId) {
-        const filePath = this.requestControlPath(requestId);
-        if (!(await fileExists(filePath))) {
-            return null;
-        }
-        return readJson(filePath);
-    }
-    async requestRequestCancel(requestId, reason) {
-        const current = await this.getRequestControl(requestId);
-        if (!current) {
-            throw new Error(`Missing request control for ${requestId}`);
-        }
-        const updated = {
-            ...current,
-            cancelRequested: true,
-            cancelReason: reason ?? null,
-            cancelRequestedAt: nowIso(),
-        };
-        await writeJson(this.requestControlPath(requestId), updated);
-        return updated;
-    }
-    async clearRequestCancel(requestId) {
-        const current = await this.getRequestControl(requestId);
-        if (!current) {
-            return;
-        }
-        await writeJson(this.requestControlPath(requestId), {
-            ...current,
-            cancelRequested: false,
-            cancelReason: null,
-            cancelRequestedAt: null,
-        });
-    }
-}
+import r from"node:path";import{appendFile as y,readFile as R,readdir as I,rm as d,writeFile as p}from"node:fs/promises";import{ensureDir as A,fileExists as l,readJson as o,writeJson as u}from"../utils/fs.js";import{resolveRuntimeArtifactsRoot as P}from"../runtime/layout/runtime-layout.js";function q(){return new Date(Date.now()).toISOString()}class C{runtimeRoot;constructor(e){this.runtimeRoot=e}artifactsRoot(){return P(this.runtimeRoot)}sessionIndexPath(e){return r.join(this.artifactsRoot(),"indexes","sessions",`${e}.json`)}requestIndexPath(e){return r.join(this.artifactsRoot(),"indexes","requests",`${e}.json`)}approvalIndexPath(e){return r.join(this.artifactsRoot(),"indexes","approvals",`${e}.json`)}requestQueuePath(e){return r.join(this.artifactsRoot(),"indexes","requests-queue",`${e}.json`)}requestControlPath(e){return r.join(this.artifactsRoot(),"indexes","requests-control",`${e}.json`)}traceItemsPath(e,t){return r.join(this.requestDir(e,t),"trace-items.ndjson")}requestPlanStatePath(e,t){return r.join(this.requestDir(e,t),"plan-state.json")}async writeSessionHead(e,t){const s=r.join(this.sessionDir(e),"meta.json"),a=await o(s);await Promise.all([u(s,{...a,status:t.status,latestRequestId:t.latestRequestId,updatedAt:t.updatedAt}),u(this.sessionIndexPath(e),{sessionId:e,status:t.status,latestRequestId:t.latestRequestId,updatedAt:t.updatedAt})])}async initialize(){await Promise.all(["indexes/sessions","indexes/requests","indexes/approvals","indexes/requests-queue","indexes/requests-control","sessions"].map(e=>A(r.join(this.artifactsRoot(),e))))}sessionDir(e){return r.join(this.artifactsRoot(),"sessions",e)}requestDir(e,t){return r.join(this.sessionDir(e),"requests",t)}async createSession(e){const t={sessionId:e.sessionId,workspaceId:"default",entryAgentId:e.agentId,createdAt:e.createdAt,updatedAt:e.createdAt,status:e.status,latestRequestId:e.requestId};await u(r.join(this.sessionDir(e.sessionId),"meta.json"),t),await u(r.join(this.sessionDir(e.sessionId),"messages.json"),{sessionId:e.sessionId,items:[]}),await u(this.sessionIndexPath(e.sessionId),{sessionId:e.sessionId,status:e.status,latestRequestId:e.requestId,updatedAt:e.createdAt})}async createRequest(e){const t=this.requestDir(e.sessionId,e.requestId);await A(r.join(t,"events")),await A(r.join(t,"approvals"));const s=await this.getSessionMeta(e.sessionId),a=s?.latestRequestId===e.requestId?null:s?.latestRequestId??null,n={requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,parentRequestId:a,executionMode:e.executionMode,adapterKind:e.adapterKind??e.executionMode,createdAt:e.createdAt,updatedAt:e.createdAt},i={state:"running",previousState:null,stateEnteredAt:e.createdAt,lastTransitionAt:e.createdAt,resumable:!1,checkpointRef:null},c={startedAt:e.startedAt??e.createdAt,endedAt:null,lastActivityAt:e.createdAt,currentAgentId:e.currentAgentId??e.agentId,delegationChain:e.delegationChain??[e.currentAgentId??e.agentId],runtimeSnapshot:e.runtimeSnapshot??null,traceItems:[]};await Promise.all([u(r.join(t,"meta.json"),n),u(r.join(t,"lifecycle.json"),i),u(r.join(t,"inspection.json"),c),p(this.traceItemsPath(e.sessionId,e.requestId),"","utf8"),u(r.join(t,"checkpoint-ref.json"),{sessionId:e.sessionId,requestId:e.requestId,checkpointRef:null,savedAt:e.createdAt,kind:"langgraph-checkpoint"}),u(r.join(t,"artifacts.json"),{sessionId:e.sessionId,requestId:e.requestId,items:[]}),u(r.join(t,"error.json"),{hasError:!1,lastError:null}),u(this.requestIndexPath(e.requestId),{requestId:e.requestId,sessionId:e.sessionId,state:"running",resumable:!1,updatedAt:e.createdAt}),u(this.requestControlPath(e.requestId),{requestId:e.requestId,cancelRequested:!1,cancelReason:null,cancelRequestedAt:null,heartbeatAt:null,workerId:null,workerStartedAt:null})]),await this.writeSessionHead(e.sessionId,{latestRequestId:e.requestId,status:"running",updatedAt:e.createdAt})}async setRequestState(e,t,s,a){const n=r.join(this.requestDir(e,t),"lifecycle.json"),i=r.join(this.requestDir(e,t),"meta.json"),c=r.join(this.requestDir(e,t),"inspection.json"),[m,f,w]=await Promise.all([o(n),o(i),o(c)]),h=q(),j={state:s,previousState:m.state,stateEnteredAt:h,lastTransitionAt:h,resumable:s==="waiting_for_approval",checkpointRef:a??m.checkpointRef};await Promise.all([u(n,j),u(i,{...f,updatedAt:h}),u(c,{...w,endedAt:s==="completed"||s==="failed"||s==="cancelled"?h:w.endedAt,lastActivityAt:h})]),a!==void 0&&await u(r.join(this.requestDir(e,t),"checkpoint-ref.json"),{sessionId:e,requestId:t,checkpointRef:a,savedAt:h,kind:"langgraph-checkpoint"}),await u(this.requestIndexPath(t),{requestId:t,sessionId:e,state:s,resumable:j.resumable,updatedAt:h}),await this.writeSessionHead(e,{latestRequestId:t,status:s,updatedAt:h})}async appendEvent(e){const t=String(e.sequence).padStart(6,"0"),s=r.join(this.requestDir(e.sessionId,e.requestId),"inspection.json"),a=await o(s);await Promise.all([u(r.join(this.requestDir(e.sessionId,e.requestId),"events",`${t}.json`),e),u(s,{...a,lastActivityAt:e.timestamp})])}async listSessions(e={}){const t=r.join(this.artifactsRoot(),"indexes","sessions");if(!await l(t))return[];const s=await I(t);return(await Promise.all(s.map(async n=>{const i=await o(r.join(t,n)),[c,m]=await Promise.all([o(r.join(this.sessionDir(i.sessionId),"meta.json")),o(r.join(this.requestDir(i.sessionId,i.latestRequestId),"inspection.json")).catch(()=>null)]);return{agentId:c.entryAgentId,sessionId:i.sessionId,latestRequestId:i.latestRequestId,createdAt:c.createdAt,updatedAt:i.updatedAt,status:i.status,currentAgentId:m?.currentAgentId??void 0}}))).filter(n=>!e.agentId||n.agentId===e.agentId).sort((n,i)=>i.updatedAt.localeCompare(n.updatedAt))}async listSessionSummaries(e={}){const t=await this.listSessions(e);return(await Promise.all(t.map(async a=>{const[n,i]=await Promise.all([o(r.join(this.sessionDir(a.sessionId),"meta.json")),o(r.join(this.sessionDir(a.sessionId),"messages.json")).catch(()=>({sessionId:a.sessionId,items:[]}))]),c=i.items;return{...a,entryAgentId:n.entryAgentId,messageCount:c.length,firstMessage:c[0],lastMessage:c.at(-1)}}))).sort((a,n)=>n.updatedAt.localeCompare(a.updatedAt))}async listRequestIndexes(){const e=r.join(this.artifactsRoot(),"indexes","requests");if(!await l(e))return[];const t=(await I(e)).sort();return Promise.all(t.map(s=>o(r.join(e,s))))}async readRequestSummary(e,t){const s=this.requestDir(e,t),[a,n,i]=await Promise.all([o(r.join(s,"meta.json")),o(r.join(s,"lifecycle.json")),o(r.join(s,"inspection.json"))]);return{requestId:a.requestId,sessionId:a.sessionId,agentId:a.agentId,...a.parentRequestId?{parentRequestId:a.parentRequestId}:{},executionMode:a.executionMode,adapterKind:a.adapterKind??a.executionMode,createdAt:a.createdAt,updatedAt:a.updatedAt,state:n.state,checkpointRef:n.checkpointRef,resumable:n.resumable,startedAt:i.startedAt,...i.endedAt?{endedAt:i.endedAt}:{},lastActivityAt:i.lastActivityAt,...i.currentAgentId?{currentAgentId:i.currentAgentId}:{},delegationChain:i.delegationChain,...i.runtimeSnapshot?{runtimeSnapshot:i.runtimeSnapshot}:{}}}async listRequests(e={}){const t=await this.listRequestIndexes();return(await Promise.all(t.map(a=>this.readRequestSummary(a.sessionId,a.requestId)))).filter(a=>!(e.agentId&&a.agentId!==e.agentId||e.sessionId&&a.sessionId!==e.sessionId||e.state&&a.state!==e.state)).sort((a,n)=>n.updatedAt.localeCompare(a.updatedAt))}async getRequest(e){const t=this.requestIndexPath(e);if(!await l(t))return null;const s=await o(t);return this.readRequestSummary(s.sessionId,s.requestId)}async getSession(e){const t=this.sessionIndexPath(e);if(!await l(t))return null;const[s,a]=await Promise.all([o(t),o(r.join(this.sessionDir(e),"meta.json"))]),n=await o(r.join(this.requestDir(e,s.latestRequestId),"inspection.json")).catch(()=>null);return{agentId:a.entryAgentId,sessionId:e,latestRequestId:s.latestRequestId,createdAt:a.createdAt,updatedAt:s.updatedAt,status:s.status,currentAgentId:n?.currentAgentId??void 0}}async getSessionMeta(e){const t=r.join(this.sessionDir(e),"meta.json");return await l(t)?o(t):null}async listSessionRequests(e){const t=r.join(this.sessionDir(e),"requests");if(!await l(t))return[];const s=(await I(t)).sort();return(await Promise.all(s.map(async n=>this.readRequestSummary(e,n)))).sort((n,i)=>i.createdAt.localeCompare(n.createdAt))}async listRequestEvents(e,t){const s=r.join(this.requestDir(e,t),"events");if(!await l(s))return[];const a=(await I(s)).filter(n=>n.endsWith(".json")).sort((n,i)=>n.localeCompare(i));return Promise.all(a.map(n=>o(r.join(s,n))))}async listApprovals(e={}){const t=r.join(this.artifactsRoot(),"indexes","approvals");if(!await l(t))return[];const s=(await I(t)).sort();return(await Promise.all(s.map(n=>o(r.join(t,n))))).filter(n=>!(e.status&&n.status!==e.status||e.sessionId&&n.sessionId!==e.sessionId||e.requestId&&n.requestId!==e.requestId))}async getApproval(e){const t=this.approvalIndexPath(e);return await l(t)?o(t):null}async getRequestApprovals(e,t){const s=r.join(this.requestDir(e,t),"approvals");if(!await l(s))return[];const a=(await I(s)).sort();return Promise.all(a.map(n=>o(r.join(s,n))))}async getRequestMeta(e,t){return o(r.join(this.requestDir(e,t),"meta.json"))}async getRequestLifecycle(e,t){return o(r.join(this.requestDir(e,t),"lifecycle.json"))}async getRequestInspection(e,t){const s=await o(r.join(this.requestDir(e,t),"inspection.json")),a=await this.listRequestTraceItems(e,t);return{...s,traceItems:a}}async updateRequestInspection(e,t,s){const a=r.join(this.requestDir(e,t),"inspection.json"),n=await o(a),i=Array.isArray(n.traceItems)?n.traceItems:Array.isArray(n.upstreamEvents)?n.upstreamEvents:[];await u(a,{...n,...s.endedAt!==void 0?{endedAt:s.endedAt}:{},...s.lastActivityAt?{lastActivityAt:s.lastActivityAt}:{},...s.currentAgentId!==void 0?{currentAgentId:s.currentAgentId}:{},...s.delegationChain?{delegationChain:s.delegationChain}:{},...s.runtimeSnapshot!==void 0?{runtimeSnapshot:s.runtimeSnapshot}:{},traceItems:i})}async appendRequestTraceItem(e,t,s){await y(this.traceItemsPath(e,t),`${JSON.stringify(s)}
+`,"utf8")}async listRequestTraceItems(e,t){const s=this.traceItemsPath(e,t);if(await l(s)){const i=(await R(s,"utf8")).split(`
+`).map(c=>c.trim()).filter(c=>c.length>0).map(c=>JSON.parse(c));if(i.length>0)return i}const a=await o(r.join(this.requestDir(e,t),"inspection.json"));return Array.isArray(a.traceItems)?a.traceItems:Array.isArray(a.upstreamEvents)?a.upstreamEvents:[]}async deleteSession(e){const t=this.sessionDir(e),s=this.sessionIndexPath(e);if(!await l(t)&&!await l(s))return!1;const[a,n]=await Promise.all([this.listRequestIndexes(),this.listApprovals()]);return await Promise.all([...a.filter(i=>i.sessionId===e).map(i=>d(this.requestIndexPath(i.requestId),{force:!0})),...n.filter(i=>i.sessionId===e).map(i=>d(this.approvalIndexPath(i.approvalId),{force:!0})),...a.filter(i=>i.sessionId===e).flatMap(i=>[d(this.requestQueuePath(i.requestId),{force:!0}),d(this.requestControlPath(i.requestId),{force:!0})]),d(s,{force:!0}),d(t,{recursive:!0,force:!0})]),!0}async saveRequestInput(e,t,s){await u(r.join(this.requestDir(e,t),"request.json"),s)}async getRequestInput(e,t){const s=r.join(this.requestDir(e,t),"request.json");return await l(s)?o(s):null}async clearRequestInput(e,t){const s=r.join(this.requestDir(e,t),"request.json");await l(s)&&await d(s,{force:!0})}async createApproval(e){const t=e.sessionId,s=e.requestId,a={...e,sessionId:t,requestId:s};await Promise.all([u(r.join(this.requestDir(t,s),"approvals",`${e.approvalId}.json`),a),u(this.approvalIndexPath(e.approvalId),a)])}async resolveApproval(e,t,s,a){const n=r.join(this.requestDir(e,t),"approvals",`${s}.json`),c={...await o(n),status:a,resolvedAt:q()};return await Promise.all([u(n,c),u(this.approvalIndexPath(s),c)]),c}async saveRequestPlanState(e,t,s){await u(this.requestPlanStatePath(e,t),s)}async getRequestPlanState(e,t){const s=this.requestPlanStatePath(e,t);return await l(s)?o(s):null}async clearRequestPlanState(e,t){await d(this.requestPlanStatePath(e,t),{force:!0})}async createRequestArtifact(e,t,s,a){const n=this.requestDir(e,t);await u(r.join(n,s.path),a);const i=r.join(n,"artifacts.json"),c=await o(i);return c.items.push(s),await u(i,c),s}async listRequestArtifacts(e,t){return o(r.join(this.requestDir(e,t),"artifacts.json"))}async readRequestArtifact(e,t,s){const a=r.join(this.requestDir(e,t),s);return await l(a)?o(a):null}async appendSessionMessage(e,t){const s=r.join(this.sessionDir(e),"messages.json"),a=await l(s)?await o(s):{sessionId:e,items:[]};a.items.push(t),await u(s,{sessionId:a.sessionId??e,items:a.items})}async listSessionMessages(e,t=12){const s=r.join(this.sessionDir(e),"messages.json");return await l(s)?(await o(s)).items.slice(-t):[]}async saveRequestRecoveryIntent(e,t,s){await u(r.join(this.requestDir(e,t),"recovery-intent.json"),s)}async getRequestRecoveryIntent(e,t){const s=r.join(this.requestDir(e,t),"recovery-intent.json");return await l(s)?o(s):null}async clearRequestRecoveryIntent(e,t){const s=r.join(this.requestDir(e,t),"recovery-intent.json");await l(s)&&await d(s,{force:!0})}async enqueueRequest(e){const t=await this.getQueuedRequest(e.requestId)??{requestId:e.requestId,sessionId:e.sessionId,priority:e.priority??0,queueKey:e.queueKey??null,enqueuedAt:q(),availableAt:e.availableAt??q(),claimedBy:null,claimedAt:null,leaseExpiresAt:null,attemptCount:0,lastError:null};await u(this.requestQueuePath(e.requestId),{...t,sessionId:e.sessionId,priority:e.priority??t.priority,queueKey:e.queueKey??t.queueKey,availableAt:e.availableAt??t.availableAt,claimedBy:null,claimedAt:null,leaseExpiresAt:null,lastError:null})}async getQueuedRequest(e){const t=this.requestQueuePath(e);return await l(t)?o(t):null}async claimQueuedRequest(e){const t=await this.getQueuedRequest(e.requestId);if(!t)throw new Error(`Missing queued request ${e.requestId}`);const s=e.claimedAt??q(),a={...t,sessionId:e.sessionId,claimedBy:e.workerId,claimedAt:s,leaseExpiresAt:e.leaseExpiresAt,attemptCount:t.attemptCount+1};return await u(this.requestQueuePath(e.requestId),a),await u(this.requestControlPath(e.requestId),{...await this.getRequestControl(e.requestId)??{requestId:e.requestId,cancelRequested:!1,cancelReason:null,cancelRequestedAt:null,heartbeatAt:null,workerId:null,workerStartedAt:null},heartbeatAt:s,workerId:e.workerId,workerStartedAt:s}),a}async renewRequestLease(e){const t=await this.getQueuedRequest(e.requestId);t&&await u(this.requestQueuePath(e.requestId),{...t,claimedBy:e.workerId,claimedAt:t.claimedAt??e.heartbeatAt??q(),leaseExpiresAt:e.leaseExpiresAt}),await u(this.requestControlPath(e.requestId),{...await this.getRequestControl(e.requestId)??{requestId:e.requestId,cancelRequested:!1,cancelReason:null,cancelRequestedAt:null,heartbeatAt:null,workerId:null,workerStartedAt:null},heartbeatAt:e.heartbeatAt??q(),workerId:e.workerId,workerStartedAt:(await this.getRequestControl(e.requestId))?.workerStartedAt??e.heartbeatAt??q()})}async releaseRequestClaim(e){await d(this.requestQueuePath(e),{force:!0});const t=await this.getRequestControl(e);t&&await u(this.requestControlPath(e),{...t,heartbeatAt:null,workerId:null,workerStartedAt:null})}async listExpiredClaimedRequests(e){const t=r.join(this.artifactsRoot(),"indexes","requests-queue");if(!await l(t))return[];const s=(await I(t)).sort();return(await Promise.all(s.map(n=>o(r.join(t,n))))).filter(n=>n.claimedBy&&n.leaseExpiresAt&&n.leaseExpiresAt<=e)}async getRequestControl(e){const t=this.requestControlPath(e);return await l(t)?o(t):null}async requestRequestCancel(e,t){const s=await this.getRequestControl(e);if(!s)throw new Error(`Missing request control for ${e}`);const a={...s,cancelRequested:!0,cancelReason:t??null,cancelRequestedAt:q()};return await u(this.requestControlPath(e),a),a}async clearRequestCancel(e){const t=await this.getRequestControl(e);t&&await u(this.requestControlPath(e),{...t,cancelRequested:!1,cancelReason:null,cancelRequestedAt:null})}}export{C as FilePersistence};