@naturali/cli 0.208.1 → 0.208.3

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.208.1";
+var version = "0.208.3";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -4576,7 +4576,7 @@ var Playbooks = class {
 	/**
 	* Delete a playbook
 	*
-	* Deletes a playbook and its version archive. A playbook with cases is refused with `409 PLAYBOOK_HAS_CASES`.
+	* Deletes a playbook and its version archive. A playbook with cases is refused with `409 PLAYBOOK_HAS_CASES`, and one another playbook's current definition declares as an upstream with `409 PLAYBOOK_HAS_DEPENDENTS`.
 	*/
 	static deletePlaybook(options) {
 		return (options.client ?? client).delete({
@@ -4652,7 +4652,7 @@ var Playbooks = class {
 	/**
 	* Create a case
 	*
-	* Creates a case for one subject on the playbook's current version. The case stays on that version however the playbook changes later.
+	* Creates a case for one subject on the playbook's current version. The case stays on that version however the playbook changes later. A playbook that declares `upstreams` needs each bound to a case of the declared playbook, in the same project, of the same `actor_id`, that the caller may read (`playbooks:GetPlaybookCase`); anything else is `400 PLAYBOOK_CASE_UPSTREAM_INVALID`. The binding is fixed for the life of the case.
 	*/
 	static createPlaybookCase(options) {
 		return (options.client ?? client).post({
@@ -4678,7 +4678,7 @@ var Playbooks = class {
 	/**
 	* Delete a case
 	*
-	* Deletes a case and every entry written to it.
+	* Deletes a case and every entry written to it. A case other cases are bound to as their upstream is refused with `409 PLAYBOOK_CASE_HAS_DEPENDENTS`.
 	*/
 	static deletePlaybookCase(options) {
 		return (options.client ?? client).delete({
@@ -4700,7 +4700,7 @@ var Playbooks = class {
 	/**
 	* Write a case's inputs
 	*
-	* Writes a batch of manual inputs, all or none. Each write names the revision it read in `expected_revision`, `null` for a field still unset; when any field has moved on the whole batch is refused with `409 PLAYBOOK_INPUT_CONFLICT` and `meta.conflicts` names each field. An input the case's version does not declare, one that reads another node, or a value its schema refuses is `400 PLAYBOOK_INPUT_INVALID`. A value equal to the field's current one writes no revision. Once written, every node the write makes runnable is queued to run, unless the case is paused. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A write made with a credential the case's own work runs as — the case, one of its executions in flight, or the task or run one started — is `403 PLAYBOOK_SELF_WRITE`.
+	* Writes a batch of manual inputs, all or none. Each write names the revision it read in `expected_revision`, `null` for a field still unset; when any field has moved on the whole batch is refused with `409 PLAYBOOK_INPUT_CONFLICT` and `meta.conflicts` names each field. An input the case's version does not declare, one that reads another node, or a value its schema refuses is `400 PLAYBOOK_INPUT_INVALID`. A value equal to the field's current one writes no revision. Once written, every node the write makes runnable is queued to run, unless the case is paused. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A write made with a credential the case's own work runs as — the case, one of its executions in flight, or the task or run one started — or the work of a case reading it as an upstream, at any depth, is `403 PLAYBOOK_SELF_WRITE`.
 	*/
 	static writePlaybookCaseInputs(options) {
 		return (options.client ?? client).post({
@@ -4715,7 +4715,7 @@ var Playbooks = class {
 	/**
 	* List what a node still needs
 	*
-	* Returns the manual inputs still unset, or refused by their schema, upstream of `node_id`, grouped in waves: nothing in a later wave can run before the earlier ones' required inputs are filled. Optional inputs are listed with `required: false`; they never block a node.
+	* Returns the manual inputs still unset, or refused by their schema, upstream of `node_id`, grouped in waves: nothing in a later wave can run before the earlier ones' required inputs are filled. Optional inputs are listed with `required: false`; they never block a node. An `upstream` node before `node_id` adds the missing inputs of the case it is bound to, each with that case's `case_id`, so one read lists everything to ask and each answer is written to its own case.
 	*/
 	static getPlaybookCaseMissing(options) {
 		return (options.client ?? client).get({
@@ -4739,6 +4739,8 @@ var Playbooks = class {
 	*
 	* Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
 	*
+	* An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`.
+	*
 	* The output is written as an entry when the execution settles. A value equal to the node's current output writes no revision. If the node's inputs change while it runs, the execution settles as `superseded` and writes nothing.
 	*
 	* Without `wait` the execution answers `running` and settles in the background. With `wait: true` it answers once the executor settles, or once it parks: a workflow task still open, or an orchestration run waiting on a person or a timer, settles the node when it closes or ends.
@@ -4821,7 +4823,7 @@ var Playbooks = class {
 	*
 	* 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.
 	*
-	* 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`.
+	* 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, or that of a case reading it as an upstream, runs as is `403 PLAYBOOK_SELF_WRITE`.
 	*/
 	static upgradePlaybookCase(options) {
 		return (options.client ?? client).post({
@@ -4871,7 +4873,7 @@ var Playbooks = class {
 	*
 	* Approves or rejects a `confirm` node on the inputs the confirmer read. `expected_revisions` names the revision of each of the node's inputs as read (`nodes[].inputs[].revision` on the case); an input that moved since is `409 PLAYBOOK_INPUT_CONFLICT`, `meta.conflicts` naming each, and nothing is written.
 	*
-	* An approval writes a `confirmation` entry whose value is the node's input values: it is the node's output, and the nodes reading it run next. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A rejection writes a `rejection` entry with the `reason`: the node is `rejected`, and every node reading it is blocked, until its inputs change or it is approved. Another node, or a `confirm` node with a required input unset or reading a node that is not `done`, is `409 PLAYBOOK_NODE_NOT_CONFIRMABLE`. A confirmation made with a credential the case's own work runs as is `403 PLAYBOOK_SELF_WRITE`.
+	* An approval writes a `confirmation` entry whose value is the node's input values: it is the node's output, and the nodes reading it run next. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A rejection writes a `rejection` entry with the `reason`: the node is `rejected`, and every node reading it is blocked, until its inputs change or it is approved. Another node, or a `confirm` node with a required input unset or reading a node that is not `done`, is `409 PLAYBOOK_NODE_NOT_CONFIRMABLE`. A confirmation made with a credential the case's own work, or that of a case reading it as an upstream, runs as is `403 PLAYBOOK_SELF_WRITE`.
 	*/
 	static confirmPlaybookCaseNode(options) {
 		return (options.client ?? client).post({
@@ -19370,7 +19372,7 @@ const routes = {
 	"delete-playbook": {
 		serviceClass: "Playbooks",
 		operationId: "deletePlaybook",
-		description: "Deletes a playbook and its version archive. A playbook with cases is refused with `409 PLAYBOOK_HAS_CASES`.",
+		description: "Deletes a playbook and its version archive. A playbook with cases is refused with `409 PLAYBOOK_HAS_CASES`, and one another playbook's current definition declares as an upstream with `409 PLAYBOOK_HAS_DEPENDENTS`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "delete",
 		pathParams: ["project_id", "playbook_id"],
@@ -19518,7 +19520,7 @@ const routes = {
 	"create-playbook-case": {
 		serviceClass: "Playbooks",
 		operationId: "createPlaybookCase",
-		description: "Creates a case for one subject on the playbook's current version. The case stays on that version however the playbook changes later.",
+		description: "Creates a case for one subject on the playbook's current version. The case stays on that version however the playbook changes later. A playbook that declares `upstreams` needs each bound to a case of the declared playbook, in the same project, of the same `actor_id`, that the caller may read (`playbooks:GetPlaybookCase`); anything else is `400 PLAYBOOK_CASE_UPSTREAM_INVALID`. The binding is fixed for the life of the case.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: ["project_id", "playbook_id"],
@@ -19546,6 +19548,20 @@ const routes = {
 				"required": true,
 				"type": "string",
 				"in": "body"
+			},
+			{
+				"name": "actor_id",
+				"description": "The end user the case belongs to, an actor of the playbook's project; an unknown one is `400 ACTOR_NOT_FOUND`. Omitted, the case belongs to no actor.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "upstreams",
+				"description": "The case bound to each of the playbook's declared `upstreams`, by name: every declared name and no other, each a case of the declared playbook. Fixed at create; empty when the playbook declares none.",
+				"required": false,
+				"type": "object",
+				"in": "body"
 			}
 		]
 	},
@@ -19558,6 +19574,8 @@ const routes = {
 		pathParams: ["project_id"],
 		queryParams: [
 			"playbook_id",
+			"actor_id",
+			"subject",
 			"automation_status",
 			"limit",
 			"offset"
@@ -19579,6 +19597,20 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "actor_id",
+				"description": "Only the cases that belong to this actor. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent lists the cases of the end user it serves only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "subject",
+				"description": "Only the cases whose `subject` is exactly this",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "automation_status",
 				"description": "Only the cases in these automation statuses. Repeat the parameter to OR values. A value outside the enum, empty string included, is a `400`.",
@@ -19609,55 +19641,75 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "case_id",
-			"description": "The case ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "case_id",
+				"description": "The case ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
 	},
 	"delete-playbook-case": {
 		serviceClass: "Playbooks",
 		operationId: "deletePlaybookCase",
-		description: "Deletes a case and every entry written to it.",
+		description: "Deletes a case and every entry written to it. A case other cases are bound to as their upstream is refused with `409 PLAYBOOK_CASE_HAS_DEPENDENTS`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "delete",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "case_id",
-			"description": "The case ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "case_id",
+				"description": "The case ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
 	},
 	"write-playbook-case-inputs": {
 		serviceClass: "Playbooks",
 		operationId: "writePlaybookCaseInputs",
-		description: "Writes a batch of manual inputs, all or none. Each write names the revision it read in `expected_revision`, `null` for a field still unset; when any field has moved on the whole batch is refused with `409 PLAYBOOK_INPUT_CONFLICT` and `meta.conflicts` names each field. An input the case's version does not declare, one that reads another node, or a value its schema refuses is `400 PLAYBOOK_INPUT_INVALID`. A value equal to the field's current one writes no revision. Once written, every node the write makes runnable is queued to run, unless the case is paused. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A write made with a credential the case's own work runs as — the case, one of its executions in flight, or the task or run one started — is `403 PLAYBOOK_SELF_WRITE`.",
+		description: "Writes a batch of manual inputs, all or none. Each write names the revision it read in `expected_revision`, `null` for a field still unset; when any field has moved on the whole batch is refused with `409 PLAYBOOK_INPUT_CONFLICT` and `meta.conflicts` names each field. An input the case's version does not declare, one that reads another node, or a value its schema refuses is `400 PLAYBOOK_INPUT_INVALID`. A value equal to the field's current one writes no revision. Once written, every node the write makes runnable is queued to run, unless the case is paused. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A write made with a credential the case's own work runs as — the case, one of its executions in flight, or the task or run one started — or the work of a case reading it as an upstream, at any depth, is `403 PLAYBOOK_SELF_WRITE`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -19675,6 +19727,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "inputs",
 				"description": "The writes, applied all or none",
@@ -19694,11 +19753,11 @@ const routes = {
 	"get-playbook-case-missing": {
 		serviceClass: "Playbooks",
 		operationId: "getPlaybookCaseMissing",
-		description: "Returns the manual inputs still unset, or refused by their schema, upstream of `node_id`, grouped in waves: nothing in a later wave can run before the earlier ones' required inputs are filled. Optional inputs are listed with `required: false`; they never block a node.",
+		description: "Returns the manual inputs still unset, or refused by their schema, upstream of `node_id`, grouped in waves: nothing in a later wave can run before the earlier ones' required inputs are filled. Optional inputs are listed with `required: false`; they never block a node. An `upstream` node before `node_id` adds the missing inputs of the case it is bound to, each with that case's `case_id`, so one read lists everything to ask and each answer is written to its own case.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
-		queryParams: ["node_id"],
+		queryParams: ["actor_id", "node_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -19716,6 +19775,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node_id",
 				"description": "The ID of the node to reach, usually a final node",
@@ -19733,6 +19799,7 @@ const routes = {
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
 		queryParams: [
+			"actor_id",
 			"node_id",
 			"limit",
 			"offset"
@@ -19754,6 +19821,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node_id",
 				"description": "Only the entries of this node",
@@ -19780,7 +19854,7 @@ const routes = {
 	"run-playbook-case-node": {
 		serviceClass: "Playbooks",
 		operationId: "runPlaybookCaseNode",
-		description: "Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`. The output is written as an entry when the execution settles. A value equal to the node's current output writes no revision. If the node's inputs change while it runs, the execution settles as `superseded` and writes nothing. Without `wait` the execution answers `running` and settles in the background. With `wait: true` it answers once the executor settles, or once it parks: a workflow task still open, or an orchestration run waiting on a person or a timer, settles the node when it closes or ends.",
+		description: "Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`. An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`. The output is written as an entry when the execution settles. A value equal to the node's current output writes no revision. If the node's inputs change while it runs, the execution settles as `superseded` and writes nothing. Without `wait` the execution answers `running` and settles in the background. With `wait: true` it answers once the executor settles, or once it parks: a workflow task still open, or an orchestration run waiting on a person or a timer, settles the node when it closes or ends.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: [
@@ -19788,7 +19862,7 @@ const routes = {
 			"case_id",
 			"node"
 		],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -19806,6 +19880,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node",
 				"description": "The ID of a node of the case's playbook version",
@@ -19830,6 +19911,7 @@ const routes = {
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
 		queryParams: [
+			"actor_id",
 			"node_id",
 			"limit",
 			"offset"
@@ -19851,6 +19933,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node_id",
 				"description": "Only the executions of this node",
@@ -19885,7 +19974,7 @@ const routes = {
 			"case_id",
 			"execution_id"
 		],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -19903,6 +19992,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "execution_id",
 				"description": "The execution ID",
@@ -19923,7 +20019,7 @@ const routes = {
 			"case_id",
 			"node"
 		],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -19941,6 +20037,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node",
 				"description": "The ID of a node of the case's playbook version",
@@ -19979,6 +20082,7 @@ const routes = {
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
 		queryParams: [
+			"actor_id",
 			"node_id",
 			"transformation",
 			"limit",
@@ -20001,6 +20105,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node_id",
 				"description": "Only the exports of this node",
@@ -20042,7 +20153,7 @@ const routes = {
 			"case_id",
 			"export_id"
 		],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -20060,6 +20171,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "export_id",
 				"description": "The export ID",
@@ -20072,11 +20190,11 @@ const routes = {
 	"upgrade-playbook-case": {
 		serviceClass: "Playbooks",
 		operationId: "upgradePlaybookCase",
-		description: "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. 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`.",
+		description: "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. 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, or that of a case reading it as an upstream, runs as is `403 PLAYBOOK_SELF_WRITE`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -20094,6 +20212,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "version",
 				"description": "The version to move the case to; the playbook's current one when omitted",
@@ -20117,7 +20242,11 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "get",
 		pathParams: ["project_id", "case_id"],
-		queryParams: ["limit", "offset"],
+		queryParams: [
+			"actor_id",
+			"limit",
+			"offset"
+		],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -20135,6 +20264,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is `400`.",
@@ -20158,22 +20294,32 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "case_id",
-			"description": "The case ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "case_id",
+				"description": "The case ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
 	},
 	"resume-playbook-case": {
 		serviceClass: "Playbooks",
@@ -20182,27 +20328,37 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: ["project_id", "case_id"],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "case_id",
-			"description": "The case ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "case_id",
+				"description": "The case ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
 	},
 	"confirm-playbook-case-node": {
 		serviceClass: "Playbooks",
 		operationId: "confirmPlaybookCaseNode",
-		description: "Approves or rejects a `confirm` node on the inputs the confirmer read. `expected_revisions` names the revision of each of the node's inputs as read (`nodes[].inputs[].revision` on the case); an input that moved since is `409 PLAYBOOK_INPUT_CONFLICT`, `meta.conflicts` naming each, and nothing is written. An approval writes a `confirmation` entry whose value is the node's input values: it is the node's output, and the nodes reading it run next. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A rejection writes a `rejection` entry with the `reason`: the node is `rejected`, and every node reading it is blocked, until its inputs change or it is approved. Another node, or a `confirm` node with a required input unset or reading a node that is not `done`, is `409 PLAYBOOK_NODE_NOT_CONFIRMABLE`. A confirmation made with a credential the case's own work runs as is `403 PLAYBOOK_SELF_WRITE`.",
+		description: "Approves or rejects a `confirm` node on the inputs the confirmer read. `expected_revisions` names the revision of each of the node's inputs as read (`nodes[].inputs[].revision` on the case); an input that moved since is `409 PLAYBOOK_INPUT_CONFLICT`, `meta.conflicts` naming each, and nothing is written. An approval writes a `confirmation` entry whose value is the node's input values: it is the node's output, and the nodes reading it run next. With `wait: true` it answers once every execution queued, and every one those queue, has settled or parked. A rejection writes a `rejection` entry with the `reason`: the node is `rejected`, and every node reading it is blocked, until its inputs change or it is approved. Another node, or a `confirm` node with a required input unset or reading a node that is not `done`, is `409 PLAYBOOK_NODE_NOT_CONFIRMABLE`. A confirmation made with a credential the case's own work, or that of a case reading it as an upstream, runs as is `403 PLAYBOOK_SELF_WRITE`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
 		httpMethod: "post",
 		pathParams: [
@@ -20210,7 +20366,7 @@ const routes = {
 			"case_id",
 			"node"
 		],
-		queryParams: [],
+		queryParams: ["actor_id"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -20228,6 +20384,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "node",
 				"description": "The ID of a node of the case's playbook version",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.208.1",
+  "version": "0.208.3",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -31,7 +31,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.208.1",
+    "@naturali/sdk": "0.208.3",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",