@meetkai/mka1 0.48.24 → 0.48.26

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmModelsSetOrgPrice } from "../../funcs/llmModelsSetOrgPrice.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.SetOrgPriceRequest$inboundSchema,
+};
+
+export const tool$llmModelsSetOrgPrice: ToolDefinition<typeof args> = {
+  name: "llm-models-set-org-price",
+  description: `Set an org price override
+
+Upserts a per-org price override for a model (new dated version). Resolution at spend time is org override → cluster default → $0.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmModelsSetOrgPrice(
+      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/mcp-server/tools/llmUsageCosts.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmUsageCosts } from "../../funcs/llmUsageCosts.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetCostsUsageRequest$inboundSchema,
+};
+
+export const tool$llmUsageCosts: ToolDefinition<typeof args> = {
+  name: "llm-usage-costs",
+  description: `Get cost by model
+
+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 reconcile with the live budget gauge.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmUsageCosts(
+      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/agent.ts

@@ -52,6 +52,10 @@ export type Agent = {
   text: AgentTextConfiguration | null;
   reasoning: AgentReasoningConfiguration | null;
   metadata: { [k: string]: string };
+  /**
+   * Current configuration version. Incremented on every update or rollback.
+   */
+  version: number;
   createdAt: Date;
   updatedAt: Date;
   deletedAt: Date | null;
@@ -80,6 +84,7 @@ export const Agent$inboundSchema: z.ZodType<Agent, z.ZodTypeDef, unknown> = z
     text: z.nullable(AgentTextConfiguration$inboundSchema),
     reasoning: z.nullable(AgentReasoningConfiguration$inboundSchema),
     metadata: z.record(z.string()),
+    version: z.number().int(),
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
@@ -114,6 +119,7 @@ export type Agent$Outbound = {
   text: AgentTextConfiguration$Outbound | null;
   reasoning: AgentReasoningConfiguration$Outbound | null;
   metadata: { [k: string]: string };
+  version: number;
   created_at: string;
   updated_at: string;
   deleted_at: string | null;
@@ -138,6 +144,7 @@ export const Agent$outboundSchema: z.ZodType<
   text: z.nullable(AgentTextConfiguration$outboundSchema),
   reasoning: z.nullable(AgentReasoningConfiguration$outboundSchema),
   metadata: z.record(z.string()),
+  version: z.number().int(),
   createdAt: z.date().transform(v => v.toISOString()),
   updatedAt: z.date().transform(v => v.toISOString()),
   deletedAt: z.nullable(z.date().transform(v => v.toISOString())),

package/src/models/components/agentrun.ts

@@ -31,6 +31,10 @@ export type AgentRun = {
   object: AgentRunObject;
   id: string;
   agentId: string;
+  /**
+   * The agent configuration version this run executed against. Null for runs created before versioning.
+   */
+  agentVersion: number | null;
   status: AgentRunStatus;
   input: JsonValue | null;
   conversation: JsonValue | null;
@@ -70,6 +74,7 @@ export const AgentRun$inboundSchema: z.ZodType<
   object: AgentRunObject$inboundSchema,
   id: z.string(),
   agent_id: z.string(),
+  agent_version: z.nullable(z.number().int()),
   status: AgentRunStatus$inboundSchema,
   input: z.nullable(JsonValue$inboundSchema),
   conversation: z.nullable(JsonValue$inboundSchema),
@@ -85,6 +90,7 @@ export const AgentRun$inboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     "agent_id": "agentId",
+    "agent_version": "agentVersion",
     "previous_response_id": "previousResponseId",
     "gateway_response_id": "gatewayResponseId",
     "gateway_response": "gatewayResponse",
@@ -97,6 +103,7 @@ export type AgentRun$Outbound = {
   object: string;
   id: string;
   agent_id: string;
+  agent_version: number | null;
   status: string;
   input: JsonValue$Outbound | null;
   conversation: JsonValue$Outbound | null;
@@ -118,6 +125,7 @@ export const AgentRun$outboundSchema: z.ZodType<
   object: AgentRunObject$outboundSchema,
   id: z.string(),
   agentId: z.string(),
+  agentVersion: z.nullable(z.number().int()),
   status: AgentRunStatus$outboundSchema,
   input: z.nullable(JsonValue$outboundSchema),
   conversation: z.nullable(JsonValue$outboundSchema),
@@ -131,6 +139,7 @@ export const AgentRun$outboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     agentId: "agent_id",
+    agentVersion: "agent_version",
     previousResponseId: "previous_response_id",
     gatewayResponseId: "gateway_response_id",
     gatewayResponse: "gateway_response",

package/src/models/components/agentversion.ts

@@ -0,0 +1,181 @@
+/*
+ * 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 { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AgentReasoningConfiguration,
+  AgentReasoningConfiguration$inboundSchema,
+  AgentReasoningConfiguration$Outbound,
+  AgentReasoningConfiguration$outboundSchema,
+} from "./agentreasoningconfiguration.js";
+import {
+  AgentTextConfiguration,
+  AgentTextConfiguration$inboundSchema,
+  AgentTextConfiguration$Outbound,
+  AgentTextConfiguration$outboundSchema,
+} from "./agenttextconfiguration.js";
+import {
+  JsonValue,
+  JsonValue$inboundSchema,
+  JsonValue$Outbound,
+  JsonValue$outboundSchema,
+} from "./jsonvalue.js";
+import {
+  ToolDefinition,
+  ToolDefinition$inboundSchema,
+  ToolDefinition$Outbound,
+  ToolDefinition$outboundSchema,
+} from "./tooldefinition.js";
+
+export const AgentVersionObject = {
+  AgentVersion: "agent.version",
+} as const;
+export type AgentVersionObject = ClosedEnum<typeof AgentVersionObject>;
+
+export type AgentVersion = {
+  object: AgentVersionObject;
+  id: string;
+  agentId: string;
+  version: number;
+  /**
+   * True when this version matches the agent's current configuration.
+   */
+  isCurrent: boolean;
+  /**
+   * When this version was produced by a rollback, the version it was restored from.
+   */
+  restoredFromVersion: number | null;
+  name: string;
+  description: string | null;
+  model: string;
+  instructions: string | null;
+  tools: Array<ToolDefinition>;
+  toolChoice: JsonValue | null;
+  parallelToolCalls: boolean;
+  maxToolCalls: number | null;
+  text: AgentTextConfiguration | null;
+  reasoning: AgentReasoningConfiguration | null;
+  metadata: { [k: string]: string };
+  createdAt: Date;
+};
+
+/** @internal */
+export const AgentVersionObject$inboundSchema: z.ZodNativeEnum<
+  typeof AgentVersionObject
+> = z.nativeEnum(AgentVersionObject);
+/** @internal */
+export const AgentVersionObject$outboundSchema: z.ZodNativeEnum<
+  typeof AgentVersionObject
+> = AgentVersionObject$inboundSchema;
+
+/** @internal */
+export const AgentVersion$inboundSchema: z.ZodType<
+  AgentVersion,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  object: AgentVersionObject$inboundSchema,
+  id: z.string(),
+  agent_id: z.string(),
+  version: z.number().int(),
+  is_current: z.boolean(),
+  restored_from_version: z.nullable(z.number().int()),
+  name: z.string(),
+  description: z.nullable(z.string()),
+  model: z.string(),
+  instructions: z.nullable(z.string()),
+  tools: z.array(ToolDefinition$inboundSchema),
+  tool_choice: z.nullable(JsonValue$inboundSchema),
+  parallel_tool_calls: z.boolean(),
+  max_tool_calls: z.nullable(z.number().int()),
+  text: z.nullable(AgentTextConfiguration$inboundSchema),
+  reasoning: z.nullable(AgentReasoningConfiguration$inboundSchema),
+  metadata: z.record(z.string()),
+  created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+}).transform((v) => {
+  return remap$(v, {
+    "agent_id": "agentId",
+    "is_current": "isCurrent",
+    "restored_from_version": "restoredFromVersion",
+    "tool_choice": "toolChoice",
+    "parallel_tool_calls": "parallelToolCalls",
+    "max_tool_calls": "maxToolCalls",
+    "created_at": "createdAt",
+  });
+});
+/** @internal */
+export type AgentVersion$Outbound = {
+  object: string;
+  id: string;
+  agent_id: string;
+  version: number;
+  is_current: boolean;
+  restored_from_version: number | null;
+  name: string;
+  description: string | null;
+  model: string;
+  instructions: string | null;
+  tools: Array<ToolDefinition$Outbound>;
+  tool_choice: JsonValue$Outbound | null;
+  parallel_tool_calls: boolean;
+  max_tool_calls: number | null;
+  text: AgentTextConfiguration$Outbound | null;
+  reasoning: AgentReasoningConfiguration$Outbound | null;
+  metadata: { [k: string]: string };
+  created_at: string;
+};
+
+/** @internal */
+export const AgentVersion$outboundSchema: z.ZodType<
+  AgentVersion$Outbound,
+  z.ZodTypeDef,
+  AgentVersion
+> = z.object({
+  object: AgentVersionObject$outboundSchema,
+  id: z.string(),
+  agentId: z.string(),
+  version: z.number().int(),
+  isCurrent: z.boolean(),
+  restoredFromVersion: z.nullable(z.number().int()),
+  name: z.string(),
+  description: z.nullable(z.string()),
+  model: z.string(),
+  instructions: z.nullable(z.string()),
+  tools: z.array(ToolDefinition$outboundSchema),
+  toolChoice: z.nullable(JsonValue$outboundSchema),
+  parallelToolCalls: z.boolean(),
+  maxToolCalls: z.nullable(z.number().int()),
+  text: z.nullable(AgentTextConfiguration$outboundSchema),
+  reasoning: z.nullable(AgentReasoningConfiguration$outboundSchema),
+  metadata: z.record(z.string()),
+  createdAt: z.date().transform(v => v.toISOString()),
+}).transform((v) => {
+  return remap$(v, {
+    agentId: "agent_id",
+    isCurrent: "is_current",
+    restoredFromVersion: "restored_from_version",
+    toolChoice: "tool_choice",
+    parallelToolCalls: "parallel_tool_calls",
+    maxToolCalls: "max_tool_calls",
+    createdAt: "created_at",
+  });
+});
+
+export function agentVersionToJSON(agentVersion: AgentVersion): string {
+  return JSON.stringify(AgentVersion$outboundSchema.parse(agentVersion));
+}
+export function agentVersionFromJSON(
+  jsonString: string,
+): SafeParseResult<AgentVersion, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AgentVersion$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AgentVersion' from JSON`,
+  );
+}

package/src/models/components/agentversionlist.ts

@@ -0,0 +1,101 @@
+/*
+ * 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 { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AgentVersion,
+  AgentVersion$inboundSchema,
+  AgentVersion$Outbound,
+  AgentVersion$outboundSchema,
+} from "./agentversion.js";
+
+export const AgentVersionListObject = {
+  List: "list",
+} as const;
+export type AgentVersionListObject = ClosedEnum<typeof AgentVersionListObject>;
+
+export type AgentVersionList = {
+  object: AgentVersionListObject;
+  data: Array<AgentVersion>;
+  firstId: string | null;
+  lastId: string | null;
+  hasMore: boolean;
+};
+
+/** @internal */
+export const AgentVersionListObject$inboundSchema: z.ZodNativeEnum<
+  typeof AgentVersionListObject
+> = z.nativeEnum(AgentVersionListObject);
+/** @internal */
+export const AgentVersionListObject$outboundSchema: z.ZodNativeEnum<
+  typeof AgentVersionListObject
+> = AgentVersionListObject$inboundSchema;
+
+/** @internal */
+export const AgentVersionList$inboundSchema: z.ZodType<
+  AgentVersionList,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  object: AgentVersionListObject$inboundSchema,
+  data: z.array(AgentVersion$inboundSchema),
+  first_id: z.nullable(z.string()),
+  last_id: z.nullable(z.string()),
+  has_more: z.boolean(),
+}).transform((v) => {
+  return remap$(v, {
+    "first_id": "firstId",
+    "last_id": "lastId",
+    "has_more": "hasMore",
+  });
+});
+/** @internal */
+export type AgentVersionList$Outbound = {
+  object: string;
+  data: Array<AgentVersion$Outbound>;
+  first_id: string | null;
+  last_id: string | null;
+  has_more: boolean;
+};
+
+/** @internal */
+export const AgentVersionList$outboundSchema: z.ZodType<
+  AgentVersionList$Outbound,
+  z.ZodTypeDef,
+  AgentVersionList
+> = z.object({
+  object: AgentVersionListObject$outboundSchema,
+  data: z.array(AgentVersion$outboundSchema),
+  firstId: z.nullable(z.string()),
+  lastId: z.nullable(z.string()),
+  hasMore: z.boolean(),
+}).transform((v) => {
+  return remap$(v, {
+    firstId: "first_id",
+    lastId: "last_id",
+    hasMore: "has_more",
+  });
+});
+
+export function agentVersionListToJSON(
+  agentVersionList: AgentVersionList,
+): string {
+  return JSON.stringify(
+    AgentVersionList$outboundSchema.parse(agentVersionList),
+  );
+}
+export function agentVersionListFromJSON(
+  jsonString: string,
+): SafeParseResult<AgentVersionList, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AgentVersionList$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AgentVersionList' from JSON`,
+  );
+}

package/src/models/components/budgetevent.ts

@@ -0,0 +1,108 @@
+/*
+ * 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 { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export const BudgetEventType = {
+  ThresholdAlert: "threshold_alert",
+  Blocked: "blocked",
+} as const;
+export type BudgetEventType = ClosedEnum<typeof BudgetEventType>;
+
+export type BudgetEvent = {
+  id: string;
+  budgetId: string;
+  type: BudgetEventType;
+  pct: number | null;
+  periodKey: string;
+  spendSnapshot: string;
+  limitSnapshot: string;
+  createdAt: string;
+};
+
+/** @internal */
+export const BudgetEventType$inboundSchema: z.ZodNativeEnum<
+  typeof BudgetEventType
+> = z.nativeEnum(BudgetEventType);
+/** @internal */
+export const BudgetEventType$outboundSchema: z.ZodNativeEnum<
+  typeof BudgetEventType
+> = BudgetEventType$inboundSchema;
+
+/** @internal */
+export const BudgetEvent$inboundSchema: z.ZodType<
+  BudgetEvent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  budget_id: z.string(),
+  type: BudgetEventType$inboundSchema,
+  pct: z.nullable(z.number()),
+  period_key: z.string(),
+  spend_snapshot: z.string(),
+  limit_snapshot: z.string(),
+  created_at: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "budget_id": "budgetId",
+    "period_key": "periodKey",
+    "spend_snapshot": "spendSnapshot",
+    "limit_snapshot": "limitSnapshot",
+    "created_at": "createdAt",
+  });
+});
+/** @internal */
+export type BudgetEvent$Outbound = {
+  id: string;
+  budget_id: string;
+  type: string;
+  pct: number | null;
+  period_key: string;
+  spend_snapshot: string;
+  limit_snapshot: string;
+  created_at: string;
+};
+
+/** @internal */
+export const BudgetEvent$outboundSchema: z.ZodType<
+  BudgetEvent$Outbound,
+  z.ZodTypeDef,
+  BudgetEvent
+> = z.object({
+  id: z.string(),
+  budgetId: z.string(),
+  type: BudgetEventType$outboundSchema,
+  pct: z.nullable(z.number()),
+  periodKey: z.string(),
+  spendSnapshot: z.string(),
+  limitSnapshot: z.string(),
+  createdAt: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    budgetId: "budget_id",
+    periodKey: "period_key",
+    spendSnapshot: "spend_snapshot",
+    limitSnapshot: "limit_snapshot",
+    createdAt: "created_at",
+  });
+});
+
+export function budgetEventToJSON(budgetEvent: BudgetEvent): string {
+  return JSON.stringify(BudgetEvent$outboundSchema.parse(budgetEvent));
+}
+export function budgetEventFromJSON(
+  jsonString: string,
+): SafeParseResult<BudgetEvent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BudgetEvent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BudgetEvent' from JSON`,
+  );
+}

package/src/models/components/budgetlimitkind.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const BudgetLimitKind = {
+  Cost: "cost",
+  Tokens: "tokens",
+} as const;
+export type BudgetLimitKind = ClosedEnum<typeof BudgetLimitKind>;
+
+/** @internal */
+export const BudgetLimitKind$inboundSchema: z.ZodNativeEnum<
+  typeof BudgetLimitKind
+> = z.nativeEnum(BudgetLimitKind);
+/** @internal */
+export const BudgetLimitKind$outboundSchema: z.ZodNativeEnum<
+  typeof BudgetLimitKind
+> = BudgetLimitKind$inboundSchema;

package/src/models/components/budgetowner.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const BudgetOwner = {
+  Cluster: "cluster",
+  Org: "org",
+} as const;
+export type BudgetOwner = ClosedEnum<typeof BudgetOwner>;
+
+/** @internal */
+export const BudgetOwner$inboundSchema: z.ZodNativeEnum<typeof BudgetOwner> = z
+  .nativeEnum(BudgetOwner);
+/** @internal */
+export const BudgetOwner$outboundSchema: z.ZodNativeEnum<typeof BudgetOwner> =
+  BudgetOwner$inboundSchema;

package/src/models/components/budgetperiod.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const BudgetPeriod = {
+  Daily: "daily",
+  Weekly: "weekly",
+  Monthly: "monthly",
+} as const;
+export type BudgetPeriod = ClosedEnum<typeof BudgetPeriod>;
+
+/** @internal */
+export const BudgetPeriod$inboundSchema: z.ZodNativeEnum<typeof BudgetPeriod> =
+  z.nativeEnum(BudgetPeriod);
+/** @internal */
+export const BudgetPeriod$outboundSchema: z.ZodNativeEnum<typeof BudgetPeriod> =
+  BudgetPeriod$inboundSchema;