@deepraxis/sdk 0.1.0-dev.4cbfc1f → 0.1.0-dev.5dca2b5

package/dist/helpers/file-upload.d.ts

@@ -0,0 +1,24 @@
+import type { Praxis } from '../core/client.js';
+import type { OwnFileOpenAiFile } from '../generated/types.gen.js';
+export interface UploadFileOptions {
+    /** user_data for conversation attachments; assistants for assistant files; vision for PNG/JPEG/GIF/WebP. */
+    purpose: 'user_data' | 'assistants' | 'vision';
+    /** Defaults to File.name, or upload for a Blob. */
+    filename?: string;
+    /** Fixed part size in bytes, 5 MiB–64 MB; defaults to 50 MiB. */
+    partSize?: number;
+    /** Concurrent part requests, a positive integer; defaults to 3. */
+    concurrency?: number;
+    /** Aborts outstanding requests and cancels an unfinished Upload. */
+    signal?: AbortSignal;
+    /** Acknowledged byte fraction, 0–1. A value of 1 does not imply processing has finished. */
+    onProgress?: (fraction: number) => void;
+}
+export type UploadedFile = OwnFileOpenAiFile;
+/** Upload a nonempty file up to 2 GiB, returning only after processing reaches active.
+ * Files up to 32 MiB use one request; larger files use fixed-size Uploads parts.
+ * Parts and complete each retry transient failures at most five times with exponential backoff.
+ * A terminal failure or abort cancels the Upload. Completed files cannot be cancelled;
+ * if abort occurs during processing, delete the resulting file explicitly if no longer needed.
+ */
+export declare function uploadFile(client: Pick<Praxis, 'file'>, file: Blob | File, options: UploadFileOptions): Promise<UploadedFile>;

package/dist/helpers/file-upload.js

@@ -0,0 +1,113 @@
+import { PraxisError, PraxisConnectionError, PraxisTimeoutError } from "../core/errors.js";
+import { sleep } from "../core/retry.js";
+const MAX_RETRIES = 5;
+function retryable(error) {
+    return error instanceof PraxisConnectionError || error instanceof PraxisTimeoutError
+        || error instanceof SyntaxError
+        || (error instanceof PraxisError && (error.status === 408 || error.status === 429 || (error.status !== undefined && error.status >= 500 && error.status <= 599)));
+}
+async function retry(signal, operation) {
+    for (let used = 0;; used++) {
+        signal.throwIfAborted();
+        try {
+            return await operation();
+        }
+        catch (error) {
+            signal.throwIfAborted();
+            if (used >= MAX_RETRIES || !retryable(error))
+                throw error;
+            await sleep(500 * 2 ** used, signal);
+        }
+    }
+}
+/** Upload a nonempty file up to 2 GiB, returning only after processing reaches active.
+ * Files up to 32 MiB use one request; larger files use fixed-size Uploads parts.
+ * Parts and complete each retry transient failures at most five times with exponential backoff.
+ * A terminal failure or abort cancels the Upload. Completed files cannot be cancelled;
+ * if abort occurs during processing, delete the resulting file explicitly if no longer needed.
+ */
+export async function uploadFile(client, file, options) {
+    options.signal?.throwIfAborted();
+    if (file.size < 1 || file.size > 2 * 1024 ** 3)
+        throw new RangeError('File size must be 1 byte through 2 GiB');
+    const partSize = options.partSize ?? 50 * 1024 ** 2;
+    const concurrency = options.concurrency ?? 3;
+    if (!Number.isSafeInteger(partSize) || partSize < 5 * 1024 ** 2 || partSize > 64_000_000)
+        throw new RangeError('partSize must be an integer from 5242880 through 64000000');
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1)
+        throw new RangeError('concurrency must be a positive integer');
+    const filename = options.filename ?? (typeof File !== 'undefined' && file instanceof File ? file.name : 'upload');
+    const work = new AbortController();
+    const abort = () => work.abort(options.signal?.reason);
+    options.signal?.addEventListener('abort', abort, { once: true });
+    const signal = work.signal;
+    const request = { signal, maxRetries: 0, timeoutMs: 120_000 };
+    let uploadId;
+    const active = async (initial) => {
+        let result = initial;
+        for (let polls = 0;; polls++) {
+            signal.throwIfAborted();
+            if (result.state === 'active')
+                return result;
+            if (result.state !== 'processing')
+                throw new PraxisError({ code: 'FILE_PROCESSING_FAILED', message: `File ${result.id} is not active (${result.state})` });
+            await sleep(Math.min(5000, 1000 * 2 ** polls), signal);
+            result = await retry(signal, () => client.file.files.retrieve({ path: { file_id: result.id }, ...request }));
+        }
+    };
+    try {
+        signal.throwIfAborted();
+        options.onProgress?.(0);
+        if (file.size <= 32 * 1024 ** 2) {
+            const result = await client.file.files.create({ body: { file: new File([file], filename, { type: file.type }), purpose: options.purpose }, ...request });
+            options.onProgress?.(1);
+            return await active(result);
+        }
+        const upload = await client.file.uploads.create({ body: { bytes: file.size, filename, mime_type: file.type || 'application/octet-stream', purpose: options.purpose, part_size: partSize }, ...request });
+        uploadId = upload.id;
+        signal.throwIfAborted();
+        const path = { upload_id: uploadId };
+        const count = Math.ceil(file.size / partSize);
+        const ids = new Array(count);
+        let cursor = 0, confirmed = 0;
+        const worker = async () => {
+            while (cursor < count) {
+                signal.throwIfAborted();
+                const index = cursor++;
+                const chunk = file.slice(index * partSize, Math.min(file.size, (index + 1) * partSize));
+                const part = await retry(signal, () => client.file.uploads.parts.create({ path, query: { part_number: index + 1 }, body: { data: new File([chunk], filename) }, ...request }));
+                ids[index] = part.id;
+                confirmed += chunk.size;
+                options.onProgress?.(confirmed / file.size);
+            }
+        };
+        const workers = Array.from({ length: Math.min(concurrency, count) }, worker);
+        try {
+            await Promise.all(workers);
+        }
+        catch (error) {
+            work.abort();
+            await Promise.allSettled(workers);
+            throw error;
+        }
+        const result = await retry(signal, () => client.file.uploads.complete({ path, body: { part_ids: ids }, ...request }));
+        if (result.error)
+            throw new PraxisError({ code: result.error.code, message: result.error.message });
+        if (result.status !== 'completed' || !result.file)
+            throw new PraxisError({ code: 'INVALID_RESPONSE', message: 'Complete did not return a completed Upload with a file' });
+        return await active(result.file);
+    }
+    catch (error) {
+        work.abort();
+        if (uploadId) {
+            // Cleanup uses its own timeout and must not inherit the aborted work signal.
+            await client.file.uploads.cancel({ path: { upload_id: uploadId }, maxRetries: 0, timeoutMs: 10_000 }).catch(() => { });
+        }
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        throw error;
+    }
+    finally {
+        options.signal?.removeEventListener('abort', abort);
+    }
+}

package/dist/index.d.ts

@@ -9,3 +9,5 @@ export { publish } from './helpers/application-publish.js';
 export type { PublishInput, PublishResult, AssetsConfig } from './helpers/application-publish.js';
 export { count } from './helpers/database-count.js';
 export type { CountInput, CountResult } from './helpers/database-count.js';
+export { uploadFile } from './helpers/file-upload.js';
+export type { UploadFileOptions, UploadedFile } from './helpers/file-upload.js';

package/dist/index.js

@@ -4,3 +4,4 @@ export { Page } from "./core/pagination.js";
 export { parseSSE } from "./core/sse.js";
 export { publish } from "./helpers/application-publish.js";
 export { count } from "./helpers/database-count.js";
+export { uploadFile } from "./helpers/file-upload.js";

package/dist/operations.generated.d.ts

@@ -102,6 +102,24 @@ export declare const operations: readonly [{
             readonly itemType: "object";
             readonly required: false;
             readonly description: "Tool configurations available to the agent. Maximum of 128 tools\nacross all toolsets allowed.";
+        }, {
+            readonly name: "databases";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Database allowlist for platform resources accessible through service-agent codemode. Only kind=service accepts nonempty bindings; personal agents return 400. At most 20 bindings per resource type, with no duplicate ids. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Unbound resources return 404; writes to read_only resources are refused. Other platform APIs return 403, except public API discovery. Invalid bindings and unknown item fields return 400. Omit on create for no bindings.";
+        }, {
+            readonly name: "vector_stores";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Knowledge vector store allowlist for platform resources accessible through service-agent codemode. Only kind=service accepts nonempty bindings; personal agents return 400. At most 20 bindings per resource type, with no duplicate ids. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Unbound resources return 404; writes to read_only resources are refused. Other platform APIs return 403, except public API discovery. Invalid bindings and unknown item fields return 400. Omit on create for no bindings.";
+        }, {
+            readonly name: "files";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "File allowlist for platform resources accessible through service-agent codemode. Only kind=service accepts nonempty bindings; personal agents return 400. At most 20 bindings per resource type, with no duplicate ids. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Unbound resources return 404; writes to read_only resources are refused. Other platform APIs return 403, except public API discovery. Invalid bindings and unknown item fields return 400. Omit on create for no bindings.";
         }, {
             readonly name: "kind";
             readonly type: "string";
@@ -236,6 +254,24 @@ export declare const operations: readonly [{
             readonly type: "number";
             readonly required: false;
             readonly description: "The agent's current version, used to prevent concurrent overwrites.\nObtain this value from a create or retrieve response. Must be at least 1 if\nspecified. When supplied, the request fails if it does not match the server's\ncurrent version; omit to apply the update unconditionally.";
+        }, {
+            readonly name: "databases";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Replace this resource allowlist; omission preserves it, and null or [] clears it. Additions apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Only service agents accept nonempty bindings.";
+        }, {
+            readonly name: "vector_stores";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Replace this resource allowlist; omission preserves it, and null or [] clears it. Additions apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Only service agents accept nonempty bindings.";
+        }, {
+            readonly name: "files";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Replace this resource allowlist; omission preserves it, and null or [] clears it. Additions apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Only service agents accept nonempty bindings.";
         }, {
             readonly name: "kind";
             readonly type: "string";
@@ -608,7 +644,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.computers";
     readonly method: "connect";
     readonly summary: "Connect computer";
-    readonly description: "Resume the computer and issue a sandbox connection.\n\nOwn-face extension: Managed Agents has no persistent Computer connection. Returns the public SDK sandbox_id, envd_access_token and template_id, plus the machine tier the computer is on now (light or heavy) and the lease that keeps it there (lease_id, lease_expires_at; lease_id is null when no lease exists). Keep the lease while the connection stays open: renew it about every 20 seconds (POST .../leases/{lease_id}/renew) and release it on close (DELETE .../leases/{lease_id}). An unrenewed lease simply expires, and the full machine is reclaimed only after that. Archived computers remain accessible; foreign or absent computers return 404. Never cache credentials.\n\nConnect to a computer with a caller-held lease. Omit the body or send {} to request light: the lightweight shell, or the heavy instance while it is running. Send {\"need\":\"heavy\"} to request full Linux for interactive programs; files are synchronized before the heavy connection is returned with tier heavy. Heavy running time counts toward the daily budget in seconds. Renew the lease while using the connection and release it with DELETE when finished. If the daily budget is exhausted, 429 COMPUTER_BUDGET_EXHAUSTED allows you to continue with need light.";
+    readonly description: "Resume the computer and issue a sandbox connection.\n\nOwn-face extension: Managed Agents has no persistent Computer connection. Returns the public SDK sandbox_id, envd_access_token and template_id, plus the machine tier the computer is on now (light or heavy) and the lease that keeps it there (lease_id, lease_expires_at; lease_id is null when no lease exists). Keep the lease while the connection stays open: renew it about every 20 seconds (POST .../leases/{lease_id}/renew) and release it on close (DELETE .../leases/{lease_id}). An unrenewed lease simply expires, and the full machine is reclaimed only after that. Archived computers remain accessible; foreign or absent computers return 404. Never cache credentials.\n\nConnect to a computer with a caller-held lease. Omit the body or send {} to request light: the lightweight shell, or the heavy instance while it is running. Send {\"need\":\"heavy\"} to request full Linux for interactive programs; files are synchronized before the heavy connection is returned with tier heavy. Renew the lease while using the connection and release it with DELETE when finished.";
     readonly http: "POST";
     readonly path: "/agent/v1/computers/{computer_id}/connect";
     readonly streaming: "no";
@@ -1442,7 +1478,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.sessions";
     readonly method: "create";
     readonly summary: "Create session";
-    readonly description: "Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest version) or {id, version, type:\"agent\"}. Unlike Anthropic Managed Agents, omit environment_id to get a light machine, unless computer_id (explicit, or the agent's default) selects a Computer; pass environment_id for a sandbox recipe. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Inline agent overrides are not supported. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Omitted budget defaults to USD 20; null removes the limit, and a limit object uses a positive integer string of USD cents. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
+    readonly description: "Create a session: one conversation with an agent. Pass agent as an agent id (latest version) or {id, version, type:\"agent\"}. Unlike Anthropic Managed Agents, omit environment_id to get a light machine, unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, omission returns environment_id=light; explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Inline agent overrides are not supported. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Omitted budget defaults to USD 20; null removes the limit, and a limit object uses a positive integer string of USD cents. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
     readonly http: "POST";
     readonly path: "/agent/v1/sessions";
     readonly streaming: "no";
@@ -1460,7 +1496,7 @@ export declare const operations: readonly [{
             readonly name: "environment_id";
             readonly type: "string";
             readonly required: false;
-            readonly description: "ID of the `environment` defining the container configuration for\nthis session.";
+            readonly description: "Execution environment id from agent.environments.list or agent.environments.create. For a service agent, omission selects the built-in light environment and returns session.environment_id=light; explicit null allocates no machine and makes machine tools, including codemode and bash, unavailable. Personal agents use their selected Computer.";
         }, {
             readonly name: "budget";
             readonly type: "object";
@@ -6113,7 +6149,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "create";
     readonly summary: "Upload file";
-    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 104857600 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. OpenAI Uploads chunking is not supported. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.";
+    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.";
     readonly http: "POST";
     readonly path: "/file/v1/files";
     readonly streaming: "no";
@@ -6127,7 +6163,7 @@ export declare const operations: readonly [{
             readonly name: "file";
             readonly type: "string";
             readonly required: true;
-            readonly description: "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 104857600 bytes; its content determines the MIME type.";
+            readonly description: "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 100000000 bytes; its content determines the MIME type.";
         }, {
             readonly name: "purpose";
             readonly type: "string";
@@ -6164,7 +6200,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "retrieve";
     readonly summary: "Retrieve file";
-    readonly description: "Retrieve metadata for a live file owned by your tenant. Use its file_dp_ ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.";
+    readonly description: "Retrieve metadata for a live file owned by your tenant. Use its file- ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.";
     readonly http: "GET";
     readonly path: "/file/v1/files/{file_id}";
     readonly streaming: "no";
@@ -6178,7 +6214,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "retrieveContent";
     readonly summary: "Retrieve file content";
-    readonly description: "Download the original bytes of a live file owned by your tenant. Supply its file_dp_ ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.";
+    readonly description: "Download the original bytes of a live file owned by your tenant. Supply its file- ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.";
     readonly http: "GET";
     readonly path: "/file/v1/files/{file_id}/content";
     readonly streaming: "no";
@@ -6188,6 +6224,124 @@ export declare const operations: readonly [{
         readonly sdkName: "file_id";
     }];
     readonly query: readonly [];
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "create";
+    readonly summary: "Create an upload";
+    readonly description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "bytes";
+            readonly type: "integer";
+            readonly required: true;
+            readonly description: "Exact complete file length in bytes, from 1 through 2147483648 (2 GiB); the sum of completed parts must match.";
+        }, {
+            readonly name: "filename";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Filename for the resulting file, at most 255 UTF-8 bytes.";
+        }, {
+            readonly name: "mime_type";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Declared MIME type; validated against the assembled content.";
+        }, {
+            readonly name: "purpose";
+            readonly type: "string";
+            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly required: true;
+            readonly description: "Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images.";
+        }, {
+            readonly name: "expires_after";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Optional expiry policy for the resulting file; omission retains the file until deletion.";
+        }, {
+            readonly name: "part_size";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Optional fixed part size in bytes, 5242880–64000000. Requires part_number on every part; retries of identical bytes at the same number return the same part. Omit to use arbitrary-sized parts.";
+        }];
+    };
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "cancel";
+    readonly summary: "Cancel an upload";
+    readonly description: "Cancel an unfinished upload using upload_id from create and release its reserved storage. Further parts and completion are rejected. Cancelling an already cancelled upload returns the same terminal result; a completed upload cannot be cancelled. Delete its resulting file instead.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/cancel";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "complete";
+    readonly summary: "Complete an upload";
+    readonly description: "Assemble the uploaded parts into a file. Supply upload_id from create and part_ids from addPart in file byte order; their sizes must total the declared bytes. Optional md5 verifies the assembled content. Retrying identical part_ids and normalized md5 returns the same result; different inputs return 409. Unlike OpenAI, completed can contain a file still processing (status uploaded). Poll files.retrieve using file.id until status processed (own face state active); error, expiry or 404 means processing failed and the file cannot be used.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/complete";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "part_ids";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "All part IDs in concatenation order, without duplicates. Fixed-size uploads require increasing part_number order.";
+        }, {
+            readonly name: "md5";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Optional whole-file MD5 as 32 hexadecimal characters; verified after assembly.";
+        }];
+    };
+}, {
+    readonly resource: "file.uploads.parts";
+    readonly method: "create";
+    readonly summary: "Add an upload part";
+    readonly description: "Send one nonempty part as the multipart data field, at most 64000000 bytes. Parts may arrive concurrently in any order. Use upload_id from create. For a fixed-size upload, supply part_number starting at 1 and exactly part_size bytes except for the final remainder; retry the same number with identical bytes to recover its part ID. Without part_size, each request creates a new part and part_number is ignored. Save the returned part IDs for complete.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/parts";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly multipart: true;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [{
+        readonly name: "part_number";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "Required when create set part_size; 1 through ceil(bytes / part_size). Ignored for general uploads.";
+    }];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "data";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Raw bytes of this part, nonempty and at most 64000000 bytes.";
+        }];
+    };
 }, {
     readonly resource: "knowledge.vectorStores";
     readonly method: "list";
@@ -9462,7 +9616,7 @@ export declare const operations: readonly [{
             readonly name: "message";
             readonly type: "string";
             readonly required: true;
-            readonly description: "Problem description and original error text; at most 4096 Unicode code points.";
+            readonly description: "Problem description, at most 4096 Unicode code points; may be empty only when contexts.praxis.error.message is a non-empty string.";
         }, {
             readonly name: "contact_email";
             readonly type: "string";
@@ -9697,7 +9851,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "create";
     readonly summary: "Create sandbox (v2)";
-    readonly description: "Start an isolated environment using a templateID from templates.list, then retain sandboxID for lifecycle calls. Unlike E2B, templateID resolves to your ready Environment or a public Base; omit it to use the default base template (`base`), as the E2B SDK does. timeout is seconds from creation and defaults to 300. envVars supplies environment variables and metadata stores your string labels. All system communication is secured; use the returned envdAccessToken for files and commands through the envd data plane, not the management methods. Never print that token.";
+    readonly description: "Create a sandbox from the template. All system communication with the sandbox is secured.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes";
     readonly streaming: "no";
@@ -9710,7 +9864,7 @@ export declare const operations: readonly [{
             readonly name: "templateID";
             readonly type: "string";
             readonly required: true;
-            readonly description: "Template ID or alias from templates.list; resolves to your ready Environment first, then a public Base. Omit it to use the default base template (`base`).";
+            readonly description: "Identifier of the required template";
         }, {
             readonly name: "timeout";
             readonly type: "integer";
@@ -9824,7 +9978,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "connect";
     readonly summary: "Connect sandbox (v2)";
-    readonly description: "Reconnect to an existing sandbox and resume it if paused. The optional timeout is seconds from now and defaults to 300; a later existing deadline is preserved. A running sandbox returns 200 and a resumed sandbox returns 201. Read sandboxID, domain and envdAccessToken from the response for subsequent data-plane access; never treat connecting as executing a command.";
+    readonly description: "Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended. The request body is optional; an omitted timeout defaults to 300 seconds.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/connect";
     readonly streaming: "no";
@@ -9945,7 +10099,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes.metrics";
     readonly method: "list";
     readonly summary: "Sandbox metrics";
-    readonly description: "Read CPU, memory and disk usage over the requested interval; start and end are Unix seconds. Unlike E2B, light sandboxes do not provide metrics; check the returned capabilities before requesting them.";
+    readonly description: "Read CPU, memory and disk usage samples of a sandbox over a time window. Use it to size a sandbox or find out why it is slow. start and end are Unix timestamps in seconds; without them the recent samples are returned. An unknown id answers 404.";
     readonly http: "GET";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/metrics";
     readonly streaming: "no";
@@ -10014,7 +10168,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "pause";
     readonly summary: "Pause sandbox";
-    readonly description: "Suspend a running sandbox for later connection; use delete to discard it instead. Unlike E2B, light sandboxes preserve disk rather than memory, and persistent sandboxes can resume on data-plane traffic even when autoResume is false. Inspect paused state with the management retrieve operation to avoid waking the sandbox. Explicitly ephemeral sandboxes cannot pause. memory defaults to true, but only a memory-capable sandbox preserves running processes; memory=false saves disk state and resumes with a cold boot. Success returns 204; connect resumes the saved sandbox.";
+    readonly description: "Pause a running sandbox, keeping its files and memory so that connectSandbox can resume it later. Use it to stop paying for compute without losing state; to discard the sandbox use killSandbox. Success answers 204. A sandbox that is not running answers 409.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/pause";
     readonly streaming: "no";
@@ -10330,7 +10484,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.templates";
     readonly method: "list";
     readonly summary: "List templates (v2)";
-    readonly description: "Choose a templateID before creating a sandbox. Unlike E2B, this catalog lists your ready Environments and public Bases; use a returned ID or alias; `base` is the default template that create uses when templateID is omitted. Page through results using nextToken.";
+    readonly description: "List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.";
     readonly http: "GET";
     readonly path: "/sandbox/v1/templates";
     readonly streaming: "no";