@naturali/sdk 0.77.2 → 0.78.1

package/dist/index.cjs

@@ -2965,7 +2965,7 @@ var Models = class {
 	/**
 	* Enable naturali models
 	*
-	* Provisions the project's managed provider — the one provider through which every model the catalog marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project, not per model, and calling it again returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
+	* Provisions the project's managed provider for one catalog source (`bedrock` by default) — the provider through which every model that source marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project per source, not per model, and calling it again for the same source returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
 	*
 	*/
 	static enableManagedModels(options) {

package/dist/index.d.cts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;
@@ -12972,7 +12974,13 @@ type GetModelResponse = GetModelResponses[keyof GetModelResponses];
 type EnableManagedModelsData = {
   body?: {
     /**
-     * Provider configuration name. Defaults to `naturali`.
+     * Which catalog source to enable. A managed provider serves the models of one source, so a project that wants both enables both — each call returns its own provider, and each is priced only for the models it can actually serve.
+     *
+     */
+    provider?: 'bedrock' | 'vertex';
+    /**
+     * Provider configuration name. Defaults to `naturali` for `bedrock` and `naturali-<provider>` for every other source, so a project that enables more than one keeps them apart.
+     *
      */
     name?: string;
     /**
@@ -17876,7 +17884,7 @@ declare class Models {
   /**
    * Enable naturali models
    *
-   * Provisions the project's managed provider — the one provider through which every model the catalog marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project, not per model, and calling it again returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
+   * Provisions the project's managed provider for one catalog source (`bedrock` by default) — the provider through which every model that source marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project per source, not per model, and calling it again for the same source returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
    *
    */
   static enableManagedModels<ThrowOnError extends boolean = false>(options: Options<EnableManagedModelsData, ThrowOnError>): RequestResult<EnableManagedModelsResponses, EnableManagedModelsErrors, ThrowOnError>;

package/dist/index.d.mts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;
@@ -12972,7 +12974,13 @@ type GetModelResponse = GetModelResponses[keyof GetModelResponses];
 type EnableManagedModelsData = {
   body?: {
     /**
-     * Provider configuration name. Defaults to `naturali`.
+     * Which catalog source to enable. A managed provider serves the models of one source, so a project that wants both enables both — each call returns its own provider, and each is priced only for the models it can actually serve.
+     *
+     */
+    provider?: 'bedrock' | 'vertex';
+    /**
+     * Provider configuration name. Defaults to `naturali` for `bedrock` and `naturali-<provider>` for every other source, so a project that enables more than one keeps them apart.
+     *
      */
     name?: string;
     /**
@@ -17876,7 +17884,7 @@ declare class Models {
   /**
    * Enable naturali models
    *
-   * Provisions the project's managed provider — the one provider through which every model the catalog marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project, not per model, and calling it again returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
+   * Provisions the project's managed provider for one catalog source (`bedrock` by default) — the provider through which every model that source marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project per source, not per model, and calling it again for the same source returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
    *
    */
   static enableManagedModels<ThrowOnError extends boolean = false>(options: Options<EnableManagedModelsData, ThrowOnError>): RequestResult<EnableManagedModelsResponses, EnableManagedModelsErrors, ThrowOnError>;

package/dist/index.mjs

@@ -2964,7 +2964,7 @@ var Models = class {
 	/**
 	* Enable naturali models
 	*
-	* Provisions the project's managed provider — the one provider through which every model the catalog marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project, not per model, and calling it again returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
+	* Provisions the project's managed provider for one catalog source (`bedrock` by default) — the provider through which every model that source marks `managed: true` is available. It needs no credentials of yours (it runs on naturali's own model access) and is priced from the catalog for all managed models the moment it is created, so any of them is usable from an agent's `model` field — set it to the catalog's `provider_model` — and metered from the first generation. Models that join the catalog later are priced onto the provider automatically by the daily sync; enabling is a one-time act per project per source, not per model, and calling it again for the same source returns the existing provider as a `200` instead of creating a duplicate. The created resource is an ordinary provider: read, update and delete it through [`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}`](/docs/api/ai-providers/get-ai-provider) like any other. Requires the `admin` role in the project.
 	*
 	*/
 	static enableManagedModels(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.77.2",
+  "version": "0.78.1",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.77.2"
+    "@naturali/api": "0.78.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",