@naturali/cli 0.56.5 → 0.58.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.56.5";
+var version = "0.58.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) };
@@ -1858,6 +1858,8 @@ var Projects = class {
 	*
 	* 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.
 	*
+	* Every bucket also carries components — the amounts actually measured. The token counts describe LLM usage alone, so that is where a storage, api_request or compute_execution bucket reports its real quantity instead of zeroed token fields.
+	*
 	*/
 	static getProjectUsage(options) {
 		return (options.client ?? client).get({
@@ -6080,6 +6082,13 @@ const routes = {
 				"type": "object",
 				"in": "body"
 			},
+			{
+				"name": "tool_context",
+				"description": "Write-only. Per-run context forwarded to the run's tool calls: every entry is sent as an `X-Naturali-Context-<key>` request header on each `http`/`mcp` tool call the run's agent nodes make, including those of a `loop` or `sub_orchestration` child run. This is how a per-user credential reaches a tool endpoint without being written into the prompt — the endpoint reads it from a header it can trust rather than from model output.\n\nThe bag is stored on the run, so it survives an `awaiting_input` pause, a durable wait and a restart. It is never returned on a read: any principal on the project can read the project's runs.\n\nA key becomes an HTTP header name verbatim — no character is re-cased, so `ocaToken` and `oca_token` are two different keys — and must contain only letters, digits and `!#$%&'*+-.^_`|~`; two keys that differ only in case are rejected, since HTTP folds them into one. To land a value in a header the target already expects (usually `Authorization`), have the tool declare it with a `{{context:<key>}}` reference in its own `headers`, and set the tool's `context_keys` so the value reaches that tool alone.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
 			{
 				"name": "wait",
 				"description": "When true, block until the run reaches a terminal or `awaiting_input` state and return the settled run. When false (default), return immediately with `status: \"queued\"`.",
@@ -6319,12 +6328,13 @@ 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 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.",
+		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. Every bucket also carries components — the amounts actually measured. The token counts describe LLM usage alone, so that is where a storage, api_request or compute_execution bucket reports its real quantity instead of zeroed token fields.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
 			"group_by",
+			"meter_type",
 			"from",
 			"to"
 		],
@@ -6343,6 +6353,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "meter_type",
+				"description": "Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage). Omit to include every meter. Useful with group_by=model, whose dimension otherwise mixes model ids with platform SKUs. An unrecognized value yields an empty rollup, not an error.\n",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "from",
 				"description": "Inclusive lower bound (ISO-8601) on event time. Omit for no lower bound.",
@@ -7220,6 +7237,13 @@ const routes = {
 				"required": false,
 				"type": "array",
 				"in": "body"
+			},
+			{
+				"name": "context_keys",
+				"description": "Allowlist of `tool_context` keys forwarded to this tool as `X-Naturali-Context-<key>` headers. Omit (or `null`) to forward every key the caller supplied; `[]` forwards none. Set it on the tools that need a given credential and the credential stops egressing to the rest of the agent's tool set — a key a tool consumes through a `{{context:<key>}}` reference in its own `headers` is substituted either way, since the tool declared that header itself.",
+				"required": false,
+				"type": "array",
+				"in": "body"
 			}
 		]
 	},
@@ -7331,6 +7355,13 @@ const routes = {
 				"type": "array",
 				"in": "body"
 			},
+			{
+				"name": "context_keys",
+				"description": "Replace the allowlist of `tool_context` keys forwarded to this tool. `null` clears it (every key is forwarded again) — unlike omitting the field, which leaves the current allowlist alone.",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
 			{
 				"name": "status",
 				"description": "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.56.5",
+  "version": "0.58.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.56.5"
+    "@naturali/sdk": "0.58.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",