@naturali/cli 0.194.2 → 0.195.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.194.2";
+var version = "0.195.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -4515,6 +4515,361 @@ var Orchestrations = class {
 		});
 	}
 };
+var Playbooks = class {
+	/**
+	* List playbooks
+	*
+	* Returns the playbooks defined in a project, newest first.
+	*/
+	static listPlaybooks(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbooks",
+			...options
+		});
+	}
+	/**
+	* Create a playbook
+	*
+	* Creates a playbook at version 1. The definition is refused with `400 PLAYBOOK_VALIDATION_FAILED` when it holds a duplicate node or input, an input reading a missing node or field, an `execute` node without an executor or another kind with one, transformations on a non-final node, or a cycle; `meta.problems` lists every one. A duplicate `name` in the project is `409 NAME_CONFLICT`.
+	*
+	* The caller becomes the version's author, whom its executors run as, so it must be allowed to start every executor the definition names (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`). A definition with executors written with a trigger or OAuth token is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`: those carry their boundary in the token, so no run can act as them.
+	*/
+	static createPlaybook(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbooks",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Validate a playbook definition
+	*
+	* Answers what a create or update would be told about a definition, without writing: `valid`, and every graph problem it holds. A definition whose shape cannot be read is `400 VALIDATION_FAILED`, as on a write.
+	*/
+	static validatePlaybook(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbooks/validate",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a playbook
+	*
+	* Deletes a playbook and its version archive. A playbook with cases is refused with `409 PLAYBOOK_HAS_CASES`.
+	*/
+	static deletePlaybook(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}",
+			...options
+		});
+	}
+	/**
+	* Get a playbook
+	*
+	* Returns a playbook with its current definition and version.
+	*/
+	static getPlaybook(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}",
+			...options
+		});
+	}
+	/**
+	* Update a playbook
+	*
+	* Updates any of `name`, `description` and `definition`. Only a change to `definition` archives a new version; a rename or a rewrite of the definition the playbook already holds leaves `version` where it is. A case keeps the version it was created on.
+	*
+	* A new version is authored by the caller, checked as on create: `403 PLAYBOOK_EXECUTOR_FORBIDDEN` for an executor it may not start, `409 PLAYBOOK_AUTHOR_UNAVAILABLE` for a trigger or OAuth token.
+	*/
+	static updatePlaybook(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a playbook's versions
+	*
+	* Returns the playbook's archived definitions, newest first. A version is written on create and on every write that changes `definition`.
+	*/
+	static listPlaybookVersions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}/versions",
+			...options
+		});
+	}
+	/**
+	* Fetch an archived playbook version
+	*
+	* Returns the definition a version held: what a case pinned to it is evaluated against.
+	*/
+	static getPlaybookVersion(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}/versions/{version}",
+			...options
+		});
+	}
+	/**
+	* Restore an archived playbook version
+	*
+	* Writes an archived definition back as the playbook's live one, which archives it again as a new version rather than rewinding the counter. Restoring the definition the playbook already holds is a no-op. The caller authors the new version, checked as on create.
+	*/
+	static restorePlaybookVersion(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}/versions/{version}/restore",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* 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.
+	*/
+	static createPlaybookCase(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbooks/{playbook_id}/cases",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List playbook cases
+	*
+	* Returns a project's cases, newest first, without node states; read one case for those.
+	*/
+	static listPlaybookCases(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases",
+			...options
+		});
+	}
+	/**
+	* Delete a case
+	*
+	* Deletes a case and every entry written to it.
+	*/
+	static deletePlaybookCase(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}",
+			...options
+		});
+	}
+	/**
+	* Get a case
+	*
+	* Returns a case with every node's state, computed from its entries on each read and never stored.
+	*/
+	static getPlaybookCase(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}",
+			...options
+		});
+	}
+	/**
+	* 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. 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`.
+	*/
+	static writePlaybookCaseInputs(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/inputs",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List what a node still needs
+	*
+	* Returns the manual inputs still unset, or refused by their schema, before `node` can be reached, grouped in waves: nothing in a later wave can run before the earlier ones are filled.
+	*/
+	static getPlaybookCaseMissing(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/missing",
+			...options
+		});
+	}
+	/**
+	* List a case's entries
+	*
+	* Returns every value written to the case, newest first. Entries are never rewritten, so this is the case's full history.
+	*/
+	static listPlaybookCaseEntries(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/entries",
+			...options
+		});
+	}
+	/**
+	* Run a node of a case
+	*
+	* 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` one: this is how a failed node is retried. 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` or `failed` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_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.
+	*/
+	static runPlaybookCaseNode(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/nodes/{node}/run",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a case's executions
+	*
+	* Returns every run of the case's nodes, newest first.
+	*/
+	static listPlaybookCaseExecutions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/executions",
+			...options
+		});
+	}
+	/**
+	* Get an execution
+	*
+	* Returns one run of a case's node.
+	*/
+	static getPlaybookCaseExecution(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/executions/{execution_id}",
+			...options
+		});
+	}
+	/**
+	* Export a final node
+	*
+	* 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`, 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.
+	*
+	* 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`.
+	*
+	* Without `wait` every export answers `running` and settles in the background; with `wait: true` it answers once each has its file or its error.
+	*/
+	static exportPlaybookCaseNode(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/nodes/{node}/exports",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a case's exports
+	*
+	* Returns every file rendered from the case's final nodes, newest first.
+	*/
+	static listPlaybookCaseExports(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/exports",
+			...options
+		});
+	}
+	/**
+	* Get an export
+	*
+	* Returns one file rendered from a case's final node.
+	*/
+	static getPlaybookCaseExport(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/exports/{export_id}",
+			...options
+		});
+	}
+	/**
+	* Upgrade a case
+	*
+	* 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 key, 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. 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`.
+	*/
+	static upgradePlaybookCase(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/upgrade",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a case's upgrades
+	*
+	* Returns every version change of the case, newest first.
+	*/
+	static listPlaybookCaseUpgrades(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/upgrades",
+			...options
+		});
+	}
+	/**
+	* Pause a case
+	*
+	* Stops the case starting anything: no node is queued and no queued execution starts until it is resumed. Executions already running settle. Input writes are still accepted. Pausing a paused case keeps the first pause.
+	*/
+	static pausePlaybookCase(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/pause",
+			...options
+		});
+	}
+	/**
+	* Resume a case
+	*
+	* Lifts the pause and starts what became runnable while the case was paused. A case that is not paused is `409 PLAYBOOK_CASE_NOT_PAUSED`.
+	*/
+	static resumePlaybookCase(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/resume",
+			...options
+		});
+	}
+	/**
+	* Confirm a node of a case
+	*
+	* 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. 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`.
+	*/
+	static confirmPlaybookCaseNode(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/playbook-cases/{case_id}/nodes/{node}/confirmation",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Projects = class {
 	/**
 	* List projects
@@ -6150,6 +6505,7 @@ var NaturaliClient = class {
 	quotas;
 	models;
 	orchestrations;
+	playbooks;
 	projects;
 	secrets;
 	sessions;
@@ -6205,6 +6561,7 @@ var NaturaliClient = class {
 		this.quotas = bindResource(Quotas, this.http);
 		this.models = bindResource(Models, this.http);
 		this.orchestrations = bindResource(Orchestrations, this.http);
+		this.playbooks = bindResource(Playbooks, this.http);
 		this.projects = bindResource(Projects, this.http);
 		this.secrets = bindResource(Secrets, this.http);
 		this.sessions = bindResource(Sessions, this.http);
@@ -6255,6 +6612,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
 	Orchestrations: () => Orchestrations,
+	Playbooks: () => Playbooks,
 	Projects: () => Projects,
 	Quotas: () => Quotas,
 	Secrets: () => Secrets,
@@ -18642,6 +19000,1082 @@ const routes = {
 			}
 		]
 	},
+	"list-playbooks": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybooks",
+		description: "Returns the playbooks defined in a project, newest first.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-playbook": {
+		serviceClass: "Playbooks",
+		operationId: "createPlaybook",
+		description: "Creates a playbook at version 1. The definition is refused with `400 PLAYBOOK_VALIDATION_FAILED` when it holds a duplicate node or input, an input reading a missing node or field, an `execute` node without an executor or another kind with one, transformations on a non-final node, or a cycle; `meta.problems` lists every one. A duplicate `name` in the project is `409 NAME_CONFLICT`. The caller becomes the version's author, whom its executors run as, so it must be allowed to start every executor the definition names (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`). A definition with executors written with a trigger or OAuth token is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`: those carry their boundary in the token, so no run can act as them.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Human-readable name, unique per project",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "What the playbook is for",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "definition",
+				"description": "The nodes and how their inputs are sourced",
+				"required": true,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "version_label",
+				"description": "Optional tag for version 1, e.g. `initial`",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"validate-playbook": {
+		serviceClass: "Playbooks",
+		operationId: "validatePlaybook",
+		description: "Answers what a create or update would be told about a definition, without writing: `valid`, and every graph problem it holds. A definition whose shape cannot be read is `400 VALIDATION_FAILED`, as on a write.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "definition",
+			"description": "The definition to check",
+			"required": true,
+			"type": "object",
+			"in": "body"
+		}]
+	},
+	"get-playbook": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybook",
+		description: "Returns a playbook with its current definition and version.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "playbook_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "playbook_id",
+			"description": "The playbook ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-playbook": {
+		serviceClass: "Playbooks",
+		operationId: "updatePlaybook",
+		description: "Updates any of `name`, `description` and `definition`. Only a change to `definition` archives a new version; a rename or a rewrite of the definition the playbook already holds leaves `version` where it is. A case keeps the version it was created on. A new version is authored by the caller, checked as on create: `403 PLAYBOOK_EXECUTOR_FORBIDDEN` for an executor it may not start, `409 PLAYBOOK_AUTHOR_UNAVAILABLE` for a trigger or OAuth token.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "patch",
+		pathParams: ["project_id", "playbook_id"],
+		queryParams: [],
+		headerParams: ["If-Match"],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "The playbook ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "If-Match",
+				"description": "The version the caller believes the resource holds, as an entity tag (`3` or `\"3\"`). Equivalent to `expected_version` in the request body; `*` states no precondition beyond the resource existing. A mismatch is `409 VERSION_CONFLICT`.",
+				"required": false,
+				"type": "string",
+				"in": "header"
+			},
+			{
+				"name": "name",
+				"description": "Human-readable name, unique per project",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "What the playbook is for",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "definition",
+				"description": "Replaces the whole definition; a change archives a new version",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "version_label",
+				"description": "Optional tag for the version this write archives. Ignored when the write changes no definition, since no version is archived.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "expected_version",
+				"description": "Refuses the write unless the playbook is at this version.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"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`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "delete",
+		pathParams: ["project_id", "playbook_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "playbook_id",
+			"description": "The playbook ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-playbook-versions": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookVersions",
+		description: "Returns the playbook's archived definitions, newest first. A version is written on create and on every write that changes `definition`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "playbook_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "The playbook ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-playbook-version": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybookVersion",
+		description: "Returns the definition a version held: what a case pinned to it is evaluated against.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"playbook_id",
+			"version"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "The playbook ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "The archived version number",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			}
+		]
+	},
+	"restore-playbook-version": {
+		serviceClass: "Playbooks",
+		operationId: "restorePlaybookVersion",
+		description: "Writes an archived definition back as the playbook's live one, which archives it again as a new version rather than rewinding the counter. Restoring the definition the playbook already holds is a no-op. The caller authors the new version, checked as on create.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"playbook_id",
+			"version"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "The playbook ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "The archived version number",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			},
+			{
+				"name": "label",
+				"description": "Optional tag for the new version. Defaults to `restored from vN`.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"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.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id", "playbook_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "The playbook ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "subject",
+				"description": "Who or what the case is about, as you name it",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"list-playbook-cases": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookCases",
+		description: "Returns a project's cases, newest first, without node states; read one case for those.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"playbook_id",
+			"automation_status",
+			"limit",
+			"offset"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "playbook_id",
+				"description": "Only the cases of this playbook",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "automation_status",
+				"description": "Only the cases in this automation status",
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-playbook-case": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybookCase",
+		description: "Returns a case with every node's state, computed from its entries on each read and never stored.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+		}]
+	},
+	"delete-playbook-case": {
+		serviceClass: "Playbooks",
+		operationId: "deletePlaybookCase",
+		description: "Deletes a case and every entry written to it.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "delete",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+		}]
+	},
+	"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. 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`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "inputs",
+				"description": "The writes, applied all or none",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			}
+		]
+	},
+	"get-playbook-case-missing": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybookCaseMissing",
+		description: "Returns the manual inputs still unset, or refused by their schema, before `node` can be reached, grouped in waves: nothing in a later wave can run before the earlier ones are filled.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: ["node"],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "The key of the node to reach, usually a final node",
+				"required": true,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"list-playbook-case-entries": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookCaseEntries",
+		description: "Returns every value written to the case, newest first. Entries are never rewritten, so this is the case's full history.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [
+			"node",
+			"limit",
+			"offset"
+		],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "Only the entries of this node",
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"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` one: this is how a failed node is retried. 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` or `failed` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_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.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"case_id",
+			"node"
+		],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "The key of a node of the case's playbook version",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "wait",
+				"description": "Answer once the executor settles or parks instead of right away",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"list-playbook-case-executions": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookCaseExecutions",
+		description: "Returns every run of the case's nodes, newest first.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [
+			"node",
+			"limit",
+			"offset"
+		],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "Only the executions of this node",
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-playbook-case-execution": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybookCaseExecution",
+		description: "Returns one run of a case's node.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"case_id",
+			"execution_id"
+		],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "execution_id",
+				"description": "The execution ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"export-playbook-case-node": {
+		serviceClass: "Playbooks",
+		operationId: "exportPlaybookCaseNode",
+		description: "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`, 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. 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`. Without `wait` every export answers `running` and settles in the background; with `wait: true` it answers once each has its file or its error.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"case_id",
+			"node"
+		],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "The key of a node of the case's playbook version",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "transformations",
+				"description": "The names of the transformations to render; every one the node declares when omitted",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "revision",
+				"description": "The output or confirmation of the node to render; its current output when omitted",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "wait",
+				"description": "Answer once every export settles instead of right away. An MCP tool call always waits.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"list-playbook-case-exports": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookCaseExports",
+		description: "Returns every file rendered from the case's final nodes, newest first.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [
+			"node",
+			"transformation",
+			"limit",
+			"offset"
+		],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "Only the exports of this node",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "transformation",
+				"description": "Only the exports of this transformation",
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-playbook-case-export": {
+		serviceClass: "Playbooks",
+		operationId: "getPlaybookCaseExport",
+		description: "Returns one file rendered from a case's final node.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"case_id",
+			"export_id"
+		],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "export_id",
+				"description": "The export ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"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 key, 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. 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`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "version",
+				"description": "The version to move the case to; the playbook's current one when omitted",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"list-playbook-case-upgrades": {
+		serviceClass: "Playbooks",
+		operationId: "listPlaybookCaseUpgrades",
+		description: "Returns every version change of the case, newest first.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "get",
+		pathParams: ["project_id", "case_id"],
+		queryParams: ["limit", "offset"],
+		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"
+			},
+			{
+				"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`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"pause-playbook-case": {
+		serviceClass: "Playbooks",
+		operationId: "pausePlaybookCase",
+		description: "Stops the case starting anything: no node is queued and no queued execution starts until it is resumed. Executions already running settle. Input writes are still accepted. Pausing a paused case keeps the first pause.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+		}]
+	},
+	"resume-playbook-case": {
+		serviceClass: "Playbooks",
+		operationId: "resumePlaybookCase",
+		description: "Lifts the pause and starts what became runnable while the case was paused. A case that is not paused is `409 PLAYBOOK_CASE_NOT_PAUSED`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: ["project_id", "case_id"],
+		queryParams: [],
+		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"
+		}]
+	},
+	"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. 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`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/playbooks",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"case_id",
+			"node"
+		],
+		queryParams: [],
+		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"
+			},
+			{
+				"name": "node",
+				"description": "The key of a node of the case's playbook version",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decision",
+				"description": "Whether the node's inputs, as read, are approved",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "reason",
+				"description": "Why the inputs were rejected; required on a rejection",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "expected_revisions",
+				"description": "Each of the node's inputs, by name, mapped to the revision read, or null for one read as unset",
+				"required": true,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
 	"list-projects": {
 		serviceClass: "Projects",
 		operationId: "listProjects",