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

package/dist/cjs/client.d.ts

@@ -727,6 +727,10 @@ export interface OrgRecord {
     projects: number;
     members: number;
     created_at: string;
+    /** Days command output is kept after a sandbox ends; `null` = the default, 7. */
+    output_retention_days?: number | null;
+    /** Keep a failed sandbox to reopen where it broke, when a run does not say; absent or `null` = the default. */
+    failure_captures?: boolean | null;
 }
 export interface ProjectRecord {
     project_id: string;
@@ -736,8 +740,14 @@ export interface ProjectRecord {
     keys: number;
     /** The most the project may bill in a calendar month (UTC); `null` = no cap. */
     monthly_cap_usd?: number | null;
+    /** Days this project's command output is kept after a sandbox ends; `null` = the organization's. */
+    output_retention_days?: number | null;
+    /** Keep this project's failed sandboxes to reopen, when a run does not say; absent or `null` = the organization's. */
+    failure_captures?: boolean | null;
     created_at: string;
 }
+/** The longest command output may be kept after a sandbox ends, in days. */
+export declare const OUTPUT_RETENTION_MAX_DAYS = 30;
 export interface MemberRecord {
     user_id: string;
     email: string;
@@ -905,8 +915,10 @@ export interface PricingView {
         invite_required: boolean;
     };
     monthly_fee_usd: number;
-    /** Usage the monthly fee includes each month, USD. */
+    /** Credits the plan adds each paid month, USD. */
     included_credits_usd: number;
+    /** For how many paid months the plan adds `included_credits_usd`; `null` when it adds them every paid month. */
+    included_credits_promo_months?: number | null;
     monthly_minimum_usd: number;
 }
 export interface BillingUsage {
@@ -957,6 +969,20 @@ export interface BillingUsage {
         period_end?: string | null;
     } | null;
     upcoming_invoice_error?: string | null;
+    /** What the organization's credits can pay for: balance, held, available, the next to expire. */
+    credits?: M.BillingCredits;
+    /** Auto-reload: when available credits fall below `threshold_usd`, `amount_usd` is added from `card`. */
+    auto_reload?: M.AutoReload;
+    /** The plan in force, and a renewal payment in trouble. */
+    plan_status?: M.PlanStatus;
+    /** `credits` (paid from credits bought in advance) or `postpaid` (billed after use, until `switch.at`). */
+    model?: string;
+    /** For a `postpaid` organization: when it moves to credits, and the credits ready then. */
+    switch?: M.BillingSwitch | null;
+    /** What this organization can buy now. */
+    trust?: M.TrustLimits;
+    /** A hold that refuses new work, and the page that lifts it; `null` when there is none. */
+    hold?: M.BillingHold | null;
     [extra: string]: unknown;
 }
 /** One row of `GET /billing/history`: a credit the organization received, or a payment. */
@@ -1150,7 +1176,7 @@ export interface SnapshotVerifyResponse {
         state: string;
     }>;
 }
-/** `GET /sandboxes/:id/files/stat`. */
+/** `POST /sandboxes/:id/files/stat`. */
 export interface FileStat {
     path: string;
     size: number;
@@ -1178,7 +1204,7 @@ export interface DirEntry {
 }
 /** An opaque label of how a file request was answered, passed through for support. */
 export type ServedBy = string;
-/** `GET /sandboxes/:id/files/list?path=`. */
+/** `POST /sandboxes/:id/files/list`. */
 export interface DirListing {
     sandbox_id: string;
     path: string;
@@ -1187,7 +1213,7 @@ export interface DirListing {
     truncated: boolean;
     served_by?: ServedBy;
 }
-/** `?recursive=&depth=&limit=&hidden=` on `files/list`. */
+/** `recursive`, `depth`, `limit` and `hidden` on `files/list` (sent in the request body). */
 export interface DirListOpts {
     recursive?: boolean;
     /** With `recursive`: how many levels below `path`. Unset = no bound. */
@@ -1207,7 +1233,7 @@ export interface FileInfo {
     is_symlink: boolean;
     served_by?: ServedBy;
 }
-/** One hit of `GET /sandboxes/:id/files/search`. `line`/`text` only for a `contains` search. */
+/** One hit of `POST /sandboxes/:id/files/search`. `line`/`text` only for a `contains` search. */
 export interface FileMatch {
     path: string;
     line?: number | null;
@@ -1906,6 +1932,8 @@ interface RequestOpts {
     onHeaders?: (headers: Headers) => void;
     /** Extra request headers (e.g. `promigence-replaced-by`). Never the authorization. */
     headers?: Record<string, string>;
+    /** A `POST` that changes nothing (a file read): safe to send twice, so it is retried as a `GET` is. */
+    replayable?: boolean;
 }
 /** One answer's timing ([`PromigenceClient.lastTiming`]). */
 export interface Timing {
@@ -2011,13 +2039,16 @@ export declare class PromigenceClient {
      * artefact must not go through: it would corrupt binary and cost a second copy of a file that
      * can be gigabytes. This reads the body as an `ArrayBuffer` and hands it back untouched.
      * Errors still arrive as JSON, so a non-2xx answer is decoded and mapped the same way.
+     *
+     * `body` is sent as given with its content type (a JSON question, or a `files put` form).
+     * `read`: the request changes nothing, so a refusal is sent again as a `GET` would be.
      */
     private bytes;
     /**
-     * `GET` a byte body **without holding it**: each chunk goes to `onChunk` as it arrives, and
+     * Read a byte body **without holding it**: each chunk goes to `onChunk` as it arrives, and
      * the next is not read until `onChunk` has finished with it, so a 10 GiB artefact costs one
-     * chunk of memory. Errors arrive
-     * as JSON and are mapped exactly as [`bytes`] maps them; a door refusal is sent again.
+     * chunk of memory. A read only (a `POST` carries its question as `body`), so a door refusal
+     * is sent again. Errors arrive as JSON and are mapped exactly as [`bytes`] maps them.
      */
     private stream;
     /**
@@ -2075,7 +2106,7 @@ export declare class PromigenceClient {
         signal?: AbortSignal;
     }): Promise<Outcomes>;
     readonly billing: {
-        /** `GET /billing` — plan, card, period, usage, trial, upcoming invoice. */
+        /** `GET /billing` — plan, credits, auto-reload, card, period, usage, trial, the next plan invoice. */
         usage: () => Promise<BillingUsage>;
         /** `GET /me/ledger?limit=N` — the metered rows the month's total is the sum of (one page). */
         ledger: (limit?: number) => Promise<LedgerEntry[]>;
@@ -2097,6 +2128,29 @@ export declare class PromigenceClient {
             limit?: number;
             cursor?: string;
         }) => Promise<Page<BillingHistoryEntry>>;
+        /** `GET /billing/holds` — what each running or paused sandbox holds of the organization's credits. */
+        holds: () => Promise<M.CreditHolds>;
+        /**
+         * `POST /billing/credits` — a payment page to buy credits, from $5, in whole dollars. The credits are
+         * added when the payment goes through: `settleCredits(session_id)` checks it. An owner's full-access key.
+         */
+        buyCredits: (amountUsd: number) => Promise<M.PaymentPage>;
+        /** `POST /billing/credits/:session_id/settle` — check a credits payment and add its credits if it went through. */
+        settleCredits: (sessionId: string) => Promise<M.CreditsSettled>;
+        /** `GET /billing/auto-reload` — the auto-reload settings, and the authorization turning it on asks for. */
+        autoReload: () => Promise<M.AutoReload>;
+        /**
+         * `PUT /billing/auto-reload` — turn auto-reload on or off, or change it. Turning it on, or changing the level or
+         * the amount, needs `authorizationVersion`: the version of the authorization the owner accepted.
+         */
+        setAutoReload: (opts: {
+            on: boolean;
+            thresholdUsd?: number;
+            amountUsd?: number;
+            authorizationVersion?: string;
+        }) => Promise<M.AutoReload>;
+        /** `POST /billing/disputes/:dispute_id/repay` — a payment page to repay a disputed payment. */
+        repayDispute: (disputeId: string) => Promise<M.PaymentPage>;
         /** `POST /billing/checkout` — the hosted page that puts a card on file. */
         checkout: () => Promise<{
             url: string;
@@ -2109,7 +2163,7 @@ export declare class PromigenceClient {
         }>;
         /** `GET /referrals` — your code and its offer, your referrals by status, what they earned. */
         referrals: () => Promise<ReferralStatus>;
-        /** `POST /referrals/apply` — apply a referral code (an owner's key, before the first paid invoice). */
+        /** `POST /referrals/apply` — apply a referral code (an owner's key, before the first payment of at least the reward). */
         applyReferral: (code: string) => Promise<ReferralApplied>;
     };
     private group_billing;
@@ -2173,6 +2227,15 @@ export declare class PromigenceClient {
             create: (org: string, name: string) => Promise<ProjectRecord>;
             /** `PATCH /orgs/:org/projects/:project {name}` — rename it (the `default` project keeps its name). */
             rename: (org: string, project: string, name: string) => Promise<ProjectRecord>;
+            /**
+             * `PATCH /orgs/:org/projects/:project` — rename it, set how long its command output is kept, or
+             * whether its failed sandboxes are kept to reopen (that one on its own). The settings need an owner signed in.
+             */
+            update: (org: string, project: string, update: {
+                name?: string;
+                outputRetentionDays?: number | null;
+                failureCaptures?: boolean | null;
+            }) => Promise<ProjectRecord>;
         };
     };
     private group_orgs;
@@ -2499,7 +2562,7 @@ export declare class PromigenceClient {
             rows?: number;
             cmd?: string;
             /** Stored secret names, or `{name, as}` bindings, put into the terminal's environment
-             *  by the server. Names travel in a header; values never leave the service. */
+             *  by the server. Names travel inside the terminal's connection; values never leave the service. */
             secrets?: SecretBinding[];
             onData?: (data: Uint8Array) => void;
             onExit?: (exit: PtyExit) => void;
@@ -2544,6 +2607,12 @@ export declare class PromigenceClient {
             optimizeFor?: OptimizeFor;
             spendCap?: number;
         }) => Promise<ResumeResult>;
+        /**
+         * `POST /sandboxes/resume {paused_for: "credits"}` — resume every sandbox paused because credits
+         * ran out. Each resume is checked like new work: the answer lists the sandboxes that resumed and
+         * those that still need credits.
+         */
+        resumePausedForCredits: () => Promise<M.SandboxesResumed>;
         /**
          * `POST /sandboxes/:id/snapshot` — photograph a running sandbox and keep it running.
          *
@@ -2656,8 +2725,9 @@ export declare class PromigenceClient {
         }) => Promise<SandboxPatchResponse>;
         /**
          * `get` streams: the body is handed back as bytes and never parsed, because an eval
-         * artefact, a trace or a run log is exactly what this is for. `put` sends the file as the
-         * body rather than base64 inside JSON.
+         * artefact, a trace or a run log is exactly what this is for. `put` sends the file's bytes
+         * as they are rather than base64 inside JSON. A file's path, a name pattern and a search
+         * text travel in the request body, never in the URL.
          */
         files: {
             /**
@@ -2744,7 +2814,7 @@ export declare class PromigenceClient {
             /**
              * Write a file of **any size**, in [`FILE_PUT_CHUNK_BYTES`] requests.
              *
-             * Chunk 0 goes without `?offset=`, which means "this is the file" (create, truncate);
+             * Chunk 0 goes without an `offset`, which means "this is the file" (create, truncate);
              * every later chunk carries one, which appends, so a file has no size limit here.
              *
              * A failure mid-loop leaves a **prefix** in the sandbox, not a corrupt file. Re-running the

package/dist/cjs/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromigenceClient = exports.LONG_POLL_MS = exports.isKeyedCreate = exports.REPO_CREDENTIALS_FIX = exports.CONTEXT_GIT_RE = exports.IMAGE_DIGEST_RE = exports.MAX_SOURCES = exports.NOTICE_HEADER = exports.isWaiting = exports.FILE_TIMEOUT_MS = void 0;
+exports.PromigenceClient = exports.LONG_POLL_MS = exports.isKeyedCreate = exports.REPO_CREDENTIALS_FIX = exports.CONTEXT_GIT_RE = exports.IMAGE_DIGEST_RE = exports.MAX_SOURCES = exports.NOTICE_HEADER = exports.OUTPUT_RETENTION_MAX_DAYS = exports.isWaiting = exports.FILE_TIMEOUT_MS = void 0;
 exports.execOutputBytes = execOutputBytes;
 exports.configDir = configDir;
 exports.credentialsPath = credentialsPath;
@@ -75,6 +75,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}` };
+}
 function execOutputBytes(r, stream = "stdout") {
     const b64 = r[`${stream}_b64`];
     if (typeof b64 === "string")
@@ -104,6 +124,32 @@ function pageQuery(limit, max, cursor) {
         q.set("cursor", cursor);
     return q.toString();
 }
+exports.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 > exports.OUTPUT_RETENTION_MAX_DAYS)) {
+            throw new core_js_1.InvalidArgumentError(`outputRetentionDays must be a whole number from 1 to ${exports.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 core_js_1.InvalidArgumentError("failureCaptures must be true, false or null", "Pass null for the organization's setting.");
+        }
+        if (Object.keys(body).length) {
+            throw new core_js_1.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 core_js_1.InvalidArgumentError("projects.update needs something to change", "Pass name, outputRetentionDays or failureCaptures.");
+    }
+    return body;
+}
 function expiryFields(o) {
     const body = {};
     if (o.expiresInDays !== undefined)
@@ -976,7 +1022,8 @@ 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;
@@ -1173,7 +1220,7 @@ 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",
@@ -1183,7 +1230,7 @@ class PromigenceClient {
         if (this.caller)
             headers[caller_js_1.CALLER_HEADER] = this.caller;
         if (body !== undefined)
-            headers["content-type"] = "application/octet-stream";
+            headers["content-type"] = body.contentType;
         const signals = [AbortSignal.timeout(opts.timeoutMs ?? exports.FILE_TIMEOUT_MS)];
         if (opts.signal)
             signals.push(opts.signal);
@@ -1197,7 +1244,7 @@ class PromigenceClient {
                     method,
                     headers,
                     signal,
-                    ...(body === undefined ? {} : { body: body }),
+                    ...(body === undefined ? {} : { body: body.data }),
                     ...(dispatcher === undefined ? {} : { dispatcher }),
                 });
             }
@@ -1217,7 +1264,7 @@ 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);
@@ -1231,7 +1278,7 @@ 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",
@@ -1240,17 +1287,25 @@ class PromigenceClient {
         };
         if (this.caller)
             headers[caller_js_1.CALLER_HEADER] = this.caller;
+        if (body !== undefined)
+            headers["content-type"] = body.contentType;
         const signals = [AbortSignal.timeout(opts.timeoutMs ?? exports.FILE_TIMEOUT_MS)];
         if (opts.signal)
             signals.push(opts.signal);
         const signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
-        const timedOut = () => new core_js_1.TimeoutError(`GET ${path} timed out after ${opts.timeoutMs ?? exports.FILE_TIMEOUT_MS} ms`, "Retry; for a large artefact raise timeoutMs.");
+        const timedOut = () => new core_js_1.TimeoutError(`${method} ${path} timed out after ${opts.timeoutMs ?? exports.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;
@@ -1299,7 +1354,7 @@ 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 }),
@@ -1378,6 +1433,29 @@ 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 core_js_1.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 core_js_1.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" }),
@@ -1436,6 +1514,9 @@ 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),
+                }),
             },
         };
     }
@@ -2184,6 +2265,7 @@ 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`,
@@ -2254,38 +2336,42 @@ 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 core_js_1.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({
@@ -2342,11 +2428,13 @@ 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;
@@ -2356,8 +2444,7 @@ 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;
@@ -2366,7 +2453,12 @@ class PromigenceClient {
                         if (slice.length === 0 && sent < source.size) {
                             throw new core_js_1.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;
@@ -2375,8 +2467,8 @@ 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/cjs/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/cjs/core.js

@@ -7,7 +7,7 @@ exports.fixBeyondMessage = fixBeyondMessage;
 exports.previewsOff = previewsOff;
 exports.exitForCode = exitForCode;
 const hint_js_1 = require("./hint.js");
-exports.VERSION = "0.1.0-beta.13";
+exports.VERSION = "0.1.0-beta.15";
 exports.DOCS_URL = "https://promigence.ai";
 exports.ERRORS_DOCS_URL = "https://www.promigence.ai/docs/errors";
 exports.DEFAULT_API_URL = "https://api.promigence.ai/v1";
@@ -271,6 +271,8 @@ exports.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/cjs/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): {