@agent-relay/sandbox 0.1.2 → 0.1.3

package/dist/port.d.ts.map

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

package/dist/port.js

@@ -1,14 +1,24 @@
+/**
+ * True when a mode is still pending evidence, i.e. a live probe could change
+ * it.
+ *
+ * This is the guard a promotion path should consult. `"not-exposed"` and
+ * `"unsupported"` are not weaker forms of `"unknown"` — proving the provider
+ * can do the thing is not grounds for promoting either of them.
+ */
+export function isPendingEvidence(mode) {
+    return mode === "unknown";
+}
 const capabilitiesByRuntime = new WeakMap();
 /**
  * Resolve (and memoize) a runtime's capability descriptor.
  *
  * Hybrid by necessity: `asyncExec` / `reattach` / `detachedLaunch` are honestly
  * derivable from method presence, but `warmLease` and `lifecycle` are not —
- * every provider ships `findAllByLabels` (E2B and local return `[]` both for
- * "no server-side label search" and for "no matches", an ambiguity presence
- * cannot resolve) and every provider ships `start`/`stop` (present-but-no-op on
- * local and E2B). Those two are provider-declared, defaulting to `true` so an
- * undeclared runtime keeps today's behavior exactly.
+ * a provider can expose `findAllByLabels` while degrading unsupported search
+ * to `[]`, and can expose `start`/`stop` as compatibility no-ops. Method
+ * presence cannot distinguish either case. Those two are provider-declared,
+ * defaulting to `true` so an undeclared runtime keeps today's behavior exactly.
  */
 export function resolveSandboxRuntimeCapabilities(runtime) {
     const cached = capabilitiesByRuntime.get(runtime);
@@ -16,6 +26,7 @@ export function resolveSandboxRuntimeCapabilities(runtime) {
         return cached;
     }
     const declared = runtime.declaredCapabilities ?? {};
+    const declaredModes = runtime.declaredCapabilityModes ?? {};
     // All-or-nothing: a runtime that can submit but cannot poll would strand a
     // live command inside the sandbox with no way to ever observe or reap it.
     const asyncExec = typeof runtime.startScript === "function"
@@ -28,6 +39,17 @@ export function resolveSandboxRuntimeCapabilities(runtime) {
         detachedLaunch: typeof runtime.launchDetached === "function",
         warmLease: declared.warmLease ?? true,
         lifecycle: declared.lifecycle ?? true,
+        // Modes default to "unknown", not to a plausible-looking value. An
+        // undeclared mode means nobody has established it, and inventing one here
+        // would manufacture exactly the false confidence the booleans already cost
+        // us.
+        modes: {
+            outputStreams: declaredModes.outputStreams ?? "unknown",
+            filesystem: declaredModes.filesystem ?? "unknown",
+            lifetime: declaredModes.lifetime ?? "unknown",
+            interactive: declaredModes.interactive ?? "unknown",
+            snapshots: declaredModes.snapshots ?? "unknown",
+        },
     };
     capabilitiesByRuntime.set(runtime, resolved);
     return resolved;

package/dist/port.js.map

@@ -1 +1 @@
-{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AA4IA,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAGtC,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAuB;IAEvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACpD,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU;WACtD,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;WACrC,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU;WAC7C,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,CAAC;IACjD,MAAM,QAAQ,GAA+B;QAC3C,SAAS;QACT,QAAQ,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;QAC/C,cAAc,EAAE,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU;QAC5D,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACrC,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;KACtC,CAAC;IACF,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAsJA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuC;IAEvC,OAAO,IAAI,KAAK,SAAS,CAAC;AAC5B,CAAC;AAuID,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAGtC,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAuB;IAEvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,uBAAuB,IAAI,EAAE,CAAC;IAC5D,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU;WACtD,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;WACrC,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU;WAC7C,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,CAAC;IACjD,MAAM,QAAQ,GAAuC;QACnD,SAAS;QACT,QAAQ,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;QAC/C,cAAc,EAAE,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU;QAC5D,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACrC,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACrC,mEAAmE;QACnE,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM;QACN,KAAK,EAAE;YACL,aAAa,EAAE,aAAa,CAAC,aAAa,IAAI,SAAS;YACvD,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,SAAS;YACjD,QAAQ,EAAE,aAAa,CAAC,QAAQ,IAAI,SAAS;YAC7C,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,SAAS;YACnD,SAAS,EAAE,aAAa,CAAC,SAAS,IAAI,SAAS;SAChD;KACF,CAAC;IACF,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,15 @@
-export type IsolationLevel = 'none' | 'process' | 'strong';
+/**
+ * How strongly a runtime isolates a workload from the host.
+ *
+ * `'unknown'` is deliberately NOT a synonym for weak. It is for a provider
+ * whose isolation this package has not established as fact — most often a
+ * hosted backend whose internals are documented by the vendor but not
+ * observable from here. Encoding such a case as `'strong'` would publish a
+ * guarantee nobody verified, and encoding it as `'none'`/`'process'` would
+ * publish a limitation that may not exist. A caller that requires a specific
+ * guarantee must treat `'unknown'` as "not established" and decide for itself.
+ */
+export type IsolationLevel = 'none' | 'process' | 'strong' | 'unknown';
 export interface RuntimeCapabilities {
     pty: boolean;
     snapshots: boolean;
@@ -13,6 +24,36 @@ export interface LaunchOptions {
     labels?: Record<string, string>;
     workdir?: string;
     createTimeoutSeconds?: number;
+    /**
+     * Deadline after which the instance is a leak — the caller promises the
+     * instance is safe to reap once wall-clock passes this timestamp. Together
+     * with `attributionTag`, this is the reap-ephemeral contract: an out-of-
+     * process reaper (see `scripts/reap-ephemeral.ts`) DELETEs instances that
+     * carry BOTH fields when `ephemeralUntil` is in the past. Adapters that
+     * accept this option persist it on the instance's provider-side metadata
+     * so it survives caller crashes.
+     *
+     * Number: Unix milliseconds. String: ISO-8601 (parsed and re-encoded to
+     * millis at persist time; consistency with the reaper is on the adapter).
+     *
+     * **Never sweep on labels alone.** `metadata.ephemeral === 'true'` is a
+     * caller-set label, not a lifecycle contract — sweeping on it deletes
+     * healthy warm-lease instances that legitimately carry the same label.
+     * The safe contract is `attributionTag + ephemeralUntil<past>`, both
+     * required.
+     */
+    ephemeralUntil?: number | string;
+    /**
+     * Opaque tag identifying which system launched this instance for the
+     * reap-ephemeral contract. Any two systems that share a tag agree to
+     * reap each other's leaked instances; a tag with no counter-reaper leaks
+     * quietly. Combined with `ephemeralUntil` per the contract above.
+     *
+     * Suggested shape: `<system-slug>:<lane-slug>` (e.g.,
+     * `bench:sandbox-provider-comparison-0819`). Kept as an opaque string
+     * so the reap contract does not force a shared taxonomy.
+     */
+    attributionTag?: string;
 }
 export interface RuntimeHandle {
     id: string;
@@ -31,6 +72,14 @@ export interface ExecOptions {
 export interface ExecResult {
     output: string;
     exitCode: number;
+    /**
+     * True when the provider capped captured output and `output` is therefore
+     * incomplete. Optional and additive; `undefined` means the provider did not
+     * report truncation, not that the output is known to be complete. A given
+     * adapter may guarantee more than this baseline for its own reads — see
+     * that adapter's implementation for the stronger claim, if any.
+     */
+    truncated?: boolean;
 }
 export interface AsyncExecStartResult {
     sessionId: string;

package/dist/types.d.ts.map

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

package/dist/vercel/bench.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Live benchmark core for the Vercel adapter.
+ *
+ * Split out from the CLI in `scripts/vercel-bench.ts` so the safety guards are
+ * testable against a fake runtime *before* they are pointed at a real account.
+ * A harness whose ledger-before-use and verified-cleanup guards have never been
+ * exercised is exactly the unverified claim this package refuses to make about
+ * anything else.
+ *
+ * Not exported from the package barrel: this is an internal measurement tool,
+ * not public API.
+ */
+import type { RuntimeHandle } from "../types.js";
+/** The slice of the runtime the benchmark needs. Keeps fakes cheap. */
+export interface BenchRuntime {
+    launch(options: {
+        name?: string;
+        labels?: Record<string, string>;
+    }): Promise<RuntimeHandle>;
+    runScript(handle: RuntimeHandle, options: {
+        command: string;
+        timeoutMs?: number;
+    }): Promise<{
+        output: string;
+        exitCode: number | null;
+    }>;
+    listOwned(options?: {
+        includeTerminated?: boolean;
+        states?: readonly string[] | null;
+    }): Promise<Array<{
+        name: string;
+        providerStatus: string;
+        vcpus?: number;
+        memoryMiB?: number;
+        activeCpuMs?: number;
+        wallClockMs?: number;
+    }>>;
+    destroy(handle: RuntimeHandle): Promise<void>;
+}
+export type LedgerEvent = {
+    event: "run-start" | "intent" | "created" | "error" | "destroyed-verified" | "destroy-unverified" | "destroy-submit-failed" | "sweep-failed" | "burst-start" | "survivor" | "run-end";
+    name: string;
+    [key: string]: unknown;
+};
+export interface BenchLimits {
+    /** Absolute ceiling on sandboxes created by one invocation. */
+    maxSandboxes: number;
+    /** vCPUs per sandbox, echoed into the cost projection. */
+    vcpus: number;
+    /** Concurrency probe width. */
+    burstWidth: number;
+}
+export interface BenchDeps {
+    runtime: BenchRuntime;
+    /** Must be durable before the create call goes out. */
+    ledger(entry: LedgerEvent): void;
+    prefix: string;
+    runId: string;
+    limits: BenchLimits;
+    now?: () => number;
+}
+export declare class BenchBoundsError extends Error {
+    constructor(requested: number, max: number);
+}
+export type Sample = {
+    index: number;
+    createMs: number;
+    stateAfterCreate: string;
+    firstExecMs: number;
+    execExitCode: number | null;
+    execOutput: string;
+    vcpus?: number;
+    memoryMiB?: number;
+    activeCpuMs?: number;
+    wallClockMs?: number;
+    destroyed: boolean;
+    verifiedGone: boolean;
+    error?: string;
+};
+/**
+ * Cost for one sandbox-hour at a given shape and CPU utilisation.
+ *
+ * The two lines are always reported separately and never blended. Active CPU
+ * excludes I/O wait; provisioned memory does not — it is wall-clock. Collapsing
+ * them into one number is precisely how the "cheapest provider" claim gets
+ * overstated for idle-heavy agent workloads.
+ */
+export declare function projectCost(vcpus: number, utilisation: number): {
+    utilisation: number;
+    cpuPerHour: number;
+    memoryPerHour: number;
+    totalPerHour: number;
+};
+/** Nearest-rank percentile. NaN entries are dropped, not treated as zero. */
+export declare function percentile(values: readonly number[], p: number): number;
+/**
+ * Measure one sandbox end to end.
+ *
+ * The name is ledgered *before* `launch` is called. A record written after the
+ * response would be lost exactly when it matters — a crash between submit and
+ * response leaves a live sandbox nobody wrote down.
+ *
+ * Teardown runs in `finally`, so a failed measurement still destroys what it
+ * created. `destroyed` and `verifiedGone` are tracked separately because they
+ * are different facts, and conflating them is how a leak gets reported as a
+ * clean run.
+ */
+export declare function measureOne(deps: BenchDeps, index: number): Promise<Sample>;
+export interface BurstResult {
+    width: number;
+    admitted: number;
+    rejected: number;
+    rejections: string[];
+    verifiedGone: number;
+    caveat: string;
+}
+/** Concurrency probe: launch a burst, then tear all of it down. */
+export declare function burstProbe(deps: BenchDeps): Promise<BurstResult>;
+/** Independent audit: nothing under this lane's prefix may survive a run. */
+export declare function sweep(deps: BenchDeps): Promise<string[]>;
+export type BenchMode = "canary" | "full" | "sweep";
+export interface BenchReport {
+    runId: string;
+    prefix: string;
+    mode: BenchMode;
+    n: number;
+    coldCreate: {
+        p50Ms: number;
+        p95Ms: number;
+    };
+    firstExec: {
+        p50Ms: number;
+        p95Ms: number;
+    };
+    readyStateAfterCreate: string[];
+    deliveredShape: {
+        vcpus: number[];
+        memoryMiB: number[];
+        documented: string;
+    };
+    cleanup: {
+        created: number;
+        destroyed: number;
+        verifiedGone: number;
+        survivors: string[];
+        /** Present when the independent sweep itself failed to run. */
+        sweepError?: string;
+    };
+    burst: BurstResult | null;
+    costProjection: {
+        shape: string;
+        note: string;
+        perHour: ReturnType<typeof projectCost>[];
+    };
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+    /** True only when every created sandbox was proven gone. */
+    clean: boolean;
+}
+/**
+ * Run the benchmark.
+ *
+ * Refuses up front to exceed the sandbox cap: a bound checked after the fact is
+ * not a bound. The sweep runs in `finally`, so an aborted run still audits.
+ */
+export declare function runBenchmark(deps: BenchDeps, mode: BenchMode): Promise<BenchReport>;
+//# sourceMappingURL=bench.d.ts.map

package/dist/vercel/bench.d.ts.map

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