@deepraxis/cli 0.3.0-dev.27abe4e → 0.3.0-dev.3266b68

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
- 676 HTTP operations; 678 commands including aliases.
5
+ 677 HTTP operations; 679 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
 
@@ -418,12 +418,12 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
418
418
  | `praxis api media generation capability list` | `media.generation.capabilities.list` | GET `/media/v1/generation/capabilities` | |
419
419
  | `praxis api media image generate` | `media.images.generate` | POST `/media/v1/libraries/{library_id}/images/generations` | `--library`, `--prompt`, `--negative-prompt`, `--n`, `--size`, `--background`, `--output-format`, `--output`, `--seed`, `--model`, `--asset-folder`, `--understanding`, `--idempotency-key` |
420
420
  | `praxis api media library asset batch <library_id>` | `media.libraries.assets.batch` | POST `/media/v1/libraries/{library_id}/assets:batch` | `--reason` |
421
- | `praxis api media library asset create` | `media.libraries.assets.create` | POST `/media/v1/libraries/{library_id}/assets` | `--library`, `--file`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--resource-type`, `--type` |
421
+ | `praxis api media library asset create` | `media.libraries.assets.create` | POST `/media/v1/libraries/{library_id}/assets` | `--library`, `--file`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--type` |
422
422
  | `praxis api media library asset delete <asset_id>` | `media.libraries.assets.delete` | DELETE `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
423
423
  | `praxis api media library asset frame create` | `media.libraries.assets.frames.create` | POST `/media/v1/libraries/{library_id}/assets/{asset_id}/frames` | `--library`, `--asset`, `--at-micros`, `--width` |
424
424
  | `praxis api media library asset get <asset_id>` | `media.libraries.assets.retrieve` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
425
- | `praxis api media library asset import` | `media.libraries.assets.import.create` | POST `/media/v1/libraries/{library_id}/assets/import` | `--library`, `--file-id`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--resource-type`, `--type` |
426
- | `praxis api media library asset list` | `media.libraries.assets.list` | GET `/media/v1/libraries/{library_id}/assets` | `--library`, `--asset-folder`, `--resource-type`, `--material-type`, `--param-cursor`, `--param-limit` |
425
+ | `praxis api media library asset import` | `media.libraries.assets.import.create` | POST `/media/v1/libraries/{library_id}/assets/import` | `--library`, `--file-id`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--type` |
426
+ | `praxis api media library asset list` | `media.libraries.assets.list` | GET `/media/v1/libraries/{library_id}/assets` | `--library`, `--asset-folder`, `--material-type`, `--param-cursor`, `--param-limit` |
427
427
  | `praxis api media library asset reprocess <asset_id>` | `media.libraries.assets.reprocess.create` | POST `/media/v1/libraries/{library_id}/assets/{asset_id}/reprocess` | `--library`, `--kinds` |
428
428
  | `praxis api media library asset understanding list` | `media.libraries.assets.understandings.list` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}/understandings` | `--library`, `--asset`, `--include-superseded`, `--kind`, `--param-cursor`, `--param-limit` |
429
429
  | `praxis api media library asset update <asset_id>` | `media.libraries.assets.update` | PATCH `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library`, `--display-name`, `--asset-folder`, `--tags` |
@@ -519,10 +519,11 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
519
519
  | `praxis api organization feedback message list` | `organization.feedback.messages.list` | GET `/organization/v1/feedback/{id}/messages` | `--feedback`, `--param-limit`, `--page` |
520
520
  | `praxis api organization member list` | `organization.members.list` | GET `/organization/v1/members` | `--param-limit`, `--page` |
521
521
  | `praxis api organization usage list` | `organization.usage.list` | GET `/organization/v1/usage` | `--starting-at`, `--ending-at`, `--bucket-width`, `--time-zone`, `--group-by`, `--page` |
522
- | `praxis api sandbox command run <sandbox_id>` | `sandbox.sandboxes.commands.run` | POST `/sandbox/v1/sandboxes/{sandbox_id}/commands` | `--cmd`, `--background`, `--cwd`, `--timeout-ms` |
522
+ | `praxis api sandbox command run <sandbox_id>` | `sandbox.sandboxes.commands.run` | POST `/sandbox/v1/sandboxes/{sandbox_id}/commands` | `--cmd`, `--background`, `--cwd`, `--timeout-ms`, `--progress-timeout-ms` |
523
523
  | `praxis api sandbox connect <sandboxID>` | `sandbox.sandboxes.connect` | POST `/sandbox/v1/sandboxes/{sandboxID}/connect` | `--timeout`, `--memory` |
524
524
  | `praxis api sandbox create` | `sandbox.sandboxes.create` | POST `/sandbox/v1/sandboxes` | `--template-id`, `--timeout`, `--auto-pause`, `--auto-pause-memory`, `--allow-internet-access` |
525
525
  | `praxis api sandbox delete <sandboxID>` | `sandbox.sandboxes.delete` | DELETE `/sandbox/v1/sandboxes/{sandboxID}` | |
526
+ | `praxis api sandbox event sandbox get <sandboxID>` | `sandbox.events.sandboxes.retrieve` | GET `/sandbox/v1/events/sandboxes/{sandboxID}` | `--offset`, `--param-limit`, `--order-asc`, `--types` |
526
527
  | `praxis api sandbox extend <sandboxID>` | `sandbox.sandboxes.extend` | POST `/sandbox/v1/sandboxes/{sandboxID}/extend` | `--timeout` |
527
528
  | `praxis api sandbox file list` | `sandbox.sandboxes.files.list` | GET `/sandbox/v1/sandboxes/{sandbox_id}/files:list` | `--sandbox`, `--path` |
528
529
  | `praxis api sandbox file make-dir <sandbox_id>` | `sandbox.sandboxes.files.makeDir` | POST `/sandbox/v1/sandboxes/{sandbox_id}/files:makeDir` | `--path` |
package/dist/praxis.js CHANGED
@@ -7088,7 +7088,7 @@ across all toolsets allowed.`
7088
7088
  type: "array",
7089
7089
  itemType: "object",
7090
7090
  required: false,
7091
- 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, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. 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."
7091
+ 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, browser, ticket, crm, canvas or cut. The ticket service is bound by default: a service agent whose list has no ticket entry may call the ticket API, and {"type": "ticket", "enabled": false} removes it. Every other service stays closed until it is bound. An open service allows every public method of that service. 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 the default: the ticket service only. 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.`
7092
7092
  },
7093
7093
  {
7094
7094
  name: "kind",
@@ -21888,7 +21888,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
21888
21888
  resource: "media.libraries.assets",
21889
21889
  method: "list",
21890
21890
  summary: "List assets",
21891
- description: "Upload content into an active library and return a Cloudinary-compatible resource. Use file for a multipart file, data URI, public HTTPS URL or same-owner file identifier. Reusing public_id overwrites by default; overwrite=false returns the existing resource. Chunk uploads require both chunk headers.",
21891
+ description: "Upload content into an active library and return the stored asset. Use file for a multipart file, data URI, public HTTPS URL or same-owner file identifier. Reusing public_id overwrites by default; overwrite=false returns the existing asset. Chunk uploads require both chunk headers.",
21892
21892
  http: "GET",
21893
21893
  path: "/media/v1/libraries/{library_id}/assets",
21894
21894
  streaming: "no",
@@ -21907,17 +21907,6 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
21907
21907
  required: false,
21908
21908
  description: "Filter by the exact organizational folder path; an empty value selects assets at the root. Descendant folders are not included."
21909
21909
  },
21910
- {
21911
- name: "resource_type",
21912
- type: "string",
21913
- enum: [
21914
- "image",
21915
- "video",
21916
- "raw"
21917
- ],
21918
- required: false,
21919
- description: "image, video (including audio), raw; auto is accepted by Upload actions only, and listing with auto returns 400."
21920
- },
21921
21910
  {
21922
21911
  name: "material_type",
21923
21912
  type: "string",
@@ -21932,10 +21921,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
21932
21921
  "text_template",
21933
21922
  "animation_preset",
21934
21923
  "lut",
21935
- "transition_map"
21924
+ "transition_map",
21925
+ "file"
21936
21926
  ],
21937
21927
  required: false,
21938
- description: "Filter assets to one kind of material, independent of the stored resource_type. Omit to list every material type. Assets stored before this field existed match no material_type filter."
21928
+ description: "Filter assets to one kind of material. Audio is one material type; use audio_role to tell speech, music and sound effects apart. Omit to list every material type."
21939
21929
  },
21940
21930
  {
21941
21931
  name: "cursor",
@@ -22050,18 +22040,6 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22050
22040
  required: false,
22051
22041
  description: "Requires an image and visual understanding enabled in the library; otherwise returns UNSUPPORTED. Tagging is asynchronous."
22052
22042
  },
22053
- {
22054
- name: "resource_type",
22055
- type: "string",
22056
- enum: [
22057
- "image",
22058
- "video",
22059
- "raw",
22060
- "auto"
22061
- ],
22062
- required: false,
22063
- description: "Upload category: image for images, video for video or audio, raw for unprocessed files, or auto to detect the category. Defaults to auto."
22064
- },
22065
22043
  {
22066
22044
  name: "type",
22067
22045
  type: "string",
@@ -22173,18 +22151,6 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22173
22151
  required: false,
22174
22152
  description: "Minimum confidence for adding generated labels to tags, from 0 to 1 inclusive. Requires an image and enabled visual understanding; labels appear after processing completes."
22175
22153
  },
22176
- {
22177
- name: "resource_type",
22178
- type: "string",
22179
- enum: [
22180
- "image",
22181
- "video",
22182
- "raw",
22183
- "auto"
22184
- ],
22185
- required: false,
22186
- description: "Upload category: image for images, video for video or audio, raw for unprocessed files, or auto to detect the category. Defaults to auto."
22187
- },
22188
22154
  {
22189
22155
  name: "type",
22190
22156
  type: "string",
@@ -22301,7 +22267,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22301
22267
  resource: "media.assets",
22302
22268
  method: "edit",
22303
22269
  summary: "Edit asset",
22304
- description: "Edit an existing asset and store the result as a new asset. Use library_id from creation or listing and asset_id from asset creation or listing; library_id also accepts the literal default, which resolves to the organization’s default library before the credential check. The source asset is never overwritten: the new asset hangs under it in the edit chain, records it in derived_from, and reads back with assets.lineage, so earlier steps stay reachable. The body is operation plus the optional model, asset_folder, understanding and idempotency_key; operation.type selects the edit and carries that operation’s own fields. This release performs variations, inpaint, erase, replace_object, recolor, remove_background and replace_background on images; every other type in the operation vocabulary — the video and audio edits — is refused with OPERATION_NOT_SUPPORTED. inpaint takes mask, a PNG File identifier beginning with file- whose transparent area marks the region to replace, plus the prompt describing what belongs there. Aspects beyond the source asset’s material type return REFERENCE_TYPE_MISMATCH. Editing is charged through Router and the job records the charge in usage. The response is 202 with a queued Job whose type is image, whose operation is the edit applied, and whose source_asset_id is the asset edited; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until it is completed or failed, then read the produced asset. Example: POST /media/v1/libraries/lib_example/assets/9dfa312ef9bc4b00816339b598b1152c/edits with {\"operation\":{\"type\":\"variations\",\"strength\":\"subtle\"}}.",
22270
+ description: "Edit an existing asset and store the result as a new asset. Use library_id from creation or listing and asset_id from asset creation or listing; library_id also accepts the literal default, which resolves to the organization’s default library before the credential check. The source asset is never overwritten: the new asset hangs under it in the edit chain, records it in derived_from, and reads back with assets.lineage, so earlier steps stay reachable. The body is operation plus the optional model, asset_folder, understanding and idempotency_key; operation.type selects the edit and carries that operation’s own fields. This release performs variations, inpaint, erase, replace_object, recolor, remove_background and replace_background on images; every other type in the operation vocabulary — the video and audio edits — is refused with OPERATION_NOT_SUPPORTED. inpaint takes mask, a PNG File identifier beginning with file- whose transparent area marks the region to replace, plus the prompt describing what belongs there. Aspects beyond the source asset’s material type return REFERENCE_TYPE_MISMATCH. Editing is billed by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage. The response is 202 with a queued Job whose type is image, whose operation is the edit applied, and whose source_asset_id is the asset edited; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until it is completed or failed, then read the produced asset. Example: POST /media/v1/libraries/lib_example/assets/9dfa312ef9bc4b00816339b598b1152c/edits with {\"operation\":{\"type\":\"variations\",\"strength\":\"subtle\"}}.",
22305
22271
  http: "POST",
22306
22272
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}/edits",
22307
22273
  streaming: "no",
@@ -22332,7 +22298,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22332
22298
  name: "model",
22333
22299
  type: "string",
22334
22300
  required: false,
22335
- description: "Router model that performs the edit; omit it to use the library default image model."
22301
+ description: "Model that performs the edit; omit it to use the library default image model."
22336
22302
  },
22337
22303
  {
22338
22304
  name: "asset_folder",
@@ -22569,7 +22535,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22569
22535
  resource: "media.speech",
22570
22536
  method: "create",
22571
22537
  summary: "Create speech",
22572
- description: "Synthesise speech from text and store the recording straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still synthesise. input is the text to speak and voice is required; speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. A voice that names a voice material of this library is refused the same way — voice cloning opens with voices.create. The provider caps one request at a short stretch of text, so a long input is cut into segments at paragraph and sentence boundaries and synthesised in order, then joined into the single recording the library receives: nothing is spoken twice and nothing is dropped. Because the segments are joined byte for byte, a multi-segment input accepts only response_format mp3 (the default) or pcm; opus is available for a single-segment input. A speech job has one result however many segments it took. Synthesis is charged through Router and the job records the charge in usage; a request refused before it starts costs nothing. The response is 202 with a queued Job whose type is speech and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced asset from the library — the recording carries material_type audio, audio_role voice, ai_generated true, and provenance naming this job, the text spoken and the model. Send Idempotency-Key, or idempotency_key in the body, to retry without synthesising and charging twice. Example: POST /media/v1/libraries/default/audio/speech with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"alloy\"}.",
22538
+ description: "Synthesise speech from text and store the recording straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still synthesise. input is the text to speak and voice is required; speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. A voice that names a voice material of this library is refused the same way — voice cloning opens with voices.create. The provider caps one request at a short stretch of text, so a long input is cut into segments at paragraph and sentence boundaries and synthesised in order, then joined into the single recording the library receives: nothing is spoken twice and nothing is dropped. Because the segments are joined byte for byte, a multi-segment input accepts only response_format mp3 (the default) or pcm; opus is available for a single-segment input. A speech job has one result however many segments it took. Synthesis is billed by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage; a request refused before it starts costs nothing. The response is 202 with a queued Job whose type is speech and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced asset from the library — the recording carries material_type audio, audio_role voice, ai_generated true, and provenance naming this job, the text spoken and the model. Send Idempotency-Key, or idempotency_key in the body, to retry without synthesising and charging twice. Example: POST /media/v1/libraries/default/audio/speech with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"alloy\"}.",
22573
22539
  http: "POST",
22574
22540
  path: "/media/v1/libraries/{library_id}/audio/speech",
22575
22541
  streaming: "no",
@@ -22801,7 +22767,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22801
22767
  resource: "media.images",
22802
22768
  method: "generate",
22803
22769
  summary: "Generate image",
22804
- description: "Generate one or more images from a text prompt and store them straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still generate. The request body is the image request itself: prompt is required, and n, size, background, output_format, output, references, seed, model, asset_folder and understanding are optional. Set output to sticker for a cut-out with a transparent background. references attach existing assets with a role — edit_target, style, structure or subject — and a model that cannot honour a role returns REFERENCE_TYPE_MISMATCH. Aspect ratio is not accepted for images; name size instead. Generation is charged through Router and the job records the charge in usage; nothing is charged for a request refused before it starts. The response is 202 with a queued Job whose type is image and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced assets from the library. Send Idempotency-Key, or idempotency_key in the body, to retry without generating and charging twice. Example: POST /media/v1/libraries/default/images/generations with {\"prompt\":\"A red kite above a calm sea at sunrise\",\"n\":1,\"output\":\"sticker\"}.",
22770
+ description: "Generate one or more images from a text prompt and store them straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still generate. The request body is the image request itself: prompt is required, and n, size, background, output_format, output, references, seed, model, asset_folder and understanding are optional. Set output to sticker for a cut-out with a transparent background. references attach existing assets with a role — edit_target, style, structure or subject — and a model that cannot honour a role returns REFERENCE_TYPE_MISMATCH. Aspect ratio is not accepted for images; name size instead. Generation is billed by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage; nothing is charged for a request refused before it starts. The response is 202 with a queued Job whose type is image and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced assets from the library. Send Idempotency-Key, or idempotency_key in the body, to retry without generating and charging twice. Example: POST /media/v1/libraries/default/images/generations with {\"prompt\":\"A red kite above a calm sea at sunrise\",\"n\":1,\"output\":\"sticker\"}.",
22805
22771
  http: "POST",
22806
22772
  path: "/media/v1/libraries/{library_id}/images/generations",
22807
22773
  streaming: "no",
@@ -22821,7 +22787,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22821
22787
  name: "prompt",
22822
22788
  type: "string",
22823
22789
  required: true,
22824
- description: "Text prompt describing the image to generate; Router forwards it to the image model unchanged."
22790
+ description: "Text prompt describing the image to generate; the image model receives it unchanged."
22825
22791
  },
22826
22792
  {
22827
22793
  name: "negative_prompt",
@@ -22839,7 +22805,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22839
22805
  name: "size",
22840
22806
  type: "string",
22841
22807
  required: false,
22842
- description: "Requested pixel size written as width x height. Router validates it against the chosen model and rejects an unsupported size with INVALID_PARAMS."
22808
+ description: "Requested pixel size written as width x height. The chosen model is validated against it and an unsupported size is rejected with INVALID_PARAMS."
22843
22809
  },
22844
22810
  {
22845
22811
  name: "background",
@@ -22878,7 +22844,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22878
22844
  type: "array",
22879
22845
  itemType: "object",
22880
22846
  required: false,
22881
- description: "Existing assets the model may use, each with the role it plays. Router answers REFERENCE_TYPE_MISMATCH when the chosen model cannot honour a role."
22847
+ description: "Existing assets the model may use, each with the role it plays. A chosen model that cannot honour a role answers REFERENCE_TYPE_MISMATCH."
22882
22848
  },
22883
22849
  {
22884
22850
  name: "seed",
@@ -22890,7 +22856,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22890
22856
  name: "model",
22891
22857
  type: "string",
22892
22858
  required: false,
22893
- description: "Router model with image-generation capability; omit it to use the library default image model."
22859
+ description: "Model with image-generation capability; omit it to use the library default image model."
22894
22860
  },
22895
22861
  {
22896
22862
  name: "asset_folder",
@@ -23108,10 +23074,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23108
23074
  "text_template",
23109
23075
  "animation_preset",
23110
23076
  "lut",
23111
- "transition_map"
23077
+ "transition_map",
23078
+ "file"
23112
23079
  ],
23113
23080
  required: false,
23114
- description: "What this asset is as a reusable material, as opposed to resource_type (its stored file category). Omitted on assets stored before this field existed and on raw assets that are not materials."
23081
+ description: "What this asset is as a reusable material. Always present: a file whose specific kind cannot be identified is file."
23115
23082
  }
23116
23083
  ]
23117
23084
  }
@@ -23177,7 +23144,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23177
23144
  type: "array",
23178
23145
  itemType: "string",
23179
23146
  enum: [
23180
- "resource_type",
23147
+ "material_type",
23181
23148
  "format",
23182
23149
  "asset_folder",
23183
23150
  "processing_state"
@@ -23250,10 +23217,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23250
23217
  "text_template",
23251
23218
  "animation_preset",
23252
23219
  "lut",
23253
- "transition_map"
23220
+ "transition_map",
23221
+ "file"
23254
23222
  ],
23255
23223
  required: false,
23256
- description: "What this asset is as a reusable material, as opposed to resource_type (its stored file category). Omitted on assets stored before this field existed and on raw assets that are not materials."
23224
+ description: "What this asset is as a reusable material. Always present: a file whose specific kind cannot be identified is file."
23257
23225
  }
23258
23226
  ]
23259
23227
  }
@@ -23370,7 +23338,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23370
23338
  resource: "media.videos",
23371
23339
  method: "generate",
23372
23340
  summary: "Generate video",
23373
- description: "Generate one or more videos from a text prompt and store them straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still generate. mode says what the video is anchored to: text needs only a prompt, image animates the existing image named by first_frame, and first_last interpolates between first_frame and last_frame. The frames must be image or sticker assets of the same library; Router is sent a fetchable URL for each, recorded in the produced asset’s provenance. mode reference and output gif are refused with OPERATION_NOT_SUPPORTED in this release, and negative_prompt, references and an unknown mode are refused before anything is charged. Every output lands in the library as a video asset as soon as it is ready — there is no candidate state and nothing expires, so outputs.save is not part of this lane. Generation is charged per second through Router and the job records the charge in usage; a refused request costs nothing. The response is 202 with a queued Job whose type is video and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced assets from the library. Send Idempotency-Key, or idempotency_key in the body, to retry without generating and charging twice. Example: POST /media/v1/libraries/default/videos/generations with {\"prompt\":\"A red kite above a calm sea at sunrise\",\"mode\":\"text\",\"n\":1}.",
23341
+ description: "Generate one or more videos from a text prompt and store them straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still generate. mode says what the video is anchored to: text needs only a prompt, image animates the existing image named by first_frame, and first_last interpolates between first_frame and last_frame. The frames must be image or sticker assets of the same library; a fetchable URL for each is sent to the model and recorded in the produced asset’s provenance. mode reference and output gif are refused with OPERATION_NOT_SUPPORTED in this release, and negative_prompt, references and an unknown mode are refused before anything is charged. Every output lands in the library as a video asset as soon as it is ready — there is no candidate state and nothing expires, so outputs.save is not part of this lane. Generation is billed per second by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage; a refused request costs nothing. The response is 202 with a queued Job whose type is video and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced assets from the library. Send Idempotency-Key, or idempotency_key in the body, to retry without generating and charging twice. Example: POST /media/v1/libraries/default/videos/generations with {\"prompt\":\"A red kite above a calm sea at sunrise\",\"mode\":\"text\",\"n\":1}.",
23374
23342
  http: "POST",
23375
23343
  path: "/media/v1/libraries/{library_id}/videos/generations",
23376
23344
  streaming: "no",
@@ -23390,7 +23358,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23390
23358
  name: "prompt",
23391
23359
  type: "string",
23392
23360
  required: true,
23393
- description: "Text prompt describing the video to generate; Router forwards it to the video model unchanged."
23361
+ description: "Text prompt describing the video to generate; the video model receives it unchanged."
23394
23362
  },
23395
23363
  {
23396
23364
  name: "negative_prompt",
@@ -23433,7 +23401,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23433
23401
  name: "duration_seconds",
23434
23402
  type: "integer",
23435
23403
  required: false,
23436
- description: "Requested video length in seconds. Router validates it against the chosen model’s supported durations and rejects an unsupported value with INVALID_PARAMS."
23404
+ description: "Requested video length in seconds. The chosen model’s supported durations are validated against it and an unsupported value is rejected with INVALID_PARAMS."
23437
23405
  },
23438
23406
  {
23439
23407
  name: "resolution",
@@ -23445,13 +23413,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23445
23413
  "4k"
23446
23414
  ],
23447
23415
  required: false,
23448
- description: "Requested output resolution; Router validates it against the chosen model."
23416
+ description: "Requested output resolution, validated against the chosen model."
23449
23417
  },
23450
23418
  {
23451
23419
  name: "aspect_ratio",
23452
23420
  type: "string",
23453
23421
  required: false,
23454
- description: "Output aspect ratio written as width:height; defaults to 16:9. Router validates it against the chosen model and rejects an unsupported ratio with INVALID_PARAMS."
23422
+ description: "Output aspect ratio written as width:height; defaults to 16:9. The chosen model is validated against it and an unsupported ratio is rejected with INVALID_PARAMS."
23455
23423
  },
23456
23424
  {
23457
23425
  name: "generate_audio",
@@ -23485,7 +23453,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
23485
23453
  name: "model",
23486
23454
  type: "string",
23487
23455
  required: false,
23488
- description: "Router model with video-generation capability; omit it to use the library default video model."
23456
+ description: "Model with video-generation capability; omit it to use the library default video model."
23489
23457
  },
23490
23458
  {
23491
23459
  name: "asset_folder",
@@ -25149,7 +25117,9 @@ for more details.`
25149
25117
  "openai.images.generations",
25150
25118
  "openai.responses",
25151
25119
  "openai.videos",
25152
- "typesafe.systemone"
25120
+ "typesafe.systemone",
25121
+ "volcengine.music",
25122
+ "volcengine.voice_clone"
25153
25123
  ],
25154
25124
  required: false,
25155
25125
  description: "Match any comma-separated declared protocol ID; omitted or empty includes all models. Combined with type and output_modalities using AND. Invalid IDs return 400 with all legal values."
@@ -27037,6 +27007,50 @@ for more details.`
27037
27007
  }
27038
27008
  ]
27039
27009
  },
27010
+ {
27011
+ resource: "sandbox.events.sandboxes",
27012
+ method: "retrieve",
27013
+ summary: "Get sandbox events",
27014
+ description: "Read one sandbox's lifecycle events, newest first by default. Unlike every other read on this face, it answers for a sandbox whose machine has ENDED (killed or failed) — a sandbox's cause of death is readable here even after its files are gone. The killed event carries eventData.terminationReason (the platform's own reason: requested, lease_expired, max_running, provider_lost, start_failed, retention, admin, unknown) and eventData.kill_reason (the E2B-shaped bucket: request, timeout, admin, orphaned, unknown); the updated event carries expiresAt. Page with offset, limit (1–100, default 10), orderAsc and repeatable types. An ended sandbox that is never going to come back also answers SANDBOX_EXPIRED (410) with terminationReason on its files and commands.",
27015
+ http: "GET",
27016
+ path: "/sandbox/v1/events/sandboxes/{sandboxID}",
27017
+ streaming: "no",
27018
+ pagination: false,
27019
+ pathParams: [
27020
+ {
27021
+ name: "sandboxID",
27022
+ sdkName: "sandboxID",
27023
+ description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404."
27024
+ }
27025
+ ],
27026
+ query: [
27027
+ {
27028
+ name: "offset",
27029
+ type: "integer",
27030
+ required: false,
27031
+ description: "Number of the newest events to skip before collecting the page; omit to start at the first one. Use it with limit to walk pages: the next page is offset + limit."
27032
+ },
27033
+ {
27034
+ name: "limit",
27035
+ type: "integer",
27036
+ required: false,
27037
+ description: "Page size from 1 to 100; defaults to 10. A larger value returns INVALID_PARAMS rather than being clipped."
27038
+ },
27039
+ {
27040
+ name: "orderAsc",
27041
+ type: "boolean",
27042
+ required: false,
27043
+ description: "true returns the oldest event first, false or omitted returns the newest first. Only the literal spellings true and false are accepted."
27044
+ },
27045
+ {
27046
+ name: "types",
27047
+ type: "array",
27048
+ itemType: "string",
27049
+ required: false,
27050
+ description: "Filter events to the provided event types"
27051
+ }
27052
+ ]
27053
+ },
27040
27054
  {
27041
27055
  resource: "sandbox.sandboxes",
27042
27056
  method: "list",
@@ -27730,6 +27744,12 @@ for more details.`
27730
27744
  type: "integer",
27731
27745
  required: false,
27732
27746
  description: "Execution timeout in milliseconds, from 1 to 3600000 (1 hour); defaults to 600000 (10 minutes). In background mode this limits process runtime; expiry records exit code 124."
27747
+ },
27748
+ {
27749
+ name: "progressTimeoutMs",
27750
+ type: "integer",
27751
+ required: false,
27752
+ description: "Foreground commands only, off by default: end this command once it goes this many milliseconds (1000 to 3600000) without writing a single byte to stdout or stderr, and answer COMMAND_NO_PROGRESS (504) with the output received so far and lastOutputAt. The sandbox itself keeps running, so decide afterwards whether to read what it produced or stop it with DELETE. A slow command that keeps producing output is never ended by it; if the program buffers its output, turn buffering off first, for example PYTHONUNBUFFERED=1 or stdbuf -oL. Passing it together with background true is refused with INVALID_PARAMS."
27733
27753
  }
27734
27754
  ]
27735
27755
  }
@@ -42171,6 +42191,38 @@ var getSandboxV1SandboxesBySandboxIdLogs = (options) => (options.client ?? clien
42171
42191
  url: "/sandbox/v1/sandboxes/{sandboxID}/logs",
42172
42192
  ...options
42173
42193
  });
42194
+ var getSandboxEvents = (options) => (options.client ?? client).get({
42195
+ security: [
42196
+ {
42197
+ key: "sandbox-ApiKeyAuth",
42198
+ name: "X-API-Key",
42199
+ type: "apiKey"
42200
+ },
42201
+ {
42202
+ key: "sandbox-AuthProviderBearerAuth",
42203
+ scheme: "bearer",
42204
+ type: "http"
42205
+ },
42206
+ {
42207
+ key: "sandbox-AuthProviderTeamAuth",
42208
+ name: "X-Team-ID",
42209
+ type: "apiKey"
42210
+ },
42211
+ { name: "X-Admin-Token", type: "apiKey" },
42212
+ {
42213
+ key: "sandbox-AdminTeamAuth",
42214
+ name: "X-Team-ID",
42215
+ type: "apiKey"
42216
+ },
42217
+ {
42218
+ key: "sandbox-AdminJWTAuth",
42219
+ scheme: "bearer",
42220
+ type: "http"
42221
+ }
42222
+ ],
42223
+ url: "/sandbox/v1/events/sandboxes/{sandboxID}",
42224
+ ...options
42225
+ });
42174
42226
  var startTemplateBuild = (options) => (options.client ?? client).post({
42175
42227
  security: [
42176
42228
  {
@@ -45382,6 +45434,11 @@ function createOrganization(transport) {
45382
45434
  }
45383
45435
  function createSandbox(transport) {
45384
45436
  return {
45437
+ events: {
45438
+ sandboxes: {
45439
+ retrieve: bind(transport, getSandboxEvents)
45440
+ }
45441
+ },
45385
45442
  sandboxes: {
45386
45443
  commands: {
45387
45444
  run: bind(transport, runSandboxCommand)
@@ -50127,7 +50184,8 @@ function connectorGeometry(from, to, opts = {}) {
50127
50184
  if (cum[i] > start + EPSILON && cum[i] < end - EPSILON)
50128
50185
  run.push(points[i]);
50129
50186
  run.push(pointAt(points, cum, end));
50130
- parts.push(run.map((p, i) => `${i ? "L" : "M"}${n(local(p).x)} ${n(local(p).y)}`).join(""));
50187
+ const traced = run.length > 2 ? [...run, ...run.slice(0, -1).reverse()] : run;
50188
+ parts.push(traced.map((p, i) => `${i ? "L" : "M"}${n(local(p).x)} ${n(local(p).y)}`).join(""));
50131
50189
  }
50132
50190
  for (const head of arrowHeads) {
50133
50191
  const t = local(head.tip);
@@ -52850,7 +52908,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
52850
52908
  }
52851
52909
 
52852
52910
  // src/main.ts
52853
- var version = "0.3.0-dev.27abe4e";
52911
+ var version = "0.3.0-dev.3266b68";
52854
52912
  var commands = commandTree(operations);
52855
52913
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
52856
52914
  function route(argv) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/cli",
3
- "version": "0.3.0-dev.27abe4e",
3
+ "version": "0.3.0-dev.3266b68",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "praxis": "dist/praxis.js"