@elie-laloum/outpost 4.1.0 → 4.2.0

package/dist/application/transport-inspection.js

@@ -0,0 +1,103 @@
+import { transportDefaults } from "../infrastructure/transport.constants.js";
+import { resourceRecord } from "../infrastructure/resource-activity-inspection.js";
+import { jsonObject } from "../infrastructure/transport-json.js";
+import { invariant, positive } from "../domain/errors.js";
+import { transportCategories } from "./transport-inspection.constants.js";
+export async function inspectTransportRecovery(options) {
+    const transporter = options.transporter;
+    invariant(transporter, "Transport is required");
+    invariant(!options.git && !options.locks, "Transport inspection cannot verify host Git or process locks");
+    const maxEntries = positive(options.maxEntries ?? transportDefaults.maxEntries, "maxEntries");
+    const buckets = transportCategories.map((name) => ({
+        name,
+        path: name,
+        entries: [],
+    }));
+    const categories = buckets;
+    const usage = {
+        bytes: 0,
+        files: 0,
+        directories: 0,
+        symlinks: 0,
+        other: 0,
+    };
+    const issues = [];
+    const resources = [];
+    let scannedEntries = 0, complete = true;
+    for await (const entry of transporter.list()) {
+        if (scannedEntries >= maxEntries) {
+            complete = false;
+            issues.push({ path: "", code: "ENTRY_LIMIT" });
+            break;
+        }
+        scannedEntries++;
+        const name = entry.key.split("/")[0];
+        const category = buckets.find((category) => category.name === name);
+        if (!category) {
+            complete = false;
+            issues.push({ path: entry.key, code: "UNKNOWN_TRANSPORT_CATEGORY" });
+            continue;
+        }
+        const stored = {
+            name: entry.key,
+            path: entry.key,
+            kind: "file",
+            modifiedAt: entry.modifiedAt,
+            complete: true,
+            bytes: entry.size,
+            files: 1,
+            directories: 0,
+            symlinks: 0,
+            other: 0,
+            revision: entry.revision,
+        };
+        category.entries.push(stored);
+        usage.bytes += entry.size;
+        usage.files++;
+        if (options.resources && name === "resources") {
+            try {
+                const object = await transporter.read(entry.key);
+                invariant(object?.revision === entry.revision, "Resource changed during inspection");
+                const record = resourceRecord(jsonObject(object));
+                resources.push({
+                    path: entry.key,
+                    record,
+                    ownership: { status: "unknown", reason: "REMOTE_OWNER_UNVERIFIED" },
+                });
+            }
+            catch {
+                issues.push({ path: entry.key, code: "RESOURCE_RECORD_UNREADABLE" });
+                complete = false;
+                resources.push({
+                    path: entry.key,
+                    ownership: {
+                        status: "unknown",
+                        reason: "RESOURCE_RECORD_UNREADABLE",
+                    },
+                });
+            }
+        }
+    }
+    return {
+        repository: options.repository ?? "",
+        root: "transport",
+        activity: "unverified",
+        categories,
+        usage,
+        issues,
+        complete,
+        scannedEntries,
+        maxEntries,
+        ...(options.resources
+            ? {
+                resources: {
+                    scope: "recorded-sandboxes",
+                    complete,
+                    entries: resources,
+                    issues,
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=transport-inspection.js.map

package/dist/application/transport-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-inspection.js","sourceRoot":"","sources":["../../src/application/transport-inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportDefaults } from \"../infrastructure/transport.constants.ts\";\nimport type {\n  RecoveryInspection,\n  RecoveryInspectionOptions,\n} from \"./recovery-inspection.types.ts\";\nimport type {\n  StorageCategory,\n  StorageEntry,\n  StorageUsage,\n} from \"../infrastructure/storage-inventory.types.ts\";\nimport type { ResourceInspectionEntry } from \"../infrastructure/resource-activity.types.ts\";\nimport { resourceRecord } from \"../infrastructure/resource-activity-inspection.ts\";\nimport { jsonObject } from \"../infrastructure/transport-json.ts\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { transportCategories } from \"./transport-inspection.constants.ts\";\n\nexport async function inspectTransportRecovery(\n  options: RecoveryInspectionOptions,\n): Promise<RecoveryInspection> {\n  const transporter = options.transporter;\n  invariant(transporter, \"Transport is required\");\n  invariant(\n    !options.git && !options.locks,\n    \"Transport inspection cannot verify host Git or process locks\",\n  );\n  const maxEntries = positive(\n    options.maxEntries ?? transportDefaults.maxEntries,\n    \"maxEntries\",\n  );\n  const buckets = transportCategories.map((name) => ({\n    name,\n    path: name,\n    entries: [] as StorageEntry[],\n  }));\n  const categories: StorageCategory[] = buckets;\n  const usage: StorageUsage = {\n    bytes: 0,\n    files: 0,\n    directories: 0,\n    symlinks: 0,\n    other: 0,\n  };\n  const issues = [];\n  const resources: ResourceInspectionEntry[] = [];\n  let scannedEntries = 0,\n    complete = true;\n  for await (const entry of transporter.list()) {\n    if (scannedEntries >= maxEntries) {\n      complete = false;\n      issues.push({ path: \"\", code: \"ENTRY_LIMIT\" });\n      break;\n    }\n    scannedEntries++;\n    const name = entry.key.split(\"/\")[0];\n    const category = buckets.find((category) => category.name === name);\n    if (!category) {\n      complete = false;\n      issues.push({ path: entry.key, code: \"UNKNOWN_TRANSPORT_CATEGORY\" });\n      continue;\n    }\n    const stored = {\n      name: entry.key,\n      path: entry.key,\n      kind: \"file\" as const,\n      modifiedAt: entry.modifiedAt,\n      complete: true,\n      bytes: entry.size,\n      files: 1,\n      directories: 0,\n      symlinks: 0,\n      other: 0,\n      revision: entry.revision,\n    };\n    category.entries.push(stored);\n    usage.bytes += entry.size;\n    usage.files++;\n    if (options.resources && name === \"resources\") {\n      try {\n        const object = await transporter.read(entry.key);\n        invariant(\n          object?.revision === entry.revision,\n          \"Resource changed during inspection\",\n        );\n        const record = resourceRecord(jsonObject(object));\n        resources.push({\n          path: entry.key,\n          record,\n          ownership: { status: \"unknown\", reason: \"REMOTE_OWNER_UNVERIFIED\" },\n        });\n      } catch {\n        issues.push({ path: entry.key, code: \"RESOURCE_RECORD_UNREADABLE\" });\n        complete = false;\n        resources.push({\n          path: entry.key,\n          ownership: {\n            status: \"unknown\",\n            reason: \"RESOURCE_RECORD_UNREADABLE\",\n          },\n        });\n      }\n    }\n  }\n  return {\n    repository: options.repository ?? \"\",\n    root: \"transport\",\n    activity: \"unverified\",\n    categories,\n    usage,\n    issues,\n    complete,\n    scannedEntries,\n    maxEntries,\n    ...(options.resources\n      ? {\n          resources: {\n            scope: \"recorded-sandboxes\",\n            complete,\n            entries: resources,\n            issues,\n          },\n        }\n      : {}),\n  };\n}\n"]}

package/dist/application/transport-retention.d.ts

@@ -0,0 +1,4 @@
+import type { TransportStoreOptions } from "../domain/transport.types.ts";
+import type { RecoveryRetentionOptions, RecoveryRetentionPlan, RecoveryPruneResult } from "./recovery-retention.types.ts";
+export declare function planTransportRetention(options: RecoveryRetentionOptions): Promise<RecoveryRetentionPlan>;
+export declare function pruneTransportRetention(plan: RecoveryRetentionPlan, options: TransportStoreOptions): Promise<RecoveryPruneResult>;

package/dist/application/transport-retention.js

@@ -0,0 +1,153 @@
+import { invariant } from "../domain/errors.js";
+import { inspectTransportRecovery } from "./transport-inspection.js";
+import { journalSnapshot } from "../infrastructure/transport-journal.js";
+import { jsonObject } from "../infrastructure/transport-json.js";
+import { retentionPolicy } from "./recovery-retention-policy.js";
+export async function planTransportRetention(options) {
+    const transporter = options.transporter;
+    invariant(transporter, "Transport is required");
+    retentionPolicy(options.policy);
+    invariant(!options.policy.scopes.includes("clean-workspaces") &&
+        options.policy.maxWorkspaces === undefined, "Transport retention cannot inspect local workspaces");
+    const inspection = await inspectTransportRecovery(options);
+    const inspectedAt = new Date().toISOString();
+    const entries = [];
+    const handled = new Set();
+    for (const category of inspection.categories) {
+        for (const entry of category.entries) {
+            if (handled.has(entry.path))
+                continue;
+            let eligible = false, reason = "RECOVERY_DATA_PROTECTED";
+            let objects = [];
+            if (category.name === "logs") {
+                const prefix = entry.path.slice(0, entry.path.lastIndexOf("/") + 1);
+                const group = category.entries.filter((value) => value.path.startsWith(prefix));
+                objects = group.map((value) => {
+                    invariant(value.revision && value.modifiedAt, "Missing transport entry version");
+                    return {
+                        key: value.path,
+                        revision: value.revision,
+                        size: value.bytes,
+                        modifiedAt: value.modifiedAt,
+                    };
+                });
+                for (const object of objects)
+                    handled.add(object.key);
+                const index = group.find((value) => value.path === prefix + "index");
+                reason = "LOG_ACTIVITY_OR_CONTENT_UNKNOWN";
+                if (index && options.policy.scopes.includes("closed-logs")) {
+                    try {
+                        const current = await transporter.read(index.path);
+                        if (current?.revision === index.revision &&
+                            journalSnapshot(jsonObject(current)).closed) {
+                            eligible =
+                                inspection.complete &&
+                                    objects.every((value) => Date.parse(inspectedAt) - Date.parse(value.modifiedAt) >=
+                                        options.policy.minAgeMs);
+                            reason = eligible
+                                ? "ELIGIBLE"
+                                : "RETENTION_AGE_OR_INCOMPLETE_INVENTORY";
+                        }
+                    }
+                    catch {
+                        reason = "LOG_ACTIVITY_OR_CONTENT_UNKNOWN";
+                    }
+                }
+                const indexObject = objects.find((value) => value.key === prefix + "index");
+                entries.push({
+                    path: prefix + "index",
+                    category: category.name,
+                    bytes: objects.reduce((sum, value) => sum + value.size, 0),
+                    eligible,
+                    reason,
+                    objects,
+                    ...(indexObject
+                        ? {
+                            revision: indexObject.revision,
+                            modifiedAt: indexObject.modifiedAt,
+                        }
+                        : {}),
+                });
+                continue;
+            }
+            entries.push({
+                path: entry.path,
+                category: category.name,
+                bytes: entry.bytes,
+                eligible,
+                reason,
+                ...(entry.revision ? { revision: entry.revision } : {}),
+                ...(entry.modifiedAt ? { modifiedAt: entry.modifiedAt } : {}),
+            });
+        }
+    }
+    const projectedBytes = inspection.usage.bytes -
+        entries
+            .filter((entry) => entry.eligible)
+            .reduce((sum, entry) => sum + entry.bytes, 0);
+    return {
+        repository: inspection.repository,
+        source: "transport",
+        policy: structuredClone(options.policy),
+        inspectedAt,
+        inspection,
+        entries,
+        complete: inspection.complete,
+        usageBytes: inspection.usage.bytes,
+        projectedBytes,
+        quota: !inspection.complete
+            ? "unknown"
+            : options.policy.maxBytes !== undefined &&
+                projectedBytes > options.policy.maxBytes
+                ? "exceeded"
+                : "within",
+    };
+}
+export async function pruneTransportRetention(plan, options) {
+    invariant(plan.complete, "Cannot prune an incomplete retention plan");
+    retentionPolicy(plan.policy);
+    const removed = [], retained = [];
+    for (const candidate of plan.entries.filter((entry) => entry.eligible)) {
+        const fresh = await planTransportRetention({
+            transporter: options.transporter,
+            policy: plan.policy,
+            repository: plan.repository,
+        });
+        const entry = fresh.entries.find((entry) => entry.path === candidate.path);
+        if (!entry?.eligible ||
+            entry.revision !== candidate.revision ||
+            JSON.stringify(entry.objects) !== JSON.stringify(candidate.objects)) {
+            retained.push({ path: candidate.path, reason: "PLAN_CHANGED" });
+            continue;
+        }
+        try {
+            invariant(entry.revision && entry.objects, "Missing log revisions");
+            await options.transporter.remove(entry.path, {
+                ifRevision: entry.revision,
+            });
+            for (const object of entry.objects) {
+                if (object.key !== entry.path)
+                    await options.transporter.remove(object.key, {
+                        ifRevision: object.revision,
+                    });
+            }
+            removed.push(entry.path);
+        }
+        catch {
+            retained.push({
+                path: entry.path,
+                reason: "REVALIDATION_OR_REMOVAL_FAILED",
+            });
+        }
+    }
+    return {
+        removed,
+        retained,
+        after: await planTransportRetention({
+            transporter: options.transporter,
+            policy: plan.policy,
+            repository: plan.repository,
+        }),
+    };
+}
+//# sourceMappingURL=transport-retention.js.map

package/dist/application/transport-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-retention.js","sourceRoot":"","sources":["../../src/application/transport-retention.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"../domain/errors.ts\";\nimport type {\n  TransportStoreOptions,\n  TransportEntry,\n} from \"../domain/transport.types.ts\";\nimport type {\n  RecoveryRetentionOptions,\n  RecoveryRetentionPlan,\n  RecoveryRetentionEntry,\n  RecoveryPruneResult,\n} from \"./recovery-retention.types.ts\";\nimport { inspectTransportRecovery } from \"./transport-inspection.ts\";\nimport { journalSnapshot } from \"../infrastructure/transport-journal.ts\";\nimport { jsonObject } from \"../infrastructure/transport-json.ts\";\nimport { retentionPolicy } from \"./recovery-retention-policy.ts\";\n\nexport async function planTransportRetention(\n  options: RecoveryRetentionOptions,\n): Promise<RecoveryRetentionPlan> {\n  const transporter = options.transporter;\n  invariant(transporter, \"Transport is required\");\n  retentionPolicy(options.policy);\n  invariant(\n    !options.policy.scopes.includes(\"clean-workspaces\") &&\n      options.policy.maxWorkspaces === undefined,\n    \"Transport retention cannot inspect local workspaces\",\n  );\n  const inspection = await inspectTransportRecovery(options);\n  const inspectedAt = new Date().toISOString();\n  const entries: RecoveryRetentionEntry[] = [];\n  const handled = new Set<string>();\n  for (const category of inspection.categories) {\n    for (const entry of category.entries) {\n      if (handled.has(entry.path)) continue;\n      let eligible = false,\n        reason = \"RECOVERY_DATA_PROTECTED\";\n      let objects: TransportEntry[] = [];\n      if (category.name === \"logs\") {\n        const prefix = entry.path.slice(0, entry.path.lastIndexOf(\"/\") + 1);\n        const group = category.entries.filter((value) =>\n          value.path.startsWith(prefix),\n        );\n        objects = group.map((value) => {\n          invariant(\n            value.revision && value.modifiedAt,\n            \"Missing transport entry version\",\n          );\n          return {\n            key: value.path,\n            revision: value.revision,\n            size: value.bytes,\n            modifiedAt: value.modifiedAt,\n          };\n        });\n        for (const object of objects) handled.add(object.key);\n        const index = group.find((value) => value.path === prefix + \"index\");\n        reason = \"LOG_ACTIVITY_OR_CONTENT_UNKNOWN\";\n        if (index && options.policy.scopes.includes(\"closed-logs\")) {\n          try {\n            const current = await transporter.read(index.path);\n            if (\n              current?.revision === index.revision &&\n              journalSnapshot(jsonObject(current)).closed\n            ) {\n              eligible =\n                inspection.complete &&\n                objects.every(\n                  (value) =>\n                    Date.parse(inspectedAt) - Date.parse(value.modifiedAt) >=\n                    options.policy.minAgeMs,\n                );\n              reason = eligible\n                ? \"ELIGIBLE\"\n                : \"RETENTION_AGE_OR_INCOMPLETE_INVENTORY\";\n            }\n          } catch {\n            reason = \"LOG_ACTIVITY_OR_CONTENT_UNKNOWN\";\n          }\n        }\n        const indexObject = objects.find(\n          (value) => value.key === prefix + \"index\",\n        );\n        entries.push({\n          path: prefix + \"index\",\n          category: category.name,\n          bytes: objects.reduce((sum, value) => sum + value.size, 0),\n          eligible,\n          reason,\n          objects,\n          ...(indexObject\n            ? {\n                revision: indexObject.revision,\n                modifiedAt: indexObject.modifiedAt,\n              }\n            : {}),\n        });\n        continue;\n      }\n      entries.push({\n        path: entry.path,\n        category: category.name,\n        bytes: entry.bytes,\n        eligible,\n        reason,\n        ...(entry.revision ? { revision: entry.revision } : {}),\n        ...(entry.modifiedAt ? { modifiedAt: entry.modifiedAt } : {}),\n      });\n    }\n  }\n  const projectedBytes =\n    inspection.usage.bytes -\n    entries\n      .filter((entry) => entry.eligible)\n      .reduce((sum, entry) => sum + entry.bytes, 0);\n  return {\n    repository: inspection.repository,\n    source: \"transport\",\n    policy: structuredClone(options.policy),\n    inspectedAt,\n    inspection,\n    entries,\n    complete: inspection.complete,\n    usageBytes: inspection.usage.bytes,\n    projectedBytes,\n    quota: !inspection.complete\n      ? \"unknown\"\n      : options.policy.maxBytes !== undefined &&\n          projectedBytes > options.policy.maxBytes\n        ? \"exceeded\"\n        : \"within\",\n  };\n}\n\nexport async function pruneTransportRetention(\n  plan: RecoveryRetentionPlan,\n  options: TransportStoreOptions,\n): Promise<RecoveryPruneResult> {\n  invariant(plan.complete, \"Cannot prune an incomplete retention plan\");\n  retentionPolicy(plan.policy);\n  const removed: string[] = [],\n    retained = [];\n  for (const candidate of plan.entries.filter((entry) => entry.eligible)) {\n    const fresh = await planTransportRetention({\n      transporter: options.transporter,\n      policy: plan.policy,\n      repository: plan.repository,\n    });\n    const entry = fresh.entries.find((entry) => entry.path === candidate.path);\n    if (\n      !entry?.eligible ||\n      entry.revision !== candidate.revision ||\n      JSON.stringify(entry.objects) !== JSON.stringify(candidate.objects)\n    ) {\n      retained.push({ path: candidate.path, reason: \"PLAN_CHANGED\" });\n      continue;\n    }\n    try {\n      invariant(entry.revision && entry.objects, \"Missing log revisions\");\n      await options.transporter.remove(entry.path, {\n        ifRevision: entry.revision,\n      });\n      for (const object of entry.objects) {\n        if (object.key !== entry.path)\n          await options.transporter.remove(object.key, {\n            ifRevision: object.revision,\n          });\n      }\n      removed.push(entry.path);\n    } catch {\n      retained.push({\n        path: entry.path,\n        reason: \"REVALIDATION_OR_REMOVAL_FAILED\",\n      });\n    }\n  }\n  return {\n    removed,\n    retained,\n    after: await planTransportRetention({\n      transporter: options.transporter,\n      policy: plan.policy,\n      repository: plan.repository,\n    }),\n  };\n}\n"]}

package/dist/domain/conversation.types.d.ts

@@ -1,7 +1,9 @@
+import type { TransportReference } from "./transport.types.ts";
 import type { SandboxLease } from "./sandbox.types.ts";
 export interface ConversationRecord {
     readonly id: string;
     readonly file: string;
+    readonly reference?: TransportReference;
     readonly format: string;
 }
 export interface ConversationContext {

package/dist/domain/conversation.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.types.js","sourceRoot":"","sources":["../../src/domain/conversation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { SandboxLease } from \"./sandbox.types.ts\";\n\nexport interface ConversationRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly format: string;\n}\n\nexport interface ConversationContext {\n  readonly repository: string;\n  readonly sandbox: SandboxLease;\n  readonly staging: string;\n  readonly home?: string;\n  readonly local?: boolean;\n  readonly warn?: (message: string) => void;\n}\n\nexport interface ConversationStore {\n  readonly name: string;\n  locate(\n    id: string,\n    repository: string,\n    home?: string,\n  ): Promise<ConversationRecord>;\n  capture(\n    id: string,\n    context: ConversationContext,\n  ): Promise<ConversationRecord>;\n  restore(\n    record: ConversationRecord,\n    context: ConversationContext,\n  ): Promise<void>;\n}\n"]}
+{"version":3,"file":"conversation.types.js","sourceRoot":"","sources":["../../src/domain/conversation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TransportReference } from \"./transport.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\n\nexport interface ConversationRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly reference?: TransportReference;\n  readonly format: string;\n}\n\nexport interface ConversationContext {\n  readonly repository: string;\n  readonly sandbox: SandboxLease;\n  readonly staging: string;\n  readonly home?: string;\n  readonly local?: boolean;\n  readonly warn?: (message: string) => void;\n}\n\nexport interface ConversationStore {\n  readonly name: string;\n  locate(\n    id: string,\n    repository: string,\n    home?: string,\n  ): Promise<ConversationRecord>;\n  capture(\n    id: string,\n    context: ConversationContext,\n  ): Promise<ConversationRecord>;\n  restore(\n    record: ConversationRecord,\n    context: ConversationContext,\n  ): Promise<void>;\n}\n"]}

package/dist/domain/model.types.d.ts

@@ -0,0 +1,15 @@
+import type { Usage } from "./agent.types.ts";
+export interface ModelRequest {
+    readonly prompt: string;
+    readonly system?: string;
+    readonly maxOutputTokens?: number;
+    readonly signal?: AbortSignal;
+}
+export interface ModelResult {
+    readonly text: string;
+    readonly usage?: Usage;
+}
+export interface ModelProvider {
+    readonly name: string;
+    generate(request: ModelRequest): Promise<ModelResult>;
+}

package/dist/domain/model.types.js

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

package/dist/domain/model.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.types.js","sourceRoot":"","sources":["../../src/domain/model.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\n\nexport interface ModelRequest {\n  readonly prompt: string;\n  readonly system?: string;\n  readonly maxOutputTokens?: number;\n  readonly signal?: AbortSignal;\n}\n\nexport interface ModelResult {\n  readonly text: string;\n  readonly usage?: Usage;\n}\n\nexport interface ModelProvider {\n  readonly name: string;\n  generate(request: ModelRequest): Promise<ModelResult>;\n}\n"]}

package/dist/domain/transport.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const transportKeyMaxLength = 512;
+export declare const transportSegmentPattern: RegExp;

package/dist/domain/transport.constants.js

@@ -0,0 +1,3 @@
+export const transportKeyMaxLength = 512;
+export const transportSegmentPattern = /^[A-Za-z0-9_-][A-Za-z0-9_.-]*$/;
+//# sourceMappingURL=transport.constants.js.map

package/dist/domain/transport.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.constants.js","sourceRoot":"","sources":["../../src/domain/transport.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC","sourcesContent":["export const transportKeyMaxLength = 512;\nexport const transportSegmentPattern = /^[A-Za-z0-9_-][A-Za-z0-9_.-]*$/;\n"]}

package/dist/domain/transport.d.ts

@@ -0,0 +1,6 @@
+export declare class TransportConflict extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+export declare function transportKey(key: string): string;
+export declare function transportCondition(value: unknown): asserts value is string | null;

package/dist/domain/transport.js

@@ -0,0 +1,21 @@
+import { transportKeyMaxLength, transportSegmentPattern, } from "./transport.constants.js";
+export class TransportConflict extends Error {
+    key;
+    constructor(key) {
+        super(`Transport revision conflict: ${key}`);
+        this.name = "TransportConflict";
+        this.key = key;
+    }
+}
+export function transportKey(key) {
+    if (!key ||
+        key.length > transportKeyMaxLength ||
+        key.split("/").some((part) => !transportSegmentPattern.test(part)))
+        throw new Error("Invalid transport key");
+    return key;
+}
+export function transportCondition(value) {
+    if (value !== null && (typeof value !== "string" || !value.trim()))
+        throw new Error("A transport mutation requires an explicit revision condition");
+}
+//# sourceMappingURL=transport.js.map

package/dist/domain/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/domain/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,GAAG,CAAS;IACrB,YAAY,GAAW;QACrB,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IACE,CAAC,GAAG;QACJ,GAAG,CAAC,MAAM,GAAG,qBAAqB;QAClC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;AACN,CAAC","sourcesContent":["import {\n  transportKeyMaxLength,\n  transportSegmentPattern,\n} from \"./transport.constants.ts\";\n\nexport class TransportConflict extends Error {\n  readonly key: string;\n  constructor(key: string) {\n    super(`Transport revision conflict: ${key}`);\n    this.name = \"TransportConflict\";\n    this.key = key;\n  }\n}\n\nexport function transportKey(key: string): string {\n  if (\n    !key ||\n    key.length > transportKeyMaxLength ||\n    key.split(\"/\").some((part) => !transportSegmentPattern.test(part))\n  )\n    throw new Error(\"Invalid transport key\");\n  return key;\n}\n\nexport function transportCondition(\n  value: unknown,\n): asserts value is string | null {\n  if (value !== null && (typeof value !== \"string\" || !value.trim()))\n    throw new Error(\n      \"A transport mutation requires an explicit revision condition\",\n    );\n}\n"]}

package/dist/domain/transport.types.d.ts

@@ -0,0 +1,31 @@
+export interface TransportReadOptions {
+    readonly signal?: AbortSignal;
+    readonly maxBytes?: number;
+}
+export interface TransportWriteOptions {
+    readonly signal?: AbortSignal;
+    readonly ifRevision: string | null;
+}
+export interface TransportEntry {
+    readonly key: string;
+    readonly revision: string;
+    readonly size: number;
+    readonly modifiedAt: string;
+}
+export interface TransportObject extends TransportEntry {
+    readonly bytes: Uint8Array;
+}
+export interface Transport {
+    readonly name: string;
+    read(key: string, options?: TransportReadOptions): Promise<TransportObject | undefined>;
+    write(key: string, bytes: Uint8Array, options: TransportWriteOptions): Promise<TransportEntry>;
+    remove(key: string, options: TransportWriteOptions): Promise<void>;
+    list(prefix?: string, options?: TransportReadOptions): AsyncIterable<TransportEntry>;
+}
+export interface TransportStoreOptions {
+    readonly transporter: Transport;
+}
+export interface TransportReference {
+    readonly key: string;
+    readonly revision: string;
+}

package/dist/domain/transport.types.js

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

package/dist/domain/transport.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.types.js","sourceRoot":"","sources":["../../src/domain/transport.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface TransportReadOptions {\n  readonly signal?: AbortSignal;\n  readonly maxBytes?: number;\n}\n\nexport interface TransportWriteOptions {\n  readonly signal?: AbortSignal;\n  readonly ifRevision: string | null;\n}\n\nexport interface TransportEntry {\n  readonly key: string;\n  readonly revision: string;\n  readonly size: number;\n  readonly modifiedAt: string;\n}\n\nexport interface TransportObject extends TransportEntry {\n  readonly bytes: Uint8Array;\n}\n\nexport interface Transport {\n  readonly name: string;\n  read(\n    key: string,\n    options?: TransportReadOptions,\n  ): Promise<TransportObject | undefined>;\n  write(\n    key: string,\n    bytes: Uint8Array,\n    options: TransportWriteOptions,\n  ): Promise<TransportEntry>;\n  remove(key: string, options: TransportWriteOptions): Promise<void>;\n  list(\n    prefix?: string,\n    options?: TransportReadOptions,\n  ): AsyncIterable<TransportEntry>;\n}\n\nexport interface TransportStoreOptions {\n  readonly transporter: Transport;\n}\n\nexport interface TransportReference {\n  readonly key: string;\n  readonly revision: string;\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,17 @@
+export { TransportConflict } from "./domain/transport.ts";
+export type { Transport, TransportEntry, TransportObject, TransportReadOptions, TransportWriteOptions, TransportReference, TransportStoreOptions, } from "./domain/transport.types.ts";
+export { localTransport } from "./infrastructure/local-transport.ts";
+export type { LocalTransportOptions } from "./infrastructure/local-transport.types.ts";
+export { artifactStore } from "./infrastructure/transport-artifact-store.ts";
+export type { ArtifactStoreOptions } from "./infrastructure/transport-artifact-store.types.ts";
+export { workflowCheckpointStore, recoverWorkflowCheckpoint, } from "./infrastructure/transport-checkpoint.ts";
+export type { CheckpointRecoveryOptions } from "./infrastructure/transport-checkpoint.types.ts";
+export { readJournal } from "./infrastructure/transport-journal.ts";
+export type { ReadJournalOptions } from "./infrastructure/transport-journal.types.ts";
+export { transportConversations } from "./infrastructure/transport-conversations.ts";
+export type { TransportConversationOptions } from "./infrastructure/transport-conversations.types.ts";
+export { archiveRecovery, materializeRecoveryArchive, } from "./application/recovery-archive.ts";
+export type { RecoveryArchiveOptions, RecoveryArchiveRestoreOptions, } from "./application/recovery-archive.types.ts";
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.ts";
 export type { AttachOptions, AttachResult, ContinuationOptions, DispatchResult, Sandbox, SandboxOptions, WarmDispatchResult, Workspace, WorkspaceOptions, } from "./application/outpost.ts";
 export type { DispatchOptions, Execution, Turn, } from "./application/execution.ts";
@@ -59,3 +73,6 @@ export type { QueuedTaskOptions } from "./application/queued-task.types.ts";
 export type { EgressPolicy } from "./domain/egress.types.ts";
 export { speculate } from "./application/speculation.ts";
 export type { SpeculationOptions, SpeculationResult, SpeculativeCandidate, SpeculativeCandidateResult, SpeculativeOutput, SpeculativeHostSnapshot, SpeculativeValidation, } from "./application/speculation.types.ts";
+export { openaiCompatible } from "./adapters/models/openai-compatible.ts";
+export type { OpenAICompatibleOptions } from "./adapters/models/openai-compatible.types.ts";
+export type { ModelProvider, ModelRequest, ModelResult, } from "./domain/model.types.ts";

package/dist/index.js

@@ -1,3 +1,10 @@
+export { TransportConflict } from "./domain/transport.js";
+export { localTransport } from "./infrastructure/local-transport.js";
+export { artifactStore } from "./infrastructure/transport-artifact-store.js";
+export { workflowCheckpointStore, recoverWorkflowCheckpoint, } from "./infrastructure/transport-checkpoint.js";
+export { readJournal } from "./infrastructure/transport-journal.js";
+export { transportConversations } from "./infrastructure/transport-conversations.js";
+export { archiveRecovery, materializeRecoveryArchive, } from "./application/recovery-archive.js";
 export { attach, createSandbox, dispatch, openWorkspace, } from "./application/outpost.js";
 export { WorkflowFailure, WorkflowBudgetExceeded, task, workflow, } from "./domain/workflow.js";
 export { agentTask, commandTask, isolatedTask } from "./application/tasks.js";
@@ -25,4 +32,5 @@ export { serveTaskQueue, httpTaskQueue, } from "./infrastructure/task-queue-http
 export { runQueueWorker } from "./application/queue-worker.js";
 export { queuedTask } from "./application/queued-task.js";
 export { speculate } from "./application/speculation.js";
+export { openaiCompatible } from "./adapters/models/openai-compatible.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,aAAa,EACb,QAAQ,EACR,aAAa,GACd,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,IAAI,EACJ,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAiB9B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAclE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoCnE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAMxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAS7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAMhF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAWlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAO9E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAWtF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAevE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAevE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAwB1D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC","sourcesContent":["export {\n  attach,\n  createSandbox,\n  dispatch,\n  openWorkspace,\n} from \"./application/outpost.ts\";\n\nexport type {\n  AttachOptions,\n  AttachResult,\n  ContinuationOptions,\n  DispatchResult,\n  Sandbox,\n  SandboxOptions,\n  WarmDispatchResult,\n  Workspace,\n  WorkspaceOptions,\n} from \"./application/outpost.ts\";\n\nexport type {\n  DispatchOptions,\n  Execution,\n  Turn,\n} from \"./application/execution.ts\";\n\nexport {\n  WorkflowFailure,\n  WorkflowBudgetExceeded,\n  task,\n  workflow,\n} from \"./domain/workflow.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowBudget,\n  WorkflowUsage,\n  WorkflowResult,\n} from \"./domain/workflow.ts\";\n\nexport { agentTask, commandTask, isolatedTask } from \"./application/tasks.ts\";\n\nexport { claude, codex, gemini } from \"./providers/agents.ts\";\n\nexport { agentVersions } from \"./providers/versions.ts\";\n\nexport { conversations } from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ClaudeSettings,\n  CodexSettings,\n  CodexModelProvider,\n  GeminiSettings,\n} from \"./providers/agents.ts\";\n\nexport { mountedProvider, remoteProvider } from \"./providers/factories.ts\";\n\nexport { ResponseError, response } from \"./domain/response.ts\";\n\nexport type { ResponseSpec, StandardValidator } from \"./domain/response.ts\";\n\nexport { OutpostError, recoveryDetails } from \"./domain/errors.ts\";\n\nexport type { FaultCode } from \"./domain/errors.ts\";\n\nexport type {\n  AgentAdapter,\n  AgentEvent,\n  AgentInput,\n  AgentObservation,\n  BranchPolicy,\n  Channel,\n  Command,\n  CommandResult,\n  Commit,\n  ConversationContext,\n  ConversationRecord,\n  ConversationStore,\n  Disposal,\n  LifecycleHooks,\n  FileManifestEntry,\n  FileTransfers,\n  SandboxContext,\n  SandboxLease,\n  SandboxProvider,\n  StageLimits,\n  TransferOptions,\n  Usage,\n  Variables,\n  Volume,\n  WorkspaceRecord,\n} from \"./domain/ports.ts\";\n\nexport type { Brief, PromptVariables } from \"./domain/prompts.ts\";\n\nexport type { Logging } from \"./infrastructure/journal.ts\";\n\nexport { reporter } from \"./infrastructure/reporter.ts\";\n\nexport type { ReporterOptions } from \"./infrastructure/reporter.ts\";\n\nexport type { VariableQuestion } from \"./application/interactive-brief.ts\";\n\nexport {\n  planRecoveryRetention,\n  pruneRecoveryRetention,\n  assertRecoveryQuota,\n} from \"./application/recovery-retention.ts\";\nexport type {\n  RecoveryRetentionPolicy,\n  RecoveryRetentionOptions,\n  RecoveryRetentionPlan,\n  RecoveryRetentionEntry,\n  RecoveryPruneResult,\n  RecoveryQuotaOptions,\n} from \"./application/recovery-retention.types.ts\";\nexport { verifyRecoveryTransfer } from \"./application/recovery-verification.ts\";\nexport type {\n  RecoveryVerification,\n  RecoveryVerificationOptions,\n} from \"./application/recovery-verification.types.ts\";\n\nexport { diagnoseSandbox } from \"./application/doctor-sandbox.ts\";\nexport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n  DiagnosticCapability,\n} from \"./application/doctor-sandbox.types.ts\";\nexport type {\n  DiagnosticCheck,\n  DiagnosticStatus,\n  DoctorAgent,\n} from \"./application/doctor.types.ts\";\nexport { diagnoseAgentProtocol } from \"./application/doctor-protocol.ts\";\nexport type { AgentProtocolReport } from \"./application/doctor-protocol.types.ts\";\n\nexport { reserveRecoveryStorage } from \"./application/storage-reservation.ts\";\nexport type { RecoveryStorageReservationOptions } from \"./application/storage-reservation.types.ts\";\nexport type {\n  StorageReservation,\n  StorageReservationOptions,\n} from \"./infrastructure/storage-reservations.types.ts\";\n\nexport {\n  planRecoveryRestore,\n  restoreRecoveryTransfer,\n} from \"./application/recovery-restore.ts\";\nexport type {\n  RecoveryRestoreOptions,\n  RecoveryRestorePlan,\n  RecoveryRestoreResult,\n} from \"./application/recovery-restore.types.ts\";\n\nexport { fileWorkflowCheckpointStore } from \"./infrastructure/workflow-checkpoint.ts\";\nexport type { FileWorkflowCheckpointOptions } from \"./infrastructure/workflow-checkpoint.types.ts\";\nexport type {\n  WorkflowCheckpoint,\n  WorkflowCheckpointOptions,\n  WorkflowCheckpointStore,\n  WorkflowCheckpointLease,\n  WorkflowCheckpointValue,\n  WorkflowJson,\n} from \"./domain/workflow/checkpoint.types.ts\";\n\nexport { approvalTask, pauseTask } from \"./domain/workflow/gates.ts\";\nexport type {\n  WorkflowGate,\n  WorkflowGateOptions,\n  WorkflowPauseRequest,\n  WorkflowDecision,\n  WorkflowDecisionRecord,\n} from \"./domain/workflow/gates.types.ts\";\n\nexport { inspectRecovery } from \"./application/recovery-inspection.ts\";\nexport type {\n  RecoveryInspection,\n  RecoveryInspectionOptions,\n} from \"./application/recovery-inspection.types.ts\";\nexport type {\n  ResourceActivityRecord,\n  ResourceInspection,\n  ResourceInspectionEntry,\n  ResourceOperation,\n  ResourceOperationKind,\n  ResourceOperationResult,\n  ResourcePhase,\n} from \"./infrastructure/resource-activity.types.ts\";\n\nexport {\n  artifact,\n  publishArtifact,\n  readStoredArtifact,\n} from \"./domain/artifact.ts\";\nexport { artifactTask, readArtifact } from \"./application/artifact-tasks.ts\";\nexport { fileArtifactStore } from \"./infrastructure/artifact-store.ts\";\nexport type {\n  ArtifactContract,\n  ArtifactContractOptions,\n  ArtifactIdentity,\n  ArtifactProducer,\n  ArtifactReference,\n  ArtifactStore,\n  JsonArtifactOptions,\n  PublishArtifactOptions,\n  ReadArtifactOptions,\n} from \"./domain/artifact.types.ts\";\nexport type { ArtifactTaskOptions } from \"./application/artifact-tasks.types.ts\";\nexport type { FileArtifactStoreOptions } from \"./infrastructure/artifact-store.types.ts\";\n\nexport { sqliteTaskQueue } from \"./infrastructure/task-queue.ts\";\nexport {\n  serveTaskQueue,\n  httpTaskQueue,\n} from \"./infrastructure/task-queue-http.ts\";\nexport { runQueueWorker } from \"./application/queue-worker.ts\";\nexport { queuedTask } from \"./application/queued-task.ts\";\nexport type {\n  QueueRequest,\n  QueueResult,\n  QueueJob,\n  QueueClaim,\n  QueueLease,\n  TaskQueue,\n  DurableTaskQueue,\n} from \"./domain/task-queue.types.ts\";\nexport type {\n  QueueServerOptions,\n  QueueServer,\n  QueueClientOptions,\n} from \"./infrastructure/task-queue-http.types.ts\";\nexport type {\n  QueueHandlerContext,\n  QueueHandler,\n  QueueWorkerOptions,\n} from \"./application/queue-worker.types.ts\";\nexport type { QueuedTaskOptions } from \"./application/queued-task.types.ts\";\n\nexport type { EgressPolicy } from \"./domain/egress.types.ts\";\n\nexport { speculate } from \"./application/speculation.ts\";\nexport type {\n  SpeculationOptions,\n  SpeculationResult,\n  SpeculativeCandidate,\n  SpeculativeCandidateResult,\n  SpeculativeOutput,\n  SpeculativeHostSnapshot,\n  SpeculativeValidation,\n} from \"./application/speculation.types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU1D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAE7E,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0CAA0C,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EACL,eAAe,EACf,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAM3C,OAAO,EACL,MAAM,EACN,aAAa,EACb,QAAQ,EACR,aAAa,GACd,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,IAAI,EACJ,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAiB9B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAclE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoCnE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAMxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAS7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAMhF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAWlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAO9E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAWtF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAevE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAevE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAwB1D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAWzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["export { TransportConflict } from \"./domain/transport.ts\";\nexport type {\n  Transport,\n  TransportEntry,\n  TransportObject,\n  TransportReadOptions,\n  TransportWriteOptions,\n  TransportReference,\n  TransportStoreOptions,\n} from \"./domain/transport.types.ts\";\nexport { localTransport } from \"./infrastructure/local-transport.ts\";\nexport type { LocalTransportOptions } from \"./infrastructure/local-transport.types.ts\";\nexport { artifactStore } from \"./infrastructure/transport-artifact-store.ts\";\nexport type { ArtifactStoreOptions } from \"./infrastructure/transport-artifact-store.types.ts\";\nexport {\n  workflowCheckpointStore,\n  recoverWorkflowCheckpoint,\n} from \"./infrastructure/transport-checkpoint.ts\";\nexport type { CheckpointRecoveryOptions } from \"./infrastructure/transport-checkpoint.types.ts\";\nexport { readJournal } from \"./infrastructure/transport-journal.ts\";\nexport type { ReadJournalOptions } from \"./infrastructure/transport-journal.types.ts\";\nexport { transportConversations } from \"./infrastructure/transport-conversations.ts\";\nexport type { TransportConversationOptions } from \"./infrastructure/transport-conversations.types.ts\";\nexport {\n  archiveRecovery,\n  materializeRecoveryArchive,\n} from \"./application/recovery-archive.ts\";\nexport type {\n  RecoveryArchiveOptions,\n  RecoveryArchiveRestoreOptions,\n} from \"./application/recovery-archive.types.ts\";\n\nexport {\n  attach,\n  createSandbox,\n  dispatch,\n  openWorkspace,\n} from \"./application/outpost.ts\";\n\nexport type {\n  AttachOptions,\n  AttachResult,\n  ContinuationOptions,\n  DispatchResult,\n  Sandbox,\n  SandboxOptions,\n  WarmDispatchResult,\n  Workspace,\n  WorkspaceOptions,\n} from \"./application/outpost.ts\";\n\nexport type {\n  DispatchOptions,\n  Execution,\n  Turn,\n} from \"./application/execution.ts\";\n\nexport {\n  WorkflowFailure,\n  WorkflowBudgetExceeded,\n  task,\n  workflow,\n} from \"./domain/workflow.ts\";\n\nexport type {\n  Retry,\n  Task,\n  TaskContext,\n  TaskOptions,\n  TaskRecord,\n  TaskStatus,\n  Workflow,\n  WorkflowEvent,\n  WorkflowOptions,\n  WorkflowBudget,\n  WorkflowUsage,\n  WorkflowResult,\n} from \"./domain/workflow.ts\";\n\nexport { agentTask, commandTask, isolatedTask } from \"./application/tasks.ts\";\n\nexport { claude, codex, gemini } from \"./providers/agents.ts\";\n\nexport { agentVersions } from \"./providers/versions.ts\";\n\nexport { conversations } from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./infrastructure/conversations.ts\";\n\nexport type {\n  ClaudeSettings,\n  CodexSettings,\n  CodexModelProvider,\n  GeminiSettings,\n} from \"./providers/agents.ts\";\n\nexport { mountedProvider, remoteProvider } from \"./providers/factories.ts\";\n\nexport { ResponseError, response } from \"./domain/response.ts\";\n\nexport type { ResponseSpec, StandardValidator } from \"./domain/response.ts\";\n\nexport { OutpostError, recoveryDetails } from \"./domain/errors.ts\";\n\nexport type { FaultCode } from \"./domain/errors.ts\";\n\nexport type {\n  AgentAdapter,\n  AgentEvent,\n  AgentInput,\n  AgentObservation,\n  BranchPolicy,\n  Channel,\n  Command,\n  CommandResult,\n  Commit,\n  ConversationContext,\n  ConversationRecord,\n  ConversationStore,\n  Disposal,\n  LifecycleHooks,\n  FileManifestEntry,\n  FileTransfers,\n  SandboxContext,\n  SandboxLease,\n  SandboxProvider,\n  StageLimits,\n  TransferOptions,\n  Usage,\n  Variables,\n  Volume,\n  WorkspaceRecord,\n} from \"./domain/ports.ts\";\n\nexport type { Brief, PromptVariables } from \"./domain/prompts.ts\";\n\nexport type { Logging } from \"./infrastructure/journal.ts\";\n\nexport { reporter } from \"./infrastructure/reporter.ts\";\n\nexport type { ReporterOptions } from \"./infrastructure/reporter.ts\";\n\nexport type { VariableQuestion } from \"./application/interactive-brief.ts\";\n\nexport {\n  planRecoveryRetention,\n  pruneRecoveryRetention,\n  assertRecoveryQuota,\n} from \"./application/recovery-retention.ts\";\nexport type {\n  RecoveryRetentionPolicy,\n  RecoveryRetentionOptions,\n  RecoveryRetentionPlan,\n  RecoveryRetentionEntry,\n  RecoveryPruneResult,\n  RecoveryQuotaOptions,\n} from \"./application/recovery-retention.types.ts\";\nexport { verifyRecoveryTransfer } from \"./application/recovery-verification.ts\";\nexport type {\n  RecoveryVerification,\n  RecoveryVerificationOptions,\n} from \"./application/recovery-verification.types.ts\";\n\nexport { diagnoseSandbox } from \"./application/doctor-sandbox.ts\";\nexport type {\n  SandboxDiagnosticOptions,\n  SandboxDiagnosticReport,\n  DiagnosticCapability,\n} from \"./application/doctor-sandbox.types.ts\";\nexport type {\n  DiagnosticCheck,\n  DiagnosticStatus,\n  DoctorAgent,\n} from \"./application/doctor.types.ts\";\nexport { diagnoseAgentProtocol } from \"./application/doctor-protocol.ts\";\nexport type { AgentProtocolReport } from \"./application/doctor-protocol.types.ts\";\n\nexport { reserveRecoveryStorage } from \"./application/storage-reservation.ts\";\nexport type { RecoveryStorageReservationOptions } from \"./application/storage-reservation.types.ts\";\nexport type {\n  StorageReservation,\n  StorageReservationOptions,\n} from \"./infrastructure/storage-reservations.types.ts\";\n\nexport {\n  planRecoveryRestore,\n  restoreRecoveryTransfer,\n} from \"./application/recovery-restore.ts\";\nexport type {\n  RecoveryRestoreOptions,\n  RecoveryRestorePlan,\n  RecoveryRestoreResult,\n} from \"./application/recovery-restore.types.ts\";\n\nexport { fileWorkflowCheckpointStore } from \"./infrastructure/workflow-checkpoint.ts\";\nexport type { FileWorkflowCheckpointOptions } from \"./infrastructure/workflow-checkpoint.types.ts\";\nexport type {\n  WorkflowCheckpoint,\n  WorkflowCheckpointOptions,\n  WorkflowCheckpointStore,\n  WorkflowCheckpointLease,\n  WorkflowCheckpointValue,\n  WorkflowJson,\n} from \"./domain/workflow/checkpoint.types.ts\";\n\nexport { approvalTask, pauseTask } from \"./domain/workflow/gates.ts\";\nexport type {\n  WorkflowGate,\n  WorkflowGateOptions,\n  WorkflowPauseRequest,\n  WorkflowDecision,\n  WorkflowDecisionRecord,\n} from \"./domain/workflow/gates.types.ts\";\n\nexport { inspectRecovery } from \"./application/recovery-inspection.ts\";\nexport type {\n  RecoveryInspection,\n  RecoveryInspectionOptions,\n} from \"./application/recovery-inspection.types.ts\";\nexport type {\n  ResourceActivityRecord,\n  ResourceInspection,\n  ResourceInspectionEntry,\n  ResourceOperation,\n  ResourceOperationKind,\n  ResourceOperationResult,\n  ResourcePhase,\n} from \"./infrastructure/resource-activity.types.ts\";\n\nexport {\n  artifact,\n  publishArtifact,\n  readStoredArtifact,\n} from \"./domain/artifact.ts\";\nexport { artifactTask, readArtifact } from \"./application/artifact-tasks.ts\";\nexport { fileArtifactStore } from \"./infrastructure/artifact-store.ts\";\nexport type {\n  ArtifactContract,\n  ArtifactContractOptions,\n  ArtifactIdentity,\n  ArtifactProducer,\n  ArtifactReference,\n  ArtifactStore,\n  JsonArtifactOptions,\n  PublishArtifactOptions,\n  ReadArtifactOptions,\n} from \"./domain/artifact.types.ts\";\nexport type { ArtifactTaskOptions } from \"./application/artifact-tasks.types.ts\";\nexport type { FileArtifactStoreOptions } from \"./infrastructure/artifact-store.types.ts\";\n\nexport { sqliteTaskQueue } from \"./infrastructure/task-queue.ts\";\nexport {\n  serveTaskQueue,\n  httpTaskQueue,\n} from \"./infrastructure/task-queue-http.ts\";\nexport { runQueueWorker } from \"./application/queue-worker.ts\";\nexport { queuedTask } from \"./application/queued-task.ts\";\nexport type {\n  QueueRequest,\n  QueueResult,\n  QueueJob,\n  QueueClaim,\n  QueueLease,\n  TaskQueue,\n  DurableTaskQueue,\n} from \"./domain/task-queue.types.ts\";\nexport type {\n  QueueServerOptions,\n  QueueServer,\n  QueueClientOptions,\n} from \"./infrastructure/task-queue-http.types.ts\";\nexport type {\n  QueueHandlerContext,\n  QueueHandler,\n  QueueWorkerOptions,\n} from \"./application/queue-worker.types.ts\";\nexport type { QueuedTaskOptions } from \"./application/queued-task.types.ts\";\n\nexport type { EgressPolicy } from \"./domain/egress.types.ts\";\n\nexport { speculate } from \"./application/speculation.ts\";\nexport type {\n  SpeculationOptions,\n  SpeculationResult,\n  SpeculativeCandidate,\n  SpeculativeCandidateResult,\n  SpeculativeOutput,\n  SpeculativeHostSnapshot,\n  SpeculativeValidation,\n} from \"./application/speculation.types.ts\";\n\nexport { openaiCompatible } from \"./adapters/models/openai-compatible.ts\";\nexport type { OpenAICompatibleOptions } from \"./adapters/models/openai-compatible.types.ts\";\nexport type {\n  ModelProvider,\n  ModelRequest,\n  ModelResult,\n} from \"./domain/model.types.ts\";\n"]}

package/dist/infrastructure/artifact-store.js

@@ -1,3 +1,4 @@
+import { artifactStore } from "./transport-artifact-store.js";
 import { artifactDigestPattern } from "../domain/artifact.constants.js";
 import { randomUUID } from "node:crypto";
 import { link, lstat, mkdir, open, rm } from "node:fs/promises";
@@ -38,6 +39,15 @@ async function readArtifactFile(path, maxBytes) {
     }
 }
 export function fileArtifactStore(options) {
+    if ((options.directory === undefined) === (options.transporter === undefined))
+        throw new Error("Provide exactly one artifact directory or transporter");
+    if (options.transporter)
+        return artifactStore({
+            transporter: options.transporter,
+            ...(options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),
+        });
+    if (options.directory === undefined)
+        throw new Error("Artifact directory is required");
     const root = resolve(options.directory), maxBytes = options.maxBytes ?? artifactMaxBytes;
     if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)
         throw new Error("Artifact maxBytes must be a positive safe integer");

package/dist/infrastructure/artifact-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../src/infrastructure/artifact-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { artifactDigestPattern } from \"../domain/artifact.constants.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport { link, lstat, mkdir, open, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { ArtifactStore } from \"../domain/artifact.types.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { artifactMaxBytes } from \"./artifact-store.constants.ts\";\nimport type { FileArtifactStoreOptions } from \"./artifact-store.types.ts\";\n\nasync function directory(path: string): Promise<void> {\n  const parent = dirname(path);\n  if (parent !== path) {\n    await directory(parent);\n    try {\n      await mkdir(path, { mode: 0o700 });\n    } catch (error) {\n      if (!code(error, \"EEXIST\")) throw error;\n    }\n  }\n  if (!(await lstat(path)).isDirectory())\n    throw new Error(\"Artifact directory must not contain symlinks\");\n}\n\nfunction code(error: unknown, expected: string): boolean {\n  return (\n    !!error &&\n    typeof error === \"object\" &&\n    \"code\" in error &&\n    error.code === expected\n  );\n}\n\nasync function readArtifactFile(\n  path: string,\n  maxBytes: number,\n): Promise<Buffer> {\n  try {\n    return await readInspectionFile(path, maxBytes);\n  } catch (error) {\n    if (\n      !(error instanceof Error) ||\n      error.message !== \"Inspection file changed\"\n    )\n      throw error;\n    // Removing the staging hard link can change ctime once after publication.\n    return readInspectionFile(path, maxBytes);\n  }\n}\n\nexport function fileArtifactStore(\n  options: FileArtifactStoreOptions,\n): ArtifactStore {\n  const root = resolve(options.directory),\n    maxBytes = options.maxBytes ?? artifactMaxBytes;\n  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)\n    throw new Error(\"Artifact maxBytes must be a positive safe integer\");\n  const path = (id: string) => {\n    if (!artifactDigestPattern.test(id))\n      throw new Error(\"Invalid artifact storage ID\");\n    return join(root, `${id}.blob`);\n  };\n  return {\n    async put(id, input, signal) {\n      signal?.throwIfAborted();\n      const target = path(id);\n      if (input.byteLength > maxBytes)\n        throw new Error(\"Artifact exceeds maxBytes\");\n      const bytes = Buffer.from(input);\n      await directory(root);\n      const temporary = join(root, `.${randomUUID()}.tmp`);\n      try {\n        const file = await open(temporary, \"wx\", 0o600);\n        try {\n          await file.writeFile(bytes, signal ? { signal } : {});\n          await file.sync();\n        } finally {\n          await file.close();\n        }\n        signal?.throwIfAborted();\n        try {\n          await link(temporary, target);\n        } catch (error) {\n          if (!code(error, \"EEXIST\")) throw error;\n          if (!bytes.equals(await readArtifactFile(target, maxBytes)))\n            throw new Error(\"Existing artifact content integrity mismatch\");\n        }\n        if (process.platform !== \"win32\") {\n          const parent = await open(root, \"r\");\n          try {\n            await parent.sync();\n          } finally {\n            await parent.close();\n          }\n        }\n      } finally {\n        await rm(temporary, { force: true });\n      }\n    },\n    async get(id, signal) {\n      signal?.throwIfAborted();\n      const target = path(id);\n      const bytes = await readArtifactFile(target, maxBytes);\n      signal?.throwIfAborted();\n      return bytes;\n    },\n  };\n}\n"]}
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../src/infrastructure/artifact-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { artifactStore } from \"./transport-artifact-store.ts\";\nimport { artifactDigestPattern } from \"../domain/artifact.constants.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport { link, lstat, mkdir, open, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { ArtifactStore } from \"../domain/artifact.types.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { artifactMaxBytes } from \"./artifact-store.constants.ts\";\nimport type { FileArtifactStoreOptions } from \"./artifact-store.types.ts\";\n\nasync function directory(path: string): Promise<void> {\n  const parent = dirname(path);\n  if (parent !== path) {\n    await directory(parent);\n    try {\n      await mkdir(path, { mode: 0o700 });\n    } catch (error) {\n      if (!code(error, \"EEXIST\")) throw error;\n    }\n  }\n  if (!(await lstat(path)).isDirectory())\n    throw new Error(\"Artifact directory must not contain symlinks\");\n}\n\nfunction code(error: unknown, expected: string): boolean {\n  return (\n    !!error &&\n    typeof error === \"object\" &&\n    \"code\" in error &&\n    error.code === expected\n  );\n}\n\nasync function readArtifactFile(\n  path: string,\n  maxBytes: number,\n): Promise<Buffer> {\n  try {\n    return await readInspectionFile(path, maxBytes);\n  } catch (error) {\n    if (\n      !(error instanceof Error) ||\n      error.message !== \"Inspection file changed\"\n    )\n      throw error;\n    // Removing the staging hard link can change ctime once after publication.\n    return readInspectionFile(path, maxBytes);\n  }\n}\n\nexport function fileArtifactStore(\n  options: FileArtifactStoreOptions,\n): ArtifactStore {\n  if ((options.directory === undefined) === (options.transporter === undefined))\n    throw new Error(\"Provide exactly one artifact directory or transporter\");\n  if (options.transporter)\n    return artifactStore({\n      transporter: options.transporter,\n      ...(options.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),\n    });\n  if (options.directory === undefined)\n    throw new Error(\"Artifact directory is required\");\n  const root = resolve(options.directory),\n    maxBytes = options.maxBytes ?? artifactMaxBytes;\n  if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)\n    throw new Error(\"Artifact maxBytes must be a positive safe integer\");\n  const path = (id: string) => {\n    if (!artifactDigestPattern.test(id))\n      throw new Error(\"Invalid artifact storage ID\");\n    return join(root, `${id}.blob`);\n  };\n  return {\n    async put(id, input, signal) {\n      signal?.throwIfAborted();\n      const target = path(id);\n      if (input.byteLength > maxBytes)\n        throw new Error(\"Artifact exceeds maxBytes\");\n      const bytes = Buffer.from(input);\n      await directory(root);\n      const temporary = join(root, `.${randomUUID()}.tmp`);\n      try {\n        const file = await open(temporary, \"wx\", 0o600);\n        try {\n          await file.writeFile(bytes, signal ? { signal } : {});\n          await file.sync();\n        } finally {\n          await file.close();\n        }\n        signal?.throwIfAborted();\n        try {\n          await link(temporary, target);\n        } catch (error) {\n          if (!code(error, \"EEXIST\")) throw error;\n          if (!bytes.equals(await readArtifactFile(target, maxBytes)))\n            throw new Error(\"Existing artifact content integrity mismatch\");\n        }\n        if (process.platform !== \"win32\") {\n          const parent = await open(root, \"r\");\n          try {\n            await parent.sync();\n          } finally {\n            await parent.close();\n          }\n        }\n      } finally {\n        await rm(temporary, { force: true });\n      }\n    },\n    async get(id, signal) {\n      signal?.throwIfAborted();\n      const target = path(id);\n      const bytes = await readArtifactFile(target, maxBytes);\n      signal?.throwIfAborted();\n      return bytes;\n    },\n  };\n}\n"]}

package/dist/infrastructure/artifact-store.types.d.ts

@@ -1,4 +1,6 @@
+import type { Transport } from "../domain/transport.types.ts";
 export interface FileArtifactStoreOptions {
-    readonly directory: string;
+    readonly directory?: string;
+    readonly transporter?: Transport;
     readonly maxBytes?: number;
 }

package/dist/infrastructure/artifact-store.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-store.types.js","sourceRoot":"","sources":["../../src/infrastructure/artifact-store.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface FileArtifactStoreOptions {\n  readonly directory: string;\n  readonly maxBytes?: number;\n}\n"]}
+{"version":3,"file":"artifact-store.types.js","sourceRoot":"","sources":["../../src/infrastructure/artifact-store.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Transport } from \"../domain/transport.types.ts\";\n\nexport interface FileArtifactStoreOptions {\n  readonly directory?: string;\n  readonly transporter?: Transport;\n  readonly maxBytes?: number;\n}\n"]}