@sapiom/tools 0.1.0

package/dist/esm/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@sapiom/tools` — the typed Sapiom capability client.
+ *
+ * The same catalog your agents call over MCP, callable from code. Capabilities are
+ * namespaces (`sandboxes`, `repositories`, `agent`, … ), importable from the barrel
+ * or a subpath:
+ *
+ *   import { sandboxes } from "@sapiom/tools";
+ *   import { sandboxes } from "@sapiom/tools/sandboxes";
+ *
+ * Auth is implicit: ambient (engine-injected) inside a workflow step, or explicit
+ * via `createClient({ apiKey })` standalone.
+ */
+export { createClient } from "./client.js";
+export type { Sapiom } from "./client.js";
+export type { TransportConfig, Attribution } from "./_client/index.js";
+export * as sandboxes from "./sandboxes/index.js";
+export { Sandbox } from "./sandboxes/index.js";
+export * as repositories from "./repositories/index.js";
+export { Repository } from "./repositories/index.js";
+export * as agent from "./agent/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@sapiom/tools` — the typed Sapiom capability client.
+ *
+ * The same catalog your agents call over MCP, callable from code. Capabilities are
+ * namespaces (`sandboxes`, `repositories`, `agent`, … ), importable from the barrel
+ * or a subpath:
+ *
+ *   import { sandboxes } from "@sapiom/tools";
+ *   import { sandboxes } from "@sapiom/tools/sandboxes";
+ *
+ * Auth is implicit: ambient (engine-injected) inside a workflow step, or explicit
+ * via `createClient({ apiKey })` standalone.
+ */
+export { createClient } from "./client.js";
+export * as sandboxes from "./sandboxes/index.js";
+export { Sandbox } from "./sandboxes/index.js";
+export * as repositories from "./repositories/index.js";
+export { Repository } from "./repositories/index.js";
+export * as agent from "./agent/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/dist/esm/repositories/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `repositories` capability — in-network git repos: create, get, list, delete, and
+ * the first cross-capability mesh method, `repo.pushFromSandbox(sandbox)`.
+ *
+ *   import { repositories } from "@sapiom/tools";
+ *   const repo = await repositories.create("my-app");
+ *   // … an agent or your code writes files in a sandbox checkout of the repo …
+ *   await repo.pushFromSandbox(box, { message: "build: page" });
+ *
+ * `pushFromSandbox` is the deterministic counterpart to a fuzzy agent step: it
+ * composes the `sandboxes` capability (calls `sandbox.exec`) to commit + push the
+ * repo's working tree. It references the `Sandbox` TYPE only — no module cycle.
+ *
+ * Note: `cloneUrl` is the unauthenticated origin. The gateway authenticates clones
+ * via basic-auth (the `auth` block returned by create); inside an agent run the
+ * `gitRepository` auto-clone wires that credential into the in-sandbox origin, so
+ * `pushFromSandbox` doesn't need it.
+ */
+import { Transport } from "../_client/index.js";
+import type { Sandbox } from "../sandboxes/index.js";
+export interface PushResult {
+    /** False when there was nothing to commit. */
+    pushed: boolean;
+    sha: string | null;
+}
+/** A connected in-network repository. */
+export declare class Repository {
+    readonly slug: string;
+    /** Unauthenticated clone origin (see module note on auth). */
+    readonly cloneUrl: string;
+    readonly status: string;
+    private readonly transport;
+    private readonly baseUrl;
+    private constructor();
+    static create(slug: string, transport?: Transport, baseUrl?: string): Promise<Repository>;
+    static get(slug: string, transport?: Transport, baseUrl?: string): Promise<Repository>;
+    static list(transport?: Transport, baseUrl?: string): Promise<Repository[]>;
+    static delete(slug: string, transport?: Transport, baseUrl?: string): Promise<void>;
+    /** Adopt a known repo without a round-trip (e.g. one returned from another step). */
+    static attach(slug: string, cloneUrl: string, transport?: Transport, baseUrl?: string): Repository;
+    /** Delete this repository. */
+    delete(): Promise<void>;
+    /**
+     * Deterministically stage + commit + push this repo's working tree FROM a
+     * sandbox checkout (no LLM). Assumes the repo is checked out at the canonical
+     * `/workspace/<slug>` with an authenticated `origin` (which the agent's
+     * `gitRepository` auto-clone sets up). No-op when there's nothing to commit.
+     */
+    pushFromSandbox(sandbox: Sandbox, opts?: {
+        message?: string;
+    }): Promise<PushResult>;
+}
+export declare function create(slug: string): Promise<Repository>;
+export declare function get(slug: string): Promise<Repository>;
+export declare function list(): Promise<Repository[]>;
+export declare function attach(slug: string, cloneUrl: string): Repository;
+declare function deleteRepository(slug: string): Promise<void>;
+export { deleteRepository as delete };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/repositories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAuBrD,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,yCAAyC;AACzC,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO;WAYM,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,SAA8B,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;WAShH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,SAA8B,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;WAK7G,IAAI,CAAC,SAAS,GAAE,SAA8B,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;WAKlG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,SAA8B,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvH,qFAAqF;IACrF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,SAA8B,EAAE,OAAO,SAAmB,GAAG,UAAU;IAIhI,8BAA8B;IAC9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgB9F;AAGD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAExD;AACD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAErD;AACD,wBAAgB,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAE5C;AACD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAEjE;AACD,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AACD,OAAO,EAAE,gBAAgB,IAAI,MAAM,EAAE,CAAC"}

package/dist/esm/repositories/index.js

@@ -0,0 +1,99 @@
+/**
+ * `repositories` capability — in-network git repos: create, get, list, delete, and
+ * the first cross-capability mesh method, `repo.pushFromSandbox(sandbox)`.
+ *
+ *   import { repositories } from "@sapiom/tools";
+ *   const repo = await repositories.create("my-app");
+ *   // … an agent or your code writes files in a sandbox checkout of the repo …
+ *   await repo.pushFromSandbox(box, { message: "build: page" });
+ *
+ * `pushFromSandbox` is the deterministic counterpart to a fuzzy agent step: it
+ * composes the `sandboxes` capability (calls `sandbox.exec`) to commit + push the
+ * repo's working tree. It references the `Sandbox` TYPE only — no module cycle.
+ *
+ * Note: `cloneUrl` is the unauthenticated origin. The gateway authenticates clones
+ * via basic-auth (the `auth` block returned by create); inside an agent run the
+ * `gitRepository` auto-clone wires that credential into the in-sandbox origin, so
+ * `pushFromSandbox` doesn't need it.
+ */
+import { defaultTransport } from "../_client/index.js";
+const DEFAULT_BASE_URL = process.env.SAPIOM_GIT_URL || "https://git.services.sapiom.ai";
+/** Canonical in-sandbox checkout path (matches the agent's `gitRepository` auto-clone). */
+const checkoutDir = (slug) => `/workspace/${slug}`;
+/** A connected in-network repository. */
+export class Repository {
+    constructor(fields, transport, baseUrl) {
+        this.slug = fields.slug;
+        this.cloneUrl = fields.cloneUrl;
+        this.status = fields.status;
+        this.transport = transport;
+        this.baseUrl = baseUrl;
+    }
+    static async create(slug, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+        const r = await transport.request(`${baseUrl}/v1/git/repositories`, {
+            method: "POST",
+            body: JSON.stringify({ slug }),
+        });
+        // create doesn't return a status; a just-created repo is active.
+        return new Repository({ slug: r.slug, cloneUrl: r.cloneUrl, status: "active" }, transport, baseUrl);
+    }
+    static async get(slug, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+        const r = await transport.request(`${baseUrl}/v1/git/repositories/${encodeURIComponent(slug)}`);
+        return new Repository(r, transport, baseUrl);
+    }
+    static async list(transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+        const r = await transport.request(`${baseUrl}/v1/git/repositories`);
+        return r.repositories.map((s) => new Repository(s, transport, baseUrl));
+    }
+    static async delete(slug, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+        await transport.request(`${baseUrl}/v1/git/repositories/${encodeURIComponent(slug)}`, { method: "DELETE" }).catch(() => undefined);
+    }
+    /** Adopt a known repo without a round-trip (e.g. one returned from another step). */
+    static attach(slug, cloneUrl, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+        return new Repository({ slug, cloneUrl, status: "active" }, transport, baseUrl);
+    }
+    /** Delete this repository. */
+    delete() {
+        return Repository.delete(this.slug, this.transport, this.baseUrl);
+    }
+    /**
+     * Deterministically stage + commit + push this repo's working tree FROM a
+     * sandbox checkout (no LLM). Assumes the repo is checked out at the canonical
+     * `/workspace/<slug>` with an authenticated `origin` (which the agent's
+     * `gitRepository` auto-clone sets up). No-op when there's nothing to commit.
+     */
+    async pushFromSandbox(sandbox, opts = {}) {
+        const message = (opts.message ?? `update ${this.slug}`).replace(/'/g, ""); // single-quote-safe for sh -c
+        const script = `cd ${checkoutDir(this.slug)} && git add -A && ` +
+            `if git diff --cached --quiet; then echo NO_CHANGES; else ` +
+            `git -c user.email=workflow@sapiom.ai -c user.name=sapiom-workflow commit -m "${message}" >/dev/null && ` +
+            `git push origin HEAD && printf "SHA:%s\\n" "$(git rev-parse HEAD)"; fi`;
+        const { stdout, stderr, exitCode } = await sandbox.exec(`sh -c '${script}'`);
+        const out = `${stdout}\n${stderr}`;
+        if (out.includes("NO_CHANGES"))
+            return { pushed: false, sha: null };
+        const sha = out.match(/SHA:([0-9a-f]{7,40})/)?.[1] ?? null;
+        if (exitCode !== 0 || !sha) {
+            throw new Error(`pushFromSandbox(${this.slug}) failed (exit ${exitCode}): ${out.slice(-300)}`);
+        }
+        return { pushed: true, sha };
+    }
+}
+// Ambient-bound namespace functions.
+export function create(slug) {
+    return Repository.create(slug);
+}
+export function get(slug) {
+    return Repository.get(slug);
+}
+export function list() {
+    return Repository.list();
+}
+export function attach(slug, cloneUrl) {
+    return Repository.attach(slug, cloneUrl);
+}
+function deleteRepository(slug) {
+    return Repository.delete(slug);
+}
+export { deleteRepository as delete };
+//# sourceMappingURL=index.js.map

package/dist/esm/repositories/index.js.map

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

package/dist/esm/sandboxes/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `sandbox` capability — an isolated, ephemeral compute instance for running code
+ * or agents securely: create, exec (sync / fire-and-forget / streaming), read &
+ * write files, then destroy. Ported from the legacy `@sapiom/sandbox` onto the
+ * `_client` transport, with the Blaxel specifics removed:
+ *   - auth comes from the transport (ambient or explicit), not per-call apiKey
+ *   - the host is a platform routing detail (overridable), not a "blaxel" concept
+ *   - custom image build (the Blaxel-runtime Dockerfile) is deferred, not exposed
+ *
+ *   import { sandbox } from "@sapiom/tools";          // ambient auth
+ *   const box = await sandbox.create({ name: "demo" });
+ *   const { stdout } = await box.exec("echo hi");
+ *   await box.destroy();
+ */
+import { Transport } from "../_client/index.js";
+import type { ExecOptions, ExecResult, ExecStreamOptions, ProcessStatus, SandboxCreateOptions, StreamingExecResult } from "./types.js";
+export type { ExecOptions, ExecResult, ExecStreamOptions, OutputLine, PortSpec, ProcessStatus, SandboxCreateOptions, SandboxTier, StreamingExecResult, } from "./types.js";
+/** A live sandbox handle. Create via {@link create}; pass between steps to share state. */
+export declare class Sandbox {
+    /** Name / identifier of the sandbox. */
+    readonly name: string;
+    /** Absolute workspace root path inside the sandbox. */
+    readonly workspaceRoot: string;
+    private readonly transport;
+    private readonly baseUrl;
+    private constructor();
+    /** Create a sandbox and return a handle. Uses the ambient transport unless one is supplied. */
+    static create(opts: SandboxCreateOptions, transport?: Transport): Promise<Sandbox>;
+    /** Adopt an existing sandbox by name (e.g. one a prior step kept). */
+    static attach(name: string, opts?: {
+        workspaceRoot?: string;
+        baseUrl?: string;
+    }, transport?: Transport): Sandbox;
+    private fileUrl;
+    private procUrl;
+    /** Write a file (path relative to the workspace root). */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Read a file (path relative to the workspace root). */
+    readFile(path: string): Promise<string>;
+    /**
+     * Execute a command. Waits for completion by default; set `waitForCompletion:
+     * false` for fire-and-forget, or use {@link execStream} for real-time output.
+     */
+    exec(command: string, opts?: ExecOptions): Promise<ExecResult>;
+    /** Execute a command and stream output lines in real time. `exitCode` populates after `output` drains. */
+    execStream(command: string, opts?: ExecStreamOptions): Promise<StreamingExecResult>;
+    /** Current status of a process by PID (useful for fire-and-forget execs). */
+    getProcess(pid: string): Promise<ProcessStatus>;
+    /** Wait for a process to finish by polling its status. */
+    waitForProcess(pid: string, opts?: {
+        pollInterval?: number;
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecResult>;
+    /** Destroy the sandbox and release its resources. */
+    destroy(): Promise<void>;
+    private createProcess;
+    private pollProcess;
+}
+/** Create a sandbox (ambient transport). The namespace's primary entry point. */
+export declare function create(opts: SandboxCreateOptions): Promise<Sandbox>;
+/** Adopt an existing sandbox by name (ambient transport). */
+export declare function attach(name: string, opts?: {
+    workspaceRoot?: string;
+    baseUrl?: string;
+}): Sandbox;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/sandboxes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sandboxes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,iBAAiB,EAGjB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AA0BpB,2FAA2F;AAC3F,qBAAa,OAAO;IAClB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO;IAOP,+FAA+F;WAClF,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,GAAE,SAA8B,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB5G,sEAAsE;IACtE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,EAAE,SAAS,GAAE,SAA8B,GAAG,OAAO;IAIxI,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,OAAO;IAIf,0DAA0D;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D,yDAAyD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO7C;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAWpE,0GAA0G;IACpG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4DzF,6EAA6E;IACvE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMrD,0DAA0D;IACpD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAIhI,qDAAqD;IAC/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOhB,aAAa;YAqBb,WAAW;CAc1B;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEjG"}

package/dist/esm/sandboxes/index.js

@@ -0,0 +1,249 @@
+/**
+ * `sandbox` capability — an isolated, ephemeral compute instance for running code
+ * or agents securely: create, exec (sync / fire-and-forget / streaming), read &
+ * write files, then destroy. Ported from the legacy `@sapiom/sandbox` onto the
+ * `_client` transport, with the Blaxel specifics removed:
+ *   - auth comes from the transport (ambient or explicit), not per-call apiKey
+ *   - the host is a platform routing detail (overridable), not a "blaxel" concept
+ *   - custom image build (the Blaxel-runtime Dockerfile) is deferred, not exposed
+ *
+ *   import { sandbox } from "@sapiom/tools";          // ambient auth
+ *   const box = await sandbox.create({ name: "demo" });
+ *   const { stdout } = await box.exec("echo hi");
+ *   await box.destroy();
+ */
+import { defaultTransport } from "../_client/index.js";
+/** Platform sandbox service. Host routing is an internal detail — override via `baseUrl` or SAPIOM_SANDBOX_URL. */
+const DEFAULT_BASE_URL = process.env.SAPIOM_SANDBOX_URL || "https://blaxel.services.sapiom.ai";
+const DEFAULT_POLL_INTERVAL = 1000;
+const DEFAULT_EXEC_TIMEOUT = 60000;
+function assertRelativePath(path) {
+    if (path.split("/").some((seg) => seg === "..")) {
+        throw new Error(`Path must not contain '..' segments: ${path}`);
+    }
+}
+function encodePathSegments(path) {
+    return path
+        .split("/")
+        .map((seg) => encodeURIComponent(seg))
+        .join("/");
+}
+function parseOutputLine(line) {
+    if (line.startsWith("stdout:"))
+        return { stream: "stdout", data: line.slice(7) };
+    if (line.startsWith("stderr:"))
+        return { stream: "stderr", data: line.slice(7) };
+    return { stream: "stdout", data: line }; // unrecognized framing — keep, don't drop
+}
+/** A live sandbox handle. Create via {@link create}; pass between steps to share state. */
+export class Sandbox {
+    constructor(name, workspaceRoot, transport, baseUrl) {
+        this.name = name;
+        this.workspaceRoot = workspaceRoot;
+        this.transport = transport;
+        this.baseUrl = baseUrl;
+    }
+    /** Create a sandbox and return a handle. Uses the ambient transport unless one is supplied. */
+    static async create(opts, transport = defaultTransport()) {
+        if (opts.port !== undefined && opts.ports !== undefined) {
+            throw new Error("Cannot specify both 'port' and 'ports'");
+        }
+        const baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
+        const body = { name: opts.name };
+        if (opts.tier !== undefined)
+            body.tier = opts.tier;
+        if (opts.ttl !== undefined)
+            body.ttl = opts.ttl;
+        if (opts.envs !== undefined)
+            body.envs = opts.envs;
+        if (opts.port !== undefined)
+            body.port = opts.port;
+        if (opts.ports !== undefined)
+            body.ports = opts.ports;
+        if (opts.image !== undefined)
+            body.image = opts.image;
+        const res = await transport.fetch(`${baseUrl}/v1/sandboxes`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to create sandbox: ${res.status} ${await res.text()}`);
+        const data = (await res.json());
+        return new Sandbox(data.name, data.workspaceRoot, transport, baseUrl);
+    }
+    /** Adopt an existing sandbox by name (e.g. one a prior step kept). */
+    static attach(name, opts = {}, transport = defaultTransport()) {
+        return new Sandbox(name, opts.workspaceRoot ?? "/", transport, opts.baseUrl ?? DEFAULT_BASE_URL);
+    }
+    fileUrl(path) {
+        assertRelativePath(path);
+        const base = this.workspaceRoot.endsWith("/") ? this.workspaceRoot.slice(0, -1) : this.workspaceRoot;
+        const rel = path.startsWith("/") ? path.slice(1) : path;
+        const abs = `${base}/${rel}`.replace(/^\//, "");
+        return `${this.baseUrl}/v1/sandboxes/${encodeURIComponent(this.name)}/filesystem/${encodePathSegments(abs)}`;
+    }
+    procUrl(suffix = "") {
+        return `${this.baseUrl}/v1/sandboxes/${encodeURIComponent(this.name)}/process${suffix}`;
+    }
+    /** Write a file (path relative to the workspace root). */
+    async writeFile(path, content) {
+        const res = await this.transport.fetch(this.fileUrl(path), {
+            method: "PUT",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ content }),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to write file '${path}': ${res.status} ${await res.text()}`);
+    }
+    /** Read a file (path relative to the workspace root). */
+    async readFile(path) {
+        const res = await this.transport.fetch(this.fileUrl(path));
+        if (!res.ok)
+            throw new Error(`Failed to read file '${path}': ${res.status} ${await res.text()}`);
+        const data = (await res.json());
+        return data.content;
+    }
+    /**
+     * Execute a command. Waits for completion by default; set `waitForCompletion:
+     * false` for fire-and-forget, or use {@link execStream} for real-time output.
+     */
+    async exec(command, opts) {
+        const proc = await this.createProcess(command, opts);
+        if (proc.status === "completed") {
+            return { pid: proc.pid, exitCode: proc.exitCode ?? 0, stdout: proc.stdout ?? "", stderr: proc.stderr ?? "" };
+        }
+        if (opts?.waitForCompletion === false) {
+            return { pid: proc.pid, exitCode: -1, stdout: proc.stdout ?? "", stderr: proc.stderr ?? "" };
+        }
+        return this.pollProcess(proc.pid, opts);
+    }
+    /** Execute a command and stream output lines in real time. `exitCode` populates after `output` drains. */
+    async execStream(command, opts) {
+        const proc = await this.createProcess(command, opts);
+        if (proc.status === "completed") {
+            const code = proc.exitCode ?? 0;
+            const stdout = proc.stdout ?? "";
+            const stderr = proc.stderr ?? "";
+            const output = (async function* () {
+                if (stdout)
+                    yield { stream: "stdout", data: stdout };
+                if (stderr)
+                    yield { stream: "stderr", data: stderr };
+            })();
+            return { pid: proc.pid, get exitCode() { return code; }, output };
+        }
+        let finalExitCode = -1;
+        const transport = this.transport;
+        const signal = opts?.signal;
+        const logsUrl = this.procUrl(`/${proc.pid}/logs/stream`);
+        const statusUrl = this.procUrl(`/${proc.pid}`);
+        async function* streamOutput() {
+            const res = await transport.fetch(logsUrl, { signal });
+            if (!res.ok)
+                throw new Error(`Failed to stream process ${proc.pid}: ${res.status} ${await res.text()}`);
+            if (!res.body)
+                throw new Error(`No response body for process ${proc.pid} log stream`);
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            try {
+                for (;;) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split("\n");
+                    buffer = lines.pop();
+                    for (const line of lines)
+                        if (line)
+                            yield parseOutputLine(line);
+                }
+                buffer += decoder.decode();
+                if (buffer)
+                    yield parseOutputLine(buffer);
+            }
+            finally {
+                reader.releaseLock();
+            }
+            let status = await readStatus();
+            while (status.status !== "completed") {
+                await new Promise((r) => setTimeout(r, 1000));
+                status = await readStatus();
+            }
+            finalExitCode = status.exitCode ?? 0;
+            async function readStatus() {
+                const s = await transport.fetch(statusUrl, { signal });
+                if (!s.ok)
+                    throw new Error(`Failed to get final status for process ${proc.pid}: ${s.status} ${await s.text()}`);
+                return (await s.json());
+            }
+        }
+        return { pid: proc.pid, get exitCode() { return finalExitCode; }, output: streamOutput() };
+    }
+    /** Current status of a process by PID (useful for fire-and-forget execs). */
+    async getProcess(pid) {
+        const res = await this.transport.fetch(this.procUrl(`/${pid}`));
+        if (!res.ok)
+            throw new Error(`Failed to get process ${pid}: ${res.status} ${await res.text()}`);
+        return (await res.json());
+    }
+    /** Wait for a process to finish by polling its status. */
+    async waitForProcess(pid, opts) {
+        return this.pollProcess(pid, opts);
+    }
+    /** Destroy the sandbox and release its resources. */
+    async destroy() {
+        const res = await this.transport.fetch(`${this.baseUrl}/v1/sandboxes/${encodeURIComponent(this.name)}`, { method: "DELETE" });
+        if (!res.ok)
+            throw new Error(`Failed to destroy sandbox: ${res.status} ${await res.text()}`);
+    }
+    // --- internal ---
+    async createProcess(command, opts) {
+        const body = { command };
+        if (opts?.cwd !== undefined) {
+            assertRelativePath(opts.cwd);
+            const base = this.workspaceRoot.endsWith("/") ? this.workspaceRoot.slice(0, -1) : this.workspaceRoot;
+            body.cwd = `${base}/${opts.cwd.startsWith("/") ? opts.cwd.slice(1) : opts.cwd}`;
+        }
+        if (opts?.env !== undefined)
+            body.env = opts.env;
+        if (opts?.keepAlive !== undefined)
+            body.keepAlive = opts.keepAlive;
+        if (opts?.processTimeout !== undefined)
+            body.timeout = opts.processTimeout;
+        const res = await this.transport.fetch(this.procUrl(), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+            signal: opts?.signal,
+        });
+        if (!res.ok)
+            throw new Error(`Failed to execute command: ${res.status} ${await res.text()}`);
+        return (await res.json());
+    }
+    async pollProcess(pid, opts) {
+        const pollInterval = opts?.pollInterval ?? DEFAULT_POLL_INTERVAL;
+        const deadline = Date.now() + (opts?.timeout ?? DEFAULT_EXEC_TIMEOUT);
+        while (Date.now() < deadline) {
+            const res = await this.transport.fetch(this.procUrl(`/${pid}`), { signal: opts?.signal });
+            if (!res.ok)
+                throw new Error(`Failed to poll process ${pid}: ${res.status} ${await res.text()}`);
+            const status = (await res.json());
+            if (status.status === "completed") {
+                return { pid, exitCode: status.exitCode ?? 0, stdout: status.stdout ?? "", stderr: status.stderr ?? "" };
+            }
+            await new Promise((r) => setTimeout(r, pollInterval));
+        }
+        throw new Error(`Process ${pid} timed out after ${opts?.timeout ?? DEFAULT_EXEC_TIMEOUT}ms`);
+    }
+}
+/** Create a sandbox (ambient transport). The namespace's primary entry point. */
+export function create(opts) {
+    return Sandbox.create(opts);
+}
+/** Adopt an existing sandbox by name (ambient transport). */
+export function attach(name, opts) {
+    return Sandbox.attach(name, opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/sandboxes/index.js.map

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