@naturali/cli 0.48.1 → 0.49.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.48.1";
+var version = "0.49.0";
 //#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,78 @@ const createClient = (config = {}) => {
 const client = createClient(createConfig());
 //#endregion
 //#region ../sdk/src/generated/sdk.gen.ts
+var Actors = class {
+	/**
+	* List actors
+	*
+	* Lists the project's actors. Filter by `external_id` to resolve your own key to an actor without creating one.
+	*
+	*/
+	static listActors(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/actors",
+			...options
+		});
+	}
+	/**
+	* Create an actor
+	*
+	* Creates the actor, or returns the one that already carries this `external_id`. Idempotent on that key: a retry returns the existing actor with `200` rather than creating a second one, so this is safe as the first call your backend makes when it sees a new user.
+	* `external_id` may not start with a channel prefix (`whatsapp:`, `discord:`, …) or `address:` — those name actors that belong to an [address](/docs/api/addresses/get-address), which owns its own.
+	*
+	*/
+	static createActor(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/actors",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Erase an actor
+	*
+	* Removes the actor and the sessions it holds. Erasure of one identity as this API knows it — narrower than "erase this human everywhere", since naturali does not know that two identities are the same person and does not claim to.
+	* An actor that belongs to an [address](/docs/api/addresses/get-address) responds `409`: erase it through `DELETE /v1/projects/{project_id}/addresses/{identifier}`, which also removes the address and its conversations. Deleting it here would leave those behind, pointing at an identity that no longer exists.
+	*
+	*/
+	static deleteActor(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options
+		});
+	}
+	/**
+	* Get an actor
+	*
+	* Returns one actor. An actor belonging to another project responds `404`, not `403` — the API never confirms that an id exists elsewhere.
+	*
+	*/
+	static getActor(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options
+		});
+	}
+	/**
+	* Update an actor
+	*
+	* Updates the fields present in the body and leaves the rest alone. `external_id` is not updatable: it is the key callers converge on, and moving it would silently orphan every reference they hold.
+	*
+	*/
+	static updateActor(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Channels = class {
 	/**
 	* List addresses
@@ -2151,6 +2223,7 @@ const API_BASE_URL$1 = "https://api.naturali.ai";
 * is available as typed data.
 */
 var NaturaliClient = class {
+	actors;
 	agents;
 	apiKeys;
 	assistant;
@@ -2177,6 +2250,7 @@ var NaturaliClient = class {
 				...headers
 			}
 		}));
+		this.actors = bindResource(Actors, this.http);
 		this.agents = bindResource(Agents, this.http);
 		this.apiKeys = bindResource(ApiKeys, this.http);
 		this.assistant = bindResource(Assistant, this.http);
@@ -2198,6 +2272,7 @@ var NaturaliClient = class {
 //#endregion
 //#region ../sdk/src/index.ts
 var src_exports = /* @__PURE__ */ __exportAll({
+	Actors: () => Actors,
 	Agents: () => Agents,
 	ApiKeys: () => ApiKeys,
 	Assistant: () => Assistant,
@@ -2580,6 +2655,178 @@ const dispatchCommand = async (args) => {
 //#endregion
 //#region src/generated/routes.ts
 const routes = {
+	"list-actors": {
+		serviceClass: "Actors",
+		operationId: "listActors",
+		description: "Lists the project's actors. Filter by `external_id` to resolve your own key to an actor without creating one.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"external_id",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "external_id",
+				"description": "Return only the actor carrying this external ID.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items to return (1–100).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Items to skip. This list pages by offset rather than by naturali's usual opaque cursor because the upstream ordering is offset-based; a cursor here would only imitate a keyset.\n",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-actor": {
+		serviceClass: "Actors",
+		operationId: "createActor",
+		description: "Creates the actor, or returns the one that already carries this `external_id`. Idempotent on that key: a retry returns the existing actor with `200` rather than creating a second one, so this is safe as the first call your backend makes when it sees a new user. `external_id` may not start with a channel prefix (`whatsapp:`, `discord:`, …) or `address:` — those name actors that belong to an [address](/docs/api/addresses/get-address), which owns its own.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "external_id",
+				"description": "Your own key for this person — the idempotency key this call converges on. May not start with a channel prefix (`whatsapp:`, `discord:`, …) or `address:`.\n",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "name",
+				"description": "A human-friendly name. Defaults to `external_id`.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "instructions",
+				"description": "Persona instructions composed into the agent's prompt for this actor's turns. Treat as trusted input: text an end user controls reaches the agent's instructions verbatim.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "memory",
+				"description": "Give the actor its own memory container, so an agent remembers it across sessions. Applied on creation only — a call that returns an existing actor leaves its memory as it was.\n",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-actor": {
+		serviceClass: "Actors",
+		operationId: "getActor",
+		description: "Returns one actor. An actor belonging to another project responds `404`, not `403` — the API never confirms that an id exists elsewhere.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
+		httpMethod: "get",
+		pathParams: ["project_id", "actor_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "actor_id",
+			"description": "Actor public ID (actor_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-actor": {
+		serviceClass: "Actors",
+		operationId: "updateActor",
+		description: "Updates the fields present in the body and leaves the rest alone. `external_id` is not updatable: it is the key callers converge on, and moving it would silently orphan every reference they hold.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
+		httpMethod: "patch",
+		pathParams: ["project_id", "actor_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "actor_id",
+				"description": "Actor public ID (actor_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "instructions",
+				"description": "Null clears the persona instructions.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"delete-actor": {
+		serviceClass: "Actors",
+		operationId: "deleteActor",
+		description: "Removes the actor and the sessions it holds. Erasure of one identity as this API knows it — narrower than \"erase this human everywhere\", since naturali does not know that two identities are the same person and does not claim to. An actor that belongs to an [address](/docs/api/addresses/get-address) responds `409`: erase it through `DELETE /v1/projects/{project_id}/addresses/{identifier}`, which also removes the address and its conversations. Deleting it here would leave those behind, pointing at an identity that no longer exists.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
+		httpMethod: "delete",
+		pathParams: ["project_id", "actor_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "actor_id",
+			"description": "Actor public ID (actor_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-addresses": {
 		serviceClass: "Channels",
 		operationId: "listAddresses",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.48.1",
+  "version": "0.49.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.48.1"
+    "@naturali/sdk": "0.49.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",