@orq-ai/node 4.11.0-rc.2 → 4.11.0-rc.20

package/src/models/components/checkbudgetsrequest.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+/**
+ * Request metadata forwarded for dynamic-budget matching
+ *
+ * @remarks
+ *  (`metadata.team == "ml"`). Free-form JSON object from the request
+ *  body's `metadata` field.
+ */
+export type Metadata = {};
+
+export type CheckBudgetsRequest = {
+  /**
+   * API key that issued the request (if any).
+   */
+  apiKeyId?: string | undefined;
+  /**
+   * Project the request targets (if any).
+   */
+  projectId?: string | undefined;
+  /**
+   * Identity external id for contact-scoped budgets (if any).
+   */
+  identityExternalId?: string | undefined;
+  /**
+   * Provider enum value for provider-scoped budgets (if any).
+   */
+  provider?: string | undefined;
+  /**
+   * Full model reference for model-scoped budgets (if any), exactly as
+   *
+   * @remarks
+   *  the caller sent it: "provider/model" or "workspaceKey@provider/model".
+   */
+  modelId?: string | undefined;
+  /**
+   * Request metadata forwarded for dynamic-budget matching
+   *
+   * @remarks
+   *  (`metadata.team == "ml"`). Free-form JSON object from the request
+   *  body's `metadata` field.
+   */
+  metadata?: Metadata | undefined;
+  /**
+   * Request headers (lowercase keys) forwarded for dynamic-budget
+   *
+   * @remarks
+   *  matching (`headers["x-env"] == "prod"`).
+   */
+  headers?: { [k: string]: string } | undefined;
+};
+
+/** @internal */
+export type Metadata$Outbound = {};
+
+/** @internal */
+export const Metadata$outboundSchema: z.ZodType<
+  Metadata$Outbound,
+  z.ZodTypeDef,
+  Metadata
+> = z.object({});
+
+export function metadataToJSON(metadata: Metadata): string {
+  return JSON.stringify(Metadata$outboundSchema.parse(metadata));
+}
+
+/** @internal */
+export type CheckBudgetsRequest$Outbound = {
+  api_key_id?: string | undefined;
+  project_id?: string | undefined;
+  identity_external_id?: string | undefined;
+  provider?: string | undefined;
+  model_id?: string | undefined;
+  metadata?: Metadata$Outbound | undefined;
+  headers?: { [k: string]: string } | undefined;
+};
+
+/** @internal */
+export const CheckBudgetsRequest$outboundSchema: z.ZodType<
+  CheckBudgetsRequest$Outbound,
+  z.ZodTypeDef,
+  CheckBudgetsRequest
+> = z.object({
+  apiKeyId: z.string().optional(),
+  projectId: z.string().optional(),
+  identityExternalId: z.string().optional(),
+  provider: z.string().optional(),
+  modelId: z.string().optional(),
+  metadata: z.lazy(() => Metadata$outboundSchema).optional(),
+  headers: z.record(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    apiKeyId: "api_key_id",
+    projectId: "project_id",
+    identityExternalId: "identity_external_id",
+    modelId: "model_id",
+  });
+});
+
+export function checkBudgetsRequestToJSON(
+  checkBudgetsRequest: CheckBudgetsRequest,
+): string {
+  return JSON.stringify(
+    CheckBudgetsRequest$outboundSchema.parse(checkBudgetsRequest),
+  );
+}

package/src/models/components/checkbudgetsresponse.ts

@@ -0,0 +1,62 @@
+/*
+ * 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";
+import {
+  BudgetRejection,
+  BudgetRejection$inboundSchema,
+} from "./budgetrejection.js";
+import { DimensionInfo, DimensionInfo$inboundSchema } from "./dimensioninfo.js";
+
+export type CheckBudgetsResponse = {
+  /**
+   * True when no applicable budget exceeds its limit.
+   */
+  allowed?: boolean | undefined;
+  /**
+   * Populated when allowed is false; identifies which budget and
+   *
+   * @remarks
+   *  dimension triggered the rejection.
+   */
+  rejection?: BudgetRejection | undefined;
+  /**
+   * Cost dimension info for rate-limit headers (nil when no cost budget applies).
+   */
+  cost?: DimensionInfo | undefined;
+  /**
+   * Token dimension info for rate-limit headers (nil when no token budget applies).
+   */
+  tokens?: DimensionInfo | undefined;
+  /**
+   * Requests dimension info for rate-limit headers (nil when no RPM budget applies).
+   */
+  requests?: DimensionInfo | undefined;
+};
+
+/** @internal */
+export const CheckBudgetsResponse$inboundSchema: z.ZodType<
+  CheckBudgetsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  allowed: z.boolean().optional(),
+  rejection: BudgetRejection$inboundSchema.optional(),
+  cost: DimensionInfo$inboundSchema.optional(),
+  tokens: DimensionInfo$inboundSchema.optional(),
+  requests: DimensionInfo$inboundSchema.optional(),
+});
+
+export function checkBudgetsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CheckBudgetsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CheckBudgetsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CheckBudgetsResponse' from JSON`,
+  );
+}

package/src/models/components/createbudgetrequest.ts

@@ -0,0 +1,109 @@
+/*
+ * 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 {
+  BudgetLimits,
+  BudgetLimits$Outbound,
+  BudgetLimits$outboundSchema,
+} from "./budgetlimits.js";
+import {
+  BudgetMatch,
+  BudgetMatch$Outbound,
+  BudgetMatch$outboundSchema,
+} from "./budgetmatch.js";
+import {
+  BudgetScope,
+  BudgetScope$Outbound,
+  BudgetScope$outboundSchema,
+} from "./budgetscope.js";
+import {
+  RateLimit,
+  RateLimit$Outbound,
+  RateLimit$outboundSchema,
+} from "./ratelimit.js";
+
+export type CreateBudgetRequest = {
+  /**
+   * Structured scope. Mutually exclusive with `match`: provide a scope
+   *
+   * @remarks
+   *  for the six canonical kinds (the server derives the matching CEL),
+   *  or provide `match` for a dynamic budget. Exactly one of the two
+   *  must be set; the handler enforces that invariant.
+   */
+  scope?: BudgetScope | undefined;
+  /**
+   * Raw CEL matching expression for dynamic budgets (e.g.
+   *
+   * @remarks
+   *  `metadata.team == "ml" && provider == "openai"`). Validated via
+   *  CEL parse at write time. Mutually exclusive with `scope`.
+   */
+  match?: BudgetMatch | undefined;
+  /**
+   * At least one of amount / token_limit / rate_limit.requests_per_minute
+   *
+   * @remarks
+   *  must be provided on the budget; the handler enforces that invariant.
+   */
+  limits?: BudgetLimits | undefined;
+  /**
+   * Optional rate limit.
+   */
+  rateLimit?: RateLimit | undefined;
+  /**
+   * Whether the budget should be active immediately. Defaults to true
+   *
+   * @remarks
+   *  when omitted (handler enforces).
+   */
+  isActive?: boolean | undefined;
+  /**
+   * Optional expiration. When set in combination with is_active=true,
+   *
+   * @remarks
+   *  the value MUST be in the future; the handler rejects past values.
+   */
+  expiresAt?: Date | undefined;
+};
+
+/** @internal */
+export type CreateBudgetRequest$Outbound = {
+  scope?: BudgetScope$Outbound | undefined;
+  match?: BudgetMatch$Outbound | undefined;
+  limits?: BudgetLimits$Outbound | undefined;
+  rate_limit?: RateLimit$Outbound | undefined;
+  is_active?: boolean | undefined;
+  expires_at?: string | undefined;
+};
+
+/** @internal */
+export const CreateBudgetRequest$outboundSchema: z.ZodType<
+  CreateBudgetRequest$Outbound,
+  z.ZodTypeDef,
+  CreateBudgetRequest
+> = z.object({
+  scope: BudgetScope$outboundSchema.optional(),
+  match: BudgetMatch$outboundSchema.optional(),
+  limits: BudgetLimits$outboundSchema.optional(),
+  rateLimit: RateLimit$outboundSchema.optional(),
+  isActive: z.boolean().optional(),
+  expiresAt: z.date().transform(v => v.toISOString()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    rateLimit: "rate_limit",
+    isActive: "is_active",
+    expiresAt: "expires_at",
+  });
+});
+
+export function createBudgetRequestToJSON(
+  createBudgetRequest: CreateBudgetRequest,
+): string {
+  return JSON.stringify(
+    CreateBudgetRequest$outboundSchema.parse(createBudgetRequest),
+  );
+}

package/src/models/components/createbudgetresponse.ts

@@ -0,0 +1,35 @@
+/*
+ * 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";
+import { Budget, Budget$inboundSchema } from "./budget.js";
+
+export type CreateBudgetResponse = {
+  /**
+   * Newly created budget.
+   */
+  budget?: Budget | undefined;
+};
+
+/** @internal */
+export const CreateBudgetResponse$inboundSchema: z.ZodType<
+  CreateBudgetResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  budget: Budget$inboundSchema.optional(),
+});
+
+export function createBudgetResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateBudgetResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateBudgetResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateBudgetResponse' from JSON`,
+  );
+}

package/src/models/components/deletebudgetresponse.ts

@@ -0,0 +1,27 @@
+/*
+ * 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";
+
+export type DeleteBudgetResponse = {};
+
+/** @internal */
+export const DeleteBudgetResponse$inboundSchema: z.ZodType<
+  DeleteBudgetResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({});
+
+export function deleteBudgetResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<DeleteBudgetResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeleteBudgetResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeleteBudgetResponse' from JSON`,
+  );
+}

package/src/models/components/dimensioninfo.ts

@@ -0,0 +1,43 @@
+/*
+ * 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";
+
+/**
+ * DimensionInfo carries limit/remaining/reset for a single dimension.
+ */
+export type DimensionInfo = {
+  limit?: number | undefined;
+  remaining?: number | undefined;
+  resetSeconds?: number | undefined;
+};
+
+/** @internal */
+export const DimensionInfo$inboundSchema: z.ZodType<
+  DimensionInfo,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  limit: z.number().optional(),
+  remaining: z.number().optional(),
+  reset_seconds: z.number().int().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "reset_seconds": "resetSeconds",
+  });
+});
+
+export function dimensionInfoFromJSON(
+  jsonString: string,
+): SafeParseResult<DimensionInfo, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DimensionInfo$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DimensionInfo' from JSON`,
+  );
+}

package/src/models/components/getbudgetconsumptionresponse.ts

@@ -0,0 +1,67 @@
+/*
+ * 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 { BudgetPeriod, BudgetPeriod$inboundSchema } from "./budgetperiod.js";
+
+export type GetBudgetConsumptionResponse = {
+  /**
+   * Budget id whose counters are reported.
+   */
+  budgetId?: string | undefined;
+  period?: BudgetPeriod | undefined;
+  /**
+   * Period bucket label (e.g. "2025-05-27" for DAILY, "2025-05" for
+   *
+   * @remarks
+   *  MONTHLY). Empty when no counters exist for the current period.
+   */
+  periodDate?: string | undefined;
+  /**
+   * Cost accumulated in the current period, in USD.
+   */
+  cost?: number | undefined;
+  /**
+   * Tokens accumulated in the current period.
+   */
+  tokens?: string | undefined;
+  /**
+   * Requests counted in the current 60-second rolling window.
+   */
+  requestsInWindow?: number | undefined;
+};
+
+/** @internal */
+export const GetBudgetConsumptionResponse$inboundSchema: z.ZodType<
+  GetBudgetConsumptionResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  budget_id: z.string().optional(),
+  period: BudgetPeriod$inboundSchema.optional(),
+  period_date: z.string().optional(),
+  cost: z.number().optional(),
+  tokens: z.string().optional(),
+  requests_in_window: z.number().int().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "budget_id": "budgetId",
+    "period_date": "periodDate",
+    "requests_in_window": "requestsInWindow",
+  });
+});
+
+export function getBudgetConsumptionResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetBudgetConsumptionResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetBudgetConsumptionResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetBudgetConsumptionResponse' from JSON`,
+  );
+}

package/src/models/components/getbudgetresponse.ts

@@ -0,0 +1,35 @@
+/*
+ * 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";
+import { Budget, Budget$inboundSchema } from "./budget.js";
+
+export type GetBudgetResponse = {
+  /**
+   * Requested budget.
+   */
+  budget?: Budget | undefined;
+};
+
+/** @internal */
+export const GetBudgetResponse$inboundSchema: z.ZodType<
+  GetBudgetResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  budget: Budget$inboundSchema.optional(),
+});
+
+export function getBudgetResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetBudgetResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetBudgetResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetBudgetResponse' from JSON`,
+  );
+}

package/src/models/components/identity.ts

@@ -15,7 +15,7 @@ import {
 /**
  * Custom JSON metadata stored with the identity.
  */
-export type Metadata = {};
+export type IdentityMetadata = {};
 
 export type Identity = {
   /**
@@ -55,7 +55,7 @@ export type Identity = {
   /**
    * Custom JSON metadata stored with the identity.
    */
-  metadata?: Metadata | undefined;
+  metadata?: IdentityMetadata | undefined;
   /**
    * ISO timestamp for when the identity was created.
    */
@@ -74,19 +74,19 @@ export type Identity = {
 };
 
 /** @internal */
-export const Metadata$inboundSchema: z.ZodType<
-  Metadata,
+export const IdentityMetadata$inboundSchema: z.ZodType<
+  IdentityMetadata,
   z.ZodTypeDef,
   unknown
 > = z.object({});
 
-export function metadataFromJSON(
+export function identityMetadataFromJSON(
   jsonString: string,
-): SafeParseResult<Metadata, SDKValidationError> {
+): SafeParseResult<IdentityMetadata, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => Metadata$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Metadata' from JSON`,
+    (x) => IdentityMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IdentityMetadata' from JSON`,
   );
 }
 
@@ -103,7 +103,7 @@ export const Identity$inboundSchema: z.ZodType<
   email: z.string().optional(),
   avatar_url: z.string().optional(),
   tags: z.array(z.string()).optional(),
-  metadata: z.lazy(() => Metadata$inboundSchema).optional(),
+  metadata: z.lazy(() => IdentityMetadata$inboundSchema).optional(),
   created: z.string(),
   updated: z.string(),
   metrics: IdentityMetrics$inboundSchema.optional(),

package/src/models/components/identitybudgetscope.ts

@@ -0,0 +1,66 @@
+/*
+ * 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";
+
+/**
+ * Per-identity cap. Keyed by the contact's external_id (not the
+ *
+ * @remarks
+ *  internal Mongo `_id`) so the scope is stable across imports.
+ */
+export type IdentityBudgetScope = {
+  identityExternalId?: string | undefined;
+};
+
+/** @internal */
+export const IdentityBudgetScope$inboundSchema: z.ZodType<
+  IdentityBudgetScope,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  identity_external_id: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "identity_external_id": "identityExternalId",
+  });
+});
+/** @internal */
+export type IdentityBudgetScope$Outbound = {
+  identity_external_id?: string | undefined;
+};
+
+/** @internal */
+export const IdentityBudgetScope$outboundSchema: z.ZodType<
+  IdentityBudgetScope$Outbound,
+  z.ZodTypeDef,
+  IdentityBudgetScope
+> = z.object({
+  identityExternalId: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    identityExternalId: "identity_external_id",
+  });
+});
+
+export function identityBudgetScopeToJSON(
+  identityBudgetScope: IdentityBudgetScope,
+): string {
+  return JSON.stringify(
+    IdentityBudgetScope$outboundSchema.parse(identityBudgetScope),
+  );
+}
+export function identityBudgetScopeFromJSON(
+  jsonString: string,
+): SafeParseResult<IdentityBudgetScope, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IdentityBudgetScope$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IdentityBudgetScope' from JSON`,
+  );
+}