@deepraxis/cli 0.3.0-dev.b4c63c2 → 0.3.0-dev.b58d05d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/COMMANDS.md +16 -3
  2. package/dist/praxis.js +1060 -120
  3. package/package.json +1 -1
package/dist/praxis.js CHANGED
@@ -14059,7 +14059,7 @@ across all toolsets allowed.`
14059
14059
  name: "image_model",
14060
14060
  type: "string",
14061
14061
  required: false,
14062
- description: "Model used by the imagine image tool; defaults to gpt-image-2 when unset. Only models that can generate images are accepted. Omit to preserve; null clears the configured model. /agent/v1 only."
14062
+ description: "Retired (the imagine tool no longer exists): accepted and ignored, never stored. Image generation goes through the media library and the manage-media skill. /agent/v1 only."
14063
14063
  },
14064
14064
  {
14065
14065
  name: "subagents",
@@ -14286,7 +14286,7 @@ toolsets allowed.`
14286
14286
  name: "image_model",
14287
14287
  type: "string",
14288
14288
  required: false,
14289
- description: "Model used by the imagine image tool; defaults to gpt-image-2 when unset. Only models that can generate images are accepted. Omit to preserve; null clears the configured model. /agent/v1 only."
14289
+ description: "Retired (the imagine tool no longer exists): accepted and ignored, never stored. Image generation goes through the media library and the manage-media skill. /agent/v1 only."
14290
14290
  },
14291
14291
  {
14292
14292
  name: "subagents",
@@ -25680,6 +25680,82 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
25680
25680
  ]
25681
25681
  }
25682
25682
  },
25683
+ {
25684
+ resource: "devops.changes",
25685
+ method: "retrieve",
25686
+ summary: "Retrieve a change",
25687
+ description: "Read one change in full: its derived stage, its pull requests (one per slice, oldest first), its flag, its workspace, and one cell per environment showing the version it rode and how far its flag has been rolled out there. The id is the branch name and contains a slash, so it must be percent-encoded in the path: feat/run-page-v2 is sent as feat%2Frun-page-v2. The stage is derived, not stored — with several pull requests it shows the slice that is furthest behind, so a change already in production that opens a new slice goes back to reviewing. When suspectedIn is set, the latest verification in that environment failed and this change is listed among the suspects until a later verification succeeds.",
25688
+ http: "GET",
25689
+ path: "/devops/v1/changes/{id}",
25690
+ streaming: "no",
25691
+ pagination: false,
25692
+ pathParams: [
25693
+ {
25694
+ name: "id",
25695
+ sdkName: "id",
25696
+ description: "The change's id, which is its branch name <type>/<slug> from a change list or create answer; the slash must be percent-encoded, so feat/run-page-v2 is sent as feat%2Frun-page-v2."
25697
+ }
25698
+ ],
25699
+ query: []
25700
+ },
25701
+ {
25702
+ resource: "devops.changes",
25703
+ method: "abandon",
25704
+ summary: "Abandon a change",
25705
+ description: "Stop a change for good: it no longer moves forward and its stage becomes abandoned. reason is required and is kept with the change. Pull requests that were already merged are not undone — the system cleans them up, or a new change reverts them — so abandoning is a statement about the change, not a rollback of code. The id is the branch name and its slash must be percent-encoded in the path (feat%2Frun-page-v2). A change that is already abandoned is refused with INVALID_ARGUMENT, which is how a caller tells an earlier abandon apart from a call that had no effect.",
25706
+ http: "POST",
25707
+ path: "/devops/v1/changes/{id}:abandon",
25708
+ streaming: "no",
25709
+ pagination: false,
25710
+ pathParams: [
25711
+ {
25712
+ name: "id",
25713
+ sdkName: "id",
25714
+ description: "The change's id, which is its branch name <type>/<slug> from a change list or create answer; the slash must be percent-encoded, so feat/run-page-v2 is sent as feat%2Frun-page-v2."
25715
+ }
25716
+ ],
25717
+ query: [],
25718
+ body: {
25719
+ required: true,
25720
+ fields: [
25721
+ {
25722
+ name: "reason",
25723
+ type: "string",
25724
+ required: true,
25725
+ description: "Why the change is abandoned, stored with it as the attribution of the act."
25726
+ }
25727
+ ]
25728
+ }
25729
+ },
25730
+ {
25731
+ resource: "devops.changes",
25732
+ method: "markLastSlice",
25733
+ summary: "Mark the last slice",
25734
+ description: "Say whether the pull request being merged is the last slice of the change. A change defaults to yes; until it is marked as the last slice it cannot reach rolling out or done, because rolling out a container that may still grow would roll out the wrong thing. Send lastSlice=false before merging a pull request when more slices will follow, and true again on the final one. The id is the branch name and its slash must be percent-encoded in the path (feat%2Frun-page-v2).",
25735
+ http: "POST",
25736
+ path: "/devops/v1/changes/{id}:markLastSlice",
25737
+ streaming: "no",
25738
+ pagination: false,
25739
+ pathParams: [
25740
+ {
25741
+ name: "id",
25742
+ sdkName: "id",
25743
+ description: "The change's id, which is its branch name <type>/<slug> from a change list or create answer; the slash must be percent-encoded, so feat/run-page-v2 is sent as feat%2Frun-page-v2."
25744
+ }
25745
+ ],
25746
+ query: [],
25747
+ body: {
25748
+ required: true,
25749
+ fields: [
25750
+ {
25751
+ name: "lastSlice",
25752
+ type: "boolean",
25753
+ required: true,
25754
+ description: "True when no more pull requests will follow; false keeps the change from reaching rolling out or done."
25755
+ }
25756
+ ]
25757
+ }
25758
+ },
25683
25759
  {
25684
25760
  resource: "devops.environments.checkpoints",
25685
25761
  method: "list",
@@ -26053,6 +26129,127 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
26053
26129
  ],
26054
26130
  query: []
26055
26131
  },
26132
+ {
26133
+ resource: "devops.projects.changes",
26134
+ method: "list",
26135
+ summary: "List changes",
26136
+ description: "List the project's changes, newest first, each with its derived stage and one cell per environment. Use it to see what is in flight before opening another change, or to find the id (the branch name) of a change you want to read. filter narrows the list: stage is derived from the facts, so it is applied after derivation, while type, owner and ended narrow on stored columns. Leaving a filter field out, or sending an empty array, does not narrow that field. ended=true lists changes that are done or abandoned, ended=false lists the rest. totalSize is answered on the first page only and counts what the filter leaves.",
26137
+ http: "GET",
26138
+ path: "/devops/v1/projects/{project}/changes",
26139
+ streaming: "no",
26140
+ pagination: false,
26141
+ pathParams: [
26142
+ {
26143
+ name: "project",
26144
+ sdkName: "project",
26145
+ description: "Identifies the project whose data you are reading, from the project list or create answer."
26146
+ }
26147
+ ],
26148
+ query: [
26149
+ {
26150
+ name: "pageSize",
26151
+ type: "integer",
26152
+ required: false,
26153
+ description: "How many items this page returns, 1 to 100; omitted uses 50. A larger value is capped at 100 rather than refused, and 0 falls back to the default, so a paging loop never fails on a size alone."
26154
+ },
26155
+ {
26156
+ name: "pageToken",
26157
+ type: "string",
26158
+ required: false,
26159
+ description: "The cursor from the previous page's nextPageToken. Treat it as opaque and never build one yourself; omit it for the first page."
26160
+ },
26161
+ {
26162
+ name: "filter",
26163
+ type: "string",
26164
+ required: false,
26165
+ description: "JSON object with any of stage (array of stages), type (array of change types), owner (the requester's actor id) and ended (boolean). A stage or type that is not in the vocabulary is refused with INVALID_ARGUMENT rather than ignored."
26166
+ }
26167
+ ]
26168
+ },
26169
+ {
26170
+ resource: "devops.projects.changes",
26171
+ method: "create",
26172
+ summary: "Create a change",
26173
+ description: "Open a change: the unit that carries one piece of work from a branch to production. A change has no separate id — its id is its branch name, <type>/<slug> (for example feat/run-page-v2), and the branch is cut from main as part of this call. type says what the work is and slug names it; both together are the id, so the same pair sent again answers the change the first call made instead of creating a second. A change with a flag also creates a release flag whose key is the slug, off in every environment, so opening one changes no runtime behaviour; withFlag defaults to true for feat and false for every other type, and you may override it either way. Requesting a change opens it at once — there is no approval step — and the caller becomes its owner. A slug already used by another type in the project is refused with CHANGE_SLUG_TAKEN because both would need the same branch name. The stage in the answer is derived from facts such as pull requests and promotions; it is never something you set.",
26174
+ http: "POST",
26175
+ path: "/devops/v1/projects/{project}/changes",
26176
+ streaming: "no",
26177
+ pagination: false,
26178
+ pathParams: [
26179
+ {
26180
+ name: "project",
26181
+ sdkName: "project",
26182
+ description: "Identifies the project whose data you are reading, from the project list or create answer."
26183
+ }
26184
+ ],
26185
+ query: [],
26186
+ body: {
26187
+ required: true,
26188
+ fields: [
26189
+ {
26190
+ name: "type",
26191
+ type: "string",
26192
+ enum: [
26193
+ "feat",
26194
+ "fix",
26195
+ "perf",
26196
+ "refactor",
26197
+ "docs",
26198
+ "test",
26199
+ "build",
26200
+ "ci",
26201
+ "chore",
26202
+ "revert"
26203
+ ],
26204
+ required: true,
26205
+ description: "What the work is, in commitlint vocabulary; together with slug it forms the change id <type>/<slug>."
26206
+ },
26207
+ {
26208
+ name: "slug",
26209
+ type: "string",
26210
+ required: true,
26211
+ description: "Lower-case letters, digits and hyphens, 2 to 60 characters; it becomes the branch name after the type and the key of the change's flag."
26212
+ },
26213
+ {
26214
+ name: "title",
26215
+ type: "string",
26216
+ required: true,
26217
+ description: "One line saying what the change is for, shown wherever the change is listed and used as the flag's name."
26218
+ },
26219
+ {
26220
+ name: "tickets",
26221
+ type: "array",
26222
+ itemType: "string",
26223
+ required: false,
26224
+ description: "Ticket references the change belongs to, as a magic word or a #number; omit it when there is none."
26225
+ },
26226
+ {
26227
+ name: "withFlag",
26228
+ type: "boolean",
26229
+ required: false,
26230
+ description: "True to create a release flag keyed by the slug; omitted means true for feat and false for every other type."
26231
+ },
26232
+ {
26233
+ name: "urgent",
26234
+ type: "boolean",
26235
+ required: false,
26236
+ description: "True for an urgent fix that may take the patch path with a recorded authorization to skip develop; omitted means false."
26237
+ },
26238
+ {
26239
+ name: "observeUntil",
26240
+ type: "string",
26241
+ required: false,
26242
+ description: "RFC 3339 UTC deadline by which the flag's observation must be decided; only used when the change creates a flag."
26243
+ },
26244
+ {
26245
+ name: "requestId",
26246
+ type: "string",
26247
+ required: false,
26248
+ description: "Caller-chosen key that makes a retry answer the change the first call made instead of creating another."
26249
+ }
26250
+ ]
26251
+ }
26252
+ },
26056
26253
  {
26057
26254
  resource: "devops.projects.environments",
26058
26255
  method: "list",
@@ -28864,7 +29061,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
28864
29061
  resource: "media.generation.capabilities",
28865
29062
  method: "list",
28866
29063
  summary: "Get generation capabilities",
28867
- description: 'Read what Praxis offers for each kind of generation — image, video and speech — before asking for one, and read a speech model’s voices here before naming one. Every type answers the models available for it, the model it uses when a request names none, and what each model costs per unit; a speech model the platform publishes voices for also carries default_voice and voices there, each voice with an id, a name, a gender, a language and a style — so a request for "a gentle female voice" is answered by matching the style and gender rather than by guessing an identifier. Pass a voice id back verbatim as voice, or omit voice to take default_voice; a voice that is neither one of those nor a voice material of the library is refused with INVALID_PARAMS before any job is created. OpenAI voice names such as alloy and aura are not valid here. The video fields beside the types keep their original meaning (intents, default model, duration and aspect-ratio limits, per-library concurrency). The models come from the platform model catalogue, and an id listed here is accepted verbatim as the model field of that type’s generation request. price.amount is a decimal string with its currency; video models that charge by resolution also carry price.by_resolution, whose amount is then the cheapest tier. A model the catalogue cannot route right now is still listed, with available false, so a caller can show it as temporarily unavailable instead of hiding it. When the catalogue cannot be read the endpoint still answers: every type comes back with an empty models list and its real default_model, and the voices a speech model carries are absent rather than empty, because the voices come from the platform and not from the catalogue. Generation is charged per unit and every output is stored in the library.',
29064
+ description: 'Read what Praxis offers for each kind of generation — image, video and speech — before asking for one, and read a speech model’s voices here before naming one. Every type answers the models available for it, the model it uses when a request names none, and what each model costs per unit; a speech model the platform publishes voices for also carries default_voice and voices there, each voice with an id, a name, a gender, a language and a style — so a request for "a gentle female voice" is answered by matching the style and gender rather than by guessing an identifier. Pass a voice id back verbatim as voice, or omit voice to take default_voice; a voice that is neither one of those nor a voice material of the library is refused with INVALID_PARAMS before any job is created. OpenAI voice names such as alloy and aura are not valid here. The video fields beside the types keep their original meaning (intents, default model, duration and aspect-ratio limits, per-library concurrency). The models come from the platform model catalogue, and an id listed here is accepted verbatim as the model field of that type’s generation request. A video model additionally carries the modes it can be driven in and the durations, aspect ratios and resolutions the catalogue has registered for it — modes, duration_seconds, aspect_ratios and resolutions — so read them before requesting video and choose a mode and a value this model lists; an empty list means the platform has not registered that option yet, and then omit the field rather than assume a value. price.amount is a decimal string with its currency; video models that charge by resolution also carry price.by_resolution, whose amount is then the cheapest tier. A model the catalogue cannot route right now is still listed, with available false, so a caller can show it as temporarily unavailable instead of hiding it. When the catalogue cannot be read the endpoint still answers: every type comes back with an empty models list and its real default_model, and the voices a speech model carries are absent rather than empty, because the voices come from the platform and not from the catalogue. Generation is charged per unit and every output is stored in the library.',
28868
29065
  http: "GET",
28869
29066
  path: "/media/v1/generation/capabilities",
28870
29067
  streaming: "no",
@@ -29462,7 +29659,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
29462
29659
  resource: "media.assets",
29463
29660
  method: "edit",
29464
29661
  summary: "Edit asset",
29465
- 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\"}}.",
29662
+ 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 reports the charge in usage (US dollars, six decimals) and the new asset carries it in provenance.cost; when the job is done, tell the person the usage amount and give them the output’s viewer_url. 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\"}}.",
29466
29663
  http: "POST",
29467
29664
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}/edits",
29468
29665
  streaming: "no",
@@ -29730,7 +29927,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
29730
29927
  resource: "media.speech",
29731
29928
  method: "create",
29732
29929
  summary: "Create speech",
29733
- 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. voice is optional and may be omitted, in which case the model’s default voice is used; when it is given it must be one of the voices of the model being used — read them from the types.speech list of GET /media/v1/generation/capabilities, which gives each voice an id, a name, a gender, a language and a style, or pass a voice material id of this same library — and a voice that is neither is refused with INVALID_PARAMS in the voice field before any job exists, so a wrong name is free to try but reading the capabilities first is free without trying. Do not use OpenAI voice names such as alloy or aura: they are not valid here. speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. Cloning a voice from recordings is not available yet. 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.\"}, or with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"zh_female_wenroumama_uranus_bigtts\"} for a gentle female voice.",
29930
+ 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. voice is optional and may be omitted, in which case the model’s default voice is used; when it is given it must be one of the voices of the model being used — read them from the types.speech list of GET /media/v1/generation/capabilities, which gives each voice an id, a name, a gender, a language and a style, or pass a voice material id of this same library — and a voice that is neither is refused with INVALID_PARAMS in the voice field before any job exists, so a wrong name is free to try but reading the capabilities first is free without trying. Do not use OpenAI voice names such as alloy or aura: they are not valid here. speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. Cloning a voice from recordings is not available yet. 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 reports the charge in usage (US dollars, six decimals, the sum over every segment) and the recording carries it in provenance.cost; a request refused before it starts costs nothing. When the job is done, tell the person the usage amount and give them the output’s viewer_url. 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.\"}, or with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"zh_female_wenroumama_uranus_bigtts\"} for a gentle female voice.",
29734
29931
  http: "POST",
29735
29932
  path: "/media/v1/libraries/{library_id}/audio/speech",
29736
29933
  streaming: "no",
@@ -29962,7 +30159,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
29962
30159
  resource: "media.images",
29963
30160
  method: "generate",
29964
30161
  summary: "Generate image",
29965
- 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\"}.",
30162
+ 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 reports the charge in usage (US dollars, six decimals, final once the job is completed or failed) and each produced asset carries its own part in provenance.cost; nothing is charged for a request refused before it starts. When the job is done, tell the person the usage amount and give them each output’s viewer_url, which opens the asset in the Console. 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\"}.",
29966
30163
  http: "POST",
29967
30164
  path: "/media/v1/libraries/{library_id}/images/generations",
29968
30165
  streaming: "no",
@@ -29999,8 +30196,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
29999
30196
  {
30000
30197
  name: "size",
30001
30198
  type: "string",
30199
+ enum: [
30200
+ "1024x1024",
30201
+ "1024x1536",
30202
+ "1536x1024"
30203
+ ],
30002
30204
  required: false,
30003
- 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."
30205
+ description: "Requested pixel size written as width x height. The platform image models accept 1024x1024 (square, the default), 1024x1536 (portrait) and 1536x1024 (landscape); any other size is rejected with INVALID_PARAMS before anything is charged."
30004
30206
  },
30005
30207
  {
30006
30208
  name: "background",
@@ -30082,7 +30284,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
30082
30284
  resource: "media.libraries.jobs",
30083
30285
  method: "list",
30084
30286
  summary: "List jobs",
30085
- description: "List batch and generation jobs in a library. Filter by status and continue with next_cursor. Poll a generation Job until terminal; every produced output is already a library asset.",
30287
+ description: "List batch and generation jobs in a library. Filter by status or by pipeline_run_id (the jobs one automation run started) and continue with next_cursor. Poll a generation Job until terminal; every produced output is already a library asset.",
30086
30288
  http: "GET",
30087
30289
  path: "/media/v1/libraries/{library_id}/jobs",
30088
30290
  streaming: "no",
@@ -30111,6 +30313,12 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
30111
30313
  required: false,
30112
30314
  description: "Filter jobs by their current status."
30113
30315
  },
30316
+ {
30317
+ name: "pipeline_run_id",
30318
+ type: "string",
30319
+ required: false,
30320
+ description: "Return only the jobs started by this automation run (its root run), so one pipeline run reads as one batch."
30321
+ },
30114
30322
  {
30115
30323
  name: "limit",
30116
30324
  type: "integer",
@@ -30533,7 +30741,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
30533
30741
  resource: "media.videos",
30534
30742
  method: "generate",
30535
30743
  summary: "Generate video",
30536
- 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}.",
30744
+ 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 reports the charge in usage (US dollars, six decimals) and each produced asset carries its own part in provenance.cost; a refused request costs nothing. When the job is done, tell the person the usage amount and give them each output’s viewer_url. 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}.",
30537
30745
  http: "POST",
30538
30746
  path: "/media/v1/libraries/{library_id}/videos/generations",
30539
30747
  streaming: "no",
@@ -34832,6 +35040,96 @@ for more details.`
34832
35040
  ]
34833
35041
  }
34834
35042
  },
35043
+ {
35044
+ resource: "sandbox.sandboxes.tasks",
35045
+ method: "create",
35046
+ summary: "Start a task whose output is pushed off the machine while it runs",
35047
+ description: "Run a long command whose output you will read back afterwards, including after the sandbox is deleted, instead of holding one connection open. Use this for builds, test runs and batch jobs; use commands.run for a short command whose output you want inline. The machine's resident daemon pushes the task's stdout/stderr to Praxis storage as it is produced, so the log survives the sandbox (seven days) and can be read in ranges with sandboxes.tasks.log; no vendor exec channel is involved. The command and the shipping credential travel to the daemon in its process environment, never in argv, so neither appears in the machine's process list. Only a full sandbox whose daemon advertises log-ship can run a task; any other machine returns PROVIDER_UNSUPPORTED with the reason. Returns 201 with the task id; starting is not waiting — poll the log to follow the task, and the final marker's exitCode for how it ended.",
35048
+ http: "POST",
35049
+ path: "/sandbox/v1/sandboxes/{sandboxID}/tasks",
35050
+ streaming: "no",
35051
+ pagination: false,
35052
+ pathParams: [
35053
+ {
35054
+ name: "sandboxID",
35055
+ sdkName: "sandboxID",
35056
+ 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."
35057
+ }
35058
+ ],
35059
+ query: [],
35060
+ body: {
35061
+ required: true,
35062
+ fields: [
35063
+ {
35064
+ name: "command",
35065
+ type: "string",
35066
+ required: true,
35067
+ description: "The shell command to run. It is handed to the sandbox's daemon in an environment variable, never in argv, so it stays out of the machine's process list; at most 64 KiB of UTF-8."
35068
+ },
35069
+ {
35070
+ name: "cwd",
35071
+ type: "string",
35072
+ required: false,
35073
+ description: "Absolute working directory inside the sandbox. Omit to run where the daemon starts; a relative path is rejected rather than resolved against a home directory you did not choose."
35074
+ },
35075
+ {
35076
+ name: "maxLifetimeSecs",
35077
+ type: "integer",
35078
+ required: false,
35079
+ description: "How long the task may run, in seconds; omit for 7200, the ceiling is 86400 (a day). The pushing credential lives 30 minutes past this, so the daemon can still deliver a task that ran to its limit."
35080
+ },
35081
+ {
35082
+ name: "files",
35083
+ type: "array",
35084
+ itemType: "object",
35085
+ required: false,
35086
+ description: "Up to eight extra files to ship alongside the task's own output, for example a structured events log the task appends to. Each gets its own stream, read with name on sandboxes.tasks.log."
35087
+ }
35088
+ ]
35089
+ }
35090
+ },
35091
+ {
35092
+ resource: "sandbox.sandboxes.tasks",
35093
+ method: "retrieveLog",
35094
+ summary: "Read a range of a task's pushed output",
35095
+ description: "Follow a task started with sandboxes.tasks.start, or read it long after its sandbox is gone. This reads Praxis storage and never the machine, so the answer is the same whether the sandbox is running, paused or deleted; the log is kept for seven days. Read in ranges: pass the previous answer's nextOffset as offset to continue, and stop when done is true. done means the final marker exists and the whole stream has been read, and only then do exitCode and size carry the task's outcome. text is UTF-8 decoded by bytes and backs up to a whole character when a cut would split one, so a page never ends mid-character; size, offset and nextOffset all count bytes. Ownership comes from the sandbox's index row while it exists and from the record written when the task started once it does not, so a sandbox id you own keeps answering after the sandbox is deleted. A task that was never started, or one belonging to another organization, returns NOT_FOUND.",
35096
+ http: "GET",
35097
+ path: "/sandbox/v1/sandboxes/{sandboxID}/tasks/{taskID}/log",
35098
+ streaming: "no",
35099
+ pagination: false,
35100
+ pathParams: [
35101
+ {
35102
+ name: "sandboxID",
35103
+ sdkName: "sandboxID",
35104
+ 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."
35105
+ },
35106
+ {
35107
+ name: "taskID",
35108
+ sdkName: "taskID",
35109
+ description: "Task id returned by sandboxes.tasks.start; a task id is opaque and is not the sandbox id."
35110
+ }
35111
+ ],
35112
+ query: [
35113
+ {
35114
+ name: "name",
35115
+ type: "string",
35116
+ required: false,
35117
+ description: "Which stream to read: output is the task's own stdout and stderr and is the default; any other value must be one of the file names passed to sandboxes.tasks.start. 1 to 32 characters of a-z, 0-9 or a hyphen."
35118
+ },
35119
+ {
35120
+ name: "offset",
35121
+ type: "integer",
35122
+ required: false,
35123
+ description: "First byte of the range, counted from the start of the stream. Omit to start at 0; resume with the previous answer's nextOffset."
35124
+ },
35125
+ {
35126
+ name: "limit",
35127
+ type: "integer",
35128
+ required: false,
35129
+ description: "How many bytes to return, at most 4 MiB; omit for 1 MiB. A smaller limit follows a running task with less data per call."
35130
+ }
35131
+ ]
35132
+ },
34835
35133
  {
34836
35134
  resource: "sandbox.sandboxes",
34837
35135
  method: "timeout",
@@ -36518,7 +36816,7 @@ for more details.`
36518
36816
  name: "time",
36519
36817
  type: "string",
36520
36818
  required: false,
36521
- description: "When this entry happens in the story, such as 2037 or 民国二十四年冬; at most 40 characters, and an empty string records no time. It is shown beside the entry and reaches the writer with it."
36819
+ description: "When this entry happens in the story, such as 2037, 1931 年 4 月 or 第 3 天; at most 40 characters, and an empty string records no time. The 脉络 timeline orders entries by the first and last number in it, so a time without a digit (民国二十四年冬) sits in 未定时间. It is shown beside the entry and reaches the writer with it."
36522
36820
  },
36523
36821
  {
36524
36822
  name: "tracking",
@@ -36536,7 +36834,7 @@ for more details.`
36536
36834
  type: "array",
36537
36835
  itemType: "object",
36538
36836
  required: false,
36539
- description: "Entries this one relates to at creation, each naming the target and the label that reads from this entry to it."
36837
+ description: "Entries this one relates to at creation, each naming the target and the label that reads from this entry to it. Between two events the cause holds the relation to its effect (label such as 导致); 参与 marks a participant."
36540
36838
  },
36541
36839
  {
36542
36840
  name: "images",
@@ -37365,7 +37663,7 @@ for more details.`
37365
37663
  resource: "studio.works",
37366
37664
  method: "create",
37367
37665
  summary: "Create a work with its goal",
37368
- description: "Create a work: one deliverable piece plus everything around it. Pass the goal the writing serves — the reader, what that reader should get or do, the one-sentence message and the constraints — and the original brief the person gave in their own words. A slug is derived from the title unless you pass one. The work starts with no drafts; create the first one with the drafts create call, because the genre decides the structure. A reference library belongs to the work and is created with it, so the setting written later stays this work's own; pass based_on to start from another work and have its setting and styles copied in as your own.",
37666
+ description: "Create a work: one deliverable piece plus everything around it. Pass the goal the writing serves: the reader, what that reader should get or do, and the one-sentence message. The work holds the goal only; the requirement for one piece (the person's text, its points, a length, banned wording) belongs to that draft and is given with the drafts create call, so a novel's plot points and length never bind the promotion derived from it. A slug is derived from the title unless you pass one. The work starts with no drafts; create the first one with the drafts create call, because the genre decides the structure. A reference library belongs to the work and is created with it, so the setting written later stays this work's own; pass based_on to start from another work and have its setting and styles copied in as your own.",
37369
37667
  http: "POST",
37370
37668
  path: "/studio/v1/works",
37371
37669
  streaming: "no",
@@ -37391,13 +37689,7 @@ for more details.`
37391
37689
  name: "goal",
37392
37690
  type: "object",
37393
37691
  required: true,
37394
- description: "What this work is for: who reads it, what that reader should get or do, the one message it carries, and the limits it is written under."
37395
- },
37396
- {
37397
- name: "brief",
37398
- type: "object",
37399
- required: false,
37400
- description: "The original requirement as it arrives with a new work: the person's text, any attached source files, and the points split from it."
37692
+ description: "What this work is for: who reads it, what that reader should get or do, and the one message it carries. Limits such as a length belong to a draft's brief, not to the goal; a goal with constraints or any other unknown field answers INVALID_PARAMS."
37401
37693
  },
37402
37694
  {
37403
37695
  name: "codexes",
@@ -37532,7 +37824,7 @@ for more details.`
37532
37824
  name: "goal",
37533
37825
  type: "object",
37534
37826
  required: false,
37535
- description: "What this work is for: who reads it, what that reader should get or do, the one message it carries, and the limits it is written under."
37827
+ description: "What this work is for: who reads it, what that reader should get or do, and the one message it carries. Limits such as a length belong to a draft's brief, not to the goal; a goal with constraints or any other unknown field answers INVALID_PARAMS."
37536
37828
  },
37537
37829
  {
37538
37830
  name: "codexes",
@@ -37568,69 +37860,6 @@ for more details.`
37568
37860
  ]
37569
37861
  }
37570
37862
  },
37571
- {
37572
- resource: "studio.works",
37573
- method: "updateBrief",
37574
- summary: "Add to or correct the original brief",
37575
- description: "Extend the original brief: append text, attach files, add points taken from an outline, edit one point, or drop a point. Points are how the software checks that every requirement landed in a written unit, so split the person's outline into points here rather than burying them in prose. The brief carries its own revision, separate from the work and from each draft.",
37576
- http: "PATCH",
37577
- path: "/studio/v1/works/{work}/brief",
37578
- streaming: "no",
37579
- pagination: false,
37580
- pathParams: [
37581
- {
37582
- name: "work",
37583
- sdkName: "work",
37584
- description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
37585
- }
37586
- ],
37587
- query: [],
37588
- body: {
37589
- required: true,
37590
- fields: [
37591
- {
37592
- name: "expected_revision",
37593
- type: "integer",
37594
- required: false,
37595
- description: "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged."
37596
- },
37597
- {
37598
- name: "text",
37599
- type: "string",
37600
- required: false,
37601
- description: "Text to append to the stored brief, added after what is already there and never replacing it."
37602
- },
37603
- {
37604
- name: "attachments",
37605
- type: "array",
37606
- itemType: "string",
37607
- required: false,
37608
- description: "Source files to keep with the brief, added to the ones already attached."
37609
- },
37610
- {
37611
- name: "add_points",
37612
- type: "array",
37613
- itemType: "object",
37614
- required: false,
37615
- description: "New requirement points to split out of the brief; each receives the next free key in order. A plain string is a unit point; pass { text, scope: work } for a constraint on the whole piece (period, voice, point of view, cast, words to avoid)."
37616
- },
37617
- {
37618
- name: "edit_points",
37619
- type: "array",
37620
- itemType: "object",
37621
- required: false,
37622
- description: "Existing points to reword, each naming the key it keeps and the text that replaces it."
37623
- },
37624
- {
37625
- name: "remove_points",
37626
- type: "array",
37627
- itemType: "string",
37628
- required: false,
37629
- description: "Keys of points to drop; a dropped key is never reused, so later points keep their own keys."
37630
- }
37631
- ]
37632
- }
37633
- },
37634
37863
  {
37635
37864
  resource: "studio.works.drafts",
37636
37865
  method: "list",
@@ -37716,6 +37945,12 @@ for more details.`
37716
37945
  required: false,
37717
37946
  description: "What the new draft should be derived from, so the service can record the source revision for later staleness checks."
37718
37947
  },
37948
+ {
37949
+ name: "brief",
37950
+ type: "object",
37951
+ required: false,
37952
+ description: "The requirement as it arrives with a new draft: the person's text, any attached source files, the constraints and the points split from it."
37953
+ },
37719
37954
  {
37720
37955
  name: "props",
37721
37956
  type: "object",
@@ -37841,6 +38076,80 @@ for more details.`
37841
38076
  ]
37842
38077
  }
37843
38078
  },
38079
+ {
38080
+ resource: "studio.works.drafts",
38081
+ method: "updateBrief",
38082
+ summary: "Add to or correct a draft's brief",
38083
+ description: "Extend the brief of one draft: append text, attach files, replace its constraints, add points taken from an outline, edit one point, or drop a point. The brief belongs to the draft, not the work: the length and plot points of a novel do not bind the promotion derived from it. Points are how the software checks that every requirement landed in a written unit, so split the person's outline into points here rather than burying them in prose; the constraints (a length such as 3000 字以内, banned wording) are what the length check and the context pack read. The brief carries its own revision, separate from the draft's.",
38084
+ http: "PATCH",
38085
+ path: "/studio/v1/works/{work}/drafts/{draft}/brief",
38086
+ streaming: "no",
38087
+ pagination: false,
38088
+ pathParams: [
38089
+ {
38090
+ name: "work",
38091
+ sdkName: "work",
38092
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38093
+ },
38094
+ {
38095
+ name: "draft",
38096
+ sdkName: "draft",
38097
+ description: "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
38098
+ }
38099
+ ],
38100
+ query: [],
38101
+ body: {
38102
+ required: true,
38103
+ fields: [
38104
+ {
38105
+ name: "expected_revision",
38106
+ type: "integer",
38107
+ required: false,
38108
+ description: "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged."
38109
+ },
38110
+ {
38111
+ name: "text",
38112
+ type: "string",
38113
+ required: false,
38114
+ description: "Text to append to the stored brief, added after what is already there and never replacing it."
38115
+ },
38116
+ {
38117
+ name: "constraints",
38118
+ type: "string",
38119
+ required: false,
38120
+ description: "The draft's constraints as one text, replacing what is there; pass an empty string to clear them."
38121
+ },
38122
+ {
38123
+ name: "attachments",
38124
+ type: "array",
38125
+ itemType: "string",
38126
+ required: false,
38127
+ description: "Source files to keep with the brief, added to the ones already attached."
38128
+ },
38129
+ {
38130
+ name: "add_points",
38131
+ type: "array",
38132
+ itemType: "object",
38133
+ required: false,
38134
+ description: "New requirement points to split out of the brief; each receives the next free key in order. A plain string is a unit point; pass { text, scope: work } for a constraint on the whole piece (period, voice, point of view, cast, words to avoid)."
38135
+ },
38136
+ {
38137
+ name: "edit_points",
38138
+ type: "array",
38139
+ itemType: "object",
38140
+ required: false,
38141
+ description: "Existing points to reword, each naming the key it keeps and the text that replaces it."
38142
+ },
38143
+ {
38144
+ name: "remove_points",
38145
+ type: "array",
38146
+ itemType: "string",
38147
+ required: false,
38148
+ description: "Keys of points to drop; a dropped key is never reused, so later points keep their own keys."
38149
+ }
38150
+ ]
38151
+ }
38152
+ },
37844
38153
  {
37845
38154
  resource: "studio.works.drafts",
37846
38155
  method: "retrieveExport",
@@ -37875,6 +38184,108 @@ for more details.`
37875
38184
  }
37876
38185
  ]
37877
38186
  },
38187
+ {
38188
+ resource: "studio.works.drafts.foreshadows",
38189
+ method: "list",
38190
+ summary: "List the foreshadows of a draft",
38191
+ description: "List the threads this draft sets up and pays off: each foreshadow names the unit that plants it, the unit that pays it off (or null while it is still open) and a note on what was planted. The foreshadow_paid check reports every open one in the draft's status and review, so a mystery or serial that plants a clue in chapter 2 is reminded until a later chapter answers it.",
38192
+ http: "GET",
38193
+ path: "/studio/v1/works/{work}/drafts/{draft}/foreshadows",
38194
+ streaming: "no",
38195
+ pagination: false,
38196
+ pathParams: [
38197
+ {
38198
+ name: "work",
38199
+ sdkName: "work",
38200
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38201
+ },
38202
+ {
38203
+ name: "draft",
38204
+ sdkName: "draft",
38205
+ description: "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
38206
+ }
38207
+ ],
38208
+ query: []
38209
+ },
38210
+ {
38211
+ resource: "studio.works.drafts.foreshadows",
38212
+ method: "delete",
38213
+ summary: "Drop a foreshadow",
38214
+ description: "Remove a thread that is no longer in the story. Deleting a key that does not exist answers the same as deleting one that did.",
38215
+ http: "DELETE",
38216
+ path: "/studio/v1/works/{work}/drafts/{draft}/foreshadows/{key}",
38217
+ streaming: "no",
38218
+ pagination: false,
38219
+ pathParams: [
38220
+ {
38221
+ name: "work",
38222
+ sdkName: "work",
38223
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38224
+ },
38225
+ {
38226
+ name: "draft",
38227
+ sdkName: "draft",
38228
+ description: "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
38229
+ },
38230
+ {
38231
+ name: "key",
38232
+ sdkName: "key",
38233
+ description: "Your name for the thread inside this work, such as 改造告示 or the-photo; the same key updates the same foreshadow."
38234
+ }
38235
+ ],
38236
+ query: []
38237
+ },
38238
+ {
38239
+ resource: "studio.works.drafts.foreshadows",
38240
+ method: "update",
38241
+ summary: "Plant or pay off a foreshadow",
38242
+ description: "Record a thread under a key of your choice: the unit that plants it and, once written, the unit that pays it off. Call it when you write the setup (payoff left out or null) and again with the same key when a later unit answers it. Both units must belong to this draft. An open foreshadow is reported by the foreshadow_paid check until it has a payoff, and a unit's context pack does not need to be asked for it.",
38243
+ http: "PUT",
38244
+ path: "/studio/v1/works/{work}/drafts/{draft}/foreshadows/{key}",
38245
+ streaming: "no",
38246
+ pagination: false,
38247
+ pathParams: [
38248
+ {
38249
+ name: "work",
38250
+ sdkName: "work",
38251
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38252
+ },
38253
+ {
38254
+ name: "draft",
38255
+ sdkName: "draft",
38256
+ description: "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
38257
+ },
38258
+ {
38259
+ name: "key",
38260
+ sdkName: "key",
38261
+ description: "Your name for the thread inside this work, such as 改造告示 or the-photo; the same key updates the same foreshadow."
38262
+ }
38263
+ ],
38264
+ query: [],
38265
+ body: {
38266
+ required: true,
38267
+ fields: [
38268
+ {
38269
+ name: "setup",
38270
+ type: "string",
38271
+ required: true,
38272
+ description: "Unit that plants the thread, by number such as 1 or by unt_ identifier; it must belong to this draft."
38273
+ },
38274
+ {
38275
+ name: "payoff",
38276
+ type: "string",
38277
+ required: false,
38278
+ description: "Unit that pays it off, by number or identifier, in this draft; leave it out or null while it is still open."
38279
+ },
38280
+ {
38281
+ name: "note",
38282
+ type: "string",
38283
+ required: false,
38284
+ description: "What was planted, in a sentence."
38285
+ }
38286
+ ]
38287
+ }
38288
+ },
37878
38289
  {
37879
38290
  resource: "studio.works.drafts",
37880
38291
  method: "retrieveOutline",
@@ -38209,6 +38620,95 @@ for more details.`
38209
38620
  ]
38210
38621
  }
38211
38622
  },
38623
+ {
38624
+ resource: "studio.works.progressions",
38625
+ method: "list",
38626
+ summary: "List the setting changes of a work",
38627
+ description: "List the recorded changes, all of them or those of one entry. Use it to check what a character has been through before writing the next unit, or to find a progression to delete.",
38628
+ http: "GET",
38629
+ path: "/studio/v1/works/{work}/progressions",
38630
+ streaming: "no",
38631
+ pagination: false,
38632
+ pathParams: [
38633
+ {
38634
+ name: "work",
38635
+ sdkName: "work",
38636
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38637
+ }
38638
+ ],
38639
+ query: [
38640
+ {
38641
+ name: "entry",
38642
+ type: "string",
38643
+ required: false,
38644
+ description: "Only the changes of this entry, by name, alias or ent_ identifier."
38645
+ }
38646
+ ]
38647
+ },
38648
+ {
38649
+ resource: "studio.works.progressions",
38650
+ method: "create",
38651
+ summary: "Record how a setting entry changes at a unit",
38652
+ description: "Record that an entry changes as of one unit: a character is injured in chapter 6, a shop moves in chapter 9, a secret becomes known. The library keeps what an entry is from the start; a progression keeps what becomes true later. A unit's context pack shows an entry's changes up to and including that unit (截至本单元的设定变化) and withholds the later ones, so chapter 3 is not written with chapter 6's injury. Name the entry by its name, an alias or its ent_ identifier, and the unit by its number.",
38653
+ http: "POST",
38654
+ path: "/studio/v1/works/{work}/progressions",
38655
+ streaming: "no",
38656
+ pagination: false,
38657
+ pathParams: [
38658
+ {
38659
+ name: "work",
38660
+ sdkName: "work",
38661
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38662
+ }
38663
+ ],
38664
+ query: [],
38665
+ body: {
38666
+ required: true,
38667
+ fields: [
38668
+ {
38669
+ name: "entry",
38670
+ type: "string",
38671
+ required: true,
38672
+ description: "Entry that changes, by name, alias or ent_ identifier; it must be in a library this work mounts."
38673
+ },
38674
+ {
38675
+ name: "unit",
38676
+ type: "string",
38677
+ required: true,
38678
+ description: "Unit from which the change is true, by number such as 3 or by unt_ identifier."
38679
+ },
38680
+ {
38681
+ name: "change",
38682
+ type: "string",
38683
+ required: true,
38684
+ description: "What changes, in a sentence a writer can respect."
38685
+ }
38686
+ ]
38687
+ }
38688
+ },
38689
+ {
38690
+ resource: "studio.works.progressions",
38691
+ method: "delete",
38692
+ summary: "Delete a setting change",
38693
+ description: "Remove one recorded change, by the prg_ identifier the list returns; to correct a change, delete it and record the new one.",
38694
+ http: "DELETE",
38695
+ path: "/studio/v1/works/{work}/progressions/{id}",
38696
+ streaming: "no",
38697
+ pagination: false,
38698
+ pathParams: [
38699
+ {
38700
+ name: "work",
38701
+ sdkName: "work",
38702
+ description: "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
38703
+ },
38704
+ {
38705
+ name: "id",
38706
+ sdkName: "id",
38707
+ description: "The progression to delete, by its identifier from the list."
38708
+ }
38709
+ ],
38710
+ query: []
38711
+ },
38212
38712
  {
38213
38713
  resource: "studio.works.renditions",
38214
38714
  method: "list",
@@ -38962,7 +39462,7 @@ for more details.`
38962
39462
  name: "budget_tokens",
38963
39463
  type: "integer",
38964
39464
  required: false,
38965
- description: "Token budget the pack must fit into; the reference and previous sections are cut to fit it while the genre, brief and unit sections always arrive whole. Omit it to use the service default."
39465
+ description: "Token budget the pack must fit into; the reference, timeline and previous sections are cut to fit it while the genre, brief and unit sections always arrive whole. Omit it to use the service default."
38966
39466
  }
38967
39467
  ]
38968
39468
  },
@@ -44076,6 +44576,36 @@ var getObservedProcessOutput = (options) => (options.client ?? client).get({
44076
44576
  url: "/sandbox/v1/sandboxes/{sandboxID}/processes/{processID}/output",
44077
44577
  ...options
44078
44578
  });
44579
+ var startSandboxTask = (options) => (options.client ?? client).post({
44580
+ security: [{
44581
+ key: "BearerAuth",
44582
+ scheme: "bearer",
44583
+ type: "http"
44584
+ }, {
44585
+ key: "ApiKeyAuth",
44586
+ name: "X-API-Key",
44587
+ type: "apiKey"
44588
+ }],
44589
+ url: "/sandbox/v1/sandboxes/{sandboxID}/tasks",
44590
+ ...options,
44591
+ headers: {
44592
+ "Content-Type": "application/json",
44593
+ ...options.headers
44594
+ }
44595
+ });
44596
+ var getSandboxTaskLog = (options) => (options.client ?? client).get({
44597
+ security: [{
44598
+ key: "BearerAuth",
44599
+ scheme: "bearer",
44600
+ type: "http"
44601
+ }, {
44602
+ key: "ApiKeyAuth",
44603
+ name: "X-API-Key",
44604
+ type: "apiKey"
44605
+ }],
44606
+ url: "/sandbox/v1/sandboxes/{sandboxID}/tasks/{taskID}/log",
44607
+ ...options
44608
+ });
44079
44609
  var deleteSandboxV1SandboxesBySandboxId = (options) => (options.client ?? client).delete({
44080
44610
  security: [
44081
44611
  {
@@ -48108,6 +48638,63 @@ var devopsTofuStateLock = (options) => (options.client ?? client).post({
48108
48638
  ...options.headers
48109
48639
  }
48110
48640
  });
48641
+ var devopsChangesList = (options) => (options.client ?? client).get({
48642
+ security: [{
48643
+ key: "devops-bearerAuth",
48644
+ scheme: "bearer",
48645
+ type: "http"
48646
+ }],
48647
+ url: "/devops/v1/projects/{project}/changes",
48648
+ ...options
48649
+ });
48650
+ var devopsChangesCreate = (options) => (options.client ?? client).post({
48651
+ security: [{
48652
+ key: "devops-bearerAuth",
48653
+ scheme: "bearer",
48654
+ type: "http"
48655
+ }],
48656
+ url: "/devops/v1/projects/{project}/changes",
48657
+ ...options,
48658
+ headers: {
48659
+ "Content-Type": "application/json",
48660
+ ...options.headers
48661
+ }
48662
+ });
48663
+ var devopsChangesGet = (options) => (options.client ?? client).get({
48664
+ security: [{
48665
+ key: "devops-bearerAuth",
48666
+ scheme: "bearer",
48667
+ type: "http"
48668
+ }],
48669
+ url: "/devops/v1/changes/{id}",
48670
+ ...options
48671
+ });
48672
+ var devopsChangesAbandon = (options) => (options.client ?? client).post({
48673
+ security: [{
48674
+ key: "devops-bearerAuth",
48675
+ scheme: "bearer",
48676
+ type: "http"
48677
+ }],
48678
+ url: "/devops/v1/changes/{id}:abandon",
48679
+ ...options,
48680
+ headers: {
48681
+ "Content-Type": "application/json",
48682
+ ...options.headers
48683
+ }
48684
+ });
48685
+ var devopsChangesMarkLastSlice = (options) => (options.client ?? client).post({
48686
+ security: [{
48687
+ key: "devops-bearerAuth",
48688
+ scheme: "bearer",
48689
+ type: "http"
48690
+ }],
48691
+ url: "/devops/v1/changes/{id}:markLastSlice",
48692
+ ...options,
48693
+ headers: {
48694
+ "Content-Type": "application/json",
48695
+ ...options.headers
48696
+ }
48697
+ });
48111
48698
  var knowledgeListVectorStores = (options) => (options?.client ?? client).get({
48112
48699
  security: [{
48113
48700
  key: "knowledge-bearerAuth",
@@ -50014,7 +50601,7 @@ var studioWorksUpdate = (options) => (options.client ?? client).patch({
50014
50601
  ...options.headers
50015
50602
  }
50016
50603
  });
50017
- var studioWorksUpdateBrief = (options) => (options.client ?? client).patch({
50604
+ var studioDraftsList = (options) => (options.client ?? client).get({
50018
50605
  security: [{
50019
50606
  key: "BearerAuth",
50020
50607
  scheme: "bearer",
@@ -50024,14 +50611,27 @@ var studioWorksUpdateBrief = (options) => (options.client ?? client).patch({
50024
50611
  name: "X-API-Key",
50025
50612
  type: "apiKey"
50026
50613
  }],
50027
- url: "/studio/v1/works/{work}/brief",
50614
+ url: "/studio/v1/works/{work}/drafts",
50615
+ ...options
50616
+ });
50617
+ var studioDraftsCreate = (options) => (options.client ?? client).post({
50618
+ security: [{
50619
+ key: "BearerAuth",
50620
+ scheme: "bearer",
50621
+ type: "http"
50622
+ }, {
50623
+ key: "ApiKeyAuth",
50624
+ name: "X-API-Key",
50625
+ type: "apiKey"
50626
+ }],
50627
+ url: "/studio/v1/works/{work}/drafts",
50028
50628
  ...options,
50029
50629
  headers: {
50030
50630
  "Content-Type": "application/json",
50031
50631
  ...options.headers
50032
50632
  }
50033
50633
  });
50034
- var studioDraftsList = (options) => (options.client ?? client).get({
50634
+ var studioDraftsGet = (options) => (options.client ?? client).get({
50035
50635
  security: [{
50036
50636
  key: "BearerAuth",
50037
50637
  scheme: "bearer",
@@ -50041,10 +50641,10 @@ var studioDraftsList = (options) => (options.client ?? client).get({
50041
50641
  name: "X-API-Key",
50042
50642
  type: "apiKey"
50043
50643
  }],
50044
- url: "/studio/v1/works/{work}/drafts",
50644
+ url: "/studio/v1/works/{work}/drafts/{draft}",
50045
50645
  ...options
50046
50646
  });
50047
- var studioDraftsCreate = (options) => (options.client ?? client).post({
50647
+ var studioDraftsUpdate = (options) => (options.client ?? client).patch({
50048
50648
  security: [{
50049
50649
  key: "BearerAuth",
50050
50650
  scheme: "bearer",
@@ -50054,14 +50654,14 @@ var studioDraftsCreate = (options) => (options.client ?? client).post({
50054
50654
  name: "X-API-Key",
50055
50655
  type: "apiKey"
50056
50656
  }],
50057
- url: "/studio/v1/works/{work}/drafts",
50657
+ url: "/studio/v1/works/{work}/drafts/{draft}",
50058
50658
  ...options,
50059
50659
  headers: {
50060
50660
  "Content-Type": "application/json",
50061
50661
  ...options.headers
50062
50662
  }
50063
50663
  });
50064
- var studioDraftsGet = (options) => (options.client ?? client).get({
50664
+ var studioDraftsUpdateBrief = (options) => (options.client ?? client).patch({
50065
50665
  security: [{
50066
50666
  key: "BearerAuth",
50067
50667
  scheme: "bearer",
@@ -50071,10 +50671,27 @@ var studioDraftsGet = (options) => (options.client ?? client).get({
50071
50671
  name: "X-API-Key",
50072
50672
  type: "apiKey"
50073
50673
  }],
50074
- url: "/studio/v1/works/{work}/drafts/{draft}",
50674
+ url: "/studio/v1/works/{work}/drafts/{draft}/brief",
50675
+ ...options,
50676
+ headers: {
50677
+ "Content-Type": "application/json",
50678
+ ...options.headers
50679
+ }
50680
+ });
50681
+ var studioDraftsOutline = (options) => (options.client ?? client).get({
50682
+ security: [{
50683
+ key: "BearerAuth",
50684
+ scheme: "bearer",
50685
+ type: "http"
50686
+ }, {
50687
+ key: "ApiKeyAuth",
50688
+ name: "X-API-Key",
50689
+ type: "apiKey"
50690
+ }],
50691
+ url: "/studio/v1/works/{work}/drafts/{draft}/outline",
50075
50692
  ...options
50076
50693
  });
50077
- var studioDraftsUpdate = (options) => (options.client ?? client).patch({
50694
+ var studioForeshadowsList = (options) => (options.client ?? client).get({
50078
50695
  security: [{
50079
50696
  key: "BearerAuth",
50080
50697
  scheme: "bearer",
@@ -50084,14 +50701,40 @@ var studioDraftsUpdate = (options) => (options.client ?? client).patch({
50084
50701
  name: "X-API-Key",
50085
50702
  type: "apiKey"
50086
50703
  }],
50087
- url: "/studio/v1/works/{work}/drafts/{draft}",
50704
+ url: "/studio/v1/works/{work}/drafts/{draft}/foreshadows",
50705
+ ...options
50706
+ });
50707
+ var studioForeshadowsDelete = (options) => (options.client ?? client).delete({
50708
+ security: [{
50709
+ key: "BearerAuth",
50710
+ scheme: "bearer",
50711
+ type: "http"
50712
+ }, {
50713
+ key: "ApiKeyAuth",
50714
+ name: "X-API-Key",
50715
+ type: "apiKey"
50716
+ }],
50717
+ url: "/studio/v1/works/{work}/drafts/{draft}/foreshadows/{key}",
50718
+ ...options
50719
+ });
50720
+ var studioForeshadowsUpsert = (options) => (options.client ?? client).put({
50721
+ security: [{
50722
+ key: "BearerAuth",
50723
+ scheme: "bearer",
50724
+ type: "http"
50725
+ }, {
50726
+ key: "ApiKeyAuth",
50727
+ name: "X-API-Key",
50728
+ type: "apiKey"
50729
+ }],
50730
+ url: "/studio/v1/works/{work}/drafts/{draft}/foreshadows/{key}",
50088
50731
  ...options,
50089
50732
  headers: {
50090
50733
  "Content-Type": "application/json",
50091
50734
  ...options.headers
50092
50735
  }
50093
50736
  });
50094
- var studioDraftsOutline = (options) => (options.client ?? client).get({
50737
+ var studioProgressionsList = (options) => (options.client ?? client).get({
50095
50738
  security: [{
50096
50739
  key: "BearerAuth",
50097
50740
  scheme: "bearer",
@@ -50101,7 +50744,37 @@ var studioDraftsOutline = (options) => (options.client ?? client).get({
50101
50744
  name: "X-API-Key",
50102
50745
  type: "apiKey"
50103
50746
  }],
50104
- url: "/studio/v1/works/{work}/drafts/{draft}/outline",
50747
+ url: "/studio/v1/works/{work}/progressions",
50748
+ ...options
50749
+ });
50750
+ var studioProgressionsCreate = (options) => (options.client ?? client).post({
50751
+ security: [{
50752
+ key: "BearerAuth",
50753
+ scheme: "bearer",
50754
+ type: "http"
50755
+ }, {
50756
+ key: "ApiKeyAuth",
50757
+ name: "X-API-Key",
50758
+ type: "apiKey"
50759
+ }],
50760
+ url: "/studio/v1/works/{work}/progressions",
50761
+ ...options,
50762
+ headers: {
50763
+ "Content-Type": "application/json",
50764
+ ...options.headers
50765
+ }
50766
+ });
50767
+ var studioProgressionsDelete = (options) => (options.client ?? client).delete({
50768
+ security: [{
50769
+ key: "BearerAuth",
50770
+ scheme: "bearer",
50771
+ type: "http"
50772
+ }, {
50773
+ key: "ApiKeyAuth",
50774
+ name: "X-API-Key",
50775
+ type: "apiKey"
50776
+ }],
50777
+ url: "/studio/v1/works/{work}/progressions/{id}",
50105
50778
  ...options
50106
50779
  });
50107
50780
  var studioDraftsStatus = (options) => (options.client ?? client).get({
@@ -52366,6 +53039,11 @@ function createDatabase(transport) {
52366
53039
  }
52367
53040
  function createDevops(transport) {
52368
53041
  return {
53042
+ changes: {
53043
+ abandon: bind(transport, devopsChangesAbandon),
53044
+ markLastSlice: bind(transport, devopsChangesMarkLastSlice),
53045
+ retrieve: bind(transport, devopsChangesGet)
53046
+ },
52369
53047
  environments: {
52370
53048
  checkpoints: {
52371
53049
  list: bind(transport, devopsEnvironmentsCheckpointsList)
@@ -52388,6 +53066,10 @@ function createDevops(transport) {
52388
53066
  rollback: bind(transport, devopsProgressiveRolloutsRollback)
52389
53067
  },
52390
53068
  projects: {
53069
+ changes: {
53070
+ create: bind(transport, devopsChangesCreate),
53071
+ list: bind(transport, devopsChangesList)
53072
+ },
52391
53073
  environments: {
52392
53074
  list: bind(transport, devopsEnvironmentsList),
52393
53075
  targets: {
@@ -52841,6 +53523,10 @@ function createSandbox(transport) {
52841
53523
  snapshots: {
52842
53524
  create: bind(transport, postSandboxV1SandboxesBySandboxIdSnapshots)
52843
53525
  },
53526
+ tasks: {
53527
+ create: bind(transport, startSandboxTask),
53528
+ retrieveLog: bind(transport, getSandboxTaskLog)
53529
+ },
52844
53530
  timeout: bind(transport, postSandboxV1SandboxesBySandboxIdTimeout),
52845
53531
  update: bind(transport, renameSandbox),
52846
53532
  updateNetwork: bind(transport, putSandboxV1SandboxesBySandboxIdNetwork),
@@ -52944,6 +53630,11 @@ function createStudio(transport) {
52944
53630
  create: bind(transport, studioWorksCreate),
52945
53631
  drafts: {
52946
53632
  create: bind(transport, studioDraftsCreate),
53633
+ foreshadows: {
53634
+ delete: bind(transport, studioForeshadowsDelete),
53635
+ list: bind(transport, studioForeshadowsList),
53636
+ update: bind(transport, studioForeshadowsUpsert)
53637
+ },
52947
53638
  list: bind(transport, studioDraftsList),
52948
53639
  rebase: bind(transport, studioDraftsRebase),
52949
53640
  renditions: {
@@ -52961,9 +53652,15 @@ function createStudio(transport) {
52961
53652
  batchUpdate: bind(transport, studioUnitsBatchUpdate),
52962
53653
  create: bind(transport, studioUnitsCreate)
52963
53654
  },
52964
- update: bind(transport, studioDraftsUpdate)
53655
+ update: bind(transport, studioDraftsUpdate),
53656
+ updateBrief: bind(transport, studioDraftsUpdateBrief)
52965
53657
  },
52966
53658
  list: bind(transport, studioWorksList),
53659
+ progressions: {
53660
+ create: bind(transport, studioProgressionsCreate),
53661
+ delete: bind(transport, studioProgressionsDelete),
53662
+ list: bind(transport, studioProgressionsList)
53663
+ },
52967
53664
  renditions: {
52968
53665
  delete: bind(transport, studioRenditionsDelete),
52969
53666
  list: bind(transport, studioRenditionsList),
@@ -53000,8 +53697,7 @@ function createStudio(transport) {
53000
53697
  retrieveContext: bind(transport, studioUnitsContext),
53001
53698
  update: bind(transport, studioUnitsUpdate)
53002
53699
  },
53003
- update: bind(transport, studioWorksUpdate),
53004
- updateBrief: bind(transport, studioWorksUpdateBrief)
53700
+ update: bind(transport, studioWorksUpdate)
53005
53701
  }
53006
53702
  };
53007
53703
  }
@@ -57203,6 +57899,7 @@ function nodeToolchainPorts(env, fetchImpl = fetch, home = homedir2()) {
57203
57899
  }
57204
57900
 
57205
57901
  // src/devops/tofu/pure.ts
57902
+ import { isAbsolute, relative } from "node:path";
57206
57903
  var ENVIRONMENT_ID = /^dve_[A-Za-z0-9]+$/;
57207
57904
  function parseEnvironmentId(value) {
57208
57905
  const id = value?.trim();
@@ -57245,21 +57942,48 @@ function parseTofuDeployArgs(flags) {
57245
57942
  ...flags.workdir ? { workdir: flags.workdir } : {}
57246
57943
  };
57247
57944
  }
57248
- function selectTargets(plan, environment2, requested, adapters) {
57945
+ function isExcludedPath(path, exclude) {
57946
+ return exclude.some((pattern) => matchesPattern(pattern, path));
57947
+ }
57948
+ function excludedTargets(plan, environment2, adapters, exclude) {
57949
+ if (exclude.length === 0)
57950
+ return [];
57951
+ return targetsFor(plan, environment2).filter((t) => adapters.has(t.destination) && deploysTo(t, environment2, { named: false }) && isExcludedPath(t.path, exclude)).map((t) => t.path).sort();
57952
+ }
57953
+ function excludedDependencies(targets, excluded) {
57954
+ const dropped = new Set(excluded);
57955
+ const found = [];
57956
+ for (const t of targets)
57957
+ for (const dependency of t.dependsOn) {
57958
+ if (dropped.has(dependency))
57959
+ found.push({ target: t.path, dependency });
57960
+ }
57961
+ return found;
57962
+ }
57963
+ function selectTargets(plan, environment2, requested, adapters, exclude = []) {
57249
57964
  const named = requested !== undefined;
57250
- let targets = targetsFor(plan, environment2).filter((t) => adapters.has(t.destination) && deploysTo(t, environment2, { named }));
57965
+ const dropped = excludedTargets(plan, environment2, adapters, exclude);
57966
+ let targets = targetsFor(plan, environment2).filter((t) => adapters.has(t.destination) && deploysTo(t, environment2, { named }) && !isExcludedPath(t.path, exclude));
57251
57967
  if (requested !== undefined) {
57252
57968
  const known = new Set(plan.targets.map((t) => t.path));
57253
57969
  const missing = requested.filter((r) => !known.has(r));
57254
57970
  if (missing.length > 0)
57255
57971
  throw new UsageError(`unknown target(s): ${missing.join(", ")}`, "Run `praxis devops deploy plan` to list the targets.");
57972
+ const excludedNamed = requested.filter((r) => isExcludedPath(r, exclude));
57973
+ if (excludedNamed.length > 0) {
57974
+ throw new UsageError(`${excludedNamed.join(", ")} is excluded by praxis.yaml`, "devops.deploy.exclude in praxis.yaml removes it from every run: it is not a delivery target. Name another target, or take its path out of that list.");
57975
+ }
57256
57976
  const refused = requested.filter((r) => !targets.some((t) => t.path === r));
57257
57977
  if (refused.length > 0)
57258
57978
  throw new UsageError(`${refused.join(", ")} does not deploy to ${environment2}, or praxis.yaml names no adapter for its destination`, "Check the target's environments, and devops.deploy.adapters in praxis.yaml.");
57259
57979
  targets = targets.filter((t) => requested.includes(t.path));
57260
57980
  }
57981
+ const orphaned = excludedDependencies(targets, dropped);
57982
+ if (orphaned.length > 0) {
57983
+ throw new UsageError(`excluded target(s) still depended on: ${orphaned.map((o) => `${o.target} depends on ${o.dependency}`).join("; ")}`, "devops.deploy.exclude in praxis.yaml must not cover a directory another target binds: remove that path from the exclude list, or keep the dependent out of this run.");
57984
+ }
57261
57985
  const selected = { commit: plan.commit, targets };
57262
- return { targets, layers: layersOf(selected).map((layer) => [...layer]) };
57986
+ return { targets, layers: layersOf(selected).map((layer) => [...layer]), excluded: dropped };
57263
57987
  }
57264
57988
  function blockedBy(targets, broken) {
57265
57989
  const blocked = new Set;
@@ -57294,6 +58018,7 @@ var DEPLOY_SHAPE = `devops:
57294
58018
  deploy:
57295
58019
  adapters:
57296
58020
  cloudflare: bun tofu/adapter.ts
58021
+ exclude: ["**/spec/features/*"] # optional
57297
58022
  policy:
57298
58023
  forbiddenNames: <path> # optional`;
57299
58024
  function parseDeployProject(file) {
@@ -57323,7 +58048,43 @@ ${DEPLOY_SHAPE}`);
57323
58048
  const forbiddenNames = object(policy) ? policy.forbiddenNames : undefined;
57324
58049
  if (forbiddenNames !== undefined && (typeof forbiddenNames !== "string" || forbiddenNames.trim() === ""))
57325
58050
  refuse("devops.deploy.policy.forbiddenNames must be a repository path");
57326
- return { adapters, ...typeof forbiddenNames === "string" ? { forbiddenNames: forbiddenNames.trim() } : {} };
58051
+ const declaredExclude = deploy.exclude;
58052
+ if (declaredExclude !== undefined && (!Array.isArray(declaredExclude) || declaredExclude.some((e) => typeof e !== "string" || e.trim() === ""))) {
58053
+ refuse("devops.deploy.exclude must be a list of non-empty workspace globs");
58054
+ }
58055
+ const declaredAllow = object(policy) ? policy.allowDeletes : undefined;
58056
+ if (declaredAllow !== undefined && (!Array.isArray(declaredAllow) || declaredAllow.some((e) => typeof e !== "string" || e.trim() === ""))) {
58057
+ refuse("devops.deploy.policy.allowDeletes must be a list of resource-address prefixes");
58058
+ }
58059
+ const allowDeletes = Array.isArray(declaredAllow) ? declaredAllow.map((e) => e.trim()) : [];
58060
+ const exclude = Array.isArray(declaredExclude) ? declaredExclude.map((e) => e.trim().replace(/^\.\//, "").replace(/\/+$/, "")) : [];
58061
+ return {
58062
+ adapters,
58063
+ ...typeof forbiddenNames === "string" ? { forbiddenNames: forbiddenNames.trim() } : {},
58064
+ ...exclude.length > 0 ? { exclude } : {},
58065
+ ...allowDeletes.length > 0 ? { allowDeletes } : {}
58066
+ };
58067
+ }
58068
+ function forbiddenDeletes(showJson, allow = []) {
58069
+ let doc;
58070
+ try {
58071
+ doc = JSON.parse(showJson);
58072
+ } catch {
58073
+ return { ok: false, reason: "tofu show -json did not answer a JSON plan" };
58074
+ }
58075
+ const changes = doc.resource_changes;
58076
+ if (changes === undefined)
58077
+ return { ok: true, deletes: [] };
58078
+ if (!Array.isArray(changes))
58079
+ return { ok: false, reason: "the plan document has no resource_changes list" };
58080
+ const deletes = [];
58081
+ for (const change of changes) {
58082
+ const actions = Array.isArray(change.change?.actions) ? change.change.actions : [];
58083
+ const address = typeof change.address === "string" ? change.address : "?";
58084
+ if (actions.includes("delete") && !allow.some((prefix) => address.startsWith(prefix)))
58085
+ deletes.push(address);
58086
+ }
58087
+ return { ok: true, deletes };
57327
58088
  }
57328
58089
  function adapterEnv(input) {
57329
58090
  return {
@@ -57371,6 +58132,66 @@ function forbiddenHits(names, entries) {
57371
58132
  }
57372
58133
  var targetDir = (workdir, target) => `${workdir}/${target}`;
57373
58134
  var planFileOf = (planDir, target) => `${planDir}/${target.replaceAll("/", "__")}.bin`;
58135
+ var renderArchiveOf = (planDir, target) => `${planDir}/${target.replaceAll("/", "__")}.render.tar.gz`;
58136
+ var RENDER_ASSETS_DIR = "__render_assets";
58137
+ var RENDER_EXCLUDES = [".terraform", ".terraform.lock.hcl", "*.tfstate*", "praxis_backend.tf.json"];
58138
+ function underReservedDir(rel) {
58139
+ const d = [",", "|", "#", "%"].find((c) => !rel.includes(c)) ?? ",";
58140
+ return `s${d}^${rel}${d}${RENDER_ASSETS_DIR}/${rel}${d}`;
58141
+ }
58142
+ function renderArchiveArgs(input) {
58143
+ const { archive, targetDir: dir, repoRoot, assetsRel } = input;
58144
+ return [
58145
+ "-czf",
58146
+ archive,
58147
+ "-C",
58148
+ dir,
58149
+ ...RENDER_EXCLUDES.map((name) => `--exclude=./${name}`),
58150
+ ".",
58151
+ ...assetsRel === null ? [] : ["-C", repoRoot, `--transform=${underReservedDir(assetsRel)}`, assetsRel]
58152
+ ];
58153
+ }
58154
+ var renderExtractWorkdirArgs = (archive) => ["-xzf", archive, `--exclude=${RENDER_ASSETS_DIR}`];
58155
+ function renderExtractAssetsArgs(archive) {
58156
+ return ["-xzf", archive, "--wildcards", `--transform=s,^${RENDER_ASSETS_DIR}/,,`, `${RENDER_ASSETS_DIR}/*`];
58157
+ }
58158
+ function renderArchiveAssetsRel(listing) {
58159
+ for (const line of listing) {
58160
+ const rel = line.trim().replace(/^\.\//, "");
58161
+ if (!rel.startsWith(`${RENDER_ASSETS_DIR}/`))
58162
+ continue;
58163
+ const rest = rel.slice(RENDER_ASSETS_DIR.length + 1).replace(/\/+$/, "");
58164
+ if (rest !== "")
58165
+ return rest;
58166
+ }
58167
+ return null;
58168
+ }
58169
+ function clientDirOf(text) {
58170
+ if (text === null)
58171
+ return null;
58172
+ try {
58173
+ const value = JSON.parse(text);
58174
+ return typeof value?.clientDir === "string" && value.clientDir !== "" ? value.clientDir : null;
58175
+ } catch {
58176
+ return null;
58177
+ }
58178
+ }
58179
+ function renderAssetsRel(repoRoot, clientDir) {
58180
+ if (clientDir === null)
58181
+ return null;
58182
+ const rel = relative(repoRoot, clientDir);
58183
+ return rel === "" || rel === ".." || rel.startsWith("../") || isAbsolute(rel) ? null : rel;
58184
+ }
58185
+ function withClientDir(text, clientDir) {
58186
+ let value;
58187
+ try {
58188
+ value = JSON.parse(text);
58189
+ } catch {
58190
+ return null;
58191
+ }
58192
+ return `${JSON.stringify({ ...value, clientDir }, null, 2)}
58193
+ `;
58194
+ }
57374
58195
  var STATE_USERNAME = "praxis";
57375
58196
  var STATE_PASSWORD_ENV = "TF_HTTP_PASSWORD";
57376
58197
  function stateAddress(backend, target) {
@@ -57395,21 +58216,56 @@ function backendDocument(backend, target) {
57395
58216
  }
57396
58217
 
57397
58218
  // src/devops/tofu/run.ts
57398
- import { dirname as dirname4, isAbsolute, resolve as resolve3 } from "node:path";
58219
+ import { dirname as dirname4, isAbsolute as isAbsolute2, resolve as resolve3 } from "node:path";
58220
+ function plannedTargetsOf(summaryText) {
58221
+ if (summaryText === null)
58222
+ return;
58223
+ try {
58224
+ const summary = JSON.parse(summaryText);
58225
+ if (!Array.isArray(summary.targets))
58226
+ return;
58227
+ return summary.targets.filter((t) => t.status === "planned" && typeof t.target === "string").map((t) => t.target);
58228
+ } catch {
58229
+ return;
58230
+ }
58231
+ }
58232
+ function planReadyLine(summary) {
58233
+ const planned = new Set(summary.targets.filter((t) => t.status === "planned").map((t) => t.target));
58234
+ const layers = summary.layers.map((layer) => layer.filter((path) => planned.has(path))).filter((layer) => layer.length > 0);
58235
+ const migrations = summary.targets.flatMap((t) => {
58236
+ const files = t.status === "planned" ? t.pending.filter((line) => line.startsWith("d1 migrations ")) : [];
58237
+ return files.length === 0 ? [] : [{ targetPath: t.target, files }];
58238
+ });
58239
+ return { type: "plan.ready", layers, migrations };
58240
+ }
58241
+ function failureDigest(summary) {
58242
+ const count2 = (status) => summary.targets.filter((t) => t.status === status).length;
58243
+ const lines = [`RESULT ${summary.finished} planned=${count2("planned")} succeeded=${count2("succeeded")} failed=${count2("failed")} blocked=${count2("blocked")}`];
58244
+ for (const t of summary.targets) {
58245
+ if (t.status === "failed" || t.status === "blocked" && t.message !== "a target it depends on did not finish")
58246
+ lines.push(`FAILED ${t.target}: ${t.message ?? t.status}`);
58247
+ }
58248
+ return lines;
58249
+ }
57399
58250
  var BACKEND_FILE = "praxis_backend.tf.json";
58251
+ var NATIVE_PLAN = `praxis-native-target: deployed by wrangler after approval; no OpenTofu plan
58252
+ `;
57400
58253
  async function runTofuDeploy(args, plan, ports) {
57401
58254
  const { fs, exec, out } = ports;
57402
58255
  const startedAt = ports.clock.iso();
57403
58256
  const root = resolve3(ports.repoRoot);
57404
- const absolute = (p) => isAbsolute(p) ? p : resolve3(p);
58257
+ const absolute = (p) => isAbsolute2(p) ? p : resolve3(p);
57405
58258
  const workdir = absolute(args.workdir ?? `${root}/.tofu-work`);
57406
58259
  const planDir = absolute(args.planDir ?? `${workdir}/plans`);
57407
58260
  const applying = args.mode !== "plan-only";
57408
58261
  const events = applying && args.eventsFile !== undefined ? ports.openEvents(args.eventsFile, startedAt) : undefined;
57409
58262
  const reports = new Map;
57410
- const selection = selectTargets(plan, args.environment, args.targets, new Set(Object.keys(ports.project.adapters)));
58263
+ const targets = args.targets ?? (args.mode === "apply-plans" ? plannedTargetsOf(await fs.read(`${planDir}/summary.json`)) : undefined);
58264
+ const selection = selectTargets(plan, args.environment, targets, new Set(Object.keys(ports.project.adapters)), ports.project.exclude ?? []);
57411
58265
  const byPath = new Map(selection.targets.map((t) => [t.path, t]));
57412
58266
  const redact = (line) => ports.state.password === "" ? line : line.split(ports.state.password).join("***");
58267
+ for (const path of selection.excluded)
58268
+ out(`excluded by praxis.yaml: ${path}`);
57413
58269
  const finish = (finished2, message2) => {
57414
58270
  if (events)
57415
58271
  events.finish(message2 === undefined ? {} : { message: message2 });
@@ -57425,6 +58281,9 @@ async function runTofuDeploy(args, plan, ports) {
57425
58281
  };
57426
58282
  const writeSummary = async (summary) => {
57427
58283
  await fs.write(`${planDir}/summary.json`, `${JSON.stringify(summary, null, 2)}
58284
+ `);
58285
+ if (args.mode === "plan-only")
58286
+ await fs.write(`${planDir}/plan-ready.json`, `${JSON.stringify(planReadyLine(summary))}
57428
58287
  `);
57429
58288
  out(`SUMMARY ${JSON.stringify(summary)}`);
57430
58289
  };
@@ -57460,7 +58319,55 @@ async function runTofuDeploy(args, plan, ports) {
57460
58319
  if (code !== 0)
57461
58320
  throw new StepFailed(kind === "engine" ? `rollout step ${cmdArgs[0]} exited ${code}` : `adapter ${cmdArgs[0]} exited ${code}`);
57462
58321
  };
58322
+ const deletesOf = async (t, planFile, cwd, env) => {
58323
+ const resolved = await ports.toolchain.ensure();
58324
+ const lines = [];
58325
+ const code = await exec.run(resolved.binary, ["show", "-json", "-no-color", planFile], { cwd, env: { ...resolved.env, ...env }, onLine: (line) => {
58326
+ lines.push(line);
58327
+ } });
58328
+ if (code !== 0)
58329
+ throw new StepFailed(`rollout step show exited ${code}`);
58330
+ const verdict = forbiddenDeletes(lines.join(`
58331
+ `), ports.project.allowDeletes ?? []);
58332
+ if (!verdict.ok)
58333
+ throw new StepFailed(verdict.reason);
58334
+ if (verdict.deletes.length > 0) {
58335
+ throw new StepFailed(`the plan deletes or replaces ${verdict.deletes.join(", ")}; refused (praxis.yaml devops.deploy.policy.allowDeletes allows none of them)`);
58336
+ }
58337
+ };
57463
58338
  const adapter = (t, phase) => step(t, "adapter", [phase], root, adapterEnv({ target: t.path, environment: args.environment, mode: args.mode, commit: args.commit, dir: targetDir(workdir, t.path) }));
58339
+ const tarStep = async (t, cmdArgs, cwd, lines) => {
58340
+ const say = (line) => {
58341
+ out(`[${t.path}] ${redact(line)}`);
58342
+ lines?.push(line);
58343
+ };
58344
+ const code = await exec.run("tar", cmdArgs, { cwd, onLine: say });
58345
+ if (code !== 0)
58346
+ throw new StepFailed(`render archive tar ${cmdArgs[0]} exited ${code}`);
58347
+ };
58348
+ const packRender = async (t, dir) => {
58349
+ const archive = renderArchiveOf(planDir, t.path);
58350
+ const assetsRel = renderAssetsRel(root, clientDirOf(await fs.read(`${dir}/frontend.json`)));
58351
+ await tarStep(t, renderArchiveArgs({ archive, targetDir: dir, repoRoot: root, assetsRel }), root);
58352
+ out(`[${t.path}] render archive ${archive}${assetsRel === null ? "" : ` (+ ${assetsRel})`}`);
58353
+ };
58354
+ const unpackRender = async (t, dir) => {
58355
+ const archive = renderArchiveOf(planDir, t.path);
58356
+ await fs.mkdirp(dir);
58357
+ await tarStep(t, renderExtractWorkdirArgs(archive), dir);
58358
+ const listing = [];
58359
+ await tarStep(t, ["-tzf", archive], root, listing);
58360
+ const assetsRel = renderArchiveAssetsRel(listing);
58361
+ if (assetsRel === null)
58362
+ return;
58363
+ await tarStep(t, renderExtractAssetsArgs(archive), root);
58364
+ const frontend = await fs.read(`${dir}/frontend.json`);
58365
+ const rewritten = frontend === null ? null : withClientDir(frontend, `${root}/${assetsRel}`);
58366
+ if (rewritten === null)
58367
+ throw new StepFailed(`render archive ${archive} carries ${assetsRel} but ${dir}/frontend.json is missing or not JSON`);
58368
+ await fs.write(`${dir}/frontend.json`, rewritten);
58369
+ out(`[${t.path}] static assets restored to ${root}/${assetsRel}`);
58370
+ };
57464
58371
  const broken = new Set;
57465
58372
  const manifests = new Map;
57466
58373
  const fail = (t, message2, began, extra = {}) => {
@@ -57479,15 +58386,26 @@ async function runTofuDeploy(args, plan, ports) {
57479
58386
  return await refuseAll(`policy.forbiddenNames ${ports.project.forbiddenNames} is missing; the policy check cannot run`);
57480
58387
  forbidden = parseNameList(text);
57481
58388
  }
58389
+ const rendered = new Set;
57482
58390
  await pool(selection.targets, LAYER_CONCURRENCY, async (t) => {
57483
58391
  const began = ports.clock.now();
57484
58392
  const dir = targetDir(workdir, t.path);
57485
58393
  try {
57486
- if (args.mode === "apply-plans" && !await fs.exists(planFileOf(planDir, t.path))) {
57487
- throw new StepFailed(`plan file ${planFileOf(planDir, t.path)} is missing; refusing to apply without it`);
58394
+ const planFile = planFileOf(planDir, t.path);
58395
+ if (args.mode === "apply-plans" && !await fs.exists(planFile)) {
58396
+ throw new StepFailed(`plan file ${planFile} is missing; refusing to apply without it`);
58397
+ }
58398
+ const nativeApply = args.mode === "apply-plans" && await fs.read(planFile) === NATIVE_PLAN;
58399
+ const archive = renderArchiveOf(planDir, t.path);
58400
+ if (args.mode === "apply-plans" && !nativeApply && await fs.exists(archive)) {
58401
+ await unpackRender(t, dir);
58402
+ rendered.add(t.path);
58403
+ } else {
58404
+ if (args.mode === "apply-plans" && !nativeApply)
58405
+ out(`[${t.path}] no render archive in the plan; rebuilding`);
58406
+ await fs.mkdirp(dir);
58407
+ await adapter(t, "generate");
57488
58408
  }
57489
- await fs.mkdirp(dir);
57490
- await adapter(t, "generate");
57491
58409
  const manifest = parseTargetManifest(await fs.read(`${dir}/target.json`));
57492
58410
  if (typeof manifest === "string")
57493
58411
  throw new StepFailed(`adapter generate: ${manifest}`);
@@ -57528,6 +58446,23 @@ async function runTofuDeploy(args, plan, ports) {
57528
58446
  out(`[${target}] pending until an approved apply: ${p}`);
57529
58447
  const engineEnv = { [STATE_PASSWORD_ENV]: ports.state.password };
57530
58448
  try {
58449
+ if (await fs.exists(`${dir}/native.json`)) {
58450
+ if (args.mode !== "apply-plans") {
58451
+ await adapter(t, "before-plan");
58452
+ await fs.mkdirp(dirname4(planFile));
58453
+ await fs.write(planFile, NATIVE_PLAN);
58454
+ out(`[${target}] native: no OpenTofu plan; wrangler deploys it after approval`);
58455
+ }
58456
+ if (applying) {
58457
+ if (await fs.read(planFile) !== NATIVE_PLAN)
58458
+ throw new StepFailed(`plan file ${planFile} is not the native marker this target's plan wrote`);
58459
+ await adapter(t, "before-apply");
58460
+ }
58461
+ reports.set(target, { target, status: applying ? "succeeded" : "planned", planFile, pending: manifest.pending, warnings: manifest.warnings, ...rendered.has(target) ? { rendered: true } : {} });
58462
+ if (events)
58463
+ events.end(target, "deploy", { kind: "succeeded", durationMs: ports.clock.now() - began });
58464
+ return;
58465
+ }
57531
58466
  if (args.mode !== "apply-plans")
57532
58467
  await adapter(t, "before-plan");
57533
58468
  await step(t, "engine", ["init", "-input=false"], dir, engineEnv);
@@ -57535,12 +58470,15 @@ async function runTofuDeploy(args, plan, ports) {
57535
58470
  await fs.mkdirp(dirname4(planFile));
57536
58471
  await step(t, "engine", ["plan", "-input=false", "-no-color", `-out=${planFile}`], dir, engineEnv);
57537
58472
  }
58473
+ await deletesOf(t, planFile, dir, engineEnv);
58474
+ if (args.mode === "plan-only")
58475
+ await packRender(t, dir);
57538
58476
  if (applying) {
57539
58477
  await adapter(t, "before-apply");
57540
58478
  await step(t, "engine", ["apply", "-input=false", "-no-color", planFile], dir, engineEnv);
57541
58479
  await adapter(t, "after-apply");
57542
58480
  }
57543
- reports.set(target, { target, status: applying ? "succeeded" : "planned", planFile, pending: manifest.pending, warnings: manifest.warnings });
58481
+ reports.set(target, { target, status: applying ? "succeeded" : "planned", planFile, pending: manifest.pending, warnings: manifest.warnings, ...rendered.has(target) ? { rendered: true } : {} });
57544
58482
  if (events)
57545
58483
  events.end(target, "deploy", { kind: "succeeded", durationMs: ports.clock.now() - began });
57546
58484
  } catch (error) {
@@ -57909,6 +58847,8 @@ async function devopsDeployTofu(flags, ports) {
57909
58847
  out: ports.stdout
57910
58848
  });
57911
58849
  ports.emit({ kind: "object", data: result.summary });
58850
+ for (const line of failureDigest(result.summary))
58851
+ ports.stdout(line);
57912
58852
  return result.exitCode;
57913
58853
  }
57914
58854
 
@@ -58645,7 +59585,7 @@ function pathLineBounds(geometry) {
58645
59585
  }
58646
59586
  if (command === null)
58647
59587
  return null;
58648
- const relative = command === command.toLowerCase();
59588
+ const relative2 = command === command.toLowerCase();
58649
59589
  const upper = command.toUpperCase();
58650
59590
  if (upper === "H" || upper === "V") {
58651
59591
  const value = tokens[i];
@@ -58653,9 +59593,9 @@ function pathLineBounds(geometry) {
58653
59593
  return null;
58654
59594
  i++;
58655
59595
  if (upper === "H")
58656
- x = relative ? x + value : value;
59596
+ x = relative2 ? x + value : value;
58657
59597
  else
58658
- y = relative ? y + value : value;
59598
+ y = relative2 ? y + value : value;
58659
59599
  add(x, y);
58660
59600
  continue;
58661
59601
  }
@@ -58663,8 +59603,8 @@ function pathLineBounds(geometry) {
58663
59603
  if (typeof nx !== "number" || typeof ny !== "number")
58664
59604
  return null;
58665
59605
  i += 2;
58666
- x = relative ? x + nx : nx;
58667
- y = relative ? y + ny : ny;
59606
+ x = relative2 ? x + nx : nx;
59607
+ y = relative2 ? y + ny : ny;
58668
59608
  if (upper === "M") {
58669
59609
  startX = x;
58670
59610
  startY = y;
@@ -60574,7 +61514,7 @@ function timestamp(key, value) {
60574
61514
  const time = typeof value === "number" ? Math.abs(value) < 100000000000 ? value * 1000 : value : typeof value === "string" && /^\d{4}-\d\d-\d\d[T ]/.test(value) ? Date.parse(value) : NaN;
60575
61515
  return Number.isFinite(time) ? new Date(time).toISOString() : undefined;
60576
61516
  }
60577
- function relative(iso, now) {
61517
+ function relative2(iso, now) {
60578
61518
  const delta = now - Date.parse(iso), seconds = Math.floor(Math.abs(delta) / 1000);
60579
61519
  if (Math.abs(delta) < 60000)
60580
61520
  return "just now";
@@ -60713,7 +61653,7 @@ function table(items, ctx, paint) {
60713
61653
  const now = ctx.now ?? Date.now();
60714
61654
  let rows = items.map((item) => columns.map((key) => {
60715
61655
  const v = record(item)[key], iso = timestamp(key, v);
60716
- return plain(iso ? relative(iso, now) : scalar(v));
61656
+ return plain(iso ? relative2(iso, now) : scalar(v));
60717
61657
  }));
60718
61658
  let headers = columns.map((key) => key.toUpperCase());
60719
61659
  let sizes = columns.map((_, i) => Math.max(width(headers[i]), ...rows.map((row) => width(row[i]))));
@@ -60753,7 +61693,7 @@ function objectView(data, resource, id, ctx, paint) {
60753
61693
  function value(key, v, depth) {
60754
61694
  const iso = timestamp(key, v);
60755
61695
  if (iso)
60756
- return `${iso} (${relative(iso, now)})`;
61696
+ return `${iso} (${relative2(iso, now)})`;
60757
61697
  if (Array.isArray(v)) {
60758
61698
  if (v.every((x) => x === null || typeof x !== "object"))
60759
61699
  return v.map(scalar).map(plain).join(", ");
@@ -61133,7 +62073,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
61133
62073
  }
61134
62074
 
61135
62075
  // src/main.ts
61136
- var version = "0.3.0-dev.b4c63c2";
62076
+ var version = "0.3.0-dev.b58d05d";
61137
62077
  var commands = commandTree(operations);
61138
62078
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
61139
62079
  function route(argv) {