@deepraxis/cli 0.2.1-dev.7d20ab6 → 0.2.1-dev.b3b65e8

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
- 524 HTTP operations; 526 commands including aliases.
5
+ 525 HTTP operations; 527 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
 
@@ -359,6 +359,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
359
359
  | `praxis api media library asset batch <library_id>` | `media.libraries.assets.batch` | POST `/media/v1/libraries/{library_id}/assets:batch` | `--reason` |
360
360
  | `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` |
361
361
  | `praxis api media library asset delete <asset_id>` | `media.libraries.assets.delete` | DELETE `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
362
+ | `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` |
362
363
  | `praxis api media library asset get <asset_id>` | `media.libraries.assets.retrieve` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
363
364
  | `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` |
364
365
  | `praxis api media library asset list` | `media.libraries.assets.list` | GET `/media/v1/libraries/{library_id}/assets` | `--library`, `--asset-folder`, `--resource-type`, `--param-cursor`, `--param-limit` |
package/dist/praxis.js CHANGED
@@ -11888,7 +11888,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11888
11888
  resource: "knowledge.vectorStores",
11889
11889
  method: "create",
11890
11890
  summary: "Create knowledge base",
11891
- 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"}.',
11891
+ 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. PDF files accept up to 536870912 bytes (512 MiB), while other formats accept up to 52428800 bytes (50 MiB), constrained by Router conversion; every file is limited to 5000000 estimated tokens; each account holds up to 100 active/nondeleted stores. Minimal body: {"name":"Refund policies"}.',
11892
11892
  http: "POST",
11893
11893
  path: "/knowledge/v1/vector_stores",
11894
11894
  streaming: "no",
@@ -11927,7 +11927,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11927
11927
  name: "chunking_strategy",
11928
11928
  type: "object",
11929
11929
  required: false,
11930
- description: "auto resolves to static with 800 estimated tokens and 400 overlap tokens. Unlike OpenAI vector stores, token counts are estimates; each Han character counts as one, and other whitespace-delimited words count as their UTF-16 length divided by four, rounded up."
11930
+ description: "Native attachment strategy. auto uses static chunks of 800 estimated tokens with 400 overlap; static supplies explicit chunk sizes; hierarchical indexes child chunks and supplies bounded parent context. Existing attachments are reused unchanged; remove and reattach a file to change its strategy."
11931
11931
  },
11932
11932
  {
11933
11933
  name: "description",
@@ -12274,7 +12274,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12274
12274
  resource: "knowledge.vectorStores.files",
12275
12275
  method: "create",
12276
12276
  summary: "Add file",
12277
- 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.",
12277
+ description: "Attach an uploaded File for asynchronous ingestion, then poll this attachment until status is completed, failed or cancelled before searching. PDF files accept up to 536870912 bytes (512 MiB), while other formats accept up to 52428800 bytes (50 MiB), constrained by Router conversion; every file is limited to 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.",
12278
12278
  http: "POST",
12279
12279
  path: "/knowledge/v1/vector_stores/{vector_store_id}/files",
12280
12280
  streaming: "no",
@@ -12306,7 +12306,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12306
12306
  name: "chunking_strategy",
12307
12307
  type: "object",
12308
12308
  required: false,
12309
- description: "auto resolves to static with 800 estimated tokens and 400 overlap tokens. Unlike OpenAI vector stores, token counts are estimates; each Han character counts as one, and other whitespace-delimited words count as their UTF-16 length divided by four, rounded up."
12309
+ description: "Native attachment strategy. auto uses static chunks of 800 estimated tokens with 400 overlap; static supplies explicit chunk sizes; hierarchical indexes child chunks and supplies bounded parent context. Existing attachments are reused unchanged; remove and reattach a file to change its strategy."
12310
12310
  }
12311
12311
  ]
12312
12312
  }
@@ -12617,7 +12617,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12617
12617
  resource: "media.libraries",
12618
12618
  method: "list",
12619
12619
  summary: "List libraries",
12620
- description: "List libraries owned by the caller, newest first. By default, deleting and deleted libraries are excluded; use status=deleting to find libraries awaiting purge. All supplied label pairs must match.",
12620
+ description: "Read a caller-owned library’s current settings, usage and lifecycle status. A deleting library remains readable; missing, foreign or purged libraries return LIBRARY_NOT_FOUND.",
12621
12621
  http: "GET",
12622
12622
  path: "/media/v1/libraries",
12623
12623
  streaming: "no",
@@ -12699,7 +12699,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12699
12699
  resource: "media.libraries",
12700
12700
  method: "delete",
12701
12701
  summary: "Delete library",
12702
- description: "Soft-delete an active library, returning its deleting status and purge_at deadline. Asset operations and delivery become unavailable; the library can be restored before purge_at. Repeated deletion while deleting returns the current library.",
12702
+ description: "Restore a deleting library before its purge_at deadline. The library becomes active again and deleted_at and purge_at are cleared; expired or non-deleting libraries cannot be restored.",
12703
12703
  http: "DELETE",
12704
12704
  path: "/media/v1/libraries/{library_id}",
12705
12705
  streaming: "no",
@@ -12717,7 +12717,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12717
12717
  resource: "media.libraries",
12718
12718
  method: "retrieve",
12719
12719
  summary: "Get library",
12720
- description: "Read a caller-owned library’s current settings, usage and lifecycle status. A deleting library remains readable; missing, foreign or purged libraries return LIBRARY_NOT_FOUND.",
12720
+ description: "Update an active library’s supplied settings. Labels replace the complete map; understanding settings and model roles merge with current values. Changing the embedding model is rejected while assets exist.",
12721
12721
  http: "GET",
12722
12722
  path: "/media/v1/libraries/{library_id}",
12723
12723
  streaming: "no",
@@ -12789,7 +12789,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12789
12789
  resource: "media.libraries.assets",
12790
12790
  method: "list",
12791
12791
  summary: "List assets",
12792
- description: "List assets in an active library, newest first, optionally filtering by exact folder and stored resource type. Continue using next_cursor; video includes audio-only assets.",
12792
+ 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.",
12793
12793
  http: "GET",
12794
12794
  path: "/media/v1/libraries/{library_id}/assets",
12795
12795
  streaming: "no",
@@ -12837,7 +12837,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12837
12837
  resource: "media.libraries.assets",
12838
12838
  method: "create",
12839
12839
  summary: "Upload asset",
12840
- 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.",
12840
+ description: " For understanding, Media generates proxies for video or audio sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.",
12841
12841
  http: "POST",
12842
12842
  path: "/media/v1/libraries/{library_id}/assets",
12843
12843
  streaming: "no",
@@ -12882,7 +12882,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12882
12882
  name: "asset_folder",
12883
12883
  type: "string",
12884
12884
  required: false,
12885
- description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected."
12885
+ description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out."
12886
12886
  },
12887
12887
  {
12888
12888
  name: "use_filename",
@@ -12961,7 +12961,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12961
12961
  resource: "media.libraries.assets.import",
12962
12962
  method: "create",
12963
12963
  summary: "Import file",
12964
- description: "Copy a File into an independent Media asset. Defaults to public delivery (type=upload); use type=authenticated for private originals and derivatives. Deleting the source File does not delete this copy.",
12964
+ description: "Copy a File into an independent Media asset. New assets default to organization-private delivery (type=authenticated); explicitly set type=upload for public originals and derivatives. Omitting type on overwrite preserves the current type. Deleting the source File does not delete this copy. For understanding, Media generates proxies for video or audio sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.",
12965
12965
  http: "POST",
12966
12966
  path: "/media/v1/libraries/{library_id}/assets/import",
12967
12967
  streaming: "no",
@@ -12981,7 +12981,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
12981
12981
  name: "file_id",
12982
12982
  type: "string",
12983
12983
  required: true,
12984
- description: "File ID to copy into this library instead of file bytes. This independent copy defaults to public delivery; set type=authenticated for private delivery. Deleting the source File does not delete this asset."
12984
+ description: "File ID to copy into this library instead of file bytes. This independent copy defaults to organization-private delivery (type=authenticated); explicitly set type=upload for public delivery. Deleting the source File does not delete this asset."
12985
12985
  },
12986
12986
  {
12987
12987
  name: "public_id",
@@ -13005,7 +13005,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13005
13005
  name: "asset_folder",
13006
13006
  type: "string",
13007
13007
  required: false,
13008
- description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected."
13008
+ description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out."
13009
13009
  },
13010
13010
  {
13011
13011
  name: "use_filename",
@@ -13084,7 +13084,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13084
13084
  resource: "media.libraries.assets",
13085
13085
  method: "delete",
13086
13086
  summary: "Delete asset",
13087
- description: "Delete an asset from the library so it is no longer readable, searchable or deliverable. This removes the asset rather than placing it in the library’s restoration window; a missing asset returns ASSET_NOT_FOUND.",
13087
+ description: "Queue reprocessing of the asset’s current version and return its updated state immediately. Omit kinds to retry failed tasks and legacy source-size unsupported tasks; explicit kinds rerun applicable completed tasks and recoverable source-size unsupported tasks. Other unsupported causes remain unchanged. Replaced understandings become superseded, and processing finishes asynchronously.",
13088
13088
  http: "DELETE",
13089
13089
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}",
13090
13090
  streaming: "no",
@@ -13107,7 +13107,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13107
13107
  resource: "media.libraries.assets",
13108
13108
  method: "retrieve",
13109
13109
  summary: "Get asset",
13110
- description: "Read a non-deleted asset by its asset_id in an active library, including content hashes, processing progress and available previews. Missing or deleted assets return ASSET_NOT_FOUND.",
13110
+ description: "Update an asset’s supplied metadata fields. Tags and context replace their current collections; an empty collection clears them. Moving asset_folder or changing display_name preserves public_id and delivery URLs.",
13111
13111
  http: "GET",
13112
13112
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}",
13113
13113
  streaming: "no",
@@ -13130,7 +13130,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13130
13130
  resource: "media.libraries.assets",
13131
13131
  method: "update",
13132
13132
  summary: "Update asset",
13133
- description: "Update an asset’s supplied metadata fields. Tags and context replace their current collections; an empty collection clears them. Moving asset_folder or changing display_name preserves public_id and delivery URLs.",
13133
+ description: "Delete an asset from the library so it is no longer readable, searchable or deliverable. This removes the asset rather than placing it in the library’s restoration window; a missing asset returns ASSET_NOT_FOUND.",
13134
13134
  http: "PATCH",
13135
13135
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}",
13136
13136
  streaming: "no",
@@ -13161,7 +13161,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13161
13161
  name: "asset_folder",
13162
13162
  type: "string",
13163
13163
  required: false,
13164
- description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected."
13164
+ description: "Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out."
13165
13165
  },
13166
13166
  {
13167
13167
  name: "tags",
@@ -13179,11 +13179,57 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13179
13179
  ]
13180
13180
  }
13181
13181
  },
13182
+ {
13183
+ resource: "media.libraries.assets.frames",
13184
+ method: "create",
13185
+ summary: "Create frame URLs",
13186
+ description: 'Media creates JPEG frame URLs for inspecting one or more moments in a video without downloading the original. Obtain library_id from libraries and asset_id plus duration from assets. Send 1–20 integer microsecond timestamps strictly below duration, for example {"at_micros":[0,1000000],"width":640}. Only video assets are supported; audio and images return INVALID_PARAMS. Width defaults to 640 and accepts 160, 320 or 640. This read operation does not store a new asset or rerun understanding. Fetch each returned URL to obtain the frame; delivery usage follows media pricing. Authenticated links expire after 300 seconds; upload links remain public and permanent. Reissue expired links. Foreign libraries and assets return 404 without revealing their existence.',
13187
+ http: "POST",
13188
+ path: "/media/v1/libraries/{library_id}/assets/{asset_id}/frames",
13189
+ streaming: "no",
13190
+ pagination: false,
13191
+ pathParams: [
13192
+ {
13193
+ name: "library_id",
13194
+ sdkName: "library_id",
13195
+ description: "Library identifier returned by library creation or listing; must be accessible to the current credential."
13196
+ },
13197
+ {
13198
+ name: "asset_id",
13199
+ sdkName: "asset_id",
13200
+ description: "Video asset identifier returned by asset upload or listing in this library; read its duration before choosing timestamps."
13201
+ }
13202
+ ],
13203
+ query: [],
13204
+ body: {
13205
+ required: true,
13206
+ fields: [
13207
+ {
13208
+ name: "at_micros",
13209
+ type: "array",
13210
+ itemType: "integer",
13211
+ required: true,
13212
+ description: "One to twenty timestamps in microseconds from the start of the video. Each must be a nonnegative safe integer strictly below the video duration; order and duplicates are preserved."
13213
+ },
13214
+ {
13215
+ name: "width",
13216
+ type: "integer",
13217
+ enum: [
13218
+ 160,
13219
+ 320,
13220
+ 640
13221
+ ],
13222
+ required: false,
13223
+ description: "Maximum JPEG width in pixels: 160 is a small thumbnail, 320 a preview and 640 a larger preview. Defaults to 640; larger widths are unavailable."
13224
+ }
13225
+ ]
13226
+ }
13227
+ },
13182
13228
  {
13183
13229
  resource: "media.libraries.assets.reprocess",
13184
13230
  method: "create",
13185
13231
  summary: "Reprocess asset",
13186
- description: "Queue reprocessing of the asset’s current version and return its updated state immediately. Omit kinds to retry failed tasks; explicit kinds rerun applicable completed tasks. Replaced understandings become superseded, and processing finishes asynchronously.",
13232
+ description: " For understanding, Media generates proxies for video or audio sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.",
13187
13233
  http: "POST",
13188
13234
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}/reprocess",
13189
13235
  streaming: "no",
@@ -13215,7 +13261,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13215
13261
  "embedding"
13216
13262
  ],
13217
13263
  required: false,
13218
- description: "Processing tasks to rerun. Omit to retry failed tasks only; explicit kinds rerun applicable ready, failed or unsupported tasks. Pending and running tasks are unchanged; an empty array does nothing."
13264
+ description: "Processing tasks to rerun. Omit to retry failed tasks and legacy source-size unsupported tasks; explicit kinds rerun applicable ready or failed tasks and recoverable source-size unsupported tasks. Other unsupported causes remain unchanged. Pending and running tasks are unchanged; an empty array does nothing."
13219
13265
  }
13220
13266
  ]
13221
13267
  }
@@ -13258,10 +13304,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13258
13304
  "transcript",
13259
13305
  "frame",
13260
13306
  "overview",
13307
+ "audio",
13261
13308
  "embedding"
13262
13309
  ],
13263
13310
  required: false,
13264
- description: "Return one output kind: caption is a visual description, tags are generated labels, ocr is visible text, transcript is speech, frame is a video shot, overview is a video summary, and embedding reports a failed embedding step."
13311
+ description: "Return one output kind: caption is a visual description, tags are generated labels, ocr is visible text, transcript is speech, frame is a video shot, overview is a video summary, audio is sampled audio understanding, and embedding reports a failed embedding step."
13265
13312
  },
13266
13313
  {
13267
13314
  name: "cursor",
@@ -13281,7 +13328,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13281
13328
  resource: "media.libraries.assets",
13282
13329
  method: "batch",
13283
13330
  summary: "Batch assets alias",
13284
- description: 'Queue a frozen selection for tagging, untagging, context replacement, moving, deleting or reprocessing. IDs are limited to 1000; use an expression for larger selections, subject to the search scan budget. reprocess starts at most 30 assets per rolling minute per library. Only retryable failed steps rerun. Omit kinds to inspect all failed steps, or supply kinds to narrow them. Unsupported, permanent and completed steps remain unchanged and do not block other retryable steps on the same asset. Assets without any selected retryable failed step count as failed items without starting understanding. Poll the returned job id; done counts accepted launches, not successful model inference. Staff Admin only permits reprocess and requires a nonblank reason. Example: {"action":"reprocess","selector":{"expression":"processing_state=failed AND failure_code=UPSTREAM_FAILED"}}.',
13331
+ description: 'Queue a frozen selection for tagging, untagging, context replacement, moving, deleting or reprocessing. IDs are limited to 1000; use an expression for larger selections, subject to the search scan budget. reprocess starts at most 30 assets per rolling minute per library. Only retryable failed steps and legacy source-size unsupported steps rerun. Omit kinds to inspect all recoverable steps, or supply kinds to narrow them. Other unsupported, permanent and completed steps remain unchanged; a permanent output blocks only its own step. Assets without any selected recoverable step count as failed items without starting understanding. Poll the returned job id; done counts accepted launches, not successful model inference. Staff Admin only permits reprocess and requires a nonblank reason. Example: {"action":"reprocess","selector":{"expression":"processing_state=failed AND failure_code=UPSTREAM_FAILED"}}. For understanding, Media generates proxies for video or audio sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.',
13285
13332
  http: "POST",
13286
13333
  path: "/media/v1/libraries/{library_id}/assets:batch",
13287
13334
  streaming: "no",
@@ -13316,7 +13363,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13316
13363
  resource: "media.libraries.batches",
13317
13364
  method: "create",
13318
13365
  summary: "Create batch",
13319
- description: 'Queue a frozen selection for tagging, untagging, context replacement, moving, deleting or reprocessing. IDs are limited to 1000; use an expression for larger selections, subject to the search scan budget. reprocess starts at most 30 assets per rolling minute per library. Only retryable failed steps rerun. Omit kinds to inspect all failed steps, or supply kinds to narrow them. Unsupported, permanent and completed steps remain unchanged and do not block other retryable steps on the same asset. Assets without any selected retryable failed step count as failed items without starting understanding. Poll the returned job id; done counts accepted launches, not successful model inference. Staff Admin only permits reprocess and requires a nonblank reason. Example: {"action":"reprocess","selector":{"expression":"processing_state=failed AND failure_code=UPSTREAM_FAILED"}}.',
13366
+ description: 'Queue a frozen selection for tagging, untagging, context replacement, moving, deleting or reprocessing. IDs are limited to 1000; use an expression for larger selections, subject to the search scan budget. reprocess starts at most 30 assets per rolling minute per library. Only retryable failed steps and legacy source-size unsupported steps rerun. Omit kinds to inspect all recoverable steps, or supply kinds to narrow them. Other unsupported, permanent and completed steps remain unchanged; a permanent output blocks only its own step. Assets without any selected recoverable step count as failed items without starting understanding. Poll the returned job id; done counts accepted launches, not successful model inference. Staff Admin only permits reprocess and requires a nonblank reason. Example: {"action":"reprocess","selector":{"expression":"processing_state=failed AND failure_code=UPSTREAM_FAILED"}}. For understanding, Media generates proxies for video or audio sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.',
13320
13367
  http: "POST",
13321
13368
  path: "/media/v1/libraries/{library_id}/batches",
13322
13369
  streaming: "no",
@@ -13351,7 +13398,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13351
13398
  resource: "media.libraries.batches",
13352
13399
  method: "retrieve",
13353
13400
  summary: "Get batch",
13354
- description: "Read a batch job’s status, successful and failed item counts, and a bounded list of failed items. Use the id returned by batch creation; a job outside this library is not found.",
13401
+ description: "Alias of batch creation. Apply one metadata or deletion action to ids or a frozen expression selection asynchronously; poll the returned job id to inspect completion and item failures.",
13355
13402
  http: "GET",
13356
13403
  path: "/media/v1/libraries/{library_id}/batches/{job_id}",
13357
13404
  streaming: "no",
@@ -13409,7 +13456,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13409
13456
  resource: "media.libraries.events",
13410
13457
  method: "list",
13411
13458
  summary: "List events",
13412
- description: "Read library events in sequence order, including while the library is deleting. Page forward with asc and after_seq, or backward with desc and before_seq; never combine the two sequence cursors.",
13459
+ description: "Read library events in sequence order for observing asset writes and understanding progress. Obtain library_id from creation or listing; continue with after_seq for asc or before_seq for desc, without combining both. Use next_cursor when supplied. Reads do not start or retry understanding.",
13413
13460
  http: "GET",
13414
13461
  path: "/media/v1/libraries/{library_id}/events",
13415
13462
  streaming: "no",
@@ -13481,7 +13528,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13481
13528
  resource: "media.libraries.jobs",
13482
13529
  method: "retrieve",
13483
13530
  summary: "Get job alias",
13484
- description: "Alias of batch retrieval. Read the job returned by a batch request, including terminal status, successful and failed counts, and individual failure codes.",
13531
+ description: "Read library events in sequence order, including while the library is deleting. Page forward with asc and after_seq, or backward with desc and before_seq; never combine the two sequence cursors.",
13485
13532
  http: "GET",
13486
13533
  path: "/media/v1/libraries/{library_id}/jobs/{job_id}",
13487
13534
  streaming: "no",
@@ -13504,7 +13551,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13504
13551
  resource: "media.libraries.purge",
13505
13552
  method: "create",
13506
13553
  summary: "Purge library",
13507
- description: "Permanently remove a library that is already deleting, without waiting for purge_at. Its assets and related resources are removed and cannot be restored; first soft-delete an active library.",
13554
+ description: "List assets in an active library, newest first, optionally filtering by exact folder and stored resource type. Continue using next_cursor; video includes audio-only assets.",
13508
13555
  http: "POST",
13509
13556
  path: "/media/v1/libraries/{library_id}/purge",
13510
13557
  streaming: "no",
@@ -13522,7 +13569,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13522
13569
  resource: "media.libraries",
13523
13570
  method: "restore",
13524
13571
  summary: "Restore library",
13525
- description: "Restore a deleting library before its purge_at deadline. The library becomes active again and deleted_at and purge_at are cleared; expired or non-deleting libraries cannot be restored.",
13572
+ description: "Permanently remove a library that is already deleting, without waiting for purge_at. Its assets and related resources are removed and cannot be restored; first soft-delete an active library.",
13526
13573
  http: "POST",
13527
13574
  path: "/media/v1/libraries/{library_id}/restore",
13528
13575
  streaming: "no",
@@ -13540,7 +13587,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13540
13587
  resource: "media.libraries.search",
13541
13588
  method: "create",
13542
13589
  summary: "Semantic search alias",
13543
- description: "Alias of semantic search. Search assets with a nonblank text query, optional expression filter and top_k; hybrid combines semantic and keyword matches, while semantic uses vector similarity only.",
13590
+ description: "List all immediate child folders under parent, or under the root when parent is omitted. Counts include descendant assets. The result is unpaginated; limit and cursor are rejected.",
13544
13591
  http: "POST",
13545
13592
  path: "/media/v1/libraries/{library_id}/search",
13546
13593
  streaming: "no",
@@ -13591,7 +13638,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13591
13638
  resource: "media.libraries.search.expression",
13592
13639
  method: "create",
13593
13640
  summary: "Expression search",
13594
- description: "Search active assets using the supported filter-expression syntax, sorting and cursor pagination. Empty expression matches all assets. Tags and context require with_field; inspect the exactness flags before treating counts as complete.",
13641
+ description: "Find visually similar assets using exactly one of asset_id or an inline base64 image. The library must support image search; an asset query needs a current image embedding and excludes that source asset from results.",
13595
13642
  http: "POST",
13596
13643
  path: "/media/v1/libraries/{library_id}/search/expression",
13597
13644
  streaming: "no",
@@ -13611,7 +13658,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13611
13658
  name: "expression",
13612
13659
  type: "string",
13613
13660
  required: false,
13614
- description: 'Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: ["context"] to include context. Quality filters: flags:watermark matches any current shot with a watermark; flags.watermark:false requires an assessed video with no positive watermark judgment. The same syntax supports slideshow, hand_frame, text_sticker and low_quality. folder_mismatch:true selects lexical folder/location hints. Geometry filters support width, height, resolution:1920x1080, numeric aspect_ratio (width/height), and orientation:landscape, portrait or square. Missing geometry or unassessed legacy flags do not match positive filters. failure_code=UPSTREAM_FAILED selects assets with a current failed understanding carrying that code; combine with processing_state=failed or processing_state=partial.'
13661
+ description: 'Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: ["context"] to include context. Quality filters: flags:watermark matches any current shot with a watermark; flags.watermark:false requires an assessed video with no positive watermark judgment. The same syntax supports slideshow, hand_frame, text_sticker and low_quality. folder_mismatch:true selects lexical folder/location hints. Geometry filters support width, height, resolution:1920x1080, numeric aspect_ratio (width/height), and orientation:landscape, portrait or square. Missing geometry or unassessed legacy flags do not match positive filters. has_music:true AND audio_genre:jazz AND audio_mood:calm selects current-version audio profiles with music and matching model labels; has_music:false applies only to sampled ranges, not the entire source. failure_code=UPSTREAM_FAILED selects assets with a current failed understanding carrying that code; combine with processing_state=failed or processing_state=partial.'
13615
13662
  },
13616
13663
  {
13617
13664
  name: "sort_by",
@@ -13663,7 +13710,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13663
13710
  resource: "media.libraries.search.semantic",
13664
13711
  method: "create",
13665
13712
  summary: "Semantic search",
13666
- description: "Search assets with a nonblank text query and optional expression filter. Hybrid mode combines semantic and keyword matches; semantic mode uses vector similarity only. Results are ranked and limited by top_k.",
13713
+ description: "Alias of semantic search. Search assets with a nonblank text query, optional expression filter and top_k; hybrid combines semantic and keyword matches, while semantic uses vector similarity only.",
13667
13714
  http: "POST",
13668
13715
  path: "/media/v1/libraries/{library_id}/search/semantic",
13669
13716
  streaming: "no",
@@ -13714,7 +13761,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13714
13761
  resource: "media.libraries.search.visual",
13715
13762
  method: "create",
13716
13763
  summary: "Visual search",
13717
- description: "Find visually similar assets using exactly one of asset_id or an inline base64 image. The library must support image search; an asset query needs a current image embedding and excludes that source asset from results.",
13764
+ description: "Search assets with a nonblank text query and optional expression filter. Hybrid mode combines semantic and keyword matches; semantic mode uses vector similarity only. Results are ranked and limited by top_k.",
13718
13765
  http: "POST",
13719
13766
  path: "/media/v1/libraries/{library_id}/search/visual",
13720
13767
  streaming: "no",
@@ -13784,7 +13831,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
13784
13831
  name: "kinds",
13785
13832
  type: "string",
13786
13833
  required: false,
13787
- description: "Comma-separated output kinds: caption, tags, ocr, frame, transcript, overview, embedding. Omit or empty to include every kind."
13834
+ description: "Comma-separated output kinds: caption, tags, ocr, frame, transcript, overview, audio, embedding. Omit or empty to include every kind."
13788
13835
  },
13789
13836
  {
13790
13837
  name: "cursor",
@@ -14105,25 +14152,25 @@ services (model, agent, automation…); call the operation you need and read its
14105
14152
  name: "model",
14106
14153
  type: "string",
14107
14154
  required: true,
14108
- description: "Transcription model id, for example `whisper-large-v3-turbo` or `qwen3-asr-flash`; list candidates with listModels?type=transcription. Router support (supported): Verified to take effect."
14155
+ description: "Model catalog identifier declaring openai.audio.transcriptions; use it unchanged, including any creator prefix."
14109
14156
  },
14110
14157
  {
14111
14158
  name: "file",
14112
14159
  type: "string",
14113
14160
  required: true,
14114
- description: "Audio file to transcribe, uploaded as multipart/form-data. Router support (supported): Verified to take effect."
14161
+ description: "Audio bytes uploaded as a multipart file; supported formats and input limits depend on the selected model."
14115
14162
  },
14116
14163
  {
14117
14164
  name: "language",
14118
14165
  type: "string",
14119
14166
  required: false,
14120
- description: "Language of the audio as an ISO-639-1 code such as `en` or `zh`. Router support (partial): Both models accept ISO language codes. qwen3-asr-flash may translate output to that language; whisper-large-v3-turbo treats it as an input hint. Non-ISO names may return 502."
14167
+ description: "Source language code when known; omit to let the model detect the language."
14121
14168
  },
14122
14169
  {
14123
14170
  name: "prompt",
14124
14171
  type: "string",
14125
14172
  required: false,
14126
- description: "Text that primes the model with vocabulary or context. Router support (partial): Vocabulary hints work on whisper-large-v3-turbo only; qwen3-asr-flash returns 400."
14173
+ description: "Optional vocabulary or contextual guidance for recognizing the audio; support depends on the selected model."
14127
14174
  },
14128
14175
  {
14129
14176
  name: "response_format",
@@ -14131,20 +14178,22 @@ services (model, agent, automation…); call the operation you need and read its
14131
14178
  enum: [
14132
14179
  "json",
14133
14180
  "text",
14134
- "verbose_json"
14181
+ "verbose_json",
14182
+ "diarized_json"
14135
14183
  ],
14136
14184
  required: false,
14137
- description: "Format of the response body. `json` and `text` are the commonly supported formats. Router support (partial): json/text work on both; verbose_json works only on whisper-large-v3-turbo. srt/vtt return 400."
14185
+ description: "Output format: json returns text in JSON; text returns plain text; verbose_json includes requested timestamps; diarized_json includes speaker-labelled segments when supported. Defaults to json."
14138
14186
  },
14139
14187
  {
14140
14188
  name: "timestamp_granularities[]",
14141
14189
  type: "array",
14142
14190
  itemType: "string",
14143
14191
  enum: [
14192
+ "word",
14144
14193
  "segment"
14145
14194
  ],
14146
14195
  required: false,
14147
- description: "Timestamp levels to include with `verbose_json`; only `segment` exists in this schema. Router support (partial): Only whisper-large-v3-turbo supports segment with verbose_json. word returns 400; qwen3-asr-flash does not support timestamps."
14196
+ description: "Timestamp levels to request as repeated multipart fields: word returns per-word times; segment returns segment times. Omit for the model default. Use verbose_json, or diarized_json on supporting models."
14148
14197
  },
14149
14198
  {
14150
14199
  name: "temperature",
@@ -27360,6 +27409,19 @@ var mediaCreateLibrary = (options) => (options.client ?? client).post({
27360
27409
  ...options.headers
27361
27410
  }
27362
27411
  });
27412
+ var mediaCreateFrameUrls = (options) => (options.client ?? client).post({
27413
+ security: [{
27414
+ key: "media-BearerAuth",
27415
+ scheme: "bearer",
27416
+ type: "http"
27417
+ }],
27418
+ url: "/media/v1/libraries/{library_id}/assets/{asset_id}/frames",
27419
+ ...options,
27420
+ headers: {
27421
+ "Content-Type": "application/json",
27422
+ ...options.headers
27423
+ }
27424
+ });
27363
27425
  var mediaDeleteLibrary = (options) => (options.client ?? client).delete({
27364
27426
  security: [{
27365
27427
  key: "media-BearerAuth",
@@ -30097,6 +30159,9 @@ function createMedia(transport) {
30097
30159
  batch: bind(transport, mediaBatchAssets),
30098
30160
  create: bind(transport, (options) => mediaUploadAsset({ ...options, bodySerializer: multipartBodySerializer, headers: { "Content-Type": null, ...options.headers } })),
30099
30161
  delete: bind(transport, mediaDeleteAsset),
30162
+ frames: {
30163
+ create: bind(transport, mediaCreateFrameUrls)
30164
+ },
30100
30165
  import: {
30101
30166
  create: bind(transport, mediaImportAsset)
30102
30167
  },
@@ -33529,7 +33594,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
33529
33594
  }
33530
33595
 
33531
33596
  // src/main.ts
33532
- var version = "0.2.1-dev.7d20ab6";
33597
+ var version = "0.2.1-dev.b3b65e8";
33533
33598
  var commands = commandTree(operations);
33534
33599
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
33535
33600
  function route(argv) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/cli",
3
- "version": "0.2.1-dev.7d20ab6",
3
+ "version": "0.2.1-dev.b3b65e8",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "praxis": "dist/praxis.js"