@mono-agent/agent-app 0.11.2 → 0.11.4

package/dist/continuation-http-routes.js

@@ -0,0 +1,265 @@
+import { createHmac, randomUUID } from "node:crypto";
+import { ContinuationOperatorApi } from "./continuation-operator-api.js";
+import { ContinuationProtocolError } from "./continuation-service-errors.js";
+import { asObject, authorizeRecordToken, expire, operatorContinuationPage, parseClaim, readJson, requireBearer, requireHeader, requireRecord, requiredStringField, safeReason, sendJson, statusOfRequired, } from "./continuation-service-helpers.js";
+import { MAX_CLAIM_BODY_BYTES, } from "./continuation-service-types.js";
+import { TERMINAL_CONTINUATION_STATES, canonicalContinuationJson, continuationDigest, continuationTokenMatches, } from "./continuations.js";
+export class ContinuationHttpRoutes extends ContinuationOperatorApi {
+    async handleRequest(request, response) {
+        response.setHeader("cache-control", "no-store");
+        response.setHeader("x-content-type-options", "nosniff");
+        if (this.stopped) {
+            throw new ContinuationProtocolError(503, "service_stopping", "Continuation service is stopping.");
+        }
+        const url = new URL(request.url ?? "/", this.baseUrl);
+        if (request.method === "POST" && url.pathname === "/v1/continuations/claim") {
+            const token = requireBearer(request);
+            const binding = this.claimBindings.get(token);
+            if (binding === undefined) {
+                throw new ContinuationProtocolError(401, "invalid_claim_capability", "Invalid or expired claim capability.");
+            }
+            const body = await readJson(request, MAX_CLAIM_BODY_BYTES);
+            const finishClaim = this.beginClaim(binding);
+            try {
+                sendJson(response, 200, await this.claim(binding, body));
+            }
+            finally {
+                finishClaim();
+            }
+            return;
+        }
+        if (request.method === "POST" && url.pathname === "/v1/continuations/detached/claim") {
+            const serviceName = requireHeader(request, "x-mono-agent-service-name");
+            this.authorizeDetached(serviceName, requireBearer(request));
+            const body = await readJson(request, MAX_CLAIM_BODY_BYTES);
+            sendJson(response, 200, await this.claimDetached(serviceName, body));
+            return;
+        }
+        const resultMatch = /^\/v1\/continuations\/([^/]+)\/result$/u.exec(url.pathname);
+        if ((request.method === "PUT" || request.method === "POST") && resultMatch?.[1] !== undefined) {
+            const body = await readJson(request, this.maxResultBytes);
+            sendJson(response, 202, await this.acceptResult(resultMatch[1], requireBearer(request), body));
+            return;
+        }
+        const statusMatch = /^\/v1\/continuations\/([^/]+)\/status$/u.exec(url.pathname);
+        if (request.method === "GET" && statusMatch?.[1] !== undefined) {
+            const record = await this.authorizedRecord(statusMatch[1], requireBearer(request));
+            sendJson(response, 200, statusOfRequired(record));
+            return;
+        }
+        if (url.pathname === "/v1/operator/continuations") {
+            this.authorizeOperator(request);
+            if (request.method !== "GET") {
+                throw new ContinuationProtocolError(405, "method_not_allowed", "Method not allowed.");
+            }
+            sendJson(response, 200, operatorContinuationPage(await this.store.list(), url, this.limits.operatorPageSize));
+            return;
+        }
+        if (url.pathname === "/v1/operator/health") {
+            this.authorizeOperator(request);
+            if (request.method !== "GET") {
+                throw new ContinuationProtocolError(405, "method_not_allowed", "Method not allowed.");
+            }
+            sendJson(response, 200, await this.health());
+            return;
+        }
+        const operatorMatch = /^\/v1\/operator\/continuations\/([^/]+)\/(retry|cancel|resolve)$/u.exec(url.pathname);
+        if (request.method === "POST" && operatorMatch?.[1] !== undefined && operatorMatch[2] !== undefined) {
+            this.authorizeOperator(request);
+            const body = await readJson(request, MAX_CLAIM_BODY_BYTES);
+            if (operatorMatch[2] === "retry") {
+                sendJson(response, 200, await this.retry(operatorMatch[1], {
+                    allowUnknown: asObject(body).allowUnknown === true,
+                }));
+            }
+            else if (operatorMatch[2] === "cancel") {
+                sendJson(response, 200, await this.cancel(operatorMatch[1]));
+            }
+            else {
+                const value = asObject(body);
+                const kind = value.kind;
+                if (kind !== "delivered" && kind !== "not_delivered" && kind !== "dead_lettered") {
+                    throw new ContinuationProtocolError(400, "invalid_resolution", "Resolution kind is invalid.");
+                }
+                sendJson(response, 200, await this.resolveUnknown(operatorMatch[1], {
+                    kind,
+                    ...(kind === "delivered" && typeof value.deliveryId === "string"
+                        ? { deliveryId: value.deliveryId }
+                        : {}),
+                }));
+            }
+            return;
+        }
+        throw new ContinuationProtocolError(404, "not_found", "Continuation endpoint not found.");
+    }
+    async claim(binding, body) {
+        const claim = parseClaim(body, this.now(), this.maxDeadlineMs);
+        return await this.claimBound(binding, claim);
+    }
+    async claimDetached(serviceName, body) {
+        const object = asObject(body);
+        const routeName = requiredStringField(object, "route");
+        const route = this.namedRoutes[routeName];
+        if (route === undefined) {
+            throw new ContinuationProtocolError(403, "unknown_named_route", "Detached claim route is not configured.");
+        }
+        const claim = parseClaim(body, this.now(), this.maxDeadlineMs);
+        const originConversationId = route.conversationId ?? `continuation-route:${routeName}`;
+        const fingerprint = continuationDigest([
+            "v1-detached",
+            serviceName,
+            routeName,
+            route.mode,
+            route.conversationId ?? "",
+        ].join("\0"));
+        return await this.claimBound({
+            serverName: `detached:${serviceName}`,
+            originRunId: `detached:${serviceName}:${claim.taskKey}`,
+            originConversationId,
+            ...(route.conversationId === undefined ? {} : { replyToConversationId: route.conversationId }),
+            mode: route.mode,
+            fingerprint,
+            closed: false,
+            settled: true,
+            inFlightOperations: 0,
+        }, claim, routeName);
+    }
+    async claimBound(binding, claim, routeName) {
+        let created = false;
+        const record = await this.store.mutate((records) => {
+            const existing = [...records.values()].find((candidate) => candidate.serverName === binding.serverName
+                && candidate.originRunId === binding.originRunId
+                && candidate.taskKey === claim.taskKey);
+            if (existing !== undefined) {
+                if (existing.taskHash !== claim.taskHash
+                    || existing.claimFingerprint !== binding.fingerprint
+                    || existing.deadline !== claim.deadline) {
+                    throw new ContinuationProtocolError(409, "claim_conflict", "taskKey was already claimed with different immutable inputs.");
+                }
+                return structuredClone(existing);
+            }
+            const active = [...records.values()].filter((candidate) => !TERMINAL_CONTINUATION_STATES.has(candidate.state));
+            if (active.length >= this.limits.maxActiveRecords) {
+                throw new ContinuationProtocolError(429, "active_continuation_limit", `The service already has its maximum ${String(this.limits.maxActiveRecords)} active continuations.`);
+            }
+            const activeForOrigin = active.filter((candidate) => candidate.claimFingerprint === binding.fingerprint).length;
+            if (activeForOrigin >= this.limits.maxActivePerOrigin) {
+                throw new ContinuationProtocolError(429, "active_origin_limit", `This claim origin already has its maximum ${String(this.limits.maxActivePerOrigin)} active continuations.`);
+            }
+            const now = this.now().toISOString();
+            const continuationId = randomUUID();
+            const token = this.deriveResultToken(continuationId, claim.taskHash);
+            const next = {
+                continuationId,
+                serverName: binding.serverName,
+                originRunId: binding.originRunId,
+                originConversationId: binding.originConversationId,
+                ...(binding.replyToConversationId === undefined
+                    ? {}
+                    : { replyToConversationId: binding.replyToConversationId }),
+                ...(binding.historyBoundary === undefined ? {} : { historyBoundary: binding.historyBoundary }),
+                originContextState: binding.historyBoundary === undefined ? "detached_latest" : "pending",
+                mode: binding.mode,
+                ...(routeName === undefined ? {} : { routeName }),
+                taskKey: claim.taskKey,
+                taskHash: claim.taskHash,
+                claimFingerprint: binding.fingerprint,
+                resultTokenHash: continuationDigest(token),
+                createdAt: now,
+                updatedAt: now,
+                deadline: claim.deadline,
+                state: "claimed",
+                synthesisAttempts: 0,
+                synthesisDeferrals: 0,
+                deliveryAttempts: 0,
+            };
+            records.set(continuationId, next);
+            created = true;
+            return structuredClone(next);
+        });
+        const token = this.deriveResultToken(record.continuationId, record.taskHash);
+        return {
+            continuationId: record.continuationId,
+            resultUrl: `${this.baseUrl}/v1/continuations/${encodeURIComponent(record.continuationId)}/result`,
+            statusUrl: `${this.baseUrl}/v1/continuations/${encodeURIComponent(record.continuationId)}/status`,
+            token,
+            expiresAt: record.deadline,
+            fingerprint: record.claimFingerprint,
+            ...(created ? {} : { replayed: true }),
+        };
+    }
+    async acceptResult(id, token, body) {
+        const object = asObject(body);
+        const idempotencyKey = requiredStringField(object, "idempotencyKey", 256);
+        if (!("payload" in object)) {
+            throw new ContinuationProtocolError(400, "missing_payload", "Result payload is required.");
+        }
+        const serialized = canonicalContinuationJson(object.payload);
+        const payloadHash = continuationDigest(serialized);
+        const providedHash = typeof object.payloadHash === "string" ? object.payloadHash : undefined;
+        if (providedHash !== undefined && providedHash !== payloadHash) {
+            throw new ContinuationProtocolError(400, "payload_hash_mismatch", "Result payload hash does not match the payload.");
+        }
+        const now = this.now();
+        const record = await this.store.mutate((records) => {
+            const current = requireRecord(records, id);
+            authorizeRecordToken(current, token);
+            if (current.resultIdempotencyKey !== undefined) {
+                if (current.resultIdempotencyKey !== idempotencyKey || current.resultPayloadHash !== payloadHash) {
+                    throw new ContinuationProtocolError(409, "result_conflict", "Continuation already has a different immutable result.");
+                }
+                return structuredClone(current);
+            }
+            if (current.state !== "claimed") {
+                throw new ContinuationProtocolError(409, "result_not_accepted", `Continuation is ${current.state}.`);
+            }
+            if (Date.parse(current.deadline) <= now.getTime()) {
+                expire(current, now.toISOString());
+                throw new ContinuationProtocolError(410, "continuation_expired", "Continuation deadline has passed.");
+            }
+            current.resultIdempotencyKey = idempotencyKey;
+            current.resultPayloadHash = payloadHash;
+            current.resultPayload = structuredClone(object.payload);
+            current.state = "result_received";
+            current.updatedAt = now.toISOString();
+            return structuredClone(current);
+        });
+        if (this.autoProcess)
+            void this.processDue().catch(() => undefined);
+        return { continuationId: id, state: record.state, accepted: true };
+    }
+    async authorizedRecord(id, token) {
+        const record = await this.store.get(id);
+        if (record === undefined) {
+            throw new ContinuationProtocolError(404, "not_found", "Continuation not found.");
+        }
+        authorizeRecordToken(record, token);
+        return record;
+    }
+    authorizeDetached(serviceName, token) {
+        const expected = this.detachedServiceTokenHashes.get(serviceName);
+        if (expected === undefined || !continuationTokenMatches(token, expected)) {
+            throw new ContinuationProtocolError(401, "invalid_service_capability", "Invalid detached-service capability.");
+        }
+    }
+    authorizeOperator(request) {
+        if (!continuationTokenMatches(requireBearer(request), continuationDigest(this.operatorToken))) {
+            throw new ContinuationProtocolError(401, "invalid_operator_capability", "Invalid operator capability.");
+        }
+    }
+    deriveResultToken(id, taskHash) {
+        return createHmac("sha256", this.secret).update(`continuation-result\0${id}\0${taskHash}`).digest("base64url");
+    }
+    handleRequestError(response, error) {
+        if (response.headersSent || response.writableEnded)
+            return;
+        const protocol = error instanceof ContinuationProtocolError
+            ? error
+            : new ContinuationProtocolError(500, "internal_error", "Continuation request failed.");
+        if (!(error instanceof ContinuationProtocolError)) {
+            this.logger?.error?.("Continuation request failed.", { reason: safeReason(error) });
+        }
+        sendJson(response, protocol.status, { error: { code: protocol.code, message: protocol.message } });
+    }
+}
+//# sourceMappingURL=continuation-http-routes.js.map

package/dist/continuation-http-routes.js.map

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

package/dist/continuation-operator-api.d.ts

@@ -0,0 +1,18 @@
+import { ContinuationDispatchWorker } from "./continuation-dispatch-worker.js";
+import { type ContinuationHealthSnapshot, type ContinuationStatusSnapshot } from "./continuations.js";
+export declare abstract class ContinuationOperatorApi extends ContinuationDispatchWorker {
+    protected retry(id: string, options?: {
+        readonly allowUnknown?: boolean;
+    }): Promise<ContinuationStatusSnapshot>;
+    protected cancel(id: string): Promise<ContinuationStatusSnapshot>;
+    protected resolveUnknown(id: string, outcome: {
+        readonly kind: "delivered";
+        readonly deliveryId?: string;
+    } | {
+        readonly kind: "not_delivered";
+    } | {
+        readonly kind: "dead_lettered";
+    }): Promise<ContinuationStatusSnapshot>;
+    protected health(): Promise<ContinuationHealthSnapshot>;
+}
+//# sourceMappingURL=continuation-operator-api.d.ts.map

package/dist/continuation-operator-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-operator-api.d.ts","sourceRoot":"","sources":["../src/continuation-operator-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAa/E,OAAO,EAGL,KAAK,0BAA0B,EAE/B,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAE5B,8BAAsB,uBAAwB,SAAQ,0BAA0B;cAC9D,KAAK,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5C,OAAO,CAAC,0BAA0B,CAAC;cA4BtB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;cAuBvD,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE;QAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,GAClC;QAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,GACrC,OAAO,CAAC,0BAA0B,CAAC;cAwFtB,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC;CAmC9D"}

package/dist/continuation-operator-api.js

@@ -0,0 +1,164 @@
+import { ContinuationDispatchWorker } from "./continuation-dispatch-worker.js";
+import { ContinuationOperationTimeoutError, ContinuationProtocolError, ContinuationServiceStoppingError, } from "./continuation-service-errors.js";
+import { boundedHistoryErrorCode, clearLease, errorRecord, requireRecord, statusOfRequired, } from "./continuation-service-helpers.js";
+import { CONTINUATION_STATES, TERMINAL_CONTINUATION_STATES, } from "./continuations.js";
+export class ContinuationOperatorApi extends ContinuationDispatchWorker {
+    async retry(id, options) {
+        const record = await this.store.mutate((records) => {
+            const current = requireRecord(records, id);
+            if (current.state === "delivery_unknown" && options?.allowUnknown !== true) {
+                throw new ContinuationProtocolError(409, "delivery_unknown", "Resolve the ambiguous delivery before retrying.");
+            }
+            if (current.state !== "delivery_retry" && current.state !== "dead_lettered" && current.state !== "delivery_unknown") {
+                throw new ContinuationProtocolError(409, "not_retryable", `Continuation state ${current.state} is not retryable.`);
+            }
+            if (current.synthesizedText === undefined && current.mode !== "silent") {
+                throw new ContinuationProtocolError(409, "synthesis_not_retryable", "Continuation synthesis has no persisted output and cannot be repeated.");
+            }
+            current.state = "ready_to_deliver";
+            current.nextAttemptAt = this.now().toISOString();
+            delete current.deliveryStartedAt;
+            delete current.lastError;
+            current.updatedAt = this.now().toISOString();
+            clearLease(current);
+            return structuredClone(current);
+        });
+        if (this.autoProcess)
+            void this.processDue().catch(() => undefined);
+        return statusOfRequired(record);
+    }
+    async cancel(id) {
+        const record = await this.store.mutate((records) => {
+            const current = requireRecord(records, id);
+            if (TERMINAL_CONTINUATION_STATES.has(current.state)) {
+                if (current.state === "cancelled")
+                    return structuredClone(current);
+                throw new ContinuationProtocolError(409, "already_terminal", `Continuation is already ${current.state}.`);
+            }
+            if (current.leaseOwner !== undefined || current.state === "synthesizing" || current.deliveryStartedAt !== undefined) {
+                throw new ContinuationProtocolError(409, "continuation_in_flight", "Continuation has an active synthesis or native delivery; cancellation cannot make that side effect disappear.");
+            }
+            current.state = "cancelled";
+            current.updatedAt = this.now().toISOString();
+            current.lastError = errorRecord("cancelled_by_operator", "Continuation cancelled by the operator.", current.updatedAt);
+            clearLease(current);
+            return structuredClone(current);
+        });
+        return statusOfRequired(record);
+    }
+    async resolveUnknown(id, outcome) {
+        if (this.resolvingUnknown.has(id)) {
+            throw new ContinuationProtocolError(409, "resolution_in_progress", "This ambiguous delivery is already being resolved.");
+        }
+        this.resolvingUnknown.add(id);
+        try {
+            const current = await this.store.get(id);
+            if (current === undefined)
+                throw new ContinuationProtocolError(404, "not_found", "Continuation not found.");
+            if (current.state !== "delivery_unknown") {
+                throw new ContinuationProtocolError(409, "not_delivery_unknown", "Only delivery_unknown continuations can be resolved.");
+            }
+            let history;
+            if (outcome.kind === "delivered") {
+                if (this.options.recordHistory === undefined
+                    || current.replyToConversationId === undefined
+                    || current.synthesizedText === undefined) {
+                    history = { recorded: false, code: "history_record_unavailable_after_ambiguous_delivery" };
+                }
+                else {
+                    try {
+                        history = await this.runBoundedOperation("delivery", this.limits.deliveryTimeoutMs, async () => await this.options.recordHistory?.({
+                            continuationId: current.continuationId,
+                            conversationId: current.replyToConversationId,
+                            text: current.synthesizedText,
+                            deliveryKey: `continuation:${current.continuationId}`,
+                        }) ?? { recorded: false, code: "history_record_unavailable_after_ambiguous_delivery" });
+                    }
+                    catch (error) {
+                        if (error instanceof ContinuationServiceStoppingError)
+                            throw error;
+                        history = {
+                            recorded: false,
+                            code: error instanceof ContinuationOperationTimeoutError
+                                ? "history_record_timeout_after_ambiguous_delivery"
+                                : "history_record_failed_after_ambiguous_delivery",
+                        };
+                    }
+                }
+            }
+            const record = await this.store.mutate((records) => {
+                const mutable = requireRecord(records, id);
+                if (mutable.state !== "delivery_unknown") {
+                    throw new ContinuationProtocolError(409, "not_delivery_unknown", "Only delivery_unknown continuations can be resolved.");
+                }
+                const at = this.now().toISOString();
+                mutable.updatedAt = at;
+                delete mutable.deliveryStartedAt;
+                if (outcome.kind === "delivered") {
+                    const recorded = history?.recorded === true;
+                    mutable.state = "delivered";
+                    mutable.receipt = {
+                        kind: "delivered",
+                        deliveredAt: at,
+                        ...(outcome.deliveryId === undefined ? {} : { deliveryId: outcome.deliveryId }),
+                        historyRecorded: recorded,
+                        ...(recorded ? {} : {
+                            historyErrorCode: boundedHistoryErrorCode(history?.recorded === false
+                                ? history.code
+                                : "history_record_unavailable_after_ambiguous_delivery"),
+                        }),
+                    };
+                    delete mutable.lastError;
+                }
+                else if (outcome.kind === "not_delivered") {
+                    mutable.state = "ready_to_deliver";
+                    mutable.nextAttemptAt = at;
+                    delete mutable.lastError;
+                }
+                else {
+                    mutable.state = "dead_lettered";
+                    mutable.lastError = errorRecord("operator_dead_lettered", "Ambiguous delivery was dead-lettered by the operator.", at);
+                }
+                return structuredClone(mutable);
+            });
+            if (outcome.kind === "not_delivered" && this.autoProcess)
+                void this.processDue().catch(() => undefined);
+            return statusOfRequired(record);
+        }
+        finally {
+            this.resolvingUnknown.delete(id);
+        }
+    }
+    async health() {
+        const [records, storage] = await Promise.all([this.store.list(), this.store.stats()]);
+        const counts = Object.fromEntries(CONTINUATION_STATES.map((state) => [state, 0]));
+        let oldestPendingAt;
+        let due = 0;
+        const now = this.now().getTime();
+        for (const record of records) {
+            counts[record.state] += 1;
+            if (!TERMINAL_CONTINUATION_STATES.has(record.state)) {
+                if (oldestPendingAt === undefined || record.createdAt < oldestPendingAt)
+                    oldestPendingAt = record.createdAt;
+                if (record.nextAttemptAt === undefined || Date.parse(record.nextAttemptAt) <= now)
+                    due += 1;
+            }
+        }
+        const pending = records.length - [...TERMINAL_CONTINUATION_STATES].reduce((sum, state) => sum + counts[state], 0);
+        const status = counts.delivery_unknown > 0 || counts.dead_lettered > 0
+            ? "unhealthy"
+            : pending > 0 || counts.expired > 0 || storage.historyDegraded > 0
+                ? "degraded"
+                : "healthy";
+        return {
+            status,
+            checkedAt: this.now().toISOString(),
+            counts,
+            pending,
+            due,
+            storage,
+            ...(oldestPendingAt === undefined ? {} : { oldestPendingAt }),
+        };
+    }
+}
+//# sourceMappingURL=continuation-operator-api.js.map

package/dist/continuation-operator-api.js.map

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

package/dist/continuation-origin-store.d.ts

@@ -0,0 +1,19 @@
+import { type ContinuationOriginContextGroupCommit, type ContinuationOriginContextReference, type DurableContinuationRecord } from "./continuation-store-types.js";
+export declare function prepareOriginContextGroupCommit(records: Map<string, DurableContinuationRecord>, input: {
+    readonly claimFingerprint: string;
+    readonly activatedAt: string;
+}): ContinuationOriginContextGroupCommit | undefined;
+export declare function applyOriginContextGroupCommit(records: Map<string, DurableContinuationRecord>, commit: ContinuationOriginContextGroupCommit): void;
+export declare function applyOriginContextGroupCommits(directory: string, records: Map<string, DurableContinuationRecord>): Promise<readonly string[]>;
+export declare function cleanOriginContextGroupTemporaries(directory: string): Promise<void>;
+export declare function loadOriginContextGroupCommit(path: string): Promise<ContinuationOriginContextGroupCommit>;
+export declare function removeOriginContextGroupCommits(directory: string, paths: readonly string[]): Promise<void>;
+export declare class OriginContextCorruptionError extends Error {
+}
+export declare function originContextDigest(canonical: string): string;
+export declare function readOriginContextCanonical(path: string, reference: ContinuationOriginContextReference): Promise<string>;
+export declare function referencedOriginContextDigests(records: Map<string, DurableContinuationRecord>): ReadonlySet<string>;
+export declare function releasePendingOriginPin(pins: Map<string, number>, digest: string): void;
+export declare function sweepOriginContextBlobs(directory: string, referenced: ReadonlySet<string>, pending: ReadonlySet<string>): Promise<void>;
+export declare function originContextStoreBytes(directory: string): Promise<number>;
+//# sourceMappingURL=continuation-origin-store.d.ts.map

package/dist/continuation-origin-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-origin-store.d.ts","sourceRoot":"","sources":["../src/continuation-origin-store.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,oCAAoC,EACzC,KAAK,kCAAkC,EACvC,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC/C,KAAK,EAAE;IAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzE,oCAAoC,GAAG,SAAS,CAiDlD;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC/C,MAAM,EAAE,oCAAoC,GAC3C,IAAI,CAgCN;AAUD,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAC9C,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA8B5B;AAED,wBAAsB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAY9G;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,qBAAa,4BAA6B,SAAQ,KAAK;CAAG;AAE1D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,kCAAkC,GAC5C,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAC9C,WAAW,CAAC,MAAM,CAAC,CAGrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKvF;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAehF"}