@orq-ai/node 4.11.3 → 4.11.9

package/packages/orq-rc/src/funcs/modelsListLitellm.ts

@@ -0,0 +1,144 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { OrqCore } from "../core.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List models from configured LiteLLM instance
+ *
+ * @remarks
+ * Fetches the list of models from the LiteLLM instance configured for the workspace. Requires a stored LiteLLM integration.
+ */
+export function modelsListLitellm(
+  client: OrqCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Array<{ [k: string]: any }>,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Array<{ [k: string]: any }>,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/v2/models/litellm/models")();
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "ModelListLitellm",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { 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,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, 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 [result] = await M.match<
+    Array<{ [k: string]: any }>,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, z.array(z.record(z.any()))),
+    M.fail([404, "4XX"]),
+    M.fail([500, "5XX"]),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/packages/orq-rc/src/funcs/notifiersList.ts

@@ -94,7 +94,9 @@ async function $do(
     "ending_before": payload?.ending_before,
     "limit": payload?.limit,
     "project_id": payload?.project_id,
+    "search": payload?.search,
     "starting_after": payload?.starting_after,
+    "type": payload?.type,
   });
 
   const headers = new Headers(compactMap({

package/packages/orq-rc/src/funcs/reportingQuery.ts

@@ -29,7 +29,9 @@ import { Result } from "../types/fp.js";
  * Query reporting metrics
  *
  * @remarks
- * Returns time-series analytics for AI usage, cost, latency, evaluator results, and guardrail outcomes. Select a metric and time range, break results down by supported dimensions, apply filters, and optionally include totals for the full range.
+ * Deprecated: use TelemetryService.Query (POST /v2/telemetry/query) instead. Returns time-series analytics for AI usage, cost, latency, evaluator results, and guardrail outcomes. Select a metric and time range, break results down by supported dimensions, apply filters, and optionally include totals for the full range.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function reportingQuery(
   client: OrqCore,

package/packages/orq-rc/src/funcs/telemetryQuery.ts

@@ -0,0 +1,162 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeJSON } 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 { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Query telemetry
+ *
+ * @remarks
+ * Unified query envelope for traces, metrics, and logs. Selects a source, a compute list, and a time range, with optional grain, group-by, and filters; returns a time series or a single aggregate row per group.
+ */
+export function telemetryQuery(
+  client: OrqCore,
+  request: components.QueryTelemetryRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.QueryTelemetryResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request: components.QueryTelemetryRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.QueryTelemetryResponse,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => components.QueryTelemetryRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/telemetry/query")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "TelemetryQuery",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, 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 [result] = await M.match<
+    components.QueryTelemetryResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.QueryTelemetryResponse$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/packages/orq-rc/src/funcs/tracesAggregate.ts

@@ -29,7 +29,9 @@ import { Result } from "../types/fp.js";
  * Aggregate traces
  *
  * @remarks
- * Aggregate trace metrics using the structured trace filter contract.
+ * Deprecated: use TelemetryService.Query (POST /v2/telemetry/query, source=TRACES, grain=none) instead. Aggregate trace metrics using the structured trace filter contract.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function tracesAggregate(
   client: OrqCore,

package/packages/orq-rc/src/lib/config.ts

@@ -58,7 +58,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0",
-  sdkVersion: "4.12.0-rc.3",
-  genVersion: "2.915.1",
-  userAgent: "speakeasy-sdk/typescript 4.12.0-rc.3 2.915.1 2.0 @orq-ai/node",
+  sdkVersion: "4.12.0-rc.34",
+  genVersion: "2.918.3",
+  userAgent: "speakeasy-sdk/typescript 4.12.0-rc.34 2.918.3 2.0 @orq-ai/node",
 } as const;

package/packages/orq-rc/src/lib/http.ts

@@ -45,8 +45,10 @@ export class HTTPClient {
   private requestHooks: BeforeRequestHook[] = [];
   private requestErrorHooks: RequestErrorHook[] = [];
   private responseHooks: ResponseHook[] = [];
+  private options: HTTPClientOptions;
 
-  constructor(private options: HTTPClientOptions = {}) {
+  constructor(options: HTTPClientOptions = {}) {
+    this.options = options;
     this.fetcher = options.fetcher || DEFAULT_FETCHER;
   }
 

package/packages/orq-rc/src/lib/security.ts

@@ -13,17 +13,22 @@ type OAuth2PasswordFlow = {
   tokenURL: string;
 };
 
-export enum SecurityErrorCode {
-  Incomplete = "incomplete",
-  UnrecognisedSecurityType = "unrecognized_security_type",
-}
+export const SecurityErrorCode = {
+  Incomplete: "incomplete",
+  UnrecognisedSecurityType: "unrecognized_security_type",
+} as const;
+export type SecurityErrorCode =
+  (typeof SecurityErrorCode)[keyof typeof SecurityErrorCode];
 
 export class SecurityError extends Error {
+  public code: SecurityErrorCode;
+
   constructor(
-    public code: SecurityErrorCode,
+    code: SecurityErrorCode,
     message: string,
   ) {
     super(message);
+    this.code = code;
     this.name = "SecurityError";
   }
 

package/packages/orq-rc/src/models/components/agentstartedstreamingevent.ts

@@ -188,6 +188,10 @@ export type Settings = {
    * If all, the agent will require approval for all tools. If respect_tool, the agent will require approval for tools that have the requires_approval flag set to true. If none, the agent will not require approval for any tools.
    */
   toolApprovalRequired: ToolApprovalRequired;
+  /**
+   * When enabled, this agent is exposed as a selectable target in AI Chat for users to consume.
+   */
+  chatExposed?: boolean | undefined;
   tools?: Array<Tools> | undefined;
   /**
    * Configuration for an evaluator applied to the agent
@@ -432,6 +436,7 @@ export const Settings$inboundSchema: z.ZodType<
   tool_approval_required: ToolApprovalRequired$inboundSchema.default(
     "respect_tool",
   ),
+  chat_exposed: z.boolean().optional(),
   tools: z.array(z.lazy(() => Tools$inboundSchema)).optional(),
   evaluators: z.array(z.lazy(() => Evaluators$inboundSchema)).optional(),
   guardrails: z.array(z.lazy(() => Guardrails$inboundSchema)).optional(),
@@ -441,6 +446,7 @@ export const Settings$inboundSchema: z.ZodType<
     "max_execution_time": "maxExecutionTime",
     "max_cost": "maxCost",
     "tool_approval_required": "toolApprovalRequired",
+    "chat_exposed": "chatExposed",
   });
 });
 

package/packages/orq-rc/src/models/components/apikey.ts

@@ -9,6 +9,7 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import { ApiKeyOwner, ApiKeyOwner$inboundSchema } from "./apikeyowner.js";
 import { ApiKeyStatus, ApiKeyStatus$inboundSchema } from "./apikeystatus.js";
+import { BudgetAlert, BudgetAlert$inboundSchema } from "./budgetalert.js";
 import { BudgetLimits, BudgetLimits$inboundSchema } from "./budgetlimits.js";
 import { BudgetMatch, BudgetMatch$inboundSchema } from "./budgetmatch.js";
 import { BudgetScope, BudgetScope$inboundSchema } from "./budgetscope.js";
@@ -84,6 +85,10 @@ export type ApiKeyBudget = {
    *  has not been spent against in the current period.
    */
   usage?: BudgetUsage | undefined;
+  /**
+   * Threshold notifications. Absent when the budget has none.
+   */
+  alerts?: Array<BudgetAlert> | undefined;
 };
 
 /**
@@ -210,6 +215,7 @@ export const ApiKeyBudget$inboundSchema: z.ZodType<
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),
   usage: BudgetUsage$inboundSchema.optional(),
+  alerts: z.array(BudgetAlert$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
     "budget_id": "budgetId",

package/packages/orq-rc/src/models/components/budget.ts

@@ -7,6 +7,7 @@ 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 { BudgetAlert, BudgetAlert$inboundSchema } from "./budgetalert.js";
 import { BudgetLimits, BudgetLimits$inboundSchema } from "./budgetlimits.js";
 import { BudgetMatch, BudgetMatch$inboundSchema } from "./budgetmatch.js";
 import { BudgetScope, BudgetScope$inboundSchema } from "./budgetscope.js";
@@ -71,6 +72,10 @@ export type Budget = {
    *  has not been spent against in the current period.
    */
   usage?: BudgetUsage | undefined;
+  /**
+   * Threshold notifications. Absent when the budget has none.
+   */
+  alerts?: Array<BudgetAlert> | undefined;
 };
 
 /** @internal */
@@ -92,6 +97,7 @@ export const Budget$inboundSchema: z.ZodType<Budget, z.ZodTypeDef, unknown> = z
       new Date(v)
     ).optional(),
     usage: BudgetUsage$inboundSchema.optional(),
+    alerts: z.array(BudgetAlert$inboundSchema).optional(),
   }).transform((v) => {
     return remap$(v, {
       "budget_id": "budgetId",

package/packages/orq-rc/src/models/components/budgetalert.ts

@@ -0,0 +1,92 @@
+/*
+ * 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 {
+  BudgetAlertDimension,
+  BudgetAlertDimension$inboundSchema,
+  BudgetAlertDimension$outboundSchema,
+} from "./budgetalertdimension.js";
+
+/**
+ * Notifies every listed notifier once current-period consumption on
+ *
+ * @remarks
+ *  `dimension` reaches `threshold_percent` of the matching limit. Each alert
+ *  fires at most once per period, re-arming on rollover or a limit change.
+ *  The dimension must have a limit set, or the write is rejected.
+ */
+export type BudgetAlert = {
+  /**
+   * Assigned by ORQ. Supply an existing id to edit that alert in place.
+   */
+  id?: string | undefined;
+  /**
+   * Percentage of the dimension's limit at which the alert fires, 1–100.
+   */
+  thresholdPercent: number;
+  /**
+   * Must be workspace-scoped; project-scoped notifiers are rejected.
+   */
+  notifierIds: Array<string>;
+  dimension?: BudgetAlertDimension | undefined;
+};
+
+/** @internal */
+export const BudgetAlert$inboundSchema: z.ZodType<
+  BudgetAlert,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string().optional(),
+  threshold_percent: z.number().int(),
+  notifier_ids: z.array(z.string()),
+  dimension: BudgetAlertDimension$inboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "threshold_percent": "thresholdPercent",
+    "notifier_ids": "notifierIds",
+  });
+});
+/** @internal */
+export type BudgetAlert$Outbound = {
+  id?: string | undefined;
+  threshold_percent: number;
+  notifier_ids: Array<string>;
+  dimension?: string | undefined;
+};
+
+/** @internal */
+export const BudgetAlert$outboundSchema: z.ZodType<
+  BudgetAlert$Outbound,
+  z.ZodTypeDef,
+  BudgetAlert
+> = z.object({
+  id: z.string().optional(),
+  thresholdPercent: z.number().int(),
+  notifierIds: z.array(z.string()),
+  dimension: BudgetAlertDimension$outboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    thresholdPercent: "threshold_percent",
+    notifierIds: "notifier_ids",
+  });
+});
+
+export function budgetAlertToJSON(budgetAlert: BudgetAlert): string {
+  return JSON.stringify(BudgetAlert$outboundSchema.parse(budgetAlert));
+}
+export function budgetAlertFromJSON(
+  jsonString: string,
+): SafeParseResult<BudgetAlert, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BudgetAlert$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BudgetAlert' from JSON`,
+  );
+}

package/packages/orq-rc/src/models/components/budgetalertdimension.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const BudgetAlertDimension = {
+  BudgetAlertDimensionUnspecified: "BUDGET_ALERT_DIMENSION_UNSPECIFIED",
+  BudgetAlertDimensionCost: "BUDGET_ALERT_DIMENSION_COST",
+  BudgetAlertDimensionTokens: "BUDGET_ALERT_DIMENSION_TOKENS",
+} as const;
+export type BudgetAlertDimension = ClosedEnum<typeof BudgetAlertDimension>;
+
+/** @internal */
+export const BudgetAlertDimension$inboundSchema: z.ZodNativeEnum<
+  typeof BudgetAlertDimension
+> = z.nativeEnum(BudgetAlertDimension);
+/** @internal */
+export const BudgetAlertDimension$outboundSchema: z.ZodNativeEnum<
+  typeof BudgetAlertDimension
+> = BudgetAlertDimension$inboundSchema;

package/packages/orq-rc/src/models/components/config.ts

@@ -0,0 +1,44 @@
+/*
+ * 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 Config = {
+  allowFork: boolean;
+  allowVersionPin: boolean;
+  autoGrantNewProjects: boolean;
+  mode: string;
+  projectIds?: Array<string> | null | undefined;
+};
+
+/** @internal */
+export const Config$inboundSchema: z.ZodType<Config, z.ZodTypeDef, unknown> = z
+  .object({
+    allow_fork: z.boolean(),
+    allow_version_pin: z.boolean(),
+    auto_grant_new_projects: z.boolean(),
+    mode: z.string(),
+    project_ids: z.nullable(z.array(z.string())).optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "allow_fork": "allowFork",
+      "allow_version_pin": "allowVersionPin",
+      "auto_grant_new_projects": "autoGrantNewProjects",
+      "project_ids": "projectIds",
+    });
+  });
+
+export function configFromJSON(
+  jsonString: string,
+): SafeParseResult<Config, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Config$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Config' from JSON`,
+  );
+}

package/packages/orq-rc/src/models/components/createbudgetrequest.ts

@@ -4,6 +4,11 @@
 
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  BudgetAlert,
+  BudgetAlert$Outbound,
+  BudgetAlert$outboundSchema,
+} from "./budgetalert.js";
 import {
   BudgetLimits,
   BudgetLimits$Outbound,
@@ -68,6 +73,13 @@ export type CreateBudgetRequest = {
    *  the value MUST be in the future; the handler rejects past values.
    */
   expiresAt?: Date | undefined;
+  /**
+   * Optional threshold notifications. Ids are assigned by the server, so
+   *
+   * @remarks
+   *  `alerts[].id` must be omitted here; supplying one is rejected.
+   */
+  alerts?: Array<BudgetAlert> | undefined;
 };
 
 /** @internal */
@@ -78,6 +90,7 @@ export type CreateBudgetRequest$Outbound = {
   rate_limit?: RateLimit$Outbound | undefined;
   is_active?: boolean | undefined;
   expires_at?: string | undefined;
+  alerts?: Array<BudgetAlert$Outbound> | undefined;
 };
 
 /** @internal */
@@ -92,6 +105,7 @@ export const CreateBudgetRequest$outboundSchema: z.ZodType<
   rateLimit: RateLimit$outboundSchema.optional(),
   isActive: z.boolean().optional(),
   expiresAt: z.date().transform(v => v.toISOString()).optional(),
+  alerts: z.array(BudgetAlert$outboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
     rateLimit: "rate_limit",