@polpo-ai/node 0.13.1 → 0.14.0

package/dist/index.d.ts

@@ -27,4 +27,8 @@ export { createEmailTools, ALL_EMAIL_TOOL_NAMES } from "@polpo-ai/tools";
 export { createVaultTools, ALL_VAULT_TOOL_NAMES } from "@polpo-ai/tools";
 export { createAudioTools, ALL_AUDIO_TOOL_NAMES } from "@polpo-ai/tools";
 export { createImageTools, ALL_IMAGE_TOOL_NAMES } from "@polpo-ai/tools";
+export { SandboxLease, DEFAULT_IDLE_SUSPEND_MS } from "./sandbox/lease.js";
+export type { SandboxLeaseOptions } from "./sandbox/lease.js";
+export { LocalSandboxProvider } from "./sandbox/local-provider.js";
+export { ShellBackedFileSystem } from "./sandbox/shell-backed-fs.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGpG,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtM,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1H,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -30,4 +30,8 @@ export { createEmailTools, ALL_EMAIL_TOOL_NAMES } from "@polpo-ai/tools";
 export { createVaultTools, ALL_VAULT_TOOL_NAMES } from "@polpo-ai/tools";
 export { createAudioTools, ALL_AUDIO_TOOL_NAMES } from "@polpo-ai/tools";
 export { createImageTools, ALL_IMAGE_TOOL_NAMES } from "@polpo-ai/tools";
+// ── SandboxProvider (F1: lease + local provider) ─────────────────────────
+export { SandboxLease, DEFAULT_IDLE_SUSPEND_MS } from "./sandbox/lease.js";
+export { LocalSandboxProvider } from "./sandbox/local-provider.js";
+export { ShellBackedFileSystem } from "./sandbox/shell-backed-fs.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,mFAAmF;AACnF,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wFAAwF;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAItM,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AActE,0CAA0C;AAC1C,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvD,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1H,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wFAAwF;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAItM,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AActE,0CAA0C;AAC1C,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvD,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1H,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,4EAA4E;AAC5E,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/sandbox/lease.d.ts

@@ -0,0 +1,72 @@
+/**
+ * SandboxLease — a per-run lease over a {@link SandboxProvider} that adds the
+ * three things the proxy execution model needs on top of a raw session:
+ *
+ *  - LAZY ACQUIRE: the session opens on the first fs/shell operation, so a run
+ *    whose loop only reasons/talks never opens one (nothing to bill).
+ *  - INTRA-RUN SUSPEND: a refcount tracks in-flight fs/shell ops; when it hits
+ *    zero the compute is suspended after `idleSuspendMs` (the model is
+ *    thinking), and resumed on the next op. Parallel ops share one sandbox and
+ *    one resume, and it is never suspended mid-operation. No-op when the
+ *    session has no {@link SandboxLifecycle} (e.g. the local machine).
+ *  - METERING: the acquire→release window minus suspended gaps is the run's
+ *    real sandbox-milliseconds, emitted once via `onUsage` on dispose.
+ *
+ * This generalises the cloud's Sandbox-object lease to the {@link FileSystem}
+ * and {@link Shell} ports, so any backend (local, docker, daytona, remote)
+ * gets the same behaviour behind one port.
+ */
+import type { FileSystem, Shell, SandboxProvider, SandboxUsage } from "@polpo-ai/core";
+/** Default idle window before an unused sandbox's compute is suspended. */
+export declare const DEFAULT_IDLE_SUSPEND_MS = 1500;
+export interface SandboxLeaseOptions {
+    /** Clock injection for testing. */
+    now?: () => number;
+    /** Called once on dispose with the run's sandbox usage. */
+    onUsage?: (usage: SandboxUsage) => void;
+    /** Idle window (ms) before suspending compute. Default 1500. */
+    idleSuspendMs?: number;
+    /** Project id propagated into the emitted usage. */
+    projectId?: string;
+}
+export declare class SandboxLease {
+    private readonly provider;
+    private readonly runId;
+    private sessionPromise;
+    private session;
+    private lifecycle?;
+    private acquired;
+    private inFlight;
+    private running;
+    private runningSince;
+    private runningMs;
+    private idleTimer;
+    private resumeLock;
+    private released;
+    private readonly now;
+    private readonly onUsage?;
+    private readonly idleSuspendMs;
+    private readonly projectId?;
+    /** Activity-wrapped filesystem — hand this to the in-process tool ports. */
+    readonly fs: FileSystem;
+    /** Activity-wrapped shell — hand this to the in-process tool ports. */
+    readonly shell: Shell;
+    constructor(provider: SandboxProvider, runId: string, opts?: SandboxLeaseOptions);
+    /** Whether the run ever opened a session. */
+    get wasAcquired(): boolean;
+    private ensureSession;
+    /** Release the sandbox and emit usage. Idempotent. */
+    dispose(): Promise<void>;
+    private activityStart;
+    private activityEnd;
+    /** Resume the compute on demand; a single resume is shared by parallel ops. */
+    private ensureRunning;
+    private armIdle;
+    private clearIdle;
+    private suspend;
+    /** Open (lazily), bracket a fs/shell op with the refcount, and run it. */
+    private bracket;
+    private makeFs;
+    private makeShell;
+}
+//# sourceMappingURL=lease.d.ts.map

package/dist/sandbox/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../src/sandbox/lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACV,UAAU,EACV,KAAK,EAEL,eAAe,EAGf,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IA0BrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IA1BxB,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAGH,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,EAC9B,IAAI,GAAE,mBAAwB;IAUhC,6CAA6C;IAC7C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,OAAO,CAAC,aAAa;IAcrB,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAwBhB,aAAa;IAM3B,OAAO,CAAC,WAAW;IAKnB,+EAA+E;YACjE,aAAa;IAa3B,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,SAAS;YAOH,OAAO;IAcrB,0EAA0E;YAC5D,OAAO;IAerB,OAAO,CAAC,MAAM;IA2Bd,OAAO,CAAC,SAAS;CAKlB"}

package/dist/sandbox/lease.js

@@ -0,0 +1,177 @@
+/** Default idle window before an unused sandbox's compute is suspended. */
+export const DEFAULT_IDLE_SUSPEND_MS = 1500;
+export class SandboxLease {
+    provider;
+    runId;
+    sessionPromise = null;
+    session = null;
+    lifecycle;
+    acquired = false;
+    inFlight = 0;
+    running = false;
+    runningSince = 0;
+    runningMs = 0;
+    idleTimer = null;
+    resumeLock = null;
+    released = false;
+    now;
+    onUsage;
+    idleSuspendMs;
+    projectId;
+    /** Activity-wrapped filesystem — hand this to the in-process tool ports. */
+    fs;
+    /** Activity-wrapped shell — hand this to the in-process tool ports. */
+    shell;
+    constructor(provider, runId, opts = {}) {
+        this.provider = provider;
+        this.runId = runId;
+        this.now = opts.now ?? (() => Date.now());
+        this.onUsage = opts.onUsage;
+        this.idleSuspendMs = opts.idleSuspendMs ?? DEFAULT_IDLE_SUSPEND_MS;
+        this.projectId = opts.projectId;
+        this.fs = this.makeFs();
+        this.shell = this.makeShell();
+    }
+    /** Whether the run ever opened a session. */
+    get wasAcquired() {
+        return this.acquired;
+    }
+    // ── session lifecycle ──────────────────────────────────────────────────
+    ensureSession() {
+        if (!this.sessionPromise) {
+            this.sessionPromise = Promise.resolve(this.provider.open(this.runId)).then((s) => {
+                this.session = s;
+                this.lifecycle = s.lifecycle;
+                this.acquired = true;
+                this.running = true;
+                this.runningSince = this.now();
+                return s;
+            });
+        }
+        return this.sessionPromise;
+    }
+    /** Release the sandbox and emit usage. Idempotent. */
+    async dispose() {
+        if (this.released)
+            return;
+        this.released = true;
+        this.clearIdle();
+        if (this.running) {
+            this.runningMs += this.now() - this.runningSince;
+            this.running = false;
+        }
+        let sandboxId;
+        if (this.session) {
+            try {
+                sandboxId = this.session.usage?.().sandboxId;
+            }
+            catch { /* ignore */ }
+            try {
+                await this.session.dispose();
+            }
+            catch { /* best-effort */ }
+        }
+        this.onUsage?.({
+            runId: this.runId,
+            projectId: this.projectId,
+            acquired: this.acquired,
+            sandboxMs: this.acquired ? Math.max(0, this.runningMs) : 0,
+            sandboxId,
+        });
+    }
+    // ── activity tracking ──────────────────────────────────────────────────
+    async activityStart() {
+        this.clearIdle();
+        this.inFlight++;
+        if (!this.running)
+            await this.ensureRunning();
+    }
+    activityEnd() {
+        this.inFlight = Math.max(0, this.inFlight - 1);
+        if (this.inFlight === 0)
+            this.armIdle();
+    }
+    /** Resume the compute on demand; a single resume is shared by parallel ops. */
+    async ensureRunning() {
+        if (this.running || !this.lifecycle)
+            return;
+        if (!this.resumeLock) {
+            const lc = this.lifecycle;
+            this.resumeLock = lc.resume().then(() => {
+                this.running = true;
+                this.runningSince = this.now();
+                this.resumeLock = null;
+            });
+        }
+        await this.resumeLock;
+    }
+    armIdle() {
+        if (!this.lifecycle || this.released)
+            return;
+        this.clearIdle();
+        this.idleTimer = setTimeout(() => { void this.suspend(); }, this.idleSuspendMs);
+        // Never keep the process alive just to suspend an idle sandbox.
+        this.idleTimer.unref?.();
+    }
+    clearIdle() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+    async suspend() {
+        if (this.inFlight > 0 || !this.running || !this.lifecycle || this.released)
+            return;
+        this.running = false;
+        this.runningMs += this.now() - this.runningSince;
+        try {
+            await this.lifecycle.suspend();
+        }
+        catch {
+            // Suspend failed — treat as still running so metering stays honest and
+            // the next op doesn't try to resume an already-running sandbox.
+            this.running = true;
+            this.runningSince = this.now();
+        }
+    }
+    /** Open (lazily), bracket a fs/shell op with the refcount, and run it. */
+    async bracket(op) {
+        const session = await this.ensureSession();
+        await this.activityStart();
+        try {
+            return await op(session);
+        }
+        finally {
+            this.activityEnd();
+        }
+    }
+    // ── activity-wrapped ports ──────────────────────────────────────────────
+    // The optional FileSystem methods are always present on the lease (callers
+    // may feature-detect them) and fall back to the required methods when the
+    // backend doesn't implement them — same fallbacks the file routes use.
+    makeFs() {
+        const enc = new TextEncoder();
+        const dec = new TextDecoder();
+        return {
+            readFile: (p) => this.bracket((s) => s.fs.readFile(p)),
+            writeFile: (p, c) => this.bracket((s) => s.fs.writeFile(p, c)),
+            exists: (p) => this.bracket((s) => s.fs.exists(p)),
+            readdir: (p) => this.bracket((s) => s.fs.readdir(p)),
+            mkdir: (p) => this.bracket((s) => s.fs.mkdir(p)),
+            remove: (p) => this.bracket((s) => s.fs.remove(p)),
+            stat: (p) => this.bracket((s) => s.fs.stat(p)),
+            rename: (o, n) => this.bracket((s) => s.fs.rename(o, n)),
+            readdirWithTypes: (p) => this.bracket((s) => s.fs.readdirWithTypes
+                ? s.fs.readdirWithTypes(p)
+                : s.fs.readdir(p).then((names) => names.map((name) => ({ name, isDirectory: false, isFile: true })))),
+            readFileBuffer: (p) => this.bracket((s) => s.fs.readFileBuffer ? s.fs.readFileBuffer(p) : s.fs.readFile(p).then((t) => enc.encode(t))),
+            writeFileBuffer: (p, d) => this.bracket((s) => s.fs.writeFileBuffer ? s.fs.writeFileBuffer(p, d) : s.fs.writeFile(p, dec.decode(d))),
+        };
+    }
+    makeShell() {
+        return {
+            execute: (cmd, opts) => this.bracket((s) => s.shell.execute(cmd, opts)),
+        };
+    }
+}
+//# sourceMappingURL=lease.js.map

package/dist/sandbox/lease.js.map

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

package/dist/sandbox/local-provider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LocalSandboxProvider — runs a session directly on the host machine.
+ *
+ * The default provider for self-hosted mode: a session is just the real
+ * {@link NodeFileSystem} + {@link NodeShell}, with NO lifecycle (the local
+ * machine has no meaningful suspend) and NO metering. Under a
+ * {@link SandboxLease} this means the lease never suspends and behaves exactly
+ * as running the tools directly — i.e. identical to today's local execution.
+ */
+import type { SandboxProvider, SandboxSession } from "@polpo-ai/core";
+export declare class LocalSandboxProvider implements SandboxProvider {
+    open(_runId: string): SandboxSession;
+}
+//# sourceMappingURL=local-provider.d.ts.map

package/dist/sandbox/local-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-provider.d.ts","sourceRoot":"","sources":["../../src/sandbox/local-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAItE,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;CAWrC"}

package/dist/sandbox/local-provider.js

@@ -0,0 +1,16 @@
+import { NodeFileSystem } from "../adapters/node-filesystem.js";
+import { NodeShell } from "../adapters/node-shell.js";
+export class LocalSandboxProvider {
+    open(_runId) {
+        return {
+            fs: new NodeFileSystem(),
+            shell: new NodeShell(),
+            // no lifecycle → the lease never suspends (nothing to suspend locally)
+            // no usage()   → nothing metered locally
+            async dispose() {
+                /* nothing to release on the local machine */
+            },
+        };
+    }
+}
+//# sourceMappingURL=local-provider.js.map

package/dist/sandbox/local-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-provider.js","sourceRoot":"","sources":["../../src/sandbox/local-provider.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,MAAM,OAAO,oBAAoB;IAC/B,IAAI,CAAC,MAAc;QACjB,OAAO;YACL,EAAE,EAAE,IAAI,cAAc,EAAE;YACxB,KAAK,EAAE,IAAI,SAAS,EAAE;YACtB,uEAAuE;YACvE,yCAAyC;YACzC,KAAK,CAAC,OAAO;gBACX,6CAA6C;YAC/C,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/sandbox/shell-backed-fs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ShellBackedFileSystem — a {@link FileSystem} implemented entirely over a
+ * {@link Shell}. Metadata ops map to coreutils (`test`, `mkdir`, `rm`, `mv`,
+ * `ls`, `find`, `stat`); data ops move bytes through `base64` so binary content
+ * survives the shell round-trip.
+ *
+ * This is the reusable core of any shell-only sandbox backend (Docker `exec`,
+ * a remote VM's `run`, …): give it a Shell and it becomes a full FileSystem,
+ * no backend-specific file API required. Backends with a native file-transfer
+ * primitive (Daytona `fs.uploadFile`, Arker `sync`) should override the data
+ * ops for efficiency; this class is the portable fallback.
+ *
+ * Assumes GNU coreutils (`find -printf`, `stat -c`) — i.e. a Linux container,
+ * which is the case for every sandbox backend. `base64`-over-argv also caps the
+ * practical single-file size at the shell's ARG_MAX; large binaries want a
+ * native transfer primitive.
+ */
+import type { FileSystem, FileEntry, FileStat, Shell } from "@polpo-ai/core";
+export declare class ShellBackedFileSystem implements FileSystem {
+    private readonly shell;
+    constructor(shell: Shell);
+    readFile(path: string): Promise<string>;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: string): Promise<void>;
+    writeFileBuffer(path: string, data: Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    readdirWithTypes(path: string): Promise<FileEntry[]>;
+    stat(path: string): Promise<FileStat>;
+}
+//# sourceMappingURL=shell-backed-fs.d.ts.map

package/dist/sandbox/shell-backed-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-backed-fs.d.ts","sourceRoot":"","sources":["../../src/sandbox/shell-backed-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAO7E,qBAAa,qBAAsB,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAapD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAoB5C"}

package/dist/sandbox/shell-backed-fs.js

@@ -0,0 +1,79 @@
+/** Single-quote a string for safe interpolation into a shell command. */
+function shq(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+export class ShellBackedFileSystem {
+    shell;
+    constructor(shell) {
+        this.shell = shell;
+    }
+    async readFile(path) {
+        return new TextDecoder().decode(await this.readFileBuffer(path));
+    }
+    async readFileBuffer(path) {
+        const r = await this.shell.execute(`base64 ${shq(path)}`);
+        if (r.exitCode !== 0)
+            throw new Error(`readFile ${path}: ${r.stderr.trim() || "failed"}`);
+        return Uint8Array.from(Buffer.from(r.stdout, "base64"));
+    }
+    async writeFile(path, content) {
+        await this.writeFileBuffer(path, new TextEncoder().encode(content));
+    }
+    async writeFileBuffer(path, data) {
+        const b64 = Buffer.from(data).toString("base64");
+        const r = await this.shell.execute(`printf '%s' ${shq(b64)} | base64 -d > ${shq(path)}`);
+        if (r.exitCode !== 0)
+            throw new Error(`writeFile ${path}: ${r.stderr.trim() || "failed"}`);
+    }
+    async exists(path) {
+        return (await this.shell.execute(`test -e ${shq(path)}`)).exitCode === 0;
+    }
+    async mkdir(path) {
+        const r = await this.shell.execute(`mkdir -p ${shq(path)}`);
+        if (r.exitCode !== 0)
+            throw new Error(`mkdir ${path}: ${r.stderr.trim() || "failed"}`);
+    }
+    async remove(path) {
+        await this.shell.execute(`rm -rf ${shq(path)}`);
+    }
+    async rename(oldPath, newPath) {
+        const r = await this.shell.execute(`mv ${shq(oldPath)} ${shq(newPath)}`);
+        if (r.exitCode !== 0)
+            throw new Error(`rename ${oldPath} → ${newPath}: ${r.stderr.trim() || "failed"}`);
+    }
+    async readdir(path) {
+        const r = await this.shell.execute(`ls -1A ${shq(path)}`);
+        return r.exitCode === 0 ? r.stdout.split("\n").filter(Boolean) : [];
+    }
+    async readdirWithTypes(path) {
+        // `find` one level deep with a type marker: "d\t<name>" or "f\t<name>".
+        const r = await this.shell.execute(`find ${shq(path)} -mindepth 1 -maxdepth 1 -printf '%y\\t%f\\n' 2>/dev/null`);
+        if (r.exitCode !== 0)
+            return [];
+        return r.stdout.split("\n").filter(Boolean).map((line) => {
+            const [ty, name] = line.split("\t");
+            const isDirectory = ty === "d";
+            return { name: name ?? "", isDirectory, isFile: !isDirectory };
+        });
+    }
+    async stat(path) {
+        // Numeric size + mtime (locale-independent), then a d/f type marker via
+        // `test -d`. `stat -c`'s `%F` is localized ("regular file" / "file
+        // regolare") and `-c` does not interpret `\n`, so avoid both. The `&&`
+        // makes a missing path fail (stat's non-zero exit propagates).
+        const p = shq(path);
+        const r = await this.shell.execute(`stat --printf='%s %Y ' ${p} && ( [ -d ${p} ] && echo d || echo f )`);
+        if (r.exitCode !== 0)
+            throw new Error(`stat ${path}: not found`);
+        const [sizeStr, mtimeStr, kind] = r.stdout.trim().split(/\s+/);
+        const isDirectory = kind === "d";
+        const mtime = Number(mtimeStr);
+        return {
+            size: Number(sizeStr) || 0,
+            isDirectory,
+            isFile: !isDirectory,
+            modifiedAt: Number.isFinite(mtime) ? new Date(mtime * 1000) : undefined,
+        };
+    }
+}
+//# sourceMappingURL=shell-backed-fs.js.map

package/dist/sandbox/shell-backed-fs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/node",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Polpo Node.js runtime — orchestrator wiring, adapters, server assembly, runner entry. The composition root behind the polpo-ai package.",
   "type": "module",
   "main": "dist/index.js",
@@ -44,12 +44,12 @@
     "nanoid": "^5.1.2",
     "yaml": "^2.7.0",
     "zod": "^4.3.6",
-    "@polpo-ai/core": "0.13.1",
-    "@polpo-ai/llm": "0.13.1",
-    "@polpo-ai/file-stores": "0.13.1",
-    "@polpo-ai/server": "0.13.1",
-    "@polpo-ai/tools": "0.13.1",
-    "@polpo-ai/vault-crypto": "0.13.1"
+    "@polpo-ai/server": "0.14.0",
+    "@polpo-ai/llm": "0.14.0",
+    "@polpo-ai/vault-crypto": "0.14.0",
+    "@polpo-ai/core": "0.14.0",
+    "@polpo-ai/tools": "0.14.0",
+    "@polpo-ai/file-stores": "0.14.0"
   },
   "optionalDependencies": {
     "better-sqlite3": "^12.6.2",
@@ -57,7 +57,7 @@
     "nodemailer": "^8.0.1",
     "playwright-core": "^1.52.0",
     "postgres": "^3.4.0",
-    "@polpo-ai/drizzle": "0.13.1"
+    "@polpo-ai/drizzle": "0.14.0"
   },
   "license": "MIT",
   "repository": {