@deepraxis/cli 0.2.1-dev.e5614a0 → 0.2.1-dev.eb022f5
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 +2 -1
- package/dist/praxis.js +125 -3
- package/package.json +1 -1
package/COMMANDS.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Generated by `bun run commands`. DO NOT EDIT.
|
|
4
4
|
|
|
5
|
-
|
|
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.
|
|
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:
|
|
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",
|
|
@@ -16569,6 +16650,31 @@ for more details.`
|
|
|
16569
16650
|
]
|
|
16570
16651
|
}
|
|
16571
16652
|
},
|
|
16653
|
+
{
|
|
16654
|
+
resource: "organization.members",
|
|
16655
|
+
method: "list",
|
|
16656
|
+
summary: "List organization members",
|
|
16657
|
+
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.",
|
|
16658
|
+
http: "GET",
|
|
16659
|
+
path: "/organization/v1/members",
|
|
16660
|
+
streaming: "no",
|
|
16661
|
+
pagination: false,
|
|
16662
|
+
pathParams: [],
|
|
16663
|
+
query: [
|
|
16664
|
+
{
|
|
16665
|
+
name: "limit",
|
|
16666
|
+
type: "integer",
|
|
16667
|
+
required: false,
|
|
16668
|
+
description: "Maximum members per page, from 1 to 100; defaults to 20."
|
|
16669
|
+
},
|
|
16670
|
+
{
|
|
16671
|
+
name: "page",
|
|
16672
|
+
type: "string",
|
|
16673
|
+
required: false,
|
|
16674
|
+
description: "Opaque next_page cursor returned by the previous response; omit for the first page."
|
|
16675
|
+
}
|
|
16676
|
+
]
|
|
16677
|
+
},
|
|
16572
16678
|
{
|
|
16573
16679
|
resource: "organization.usage",
|
|
16574
16680
|
method: "list",
|
|
@@ -23355,6 +23461,19 @@ var countResponseInputTokens = (options) => (options.client ?? client).post({
|
|
|
23355
23461
|
...options.headers
|
|
23356
23462
|
}
|
|
23357
23463
|
});
|
|
23464
|
+
var listOrganizationMembers = (options) => (options?.client ?? client).get({
|
|
23465
|
+
security: [{
|
|
23466
|
+
key: "BearerAuth",
|
|
23467
|
+
scheme: "bearer",
|
|
23468
|
+
type: "http"
|
|
23469
|
+
}, {
|
|
23470
|
+
key: "ApiKeyAuth",
|
|
23471
|
+
name: "X-API-Key",
|
|
23472
|
+
type: "apiKey"
|
|
23473
|
+
}],
|
|
23474
|
+
url: "/organization/v1/members",
|
|
23475
|
+
...options
|
|
23476
|
+
});
|
|
23358
23477
|
var listOrganizationFeedback = (options) => (options?.client ?? client).get({
|
|
23359
23478
|
security: [{
|
|
23360
23479
|
key: "BearerAuth",
|
|
@@ -30117,6 +30236,9 @@ function createOrganization(transport) {
|
|
|
30117
30236
|
},
|
|
30118
30237
|
retrieve: bind(transport, getOrganizationFeedback)
|
|
30119
30238
|
},
|
|
30239
|
+
members: {
|
|
30240
|
+
list: bind(transport, listOrganizationMembers)
|
|
30241
|
+
},
|
|
30120
30242
|
usage: {
|
|
30121
30243
|
list: bind(transport, listOrganizationUsage)
|
|
30122
30244
|
}
|
|
@@ -33369,7 +33491,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
|
|
|
33369
33491
|
}
|
|
33370
33492
|
|
|
33371
33493
|
// src/main.ts
|
|
33372
|
-
var version = "0.2.1-dev.
|
|
33494
|
+
var version = "0.2.1-dev.eb022f5";
|
|
33373
33495
|
var commands = commandTree(operations);
|
|
33374
33496
|
var manual = [...workflows.map((w) => w.words), [API_WORD]];
|
|
33375
33497
|
function route(argv) {
|