@deepraxis/sdk 0.1.1-dev.fcdebee → 0.1.1-dev.fee48ec

package/METHODS.md

@@ -1,6 +1,6 @@
 # SDK methods
 
-Generated by `bun run generate`. 530 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`. 619 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.
 
@@ -103,6 +103,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | list | GET | `/agent/v1/computers/{computer_id}/files` | no | no |
 | retrieveContent | GET | `/agent/v1/computers/{computer_id}/files/content` | no | no |
 
+### agent.computers.files.convert
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/agent/v1/computers/{computer_id}/files/convert` | no | no |
+
 ### agent.computers.leases
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -576,6 +582,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | stream | GET | `/browser/v1/sessions/{sessionId}/stream` | always | no |
 | update | POST | `/browser/v1/sessions/{sessionId}` | no | no |
 
+### browser.sessions.actions
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/browser/v1/sessions/{sessionId}/actions` | no | no |
+
 ### browser.sessions.events
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -786,6 +798,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | import | POST | `/cut/v1/projects/{project_id}/media:import` | no | no |
 
+### cut.projects.renders
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/cut/v1/projects/{project_id}/renders` | no | no |
+
 ### cut.projects.versions
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -793,6 +811,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | create | POST | `/cut/v1/projects/{project_id}/versions` | no | no |
 | list | GET | `/cut/v1/projects/{project_id}/versions` | no | no |
 
+### cut.renders
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieve | GET | `/cut/v1/renders/{render_id}` | no | no |
+
 ### cut.versions
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -852,6 +876,82 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | delete | DELETE | `/database/v1/databases/{database_id}/tables/{table}/fields/{field}` | no | no |
 | update | PATCH | `/database/v1/databases/{database_id}/tables/{table}/fields/{field}` | no | no |
 
+## devops
+
+### devops.projects
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieveTestCatalog | GET | `/devops/v1/projects/{project}/test-catalog` | no | no |
+
+### devops.projects.testCases
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/devops/v1/projects/{project}/test-cases` | no | no |
+
+### devops.projects.testPlans
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/devops/v1/projects/{project}/test-plans` | no | no |
+| list | GET | `/devops/v1/projects/{project}/test-plans` | no | no |
+
+### devops.projects.testReports
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/devops/v1/projects/{project}/test-reports` | no | no |
+
+### devops.projects.testRuns
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/devops/v1/projects/{project}/test-runs` | no | no |
+| list | GET | `/devops/v1/projects/{project}/test-runs` | no | no |
+
+### devops.projects.testSuites
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/devops/v1/projects/{project}/test-suites` | no | no |
+
+### devops.testCases
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieve | GET | `/devops/v1/test-cases/{id}` | no | no |
+
+### devops.testPlans
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| delete | DELETE | `/devops/v1/test-plans/{id}` | no | no |
+| pause | POST | `/devops/v1/test-plans/{id}:pause` | no | no |
+| resume | POST | `/devops/v1/test-plans/{id}:resume` | no | no |
+| retrieve | GET | `/devops/v1/test-plans/{id}` | no | no |
+| update | PATCH | `/devops/v1/test-plans/{id}` | no | no |
+
+### devops.testRuns
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| cancel | POST | `/devops/v1/test-runs/{id}:cancel` | no | no |
+| retrieve | GET | `/devops/v1/test-runs/{id}` | no | no |
+
+### devops.testRuns.executions
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/devops/v1/test-runs/{run}/executions` | no | no |
+| retrieve | GET | `/devops/v1/test-runs/{run}/executions/{case}` | no | no |
+
+### devops.testSuites
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| retrieve | GET | `/devops/v1/test-suites/{id}` | no | no |
+
 ## file
 
 ### file.files
@@ -884,6 +984,7 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | 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 |
+| retrieve | GET | `/file/v1/uploads/{upload_id}` | no | no |
 
 ### file.uploads.parts
 
@@ -1250,6 +1351,57 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | retrieve | GET | `/model/v1/videos/{video_id}` | no | no |
 | retrieveContent | GET | `/model/v1/videos/{video_id}/content` | no | no |
 
+## ontology
+
+### ontology.changesets
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/changesets` | no | no |
+
+### ontology.nodes
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/nodes` | no | no |
+| list | GET | `/ontology/v1/nodes` | no | yes |
+| retrieve | GET | `/ontology/v1/nodes/{node_id}` | no | no |
+| update | PATCH | `/ontology/v1/nodes/{node_id}` | no | no |
+
+### ontology.nodes.merge
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/nodes/{node_id}/merge` | no | no |
+
+### ontology.relations
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/relations` | no | no |
+| list | GET | `/ontology/v1/relations` | no | yes |
+| retrieve | GET | `/ontology/v1/relations/{relation_id}` | no | no |
+
+### ontology.relations.invalidate
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/relations/{relation_id}/invalidate` | no | no |
+
+### ontology.search
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/search` | no | no |
+
+### ontology.types
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/ontology/v1/types` | no | no |
+| list | GET | `/ontology/v1/types` | no | no |
+| retrieve | GET | `/ontology/v1/types/{name}` | no | no |
+
 ## organization
 
 ### organization.charges
@@ -1446,6 +1598,124 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/search/v1/search` | no | no |
 
+## studio
+
+### studio.codexes
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/codexes` | no | no |
+| delete | DELETE | `/studio/v1/codexes/{codex}` | no | no |
+| list | GET | `/studio/v1/codexes` | no | no |
+| retrieve | GET | `/studio/v1/codexes/{codex}` | no | no |
+| update | PATCH | `/studio/v1/codexes/{codex}` | no | no |
+
+### studio.codexes.entries
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/codexes/{codex}/entries` | no | no |
+| delete | DELETE | `/studio/v1/codexes/{codex}/entries/{entry}` | no | no |
+| list | GET | `/studio/v1/codexes/{codex}/entries` | no | no |
+| retrieve | GET | `/studio/v1/codexes/{codex}/entries/{entry}` | no | no |
+| update | PATCH | `/studio/v1/codexes/{codex}/entries/{entry}` | no | no |
+
+### studio.genres
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/studio/v1/genres` | no | no |
+| retrieve | GET | `/studio/v1/genres/{genre}` | no | no |
+
+### studio.platforms
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/studio/v1/platforms` | no | no |
+| retrieve | GET | `/studio/v1/platforms/{platform}` | no | no |
+
+### studio.styles
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/styles` | no | no |
+| delete | DELETE | `/studio/v1/styles/{style}` | no | no |
+| list | GET | `/studio/v1/styles` | no | no |
+| retrieve | GET | `/studio/v1/styles/{style}` | no | no |
+| update | PATCH | `/studio/v1/styles/{style}` | no | no |
+
+### studio.templates
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/templates` | no | no |
+| delete | DELETE | `/studio/v1/templates/{template}` | no | no |
+| list | GET | `/studio/v1/templates` | no | no |
+| retrieve | GET | `/studio/v1/templates/{template}` | no | no |
+
+### studio.themes
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/themes` | no | no |
+| delete | DELETE | `/studio/v1/themes/{theme}` | no | no |
+| list | GET | `/studio/v1/themes` | no | no |
+| retrieve | GET | `/studio/v1/themes/{theme}` | no | no |
+| update | PATCH | `/studio/v1/themes/{theme}` | no | no |
+
+### studio.works
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/works` | no | no |
+| list | GET | `/studio/v1/works` | no | no |
+| resolve | GET | `/studio/v1/works:resolve` | no | no |
+| retrieve | GET | `/studio/v1/works/{work}` | no | no |
+| update | PATCH | `/studio/v1/works/{work}` | no | no |
+| updateBrief | PATCH | `/studio/v1/works/{work}/brief` | no | no |
+
+### studio.works.drafts
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/studio/v1/works/{work}/drafts` | no | no |
+| list | GET | `/studio/v1/works/{work}/drafts` | no | no |
+| rebase | POST | `/studio/v1/works/{work}/drafts/{draft}:rebase` | no | no |
+| retrieve | GET | `/studio/v1/works/{work}/drafts/{draft}` | no | no |
+| retrieveExport | GET | `/studio/v1/works/{work}/drafts/{draft}/export` | no | no |
+| retrieveOutline | GET | `/studio/v1/works/{work}/drafts/{draft}/outline` | no | no |
+| retrieveReview | GET | `/studio/v1/works/{work}/drafts/{draft}/review` | no | no |
+| update | PATCH | `/studio/v1/works/{work}/drafts/{draft}` | no | no |
+
+### studio.works.drafts.status
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/studio/v1/works/{work}/drafts/{draft}/status` | no | no |
+
+### studio.works.drafts.units
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| batchCreate | POST | `/studio/v1/works/{work}/drafts/{draft}/units:batchCreate` | no | no |
+| batchUpdate | POST | `/studio/v1/works/{work}/drafts/{draft}/units:batchUpdate` | no | no |
+| create | POST | `/studio/v1/works/{work}/drafts/{draft}/units` | no | no |
+
+### studio.works.units
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| move | POST | `/studio/v1/works/{work}/units/{unit}:move` | no | no |
+| retrieve | GET | `/studio/v1/works/{work}/units/{unit}` | no | no |
+| retrieveContext | GET | `/studio/v1/works/{work}/units/{unit}/context` | no | no |
+| update | PATCH | `/studio/v1/works/{work}/units/{unit}` | no | no |
+
+### studio.works.units.blocks
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| patch | POST | `/studio/v1/works/{work}/units/{unit}/blocks:patch` | no | no |
+
 ## ticket
 
 ### ticket.activity

package/README.md

@@ -4,7 +4,7 @@
 
 **Models, agents, sandboxes, search, data and automation, typed end to end.**
 
-The official TypeScript SDK for [知行云 Praxis](https://deepraxis.com), the cloud where AI agents are built, run and hosted.
+The official TypeScript SDK for [Praxis](https://deepraxis.com), the cloud where AI agents are built, run and hosted.
 
 [![npm](https://img.shields.io/npm/v/@deepraxis/sdk?label=npm&color=2e8555)](https://www.npmjs.com/package/@deepraxis/sdk)
 [![Bundle size](https://img.shields.io/bundlephobia/minzip/@deepraxis/sdk?color=2e8555)](https://bundlephobia.com/package/@deepraxis/sdk)
@@ -33,7 +33,7 @@ console.log(completion.choices[0]?.message.content);
 ## Why this SDK
 
 - **The whole platform, one client.** About 350 operations across models, agents, sandboxes,
-  cloud browsers, web search, databases, knowledge bases, files, media, automation and hosted
+  browsers, web search, databases, knowledge bases, files, media, automation and hosted
   applications, generated from the same contract as the API.
 - **Types from the contract.** Every path, query, body and response is typed, including the
   events of each stream, so your editor knows what comes back.
@@ -276,5 +276,5 @@ sandboxes, search, data, automation and the rest of the platform.
 
 [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0). Copyright 2026 南京深度实践人工智能科技有限公司 (Deepractice).
 
-"Praxis", "知行云" and "Deepraxis" are trademarks of Deepractice; the license does not grant
+"Praxis" and "Deepraxis" are trademarks of Deepractice; the license does not grant
 rights to use them.

package/dist/core/errors.d.ts

@@ -9,6 +9,9 @@ export interface ProblemDetails {
     requestId?: string;
     message?: string;
     param?: string | null;
+    /** ticket-681 — the documentation page the failure points at, and the exact section to read. */
+    docUrl?: string;
+    describe?: string;
     raw?: unknown;
 }
 /** Pure normalization shared by HTTP clients and the automation call ledger.
@@ -26,6 +29,9 @@ export declare class PraxisError extends Error {
     readonly errors: unknown[];
     readonly requestId?: string;
     readonly param?: string | null;
+    /** ticket-681 — the documented page and the exact section an agent should read to fix the call. */
+    readonly docUrl?: string;
+    readonly describe?: string;
     readonly raw?: unknown;
     constructor(problem?: ProblemDetails, options?: ErrorOptions);
     static fromResponse(response: Response, body: unknown): PraxisError;

package/dist/core/errors.js

@@ -16,6 +16,9 @@ export function problemFrom(status, headers, body, statusText) {
         param: typeof param === 'string' ? param : param === null || nested.param === null ? null : undefined,
         errors: Array.isArray(value.errors) ? value.errors : [],
         requestId: headers.get('x-request-id') ?? string(value.requestId) ?? string(value.request_id),
+        // Both spellings reach here: the own face writes snake_case, an in-process problem keeps docUrl.
+        docUrl: string(nested.doc_url) ?? string(value.doc_url) ?? string(nested.docUrl) ?? string(value.docUrl),
+        describe: string(nested.describe) ?? string(value.describe),
         raw: body,
     };
 }
@@ -28,6 +31,9 @@ export class PraxisError extends Error {
     errors;
     requestId;
     param;
+    /** ticket-681 — the documented page and the exact section an agent should read to fix the call. */
+    docUrl;
+    describe;
     raw;
     constructor(problem = {}, options) {
         super(problem.message ?? problem.detail ?? problem.title ?? `Praxis request failed${problem.status ? ` (${problem.status})` : ''}`, options);
@@ -40,6 +46,8 @@ export class PraxisError extends Error {
         this.errors = problem.errors ?? [];
         this.requestId = problem.requestId;
         this.param = problem.param;
+        this.docUrl = problem.docUrl;
+        this.describe = problem.describe;
         this.raw = problem.raw;
     }
     static fromResponse(response, body) {