@soat/sdk 0.83.1 → 0.85.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +9 -9
- package/dist/index.d.cts +386 -321
- package/dist/index.d.mts +386 -321
- package/dist/index.mjs +9 -9
- package/package.json +1 -1
package/dist/index.mjs
CHANGED
|
@@ -2230,7 +2230,7 @@ var Evaluations = class {
|
|
|
2230
2230
|
*
|
|
2231
2231
|
* `wait: true` executes the run synchronously and returns it terminal, with its scores. The dataset is capped at 25 items for a synchronous run; a larger one is rejected with 400 rather than partially scored.
|
|
2232
2232
|
*
|
|
2233
|
-
* `wait: false` (the default) enqueues one task per item and returns immediately with `status: "queued"`. A worker executes the items and the run settles itself; poll `GET /evals/{eval_id}/runs/{eval_run_id}` for the terminal status, or subscribe to the `
|
|
2233
|
+
* `wait: false` (the default) enqueues one task per item and returns immediately with `status: "queued"`. A worker executes the items and the run settles itself; poll `GET /evals/{eval_id}/runs/{eval_run_id}` for the terminal status, or subscribe to the `eval_runs.completed` webhook. There is no item cap on a queued run.
|
|
2234
2234
|
*
|
|
2235
2235
|
* The whole run is pinned to **one** agent version, stamped on `agent_version`: pass one explicitly to evaluate a canary before promoting it, or omit it to use the active release's stable version (or the live draft when no release is in effect). Without the pin, release assignment would bucket each item independently and blend two configs into a single score.
|
|
2236
2236
|
*
|
|
@@ -2271,7 +2271,7 @@ var Evaluations = class {
|
|
|
2271
2271
|
/**
|
|
2272
2272
|
* Cancel an eval run
|
|
2273
2273
|
*
|
|
2274
|
-
* Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `
|
|
2274
|
+
* Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `cancelled`.
|
|
2275
2275
|
*
|
|
2276
2276
|
* Results already written are kept — they are real measurements of generations that were really paid for — and `completed_count` / `errored_count` report what ran. `aggregate_scores` is deliberately left null: a partial roll-up in the same field a completed run uses would read as a whole-dataset verdict.
|
|
2277
2277
|
*
|
|
@@ -3453,7 +3453,7 @@ var Orchestrations = class {
|
|
|
3453
3453
|
/**
|
|
3454
3454
|
* Validate an orchestration graph
|
|
3455
3455
|
*
|
|
3456
|
-
* Statically validates an orchestration graph without persisting anything. Checks that every node has its required field, node ids are unique, edges reference existing nodes, the graph is acyclic (unless it contains a loop node), and every `input_mapping` `{"var": "..."}` reference resolves to a state key written by an upstream node or seeded by `input_schema`. Returns blocking `
|
|
3456
|
+
* Statically validates an orchestration graph without persisting anything. Checks that every node has its required field, node ids are unique, edges reference existing nodes, the graph is acyclic (unless it contains a loop node), and every `input_mapping` `{"var": "..."}` reference resolves to a state key written by an upstream node or seeded by `input_schema`. Returns blocking `problems` and non-blocking `warnings` (e.g. a state key only written on a conditional branch). The same checks are enforced on create and update, which fail with `400 ORCHESTRATION_VALIDATION_FAILED` listing the same items under `meta.problems` and `meta.warnings`.
|
|
3457
3457
|
*
|
|
3458
3458
|
*/
|
|
3459
3459
|
static validateOrchestration(options) {
|
|
@@ -3594,7 +3594,7 @@ var Orchestrations = class {
|
|
|
3594
3594
|
/**
|
|
3595
3595
|
* Start an orchestration run
|
|
3596
3596
|
*
|
|
3597
|
-
* Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status "queued" (a worker then claims it and moves it to "running") and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/
|
|
3597
|
+
* Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status "queued" (a worker then claims it and moves it to "running") and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/completed/failed). Delay and poll waits park the run as "sleeping" and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state.
|
|
3598
3598
|
*/
|
|
3599
3599
|
static startOrchestrationRun(options) {
|
|
3600
3600
|
return (options.client ?? client).post({
|
|
@@ -3871,7 +3871,7 @@ var Playbooks = class {
|
|
|
3871
3871
|
/**
|
|
3872
3872
|
* List what a node still needs
|
|
3873
3873
|
*
|
|
3874
|
-
* Returns the manual inputs still unset, or refused by their schema, before `
|
|
3874
|
+
* Returns the manual inputs still unset, or refused by their schema, before `node_id` can be reached, grouped in waves: nothing in a later wave can run before the earlier ones are filled.
|
|
3875
3875
|
*/
|
|
3876
3876
|
static getPlaybookCaseMissing(options) {
|
|
3877
3877
|
return (options.client ?? client).get({
|
|
@@ -3934,7 +3934,7 @@ var Playbooks = class {
|
|
|
3934
3934
|
/**
|
|
3935
3935
|
* Export a final node
|
|
3936
3936
|
*
|
|
3937
|
-
* Renders one revision of a final node as files, one export per transformation: each transformation's tool is called with the case's `case_id` and `subject`, the `
|
|
3937
|
+
* Renders one revision of a final node as files, one export per transformation: each transformation's tool is called with the case's `case_id` and `subject`, the `node_id`, the `revision` and that revision's `output`, and must answer a file (`execute.response_mode: base64`) of its `format`'s content type. The file is kept in the project's files under `/.system/playbooks/`. An export never feeds a node.
|
|
3938
3938
|
*
|
|
3939
3939
|
* Without `revision` the node's current output is exported, which needs the node `done` (`409 PLAYBOOK_NODE_NOT_EXPORTABLE`); a `revision` names an earlier output or confirmation of the node. Each tool runs as the author of the case's playbook version, whose permission to call it is checked here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`). A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
|
|
3940
3940
|
*
|
|
@@ -3975,7 +3975,7 @@ var Playbooks = class {
|
|
|
3975
3975
|
/**
|
|
3976
3976
|
* Upgrade a case
|
|
3977
3977
|
*
|
|
3978
|
-
* Moves a case to another version of its playbook: the playbook's current version, or the `version` named, an earlier one included. Values carry over by node
|
|
3978
|
+
* Moves a case to another version of its playbook: the playbook's current version, or the `version` named, an earlier one included. Values carry over by node ID, and every node's state is read against the new version: a node added is open, a node removed leaves the structure while its entries stay, a node whose input reads another field is `stale`, and a value its input's new schema refuses is missing again. The cascade then runs what became runnable. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. Each upgrade is recorded with what moved; the version the case is already on records nothing.
|
|
3979
3979
|
*
|
|
3980
3980
|
* An execution running is `409 PLAYBOOK_CASE_BUSY`; one queued but not started settles `superseded`. An upgrade made with a credential the case's own work runs as is `403 PLAYBOOK_SELF_WRITE`.
|
|
3981
3981
|
*/
|
|
@@ -4436,7 +4436,7 @@ var Sessions = class {
|
|
|
4436
4436
|
/**
|
|
4437
4437
|
* Add a user message
|
|
4438
4438
|
*
|
|
4439
|
-
* Saves a user message to the session. When
|
|
4439
|
+
* Saves a user message to the session. When `auto_generate` is enabled on the session and no generation is currently in progress, generation is triggered automatically and the response is the generated turn, the same body `?wait=true` generate answers. Otherwise returns the saved user message.
|
|
4440
4440
|
*
|
|
4441
4441
|
*/
|
|
4442
4442
|
static addSessionMessage(options) {
|
|
@@ -5135,7 +5135,7 @@ var Usage = class {
|
|
|
5135
5135
|
/**
|
|
5136
5136
|
* List usage thresholds
|
|
5137
5137
|
*
|
|
5138
|
-
* Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `
|
|
5138
|
+
* Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `usage_thresholds.crossed` webhook when a project's cost or token usage over a calendar-month or rolling-24h window crosses the configured value.
|
|
5139
5139
|
*
|
|
5140
5140
|
*/
|
|
5141
5141
|
static listUsageThresholds(options) {
|