@naturali/sdk 0.144.1 → 0.146.0

package/dist/index.cjs

@@ -3079,7 +3079,7 @@ var Guardrails = class {
 	/**
 	* Dry-run evaluate a guardrail
 	*
-	* Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tool.*`.
+	* Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tools.*`.
 	*
 	*/
 	static evaluateGuardrail(options) {

package/dist/index.d.cts

@@ -4180,7 +4180,7 @@ type QuotaResourceProperties = {
   /**
    * Only for metric cost_usd. The meter this cap answers for; omit it and the cap sums every priced meter. See the quotas REST contract.
    */
-  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage';
+  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution';
 };
 /**
  * Creates a guardrail — an action-class document (`class`/`guard`) that gates tool-call autonomy. Attach it to a tool or agent via that resource's `guardrail_ids` (a `{ "ref": … }` to this resource in the same template resolves to its physical id at deploy time). Mirrors the guardrails REST contract; `class`/`default_class`/`guard`/`escalate` are flattened here from the REST API's single `document` object.
@@ -6388,7 +6388,7 @@ type ProjectUsageEvent = {
    */
   action_id?: string | null;
   /**
-   * llm_tokens, compute_execution, api_request or storage.
+   * llm_tokens, compute_execution, api_request, storage or tool_execution.
    */
   meter_type: string;
   /**
@@ -6633,7 +6633,7 @@ type Quota = {
   /**
    * The meter a cost_usd cap answers for. Null is every priced meter, which is what a quota created without one carries.
    */
-  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | null;
+  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution' | null;
   /**
    * Pricing posture of a cost_usd quota over an unpriced blackout — block refuses generations, allow lets them through (the quota_unpriced exception is filed either way, and for a partly priced window, which no posture refuses). Null for metrics with no pricing dependency.
    */
@@ -7496,7 +7496,7 @@ type UserBilling = {
    */
   retention_days: number | null;
   /**
-   * Model credit left, in US dollars — granted and purchased credit plus the plan's monthly allowance, less managed-model spend. A managed generation is refused while this is negative; a zero balance still generates, and the generation that crosses zero is absorbed. Only as current as `spend_reconciled_at`, so read the two together.
+   * Model credit left, in US dollars — granted and purchased credit plus the plan's monthly allowance, less managed-model and embedding spend. Managed generations and writes that embed are refused while this is negative; zero is not. Only as current as `spend_reconciled_at`, so read the two together.
    */
   credit_balance_usd: number;
   /**
@@ -8008,7 +8008,7 @@ type OrchestrationId = string;
  */
 type OrchestrationRunId = string;
 /**
- * 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.
+ * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
  *
  */
 type UsageMeterType = string;
@@ -15830,7 +15830,7 @@ type EvaluateGuardrailData = {
       [key: string]: unknown;
     };
     /**
-     * Optional tool to resolve `runtime.tool.*` against.
+     * Optional tool to resolve `runtime.tools.*` against.
      */
     tool_id?: string;
   };
@@ -19109,7 +19109,7 @@ type GetProjectUsageData = {
      */
     group_by?: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type' | 'actor' | 'session' | 'source';
     /**
-     * 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.
+     * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
      *
      */
     meter_type?: string;
@@ -19219,7 +19219,7 @@ type ListProjectUsageEventsData = {
   };
   query?: {
     /**
-     * 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.
+     * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
      *
      */
     meter_type?: string;
@@ -19542,7 +19542,7 @@ type CreateQuotaData = {
     /**
      * Only for metric cost_usd (400 on any other metric). The meter this cap answers for. Omit it and the cap sums every priced meter, which is the existing behaviour; name one and only that meter's cost counts, so an AI spend cap is not consumed by platform meters the operator prices (and vice versa). Part of the quota's identity, so two meter scopes can share a scope/metric/window and neither conflicts with an unscoped cap. Immutable after creation — replace the quota to change it.
      */
-    meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage';
+    meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution';
   };
   path: {
     /**
@@ -23679,7 +23679,7 @@ export declare class Guardrails {
   /**
    * Dry-run evaluate a guardrail
    *
-   * Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tool.*`.
+   * Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tools.*`.
    *
    */
   static evaluateGuardrail<ThrowOnError extends boolean = false>(options: Options<EvaluateGuardrailData, ThrowOnError>): RequestResult<EvaluateGuardrailResponses, EvaluateGuardrailErrors, ThrowOnError>;

package/dist/index.d.mts

@@ -4180,7 +4180,7 @@ type QuotaResourceProperties = {
   /**
    * Only for metric cost_usd. The meter this cap answers for; omit it and the cap sums every priced meter. See the quotas REST contract.
    */
-  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage';
+  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution';
 };
 /**
  * Creates a guardrail — an action-class document (`class`/`guard`) that gates tool-call autonomy. Attach it to a tool or agent via that resource's `guardrail_ids` (a `{ "ref": … }` to this resource in the same template resolves to its physical id at deploy time). Mirrors the guardrails REST contract; `class`/`default_class`/`guard`/`escalate` are flattened here from the REST API's single `document` object.
@@ -6388,7 +6388,7 @@ type ProjectUsageEvent = {
    */
   action_id?: string | null;
   /**
-   * llm_tokens, compute_execution, api_request or storage.
+   * llm_tokens, compute_execution, api_request, storage or tool_execution.
    */
   meter_type: string;
   /**
@@ -6633,7 +6633,7 @@ type Quota = {
   /**
    * The meter a cost_usd cap answers for. Null is every priced meter, which is what a quota created without one carries.
    */
-  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | null;
+  meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution' | null;
   /**
    * Pricing posture of a cost_usd quota over an unpriced blackout — block refuses generations, allow lets them through (the quota_unpriced exception is filed either way, and for a partly priced window, which no posture refuses). Null for metrics with no pricing dependency.
    */
@@ -7496,7 +7496,7 @@ type UserBilling = {
    */
   retention_days: number | null;
   /**
-   * Model credit left, in US dollars — granted and purchased credit plus the plan's monthly allowance, less managed-model spend. A managed generation is refused while this is negative; a zero balance still generates, and the generation that crosses zero is absorbed. Only as current as `spend_reconciled_at`, so read the two together.
+   * Model credit left, in US dollars — granted and purchased credit plus the plan's monthly allowance, less managed-model and embedding spend. Managed generations and writes that embed are refused while this is negative; zero is not. Only as current as `spend_reconciled_at`, so read the two together.
    */
   credit_balance_usd: number;
   /**
@@ -8008,7 +8008,7 @@ type OrchestrationId = string;
  */
 type OrchestrationRunId = string;
 /**
- * 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.
+ * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
  *
  */
 type UsageMeterType = string;
@@ -15830,7 +15830,7 @@ type EvaluateGuardrailData = {
       [key: string]: unknown;
     };
     /**
-     * Optional tool to resolve `runtime.tool.*` against.
+     * Optional tool to resolve `runtime.tools.*` against.
      */
     tool_id?: string;
   };
@@ -19109,7 +19109,7 @@ type GetProjectUsageData = {
      */
     group_by?: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type' | 'actor' | 'session' | 'source';
     /**
-     * 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.
+     * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
      *
      */
     meter_type?: string;
@@ -19219,7 +19219,7 @@ type ListProjectUsageEventsData = {
   };
   query?: {
     /**
-     * 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.
+     * Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage, tool_execution). 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.
      *
      */
     meter_type?: string;
@@ -19542,7 +19542,7 @@ type CreateQuotaData = {
     /**
      * Only for metric cost_usd (400 on any other metric). The meter this cap answers for. Omit it and the cap sums every priced meter, which is the existing behaviour; name one and only that meter's cost counts, so an AI spend cap is not consumed by platform meters the operator prices (and vice versa). Part of the quota's identity, so two meter scopes can share a scope/metric/window and neither conflicts with an unscoped cap. Immutable after creation — replace the quota to change it.
      */
-    meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage';
+    meter_type?: 'llm_tokens' | 'compute_execution' | 'api_request' | 'storage' | 'tool_execution';
   };
   path: {
     /**
@@ -23679,7 +23679,7 @@ export declare class Guardrails {
   /**
    * Dry-run evaluate a guardrail
    *
-   * Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tool.*`.
+   * Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tools.*`.
    *
    */
   static evaluateGuardrail<ThrowOnError extends boolean = false>(options: Options<EvaluateGuardrailData, ThrowOnError>): RequestResult<EvaluateGuardrailResponses, EvaluateGuardrailErrors, ThrowOnError>;

package/dist/index.mjs

@@ -3078,7 +3078,7 @@ var Guardrails = class {
 	/**
 	* Dry-run evaluate a guardrail
 	*
-	* Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tool.*`.
+	* Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tools.*`.
 	*
 	*/
 	static evaluateGuardrail(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.144.1",
+  "version": "0.146.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.144.1",
+    "@naturali/api": "0.146.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",