@mono-agent/agent-app 0.11.2 → 0.11.4

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

@@ -0,0 +1,173 @@
+import { type AgentContinuationOriginContext } from "@mono-agent/agent-contracts";
+import type { ContinuationDeliveryReceipt, ContinuationMode, ContinuationState } from "./continuations.js";
+export declare const CONTINUATION_STORE_SCHEMA_VERSION = 1;
+export declare const CONTINUATION_RECORD_STORE_SCHEMA_VERSION = 3;
+export declare const RECORDS_DIRECTORY = "records-v3";
+export declare const TRANSACTION_FILE = "continuation-transaction-v3.json";
+export declare const MANIFEST_FILE = "continuation-store-v3.json";
+export declare const LEGACY_RECORDS_DIRECTORY = "records-v2";
+export declare const LEGACY_TRANSACTION_FILE = "continuation-transaction-v2.json";
+export declare const V2_ROLLBACK_GUARD = "UPGRADED-TO-RECORDS-V3";
+export declare const ORIGIN_CONTEXT_GROUPS_DIRECTORY = "origin-context-groups-v1";
+export declare const OWNER_DATABASE_FILE = "continuations-owner.sqlite";
+export declare const ORIGIN_CONTEXTS_DIRECTORY = "origin-context-v1";
+export declare const MAX_RECORD_BYTES: number;
+export declare const MAX_TRANSACTION_BYTES: number;
+export declare const MAX_MANIFEST_BYTES: number;
+export declare const MAX_GENERATION_BYTES = 256;
+export declare const MAX_LEGACY_STORE_BYTES: number;
+export declare const DEFAULT_TERMINAL_MAX_RECORDS = 50000;
+export declare const DEFAULT_TERMINAL_MAX_AGE_MS: number;
+export declare const DEFAULT_CAPTURED_TEXT_MAX_RECORDS = 1000;
+export declare const DEFAULT_CAPTURED_TEXT_MAX_AGE_MS: number;
+export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_BYTES: number;
+export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGES = 64;
+export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGE_BYTES: number;
+export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_STORE_BYTES: number;
+export type ContinuationOriginContextState = "pending" | "pinned" | "abandoned" | "detached_latest" | "legacy_missing" | "scrubbed";
+export interface ContinuationOriginContextReference {
+    readonly schemaVersion: 1;
+    readonly digest: string;
+    readonly bytes: number;
+    readonly messageCount: number;
+}
+export interface ContinuationOriginContextPin {
+    readonly reference: ContinuationOriginContextReference;
+    release(): Promise<void>;
+}
+export interface ContinuationRetentionOptions {
+    /** Metadata/idempotency tombstones retained after terminal compaction. Default 50,000. */
+    readonly terminalMaxRecords?: number;
+    /** Maximum terminal tombstone age. Default 365 days. */
+    readonly terminalMaxAgeMs?: number;
+    /** Captured synthesized text retained for operator retrieval. Default 1,000 records. */
+    readonly capturedTextMaxRecords?: number;
+    /** Captured text retention window. Default 30 days. */
+    readonly capturedTextMaxAgeMs?: number;
+}
+export interface ContinuationStoreStats {
+    readonly format: "per-record-v3";
+    readonly records: number;
+    readonly active: number;
+    readonly unresolvedDelivery: number;
+    readonly deadLettered: number;
+    readonly terminalTombstones: number;
+    readonly compacted: number;
+    readonly capturedText: number;
+    readonly historyDegraded: number;
+    readonly limits: {
+        readonly terminalMaxRecords: number;
+        readonly terminalMaxAgeMs: number;
+        readonly capturedTextMaxRecords: number;
+        readonly capturedTextMaxAgeMs: number;
+    };
+}
+export interface ContinuationLastError {
+    readonly code: string;
+    readonly reason: string;
+    readonly at: string;
+}
+export interface DurableContinuationRecord {
+    readonly continuationId: string;
+    readonly serverName: string;
+    readonly originRunId: string;
+    readonly originConversationId: string;
+    readonly replyToConversationId?: string;
+    readonly historyBoundary?: string;
+    originContextState: ContinuationOriginContextState;
+    originContextRef?: ContinuationOriginContextReference;
+    /** Retained after terminal snapshot scrubbing for audit/idempotency. */
+    originContextDigest?: string;
+    originContextMessageCount?: number;
+    /** Domain-separated binding of the v1 claim fingerprint and pinned digest. */
+    originContextFingerprint?: string;
+    /** Store-only HMAC over the immutable claim, route, task, and snapshot binding. */
+    originContextBindingMac?: string;
+    completionKind?: "synthesized" | "origin_context_unavailable";
+    readonly mode: ContinuationMode;
+    readonly routeName?: string;
+    readonly taskKey: string;
+    readonly taskHash: string;
+    readonly claimFingerprint: string;
+    readonly resultTokenHash: string;
+    readonly createdAt: string;
+    updatedAt: string;
+    readonly deadline: string;
+    state: ContinuationState;
+    resultIdempotencyKey?: string;
+    resultPayloadHash?: string;
+    resultPayload?: unknown;
+    synthesisAttempts: number;
+    synthesisDeferrals: number;
+    synthesisStartedAt?: string;
+    synthesizedText?: string;
+    actionable?: boolean;
+    deliveryAttempts: number;
+    deliveryStartedAt?: string;
+    nextAttemptAt?: string;
+    leaseOwner?: string;
+    leaseUntil?: string;
+    lastError?: ContinuationLastError;
+    receipt?: ContinuationDeliveryReceipt;
+    /** Set once bulky terminal payload/text fields have been removed. */
+    compactedAt?: string;
+}
+export interface ContinuationStoreFile {
+    readonly schemaVersion: typeof CONTINUATION_STORE_SCHEMA_VERSION;
+    readonly updatedAt: string;
+    readonly records: Record<string, DurableContinuationRecord>;
+}
+export interface ResolvedContinuationRetention {
+    readonly terminalMaxRecords: number;
+    readonly terminalMaxAgeMs: number;
+    readonly capturedTextMaxRecords: number;
+    readonly capturedTextMaxAgeMs: number;
+}
+export interface ContinuationRecordTransaction {
+    readonly schemaVersion: 2 | typeof CONTINUATION_RECORD_STORE_SCHEMA_VERSION;
+    readonly generation: string;
+    readonly createdAt: string;
+    readonly writes: readonly DurableContinuationRecord[];
+    readonly deletes: readonly string[];
+}
+export interface ContinuationStoreManifest {
+    readonly schemaVersion: typeof CONTINUATION_RECORD_STORE_SCHEMA_VERSION;
+    readonly generation: string;
+    readonly updatedAt: string;
+    /** False only for a fresh evidence-free store. Absent means true for eager-guard manifests; true is monotonic. */
+    readonly rollbackGuardRequired?: boolean;
+    readonly stats: ContinuationStoreStats;
+}
+export interface ContinuationOriginContextGroupCommit {
+    readonly schemaVersion: 1;
+    readonly groupKey: string;
+    readonly originRunId: string;
+    readonly originConversationId: string;
+    readonly historyBoundary: string;
+    readonly snapshotDigest: string;
+    readonly memberCount: number;
+    readonly memberSetDigest: string;
+    readonly activatedAt: string;
+}
+export interface ContinuationStore {
+    readonly path: string;
+    get(id: string): Promise<DurableContinuationRecord | undefined>;
+    list(): Promise<readonly DurableContinuationRecord[]>;
+    findClaim(input: {
+        readonly serverName: string;
+        readonly originRunId: string;
+        readonly taskKey: string;
+    }): Promise<DurableContinuationRecord | undefined>;
+    stats(): Promise<ContinuationStoreStats>;
+    stageOriginContext(snapshot: AgentContinuationOriginContext): Promise<ContinuationOriginContextPin>;
+    loadOriginContext(reference: ContinuationOriginContextReference): Promise<AgentContinuationOriginContext | undefined>;
+    activateOriginContextGroup(input: {
+        readonly claimFingerprint: string;
+        readonly activatedAt: string;
+    }): Promise<void>;
+    mutate<T>(operation: (records: Map<string, DurableContinuationRecord>) => T | Promise<T>): Promise<T>;
+}
+export interface ContinuationStoreLock {
+    release(): Promise<void>;
+}
+//# sourceMappingURL=continuation-store-types.d.ts.map

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

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

package/dist/continuation-store-types.js

@@ -0,0 +1,26 @@
+import { AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_BYTES, AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_MESSAGE_BYTES, AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_MESSAGES, } from "@mono-agent/agent-contracts";
+export const CONTINUATION_STORE_SCHEMA_VERSION = 1;
+export const CONTINUATION_RECORD_STORE_SCHEMA_VERSION = 3;
+export const RECORDS_DIRECTORY = "records-v3";
+export const TRANSACTION_FILE = "continuation-transaction-v3.json";
+export const MANIFEST_FILE = "continuation-store-v3.json";
+export const LEGACY_RECORDS_DIRECTORY = "records-v2";
+export const LEGACY_TRANSACTION_FILE = "continuation-transaction-v2.json";
+export const V2_ROLLBACK_GUARD = "UPGRADED-TO-RECORDS-V3";
+export const ORIGIN_CONTEXT_GROUPS_DIRECTORY = "origin-context-groups-v1";
+export const OWNER_DATABASE_FILE = "continuations-owner.sqlite";
+export const ORIGIN_CONTEXTS_DIRECTORY = "origin-context-v1";
+export const MAX_RECORD_BYTES = 2 * 1024 * 1024;
+export const MAX_TRANSACTION_BYTES = 16 * 1024 * 1024;
+export const MAX_MANIFEST_BYTES = 1024 * 1024;
+export const MAX_GENERATION_BYTES = 256;
+export const MAX_LEGACY_STORE_BYTES = 256 * 1024 * 1024;
+export const DEFAULT_TERMINAL_MAX_RECORDS = 50_000;
+export const DEFAULT_TERMINAL_MAX_AGE_MS = 365 * 24 * 60 * 60 * 1_000;
+export const DEFAULT_CAPTURED_TEXT_MAX_RECORDS = 1_000;
+export const DEFAULT_CAPTURED_TEXT_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1_000;
+export const MAX_CONTINUATION_ORIGIN_CONTEXT_BYTES = AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_BYTES;
+export const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGES = AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_MESSAGES;
+export const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGE_BYTES = AGENT_CONTINUATION_ORIGIN_CONTEXT_MAX_MESSAGE_BYTES;
+export const MAX_CONTINUATION_ORIGIN_CONTEXT_STORE_BYTES = 256 * 1024 * 1024;
+//# sourceMappingURL=continuation-store-types.js.map

package/dist/continuation-store-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-store-types.js","sourceRoot":"","sources":["../src/continuation-store-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2CAA2C,EAC3C,mDAAmD,EACnD,8CAA8C,GAE/C,MAAM,6BAA6B,CAAC;AAQrC,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,kCAAkC,CAAC;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AACvD,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAC1E,MAAM,CAAC,MAAM,qCAAqC,GAAG,2CAA2C,CAAC;AACjG,MAAM,CAAC,MAAM,wCAAwC,GAAG,8CAA8C,CAAC;AACvG,MAAM,CAAC,MAAM,6CAA6C,GAAG,mDAAmD,CAAC;AACjH,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/continuation-store.d.ts

@@ -1,143 +1,9 @@
-import { type AgentContinuationOriginContext } from "@mono-agent/agent-contracts";
-import type { ContinuationDeliveryReceipt, ContinuationMode, ContinuationState } from "./continuations.js";
-export declare const CONTINUATION_STORE_SCHEMA_VERSION = 1;
-export declare const CONTINUATION_RECORD_STORE_SCHEMA_VERSION = 3;
-export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_BYTES: number;
-export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGES = 64;
-export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGE_BYTES: number;
-export declare const MAX_CONTINUATION_ORIGIN_CONTEXT_STORE_BYTES: number;
-export type ContinuationOriginContextState = "pending" | "pinned" | "abandoned" | "detached_latest" | "legacy_missing" | "scrubbed";
-export interface ContinuationOriginContextReference {
-    readonly schemaVersion: 1;
-    readonly digest: string;
-    readonly bytes: number;
-    readonly messageCount: number;
-}
-export interface ContinuationOriginContextPin {
-    readonly reference: ContinuationOriginContextReference;
-    release(): Promise<void>;
-}
-export interface ContinuationRetentionOptions {
-    /** Metadata/idempotency tombstones retained after terminal compaction. Default 50,000. */
-    readonly terminalMaxRecords?: number;
-    /** Maximum terminal tombstone age. Default 365 days. */
-    readonly terminalMaxAgeMs?: number;
-    /** Captured synthesized text retained for operator retrieval. Default 1,000 records. */
-    readonly capturedTextMaxRecords?: number;
-    /** Captured text retention window. Default 30 days. */
-    readonly capturedTextMaxAgeMs?: number;
-}
-export interface ContinuationStoreStats {
-    readonly format: "per-record-v3";
-    readonly records: number;
-    readonly active: number;
-    readonly unresolvedDelivery: number;
-    readonly deadLettered: number;
-    readonly terminalTombstones: number;
-    readonly compacted: number;
-    readonly capturedText: number;
-    readonly historyDegraded: number;
-    readonly limits: {
-        readonly terminalMaxRecords: number;
-        readonly terminalMaxAgeMs: number;
-        readonly capturedTextMaxRecords: number;
-        readonly capturedTextMaxAgeMs: number;
-    };
-}
-export interface ContinuationLastError {
-    readonly code: string;
-    readonly reason: string;
-    readonly at: string;
-}
-export interface DurableContinuationRecord {
-    readonly continuationId: string;
-    readonly serverName: string;
-    readonly originRunId: string;
-    readonly originConversationId: string;
-    readonly replyToConversationId?: string;
-    readonly historyBoundary?: string;
-    originContextState: ContinuationOriginContextState;
-    originContextRef?: ContinuationOriginContextReference;
-    /** Retained after terminal snapshot scrubbing for audit/idempotency. */
-    originContextDigest?: string;
-    originContextMessageCount?: number;
-    /** Domain-separated binding of the v1 claim fingerprint and pinned digest. */
-    originContextFingerprint?: string;
-    /** Store-only HMAC over the immutable claim, route, task, and snapshot binding. */
-    originContextBindingMac?: string;
-    completionKind?: "synthesized" | "origin_context_unavailable";
-    readonly mode: ContinuationMode;
-    readonly routeName?: string;
-    readonly taskKey: string;
-    readonly taskHash: string;
-    readonly claimFingerprint: string;
-    readonly resultTokenHash: string;
-    readonly createdAt: string;
-    updatedAt: string;
-    readonly deadline: string;
-    state: ContinuationState;
-    resultIdempotencyKey?: string;
-    resultPayloadHash?: string;
-    resultPayload?: unknown;
-    synthesisAttempts: number;
-    synthesisDeferrals: number;
-    synthesisStartedAt?: string;
-    synthesizedText?: string;
-    actionable?: boolean;
-    deliveryAttempts: number;
-    deliveryStartedAt?: string;
-    nextAttemptAt?: string;
-    leaseOwner?: string;
-    leaseUntil?: string;
-    lastError?: ContinuationLastError;
-    receipt?: ContinuationDeliveryReceipt;
-    /** Set once bulky terminal payload/text fields have been removed. */
-    compactedAt?: string;
-}
-export interface ContinuationStore {
-    readonly path: string;
-    get(id: string): Promise<DurableContinuationRecord | undefined>;
-    list(): Promise<readonly DurableContinuationRecord[]>;
-    findClaim(input: {
-        readonly serverName: string;
-        readonly originRunId: string;
-        readonly taskKey: string;
-    }): Promise<DurableContinuationRecord | undefined>;
-    stats(): Promise<ContinuationStoreStats>;
-    stageOriginContext(snapshot: AgentContinuationOriginContext): Promise<ContinuationOriginContextPin>;
-    loadOriginContext(reference: ContinuationOriginContextReference): Promise<AgentContinuationOriginContext | undefined>;
-    /**
-     * Atomically publishes every prepared context in one immutable origin group.
-     * A compact durable group marker is the semantic commit point, so activation
-     * remains all-or-nothing even when materializing the individual records takes
-     * more than one bounded transaction.
-     */
-    activateOriginContextGroup(input: {
-        readonly claimFingerprint: string;
-        readonly activatedAt: string;
-    }): Promise<void>;
-    mutate<T>(operation: (records: Map<string, DurableContinuationRecord>) => T | Promise<T>): Promise<T>;
-}
-export interface ContinuationStoreLock {
-    release(): Promise<void>;
-}
-/**
- * Claim exclusive ownership of a continuation state directory for this process.
- * SQLite holds an OS-backed exclusive transaction for the process lifetime.
- * There is no stale-path cleanup race: close or process death releases the OS
- * lock, and SQLite performs any required journal recovery for the next owner.
- */
-export declare function acquireContinuationStoreLock(stateDir: string): Promise<ContinuationStoreLock>;
-/**
- * Open the bounded per-record store. Each continuation has its own atomic 0600
- * file, so a result mutates O(1) durable data instead of rewriting every prior
- * payload. A tiny write-ahead transaction makes multi-record maintenance
- * restart-safe. The legacy v1 monolith is migrated idempotently on first open.
- */
+import { type ContinuationRetentionOptions, type ContinuationStore } from "./continuation-store-types.js";
+export { acquireContinuationStoreLock, loadOrCreateContinuationSecret, } from "./continuation-store-fs.js";
+export { CONTINUATION_RECORD_STORE_SCHEMA_VERSION, CONTINUATION_STORE_SCHEMA_VERSION, MAX_CONTINUATION_ORIGIN_CONTEXT_BYTES, MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGES, MAX_CONTINUATION_ORIGIN_CONTEXT_MESSAGE_BYTES, MAX_CONTINUATION_ORIGIN_CONTEXT_STORE_BYTES, } from "./continuation-store-types.js";
+export type { ContinuationLastError, ContinuationOriginContextPin, ContinuationOriginContextReference, ContinuationOriginContextState, ContinuationRetentionOptions, ContinuationStore, ContinuationStoreLock, ContinuationStoreStats, DurableContinuationRecord, } from "./continuation-store-types.js";
 export declare function openContinuationStore(stateDir: string, options?: {
     readonly retention?: ContinuationRetentionOptions;
     readonly now?: () => Date;
 }): Promise<ContinuationStore>;
-/** Persistent owner-only key used to derive restart-stable callback capabilities. */
-export declare function loadOrCreateContinuationSecret(stateDir: string): Promise<Buffer>;
 //# sourceMappingURL=continuation-store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"continuation-store.d.ts","sourceRoot":"","sources":["../src/continuation-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"continuation-store.d.ts","sourceRoot":"","sources":["../src/continuation-store.ts"],"names":[],"mappings":"AAsDA,OAAO,EAeL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EAEvB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wCAAwC,EACxC,iCAAiC,EACjC,qCAAqC,EACrC,wCAAwC,EACxC,6CAA6C,EAC7C,2CAA2C,GAC5C,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,kCAAkC,EAClC,8BAA8B,EAC9B,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,GACL,OAAO,CAAC,iBAAiB,CAAC,CA+c5B"}