@orq-ai/node 4.15.13 → 4.15.15

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

@@ -0,0 +1,174 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } 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 { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.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";
+
+/**
+ * Get trace conversation
+ *
+ * @remarks
+ * Return ordered OpenResponses items from the selected model-call span. Prefers spans with output outside evaluator subtrees unless `span_id` is given.
+ */
+export function tracesGetConversation(
+  client: OrqCore,
+  request: operations.TracesGetConversationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.GetTraceConversationResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request: operations.TracesGetConversationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.GetTraceConversationResponse,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.TracesGetConversationRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    trace_id: encodeSimple("trace_id", payload.trace_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/v3/traces/{trace_id}/conversation")(pathParams);
+
+  const query = encodeFormQuery({
+    "span_id": payload.span_id,
+  });
+
+  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: "TracesGetConversation",
+    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,
+    query: query,
+    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.GetTraceConversationResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.GetTraceConversationResponse$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/tracesListFilters.ts

@@ -0,0 +1,170 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeFormQuery } 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 * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List trace filters
+ *
+ * @remarks
+ * List the evaluators, human reviews and metadata keys a trace filter can address.
+ */
+export function tracesListFilters(
+  client: OrqCore,
+  request?: operations.TracesListFiltersRequest | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.ListTraceFiltersResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request?: operations.TracesListFiltersRequest | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.ListTraceFiltersResponse,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.TracesListFiltersRequest$outboundSchema.optional().parse(
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/v3/traces/filters")();
+
+  const query = encodeFormQuery({
+    "include_all": payload?.include_all,
+  });
+
+  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: "TracesListFilters",
+    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,
+    query: query,
+    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.ListTraceFiltersResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.ListTraceFiltersResponse$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/tracesQuery.ts

@@ -29,7 +29,7 @@ import { Result } from "../types/fp.js";
  * Query traces with OQL
  *
  * @remarks
- * Run an OQL trace query. OQL is validated against the trace field registry and compiled through the trace planner.
+ * Run an OQL trace query over a time range. OQL selects the traces to return.
  */
 export function tracesQuery(
   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.16.0-rc.20",
-  genVersion: "2.941.0",
-  userAgent: "speakeasy-sdk/typescript 4.16.0-rc.20 2.941.0 2.0 @orq-ai/node",
+  sdkVersion: "4.16.0-rc.41",
+  genVersion: "2.943.0",
+  userAgent: "speakeasy-sdk/typescript 4.16.0-rc.41 2.943.0 2.0 @orq-ai/node",
 } as const;

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

@@ -23,6 +23,10 @@ export type AggregateTracesRequest = {
   compute?: Array<TraceCompute> | undefined;
   limit?: number | undefined;
   filterOperator?: string | undefined;
+  /**
+   * Free-text search with the same matching as SearchTracesRequest.query.
+   */
+  query?: string | undefined;
 };
 
 /** @internal */
@@ -34,6 +38,7 @@ export type AggregateTracesRequest$Outbound = {
   compute?: Array<TraceCompute$Outbound> | undefined;
   limit?: number | undefined;
   filter_operator?: string | undefined;
+  query?: string | undefined;
 };
 
 /** @internal */
@@ -49,6 +54,7 @@ export const AggregateTracesRequest$outboundSchema: z.ZodType<
   compute: z.array(TraceCompute$outboundSchema).optional(),
   limit: z.number().int().optional(),
   filterOperator: z.string().optional(),
+  query: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     groupBy: "group_by",

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

@@ -95,9 +95,9 @@ export type Alert = {
    */
   status: AlertStatus;
   /**
-   * Time when the alert last opened a trigger.
+   * Time when the alert last opened a trigger. `null` until the alert first triggers.
    */
-  lastTriggeredAt?: Date | undefined;
+  lastTriggeredAt?: Date | null | undefined;
   /**
    * Rolling window of the most recent evaluation ticks, oldest first.
    *
@@ -122,9 +122,9 @@ export type Alert = {
    */
   updatedById: string;
   /**
-   * Display options for the alert activity chart.
+   * Display options for the alert activity chart. `null` when none are saved.
    */
-  display?: AlertDisplay | undefined;
+  display?: AlertDisplay | null | undefined;
 };
 
 /** @internal */
@@ -148,8 +148,8 @@ export const Alert$inboundSchema: z.ZodType<Alert, z.ZodTypeDef, unknown> = z
     notifier_ids: z.array(z.string()),
     enabled: z.boolean(),
     status: AlertStatus$inboundSchema,
-    last_triggered_at: z.string().datetime({ offset: true }).transform(v =>
-      new Date(v)
+    last_triggered_at: z.nullable(
+      z.string().datetime({ offset: true }).transform(v => new Date(v)),
     ).optional(),
     recent_runs: z.array(AlertRun$inboundSchema).optional(),
     created_at: z.string().datetime({ offset: true }).transform(v =>
@@ -160,7 +160,7 @@ export const Alert$inboundSchema: z.ZodType<Alert, z.ZodTypeDef, unknown> = z
     ),
     created_by_id: z.string(),
     updated_by_id: z.string(),
-    display: AlertDisplay$inboundSchema.optional(),
+    display: z.nullable(AlertDisplay$inboundSchema).optional(),
   }).transform((v) => {
     return remap$(v, {
       "alert_id": "alertId",

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

@@ -75,9 +75,9 @@ export type AlertTrigger = {
    */
   openedAt: Date;
   /**
-   * Time when the value recovered. Unset while the trigger is open.
+   * Time when the value recovered. `null` while the trigger is open.
    */
-  resolvedAt?: Date | undefined;
+  resolvedAt?: Date | null | undefined;
   /**
    * Worst observed value while the trigger was open.
    */
@@ -119,8 +119,9 @@ export const AlertTrigger$inboundSchema: z.ZodType<
   severity: AlertTriggerSeverity$inboundSchema.optional(),
   peak_severity: PeakSeverity$inboundSchema.optional(),
   opened_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
-  resolved_at: z.string().datetime({ offset: true }).transform(v => new Date(v))
-    .optional(),
+  resolved_at: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
   peak_value: z.number(),
   last_value: z.number(),
   event_count: z.number().int(),

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

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type AllProjectsScope = {};
+
+/** @internal */
+export type AllProjectsScope$Outbound = {};
+
+/** @internal */
+export const AllProjectsScope$outboundSchema: z.ZodType<
+  AllProjectsScope$Outbound,
+  z.ZodTypeDef,
+  AllProjectsScope
+> = z.object({});
+
+export function allProjectsScopeToJSON(
+  allProjectsScope: AllProjectsScope,
+): string {
+  return JSON.stringify(
+    AllProjectsScope$outboundSchema.parse(allProjectsScope),
+  );
+}

package/packages/orq-rc/src/models/components/annotationfilter.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";
+
+export type AnnotationFilter = {
+  id?: string | undefined;
+  displayName?: string | undefined;
+  type?: string | undefined;
+  optionValues?: Array<string> | undefined;
+};
+
+/** @internal */
+export const AnnotationFilter$inboundSchema: z.ZodType<
+  AnnotationFilter,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string().optional(),
+  display_name: z.string().optional(),
+  type: z.string().optional(),
+  option_values: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "display_name": "displayName",
+    "option_values": "optionValues",
+  });
+});
+
+export function annotationFilterFromJSON(
+  jsonString: string,
+): SafeParseResult<AnnotationFilter, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AnnotationFilter$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AnnotationFilter' from JSON`,
+  );
+}

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

@@ -24,12 +24,10 @@ export type BudgetLimits = {
   period?: BudgetPeriod | undefined;
   amount?: number | undefined;
   /**
-   * Token ceiling. Carried as a double so it serializes as a JSON number
+   * Token ceiling for the budget period. Token counts are whole numbers
    *
    * @remarks
-   *  (proto int64 would serialize as a quoted string); token counts are
-   *  whole and well within double's exact-integer range (2^53). Stored as
-   *  an integer server-side.
+   *  and stored as integers.
    */
   tokenLimit?: number | undefined;
 };

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

@@ -19,12 +19,10 @@ export type BudgetLimitsRestResponse = {
   period?: BudgetPeriod | undefined;
   amount?: number | undefined;
   /**
-   * Token ceiling. Carried as a double so it serializes as a JSON number
+   * Token ceiling for the budget period. Token counts are whole numbers
    *
    * @remarks
-   *  (proto int64 would serialize as a quoted string); token counts are
-   *  whole and well within double's exact-integer range (2^53). Stored as
-   *  an integer server-side.
+   *  and stored as integers.
    */
   tokenLimit?: number | undefined;
 };

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

@@ -31,23 +31,22 @@ import {
 export type BudgetRestResponse = {
   budgetId: string;
   /**
-   * Denormalized metadata for UI rendering, list filters, and the
+   * Scope the budget was created for, used to group and filter budgets in
    *
    * @remarks
-   *  resolver's prefilter index. Never consulted for matching — the
-   *  `match` expression is the single source of matching semantics.
-   *  Unset for budgets created from a raw CEL expression ("custom").
+   *  the console. Not used for matching: the `match` expression decides
+   *  which requests a budget applies to. Unset for budgets created from a
+   *  raw CEL expression ("custom").
    */
   scope?: BudgetScopeRestResponse | undefined;
   /**
-   * The matching semantics of the budget. The enforcement resolver
+   * The matching semantics of the budget. A budget applies to a request
    *
    * @remarks
-   *  evaluates `match.cel` against the request context; a budget
-   *  applies to a request if and only if the expression evaluates to
-   *  true. Scoped creates derive a canonical expression (e.g.
-   *  `provider == "openai"`); an empty expression always matches
-   *  (workspace-wide).
+   *  when `match.cel` evaluates to true against the request context.
+   *  Creating a budget for a scope derives the expression for that scope
+   *  (e.g. `provider == "openai"`); an empty expression matches every
+   *  request in the workspace.
    */
   match?: BudgetMatch | undefined;
   /**
@@ -59,10 +58,10 @@ export type BudgetRestResponse = {
    */
   limits: BudgetLimitsRestResponse;
   /**
-   * RateLimit is the per-minute request ceiling. Enforced via atomic
+   * Per-minute request ceiling applied to the requests this budget
    *
    * @remarks
-   *  increment-first semantics in the enforcement middleware.
+   *  matches.
    */
   rateLimit?: RateLimitRestResponse | undefined;
   isActive: boolean;

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

@@ -82,7 +82,7 @@ export type BudgetScope = {
    *
    * @remarks
    *  it ("openai/gpt-4o", or "workspaceKey@openai/gpt-4o" for private
-   *  models), rather than an internal identifier.
+   *  models).
    */
   model?: ModelBudgetScope | undefined;
 };

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

@@ -69,7 +69,7 @@ export type BudgetScopeRestResponse = {
    *
    * @remarks
    *  it ("openai/gpt-4o", or "workspaceKey@openai/gpt-4o" for private
-   *  models), rather than an internal identifier.
+   *  models).
    */
   model?: ModelBudgetScopeRestResponse | undefined;
 };

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

@@ -10,11 +10,16 @@ export type CreateDatasetRequest = {
    * Human-readable dataset name.
    */
   displayName: string;
+  /**
+   * Project path where the dataset should be stored, in the format `project/folder/subfolder`. With a project-scoped API key the path is relative to that project. Omit to use the API key project or the workspace default project.
+   */
+  path?: string | undefined;
 };
 
 /** @internal */
 export type CreateDatasetRequest$Outbound = {
   display_name: string;
+  path?: string | undefined;
 };
 
 /** @internal */
@@ -24,6 +29,7 @@ export const CreateDatasetRequest$outboundSchema: z.ZodType<
   CreateDatasetRequest
 > = z.object({
   displayName: z.string(),
+  path: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     displayName: "display_name",