@naturali/cli 0.47.1 → 0.48.1

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.47.1";
+var version = "0.48.1";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -620,6 +620,272 @@ const createClient = (config = {}) => {
 const client = createClient(createConfig());
 //#endregion
 //#region ../sdk/src/generated/sdk.gen.ts
+var Channels = class {
+	/**
+	* List addresses
+	*/
+	static listAddresses(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/addresses",
+			...options
+		});
+	}
+	/**
+	* Erase an address
+	*
+	* Removes the address, its conversations, and its runtime actor and sessions.
+	*
+	*/
+	static deleteAddress(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/addresses/{identifier}",
+			...options
+		});
+	}
+	/**
+	* Get an address
+	*/
+	static getAddress(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/addresses/{identifier}",
+			...options
+		});
+	}
+	/**
+	* Set or clear this address's own action
+	*
+	* Upserts the address and its `action` in one call. `action: null` forgets the exception and defers back to the route table; any other `action` requires the same fields a route or channel default would (`agent_id` for `agent`, `text` for `message`).
+	*
+	*/
+	static setAddressAction(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/addresses/{identifier}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List an address's conversations
+	*
+	* Every conversation this address has had, across every channel it has ever messaged — an address is project-scoped, not channel-scoped.
+	*
+	*/
+	static listAddressConversations(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/addresses/{identifier}/conversations",
+			...options
+		});
+	}
+	/**
+	* List channel kinds
+	*
+	* Every connectable kind, its surfaces, and the predicates its routes can match on (engine-wide ones like `address_known` plus its own, like Discord's `guild_id`).
+	*
+	*/
+	static listChannelKinds(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/channel-kinds",
+			...options
+		});
+	}
+	/**
+	* List a channel's routes
+	*/
+	static listChannelRoutes(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/routes",
+			...options
+		});
+	}
+	/**
+	* Create a route
+	*
+	* `action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`; `repeat` is only valid alongside `action: message`. `surface`, when present, must be one this channel's kind serves (`GET /v1/channel-kinds`) — otherwise `400 unknown_surface`. `match` keys must be predicates that kind's registry declares — otherwise `400 unknown_predicate`. Writing a route for a surface whose transport mode is off (e.g. a Discord `guild_thread` route before `mention_threads` is enabled) still succeeds, with `unreachable_surface` in the response `warnings`.
+	*
+	*/
+	static createChannelRoute(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/routes",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a route
+	*/
+	static deleteChannelRoute(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Get a route
+	*/
+	static getChannelRoute(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Replace a route
+	*
+	* Full replace, the same validation as create.
+	*/
+	static updateChannelRoute(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/routes/{route_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Read the whole route table
+	*
+	* Every route across every channel in the project, one read — the table is small by construction (CHANNELS-ROUTING.md §3.6), so this is unpaginated.
+	*
+	*/
+	static listProjectChannelRoutes(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channel-routes",
+			...options
+		});
+	}
+	/**
+	* Open a conversation
+	*
+	* The outbound-first path (CHANNELS-ROUTING.md §3.11): open a conversation for `{ channel_id, identifier }` ahead of any inbound message, which falls out of making the identifier the unit rather than the message. Resolves the same three-layer action an inbound would (§3.6); a `409` when that does not land on an agent — there is nothing to open for a `message`/`silence` outcome.
+	*
+	*/
+	static createConversation(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/conversations",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List channels
+	*
+	* Lists the channels connected in the project.
+	*/
+	static listChannels(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels",
+			...options
+		});
+	}
+	/**
+	* Connect a channel
+	*
+	* Connect a channel. The required fields depend on `channel`; no credential is ever returned.
+	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
+	* **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
+	* * **BYOT** (`credential_source: byot`, default) — supply
+	* `phone_number_id` and `access_token` from your own Meta app.
+	*
+	* * **Embedded signup** (`credential_source: embedded_signup`) — supply
+	* `code` and `waba_id` (and optionally `pin`) from the Meta popup;
+	* naturali exchanges the `code` for the token and subscribes its app to
+	* the WABA, so the customer never hands over a token. Returns `501` on
+	* deployments where Meta App credentials are not configured.
+	*
+	*/
+	static createChannel(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/channels",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a channel
+	*
+	* Deletes the channel and whatever it provisioned — the WhatsApp send tool and write-only credential secret, or the Discord channel's sealed bot token (dropped with the row, closing its gateway connection).
+	*
+	*/
+	static deleteChannel(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/channels/{channel_id}",
+			...options
+		});
+	}
+	/**
+	* Get a channel
+	*/
+	static getChannel(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}",
+			...options
+		});
+	}
+	/**
+	* Update a channel
+	*
+	* Rotate the credential, update the kind's config (`waba_id` / `credential_source` for WhatsApp, `modes` for Discord), or flip the naturali-side status. At least one field is required. Rotating a WhatsApp token stores a new write-only secret, repoints the send tool and deletes the old secret; rotating a Discord bot token reseals it and the gateway worker reconnects with it.
+	*
+	*/
+	static updateChannel(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/channels/{channel_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List the channel's conversations
+	*
+	* A cursor page of the channel's conversations, newest first. A conversation is one address's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
+	* Conversations are created by the inbound path (the WhatsApp webhook, the Discord gateway worker) when a real message arrives; there is no way to create one directly.
+	*
+	*/
+	static listChannelConversations(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations",
+			...options
+		});
+	}
+	/**
+	* Get a conversation
+	*/
+	static getChannelConversation(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations/{conversation_id}",
+			...options
+		});
+	}
+	/**
+	* Read a conversation's transcript
+	*
+	* The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the runtime session the conversation maps to, so this reads through to the runtime. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.
+	*
+	*/
+	static listChannelConversationMessages(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations/{conversation_id}/messages",
+			...options
+		});
+	}
+};
 var Agents = class {
 	/**
 	* List agents
@@ -968,37 +1234,28 @@ var Boards = class {
 		});
 	}
 };
-var Channels = class {
+var Generations = class {
 	/**
-	* List channels
+	* List an agent's generations
+	*
+	* Lists the generation records the agent has produced, newest first. Filter by lifecycle `status` to find the failures without paging everything the agent has ever run.
 	*
-	* Lists the channels connected in the project.
 	*/
-	static listChannels(options) {
+	static listAgentGenerations(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels",
+			url: "/v1/projects/{project_id}/agents/{agent_id}/generations",
 			...options
 		});
 	}
 	/**
-	* Connect a channel
-	*
-	* Connect a channel. The required fields depend on `channel`; no credential is ever returned.
-	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
-	* **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
-	* * **BYOT** (`credential_source: byot`, default) — supply
-	* `phone_number_id` and `access_token` from your own Meta app.
+	* Run an agent generation
 	*
-	* * **Embedded signup** (`credential_source: embedded_signup`) — supply
-	* `code` and `waba_id` (and optionally `pin`) from the Meta popup;
-	* naturali exchanges the `code` for the token and subscribes its app to
-	* the WABA, so the customer never hands over a token. Returns `501` on
-	* deployments where Meta App credentials are not configured.
+	* Sends messages to the agent, resolves its tools, and runs the model loop. Returns the final text when `status` is `completed` (plus `object` when the agent has an output schema), or the pending `tool_calls` when `status` is `requires_action`. With `stream: true` the response is a Server-Sent Events stream (Content-Type text/event-stream) proxied from the runtime instead of a single JSON body.
 	*
 	*/
-	static createChannel(options) {
+	static createGeneration(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/channels",
+			url: "/v1/projects/{project_id}/agents/{agent_id}/generations",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -1007,145 +1264,10 @@ var Channels = class {
 		});
 	}
 	/**
-	* Delete a channel
+	* Get a generation
 	*
-	* Deletes the channel and whatever it provisioned — the WhatsApp send tool and write-only credential secret, or the Discord channel's sealed bot token (dropped with the row, closing its gateway connection).
-	*
-	*/
-	static deleteChannel(options) {
-		return (options.client ?? client).delete({
-			url: "/v1/projects/{project_id}/channels/{channel_id}",
-			...options
-		});
-	}
-	/**
-	* Get a channel
-	*/
-	static getChannel(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels/{channel_id}",
-			...options
-		});
-	}
-	/**
-	* Update a channel
-	*
-	* Rotate the credential, update the kind's config (`waba_id` / `credential_source` for WhatsApp, `modes` for Discord), or flip the naturali-side status. At least one field is required. Rotating a WhatsApp token stores a new write-only secret, repoints the send tool and deletes the old secret; rotating a Discord bot token reseals it and the gateway worker reconnects with it.
-	*
-	*/
-	static updateChannel(options) {
-		return (options.client ?? client).patch({
-			url: "/v1/projects/{project_id}/channels/{channel_id}",
-			...options,
-			headers: {
-				"Content-Type": "application/json",
-				...options.headers
-			}
-		});
-	}
-	/**
-	* Unbind the channel
-	*/
-	static deleteChannelBinding(options) {
-		return (options.client ?? client).delete({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/binding",
-			...options
-		});
-	}
-	/**
-	* Get the channel's binding
-	*/
-	static getChannelBinding(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/binding",
-			...options
-		});
-	}
-	/**
-	* Set the channel's binding
-	*
-	* Create or replace the channel's agent binding (a channel has one binding in v1). `agent_id` is required and must be an agent owned in the project; `language` / `config` / `status` default to null / null / active when absent (full replace).
-	*
-	*/
-	static setChannelBinding(options) {
-		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/binding",
-			...options,
-			headers: {
-				"Content-Type": "application/json",
-				...options.headers
-			}
-		});
-	}
-	/**
-	* List the channel's conversations
-	*
-	* A cursor page of the channel's conversations, newest first. A conversation is one address's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
-	* Conversations are created by the inbound path (the WhatsApp webhook, the Discord gateway worker) when a real message arrives; there is no way to create one directly.
-	*
-	*/
-	static listChannelConversations(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations",
-			...options
-		});
-	}
-	/**
-	* Get a conversation
-	*/
-	static getChannelConversation(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations/{conversation_id}",
-			...options
-		});
-	}
-	/**
-	* Read a conversation's transcript
-	*
-	* The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the runtime session the conversation maps to, so this reads through to the runtime. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.
-	*
-	*/
-	static listChannelConversationMessages(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/channels/{channel_id}/conversations/{conversation_id}/messages",
-			...options
-		});
-	}
-};
-var Generations = class {
-	/**
-	* List an agent's generations
-	*
-	* Lists the generation records the agent has produced, newest first. Filter by lifecycle `status` to find the failures without paging everything the agent has ever run.
-	*
-	*/
-	static listAgentGenerations(options) {
-		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/agents/{agent_id}/generations",
-			...options
-		});
-	}
-	/**
-	* Run an agent generation
-	*
-	* Sends messages to the agent, resolves its tools, and runs the model loop. Returns the final text when `status` is `completed` (plus `object` when the agent has an output schema), or the pending `tool_calls` when `status` is `requires_action`. With `stream: true` the response is a Server-Sent Events stream (Content-Type text/event-stream) proxied from the runtime instead of a single JSON body.
-	*
-	*/
-	static createGeneration(options) {
-		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/agents/{agent_id}/generations",
-			...options,
-			headers: {
-				"Content-Type": "application/json",
-				...options.headers
-			}
-		});
-	}
-	/**
-	* Get a generation
-	*
-	* Returns one generation record. Flat rather than nested under the agent, because the ids that need resolving arrive on their own — a session reply carries a `generation_id` with no agent in hand.
-	* A generation belonging to another project responds `404`, not `403` — the API never confirms that an id exists elsewhere.
+	* Returns one generation record. Flat rather than nested under the agent, because the ids that need resolving arrive on their own — a session reply carries a `generation_id` with no agent in hand.
+	* A generation belonging to another project responds `404`, not `403` — the API never confirms that an id exists elsewhere.
 	*
 	*/
 	static getGeneration(options) {
@@ -2458,11 +2580,11 @@ const dispatchCommand = async (args) => {
 //#endregion
 //#region src/generated/routes.ts
 const routes = {
-	"list-agents": {
-		serviceClass: "Agents",
-		operationId: "listAgents",
-		description: "Lists the agents in the project.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
+	"list-addresses": {
+		serviceClass: "Channels",
+		operationId: "listAddresses",
+		description: "List addresses",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/addresses",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: ["limit", "cursor"],
@@ -2490,13 +2612,35 @@ const routes = {
 			}
 		]
 	},
-	"create-agent": {
-		serviceClass: "Agents",
-		operationId: "createAgent",
-		description: "Create an agent bound to one of the project's providers (provider_id), optionally attaching tools (tool_ids). See AgentCreate for the runtime config fields.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
-		httpMethod: "post",
-		pathParams: ["project_id"],
+	"get-address": {
+		serviceClass: "Channels",
+		operationId: "getAddress",
+		description: "Get an address",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/addresses",
+		httpMethod: "get",
+		pathParams: ["project_id", "identifier"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "identifier",
+			"description": "The prefixed, self-describing channel identifier (`whatsapp:dm:<phone>`, `discord:dm:<user_id>`, `discord:thread:<guild_id>:<channel_id>`), URL-encoded.\n",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"set-address-action": {
+		serviceClass: "Channels",
+		operationId: "setAddressAction",
+		description: "Upserts the address and its `action` in one call. `action: null` forgets the exception and defers back to the route table; any other `action` requires the same fields a route or channel default would (`agent_id` for `agent`, `text` for `message`).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/addresses",
+		httpMethod: "put",
+		pathParams: ["project_id", "identifier"],
 		queryParams: [],
 		flags: [
 			{
@@ -2507,91 +2651,70 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "provider_id",
-				"description": "A provider registered in this project (aip_ prefix).",
+				"name": "identifier",
+				"description": "The prefixed, self-describing channel identifier (`whatsapp:dm:<phone>`, `discord:dm:<user_id>`, `discord:thread:<guild_id>:<channel_id>`), URL-encoded.\n",
 				"required": true,
 				"type": "string",
-				"in": "body"
+				"in": "path"
 			},
 			{
-				"name": "name",
-				"description": "Human-readable label.",
-				"required": false,
+				"name": "action",
+				"description": "",
+				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "model",
-				"description": "Model string the runtime sends (see /v1/models provider_model). Defaults to the provider's default model.",
+				"name": "agent_id",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "instructions",
-				"description": "System instructions guiding the agent's behavior.",
+				"name": "text",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "temperature",
+				"name": "repeat",
 				"description": "",
 				"required": false,
-				"type": "number",
+				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "max_steps",
+				"name": "language",
 				"description": "",
 				"required": false,
-				"type": "integer",
+				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "max_context_messages",
+				"name": "config",
 				"description": "",
 				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "tool_ids",
-				"description": "Tools to bind to the agent — each a tool_ id registered in this project. Replaces the whole binding set; [] clears it.\n",
-				"required": false,
-				"type": "array",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "tool_choice",
-				"description": "Tool choice strategy — a string (\"auto\" / \"required\") or an object ({ \"type\": \"tool\", \"name\": \"…\" }). Null (the default) leaves it unset.\n",
+				"name": "display_name",
+				"description": "Set only when the address is created by this call.",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "step_rules",
-				"description": "Per-step overrides of `tool_choice` (and, implicitly, which tools are active), applied on top of the agent's own `tool_choice` for the step number they name. The overall `tool_choice` otherwise governs every step of the run, with no relaxation once a tool has been called — the way to force a tool call on the first step without forcing one on every later step too (which runs the full `max_steps` before it can stop) is a rule for `step: 1` only. Null (the default) leaves it unset.\n",
-				"required": false,
-				"type": "array",
-				"in": "body"
-			},
-			{
-				"name": "output_schema",
-				"description": "JSON Schema describing the structured object the model must return. When set, a non-streaming generation is constrained to it and the parsed value comes back as `object` on the generation result. Omit (the default) to leave the output unconstrained. Streaming generations are unaffected.\n",
-				"required": false,
-				"type": "object",
-				"in": "body"
 			}
 		]
 	},
-	"get-agent": {
-		serviceClass: "Agents",
-		operationId: "getAgent",
-		description: "Get an agent",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
-		httpMethod: "get",
-		pathParams: ["project_id", "agent_id"],
+	"delete-address": {
+		serviceClass: "Channels",
+		operationId: "deleteAddress",
+		description: "Removes the address, its conversations, and its runtime actor and sessions.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/addresses",
+		httpMethod: "delete",
+		pathParams: ["project_id", "identifier"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -2600,21 +2723,21 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "agent_id",
-			"description": "Agent public ID (agent_ prefix).",
+			"name": "identifier",
+			"description": "The prefixed, self-describing channel identifier (`whatsapp:dm:<phone>`, `discord:dm:<user_id>`, `discord:thread:<guild_id>:<channel_id>`), URL-encoded.\n",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"update-agent": {
-		serviceClass: "Agents",
-		operationId: "updateAgent",
-		description: "Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice/step_rules), the structured-output schema (output_schema), or the naturali-side status. At least one field is required.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
-		httpMethod: "patch",
-		pathParams: ["project_id", "agent_id"],
-		queryParams: [],
+	"list-address-conversations": {
+		serviceClass: "Channels",
+		operationId: "listAddressConversations",
+		description: "Every conversation this address has had, across every channel it has ever messaged — an address is project-scoped, not channel-scoped.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/addresses",
+		httpMethod: "get",
+		pathParams: ["project_id", "identifier"],
+		queryParams: ["limit", "cursor"],
 		flags: [
 			{
 				"name": "project_id",
@@ -2624,26 +2747,214 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "agent_id",
-				"description": "Agent public ID (agent_ prefix).",
+				"name": "identifier",
+				"description": "The prefixed, self-describing channel identifier (`whatsapp:dm:<phone>`, `discord:dm:<user_id>`, `discord:thread:<guild_id>:<channel_id>`), URL-encoded.\n",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "provider_id",
-				"description": "Rebind the agent to a different provider in this project.",
+				"name": "limit",
+				"description": "Maximum items per page.",
 				"required": false,
-				"type": "string",
-				"in": "body"
+				"type": "integer",
+				"in": "query"
 			},
 			{
-				"name": "name",
-				"description": "",
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
 				"required": false,
 				"type": "string",
-				"in": "body"
-			},
+				"in": "query"
+			}
+		]
+	},
+	"list-agents": {
+		serviceClass: "Agents",
+		operationId: "listAgents",
+		description: "Lists the agents in the project.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "cursor"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-agent": {
+		serviceClass: "Agents",
+		operationId: "createAgent",
+		description: "Create an agent bound to one of the project's providers (provider_id), optionally attaching tools (tool_ids). See AgentCreate for the runtime config fields.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "provider_id",
+				"description": "A provider registered in this project (aip_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "name",
+				"description": "Human-readable label.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "model",
+				"description": "Model string the runtime sends (see /v1/models provider_model). Defaults to the provider's default model.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "instructions",
+				"description": "System instructions guiding the agent's behavior.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "temperature",
+				"description": "",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			},
+			{
+				"name": "max_steps",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "max_context_messages",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "tool_ids",
+				"description": "Tools to bind to the agent — each a tool_ id registered in this project. Replaces the whole binding set; [] clears it.\n",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "tool_choice",
+				"description": "Tool choice strategy — a string (\"auto\" / \"required\") or an object ({ \"type\": \"tool\", \"name\": \"…\" }). Null (the default) leaves it unset.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "step_rules",
+				"description": "Per-step overrides of `tool_choice` (and, implicitly, which tools are active), applied on top of the agent's own `tool_choice` for the step number they name. The overall `tool_choice` otherwise governs every step of the run, with no relaxation once a tool has been called — the way to force a tool call on the first step without forcing one on every later step too (which runs the full `max_steps` before it can stop) is a rule for `step: 1` only. Null (the default) leaves it unset.\n",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "output_schema",
+				"description": "JSON Schema describing the structured object the model must return. When set, a non-streaming generation is constrained to it and the parsed value comes back as `object` on the generation result. Omit (the default) to leave the output unconstrained. Streaming generations are unaffected.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"get-agent": {
+		serviceClass: "Agents",
+		operationId: "getAgent",
+		description: "Get an agent",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
+		httpMethod: "get",
+		pathParams: ["project_id", "agent_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "agent_id",
+			"description": "Agent public ID (agent_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-agent": {
+		serviceClass: "Agents",
+		operationId: "updateAgent",
+		description: "Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice/step_rules), the structured-output schema (output_schema), or the naturali-side status. At least one field is required.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
+		httpMethod: "patch",
+		pathParams: ["project_id", "agent_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "agent_id",
+				"description": "Agent public ID (agent_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "provider_id",
+				"description": "Rebind the agent to a different provider in this project.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
 			{
 				"name": "model",
 				"description": "",
@@ -3227,13 +3538,23 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-channels": {
+	"list-channel-kinds": {
 		serviceClass: "Channels",
-		operationId: "listChannels",
-		description: "Lists the channels connected in the project.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		operationId: "listChannelKinds",
+		description: "Every connectable kind, its surfaces, and the predicates its routes can match on (engine-wide ones like `address_known` plus its own, like Discord's `guild_id`).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-kinds",
 		httpMethod: "get",
-		pathParams: ["project_id"],
+		pathParams: [],
+		queryParams: [],
+		flags: []
+	},
+	"list-channel-routes": {
+		serviceClass: "Channels",
+		operationId: "listChannelRoutes",
+		description: "List a channel's routes",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
+		httpMethod: "get",
+		pathParams: ["project_id", "channel_id"],
 		queryParams: ["limit", "cursor"],
 		flags: [
 			{
@@ -3243,6 +3564,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "channel_id",
+				"description": "Channel public ID (chan_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum items per page.",
@@ -3259,13 +3587,13 @@ const routes = {
 			}
 		]
 	},
-	"create-channel": {
+	"create-channel-route": {
 		serviceClass: "Channels",
-		operationId: "createChannel",
-		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` (and optionally `pin`) from the Meta popup; naturali exchanges the `code` for the token and subscribes its app to the WABA, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		operationId: "createChannelRoute",
+		description: "`action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`; `repeat` is only valid alongside `action: message`. `surface`, when present, must be one this channel's kind serves (`GET /v1/channel-kinds`) — otherwise `400 unknown_surface`. `match` keys must be predicates that kind's registry declares — otherwise `400 unknown_predicate`. Writing a route for a surface whose transport mode is off (e.g. a Discord `guild_thread` route before `mention_threads` is enabled) still succeeds, with `unreachable_surface` in the response `warnings`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
 		httpMethod: "post",
-		pathParams: ["project_id"],
+		pathParams: ["project_id", "channel_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -3276,106 +3604,131 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "channel",
+				"name": "channel_id",
+				"description": "Channel public ID (chan_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "surface",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "phone_number_id",
-				"description": "Required for `whatsapp`.",
+				"name": "match",
+				"description": "",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "credential_source",
+				"name": "priority",
 				"description": "",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			},
 			{
-				"name": "access_token",
-				"description": "Write-only. Required for `byot`. The WhatsApp access token from your own Meta app. Accepted on write, never returned.\n",
-				"required": false,
+				"name": "action",
+				"description": "",
+				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "code",
-				"description": "Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned.\n",
+				"name": "agent_id",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "pin",
-				"description": "Optional (`embedded_signup` only). The number's two-step-verification PIN; when present, naturali registers the number for Cloud API sending. Never stored or returned.\n",
+				"name": "text",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "waba_id",
-				"description": "Required for `embedded_signup`; optional for `byot`.",
+				"name": "repeat",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "application_id",
-				"description": "Required for `discord`. The Discord application id.",
+				"name": "language",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "bot_token",
-				"description": "Write-only. Required for `discord`. The bot token, sealed in naturali's encrypted store so the gateway worker can authenticate its WebSocket. Accepted on write, never returned.\n",
+				"name": "config",
+				"description": "",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "modes",
-				"description": "Which Discord Gateway flows this channel serves; null for non-Discord channels. At least one must be enabled.\n* `dms` — the bot converses 1:1 in direct messages (the WhatsApp shape).\n  Needs only the non-privileged `DIRECT_MESSAGES` intent.\n\n* `mention_threads` — an @mention in a server opens a thread, and the\n  whole thread is one conversation. Reading the follow-up messages in\n  the thread needs the **privileged** `MESSAGE_CONTENT` intent, which\n  you enable on your own Discord app (Discord requires bot verification\n  past ~100 servers), so it is off unless you ask for it.\n",
+				"name": "status",
+				"description": "",
 				"required": false,
-				"type": "object",
+				"type": "string",
 				"in": "body"
 			}
 		]
 	},
-	"get-channel": {
+	"get-channel-route": {
 		serviceClass: "Channels",
-		operationId: "getChannel",
-		description: "Get a channel",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		operationId: "getChannelRoute",
+		description: "Get a route",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
 		httpMethod: "get",
-		pathParams: ["project_id", "channel_id"],
-		queryParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "channel_id",
-			"description": "Channel public ID (chan_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		pathParams: [
+			"project_id",
+			"channel_id",
+			"route_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "channel_id",
+				"description": "Channel public ID (chan_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "route_id",
+				"description": "Route public ID (route_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
 	},
-	"update-channel": {
+	"update-channel-route": {
 		serviceClass: "Channels",
-		operationId: "updateChannel",
-		description: "Rotate the credential, update the kind's config (`waba_id` / `credential_source` for WhatsApp, `modes` for Discord), or flip the naturali-side status. At least one field is required. Rotating a WhatsApp token stores a new write-only secret, repoints the send tool and deletes the old secret; rotating a Discord bot token reseals it and the gateway worker reconnects with it.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		operationId: "updateChannelRoute",
+		description: "Full replace, the same validation as create.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
 		httpMethod: "patch",
-		pathParams: ["project_id", "channel_id"],
+		pathParams: [
+			"project_id",
+			"channel_id",
+			"route_id"
+		],
 		queryParams: [],
 		flags: [
 			{
@@ -3393,36 +3746,71 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "access_token",
-				"description": "WhatsApp. Write-only. Replaces the stored credential.",
+				"name": "route_id",
+				"description": "Route public ID (route_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "surface",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "waba_id",
+				"name": "match",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "priority",
 				"description": "",
 				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "action",
+				"description": "",
+				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "credential_source",
+				"name": "agent_id",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "bot_token",
-				"description": "Discord. Write-only. Rotates the sealed bot token.",
+				"name": "text",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "modes",
-				"description": "Which Discord Gateway flows this channel serves; null for non-Discord channels. At least one must be enabled.\n* `dms` — the bot converses 1:1 in direct messages (the WhatsApp shape).\n  Needs only the non-privileged `DIRECT_MESSAGES` intent.\n\n* `mention_threads` — an @mention in a server opens a thread, and the\n  whole thread is one conversation. Reading the follow-up messages in\n  the thread needs the **privileged** `MESSAGE_CONTENT` intent, which\n  you enable on your own Discord app (Discord requires bot verification\n  past ~100 servers), so it is off unless you ask for it.\n",
+				"name": "repeat",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "language",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "config",
+				"description": "",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -3436,13 +3824,49 @@ const routes = {
 			}
 		]
 	},
-	"delete-channel": {
+	"delete-channel-route": {
 		serviceClass: "Channels",
-		operationId: "deleteChannel",
-		description: "Deletes the channel and whatever it provisioned — the WhatsApp send tool and write-only credential secret, or the Discord channel's sealed bot token (dropped with the row, closing its gateway connection).",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		operationId: "deleteChannelRoute",
+		description: "Delete a route",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
 		httpMethod: "delete",
-		pathParams: ["project_id", "channel_id"],
+		pathParams: [
+			"project_id",
+			"channel_id",
+			"route_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "channel_id",
+				"description": "Channel public ID (chan_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "route_id",
+				"description": "Route public ID (route_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"list-project-channel-routes": {
+		serviceClass: "Channels",
+		operationId: "listProjectChannelRoutes",
+		description: "Every route across every channel in the project, one read — the table is small by construction (CHANNELS-ROUTING.md §3.6), so this is unpaginated.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channel-routes",
+		httpMethod: "get",
+		pathParams: ["project_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -3450,18 +3874,171 @@ const routes = {
 			"required": true,
 			"type": "string",
 			"in": "path"
-		}, {
-			"name": "channel_id",
-			"description": "Channel public ID (chan_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
 		}]
 	},
-	"get-channel-binding": {
+	"create-conversation": {
+		serviceClass: "Channels",
+		operationId: "createConversation",
+		description: "The outbound-first path (CHANNELS-ROUTING.md §3.11): open a conversation for `{ channel_id, identifier }` ahead of any inbound message, which falls out of making the identifier the unit rather than the message. Resolves the same three-layer action an inbound would (§3.6); a `409` when that does not land on an agent — there is nothing to open for a `message`/`silence` outcome.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "channel_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "identifier",
+				"description": "The bare, channel-native identifier (a phone number, a Discord user id).",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"list-channels": {
 		serviceClass: "Channels",
-		operationId: "getChannelBinding",
-		description: "Get the channel's binding",
+		operationId: "listChannels",
+		description: "Lists the channels connected in the project.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "cursor"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-channel": {
+		serviceClass: "Channels",
+		operationId: "createChannel",
+		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` (and optionally `pin`) from the Meta popup; naturali exchanges the `code` for the token and subscribes its app to the WABA, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "default",
+				"description": "`action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`. `repeat` is only valid alongside `action: message`.\n",
+				"required": true,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "channel",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "phone_number_id",
+				"description": "Required for `whatsapp`.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "credential_source",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "access_token",
+				"description": "Write-only. Required for `byot`. The WhatsApp access token from your own Meta app. Accepted on write, never returned.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "code",
+				"description": "Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "pin",
+				"description": "Optional (`embedded_signup` only). The number's two-step-verification PIN; when present, naturali registers the number for Cloud API sending. Never stored or returned.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "waba_id",
+				"description": "Required for `embedded_signup`; optional for `byot`.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "application_id",
+				"description": "Required for `discord`. The Discord application id.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "bot_token",
+				"description": "Write-only. Required for `discord`. The bot token, sealed in naturali's encrypted store so the gateway worker can authenticate its WebSocket. Accepted on write, never returned.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "modes",
+				"description": "Which Discord Gateway flows this channel serves; null for non-Discord channels. At least one must be enabled.\n* `dms` — the bot converses 1:1 in direct messages (the WhatsApp shape).\n  Needs only the non-privileged `DIRECT_MESSAGES` intent.\n\n* `mention_threads` — an @mention in a server opens a thread, and the\n  whole thread is one conversation. Reading the follow-up messages in\n  the thread needs the **privileged** `MESSAGE_CONTENT` intent, which\n  you enable on your own Discord app (Discord requires bot verification\n  past ~100 servers), so it is off unless you ask for it.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"get-channel": {
+		serviceClass: "Channels",
+		operationId: "getChannel",
+		description: "Get a channel",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "get",
 		pathParams: ["project_id", "channel_id"],
@@ -3480,12 +4057,12 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"set-channel-binding": {
+	"update-channel": {
 		serviceClass: "Channels",
-		operationId: "setChannelBinding",
-		description: "Create or replace the channel's agent binding (a channel has one binding in v1). `agent_id` is required and must be an agent owned in the project; `language` / `config` / `status` default to null / null / active when absent (full replace).",
+		operationId: "updateChannel",
+		description: "Rotate the credential, update the kind's config (`waba_id` / `credential_source` for WhatsApp, `modes` for Discord), or flip the naturali-side status. At least one field is required. Rotating a WhatsApp token stores a new write-only secret, repoints the send tool and deletes the old secret; rotating a Discord bot token reseals it and the gateway worker reconnects with it.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
-		httpMethod: "put",
+		httpMethod: "patch",
 		pathParams: ["project_id", "channel_id"],
 		queryParams: [],
 		flags: [
@@ -3504,22 +4081,43 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "agent_id",
+				"name": "default",
+				"description": "`action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`. `repeat` is only valid alongside `action: message`.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "access_token",
+				"description": "WhatsApp. Write-only. Replaces the stored credential.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "waba_id",
 				"description": "",
-				"required": true,
+				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "language",
+				"name": "credential_source",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "config",
-				"description": "Per-binding config bag. For Discord, `discord.allowed_role_ids` and `discord.allowed_user_ids` restrict who may invoke the agent in a server — either list admits, and empty or absent lists mean everyone.\n",
+				"name": "bot_token",
+				"description": "Discord. Write-only. Rotates the sealed bot token.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "modes",
+				"description": "Which Discord Gateway flows this channel serves; null for non-Discord channels. At least one must be enabled.\n* `dms` — the bot converses 1:1 in direct messages (the WhatsApp shape).\n  Needs only the non-privileged `DIRECT_MESSAGES` intent.\n\n* `mention_threads` — an @mention in a server opens a thread, and the\n  whole thread is one conversation. Reading the follow-up messages in\n  the thread needs the **privileged** `MESSAGE_CONTENT` intent, which\n  you enable on your own Discord app (Discord requires bot verification\n  past ~100 servers), so it is off unless you ask for it.\n",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -3533,10 +4131,10 @@ const routes = {
 			}
 		]
 	},
-	"delete-channel-binding": {
+	"delete-channel": {
 		serviceClass: "Channels",
-		operationId: "deleteChannelBinding",
-		description: "Unbind the channel",
+		operationId: "deleteChannel",
+		description: "Deletes the channel and whatever it provisioned — the WhatsApp send tool and write-only credential secret, or the Discord channel's sealed bot token (dropped with the row, closing its gateway connection).",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "delete",
 		pathParams: ["project_id", "channel_id"],