@deepraxis/sdk 0.1.1-dev.d25d171 → 0.1.1-dev.ea219e1

package/METHODS.md

@@ -1,6 +1,6 @@
 # SDK methods
 
-Generated by `bun run generate`. 426 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`. 428 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.
 
@@ -16,8 +16,18 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | create | POST | `/agent/v1/agents` | no | no |
 | list | GET | `/agent/v1/agents` | no | no |
 | retrieve | GET | `/agent/v1/agents/{agent_id}` | no | no |
+| retrieveAppearance | GET | `/agent/v1/agents/{agent_id}/appearance` | no | no |
 | update | POST | `/agent/v1/agents/{agent_id}` | no | no |
 
+### agent.agents.customers
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| delete | DELETE | `/agent/v1/agents/{agent_id}/customers/{customer_id}` | no | no |
+| list | GET | `/agent/v1/agents/{agent_id}/customers` | no | no |
+| retrieve | GET | `/agent/v1/agents/{agent_id}/customers/{customer_id}` | no | no |
+| retrieveDeletion | GET | `/agent/v1/agents/{agent_id}/customers/{customer_id}/deletion` | no | no |
+
 ### agent.agents.customers.auth.accessTokens
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -37,32 +47,23 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/agent/v1/agents/{agent_id}/customers/auth/grant_codes` | no | no |
 
-### agent.agents.endUsers
+### agent.agents.customers.block
 
 | Method | HTTP | Path | Streaming | Pagination |
 |---|---|---|---|---|
-| delete | DELETE | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}` | no | no |
-| list | GET | `/agent/v1/agents/{agent_id}/end_users` | no | no |
-| retrieve | GET | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}` | no | no |
-| retrieveDeletion | GET | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/deletion` | no | no |
+| create | POST | `/agent/v1/agents/{agent_id}/customers/{customer_id}/block` | no | no |
 
-### agent.agents.endUsers.block
+### agent.agents.customers.revokeTokens
 
 | Method | HTTP | Path | Streaming | Pagination |
 |---|---|---|---|---|
-| create | POST | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/block` | no | no |
+| create | POST | `/agent/v1/agents/{agent_id}/customers/{customer_id}/revoke_tokens` | no | no |
 
-### agent.agents.endUsers.revokeTokens
+### agent.agents.customers.unblock
 
 | Method | HTTP | Path | Streaming | Pagination |
 |---|---|---|---|---|
-| create | POST | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/revoke_tokens` | no | no |
-
-### agent.agents.endUsers.unblock
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| create | POST | `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock` | no | no |
+| create | POST | `/agent/v1/agents/{agent_id}/customers/{customer_id}/unblock` | no | no |
 
 ### agent.agents.unarchive
 
@@ -144,37 +145,6 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/agent/v1/deployments/{deployment_id}/unpause` | no | no |
 
-### agent.embed
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| retrieveAppearance | GET | `/agent/v1/embed/appearance` | no | no |
-
-### agent.embed.exchange
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| create | POST | `/agent/v1/embed/exchange` | no | no |
-
-### agent.embedTokens
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| create | POST | `/agent/v1/embed_tokens` | no | no |
-| list | GET | `/agent/v1/embed_tokens` | no | no |
-
-### agent.embedTokens.anonymous
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| create | POST | `/agent/v1/embed_tokens/anonymous` | no | no |
-
-### agent.embedTokens.revoke
-
-| Method | HTTP | Path | Streaming | Pagination |
-|---|---|---|---|---|
-| create | POST | `/agent/v1/embed_tokens/{id}/revoke` | no | no |
-
 ### agent.environments
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -404,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 |
@@ -851,6 +831,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 |
@@ -1363,6 +1350,7 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | automation.workflows.distTags.set | Workflow dist-tags use the same npm-style assignment vocabulary as script dist-tags. |
 | 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. |
+| 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>;
     };

package/dist/core/client.d.ts

@@ -2,11 +2,15 @@ import { type UploadFileOptions, type UploadedFile } from '../helpers/file-uploa
 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'> {
+    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

@@ -2,6 +2,7 @@ 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) {
@@ -13,6 +14,15 @@ export class Praxis {
                 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.js

@@ -35,7 +35,7 @@ function assertKnownOptions(options) {
 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) {