hanzoai 8.5.649 → 8.5.654

package/dist/api/ai-api.d.ts

@@ -28,11 +28,13 @@ import type { AiModelList } from '../models';
 import type { AiModels } from '../models';
 import type { AiRanking } from '../models';
 import type { AiResponse } from '../models';
-import type { AiResponsesResource } from '../models';
 import type { AiRoutingEdit } from '../models';
 import type { AiRoutingRewardRequest } from '../models';
 import type { AiTokenCount } from '../models';
 import type { AiVideoStatus } from '../models';
+import type { CorrectIn } from '../models';
+import type { Correction } from '../models';
+import type { Corrections } from '../models';
 import type { DocSearchResult } from '../models';
 import type { Envelope } from '../models';
 import type { GetAiActivities200Response } from '../models';
@@ -113,7 +115,9 @@ import type { PostAiTreeFiles200Response } from '../models';
 import type { PostAiVectors200Response } from '../models';
 import type { PostAiVideos200Response } from '../models';
 import type { PostAiWorkflows200Response } from '../models';
+import type { PostChat200Response } from '../models';
 import type { PostModelsByModelAccess200Response } from '../models';
+import type { PostResponses200Response } from '../models';
 import type { PutAiRouterCatalog200Response } from '../models';
 /**
  * AiApi - axios parameter creator
@@ -171,6 +175,32 @@ export declare const AiApiAxiosParamCreator: (configuration?: Configuration) =>
      * @throws {RequiredError}
      */
     aiSetLimits: (aiLimitsSet: AiLimitsSet, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+     * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+     * @param {string} decision Decision is the decision\&#39;s id.
+     * @param {CorrectIn} correctIn
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrect: (decision: string, correctIn: CorrectIn, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @param {string} decision
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrections: (decision: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+     * @summary Deletes one correction of one of the org\'s decisions.
+     * @param {string} decision
+     * @param {string} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsUncorrect: (decision: string, id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Delete one article.
      * @summary Delete a article
@@ -2695,6 +2725,32 @@ export declare const AiApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     aiSetLimits(aiLimitsSet: AiLimitsSet, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AiLimits>>;
+    /**
+     * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+     * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+     * @param {string} decision Decision is the decision\&#39;s id.
+     * @param {CorrectIn} correctIn
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrect(decision: string, correctIn: CorrectIn, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Correction>>;
+    /**
+     * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @param {string} decision
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrections(decision: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Corrections>>;
+    /**
+     * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+     * @summary Deletes one correction of one of the org\'s decisions.
+     * @param {string} decision
+     * @param {string} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsUncorrect(decision: string, id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      * Delete one article.
      * @summary Delete a article
@@ -4761,7 +4817,7 @@ export declare const AiApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postChat(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<OpenaiChatCompletionResponse>>;
+    postChat(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostChat200Response>>;
     /**
      * Implements the OpenAI-compatible chat completions API
      * @summary Implements the OpenAI-compatible chat completions API
@@ -4771,7 +4827,7 @@ export declare const AiApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postChatCompletions(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<OpenaiChatCompletionResponse>>;
+    postChatCompletions(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostChat200Response>>;
     /**
      * Serves one completion to a caller with no account.
      * @summary Serves one completion to a caller with no account.
@@ -4789,7 +4845,7 @@ export declare const AiApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postCompletions(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<OpenaiChatCompletionResponse>>;
+    postCompletions(openaiChatCompletionRequest: OpenaiChatCompletionRequest, xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostChat200Response>>;
     /**
      * Implements POST /v1/decisions (the Decisions API).  Body: {\"model\": \"kai\", \"state\": \"...\"|{...}|[...], \"questions\": {\"<name>\": {\"type\": \"choice\"|\"noul\"|\"score\", \"instructions\": ..., \"criteria\": ...}}}. model is kai, Kai\'s versioned id kai-<12 hex of the weights\' sha256> — priced as kai and sent as asked — or Jev by OpenRouter\'s vendor ids, typesafe/jev-1.13 and ~typesafe/jev-latest, which reach Jev itself and bill at Jev\'s list price. No Jev id is ever answered by Kai: a bare one, such as jev-latest, is an unknown model. model is required; state and questions are required unless the request names a handle, which carries neither. instructions is optional and any JSON. A choice names at least 2 labels and a score at least 1 level, bounded by the token budget rather than a count; questions holds 1 to 100.  observe holds the state under an id, and a later request naming that id as its handle decides over it again. An id is 1 to 128 characters of A-Z, a-z, 0-9, \'.\', \'_\' and \'-\'. A handle belongs to the org that observed it: no other org\'s request can name it.  Response: {\"id\",\"model\",\"provider\",\"answers\":{\"<name>\":{\"type\",...}}, \"usage\":{\"input_tokens\",\"output_tokens\"},\"routing\",\"state_hash\",\"latency_ms\"}. usage.input_tokens is the billed count — the request\'s text counted once, the state once and each question\'s instructions and options once; a decision over a handle bills the state once, when it was observed.  The body may be sent gzip, deflate, br or zstd encoded; decoded, it is bounded as sent.  Refusals are {\"error\":{\"code\",\"message\"}}: 400 malformed JSON or unknown model, 401 no valid credential, 402 insufficient balance, 403 a key kind that may not call this (pk-), 415 any other Content-Encoding, 422 an invalid question or handle id, a state beyond the checkpoint\'s reach (code state_too_long) or a body past 16 MiB (code request_too_long), 429 rate limited or queue full, 502 the service failed, 503 the model is known and not served, 529 overloaded. 402, 429 and 529 carry Retry-After and Retry-After-Ms, and every answer carries X-Request-Id. Billed on the answer\'s input tokens at the model\'s price.
      * @summary Implements POST /v1/decisions (the Decisions API).
@@ -4851,7 +4907,7 @@ export declare const AiApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postResponses(xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AiResponsesResource>>;
+    postResponses(xMaxCost?: number, xMaxLatencyMs?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostResponses200Response>>;
     /**
      * Implements POST /v1/videos/generations — the ASYNC create.  Body: {\"model\": \"...\", \"prompt\": \"...\", \"size\"?: \"1280x720\", \"seconds\"?: int}  It authenticates the caller, resolves the model to its upstream provider via the shared routing table (zen3-video* / wan2-2-t2v-a14b → the spark-video backend), reserves the per-video budget (the balance gate), creates ONE upstream job, registers it in the in-pod store, and returns the OpenAI-shaped video object with status \"queued\" IMMEDIATELY. The client then polls GET /v1/videos/{id} and downloads GET /v1/videos/{id}/content. Nothing is billed here — the debit lands on completion.
      * @summary Implements POST /v1/videos/generations — the ASYNC create.
@@ -5215,6 +5271,30 @@ export declare const AiApiFactory: (configuration?: Configuration, basePath?: st
      * @throws {RequiredError}
      */
     aiSetLimits(requestParameters: AiApiAiSetLimitsRequest, options?: RawAxiosRequestConfig): AxiosPromise<AiLimits>;
+    /**
+     * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+     * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+     * @param {AiApiDecisionsCorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrect(requestParameters: AiApiDecisionsCorrectRequest, options?: RawAxiosRequestConfig): AxiosPromise<Correction>;
+    /**
+     * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @param {AiApiDecisionsCorrectionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsCorrections(requestParameters: AiApiDecisionsCorrectionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<Corrections>;
+    /**
+     * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+     * @summary Deletes one correction of one of the org\'s decisions.
+     * @param {AiApiDecisionsUncorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    decisionsUncorrect(requestParameters: AiApiDecisionsUncorrectRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
      * Delete one article.
      * @summary Delete a article
@@ -7166,7 +7246,7 @@ export declare const AiApiFactory: (configuration?: Configuration, basePath?: st
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postChat(requestParameters: AiApiPostChatRequest, options?: RawAxiosRequestConfig): AxiosPromise<OpenaiChatCompletionResponse>;
+    postChat(requestParameters: AiApiPostChatRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostChat200Response>;
     /**
      * Implements the OpenAI-compatible chat completions API
      * @summary Implements the OpenAI-compatible chat completions API
@@ -7174,7 +7254,7 @@ export declare const AiApiFactory: (configuration?: Configuration, basePath?: st
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postChatCompletions(requestParameters: AiApiPostChatCompletionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<OpenaiChatCompletionResponse>;
+    postChatCompletions(requestParameters: AiApiPostChatCompletionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostChat200Response>;
     /**
      * Serves one completion to a caller with no account.
      * @summary Serves one completion to a caller with no account.
@@ -7190,7 +7270,7 @@ export declare const AiApiFactory: (configuration?: Configuration, basePath?: st
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postCompletions(requestParameters: AiApiPostCompletionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<OpenaiChatCompletionResponse>;
+    postCompletions(requestParameters: AiApiPostCompletionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostChat200Response>;
     /**
      * Implements POST /v1/decisions (the Decisions API).  Body: {\"model\": \"kai\", \"state\": \"...\"|{...}|[...], \"questions\": {\"<name>\": {\"type\": \"choice\"|\"noul\"|\"score\", \"instructions\": ..., \"criteria\": ...}}}. model is kai, Kai\'s versioned id kai-<12 hex of the weights\' sha256> — priced as kai and sent as asked — or Jev by OpenRouter\'s vendor ids, typesafe/jev-1.13 and ~typesafe/jev-latest, which reach Jev itself and bill at Jev\'s list price. No Jev id is ever answered by Kai: a bare one, such as jev-latest, is an unknown model. model is required; state and questions are required unless the request names a handle, which carries neither. instructions is optional and any JSON. A choice names at least 2 labels and a score at least 1 level, bounded by the token budget rather than a count; questions holds 1 to 100.  observe holds the state under an id, and a later request naming that id as its handle decides over it again. An id is 1 to 128 characters of A-Z, a-z, 0-9, \'.\', \'_\' and \'-\'. A handle belongs to the org that observed it: no other org\'s request can name it.  Response: {\"id\",\"model\",\"provider\",\"answers\":{\"<name>\":{\"type\",...}}, \"usage\":{\"input_tokens\",\"output_tokens\"},\"routing\",\"state_hash\",\"latency_ms\"}. usage.input_tokens is the billed count — the request\'s text counted once, the state once and each question\'s instructions and options once; a decision over a handle bills the state once, when it was observed.  The body may be sent gzip, deflate, br or zstd encoded; decoded, it is bounded as sent.  Refusals are {\"error\":{\"code\",\"message\"}}: 400 malformed JSON or unknown model, 401 no valid credential, 402 insufficient balance, 403 a key kind that may not call this (pk-), 415 any other Content-Encoding, 422 an invalid question or handle id, a state beyond the checkpoint\'s reach (code state_too_long) or a body past 16 MiB (code request_too_long), 429 rate limited or queue full, 502 the service failed, 503 the model is known and not served, 529 overloaded. 402, 429 and 529 carry Retry-After and Retry-After-Ms, and every answer carries X-Request-Id. Billed on the answer\'s input tokens at the model\'s price.
      * @summary Implements POST /v1/decisions (the Decisions API).
@@ -7251,7 +7331,7 @@ export declare const AiApiFactory: (configuration?: Configuration, basePath?: st
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postResponses(requestParameters?: AiApiPostResponsesRequest, options?: RawAxiosRequestConfig): AxiosPromise<AiResponsesResource>;
+    postResponses(requestParameters?: AiApiPostResponsesRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostResponses200Response>;
     /**
      * Implements POST /v1/videos/generations — the ASYNC create.  Body: {\"model\": \"...\", \"prompt\": \"...\", \"size\"?: \"1280x720\", \"seconds\"?: int}  It authenticates the caller, resolves the model to its upstream provider via the shared routing table (zen3-video* / wan2-2-t2v-a14b → the spark-video backend), reserves the per-video budget (the balance gate), creates ONE upstream job, registers it in the in-pod store, and returns the OpenAI-shaped video object with status \"queued\" IMMEDIATELY. The client then polls GET /v1/videos/{id} and downloads GET /v1/videos/{id}/content. Nothing is billed here — the debit lands on completion.
      * @summary Implements POST /v1/videos/generations — the ASYNC create.
@@ -7606,6 +7686,57 @@ export interface AiApiAiSetLimitsRequest {
      */
     readonly aiLimitsSet: AiLimitsSet;
 }
+/**
+ * Request parameters for decisionsCorrect operation in AiApi.
+ * @export
+ * @interface AiApiDecisionsCorrectRequest
+ */
+export interface AiApiDecisionsCorrectRequest {
+    /**
+     * Decision is the decision\&#39;s id.
+     * @type {string}
+     * @memberof AiApiDecisionsCorrect
+     */
+    readonly decision: string;
+    /**
+     *
+     * @type {CorrectIn}
+     * @memberof AiApiDecisionsCorrect
+     */
+    readonly correctIn: CorrectIn;
+}
+/**
+ * Request parameters for decisionsCorrections operation in AiApi.
+ * @export
+ * @interface AiApiDecisionsCorrectionsRequest
+ */
+export interface AiApiDecisionsCorrectionsRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof AiApiDecisionsCorrections
+     */
+    readonly decision: string;
+}
+/**
+ * Request parameters for decisionsUncorrect operation in AiApi.
+ * @export
+ * @interface AiApiDecisionsUncorrectRequest
+ */
+export interface AiApiDecisionsUncorrectRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof AiApiDecisionsUncorrect
+     */
+    readonly decision: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AiApiDecisionsUncorrect
+     */
+    readonly id: string;
+}
 /**
  * Request parameters for deleteAiArticlesByOwnerByName operation in AiApi.
  * @export
@@ -10820,6 +10951,33 @@ export declare class AiApi extends BaseAPI {
      * @memberof AiApi
      */
     aiSetLimits(requestParameters: AiApiAiSetLimitsRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<AiLimits, any, {}>>;
+    /**
+     * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+     * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+     * @param {AiApiDecisionsCorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsCorrect(requestParameters: AiApiDecisionsCorrectRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<Correction, any, {}>>;
+    /**
+     * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @param {AiApiDecisionsCorrectionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsCorrections(requestParameters: AiApiDecisionsCorrectionsRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<Corrections, any, {}>>;
+    /**
+     * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+     * @summary Deletes one correction of one of the org\'s decisions.
+     * @param {AiApiDecisionsUncorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsUncorrect(requestParameters: AiApiDecisionsUncorrectRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<void, any, {}>>;
     /**
      * Delete one article.
      * @summary Delete a article
@@ -13127,7 +13285,7 @@ export declare class AiApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof AiApi
      */
-    postResponses(requestParameters?: AiApiPostResponsesRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<AiResponsesResource, any, {}>>;
+    postResponses(requestParameters?: AiApiPostResponsesRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<import("../models").AiResponsesResource, any, {}>>;
     /**
      * Implements POST /v1/videos/generations — the ASYNC create.  Body: {\"model\": \"...\", \"prompt\": \"...\", \"size\"?: \"1280x720\", \"seconds\"?: int}  It authenticates the caller, resolves the model to its upstream provider via the shared routing table (zen3-video* / wan2-2-t2v-a14b → the spark-video backend), reserves the per-video budget (the balance gate), creates ONE upstream job, registers it in the in-pod store, and returns the OpenAI-shaped video object with status \"queued\" IMMEDIATELY. The client then polls GET /v1/videos/{id} and downloads GET /v1/videos/{id}/content. Nothing is billed here — the debit lands on completion.
      * @summary Implements POST /v1/videos/generations — the ASYNC create.

package/dist/api/ai-api.js

@@ -236,6 +236,111 @@ const AiApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+         * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+         * @param {string} decision Decision is the decision\'s id.
+         * @param {CorrectIn} correctIn
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsCorrect: async (decision, correctIn, options = {}) => {
+            // verify required parameter 'decision' is not null or undefined
+            (0, common_1.assertParamExists)('decisionsCorrect', 'decision', decision);
+            // verify required parameter 'correctIn' is not null or undefined
+            (0, common_1.assertParamExists)('decisionsCorrect', 'correctIn', correctIn);
+            const localVarPath = `/v1/decisions/{decision}/corrections`
+                .replace(`{${"decision"}}`, encodeURIComponent(String(decision)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication bearer required
+            // http bearer authentication required
+            await (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(correctIn, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @param {string} decision
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsCorrections: async (decision, options = {}) => {
+            // verify required parameter 'decision' is not null or undefined
+            (0, common_1.assertParamExists)('decisionsCorrections', 'decision', decision);
+            const localVarPath = `/v1/decisions/{decision}/corrections`
+                .replace(`{${"decision"}}`, encodeURIComponent(String(decision)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication bearer required
+            // http bearer authentication required
+            await (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+         * @summary Deletes one correction of one of the org\'s decisions.
+         * @param {string} decision
+         * @param {string} id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsUncorrect: async (decision, id, options = {}) => {
+            // verify required parameter 'decision' is not null or undefined
+            (0, common_1.assertParamExists)('decisionsUncorrect', 'decision', decision);
+            // verify required parameter 'id' is not null or undefined
+            (0, common_1.assertParamExists)('decisionsUncorrect', 'id', id);
+            const localVarPath = `/v1/decisions/{decision}/corrections/{id}`
+                .replace(`{${"decision"}}`, encodeURIComponent(String(decision)))
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'DELETE', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication bearer required
+            // http bearer authentication required
+            await (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Delete one article.
          * @summary Delete a article
@@ -10316,6 +10421,47 @@ const AiApiFp = function (configuration) {
             const localVarOperationServerBasePath = base_1.operationServerMap['AiApi.aiSetLimits']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+         * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+         * @param {string} decision Decision is the decision\'s id.
+         * @param {CorrectIn} correctIn
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async decisionsCorrect(decision, correctIn, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.decisionsCorrect(decision, correctIn, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['AiApi.decisionsCorrect']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @param {string} decision
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async decisionsCorrections(decision, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.decisionsCorrections(decision, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['AiApi.decisionsCorrections']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+         * @summary Deletes one correction of one of the org\'s decisions.
+         * @param {string} decision
+         * @param {string} id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async decisionsUncorrect(decision, id, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.decisionsUncorrect(decision, id, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['AiApi.decisionsUncorrect']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Delete one article.
          * @summary Delete a article
@@ -14377,6 +14523,36 @@ const AiApiFactory = function (configuration, basePath, axios) {
         aiSetLimits(requestParameters, options) {
             return localVarFp.aiSetLimits(requestParameters.aiLimitsSet, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+         * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+         * @param {AiApiDecisionsCorrectRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsCorrect(requestParameters, options) {
+            return localVarFp.decisionsCorrect(requestParameters.decision, requestParameters.correctIn, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+         * @param {AiApiDecisionsCorrectionsRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsCorrections(requestParameters, options) {
+            return localVarFp.decisionsCorrections(requestParameters.decision, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+         * @summary Deletes one correction of one of the org\'s decisions.
+         * @param {AiApiDecisionsUncorrectRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        decisionsUncorrect(requestParameters, options) {
+            return localVarFp.decisionsUncorrect(requestParameters.decision, requestParameters.id, options).then((request) => request(axios, basePath));
+        },
         /**
          * Delete one article.
          * @summary Delete a article
@@ -17363,6 +17539,39 @@ class AiApi extends base_1.BaseAPI {
     aiSetLimits(requestParameters, options) {
         return (0, exports.AiApiFp)(this.configuration).aiSetLimits(requestParameters.aiLimitsSet, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why. A decision Kai captured can teach a capability of its question (/v1/capabilities); one made with capture off is kept with state missing and cannot. The org\'s first correction turns capture on, so its next decisions can teach. Refused: 409 not_wrong when the answer is Kai\'s own, 409 corrected when the question already has a correction, 404 when the decision captured no such question.
+     * @summary Files a correction of one question of one of the org\'s Kai decisions: the right answer, which must be one of that question\'s options and not what Kai answered, and why.
+     * @param {AiApiDecisionsCorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsCorrect(requestParameters, options) {
+        return (0, exports.AiApiFp)(this.configuration).decisionsCorrect(requestParameters.decision, requestParameters.correctIn, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @summary Answers one of the org\'s decisions\' corrections, each captured (it can teach) or missing (the decision was made with capture off).
+     * @param {AiApiDecisionsCorrectionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsCorrections(requestParameters, options) {
+        return (0, exports.AiApiFp)(this.configuration).decisionsCorrections(requestParameters.decision, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Deletes one correction of one of the org\'s decisions. A capability already taught from it keeps its versions.
+     * @summary Deletes one correction of one of the org\'s decisions.
+     * @param {AiApiDecisionsUncorrectRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AiApi
+     */
+    decisionsUncorrect(requestParameters, options) {
+        return (0, exports.AiApiFp)(this.configuration).decisionsUncorrect(requestParameters.decision, requestParameters.id, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Delete one article.
      * @summary Delete a article

package/dist/api/billing-api.d.ts

@@ -275,7 +275,7 @@ export declare const BillingApiAxiosParamCreator: (configuration?: Configuration
      */
     getBillingTransactionsById: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
+     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  Each row carries `name`: what its metered unit (`metadata.model`) reads as on a bill — `Desktop sandbox` for `desktop/visor`, `Agent sessions` for `session`. An AI model is its own name. Show `name`; `metadata.model` stays the unit the ledger keys on.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
      * @summary Every billed call the caller\'s org made, attributed to a product
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -664,7 +664,7 @@ export declare const BillingApiFp: (configuration?: Configuration) => {
      */
     getBillingTransactionsById(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BillingTransaction>>;
     /**
-     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
+     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  Each row carries `name`: what its metered unit (`metadata.model`) reads as on a bill — `Desktop sandbox` for `desktop/visor`, `Agent sessions` for `session`. An AI model is its own name. Show `name`; `metadata.model` stays the unit the ledger keys on.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
      * @summary Every billed call the caller\'s org made, attributed to a product
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1043,7 +1043,7 @@ export declare const BillingApiFactory: (configuration?: Configuration, basePath
      */
     getBillingTransactionsById(requestParameters: BillingApiGetBillingTransactionsByIdRequest, options?: RawAxiosRequestConfig): AxiosPromise<BillingTransaction>;
     /**
-     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
+     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  Each row carries `name`: what its metered unit (`metadata.model`) reads as on a bill — `Desktop sandbox` for `desktop/visor`, `Agent sessions` for `session`. An AI model is its own name. Show `name`; `metadata.model` stays the unit the ledger keys on.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
      * @summary Every billed call the caller\'s org made, attributed to a product
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1870,7 +1870,7 @@ export declare class BillingApi extends BaseAPI {
      */
     getBillingTransactionsById(requestParameters: BillingApiGetBillingTransactionsByIdRequest, options?: RawAxiosRequestConfig): Promise<globalAxios.AxiosResponse<BillingTransaction, any, {}>>;
     /**
-     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
+     * Answers one row per BILLED call against the caller\'s org — transaction id, amount, timestamp and the metered unit. This is the raw charged ledger, not a rollup.  Each row is stamped with a canonical `metadata.product` derived from what the meter persisted: `agent` becomes agents, `provisioning` becomes the provisioned kind, a token-metered row becomes inference, anything else keeps its metering surface. The ledger has no product field of its own, so this read is where that dimension is made real — from the SAME charged rows, never a second meter. A row that already carries its own product WINS, so the derivation stops the day the meter records one.  Each row carries `name`: what its metered unit (`metadata.model`) reads as on a bill — `Desktop sandbox` for `desktop/visor`, `Agent sessions` for `session`. An AI model is its own name. Show `name`; `metadata.model` stays the unit the ledger keys on.  `product=<id>` filters to one product server-side. `groupBy=product` reduces to `{product,requests,amountCents}` rollups instead of rows.  `amount` is whole USD cents, ROUNDED; `decimal` beside it is the SAME debit exact, as an 18-decimal USD string. Sum `decimal`. A page of sub-cent token calls totals correctly there and totals ZERO in `amount` — that difference is real money.  Scoped to the caller\'s own org\'s books, where the org\'s ledger file IS the tenant boundary; no client-supplied subject is ever forwarded. 401 without a validated principal. The co-resident read returns the 2000 most recent debits, newest first; `start` and `end` narrow the window only on the split-deploy upstream.
      * @summary Every billed call the caller\'s org made, attributed to a product
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}