@meetkai/mka1 0.51.12 → 0.51.13

package/src/funcs/servingSpendGet.ts

@@ -0,0 +1,197 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Cost and spend summary
+ *
+ * @remarks
+ * Aggregate spend for your organization, computed from retained compute ledgers as price × runtime overlap with the requested window. Spend is derived on read and is never stored.
+ */
+export function servingSpendGet(
+  client: SDKCore,
+  request: operations.GetSpendRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.SpendSummary,
+    | errors.ServingError
+    | errors.ServingHTTPValidationError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.GetSpendRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.SpendSummary,
+      | errors.ServingError
+      | errors.ServingHTTPValidationError
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetSpendRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/api/v1/serving/spend")();
+
+  const query = encodeFormQuery({
+    "end": payload.end,
+    "start": payload.start,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+    "X-On-Behalf-Of": encodeSimple(
+      "X-On-Behalf-Of",
+      payload["X-On-Behalf-Of"],
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getSpend",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 5000,
+          exponent: 1.5,
+          maxElapsedTime: 15000,
+        },
+        retryConnectionErrors: true,
+      }
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.SpendSummary,
+    | errors.ServingError
+    | errors.ServingHTTPValidationError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.SpendSummary$inboundSchema),
+    M.jsonErr([401, 403], errors.ServingError$inboundSchema),
+    M.jsonErr(422, errors.ServingHTTPValidationError$inboundSchema),
+    M.jsonErr([500, 503], errors.ServingError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.51.12",
+  sdkVersion: "0.51.13",
   genVersion: "2.918.4",
-  userAgent: "speakeasy-sdk/typescript 0.51.12 2.918.4 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.51.13 2.918.4 1.1.0 @meetkai/mka1",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.51.12",
+    currentVersion: "0.51.13",
   },
 });
 

package/src/mcp-server/server.ts

@@ -338,6 +338,7 @@ import { tool$servingRecipesSetEnabled } from "./tools/servingRecipesSetEnabled.
 import { tool$servingSecretsCreate } from "./tools/servingSecretsCreate.js";
 import { tool$servingSecretsDelete } from "./tools/servingSecretsDelete.js";
 import { tool$servingSecretsList } from "./tools/servingSecretsList.js";
+import { tool$servingSpendGet } from "./tools/servingSpendGet.js";
 import { tool$servingTenantsDeleteOrganization } from "./tools/servingTenantsDeleteOrganization.js";
 import { tool$servingTenantsGet } from "./tools/servingTenantsGet.js";
 import { tool$servingTenantsGetOrganizationDeletion } from "./tools/servingTenantsGetOrganizationDeletion.js";
@@ -360,7 +361,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.51.12",
+    version: "0.51.13",
   });
 
   const client = new SDKCore({
@@ -717,6 +718,7 @@ export function createMCPServer(deps: {
   tool(tool$servingSecretsList);
   tool(tool$servingSecretsCreate);
   tool(tool$servingSecretsDelete);
+  tool(tool$servingSpendGet);
   tool(tool$servingTenantsList);
   tool(tool$servingTenantsGet);
   tool(tool$servingTenantsSet);

package/src/mcp-server/tools/servingSpendGet.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingSpendGet } from "../../funcs/servingSpendGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetSpendRequest$inboundSchema,
+};
+
+export const tool$servingSpendGet: ToolDefinition<typeof args> = {
+  name: "serving-spend-get",
+  description: `Cost and spend summary
+
+Aggregate spend for your organization, computed from retained compute ledgers as price × runtime overlap with the requested window. Spend is derived on read and is never stored.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await servingSpendGet(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/components/index.ts

@@ -512,6 +512,10 @@ export * from "./speakersegment.js";
 export * from "./speechhistorydeletionstatus.js";
 export * from "./speechtotexthistorylist.js";
 export * from "./speechtotexthistoryobject.js";
+export * from "./spendgroup.js";
+export * from "./spenditem.js";
+export * from "./spendsummary.js";
+export * from "./spendwindow.js";
 export * from "./startexportfeedbackresponse.js";
 export * from "./staticchunkingstrategy.js";
 export * from "./status.js";

package/src/models/components/spendgroup.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  SpendItem,
+  SpendItem$inboundSchema,
+  SpendItem$Outbound,
+  SpendItem$outboundSchema,
+} from "./spenditem.js";
+
+/**
+ * Aggregate spend for one resource class.
+ */
+export type SpendGroup = {
+  /**
+   * Highest-spend resources first; at most 100 entries.
+   */
+  items: Array<SpendItem>;
+  /**
+   * Full spend for this group in the window, including resources beyond the items cap.
+   */
+  totalUsd: number;
+};
+
+/** @internal */
+export const SpendGroup$inboundSchema: z.ZodType<
+  SpendGroup,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(SpendItem$inboundSchema),
+  total_usd: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "total_usd": "totalUsd",
+  });
+});
+/** @internal */
+export type SpendGroup$Outbound = {
+  items: Array<SpendItem$Outbound>;
+  total_usd: number;
+};
+
+/** @internal */
+export const SpendGroup$outboundSchema: z.ZodType<
+  SpendGroup$Outbound,
+  z.ZodTypeDef,
+  SpendGroup
+> = z.object({
+  items: z.array(SpendItem$outboundSchema),
+  totalUsd: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    totalUsd: "total_usd",
+  });
+});
+
+export function spendGroupToJSON(spendGroup: SpendGroup): string {
+  return JSON.stringify(SpendGroup$outboundSchema.parse(spendGroup));
+}
+export function spendGroupFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendGroup, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendGroup$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendGroup' from JSON`,
+  );
+}

package/src/models/components/spenditem.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Computed spend for one resource within the window.
+ */
+export type SpendItem = {
+  id: string;
+  name: string;
+  /**
+   * Computed spend within the window, in USD.
+   */
+  usd: number;
+};
+
+/** @internal */
+export const SpendItem$inboundSchema: z.ZodType<
+  SpendItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  usd: z.number(),
+});
+/** @internal */
+export type SpendItem$Outbound = {
+  id: string;
+  name: string;
+  usd: number;
+};
+
+/** @internal */
+export const SpendItem$outboundSchema: z.ZodType<
+  SpendItem$Outbound,
+  z.ZodTypeDef,
+  SpendItem
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  usd: z.number(),
+});
+
+export function spendItemToJSON(spendItem: SpendItem): string {
+  return JSON.stringify(SpendItem$outboundSchema.parse(spendItem));
+}
+export function spendItemFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendItem' from JSON`,
+  );
+}

package/src/models/components/spendsummary.ts

@@ -0,0 +1,95 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  SpendGroup,
+  SpendGroup$inboundSchema,
+  SpendGroup$Outbound,
+  SpendGroup$outboundSchema,
+} from "./spendgroup.js";
+import {
+  SpendWindow,
+  SpendWindow$inboundSchema,
+  SpendWindow$Outbound,
+  SpendWindow$outboundSchema,
+} from "./spendwindow.js";
+
+/**
+ * Aggregate spend computed as price × runtime overlap with the window; derived on read, never stored.
+ */
+export type SpendSummary = {
+  /**
+   * Aggregate spend for one resource class.
+   */
+  deployments: SpendGroup;
+  /**
+   * Aggregate spend for one resource class.
+   */
+  finetune: SpendGroup;
+  /**
+   * Total spend across deployments and fine-tune jobs in the window.
+   */
+  totalUsd: number;
+  /**
+   * The resolved reporting window.
+   */
+  window: SpendWindow;
+};
+
+/** @internal */
+export const SpendSummary$inboundSchema: z.ZodType<
+  SpendSummary,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  deployments: SpendGroup$inboundSchema,
+  finetune: SpendGroup$inboundSchema,
+  total_usd: z.number(),
+  window: SpendWindow$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "total_usd": "totalUsd",
+  });
+});
+/** @internal */
+export type SpendSummary$Outbound = {
+  deployments: SpendGroup$Outbound;
+  finetune: SpendGroup$Outbound;
+  total_usd: number;
+  window: SpendWindow$Outbound;
+};
+
+/** @internal */
+export const SpendSummary$outboundSchema: z.ZodType<
+  SpendSummary$Outbound,
+  z.ZodTypeDef,
+  SpendSummary
+> = z.object({
+  deployments: SpendGroup$outboundSchema,
+  finetune: SpendGroup$outboundSchema,
+  totalUsd: z.number(),
+  window: SpendWindow$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    totalUsd: "total_usd",
+  });
+});
+
+export function spendSummaryToJSON(spendSummary: SpendSummary): string {
+  return JSON.stringify(SpendSummary$outboundSchema.parse(spendSummary));
+}
+export function spendSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendSummary' from JSON`,
+  );
+}

package/src/models/components/spendwindow.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * The resolved reporting window.
+ */
+export type SpendWindow = {
+  end: Date;
+  /**
+   * Lower bound of the window; null when the request set none (total covers all history).
+   */
+  start?: Date | null | undefined;
+};
+
+/** @internal */
+export const SpendWindow$inboundSchema: z.ZodType<
+  SpendWindow,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  end: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  start: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+});
+/** @internal */
+export type SpendWindow$Outbound = {
+  end: string;
+  start?: string | null | undefined;
+};
+
+/** @internal */
+export const SpendWindow$outboundSchema: z.ZodType<
+  SpendWindow$Outbound,
+  z.ZodTypeDef,
+  SpendWindow
+> = z.object({
+  end: z.date().transform(v => v.toISOString()),
+  start: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+});
+
+export function spendWindowToJSON(spendWindow: SpendWindow): string {
+  return JSON.stringify(SpendWindow$outboundSchema.parse(spendWindow));
+}
+export function spendWindowFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendWindow, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendWindow$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendWindow' from JSON`,
+  );
+}

package/src/models/operations/getspend.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetSpendRequest = {
+  start?: Date | null | undefined;
+  end?: Date | null | undefined;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const GetSpendRequest$inboundSchema: z.ZodType<
+  GetSpendRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  start: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  end: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetSpendRequest$Outbound = {
+  start?: string | null | undefined;
+  end?: string | null | undefined;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetSpendRequest$outboundSchema: z.ZodType<
+  GetSpendRequest$Outbound,
+  z.ZodTypeDef,
+  GetSpendRequest
+> = z.object({
+  start: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  end: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getSpendRequestToJSON(
+  getSpendRequest: GetSpendRequest,
+): string {
+  return JSON.stringify(GetSpendRequest$outboundSchema.parse(getSpendRequest));
+}
+export function getSpendRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetSpendRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetSpendRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetSpendRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -176,6 +176,7 @@ export * from "./getskillversion.js";
 export * from "./getskillversioncontent.js";
 export * from "./getspeechtotexthistory.js";
 export * from "./getspeechtotexthistorycontent.js";
+export * from "./getspend.js";
 export * from "./getteam.js";
 export * from "./gettexttospeechhistory.js";
 export * from "./gettexttospeechhistorycontent.js";

package/src/react-query/index.ts

@@ -331,6 +331,7 @@ export * from "./servingRecipesSetEnabled.js";
 export * from "./servingSecretsCreate.js";
 export * from "./servingSecretsDelete.js";
 export * from "./servingSecretsList.js";
+export * from "./servingSpendGet.js";
 export * from "./servingTenantsDeleteOrganization.js";
 export * from "./servingTenantsGet.js";
 export * from "./servingTenantsGetOrganizationDeletion.js";