@deepraxis/sdk 0.1.1-dev.d775f1e → 0.1.1-dev.de0a917

package/METHODS.md

@@ -1,6 +1,6 @@
 # SDK methods
 
-Generated by `bun run generate`. 421 HTTP operations, plus product aliases. Version segments and path parameters are omitted from resource names. Inputs use typed `{ path, query, body, headers }` options. Collections form nested resource objects; POST actions retain their verb. Naming rules are documented in `scripts/resources.ts`; semantic exceptions and aliases with reasons are in `scripts/naming-overrides.ts`.
+Generated by `bun run generate`. 485 HTTP operations, plus product aliases. Version segments and path parameters are omitted from resource names. Inputs use typed `{ path, query, body, headers }` options. Collections form nested resource objects; POST actions retain their verb. Naming rules are documented in `scripts/resources.ts`; semantic exceptions and aliases with reasons are in `scripts/naming-overrides.ts`.
 
 `always` returns an AsyncIterable; `optional` streams with `{ stream: true }`; `yes` pagination returns a Page. Only `{ data, next_cursor }` + `cursor` query contracts are automatically paginated.
 
@@ -374,6 +374,16 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | send | POST | `/automation/v1/hooks/{trigger_id}/{token}` | no | no |
 
+### automation.humanTasks
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| cancel | POST | `/automation/v1/human-tasks/{id}/cancel` | no | no |
+| delegate | POST | `/automation/v1/human-tasks/{id}/delegate` | no | no |
+| list | GET | `/automation/v1/human-tasks` | no | yes |
+| respond | POST | `/automation/v1/human-tasks/{id}/respond` | no | no |
+| retrieve | GET | `/automation/v1/human-tasks/{id}` | no | no |
+
 ### automation.resolve
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -439,6 +449,14 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | list | GET | `/automation/v1/scripts/{ns}/{name}/dist-tags` | no | no |
 | set | PUT | `/automation/v1/scripts/{ns}/{name}/dist-tags/{tag}` | no | no |
 
+### automation.scripts.vaults
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| delete | DELETE | `/automation/v1/scripts/{ns}/{name}/vaults/{alias}` | no | no |
+| list | GET | `/automation/v1/scripts/{ns}/{name}/vaults` | no | no |
+| set | PUT | `/automation/v1/scripts/{ns}/{name}/vaults/{alias}` | no | no |
+
 ### automation.scripts.versions
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -500,6 +518,14 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | list | GET | `/automation/v1/workflows/{ns}/{name}/dist-tags` | no | no |
 | set | PUT | `/automation/v1/workflows/{ns}/{name}/dist-tags/{tag}` | no | no |
 
+### automation.workflows.vaults
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| delete | DELETE | `/automation/v1/workflows/{ns}/{name}/vaults/{alias}` | no | no |
+| list | GET | `/automation/v1/workflows/{ns}/{name}/vaults` | no | no |
+| set | PUT | `/automation/v1/workflows/{ns}/{name}/vaults/{alias}` | no | no |
+
 ### automation.workflows.versions
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -569,6 +595,117 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/browser/v1/sessions/{sessionId}/viewer` | no | no |
 
+## canvas
+
+### canvas.canvases
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/canvas/v1/canvases` | no | no |
+| delete | DELETE | `/canvas/v1/canvases/{canvas_id}` | no | no |
+| execute | POST | `/canvas/v1/canvases/{canvas_id}:execute` | no | no |
+| list | GET | `/canvas/v1/canvases` | no | yes |
+| restore | POST | `/canvas/v1/canvases/{canvas_id}:restore` | no | no |
+| retrieve | GET | `/canvas/v1/canvases/{canvas_id}` | no | no |
+| update | PATCH | `/canvas/v1/canvases/{canvas_id}` | no | no |
+
+### canvas.canvases.images
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/canvas/v1/canvases/{canvas_id}/images` | no | no |
+
+### canvas.canvases.nodes
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/canvas/v1/canvases/{canvas_id}/nodes` | no | no |
+
+### canvas.canvases.versions
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/canvas/v1/canvases/{canvas_id}/versions` | no | no |
+
+### canvas.collections
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/canvas/v1/collections` | no | no |
+| delete | DELETE | `/canvas/v1/collections/{collection_id}` | no | no |
+| list | GET | `/canvas/v1/collections` | no | no |
+| retrieve | GET | `/canvas/v1/collections/{collection_id}` | no | no |
+| update | PATCH | `/canvas/v1/collections/{collection_id}` | no | no |
+
+## cut
+
+### cut.exports
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| cancel | POST | `/cut/v1/exports/{export_id}:cancel` | no | no |
+| retrieve | GET | `/cut/v1/exports/{export_id}` | no | no |
+
+### cut.projects
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects` | no | no |
+| delete | DELETE | `/cut/v1/projects/{project_id}` | no | no |
+| execute | POST | `/cut/v1/projects/{project_id}:execute` | no | no |
+| list | GET | `/cut/v1/projects` | no | no |
+| retrieve | GET | `/cut/v1/projects/{project_id}` | no | no |
+| retrieveState | GET | `/cut/v1/projects/{project_id}/state` | no | no |
+| retrieveTimeline | GET | `/cut/v1/projects/{project_id}/timeline` | no | no |
+| undelete | POST | `/cut/v1/projects/{project_id}:undelete` | no | no |
+| update | PATCH | `/cut/v1/projects/{project_id}` | no | no |
+
+### cut.projects.analysis
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects/{project_id}/analysis` | no | no |
+
+### cut.projects.bindings
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects/{project_id}/bindings` | no | no |
+| delete | DELETE | `/cut/v1/projects/{project_id}/bindings/{name}` | no | no |
+| list | GET | `/cut/v1/projects/{project_id}/bindings` | no | no |
+
+### cut.projects.exports
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects/{project_id}/exports` | no | no |
+| list | GET | `/cut/v1/projects/{project_id}/exports` | no | no |
+
+### cut.projects.frames
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/cut/v1/projects/{project_id}/frames` | no | no |
+
+### cut.projects.media
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| import | POST | `/cut/v1/projects/{project_id}/media:import` | no | no |
+
+### cut.projects.versions
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects/{project_id}/versions` | no | no |
+| list | GET | `/cut/v1/projects/{project_id}/versions` | no | no |
+
+### cut.versions
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| restore | POST | `/cut/v1/versions/{version_id}:restore` | no | no |
+
 ## database
 
 ### database.databases
@@ -634,6 +771,18 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | retrieve | GET | `/file/v1/files/{file_id}` | no | no |
 | retrieveContent | GET | `/file/v1/files/{file_id}/content` | no | no |
 
+### file.files.contentLinks
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| revoke | POST | `/file/v1/files/{file_id}/content_links:revoke` | no | no |
+
+### file.files.contentUrl
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/file/v1/files/{file_id}/content_url` | no | no |
+
 ### file.uploads
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -641,6 +790,7 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | cancel | POST | `/file/v1/uploads/{upload_id}/cancel` | no | no |
 | complete | POST | `/file/v1/uploads/{upload_id}/complete` | no | no |
 | create | POST | `/file/v1/uploads` | no | no |
+| createSigned | POST | `/file/v1/uploads/signed` | no | no |
 
 ### file.uploads.parts
 
@@ -771,6 +921,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | create | POST | `/media/v1/libraries/{library_id}/batches` | no | no |
 | retrieve | GET | `/media/v1/libraries/{library_id}/batches/{job_id}` | no | no |
 
+### media.libraries.deliveryTokens
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/media/v1/libraries/{library_id}/delivery_tokens` | no | no |
+
 ### media.libraries.events
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -821,6 +977,13 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 
 ## meta
 
+### meta.docs
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieve | GET | `/meta/v1/docs/{path}` | no | no |
+| search | GET | `/meta/v1/docs/search` | no | no |
+
 ### meta.health
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -944,6 +1107,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/model/v1/responses/input_tokens` | no | no |
 
+### model.systemone
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/model/v1/systemone` | no | no |
+
 ### model.videos
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -1079,7 +1248,36 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 
 | Method | HTTP | Path | Streaming | Pagination |
 |---|---|---|---|---|
+| create | POST | `/sandbox/v1/templates` | no | no |
+| delete | DELETE | `/sandbox/v1/templates/{templateID}` | no | no |
 | list | GET | `/sandbox/v1/templates` | no | no |
+| retrieve | GET | `/sandbox/v1/templates/{templateID}` | no | no |
+
+### sandbox.templates.aliases
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieve | GET | `/sandbox/v1/templates/aliases/{alias}` | no | no |
+
+### sandbox.templates.builds
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| update | POST | `/sandbox/v1/templates/{templateID}/builds/{buildID}` | no | no |
+
+### sandbox.templates.builds.status
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/sandbox/v1/templates/{templateID}/builds/{buildID}/status` | no | no |
+
+### sandbox.templates.tags
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/sandbox/v1/templates/tags` | no | no |
+| delete | DELETE | `/sandbox/v1/templates/tags` | no | no |
+| list | GET | `/sandbox/v1/templates/{templateID}/tags` | no | no |
 
 ### sandbox.volumes
 
@@ -1329,10 +1527,14 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | agent.sessions.events.send | Events submit session input; the product verb is send rather than create. |
 | automation.hooks.send | Delivers a payload to a trigger's secret webhook URL; it sends an event rather than updating a hook resource. |
 | automation.scripts.distTags.set | A dist-tag assigns a version to a name; use npm vocabulary set rather than update. |
+| automation.scripts.vaults.set | Assign a whole vault to a definition alias, independently of published versions. |
 | automation.scripts.versions.create / publish | Creating a script version publishes it; publish is a product alias of versions.create. |
 | automation.workflows.distTags.set | Workflow dist-tags use the same npm-style assignment vocabulary as script dist-tags. |
+| automation.workflows.vaults.set | Assign a whole vault to a definition alias, independently of published versions. |
 | automation.workflows.versions.create / publish | Creating a workflow version publishes it; publish is a product alias of versions.create. |
 | database.databases.rest.create | The final parameter identifies a table collection; POST inserts rows rather than updating the table. |
+| file.uploads.createSigned | Signed upload creation returns a one-time local PUT URL; ADR-039 names this operation uploads.createSigned. |
+| meta.docs.search | Documentation keyword search is an operation on docs, not a nested collection. |
 | sandbox.sandboxes.commands.run | Sandbox data operations use the E2B SDK verb while preserving URL resource nesting. |
 | sandbox.sandboxes.files.remove | Sandbox data operations use the E2B SDK verb while preserving URL resource nesting. |
 | sandbox.sandboxes.files.read | Sandbox data operations use the E2B SDK verb while preserving URL resource nesting. |

package/README.md

@@ -55,7 +55,7 @@ server. You need a Praxis account; sign up at [deepraxis.com](https://deepraxis.
 const praxis = new Praxis({
   apiKey: process.env.PRAXIS_API_KEY!,
   baseUrl: 'https://api.deepraxis.com',  // default
-  timeoutMs: 60_000,   // default; the whole call, body included
+  timeoutMs: 600_000,  // default (10 minutes, as the OpenAI and Anthropic SDKs); the whole call, body included
   maxRetries: 2,       // default
   // fetch: customFetch,  // bring your own fetch
 });

package/dist/automation.d.ts

@@ -23,6 +23,13 @@ export declare function createAutomationClient(options: PraxisOptions): {
     hooks: {
         send: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHooksReceiveData>) => Promise<import("./generated/types.gen.js").AutomationFiring>;
     };
+    humanTasks: {
+        cancel: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHumanTasksCancelData>) => Promise<import("./generated/types.gen.js").AutomationHumanTask>;
+        delegate: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHumanTasksDelegateData>) => Promise<import("./generated/types.gen.js").AutomationHumanTask>;
+        list: (options?: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHumanTasksListData> | undefined) => Promise<import("./automation.js").Page<import("./generated/types.gen.js").AutomationHumanTask>>;
+        respond: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHumanTasksRespondData>) => Promise<import("./generated/types.gen.js").AutomationHumanTask>;
+        retrieve: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationHumanTasksGetData>) => Promise<import("./generated/types.gen.js").AutomationHumanTask>;
+    };
     resolve: {
         retrieve: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationResolveResolveData>) => Promise<import("./generated/types.gen.js").AutomationResolveResult>;
     };
@@ -89,6 +96,33 @@ export declare function createAutomationClient(options: PraxisOptions): {
         restore: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsRestoreData>) => Promise<import("./generated/types.gen.js").AutomationDefinition>;
         retrieve: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsGetData>) => Promise<import("./generated/types.gen.js").AutomationDefinitionDetail>;
         update: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsPatchData>) => Promise<import("./generated/types.gen.js").AutomationDefinitionDetail>;
+        vaults: {
+            delete: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsVaultsDeleteData>) => Promise<void>;
+            list: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsVaultsListData>) => Promise<{
+                data: Array<{
+                    alias: string;
+                    vault: {
+                        id: string;
+                        name: string;
+                    };
+                    secrets: Array<{
+                        name: string;
+                    }>;
+                    secrets_unavailable?: true;
+                }>;
+            }>;
+            set: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsVaultsSetData>) => Promise<{
+                alias: string;
+                vault: {
+                    id: string;
+                    name: string;
+                };
+                secrets: Array<{
+                    name: string;
+                }>;
+                secrets_unavailable?: true;
+            }>;
+        };
         versions: {
             create: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsPublishData>) => Promise<import("./generated/types.gen.js").AutomationVersion>;
             deprecate: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationScriptsDeprecateData>) => Promise<import("./generated/types.gen.js").AutomationVersion>;
@@ -136,6 +170,33 @@ export declare function createAutomationClient(options: PraxisOptions): {
         restore: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsRestoreData>) => Promise<import("./generated/types.gen.js").AutomationDefinition>;
         retrieve: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsGetData>) => Promise<import("./generated/types.gen.js").AutomationDefinitionDetail>;
         update: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsPatchData>) => Promise<import("./generated/types.gen.js").AutomationDefinitionDetail>;
+        vaults: {
+            delete: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsVaultsDeleteData>) => Promise<void>;
+            list: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsVaultsListData>) => Promise<{
+                data: Array<{
+                    alias: string;
+                    vault: {
+                        id: string;
+                        name: string;
+                    };
+                    secrets: Array<{
+                        name: string;
+                    }>;
+                    secrets_unavailable?: true;
+                }>;
+            }>;
+            set: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsVaultsSetData>) => Promise<{
+                alias: string;
+                vault: {
+                    id: string;
+                    name: string;
+                };
+                secrets: Array<{
+                    name: string;
+                }>;
+                secrets_unavailable?: true;
+            }>;
+        };
         versions: {
             create: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsPublishData>) => Promise<import("./generated/types.gen.js").AutomationVersion>;
             deprecate: (options: import("./core/transport.js").CallOptions<import("./generated/types.gen.js").AutomationWorkflowsDeprecateData>) => Promise<import("./generated/types.gen.js").AutomationVersion>;

package/dist/core/client.d.ts

@@ -1,12 +1,22 @@
+import { type SandboxTemplateBuildInput, type SandboxTemplateBuildResult } from "../helpers/sandbox-templates.js";
 import { type UploadFileOptions, type UploadedFile } from '../helpers/file-upload.js';
 import { resourceFactories } from '../resources.generated.js';
 import { type PraxisOptions } from './transport.js';
 import { type PublishInput, type PublishResult } from '../helpers/application-publish.js';
+import { type BrowserConnectOptions, type PraxisBrowser } from '../helpers/browser-connect.js';
 import { type CountInput, type CountResult } from '../helpers/database-count.js';
 type Resources = {
     readonly [K in keyof typeof resourceFactories]: ReturnType<(typeof resourceFactories)[K]>;
 };
-export interface Praxis extends Omit<Resources, 'application' | 'database' | 'file'> {
+export interface Praxis extends Omit<Resources, 'application' | 'browser' | 'database' | 'file' | 'sandbox'> {
+    readonly sandbox: Omit<Resources['sandbox'], 'templates'> & {
+        templates: Resources['sandbox']['templates'] & {
+            build(input: SandboxTemplateBuildInput): Promise<SandboxTemplateBuildResult>;
+        };
+    };
+    readonly browser: Resources['browser'] & {
+        connect(options?: BrowserConnectOptions): Promise<PraxisBrowser>;
+    };
     readonly file: Resources['file'] & {
         uploadFile(file: Blob | File, options: UploadFileOptions): Promise<UploadedFile>;
     };

package/dist/core/client.js

@@ -1,7 +1,9 @@
+import { buildSandboxTemplate } from "../helpers/sandbox-templates.js";
 import { uploadFile } from "../helpers/file-upload.js";
 import { resourceFactories } from "../resources.generated.js";
 import { Transport } from "./transport.js";
 import { publish } from "../helpers/application-publish.js";
+import { connectBrowser } from "../helpers/browser-connect.js";
 import { count } from "../helpers/database-count.js";
 export class Praxis {
     constructor(options) {
@@ -9,10 +11,21 @@ export class Praxis {
         for (const [name, create] of Object.entries(resourceFactories)) {
             const resource = create(transport);
             // Assemble before sealing the resource property; never replace a readonly SDK resource.
+            if (name === 'sandbox')
+                Object.assign(resource.templates, { build: (input) => buildSandboxTemplate(this, input) });
             if (name === 'file')
                 Object.assign(resource, { uploadFile: (file, options) => uploadFile(this, file, options) });
             if (name === 'database')
                 Object.assign(resource, { count: (input) => count(transport, input) });
+            if (name === 'browser') {
+                // The npm build has no Node globals in scope; name the process shape this helper reads.
+                const host = globalThis.process;
+                Object.assign(resource, { connect: (options) => connectBrowser({
+                        contexts: resource.contexts,
+                        env: host?.env ?? {},
+                        builtin: host?.getBuiltinModule?.bind(host),
+                    }, options) });
+            }
             if (name === 'application')
                 Object.assign(resource, { publish: (input) => publish(this, input) });
             Object.defineProperty(this, name, { value: resource, enumerable: true });

package/dist/core/transport.d.ts

@@ -25,6 +25,15 @@ type InternalOptions = RequestOptions & {
     query?: unknown;
     lastEventId?: string;
 };
+/** Margin over a server-side execution deadline: the response still has to travel back after it. */
+export declare const SERVER_DEADLINE_MARGIN_MS = 30000;
+/**
+ * A request body that carries its own execution deadline (`timeoutMs`, as in sandbox commands.run) is
+ * waited for at least that long plus a margin, so the client never gives up before the server answers.
+ */
+export declare function serverDeadlineMs(options: {
+    body?: unknown;
+}): number;
 export declare class Transport {
     private readonly config;
     constructor(options: PraxisOptions);

package/dist/core/transport.js

@@ -32,10 +32,21 @@ function assertKnownOptions(options) {
         detail: `Unrecognised option ${stray.length > 1 ? 'keys' : 'key'} ${names}. Request parameters are not flat: put each under \`query\` (GET/DELETE: filters, pagination), \`path\` (URL segments) or \`body\` (POST/PATCH/PUT payload), e.g. call({ query: { ${stray[0]} } }) or call({ body: { ${stray[0]} } }). Common top-level keys: path, query, body, headers, signal, timeoutMs, maxRetries.`,
     });
 }
+/** Margin over a server-side execution deadline: the response still has to travel back after it. */
+export const SERVER_DEADLINE_MARGIN_MS = 30_000;
+/**
+ * A request body that carries its own execution deadline (`timeoutMs`, as in sandbox commands.run) is
+ * waited for at least that long plus a margin, so the client never gives up before the server answers.
+ */
+export function serverDeadlineMs(options) {
+    const body = options.body;
+    const deadline = body && typeof body === 'object' ? body.timeoutMs : undefined;
+    return typeof deadline === 'number' && Number.isFinite(deadline) && deadline > 0 ? deadline + SERVER_DEADLINE_MARGIN_MS : 0;
+}
 export class Transport {
     config;
     constructor(options) {
-        this.config = { timeoutMs: 60_000, maxRetries: 2, fetch: globalThis.fetch, ...options };
+        this.config = { timeoutMs: 600_000, maxRetries: 2, fetch: globalThis.fetch, ...options };
         this.validate(this.config.timeoutMs, this.config.maxRetries);
     }
     validate(timeout, retries) {
@@ -46,7 +57,7 @@ export class Transport {
     }
     scope(options, streaming) {
         assertKnownOptions(options);
-        const timeoutMs = options.timeoutMs ?? this.config.timeoutMs;
+        const timeoutMs = options.timeoutMs ?? Math.max(this.config.timeoutMs, serverDeadlineMs(options));
         const maxRetries = options.maxRetries ?? this.config.maxRetries;
         this.validate(timeoutMs, maxRetries);
         const controller = new AbortController();