@deepraxis/cli 0.2.0-dev.a538fab → 0.2.0-dev.ea219e1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/COMMANDS.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Generated by `bun run commands`. DO NOT EDIT.
4
4
 
5
- 426 HTTP operations; 428 commands including aliases.
5
+ 428 HTTP operations; 430 commands including aliases.
6
6
 
7
7
  Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
8
8
 
@@ -299,6 +299,8 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
299
299
  | `praxis api media library search-semantic` | `media.libraries.search.semantic.create` | POST `/media/v1/libraries/{library_id}/search/semantic` | `--library`, `--query`, `--filter`, `--top-k`, `--mode` |
300
300
  | `praxis api media library search-visual` | `media.libraries.search.visual.create` | POST `/media/v1/libraries/{library_id}/search/visual` | `--library`, `--asset-id`, `--top-k`, `--filter` |
301
301
  | `praxis api media library update <library_id>` | `media.libraries.update` | PATCH `/media/v1/libraries/{library_id}` | `--name` |
302
+ | `praxis api meta doc get <path>` | `meta.docs.retrieve` | GET `/meta/v1/docs/{path}` | `--lang` |
303
+ | `praxis api meta doc search` | `meta.docs.search` | GET `/meta/v1/docs/search` | `--q`, `--param-limit`, `--lang` |
302
304
  | `praxis api meta health get` | `meta.health.retrieve` | GET `/meta/v1/health` | |
303
305
  | `praxis api meta method get <name>` | `meta.methods.retrieve` | GET `/meta/v1/methods/{name}` | |
304
306
  | `praxis api meta method list` | `meta.methods.list` | GET `/meta/v1/methods` | `--q`, `--param-limit`, `--after-id` |
package/dist/praxis.js CHANGED
@@ -11,7 +11,7 @@ var operations = [
11
11
  resource: "agent.agents",
12
12
  method: "list",
13
13
  summary: "List agents",
14
- description: "List the agents of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Use it to find an agent id before creating a session; to read one agent use agents.retrieve, to see its history use agents.versions.list. Archived agents are hidden unless include_archived is true. Filter kind=personal for durable-computer agents or kind=service for per-session environments. Pass next_page from the response as page to read the next page; a null next_page means the end.",
14
+ description: "List the agents of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Use it to find an agent id before creating a session; to read one agent use agents.retrieve, to see its history use agents.versions.list. Archived agents are hidden unless include_archived is true. Filter kind=general or kind=personal for durable-computer agents or kind=service for per-session environments. Pass next_page from the response as page to read the next page; a null next_page means the end.",
15
15
  http: "GET",
16
16
  path: "/agent/v1/agents",
17
17
  streaming: "no",
@@ -56,6 +56,7 @@ var operations = [
56
56
  name: "kind",
57
57
  type: "string",
58
58
  enum: [
59
+ "general",
59
60
  "personal",
60
61
  "service"
61
62
  ],
@@ -141,17 +142,18 @@ across all toolsets allowed.`
141
142
  type: "array",
142
143
  itemType: "object",
143
144
  required: false,
144
- description: "Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time."
145
+ description: "Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time."
145
146
  },
146
147
  {
147
148
  name: "kind",
148
149
  type: "string",
149
150
  enum: [
151
+ "general",
150
152
  "personal",
151
153
  "service"
152
154
  ],
153
155
  required: false,
154
- description: "Immutable agent kind. personal requires computer_id; service cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error."
156
+ description: "Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error."
155
157
  },
156
158
  {
157
159
  name: "computer_id",
@@ -201,7 +203,7 @@ across all toolsets allowed.`
201
203
  name: "avatar",
202
204
  type: "string",
203
205
  required: false,
204
- description: "Avatar image of the agent: an absolute https URL of at most 2048 characters, without credentials; any other value returns 400 avatar must be an https URL. It is the default picture in agent lists, the agent detail, the chat header and embedded chat when the embed appearance sets none. Saved with the agent version like other configuration, so apply=false keeps the previous avatar in effect until that version is applied. Omit on create for no avatar; on update, omit to keep it and send null to clear it. Both personal and service agents accept it. /agent/v1 only; /anthropic neither accepts nor returns it."
206
+ description: "Avatar image of the agent: an absolute https URL of at most 2048 characters, without credentials; any other value returns 400 avatar must be an https URL. It is the default picture in agent lists, the agent detail, the chat header and embedded chat when the embed appearance sets none. Saved with the agent version like other configuration, so apply=false keeps the previous avatar in effect until that version is applied. Omit on create for no avatar; on update, omit to keep it and send null to clear it. General, personal and service agents accept it. /agent/v1 only; /anthropic neither accepts nor returns it."
205
207
  },
206
208
  {
207
209
  name: "environment_id",
@@ -365,11 +367,12 @@ toolsets allowed.`
365
367
  name: "kind",
366
368
  type: "string",
367
369
  enum: [
370
+ "general",
368
371
  "personal",
369
372
  "service"
370
373
  ],
371
374
  required: false,
372
- description: "Immutable agent kind. personal requires computer_id; service cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error."
375
+ description: "Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error."
373
376
  },
374
377
  {
375
378
  name: "computer_id",
@@ -419,7 +422,7 @@ toolsets allowed.`
419
422
  name: "avatar",
420
423
  type: "string",
421
424
  required: false,
422
- description: "Avatar image of the agent: an absolute https URL of at most 2048 characters, without credentials; any other value returns 400 avatar must be an https URL. It is the default picture in agent lists, the agent detail, the chat header and embedded chat when the embed appearance sets none. Saved with the agent version like other configuration, so apply=false keeps the previous avatar in effect until that version is applied. Omit on create for no avatar; on update, omit to keep it and send null to clear it. Both personal and service agents accept it. /agent/v1 only; /anthropic neither accepts nor returns it."
425
+ description: "Avatar image of the agent: an absolute https URL of at most 2048 characters, without credentials; any other value returns 400 avatar must be an https URL. It is the default picture in agent lists, the agent detail, the chat header and embedded chat when the embed appearance sets none. Saved with the agent version like other configuration, so apply=false keeps the previous avatar in effect until that version is applied. Omit on create for no avatar; on update, omit to keep it and send null to clear it. General, personal and service agents accept it. /agent/v1 only; /anthropic neither accepts nor returns it."
423
426
  },
424
427
  {
425
428
  name: "environment_id",
@@ -958,7 +961,7 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
958
961
  resource: "agent.computers",
959
962
  method: "create",
960
963
  summary: "Create Computer",
961
- description: `Create a durable computer: a named machine whose files outlive sessions, for personal agents.
964
+ description: `Create a durable computer: a named machine whose files outlive sessions, for general and personal agents.
962
965
 
963
966
  Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.`,
964
967
  http: "POST",
@@ -1409,7 +1412,7 @@ archived).`
1409
1412
  resource: "agent.deployments",
1410
1413
  method: "create",
1411
1414
  summary: "Create deployment",
1412
- description: "Freeze session parameters as a deployment; this operation does not open a session. Pass an agent id or versioned reference, a name, 1–50 user.message initial events and an environment_id from environments.list. Unlike Anthropic Managed Agents, /agent/v1 also accepts agent_with_overrides (model, permission_mode and cwd) and target=computer for personal agents, with environment_id omitted. Cron schedules use five POSIX fields and an IANA timezone. File resources are accepted. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Active schedules run every minute when due; session creation errors pause the deployment. Unsupported tools, mcp_servers, system and skills overrides return 400.",
1415
+ description: "Freeze session parameters as a deployment; this operation does not open a session. Pass an agent id or versioned reference, a name, 1–50 user.message initial events and an environment_id from environments.list. Unlike Anthropic Managed Agents, /agent/v1 also accepts agent_with_overrides (model, permission_mode and cwd) and target=computer for general and personal agents, with environment_id omitted. Cron schedules use five POSIX fields and an IANA timezone. File resources are accepted. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Active schedules run every minute when due; session creation errors pause the deployment. Unsupported tools, mcp_servers, system and skills overrides return 400.",
1413
1416
  http: "POST",
1414
1417
  path: "/agent/v1/deployments",
1415
1418
  streaming: "no",
@@ -1490,7 +1493,7 @@ created from this deployment. Maximum 50.`
1490
1493
  name: "target",
1491
1494
  type: "object",
1492
1495
  required: false,
1493
- description: "Execution target. environment (default) requires an existing, unarchived environment_id. computer is available only for personal agents and permits environment_id to be omitted."
1496
+ description: "Execution target. environment (default) requires an existing, unarchived environment_id. computer is available only for general and personal agents and permits environment_id to be omitted."
1494
1497
  }
1495
1498
  ]
1496
1499
  }
@@ -1607,7 +1610,7 @@ null to clear. Maximum 50.`
1607
1610
  name: "target",
1608
1611
  type: "object",
1609
1612
  required: false,
1610
- description: "Execution target. environment (default) requires an existing, unarchived environment_id. computer is available only for personal agents and permits environment_id to be omitted."
1613
+ description: "Execution target. environment (default) requires an existing, unarchived environment_id. computer is available only for general and personal agents and permits environment_id to be omitted."
1611
1614
  }
1612
1615
  ]
1613
1616
  }
@@ -2277,7 +2280,7 @@ Own-face extension. No request body is required. Uses the same stop implementati
2277
2280
  summary: "Compact Session (Extension)",
2278
2281
  description: `Request session context compaction and retrieve an operation receipt.
2279
2282
 
2280
- Available only on /agent/v1. The body may be omitted or {}. Optional instructions must be a string and is forwarded unchanged. Idempotency-Key is forwarded unchanged; a UUID is generated when absent. Returns { type: session_compaction, id, status, reason? }, where id is the operation ID. queued/running return 202; skipped/succeeded/failed return 200. Non-string instructions return 400 invalid_request_error. Missing or inaccessible managed sessions return 404 not_found_error.`,
2283
+ Available only on /agent/v1. The body may be omitted or {}. Optional instructions must be a string and is forwarded unchanged. Idempotency-Key is forwarded unchanged; a UUID is generated when absent. Returns { type: session_compaction, id, status, reason? }, where id is the operation ID. queued/running return 202; skipped/succeeded/failed/cancelled return 200. Non-string instructions return 400 invalid_request_error. Missing or inaccessible managed sessions return 404 not_found_error.`,
2281
2284
  http: "POST",
2282
2285
  path: "/agent/v1/sessions/{session_id}/compact",
2283
2286
  streaming: "no",
@@ -2333,7 +2336,7 @@ Available only on /agent/v1. Returns { type: session_compaction, id, status, rea
2333
2336
  summary: "List Session Compactions (Extension)",
2334
2337
  description: `Read session compaction history and summaries.
2335
2338
 
2336
- Available only on /agent/v1. Returns { data: [...] }. Each entry contains type, id, event_id, trigger, status, model, compacted_message_count, input_tokens_before, input_tokens_after, summary, error and created_at, as recorded by the service. Missing or inaccessible managed sessions return 404 not_found_error.`,
2339
+ Available only on /agent/v1. Returns { data: [...], active }. active is the queued or running compaction ({ type: session_compaction, id, status, trigger: manual|auto|idle }), or null when none; manual work takes precedence. Each data entry contains type, id, event_id, trigger, status, model, compacted_message_count, input_tokens_before, input_tokens_after, summary, error and created_at, as recorded by the service. Missing or inaccessible managed sessions return 404 not_found_error.`,
2337
2340
  http: "GET",
2338
2341
  path: "/agent/v1/sessions/{session_id}/compactions",
2339
2342
  streaming: "no",
@@ -6303,7 +6306,7 @@ file at the root of that directory.`
6303
6306
  resource: "automation.validate",
6304
6307
  method: "create",
6305
6308
  summary: "Validate a definition",
6306
- description: "Check source without executing it when you need diagnostics, inferred schemas or references. This is optional before praxis.automation.runs.create, which also validates source before execution. Actions, scripts and workflows are supported; results include validity without saving. Invalid source is reported with valid=false. Script/action output schemas are inferred from return types: Promise unwrapping, Record, intersections and Date. Unknown types yield an empty schema and a warning in warnings. Source diagnostics use /source or /implementation/source with 1-based line/column. For kind=action the same admission checks as action creation apply (no external imports, platform operations only as direct call(praxis/<api>.<op>, input) calls, no agent or automation calls), so source that validates is not rejected at creation. For kind=workflow the YAML needs document (dsl, namespace, name, version) and do; each problem is one entry in errors[] (pointer, detail, hint), so read the first one. A listen outside the supported subset (to.all, inside a fork) and emit are not reported here and fail with DEFINITION_INVALID only when a run is created.",
6309
+ description: "Check source without executing it when you need diagnostics, inferred schemas or references. This is optional before praxis.automation.runs.create, which also validates source before execution. Actions, scripts and workflows are supported; results include validity without saving. Invalid source is reported with valid=false. Script/action output schemas are inferred from return types: Promise unwrapping, Record, intersections and Date. Unknown types yield an empty schema and a warning in warnings. Source diagnostics use /source or /implementation/source with 1-based line/column. For kind=action the same admission checks as action creation apply (no external imports, platform operations only as direct call(praxis/<api>.<op>, input) calls, no agent or automation calls), so source that validates is not rejected at creation. For kind=workflow the YAML needs document (dsl, namespace, name, version) and do; each problem is one entry in errors[] (pointer, detail, hint), so read the first one. A listen outside the supported subset (to.all, inside a fork) and emit are not reported here and fail with DEFINITION_INVALID only when a run is created. Workflow syntax reference: https://deepraxis.com/docs/developers/automation/reference/workflow-syntax.",
6307
6310
  http: "POST",
6308
6311
  path: "/automation/v1/validate",
6309
6312
  streaming: "no",
@@ -6410,7 +6413,7 @@ file at the root of that directory.`
6410
6413
  resource: "automation.workflows",
6411
6414
  method: "create",
6412
6415
  summary: "Create a workflow",
6413
- description: 'Save a YAML workflow as an editable draft; this does not validate, publish or run it, so check it with validate (kind=workflow) first. Minimal draft: document with dsl ("1.0.3"), namespace, name and version, plus a do list of steps, for example document: {dsl: "1.0.3", namespace: demo, name: add, version: "1.0.0"} and do: [{first: {call: demo/add-one, with: {n: "${ .n }"}}}]. call: <ns/name> calls an Action directly (bare name for built-ins such as ocr) and with is the Action input; the input contract is at current_revision.input_schema in the get-action response. run: starts a saved script or child workflow. The run input is . in the first step, and expressions are jq written as a whole ${ ... } string. Limits: Action 30 s (run-sandbox 10 min), workflow 24 h by default and 30 days at most, payload 1 MiB. Test the draft by sending its source and language=yaml to praxis.automation.runs.create. Guide: /docs/developers/automation/guides/write-workflow. Error details are in the errors[] of the response (pointer, detail, hint). Choose your own namespace without registering it first; praxis is reserved for built-in Actions. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. run.workflow accepts ns/name@range or {namespace, name, version, input}; run.script uses the same reference shape as a platform extension. Object namespace, name and version are required; version accepts an exact version, dist-tag or range, locked at publication. Object input defaults to {} and supports expressions; string references retain task-level with. run.await defaults to true and returns the child output. With false, the child uses detach and the task immediately returns {run_id}; parent cancellation does not cascade. Inline script.code returns DEFINITION_INVALID with a detail asking you to save a script and reference it first. raise.error retains its type URI, status, title and detail in the run error.',
6416
+ description: 'Workflow syntax reference: https://deepraxis.com/docs/developers/automation/reference/workflow-syntax. Save a YAML workflow as an editable draft; this does not validate, publish or run it, so check it with validate (kind=workflow) first. Minimal draft: document with dsl ("1.0.3"), namespace, name and version, plus a do list of steps, for example document: {dsl: "1.0.3", namespace: demo, name: add, version: "1.0.0"} and do: [{first: {call: demo/add-one, with: {n: "${ .n }"}}}]. call: <ns/name> calls an Action directly (bare name for built-ins such as ocr) and with is the Action input; the input contract is at current_revision.input_schema in the get-action response. run: starts a saved script or child workflow. The run input is . in the first step, and expressions are jq written as a whole ${ ... } string. Limits: Action 30 s (run-sandbox 10 min), workflow 24 h by default and 30 days at most, payload 1 MiB. Test the draft by sending its source and language=yaml to praxis.automation.runs.create. Guide: /docs/developers/automation/guides/write-workflow. Error details are in the errors[] of the response (pointer, detail, hint). Choose your own namespace without registering it first; praxis is reserved for built-in Actions. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. run.workflow accepts ns/name@range or {namespace, name, version, input}; run.script uses the same reference shape as a platform extension. Object namespace, name and version are required; version accepts an exact version, dist-tag or range, locked at publication. Object input defaults to {} and supports expressions; string references retain task-level with. run.await defaults to true and returns the child output. With false, the child uses detach and the task immediately returns {run_id}; parent cancellation does not cascade. Inline script.code returns DEFINITION_INVALID with a detail asking you to save a script and reference it first. raise.error retains its type URI, status, title and detail in the run error.',
6414
6417
  http: "POST",
6415
6418
  path: "/automation/v1/workflows",
6416
6419
  streaming: "no",
@@ -6480,7 +6483,7 @@ file at the root of that directory.`
6480
6483
  resource: "automation.workflows",
6481
6484
  method: "update",
6482
6485
  summary: "Update a workflow draft",
6483
- description: "Update description, labels or draft with the current draft revision in If-Match, taken from draft.revision in the get-workflow response. Even metadata-only updates create a new draft revision. A mismatch returns 412 PRECONDITION_FAILED; read the draft again, merge and retry. The draft is not validated here, so check it with validate (kind=workflow) before publishing. Error details are in errors[].",
6486
+ description: "Update description, labels or draft with the current draft revision in If-Match, taken from draft.revision in the get-workflow response. Even metadata-only updates create a new draft revision. A mismatch returns 412 PRECONDITION_FAILED; read the draft again, merge and retry. The draft is not validated here, so check it with validate (kind=workflow) before publishing. Error details are in errors[]. See the workflow syntax reference at https://deepraxis.com/docs/developers/automation/reference/workflow-syntax.",
6484
6487
  http: "PATCH",
6485
6488
  path: "/automation/v1/workflows/{ns}/{name}",
6486
6489
  streaming: "no",
@@ -10491,6 +10494,70 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
10491
10494
  ]
10492
10495
  }
10493
10496
  },
10497
+ {
10498
+ resource: "meta.docs",
10499
+ method: "search",
10500
+ summary: "Search platform documentation",
10501
+ description: "Find guides and references by keyword before reading them with praxis.meta.docs.retrieve. Public; no API key required. Matches documentation titles, headings and page text without case sensitivity; all query words must occur. q is required; limit defaults to 20 and accepts 1–50. lang defaults to zh or use en for English. Returns paths, page titles, canonical URLs and short matching snippets; no matches returns an empty array.",
10502
+ http: "GET",
10503
+ path: "/meta/v1/docs/search",
10504
+ streaming: "no",
10505
+ pagination: false,
10506
+ pathParams: [],
10507
+ query: [
10508
+ {
10509
+ name: "q",
10510
+ type: "string",
10511
+ required: true,
10512
+ description: "Keywords describing the syntax or guide needed, for example export or workflow."
10513
+ },
10514
+ {
10515
+ name: "limit",
10516
+ type: "integer",
10517
+ required: false,
10518
+ description: "Maximum number of matching pages returned; integer 1–50, default 20."
10519
+ },
10520
+ {
10521
+ name: "lang",
10522
+ type: "string",
10523
+ enum: [
10524
+ "zh",
10525
+ "en"
10526
+ ],
10527
+ required: false,
10528
+ description: "Documentation language: zh for Chinese (default), en for English."
10529
+ }
10530
+ ]
10531
+ },
10532
+ {
10533
+ resource: "meta.docs",
10534
+ method: "retrieve",
10535
+ summary: "Read documentation Markdown",
10536
+ description: "Read a platform guide or reference before implementing an unfamiliar capability. Public; no API key required. Take path from praxis.meta.docs.search, or use developers/automation/guides/write-workflow. Append #heading-id to path to read only that section, including its subsections. Encode the hash as %23 over HTTP; SDK callers pass it in the path string. lang defaults to zh; en selects the English page. Unknown pages or anchors return DOC_NOT_FOUND; search again for a valid path.",
10537
+ http: "GET",
10538
+ path: "/meta/v1/docs/{path}",
10539
+ streaming: "no",
10540
+ pagination: false,
10541
+ pathParams: [
10542
+ {
10543
+ name: "path",
10544
+ sdkName: "path",
10545
+ description: "Slash-separated documentation path from docs.search; optionally append #heading-id to select a section."
10546
+ }
10547
+ ],
10548
+ query: [
10549
+ {
10550
+ name: "lang",
10551
+ type: "string",
10552
+ enum: [
10553
+ "zh",
10554
+ "en"
10555
+ ],
10556
+ required: false,
10557
+ description: "Documentation language: zh for Chinese (default), en for English."
10558
+ }
10559
+ ]
10560
+ },
10494
10561
  {
10495
10562
  resource: "meta.health",
10496
10563
  method: "retrieve",
@@ -19094,6 +19161,8 @@ var fileCancelUpload = (options) => (options.client ?? client).post({
19094
19161
  var healthCheck = (options) => (options?.client ?? client).get({ url: "/meta/v1/health", ...options });
19095
19162
  var metaMethodsSearch = (options) => (options?.client ?? client).get({ url: "/meta/v1/methods", ...options });
19096
19163
  var metaMethodsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/methods/{name}", ...options });
19164
+ var metaDocsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/{path}", ...options });
19165
+ var metaDocsSearch = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/search", ...options });
19097
19166
  var listModels = (options) => (options?.client ?? client).get({
19098
19167
  querySerializer: { parameters: {
19099
19168
  supported_api: { array: { explode: false } },
@@ -24715,6 +24784,10 @@ function createMedia(transport) {
24715
24784
  }
24716
24785
  function createMeta(transport) {
24717
24786
  return {
24787
+ docs: {
24788
+ retrieve: bind(transport, metaDocsRetrieve),
24789
+ search: bind(transport, metaDocsSearch)
24790
+ },
24718
24791
  health: {
24719
24792
  retrieve: bind(transport, healthCheck)
24720
24793
  },
@@ -25206,7 +25279,7 @@ function assertKnownOptions(options) {
25206
25279
  class Transport {
25207
25280
  config;
25208
25281
  constructor(options) {
25209
- this.config = { timeoutMs: 60000, maxRetries: 2, fetch: globalThis.fetch, ...options };
25282
+ this.config = { timeoutMs: 600000, maxRetries: 2, fetch: globalThis.fetch, ...options };
25210
25283
  this.validate(this.config.timeoutMs, this.config.maxRetries);
25211
25284
  }
25212
25285
  validate(timeout, retries) {
@@ -27952,7 +28025,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
27952
28025
  }
27953
28026
 
27954
28027
  // src/main.ts
27955
- var version = "0.2.0-dev.a538fab";
28028
+ var version = "0.2.0-dev.ea219e1";
27956
28029
  var commands = commandTree(operations);
27957
28030
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
27958
28031
  function route(argv) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/cli",
3
- "version": "0.2.0-dev.a538fab",
3
+ "version": "0.2.0-dev.ea219e1",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "praxis": "dist/praxis.js"