@deepraxis/cli 0.3.0-dev.fa6f8b5 → 0.3.0-dev.fc91058

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 -4
  2. package/dist/praxis.js +799 -86
  3. package/package.json +1 -1
package/dist/praxis.js CHANGED
@@ -13984,8 +13984,11 @@ var init_flag_registry_generated = __esm(() => {
13984
13984
  FLAGS = {
13985
13985
  "agent-cognition-idle-wake": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "genius", ticket: 540, expires: "2026-11-30", system: "flagship" },
13986
13986
  "cognition-weight-driven": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "praxis-bd", ticket: 1760, expires: "2026-12-05", system: "devops" },
13987
+ "delivery-rules-v2": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "usr_t60d4g5z82rhbtbfrfxfbdxe", ticket: 2048, expires: "2026-11-28", system: "devops" },
13987
13988
  "model-access-gate": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "usr_t60d4g5z82rhbtbfrfxfbdxe", ticket: 1933, expires: "2026-12-15", system: "devops" },
13988
13989
  "open-project": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "praxis-51", ticket: 1488, expires: "2026-11-25", system: "devops" },
13990
+ "requests-v1": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "usr_t60d4g5z82rhbtbfrfxfbdxe", ticket: 2057, expires: "2026-11-28", system: "devops" },
13991
+ "router-precommit-hedge": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "usr_t60d4g5z82rhbtbfrfxfbdxe", ticket: 2052, expires: "2026-11-28", system: "devops" },
13989
13992
  "search-provider-routing": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "praxis-98", ticket: 716, expires: "2026-12-31", system: "devops" },
13990
13993
  "unit-live-probe": { kind: "RELEASE", type: "BOOLEAN", default: false, owner: "usr_t60d4g5z82rhbtbfrfxfbdxe", ticket: null, expires: "2026-11-19", system: "devops" }
13991
13994
  };
@@ -14031,6 +14034,8 @@ function checkFlags(files, registry, today = new Date().toISOString().slice(0, 1
14031
14034
  add(f, browserList.index + entry.index, `unregistered browser flag key "${entry[1]}"`);
14032
14035
  }
14033
14036
  }
14037
+ if (/\.generated\.[cm]?[jt]sx?$/.test(f.path))
14038
+ continue;
14034
14039
  const calls = /(\.bool|\breadBrowserFlag|\buseBrowserFlag)\s*\(\s*([^,)\n]+)/g;
14035
14040
  for (const m of f.text.matchAll(calls)) {
14036
14041
  if (/function\s*$/.test(f.text.slice(Math.max(0, m.index - 20), m.index)))
@@ -14539,7 +14544,7 @@ import { mkdir as mkdir4, readFile as readFile7, readdir as readdir3, writeFile
14539
14544
  import { resolve as resolve11 } from "node:path";
14540
14545
  import { pathToFileURL } from "node:url";
14541
14546
  import { createHash as createHash5 } from "node:crypto";
14542
- import { spawn as spawn4 } from "node:child_process";
14547
+ import { spawn as spawn5 } from "node:child_process";
14543
14548
  import { createInterface } from "node:readline";
14544
14549
 
14545
14550
  // ../../packages/sdk/typescript/src/operations.generated.ts
@@ -15983,18 +15988,14 @@ Praxis extension: the preview conversion endpoint. The browser never parses an u
15983
15988
  description: "Computer id (cmp_...), as returned by computers.create or computers.list."
15984
15989
  }
15985
15990
  ],
15986
- query: [],
15987
- body: {
15988
- required: true,
15989
- fields: [
15990
- {
15991
- name: "name",
15992
- type: "string",
15993
- required: true,
15994
- description: "Name of the entry or object."
15995
- }
15996
- ]
15997
- }
15991
+ query: [
15992
+ {
15993
+ name: "path",
15994
+ type: "string",
15995
+ required: true,
15996
+ description: "Absolute path of the document on the computer, for example /home/user/workspace/deck.pptx. The request has no body."
15997
+ }
15998
+ ]
15998
15999
  },
15999
16000
  {
16000
16001
  resource: "agent.computers.leases",
@@ -16986,6 +16987,68 @@ delete it. Omit the field to preserve.`
16986
16987
  ],
16987
16988
  query: []
16988
16989
  },
16990
+ {
16991
+ resource: "agent.sessions.artifacts",
16992
+ method: "list",
16993
+ summary: "List Session Artifacts (Extension)",
16994
+ description: `List the files this session delivered; an end-customer token reads its own session.
16995
+
16996
+ Own-face extension. Returns { data: Artifact[] } ordered by create_time. Each artifact is one file in the session outputs directory with id, name, version, parts, source_hrefs, create_time and update_time. Delivering the same path again keeps the id and adds one to version. Files are captured seconds after the turn ends, so artifacts appear after session.status_idle; also watch the agent.artifact_delivered event. Whoever may read the session may read its artifacts; a session that is missing or not yours returns 404.`,
16997
+ http: "GET",
16998
+ path: "/agent/v1/sessions/{session_id}/artifacts",
16999
+ streaming: "no",
17000
+ pagination: false,
17001
+ pathParams: [
17002
+ {
17003
+ name: "session_id",
17004
+ sdkName: "session_id",
17005
+ description: "Session id from session creation or listing."
17006
+ }
17007
+ ],
17008
+ query: []
17009
+ },
17010
+ {
17011
+ resource: "agent.sessions.artifacts.contentUrl",
17012
+ method: "create",
17013
+ summary: "Create Artifact Content URL (Extension)",
17014
+ description: `Mint a short-lived download address for one file of an artifact.
17015
+
17016
+ Own-face extension. The body is optional: part (index into the artifact parts, default 0) and ttl_seconds (60 to 300, default 300). Returns { url, expire_time }. The address works for minutes; do not store or log it. An unknown artifact or an out-of-range part returns 404 ARTIFACT_NOT_FOUND, a session that is missing or not yours returns 404, and a ttl_seconds outside 60 to 300 returns 400.`,
17017
+ http: "POST",
17018
+ path: "/agent/v1/sessions/{session_id}/artifacts/{artifact_id}/content_url",
17019
+ streaming: "no",
17020
+ pagination: false,
17021
+ pathParams: [
17022
+ {
17023
+ name: "session_id",
17024
+ sdkName: "session_id",
17025
+ description: "Session id from session creation or listing."
17026
+ },
17027
+ {
17028
+ name: "artifact_id",
17029
+ sdkName: "artifact_id",
17030
+ description: "Artifact id (art_...) from the artifact list or an agent.artifact_delivered event."
17031
+ }
17032
+ ],
17033
+ query: [],
17034
+ body: {
17035
+ required: false,
17036
+ fields: [
17037
+ {
17038
+ name: "part",
17039
+ type: "integer",
17040
+ required: false,
17041
+ description: "Index into the artifact's parts; defaults to 0."
17042
+ },
17043
+ {
17044
+ name: "ttl_seconds",
17045
+ type: "integer",
17046
+ required: false,
17047
+ description: "How long the address works, 60 to 300 seconds; defaults to 300."
17048
+ }
17049
+ ]
17050
+ }
17051
+ },
16989
17052
  {
16990
17053
  resource: "agent.sessions.backgroundTasks",
16991
17054
  method: "list",
@@ -17169,7 +17232,7 @@ Praxis extension available only on /agent/v1, following Claude Agent SDK getCont
17169
17232
  resource: "agent.sessions.events",
17170
17233
  method: "list",
17171
17234
  summary: "List session events",
17172
- description: "Read the event history of a session as a page of events, oldest first by default (order=desc for newest first). Use it after sending a message to collect the reply, to find tool calls that wait for approval or client custom tool results (session.status_idle with stop_reason requires_action lists their event_ids), or to audit a run; to follow a running session live use sessions.events.stream instead. Filter by types and by a created_at range on processed_at; pages hold at most 100 events (default 20) and next_page continues. A failed run emits session.error before session.status_terminated. Native history also includes user.steer, user.withdraw, system.notification, session.forked, session.goal_changed and session.goal_verification; these are not accepted by the /anthropic/v1 event-type filter. This operation addresses one session — normally a worker session an agent dispatched; to talk to a personal or general agent itself, use agents.events.list instead. In the path, session_id may also be `main` (your own main session with that agent) or a short session name, and either alias then requires agent_id with the agent_… id, the eight character identity number or the handle; only the own face /agent/v1 accepts an alias, /anthropic/v1 requires a real sesn_… id.",
17235
+ description: "Read the event history of a session as a page of events, oldest first by default (order=desc for newest first). Use it after sending a message to collect the reply, to find tool calls that wait for approval or client custom tool results (session.status_idle with stop_reason requires_action lists their event_ids; a request nobody answered within 24 hours is settled as unanswered and the session goes idle with stop_reason request_expired, which the /anthropic/v1 face shows as end_turn), or to audit a run; to follow a running session live use sessions.events.stream instead. Filter by types and by a created_at range on processed_at; pages hold at most 100 events (default 20) and next_page continues. A failed run emits session.error before session.status_terminated. Native history also includes user.steer, user.withdraw, system.notification, session.forked, session.goal_changed and session.goal_verification; these are not accepted by the /anthropic/v1 event-type filter. This operation addresses one session — normally a worker session an agent dispatched; to talk to a personal or general agent itself, use agents.events.list instead. In the path, session_id may also be `main` (your own main session with that agent) or a short session name, and either alias then requires agent_id with the agent_… id, the eight character identity number or the handle; only the own face /agent/v1 accepts an alias, /anthropic/v1 requires a real sesn_… id.",
17173
17236
  http: "GET",
17174
17237
  path: "/agent/v1/sessions/{session_id}/events",
17175
17238
  streaming: "no",
@@ -17328,6 +17391,26 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
17328
17391
  ]
17329
17392
  }
17330
17393
  },
17394
+ {
17395
+ resource: "agent.sessions.requests",
17396
+ method: "list",
17397
+ summary: "List Session Requests (Extension)",
17398
+ description: `List the requests a session is waiting on; an end-customer token reads its own session.
17399
+
17400
+ Own-face extension. When a session stops at session.status_idle with stop_reason requires_action, read what it waits on here instead of replaying events. Returns { data: Request[] } ordered by create_time, an empty array when nothing is pending, not paginated. Each request has id (the pending tool call id), object (request), kind (question for the ask_user_question tool, approval for any other tool that waits for permission), status (pending), tool_name, input (the same input the agent.tool_use event shows), create_time and expire_time. Answer a request as before: send a user.tool_confirmation event for its id. expire_time is set only for a session with no collaboration mode while the requests-v1 release is on (create_time plus 24 hours; an expired request counts as declined), otherwise null. Answered, expired and superseded requests are not listed, and neither are pending custom tool results (user.custom_tool_result). Whoever may read the session may read its requests; a session that is missing or not yours returns 404.`,
17401
+ http: "GET",
17402
+ path: "/agent/v1/sessions/{session_id}/requests",
17403
+ streaming: "no",
17404
+ pagination: false,
17405
+ pathParams: [
17406
+ {
17407
+ name: "session_id",
17408
+ sdkName: "session_id",
17409
+ description: "Session id from session creation or listing."
17410
+ }
17411
+ ],
17412
+ query: []
17413
+ },
17331
17414
  {
17332
17415
  resource: "agent.sessions.resources",
17333
17416
  method: "list",
@@ -25380,6 +25463,12 @@ Published at https://docs.deepraxis.com/docs/developers/cut/script-reference wit
25380
25463
  - \`RippleDeleteRange\` — Cut a time range and close the gap.
25381
25464
  - \`DeleteWords\` — Cut transcript words and ripple every track, keeping a breath.
25382
25465
  - \`RemoveFillers\` — List and delete filler words by media's own labels; dryRun first.
25466
+ - \`Matte\` — Replace the clip's background with media's matte of its source, read as a luma mask.
25467
+ - \`EnhanceVoice\` — Replace a clip's sound with media's enhanced speech on its own audio track.
25468
+ - \`AlignByAudio\` — Line two recordings of the same sound up by media's measurement of their offset.
25469
+ - \`Reframe\` — Swap the clip's media for media's reframed take at the aspect you ask for.
25470
+ - \`Upscale\` — Swap the clip's media for media's upscaled take at the height you ask for.
25471
+ - \`Redact\` — Pixelate the faces, QR codes or text media marks, leaving the rest of the frame plain.
25383
25472
  - \`AddTrack\` — Add a video, audio or caption track.
25384
25473
  - \`MoveTrack\` — Move a track between layers; 0 is the topmost.
25385
25474
  - \`UpdateTrack\` — Change a track's name, lock, gain or role.
@@ -25483,6 +25572,9 @@ Published at https://docs.deepraxis.com/docs/developers/cut/script-reference wit
25483
25572
  - \`MEDIA_OFFLINE\` — The asset cannot be fetched right now.
25484
25573
  - \`MEDIA_UNAVAILABLE\` — The asset is not usable for rendering.
25485
25574
  - \`MEDIA_IMPORT_FAILED\` — Importing media failed.
25575
+ - \`MEDIA_PROCESSING\` — Media is still processing the clip; wait for the job and rerun.
25576
+ - \`MEDIA_PROCESSING_FAILED\` — Media's processing job failed; nothing changed.
25577
+ - \`ALIGNMENT_UNCERTAIN\` — \`AlignByAudio\` confidence too low; nothing changed.
25486
25578
  - \`FRAME_OUT_OF_RANGE\` — The preview time is outside the project.
25487
25579
  - \`PROJECT_TOO_LARGE\` — The project exceeds the size limit.
25488
25580
  - \`RESPONSE_TOO_LARGE\` — The response would exceed its budget.
@@ -27006,7 +27098,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
27006
27098
  resource: "devops.flags",
27007
27099
  method: "archive",
27008
27100
  summary: "Archive a flag",
27009
- description: "Archive a flag whose code is gone: it stops evaluating in every environment, leaves the ordinary flag list and keeps its key and history. Archiving changes the flag's lifecycle only and does not check code references: codeRefs.count on the flag is informational, and the call succeeds even while code still names the key (ticket #1881), in which case that code gets its default. It is irreversible through the API: there is no unarchive call, an archived flag cannot be updated or configured, and its key stays reserved, so a later create with the same key is refused; archiving an archived flag just answers it again. A flag that may come back is turned off in its environment instead. The order is: open the flag fully (`praxis api devops flag environment update`), delete the code that names the key and deploy that, run `praxis devops flag remove <key>` (local, lists the references still naming the key), then `praxis api devops flag archive <id>`, then `praxis devops flag sync` so the local registry drops it. There is no separate delete call.",
27101
+ description: "Archive a flag whose code is gone: it stops evaluating in every environment, leaves the ordinary flag list and keeps its key and history. Archiving is the delete, and the platform refuses it while the last reported scan still finds the key in code or while the flag is on in an environment: a flag whose codeRefs.count is above zero is refused with FLAG_STILL_REFERENCED, and a flag whose on state is true in any environment is refused with FLAG_HAS_LIVE_RULES, so archiving succeeds only once the code that names the key is deployed away and every environment is off. The gate reads the stored scan as it stands — an out-of-date scannedCommit is not corrected for — and there is no force flag. It is irreversible through the API: there is no unarchive call, an archived flag cannot be updated or configured, and its key stays reserved, so a later create with the same key is refused; archiving an archived flag just answers it again. A flag that may come back is turned off in its environment instead. The order is: open the flag fully (`praxis api devops flag environment update`), delete the code that names the key and deploy that, run `praxis devops flag remove <key>` (local, lists the references still naming the key), then `praxis api devops flag archive <id>`, then `praxis devops flag sync` so the local registry drops it. There is no separate delete call.",
27010
27102
  http: "POST",
27011
27103
  path: "/devops/v1/flags/{id}:archive",
27012
27104
  streaming: "no",
@@ -27870,6 +27962,42 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
27870
27962
  }
27871
27963
  }
27872
27964
  },
27965
+ {
27966
+ resource: "devops.projects.flags",
27967
+ method: "reportCodeRefs",
27968
+ summary: "Report a project's flag code references",
27969
+ description: "Store one code-reference scan for a project in a single call: send the commit the scan read (scannedCommit, the checkout's `git rev-parse HEAD`) and, for every flag key the scan knows, the places code reads it ({path, line, snippet}). Send every key the checkout still expects to be referenced, including the ones found nowhere: a project flag with no entry in refs is stored with zero references, and zero is what lets `archive` see the code that named the flag is gone. A key that matches no live flag of the project — one already archived, or from another project — is returned in unknownKeys and stores nothing; reporting it is not an error. updated is how many flags were written, which is every live flag of the project because each gets a row. This is the write side of the archive gate: `POST /v1/flags/{id}:archive` refuses with FLAG_STILL_REFERENCED while the stored count is above zero, and the count it reads is exactly the one stored here. Staleness is not corrected for — the stored scannedCommit and count are used as they stand. At most 500 references are stored per flag; a longer list is truncated for storage while count still reports the true number. Reporting changes no flag's runtime behaviour.",
27970
+ http: "POST",
27971
+ path: "/devops/v1/projects/{project}/flags/code-refs",
27972
+ streaming: "no",
27973
+ pagination: false,
27974
+ pathParams: [
27975
+ {
27976
+ name: "project",
27977
+ sdkName: "project",
27978
+ description: "Identifies the project whose data you are reading, from the project list or create answer."
27979
+ }
27980
+ ],
27981
+ query: [],
27982
+ body: {
27983
+ required: true,
27984
+ fields: [
27985
+ {
27986
+ name: "scannedCommit",
27987
+ type: "string",
27988
+ required: true,
27989
+ description: "The commit this scan read, from `git rev-parse HEAD` in the reporting checkout; it is stored as each flag's codeRefs.scannedCommit, so a value older than the current head means the count describes the code as it was then."
27990
+ },
27991
+ {
27992
+ name: "refs",
27993
+ type: "array",
27994
+ itemType: "object",
27995
+ required: true,
27996
+ description: "One entry per flag key this scan judged. Send every key the checkout still expects to be referenced, including the ones found nowhere: a project flag with no entry here is stored with zero references, which is what later lets `archive` refuse only flags code still names."
27997
+ }
27998
+ ]
27999
+ }
28000
+ },
27873
28001
  {
27874
28002
  resource: "devops.projects.promotions",
27875
28003
  method: "list",
@@ -31712,11 +31840,57 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
31712
31840
  ]
31713
31841
  }
31714
31842
  },
31843
+ {
31844
+ resource: "media.libraries.assets.align",
31845
+ method: "create",
31846
+ summary: "Align asset",
31847
+ description: "Align two recordings by their sound and learn how they line up, without producing an asset. The route names the source asset; the body names the reference to compare against it. Both must be audio or a video, of the same library; anything else is refused with REFERENCE_TYPE_MISMATCH before a job exists. The call is an analysis: it decides and charges nothing else, bills per second of input, and stores no asset — the completed job carries the answer in result, offset_seconds saying how many seconds later the reference starts (so a caller holding both recordings knows which one to slide) and confidence how sure the correlation is. The analysis is idempotent on the source, the reference and the parameters: asking again with the same pair answers the completed job and its result instead of analysing and charging again. A max_offset_seconds caps how far apart the two may be; alignment needs an alignment model from the platform model catalogue, and with none published the request is refused with OPERATION_NOT_SUPPORTED, 尚未上架. Send Idempotency-Key, or idempotency_key in the body, to retry without analysing twice. The response is 202 with a queued Job whose operation is align; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until it is completed or failed, then read result. Example: POST /media/v1/libraries/lib_example/assets/9dfa312ef9bc4b00816339b598b1152c/align with {\"reference_asset_id\":\"3f2a9c1e5b7d4e6f8a0b1c2d3e4f5a6b\",\"max_offset_seconds\":30}.",
31848
+ http: "POST",
31849
+ path: "/media/v1/libraries/{library_id}/assets/{asset_id}/align",
31850
+ streaming: "no",
31851
+ pagination: false,
31852
+ pathParams: [
31853
+ {
31854
+ name: "library_id",
31855
+ sdkName: "library_id",
31856
+ description: "Library ID returned by creation."
31857
+ },
31858
+ {
31859
+ name: "asset_id",
31860
+ sdkName: "asset_id",
31861
+ description: "32-character asset ID."
31862
+ }
31863
+ ],
31864
+ query: [],
31865
+ body: {
31866
+ required: true,
31867
+ fields: [
31868
+ {
31869
+ name: "reference_asset_id",
31870
+ type: "string",
31871
+ required: true,
31872
+ description: "Asset to align against the one the route names. It must be an audio or video asset of the same library, otherwise the request is refused with REFERENCE_TYPE_MISMATCH before a job exists."
31873
+ },
31874
+ {
31875
+ name: "max_offset_seconds",
31876
+ type: "number",
31877
+ required: false,
31878
+ description: "Largest offset to search for, in seconds; omit it to let the model search its full range. Zero and negative values are refused with INVALID_PARAMS."
31879
+ },
31880
+ {
31881
+ name: "idempotency_key",
31882
+ type: "string",
31883
+ required: false,
31884
+ description: "Stable key so a retried request reuses the same job instead of analysing and charging again; reusing it with different content is rejected."
31885
+ }
31886
+ ]
31887
+ }
31888
+ },
31715
31889
  {
31716
31890
  resource: "media.assets",
31717
31891
  method: "edit",
31718
31892
  summary: "Edit asset",
31719
- 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 and replace_background on images, remove_background on an image or a video, and to_video, frame and resynthesize on the material each takes; every other type in the operation vocabulary is refused with OPERATION_NOT_SUPPORTED. remove_background on a video produces a portrait matte video for compositing without a green screen: output picks alpha (the default: the person cut out on a transparent background, to lay over slides directly or use as a Cut track mask with channel alpha) or mask (a black-and-white keying matte, which the current matting line does not produce and refuses), and model picks the matting model from types.matting.models of the generation capabilities — read it first, because a request that names none takes the first available matting model and a video is refused with OPERATION_NOT_SUPPORTED, in the model field, when the platform has published none. output and model mean nothing for an image source and are refused with INVALID_PARAMS naming the field rather than ignored. 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\"}}.",
31893
+ 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 and replace_background on images, remove_background on an image or a video, upscale, enhance_voice, reframe and redact through Media’s processing lane (upscale on a picture or a video; enhance_voice on a recording or a video, whose audio is used; reframe and redact on a video), and to_video, frame and resynthesize on the material each takes; every other type in the operation vocabulary is refused with OPERATION_NOT_SUPPORTED. The processing lane takes its model from the platform model catalogue, judged by the operation’s capability and overridable with operation.model, and bills per second of input; each edit is idempotent on the source, the operation and the parameters, so a second request that would make the same asset answers the asset already made instead of paying again, and an operation whose catalogue list is empty is refused with OPERATION_NOT_SUPPORTED, 尚未上架. remove_background on a video produces a portrait matte video for compositing without a green screen: output picks mask (a black-and-white matte as a small H.264 video, person white and background black: use it as a Cut track mask with channel luma under the original video to lay a lecturer over slides — the choice for compositing) or alpha (the default: the person on a transparent background as ProRes 4444, which is very large, about 870 MB per 15 seconds of 1080p, so ask for it only when a transparent file itself is the deliverable), and model picks the matting model from types.matting.models of the generation capabilities — read it first, because a request that names none takes the first available matting model and a video is refused with OPERATION_NOT_SUPPORTED, in the model field, when the platform has published none. output and model mean nothing for an image source and are refused with INVALID_PARAMS naming the field rather than ignored. 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\"}}.",
31720
31894
  http: "POST",
31721
31895
  path: "/media/v1/libraries/{library_id}/assets/{asset_id}/edits",
31722
31896
  streaming: "no",
@@ -31741,7 +31915,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
31741
31915
  name: "operation",
31742
31916
  type: "object",
31743
31917
  required: true,
31744
- description: "One edit to apply to the source asset. type selects the operation and the discriminating branch carries that operation’s fields. This release performs variations, inpaint, erase, replace_object, recolor and replace_background on images, remove_background on an image or a video, and to_video, frame and resynthesize on the material each takes; every other type here describes the operation vocabulary and is refused with OPERATION_NOT_SUPPORTED."
31918
+ description: "One edit to apply to the source asset. type selects the operation and the discriminating branch carries that operation’s fields. This release performs variations, inpaint, erase, replace_object, recolor and replace_background on images, remove_background on an image or a video, upscale, enhance_voice, reframe and redact through Media’s processing lane (upscale on a picture or a video; enhance_voice on a recording or a video, whose audio is used; reframe and redact on a video), and to_video, frame and resynthesize on the material each takes; every other type here describes the operation vocabulary and is refused with OPERATION_NOT_SUPPORTED. align is not an edit — it compares two assets and has its own endpoint, POST /media/v1/libraries/{library_id}/assets/{asset_id}/align."
31745
31919
  },
31746
31920
  {
31747
31921
  name: "model",
@@ -34734,6 +34908,18 @@ for more details.`
34734
34908
  ]
34735
34909
  }
34736
34910
  },
34911
+ {
34912
+ resource: "model.modelAccess",
34913
+ method: "list",
34914
+ summary: "List Model Access",
34915
+ description: "List the models your organization must enable before use, together with the grants it already has. Read it to check whether a model is enabled before an inference call, or to show which marked models still need enabling; use each item's model as the id for enableModelAccess or disableModelAccess (PUT or DELETE /model/v1/models/{model}/access). Items cover every model the catalog marks access_required, granted or not, so the gated class stays discoverable, plus any other model this organization has enabled, one item per model. access_required says whether the catalog gates the model; granted says whether your organization has a grant; the prices are the model's current sell prices, what the next call costs, not the price recorded when the grant was created.",
34916
+ http: "GET",
34917
+ path: "/model/v1/model-access",
34918
+ streaming: "no",
34919
+ pagination: false,
34920
+ pathParams: [],
34921
+ query: []
34922
+ },
34737
34923
  {
34738
34924
  resource: "model.models",
34739
34925
  method: "list",
@@ -34762,6 +34948,8 @@ for more details.`
34762
34948
  "openai.images.generations",
34763
34949
  "openai.responses",
34764
34950
  "openai.videos",
34951
+ "praxis.media.process",
34952
+ "praxis.video.matting",
34765
34953
  "typesafe.systemone",
34766
34954
  "volcengine.music",
34767
34955
  "volcengine.vod.matting",
@@ -34826,6 +35014,42 @@ for more details.`
34826
35014
  ],
34827
35015
  query: []
34828
35016
  },
35017
+ {
35018
+ resource: "model.models.access",
35019
+ method: "delete",
35020
+ summary: "Disable Model Access",
35021
+ description: "Disable one model for your organization by deleting its grant, so the next call to a model that requires access is refused again with 403 MODEL_ACCESS_REQUIRED. Pass any id enableModelAccess accepts, including creator prefixes; the model may be enabled again later, and the new grant records whoever enabled it then. A model that is not currently enabled is already disabled, so deleting a grant that does not exist also answers 200 with revoked true; only an id no catalog model carries answers 404 MODEL_NOT_FOUND.",
35022
+ http: "DELETE",
35023
+ path: "/model/v1/models/{model}/access",
35024
+ streaming: "no",
35025
+ pagination: false,
35026
+ pathParams: [
35027
+ {
35028
+ name: "model",
35029
+ sdkName: "model",
35030
+ description: "Model ID the organization no longer wants enabled; same ids as enableModelAccess."
35031
+ }
35032
+ ],
35033
+ query: []
35034
+ },
35035
+ {
35036
+ resource: "model.models.access",
35037
+ method: "update",
35038
+ summary: "Enable Model Access",
35039
+ description: "Enable one model for your organization so a call to it is allowed. Call it when an inference request was refused with 403 MODEL_ACCESS_REQUIRED, or ahead of time for a model the catalog marks access_required: true; the refusal message and praxis.model.models.list name the model id to pass here. The id resolves exactly as a chat call resolves it, including any creator prefix such as deepseek/deepseek-v4-pro, and an id no catalog model carries answers 404 MODEL_NOT_FOUND. Enabling is organization-wide and needs no approval, and it is idempotent: a second call returns the first grant unchanged, keeping its author, its timestamp and the USD-per-million-token price snapshot it recorded then. Enabling a model that does not require access is allowed and makes no difference to gating.",
35040
+ http: "PUT",
35041
+ path: "/model/v1/models/{model}/access",
35042
+ streaming: "no",
35043
+ pagination: false,
35044
+ pathParams: [
35045
+ {
35046
+ name: "model",
35047
+ sdkName: "model",
35048
+ description: "Model ID as the catalog lists it, including any creator prefix; primary ids, aliases and prefixed ids resolve the same way a chat call resolves them."
35049
+ }
35050
+ ],
35051
+ query: []
35052
+ },
34829
35053
  {
34830
35054
  resource: "model.ocr",
34831
35055
  method: "create",
@@ -36245,7 +36469,7 @@ for more details.`
36245
36469
  resource: "organization.actors",
36246
36470
  method: "list",
36247
36471
  summary: "List actors holding positions",
36248
- description: "Lists every actor, person or agent, that currently holds at least one position, ordered by actor address, each with its primary position and all positions it holds; use it to see who works where. Actors holding nothing are not listed. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/actors?department_id=dept_123.",
36472
+ description: "Lists every actor, person or agent, that currently holds at least one position, ordered by actor address, each with its primary position and all positions it holds; use it to see who works where. Actors holding nothing are not listed. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/actors?department_id=dept_123.",
36249
36473
  http: "GET",
36250
36474
  path: "/organization/v1/actors",
36251
36475
  streaming: "no",
@@ -36276,7 +36500,7 @@ for more details.`
36276
36500
  resource: "organization.actors",
36277
36501
  method: "retrieve",
36278
36502
  summary: "Get the position chain of an actor",
36279
- description: "Reads where an actor, person or agent, sits in the organization: its primary position and its concurrent positions, each with the department path from the root down with every level's charter, the job, title and level name, the manager (the first filled position up the reporting line), the position's own duties and methods, and objectives. Use it to answer who this actor is and what it is responsible for. An actor that holds no position is not an error: primary is null and concurrent is empty. Read-only. Errors: 403 PERMISSION_DENIED for session and run tokens.",
36503
+ description: "Reads where an actor, person or agent, sits in the organization: its primary position and its concurrent positions, each with the department path from the root down with every level's charter, the job, title and level name, the manager (the first filled position up the reporting line), the position's own duties and methods, and objectives. Use it to answer who this actor is and what it is responsible for. An actor that holds no position is not an error: primary is null and concurrent is empty. Read-only. Errors: 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
36280
36504
  http: "GET",
36281
36505
  path: "/organization/v1/actors/{actor}",
36282
36506
  streaming: "no",
@@ -36294,7 +36518,7 @@ for more details.`
36294
36518
  resource: "organization.assignments",
36295
36519
  method: "list",
36296
36520
  summary: "List assignments",
36297
- description: "Lists assignments, newest start first, each tying one actor (person or agent) to one position; use it to see who holds what, or the history of a position or an actor. Ended assignments are included unless you filter active=true. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100, a non-boolean active or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/assignments?position_id=pos_123&active=true.",
36521
+ description: "Lists assignments, newest start first, each tying one actor (person or agent) to one position; use it to see who holds what, or the history of a position or an actor. Ended assignments are included unless you filter active=true. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100, a non-boolean active or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/assignments?position_id=pos_123&active=true.",
36298
36522
  http: "GET",
36299
36523
  path: "/organization/v1/assignments",
36300
36524
  streaming: "no",
@@ -36337,7 +36561,7 @@ for more details.`
36337
36561
  resource: "organization.assignments",
36338
36562
  method: "retrieve",
36339
36563
  summary: "Get an assignment",
36340
- description: "Reads one assignment, current or ended, with who appointed and ended it and, for a replaced holder, the successor's assignment id. Read-only. Errors: 404 ASSIGNMENT_NOT_FOUND when the id is not an assignment of your organization; 403 PERMISSION_DENIED for session and run tokens.",
36564
+ description: "Reads one assignment, current or ended, with who appointed and ended it and, for a replaced holder, the successor's assignment id. Read-only. Errors: 404 ASSIGNMENT_NOT_FOUND when the id is not an assignment of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
36341
36565
  http: "GET",
36342
36566
  path: "/organization/v1/assignments/{id}",
36343
36567
  streaming: "no",
@@ -36526,7 +36750,7 @@ for more details.`
36526
36750
  resource: "organization.departments",
36527
36751
  method: "list",
36528
36752
  summary: "List departments",
36529
- description: "Lists the departments of your organization's tree, including the root department; use it to find a department id or to walk the tree one level at a time with parent_id. Dissolved departments are included unless you filter status=active. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/departments?status=active.",
36753
+ description: "Lists the departments of your organization's tree, including the root department; use it to find a department id or to walk the tree one level at a time with parent_id. Dissolved departments are included unless you filter status=active. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/departments?status=active.",
36530
36754
  http: "GET",
36531
36755
  path: "/organization/v1/departments",
36532
36756
  streaming: "no",
@@ -36602,7 +36826,7 @@ for more details.`
36602
36826
  resource: "organization.departments",
36603
36827
  method: "retrieve",
36604
36828
  summary: "Get a department",
36605
- description: "Reads one department with its head position id and its charter, including the charter revision you need before amending the charter. Read-only. Errors: 404 DEPARTMENT_NOT_FOUND when the id is not a department of your organization; 403 PERMISSION_DENIED for session and run tokens.",
36829
+ description: "Reads one department with its head position id and its charter, including the charter revision you need before amending the charter. Read-only. Errors: 404 DEPARTMENT_NOT_FOUND when the id is not a department of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
36606
36830
  http: "GET",
36607
36831
  path: "/organization/v1/departments/{id}",
36608
36832
  streaming: "no",
@@ -36993,7 +37217,7 @@ for more details.`
36993
37217
  resource: "organization.jobs",
36994
37218
  method: "list",
36995
37219
  summary: "List jobs",
36996
- description: "Lists the jobs of your organization ordered by code; use it to find the job_id to open positions from. Retired jobs are included unless you filter status=active. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens.",
37220
+ description: "Lists the jobs of your organization ordered by code; use it to find the job_id to open positions from. Retired jobs are included unless you filter status=active. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
36997
37221
  http: "GET",
36998
37222
  path: "/organization/v1/jobs",
36999
37223
  streaming: "no",
@@ -37076,7 +37300,7 @@ for more details.`
37076
37300
  resource: "organization.jobs",
37077
37301
  method: "retrieve",
37078
37302
  summary: "Get a job",
37079
- description: "Reads one job with its current revision, which you need before revising it. Read-only. Errors: 404 JOB_NOT_FOUND when the id is not a job of your organization; 403 PERMISSION_DENIED for session and run tokens.",
37303
+ description: "Reads one job with its current revision, which you need before revising it. Read-only. Errors: 404 JOB_NOT_FOUND when the id is not a job of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37080
37304
  http: "GET",
37081
37305
  path: "/organization/v1/jobs/{id}",
37082
37306
  streaming: "no",
@@ -37166,7 +37390,7 @@ for more details.`
37166
37390
  resource: "organization.keyResults",
37167
37391
  method: "list",
37168
37392
  summary: "List key results",
37169
- description: "Lists key results, oldest first, each with its metric, health, done flag and, once its objective is graded, its score; use it to read the key results of one objective or the ones a position owns. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/key_results?objective_id=obj_3b7a52c1e9d84f06b2a1c8e4d7f50a96.",
37393
+ description: "Lists key results, oldest first, each with its metric, health, done flag and, once its objective is graded, its score; use it to read the key results of one objective or the ones a position owns. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/key_results?objective_id=obj_3b7a52c1e9d84f06b2a1c8e4d7f50a96.",
37170
37394
  http: "GET",
37171
37395
  path: "/organization/v1/key_results",
37172
37396
  streaming: "no",
@@ -37254,7 +37478,7 @@ for more details.`
37254
37478
  resource: "organization.keyResults",
37255
37479
  method: "retrieve",
37256
37480
  summary: "Get a key result",
37257
- description: "Reads one key result with its metric, its health, its done flag, its owner position and its score. Progress of a metric key result is (current - initial) / (target - initial), clamped between 0 and 1; a key result without a metric counts as 1 when done is true and 0 otherwise. Read-only. Errors: 404 KEY_RESULT_NOT_FOUND when the id is not a key result of your organization; 403 PERMISSION_DENIED for session and run tokens.",
37481
+ description: "Reads one key result with its metric, its health, its done flag, its owner position and its score. Progress of a metric key result is (current - initial) / (target - initial), clamped between 0 and 1; a key result without a metric counts as 1 when done is true and 0 otherwise. Read-only. Errors: 404 KEY_RESULT_NOT_FOUND when the id is not a key result of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37258
37482
  http: "GET",
37259
37483
  path: "/organization/v1/key_results/{id}",
37260
37484
  streaming: "no",
@@ -37340,7 +37564,7 @@ for more details.`
37340
37564
  resource: "organization.ladders",
37341
37565
  method: "list",
37342
37566
  summary: "List job ladders",
37343
- description: "Lists the job ladders of your organization, oldest first, each with its levels in ascending order; use it to find the level ids for jobs and positions. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens.",
37567
+ description: "Lists the job ladders of your organization, oldest first, each with its levels in ascending order; use it to find the level ids for jobs and positions. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37344
37568
  http: "GET",
37345
37569
  path: "/organization/v1/ladders",
37346
37570
  streaming: "no",
@@ -37395,7 +37619,7 @@ for more details.`
37395
37619
  resource: "organization.ladders",
37396
37620
  method: "retrieve",
37397
37621
  summary: "Get a job ladder",
37398
- description: "Reads one job ladder with its levels in ascending order. Read-only. Errors: 404 LADDER_NOT_FOUND when the id is not a ladder of your organization; 403 PERMISSION_DENIED for session and run tokens.",
37622
+ description: "Reads one job ladder with its levels in ascending order. Read-only. Errors: 404 LADDER_NOT_FOUND when the id is not a ladder of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37399
37623
  http: "GET",
37400
37624
  path: "/organization/v1/ladders/{id}",
37401
37625
  streaming: "no",
@@ -37413,7 +37637,7 @@ for more details.`
37413
37637
  resource: "organization.ladders",
37414
37638
  method: "update",
37415
37639
  summary: "Revise a job ladder",
37416
- description: "Replaces all levels of a ladder with the array you send. A level with an id keeps that id and takes the new name and order, a level without an id is created, and an existing level you leave out is deleted. A level cannot be deleted while an open position or a job's level_ids still refers to it; first regrade those positions or revise those jobs. The ladder name is not changed by this call. Requires an organization owner or admin. Errors: 400 INVALID_PARAMS for an empty levels array, duplicate order values, a level id sent twice or a level that is still referenced; 403 PERMISSION_DENIED; 404 LADDER_NOT_FOUND; 404 JOB_LEVEL_NOT_FOUND when a level id does not belong to this ladder.",
37640
+ description: "Replaces all levels of a ladder with the array you send. A level with an id keeps that id and takes the new name and order, a level without an id is created, and an existing level you leave out is deleted. A level cannot be deleted while an open position or a job's level_ids still refers to it; first regrade those positions or revise those jobs. Send name to rename the ladder; leave it out to keep the name. Requires an organization owner or admin. Errors: 400 INVALID_PARAMS for an empty levels array, duplicate order values, a level id sent twice or a level that is still referenced; 403 PERMISSION_DENIED; 404 LADDER_NOT_FOUND; 404 JOB_LEVEL_NOT_FOUND when a level id does not belong to this ladder.",
37417
37641
  http: "PUT",
37418
37642
  path: "/organization/v1/ladders/{id}",
37419
37643
  streaming: "no",
@@ -37429,6 +37653,12 @@ for more details.`
37429
37653
  body: {
37430
37654
  required: true,
37431
37655
  fields: [
37656
+ {
37657
+ name: "name",
37658
+ type: "string",
37659
+ required: false,
37660
+ description: "The ladder's new name; omit it to keep the current name."
37661
+ },
37432
37662
  {
37433
37663
  name: "levels",
37434
37664
  type: "array",
@@ -37468,7 +37698,7 @@ for more details.`
37468
37698
  resource: "organization.objectives",
37469
37699
  method: "list",
37470
37700
  summary: "List objectives",
37471
- description: "Lists objectives, oldest first, each with its scope, the parents it aligns to and, once graded, its result and score; use it to find an objective id or to read one period or one department's objectives. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/objectives?period_id=prd_6d1f0c3a9b8e4a27a5c4e7d2f1b90a38&status=active.",
37701
+ description: "Lists objectives, oldest first, each with its scope, the parents it aligns to and, once graded, its result and score; use it to find an objective id or to read one period or one department's objectives. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/objectives?period_id=prd_6d1f0c3a9b8e4a27a5c4e7d2f1b90a38&status=active.",
37472
37702
  http: "GET",
37473
37703
  path: "/organization/v1/objectives",
37474
37704
  streaming: "no",
@@ -37566,7 +37796,7 @@ for more details.`
37566
37796
  resource: "organization.objectives",
37567
37797
  method: "retrieve",
37568
37798
  summary: "Get an objective",
37569
- description: "Reads one objective with its scope, the parents it aligns to with their weights, its status and, once graded, its result, score and grade note. Its key results are read with the key results list filtered by objective_id. Read-only. Errors: 404 OBJECTIVE_NOT_FOUND when the id is not an objective of your organization; 403 PERMISSION_DENIED for session and run tokens.",
37799
+ description: "Reads one objective with its scope, the parents it aligns to with their weights, its status and, once graded, its result, score and grade note. Its key results are read with the key results list filtered by objective_id. Read-only. Errors: 404 OBJECTIVE_NOT_FOUND when the id is not an objective of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37570
37800
  http: "GET",
37571
37801
  path: "/organization/v1/objectives/{id}",
37572
37802
  streaming: "no",
@@ -37703,7 +37933,7 @@ for more details.`
37703
37933
  resource: "organization.periods",
37704
37934
  method: "list",
37705
37935
  summary: "List periods",
37706
- description: "Lists the periods of your organization's OKR calendar, newest start first; use it to find the period_id to set objectives in, or to see which periods are still open for grading. Closed periods are included. Filter cadence to read one level of the calendar. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/periods?cadence=quarter.",
37936
+ description: "Lists the periods of your organization's OKR calendar, newest start first; use it to find the period_id to set objectives in, or to see which periods are still open for grading. Closed periods are included. Filter cadence to read one level of the calendar. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100 or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/periods?cadence=quarter.",
37707
37937
  http: "GET",
37708
37938
  path: "/organization/v1/periods",
37709
37939
  streaming: "no",
@@ -37791,7 +38021,7 @@ for more details.`
37791
38021
  resource: "organization.periods",
37792
38022
  method: "retrieve",
37793
38023
  summary: "Get a period",
37794
- description: "Reads one period with its derived status, so you can tell whether it is still planning, active, in grading or closed. Read-only. Errors: 404 PERIOD_NOT_FOUND when the id is not a period of your organization; 403 PERMISSION_DENIED for session and run tokens.",
38024
+ description: "Reads one period with its derived status, so you can tell whether it is still planning, active, in grading or closed. Read-only. Errors: 404 PERIOD_NOT_FOUND when the id is not a period of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37795
38025
  http: "GET",
37796
38026
  path: "/organization/v1/periods/{id}",
37797
38027
  streaming: "no",
@@ -37827,7 +38057,7 @@ for more details.`
37827
38057
  resource: "organization.positions",
37828
38058
  method: "list",
37829
38059
  summary: "List positions",
37830
- description: "Lists positions across the organization ordered by department and then number, vacant ones included; narrow it with department_id, job_id, status or is_head. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100, a non-boolean is_head or a stale cursor; 403 PERMISSION_DENIED for session and run tokens. Example: GET /organization/v1/positions?department_id=dept_123&status=active.",
38060
+ description: "Lists positions across the organization ordered by department and then number, vacant ones included; narrow it with department_id, job_id, status or is_head. Filters combine with AND. Pass next_page unchanged as page; null means the end. Read-only. Errors: 400 INVALID_PARAMS for an unknown query parameter, a limit outside 1 to 100, a non-boolean is_head or a stale cursor; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent. Example: GET /organization/v1/positions?department_id=dept_123&status=active.",
37831
38061
  http: "GET",
37832
38062
  path: "/organization/v1/positions",
37833
38063
  streaming: "no",
@@ -37940,7 +38170,7 @@ for more details.`
37940
38170
  resource: "organization.positions",
37941
38171
  method: "retrieve",
37942
38172
  summary: "Get a position",
37943
- description: "Reads one position with its derived effective_reports_to line. Read-only. Errors: 404 POSITION_NOT_FOUND when the id is not a position of your organization; 403 PERMISSION_DENIED for session and run tokens.",
38173
+ description: "Reads one position with its derived effective_reports_to line. Read-only. Errors: 404 POSITION_NOT_FOUND when the id is not a position of your organization; 403 PERMISSION_DENIED for a run or computer token, or a session token that names no agent.",
37944
38174
  http: "GET",
37945
38175
  path: "/organization/v1/positions/{id}",
37946
38176
  streaming: "no",
@@ -40394,6 +40624,129 @@ for more details.`
40394
40624
  ]
40395
40625
  }
40396
40626
  },
40627
+ {
40628
+ resource: "share.permissions",
40629
+ method: "list",
40630
+ summary: "List shares",
40631
+ description: "Find the shares of this organization, newest first, for example every link that exposes one file before you decide which to revoke. Filter by resource_type, resource_id and status; filters combine with AND. Continue with next_page_token as page_token until next_page_token is null. Records never include link.web_url. A credential bound to specific files must pass resource_type and resource_id of a bound file, and an unbound file answers 404.",
40632
+ http: "GET",
40633
+ path: "/share/v1/permissions",
40634
+ streaming: "no",
40635
+ pagination: false,
40636
+ pathParams: [],
40637
+ query: [
40638
+ {
40639
+ name: "resource_type",
40640
+ type: "string",
40641
+ enum: [
40642
+ "file",
40643
+ "artifact"
40644
+ ],
40645
+ required: false,
40646
+ description: "Only shares of this object type; file is the only type that creates today."
40647
+ },
40648
+ {
40649
+ name: "resource_id",
40650
+ type: "string",
40651
+ required: false,
40652
+ description: "Only shares of the object with this id, for example a file id from the File API; combine with resource_type."
40653
+ },
40654
+ {
40655
+ name: "status",
40656
+ type: "string",
40657
+ enum: [
40658
+ "active",
40659
+ "expired",
40660
+ "revoked"
40661
+ ],
40662
+ required: false,
40663
+ description: "Only shares in this state; omit to list every state."
40664
+ },
40665
+ {
40666
+ name: "page_size",
40667
+ type: "integer",
40668
+ required: false,
40669
+ description: "Maximum shares in one page, from 1 to 100; defaults to 50."
40670
+ },
40671
+ {
40672
+ name: "page_token",
40673
+ type: "string",
40674
+ required: false,
40675
+ description: "Opaque next_page_token from the preceding page with the same filters; omit on the first request."
40676
+ }
40677
+ ]
40678
+ },
40679
+ {
40680
+ resource: "share.permissions",
40681
+ method: "create",
40682
+ summary: "Create share",
40683
+ description: "Make one file readable by anyone holding a link, before sending the link to a person or embedding it. Name the object as resource {type, id}, with the file id from the File API. The response is 201 and is the only time link.web_url is returned; store it, because later reads omit it and a lost address means creating another share (the old one keeps working until you delete it). The link is anonymous and read-only. A type other than file answers 400 RESOURCE_TYPE_UNSUPPORTED, and a file that is missing or outside your organization answers 404 RESOURCE_NOT_FOUND.",
40684
+ http: "POST",
40685
+ path: "/share/v1/permissions",
40686
+ streaming: "no",
40687
+ pagination: false,
40688
+ pathParams: [],
40689
+ query: [],
40690
+ body: {
40691
+ required: true,
40692
+ fields: [
40693
+ {
40694
+ name: "resource",
40695
+ type: "object",
40696
+ required: true,
40697
+ description: "The object a share exposes, named by a type and an id."
40698
+ },
40699
+ {
40700
+ name: "expire_time",
40701
+ type: "string",
40702
+ required: false,
40703
+ description: "ISO 8601 instant after which the link answers 410; omit or null for a link that never expires, and it must be in the future."
40704
+ },
40705
+ {
40706
+ name: "prevents_download",
40707
+ type: "boolean",
40708
+ required: false,
40709
+ description: "Ask viewers to open the content without a download prompt; a limit, not a guarantee, because anyone who can read it can save it. Defaults to false."
40710
+ }
40711
+ ]
40712
+ }
40713
+ },
40714
+ {
40715
+ resource: "share.permissions",
40716
+ method: "delete",
40717
+ summary: "Delete share",
40718
+ description: "Take a link back so nobody can open it again. This revokes the share, the record stays readable with status revoked, and opening the link answers 410. Repeating the call on a revoked share is harmless and answers 204 again. Content addresses already signed when the link was opened expire on their own within five minutes. Take the id from shares.create or shares.list.",
40719
+ http: "DELETE",
40720
+ path: "/share/v1/permissions/{id}",
40721
+ streaming: "no",
40722
+ pagination: false,
40723
+ pathParams: [
40724
+ {
40725
+ name: "id",
40726
+ sdkName: "id",
40727
+ description: "Share id returned by shares.create or shares.list, in the form shr_ followed by 32 lowercase letters or digits; a link address is not accepted."
40728
+ }
40729
+ ],
40730
+ query: []
40731
+ },
40732
+ {
40733
+ resource: "share.permissions",
40734
+ method: "retrieve",
40735
+ summary: "Retrieve share",
40736
+ description: "Read one share to see whether its link is still active, when it expires, and how many times it was opened. Take the id from shares.create or shares.list. The record never includes link.web_url, because the address is shown once at creation. A share that does not exist or belongs to another organization answers 404 PERMISSION_NOT_FOUND.",
40737
+ http: "GET",
40738
+ path: "/share/v1/permissions/{id}",
40739
+ streaming: "no",
40740
+ pagination: false,
40741
+ pathParams: [
40742
+ {
40743
+ name: "id",
40744
+ sdkName: "id",
40745
+ description: "Share id returned by shares.create or shares.list, in the form shr_ followed by 32 lowercase letters or digits; a link address is not accepted."
40746
+ }
40747
+ ],
40748
+ query: []
40749
+ },
40397
40750
  {
40398
40751
  resource: "studio.codexes",
40399
40752
  method: "list",
@@ -47220,11 +47573,7 @@ var computersFilesConvert = (options) => (options.client ?? client).post({
47220
47573
  type: "apiKey"
47221
47574
  }],
47222
47575
  url: "/agent/v1/computers/{computer_id}/files/convert",
47223
- ...options,
47224
- headers: {
47225
- "Content-Type": "application/json",
47226
- ...options.headers
47227
- }
47576
+ ...options
47228
47577
  });
47229
47578
  var connectComputer = (options) => (options.client ?? client).post({
47230
47579
  security: [{
@@ -47312,6 +47661,49 @@ var forkSession = (options) => (options.client ?? client).post({
47312
47661
  ...options.headers
47313
47662
  }
47314
47663
  });
47664
+ var listSessionArtifacts = (options) => (options.client ?? client).get({
47665
+ security: [{
47666
+ key: "BearerAuth",
47667
+ scheme: "bearer",
47668
+ type: "http"
47669
+ }, {
47670
+ key: "ApiKeyAuth",
47671
+ name: "X-API-Key",
47672
+ type: "apiKey"
47673
+ }],
47674
+ url: "/agent/v1/sessions/{session_id}/artifacts",
47675
+ ...options
47676
+ });
47677
+ var createSessionArtifactContentUrl = (options) => (options.client ?? client).post({
47678
+ security: [{
47679
+ key: "BearerAuth",
47680
+ scheme: "bearer",
47681
+ type: "http"
47682
+ }, {
47683
+ key: "ApiKeyAuth",
47684
+ name: "X-API-Key",
47685
+ type: "apiKey"
47686
+ }],
47687
+ url: "/agent/v1/sessions/{session_id}/artifacts/{artifact_id}/content_url",
47688
+ ...options,
47689
+ headers: {
47690
+ "Content-Type": "application/json",
47691
+ ...options.headers
47692
+ }
47693
+ });
47694
+ var listSessionRequests = (options) => (options.client ?? client).get({
47695
+ security: [{
47696
+ key: "BearerAuth",
47697
+ scheme: "bearer",
47698
+ type: "http"
47699
+ }, {
47700
+ key: "ApiKeyAuth",
47701
+ name: "X-API-Key",
47702
+ type: "apiKey"
47703
+ }],
47704
+ url: "/agent/v1/sessions/{session_id}/requests",
47705
+ ...options
47706
+ });
47315
47707
  var listSessionBackgroundTasks = (options) => (options.client ?? client).get({
47316
47708
  security: [{
47317
47709
  key: "BearerAuth",
@@ -47957,6 +48349,45 @@ var createChatCompletion = (options) => (options.client ?? client).post({
47957
48349
  ...options.headers
47958
48350
  }
47959
48351
  });
48352
+ var disableModelAccess = (options) => (options.client ?? client).delete({
48353
+ security: [{
48354
+ key: "BearerAuth",
48355
+ scheme: "bearer",
48356
+ type: "http"
48357
+ }, {
48358
+ key: "ApiKeyAuth",
48359
+ name: "X-API-Key",
48360
+ type: "apiKey"
48361
+ }],
48362
+ url: "/model/v1/models/{model}/access",
48363
+ ...options
48364
+ });
48365
+ var enableModelAccess = (options) => (options.client ?? client).put({
48366
+ security: [{
48367
+ key: "BearerAuth",
48368
+ scheme: "bearer",
48369
+ type: "http"
48370
+ }, {
48371
+ key: "ApiKeyAuth",
48372
+ name: "X-API-Key",
48373
+ type: "apiKey"
48374
+ }],
48375
+ url: "/model/v1/models/{model}/access",
48376
+ ...options
48377
+ });
48378
+ var listModelAccess = (options) => (options?.client ?? client).get({
48379
+ security: [{
48380
+ key: "BearerAuth",
48381
+ scheme: "bearer",
48382
+ type: "http"
48383
+ }, {
48384
+ key: "ApiKeyAuth",
48385
+ name: "X-API-Key",
48386
+ type: "apiKey"
48387
+ }],
48388
+ url: "/model/v1/model-access",
48389
+ ...options
48390
+ });
47960
48391
  var getGeneration = (options) => (options.client ?? client).get({
47961
48392
  security: [{
47962
48393
  key: "BearerAuth",
@@ -53157,6 +53588,19 @@ var devopsFlagsCreate = (options) => (options.client ?? client).post({
53157
53588
  ...options.headers
53158
53589
  }
53159
53590
  });
53591
+ var devopsFlagsReportCodeRefs = (options) => (options.client ?? client).post({
53592
+ security: [{
53593
+ key: "devops-bearerAuth",
53594
+ scheme: "bearer",
53595
+ type: "http"
53596
+ }],
53597
+ url: "/devops/v1/projects/{project}/flags/code-refs",
53598
+ ...options,
53599
+ headers: {
53600
+ "Content-Type": "application/json",
53601
+ ...options.headers
53602
+ }
53603
+ });
53160
53604
  var devopsFlagsGet = (options) => (options.client ?? client).get({
53161
53605
  security: [{
53162
53606
  key: "devops-bearerAuth",
@@ -54370,6 +54814,19 @@ var mediaGetGenerationCapabilities = (options) => (options?.client ?? client).ge
54370
54814
  url: "/media/v1/generation/capabilities",
54371
54815
  ...options
54372
54816
  });
54817
+ var mediaAlignAsset = (options) => (options.client ?? client).post({
54818
+ security: [{
54819
+ key: "media-BearerAuth",
54820
+ scheme: "bearer",
54821
+ type: "http"
54822
+ }],
54823
+ url: "/media/v1/libraries/{library_id}/assets/{asset_id}/align",
54824
+ ...options,
54825
+ headers: {
54826
+ "Content-Type": "application/json",
54827
+ ...options.headers
54828
+ }
54829
+ });
54373
54830
  var ontologyListTypes = (options) => (options?.client ?? client).get({
54374
54831
  security: [{
54375
54832
  key: "ontology-bearerAuth",
@@ -55502,6 +55959,46 @@ var searchMap = (options) => (options.client ?? client).post({
55502
55959
  ...options.headers
55503
55960
  }
55504
55961
  });
55962
+ var shareListPermissions = (options) => (options?.client ?? client).get({
55963
+ security: [{
55964
+ key: "share-bearerAuth",
55965
+ scheme: "bearer",
55966
+ type: "http"
55967
+ }],
55968
+ url: "/share/v1/permissions",
55969
+ ...options
55970
+ });
55971
+ var shareCreatePermission = (options) => (options.client ?? client).post({
55972
+ security: [{
55973
+ key: "share-bearerAuth",
55974
+ scheme: "bearer",
55975
+ type: "http"
55976
+ }],
55977
+ url: "/share/v1/permissions",
55978
+ ...options,
55979
+ headers: {
55980
+ "Content-Type": "application/json",
55981
+ ...options.headers
55982
+ }
55983
+ });
55984
+ var shareDeletePermission = (options) => (options.client ?? client).delete({
55985
+ security: [{
55986
+ key: "share-bearerAuth",
55987
+ scheme: "bearer",
55988
+ type: "http"
55989
+ }],
55990
+ url: "/share/v1/permissions/{id}",
55991
+ ...options
55992
+ });
55993
+ var shareRetrievePermission = (options) => (options.client ?? client).get({
55994
+ security: [{
55995
+ key: "share-bearerAuth",
55996
+ scheme: "bearer",
55997
+ type: "http"
55998
+ }],
55999
+ url: "/share/v1/permissions/{id}",
56000
+ ...options
56001
+ });
55505
56002
  var studioGenresList = (options) => (options?.client ?? client).get({
55506
56003
  security: [{
55507
56004
  key: "BearerAuth",
@@ -57602,6 +58099,12 @@ function createAgent(transport) {
57602
58099
  },
57603
58100
  sessions: {
57604
58101
  archive: bind(transport, sessionsArchive),
58102
+ artifacts: {
58103
+ contentUrl: {
58104
+ create: bind(transport, createSessionArtifactContentUrl)
58105
+ },
58106
+ list: bind(transport, listSessionArtifacts)
58107
+ },
57605
58108
  backgroundTasks: {
57606
58109
  list: bind(transport, listSessionBackgroundTasks),
57607
58110
  retrieveOutput: bind(transport, getSessionBackgroundTaskOutput),
@@ -57620,6 +58123,9 @@ function createAgent(transport) {
57620
58123
  },
57621
58124
  fork: bind(transport, forkSession),
57622
58125
  list: bind(transport, sessionsList),
58126
+ requests: {
58127
+ list: bind(transport, listSessionRequests)
58128
+ },
57623
58129
  resources: {
57624
58130
  create: bind(transport, sessionsResourcesAdd),
57625
58131
  delete: bind(transport, aliasOperation(sessionsResourcesDelete, { query: { session_id: "query_session_id" } })),
@@ -58132,7 +58638,8 @@ function createDevops(transport) {
58132
58638
  },
58133
58639
  flags: {
58134
58640
  create: bind(transport, devopsFlagsCreate),
58135
- list: bind(transport, devopsFlagsList)
58641
+ list: bind(transport, devopsFlagsList),
58642
+ reportCodeRefs: bind(transport, devopsFlagsReportCodeRefs)
58136
58643
  },
58137
58644
  list: bind(transport, devopsProjectsList),
58138
58645
  promotions: {
@@ -58336,6 +58843,9 @@ function createMedia(transport) {
58336
58843
  },
58337
58844
  libraries: {
58338
58845
  assets: {
58846
+ align: {
58847
+ create: bind(transport, mediaAlignAsset)
58848
+ },
58339
58849
  batch: bind(transport, mediaBatchAssets),
58340
58850
  create: bind(transport, (options) => mediaUploadAsset({ ...options, bodySerializer: multipartBodySerializer, headers: { "Content-Type": null, ...options.headers } })),
58341
58851
  delete: bind(transport, mediaDeleteAsset),
@@ -58477,7 +58987,14 @@ function createModel(transport) {
58477
58987
  countTokens: bind(transport, countTokens),
58478
58988
  create: bindMixed(transport, createMessage)
58479
58989
  },
58990
+ modelAccess: {
58991
+ list: bind(transport, listModelAccess)
58992
+ },
58480
58993
  models: {
58994
+ access: {
58995
+ delete: bind(transport, disableModelAccess),
58996
+ update: bind(transport, enableModelAccess)
58997
+ },
58481
58998
  list: bind(transport, listModels),
58482
58999
  retrieve: bind(transport, retrieveModel)
58483
59000
  },
@@ -58770,6 +59287,16 @@ function createSearch(transport) {
58770
59287
  }
58771
59288
  };
58772
59289
  }
59290
+ function createShare(transport) {
59291
+ return {
59292
+ permissions: {
59293
+ create: bind(transport, shareCreatePermission),
59294
+ delete: bind(transport, shareDeletePermission),
59295
+ list: bind(transport, shareListPermissions),
59296
+ retrieve: bind(transport, shareRetrievePermission)
59297
+ }
59298
+ };
59299
+ }
58773
59300
  function createStudio(transport) {
58774
59301
  return {
58775
59302
  codexes: {
@@ -59040,6 +59567,7 @@ var resourceFactories = {
59040
59567
  organization: createOrganization,
59041
59568
  sandbox: createSandbox,
59042
59569
  search: createSearch,
59570
+ share: createShare,
59043
59571
  studio: createStudio,
59044
59572
  ticket: createTicket,
59045
59573
  vault: createVault
@@ -61227,7 +61755,7 @@ var workflows = [
61227
61755
  ],
61228
61756
  group: "local",
61229
61757
  network: "offline",
61230
- platform: "the `@mise/code` engine's own `mise code refactor rename|check|apply`: this is their thin shell, one for one (ADR-125 §3).",
61758
+ platform: "the `@deepractice-ai/devops-refactor` engine's own `mise code refactor rename|check|apply`: this is their thin shell, one for one (ADR-125 §3).",
61231
61759
  docs: "https://docs.deepraxis.com/docs/cli"
61232
61760
  },
61233
61761
  {
@@ -61316,30 +61844,31 @@ var workflows = [
61316
61844
  {
61317
61845
  words: ["devops", "flag", "refs"],
61318
61846
  requires: "checkout",
61319
- usage: "devops flag refs [key]",
61320
- summary: "Where each flag key is referenced in this checkout: file and line, for every registered key or one named key.",
61321
- example: "praxis devops flag refs",
61847
+ usage: "devops flag refs [key] [--report --project <dvp_…>]",
61848
+ summary: "Where each flag key is referenced in this checkout: file and line, for every registered key or one named key. With --report the whole scan of every registered key is posted to the platform, which is what lets archiving a flag be refused while code still names it.",
61849
+ example: "praxis devops flag refs --report --project dvp_…",
61322
61850
  examples: [
61323
61851
  "praxis devops flag refs",
61324
- "praxis devops flag refs run-page-v2"
61852
+ "praxis devops flag refs run-page-v2",
61853
+ "praxis devops flag refs --report --project dvp_…"
61325
61854
  ],
61326
61855
  group: "local",
61327
- network: "offline",
61328
- platform: "Reporting the references to the platform waits on the write API: `devops.flags.listCodeRefs` reads only, so this slice lists locally (ADR-125 §4).",
61856
+ network: "Offline. --report: needs a login and sends this checkout's references to the platform",
61857
+ platform: "the platform half of the scan: `devops.flags.reportCodeRefs` stores the references on each flag of the project (0 for a key this scan no longer finds), `devops.flags.listCodeRefs` reads them back, and `praxis api devops flag archive <flg_…>` refuses while a flag still has references or is still on in an environment (ADR-125 §4).",
61329
61858
  docs: "https://docs.deepraxis.com/docs/cli"
61330
61859
  },
61331
61860
  {
61332
61861
  words: ["devops", "flag", "remove"],
61333
61862
  requires: "checkout",
61334
61863
  usage: "devops flag remove <key>",
61335
- summary: "The local step of removing a flag: list the remaining references, or the steps that follow once none remain. Order: open the flag fully (praxis api devops flag environment update), delete the code that names the key and deploy it, run this command, then retire the flag on the platform with praxis api devops flag archive <flg_…> (irreversible; it does not check code references), then regenerate the registry with praxis devops flag sync.",
61864
+ summary: "The local step of removing a flag: list the remaining references, or the steps that follow once none remain. Order: turn the flag off in every environment (praxis api devops flag environment update), delete the code that names the key and deploy it, run this command, report the scan with praxis devops flag refs --report, then retire the flag on the platform with praxis api devops flag archive <flg_…> (irreversible; it is refused while references remain or an environment still has it on), then regenerate the registry with praxis devops flag sync.",
61336
61865
  example: "praxis devops flag remove run-page-v2",
61337
61866
  examples: [
61338
61867
  "praxis devops flag remove run-page-v2"
61339
61868
  ],
61340
61869
  group: "local",
61341
61870
  network: "offline",
61342
- platform: "praxis api devops flag archive — retires the flag on the platform after the code that named it is deployed away; it keeps the key reserved (ADR-050 §7, ADR-125 §4).",
61871
+ platform: "praxis api devops flag archive — retires the flag on the platform after the code that named it is deployed away, and keeps the key reserved; it is refused, not forced, while the references the last `praxis devops flag refs --report` wrote remain or the flag is still on in an environment (ADR-050 §7, ADR-125 §4).",
61343
61872
  docs: "https://docs.deepraxis.com/docs/cli"
61344
61873
  },
61345
61874
  {
@@ -62948,6 +63477,101 @@ function wranglerEdges(nodes) {
62948
63477
  }
62949
63478
  return edges;
62950
63479
  }
63480
+ // ../../packages/praxis/deploy-core/src/lambda-function.ts
63481
+ var LAMBDA_FUNCTIONS_ROOT = "services/lambda/functions";
63482
+ var UPSTREAM = "aliyun-fc";
63483
+ var RECIPE_PATH = /^services\/lambda\/functions\/([^/]+)\/function\.json$/;
63484
+ var isText = (value) => typeof value === "string" && value !== "";
63485
+ var isCount = (value, min, max) => typeof value === "number" && Number.isInteger(value) && value >= min && value <= max;
63486
+ function lambdaFunctionOf(text) {
63487
+ const parsed = text === null ? null : parseJsonc2(text);
63488
+ if (parsed === null)
63489
+ return null;
63490
+ if (!isText(parsed.name) || !isText(parsed.upstream))
63491
+ return null;
63492
+ if (!Array.isArray(parsed.regions) || parsed.regions.length === 0 || !parsed.regions.every(isText))
63493
+ return null;
63494
+ if (parsed.gpu !== undefined && !isText(parsed.gpu))
63495
+ return null;
63496
+ if (!isCount(parsed.cpu, 1, 256))
63497
+ return null;
63498
+ if (!isCount(parsed.memoryMb, 128, 32 * 1024))
63499
+ return null;
63500
+ if (!isCount(parsed.timeoutSeconds, 1, 24 * 3600))
63501
+ return null;
63502
+ if (!isCount(parsed.concurrency, 1, 1024))
63503
+ return null;
63504
+ return {
63505
+ name: parsed.name,
63506
+ upstream: parsed.upstream,
63507
+ regions: [...parsed.regions],
63508
+ ...parsed.gpu === undefined ? {} : { gpu: parsed.gpu },
63509
+ cpu: parsed.cpu,
63510
+ memoryMb: parsed.memoryMb,
63511
+ timeoutSeconds: parsed.timeoutSeconds,
63512
+ concurrency: parsed.concurrency
63513
+ };
63514
+ }
63515
+ function lambdaFunctionTarget(recipe) {
63516
+ return { path: `${LAMBDA_FUNCTIONS_ROOT}/${recipe.name}`, name: `lambda-${recipe.name}` };
63517
+ }
63518
+ function lambdaFunctionOwner(path) {
63519
+ return path.split("/").slice(0, -2).join("/");
63520
+ }
63521
+ async function scanRecipes(facts) {
63522
+ const found = [];
63523
+ const warnings = [];
63524
+ for (const path of [...facts.tree].sort()) {
63525
+ const match = RECIPE_PATH.exec(path);
63526
+ if (match === null)
63527
+ continue;
63528
+ const dir = path.slice(0, -"/function.json".length);
63529
+ const recipe = lambdaFunctionOf(await facts.read(path));
63530
+ if (recipe === null) {
63531
+ warnings.push(`${dir}: function.json is not a recipe`);
63532
+ continue;
63533
+ }
63534
+ if (recipe.upstream !== UPSTREAM)
63535
+ continue;
63536
+ if (recipe.name !== match[1]) {
63537
+ warnings.push(`${dir}: function.json names ${JSON.stringify(recipe.name)}, not the directory name`);
63538
+ continue;
63539
+ }
63540
+ found.push(recipe);
63541
+ }
63542
+ return { found, warnings };
63543
+ }
63544
+ function lambdaFunctionProvider(_options = {}) {
63545
+ return {
63546
+ id: "lambda-function",
63547
+ async detect(facts) {
63548
+ return (await scanRecipes(facts)).found.length > 0 ? "certain" : "none";
63549
+ },
63550
+ async plan(facts, partial) {
63551
+ const claimed = new Set(partial.targets.map((target) => target.path));
63552
+ const scan = await scanRecipes(facts);
63553
+ const targets = [];
63554
+ const byOwner = new Map;
63555
+ for (const recipe of scan.found) {
63556
+ const { path, name } = lambdaFunctionTarget(recipe);
63557
+ if (claimed.has(path))
63558
+ continue;
63559
+ targets.push({ path, name, destination: "aliyun-fc", production: true, onTrain: true });
63560
+ const owner = lambdaFunctionOwner(path);
63561
+ byOwner.set(owner, [...byOwner.get(owner) ?? [], path]);
63562
+ }
63563
+ const refined = partial.targets.map((target) => {
63564
+ const paths = byOwner.get(target.path);
63565
+ return paths === undefined ? target : { ...target, dependsOn: [...new Set([...target.dependsOn ?? [], ...paths])] };
63566
+ });
63567
+ return {
63568
+ targets: [...refined, ...targets],
63569
+ ...scan.warnings.length === 0 ? {} : { warnings: [...partial.warnings ?? [], ...scan.warnings] }
63570
+ };
63571
+ }
63572
+ };
63573
+ }
63574
+ var lambdaFunction = lambdaFunctionProvider();
62951
63575
  // ../../packages/praxis/deploy-core/src/package-manifest.ts
62952
63576
  function packageManifestOf(text) {
62953
63577
  const parsed = text === null ? null : parseJsonc2(text);
@@ -63105,13 +63729,21 @@ function matchesPattern(pattern, path) {
63105
63729
  }
63106
63730
  async function workspaceIndexOf(facts, options = {}) {
63107
63731
  const tree = new Set(facts.tree);
63108
- const declared = workspacePatternsOf({
63732
+ return workspaceIndexOfSync({
63733
+ tree: facts.tree,
63109
63734
  packageJson: tree.has("package.json") ? await facts.read("package.json") : null,
63110
63735
  pnpmWorkspace: tree.has("pnpm-workspace.yaml") ? await facts.read("pnpm-workspace.yaml") : null
63736
+ }, options);
63737
+ }
63738
+ function workspaceIndexOfSync(input, options = {}) {
63739
+ const tree = new Set(input.tree);
63740
+ const declared = workspacePatternsOf({
63741
+ packageJson: input.packageJson,
63742
+ pnpmWorkspace: input.pnpmWorkspace
63111
63743
  });
63112
63744
  const patterns = declared.length > 0 ? declared : options.defaultPatterns ?? [];
63113
63745
  const candidates2 = new Set;
63114
- for (const path of facts.tree) {
63746
+ for (const path of input.tree) {
63115
63747
  const dir = dirOfPackageJson(path) ?? dirOfManifest(path);
63116
63748
  if (dir === undefined || dir === ".")
63117
63749
  continue;
@@ -63274,7 +63906,11 @@ function workspaceCloudflareProvider(options = {}) {
63274
63906
  };
63275
63907
  }
63276
63908
  var workspaceCloudflare = workspaceCloudflareProvider();
63277
- var BUILTIN_PROVIDERS = [workspaceCloudflare, workspaceNpmProvider()];
63909
+ var BUILTIN_PROVIDERS = [
63910
+ workspaceCloudflare,
63911
+ workspaceNpmProvider(),
63912
+ lambdaFunctionProvider()
63913
+ ];
63278
63914
  function directoriesOfPackageNames(workspaces) {
63279
63915
  const byName = new Map;
63280
63916
  for (const workspace of workspaces)
@@ -63301,15 +63937,23 @@ function workspaceClosureOf(target, byName, dependenciesOf) {
63301
63937
  // ../../packages/praxis/deploy-core/src/plan.ts
63302
63938
  async function planRepository(facts, providers = BUILTIN_PROVIDERS, options = {}) {
63303
63939
  let partial = { targets: [] };
63940
+ const warnings = [];
63304
63941
  for (const provider of providers) {
63305
63942
  const confidence = await provider.detect(facts);
63306
63943
  if (confidence === "none")
63307
63944
  continue;
63308
63945
  partial = await provider.plan(facts, partial);
63946
+ for (const warning of partial.warnings ?? [])
63947
+ if (!warnings.includes(warning))
63948
+ warnings.push(warning);
63309
63949
  }
63310
63950
  const drafts = partial.targets.filter((draft) => draft.deploy !== false);
63311
63951
  const workspaces = await readWorkspaces(facts, options);
63312
- return { commit: facts.commit, targets: closePlan(drafts, workspaces) };
63952
+ return {
63953
+ commit: facts.commit,
63954
+ targets: closePlan(drafts, workspaces),
63955
+ ...warnings.length === 0 ? {} : { warnings }
63956
+ };
63313
63957
  }
63314
63958
  function closePlan(drafts, workspaces) {
63315
63959
  const configOf = new Map(workspaces.map((workspace) => [workspace.dir, workspace.config]));
@@ -63331,7 +63975,7 @@ function closePlan(drafts, workspaces) {
63331
63975
  path: draft.path,
63332
63976
  name: draft.name,
63333
63977
  destination: draft.destination,
63334
- dependsOn: edges.get(draft.path) ?? [],
63978
+ dependsOn: [...new Set([...edges.get(draft.path) ?? [], ...draft.dependsOn ?? []])],
63335
63979
  ...draft.environments === undefined ? {} : { environments: draft.environments },
63336
63980
  production: draft.production === true,
63337
63981
  onTrain: draft.onTrain !== false,
@@ -63340,10 +63984,10 @@ function closePlan(drafts, workspaces) {
63340
63984
  }
63341
63985
  function isDeployToolDependency(name, path) {
63342
63986
  const directory = path.replace(/^(\.\/)+/, "").replace(/^\/+/, "").replace(/\/+$/, "");
63343
- if (directory === "packages/mise" || directory.startsWith("packages/mise/"))
63344
- return true;
63345
- if (directory === "packages/testing" || directory.startsWith("packages/testing/"))
63346
- return true;
63987
+ for (const root of ["packages/mise", "packages/devops", "packages/testing", "packages/bdd"]) {
63988
+ if (directory === root || directory.startsWith(`${root}/`))
63989
+ return true;
63990
+ }
63347
63991
  return name.startsWith("@mise/");
63348
63992
  }
63349
63993
  function targetsFor(plan, environment2) {
@@ -65092,7 +65736,7 @@ function planTest(flags, paths) {
65092
65736
  }
65093
65737
  function requireSingleCtrfTarget(targets) {
65094
65738
  if (targets > 1)
65095
- throw new UsageError("--ctrf names one report file but this selection covers several packages", "Run one package at a time with --ctrf, or drop --ctrf and read each run's own .mise/ctrf/<run>.json.");
65739
+ throw new UsageError("--ctrf names one report file but this selection covers several packages", "Run one package at a time with --ctrf, or drop --ctrf and read each run's own .praxis/ctrf/<run>.json.");
65096
65740
  }
65097
65741
  var FAILURE_LIMIT2 = 20;
65098
65742
  var member3 = (value, key) => typeof value === "object" && value !== null ? value[key] : undefined;
@@ -65327,6 +65971,30 @@ function bunTestRun(packagePath, code, output) {
65327
65971
  }
65328
65972
 
65329
65973
  // src/commands/devops-test.ts
65974
+ import { spawn as spawn4 } from "node:child_process";
65975
+ var CACHE_OFF_REEXEC_ENV = "PRAXIS_DEVOPS_TEST_CACHE_OFF";
65976
+ function needsCacheOffReexec(env) {
65977
+ return env.BUN_RUNTIME_TRANSPILER_CACHE_PATH !== "0" && !env[CACHE_OFF_REEXEC_ENV];
65978
+ }
65979
+ function isDevopsTestRun(words) {
65980
+ return words.join(" ") === "devops test";
65981
+ }
65982
+ function spawnInherit(cmd, args, options) {
65983
+ return new Promise((resolveCode) => {
65984
+ const child = spawn4(cmd, [...args], { cwd: options.cwd, env: options.env, stdio: "inherit" });
65985
+ child.once("error", (error) => {
65986
+ console.error(error instanceof Error ? error.message : String(error));
65987
+ resolveCode(1);
65988
+ });
65989
+ child.once("close", (code) => resolveCode(code ?? 1));
65990
+ });
65991
+ }
65992
+ function reexecWithCacheOff(options = {}) {
65993
+ return (options.spawn ?? spawnInherit)(process.execPath, options.argv ?? process.argv.slice(1), {
65994
+ cwd: options.cwd ?? process.cwd(),
65995
+ env: { ...options.env ?? process.env, BUN_RUNTIME_TRANSPILER_CACHE_PATH: "0", [CACHE_OFF_REEXEC_ENV]: "1" }
65996
+ });
65997
+ }
65330
65998
  async function devopsTest(flags, paths, ports) {
65331
65999
  const plan = planTest(flags, paths);
65332
66000
  if (plan.mode.kind === "affected")
@@ -65451,7 +66119,7 @@ async function devopsTestReportUpload(args, ports) {
65451
66119
  if (id === undefined || id === "")
65452
66120
  throw new UsageError("--upload needs --id", "Run `praxis devops test report` first to list this machine's runs, then pass one with --id.");
65453
66121
  const root = await ports.root();
65454
- const file = join6(root, ".mise", "ctrf", `${id}.json`);
66122
+ const file = join6(root, ".praxis", "ctrf", `${id}.json`);
65455
66123
  let report;
65456
66124
  try {
65457
66125
  report = await ports.readFile(file);
@@ -65527,8 +66195,8 @@ async function devopsTestInspect(args, ports) {
65527
66195
  return 0;
65528
66196
  }
65529
66197
  async function localEngine(cwd) {
65530
- const { testCommand } = await import("@mise/bdd/test-command");
65531
- const { mise } = await import("@mise/bdd");
66198
+ const { testCommand } = await import("@deepractice-ai/devops-test-engine/test-command");
66199
+ const { mise } = await import("@deepractice-ai/devops-test-engine");
65532
66200
  const { createLocalPlatform } = await import("@deepractice-ai/bdd-local");
65533
66201
  const { _scanPackages } = await import("@deepractice-ai/bdd-service/shared/bdd-config");
65534
66202
  const platform = createLocalPlatform({ cwd });
@@ -65597,8 +66265,8 @@ async function localEngine(cwd) {
65597
66265
  })
65598
66266
  };
65599
66267
  }
65600
- async function localCheckout(cwd, spawn4) {
65601
- const git2 = (args) => spawn4("git", [...args], { cwd });
66268
+ async function localCheckout(cwd, spawn5) {
66269
+ const git2 = (args) => spawn5("git", [...args], { cwd });
65602
66270
  const required = async (args) => {
65603
66271
  const result = await git2(args);
65604
66272
  if (result.code !== 0)
@@ -65634,7 +66302,7 @@ async function localCheckout(cwd, spawn4) {
65634
66302
  const files = new Map;
65635
66303
  const walk = async (dir) => {
65636
66304
  for (const entry of await readdir2(dir, { withFileTypes: true })) {
65637
- if (["node_modules", ".git", "dist", ".mise"].includes(entry.name))
66305
+ if (["node_modules", ".git", "dist", ".praxis"].includes(entry.name))
65638
66306
  continue;
65639
66307
  const full = join6(dir, entry.name);
65640
66308
  if (entry.isDirectory()) {
@@ -65649,7 +66317,7 @@ async function localCheckout(cwd, spawn4) {
65649
66317
  await walk(packagePath);
65650
66318
  return files;
65651
66319
  },
65652
- runTests: (packagePath, files) => spawn4("nice", ["-n", "10", "bun", "test", ...files], { cwd: packagePath })
66320
+ runTests: (packagePath, files) => spawn5("nice", ["-n", "10", "bun", "test", ...files], { cwd: packagePath })
65653
66321
  };
65654
66322
  }
65655
66323
  async function withEngineStdoutOnStderr(body) {
@@ -65686,7 +66354,7 @@ async function runEngineCall(call, ports) {
65686
66354
  return exitCode;
65687
66355
  }
65688
66356
  async function miseEngine(cwd) {
65689
- const { mise } = await import("@mise/bdd");
66357
+ const { mise } = await import("@deepractice-ai/devops-test-engine");
65690
66358
  const { createLocalPlatform } = await import("@deepractice-ai/bdd-local");
65691
66359
  const platform = createLocalPlatform({ cwd });
65692
66360
  return {
@@ -65826,7 +66494,7 @@ function removalSteps(key) {
65826
66494
  `No code references ${key}. The rest is not this command's to do:`,
65827
66495
  ` 1. Deploy the code that removed the references (deploy never writes the trunk).`,
65828
66496
  ` 2. Retire the flag on the platform: praxis api devops flag archive <flg_…> — the terminal state.`,
65829
- ` Archiving keeps the key reserved and turns the flag off in every environment; there is no separate delete call.`,
66497
+ ` Archiving keeps the key reserved, and is refused while reported references remain or an environment still has it on; there is no separate delete call (ADR-125 §4).`,
65830
66498
  ` 3. Regenerate the registry: praxis devops flag sync`
65831
66499
  ].join(`
65832
66500
  `);
@@ -65856,6 +66524,25 @@ async function repositoryRoot(cwd, read) {
65856
66524
  dir = parent;
65857
66525
  }
65858
66526
  }
66527
+ var SNIPPET_LIMIT = 200;
66528
+ function snippetOf(text2, line) {
66529
+ const trimmed = (text2.split(`
66530
+ `)[line - 1] ?? "").trim();
66531
+ return trimmed.length > SNIPPET_LIMIT ? trimmed.slice(0, SNIPPET_LIMIT) : trimmed;
66532
+ }
66533
+ function reportedKeys(keys, sources, refs) {
66534
+ const texts = new Map(sources.map((file) => [file.path, file.text]));
66535
+ return keys.map((flagKey) => ({
66536
+ flagKey,
66537
+ items: refs.filter((ref) => ref.key === flagKey).map((ref) => ({ path: ref.file, line: ref.line, snippet: snippetOf(texts.get(ref.file) ?? "", ref.line) }))
66538
+ }));
66539
+ }
66540
+ function reportNeedsProject() {
66541
+ return new UsageError("praxis devops flag refs --report needs the project to report into: --project <dvp_…>", "Pass the DevOps project id the flags belong to — `praxis api devops project list` lists them, or read devops.project from praxis.jsonc.");
66542
+ }
66543
+ function reportClientMissing() {
66544
+ return new UsageError("this CLI build has no client method for devops.flags.reportCodeRefs yet", "The route is declared in the protocol but the public /devops/v1 spec (and the SDK generated from it) does not carry it yet (#1881); the reference report cannot be sent until that is regenerated.");
66545
+ }
65859
66546
  async function codeSources(ports, registry) {
65860
66547
  const suffix = registry.replace(/^\.\//, "");
65861
66548
  return (await ports.sources()).filter((file) => !file.path.replace(/^\.\//, "").endsWith(suffix));
@@ -65912,15 +66599,33 @@ async function devopsFlagScaffold(key, args, ports) {
65912
66599
  ports.emit({ kind: "object", data: { key, registry, file, call: scaffoldCall(key) } });
65913
66600
  return 0;
65914
66601
  }
65915
- async function devopsFlagRefs(key, ports) {
66602
+ async function devopsFlagRefs(key, args, ports) {
65916
66603
  const registry = await registryOf(ports);
65917
66604
  const flags = await ports.loadRegistry(registry);
65918
66605
  const keys = key !== undefined ? [key] : Object.keys(flags).sort();
65919
- const refs = flagReferences(await codeSources(ports, registry), keys);
66606
+ const sources = await codeSources(ports, registry);
66607
+ const refs = flagReferences(sources, keys);
65920
66608
  for (const ref of refs)
65921
66609
  ports.human(`${ref.file}:${ref.line}: ${ref.key}`);
65922
66610
  ports.human(refs.length ? `${refs.length} reference(s) in ${new Set(refs.map((r) => r.file)).size} file(s).` : `No references to ${key ?? "any registered flag"} in this checkout.`);
65923
- ports.emit({ kind: "object", data: { refs, reported: false } });
66611
+ if (!args.report) {
66612
+ ports.emit({ kind: "object", data: { refs, reported: false } });
66613
+ return 0;
66614
+ }
66615
+ const project = args.project;
66616
+ if (project === undefined || project === "")
66617
+ throw reportNeedsProject();
66618
+ const scannedCommit = (await ports.git(["rev-parse", "HEAD"])).trim();
66619
+ if (scannedCommit === "")
66620
+ throw new UsageError("git rev-parse HEAD answered no commit", "Run this command inside a git repository.");
66621
+ const payload = reportedKeys(Object.keys(flags).sort(), sources, refs);
66622
+ const client2 = await ports.client();
66623
+ const report = client2.devops?.projects?.flags?.reportCodeRefs;
66624
+ if (typeof report !== "function")
66625
+ throw reportClientMissing();
66626
+ const answer = await report.call(client2.devops.projects.flags, { path: { project }, body: { scannedCommit, refs: payload } });
66627
+ ports.human(`Reported ${refs.length} reference(s) over ${payload.length} key(s) to ${project} at ${scannedCommit}: ${answer.updated} flag(s) updated${answer.unknownKeys.length ? `; unknown key(s): ${answer.unknownKeys.join(", ")}` : ""}.`);
66628
+ ports.emit({ kind: "object", data: { refs, reported: true, project, scannedCommit, updated: answer.updated, unknownKeys: answer.unknownKeys } });
65924
66629
  return 0;
65925
66630
  }
65926
66631
  async function devopsFlagRemove(key, ports) {
@@ -66160,9 +66865,9 @@ function refactorRoot(fileRelToCheckout, hasTsconfig) {
66160
66865
  // src/commands/devops-refactor.ts
66161
66866
  function codeRefactorEngine() {
66162
66867
  return {
66163
- rename: async (input) => (await repositoryEngine("devops refactor rename", () => import("@mise/code/rename"))).planSemanticRename(input),
66164
- check: async (input) => (await repositoryEngine("devops refactor check", () => import("@mise/code/rename"))).inspectRenamePlan(input),
66165
- apply: async (input) => (await repositoryEngine("devops refactor apply", () => import("@mise/code/rename"))).applyRenamePlan(input)
66868
+ rename: async (input) => (await repositoryEngine("devops refactor rename", () => import("@deepractice-ai/devops-refactor/rename"))).planSemanticRename(input),
66869
+ check: async (input) => (await repositoryEngine("devops refactor check", () => import("@deepractice-ai/devops-refactor/rename"))).inspectRenamePlan(input),
66870
+ apply: async (input) => (await repositoryEngine("devops refactor apply", () => import("@deepractice-ai/devops-refactor/rename"))).applyRenamePlan(input)
66166
66871
  };
66167
66872
  }
66168
66873
  function required(value, argument, use) {
@@ -68570,6 +69275,7 @@ var FILE_ID = /^file-/;
68570
69275
  var asRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
68571
69276
  var isImage = (node2) => node2.type === "image" && typeof node2.url === "string";
68572
69277
  var isRef = (node2) => node2.type === "ref" && typeof node2.ref === "string";
69278
+ var NODE_TYPES = new Set(Object.keys(KNOWN_PROPS));
68573
69279
  function visit2(value, nodeId, fn) {
68574
69280
  if (Array.isArray(value)) {
68575
69281
  for (const item of value)
@@ -69506,7 +70212,7 @@ function startProgress(ctx, write = (text2) => writeOutput({ stderr: text2 })) {
69506
70212
  }
69507
70213
 
69508
70214
  // src/main.ts
69509
- var version = "0.3.0-dev.fa6f8b5";
70215
+ var version = "0.3.0-dev.fc91058";
69510
70216
  var commands = commandTree(operations);
69511
70217
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
69512
70218
  function route(argv) {
@@ -69588,7 +70294,7 @@ var defaults = {
69588
70294
  return;
69589
70295
  const cmd = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["rundll32", "url.dll,FileProtocolHandler", url] : ["xdg-open", url];
69590
70296
  await new Promise((resolve12, reject) => {
69591
- const child = spawn4(cmd[0], cmd.slice(1), { stdio: "ignore" });
70297
+ const child = spawn5(cmd[0], cmd.slice(1), { stdio: "ignore" });
69592
70298
  child.once("error", reject);
69593
70299
  child.once("close", () => resolve12());
69594
70300
  });
@@ -69597,12 +70303,12 @@ var defaults = {
69597
70303
  wait: (ms) => new Promise((resolve12) => setTimeout(resolve12, ms)),
69598
70304
  render,
69599
70305
  spawn: (cmd, args, options) => new Promise((resolve12, reject) => {
69600
- const child = spawn4(cmd, args, { cwd: options.cwd, stdio: ["ignore", 2, 2] });
70306
+ const child = spawn5(cmd, args, { cwd: options.cwd, stdio: ["ignore", 2, 2] });
69601
70307
  child.once("error", reject);
69602
70308
  child.once("close", (code) => resolve12(code ?? 1));
69603
70309
  }),
69604
70310
  spawnCapture: (cmd, args, options) => new Promise((resolve12, reject) => {
69605
- const child = spawn4(cmd, args, { cwd: options.cwd, stdio: ["ignore", "pipe", "pipe"] });
70311
+ const child = spawn5(cmd, args, { cwd: options.cwd, stdio: ["ignore", "pipe", "pipe"] });
69606
70312
  const chunks = [];
69607
70313
  child.stdout.on("data", (c) => chunks.push(c));
69608
70314
  child.stderr.on("data", (c) => chunks.push(c));
@@ -69661,7 +70367,7 @@ var appOptions = {
69661
70367
  { name: "case", type: "string", description: "Scenario title substring; the engine's `scenario` (case ids are a later slice)." },
69662
70368
  { name: "e2e", type: "boolean", description: "The large end-to-end tests; exactly --size large, so the two cannot be combined." },
69663
70369
  { name: "retries", type: "string", description: "Retries after a failing scenario (default: 0)." },
69664
- { name: "ctrf", type: "string", description: "Write the CTRF report here (default: <cwd>/.mise/ctrf/<run>.json)." }
70370
+ { name: "ctrf", type: "string", description: "Write the CTRF report here (default: <cwd>/.praxis/ctrf/<run>.json)." }
69665
70371
  ],
69666
70372
  "devops test report": [
69667
70373
  { name: "id", type: "string", description: "Show one run's detail instead of the recent list." },
@@ -69681,6 +70387,10 @@ var appOptions = {
69681
70387
  "devops flag scaffold": [
69682
70388
  { name: "out", type: "string", description: "Directory the paired on/off scenario stubs are written to (default: the current directory)." }
69683
70389
  ],
70390
+ "devops flag refs": [
70391
+ { name: "report", type: "boolean", description: "Post this checkout's scan to the platform, so archiving a flag is refused while code still names it (ADR-125 §4)." },
70392
+ { name: "project", type: "string", description: "With --report: the DevOps project id (dvp_…) whose flags the scan is reported into. Required." }
70393
+ ],
69684
70394
  "canvas import": [
69685
70395
  { name: "name", type: "string", description: "Name for the new canvas (default: the file name without .pen)." },
69686
70396
  { name: "canvas", type: "string", description: "Import into this existing canvas instead of a new one. Whole-canvas replacement: it clears what is already there and requires --yes." },
@@ -69695,7 +70405,7 @@ var appOptions = {
69695
70405
  };
69696
70406
  appOptions["devops engine deploy"] = appOptions["devops deploy"];
69697
70407
  var workflowOptions = (words) => words[0] === "skill" ? [{ name: "install", type: "string" }] : appOptions[words.join(" ")] ?? [];
69698
- function flagPortsFor(ports, context, emit) {
70408
+ function flagPortsFor(ports, context, emit, connect) {
69699
70409
  return {
69700
70410
  mode: context.mode,
69701
70411
  emit,
@@ -69705,6 +70415,8 @@ function flagPortsFor(ports, context, emit) {
69705
70415
  },
69706
70416
  cwd: ports.cwd,
69707
70417
  readFile: ports.readFile,
70418
+ git: async (args) => (await ports.spawnCapture("git", [...args], { cwd: ports.cwd })).output,
70419
+ client: connect,
69708
70420
  writeFile: (path, text2) => writeFile5(path, text2, "utf8"),
69709
70421
  mkdir: async (path) => {
69710
70422
  await mkdir4(path, { recursive: true });
@@ -69746,7 +70458,7 @@ function toolPortsFor(ports, context, emit) {
69746
70458
  },
69747
70459
  git: (args, cwd) => ports.spawnCapture("git", args, { cwd }),
69748
70460
  run: (cmd, args, cwd) => new Promise((resolve12, reject) => {
69749
- const child = spawn4(cmd, args, { cwd, stdio: "inherit" });
70461
+ const child = spawn5(cmd, args, { cwd, stdio: "inherit" });
69750
70462
  child.once("error", reject);
69751
70463
  child.once("close", (code) => resolve12(code ?? 1));
69752
70464
  }),
@@ -70158,7 +70870,7 @@ Examples:
70158
70870
  }
70159
70871
  });
70160
70872
  }
70161
- const flagPorts = flagPortsFor(ports, ctx, emit);
70873
+ const flagPorts = flagPortsFor(ports, ctx, emit, async () => await auth.client(org));
70162
70874
  if (name === "devops flag sync")
70163
70875
  return await devopsFlagSync({ check: Boolean(parsed.flags.check) }, flagPorts);
70164
70876
  if (name === "devops flag check")
@@ -70166,7 +70878,7 @@ Examples:
70166
70878
  if (name === "devops flag scaffold")
70167
70879
  return await devopsFlagScaffold(parsed.positional[0], { out: parsed.flags.out?.[0] }, flagPorts);
70168
70880
  if (name === "devops flag refs")
70169
- return await devopsFlagRefs(parsed.positional[0], flagPorts);
70881
+ return await devopsFlagRefs(parsed.positional[0], { report: Boolean(parsed.flags.report), project: parsed.flags.project?.[0] }, flagPorts);
70170
70882
  return await devopsFlagRemove(parsed.positional[0], flagPorts);
70171
70883
  }
70172
70884
  if (!quiet)
@@ -70331,7 +71043,8 @@ if (true) {
70331
71043
  process.exit(0);
70332
71044
  throw error;
70333
71045
  });
70334
- process.exitCode = await main3(process.argv.slice(2));
71046
+ const argv = process.argv.slice(2);
71047
+ process.exitCode = isDevopsTestRun(route(argv).words) && needsCacheOffReexec(process.env) ? await reexecWithCacheOff() : await main3(argv);
70335
71048
  }
70336
71049
  export {
70337
71050
  main3 as main