@deepraxis/cli 0.2.1-dev.077ed16 → 0.2.1-dev.22816e2

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.
Files changed (3) hide show
  1. package/COMMANDS.md +11 -1
  2. package/dist/praxis.js +920 -139
  3. package/package.json +1 -1
package/dist/praxis.js CHANGED
@@ -193,7 +193,7 @@ across all toolsets allowed.`
193
193
  name: "settings",
194
194
  type: "object",
195
195
  required: false,
196
- description: "Praxis extension: managed settings saved with the configuration revision. Omit to preserve; null clears. Configuration storage only; these switches and hooks are not applied to runtime yet. /agent/v1 only."
196
+ description: "Agent runtime settings follow Claude Code managed settings. Praxis freezes output-style selection for each new session; inline output_styles extend file-based styles. Omit settings to keep saved settings; null clears them."
197
197
  },
198
198
  {
199
199
  name: "models",
@@ -230,6 +230,13 @@ across all toolsets allowed.`
230
230
  ],
231
231
  required: false,
232
232
  description: "Optional tool preset. minimal enables read, glob, grep and ask_user_question; data-editor also enables write and edit; full uses the default toolset with always_allow. Explicit tools override matching preset entries. codemode requires bash and is absent from data-editor."
233
+ },
234
+ {
235
+ name: "output_styles",
236
+ type: "array",
237
+ itemType: "object",
238
+ required: false,
239
+ description: "Inline custom output styles, including for agents without a computer. Omit to keep the saved list; null or [] clears it. Same-name precedence is inline, project files, personal files, then plugins. Selection is settings.outputStyle; styles apply to main conversations and are frozen per session."
233
240
  }
234
241
  ]
235
242
  }
@@ -413,7 +420,7 @@ toolsets allowed.`
413
420
  name: "settings",
414
421
  type: "object",
415
422
  required: false,
416
- description: "Praxis extension: managed settings saved with the configuration revision. Omit to preserve; null clears. Configuration storage only; these switches and hooks are not applied to runtime yet. /agent/v1 only."
423
+ description: "Agent runtime settings follow Claude Code managed settings. Praxis freezes output-style selection for each new session; inline output_styles extend file-based styles. Omit settings to keep saved settings; null clears them."
417
424
  },
418
425
  {
419
426
  name: "models",
@@ -450,6 +457,13 @@ toolsets allowed.`
450
457
  ],
451
458
  required: false,
452
459
  description: "Optional tool preset. minimal enables read, glob, grep and ask_user_question; data-editor also enables write and edit; full uses the default toolset with always_allow. Explicit tools override matching preset entries. codemode requires bash and is absent from data-editor."
460
+ },
461
+ {
462
+ name: "output_styles",
463
+ type: "array",
464
+ itemType: "object",
465
+ required: false,
466
+ description: "Inline custom output styles, including for agents without a computer. Omit to keep the saved list; null or [] clears it. Same-name precedence is inline, project files, personal files, then plugins. Selection is settings.outputStyle; styles apply to main conversations and are frozen per session."
453
467
  }
454
468
  ]
455
469
  }
@@ -4080,7 +4094,7 @@ file at the root of that directory.`
4080
4094
  name: "timeout_ms",
4081
4095
  type: "number",
4082
4096
  required: false,
4083
- description: "Positive integer milliseconds; code defaults to and is capped at 30,000. container/shell are not yet available."
4097
+ description: "Positive integer milliseconds; code defaults to and is capped at 300,000. container/shell are not yet available."
4084
4098
  },
4085
4099
  {
4086
4100
  name: "implementation",
@@ -4130,7 +4144,7 @@ file at the root of that directory.`
4130
4144
  resource: "automation.actions",
4131
4145
  method: "update",
4132
4146
  summary: "Update an action",
4133
- description: "Update after checking compatibility against the current and five recent revisions. Widening inputs and narrowing outputs are compatible, including length, item count, property count, type (integer/number), and multipleOf (the new input factor divides the old one; the reverse holds for outputs). dry_run=true returns only CompatResult and may omit If-Match; a supplied header is still checked, and * matches any existing representation. Normal updates require If-Match and return ActionDef with ETag; previews return no ETag. Omitted optional fields retain their existing values only for description and labels; when constructing a new revision, errors defaults to [], omitted annotations keys to false, timeout_ms to 30000, and message to null. Incompatible normal updates return 422 SCHEMA_INCOMPATIBLE with issues; unchanged contents retain the existing revision.",
4147
+ description: "Update after checking compatibility against the current and five recent revisions. Widening inputs and narrowing outputs are compatible, including length, item count, property count, type (integer/number), and multipleOf (the new input factor divides the old one; the reverse holds for outputs). dry_run=true returns only CompatResult and may omit If-Match; a supplied header is still checked, and * matches any existing representation. Normal updates require If-Match and return ActionDef with ETag; previews return no ETag. Omitted optional fields retain their existing values only for description and labels; when constructing a new revision, errors defaults to [], omitted annotations keys to false, timeout_ms to 300000, and message to null. Incompatible normal updates return 422 SCHEMA_INCOMPATIBLE with issues; unchanged contents retain the existing revision.",
4134
4148
  http: "PUT",
4135
4149
  path: "/automation/v1/actions/{ns}/{name}",
4136
4150
  streaming: "no",
@@ -4199,7 +4213,7 @@ file at the root of that directory.`
4199
4213
  name: "timeout_ms",
4200
4214
  type: "number",
4201
4215
  required: false,
4202
- description: "Positive integer milliseconds; code defaults to and is capped at 30,000. container/shell are not yet available."
4216
+ description: "Positive integer milliseconds; code defaults to and is capped at 300,000. container/shell are not yet available."
4203
4217
  },
4204
4218
  {
4205
4219
  name: "implementation",
@@ -4874,7 +4888,7 @@ file at the root of that directory.`
4874
4888
  resource: "automation.runs",
4875
4889
  method: "create",
4876
4890
  summary: "Run a published target or execute draft source",
4877
- description: 'Execute a published script or workflow with target, or test unpublished code directly with source and language (ts for TypeScript, yaml for workflow YAML), without first saving or publishing a definition. Minimal script: `export default async ({ file_id }: { file_id: string }) => { const result = await call("ocr", { document: { type: "file", file_id } }); return result; }`; send it as source with language="ts", input={"file_id":"<uploaded file ID>"} and wait=0, using a PDF or image already uploaded to your account. To call a platform API directly in the same script, use the praxis SDK object, for example `praxis.model.ocr.create({ body: { model: "glm-ocr", document: { type: "file", file_id } } })`; Action IDs are strings passed to call(), not SDK methods such as praxis.ocr(...). praxis, call, invoke, console and codemode are module-scope bindings, not on globalThis, and need no import; invoke("namespace/name", input) starts a child run. target and source are mutually exclusive; target accepts ns/name@version, @tag or @range and defaults to latest when @ is omitted. Source/input validation precedes run creation, so a separate validate call is optional. input defaults to {} and must match the input schema and fit within 1 MiB. wait is 0–60 seconds (default 0): a terminal run returns 200, otherwise 202. Use the returned id with praxis.automation.runs.retrieve and inspect status, output and error; acceptance does not mean successful completion. For long-running, background or batch work, use wait: 0 and poll the run, or split work into child runs or a workflow; wait only controls the response wait and does not extend execution limits. Actions time out after 30 s (run-sandbox after 10 min); scripts have a 5 min wall-clock limit and a 30 s CPU limit; workflows default to 24 h and allow up to 30 days. Each run can start at most 100 child runs, with at most 20 active at once; nesting depth is limited to 10. Idempotency-Key is scoped to tenant, method and path for 24 hours, excluding wait from the fingerprint; replay returns the current run with Idempotent-Replayed: true, changed contents return 422 and an in-flight request returns 409. With language=yaml, source is a workflow YAML: the run input is . in the first step, and the shape is described in create workflow. Error details are in errors[] (pointer, detail, hint). New non-deterministic run IDs contain 78 characters, compared with 46 for legacy random IDs; treat IDs as opaque strings. Historical and deterministic IDs remain valid; same-millisecond order is not guaranteed.',
4891
+ description: 'Execute a published script or workflow with target, or test unpublished code directly with source and language (ts for TypeScript, yaml for workflow YAML), without first saving or publishing a definition. Minimal script: `export default async ({ file_id }: { file_id: string }) => { const result = await call("ocr", { document: { type: "file", file_id } }); return result; }`; send it as source with language="ts", input={"file_id":"<uploaded file ID>"} and wait=0, using a PDF or image already uploaded to your account. To call a platform API directly in the same script, use the praxis SDK object, for example `praxis.model.ocr.create({ body: { model: "glm-ocr", document: { type: "file", file_id } } })`; Action IDs are strings passed to call(), not SDK methods such as praxis.ocr(...). praxis, call, invoke, console and codemode are module-scope bindings, not on globalThis, and need no import; invoke("namespace/name", input) starts a child run. target and source are mutually exclusive; target accepts ns/name@version, @tag or @range and defaults to latest when @ is omitted. Source/input validation precedes run creation, so a separate validate call is optional. input defaults to {} and must match the input schema and fit within 1 MiB. wait is 0–60 seconds (default 0): a terminal run returns 200, otherwise 202. Use the returned id with praxis.automation.runs.retrieve and inspect status, output and error; acceptance does not mean successful completion. For long-running, background or batch work, use wait: 0 and poll the run, or split work into child runs or a workflow; wait only controls the response wait and does not extend execution limits. Actions time out after 5 min (run-sandbox after 6 h); scripts have a 30 min wall-clock limit and a 30 s CPU limit; workflows default to 24 h and allow up to 30 days. Each run can start at most 1,000 child runs, with at most 100 active at once; nesting depth is limited to 10. Idempotency-Key is scoped to tenant, method and path for 24 hours, excluding wait from the fingerprint; replay returns the current run with Idempotent-Replayed: true, changed contents return 422 and an in-flight request returns 409. With language=yaml, source is a workflow YAML: the run input is . in the first step, and the shape is described in create workflow. Error details are in errors[] (pointer, detail, hint). New non-deterministic run IDs contain 78 characters, compared with 46 for legacy random IDs; treat IDs as opaque strings. Historical and deterministic IDs remain valid; same-millisecond order is not guaranteed.',
4878
4892
  http: "POST",
4879
4893
  path: "/automation/v1/runs",
4880
4894
  streaming: "no",
@@ -6512,7 +6526,7 @@ file at the root of that directory.`
6512
6526
  resource: "automation.workflows",
6513
6527
  method: "create",
6514
6528
  summary: "Create a workflow",
6515
- 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. To pause for a person, call praxis/approval (it opens a human task; the step output is the decision); agents answer with praxis.automation.humanTasks.respond on behalf of their user. Guide: /docs/developers/automation/guides/approvals 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.',
6529
+ 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 5 min (run-sandbox 6 h), 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. To pause for a person, call praxis/approval (it opens a human task; the step output is the decision); agents answer with praxis.automation.humanTasks.respond on behalf of their user. Guide: /docs/developers/automation/guides/approvals 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.',
6516
6530
  http: "POST",
6517
6531
  path: "/automation/v1/workflows",
6518
6532
  streaming: "no",
@@ -9834,7 +9848,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
9834
9848
  resource: "file.files.contentLinks",
9835
9849
  method: "revoke",
9836
9850
  summary: "Revoke a file content link",
9837
- description: 'Stop a previously issued content link from reading a file. Use file_id from file creation or listing and the token path component from a content URL (/c/<token>), not the complete URL. The caller must own the file and have write access; a read-only binding is refused. Revocation propagates through the capability deny list within 30 seconds; the file and other links remain available. Only current IAM capability tokens can be revoked; legacy content links expire at the migration deadline. Example body: {"token":"<token from /c/>"}.',
9851
+ description: 'Stop a previously issued content link from reading a file. Obtain the link with files.contentUrl.create. Use file_id from file creation or listing and the token path component from a content URL (/c/<token>), not the complete URL. The caller must own the file and have write access; a read-only binding is refused. Revocation propagates through the capability deny list within 30 seconds; the file and other links remain available. Only current IAM capability tokens can be revoked; legacy content links expire at the migration deadline. Example body: {"token":"<token from /c/>"}.',
9838
9852
  http: "POST",
9839
9853
  path: "/file/v1/files/{file_id}/content_links:revoke",
9840
9854
  streaming: "no",
@@ -9859,6 +9873,35 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
9859
9873
  ]
9860
9874
  }
9861
9875
  },
9876
+ {
9877
+ resource: "file.files.contentUrl",
9878
+ method: "create",
9879
+ summary: "Create a download URL",
9880
+ description: `Download a file's bytes to a local disk from a coding agent without sending them through the model. Use file_id from file creation or listing, then run curl -fsSL -o <filename> '<url>' locally with the returned URL; GET needs no Authorization header. The link is reusable until expiry and supports a single byte Range (for example Range: bytes=0-9 returns 206). Revoke it with files.contentLinks.revoke, passing the token after /c/ in the URL. Expired, revoked, invalid or cross-organization URLs return 404. Lifetime defaults to 3600 seconds and is at most 604800 seconds. Issuance requires the same credential and file-read access as files.retrieveContent; a processing file returns 409 FILE_NOT_READY, so poll files.retrieve until active before retrying. A missing, expired or other-organization file returns 404. Each issuance creates a new link. OpenAI Files has no signed download URL; this follows S3 presigned GET semantics. Example body: {"ttl_seconds":3600}.`,
9881
+ http: "POST",
9882
+ path: "/file/v1/files/{file_id}/content_url",
9883
+ streaming: "no",
9884
+ pagination: false,
9885
+ pathParams: [
9886
+ {
9887
+ name: "file_id",
9888
+ sdkName: "file_id",
9889
+ description: "Tenant-owned live file identifier from file creation or listing; the file must be active to issue a download URL."
9890
+ }
9891
+ ],
9892
+ query: [],
9893
+ body: {
9894
+ required: false,
9895
+ fields: [
9896
+ {
9897
+ name: "ttl_seconds",
9898
+ type: "integer",
9899
+ required: false,
9900
+ description: "Download link lifetime in seconds, from 1 through 604800; omitted means 3600. This does not change the file's own expiry."
9901
+ }
9902
+ ]
9903
+ }
9904
+ },
9862
9905
  {
9863
9906
  resource: "file.uploads",
9864
9907
  method: "create",
@@ -10119,7 +10162,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
10119
10162
  resource: "knowledge.vectorStores",
10120
10163
  method: "create",
10121
10164
  summary: "Create knowledge base",
10122
- description: 'Create a knowledge base, optionally starting ingestion of uploaded file_ids in the same call; no separate attachment or batch is needed for those files. Use the returned id with vectorStores.files.retrieve to poll each attachment until completed, failed or cancelled; store status=completed alone does not mean every file succeeded. Unlike OpenAI vector stores, each file is limited to 100000000 bytes and each account to 100 active/nondeleted stores. Minimal body: {"name":"Refund policies"}.',
10165
+ description: 'Create a knowledge base, optionally starting ingestion of uploaded file_ids in the same call; no separate attachment or batch is needed for those files. Use the returned id with vectorStores.files.retrieve to poll each attachment until completed, failed or cancelled; store status=completed alone does not mean every file succeeded. Each file accepts up to 52428800 bytes and 5000000 estimated tokens; each account holds up to 100 active/nondeleted stores. Minimal body: {"name":"Refund policies"}.',
10123
10166
  http: "POST",
10124
10167
  path: "/knowledge/v1/vector_stores",
10125
10168
  streaming: "no",
@@ -10170,7 +10213,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
10170
10213
  name: "models",
10171
10214
  type: "object",
10172
10215
  required: false,
10173
- description: "Model roles to set. The model must exist in the model catalog and serve the role (embedding → openai.embeddings, rerank → cohere.rerank, query_rewrite → openai.chat.completions). The embedding model must output 1024-dimension vectors. Omitted roles stay unchanged; null restores all defaults. Unknown roles or empty IDs return 400 INVALID_PARAMS. The OpenAI-compatible API rejects this field with 400."
10216
+ description: "Model roles to set. The model must exist in the model catalog and serve the role (embedding → openai.embeddings, rerank → cohere.rerank, query_rewrite → openai.chat.completions, ocr → mistral.ocr or pdf_input capability, vision → vision capability). The embedding model must output 1024-dimension vectors. Omitted roles stay unchanged; null restores all defaults. Unknown roles or empty IDs return 400 INVALID_PARAMS. The OpenAI-compatible API rejects this field with 400."
10174
10217
  }
10175
10218
  ]
10176
10219
  }
@@ -10274,7 +10317,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
10274
10317
  name: "models",
10275
10318
  type: "object",
10276
10319
  required: false,
10277
- description: "Model roles to set. The model must exist in the model catalog and serve the role (embedding → openai.embeddings, rerank → cohere.rerank, query_rewrite → openai.chat.completions). The embedding model must output 1024-dimension vectors. Omitted roles stay unchanged; null restores all defaults. Unknown roles or empty IDs return 400 INVALID_PARAMS. The OpenAI-compatible API rejects this field with 400."
10320
+ description: "Model roles to set. The model must exist in the model catalog and serve the role (embedding → openai.embeddings, rerank → cohere.rerank, query_rewrite → openai.chat.completions, ocr → mistral.ocr or pdf_input capability, vision → vision capability). The embedding model must output 1024-dimension vectors. Omitted roles stay unchanged; null restores all defaults. Unknown roles or empty IDs return 400 INVALID_PARAMS. The OpenAI-compatible API rejects this field with 400."
10278
10321
  }
10279
10322
  ]
10280
10323
  }
@@ -10505,7 +10548,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
10505
10548
  resource: "knowledge.vectorStores.files",
10506
10549
  method: "create",
10507
10550
  summary: "Add file",
10508
- description: "Attach an uploaded File for asynchronous ingestion, then poll this attachment until status is completed, failed or cancelled before searching. Unlike OpenAI vector stores, the file limit is 100000000 bytes; chunk sizes use estimated tokens rather than a model tokenizer. Text, Markdown, CSV, JSON, HTML, PDF, DOCX, PPTX, XLSX and PNG/JPEG/GIF/WebP images can be extracted; audio and video uploads are not knowledge documents. Images may yield generated descriptions rather than verbatim OCR. auto chunking resolves to static 800/400; explicit sizes are 100–4096 with overlap at most half the size. Each store holds at most 10000 attached files. Reattaching the same file returns its existing record without applying new attributes or chunking; inspect last_error after failure.",
10551
+ description: "Attach an uploaded File for asynchronous ingestion, then poll this attachment until status is completed, failed or cancelled before searching. Each file accepts up to 52428800 bytes and 5000000 estimated tokens; chunk sizes use estimated tokens rather than a model tokenizer. Text, Markdown, CSV, JSON, HTML, PDF, DOCX, PPTX, XLSX and PNG/JPEG/GIF/WebP images can be extracted; audio and video uploads are not knowledge documents. Images may yield generated descriptions rather than verbatim OCR. auto chunking resolves to static 800/400; explicit sizes are 100–4096 with overlap at most half the size. Each store holds at most 10000 attached files. Reattaching the same file returns its existing record without applying new attributes or chunking; inspect last_error after failure.",
10509
10552
  http: "POST",
10510
10553
  path: "/knowledge/v1/vector_stores/{vector_store_id}/files",
10511
10554
  streaming: "no",
@@ -15769,7 +15812,7 @@ for more details.`
15769
15812
  resource: "sandbox.templates",
15770
15813
  method: "list",
15771
15814
  summary: "List templates (v2)",
15772
- description: "List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.",
15815
+ description: "List official templates and all your custom templates, including waiting, building, ready and error builds. Custom templates appear first; each custom row describes its latest build, not necessarily the current ready build. Use templateID for build management and a ready template name when creating a sandbox. Own-face official distinguishes public catalog entries; sourceKind is omitted until a source is submitted and on official templates. Other organizations' templates are invisible.",
15773
15816
  http: "GET",
15774
15817
  path: "/sandbox/v1/templates",
15775
15818
  streaming: "no",
@@ -15780,7 +15823,7 @@ for more details.`
15780
15823
  name: "teamID",
15781
15824
  type: "string",
15782
15825
  required: false,
15783
- description: "Id of the team whose templates to list. Omit it to list the templates of your own team; a team you do not belong to answers 403."
15826
+ description: "Upstream team selector; Praxis always lists the authenticated organization's templates."
15784
15827
  },
15785
15828
  {
15786
15829
  name: "nextToken",
@@ -15797,24 +15840,126 @@ for more details.`
15797
15840
  ]
15798
15841
  },
15799
15842
  {
15800
- resource: "sandbox.volumes",
15801
- method: "list",
15802
- summary: "List team volumes",
15803
- description: "List the volumes of your team. Use it to find a volumeID before reading or deleting a volume, or to attach a volume to a sandbox by name when you create it.",
15804
- http: "GET",
15805
- path: "/sandbox/v1/volumes",
15843
+ resource: "sandbox.templates",
15844
+ method: "create",
15845
+ summary: "Create template (v3)",
15846
+ description: 'Reserve a waiting build before submitting its source. Reusing a name in your organization allocates a new build on the same template. Returns templateID and buildID; start it with templates.builds.update, then poll templates.builds.status.list. A name:tag suffix and tags are assigned after successful publication. Example: {"name":"my-template","cpuCount":2,"memoryMB":2048}. The own face also accepts diskGb, a positive integer defaulting to 10 GiB.',
15847
+ http: "POST",
15848
+ path: "/sandbox/v1/templates",
15806
15849
  streaming: "no",
15807
15850
  pagination: false,
15808
15851
  pathParams: [],
15852
+ query: [],
15853
+ body: {
15854
+ required: true,
15855
+ fields: [
15856
+ {
15857
+ name: "name",
15858
+ type: "string",
15859
+ required: false,
15860
+ description: 'Name of the template. Can include a tag with colon separator (e.g. "my-template" or "my-template:v1"). If tag is included, it will be treated as if the tag was provided in the tags array.'
15861
+ },
15862
+ {
15863
+ name: "tags",
15864
+ type: "array",
15865
+ itemType: "string",
15866
+ required: false,
15867
+ description: "Tags to assign to the template build"
15868
+ },
15869
+ {
15870
+ name: "alias",
15871
+ type: "string",
15872
+ required: false,
15873
+ description: "Alias of the template. Deprecated, use name instead."
15874
+ },
15875
+ {
15876
+ name: "teamID",
15877
+ type: "string",
15878
+ required: false,
15879
+ description: "Identifier of the team"
15880
+ },
15881
+ {
15882
+ name: "cpuCount",
15883
+ type: "integer",
15884
+ required: false,
15885
+ description: "Requested virtual CPU count; a positive integer, default 2 for template builds."
15886
+ },
15887
+ {
15888
+ name: "memoryMB",
15889
+ type: "integer",
15890
+ required: false,
15891
+ description: "Requested build memory in MiB; a positive integer, default 1024."
15892
+ },
15893
+ {
15894
+ name: "minFreeDiskMb",
15895
+ type: "integer",
15896
+ required: false,
15897
+ description: "Upstream minimum free disk request in MiB; use the native diskGb field to set the build disk size."
15898
+ },
15899
+ {
15900
+ name: "diskGb",
15901
+ type: "integer",
15902
+ required: false,
15903
+ description: "Build disk size in GiB, a positive safe integer. Defaults to 10; available only on the own face."
15904
+ }
15905
+ ]
15906
+ }
15907
+ },
15908
+ {
15909
+ resource: "sandbox.templates.aliases",
15910
+ method: "retrieve",
15911
+ summary: "Check template alias",
15912
+ description: "Resolve a name within your organization to its templateID before reading or managing builds. Use the bare template name, without a :tag suffix. Unknown and other-organization names return 404. The response public field is false for your private templates.",
15913
+ http: "GET",
15914
+ path: "/sandbox/v1/templates/aliases/{alias}",
15915
+ streaming: "no",
15916
+ pagination: false,
15917
+ pathParams: [
15918
+ {
15919
+ name: "alias",
15920
+ sdkName: "alias",
15921
+ description: "Bare template name belonging to your organization, without a tag or provider namespace."
15922
+ }
15923
+ ],
15809
15924
  query: []
15810
15925
  },
15811
15926
  {
15812
- resource: "sandbox.volumes",
15927
+ resource: "sandbox.templates.tags",
15928
+ method: "delete",
15929
+ summary: "Delete template tags",
15930
+ description: 'Remove the specified tag labels from your template by name, for example {"name":"my-template","tags":["stable"]}. Builds remain available. Removing default means untagged sandbox creation no longer resolves this template. Unknown or other-organization names return 404. b<number> names are reserved read-only build aliases and cannot be assigned or deleted as tags.',
15931
+ http: "DELETE",
15932
+ path: "/sandbox/v1/templates/tags",
15933
+ streaming: "no",
15934
+ pagination: false,
15935
+ pathParams: [],
15936
+ query: [],
15937
+ body: {
15938
+ required: true,
15939
+ fields: [
15940
+ {
15941
+ name: "name",
15942
+ type: "string",
15943
+ required: true,
15944
+ description: "Name of the template"
15945
+ },
15946
+ {
15947
+ name: "tags",
15948
+ type: "array",
15949
+ itemType: "string",
15950
+ required: true,
15951
+ description: "Tags to delete"
15952
+ }
15953
+ ]
15954
+ }
15955
+ },
15956
+ {
15957
+ resource: "sandbox.templates.tags",
15813
15958
  method: "create",
15814
- summary: "Create team volume",
15815
- description: "Create a team volume: persistent storage that can be mounted into sandboxes and outlives them. Send the volume name; the response returns the volume id and name. Use getVolume to read it back and deleteVolume to remove it.",
15959
+ summary: "Assign template tags",
15960
+ description: 'Assign tags to the ready build selected by target in name:tag format, for example {"target":"my-template:default","tags":["stable"]}. Names belong to your organization. Tags move an existing label to this build without rebuilding. Obtain available names from templates.list and tags from templates.tags.list. b<number> names are reserved read-only build aliases and cannot be assigned or deleted as tags. target also accepts name:b<number> to select a ready build by number, for example my-template:b1.',
15816
15961
  http: "POST",
15817
- path: "/sandbox/v1/volumes",
15962
+ path: "/sandbox/v1/templates/tags",
15818
15963
  streaming: "no",
15819
15964
  pagination: false,
15820
15965
  pathParams: [],
@@ -15823,163 +15968,397 @@ for more details.`
15823
15968
  required: true,
15824
15969
  fields: [
15825
15970
  {
15826
- name: "name",
15971
+ name: "target",
15827
15972
  type: "string",
15828
15973
  required: true,
15829
- description: "Volume name, unique within your team. Use one or more ASCII letters, digits, underscores or hyphens."
15974
+ description: 'Target template in "name:tag" format'
15975
+ },
15976
+ {
15977
+ name: "tags",
15978
+ type: "array",
15979
+ itemType: "string",
15980
+ required: true,
15981
+ description: "Tags to assign to the template"
15830
15982
  }
15831
15983
  ]
15832
15984
  }
15833
15985
  },
15834
15986
  {
15835
- resource: "sandbox.volumes",
15987
+ resource: "sandbox.templates",
15836
15988
  method: "delete",
15837
- summary: "Delete team volume",
15838
- description: "Delete a team volume and its data permanently. Use it only when no sandbox needs the volume any more; the data cannot be recovered. Success answers 204; an unknown id answers 404.",
15989
+ summary: "Delete template",
15990
+ description: "Permanently remove your template, its builds and tag assignments using templateID from templates.create. Active instances prevent deletion with 409; terminate them first. Unknown or other-organization IDs return 404. Snapshot IDs use snapshots.delete instead.",
15839
15991
  http: "DELETE",
15840
- path: "/sandbox/v1/volumes/{volumeID}",
15992
+ path: "/sandbox/v1/templates/{templateID}",
15841
15993
  streaming: "no",
15842
15994
  pagination: false,
15843
15995
  pathParams: [
15844
15996
  {
15845
- name: "volumeID",
15846
- sdkName: "volumeID",
15847
- description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
15997
+ name: "templateID",
15998
+ sdkName: "templateID",
15999
+ description: "Template identifier from templates.create or templates.list. Use your organization's templateID, not a provider handle."
15848
16000
  }
15849
16001
  ],
15850
16002
  query: []
15851
16003
  },
15852
16004
  {
15853
- resource: "sandbox.volumes",
16005
+ resource: "sandbox.templates",
15854
16006
  method: "retrieve",
15855
- summary: "Team volume",
15856
- description: "Read one team volume by id. Use it to confirm a volume exists and to read its name before mounting it in a sandbox. An unknown id answers 404.",
16007
+ summary: "List template builds",
16008
+ description: "Inspect your template and its newest builds using templateID from templates.create. Build states are waiting, building, ready or error. Use limit and the returned x-next-token header to page builds. Unknown or other-organization templates return 404.",
15857
16009
  http: "GET",
15858
- path: "/sandbox/v1/volumes/{volumeID}",
16010
+ path: "/sandbox/v1/templates/{templateID}",
15859
16011
  streaming: "no",
15860
16012
  pagination: false,
15861
16013
  pathParams: [
15862
16014
  {
15863
- name: "volumeID",
15864
- sdkName: "volumeID",
15865
- description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
16015
+ name: "templateID",
16016
+ sdkName: "templateID",
16017
+ description: "Template identifier from templates.create or templates.list. Use your organization's templateID, not a provider handle."
15866
16018
  }
15867
16019
  ],
15868
- query: []
16020
+ query: [
16021
+ {
16022
+ name: "nextToken",
16023
+ type: "string",
16024
+ required: false,
16025
+ description: "Cursor to start the list from"
16026
+ },
16027
+ {
16028
+ name: "limit",
16029
+ type: "integer",
16030
+ required: false,
16031
+ description: "Maximum number of items to return per page"
16032
+ }
16033
+ ]
15869
16034
  },
15870
16035
  {
15871
- resource: "search.crawl",
15872
- method: "create",
15873
- summary: "Initiate a web crawl from a base URL",
15874
- description: "Tavily Crawl is a graph-based website traversal tool that can explore hundreds of paths in parallel with built-in extraction and intelligent discovery.",
16036
+ resource: "sandbox.templates.builds",
16037
+ method: "update",
16038
+ summary: "Start template build (v2)",
16039
+ description: 'Submit source for a waiting build returned by templates.create; returns 202 after queueing, not after successful publication. Unlike E2B, COPY is rejected (use RUN curl or git clone), fromTemplate accepts official catalog names only, and plaintext registry credentials are rejected. The own face also accepts dockerfile, mutually exclusive with fromImage/fromTemplate/steps, and fromImageRegistry vault references for nonofficial images. Poll templates.builds.status.list until ready or error. Example: {"fromImage":"node:22","steps":[{"type":"RUN","args":["echo hello"]}]}.',
15875
16040
  http: "POST",
15876
- path: "/search/v1/crawl",
16041
+ path: "/sandbox/v1/templates/{templateID}/builds/{buildID}",
15877
16042
  streaming: "no",
15878
16043
  pagination: false,
15879
- pathParams: [],
16044
+ pathParams: [
16045
+ {
16046
+ name: "templateID",
16047
+ sdkName: "templateID",
16048
+ description: "Template identifier from templates.create or templates.list. Use your organization's templateID, not a provider handle."
16049
+ },
16050
+ {
16051
+ name: "buildID",
16052
+ sdkName: "buildID",
16053
+ description: "Build identifier returned by templates.create. It must belong to the selected template in your organization."
16054
+ }
16055
+ ],
15880
16056
  query: [],
15881
16057
  body: {
15882
16058
  required: true,
15883
16059
  fields: [
15884
16060
  {
15885
- name: "url",
15886
- type: "string",
15887
- required: true,
15888
- description: "The root URL to begin the crawl."
15889
- },
15890
- {
15891
- name: "instructions",
16061
+ name: "fromImage",
15892
16062
  type: "string",
15893
16063
  required: false,
15894
- description: "Natural language instructions for the crawler. When specified, the mapping cost increases to 2 API credits per 10 successful pages instead of 1 API credit per 10 pages."
15895
- },
15896
- {
15897
- name: "chunks_per_source",
15898
- type: "integer",
15899
- required: false,
15900
- description: "Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use `chunks_per_source` to define the maximum number of relevant chunks returned per source and to control the `raw_content` length. Chunks will appear in the `raw_content` field as: `<chunk 1> [...] <chunk 2> [...] <chunk 3>`. Available only when `instructions` are provided. Must be between 1 and 5."
15901
- },
15902
- {
15903
- name: "max_depth",
15904
- type: "integer",
15905
- required: false,
15906
- description: "Max depth of the crawl. Defines how far from the base URL the crawler can explore."
15907
- },
15908
- {
15909
- name: "max_breadth",
15910
- type: "integer",
15911
- required: false,
15912
- description: "Max number of links to follow per level of the tree (i.e., per page)."
15913
- },
15914
- {
15915
- name: "limit",
15916
- type: "integer",
15917
- required: false,
15918
- description: "Total number of links the crawler will process before stopping."
16064
+ description: "Image to use as a base for the template build"
15919
16065
  },
15920
16066
  {
15921
- name: "select_paths",
15922
- type: "array",
15923
- itemType: "string",
16067
+ name: "fromTemplate",
16068
+ type: "string",
15924
16069
  required: false,
15925
- description: "Regex patterns to select only URLs with specific path patterns (e.g., `/docs/.*`, `/api/v1.*`)."
16070
+ description: "Template to use as a base for the template build"
15926
16071
  },
15927
16072
  {
15928
- name: "select_domains",
15929
- type: "array",
15930
- itemType: "string",
16073
+ name: "fromImageRegistry",
16074
+ type: "object",
15931
16075
  required: false,
15932
- description: "Regex patterns to select crawling to specific domains or subdomains (e.g., `^docs\\.example\\.com$`)."
16076
+ description: "Registry authentication. Unlike E2B, only the vault reference variant is accepted; plaintext aws, gcp and registry variants return 400. Cannot be used with official templates."
15933
16077
  },
15934
16078
  {
15935
- name: "exclude_paths",
15936
- type: "array",
15937
- itemType: "string",
16079
+ name: "force",
16080
+ type: "boolean",
15938
16081
  required: false,
15939
- description: "Regex patterns to exclude URLs with specific path patterns (e.g., `/private/.*`, `/admin/.*`)."
16082
+ description: "Whether the whole build should be forced to run regardless of the cache"
15940
16083
  },
15941
16084
  {
15942
- name: "exclude_domains",
16085
+ name: "steps",
15943
16086
  type: "array",
15944
- itemType: "string",
15945
- required: false,
15946
- description: "Regex patterns to exclude specific domains or subdomains from crawling (e.g., `^private\\.example\\.com$`)."
15947
- },
15948
- {
15949
- name: "allow_external",
15950
- type: "boolean",
16087
+ itemType: "object",
15951
16088
  required: false,
15952
- description: "Whether to include external domain links in the final results list."
16089
+ description: "List of steps to execute in the template build"
15953
16090
  },
15954
16091
  {
15955
- name: "include_images",
15956
- type: "boolean",
16092
+ name: "startCmd",
16093
+ type: "string",
15957
16094
  required: false,
15958
- description: "Whether to include images in the crawl results."
16095
+ description: "Start command to execute in the template after the build"
15959
16096
  },
15960
16097
  {
15961
- name: "extract_depth",
16098
+ name: "readyCmd",
15962
16099
  type: "string",
15963
- enum: [
15964
- "basic",
15965
- "advanced"
15966
- ],
15967
16100
  required: false,
15968
- description: "Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency. `basic` extraction costs 1 credit per 5 successful extractions, while `advanced` extraction costs 2 credits per 5 successful extractions."
16101
+ description: "Ready check command to execute in the template after the build"
15969
16102
  },
15970
16103
  {
15971
- name: "format",
16104
+ name: "dockerfile",
15972
16105
  type: "string",
15973
- enum: [
15974
- "markdown",
15975
- "text"
15976
- ],
15977
16106
  required: false,
15978
- description: "The format of the extracted web page content. `markdown` returns content in markdown format. `text` returns plain text and may increase latency."
15979
- },
15980
- {
15981
- name: "include_favicon",
15982
- type: "boolean",
16107
+ description: "Dockerfile text, at most 64 KiB UTF-8. Mutually exclusive with fromImage, fromTemplate and steps. COPY/ADD are rejected; fetch remote content using RUN. Registry credentials require a nonofficial image in the first FROM."
16108
+ }
16109
+ ]
16110
+ }
16111
+ },
16112
+ {
16113
+ resource: "sandbox.templates.builds.status",
16114
+ method: "list",
16115
+ summary: "Template build status",
16116
+ description: "Poll a build using templateID and buildID from templates.create. waiting means source has not been submitted; building includes queued work; ready permits sandbox creation; error is terminal, with reason when available. logsOffset counts previously read log entries, starting at zero; add logEntries.length after each response. limit is 0–100, default 100. level selects one log level; offsets then count entries at that level. Drain logs until an empty page, including after a terminal status.",
16117
+ http: "GET",
16118
+ path: "/sandbox/v1/templates/{templateID}/builds/{buildID}/status",
16119
+ streaming: "no",
16120
+ pagination: false,
16121
+ pathParams: [
16122
+ {
16123
+ name: "templateID",
16124
+ sdkName: "templateID",
16125
+ description: "Template identifier from templates.create or templates.list. Use your organization's templateID, not a provider handle."
16126
+ },
16127
+ {
16128
+ name: "buildID",
16129
+ sdkName: "buildID",
16130
+ description: "Build identifier returned by templates.create. It must belong to the selected template in your organization."
16131
+ }
16132
+ ],
16133
+ query: [
16134
+ {
16135
+ name: "logsOffset",
16136
+ type: "integer",
16137
+ required: false,
16138
+ description: "Index of the starting build log that should be returned with the template"
16139
+ },
16140
+ {
16141
+ name: "limit",
16142
+ type: "integer",
16143
+ required: false,
16144
+ description: "Maximum number of logs that should be returned"
16145
+ },
16146
+ {
16147
+ name: "level",
16148
+ type: "string",
16149
+ enum: [
16150
+ "debug",
16151
+ "info",
16152
+ "warn",
16153
+ "error"
16154
+ ],
16155
+ required: false,
16156
+ description: "Select one exact log severity: debug for diagnostics, info for progress, warn for warnings, error for failures. Offsets count matching entries."
16157
+ }
16158
+ ]
16159
+ },
16160
+ {
16161
+ resource: "sandbox.templates.tags",
16162
+ method: "list",
16163
+ summary: "List template tags",
16164
+ description: "Read the tag-to-build assignments for your template using templateID from templates.create. Only ready builds acquire tags. Use a returned tag with the template name as name:tag when creating a sandbox or assigning additional tags. Foreign IDs return 404.",
16165
+ http: "GET",
16166
+ path: "/sandbox/v1/templates/{templateID}/tags",
16167
+ streaming: "no",
16168
+ pagination: false,
16169
+ pathParams: [
16170
+ {
16171
+ name: "templateID",
16172
+ sdkName: "templateID",
16173
+ description: "Template identifier from templates.create or templates.list. Use your organization's templateID, not a provider handle."
16174
+ }
16175
+ ],
16176
+ query: []
16177
+ },
16178
+ {
16179
+ resource: "sandbox.volumes",
16180
+ method: "list",
16181
+ summary: "List team volumes",
16182
+ description: "List the volumes of your team. Use it to find a volumeID before reading or deleting a volume, or to attach a volume to a sandbox by name when you create it.",
16183
+ http: "GET",
16184
+ path: "/sandbox/v1/volumes",
16185
+ streaming: "no",
16186
+ pagination: false,
16187
+ pathParams: [],
16188
+ query: []
16189
+ },
16190
+ {
16191
+ resource: "sandbox.volumes",
16192
+ method: "create",
16193
+ summary: "Create team volume",
16194
+ description: "Create a team volume: persistent storage that can be mounted into sandboxes and outlives them. Send the volume name; the response returns the volume id and name. Use getVolume to read it back and deleteVolume to remove it.",
16195
+ http: "POST",
16196
+ path: "/sandbox/v1/volumes",
16197
+ streaming: "no",
16198
+ pagination: false,
16199
+ pathParams: [],
16200
+ query: [],
16201
+ body: {
16202
+ required: true,
16203
+ fields: [
16204
+ {
16205
+ name: "name",
16206
+ type: "string",
16207
+ required: true,
16208
+ description: "Volume name, unique within your team. Use one or more ASCII letters, digits, underscores or hyphens."
16209
+ }
16210
+ ]
16211
+ }
16212
+ },
16213
+ {
16214
+ resource: "sandbox.volumes",
16215
+ method: "delete",
16216
+ summary: "Delete team volume",
16217
+ description: "Delete a team volume and its data permanently. Use it only when no sandbox needs the volume any more; the data cannot be recovered. Success answers 204; an unknown id answers 404.",
16218
+ http: "DELETE",
16219
+ path: "/sandbox/v1/volumes/{volumeID}",
16220
+ streaming: "no",
16221
+ pagination: false,
16222
+ pathParams: [
16223
+ {
16224
+ name: "volumeID",
16225
+ sdkName: "volumeID",
16226
+ description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
16227
+ }
16228
+ ],
16229
+ query: []
16230
+ },
16231
+ {
16232
+ resource: "sandbox.volumes",
16233
+ method: "retrieve",
16234
+ summary: "Team volume",
16235
+ description: "Read one team volume by id. Use it to confirm a volume exists and to read its name before mounting it in a sandbox. An unknown id answers 404.",
16236
+ http: "GET",
16237
+ path: "/sandbox/v1/volumes/{volumeID}",
16238
+ streaming: "no",
16239
+ pagination: false,
16240
+ pathParams: [
16241
+ {
16242
+ name: "volumeID",
16243
+ sdkName: "volumeID",
16244
+ description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
16245
+ }
16246
+ ],
16247
+ query: []
16248
+ },
16249
+ {
16250
+ resource: "search.crawl",
16251
+ method: "create",
16252
+ summary: "Initiate a web crawl from a base URL",
16253
+ description: "Tavily Crawl is a graph-based website traversal tool that can explore hundreds of paths in parallel with built-in extraction and intelligent discovery.",
16254
+ http: "POST",
16255
+ path: "/search/v1/crawl",
16256
+ streaming: "no",
16257
+ pagination: false,
16258
+ pathParams: [],
16259
+ query: [],
16260
+ body: {
16261
+ required: true,
16262
+ fields: [
16263
+ {
16264
+ name: "url",
16265
+ type: "string",
16266
+ required: true,
16267
+ description: "The root URL to begin the crawl."
16268
+ },
16269
+ {
16270
+ name: "instructions",
16271
+ type: "string",
16272
+ required: false,
16273
+ description: "Natural language instructions for the crawler. When specified, the mapping cost increases to 2 API credits per 10 successful pages instead of 1 API credit per 10 pages."
16274
+ },
16275
+ {
16276
+ name: "chunks_per_source",
16277
+ type: "integer",
16278
+ required: false,
16279
+ description: "Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use `chunks_per_source` to define the maximum number of relevant chunks returned per source and to control the `raw_content` length. Chunks will appear in the `raw_content` field as: `<chunk 1> [...] <chunk 2> [...] <chunk 3>`. Available only when `instructions` are provided. Must be between 1 and 5."
16280
+ },
16281
+ {
16282
+ name: "max_depth",
16283
+ type: "integer",
16284
+ required: false,
16285
+ description: "Max depth of the crawl. Defines how far from the base URL the crawler can explore."
16286
+ },
16287
+ {
16288
+ name: "max_breadth",
16289
+ type: "integer",
16290
+ required: false,
16291
+ description: "Max number of links to follow per level of the tree (i.e., per page)."
16292
+ },
16293
+ {
16294
+ name: "limit",
16295
+ type: "integer",
16296
+ required: false,
16297
+ description: "Total number of links the crawler will process before stopping."
16298
+ },
16299
+ {
16300
+ name: "select_paths",
16301
+ type: "array",
16302
+ itemType: "string",
16303
+ required: false,
16304
+ description: "Regex patterns to select only URLs with specific path patterns (e.g., `/docs/.*`, `/api/v1.*`)."
16305
+ },
16306
+ {
16307
+ name: "select_domains",
16308
+ type: "array",
16309
+ itemType: "string",
16310
+ required: false,
16311
+ description: "Regex patterns to select crawling to specific domains or subdomains (e.g., `^docs\\.example\\.com$`)."
16312
+ },
16313
+ {
16314
+ name: "exclude_paths",
16315
+ type: "array",
16316
+ itemType: "string",
16317
+ required: false,
16318
+ description: "Regex patterns to exclude URLs with specific path patterns (e.g., `/private/.*`, `/admin/.*`)."
16319
+ },
16320
+ {
16321
+ name: "exclude_domains",
16322
+ type: "array",
16323
+ itemType: "string",
16324
+ required: false,
16325
+ description: "Regex patterns to exclude specific domains or subdomains from crawling (e.g., `^private\\.example\\.com$`)."
16326
+ },
16327
+ {
16328
+ name: "allow_external",
16329
+ type: "boolean",
16330
+ required: false,
16331
+ description: "Whether to include external domain links in the final results list."
16332
+ },
16333
+ {
16334
+ name: "include_images",
16335
+ type: "boolean",
16336
+ required: false,
16337
+ description: "Whether to include images in the crawl results."
16338
+ },
16339
+ {
16340
+ name: "extract_depth",
16341
+ type: "string",
16342
+ enum: [
16343
+ "basic",
16344
+ "advanced"
16345
+ ],
16346
+ required: false,
16347
+ description: "Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency. `basic` extraction costs 1 credit per 5 successful extractions, while `advanced` extraction costs 2 credits per 5 successful extractions."
16348
+ },
16349
+ {
16350
+ name: "format",
16351
+ type: "string",
16352
+ enum: [
16353
+ "markdown",
16354
+ "text"
16355
+ ],
16356
+ required: false,
16357
+ description: "The format of the extracted web page content. `markdown` returns content in markdown format. `text` returns plain text and may increase latency."
16358
+ },
16359
+ {
16360
+ name: "include_favicon",
16361
+ type: "boolean",
15983
16362
  required: false,
15984
16363
  description: "Whether to include the favicon URL for each result."
15985
16364
  },
@@ -18918,6 +19297,65 @@ async function fetchWithRetry(request, fetcher, options) {
18918
19297
  }
18919
19298
  }
18920
19299
 
19300
+ // ../../packages/sdk/typescript/src/helpers/sandbox-templates.ts
19301
+ class SandboxTemplateBuildError extends Error {
19302
+ templateID;
19303
+ buildID;
19304
+ reason;
19305
+ logEntries;
19306
+ name = "SandboxTemplateBuildError";
19307
+ constructor(templateID, buildID, reason, logEntries) {
19308
+ super(`Template build failed: ${reason?.message ?? "Unknown build error"}${logEntries.length ? `
19309
+ ${logEntries.map((log) => log.message).join(`
19310
+ `)}` : ""}`);
19311
+ this.templateID = templateID;
19312
+ this.buildID = buildID;
19313
+ this.reason = reason;
19314
+ this.logEntries = logEntries;
19315
+ }
19316
+ }
19317
+ async function buildSandboxTemplate(client, input) {
19318
+ const signal = input.signal ?? new AbortController().signal;
19319
+ signal.throwIfAborted();
19320
+ const interval = input.pollIntervalMs ?? 1000;
19321
+ if (!Number.isSafeInteger(interval) || interval < 0)
19322
+ throw new RangeError("pollIntervalMs must be a nonnegative integer");
19323
+ if ([input.dockerfile, input.fromTemplate, input.fromImage].filter((value) => value !== undefined).length !== 1 || input.dockerfile !== undefined && input.steps !== undefined)
19324
+ throw new TypeError("Supply dockerfile, fromTemplate or fromImage; dockerfile cannot include steps");
19325
+ const created = await client.sandbox.templates.create({ body: {
19326
+ name: input.name,
19327
+ cpuCount: input.cpuCount,
19328
+ memoryMB: input.memoryMB,
19329
+ diskGb: input.diskGb,
19330
+ tags: input.tags
19331
+ }, signal });
19332
+ const path = { templateID: created.templateID, buildID: created.buildID };
19333
+ await client.sandbox.templates.builds.update({ path, body: input.dockerfile !== undefined ? { dockerfile: input.dockerfile } : { fromTemplate: input.fromTemplate, fromImage: input.fromImage, steps: input.steps }, signal });
19334
+ let logsOffset = 0;
19335
+ const tail = [];
19336
+ let terminal;
19337
+ while (true) {
19338
+ signal.throwIfAborted();
19339
+ const result = await client.sandbox.templates.builds.status.list({ path, query: { logsOffset }, signal });
19340
+ for (const entry of result.logEntries) {
19341
+ signal.throwIfAborted();
19342
+ await input.onLog?.(entry);
19343
+ tail.push({ ...entry, message: entry.message.slice(-4096) });
19344
+ if (tail.length > 20)
19345
+ tail.shift();
19346
+ }
19347
+ logsOffset += result.logEntries.length;
19348
+ if (!terminal && (result.status === "ready" || result.status === "error"))
19349
+ terminal = result;
19350
+ if (terminal && result.logEntries.length === 0) {
19351
+ if (terminal.status === "error")
19352
+ throw new SandboxTemplateBuildError(path.templateID, path.buildID, terminal.reason, tail);
19353
+ return { ...terminal, status: "ready", logEntries: [] };
19354
+ }
19355
+ await sleep(interval, signal);
19356
+ }
19357
+ }
19358
+
18921
19359
  // ../../packages/sdk/typescript/src/helpers/file-upload.ts
18922
19360
  var MAX_RETRIES = 5;
18923
19361
  function retryable(error) {
@@ -20696,7 +21134,7 @@ var fileCreateSignedUpload = (options) => (options.client ?? client).post({
20696
21134
  ...options.headers
20697
21135
  }
20698
21136
  });
20699
- var fileRevokeContentLink = (options) => (options.client ?? client).post({
21137
+ var fileCreateContentUrl = (options) => (options.client ?? client).post({
20700
21138
  security: [{
20701
21139
  key: "BearerAuth",
20702
21140
  scheme: "bearer",
@@ -20706,23 +21144,40 @@ var fileRevokeContentLink = (options) => (options.client ?? client).post({
20706
21144
  name: "X-API-Key",
20707
21145
  type: "apiKey"
20708
21146
  }],
20709
- url: "/file/v1/files/{file_id}/content_links:revoke",
21147
+ url: "/file/v1/files/{file_id}/content_url",
20710
21148
  ...options,
20711
21149
  headers: {
20712
21150
  "Content-Type": "application/json",
20713
21151
  ...options.headers
20714
21152
  }
20715
21153
  });
20716
- var healthCheck = (options) => (options?.client ?? client).get({ url: "/meta/v1/health", ...options });
20717
- var metaMethodsSearch = (options) => (options?.client ?? client).get({ url: "/meta/v1/methods", ...options });
20718
- var metaMethodsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/methods/{name}", ...options });
20719
- var metaDocsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/{path}", ...options });
20720
- var metaDocsSearch = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/search", ...options });
20721
- var listModels = (options) => (options?.client ?? client).get({
20722
- querySerializer: { parameters: {
20723
- supported_api: { array: { explode: false } },
20724
- type: { array: { explode: false } },
20725
- output_modalities: { array: { explode: false } }
21154
+ var fileRevokeContentLink = (options) => (options.client ?? client).post({
21155
+ security: [{
21156
+ key: "BearerAuth",
21157
+ scheme: "bearer",
21158
+ type: "http"
21159
+ }, {
21160
+ key: "ApiKeyAuth",
21161
+ name: "X-API-Key",
21162
+ type: "apiKey"
21163
+ }],
21164
+ url: "/file/v1/files/{file_id}/content_links:revoke",
21165
+ ...options,
21166
+ headers: {
21167
+ "Content-Type": "application/json",
21168
+ ...options.headers
21169
+ }
21170
+ });
21171
+ var healthCheck = (options) => (options?.client ?? client).get({ url: "/meta/v1/health", ...options });
21172
+ var metaMethodsSearch = (options) => (options?.client ?? client).get({ url: "/meta/v1/methods", ...options });
21173
+ var metaMethodsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/methods/{name}", ...options });
21174
+ var metaDocsRetrieve = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/{path}", ...options });
21175
+ var metaDocsSearch = (options) => (options.client ?? client).get({ url: "/meta/v1/docs/search", ...options });
21176
+ var listModels = (options) => (options?.client ?? client).get({
21177
+ querySerializer: { parameters: {
21178
+ supported_api: { array: { explode: false } },
21179
+ type: { array: { explode: false } },
21180
+ output_modalities: { array: { explode: false } }
20726
21181
  } },
20727
21182
  url: "/model/v1/models",
20728
21183
  ...options
@@ -25122,7 +25577,7 @@ var postSandboxV1SandboxesBySandboxIdConnect = (options) => (options.client ?? c
25122
25577
  ...options.headers
25123
25578
  }
25124
25579
  });
25125
- var getSandboxV1Templates = (options) => (options?.client ?? client).get({
25580
+ var listSandboxTemplates = (options) => (options?.client ?? client).get({
25126
25581
  security: [
25127
25582
  {
25128
25583
  key: "sandbox-ApiKeyAuth",
@@ -25154,6 +25609,42 @@ var getSandboxV1Templates = (options) => (options?.client ?? client).get({
25154
25609
  url: "/sandbox/v1/templates",
25155
25610
  ...options
25156
25611
  });
25612
+ var requestTemplateBuild = (options) => (options.client ?? client).post({
25613
+ security: [
25614
+ {
25615
+ key: "sandbox-ApiKeyAuth",
25616
+ name: "X-API-Key",
25617
+ type: "apiKey"
25618
+ },
25619
+ {
25620
+ key: "sandbox-AuthProviderBearerAuth",
25621
+ scheme: "bearer",
25622
+ type: "http"
25623
+ },
25624
+ {
25625
+ key: "sandbox-AuthProviderTeamAuth",
25626
+ name: "X-Team-ID",
25627
+ type: "apiKey"
25628
+ },
25629
+ { name: "X-Admin-Token", type: "apiKey" },
25630
+ {
25631
+ key: "sandbox-AdminTeamAuth",
25632
+ name: "X-Team-ID",
25633
+ type: "apiKey"
25634
+ },
25635
+ {
25636
+ key: "sandbox-AdminJWTAuth",
25637
+ scheme: "bearer",
25638
+ type: "http"
25639
+ }
25640
+ ],
25641
+ url: "/sandbox/v1/templates",
25642
+ ...options,
25643
+ headers: {
25644
+ "Content-Type": "application/json",
25645
+ ...options.headers
25646
+ }
25647
+ });
25157
25648
  var getSandboxV1Volumes = (options) => (options?.client ?? client).get({
25158
25649
  security: [
25159
25650
  {
@@ -25490,6 +25981,274 @@ var getSandboxV1SandboxesBySandboxIdLogs = (options) => (options.client ?? clien
25490
25981
  url: "/sandbox/v1/sandboxes/{sandboxID}/logs",
25491
25982
  ...options
25492
25983
  });
25984
+ var startTemplateBuild = (options) => (options.client ?? client).post({
25985
+ security: [
25986
+ {
25987
+ key: "sandbox-ApiKeyAuth",
25988
+ name: "X-API-Key",
25989
+ type: "apiKey"
25990
+ },
25991
+ {
25992
+ key: "sandbox-AuthProviderBearerAuth",
25993
+ scheme: "bearer",
25994
+ type: "http"
25995
+ },
25996
+ {
25997
+ key: "sandbox-AuthProviderTeamAuth",
25998
+ name: "X-Team-ID",
25999
+ type: "apiKey"
26000
+ },
26001
+ { name: "X-Admin-Token", type: "apiKey" },
26002
+ {
26003
+ key: "sandbox-AdminTeamAuth",
26004
+ name: "X-Team-ID",
26005
+ type: "apiKey"
26006
+ },
26007
+ {
26008
+ key: "sandbox-AdminJWTAuth",
26009
+ scheme: "bearer",
26010
+ type: "http"
26011
+ }
26012
+ ],
26013
+ url: "/sandbox/v1/templates/{templateID}/builds/{buildID}",
26014
+ ...options,
26015
+ headers: {
26016
+ "Content-Type": "application/json",
26017
+ ...options.headers
26018
+ }
26019
+ });
26020
+ var getTemplateBuildStatus = (options) => (options.client ?? client).get({
26021
+ security: [
26022
+ {
26023
+ key: "sandbox-ApiKeyAuth",
26024
+ name: "X-API-Key",
26025
+ type: "apiKey"
26026
+ },
26027
+ {
26028
+ key: "sandbox-AuthProviderBearerAuth",
26029
+ scheme: "bearer",
26030
+ type: "http"
26031
+ },
26032
+ {
26033
+ key: "sandbox-AuthProviderTeamAuth",
26034
+ name: "X-Team-ID",
26035
+ type: "apiKey"
26036
+ },
26037
+ { name: "X-Admin-Token", type: "apiKey" },
26038
+ {
26039
+ key: "sandbox-AdminTeamAuth",
26040
+ name: "X-Team-ID",
26041
+ type: "apiKey"
26042
+ },
26043
+ {
26044
+ key: "sandbox-AdminJWTAuth",
26045
+ scheme: "bearer",
26046
+ type: "http"
26047
+ }
26048
+ ],
26049
+ url: "/sandbox/v1/templates/{templateID}/builds/{buildID}/status",
26050
+ ...options
26051
+ });
26052
+ var deleteUserTemplate = (options) => (options.client ?? client).delete({
26053
+ security: [
26054
+ {
26055
+ key: "sandbox-ApiKeyAuth",
26056
+ name: "X-API-Key",
26057
+ type: "apiKey"
26058
+ },
26059
+ {
26060
+ key: "sandbox-AuthProviderBearerAuth",
26061
+ scheme: "bearer",
26062
+ type: "http"
26063
+ },
26064
+ {
26065
+ key: "sandbox-AuthProviderTeamAuth",
26066
+ name: "X-Team-ID",
26067
+ type: "apiKey"
26068
+ },
26069
+ { name: "X-Admin-Token", type: "apiKey" },
26070
+ {
26071
+ key: "sandbox-AdminTeamAuth",
26072
+ name: "X-Team-ID",
26073
+ type: "apiKey"
26074
+ },
26075
+ {
26076
+ key: "sandbox-AdminJWTAuth",
26077
+ scheme: "bearer",
26078
+ type: "http"
26079
+ }
26080
+ ],
26081
+ url: "/sandbox/v1/templates/{templateID}",
26082
+ ...options
26083
+ });
26084
+ var getTemplateWithBuilds = (options) => (options.client ?? client).get({
26085
+ security: [
26086
+ {
26087
+ key: "sandbox-ApiKeyAuth",
26088
+ name: "X-API-Key",
26089
+ type: "apiKey"
26090
+ },
26091
+ {
26092
+ key: "sandbox-AuthProviderBearerAuth",
26093
+ scheme: "bearer",
26094
+ type: "http"
26095
+ },
26096
+ {
26097
+ key: "sandbox-AuthProviderTeamAuth",
26098
+ name: "X-Team-ID",
26099
+ type: "apiKey"
26100
+ },
26101
+ { name: "X-Admin-Token", type: "apiKey" },
26102
+ {
26103
+ key: "sandbox-AdminTeamAuth",
26104
+ name: "X-Team-ID",
26105
+ type: "apiKey"
26106
+ },
26107
+ {
26108
+ key: "sandbox-AdminJWTAuth",
26109
+ scheme: "bearer",
26110
+ type: "http"
26111
+ }
26112
+ ],
26113
+ url: "/sandbox/v1/templates/{templateID}",
26114
+ ...options
26115
+ });
26116
+ var deleteTemplateTags = (options) => (options.client ?? client).delete({
26117
+ security: [
26118
+ {
26119
+ key: "sandbox-ApiKeyAuth",
26120
+ name: "X-API-Key",
26121
+ type: "apiKey"
26122
+ },
26123
+ {
26124
+ key: "sandbox-AuthProviderBearerAuth",
26125
+ scheme: "bearer",
26126
+ type: "http"
26127
+ },
26128
+ {
26129
+ key: "sandbox-AuthProviderTeamAuth",
26130
+ name: "X-Team-ID",
26131
+ type: "apiKey"
26132
+ },
26133
+ { name: "X-Admin-Token", type: "apiKey" },
26134
+ {
26135
+ key: "sandbox-AdminTeamAuth",
26136
+ name: "X-Team-ID",
26137
+ type: "apiKey"
26138
+ },
26139
+ {
26140
+ key: "sandbox-AdminJWTAuth",
26141
+ scheme: "bearer",
26142
+ type: "http"
26143
+ }
26144
+ ],
26145
+ url: "/sandbox/v1/templates/tags",
26146
+ ...options,
26147
+ headers: {
26148
+ "Content-Type": "application/json",
26149
+ ...options.headers
26150
+ }
26151
+ });
26152
+ var assignTemplateTags = (options) => (options.client ?? client).post({
26153
+ security: [
26154
+ {
26155
+ key: "sandbox-ApiKeyAuth",
26156
+ name: "X-API-Key",
26157
+ type: "apiKey"
26158
+ },
26159
+ {
26160
+ key: "sandbox-AuthProviderBearerAuth",
26161
+ scheme: "bearer",
26162
+ type: "http"
26163
+ },
26164
+ {
26165
+ key: "sandbox-AuthProviderTeamAuth",
26166
+ name: "X-Team-ID",
26167
+ type: "apiKey"
26168
+ },
26169
+ { name: "X-Admin-Token", type: "apiKey" },
26170
+ {
26171
+ key: "sandbox-AdminTeamAuth",
26172
+ name: "X-Team-ID",
26173
+ type: "apiKey"
26174
+ },
26175
+ {
26176
+ key: "sandbox-AdminJWTAuth",
26177
+ scheme: "bearer",
26178
+ type: "http"
26179
+ }
26180
+ ],
26181
+ url: "/sandbox/v1/templates/tags",
26182
+ ...options,
26183
+ headers: {
26184
+ "Content-Type": "application/json",
26185
+ ...options.headers
26186
+ }
26187
+ });
26188
+ var listTemplateTags = (options) => (options.client ?? client).get({
26189
+ security: [
26190
+ {
26191
+ key: "sandbox-ApiKeyAuth",
26192
+ name: "X-API-Key",
26193
+ type: "apiKey"
26194
+ },
26195
+ {
26196
+ key: "sandbox-AuthProviderBearerAuth",
26197
+ scheme: "bearer",
26198
+ type: "http"
26199
+ },
26200
+ {
26201
+ key: "sandbox-AuthProviderTeamAuth",
26202
+ name: "X-Team-ID",
26203
+ type: "apiKey"
26204
+ },
26205
+ { name: "X-Admin-Token", type: "apiKey" },
26206
+ {
26207
+ key: "sandbox-AdminTeamAuth",
26208
+ name: "X-Team-ID",
26209
+ type: "apiKey"
26210
+ },
26211
+ {
26212
+ key: "sandbox-AdminJWTAuth",
26213
+ scheme: "bearer",
26214
+ type: "http"
26215
+ }
26216
+ ],
26217
+ url: "/sandbox/v1/templates/{templateID}/tags",
26218
+ ...options
26219
+ });
26220
+ var resolveTemplateAlias = (options) => (options.client ?? client).get({
26221
+ security: [
26222
+ {
26223
+ key: "sandbox-ApiKeyAuth",
26224
+ name: "X-API-Key",
26225
+ type: "apiKey"
26226
+ },
26227
+ {
26228
+ key: "sandbox-AuthProviderBearerAuth",
26229
+ scheme: "bearer",
26230
+ type: "http"
26231
+ },
26232
+ {
26233
+ key: "sandbox-AuthProviderTeamAuth",
26234
+ name: "X-Team-ID",
26235
+ type: "apiKey"
26236
+ },
26237
+ { name: "X-Admin-Token", type: "apiKey" },
26238
+ {
26239
+ key: "sandbox-AdminTeamAuth",
26240
+ name: "X-Team-ID",
26241
+ type: "apiKey"
26242
+ },
26243
+ {
26244
+ key: "sandbox-AdminJWTAuth",
26245
+ scheme: "bearer",
26246
+ type: "http"
26247
+ }
26248
+ ],
26249
+ url: "/sandbox/v1/templates/aliases/{alias}",
26250
+ ...options
26251
+ });
25493
26252
  var searchSearch = (options) => (options.client ?? client).post({
25494
26253
  security: [{
25495
26254
  key: "search-bearerAuth",
@@ -26929,6 +27688,9 @@ function createFile(transport) {
26929
27688
  contentLinks: {
26930
27689
  revoke: bind(transport, fileRevokeContentLink)
26931
27690
  },
27691
+ contentUrl: {
27692
+ create: bind(transport, fileCreateContentUrl)
27693
+ },
26932
27694
  create: bind(transport, (options) => fileCreateFile({ ...options, bodySerializer: multipartBodySerializer, headers: { "Content-Type": null, ...options.headers } })),
26933
27695
  delete: bind(transport, fileDeleteFile),
26934
27696
  list: bind(transport, fileListFiles),
@@ -27223,7 +27985,24 @@ function createSandbox(transport) {
27223
27985
  list: bind(transport, getSandboxV1Snapshots)
27224
27986
  },
27225
27987
  templates: {
27226
- list: bind(transport, getSandboxV1Templates)
27988
+ aliases: {
27989
+ retrieve: bind(transport, resolveTemplateAlias)
27990
+ },
27991
+ builds: {
27992
+ status: {
27993
+ list: bind(transport, getTemplateBuildStatus)
27994
+ },
27995
+ update: bind(transport, startTemplateBuild)
27996
+ },
27997
+ create: bind(transport, requestTemplateBuild),
27998
+ delete: bind(transport, deleteUserTemplate),
27999
+ list: bind(transport, listSandboxTemplates),
28000
+ retrieve: bind(transport, getTemplateWithBuilds),
28001
+ tags: {
28002
+ create: bind(transport, assignTemplateTags),
28003
+ delete: bind(transport, deleteTemplateTags),
28004
+ list: bind(transport, listTemplateTags)
28005
+ }
27227
28006
  },
27228
28007
  volumes: {
27229
28008
  create: bind(transport, postSandboxV1Volumes),
@@ -28144,6 +28923,8 @@ class Praxis {
28144
28923
  const transport = new Transport(options);
28145
28924
  for (const [name, create] of Object.entries(resourceFactories)) {
28146
28925
  const resource = create(transport);
28926
+ if (name === "sandbox")
28927
+ Object.assign(resource.templates, { build: (input) => buildSandboxTemplate(this, input) });
28147
28928
  if (name === "file")
28148
28929
  Object.assign(resource, { uploadFile: (file, options2) => uploadFile(this, file, options2) });
28149
28930
  if (name === "database")
@@ -29574,9 +30355,9 @@ function randomSecret(bytes = 32) {
29574
30355
  function decideBuildOutput(mode) {
29575
30356
  return mode === "human" ? "stream" : "capture";
29576
30357
  }
29577
- function tailLines(text, count3) {
30358
+ function tailLines(text, count2) {
29578
30359
  return text.replace(/\s+$/, "").split(`
29579
- `).slice(-count3).join(`
30360
+ `).slice(-count2).join(`
29580
30361
  `);
29581
30362
  }
29582
30363
  function nextSteps(dir, bunAvailable) {
@@ -29977,7 +30758,7 @@ function projectList(items, op) {
29977
30758
  }
29978
30759
 
29979
30760
  // src/output/human.ts
29980
- var count3 = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
30761
+ var count2 = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
29981
30762
  function identity(result, ctx) {
29982
30763
  const op = "op" in result ? result.op : undefined;
29983
30764
  const split = op?.lastIndexOf(".") ?? -1;
@@ -30065,7 +30846,7 @@ function objectView(data, resource, id, ctx, paint) {
30065
30846
  return v.map(scalar).map(plain).join(", ");
30066
30847
  folded = true;
30067
30848
  const preview = v.slice(0, 3).map((item) => record(item).id ?? record(item).name).filter((x) => x !== undefined).map((x) => plain(scalar(x)));
30068
- return `${count3(v.length, "item")}${preview.length ? ` (${preview.join(", ")})` : ""}`;
30849
+ return `${count2(v.length, "item")}${preview.length ? ` (${preview.join(", ")})` : ""}`;
30069
30850
  }
30070
30851
  if (v !== null && typeof v === "object") {
30071
30852
  if (depth >= 1) {
@@ -30110,7 +30891,7 @@ function renderHuman(result, ctx) {
30110
30891
  return {
30111
30892
  stdout: result.items.length ? table(projectList(result.items, result.op), ctx, out) : out.dim(`No ${plain(resource)}${/(s|x|ch|sh)$/.test(resource) ? "es" : "s"}.`) + `
30112
30893
  `,
30113
- stderr: err.dim(`${result.total !== undefined ? `${result.items.length} of ${result.total} items` : count3(result.items.length, "item")}${result.nextCursor ? ` · next: ${ctx.nextCommand ?? "praxis --help"}` : ""}`) + `
30894
+ stderr: err.dim(`${result.total !== undefined ? `${result.items.length} of ${result.total} items` : count2(result.items.length, "item")}${result.nextCursor ? ` · next: ${ctx.nextCommand ?? "praxis --help"}` : ""}`) + `
30114
30895
  `
30115
30896
  };
30116
30897
  case "object": {
@@ -30404,7 +31185,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
30404
31185
  }
30405
31186
 
30406
31187
  // src/main.ts
30407
- var version = "0.2.1-dev.077ed16";
31188
+ var version = "0.2.1-dev.22816e2";
30408
31189
  var commands = commandTree(operations);
30409
31190
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
30410
31191
  function route(argv) {