@elie-laloum/outpost 4.2.0 → 6.0.1

package/dist/infrastructure/sse.js

@@ -0,0 +1,64 @@
+import { OutpostError } from "../domain/errors.js";
+export async function* serverSentEvents(body, maxBytes, onChunk = () => undefined) {
+    const decoder = new TextDecoder();
+    const reader = body.getReader();
+    let buffer = "";
+    let size = 0;
+    let event;
+    let data = [];
+    const dispatch = () => {
+        const complete = data.length
+            ? { ...(event ? { event } : {}), data: data.join("\n") }
+            : undefined;
+        event = undefined;
+        data = [];
+        return complete;
+    };
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (!done) {
+                onChunk();
+                size += value.byteLength;
+                if (size > maxBytes)
+                    throw new OutpostError("response", "Model response exceeds maxResponseBytes");
+            }
+            buffer += done
+                ? decoder.decode()
+                : decoder.decode(value, { stream: true });
+            // A CR at the end of a chunk may be the first half of a CRLF terminator.
+            const carriage = !done && buffer.endsWith("\r");
+            const lines = (carriage ? buffer.slice(0, -1) : buffer).split(/\r\n|\r|\n/);
+            buffer = done ? "" : `${lines.pop()}${carriage ? "\r" : ""}`;
+            for (const line of lines) {
+                if (line === "") {
+                    const complete = dispatch();
+                    if (complete)
+                        yield complete;
+                    continue;
+                }
+                if (line.startsWith(":"))
+                    continue;
+                const colon = line.indexOf(":");
+                const field = colon < 0 ? line : line.slice(0, colon);
+                const raw = colon < 0 ? "" : line.slice(colon + 1);
+                const value = raw.startsWith(" ") ? raw.slice(1) : raw;
+                if (field === "event")
+                    event = value;
+                if (field === "data")
+                    data.push(value);
+            }
+            if (!done)
+                continue;
+            const complete = dispatch();
+            if (complete)
+                yield complete;
+            return;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/infrastructure/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/infrastructure/sse.ts"],"names":[],"mappings":"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","sourcesContent":["import { OutpostError } from \"../domain/errors.ts\";\nimport type { ServerSentEvent } from \"./sse.types.ts\";\n\nexport async function* serverSentEvents(\n  body: ReadableStream<Uint8Array>,\n  maxBytes: number,\n  onChunk: () => void = () => undefined,\n): AsyncGenerator<ServerSentEvent> {\n  const decoder = new TextDecoder();\n  const reader = body.getReader();\n  let buffer = \"\";\n  let size = 0;\n  let event: string | undefined;\n  let data: string[] = [];\n  const dispatch = (): ServerSentEvent | undefined => {\n    const complete = data.length\n      ? { ...(event ? { event } : {}), data: data.join(\"\\n\") }\n      : undefined;\n    event = undefined;\n    data = [];\n    return complete;\n  };\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (!done) {\n        onChunk();\n        size += value.byteLength;\n        if (size > maxBytes)\n          throw new OutpostError(\n            \"response\",\n            \"Model response exceeds maxResponseBytes\",\n          );\n      }\n      buffer += done\n        ? decoder.decode()\n        : decoder.decode(value, { stream: true });\n      // A CR at the end of a chunk may be the first half of a CRLF terminator.\n      const carriage = !done && buffer.endsWith(\"\\r\");\n      const lines = (carriage ? buffer.slice(0, -1) : buffer).split(\n        /\\r\\n|\\r|\\n/,\n      );\n      buffer = done ? \"\" : `${lines.pop()!}${carriage ? \"\\r\" : \"\"}`;\n      for (const line of lines) {\n        if (line === \"\") {\n          const complete = dispatch();\n          if (complete) yield complete;\n          continue;\n        }\n        if (line.startsWith(\":\")) continue;\n        const colon = line.indexOf(\":\");\n        const field = colon < 0 ? line : line.slice(0, colon);\n        const raw = colon < 0 ? \"\" : line.slice(colon + 1);\n        const value = raw.startsWith(\" \") ? raw.slice(1) : raw;\n        if (field === \"event\") event = value;\n        if (field === \"data\") data.push(value);\n      }\n      if (!done) continue;\n      const complete = dispatch();\n      if (complete) yield complete;\n      return;\n    }\n  } finally {\n    await reader.cancel().catch(() => undefined);\n    reader.releaseLock();\n  }\n}\n"]}

package/dist/infrastructure/sse.types.d.ts

@@ -0,0 +1,4 @@
+export interface ServerSentEvent {
+    readonly event?: string;
+    readonly data: string;
+}

package/dist/infrastructure/sse.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sse.types.js.map

package/dist/infrastructure/sse.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.types.js","sourceRoot":"","sources":["../../src/infrastructure/sse.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ServerSentEvent {\n  readonly event?: string;\n  readonly data: string;\n}\n"]}

package/dist/infrastructure/storage-inventory.constants.js

@@ -3,6 +3,7 @@ export const storageCategories = [
     "logs",
     "locks",
     "workspaces",
+    "storage",
 ];
 export const storageInventoryDefaults = Object.freeze({
     maxEntries: 100_000,

package/dist/infrastructure/storage-inventory.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-inventory.constants.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,UAAU;IACV,MAAM;IACN,OAAO;IACP,YAAY;CACb,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC","sourcesContent":["import type { StorageCategoryName } from \"./storage-inventory.types.ts\";\n\nexport const storageCategories: readonly StorageCategoryName[] = [\n  \"recovery\",\n  \"logs\",\n  \"locks\",\n  \"workspaces\",\n];\nexport const storageInventoryDefaults = Object.freeze({\n  maxEntries: 100_000,\n  maxDepth: 64,\n});\n"]}
+{"version":3,"file":"storage-inventory.constants.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,UAAU;IACV,MAAM;IACN,OAAO;IACP,YAAY;IACZ,SAAS;CACV,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC","sourcesContent":["import type { StorageCategoryName } from \"./storage-inventory.types.ts\";\n\nexport const storageCategories: readonly StorageCategoryName[] = [\n  \"recovery\",\n  \"logs\",\n  \"locks\",\n  \"workspaces\",\n  \"storage\",\n];\nexport const storageInventoryDefaults = Object.freeze({\n  maxEntries: 100_000,\n  maxDepth: 64,\n});\n"]}

package/dist/infrastructure/storage-inventory.types.d.ts

@@ -1,4 +1,4 @@
-export type StorageCategoryName = "recovery" | "logs" | "locks" | "workspaces" | "artifacts" | "checkpoints" | "conversations" | "reservations" | "resources";
+export type StorageCategoryName = "storage" | "recovery" | "logs" | "locks" | "workspaces" | "artifacts" | "checkpoints" | "conversations" | "reservations" | "resources";
 export type StorageEntryKind = "file" | "directory" | "symlink" | "other" | "unknown";
 export interface StorageIssue {
     readonly path: string;

package/dist/infrastructure/storage-inventory.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-inventory.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.types.ts"],"names":[],"mappings":"","sourcesContent":["export type StorageCategoryName =\n  | \"recovery\"\n  | \"logs\"\n  | \"locks\"\n  | \"workspaces\"\n  | \"artifacts\"\n  | \"checkpoints\"\n  | \"conversations\"\n  | \"reservations\"\n  | \"resources\";\nexport type StorageEntryKind =\n  \"file\" | \"directory\" | \"symlink\" | \"other\" | \"unknown\";\n\nexport interface StorageIssue {\n  readonly path: string;\n  readonly code: string;\n}\nexport interface StorageUsage {\n  bytes: number;\n  files: number;\n  directories: number;\n  symlinks: number;\n  other: number;\n}\nexport interface StorageEntry extends StorageUsage {\n  readonly revision?: string;\n  readonly name: string;\n  readonly path: string;\n  kind: StorageEntryKind;\n  modifiedAt?: string;\n  complete: boolean;\n}\nexport interface StorageCategory {\n  readonly name: StorageCategoryName;\n  readonly path: string;\n  readonly entries: readonly StorageEntry[];\n}\nexport interface StorageInventory {\n  readonly root: string;\n  readonly categories: readonly StorageCategory[];\n  readonly usage: Readonly<StorageUsage>;\n  readonly issues: readonly StorageIssue[];\n  readonly complete: boolean;\n  readonly scannedEntries: number;\n  readonly maxEntries: number;\n}\nexport interface StorageScan {\n  remaining: number;\n  readonly issues: StorageIssue[];\n}\n"]}
+{"version":3,"file":"storage-inventory.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.types.ts"],"names":[],"mappings":"","sourcesContent":["export type StorageCategoryName =\n  | \"storage\"\n  | \"recovery\"\n  | \"logs\"\n  | \"locks\"\n  | \"workspaces\"\n  | \"artifacts\"\n  | \"checkpoints\"\n  | \"conversations\"\n  | \"reservations\"\n  | \"resources\";\nexport type StorageEntryKind =\n  \"file\" | \"directory\" | \"symlink\" | \"other\" | \"unknown\";\n\nexport interface StorageIssue {\n  readonly path: string;\n  readonly code: string;\n}\nexport interface StorageUsage {\n  bytes: number;\n  files: number;\n  directories: number;\n  symlinks: number;\n  other: number;\n}\nexport interface StorageEntry extends StorageUsage {\n  readonly revision?: string;\n  readonly name: string;\n  readonly path: string;\n  kind: StorageEntryKind;\n  modifiedAt?: string;\n  complete: boolean;\n}\nexport interface StorageCategory {\n  readonly name: StorageCategoryName;\n  readonly path: string;\n  readonly entries: readonly StorageEntry[];\n}\nexport interface StorageInventory {\n  readonly root: string;\n  readonly categories: readonly StorageCategory[];\n  readonly usage: Readonly<StorageUsage>;\n  readonly issues: readonly StorageIssue[];\n  readonly complete: boolean;\n  readonly scannedEntries: number;\n  readonly maxEntries: number;\n}\nexport interface StorageScan {\n  remaining: number;\n  readonly issues: StorageIssue[];\n}\n"]}

package/dist/infrastructure/storage-reservations.types.d.ts

@@ -13,11 +13,3 @@ export interface StorageReservation {
     release(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
 }
-export interface StorageReservationRecord {
-    readonly version: 1;
-    readonly id: string;
-    readonly pid: number;
-    readonly identity?: unknown;
-    readonly reserveBytes: number;
-    readonly createdAt: string;
-}

package/dist/infrastructure/storage-reservations.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-reservations.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-reservations.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Transport } from \"../domain/transport.types.ts\";\n\nexport interface StorageReservationOptions {\n  readonly transporter?: Transport;\n  readonly maxBytes: number;\n  readonly reserveBytes: number;\n  readonly maxEntries?: number;\n  readonly signal?: AbortSignal;\n}\n\nexport interface StorageReservation {\n  readonly id: string;\n  readonly repository: string;\n  readonly reserveBytes: number;\n  release(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface StorageReservationRecord {\n  readonly version: 1;\n  readonly id: string;\n  readonly pid: number;\n  readonly identity?: unknown;\n  readonly reserveBytes: number;\n  readonly createdAt: string;\n}\n"]}
+{"version":3,"file":"storage-reservations.types.js","sourceRoot":"","sources":["../../src/infrastructure/storage-reservations.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Transport } from \"../domain/transport.types.ts\";\n\nexport interface StorageReservationOptions {\n  readonly transporter?: Transport;\n  readonly maxBytes: number;\n  readonly reserveBytes: number;\n  readonly maxEntries?: number;\n  readonly signal?: AbortSignal;\n}\n\nexport interface StorageReservation {\n  readonly id: string;\n  readonly repository: string;\n  readonly reserveBytes: number;\n  release(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n"]}

package/dist/infrastructure/transport-conversations.d.ts

@@ -1,4 +1,4 @@
 import type { ConversationStore } from "../domain/conversation.types.ts";
-import type { ConversationFormat } from "./conversations.types.ts";
+import type { StoredConversationFormat } from "./conversations.types.ts";
 import type { TransportConversationOptions } from "./transport-conversations.types.ts";
-export declare function transportConversations(format: ConversationFormat, options: TransportConversationOptions): ConversationStore;
+export declare function transportConversations(format: StoredConversationFormat, options: TransportConversationOptions): ConversationStore;

package/dist/infrastructure/transport-conversations.js

@@ -3,14 +3,21 @@ import { mkdir, mkdtemp } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
 import { invariant } from "../domain/errors.js";
 import { transportKey } from "../domain/transport.js";
+import { harnessConversations } from "./conversations/harness-store.js";
 import { nativeConversations } from "./conversations/native-store.js";
 import { files } from "./conversations/files.js";
 import { validId } from "./conversations/paths.js";
 import { jsonBytes, jsonObject, transportReference } from "./transport-json.js";
 import { archiveFiles, restoreArchiveFiles } from "./transport-archive.js";
 import { safeDestination } from "./files.js";
+const baseStores = {
+    claude: () => nativeConversations("claude"),
+    codex: () => nativeConversations("codex"),
+    harness: harnessConversations,
+};
 export function transportConversations(format, options) {
-    const native = nativeConversations(format);
+    invariant(Object.hasOwn(baseStores, format), "Unsupported conversation format");
+    const native = baseStores[format]();
     const prefix = `conversations/${transportKey(options.namespace)}/${format}`;
     const key = (id) => {
         validId(id);

package/dist/infrastructure/transport-conversations.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport-conversations.js","sourceRoot":"","sources":["../../src/infrastructure/transport-conversations.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, mkdtemp } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport type { ConversationStore } from \"../domain/conversation.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { transportKey } from \"../domain/transport.ts\";\nimport type { ConversationFormat } from \"./conversations.types.ts\";\nimport type { TransportConversationOptions } from \"./transport-conversations.types.ts\";\nimport { nativeConversations } from \"./conversations/native-store.ts\";\nimport { files } from \"./conversations/files.ts\";\nimport { validId } from \"./conversations/paths.ts\";\nimport { jsonBytes, jsonObject, transportReference } from \"./transport-json.ts\";\nimport { archiveFiles, restoreArchiveFiles } from \"./transport-archive.ts\";\nimport { safeDestination } from \"./files.ts\";\n\nexport function transportConversations(\n  format: ConversationFormat,\n  options: TransportConversationOptions,\n): ConversationStore {\n  const native = nativeConversations(format);\n  const prefix = `conversations/${transportKey(options.namespace)}/${format}`;\n  const key = (id: string) => {\n    validId(id);\n    return `${prefix}/${id}/index`;\n  };\n  return {\n    name: `transport:${options.namespace}:${format}`,\n    async locate(id, repository) {\n      const current = await options.transporter.read(key(id));\n      invariant(current, \"Conversation does not exist\");\n      const value: unknown = jsonObject(current);\n      invariant(\n        value &&\n          typeof value === \"object\" &&\n          \"archive\" in value &&\n          \"file\" in value &&\n          typeof value.file === \"string\",\n        \"Invalid conversation index\",\n      );\n      const staging = join(repository, \".outpost\", \"recovery\", \"conversations\");\n      await mkdir(staging, { recursive: true, mode: 0o700 });\n      const parent = await mkdtemp(join(staging, \"materialized-\"));\n      const destination = join(parent, \"transcript\");\n      await restoreArchiveFiles(\n        options.transporter,\n        transportReference(value.archive),\n        destination,\n      );\n      const file = await safeDestination(destination, value.file);\n      return {\n        id,\n        file,\n        format,\n        reference: { key: current.key, revision: current.revision },\n      };\n    },\n    async capture(id, context) {\n      const target = key(id);\n      const previous = await options.transporter.read(target);\n      await mkdir(context.staging, { recursive: true, mode: 0o700 });\n      const home = await mkdtemp(join(context.staging, \"captured-\"));\n      const captured = await native.capture(id, { ...context, home });\n      const root = dirname(captured.file);\n      const selected = [\n        captured.file,\n        ...(await files(join(root, id, \"subagents\"))),\n      ];\n      const archive = await archiveFiles(\n        options.transporter,\n        root,\n        selected.map((file) => relative(root, file).replaceAll(\"\\\\\", \"/\")),\n        `${prefix}/${id}/snapshots/${randomUUID()}`,\n      );\n      const reference = await options.transporter.write(\n        target,\n        jsonBytes({\n          archive,\n          file: relative(root, captured.file).replaceAll(\"\\\\\", \"/\"),\n        }),\n        { ifRevision: previous?.revision ?? null },\n      );\n      return {\n        ...captured,\n        reference: { key: reference.key, revision: reference.revision },\n      };\n    },\n    restore(record, context) {\n      return native.restore(record, context);\n    },\n  };\n}\n"]}
+{"version":3,"file":"transport-conversations.js","sourceRoot":"","sources":["../../src/infrastructure/transport-conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,GAEZ;IACF,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,QAAQ,CAAC;IAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC;IACzC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,MAAM,UAAU,sBAAsB,CACpC,MAAgC,EAChC,OAAqC;IAErC,SAAS,CACP,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,EACjC,iCAAiC,CAClC,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,iBAAiB,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE;QACzB,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,GAAG,MAAM,IAAI,EAAE,QAAQ,CAAC;IACjC,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,aAAa,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;QAChD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU;YACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACxD,SAAS,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;YAClD,MAAM,KAAK,GAAY,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3C,SAAS,CACP,KAAK;gBACH,OAAO,KAAK,KAAK,QAAQ;gBACzB,SAAS,IAAI,KAAK;gBAClB,MAAM,IAAI,KAAK;gBACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAChC,4BAA4B,CAC7B,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAC/C,MAAM,mBAAmB,CACvB,OAAO,CAAC,WAAW,EACnB,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,EACjC,WAAW,CACZ,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5D,OAAO;gBACL,EAAE;gBACF,IAAI;gBACJ,MAAM;gBACN,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;aAC5D,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO;YACvB,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;YAC/D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG;gBACf,QAAQ,CAAC,IAAI;gBACb,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;aAC9C,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,OAAO,CAAC,WAAW,EACnB,IAAI,EACJ,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAClE,GAAG,MAAM,IAAI,EAAE,cAAc,UAAU,EAAE,EAAE,CAC5C,CAAC;YACF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,CAC/C,MAAM,EACN,SAAS,CAAC;gBACR,OAAO;gBACP,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;aAC1D,CAAC,EACF,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,CAC3C,CAAC;YACF,OAAO;gBACL,GAAG,QAAQ;gBACX,SAAS,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE;aAChE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,OAAO;YACrB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, mkdtemp } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport type { ConversationStore } from \"../domain/conversation.types.ts\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { transportKey } from \"../domain/transport.ts\";\nimport type { StoredConversationFormat } from \"./conversations.types.ts\";\nimport { harnessConversations } from \"./conversations/harness-store.ts\";\nimport type { TransportConversationOptions } from \"./transport-conversations.types.ts\";\nimport { nativeConversations } from \"./conversations/native-store.ts\";\nimport { files } from \"./conversations/files.ts\";\nimport { validId } from \"./conversations/paths.ts\";\nimport { jsonBytes, jsonObject, transportReference } from \"./transport-json.ts\";\nimport { archiveFiles, restoreArchiveFiles } from \"./transport-archive.ts\";\nimport { safeDestination } from \"./files.ts\";\n\nconst baseStores: Readonly<\n  Record<StoredConversationFormat, () => ConversationStore>\n> = {\n  claude: () => nativeConversations(\"claude\"),\n  codex: () => nativeConversations(\"codex\"),\n  harness: harnessConversations,\n};\n\nexport function transportConversations(\n  format: StoredConversationFormat,\n  options: TransportConversationOptions,\n): ConversationStore {\n  invariant(\n    Object.hasOwn(baseStores, format),\n    \"Unsupported conversation format\",\n  );\n  const native = baseStores[format]();\n  const prefix = `conversations/${transportKey(options.namespace)}/${format}`;\n  const key = (id: string) => {\n    validId(id);\n    return `${prefix}/${id}/index`;\n  };\n  return {\n    name: `transport:${options.namespace}:${format}`,\n    async locate(id, repository) {\n      const current = await options.transporter.read(key(id));\n      invariant(current, \"Conversation does not exist\");\n      const value: unknown = jsonObject(current);\n      invariant(\n        value &&\n          typeof value === \"object\" &&\n          \"archive\" in value &&\n          \"file\" in value &&\n          typeof value.file === \"string\",\n        \"Invalid conversation index\",\n      );\n      const staging = join(repository, \".outpost\", \"recovery\", \"conversations\");\n      await mkdir(staging, { recursive: true, mode: 0o700 });\n      const parent = await mkdtemp(join(staging, \"materialized-\"));\n      const destination = join(parent, \"transcript\");\n      await restoreArchiveFiles(\n        options.transporter,\n        transportReference(value.archive),\n        destination,\n      );\n      const file = await safeDestination(destination, value.file);\n      return {\n        id,\n        file,\n        format,\n        reference: { key: current.key, revision: current.revision },\n      };\n    },\n    async capture(id, context) {\n      const target = key(id);\n      const previous = await options.transporter.read(target);\n      await mkdir(context.staging, { recursive: true, mode: 0o700 });\n      const home = await mkdtemp(join(context.staging, \"captured-\"));\n      const captured = await native.capture(id, { ...context, home });\n      const root = dirname(captured.file);\n      const selected = [\n        captured.file,\n        ...(await files(join(root, id, \"subagents\"))),\n      ];\n      const archive = await archiveFiles(\n        options.transporter,\n        root,\n        selected.map((file) => relative(root, file).replaceAll(\"\\\\\", \"/\")),\n        `${prefix}/${id}/snapshots/${randomUUID()}`,\n      );\n      const reference = await options.transporter.write(\n        target,\n        jsonBytes({\n          archive,\n          file: relative(root, captured.file).replaceAll(\"\\\\\", \"/\"),\n        }),\n        { ifRevision: previous?.revision ?? null },\n      );\n      return {\n        ...captured,\n        reference: { key: reference.key, revision: reference.revision },\n      };\n    },\n    restore(record, context) {\n      return native.restore(record, context);\n    },\n  };\n}\n"]}

package/dist/infrastructure/transport-journal.js

@@ -1,3 +1,4 @@
+import { verboseOnly } from "./journal.constants.js";
 import { transportDefaults } from "./transport.constants.js";
 import { readLimit } from "./transport-envelope.js";
 import { randomUUID } from "node:crypto";
@@ -33,7 +34,7 @@ export async function transportJournal(transporter, verbose, label) {
             return { key: current.key, revision: current.revision };
         },
         record(event) {
-            if (closing || (event.kind === "raw" && !verbose))
+            if (closing || (verboseOnly.has(event.kind) && !verbose))
                 return;
             try {
                 const value = structuredClone({

package/dist/infrastructure/transport-journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport-journal.js","sourceRoot":"","sources":["../../src/infrastructure/transport-journal.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportDefaults } from \"./transport.constants.ts\";\nimport { readLimit } from \"./transport-envelope.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { Journal } from \"./journal.types.ts\";\nimport type {\n  JournalSnapshot,\n  ReadJournalOptions,\n} from \"./transport-journal.types.ts\";\nimport {\n  jsonBytes,\n  jsonObject,\n  readReference,\n  transportReference,\n} from \"./transport-json.ts\";\nimport { positive } from \"../domain/errors.ts\";\n\nexport function journalSnapshot(value: unknown): JournalSnapshot {\n  if (\n    !value ||\n    typeof value !== \"object\" ||\n    !(\"closed\" in value) ||\n    typeof value.closed !== \"boolean\" ||\n    !(\"head\" in value)\n  )\n    throw new Error(\"Invalid journal snapshot\");\n  return {\n    closed: value.closed,\n    head: value.head === null ? null : transportReference(value.head),\n  };\n}\n\nexport async function transportJournal(\n  transporter: Transport,\n  verbose: boolean,\n  label?: string,\n): Promise<Journal> {\n  const prefix = `logs/${randomUUID()}`;\n  let head: TransportReference | null = null;\n  let current = await transporter.write(\n    `${prefix}/index`,\n    jsonBytes({ closed: false, head }),\n    { ifRevision: null },\n  );\n  let closing: Promise<void> | undefined;\n  let pending = Promise.resolve();\n  let failure: unknown;\n  const append = async (event: unknown) => {\n    const segment = await transporter.write(\n      `${prefix}/${randomUUID()}`,\n      jsonBytes({ previous: head, event }),\n      { ifRevision: null },\n    );\n    current = await transporter.write(\n      current.key,\n      jsonBytes({ closed: false, head: segment }),\n      { ifRevision: current.revision },\n    );\n    head = segment;\n  };\n  await append({ kind: \"dispatch-start\", at: new Date().toISOString(), label });\n  return {\n    get reference() {\n      return { key: current.key, revision: current.revision };\n    },\n    record(event) {\n      if (closing || (event.kind === \"raw\" && !verbose)) return;\n      try {\n        const value = structuredClone({\n          at: new Date().toISOString(),\n          ...(label ? { label } : {}),\n          ...event,\n        });\n        pending = pending\n          .then(async () => {\n            if (!failure) await append(value);\n          })\n          .catch((error) => {\n            failure = error;\n          });\n      } catch (error) {\n        failure = error;\n      }\n    },\n    close() {\n      closing ??= (async () => {\n        await pending;\n        if (failure) throw failure;\n        current = await transporter.write(\n          current.key,\n          jsonBytes({ closed: true, head }),\n          { ifRevision: current.revision },\n        );\n      })();\n      return closing;\n    },\n  };\n}\n\nexport async function readJournal(\n  options: ReadJournalOptions,\n): Promise<readonly unknown[]> {\n  const maxEntries = positive(\n    options.maxEntries ?? transportDefaults.maxEntries,\n    \"maxEntries\",\n  );\n  const snapshot = journalSnapshot(\n    jsonObject(await readReference(options.transporter, options.reference)),\n  );\n  let next = snapshot.head;\n  let remaining = readLimit(options.maxBytes);\n  const events: unknown[] = [];\n  const seen = new Set<string>();\n  while (next) {\n    if (events.length >= maxEntries || seen.has(next.key))\n      throw new Error(\"Journal entry limit or cycle\");\n    seen.add(next.key);\n    const object = await readReference(options.transporter, next, remaining);\n    remaining -= object.bytes.length;\n    const segment: unknown = jsonObject(object);\n    if (\n      !segment ||\n      typeof segment !== \"object\" ||\n      !(\"event\" in segment) ||\n      !(\"previous\" in segment)\n    )\n      throw new Error(\"Invalid journal segment\");\n    events.push(segment.event);\n    next =\n      segment.previous === null ? null : transportReference(segment.previous);\n  }\n  return events.reverse();\n}\n"]}
+{"version":3,"file":"transport-journal.js","sourceRoot":"","sources":["../../src/infrastructure/transport-journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;QACjC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAElB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAsB,EACtB,OAAgB,EAChB,KAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,UAAU,EAAE,EAAE,CAAC;IACtC,IAAI,IAAI,GAA8B,IAAI,CAAC;IAC3C,IAAI,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CACnC,GAAG,MAAM,QAAQ,EACjB,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAClC,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;IACF,IAAI,OAAkC,CAAC;IACvC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,OAAgB,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,EAAE,KAAc,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CACrC,GAAG,MAAM,IAAI,UAAU,EAAE,EAAE,EAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EACpC,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;QACF,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAC/B,OAAO,CAAC,GAAG,EACX,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAC3C,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,CACjC,CAAC;QACF,IAAI,GAAG,OAAO,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,OAAO;QACL,IAAI,SAAS;YACX,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1D,CAAC;QACD,MAAM,CAAC,KAAK;YACV,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO;YACjE,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,eAAe,CAAC;oBAC5B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC5B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,GAAG,KAAK;iBACT,CAAC,CAAC;gBACH,OAAO,GAAG,OAAO;qBACd,IAAI,CAAC,KAAK,IAAI,EAAE;oBACf,IAAI,CAAC,OAAO;wBAAE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACf,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK;YACH,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,OAAO,CAAC;gBACd,IAAI,OAAO;oBAAE,MAAM,OAAO,CAAC;gBAC3B,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAC/B,OAAO,CAAC,GAAG,EACX,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EACjC,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,CACjC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B;IAE3B,MAAM,UAAU,GAAG,QAAQ,CACzB,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,UAAU,EAClD,YAAY,CACb,CAAC;IACF,MAAM,QAAQ,GAAG,eAAe,CAC9B,UAAU,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CACxE,CAAC;IACF,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IACzB,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACzE,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACjC,MAAM,OAAO,GAAY,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5C,IACE,CAAC,OAAO;YACR,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;YACrB,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC;YAExB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI;YACF,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["import { verboseOnly } from \"./journal.constants.ts\";\nimport { transportDefaults } from \"./transport.constants.ts\";\nimport { readLimit } from \"./transport-envelope.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { Journal } from \"./journal.types.ts\";\nimport type {\n  JournalSnapshot,\n  ReadJournalOptions,\n} from \"./transport-journal.types.ts\";\nimport {\n  jsonBytes,\n  jsonObject,\n  readReference,\n  transportReference,\n} from \"./transport-json.ts\";\nimport { positive } from \"../domain/errors.ts\";\n\nexport function journalSnapshot(value: unknown): JournalSnapshot {\n  if (\n    !value ||\n    typeof value !== \"object\" ||\n    !(\"closed\" in value) ||\n    typeof value.closed !== \"boolean\" ||\n    !(\"head\" in value)\n  )\n    throw new Error(\"Invalid journal snapshot\");\n  return {\n    closed: value.closed,\n    head: value.head === null ? null : transportReference(value.head),\n  };\n}\n\nexport async function transportJournal(\n  transporter: Transport,\n  verbose: boolean,\n  label?: string,\n): Promise<Journal> {\n  const prefix = `logs/${randomUUID()}`;\n  let head: TransportReference | null = null;\n  let current = await transporter.write(\n    `${prefix}/index`,\n    jsonBytes({ closed: false, head }),\n    { ifRevision: null },\n  );\n  let closing: Promise<void> | undefined;\n  let pending = Promise.resolve();\n  let failure: unknown;\n  const append = async (event: unknown) => {\n    const segment = await transporter.write(\n      `${prefix}/${randomUUID()}`,\n      jsonBytes({ previous: head, event }),\n      { ifRevision: null },\n    );\n    current = await transporter.write(\n      current.key,\n      jsonBytes({ closed: false, head: segment }),\n      { ifRevision: current.revision },\n    );\n    head = segment;\n  };\n  await append({ kind: \"dispatch-start\", at: new Date().toISOString(), label });\n  return {\n    get reference() {\n      return { key: current.key, revision: current.revision };\n    },\n    record(event) {\n      if (closing || (verboseOnly.has(event.kind) && !verbose)) return;\n      try {\n        const value = structuredClone({\n          at: new Date().toISOString(),\n          ...(label ? { label } : {}),\n          ...event,\n        });\n        pending = pending\n          .then(async () => {\n            if (!failure) await append(value);\n          })\n          .catch((error) => {\n            failure = error;\n          });\n      } catch (error) {\n        failure = error;\n      }\n    },\n    close() {\n      closing ??= (async () => {\n        await pending;\n        if (failure) throw failure;\n        current = await transporter.write(\n          current.key,\n          jsonBytes({ closed: true, head }),\n          { ifRevision: current.revision },\n        );\n      })();\n      return closing;\n    },\n  };\n}\n\nexport async function readJournal(\n  options: ReadJournalOptions,\n): Promise<readonly unknown[]> {\n  const maxEntries = positive(\n    options.maxEntries ?? transportDefaults.maxEntries,\n    \"maxEntries\",\n  );\n  const snapshot = journalSnapshot(\n    jsonObject(await readReference(options.transporter, options.reference)),\n  );\n  let next = snapshot.head;\n  let remaining = readLimit(options.maxBytes);\n  const events: unknown[] = [];\n  const seen = new Set<string>();\n  while (next) {\n    if (events.length >= maxEntries || seen.has(next.key))\n      throw new Error(\"Journal entry limit or cycle\");\n    seen.add(next.key);\n    const object = await readReference(options.transporter, next, remaining);\n    remaining -= object.bytes.length;\n    const segment: unknown = jsonObject(object);\n    if (\n      !segment ||\n      typeof segment !== \"object\" ||\n      !(\"event\" in segment) ||\n      !(\"previous\" in segment)\n    )\n      throw new Error(\"Invalid journal segment\");\n    events.push(segment.event);\n    next =\n      segment.previous === null ? null : transportReference(segment.previous);\n  }\n  return events.reverse();\n}\n"]}

package/dist/infrastructure/transport-reservations.d.ts

@@ -2,4 +2,4 @@ import type { Transport } from "../domain/transport.types.ts";
 import type { StorageReservation, StorageReservationOptions } from "./storage-reservations.types.ts";
 import type { ReservationLedger } from "./transport-reservations.types.ts";
 export declare function reservationLedger(value: unknown): ReservationLedger;
-export declare function reserveTransportStorage(transporter: Transport, repository: string, options: StorageReservationOptions): Promise<StorageReservation>;
+export declare function reserveTransportStorage(transporter: Transport, repository: string, options: StorageReservationOptions, measureUsage?: () => Promise<number>): Promise<StorageReservation>;

package/dist/infrastructure/transport-reservations.js

@@ -22,7 +22,16 @@ export function reservationLedger(value) {
         bytes >= 0), "Invalid reservation entry");
     return { format: 1, reservations: Object.fromEntries(entries) };
 }
-export async function reserveTransportStorage(transporter, repository, options) {
+async function payloadUsage(transporter, maxEntries, signal) {
+    let usage = 0, count = 0;
+    for await (const entry of transporter.list("", signal ? { signal } : {})) {
+        invariant(++count <= maxEntries, "Reservation inventory is incomplete");
+        if (entry.key !== key)
+            usage += entry.size;
+    }
+    return usage;
+}
+export async function reserveTransportStorage(transporter, repository, options, measureUsage) {
     invariant(Number.isSafeInteger(options.maxBytes) &&
         options.maxBytes >= 0 &&
         Number.isSafeInteger(options.reserveBytes) &&
@@ -40,14 +49,11 @@ export async function reserveTransportStorage(transporter, repository, options)
             if (release)
                 delete reservations[id];
             if (!release) {
-                let usage = 0, count = 0;
-                for await (const entry of transporter.list("", options.signal ? { signal: options.signal } : {})) {
-                    invariant(++count <= maxEntries, "Reservation inventory is incomplete");
-                    if (entry.key !== key)
-                        usage += entry.size;
-                }
+                const usage = measureUsage
+                    ? await measureUsage()
+                    : await payloadUsage(transporter, maxEntries, options.signal);
                 const reserved = Object.values(reservations).reduce((sum, value) => sum + value, 0);
-                invariant(usage + reserved + options.reserveBytes <= options.maxBytes, "Outpost storage quota admission refused");
+                invariant(usage + reserved + options.reserveBytes <= options.maxBytes, "Outpost storage reservation admission refused");
                 reservations[id] = options.reserveBytes;
             }
             try {

package/dist/infrastructure/transport-reservations.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport-reservations.js","sourceRoot":"","sources":["../../src/infrastructure/transport-reservations.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportDefaults } from \"./transport.constants.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type { Transport } from \"../domain/transport.types.ts\";\nimport { TransportConflict } from \"../domain/transport.ts\";\nimport { invariant, recordRecovery } from \"../domain/errors.ts\";\nimport { jsonBytes, jsonObject } from \"./transport-json.ts\";\nimport type {\n  StorageReservation,\n  StorageReservationOptions,\n} from \"./storage-reservations.types.ts\";\nimport type { ReservationLedger } from \"./transport-reservations.types.ts\";\n\nconst key = \"reservations/ledger\";\n\nexport function reservationLedger(value: unknown): ReservationLedger {\n  if (value === undefined) return { format: 1, reservations: {} };\n  invariant(\n    value &&\n      typeof value === \"object\" &&\n      \"format\" in value &&\n      value.format === 1 &&\n      \"reservations\" in value &&\n      value.reservations &&\n      typeof value.reservations === \"object\" &&\n      !Array.isArray(value.reservations),\n    \"Invalid reservation ledger\",\n  );\n  const entries = Object.entries(value.reservations);\n  invariant(\n    entries.every(\n      ([id, bytes]) =>\n        /^[a-f0-9-]{36}$/.test(id) &&\n        typeof bytes === \"number\" &&\n        Number.isSafeInteger(bytes) &&\n        bytes >= 0,\n    ),\n    \"Invalid reservation entry\",\n  );\n  return { format: 1, reservations: Object.fromEntries(entries) };\n}\n\nexport async function reserveTransportStorage(\n  transporter: Transport,\n  repository: string,\n  options: StorageReservationOptions,\n): Promise<StorageReservation> {\n  invariant(\n    Number.isSafeInteger(options.maxBytes) &&\n      options.maxBytes >= 0 &&\n      Number.isSafeInteger(options.reserveBytes) &&\n      options.reserveBytes >= 0,\n    \"Invalid reservation byte limit\",\n  );\n  const id = randomUUID();\n  const maxEntries = options.maxEntries ?? transportDefaults.maxEntries;\n  invariant(\n    Number.isSafeInteger(maxEntries) && maxEntries > 0,\n    \"Invalid reservation entry limit\",\n  );\n  async function update(release: boolean): Promise<void> {\n    for (\n      let attempt = 0;\n      attempt < transportDefaults.mutationAttempts;\n      attempt++\n    ) {\n      if (!release) options.signal?.throwIfAborted();\n      const current = await transporter.read(key);\n      const ledger = reservationLedger(jsonObject(current));\n      const reservations = { ...ledger.reservations };\n      if (release) delete reservations[id];\n      if (!release) {\n        let usage = 0,\n          count = 0;\n        for await (const entry of transporter.list(\n          \"\",\n          options.signal ? { signal: options.signal } : {},\n        )) {\n          invariant(\n            ++count <= maxEntries,\n            \"Reservation inventory is incomplete\",\n          );\n          if (entry.key !== key) usage += entry.size;\n        }\n        const reserved = Object.values(reservations).reduce(\n          (sum, value) => sum + value,\n          0,\n        );\n        invariant(\n          usage + reserved + options.reserveBytes <= options.maxBytes,\n          \"Outpost storage quota admission refused\",\n        );\n        reservations[id] = options.reserveBytes;\n      }\n      try {\n        await transporter.write(key, jsonBytes({ format: 1, reservations }), {\n          ifRevision: current?.revision ?? null,\n          ...(!release && options.signal ? { signal: options.signal } : {}),\n        });\n        return;\n      } catch (error) {\n        if (!(error instanceof TransportConflict)) throw error;\n      }\n    }\n    throw new Error(\"Storage reservation contention limit exceeded\");\n  }\n  try {\n    await update(false);\n  } catch (error) {\n    recordRecovery(error, { reservation: id });\n    throw error;\n  }\n  let released = false;\n  const release = async () => {\n    if (released) return;\n    await update(true);\n    released = true;\n  };\n  return {\n    id,\n    repository,\n    reserveBytes: options.reserveBytes,\n    release,\n    [Symbol.asyncDispose]: release,\n  };\n}\n"]}
+{"version":3,"file":"transport-reservations.js","sourceRoot":"","sources":["../../src/infrastructure/transport-reservations.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportDefaults } from \"./transport.constants.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type { Transport } from \"../domain/transport.types.ts\";\nimport { TransportConflict } from \"../domain/transport.ts\";\nimport { invariant, recordRecovery } from \"../domain/errors.ts\";\nimport { jsonBytes, jsonObject } from \"./transport-json.ts\";\nimport type {\n  StorageReservation,\n  StorageReservationOptions,\n} from \"./storage-reservations.types.ts\";\nimport type { ReservationLedger } from \"./transport-reservations.types.ts\";\n\nconst key = \"reservations/ledger\";\n\nexport function reservationLedger(value: unknown): ReservationLedger {\n  if (value === undefined) return { format: 1, reservations: {} };\n  invariant(\n    value &&\n      typeof value === \"object\" &&\n      \"format\" in value &&\n      value.format === 1 &&\n      \"reservations\" in value &&\n      value.reservations &&\n      typeof value.reservations === \"object\" &&\n      !Array.isArray(value.reservations),\n    \"Invalid reservation ledger\",\n  );\n  const entries = Object.entries(value.reservations);\n  invariant(\n    entries.every(\n      ([id, bytes]) =>\n        /^[a-f0-9-]{36}$/.test(id) &&\n        typeof bytes === \"number\" &&\n        Number.isSafeInteger(bytes) &&\n        bytes >= 0,\n    ),\n    \"Invalid reservation entry\",\n  );\n  return { format: 1, reservations: Object.fromEntries(entries) };\n}\n\nasync function payloadUsage(\n  transporter: Transport,\n  maxEntries: number,\n  signal?: AbortSignal,\n): Promise<number> {\n  let usage = 0,\n    count = 0;\n  for await (const entry of transporter.list(\"\", signal ? { signal } : {})) {\n    invariant(++count <= maxEntries, \"Reservation inventory is incomplete\");\n    if (entry.key !== key) usage += entry.size;\n  }\n  return usage;\n}\n\nexport async function reserveTransportStorage(\n  transporter: Transport,\n  repository: string,\n  options: StorageReservationOptions,\n  measureUsage?: () => Promise<number>,\n): Promise<StorageReservation> {\n  invariant(\n    Number.isSafeInteger(options.maxBytes) &&\n      options.maxBytes >= 0 &&\n      Number.isSafeInteger(options.reserveBytes) &&\n      options.reserveBytes >= 0,\n    \"Invalid reservation byte limit\",\n  );\n  const id = randomUUID();\n  const maxEntries = options.maxEntries ?? transportDefaults.maxEntries;\n  invariant(\n    Number.isSafeInteger(maxEntries) && maxEntries > 0,\n    \"Invalid reservation entry limit\",\n  );\n  async function update(release: boolean): Promise<void> {\n    for (\n      let attempt = 0;\n      attempt < transportDefaults.mutationAttempts;\n      attempt++\n    ) {\n      if (!release) options.signal?.throwIfAborted();\n      const current = await transporter.read(key);\n      const ledger = reservationLedger(jsonObject(current));\n      const reservations = { ...ledger.reservations };\n      if (release) delete reservations[id];\n      if (!release) {\n        const usage = measureUsage\n          ? await measureUsage()\n          : await payloadUsage(transporter, maxEntries, options.signal);\n        const reserved = Object.values(reservations).reduce(\n          (sum, value) => sum + value,\n          0,\n        );\n        invariant(\n          usage + reserved + options.reserveBytes <= options.maxBytes,\n          \"Outpost storage reservation admission refused\",\n        );\n        reservations[id] = options.reserveBytes;\n      }\n      try {\n        await transporter.write(key, jsonBytes({ format: 1, reservations }), {\n          ifRevision: current?.revision ?? null,\n          ...(!release && options.signal ? { signal: options.signal } : {}),\n        });\n        return;\n      } catch (error) {\n        if (!(error instanceof TransportConflict)) throw error;\n      }\n    }\n    throw new Error(\"Storage reservation contention limit exceeded\");\n  }\n  try {\n    await update(false);\n  } catch (error) {\n    recordRecovery(error, { reservation: id });\n    throw error;\n  }\n  let released = false;\n  const release = async () => {\n    if (released) return;\n    await update(true);\n    released = true;\n  };\n  return {\n    id,\n    repository,\n    reserveBytes: options.reserveBytes,\n    release,\n    [Symbol.asyncDispose]: release,\n  };\n}\n"]}

package/dist/providers/agents.d.ts

@@ -1,5 +1,10 @@
-export { claude } from "../adapters/agents/claude-adapter.ts";
-export { codex } from "../adapters/agents/codex-adapter.ts";
-export { gemini } from "../adapters/agents/gemini-adapter.ts";
-export type { GeminiSettings } from "../adapters/agents/gemini.types.ts";
+export { agentVersions } from "./versions.constants.ts";
+export { antigravityHarness } from "../adapters/agents/antigravity-adapter.ts";
+export { claudeHarness } from "../adapters/agents/claude-adapter.ts";
+export { codexHarness } from "../adapters/agents/codex-adapter.ts";
+export { copilotHarness } from "../adapters/agents/copilot-adapter.ts";
+export { kimiHarness } from "../adapters/agents/kimi-adapter.ts";
+export type { AntigravitySettings } from "../adapters/agents/antigravity.types.ts";
 export type { ClaudeSettings, CodexSettings, CodexModelProvider, } from "../adapters/agents/settings.types.ts";
+export type { CopilotSettings } from "../adapters/agents/copilot.types.ts";
+export type { KimiSettings } from "../adapters/agents/kimi.types.ts";

package/dist/providers/agents.js

@@ -1,4 +1,7 @@
-export { claude } from "../adapters/agents/claude-adapter.js";
-export { codex } from "../adapters/agents/codex-adapter.js";
-export { gemini } from "../adapters/agents/gemini-adapter.js";
+export { agentVersions } from "./versions.constants.js";
+export { antigravityHarness } from "../adapters/agents/antigravity-adapter.js";
+export { claudeHarness } from "../adapters/agents/claude-adapter.js";
+export { codexHarness } from "../adapters/agents/codex-adapter.js";
+export { copilotHarness } from "../adapters/agents/copilot-adapter.js";
+export { kimiHarness } from "../adapters/agents/kimi-adapter.js";
 //# sourceMappingURL=agents.js.map

package/dist/providers/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/providers/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC","sourcesContent":["export { claude } from \"../adapters/agents/claude-adapter.ts\";\nexport { codex } from \"../adapters/agents/codex-adapter.ts\";\nexport { gemini } from \"../adapters/agents/gemini-adapter.ts\";\nexport type { GeminiSettings } from \"../adapters/agents/gemini.types.ts\";\nexport type {\n  ClaudeSettings,\n  CodexSettings,\n  CodexModelProvider,\n} from \"../adapters/agents/settings.types.ts\";\n"]}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/providers/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC","sourcesContent":["export { agentVersions } from \"./versions.constants.ts\";\nexport { antigravityHarness } from \"../adapters/agents/antigravity-adapter.ts\";\nexport { claudeHarness } from \"../adapters/agents/claude-adapter.ts\";\nexport { codexHarness } from \"../adapters/agents/codex-adapter.ts\";\nexport { copilotHarness } from \"../adapters/agents/copilot-adapter.ts\";\nexport { kimiHarness } from \"../adapters/agents/kimi-adapter.ts\";\nexport type { AntigravitySettings } from \"../adapters/agents/antigravity.types.ts\";\nexport type {\n  ClaudeSettings,\n  CodexSettings,\n  CodexModelProvider,\n} from \"../adapters/agents/settings.types.ts\";\nexport type { CopilotSettings } from \"../adapters/agents/copilot.types.ts\";\nexport type { KimiSettings } from \"../adapters/agents/kimi.types.ts\";\n"]}

package/dist/providers/daytona.d.ts

@@ -2,4 +2,4 @@ import type { Daytona, DaytonaConfig } from "@daytona/sdk";
 import type { SandboxProvider } from "../domain/sandbox.types.ts";
 import type { DaytonaOptions } from "./daytona.types.ts";
 export type { DaytonaOptions } from "./daytona.types.ts";
-export declare function daytona(options?: DaytonaOptions, connect?: (config?: DaytonaConfig) => Promise<Pick<Daytona, "create" | "delete">>): SandboxProvider;
+export declare function daytonaSandboxProvider(options?: DaytonaOptions, connect?: (config?: DaytonaConfig) => Promise<Pick<Daytona, "create" | "delete">>): SandboxProvider;

package/dist/providers/daytona.js

@@ -5,7 +5,7 @@ import { registerCleanup } from "../infrastructure/shutdown.js";
 import { cloudRoots } from "./cloud.constants.js";
 import { daytonaCommand } from "./daytona-command.js";
 import { daytonaFiles } from "./daytona-files.js";
-export function daytona(options = {}, connect = async (config) => new (await import("@daytona/sdk")).Daytona(config)) {
+export function daytonaSandboxProvider(options = {}, connect = async (config) => new (await import("@daytona/sdk")).Daytona(config)) {
     invariant(!("egress" in options) || options.egress === undefined, "Daytona does not support Outpost egress policies; configure provider-native networking explicitly");
     return {
         name: "daytona",

package/dist/providers/daytona.js.map

@@ -1 +1 @@
-{"version":3,"file":"daytona.js","sourceRoot":"","sources":["../../src/providers/daytona.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Daytona, DaytonaConfig } from \"@daytona/sdk\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { posix } from \"node:path\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport { fileBatches } from \"./file-batches.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { cloudRoots } from \"./cloud.constants.ts\";\nimport { daytonaCommand } from \"./daytona-command.ts\";\nimport { daytonaFiles } from \"./daytona-files.ts\";\nimport type { DaytonaOptions } from \"./daytona.types.ts\";\n\nexport type { DaytonaOptions } from \"./daytona.types.ts\";\n\nexport function daytona(\n  options: DaytonaOptions = {},\n  connect: (\n    config?: DaytonaConfig,\n  ) => Promise<Pick<Daytona, \"create\" | \"delete\">> = async (config) =>\n    new (await import(\"@daytona/sdk\")).Daytona(config),\n): SandboxProvider {\n  invariant(\n    !(\"egress\" in options) || options.egress === undefined,\n    \"Daytona does not support Outpost egress policies; configure provider-native networking explicitly\",\n  );\n  return {\n    name: \"daytona\",\n    placement: \"remote\",\n    variables: { ...options.variables },\n    async acquire(context) {\n      context.signal?.throwIfAborted();\n      const client = await connect(options.connection);\n      const sandbox = await client.create(options.create ?? {});\n      let closed = false,\n        releasing: Promise<void> | undefined;\n      let unregister = () => {};\n      const release = () =>\n        (releasing ??= client\n          .delete(sandbox)\n          .then(() => {\n            closed = true;\n            unregister();\n          })\n          .catch((error) => {\n            releasing = undefined;\n            throw error;\n          }));\n      unregister = registerCleanup(release);\n      let home: string;\n      let root: string;\n      try {\n        home = (await sandbox.getUserHomeDir()) ?? cloudRoots.daytonaHome;\n        root = options.root ?? posix.join(home, \"outpost\");\n        await sandbox.fs.createFolder(root, \"755\");\n      } catch (cause) {\n        try {\n          await release();\n        } catch (cleanup) {\n          throw new AggregateError(\n            [cause, cleanup],\n            \"Cloud setup and cleanup failed\",\n          );\n        }\n        throw cause;\n      }\n      const lease = {\n        root,\n        home,\n        invoke: daytonaCommand({\n          sandbox,\n          root,\n          options,\n          context,\n          isClosed: () => closed,\n        }),\n        ...daytonaFiles(sandbox),\n        release,\n      };\n      return { ...lease, fileTransfers: fileBatches(lease) };\n    },\n  };\n}\n"]}
+{"version":3,"file":"daytona.js","sourceRoot":"","sources":["../../src/providers/daytona.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Daytona, DaytonaConfig } from \"@daytona/sdk\";\nimport { invariant } from \"../domain/errors.ts\";\nimport { posix } from \"node:path\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport { fileBatches } from \"./file-batches.ts\";\nimport { registerCleanup } from \"../infrastructure/shutdown.ts\";\nimport { cloudRoots } from \"./cloud.constants.ts\";\nimport { daytonaCommand } from \"./daytona-command.ts\";\nimport { daytonaFiles } from \"./daytona-files.ts\";\nimport type { DaytonaOptions } from \"./daytona.types.ts\";\n\nexport type { DaytonaOptions } from \"./daytona.types.ts\";\n\nexport function daytonaSandboxProvider(\n  options: DaytonaOptions = {},\n  connect: (\n    config?: DaytonaConfig,\n  ) => Promise<Pick<Daytona, \"create\" | \"delete\">> = async (config) =>\n    new (await import(\"@daytona/sdk\")).Daytona(config),\n): SandboxProvider {\n  invariant(\n    !(\"egress\" in options) || options.egress === undefined,\n    \"Daytona does not support Outpost egress policies; configure provider-native networking explicitly\",\n  );\n  return {\n    name: \"daytona\",\n    placement: \"remote\",\n    variables: { ...options.variables },\n    async acquire(context) {\n      context.signal?.throwIfAborted();\n      const client = await connect(options.connection);\n      const sandbox = await client.create(options.create ?? {});\n      let closed = false,\n        releasing: Promise<void> | undefined;\n      let unregister = () => {};\n      const release = () =>\n        (releasing ??= client\n          .delete(sandbox)\n          .then(() => {\n            closed = true;\n            unregister();\n          })\n          .catch((error) => {\n            releasing = undefined;\n            throw error;\n          }));\n      unregister = registerCleanup(release);\n      let home: string;\n      let root: string;\n      try {\n        home = (await sandbox.getUserHomeDir()) ?? cloudRoots.daytonaHome;\n        root = options.root ?? posix.join(home, \"outpost\");\n        await sandbox.fs.createFolder(root, \"755\");\n      } catch (cause) {\n        try {\n          await release();\n        } catch (cleanup) {\n          throw new AggregateError(\n            [cause, cleanup],\n            \"Cloud setup and cleanup failed\",\n          );\n        }\n        throw cause;\n      }\n      const lease = {\n        root,\n        home,\n        invoke: daytonaCommand({\n          sandbox,\n          root,\n          options,\n          context,\n          isClosed: () => closed,\n        }),\n        ...daytonaFiles(sandbox),\n        release,\n      };\n      return { ...lease, fileTransfers: fileBatches(lease) };\n    },\n  };\n}\n"]}

package/dist/providers/docker.d.ts

@@ -1,5 +1,5 @@
 import type { ContainerOptions } from "./container.types.ts";
 export type { ContainerOptions } from "./container.ts";
-export declare const docker: (options?: ContainerOptions) => import("../index.ts").SandboxProvider;
+export declare const dockerSandboxProvider: (options?: ContainerOptions) => import("../index.ts").SandboxProvider;
 export type { DependencyCache } from "./container-cache.types.ts";
 export type { EgressPolicy } from "../domain/egress.types.ts";

package/dist/providers/docker.js

@@ -1,3 +1,3 @@
 import { containerProvider } from "./container.js";
-export const docker = (options = {}) => containerProvider("docker", options);
+export const dockerSandboxProvider = (options = {}) => containerProvider("docker", options);
 //# sourceMappingURL=docker.js.map

package/dist/providers/docker.js.map

@@ -1 +1 @@
-{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/providers/docker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAA4B,EAAE,EAAE,EAAE,CACvD,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import { containerProvider } from \"./container.ts\";\nimport type { ContainerOptions } from \"./container.types.ts\";\n\nexport type { ContainerOptions } from \"./container.ts\";\n\nexport const docker = (options: ContainerOptions = {}) =>\n  containerProvider(\"docker\", options);\n\nexport type { DependencyCache } from \"./container-cache.types.ts\";\n\nexport type { EgressPolicy } from \"../domain/egress.types.ts\";\n"]}
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/providers/docker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,UAA4B,EAAE,EAAE,EAAE,CACtE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import { containerProvider } from \"./container.ts\";\nimport type { ContainerOptions } from \"./container.types.ts\";\n\nexport type { ContainerOptions } from \"./container.ts\";\n\nexport const dockerSandboxProvider = (options: ContainerOptions = {}) =>\n  containerProvider(\"docker\", options);\n\nexport type { DependencyCache } from \"./container-cache.types.ts\";\n\nexport type { EgressPolicy } from \"../domain/egress.types.ts\";\n"]}

package/dist/providers/factories.d.ts

@@ -1,4 +1,4 @@
 import type { SandboxProvider } from "../domain/sandbox.types.ts";
 import type { ProviderDefinition } from "./factories.types.ts";
-export declare const mountedProvider: (definition: ProviderDefinition) => SandboxProvider;
-export declare const remoteProvider: (definition: ProviderDefinition) => SandboxProvider;
+export declare const mountedSandboxProvider: (definition: ProviderDefinition) => SandboxProvider;
+export declare const remoteSandboxProvider: (definition: ProviderDefinition) => SandboxProvider;

package/dist/providers/factories.js

@@ -1,5 +1,5 @@
 import { invariant } from "../domain/errors.js";
-function provider(placement, definition) {
+function sandboxProvider(placement, definition) {
     invariant(definition.name.trim(), "A provider needs a name");
     return Object.freeze({
         ...definition,
@@ -7,6 +7,6 @@ function provider(placement, definition) {
         variables: Object.freeze({ ...definition.variables }),
     });
 }
-export const mountedProvider = (definition) => provider("mounted", definition);
-export const remoteProvider = (definition) => provider("remote", definition);
+export const mountedSandboxProvider = (definition) => sandboxProvider("mounted", definition);
+export const remoteSandboxProvider = (definition) => sandboxProvider("remote", definition);
 //# sourceMappingURL=factories.js.map

package/dist/providers/factories.js.map

@@ -1 +1 @@
-{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../src/providers/factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,SAAS,QAAQ,CACf,SAA+B,EAC/B,UAA8B;IAE9B,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,UAAU;QACb,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAA8B,EACb,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAA8B,EACb,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type { ProviderDefinition } from \"./factories.types.ts\";\n\nfunction provider(\n  placement: \"mounted\" | \"remote\",\n  definition: ProviderDefinition,\n): SandboxProvider {\n  invariant(definition.name.trim(), \"A provider needs a name\");\n  return Object.freeze({\n    ...definition,\n    placement,\n    variables: Object.freeze({ ...definition.variables }),\n  });\n}\n\nexport const mountedProvider = (\n  definition: ProviderDefinition,\n): SandboxProvider => provider(\"mounted\", definition);\n\nexport const remoteProvider = (\n  definition: ProviderDefinition,\n): SandboxProvider => provider(\"remote\", definition);\n"]}
+{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../src/providers/factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,SAAS,eAAe,CACtB,SAA+B,EAC/B,UAA8B;IAE9B,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,UAAU;QACb,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,UAA8B,EACb,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,UAA8B,EACb,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport type { ProviderDefinition } from \"./factories.types.ts\";\n\nfunction sandboxProvider(\n  placement: \"mounted\" | \"remote\",\n  definition: ProviderDefinition,\n): SandboxProvider {\n  invariant(definition.name.trim(), \"A provider needs a name\");\n  return Object.freeze({\n    ...definition,\n    placement,\n    variables: Object.freeze({ ...definition.variables }),\n  });\n}\n\nexport const mountedSandboxProvider = (\n  definition: ProviderDefinition,\n): SandboxProvider => sandboxProvider(\"mounted\", definition);\n\nexport const remoteSandboxProvider = (\n  definition: ProviderDefinition,\n): SandboxProvider => sandboxProvider(\"remote\", definition);\n"]}

package/dist/providers/firecracker.d.ts

@@ -1,4 +1,4 @@
 import type { SandboxProvider } from "../domain/sandbox.types.ts";
 import type { FirecrackerOptions } from "./firecracker.types.ts";
 export type { FirecrackerOptions } from "./firecracker.types.ts";
-export declare function firecracker(options: FirecrackerOptions): SandboxProvider;
+export declare function firecrackerSandboxProvider(options: FirecrackerOptions): SandboxProvider;

package/dist/providers/firecracker.js

@@ -5,7 +5,7 @@ import { firecrackerCommand, firecrackerSsh } from "./firecracker-command.js";
 import { firecrackerDefaults } from "./firecracker.constants.js";
 import { firecrackerFiles } from "./firecracker-files.js";
 import { firecrackerMachine, validateFirecracker, } from "./firecracker-machine.js";
-export function firecracker(options) {
+export function firecrackerSandboxProvider(options) {
     validateFirecracker(options);
     let allocated = false;
     return {

package/dist/providers/firecracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"firecracker.js","sourceRoot":"","sources":["../../src/providers/firecracker.ts"],"names":[],"mappings":"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","sourcesContent":["import { setTimeout as delay } from \"node:timers/promises\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport { executeProcess, quote } from \"../infrastructure/process.ts\";\nimport { firecrackerCommand, firecrackerSsh } from \"./firecracker-command.ts\";\nimport { firecrackerDefaults } from \"./firecracker.constants.ts\";\nimport { firecrackerFiles } from \"./firecracker-files.ts\";\nimport {\n  firecrackerMachine,\n  validateFirecracker,\n} from \"./firecracker-machine.ts\";\nimport type { FirecrackerOptions } from \"./firecracker.types.ts\";\n\nexport type { FirecrackerOptions } from \"./firecracker.types.ts\";\n\nexport function firecracker(options: FirecrackerOptions): SandboxProvider {\n  validateFirecracker(options);\n  let allocated = false;\n  return {\n    name: \"firecracker\",\n    placement: \"remote\",\n    variables: { ...options.variables },\n    async acquire(context) {\n      if (allocated)\n        throw new OutpostError(\n          \"provider\",\n          \"This Firecracker provider already owns its TAP; create separate configurations for concurrent VMs\",\n        );\n      allocated = true;\n      let machine;\n      try {\n        machine = await firecrackerMachine(options, context.signal);\n      } catch (cause) {\n        allocated = false;\n        throw cause;\n      }\n      const root = options.root ?? firecrackerDefaults.root;\n      let closed = false;\n      const active = new Set<Promise<unknown>>();\n      const stop = new AbortController();\n      const runtime = {\n        options,\n        root,\n        variables: context.variables,\n        executor: executeProcess,\n        isClosed: () => closed || machine.isClosed(),\n      };\n      let releasing: Promise<void> | undefined;\n      const release = () =>\n        (releasing ??= (async () => {\n          closed = true;\n          stop.abort(\n            new OutpostError(\"aborted\", \"Firecracker sandbox disposed\"),\n          );\n          await Promise.allSettled([...active]);\n          await machine.release();\n          allocated = false;\n        })().catch((cause) => {\n          releasing = undefined;\n          throw cause;\n        }));\n      try {\n        const deadline =\n          Date.now() +\n          (options.bootDeadlineMs ?? firecrackerDefaults.bootDeadlineMs);\n        while (true) {\n          context.signal?.throwIfAborted();\n          if (machine.isClosed())\n            throw new OutpostError(\n              \"provider\",\n              \"Firecracker exited before guest readiness\",\n            );\n          const result = await executeProcess({\n            ...firecrackerSsh(\n              options,\n              `test \"$HOME\" = ${quote(options.home)} && node -e 'if(Number(process.versions.node.split(\".\")[0])<24)process.exit(1)' && command -v git setsid tar >/dev/null && mkdir -p ${quote(root)}`,\n            ),\n            deadlineMs: Math.max(\n              1,\n              Math.min(firecrackerDefaults.probeMs, deadline - Date.now()),\n            ),\n            ...(context.signal ? { signal: context.signal } : {}),\n          }).catch((cause) => {\n            context.signal?.throwIfAborted();\n            return { status: 1, stdout: \"\", stderr: String(cause) };\n          });\n          if (machine.isClosed())\n            throw new OutpostError(\n              \"provider\",\n              \"Firecracker exited during guest readiness\",\n            );\n          if (result.status === 0) break;\n          if (Date.now() >= deadline)\n            throw new OutpostError(\n              \"timeout\",\n              \"Firecracker guest SSH/prerequisites did not become ready\",\n              { stderr: result.stderr },\n            );\n          await delay(100, undefined, { signal: context.signal });\n        }\n      } catch (cause) {\n        try {\n          await release();\n        } catch (cleanup) {\n          throw new AggregateError(\n            [cause, cleanup],\n            \"Firecracker acquisition and cleanup failed\",\n          );\n        }\n        throw cause;\n      }\n      const invoke = firecrackerCommand(runtime);\n      const files = firecrackerFiles(runtime);\n      const track = <T>(\n        operation: (signal: AbortSignal) => Promise<T>,\n        signal?: AbortSignal,\n      ): Promise<T> => {\n        if (closed)\n          return Promise.reject(\n            new OutpostError(\"provider\", \"Firecracker sandbox is closed\"),\n          );\n        const pending = operation(\n          signal ? AbortSignal.any([signal, stop.signal]) : stop.signal,\n        );\n        active.add(pending);\n        void pending.then(\n          () => active.delete(pending),\n          () => active.delete(pending),\n        );\n        return pending;\n      };\n      return {\n        root,\n        home: options.home,\n        invoke: (command) =>\n          track((signal) => invoke({ ...command, signal }), command.signal),\n        upload: (source, destination, options = {}) =>\n          track(\n            (signal) =>\n              files.upload(source, destination, { ...options, signal }),\n            options.signal,\n          ),\n        download: (source, destination, options = {}) =>\n          track(\n            (signal) =>\n              files.download(source, destination, { ...options, signal }),\n            options.signal,\n          ),\n        release,\n      };\n    },\n  };\n}\n"]}
+{"version":3,"file":"firecracker.js","sourceRoot":"","sources":["../../src/providers/firecracker.ts"],"names":[],"mappings":"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","sourcesContent":["import { setTimeout as delay } from \"node:timers/promises\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport type { SandboxProvider } from \"../domain/sandbox.types.ts\";\nimport { executeProcess, quote } from \"../infrastructure/process.ts\";\nimport { firecrackerCommand, firecrackerSsh } from \"./firecracker-command.ts\";\nimport { firecrackerDefaults } from \"./firecracker.constants.ts\";\nimport { firecrackerFiles } from \"./firecracker-files.ts\";\nimport {\n  firecrackerMachine,\n  validateFirecracker,\n} from \"./firecracker-machine.ts\";\nimport type { FirecrackerOptions } from \"./firecracker.types.ts\";\n\nexport type { FirecrackerOptions } from \"./firecracker.types.ts\";\n\nexport function firecrackerSandboxProvider(\n  options: FirecrackerOptions,\n): SandboxProvider {\n  validateFirecracker(options);\n  let allocated = false;\n  return {\n    name: \"firecracker\",\n    placement: \"remote\",\n    variables: { ...options.variables },\n    async acquire(context) {\n      if (allocated)\n        throw new OutpostError(\n          \"provider\",\n          \"This Firecracker provider already owns its TAP; create separate configurations for concurrent VMs\",\n        );\n      allocated = true;\n      let machine;\n      try {\n        machine = await firecrackerMachine(options, context.signal);\n      } catch (cause) {\n        allocated = false;\n        throw cause;\n      }\n      const root = options.root ?? firecrackerDefaults.root;\n      let closed = false;\n      const active = new Set<Promise<unknown>>();\n      const stop = new AbortController();\n      const runtime = {\n        options,\n        root,\n        variables: context.variables,\n        executor: executeProcess,\n        isClosed: () => closed || machine.isClosed(),\n      };\n      let releasing: Promise<void> | undefined;\n      const release = () =>\n        (releasing ??= (async () => {\n          closed = true;\n          stop.abort(\n            new OutpostError(\"aborted\", \"Firecracker sandbox disposed\"),\n          );\n          await Promise.allSettled([...active]);\n          await machine.release();\n          allocated = false;\n        })().catch((cause) => {\n          releasing = undefined;\n          throw cause;\n        }));\n      try {\n        const deadline =\n          Date.now() +\n          (options.bootDeadlineMs ?? firecrackerDefaults.bootDeadlineMs);\n        while (true) {\n          context.signal?.throwIfAborted();\n          if (machine.isClosed())\n            throw new OutpostError(\n              \"provider\",\n              \"Firecracker exited before guest readiness\",\n            );\n          const result = await executeProcess({\n            ...firecrackerSsh(\n              options,\n              `test \"$HOME\" = ${quote(options.home)} && node -e 'if(Number(process.versions.node.split(\".\")[0])<24)process.exit(1)' && command -v git setsid tar >/dev/null && mkdir -p ${quote(root)}`,\n            ),\n            deadlineMs: Math.max(\n              1,\n              Math.min(firecrackerDefaults.probeMs, deadline - Date.now()),\n            ),\n            ...(context.signal ? { signal: context.signal } : {}),\n          }).catch((cause) => {\n            context.signal?.throwIfAborted();\n            return { status: 1, stdout: \"\", stderr: String(cause) };\n          });\n          if (machine.isClosed())\n            throw new OutpostError(\n              \"provider\",\n              \"Firecracker exited during guest readiness\",\n            );\n          if (result.status === 0) break;\n          if (Date.now() >= deadline)\n            throw new OutpostError(\n              \"timeout\",\n              \"Firecracker guest SSH/prerequisites did not become ready\",\n              { stderr: result.stderr },\n            );\n          await delay(100, undefined, { signal: context.signal });\n        }\n      } catch (cause) {\n        try {\n          await release();\n        } catch (cleanup) {\n          throw new AggregateError(\n            [cause, cleanup],\n            \"Firecracker acquisition and cleanup failed\",\n          );\n        }\n        throw cause;\n      }\n      const invoke = firecrackerCommand(runtime);\n      const files = firecrackerFiles(runtime);\n      const track = <T>(\n        operation: (signal: AbortSignal) => Promise<T>,\n        signal?: AbortSignal,\n      ): Promise<T> => {\n        if (closed)\n          return Promise.reject(\n            new OutpostError(\"provider\", \"Firecracker sandbox is closed\"),\n          );\n        const pending = operation(\n          signal ? AbortSignal.any([signal, stop.signal]) : stop.signal,\n        );\n        active.add(pending);\n        void pending.then(\n          () => active.delete(pending),\n          () => active.delete(pending),\n        );\n        return pending;\n      };\n      return {\n        root,\n        home: options.home,\n        invoke: (command) =>\n          track((signal) => invoke({ ...command, signal }), command.signal),\n        upload: (source, destination, options = {}) =>\n          track(\n            (signal) =>\n              files.upload(source, destination, { ...options, signal }),\n            options.signal,\n          ),\n        download: (source, destination, options = {}) =>\n          track(\n            (signal) =>\n              files.download(source, destination, { ...options, signal }),\n            options.signal,\n          ),\n        release,\n      };\n    },\n  };\n}\n"]}

package/dist/providers/local.d.ts

@@ -1,3 +1,3 @@
 import type { SandboxProvider } from "../domain/sandbox.types.ts";
 import type { LocalOptions } from "./local.types.ts";
-export declare function local(options?: LocalOptions): SandboxProvider;
+export declare function localSandboxProvider(options?: LocalOptions): SandboxProvider;