@mutagent/sdk 0.2.142 → 0.4.0

package/dist/esm/tracing/span-manager.js

@@ -1,165 +0,0 @@
-/**
- * MutagenT SDK — Span Manager
- *
- * Manages span lifecycle, context propagation via AsyncLocalStorage,
- * and parent-child linking for traces.
- *
- * NOT generated by Speakeasy — manually maintained.
- */
-import { AsyncLocalStorage } from "node:async_hooks";
-import { randomUUID } from "node:crypto";
-const asyncLocalStorage = new AsyncLocalStorage();
-// ---------------------------------------------------------------------------
-// SpanManager
-// ---------------------------------------------------------------------------
-export class SpanManager {
-    constructor() {
-        this.activeSpans = new Map();
-        this.debugEnabled = false;
-    }
-    setOnSpanEnd(callback) {
-        this.onSpanEnd = callback;
-    }
-    setDebug(enabled) {
-        this.debugEnabled = enabled;
-    }
-    /**
-     * Start a new span. If no trace is active, a new trace ID is generated.
-     * The span is automatically linked as a child of the current span if one
-     * exists in the async context.
-     *
-     * Returns the created span. To execute code within the span's context,
-     * use `runInContext()`.
-     */
-    startSpan(options) {
-        const currentContext = asyncLocalStorage.getStore();
-        // Determine trace ID: reuse active trace or create new
-        const traceId = currentContext?.traceId ?? randomUUID();
-        // Determine parent: explicit option > current context > none
-        const parentSpanId = options.parentSpanId ?? currentContext?.span.id ?? undefined;
-        const spanId = randomUUID();
-        const span = {
-            id: spanId,
-            traceId,
-            parentSpanId,
-            kind: options.kind,
-            name: options.name ?? options.kind,
-            startedAt: new Date(),
-            input: options.input,
-            output: undefined,
-            status: "unset",
-            statusMessage: undefined,
-            metrics: {},
-            attributes: { ...options.attributes },
-            events: [],
-        };
-        this.activeSpans.set(spanId, span);
-        if (this.debugEnabled) {
-            console.debug(`[mutagent:trace] START span=${spanId} trace=${traceId} kind=${span.kind} name=${span.name}`);
-        }
-        return span;
-    }
-    /**
-     * Run a function within the async context of a span.
-     * This enables getCurrentSpan() / getCurrentTraceId() for nested calls.
-     */
-    runInContext(span, fn) {
-        const context = { span, traceId: span.traceId };
-        return asyncLocalStorage.run(context, fn);
-    }
-    /**
-     * End a span: compute duration, build FinishedSpan, remove from active set,
-     * and pass to the BatchCollector via the onSpanEnd callback.
-     */
-    endSpan(span, endOptions) {
-        const endTime = new Date();
-        const durationMs = endTime.getTime() - span.startedAt.getTime();
-        // Apply end options to span
-        if (endOptions?.status !== undefined) {
-            span.status = endOptions.status;
-        }
-        if (endOptions?.statusMessage !== undefined) {
-            span.statusMessage = endOptions.statusMessage;
-        }
-        if (endOptions?.output !== undefined) {
-            span.output = endOptions.output;
-        }
-        if (endOptions?.metrics !== undefined) {
-            Object.assign(span.metrics, endOptions.metrics);
-        }
-        if (endOptions?.attributes !== undefined) {
-            Object.assign(span.attributes, endOptions.attributes);
-        }
-        if (endOptions?.events !== undefined) {
-            span.events.push(...endOptions.events);
-        }
-        // Build serialized events
-        const serializedEvents = span.events.map((e) => ({
-            name: e.name,
-            timestamp: (e.timestamp ?? new Date()).toISOString(),
-            ...(e.attributes !== undefined ? { attributes: e.attributes } : {}),
-        }));
-        // Build FinishedSpan
-        const finished = {
-            spanId: span.id,
-            traceId: span.traceId,
-            parentSpanId: span.parentSpanId,
-            name: span.name,
-            kind: span.kind,
-            input: span.input,
-            output: span.output,
-            startTime: span.startedAt.toISOString(),
-            endTime: endTime.toISOString(),
-            durationMs,
-            model: span.metrics.model,
-            provider: span.metrics.provider,
-            inputTokens: span.metrics.inputTokens,
-            outputTokens: span.metrics.outputTokens,
-            totalTokens: span.metrics.totalTokens,
-            costUsd: span.metrics.costUsd,
-            status: span.status,
-            statusMessage: span.statusMessage,
-            attributes: span.attributes,
-            events: serializedEvents,
-            metadata: undefined,
-        };
-        // Remove from active set
-        this.activeSpans.delete(span.id);
-        if (this.debugEnabled) {
-            console.debug(`[mutagent:trace] END   span=${span.id} trace=${span.traceId} status=${finished.status} duration=${durationMs}ms`);
-        }
-        // Deliver to collector
-        this.onSpanEnd?.(finished);
-    }
-    /**
-     * Get the currently active span from async context.
-     */
-    getCurrentSpan() {
-        return asyncLocalStorage.getStore()?.span;
-    }
-    /**
-     * Get the currently active trace ID from async context.
-     */
-    getCurrentTraceId() {
-        return asyncLocalStorage.getStore()?.traceId;
-    }
-    /**
-     * Get an active span by ID.
-     */
-    getActiveSpan(spanId) {
-        return this.activeSpans.get(spanId);
-    }
-    /**
-     * Get count of active spans (useful for tests and debugging).
-     */
-    getActiveSpanCount() {
-        return this.activeSpans.size;
-    }
-    /**
-     * Clear all active spans (used during shutdown/reset).
-     */
-    clear() {
-        this.activeSpans.clear();
-    }
-}
-//# sourceMappingURL=span-manager.js.map

package/dist/esm/tracing/span-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"span-manager.js","sourceRoot":"","sources":["../../../src/tracing/span-manager.ts"],"names":[],"mappings":"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"}

package/dist/esm/tracing/types.d.ts

@@ -1,172 +0,0 @@
-/**
- * MutagenT SDK — Tracing Type Definitions
- *
- * These types define the tracing primitives for the MutagenT SDK.
- * They align with the server-side trace schema and OTel Gen AI conventions.
- *
- * NOT generated by Speakeasy — manually maintained.
- */
-export type SpanKind = "llm.chat" | "llm.completion" | "llm.embedding" | "chain" | "agent" | "graph" | "node" | "edge" | "workflow" | "middleware" | "tool" | "retrieval" | "rerank" | "guardrail" | "custom";
-export interface SpanIO {
-    /** Chat messages (most common for LLM spans) */
-    messages?: Array<{
-        role: "system" | "user" | "assistant" | "tool";
-        content: string;
-        name?: string;
-        toolCallId?: string;
-    }>;
-    /** Tool calls (for LLM spans that request tool use) */
-    toolCalls?: Array<{
-        id: string;
-        name: string;
-        arguments: Record<string, unknown>;
-        result?: unknown;
-    }>;
-    /** Retrieved documents (for retrieval spans) */
-    documents?: Array<{
-        content: string;
-        metadata?: Record<string, unknown>;
-        score?: number;
-    }>;
-    /** Raw text (for text completions, generic spans) */
-    text?: string;
-    /** Framework-specific raw data (escape hatch) */
-    raw?: unknown;
-}
-export type SpanStatus = "ok" | "error" | "unset";
-export interface SpanEvent {
-    name: string;
-    timestamp?: Date;
-    attributes?: Record<string, unknown>;
-}
-export interface SpanMetrics {
-    model?: string;
-    provider?: string;
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-    costUsd?: number;
-    latencyMs?: number;
-    ttftMs?: number;
-}
-export interface SpanOptions {
-    kind: SpanKind;
-    name?: string;
-    input?: SpanIO;
-    attributes?: Record<string, unknown>;
-    parentSpanId?: string;
-}
-export interface SpanEndOptions {
-    status?: SpanStatus;
-    statusMessage?: string;
-    output?: SpanIO;
-    metrics?: SpanMetrics;
-    attributes?: Record<string, unknown>;
-    events?: SpanEvent[];
-}
-export interface SpanHandle {
-    readonly spanId: string;
-    readonly traceId: string;
-    setAttributes(attrs: Record<string, unknown>): void;
-    addEvent(name: string, attributes?: Record<string, unknown>): void;
-    setOutput(output: SpanIO): void;
-    setInput(input: SpanIO): void;
-    setMetrics(metrics: SpanMetrics): void;
-}
-export interface MutagentSpan {
-    readonly id: string;
-    readonly traceId: string;
-    readonly parentSpanId: string | undefined;
-    readonly kind: SpanKind;
-    readonly name: string;
-    readonly startedAt: Date;
-    input: SpanIO | undefined;
-    output: SpanIO | undefined;
-    status: SpanStatus;
-    statusMessage: string | undefined;
-    metrics: SpanMetrics;
-    attributes: Record<string, unknown>;
-    events: SpanEvent[];
-}
-export interface FinishedSpan {
-    readonly spanId: string;
-    readonly traceId: string;
-    readonly parentSpanId: string | undefined;
-    readonly name: string;
-    readonly kind: SpanKind;
-    readonly input: SpanIO | undefined;
-    readonly output: SpanIO | undefined;
-    readonly startTime: string;
-    readonly endTime: string;
-    readonly durationMs: number;
-    readonly model: string | undefined;
-    readonly provider: string | undefined;
-    readonly inputTokens: number | undefined;
-    readonly outputTokens: number | undefined;
-    readonly totalTokens: number | undefined;
-    readonly costUsd: number | undefined;
-    readonly status: SpanStatus;
-    readonly statusMessage: string | undefined;
-    readonly attributes: Record<string, unknown>;
-    readonly events: SerializedSpanEvent[];
-    readonly metadata: Record<string, unknown> | undefined;
-}
-export interface SerializedSpanEvent {
-    readonly name: string;
-    readonly timestamp: string;
-    readonly attributes?: Record<string, unknown>;
-}
-export interface TracingConfig {
-    /** API key for authentication. Required. */
-    apiKey: string;
-    /** API endpoint URL. Defaults to 'https://api.mutagent.io'. */
-    endpoint?: string;
-    /** Environment name (e.g., 'production', 'staging', 'development'). */
-    environment?: string;
-    /** Number of spans to buffer before flushing. Default: 10. */
-    batchSize?: number;
-    /** Flush interval in milliseconds. Default: 5000. */
-    flushIntervalMs?: number;
-    /** Enable debug logging of span start/end to console. Default: false. */
-    debug?: boolean;
-    /** Source identifier for traces. Default: 'sdk'. */
-    source?: string;
-}
-export interface TracePayload {
-    traces: Array<{
-        traceId: string;
-        name?: string;
-        sessionId?: string;
-        source: string;
-        environment?: string;
-        startTime: string;
-        endTime?: string;
-        spans: Array<{
-            spanId: string;
-            parentSpanId?: string;
-            name: string;
-            kind: SpanKind;
-            input?: SpanIO;
-            output?: SpanIO;
-            startTime: string;
-            endTime: string;
-            durationMs: number;
-            model?: string;
-            provider?: string;
-            inputTokens?: number;
-            outputTokens?: number;
-            totalTokens?: number;
-            costUsd?: number;
-            status: SpanStatus;
-            statusMessage?: string;
-            attributes?: Record<string, unknown>;
-            events?: SerializedSpanEvent[];
-            metadata?: Record<string, unknown>;
-        }>;
-    }>;
-}
-export interface TraceHTTPResponse {
-    accepted: number;
-    rejected: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/esm/tracing/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tracing/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/tracing/types.js

@@ -1,10 +0,0 @@
-/**
- * MutagenT SDK — Tracing Type Definitions
- *
- * These types define the tracing primitives for the MutagenT SDK.
- * They align with the server-side trace schema and OTel Gen AI conventions.
- *
- * NOT generated by Speakeasy — manually maintained.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/esm/tracing/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tracing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/esm/tracing/wrappers.d.ts

@@ -1,45 +0,0 @@
-/**
- * MutagenT SDK -- withTrace Function Wrapper
- *
- * Wraps a function with a tracing span, providing a SpanHandle
- * for manual enrichment (attributes, events, output, metrics).
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import type { SpanKind, SpanHandle, SpanIO } from "./types.js";
-export interface WithTraceOptions {
-    kind: SpanKind;
-    name?: string;
-    input?: SpanIO;
-    attributes?: Record<string, unknown>;
-}
-/**
- * Wrap a function with a tracing span.
- *
- * The callback receives a SpanHandle for manual enrichment:
- * - `span.setAttributes(attrs)` -- add custom attributes
- * - `span.addEvent(name, attrs?)` -- record a lifecycle event
- * - `span.setOutput(output)` -- set structured output
- * - `span.setInput(input)` -- set/override structured input
- * - `span.setMetrics(metrics)` -- set token counts, cost, etc.
- *
- * Automatically sets:
- * - `status: 'ok'` on success
- * - `status: 'error'` on throw (re-throws the exception)
- *
- * No-op when tracing is not initialized (runs fn directly).
- *
- * Works with both sync and async functions.
- *
- * Usage:
- * ```ts
- * const result = await withTrace({ kind: 'chain', name: 'rag' }, async (span) => {
- *   span.setAttributes({ 'gen_ai.model': 'gpt-4' });
- *   const answer = await generate(query);
- *   span.setOutput({ text: answer });
- *   return answer;
- * });
- * ```
- */
-export declare function withTrace<T>(options: WithTraceOptions, fn: (span: SpanHandle) => T): T;
-//# sourceMappingURL=wrappers.d.ts.map

package/dist/esm/tracing/wrappers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wrappers.d.ts","sourceRoot":"","sources":["../../../src/tracing/wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,QAAQ,EAER,UAAU,EACV,MAAM,EAGP,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,gBAAgB,EACzB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAC1B,CAAC,CAiEH"}

package/dist/esm/tracing/wrappers.js

@@ -1,131 +0,0 @@
-/**
- * MutagenT SDK -- withTrace Function Wrapper
- *
- * Wraps a function with a tracing span, providing a SpanHandle
- * for manual enrichment (attributes, events, output, metrics).
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import { _getSpanManager } from "./init.js";
-// ---------------------------------------------------------------------------
-// SpanHandle implementation
-// ---------------------------------------------------------------------------
-class SpanHandleImpl {
-    constructor(span) {
-        this.spanId = span.id;
-        this.traceId = span.traceId;
-        this.span = span;
-    }
-    setAttributes(attrs) {
-        Object.assign(this.span.attributes, attrs);
-    }
-    addEvent(name, attributes) {
-        const event = {
-            name,
-            timestamp: new Date(),
-        };
-        if (attributes !== undefined) {
-            event.attributes = attributes;
-        }
-        this.span.events.push(event);
-    }
-    setOutput(output) {
-        this.span.output = output;
-    }
-    setInput(input) {
-        this.span.input = input;
-    }
-    setMetrics(metrics) {
-        Object.assign(this.span.metrics, metrics);
-    }
-}
-// ---------------------------------------------------------------------------
-// withTrace()
-// ---------------------------------------------------------------------------
-/**
- * Wrap a function with a tracing span.
- *
- * The callback receives a SpanHandle for manual enrichment:
- * - `span.setAttributes(attrs)` -- add custom attributes
- * - `span.addEvent(name, attrs?)` -- record a lifecycle event
- * - `span.setOutput(output)` -- set structured output
- * - `span.setInput(input)` -- set/override structured input
- * - `span.setMetrics(metrics)` -- set token counts, cost, etc.
- *
- * Automatically sets:
- * - `status: 'ok'` on success
- * - `status: 'error'` on throw (re-throws the exception)
- *
- * No-op when tracing is not initialized (runs fn directly).
- *
- * Works with both sync and async functions.
- *
- * Usage:
- * ```ts
- * const result = await withTrace({ kind: 'chain', name: 'rag' }, async (span) => {
- *   span.setAttributes({ 'gen_ai.model': 'gpt-4' });
- *   const answer = await generate(query);
- *   span.setOutput({ text: answer });
- *   return answer;
- * });
- * ```
- */
-export function withTrace(options, fn) {
-    const manager = _getSpanManager();
-    // No-op when tracing is not initialized
-    if (!manager) {
-        // Create a dummy handle so the function signature is satisfied
-        const dummyHandle = {
-            spanId: "",
-            traceId: "",
-            setAttributes() { },
-            addEvent() { },
-            setOutput() { },
-            setInput() { },
-            setMetrics() { },
-        };
-        return fn(dummyHandle);
-    }
-    const spanOptions = {
-        kind: options.kind,
-    };
-    if (options.name !== undefined)
-        spanOptions.name = options.name;
-    if (options.input !== undefined)
-        spanOptions.input = options.input;
-    if (options.attributes)
-        spanOptions.attributes = { ...options.attributes };
-    const span = manager.startSpan(spanOptions);
-    const handle = new SpanHandleImpl(span);
-    return manager.runInContext(span, () => {
-        try {
-            const result = fn(handle);
-            // Handle async
-            if (result instanceof Promise) {
-                return result.then((value) => {
-                    manager.endSpan(span, { status: "ok" });
-                    return value;
-                }, (error) => {
-                    const message = error instanceof Error ? error.message : String(error);
-                    manager.endSpan(span, {
-                        status: "error",
-                        statusMessage: message,
-                    });
-                    throw error;
-                });
-            }
-            // Sync
-            manager.endSpan(span, { status: "ok" });
-            return result;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            manager.endSpan(span, {
-                status: "error",
-                statusMessage: message,
-            });
-            throw error;
-        }
-    });
-}
-//# sourceMappingURL=wrappers.js.map

package/dist/esm/tracing/wrappers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wrappers.js","sourceRoot":"","sources":["../../../src/tracing/wrappers.ts"],"names":[],"mappings":"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"}