@mutagent/sdk 0.2.13

package/src/models/paginated-trace-list.ts

@@ -0,0 +1,402 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+/**
+ * Source integration that produced this trace
+ */
+export enum PaginatedTraceListSource {
+  SDK = "sdk",
+  Langchain = "langchain",
+  Langgraph = "langgraph",
+  VercelAi = "vercel-ai",
+  Openai = "openai",
+  Otel = "otel",
+  Manual = "manual",
+}
+/**
+ * Source integration that produced this trace
+ */
+export type PaginatedTraceListSourceOpen = OpenEnum<
+  typeof PaginatedTraceListSource
+>;
+
+/**
+ * Environment where the trace was captured
+ */
+export enum PaginatedTraceListEnvironment {
+  Production = "production",
+  Staging = "staging",
+  Development = "development",
+}
+/**
+ * Environment where the trace was captured
+ */
+export type PaginatedTraceListEnvironmentOpen = OpenEnum<
+  typeof PaginatedTraceListEnvironment
+>;
+
+export type PaginatedTraceListMetadata = {};
+
+/**
+ * Kind of span operation (OTel Gen AI aligned)
+ */
+export enum PaginatedTraceListKind {
+  LlmChat = "llm.chat",
+  LlmCompletion = "llm.completion",
+  LlmEmbedding = "llm.embedding",
+  Chain = "chain",
+  Agent = "agent",
+  Graph = "graph",
+  Node = "node",
+  Edge = "edge",
+  Workflow = "workflow",
+  Middleware = "middleware",
+  Retrieval = "retrieval",
+  Rerank = "rerank",
+  Tool = "tool",
+  Guardrail = "guardrail",
+  Custom = "custom",
+}
+/**
+ * Kind of span operation (OTel Gen AI aligned)
+ */
+export type PaginatedTraceListKindOpen = OpenEnum<
+  typeof PaginatedTraceListKind
+>;
+
+export type PaginatedTraceListAttributes = {};
+
+/**
+ * Event attributes
+ */
+export type PaginatedTraceListEventAttributes = {};
+
+/**
+ * Lifecycle event within a span
+ */
+export type PaginatedTraceListEvent = {
+  /**
+   * Event name
+   */
+  name: string;
+  /**
+   * Event timestamp (ISO 8601)
+   */
+  timestamp: Date;
+  /**
+   * Event attributes
+   */
+  attributes?: PaginatedTraceListEventAttributes | undefined;
+};
+
+export type PaginatedTraceListSpanMetadata = {};
+
+export type PaginatedTraceListSpan = {
+  id: string;
+  traceId: string;
+  parentSpanId: string | null;
+  name: string;
+  /**
+   * Kind of span operation (OTel Gen AI aligned)
+   */
+  kind: PaginatedTraceListKindOpen;
+  input: any | null;
+  output: any | null;
+  startTime: Date;
+  endTime: Date | null;
+  durationMs: number | null;
+  inputTokens: number | null;
+  outputTokens: number | null;
+  totalTokens: number | null;
+  model: string | null;
+  provider: string | null;
+  costUsd: string | null;
+  latencyMs: number | null;
+  ttftMs: number | null;
+  status: string;
+  statusMessage: string | null;
+  error: string | null;
+  attributes: PaginatedTraceListAttributes | null;
+  events: Array<PaginatedTraceListEvent> | null;
+  metadata: PaginatedTraceListSpanMetadata | null;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type PaginatedTraceListData = {
+  id: string;
+  workspaceId: string;
+  sessionId: string | null;
+  name: string | null;
+  /**
+   * Source integration that produced this trace
+   */
+  source: PaginatedTraceListSourceOpen;
+  /**
+   * Environment where the trace was captured
+   */
+  environment: PaginatedTraceListEnvironmentOpen | null;
+  tags: Array<string> | null;
+  metadata: PaginatedTraceListMetadata | null;
+  startTime: Date;
+  endTime: Date | null;
+  durationMs: number | null;
+  totalInputTokens: number | null;
+  totalOutputTokens: number | null;
+  totalSpans: number | null;
+  totalCostUsd: string | null;
+  status: string;
+  error: string | null;
+  createdAt: Date;
+  updatedAt: Date;
+  spans: Array<PaginatedTraceListSpan>;
+};
+
+export type PaginatedTraceList = {
+  data: Array<PaginatedTraceListData>;
+  /**
+   * Total number of traces matching filters
+   */
+  total: number;
+  /**
+   * Page size
+   */
+  limit: number;
+  /**
+   * Current offset
+   */
+  offset: number;
+};
+
+/** @internal */
+export const PaginatedTraceListSource$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListSourceOpen,
+  unknown
+> = openEnums.inboundSchema(PaginatedTraceListSource);
+
+/** @internal */
+export const PaginatedTraceListEnvironment$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListEnvironmentOpen,
+  unknown
+> = openEnums.inboundSchema(PaginatedTraceListEnvironment);
+
+/** @internal */
+export const PaginatedTraceListMetadata$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListMetadata,
+  unknown
+> = z.object({});
+
+export function paginatedTraceListMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListMetadata' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListKind$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListKindOpen,
+  unknown
+> = openEnums.inboundSchema(PaginatedTraceListKind);
+
+/** @internal */
+export const PaginatedTraceListAttributes$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListAttributes,
+  unknown
+> = z.object({});
+
+export function paginatedTraceListAttributesFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListAttributes, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListAttributes$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListAttributes' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListEventAttributes$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListEventAttributes,
+  unknown
+> = z.object({});
+
+export function paginatedTraceListEventAttributesFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListEventAttributes, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListEventAttributes$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListEventAttributes' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListEvent$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListEvent,
+  unknown
+> = z.object({
+  name: types.string(),
+  timestamp: types.date(),
+  attributes: types.optional(
+    z.lazy(() => PaginatedTraceListEventAttributes$inboundSchema),
+  ),
+});
+
+export function paginatedTraceListEventFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListEvent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListEvent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListEvent' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListSpanMetadata$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListSpanMetadata,
+  unknown
+> = z.object({});
+
+export function paginatedTraceListSpanMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListSpanMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListSpanMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListSpanMetadata' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListSpan$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListSpan,
+  unknown
+> = z.object({
+  id: types.string(),
+  traceId: types.string(),
+  parentSpanId: types.nullable(types.string()),
+  name: types.string(),
+  kind: z._default(
+    PaginatedTraceListKind$inboundSchema,
+    PaginatedTraceListKind.LlmChat,
+  ),
+  input: types.nullable(z.any()),
+  output: types.nullable(z.any()),
+  startTime: types.date(),
+  endTime: types.nullable(types.date()),
+  durationMs: types.nullable(types.number()),
+  inputTokens: types.nullable(types.number()),
+  outputTokens: types.nullable(types.number()),
+  totalTokens: types.nullable(types.number()),
+  model: types.nullable(types.string()),
+  provider: types.nullable(types.string()),
+  costUsd: types.nullable(types.string()),
+  latencyMs: types.nullable(types.number()),
+  ttftMs: types.nullable(types.number()),
+  status: types.string(),
+  statusMessage: types.nullable(types.string()),
+  error: types.nullable(types.string()),
+  attributes: types.nullable(
+    z.lazy(() => PaginatedTraceListAttributes$inboundSchema),
+  ),
+  events: types.nullable(
+    z.array(z.lazy(() => PaginatedTraceListEvent$inboundSchema)),
+  ),
+  metadata: types.nullable(
+    z.lazy(() => PaginatedTraceListSpanMetadata$inboundSchema),
+  ),
+  createdAt: types.date(),
+  updatedAt: types.date(),
+});
+
+export function paginatedTraceListSpanFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListSpan, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListSpan$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListSpan' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceListData$inboundSchema: z.ZodMiniType<
+  PaginatedTraceListData,
+  unknown
+> = z.object({
+  id: types.string(),
+  workspaceId: types.string(),
+  sessionId: types.nullable(types.string()),
+  name: types.nullable(types.string()),
+  source: z._default(
+    PaginatedTraceListSource$inboundSchema,
+    PaginatedTraceListSource.SDK,
+  ),
+  environment: z.nullable(
+    z._default(
+      PaginatedTraceListEnvironment$inboundSchema,
+      PaginatedTraceListEnvironment.Production,
+    ),
+  ),
+  tags: types.nullable(z.array(types.string())),
+  metadata: types.nullable(
+    z.lazy(() => PaginatedTraceListMetadata$inboundSchema),
+  ),
+  startTime: types.date(),
+  endTime: types.nullable(types.date()),
+  durationMs: types.nullable(types.number()),
+  totalInputTokens: types.nullable(types.number()),
+  totalOutputTokens: types.nullable(types.number()),
+  totalSpans: types.nullable(types.number()),
+  totalCostUsd: types.nullable(types.string()),
+  status: types.string(),
+  error: types.nullable(types.string()),
+  createdAt: types.date(),
+  updatedAt: types.date(),
+  spans: z.array(z.lazy(() => PaginatedTraceListSpan$inboundSchema)),
+});
+
+export function paginatedTraceListDataFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceListData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceListData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceListData' from JSON`,
+  );
+}
+
+/** @internal */
+export const PaginatedTraceList$inboundSchema: z.ZodMiniType<
+  PaginatedTraceList,
+  unknown
+> = z.object({
+  data: z.array(z.lazy(() => PaginatedTraceListData$inboundSchema)),
+  total: types.number(),
+  limit: types.number(),
+  offset: types.number(),
+});
+
+export function paginatedTraceListFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedTraceList, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedTraceList$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedTraceList' from JSON`,
+  );
+}

package/src/models/prompt-dataset-export.ts

@@ -0,0 +1,228 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+/**
+ * Test dataset object with metadata and configuration
+ */
+export type PromptDatasetExportDataset = {
+  /**
+   * Unique dataset identifier
+   */
+  id: number;
+  /**
+   * Dataset name
+   */
+  name: string;
+  /**
+   * Dataset description
+   */
+  description: string | null;
+  /**
+   * UUID of the prompt family this dataset tests (cache this for performance)
+   */
+  promptGroupId: string;
+  /**
+   * Arbitrary metadata object
+   */
+  metadata: any;
+  /**
+   * Creation timestamp
+   */
+  createdAt: Date | null;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: Date | null;
+  /**
+   * Creator email
+   */
+  createdBy: string | null;
+  /**
+   * ML-style labels for categorization
+   */
+  labels: Array<string> | null;
+};
+
+export type PromptGroup = {
+  /**
+   * UUID of the prompt family this dataset belongs to
+   */
+  promptGroupId: string;
+  /**
+   * Latest prompt version in this group
+   */
+  latestPrompt: any;
+  /**
+   * Total number of prompt versions in this group
+   */
+  totalVersions: number;
+};
+
+/**
+ * Test case item with input/output data and feedback
+ */
+export type PromptDatasetExportItem = {
+  /**
+   * Unique item identifier
+   */
+  id: number;
+  /**
+   * Parent dataset ID
+   */
+  datasetId: number;
+  /**
+   * Test case name
+   */
+  name: string | null;
+  /**
+   * Input variables as JSON object
+   */
+  input: any;
+  /**
+   * Expected output as JSON object
+   */
+  expectedOutput: any;
+  /**
+   * Human feedback
+   */
+  userFeedback: string | null;
+  /**
+   * Automated feedback
+   */
+  systemFeedback: string | null;
+  /**
+   * Test case labels
+   */
+  labels: Array<string> | null;
+  /**
+   * Arbitrary metadata
+   */
+  metadata: any;
+  /**
+   * Creation timestamp
+   */
+  createdAt: Date | null;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: Date | null;
+};
+
+/**
+ * Full dataset export with metadata and all items
+ */
+export type PromptDatasetExport = {
+  /**
+   * Test dataset object with metadata and configuration
+   */
+  dataset: PromptDatasetExportDataset;
+  promptGroup: PromptGroup;
+  /**
+   * All items in the dataset
+   */
+  items: Array<PromptDatasetExportItem>;
+  /**
+   * Export timestamp
+   */
+  exportedAt: Date;
+};
+
+/** @internal */
+export const PromptDatasetExportDataset$inboundSchema: z.ZodMiniType<
+  PromptDatasetExportDataset,
+  unknown
+> = z.object({
+  id: types.number(),
+  name: types.string(),
+  description: types.nullable(types.string()),
+  promptGroupId: types.string(),
+  metadata: z.any(),
+  createdAt: types.nullable(types.date()),
+  updatedAt: types.nullable(types.date()),
+  createdBy: types.nullable(types.string()),
+  labels: types.nullable(z.array(types.string())),
+});
+
+export function promptDatasetExportDatasetFromJSON(
+  jsonString: string,
+): SafeParseResult<PromptDatasetExportDataset, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PromptDatasetExportDataset$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PromptDatasetExportDataset' from JSON`,
+  );
+}
+
+/** @internal */
+export const PromptGroup$inboundSchema: z.ZodMiniType<PromptGroup, unknown> = z
+  .object({
+    promptGroupId: types.string(),
+    latestPrompt: z.any(),
+    totalVersions: types.number(),
+  });
+
+export function promptGroupFromJSON(
+  jsonString: string,
+): SafeParseResult<PromptGroup, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PromptGroup$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PromptGroup' from JSON`,
+  );
+}
+
+/** @internal */
+export const PromptDatasetExportItem$inboundSchema: z.ZodMiniType<
+  PromptDatasetExportItem,
+  unknown
+> = z.object({
+  id: types.number(),
+  datasetId: types.number(),
+  name: types.nullable(types.string()),
+  input: z.any(),
+  expectedOutput: z.any(),
+  userFeedback: types.nullable(types.string()),
+  systemFeedback: types.nullable(types.string()),
+  labels: types.nullable(z.array(types.string())),
+  metadata: z.any(),
+  createdAt: types.nullable(types.date()),
+  updatedAt: types.nullable(types.date()),
+});
+
+export function promptDatasetExportItemFromJSON(
+  jsonString: string,
+): SafeParseResult<PromptDatasetExportItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PromptDatasetExportItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PromptDatasetExportItem' from JSON`,
+  );
+}
+
+/** @internal */
+export const PromptDatasetExport$inboundSchema: z.ZodMiniType<
+  PromptDatasetExport,
+  unknown
+> = z.object({
+  dataset: z.lazy(() => PromptDatasetExportDataset$inboundSchema),
+  promptGroup: z.lazy(() => PromptGroup$inboundSchema),
+  items: z.array(z.lazy(() => PromptDatasetExportItem$inboundSchema)),
+  exportedAt: types.date(),
+});
+
+export function promptDatasetExportFromJSON(
+  jsonString: string,
+): SafeParseResult<PromptDatasetExport, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PromptDatasetExport$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PromptDatasetExport' from JSON`,
+  );
+}

package/src/models/prompt-dataset-item.ts

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+/**
+ * Test case item with input/output data and feedback
+ */
+export type PromptDatasetItem = {
+  /**
+   * Unique item identifier
+   */
+  id: number;
+  /**
+   * Parent dataset ID
+   */
+  datasetId: number;
+  /**
+   * Test case name
+   */
+  name: string | null;
+  /**
+   * Input variables as JSON object
+   */
+  input: any;
+  /**
+   * Expected output as JSON object
+   */
+  expectedOutput: any;
+  /**
+   * Human feedback
+   */
+  userFeedback: string | null;
+  /**
+   * Automated feedback
+   */
+  systemFeedback: string | null;
+  /**
+   * Test case labels
+   */
+  labels: Array<string> | null;
+  /**
+   * Arbitrary metadata
+   */
+  metadata: any;
+  /**
+   * Creation timestamp
+   */
+  createdAt: Date | null;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: Date | null;
+};
+
+/** @internal */
+export const PromptDatasetItem$inboundSchema: z.ZodMiniType<
+  PromptDatasetItem,
+  unknown
+> = z.object({
+  id: types.number(),
+  datasetId: types.number(),
+  name: types.nullable(types.string()),
+  input: z.any(),
+  expectedOutput: z.any(),
+  userFeedback: types.nullable(types.string()),
+  systemFeedback: types.nullable(types.string()),
+  labels: types.nullable(z.array(types.string())),
+  metadata: z.any(),
+  createdAt: types.nullable(types.date()),
+  updatedAt: types.nullable(types.date()),
+});
+
+export function promptDatasetItemFromJSON(
+  jsonString: string,
+): SafeParseResult<PromptDatasetItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PromptDatasetItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PromptDatasetItem' from JSON`,
+  );
+}