@naturali/cli 0.61.0 → 0.62.0

package/README.md

@@ -40,7 +40,7 @@ naturali create-agent \
   --project-id proj_V1StGXR8Z5jdHi6B \
   --provider-id aip_V1StGXR8Z5jdHi6B \
   --name support-triage \
-  --tool-ids tool_V1StGXR8Z5jdHi6B
+  --tool-bindings '[{"tool_id":"tool_V1StGXR8Z5jdHi6B"}]'
 ```
 
 Where a flag's value goes — URL path, query string or request body — comes from
@@ -53,7 +53,7 @@ the spec, so you never have to know.
 | String | `--name support-triage` |
 | Number / boolean | `--temperature 0.7`, `--force` (a bare flag is `true`) |
 | Object | `--tool-choice '{"type":"tool","name":"get_weather"}'` |
-| Array | repeat the flag (`--tool-ids a --tool-ids b`) or pass a JSON array (`--tool-ids '["a","b"]'`) |
+| Array | repeat the flag (`--capabilities a --capabilities b`) or pass a JSON array (`--tool-bindings '[{"tool_id":"tool_a"}]'`) |
 
 An array-typed field is always sent as a list, even with one value.
 

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.61.0";
+var version = "0.62.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) };
@@ -973,7 +973,7 @@ var Agents = class {
 	/**
 	* Create an agent
 	*
-	* 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.
+	* Create an agent bound to one of the project's providers (provider_id), optionally attaching tools (tool_bindings). See AgentCreate for the runtime config fields.
 	*
 	*/
 	static createAgent(options) {
@@ -1010,7 +1010,7 @@ var Agents = class {
 	/**
 	* Update an agent
 	*
-	* 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.
+	* Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_bindings/tool_choice/step_rules), the structured-output schema (output_schema), or the naturali-side status. At least one field is required.
 	*
 	*/
 	static updateAgent(options) {
@@ -2700,10 +2700,13 @@ const parseFlagValue = (value) => {
 };
 /**
 * Builds the value for an array-typed flag. Repeated occurrences
-* (`--tool-ids tool_a --tool-ids tool_b`) collect into a list; a single JSON
-* array literal (`--tool-ids '["tool_a"]'`) passes through unwrapped; a single
-* scalar becomes a one-element array, so an array field never reaches the API
-* as a bare string.
+* (`--capabilities a --capabilities b`) collect into a list; a single JSON
+* array literal (`--capabilities '["a","b"]'`) passes through unwrapped; a
+* single scalar becomes a one-element array, so an array field never reaches
+* the API as a bare string.
+*
+* An array *of objects* — `tool_bindings` — has only the literal form:
+* `--tool-bindings '[{"tool_id":"tool_a"}]'`.
 */
 const buildArrayFlagValue = (rawValues) => {
 	const parsed = rawValues.map((value) => {
@@ -3368,7 +3371,7 @@ 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.",
+		description: "Create an agent bound to one of the project's providers (provider_id), optionally attaching tools (tool_bindings). See AgentCreate for the runtime config fields.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/agents",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -3431,22 +3434,22 @@ const routes = {
 				"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",
+				"name": "tool_bindings",
+				"description": "Tools to bind to the agent — each naming 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",
+				"description": "Tool choice strategy — a string (`auto`, `required`, `none`) or an object naming one tool (`{ \"type\": \"tool\", \"name\": \"…\" }`). Null (the default) leaves it unset.\n\nThe shape is validated on write: an unrecognized string, an unknown field on the object form, or a `type` other than `tool` is a `400` rather than a value that is accepted and then ignored. There is exactly one spelling of each field — camelCase variants such as `toolName` are refused, not translated.\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",
+				"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\nA rule carries `step` and `tool_choice` and nothing else. An unknown field is a `400` naming it, because a rule the runtime does not recognize is dropped rather than corrected — the agent would keep running with the rule silently not applied.\n",
 				"required": false,
 				"type": "array",
 				"in": "body"
@@ -3492,7 +3495,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/step_rules), the structured-output schema (output_schema), 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_bindings/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"],
@@ -3562,22 +3565,22 @@ const routes = {
 				"in": "body"
 			},
 			{
-				"name": "tool_ids",
-				"description": "Replace the agent's bound tools with exactly this set (each a tool_ id in this project); [] detaches all tools.\n",
+				"name": "tool_bindings",
+				"description": "Replace the agent's bound tools with exactly this set (each naming a tool_ id in this project); [] detaches all tools.\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",
+				"description": "Tool choice strategy — a string (`auto`, `required`, `none`) or an object naming one tool (`{ \"type\": \"tool\", \"name\": \"…\" }`). Null (the default) leaves it unset.\n\nThe shape is validated on write: an unrecognized string, an unknown field on the object form, or a `type` other than `tool` is a `400` rather than a value that is accepted and then ignored. There is exactly one spelling of each field — camelCase variants such as `toolName` are refused, not translated.\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",
+				"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\nA rule carries `step` and `tool_choice` and nothing else. An unknown field is a `400` naming it, because a rule the runtime does not recognize is dropped rather than corrected — the agent would keep running with the rule silently not applied.\n",
 				"required": false,
 				"type": "array",
 				"in": "body"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.61.0",
+  "version": "0.62.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.61.0"
+    "@naturali/sdk": "0.62.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",