@promigence/sdk 0.1.0-beta.13 → 0.1.0-beta.15

package/dist/client.js

@@ -42,6 +42,26 @@ function bytesToB64(b) {
 function modeParam(mode) {
     return typeof mode === "number" ? mode.toString(8) : mode;
 }
+function jsonBody(value) {
+    return { data: new TextEncoder().encode(JSON.stringify(value)), contentType: "application/json" };
+}
+function fileForm(fields, data) {
+    const boundary = `promigence-${globalThis.crypto.randomUUID().replace(/-/g, "")}`;
+    let head = "";
+    for (const [name, value] of fields) {
+        head += `--${boundary}\r\nContent-Disposition: form-data; name="${name}"\r\n\r\n${value}\r\n`;
+    }
+    head += `--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="blob"\r\n`
+        + "Content-Type: application/octet-stream\r\n\r\n";
+    const enc = new TextEncoder();
+    const pre = enc.encode(head);
+    const post = enc.encode(`\r\n--${boundary}--\r\n`);
+    const out = new Uint8Array(pre.length + data.length + post.length);
+    out.set(pre, 0);
+    out.set(data, pre.length);
+    out.set(post, pre.length + data.length);
+    return { data: out, contentType: `multipart/form-data; boundary=${boundary}` };
+}
 export function execOutputBytes(r, stream = "stdout") {
     const b64 = r[`${stream}_b64`];
     if (typeof b64 === "string")
@@ -71,6 +91,32 @@ function pageQuery(limit, max, cursor) {
         q.set("cursor", cursor);
     return q.toString();
 }
+export const OUTPUT_RETENTION_MAX_DAYS = 30;
+function projectUpdateBody(u) {
+    const body = {};
+    if (u.name !== undefined)
+        body["name"] = u.name;
+    if (u.outputRetentionDays !== undefined) {
+        const d = u.outputRetentionDays;
+        if (d !== null && (!Number.isInteger(d) || d < 1 || d > OUTPUT_RETENTION_MAX_DAYS)) {
+            throw new InvalidArgumentError(`outputRetentionDays must be a whole number from 1 to ${OUTPUT_RETENTION_MAX_DAYS}, or null, not ${String(d)}`, "Pass null for the organization's setting.");
+        }
+        body["output_retention_days"] = d;
+    }
+    if (u.failureCaptures !== undefined) {
+        if (u.failureCaptures !== null && typeof u.failureCaptures !== "boolean") {
+            throw new InvalidArgumentError("failureCaptures must be true, false or null", "Pass null for the organization's setting.");
+        }
+        if (Object.keys(body).length) {
+            throw new InvalidArgumentError("failureCaptures is set on its own", "Change it in a call of its own, without name or outputRetentionDays.");
+        }
+        body["failure_captures"] = u.failureCaptures;
+    }
+    if (!Object.keys(body).length) {
+        throw new InvalidArgumentError("projects.update needs something to change", "Pass name, outputRetentionDays or failureCaptures.");
+    }
+    return body;
+}
 function expiryFields(o) {
     const body = {};
     if (o.expiresInDays !== undefined)
@@ -944,7 +990,8 @@ export class PromigenceClient {
         const idempotencyKey = opts.idempotencyKey ?? (keyedCreate ? newIdempotencyKey() : undefined);
         if (idempotencyKey)
             headers["idempotency-key"] = idempotencyKey;
-        const replayable = opts.method === "GET" || opts.method === "DELETE" || (keyedCreate && Boolean(idempotencyKey));
+        const replayable = opts.method === "GET" || opts.method === "DELETE" || opts.replayable === true
+            || (keyedCreate && Boolean(idempotencyKey));
         const timeoutMs = opts.timeoutMs ?? this.requestTimeoutMs;
         let dispatcher;
         let resentDelete = false;
@@ -1141,7 +1188,7 @@ export class PromigenceClient {
             }
         }
     }
-    async bytes(method, path, body, opts = {}) {
+    async bytes(method, path, body, opts = {}, read = method === "GET") {
         const url = `${this.apiUrl}${path}`;
         const headers = {
             accept: "application/octet-stream, application/json",
@@ -1151,7 +1198,7 @@ export class PromigenceClient {
         if (this.caller)
             headers[CALLER_HEADER] = this.caller;
         if (body !== undefined)
-            headers["content-type"] = "application/octet-stream";
+            headers["content-type"] = body.contentType;
         const signals = [AbortSignal.timeout(opts.timeoutMs ?? FILE_TIMEOUT_MS)];
         if (opts.signal)
             signals.push(opts.signal);
@@ -1165,7 +1212,7 @@ export class PromigenceClient {
                     method,
                     headers,
                     signal,
-                    ...(body === undefined ? {} : { body: body }),
+                    ...(body === undefined ? {} : { body: body.data }),
                     ...(dispatcher === undefined ? {} : { dispatcher }),
                 });
             }
@@ -1185,7 +1232,7 @@ export class PromigenceClient {
             }
             catch { }
             const retryAfterMs = parseRetryAfter(res.headers.get("retry-after"));
-            const wait = this.refusalBackoff(res.status, retryAfterMs, payload.error?.code, attempt, method === "GET", opts.signal);
+            const wait = this.refusalBackoff(res.status, retryAfterMs, payload.error?.code, attempt, read, opts.signal);
             if (wait !== undefined) {
                 this.stats.retries++;
                 await sleep(wait);
@@ -1199,7 +1246,7 @@ export class PromigenceClient {
             });
         }
     }
-    async stream(path, onChunk, opts = {}) {
+    async stream(method, path, onChunk, opts = {}, body) {
         const url = `${this.apiUrl}${path}`;
         const headers = {
             accept: "application/octet-stream, application/json",
@@ -1208,17 +1255,25 @@ export class PromigenceClient {
         };
         if (this.caller)
             headers[CALLER_HEADER] = this.caller;
+        if (body !== undefined)
+            headers["content-type"] = body.contentType;
         const signals = [AbortSignal.timeout(opts.timeoutMs ?? FILE_TIMEOUT_MS)];
         if (opts.signal)
             signals.push(opts.signal);
         const signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
-        const timedOut = () => new TimeoutError(`GET ${path} timed out after ${opts.timeoutMs ?? FILE_TIMEOUT_MS} ms`, "Retry; for a large artefact raise timeoutMs.");
+        const timedOut = () => new TimeoutError(`${method} ${path} timed out after ${opts.timeoutMs ?? FILE_TIMEOUT_MS} ms`, "Retry; for a large artefact raise timeoutMs.");
         const dispatcher = this.guardDispatcher();
         for (let attempt = 0;; attempt++) {
             let res;
             this.stats.requests++;
             try {
-                res = await this.fetchImpl(url, { method: "GET", headers, signal, ...(dispatcher === undefined ? {} : { dispatcher }) });
+                res = await this.fetchImpl(url, {
+                    method,
+                    headers,
+                    signal,
+                    ...(body === undefined ? {} : { body: body.data }),
+                    ...(dispatcher === undefined ? {} : { dispatcher }),
+                });
             }
             catch (err) {
                 const e = err;
@@ -1267,7 +1322,7 @@ export class PromigenceClient {
                 continue;
             }
             const code = payload.error?.code ?? codeForStatus(res.status);
-            throw errorFor(code, payload.error?.message ?? `HTTP ${res.status} from GET ${path}`, payload.error?.fix ?? "See the API response for details.", {
+            throw errorFor(code, payload.error?.message ?? `HTTP ${res.status} from ${method} ${path}`, payload.error?.fix ?? "See the API response for details.", {
                 status: res.status,
                 ...bodyExtra(payload),
                 ...(retryAfterMs === undefined ? {} : { retryAfterMs }),
@@ -1346,6 +1401,29 @@ export class PromigenceClient {
                 const r = await this.request({ method: "GET", path: `/billing/history?${q.toString()}` });
                 return pageOf(r, "entries", limit);
             },
+            holds: () => this.request({ method: "GET", path: "/billing/holds" }),
+            buyCredits: (amountUsd) => this.request({ method: "POST", path: "/billing/credits", body: { amount_usd: amountUsd } }),
+            settleCredits: (sessionId) => {
+                if (!sessionId?.trim())
+                    throw new InvalidArgumentError("billing.settleCredits needs a session id", "Pass the session_id buyCredits() answered.");
+                return this.request({ method: "POST", path: `/billing/credits/${encodeURIComponent(sessionId)}/settle`, body: {} });
+            },
+            autoReload: () => this.request({ method: "GET", path: "/billing/auto-reload" }),
+            setAutoReload: (opts) => this.request({
+                method: "PUT",
+                path: "/billing/auto-reload",
+                body: {
+                    on: opts.on,
+                    ...(opts.thresholdUsd === undefined ? {} : { threshold_usd: opts.thresholdUsd }),
+                    ...(opts.amountUsd === undefined ? {} : { amount_usd: opts.amountUsd }),
+                    ...(opts.authorizationVersion === undefined ? {} : { authorization_version: opts.authorizationVersion }),
+                },
+            }),
+            repayDispute: (disputeId) => {
+                if (!disputeId?.trim())
+                    throw new InvalidArgumentError("billing.repayDispute needs a dispute id", "Pass the hold's dispute_id from billing.usage().");
+                return this.request({ method: "POST", path: `/billing/disputes/${encodeURIComponent(disputeId)}/repay`, body: {} });
+            },
             checkout: () => this.request({ method: "POST", path: "/billing/checkout", body: {} }),
             portal: () => this.request({ method: "POST", path: "/billing/portal", body: {} }),
             referrals: () => this.request({ method: "GET", path: "/referrals" }),
@@ -1404,6 +1482,9 @@ export class PromigenceClient {
                 rename: (org, project, name) => this.request({
                     method: "PATCH", path: `/orgs/${orgSeg(org)}/projects/${encodeURIComponent(project)}`, body: { name },
                 }),
+                update: async (org, project, update) => this.request({
+                    method: "PATCH", path: `/orgs/${orgSeg(org)}/projects/${encodeURIComponent(project)}`, body: projectUpdateBody(update),
+                }),
             },
         };
     }
@@ -2152,6 +2233,7 @@ export class PromigenceClient {
                     ...(opts.spendCap === undefined ? {} : { spend_cap: checkSpendCap(opts.spendCap) }),
                 },
             }),
+            resumePausedForCredits: () => this.request({ method: "POST", path: "/sandboxes/resume", body: { paused_for: "credits" } }),
             snapshot: (sandboxId, opts = {}) => this.request({
                 method: "POST",
                 path: `/sandboxes/${encodeURIComponent(sandboxId)}/snapshot`,
@@ -2222,38 +2304,42 @@ export class PromigenceClient {
             },
             files: {
                 list: (sandboxId, path = "/", opts = {}) => {
-                    const q = [`path=${encodeURIComponent(path)}`];
+                    const body = { path };
                     if (opts.recursive)
-                        q.push("recursive=1");
+                        body.recursive = true;
                     if (opts.depth !== undefined)
-                        q.push(`depth=${Math.max(0, Math.floor(opts.depth))}`);
+                        body.depth = Math.max(0, Math.floor(opts.depth));
                     if (opts.limit !== undefined)
-                        q.push(`limit=${Math.max(1, Math.floor(opts.limit))}`);
+                        body.limit = Math.max(1, Math.floor(opts.limit));
                     if (opts.hidden === false)
-                        q.push("hidden=0");
+                        body.hidden = false;
                     return this.request({
-                        method: "GET",
-                        path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/list?${q.join("&")}`,
+                        method: "POST",
+                        path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/list`,
+                        body,
+                        replayable: true,
                     });
                 },
                 search: (sandboxId, path, opts = {}) => {
                     if (!opts.pattern && !opts.contains) {
                         throw new InvalidArgumentError("files.search needs `pattern`, `contains`, or both", "Pass { pattern: '*.py' } for a name glob, { contains: 'TODO' } for text inside files.");
                     }
-                    const q = [`path=${encodeURIComponent(path)}`];
+                    const body = { path };
                     if (opts.pattern)
-                        q.push(`pattern=${encodeURIComponent(opts.pattern)}`);
+                        body.pattern = opts.pattern;
                     if (opts.contains)
-                        q.push(`contains=${encodeURIComponent(opts.contains)}`);
+                        body.contains = opts.contains;
                     if (opts.ignoreCase)
-                        q.push("ignore_case=1");
+                        body.ignore_case = true;
                     if (opts.limit !== undefined)
-                        q.push(`limit=${Math.max(1, Math.floor(opts.limit))}`);
+                        body.limit = Math.max(1, Math.floor(opts.limit));
                     if (opts.hidden === false)
-                        q.push("hidden=0");
+                        body.hidden = false;
                     return this.request({
-                        method: "GET",
-                        path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/search?${q.join("&")}`,
+                        method: "POST",
+                        path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/search`,
+                        body,
+                        replayable: true,
                     });
                 },
                 mkdir: (sandboxId, path, opts = {}) => this.request({
@@ -2310,11 +2396,13 @@ export class PromigenceClient {
                     body: { archive, into, ...(opts.strip === undefined ? {} : { strip: Math.max(0, Math.floor(opts.strip)) }) },
                 }),
                 stat: (sandboxId, path) => this.request({
-                    method: "GET",
-                    path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/stat?path=${encodeURIComponent(path)}`,
+                    method: "POST",
+                    path: `/sandboxes/${encodeURIComponent(sandboxId)}/files/stat`,
+                    body: { path },
+                    replayable: true,
                 }),
-                get: (sandboxId, path, opts = {}) => this.bytes("GET", `/sandboxes/${encodeURIComponent(sandboxId)}/files?path=${encodeURIComponent(path)}`, undefined, opts),
-                download: (sandboxId, path, onChunk, opts = {}) => this.stream(`/sandboxes/${encodeURIComponent(sandboxId)}/files?path=${encodeURIComponent(path)}`, onChunk, opts),
+                get: (sandboxId, path, opts = {}) => this.bytes("POST", `/sandboxes/${encodeURIComponent(sandboxId)}/files/read`, jsonBody({ path }), opts, true),
+                download: (sandboxId, path, onChunk, opts = {}) => this.stream("POST", `/sandboxes/${encodeURIComponent(sandboxId)}/files/read`, onChunk, opts, jsonBody({ path })),
                 text: async (sandboxId, path, opts = {}) => new TextDecoder().decode(await this.sandboxes.files.get(sandboxId, path, opts)),
                 put: async (sandboxId, path, data, opts = {}) => {
                     const body = typeof data === "string" ? new TextEncoder().encode(data) : data;
@@ -2324,8 +2412,7 @@ export class PromigenceClient {
                     }, opts);
                 },
                 putFrom: async (sandboxId, path, source, opts = {}) => {
-                    const mode = opts.mode === undefined ? "" : `&mode=${opts.mode.toString(8)}`;
-                    const base = `/sandboxes/${encodeURIComponent(sandboxId)}/files?path=${encodeURIComponent(path)}${mode}`;
+                    const url = `/sandboxes/${encodeURIComponent(sandboxId)}/files`;
                     let sent = 0;
                     let chunks = 0;
                     let last;
@@ -2334,7 +2421,12 @@ export class PromigenceClient {
                         if (slice.length === 0 && sent < source.size) {
                             throw new InvalidArgumentError(`the source of ${path} ended at ${sent} of ${source.size} bytes`, "The file shrank while it was being sent; send it again once nothing is writing it.");
                         }
-                        const raw = await this.bytes("PUT", sent === 0 ? base : `${base}&offset=${sent}`, slice, opts);
+                        const fields = [["path", path]];
+                        if (opts.mode !== undefined)
+                            fields.push(["mode", opts.mode.toString(8)]);
+                        if (sent > 0)
+                            fields.push(["offset", String(sent)]);
+                        const raw = await this.bytes("PUT", url, fileForm(fields, slice), opts);
                         last = JSON.parse(new TextDecoder().decode(raw));
                         sent += slice.length;
                         chunks += 1;
@@ -2343,8 +2435,8 @@ export class PromigenceClient {
                 },
                 delete: (sandboxId, path, opts = {}) => this.request({
                     method: "DELETE",
-                    path: `/sandboxes/${encodeURIComponent(sandboxId)}/files?path=${encodeURIComponent(path)}`
-                        + (opts.recursive ? "&recursive=1" : ""),
+                    path: `/sandboxes/${encodeURIComponent(sandboxId)}/files`,
+                    body: { path, ...(opts.recursive ? { recursive: true } : {}) },
                 }),
             },
             output: async (execId, opts = {}) => {

package/dist/core.d.ts

@@ -1,5 +1,5 @@
 /** Promigence SDK — constants, error hierarchy and shared types. */
-export declare const VERSION = "0.1.0-beta.13";
+export declare const VERSION = "0.1.0-beta.15";
 export declare const DOCS_URL = "https://promigence.ai";
 /** The error reference; each code is an anchor on it (the API's `docs` link has the same form). */
 export declare const ERRORS_DOCS_URL = "https://www.promigence.ai/docs/errors";

package/dist/core.js

@@ -1,5 +1,5 @@
 import { hintArg } from "./hint.js";
-export const VERSION = "0.1.0-beta.13";
+export const VERSION = "0.1.0-beta.15";
 export const DOCS_URL = "https://promigence.ai";
 export const ERRORS_DOCS_URL = "https://www.promigence.ai/docs/errors";
 export const DEFAULT_API_URL = "https://api.promigence.ai/v1";
@@ -247,6 +247,8 @@ export const EXIT_BY_CODE = {
     project_cap_reached: 5,
     spend_limit_reached: 5,
     billing_hold: 5,
+    credits_exhausted: 5, purchase_limit: 5, purchases_blocked: 5,
+    card_needed: 5, auto_reload_unavailable: 5,
     tier_over_plan: 2,
     network_host_refused: 9, network_policy_unsupported: 3,
     secrets_in_snapshot: 2, secrets_unavailable: 3,

package/dist/http2.d.ts

@@ -189,6 +189,7 @@ export declare const __http2Internals: {
         closedReason: string;
         messages: number;
         posts: number;
+        startedAt: number;
     } | undefined;
     /** The transport thread's number of connections and spacing between new requests on one, for an environment (`threadKnobs`). */
     threadKnobs(env: NodeJS.ProcessEnv): {