@naturali/cli 0.198.0 → 0.200.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.198.0";
+var version = "0.200.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -779,7 +779,7 @@ var Channels = class {
 	/**
 	* Erase an address
 	*
-	* Removes the address, its conversations, and its runtime actor and sessions.
+	* Removes the address, its conversations and their sessions, and the actor naturali created for it. An actor bound with `actor_id` is yours and is kept.
 	*
 	*/
 	static deleteAddress(options) {
@@ -791,7 +791,7 @@ var Channels = class {
 	/**
 	* Get an address
 	*
-	* Reads one identifier's own action, if it has one. An identifier naturali has never seen is a `404`; to set an action without knowing whether it exists, use [`PUT /v1/projects/{project_id}/addresses/{identifier}`](/docs/api/addresses/set-address-action), which upserts.
+	* Reads one identifier's own action, if it has one. An identifier naturali has never seen is a `404`; to set an action without knowing whether it exists, use [`PUT /v1/projects/{project_id}/addresses/{identifier}`](/docs/api/addresses/set-address), which upserts.
 	*
 	*/
 	static getAddress(options) {
@@ -801,12 +801,14 @@ var Channels = class {
 		});
 	}
 	/**
-	* Set or clear this address's own action
+	* Set or clear this address's own action or actor
 	*
-	* 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`).
+	* Upserts the address with its `action`, the actor it speaks as, or both; a field left out is left alone. `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`).
+	*
+	* `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.
 	*
 	*/
-	static setAddressAction(options) {
+	static setAddress(options) {
 		return (options.client ?? client).put({
 			url: "/v1/projects/{project_id}/addresses/{identifier}",
 			...options,
@@ -898,7 +900,7 @@ var Channels = class {
 	* 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) {
+	static replaceChannelRoute(options) {
 		return (options.client ?? client).patch({
 			url: "/v1/projects/{project_id}/channels/{channel_id}/routes/{route_id}",
 			...options,
@@ -1120,7 +1122,7 @@ var Admin = class {
 	* Replaces the platform roles of any user. Needs the `admin` role, and each role that changes needs the caller to hold the role that grants it (today `admin` grants `admin`). Values outside the catalog are rejected with a 400, and a caller cannot remove their own `admin` role.
 	*
 	*/
-	static updateUserRoles(options) {
+	static setUserRoles(options) {
 		return (options.client ?? client).put({
 			url: "/v1/admin/users/{user_id}/roles",
 			...options,
@@ -7779,7 +7781,7 @@ const routes = {
 	"get-address": {
 		serviceClass: "Channels",
 		operationId: "getAddress",
-		description: "Reads one identifier's own action, if it has one. An identifier naturali has never seen is a `404`; to set an action without knowing whether it exists, use [`PUT /v1/projects/{project_id}/addresses/{identifier}`](/docs/api/addresses/set-address-action), which upserts.",
+		description: "Reads one identifier's own action, if it has one. An identifier naturali has never seen is a `404`; to set an action without knowing whether it exists, use [`PUT /v1/projects/{project_id}/addresses/{identifier}`](/docs/api/addresses/set-address), which upserts.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/addresses",
 		httpMethod: "get",
 		pathParams: ["project_id", "identifier"],
@@ -7800,10 +7802,10 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"set-address-action": {
+	"set-address": {
 		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`).",
+		operationId: "setAddress",
+		description: "Upserts the address with its `action`, the actor it speaks as, or both; a field left out is left alone. `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`). `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/addresses",
 		httpMethod: "put",
 		pathParams: ["project_id", "identifier"],
@@ -7825,10 +7827,17 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "actor_id",
+				"description": "An actor of this project for the address to speak as, `404` when the project has none by that id. Create it with your own user id as its `external_id`: every tool call in the address's sessions carries that actor's `actor_id` and `actor_external_id` as tool context, set by the runtime and never by the caller, so a tool knows which of your users is talking.\n\n`null` releases a bound actor (kept, not deleted); the next message gets an actor naturali creates.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
 			{
 				"name": "action",
 				"description": "What an inbound message becomes.\n\n`agent` is a dialogue: the identity behind the message gets a session, and every later message on it continues the same one. `oneshot` runs the agent once and keeps nothing — no address, no actor, no session, no conversation — so each message is answered on its own. Choose it for work that is filed rather than discussed; choose `agent` when the answer depends on what came before.\n\n`message` delivers fixed text without running an agent, and `silence` answers nothing.\n",
-				"required": true,
+				"required": false,
 				"type": "string",
 				"in": "body"
 			},
@@ -7879,7 +7888,7 @@ const routes = {
 	"delete-address": {
 		serviceClass: "Channels",
 		operationId: "deleteAddress",
-		description: "Removes the address, its conversations, and its runtime actor and sessions.",
+		description: "Removes the address, its conversations and their sessions, and the actor naturali created for it. An actor bound with `actor_id` is yours and is kept.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/addresses",
 		httpMethod: "delete",
 		pathParams: ["project_id", "identifier"],
@@ -7979,9 +7988,9 @@ const routes = {
 			}
 		]
 	},
-	"update-user-roles": {
+	"set-user-roles": {
 		serviceClass: "Admin",
-		operationId: "updateUserRoles",
+		operationId: "setUserRoles",
 		description: "Replaces the platform roles of any user. Needs the `admin` role, and each role that changes needs the caller to hold the role that grants it (today `admin` grants `admin`). Values outside the catalog are rejected with a 400, and a caller cannot remove their own `admin` role.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
 		httpMethod: "put",
@@ -10820,9 +10829,9 @@ const routes = {
 			}
 		]
 	},
-	"update-channel-route": {
+	"replace-channel-route": {
 		serviceClass: "Channels",
-		operationId: "updateChannelRoute",
+		operationId: "replaceChannelRoute",
 		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://naturali.ai/docs/modules/channel-routes",
 		httpMethod: "patch",

package/package.json

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