@meetkai/mka1 0.48.32 → 0.48.33

package/src/sdk/sdk.ts

@@ -8,12 +8,14 @@ import { Agents } from "./agents.js";
 import { AgentSchedules } from "./agentschedules.js";
 import { AgentVersions } from "./agentversions.js";
 import { Auth } from "./auth.js";
+import { Budgets } from "./budgets.js";
 import { Guardrails } from "./guardrails.js";
 import { Llm } from "./llm.js";
 import { Permissions } from "./permissions.js";
 import { Sandbox } from "./sandbox.js";
 import { SandboxUsage } from "./sandboxusage.js";
 import { Search } from "./search.js";
+import { Usage } from "./usage.js";
 
 export class SDK extends ClientSDK {
   private _permissions?: Permissions;
@@ -70,4 +72,14 @@ export class SDK extends ClientSDK {
   get agentRuns(): AgentRuns {
     return (this._agentRuns ??= new AgentRuns(this._options));
   }
+
+  private _budgets?: Budgets;
+  get budgets(): Budgets {
+    return (this._budgets ??= new Budgets(this._options));
+  }
+
+  private _usage?: Usage;
+  get usage(): Usage {
+    return (this._usage ??= new Usage(this._options));
+  }
 }

package/src/sdk/sdkusage.ts

@@ -0,0 +1,172 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmUsageClassify } from "../funcs/llmUsageClassify.js";
+import { llmUsageCompletions } from "../funcs/llmUsageCompletions.js";
+import { llmUsageConversations } from "../funcs/llmUsageConversations.js";
+import { llmUsageCosts } from "../funcs/llmUsageCosts.js";
+import { llmUsageEmbeddings } from "../funcs/llmUsageEmbeddings.js";
+import { llmUsageExtract } from "../funcs/llmUsageExtract.js";
+import { llmUsageFiles } from "../funcs/llmUsageFiles.js";
+import { llmUsageResponses } from "../funcs/llmUsageResponses.js";
+import { llmUsageVectorStores } from "../funcs/llmUsageVectorStores.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class SDKUsage extends ClientSDK {
+  /**
+   * Get completions usage
+   *
+   * @remarks
+   * Retrieve usage metrics for chat completions, aggregated from the ChatCompletion table.
+   */
+  async completions(
+    request: operations.GetCompletionsUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetCompletionsUsageResponseBody> {
+    return unwrapAsync(llmUsageCompletions(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get responses usage
+   *
+   * @remarks
+   * Retrieve usage metrics for agent responses, aggregated from the Response table.
+   */
+  async responses(
+    request: operations.GetResponsesUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetResponsesUsageResponseBody> {
+    return unwrapAsync(llmUsageResponses(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get conversations usage
+   *
+   * @remarks
+   * Retrieve usage metrics for conversation operations.
+   */
+  async conversations(
+    request: operations.GetConversationsUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetConversationsUsageResponseBody> {
+    return unwrapAsync(llmUsageConversations(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get embeddings usage
+   *
+   * @remarks
+   * Retrieve usage metrics for embedding operations.
+   */
+  async embeddings(
+    request: operations.GetEmbeddingsUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetEmbeddingsUsageResponseBody> {
+    return unwrapAsync(llmUsageEmbeddings(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get extract usage
+   *
+   * @remarks
+   * Retrieve usage metrics for extract operations.
+   */
+  async extract(
+    request: operations.GetExtractUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetExtractUsageResponseBody> {
+    return unwrapAsync(llmUsageExtract(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get classify usage
+   *
+   * @remarks
+   * Retrieve usage metrics for classify operations.
+   */
+  async classify(
+    request: operations.GetClassifyUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetClassifyUsageResponseBody> {
+    return unwrapAsync(llmUsageClassify(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get vector stores usage
+   *
+   * @remarks
+   * Retrieve usage metrics for vector storage operations.
+   */
+  async vectorStores(
+    request: operations.GetVectorStoresUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetVectorStoresUsageResponseBody> {
+    return unwrapAsync(llmUsageVectorStores(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get files usage
+   *
+   * @remarks
+   * Retrieve bytes of files created per period from durable file creation events. This does not reflect current retained storage, buckets remain counted after file deletion, and grouped results collapse by requested output dimensions rather than one row per UserContext.
+   */
+  async files(
+    request: operations.GetFilesUsageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetFilesUsageResponseBody> {
+    return unwrapAsync(llmUsageFiles(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get cost by model
+   *
+   * @remarks
+   * Aggregates spend by model over a time range, priced in the cluster currency from the model price book. Org-scoped: org admins see their org; cluster admins may pass `org_id`. Includes billable work with no usage row of its own (store=false responses, agent tool calls), so totals cover all LLM spend. Platform-wide, cross-service cost reporting lives in the budgeting API (/api/v1/budgeting/usage/costs).
+   */
+  async costs(
+    request: operations.GetCostsUsageRequest,
+    options?: RequestOptions,
+  ): Promise<components.UsageCostsResponse> {
+    return unwrapAsync(llmUsageCosts(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/usage.ts

@@ -2,168 +2,23 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { llmUsageClassify } from "../funcs/llmUsageClassify.js";
-import { llmUsageCompletions } from "../funcs/llmUsageCompletions.js";
-import { llmUsageConversations } from "../funcs/llmUsageConversations.js";
-import { llmUsageCosts } from "../funcs/llmUsageCosts.js";
-import { llmUsageEmbeddings } from "../funcs/llmUsageEmbeddings.js";
-import { llmUsageExtract } from "../funcs/llmUsageExtract.js";
-import { llmUsageFiles } from "../funcs/llmUsageFiles.js";
-import { llmUsageResponses } from "../funcs/llmUsageResponses.js";
-import { llmUsageVectorStores } from "../funcs/llmUsageVectorStores.js";
+import { usageCosts } from "../funcs/usageCosts.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Usage extends ClientSDK {
   /**
-   * Get completions usage
+   * Aggregate cost by dimension
    *
    * @remarks
-   * Retrieve usage metrics for chat completions, aggregated from the ChatCompletion table.
-   */
-  async completions(
-    request: operations.GetCompletionsUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetCompletionsUsageResponseBody> {
-    return unwrapAsync(llmUsageCompletions(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get responses usage
-   *
-   * @remarks
-   * Retrieve usage metrics for agent responses, aggregated from the Response table.
-   */
-  async responses(
-    request: operations.GetResponsesUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetResponsesUsageResponseBody> {
-    return unwrapAsync(llmUsageResponses(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get conversations usage
-   *
-   * @remarks
-   * Retrieve usage metrics for conversation operations.
-   */
-  async conversations(
-    request: operations.GetConversationsUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetConversationsUsageResponseBody> {
-    return unwrapAsync(llmUsageConversations(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get embeddings usage
-   *
-   * @remarks
-   * Retrieve usage metrics for embedding operations.
-   */
-  async embeddings(
-    request: operations.GetEmbeddingsUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetEmbeddingsUsageResponseBody> {
-    return unwrapAsync(llmUsageEmbeddings(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get extract usage
-   *
-   * @remarks
-   * Retrieve usage metrics for extract operations.
-   */
-  async extract(
-    request: operations.GetExtractUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetExtractUsageResponseBody> {
-    return unwrapAsync(llmUsageExtract(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get classify usage
-   *
-   * @remarks
-   * Retrieve usage metrics for classify operations.
-   */
-  async classify(
-    request: operations.GetClassifyUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetClassifyUsageResponseBody> {
-    return unwrapAsync(llmUsageClassify(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get vector stores usage
-   *
-   * @remarks
-   * Retrieve usage metrics for vector storage operations.
-   */
-  async vectorStores(
-    request: operations.GetVectorStoresUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetVectorStoresUsageResponseBody> {
-    return unwrapAsync(llmUsageVectorStores(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get files usage
-   *
-   * @remarks
-   * Retrieve bytes of files created per period from durable file creation events. This does not reflect current retained storage, buckets remain counted after file deletion, and grouped results collapse by requested output dimensions rather than one row per UserContext.
-   */
-  async files(
-    request: operations.GetFilesUsageRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetFilesUsageResponseBody> {
-    return unwrapAsync(llmUsageFiles(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get cost by model
-   *
-   * @remarks
-   * Aggregates spend by model over a time range, priced in the cluster currency from the model price book. Org-scoped: org admins see their org; cluster admins may pass `org_id`. Includes billable work with no usage row of its own (store=false responses, agent tool calls), so totals cover all LLM spend. Platform-wide, cross-service cost reporting lives in the budgeting API (/api/v1/budgeting/usage/costs).
+   * Sums stored per-entry cost over [start_time, end_time), grouped by any of service, task_type, model, api_key_id, team_id, user_id, external_user_id, org_id. Point-in-time correct for chargeback/showback.
    */
   async costs(
-    request: operations.GetCostsUsageRequest,
+    request: operations.GetCostsRequest,
     options?: RequestOptions,
-  ): Promise<components.UsageCostsResponse> {
-    return unwrapAsync(llmUsageCosts(
+  ): Promise<operations.GetCostsResponseBody> {
+    return unwrapAsync(usageCosts(
       this,
       request,
       options,