@deepraxis/cli 0.2.1-dev.414edb9 → 0.2.1-dev.5c83a98

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
- 521 HTTP operations; 523 commands including aliases.
5
+ 522 HTTP operations; 524 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
 
@@ -432,6 +432,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
432
432
  | `praxis api organization feedback list` | `organization.feedback.list` | GET `/organization/v1/feedback` | `--phase`, `--query`, `--param-limit`, `--page` |
433
433
  | `praxis api organization feedback message create` | `organization.feedback.messages.create` | POST `/organization/v1/feedback/{id}/messages` | `--feedback`, `--body` |
434
434
  | `praxis api organization feedback message list` | `organization.feedback.messages.list` | GET `/organization/v1/feedback/{id}/messages` | `--feedback`, `--param-limit`, `--page` |
435
+ | `praxis api organization member list` | `organization.members.list` | GET `/organization/v1/members` | `--param-limit`, `--page` |
435
436
  | `praxis api organization usage list` | `organization.usage.list` | GET `/organization/v1/usage` | `--starting-at`, `--ending-at`, `--bucket-width`, `--time-zone`, `--group-by`, `--page` |
436
437
  | `praxis api sandbox command run <sandbox_id>` | `sandbox.sandboxes.commands.run` | POST `/sandbox/v1/sandboxes/{sandbox_id}/commands` | `--cmd`, `--background`, `--cwd`, `--timeout-ms` |
437
438
  | `praxis api sandbox connect <sandboxID>` | `sandbox.sandboxes.connect` | POST `/sandbox/v1/sandboxes/{sandboxID}/connect` | `--timeout`, `--memory` |
package/dist/praxis.js CHANGED
@@ -10158,7 +10158,7 @@ Execution errors include error.details.prints containing output printed before f
10158
10158
  resource: "cut.projects.frames",
10159
10159
  method: "list",
10160
10160
  summary: "Render preview frames",
10161
- description: "Review the visual result at one or more project times without creating an export. Pass comma-separated seconds in at, such as 12,15.5; scale changes preview size and revision selects a committed project revision. Fetch the returned image URLs before expires_at; render again when they expire.",
10161
+ description: "Review the visual result at one or more project times without creating an export. Pass comma-separated seconds in at, such as 12,15.5; scale changes preview size and revision selects a committed project revision. Request at most eight times. Each returned url is an inline PNG data URL (data:image/png;base64,...), not a hosted HTTP image link. Decode its base64 payload to save the image. Codemode returns at most four images per call, so request at most four times when reviewing there.",
10162
10162
  http: "GET",
10163
10163
  path: "/cut/v1/projects/{project_id}/frames",
10164
10164
  streaming: "no",
@@ -10373,7 +10373,88 @@ Execution errors include error.details.prints containing output printed before f
10373
10373
  resource: "cut.projects",
10374
10374
  method: "execute",
10375
10375
  summary: "Execute editing script",
10376
- description: 'Edit the current timeline atomically using synchronous JavaScript source. Read state or timeline first, then pass its revision as expected_revision to detect concurrent changes. Use AddTrack, Insert, Update, Delete, Split, Trim, Move, RippleDeleteRange, UpdateTrack, DeleteTrack, SetSettings, AddCaptionsFromTranscript and SetMarker for writes; GetTimeline, GetItem, FindItems, GetMedia, GetTranscript and GetAnalysis read editing context; Print emits text and Preview requests frame previews. All script times are seconds; script object fields use camelCase, for example `media: {libraryId, assetId}`. Unlike Shotstack, execute applies script edits to a persistent project in one transaction. Provide script or a saved edit_id with literal edits, never both; failures roll back writes. A revision conflict while preparing the response may follow a committed edit: retrieve state before retrying. Minimal script after creating a project:\n\n```js\nconst t = AddTrack("video");\nInsert(t, {type: "color", color: "#123456", start: 0, length: 3});\nPrint(t);\n```',
10376
+ description: `Edit the current timeline atomically using synchronous JavaScript source. Read state or timeline first, then pass its revision as expected_revision to detect concurrent changes. Unlike Shotstack, execute applies script edits to a persistent project in one transaction. Provide script or a saved edit_id with literal edits, never both; failures roll back writes. A revision conflict while preparing the response may follow a committed edit: retrieve state before retrying. Minimal script after creating a project: \`const t = AddTrack("video"); Insert(t, {type: "color", color: "#123456", start: 0, length: 3}); Print(t);\`
10377
+
10378
+ ### Script function reference
10379
+
10380
+ Functions are synchronous globals; do not import them. \`project\` is the current project ID. TrackId and ClipId are strings returned by AddTrack and Insert or read from GetTimeline. Reads see earlier writes in the same script.
10381
+
10382
+ \`\`\`ts
10383
+ GetTimeline(o?: { from?: number; to?: number; tracks?: TrackId[] }): TimelineView;
10384
+ GetItem(id: ClipId): ItemView;
10385
+ FindItems<T>(visit: (item: ItemView, ctx: { track: TrackView; index: number }) => T | undefined): T[];
10386
+ GetMedia(ref: MediaRef): MediaInfo;
10387
+ GetTranscript(ref: MediaRef, o?: { from?: number; to?: number }): Word[];
10388
+ GetAnalysis(ref: MediaRef, kind: AnalysisKind): Segment[];
10389
+ Insert(track: TrackId, item: ItemInit, o?: { ripple?: boolean }): ClipId;
10390
+ Update(id: ClipId, patch: ItemPatchView): void;
10391
+ Delete(id: ClipId, o?: { ripple?: boolean }): void;
10392
+ Split(id: ClipId, at: number): ClipId;
10393
+ Trim(id: ClipId, edge: "in" | "out", delta: number, o?: { ripple?: boolean }): void;
10394
+ Move(id: ClipId, start: number, track?: TrackId): void;
10395
+ RippleDeleteRange(from: number, to: number, tracks?: TrackId[]): void;
10396
+ AddTrack(kind: "video" | "audio" | "caption", init?: { name?: string }, index?: number): TrackId;
10397
+ UpdateTrack(id: TrackId, patch: TrackPatch): void;
10398
+ DeleteTrack(id: TrackId): void;
10399
+ SetSettings(patch: Partial<ProjectSettingsView>): void;
10400
+ AddCaptionsFromTranscript(track: TrackId, source: ClipId, o?: { style?: Partial<CaptionStyle>; maxChars?: number }): ClipId[];
10401
+ SetMarker(at: number, label: string): string;
10402
+ Print(...values: unknown[]): void;
10403
+ Preview(at: number[]): void;
10404
+ \`\`\`
10405
+
10406
+ | Functions | Behavior and arguments |
10407
+ | --- | --- |
10408
+ | GetTimeline, GetItem | Read compact item views: id, track, type, start, end, length, optional media, sourceIn/sourceOut, text and offline reason. GetTimeline returns duration and tracks (id, kind, name, index, locked, items); from/to and tracks narrow the read. |
10409
+ | FindItems | Visit items with their track and index; return undefined to omit an item, any other value to collect it. |
10410
+ | GetMedia | Read metadata for \`{libraryId, assetId}\` in a bound library: kind, dimensions, fps, hasAudio and durationUs when available. durationUs is microseconds. |
10411
+ | GetTranscript, GetAnalysis | Read available transcript words or silence/filler/scenes segments. Transcript filter from/to is seconds; returned word and segment from/to values are source microseconds (divide by 1,000,000 for editing). Words contain text and optional speaker/filler; segments may include label/confidence. Request analysis first if unavailable. |
10412
+ | Insert, Update, Delete | Insert returns the new clip ID; Update changes supplied fields; Delete removes the clip. Optional ripple on Insert/Delete closes or opens space on the track. |
10413
+ | Split, Trim, Move | Split at a timeline position and return the new right-hand clip ID. Trim changes the in or out edge by delta seconds. Move sets the timeline start and optionally a new track. |
10414
+ | RippleDeleteRange | Delete a timeline interval and close its gap on the specified tracks, or all unlocked tracks when omitted. |
10415
+ | AddTrack, UpdateTrack, DeleteTrack | Add video/audio/caption tracks; index selects layer order (0 is top). TrackPatch supports name, locked, hidden, muted, gainDb and style as appropriate to track kind. |
10416
+ | SetSettings | Supply any of width/height (pixels), fps (frames per second), background (color). |
10417
+ | AddCaptionsFromTranscript | Create captions from an audio/video clip's kept words. Optional maxChars is 1–1000, default 16; style updates the caption track. Returns caption IDs. |
10418
+ | SetMarker | Add a label at a timeline time and return its ID. |
10419
+ | Print, Preview | Print appends text to prints. Preview requests up to eight times total per execute and puts images in the result's frames. Each url is an inline PNG data URL, not an HTTP image link. Decode the base64 payload to save an image. Codemode returns at most four images per call; request at most four times there. |
10420
+
10421
+ #### Insert fields (ItemInit)
10422
+
10423
+ Every item requires \`type\` and \`start\`. Times used for editing are seconds and snap to the project frame rate: start, length, sourceIn, fadeIn/fadeOut, transition length, keyframe at, reveal delay/stagger/duration. Keyframe and reveal times are relative to the clip start. Video/audio may omit length to use the remaining source duration; other types require length.
10424
+
10425
+ | type | Required fields beyond type/start | Optional fields |
10426
+ | --- | --- | --- |
10427
+ | video | media | length, sourceIn, volumeDb, transform, fit, animate, transitionIn, transitionOut |
10428
+ | image | media, length | transform, fit, animate, transitionIn, transitionOut |
10429
+ | text | text, length | style, transform, reveal, animate, transitionIn, transitionOut |
10430
+ | color | color, length | transform, fill, animate, transitionIn, transitionOut |
10431
+ | shape | shape, length, width, height, fill | radius, stroke, transform, animate, transitionIn, transitionOut |
10432
+ | audio | media | length, sourceIn, volumeDb, fadeIn, fadeOut, transitionIn, transitionOut |
10433
+ | caption | text, length | — |
10434
+
10435
+ Video tracks accept video/image/text/color/shape; audio and caption tracks accept their corresponding type. Media is \`{libraryId: string, assetId: string}\` from a bound library. sourceIn defaults to 0, volumeDb to 0 dB, audio fades to 0 seconds. fit defaults to contain: contain fits the whole image, cover fills and crops, fill stretches, none keeps native dimensions.
10436
+
10437
+ | Field | Value |
10438
+ | --- | --- |
10439
+ | transform | Partial \`{x, y, scale, rotation, opacity, crop, blur}\`. x/y are normalized canvas center coordinates (default 0.5); scale 1 is fitted size; rotation is degrees (default 0); opacity is 0–1 (default 1). crop is \`{top,right,bottom,left}\`. blur is 0–100 pixels at 1080-pixel frame height. |
10440
+ | style | Partial \`{fontFamily, fontSize, fontWeight, color, stroke, background, align, maxWidth}\`. fontFamily: Geist or Noto Sans SC (default); fontSize defaults to 48; fontWeight: 400 (default), 500 or 700; color defaults to #FFFFFF; align: left, center (default), right; maxWidth is a fraction of canvas width (default 0.9). stroke is \`{color,width}\`. Caption style additionally supports position (top/middle/bottom), margin (0–0.4 of canvas height), highlightColor and maxLines: 2. |
10441
+ | animate | An object keyed by x, y, scale, rotation, opacity or blur. Each value is an array of \`{at: number, value: number, ease?: Ease}\` sorted by at with distinct frame-snapped times. Values hold before the first and after the last keyframe, overriding the static transform. |
10442
+ | Ease | linear, in, out, inOut, \`{bezier: [x1,y1,x2,y2]}\` or \`{spring: {stiffness, damping, mass?}}\`. Easing shapes the segment arriving at that keyframe; springs may overshoot. |
10443
+ | reveal | \`{by, delay?: number, stagger: number, duration: number, from: {y?, opacity?, scale?, blur?}, ease?: Ease}\`. by selects char, word or line. Unit k starts at delay + k * stagger and takes duration seconds to reach its resting state; from.y is a fraction of font size. |
10444
+ | fill | A color string (#RRGGBB or #RRGGBBAA), \`{linear: {angle, stops: [{at,color}, ...]}}\` or \`{radial: {stops: [{at,color}, ...]}}\`. Stop positions are 0–1; angle is degrees, 0 left to right. On color clips, fill replaces color when supplied. |
10445
+ | shape, width, height, radius, stroke | shape is rect or ellipse. width/height are fractions of canvas width/height before scaling. radius rounds rect corners in pixels at 1080-pixel frame height. stroke is \`{color: string, width: number}\`. |
10446
+ | transitionIn, transitionOut | \`{kind, length: number}\` at the clip's beginning/end. length is seconds. fade changes opacity; dissolve blends; push_left/push_right move horizontally; wipe_left reveals horizontally. |
10447
+
10448
+ #### Update fields (ItemPatchView)
10449
+
10450
+ All fields are optional; use only fields relevant to the item's type. Supported fields: start, length, sourceIn, volumeDb, transform, fit, text, style, color, fadeIn, fadeOut, animate, reveal, fill, stroke, shape, width, height, radius, transitionIn, transitionOut. Values and units match Insert. Set animate, reveal, fill, stroke, transitionIn or transitionOut to null to remove that effect; omitting a field preserves it. For example: \`Update(id, {volumeDb: -12})\` or \`Update(id, {transitionIn: null})\`.
10451
+
10452
+ #### Script names versus HTTP response names
10453
+
10454
+ Use camelCase inside scripts, including nested objects. HTTP request/response JSON outside script source uses snake_case. Map media.library_id → media.libraryId, media.asset_id → media.assetId, source_in → sourceIn, volume_db → volumeDb, fade_in/fade_out → fadeIn/fadeOut, transition_in/transition_out → transitionIn/transitionOut, font_family/font_size/font_weight/max_width → fontFamily/fontSize/fontWeight/maxWidth, gain_db → gainDb, highlight_color/max_lines → highlightColor/maxLines. Fields such as animate, reveal, fill, stroke, at and length retain their spelling. GetTimeline/GetItem already return camelCase compact views; the expanded retrieveTimeline HTTP response is not an Insert object.
10455
+
10456
+ Unrecognized script fields fail with OPS_REJECTED and rejection code UNKNOWN_FIELD; snake_case mistakes suggest the corresponding camelCase name. The error message lists each rejection's #opIndex, code and reason. Correct the named fields and retry the saved edit; do not assume an ignored field applied an effect.
10457
+ `,
10377
10458
  http: "POST",
10378
10459
  path: "/cut/v1/projects/{project_id}:execute",
10379
10460
  streaming: "no",
@@ -11465,7 +11546,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11465
11546
  resource: "file.files",
11466
11547
  method: "create",
11467
11548
  summary: "Upload file",
11468
- description: 'Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File(["Return within 23 days."], "policy.txt", { type: "text/plain" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–7776000). Without expiry, the file persists until deleted.',
11549
+ description: 'Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File(["Return within 23 days."], "policy.txt", { type: "text/plain" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–7776000). Without expiry, the file persists until deleted.',
11469
11550
  http: "POST",
11470
11551
  path: "/file/v1/files",
11471
11552
  streaming: "no",
@@ -11487,10 +11568,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11487
11568
  type: "string",
11488
11569
  enum: [
11489
11570
  "user_data",
11571
+ "assistants",
11490
11572
  "vision"
11491
11573
  ],
11492
11574
  required: true,
11493
- description: "Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data."
11575
+ description: "Purpose label stored with the file: user_data, assistants or vision. The label is stored and returned unchanged; assistants follows the same rules as user_data. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data."
11494
11576
  },
11495
11577
  {
11496
11578
  name: "expires_after",
@@ -11617,7 +11699,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11617
11699
  resource: "file.uploads",
11618
11700
  method: "create",
11619
11701
  summary: "Create an upload",
11620
- description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.",
11702
+ description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.",
11621
11703
  http: "POST",
11622
11704
  path: "/file/v1/uploads",
11623
11705
  streaming: "no",
@@ -11650,10 +11732,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11650
11732
  type: "string",
11651
11733
  enum: [
11652
11734
  "user_data",
11735
+ "assistants",
11653
11736
  "vision"
11654
11737
  ],
11655
11738
  required: true,
11656
- description: "Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images."
11739
+ description: "Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images."
11657
11740
  },
11658
11741
  {
11659
11742
  name: "expires_after",
@@ -11707,10 +11790,11 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
11707
11790
  type: "string",
11708
11791
  enum: [
11709
11792
  "user_data",
11793
+ "assistants",
11710
11794
  "vision"
11711
11795
  ],
11712
11796
  required: false,
11713
- description: "user_data stores ordinary files and conversation images; vision accepts PNG, JPEG, GIF or WebP images only. Omitted means user_data."
11797
+ description: "user_data and assistants store ordinary files and conversation images with their original purpose label; vision accepts PNG, JPEG, GIF or WebP images only. Omitted means user_data."
11714
11798
  },
11715
11799
  {
11716
11800
  name: "expires_in",
@@ -16569,6 +16653,31 @@ for more details.`
16569
16653
  ]
16570
16654
  }
16571
16655
  },
16656
+ {
16657
+ resource: "organization.members",
16658
+ method: "list",
16659
+ summary: "List organization members",
16660
+ description: "Concepts follow GitHub org members: find a person's user id, for example to assign an approver to an approval task. Lists only members of the organization behind your API key or runtime token, ordered by joined_at ascending (membership id breaks ties). Ask the user who should approve, then use that member's id. Emails are visible only within this organization. The request cannot select another organization. Pass next_page unchanged as page; null means the end. Read-only; no usage charge. Example: GET /organization/v1/members?limit=20.",
16661
+ http: "GET",
16662
+ path: "/organization/v1/members",
16663
+ streaming: "no",
16664
+ pagination: false,
16665
+ pathParams: [],
16666
+ query: [
16667
+ {
16668
+ name: "limit",
16669
+ type: "integer",
16670
+ required: false,
16671
+ description: "Maximum members per page, from 1 to 100; defaults to 20."
16672
+ },
16673
+ {
16674
+ name: "page",
16675
+ type: "string",
16676
+ required: false,
16677
+ description: "Opaque next_page cursor returned by the previous response; omit for the first page."
16678
+ }
16679
+ ]
16680
+ },
16572
16681
  {
16573
16682
  resource: "organization.usage",
16574
16683
  method: "list",
@@ -23355,6 +23464,19 @@ var countResponseInputTokens = (options) => (options.client ?? client).post({
23355
23464
  ...options.headers
23356
23465
  }
23357
23466
  });
23467
+ var listOrganizationMembers = (options) => (options?.client ?? client).get({
23468
+ security: [{
23469
+ key: "BearerAuth",
23470
+ scheme: "bearer",
23471
+ type: "http"
23472
+ }, {
23473
+ key: "ApiKeyAuth",
23474
+ name: "X-API-Key",
23475
+ type: "apiKey"
23476
+ }],
23477
+ url: "/organization/v1/members",
23478
+ ...options
23479
+ });
23358
23480
  var listOrganizationFeedback = (options) => (options?.client ?? client).get({
23359
23481
  security: [{
23360
23482
  key: "BearerAuth",
@@ -30117,6 +30239,9 @@ function createOrganization(transport) {
30117
30239
  },
30118
30240
  retrieve: bind(transport, getOrganizationFeedback)
30119
30241
  },
30242
+ members: {
30243
+ list: bind(transport, listOrganizationMembers)
30244
+ },
30120
30245
  usage: {
30121
30246
  list: bind(transport, listOrganizationUsage)
30122
30247
  }
@@ -33369,7 +33494,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
33369
33494
  }
33370
33495
 
33371
33496
  // src/main.ts
33372
- var version = "0.2.1-dev.414edb9";
33497
+ var version = "0.2.1-dev.5c83a98";
33373
33498
  var commands = commandTree(operations);
33374
33499
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
33375
33500
  function route(argv) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/cli",
3
- "version": "0.2.1-dev.414edb9",
3
+ "version": "0.2.1-dev.5c83a98",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "praxis": "dist/praxis.js"