@sapiom/tools 0.1.2 → 0.2.0

package/dist/esm/file-storage/index.js

@@ -0,0 +1,129 @@
+/**
+ * `fileStorage` capability — tenant-scoped object storage on presigned GCS URLs.
+ *
+ * The control plane only: `upload` hands back a presigned URL you PUT the bytes to
+ * yourself (so you own streaming / progress / resumable uploads), and
+ * `getDownloadUrl` hands back a presigned URL you GET. `list`, `setVisibility`, and
+ * `delete` round out the lifecycle.
+ *
+ *   import { fileStorage } from "@sapiom/tools";              // ambient auth
+ *   const { uploadUrl, requiredHeaders } = await fileStorage.upload({
+ *     contentType: "image/png",
+ *     fileName: "photo.png",
+ *   });
+ *   await fetch(uploadUrl, { method: "PUT", headers: requiredHeaders, body: bytes });
+ *
+ * Or via an explicit client: `createClient({ apiKey }).fileStorage.upload(...)`.
+ *
+ * Wire fields are snake_case; this module maps them to the camelCase SDK surface.
+ * Byte counts are int64 — the gateway serializes them as strings (precision-safe),
+ * so `expectedFileSize` / `actualFileSize` on returned metadata are `string | null`.
+ */
+import { defaultTransport } from "../_client/index.js";
+import { ensureOk, FileStorageHttpError } from "./errors.js";
+export { FileStorageHttpError };
+/** Object storage service. Host routing is an internal detail — override via SAPIOM_FILE_STORAGE_URL. */
+const DEFAULT_BASE_URL = process.env.SAPIOM_FILE_STORAGE_URL ||
+    "https://file-storage.services.sapiom.ai";
+function mapFileMetadata(raw) {
+    return {
+        fileId: raw.file_id,
+        ...(raw.file_name !== undefined && { fileName: raw.file_name }),
+        contentType: raw.content_type,
+        visibility: raw.visibility,
+        status: raw.status,
+        ...(raw.expected_file_size !== undefined && {
+            expectedFileSize: raw.expected_file_size,
+        }),
+        ...(raw.actual_file_size !== undefined && {
+            actualFileSize: raw.actual_file_size,
+        }),
+        createdAt: raw.created_at,
+        ...(raw.uploaded_at !== undefined && { uploadedAt: raw.uploaded_at }),
+        ...(raw.deleted_at !== undefined && { deletedAt: raw.deleted_at }),
+        downloadRequestCount: raw.download_request_count,
+    };
+}
+// ----- capability operations -----
+/**
+ * Initiate an upload. Returns a presigned GCS URL; PUT the bytes to `uploadUrl`
+ * with `requiredHeaders` yourself (this capability owns only the control plane).
+ */
+export async function upload(input, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+    const body = { content_type: input.contentType };
+    if (input.fileName !== undefined)
+        body.file_name = input.fileName;
+    if (input.visibility !== undefined)
+        body.visibility = input.visibility;
+    if (input.expectedFileSize !== undefined) {
+        body.expected_file_size = input.expectedFileSize;
+    }
+    const res = await ensureOk(await transport.fetch(`${baseUrl}/upload`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    }), "Failed to initiate file upload");
+    const raw = (await res.json());
+    return {
+        fileId: raw.file_id,
+        uploadUrl: raw.upload_url,
+        expiresAt: raw.expires_at,
+        requiredHeaders: raw.required_headers,
+    };
+}
+/** Generate a presigned download URL for a file. */
+export async function getDownloadUrl(fileId, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+    const res = await ensureOk(await transport.fetch(`${baseUrl}/download/${encodeURIComponent(fileId)}`), `Failed to get download URL for file '${fileId}'`);
+    const raw = (await res.json());
+    return { downloadUrl: raw.download_url, expiresAt: raw.expires_at };
+}
+/** List files owned by the authenticated tenant. */
+export async function list(opts, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+    const url = new URL(`${baseUrl}/files`);
+    if (opts?.limit !== undefined) {
+        url.searchParams.set("limit", String(opts.limit));
+    }
+    if (opts?.offset !== undefined) {
+        url.searchParams.set("offset", String(opts.offset));
+    }
+    const res = await ensureOk(await transport.fetch(url.toString()), "Failed to list files");
+    const raw = (await res.json());
+    return {
+        files: raw.files.map(mapFileMetadata),
+        limit: raw.limit,
+        offset: raw.offset,
+        hasMore: raw.has_more,
+    };
+}
+/** Update a file's visibility. */
+export async function setVisibility(fileId, visibility, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+    const res = await ensureOk(await transport.fetch(`${baseUrl}/${encodeURIComponent(fileId)}`, {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ visibility }),
+    }), `Failed to set visibility for file '${fileId}'`);
+    const raw = (await res.json());
+    return mapFileMetadata(raw);
+}
+/**
+ * Delete a file. Idempotent on the gateway (deleting an already-deleted file is a
+ * no-op success). Exported as `delete`:
+ * `import { fileStorage } from "@sapiom/tools"; await fileStorage.delete(id)`.
+ */
+async function deleteFile(fileId, transport = defaultTransport(), baseUrl = DEFAULT_BASE_URL) {
+    const res = await transport.fetch(`${baseUrl}/${encodeURIComponent(fileId)}`, { method: "DELETE" });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = text;
+        }
+        throw new FileStorageHttpError(`Failed to delete file '${fileId}': ${res.status} ${text}`, res.status, parsed);
+    }
+    // 204 No Content — nothing to parse.
+}
+export { deleteFile as delete };
+//# sourceMappingURL=index.js.map

package/dist/esm/file-storage/index.js.map

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

package/dist/esm/index.d.ts

@@ -2,8 +2,8 @@
  * `@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:
+ * namespaces (`sandboxes`, `repositories`, `agent`, `fileStorage`, … ), importable
+ * from the barrel or a subpath:
  *
  *   import { sandboxes } from "@sapiom/tools";
  *   import { sandboxes } from "@sapiom/tools/sandboxes";
@@ -21,4 +21,6 @@ export * as repositories from "./repositories/index.js";
 export { Repository } from "./repositories/index.js";
 export * as agent from "./agent/index.js";
 export { CODING_RESULT_SIGNAL } from "./agent/index.js";
+export * as fileStorage from "./file-storage/index.js";
+export { FileStorageHttpError } from "./file-storage/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,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;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,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;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/index.js

@@ -2,8 +2,8 @@
  * `@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:
+ * namespaces (`sandboxes`, `repositories`, `agent`, `fileStorage`, … ), importable
+ * from the barrel or a subpath:
  *
  *   import { sandboxes } from "@sapiom/tools";
  *   import { sandboxes } from "@sapiom/tools/sandboxes";
@@ -19,4 +19,6 @@ export { Repository } from "./repositories/index.js";
 export * as agent from "./agent/index.js";
 // Surfaced top-level for the static `pause: { signal }` decl on a workflow step.
 export { CODING_RESULT_SIGNAL } from "./agent/index.js";
+export * as fileStorage from "./file-storage/index.js";
+export { FileStorageHttpError } from "./file-storage/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQhE,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;AAC1C,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQhE,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;AAC1C,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,27 +1,21 @@
 /**
  * `repositories` capability — in-network git repos: create, get, list, delete, and
- * the first cross-capability mesh method, `repo.pushFromSandbox(sandbox)`.
+ * `repo.pushFromSandbox(sandbox)` to commit + push a sandbox checkout.
  *
  *   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. */
+    /** True once your work has been pushed to the repo. */
     pushed: boolean;
+    /** The pushed commit SHA, when available. */
     sha: string | null;
+    /** The branch it was pushed to, when available. */
+    branch?: string | null;
 }
 /** A connected in-network repository. */
 export declare class Repository {
@@ -41,13 +35,17 @@ export declare class 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.
+     * Commit and push this repo's working tree from a sandbox checkout. Commits any
+     * pending changes and pushes the current commit, so the agent's work is
+     * published whether it left changes uncommitted, already committed them, or
+     * both. Returns `{ pushed, sha, branch }`; throws if the push fails.
+     *
+     * `workingDirectory` defaults to the repo's checkout at `/workspace/<slug>`
+     * (where a coding agent run with `gitRepository: repo` clones it).
      */
     pushFromSandbox(sandbox: Sandbox, opts?: {
         message?: string;
+        workingDirectory?: string;
     }): Promise<PushResult>;
 }
 export declare function create(slug: string): Promise<Repository>;

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

@@ -1 +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;AA6BrD,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,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,CAAC;WAgBT,GAAG,CACd,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,CAAC;WAOT,IAAI,CACf,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,EAAE,CAAC;WAOX,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,IAAI,CAAC;IAQhB,qFAAqF;IACrF,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,UAAU;IAQb,8BAA8B;IAC9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9B,OAAO,CAAC,UAAU,CAAC;CAoBvB;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA0BrD,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;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,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,CAAC;WAgBT,GAAG,CACd,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,CAAC;WAOT,IAAI,CACf,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,UAAU,EAAE,CAAC;WAOX,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,IAAI,CAAC;IAQhB,qFAAqF;IACrF,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,UAAU;IAQb,8BAA8B;IAC9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB;;;;;;;;OAQG;IACG,eAAe,CACnB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GACzD,OAAO,CAAC,UAAU,CAAC;CAevB;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

@@ -1,25 +1,14 @@
 /**
  * `repositories` capability — in-network git repos: create, get, list, delete, and
- * the first cross-capability mesh method, `repo.pushFromSandbox(sandbox)`.
+ * `repo.pushFromSandbox(sandbox)` to commit + push a sandbox checkout.
  *
  *   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) {
@@ -61,26 +50,25 @@ export class Repository {
         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.
+     * Commit and push this repo's working tree from a sandbox checkout. Commits any
+     * pending changes and pushes the current commit, so the agent's work is
+     * published whether it left changes uncommitted, already committed them, or
+     * both. Returns `{ pushed, sha, branch }`; throws if the push fails.
+     *
+     * `workingDirectory` defaults to the repo's checkout at `/workspace/<slug>`
+     * (where a coding agent run with `gitRepository: repo` clones it).
      */
     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 };
+        return this.transport.request(`${this.baseUrl}/v1/git/repositories/${encodeURIComponent(this.slug)}/push-from-sandbox`, {
+            method: "POST",
+            body: JSON.stringify({
+                executionEnvironmentId: sandbox.name,
+                ...(opts.workingDirectory
+                    ? { workingDirectory: opts.workingDirectory }
+                    : {}),
+                ...(opts.message ? { message: opts.message } : {}),
+            }),
+        });
     }
 }
 // Ambient-bound namespace functions.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAa,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,MAAM,gBAAgB,GACpB,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,gCAAgC,CAAC;AAEjE,2FAA2F;AAC3F,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC;AA6B3D,yCAAyC;AACzC,MAAM,OAAO,UAAU;IASrB,YACE,MAA0D,EAC1D,SAAoB,EACpB,OAAe;QAEf,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAY,EACZ,YAAuB,gBAAgB,EAAE,EACzC,OAAO,GAAG,gBAAgB;QAE1B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,OAAO,CAC/B,GAAG,OAAO,sBAAsB,EAChC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;SAC/B,CACF,CAAC;QACF,iEAAiE;QACjE,OAAO,IAAI,UAAU,CACnB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EACxD,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,CACd,IAAY,EACZ,YAAuB,gBAAgB,EAAE,EACzC,OAAO,GAAG,gBAAgB;QAE1B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,OAAO,CAC/B,GAAG,OAAO,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAC7D,CAAC;QACF,OAAO,IAAI,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,YAAuB,gBAAgB,EAAE,EACzC,OAAO,GAAG,gBAAgB;QAE1B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,OAAO,CAC/B,GAAG,OAAO,sBAAsB,CACjC,CAAC;QACF,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAY,EACZ,YAAuB,gBAAgB,EAAE,EACzC,OAAO,GAAG,gBAAgB;QAE1B,MAAM,SAAS;aACZ,OAAO,CAAC,GAAG,OAAO,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE;YACrE,MAAM,EAAE,QAAQ;SACjB,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,qFAAqF;IACrF,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,QAAgB,EAChB,YAAuB,gBAAgB,EAAE,EACzC,OAAO,GAAG,gBAAgB;QAE1B,OAAO,IAAI,UAAU,CACnB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EACpC,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM;QACJ,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,OAAgB,EAChB,OAA6B,EAAE;QAE/B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,8BAA8B;QACzG,MAAM,MAAM,GACV,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAChD,2DAA2D;YAC3D,gFAAgF,OAAO,kBAAkB;YACzG,wEAAwE,CAAC;QAC3E,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CACrD,UAAU,MAAM,GAAG,CACpB,CAAC;QACF,MAAM,GAAG,GAAG,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC3D,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,IAAI,kBAAkB,QAAQ,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAC9E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC/B,CAAC;CACF;AAED,qCAAqC;AACrC,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AACD,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,QAAgB;IACnD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AACD,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AACD,OAAO,EAAE,gBAAgB,IAAI,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/repositories/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import type { Sapiom } from '../client.js';
+/** Per-capability overrides, keyed by capability path (see module docs). */
+export type StubOverrides = Record<string, unknown | ((...args: unknown[]) => unknown)>;
+export interface StubClientOptions {
+    overrides?: StubOverrides;
+    /**
+     * When provided, any dispatch-able capability records `(correlationId →
+     * result)` here (via {@link dispatchable}). A local runner uses it to
+     * auto-resume a `pauseUntilSignal(handle, …)` with the result the handle's
+     * signal would have carried.
+     */
+    signals?: Map<string, unknown>;
+}
+/**
+ * Create a stub `Sapiom` client. Runs every capability against built-in defaults;
+ * pass `overrides` to control the results a step branches on.
+ */
+export declare function createStubClient(opts?: StubClientOptions): Sapiom;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stub/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAK3C,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;AAExF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAkID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAuFrE"}

package/dist/esm/stub/index.js

@@ -0,0 +1,184 @@
+/**
+ * `@sapiom/tools/stub` — a stub capability client for local development.
+ *
+ * `createStubClient()` returns a `Sapiom` of the same shape as the real client,
+ * but every capability is satisfied by a built-in default (so a workflow runs
+ * locally with zero setup) plus optional per-capability overrides (when a step's
+ * logic branches on a result). No network, no credentials.
+ *
+ * It is shape-faithful: namespace methods return the real handle types
+ * (`Repository`, `Sandbox`, `RunHandle`), and a handle's instance methods
+ * (`repo.pushFromSandbox(...)`, `sandbox.exec(...)`) work too — so a step never
+ * has to be rewritten to run locally. Method names are validated against the
+ * real handle classes, so a call to a method that doesn't exist throws.
+ *
+ * Overrides are keyed by capability path — namespace methods by their dotted
+ * path (`repositories.list`, `agent.coding.run`), handle methods by
+ * `<handle>.<method>` (`repository.pushFromSandbox`, `sandbox.exec`). A value
+ * replaces that capability's default; a function `(…args) => value` computes it
+ * from the call arguments.
+ */
+import { CODING_RESULT_SIGNAL } from '../agent/index.js';
+import { Repository } from '../repositories/index.js';
+import { Sandbox } from '../sandboxes/index.js';
+// Module-scoped so correlation ids are unique across launches within a run.
+let launchSeq = 0;
+/** A launched, pausable capability handle (the `DispatchHandle` shape). */
+function isDispatchHandle(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const h = v;
+    return typeof h.wait === 'function' && typeof h.dispatch?.correlationId === 'string';
+}
+/**
+ * Register a dispatch-able handle's eventual result so a pause on its signal can
+ * be auto-resumed, then return the handle. Capability-agnostic: any launch-style
+ * stub method wraps its returned handle in this — the result a `pauseUntilSignal`
+ * resumes with is exactly what the handle's `wait()` resolves to.
+ */
+async function dispatchable(handle, signals) {
+    if (signals && isDispatchHandle(handle)) {
+        signals.set(handle.dispatch.correlationId, await handle.wait());
+    }
+    return handle;
+}
+// Method names of each handle, reflected from the real classes so the stub stays
+// in lockstep with the SDK (a renamed/added method is picked up automatically).
+const REPOSITORY_METHODS = handleMethods(Repository.prototype);
+const SANDBOX_METHODS = handleMethods(Sandbox.prototype);
+const RUN_HANDLE_METHODS = new Set(['status', 'wait']); // RunHandle is a literal, not a class
+function handleMethods(proto) {
+    return new Set(Object.getOwnPropertyNames(proto).filter((n) => n !== 'constructor'));
+}
+function resolve(overrides, path, args, fallback) {
+    if (Object.prototype.hasOwnProperty.call(overrides, path)) {
+        const o = overrides[path];
+        return typeof o === 'function' ? o(...args) : o;
+    }
+    return fallback();
+}
+/**
+ * Build a handle proxy: data fields read from `data`; declared methods resolve an
+ * override (`<type>.<method>`) or a default; any other property is rejected as
+ * not part of the handle.
+ */
+function makeHandle(type, methods, data, overrides, defaults) {
+    return new Proxy(data, {
+        get(target, prop) {
+            if (typeof prop === 'symbol' || prop === 'then')
+                return undefined;
+            const key = String(prop);
+            if (key in target)
+                return target[key]; // data field (incl. nested handles)
+            if (methods.has(key)) {
+                return (...args) => Promise.resolve(resolve(overrides, `${type}.${key}`, args, () => defaults[key]?.(args)));
+            }
+            throw new Error(`'${type}.${key}' is not a method or field on this handle.`);
+        },
+    });
+}
+const REPO_METHOD_DEFAULTS = {
+    delete: () => undefined,
+    pushFromSandbox: () => ({ pushed: true, sha: 'stub00000000', branch: 'main' }),
+};
+const SANDBOX_METHOD_DEFAULTS = {
+    exec: () => ({ pid: 'stub-proc', exitCode: 0, stdout: '', stderr: '' }),
+    readFile: () => '',
+    writeFile: () => undefined,
+    destroy: () => undefined,
+};
+function stubRepository(data, overrides) {
+    return makeHandle('repository', REPOSITORY_METHODS, { slug: data.slug, cloneUrl: data.cloneUrl, status: data.status ?? 'active' }, overrides, REPO_METHOD_DEFAULTS);
+}
+function stubSandbox(data, overrides) {
+    return makeHandle('sandbox', SANDBOX_METHODS, { name: data.name, workspaceRoot: data.workspaceRoot ?? '/workspace' }, overrides, SANDBOX_METHOD_DEFAULTS);
+}
+function stubCodingResult(overrides) {
+    return {
+        runId: 'stub-run',
+        status: 'completed',
+        summary: '(stub) coding run completed locally',
+        result: {
+            success: true,
+            turns: 1,
+            modelUsed: 'stub-model',
+            durationMs: 0,
+            toolCallCount: 0,
+            usage: { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreateTokens: 0, thinkingTokens: 0 },
+        },
+        error: null,
+        sandbox: stubSandbox({ name: 'stub-sandbox' }, overrides),
+    };
+}
+function stubRunHandle(overrides, correlationId, result) {
+    const handle = {
+        runId: correlationId,
+        sandbox: result.sandbox,
+        dispatch: { correlationId, resultSignal: CODING_RESULT_SIGNAL },
+        status: () => Promise.resolve(result.status),
+        wait: () => Promise.resolve(result),
+    };
+    return makeHandle('runHandle', RUN_HANDLE_METHODS, handle, overrides, {});
+}
+/**
+ * Create a stub `Sapiom` client. Runs every capability against built-in defaults;
+ * pass `overrides` to control the results a step branches on.
+ */
+export function createStubClient(opts = {}) {
+    const overrides = opts.overrides ?? {};
+    const r = (path, args, fallback) => resolve(overrides, path, args, fallback);
+    const client = {
+        sandboxes: {
+            create: (sandboxOpts) => Promise.resolve(r('sandboxes.create', [sandboxOpts], () => stubSandbox({ name: sandboxOpts?.name ?? 'stub-sandbox' }, overrides))),
+            attach: (name, attachOpts) => r('sandboxes.attach', [name, attachOpts], () => stubSandbox({ name }, overrides)),
+        },
+        repositories: {
+            create: (slug) => Promise.resolve(r('repositories.create', [slug], () => stubRepository({ slug, cloneUrl: `https://git.local/${slug}.git` }, overrides))),
+            get: (slug) => Promise.resolve(r('repositories.get', [slug], () => stubRepository({ slug, cloneUrl: `https://git.local/${slug}.git` }, overrides))),
+            list: () => Promise.resolve(r('repositories.list', [], () => [])),
+            delete: (slug) => Promise.resolve(r('repositories.delete', [slug], () => undefined)),
+            attach: (slug, cloneUrl) => r('repositories.attach', [slug, cloneUrl], () => stubRepository({ slug, cloneUrl }, overrides)),
+        },
+        agent: {
+            coding: {
+                run: (spec) => Promise.resolve(r('agent.coding.run', [spec], () => stubCodingResult(overrides))),
+                launch: (spec) => {
+                    const correlationId = `stub-run-${++launchSeq}`;
+                    // The resume payload IS the run result, so `agent.coding.run`
+                    // overrides control both `await run()` and `launch()` + pause.
+                    const result = {
+                        ...r('agent.coding.run', [spec], () => stubCodingResult(overrides)),
+                        runId: correlationId,
+                    };
+                    // Generic: any dispatch-able handle registers itself for pause-resume.
+                    return dispatchable(stubRunHandle(overrides, correlationId, result), opts.signals);
+                },
+            },
+        },
+        fileStorage: {
+            upload: (input) => Promise.resolve(r('fileStorage.upload', [input], () => ({
+                fileId: 'stub-file',
+                uploadUrl: 'https://storage.local/upload/stub-file',
+                expiresAt: '2099-01-01T00:00:00Z',
+                requiredHeaders: {},
+            }))),
+            getDownloadUrl: (fileId) => Promise.resolve(r('fileStorage.getDownloadUrl', [fileId], () => ({
+                downloadUrl: `https://storage.local/download/${fileId}`,
+                expiresAt: '2099-01-01T00:00:00Z',
+            }))),
+            list: (listOpts) => Promise.resolve(r('fileStorage.list', [listOpts], () => ({ files: [], limit: 20, offset: 0, hasMore: false }))),
+            delete: (fileId) => Promise.resolve(r('fileStorage.delete', [fileId], () => undefined)),
+            setVisibility: (fileId, visibility) => Promise.resolve(r('fileStorage.setVisibility', [fileId, visibility], () => ({
+                fileId,
+                contentType: 'application/octet-stream',
+                visibility,
+                status: 'uploaded',
+                createdAt: '2099-01-01T00:00:00Z',
+                downloadRequestCount: 0,
+            }))),
+        },
+        withAttribution: () => client,
+    };
+    return client;
+}
+//# sourceMappingURL=index.js.map

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

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