@mutagent/sdk 0.2.142 → 0.4.0

package/src/sdk/prompt-executions.ts

@@ -1,177 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { promptExecutionsCreateBatchPromptExecution } from "../funcs/prompt-executions-create-batch-prompt-execution.js";
-import { promptExecutionsCreatePromptExecution } from "../funcs/prompt-executions-create-prompt-execution.js";
-import { promptExecutionsDeletePlaygroundRun } from "../funcs/prompt-executions-delete-playground-run.js";
-import { promptExecutionsDeletePromptExecution } from "../funcs/prompt-executions-delete-prompt-execution.js";
-import { promptExecutionsExportPromptExecutions } from "../funcs/prompt-executions-export-prompt-executions.js";
-import { promptExecutionsGetPlaygroundRun } from "../funcs/prompt-executions-get-playground-run.js";
-import { promptExecutionsGetPromptExecution } from "../funcs/prompt-executions-get-prompt-execution.js";
-import { promptExecutionsListPlaygroundRuns } from "../funcs/prompt-executions-list-playground-runs.js";
-import { promptExecutionsListPromptExecutions } from "../funcs/prompt-executions-list-prompt-executions.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as models from "../models/index.js";
-import * as operations from "../models/operations/index.js";
-import { unwrapAsync } from "../types/fp.js";
-import { PageIterator, unwrapResultIterator } from "../types/operations.js";
-
-export class PromptExecutions extends ClientSDK {
-  /**
-   * List playground runs
-   *
-   * @remarks
-   * Get paginated list of playground runs with summary stats. Requires x-workspace-id header.
-   */
-  async listPlaygroundRuns(
-    request?: operations.ListPlaygroundRunsRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<
-    PageIterator<operations.ListPlaygroundRunsResponse, { offset: number }>
-  > {
-    return unwrapResultIterator(promptExecutionsListPlaygroundRuns(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get playground run with execution details
-   *
-   * @remarks
-   * Get a single playground run with all execution results. Requires x-workspace-id header.
-   */
-  async getPlaygroundRun(
-    request: operations.GetPlaygroundRunRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetPlaygroundRunResponse> {
-    return unwrapAsync(promptExecutionsGetPlaygroundRun(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete playground run
-   *
-   * @remarks
-   * Delete a playground run and all its execution results. Requires x-workspace-id header.
-   */
-  async deletePlaygroundRun(
-    request: operations.DeletePlaygroundRunRequest,
-    options?: RequestOptions,
-  ): Promise<operations.DeletePlaygroundRunResponse> {
-    return unwrapAsync(promptExecutionsDeletePlaygroundRun(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * List playground execution history
-   *
-   * @remarks
-   * Get paginated list of playground execution results with optional filtering. Requires x-workspace-id header.
-   */
-  async listPromptExecutions(
-    request?: operations.ListPromptExecutionsRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<
-    PageIterator<operations.ListPromptExecutionsResponse, { offset: number }>
-  > {
-    return unwrapResultIterator(promptExecutionsListPromptExecutions(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Create execution result
-   *
-   * @remarks
-   * Save a single playground execution result. Requires x-workspace-id header.
-   */
-  async createPromptExecution(
-    request: models.PromptIdInputsModel,
-    options?: RequestOptions,
-  ): Promise<models.IdPromptIdWorkspaceId> {
-    return unwrapAsync(promptExecutionsCreatePromptExecution(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Export execution history
-   *
-   * @remarks
-   * Export playground execution history as CSV or JSON. Requires x-workspace-id header.
-   */
-  async exportPromptExecutions(
-    request?: operations.ExportPromptExecutionsRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<operations.ExportPromptExecutionsResponse> {
-    return unwrapAsync(promptExecutionsExportPromptExecutions(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get execution by ID
-   *
-   * @remarks
-   * Get a single prompt execution result by ID. Requires x-workspace-id header.
-   */
-  async getPromptExecution(
-    request: operations.GetPromptExecutionRequest,
-    options?: RequestOptions,
-  ): Promise<models.IdPromptIdWorkspaceId> {
-    return unwrapAsync(promptExecutionsGetPromptExecution(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete execution
-   *
-   * @remarks
-   * Delete a single prompt execution result. Requires x-workspace-id header.
-   */
-  async deletePromptExecution(
-    request: operations.DeletePromptExecutionRequest,
-    options?: RequestOptions,
-  ): Promise<operations.DeletePromptExecutionResponse> {
-    return unwrapAsync(promptExecutionsDeletePromptExecution(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Create multi-model run
-   *
-   * @remarks
-   * Save multiple execution results with a shared run group UUID. Requires x-workspace-id header.
-   */
-  async createBatchPromptExecution(
-    request: models.PromptIdExecutions,
-    options?: RequestOptions,
-  ): Promise<operations.CreateBatchPromptExecutionResponse> {
-    return unwrapAsync(promptExecutionsCreateBatchPromptExecution(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/prompt-readiness.ts

@@ -1,27 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { promptReadinessGetPromptReadiness } from "../funcs/prompt-readiness-get-prompt-readiness.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as operations from "../models/operations/index.js";
-import { unwrapAsync } from "../types/fp.js";
-
-export class PromptReadiness extends ClientSDK {
-  /**
-   * Get pipeline readiness
-   *
-   * @remarks
-   * Get pipeline readiness state for a prompt group. Returns readiness for Playground, Experiments, and Optimizer stages based on artifact counts. Requires x-workspace-id header.
-   */
-  async getPromptReadiness(
-    request: operations.GetPromptReadinessRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetPromptReadinessResponse> {
-    return unwrapAsync(promptReadinessGetPromptReadiness(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/prompt.ts

@@ -1,189 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { promptCreatePromptVersion } from "../funcs/prompt-create-prompt-version.js";
-import { promptCreatePrompt } from "../funcs/prompt-create-prompt.js";
-import { promptDeletePrompt } from "../funcs/prompt-delete-prompt.js";
-import { promptGetPromptAnalytics } from "../funcs/prompt-get-prompt-analytics.js";
-import { promptGetPromptModelComparisons } from "../funcs/prompt-get-prompt-model-comparisons.js";
-import { promptGetPrompt } from "../funcs/prompt-get-prompt.js";
-import { promptListPromptTags } from "../funcs/prompt-list-prompt-tags.js";
-import { promptListPromptVersions } from "../funcs/prompt-list-prompt-versions.js";
-import { promptListPrompts } from "../funcs/prompt-list-prompts.js";
-import { promptUpdatePrompt } from "../funcs/prompt-update-prompt.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as models from "../models/index.js";
-import * as operations from "../models/operations/index.js";
-import { unwrapAsync } from "../types/fp.js";
-import { PageIterator, unwrapResultIterator } from "../types/operations.js";
-
-export class Prompt extends ClientSDK {
-  /**
-   * List prompts
-   *
-   * @remarks
-   * Get paginated list of prompts with optional filtering. Requires x-workspace-id header.
-   */
-  async listPrompts(
-    request?: operations.ListPromptsRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<PageIterator<operations.ListPromptsResponse, { offset: number }>> {
-    return unwrapResultIterator(promptListPrompts(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Create prompt
-   *
-   * @remarks
-   * Create a new prompt with versioning support. Requires x-workspace-id header.
-   */
-  async createPrompt(
-    request: models.NameDescriptionVersion,
-    options?: RequestOptions,
-  ): Promise<models.Prompt> {
-    return unwrapAsync(promptCreatePrompt(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * List distinct tags
-   *
-   * @remarks
-   * Get all distinct tags used across prompts in this workspace. Requires x-workspace-id header.
-   */
-  async listPromptTags(
-    options?: RequestOptions,
-  ): Promise<Array<string>> {
-    return unwrapAsync(promptListPromptTags(
-      this,
-      options,
-    ));
-  }
-
-  /**
-   * Get prompt
-   *
-   * @remarks
-   * Get a prompt by its ID. Requires x-workspace-id header.
-   */
-  async getPrompt(
-    request: operations.GetPromptRequest,
-    options?: RequestOptions,
-  ): Promise<models.Prompt> {
-    return unwrapAsync(promptGetPrompt(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Update prompt
-   *
-   * @remarks
-   * Update an existing prompt. Requires x-workspace-id header.
-   */
-  async updatePrompt(
-    request: operations.UpdatePromptRequest,
-    options?: RequestOptions,
-  ): Promise<models.Prompt> {
-    return unwrapAsync(promptUpdatePrompt(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete prompt
-   *
-   * @remarks
-   * Delete a prompt (use force=true to delete with datasets). Requires x-workspace-id header.
-   */
-  async deletePrompt(
-    request: operations.DeletePromptRequest,
-    options?: RequestOptions,
-  ): Promise<models.PromptSuccessResponse> {
-    return unwrapAsync(promptDeletePrompt(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Create version
-   *
-   * @remarks
-   * Create a new version of a prompt. Requires x-workspace-id header.
-   */
-  async createPromptVersion(
-    request: operations.CreatePromptVersionRequest,
-    options?: RequestOptions,
-  ): Promise<models.Prompt> {
-    return unwrapAsync(promptCreatePromptVersion(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * List all versions for a prompt group
-   *
-   * @remarks
-   * Get all versions of a prompt (sharing the same promptGroupId), ordered newest first. Requires x-workspace-id header.
-   */
-  async listPromptVersions(
-    request: operations.ListPromptVersionsRequest,
-    options?: RequestOptions,
-  ): Promise<operations.ListPromptVersionsResponse> {
-    return unwrapAsync(promptListPromptVersions(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get version analytics summary
-   *
-   * @remarks
-   * Get analytics summary for a prompt group including current version, accuracy, trend, and recent optimization. Requires x-workspace-id header.
-   */
-  async getPromptAnalytics(
-    request: operations.GetPromptAnalyticsRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetPromptAnalyticsResponse> {
-    return unwrapAsync(promptGetPromptAnalytics(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get model performance comparison
-   *
-   * @remarks
-   * Get aggregated metrics grouped by model for playground executions. Requires x-workspace-id header.
-   */
-  async getPromptModelComparisons(
-    request: operations.GetPromptModelComparisonsRequest,
-    options?: RequestOptions,
-  ): Promise<operations.GetPromptModelComparisonsResponse> {
-    return unwrapAsync(promptGetPromptModelComparisons(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/traces.ts

@@ -1,155 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { tracesDeleteTrace } from "../funcs/traces-delete-trace.js";
-import { tracesGetAnalyticsSummary } from "../funcs/traces-get-analytics-summary.js";
-import { tracesGetTraceStats } from "../funcs/traces-get-trace-stats.js";
-import { tracesGetTrace } from "../funcs/traces-get-trace.js";
-import { tracesIngestOtlp } from "../funcs/traces-ingest-otlp.js";
-import { tracesIngestTraceBatch } from "../funcs/traces-ingest-trace-batch.js";
-import { tracesIngestTrace } from "../funcs/traces-ingest-trace.js";
-import { tracesListTraces } from "../funcs/traces-list-traces.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as models from "../models/index.js";
-import * as operations from "../models/operations/index.js";
-import { unwrapAsync } from "../types/fp.js";
-import { PageIterator, unwrapResultIterator } from "../types/operations.js";
-
-export class Traces extends ClientSDK {
-  /**
-   * Ingest trace
-   *
-   * @remarks
-   * Ingest a single trace with spans from an integration package. Requires x-workspace-id header.
-   */
-  async ingestTrace(
-    request: models.TraceIdSessionIdName,
-    options?: RequestOptions,
-  ): Promise<models.TraceIngestionResponse> {
-    return unwrapAsync(tracesIngestTrace(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * List traces
-   *
-   * @remarks
-   * List traces with optional filtering by session, status, source, environment, and time range. Default response omits spans (use ?include=spans for back-compat). Requires x-workspace-id header.
-   */
-  async listTraces(
-    request?: operations.ListTracesRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<PageIterator<operations.ListTracesResponse, { offset: number }>> {
-    return unwrapResultIterator(tracesListTraces(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Batch ingest traces
-   *
-   * @remarks
-   * Ingest multiple traces at once (max 100). More efficient than single ingestion. Requires x-workspace-id header.
-   */
-  async ingestTraceBatch(
-    request: operations.IngestTraceBatchRequest,
-    options?: RequestOptions,
-  ): Promise<models.BatchIngestionResponse> {
-    return unwrapAsync(tracesIngestTraceBatch(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * OTLP trace ingestion
-   *
-   * @remarks
-   * Accepts OTLP/HTTP JSON (ExportTraceServiceRequest) and normalizes to MutagenT format. Requires x-workspace-id header.
-   */
-  async ingestOtlp(
-    request: operations.IngestOtlpRequest,
-    options?: RequestOptions,
-  ): Promise<models.BatchIngestionResponse> {
-    return unwrapAsync(tracesIngestOtlp(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get trace stats
-   *
-   * @remarks
-   * Get aggregated trace stats grouped by model, provider, kind, or source. Requires x-workspace-id header.
-   */
-  async getTraceStats(
-    request: operations.GetTraceStatsRequest,
-    options?: RequestOptions,
-  ): Promise<Array<models.TraceStats>> {
-    return unwrapAsync(tracesGetTraceStats(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get analytics summary
-   *
-   * @remarks
-   * Get pre-aggregated analytics data for the dashboard. Returns KPIs, cost breakdown, token usage, latency percentiles, error rates, efficiency metrics, and budget burndown — all computed server-side. Requires x-workspace-id header.
-   */
-  async getAnalyticsSummary(
-    request?: operations.GetAnalyticsSummaryRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<models.AnalyticsSummary> {
-    return unwrapAsync(tracesGetAnalyticsSummary(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Get trace
-   *
-   * @remarks
-   * Get a trace by ID with all its spans. Default response omits span input/output/attributes/events/metadata to cap memory on large traces — pass `?include=io` for the full legacy shape. Requires x-workspace-id header.
-   */
-  async getTrace(
-    request: operations.GetTraceRequest,
-    options?: RequestOptions,
-  ): Promise<models.TraceWithSpans> {
-    return unwrapAsync(tracesGetTrace(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete trace
-   *
-   * @remarks
-   * Delete a trace and all its spans. Requires x-workspace-id header.
-   */
-  async deleteTrace(
-    request: operations.DeleteTraceRequest,
-    options?: RequestOptions,
-  ): Promise<operations.DeleteTraceResponse> {
-    return unwrapAsync(tracesDeleteTrace(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/tracing/api.ts

@@ -1,63 +0,0 @@
-/**
- * MutagenT SDK -- Low-Level Tracing API
- *
- * Re-exports startSpan, endSpan, getCurrentSpan, getCurrentTraceId
- * from the global SpanManager singleton.
- *
- * These are the primitives used by integration adapters.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-
-import type { MutagentSpan, SpanOptions, SpanEndOptions } from "./types.js";
-import { _ensureTracing } from "./init.js";
-
-/**
- * Start a new span. If no trace is active, a new trace is created.
- * Returns the span, or undefined if tracing is not initialized.
- *
- * If tracing hasn't been initialized but the MUTAGENT_API_KEY
- * environment variable is set, tracing is automatically initialized.
- *
- * Use `runInSpanContext` to propagate the span to child calls.
- */
-export function startSpan(options: SpanOptions): MutagentSpan | undefined {
-  return _ensureTracing()?.startSpan(options);
-}
-
-/**
- * End a span, computing duration and delivering to the batch collector.
- * No-op if tracing is not initialized.
- */
-export function endSpan(span: MutagentSpan, endOptions?: SpanEndOptions): void {
-  _ensureTracing()?.endSpan(span, endOptions);
-}
-
-/**
- * Get the currently active span from async context.
- * Returns undefined if no span is active or tracing is not initialized.
- */
-export function getCurrentSpan(): MutagentSpan | undefined {
-  return _ensureTracing()?.getCurrentSpan();
-}
-
-/**
- * Get the currently active trace ID from async context.
- * Returns undefined if no trace is active or tracing is not initialized.
- */
-export function getCurrentTraceId(): string | undefined {
-  return _ensureTracing()?.getCurrentTraceId();
-}
-
-/**
- * Run a function within the async context of a span.
- * This enables getCurrentSpan() / getCurrentTraceId() for nested calls.
- * No-op passthrough if tracing is not initialized.
- */
-export function runInSpanContext<T>(span: MutagentSpan, fn: () => T): T {
-  const manager = _ensureTracing();
-  if (!manager) {
-    return fn();
-  }
-  return manager.runInContext(span, fn);
-}