@deepraxis/sdk 0.1.1-dev.cc34a92 → 0.1.1-dev.d412c99

package/METHODS.md

@@ -1,6 +1,6 @@
 # SDK methods
 
-Generated by `bun run generate`. 521 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`. 567 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 |
@@ -786,6 +792,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 +805,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 +870,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 +978,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
 
@@ -967,6 +1062,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 
 ## media
 
+### media.generation.capabilities
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/media/v1/generation/capabilities` | no | no |
+
 ### media.libraries
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -989,6 +1090,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | retrieve | GET | `/media/v1/libraries/{library_id}/assets/{asset_id}` | no | no |
 | update | PATCH | `/media/v1/libraries/{library_id}/assets/{asset_id}` | no | no |
 
+### media.libraries.assets.frames
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/media/v1/libraries/{library_id}/assets/{asset_id}/frames` | no | no |
+
 ### media.libraries.assets.import
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -1032,12 +1139,26 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | list | GET | `/media/v1/libraries/{library_id}/folders` | no | no |
 
+### media.libraries.generations
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/media/v1/libraries/{library_id}/generations` | no | no |
+
 ### media.libraries.jobs
 
 | Method | HTTP | Path | Streaming | Pagination |
 |---|---|---|---|---|
+| cancel | POST | `/media/v1/libraries/{library_id}/jobs/{job_id}/cancel` | no | no |
+| list | GET | `/media/v1/libraries/{library_id}/jobs` | no | yes |
 | retrieve | GET | `/media/v1/libraries/{library_id}/jobs/{job_id}` | no | no |
 
+### media.libraries.jobs.outputs.save
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| create | POST | `/media/v1/libraries/{library_id}/jobs/{job_id}/outputs/{index}/save` | no | no |
+
 ### media.libraries.purge
 
 | Method | HTTP | Path | Streaming | Pagination |
@@ -1068,6 +1189,13 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 |---|---|---|---|---|
 | create | POST | `/media/v1/libraries/{library_id}/search/visual` | no | no |
 
+### media.libraries.understandings
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/media/v1/libraries/{library_id}/understandings` | no | yes |
+| retrieveFailureSummary | GET | `/media/v1/libraries/{library_id}/understandings/failure_summary` | no | no |
+
 ## meta
 
 ### meta.docs
@@ -1217,6 +1345,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
@@ -1259,6 +1438,12 @@ Multipart request bodies expand plain objects into bracketed fields (for example
 | create | POST | `/organization/v1/feedback/{id}/messages` | no | no |
 | list | GET | `/organization/v1/feedback/{id}/messages` | no | no |
 
+### organization.members
+
+| Method | HTTP | Path | Streaming | Pagination |
+|---|---|---|---|---|
+| list | GET | `/organization/v1/members` | no | no |
+
 ### organization.usage
 
 | Method | HTTP | Path | Streaming | Pagination |

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)
@@ -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) {