@naturali/cli 0.38.1 → 0.40.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.38.1";
+var version = "0.40.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) };
@@ -651,7 +651,7 @@ var Agents = class {
 	/**
 	* Delete an agent
 	*
-	* Deletes the backing SOAT agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).
+	* Deletes the backing runtime agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).
 	*
 	*/
 	static deleteAgent(options) {
@@ -672,7 +672,7 @@ var Agents = class {
 	/**
 	* Update an agent
 	*
-	* Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), or the naturali-side status. At least one field is required.
+	* Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), the structured-output schema (output_schema), or the naturali-side status. At least one field is required.
 	*
 	*/
 	static updateAgent(options) {
@@ -1024,7 +1024,7 @@ var Channels = class {
 	/**
 	* List the channel's conversations
 	*
-	* A cursor page of the channel's conversations, newest first. A conversation is one contact's dialogue on the channel — the continuity anchor that resumes the same SOAT 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.
+	* A cursor page of the channel's conversations, newest first. A conversation is one contact'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.
 	*
 	*/
@@ -1046,7 +1046,7 @@ var Channels = class {
 	/**
 	* Read a conversation's transcript
 	*
-	* The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the SOAT session the conversation maps to, so this reads through to SOAT. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.
+	* 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) {
@@ -1074,7 +1074,7 @@ var Contacts = class {
 	* Create a contact
 	*
 	* Record a contact the customer already knows about, optionally with the identifiers it is expected to arrive at.
-	* Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No SOAT actor is created here; the contact gets one on first need.
+	* Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No runtime actor is created here; the contact gets one on first need.
 	*
 	*/
 	static createContact(options) {
@@ -1090,7 +1090,7 @@ var Contacts = class {
 	/**
 	* Erase a contact
 	*
-	* **Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its SOAT actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it.
+	* **Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its runtime actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it.
 	* The upstream deletes happen first, so a failure there aborts before the local pointers are dropped and a retry can still find what is left. A contact that was merged into another cannot be erased directly: its data lives with the survivor, so erase that one.
 	*
 	*/
@@ -1169,7 +1169,7 @@ var Contacts = class {
 	* Merge another contact into this one
 	*
 	* Fold `source_contact_id` into this contact — "same human, two identifiers" (C4).
-	* What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — SOAT hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them.
+	* What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — the runtime hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them.
 	* The source is not deleted: it stays as a tombstone pointing at the survivor, and the returned merge record lists exactly what moved, so the merge can be audited and reverted.
 	*
 	*/
@@ -1225,7 +1225,7 @@ var Generations = class {
 	/**
 	* 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 SOAT instead of a single JSON body.
+	* 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) {
@@ -1254,7 +1254,7 @@ var Generations = class {
 	/**
 	* Get a generation's cost
 	*
-	* What this one generation cost, and the tokens it was charged on — the billing-grade receipt SOAT froze at write time, per model line item.
+	* What this one generation cost, and the tokens it was charged on — the billing-grade receipt the runtime froze at write time, per model line item.
 	* This is the per-generation grain that `GET /v1/projects/{project_id}/usage` cannot express: that meter buckets a whole project by model, agent, run, day or meter type, and a run can hold more than one generation. Use this to price a single turn, and the project meter to roll spend up.
 	* `cost_usd` is `null` when nothing was priced — never that the work was free. Only naturali-managed providers are priced; a BYOK generation runs on your own provider account, so it carries no LLM cost here (its tokens are still reported).
 	* A generation belonging to another project responds `404`, not `403`.
@@ -1460,7 +1460,7 @@ var Projects = class {
 	/**
 	* Delete a project
 	*
-	* Permanently deletes the project and its backing SOAT project. Fails with 409 if the SOAT project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.
+	* Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.
 	*
 	*/
 	static deleteProject(options) {
@@ -1496,7 +1496,7 @@ var Projects = class {
 	/**
 	* Get per-project usage
 	*
-	* The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd SOAT freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on SOAT), so cost reflects managed usage; BYOK usage carries no LLM cost.
+	* The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost.
 	*
 	*/
 	static getProjectUsage(options) {
@@ -1521,7 +1521,7 @@ var Providers = class {
 	/**
 	* Register a provider (managed or BYOK)
 	*
-	* Register a managed provider (naturali-keyed, priced on SOAT) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.
+	* Register a managed provider (naturali-keyed, priced on the runtime) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.
 	*
 	*/
 	static createProvider(options) {
@@ -1537,7 +1537,7 @@ var Providers = class {
 	/**
 	* Delete a provider
 	*
-	* Deletes the backing SOAT ai_provider and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.
+	* Deletes the backing provider record on the runtime and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.
 	*
 	*/
 	static deleteProvider(options) {
@@ -1576,7 +1576,7 @@ var Sessions = class {
 	/**
 	* Open a session
 	*
-	* Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing SOAT session.
+	* Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing runtime session.
 	*
 	*/
 	static createSession(options) {
@@ -1592,7 +1592,7 @@ var Sessions = class {
 	/**
 	* Get a session
 	*
-	* Returns the session's current state — status, activity timestamps and configuration — read live from the backing SOAT session, so a resumed session reflects everything that has happened since it was opened.
+	* Returns the session's current state — status, activity timestamps and configuration — read live from the backing runtime session, so a resumed session reflects everything that has happened since it was opened.
 	*
 	*/
 	static getSession(options) {
@@ -1765,7 +1765,7 @@ var Tools = class {
 	/**
 	* Delete a tool
 	*
-	* Deletes the backing SOAT tool. Returns 409 if the tool is still attached to an agent (detach it first).
+	* Deletes the backing runtime tool. Returns 409 if the tool is still attached to an agent (detach it first).
 	*
 	*/
 	static deleteTool(options) {
@@ -2387,7 +2387,7 @@ const routes = {
 			},
 			{
 				"name": "model",
-				"description": "Model string SOAT sends (see /v1/models soat_model). Defaults to the provider's default 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"
@@ -2433,6 +2433,13 @@ const routes = {
 				"required": false,
 				"type": "string",
 				"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"
 			}
 		]
 	},
@@ -2461,7 +2468,7 @@ const routes = {
 	"update-agent": {
 		serviceClass: "Agents",
 		operationId: "updateAgent",
-		description: "Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), or the naturali-side status. At least one field is required.",
+		description: "Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), 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"],
@@ -2544,6 +2551,13 @@ const routes = {
 				"type": "string",
 				"in": "body"
 			},
+			{
+				"name": "output_schema",
+				"description": "Replace the agent's structured-output schema. An object constrains non-streaming generations to it; `null` clears it and leaves the output unconstrained.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
 			{
 				"name": "status",
 				"description": "",
@@ -2556,7 +2570,7 @@ const routes = {
 	"delete-agent": {
 		serviceClass: "Agents",
 		operationId: "deleteAgent",
-		description: "Deletes the backing SOAT agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).",
+		description: "Deletes the backing runtime agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
 		httpMethod: "delete",
 		pathParams: ["project_id", "agent_id"],
@@ -3325,7 +3339,7 @@ const routes = {
 	"list-channel-conversations": {
 		serviceClass: "Channels",
 		operationId: "listChannelConversations",
-		description: "A cursor page of the channel's conversations, newest first. A conversation is one contact's dialogue on the channel — the continuity anchor that resumes the same SOAT 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.",
+		description: "A cursor page of the channel's conversations, newest first. A conversation is one contact'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.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "get",
 		pathParams: ["project_id", "channel_id"],
@@ -3419,7 +3433,7 @@ const routes = {
 	"list-channel-conversation-messages": {
 		serviceClass: "Channels",
 		operationId: "listChannelConversationMessages",
-		description: "The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the SOAT session the conversation maps to, so this reads through to SOAT. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.",
+		description: "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.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "get",
 		pathParams: [
@@ -3536,7 +3550,7 @@ const routes = {
 	"create-contact": {
 		serviceClass: "Contacts",
 		operationId: "createContact",
-		description: "Record a contact the customer already knows about, optionally with the identifiers it is expected to arrive at. Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No SOAT actor is created here; the contact gets one on first need.",
+		description: "Record a contact the customer already knows about, optionally with the identifiers it is expected to arrive at. Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No runtime actor is created here; the contact gets one on first need.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/contacts",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -3650,7 +3664,7 @@ const routes = {
 	"delete-contact": {
 		serviceClass: "Contacts",
 		operationId: "deleteContact",
-		description: "**Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its SOAT actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it. The upstream deletes happen first, so a failure there aborts before the local pointers are dropped and a retry can still find what is left. A contact that was merged into another cannot be erased directly: its data lives with the survivor, so erase that one.",
+		description: "**Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its runtime actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it. The upstream deletes happen first, so a failure there aborts before the local pointers are dropped and a retry can still find what is left. A contact that was merged into another cannot be erased directly: its data lives with the survivor, so erase that one.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/contacts",
 		httpMethod: "delete",
 		pathParams: ["project_id", "contact_id"],
@@ -3776,7 +3790,7 @@ const routes = {
 	"merge-contact": {
 		serviceClass: "Contacts",
 		operationId: "mergeContact",
-		description: "Fold `source_contact_id` into this contact — \"same human, two identifiers\" (C4). What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — SOAT hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them. The source is not deleted: it stays as a tombstone pointing at the survivor, and the returned merge record lists exactly what moved, so the merge can be audited and reverted.",
+		description: "Fold `source_contact_id` into this contact — \"same human, two identifiers\" (C4). What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — the runtime hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them. The source is not deleted: it stays as a tombstone pointing at the survivor, and the returned merge record lists exactly what moved, so the merge can be audited and reverted.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/contacts",
 		httpMethod: "post",
 		pathParams: ["project_id", "contact_id"],
@@ -3916,7 +3930,7 @@ const routes = {
 	"create-generation": {
 		serviceClass: "Generations",
 		operationId: "createGeneration",
-		description: "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 SOAT instead of a single JSON body.",
+		description: "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.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
 		httpMethod: "post",
 		pathParams: ["project_id", "agent_id"],
@@ -3998,7 +4012,7 @@ const routes = {
 	"get-generation-usage": {
 		serviceClass: "Generations",
 		operationId: "getGenerationUsage",
-		description: "What this one generation cost, and the tokens it was charged on — the billing-grade receipt SOAT froze at write time, per model line item. This is the per-generation grain that `GET /v1/projects/{project_id}/usage` cannot express: that meter buckets a whole project by model, agent, run, day or meter type, and a run can hold more than one generation. Use this to price a single turn, and the project meter to roll spend up. `cost_usd` is `null` when nothing was priced — never that the work was free. Only naturali-managed providers are priced; a BYOK generation runs on your own provider account, so it carries no LLM cost here (its tokens are still reported). A generation belonging to another project responds `404`, not `403`.",
+		description: "What this one generation cost, and the tokens it was charged on — the billing-grade receipt the runtime froze at write time, per model line item. This is the per-generation grain that `GET /v1/projects/{project_id}/usage` cannot express: that meter buckets a whole project by model, agent, run, day or meter type, and a run can hold more than one generation. Use this to price a single turn, and the project meter to roll spend up. `cost_usd` is `null` when nothing was priced — never that the work was free. Only naturali-managed providers are priced; a BYOK generation runs on your own provider account, so it carries no LLM cost here (its tokens are still reported). A generation belonging to another project responds `404`, not `403`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
 		httpMethod: "get",
 		pathParams: ["project_id", "generation_id"],
@@ -4324,7 +4338,7 @@ const routes = {
 			},
 			{
 				"name": "document_id",
-				"description": "Knowledge document public ID (doc_ prefix) — the SOAT document id.",
+				"description": "Knowledge document public ID (doc_ prefix) — the runtime document id.",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -4360,7 +4374,7 @@ const routes = {
 			},
 			{
 				"name": "document_id",
-				"description": "Knowledge document public ID (doc_ prefix) — the SOAT document id.",
+				"description": "Knowledge document public ID (doc_ prefix) — the runtime document id.",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -4396,7 +4410,7 @@ const routes = {
 			},
 			{
 				"name": "document_id",
-				"description": "Knowledge document public ID (doc_ prefix) — the SOAT document id.",
+				"description": "Knowledge document public ID (doc_ prefix) — the runtime document id.",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -4443,7 +4457,7 @@ const routes = {
 			},
 			{
 				"name": "provider",
-				"description": "Filter by the SOAT provider slug that serves the model.",
+				"description": "Filter by the provider slug that serves the model.",
 				"required": false,
 				"type": "string",
 				"in": "query"
@@ -4576,7 +4590,7 @@ const routes = {
 	"delete-project": {
 		serviceClass: "Projects",
 		operationId: "deleteProject",
-		description: "Permanently deletes the project and its backing SOAT project. Fails with 409 if the SOAT project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.",
+		description: "Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "delete",
 		pathParams: ["project_id"],
@@ -4598,7 +4612,7 @@ const routes = {
 	"get-project-usage": {
 		serviceClass: "Projects",
 		operationId: "getProjectUsage",
-		description: "The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd SOAT freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on SOAT), so cost reflects managed usage; BYOK usage carries no LLM cost.",
+		description: "The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -4673,7 +4687,7 @@ const routes = {
 	"create-provider": {
 		serviceClass: "Providers",
 		operationId: "createProvider",
-		description: "Register a managed provider (naturali-keyed, priced on SOAT) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.",
+		description: "Register a managed provider (naturali-keyed, priced on the runtime) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/providers",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -4702,14 +4716,14 @@ const routes = {
 			},
 			{
 				"name": "provider",
-				"description": "BYOK only — the SOAT provider slug.",
+				"description": "BYOK only — the provider slug.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
 				"name": "default_model",
-				"description": "BYOK only — model string SOAT sends (see /v1/models soat_model).",
+				"description": "BYOK only — model string the runtime sends (see /v1/models provider_model).",
 				"required": false,
 				"type": "string",
 				"in": "body"
@@ -4822,7 +4836,7 @@ const routes = {
 	"delete-provider": {
 		serviceClass: "Providers",
 		operationId: "deleteProvider",
-		description: "Deletes the backing SOAT ai_provider and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.",
+		description: "Deletes the backing provider record on the runtime and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/providers",
 		httpMethod: "delete",
 		pathParams: ["project_id", "provider_id"],
@@ -4844,7 +4858,7 @@ const routes = {
 			},
 			{
 				"name": "force",
-				"description": "When true, also clear the provider's soft dependents (price overrides, usage history) in SOAT. Live references (agents) always block deletion.\n",
+				"description": "When true, also clear the provider's soft dependents (price overrides, usage history) on the runtime. Live references (agents) always block deletion.\n",
 				"required": false,
 				"type": "boolean",
 				"in": "query"
@@ -4854,7 +4868,7 @@ const routes = {
 	"create-session": {
 		serviceClass: "Sessions",
 		operationId: "createSession",
-		description: "Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing SOAT session.",
+		description: "Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing runtime session.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/sessions",
 		httpMethod: "post",
 		pathParams: ["project_id", "agent_id"],
@@ -4883,14 +4897,14 @@ const routes = {
 			},
 			{
 				"name": "contact_id",
-				"description": "The contact the session is for (Contacts API, §6). naturali resolves it to the contact's SOAT actor — minting one on first need — so a web or in-app session gets the same continuity, memory and history a channel conversation gets, instead of a throwaway identity per session. When the contact has an `external_id` it rides along in `tool_context` as `actor_external_id`, so the customer's own HTTP tools receive the user reference they already key on; an explicit `tool_context` entry still wins. Mutually exclusive with `actor_id`.\n",
+				"description": "The contact the session is for (Contacts API, §6). naturali resolves it to the contact's runtime actor — minting one on first need — so a web or in-app session gets the same continuity, memory and history a channel conversation gets, instead of a throwaway identity per session. When the contact has an `external_id` it rides along in `tool_context` as `actor_external_id`, so the customer's own HTTP tools receive the user reference they already key on; an explicit `tool_context` entry still wins. Mutually exclusive with `actor_id`.\n",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
 				"name": "actor_id",
-				"description": "Public ID of an existing actor to attach as the user actor. A SOAT id showing through the public contract; prefer `contact_id`. Mutually exclusive with it.\n",
+				"description": "Public ID of an existing actor to attach as the user actor. A runtime id showing through the public contract; prefer `contact_id`. Mutually exclusive with it.\n",
 				"required": false,
 				"type": "string",
 				"in": "body"
@@ -4928,7 +4942,7 @@ const routes = {
 	"get-session": {
 		serviceClass: "Sessions",
 		operationId: "getSession",
-		description: "Returns the session's current state — status, activity timestamps and configuration — read live from the backing SOAT session, so a resumed session reflects everything that has happened since it was opened.",
+		description: "Returns the session's current state — status, activity timestamps and configuration — read live from the backing runtime session, so a resumed session reflects everything that has happened since it was opened.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/sessions",
 		httpMethod: "get",
 		pathParams: [
@@ -5579,7 +5593,7 @@ const routes = {
 	"delete-tool": {
 		serviceClass: "Tools",
 		operationId: "deleteTool",
-		description: "Deletes the backing SOAT tool. Returns 409 if the tool is still attached to an agent (detach it first).",
+		description: "Deletes the backing runtime tool. Returns 409 if the tool is still attached to an agent (detach it first).",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tools",
 		httpMethod: "delete",
 		pathParams: ["project_id", "tool_id"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.38.1",
+  "version": "0.40.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.38.1"
+    "@naturali/sdk": "0.40.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",