@naturali/sdk 0.202.0 → 0.203.1
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 +7 -7
- package/dist/index.d.cts +338 -312
- package/dist/index.d.mts +338 -312
- package/dist/index.mjs +7 -7
- package/package.json +2 -2
package/dist/index.mjs
CHANGED
|
@@ -2904,7 +2904,7 @@ var Evaluations = class {
|
|
|
2904
2904
|
/**
|
|
2905
2905
|
* Cancel an eval run
|
|
2906
2906
|
*
|
|
2907
|
-
* Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `
|
|
2907
|
+
* Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `cancelled`.
|
|
2908
2908
|
*
|
|
2909
2909
|
* 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.
|
|
2910
2910
|
*
|
|
@@ -4266,7 +4266,7 @@ var Orchestrations = class {
|
|
|
4266
4266
|
/**
|
|
4267
4267
|
* Validate an orchestration graph
|
|
4268
4268
|
*
|
|
4269
|
-
* 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 `
|
|
4269
|
+
* 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`.
|
|
4270
4270
|
*
|
|
4271
4271
|
*/
|
|
4272
4272
|
static validateOrchestration(options) {
|
|
@@ -4417,7 +4417,7 @@ var Orchestrations = class {
|
|
|
4417
4417
|
/**
|
|
4418
4418
|
* Start an orchestration run
|
|
4419
4419
|
*
|
|
4420
|
-
* 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/
|
|
4420
|
+
* 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.
|
|
4421
4421
|
*/
|
|
4422
4422
|
static startOrchestrationRun(options) {
|
|
4423
4423
|
return (options.client ?? client).post({
|
|
@@ -4694,7 +4694,7 @@ var Playbooks = class {
|
|
|
4694
4694
|
/**
|
|
4695
4695
|
* List what a node still needs
|
|
4696
4696
|
*
|
|
4697
|
-
* Returns the manual inputs still unset, or refused by their schema, before `
|
|
4697
|
+
* 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.
|
|
4698
4698
|
*/
|
|
4699
4699
|
static getPlaybookCaseMissing(options) {
|
|
4700
4700
|
return (options.client ?? client).get({
|
|
@@ -4757,7 +4757,7 @@ var Playbooks = class {
|
|
|
4757
4757
|
/**
|
|
4758
4758
|
* Export a final node
|
|
4759
4759
|
*
|
|
4760
|
-
* 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 `
|
|
4760
|
+
* 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.
|
|
4761
4761
|
*
|
|
4762
4762
|
* 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`.
|
|
4763
4763
|
*
|
|
@@ -4798,7 +4798,7 @@ var Playbooks = class {
|
|
|
4798
4798
|
/**
|
|
4799
4799
|
* Upgrade a case
|
|
4800
4800
|
*
|
|
4801
|
-
* 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
|
|
4801
|
+
* 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.
|
|
4802
4802
|
*
|
|
4803
4803
|
* 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`.
|
|
4804
4804
|
*/
|
|
@@ -5398,7 +5398,7 @@ var Sessions = class {
|
|
|
5398
5398
|
/**
|
|
5399
5399
|
* Add a user message
|
|
5400
5400
|
*
|
|
5401
|
-
* Saves a user message to the session. When
|
|
5401
|
+
* 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.
|
|
5402
5402
|
*
|
|
5403
5403
|
*/
|
|
5404
5404
|
static addSessionMessage(options) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@naturali/sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.203.1",
|
|
4
4
|
"description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"naturali",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@hey-api/openapi-ts": "^0.99.0",
|
|
41
|
-
"@naturali/api": "0.
|
|
41
|
+
"@naturali/api": "0.203.1",
|
|
42
42
|
"@ttoss/openapi-codegen": "^0.5.0",
|
|
43
43
|
"@types/node": "^26.5.1",
|
|
44
44
|
"tsdown": "^0.23.0",
|