@naturali/cli 0.141.5 → 0.141.7

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.141.5";
+var version = "0.141.7";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -895,7 +895,8 @@ var Channels = class {
 	/**
 	* Replace a route
 	*
-	* Full replace, the same validation as create.
+	* Full replace, the same validation as create: an omitted field takes its create default. Where that default would widen a value the route sets, omission is `400 replace_omits_fields`, naming the fields in `details.fields`, and nothing is written: a set `surface` (the default is any surface), a non-empty `match` (every message), a non-empty `config` (it carries the Discord allowlist), and `status` on a `disabled` route (the default re-activates it). Send the value to keep it, or `"surface": null`, `"match": {}`, `"config": null`, `"status": "active"` to clear it.
+	*
 	*/
 	static updateChannelRoute(options) {
 		return (options.client ?? client).patch({
@@ -1258,7 +1259,7 @@ var Agents = class {
 	/**
 	* Run an agent generation
 	*
-	* Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /v1/projects/{project_id}/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting.
+	* Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /v1/projects/{project_id}/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting. Pass `idempotency_key` to make a retry safe: a request whose key is already claimed runs nothing and answers `202` with the generation the key names.
 	*
 	*/
 	static createAgentGeneration(options) {
@@ -7267,7 +7268,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the resource is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -7462,7 +7463,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the resource is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -7504,7 +7505,7 @@ const routes = {
 	"create-agent-generation": {
 		serviceClass: "Agents",
 		operationId: "createAgentGeneration",
-		description: "Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /v1/projects/{project_id}/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting.",
+		description: "Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /v1/projects/{project_id}/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting. Pass `idempotency_key` to make a retry safe: a request whose key is already claimed runs nothing and answers `202` with the generation the key names.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
 		httpMethod: "post",
 		pathParams: ["project_id", "agent_id"],
@@ -7600,6 +7601,13 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-supplied key/value metadata attached to the generation record for per-run audit attribution (e.g. the knowledge-corpus version that produced this action). Round-trips verbatim when the generation is fetched via the generations API. The bag is caller-owned and no key is reserved: server-owned state (usage attribution, the served agent version, the model route's record, the extraction summary) lives in its own top-level generation fields and cannot be written from here. Use the request's own `action_id` field to set the usage-attribution label.",
 				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "idempotency_key",
+				"description": "Deduplication key, unique within the project, that makes a retry of an at-least-once delivery or an ambiguous failure safe. The first request under a key runs the generation; any later request carrying it runs nothing and answers `202` with the generation the key names, whatever state it has reached — including a retry that arrives while the original is still running. The key is claimed by the generation record for as long as the record exists.\n\nEvery other body field except `stream` is the request the key names: reusing a key with any of them changed, or on another agent of the project, is `409 IDEMPOTENCY_KEY_REUSED`. `stream` and `wait` say how the caller receives the generation, not what it is, so a retry may flip them.",
+				"required": false,
 				"type": "string",
 				"in": "body"
 			},
@@ -9149,7 +9157,7 @@ const routes = {
 	"update-channel-route": {
 		serviceClass: "Channels",
 		operationId: "updateChannelRoute",
-		description: "Full replace, the same validation as create.",
+		description: "Full replace, the same validation as create: an omitted field takes its create default. Where that default would widen a value the route sets, omission is `400 replace_omits_fields`, naming the fields in `details.fields`, and nothing is written: a set `surface` (the default is any surface), a non-empty `match` (every message), a non-empty `config` (it carries the Discord allowlist), and `status` on a `disabled` route (the default re-activates it). Send the value to keep it, or `\"surface\": null`, `\"match\": {}`, `\"config\": null`, `\"status\": \"active\"` to clear it.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
 		httpMethod: "patch",
 		pathParams: [
@@ -10081,7 +10089,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-owned annotations on the message (e.g. a phone number, a channel), stored as sent and returned verbatim. The platform does not read the bag, so nothing in it reaches the model: a value the model should see belongs in `message`.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -10385,7 +10393,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -10592,7 +10600,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Arbitrary metadata object, replacing the stored bag; `null` clears it. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -10606,7 +10614,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the document is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -10805,7 +10813,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the withdrawal unless the document is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -11336,7 +11344,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Free-form tags, opaque to the platform",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -11384,7 +11392,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Free-form tags, opaque to the platform",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -11443,7 +11451,7 @@ const routes = {
 				"name": "metadata",
 				"description": "",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -11776,7 +11784,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-supplied key/value metadata attached to the run record for attribution — what this measurement was of (the commit or release candidate being scored, the CI job that asked for it). Round-trips verbatim on every read of the run, the list included.\n\nThe bag is caller-owned and no key is reserved: everything the platform decides about a run (`status`, `agent_version`, `baseline_run_id`, `aggregate_scores`, `passed`, the counts) is a field of its own and cannot be written from here. Nothing in the scoring path reads it. A non-object is rejected with `400 VALIDATION_FAILED` and no run is created.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -12351,7 +12359,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Replaces the stored bag; `null` clears it.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -12628,7 +12636,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Static annotations stored on the formation record. This field is NOT a substitution site: `sub`/`param`/`ref` expressions are rejected with 400 (`FORMATION_INVALID_METADATA`). For deploy-time substitution use the template's top-level `metadata` block, which is resolved into `resolved_metadata`.\n",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -12700,7 +12708,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Static annotations stored on the formation record. This field is NOT a substitution site: `sub`/`param`/`ref` expressions are rejected with 400 (`FORMATION_INVALID_METADATA`). For deploy-time substitution use the template's top-level `metadata` block, which is resolved into `resolved_metadata`.\n",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -12932,7 +12940,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-supplied key/value metadata to shallow-merge into the generation record's caller-owned `metadata` bag. No key is reserved: server-owned state lives in its own top-level fields and cannot be written from here.\n",
 				"required": true,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -13183,7 +13191,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the resource is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -13510,7 +13518,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Arbitrary JSON metadata",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -13759,14 +13767,14 @@ const routes = {
 				"name": "tags",
 				"description": "Filter results to documents and memories whose `tags` contain every one of these key-value pairs (exact, case-sensitive match). Scopes both stores, so passing it alone searches both — as `query` does. For memories it matches at memory granularity: a memory is returned when its parent memory store's tags match or its own do.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
 				"name": "metadata",
 				"description": "Filter document results by their `metadata` bag. A document-store filter: a memory carries no such bag, so passing it alone searches documents, as `document_paths` does.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -13882,14 +13890,14 @@ const routes = {
 				"name": "tags",
 				"description": "Per-memory key-value tags, used for memory-granularity filtering by `tags` in search-knowledge.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
 				"name": "metadata",
 				"description": "Arbitrary structured metadata attached to the memory",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -13982,21 +13990,21 @@ const routes = {
 				"name": "tags",
 				"description": "Replaces the memory's tags. Pass null or an empty object to clear.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
 				"name": "metadata",
 				"description": "Replaces the memory's metadata. Pass null to clear.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
 				"name": "expected_version",
 				"description": "Refuses the write unless the memory is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -14061,7 +14069,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the retraction unless the memory is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -14547,7 +14555,7 @@ const routes = {
 				"name": "tags",
 				"description": "Optional key-value tags. Scopes the memory store in knowledge search, where every requested pair must match exactly.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -14633,7 +14641,7 @@ const routes = {
 				"name": "tags",
 				"description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -14980,7 +14988,7 @@ const routes = {
 				"name": "metadata",
 				"description": "The bag to judge. Absent or `null` is judged as an empty bag.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -15616,7 +15624,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the resource is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]
@@ -15881,7 +15889,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-supplied key/value metadata attached to the run record for per-run attribution (e.g. which of your own tenants this run belongs to, or the dispatch batch that started it). Round-trips verbatim on every read of the run, on the list as well as the single read.\n\nThe bag is caller-owned and no key is reserved: server-owned state (status, the pinned orchestration version, the trace, usage, artifacts, the run's own `input` and accumulated `state`) lives in its own top-level field and cannot be written from here.\n\nIt is **not** merged into run state: no graph node sees it, and an `input_schema` never has to tolerate it — which is what makes it the place for an infrastructural label, rather than `input`. Keys are never transformed. It is not inherited by the child runs a `loop` or `sub_orchestration` node starts; each child carries whatever the graph gives it, which today is nothing.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
@@ -17842,7 +17850,7 @@ const routes = {
 				"name": "metadata",
 				"description": "Caller-supplied key/value metadata attached to the task record for attribution — which of your own tenants the task belongs to, the ticket that raised it, the import batch that created it. Round-trips verbatim on every read of the task, the list included, and survives every transition (a transition supplies no metadata of its own).\n\nThe bag is caller-owned and no key is reserved: everything the engine decides about a task (`state`, `status`, `workflow_version`, `last_result`, `active_dispatch`, the automation fields) is a field of its own and cannot be written from here.\n\nPrefer this over `payload` for anything that is not task data: `payload` is read by every guard as `task.payload` and may be written by the workflow's declared `payload_writes`, so a label parked there is neither invisible to the state machine nor safe from it. A non-object is rejected with `400 VALIDATION_FAILED` and no task is created.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -18670,7 +18678,7 @@ const routes = {
 			},
 			{
 				"name": "tool_context",
-				"description": "Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Naturali-Context-<key>` header.\n\n**Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.\n\nA value may be a `{{secret:...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its name on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference naming a secret that does not exist in this project is refused here rather than at fire time.\n",
+				"description": "Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Naturali-Context-<key>` header.\n\n**Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.\n\nA value may be a `{{secret:sec_...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its id on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference is refused here rather than at fire time when it is not in that id form (a secret's name does not resolve) or names a secret that does not exist in this project.\n",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -19585,7 +19593,7 @@ const routes = {
 				"name": "expected_version",
 				"description": "Refuses the write unless the resource is at this version.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			}
 		]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.141.5",
+  "version": "0.141.7",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.141.5",
+    "@naturali/sdk": "0.141.7",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",