@mutagent/sdk 0.2.40 → 0.2.42

package/dist/esm/tracing/batch-collector.d.ts

@@ -1,59 +0,0 @@
-/**
- * MutagenT SDK -- Batch Collector
- *
- * Buffers finished spans in memory and flushes them to the trace HTTP client
- * when either the batch size threshold or the flush interval is reached.
- *
- * Retry with exponential backoff on failure.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import type { FinishedSpan } from "./types.js";
-import type { TraceHTTPClient } from "./http-client.js";
-export interface BatchCollectorConfig {
-    httpClient: TraceHTTPClient;
-    /** Number of spans to buffer before auto-flushing. Default: 10. */
-    batchSize?: number;
-    /** Flush interval in milliseconds. Default: 5000. */
-    flushIntervalMs?: number;
-    /** Source identifier for traces. Default: 'sdk'. */
-    source?: string;
-    /** Environment name. */
-    environment?: string;
-    /** Max retries on flush failure. Default: 3. */
-    maxRetries?: number;
-    /** Base delay in ms for exponential backoff. Default: 1000. */
-    retryBaseDelayMs?: number;
-}
-export declare class BatchCollector {
-    private readonly httpClient;
-    private readonly batchSize;
-    private readonly flushIntervalMs;
-    private readonly source;
-    private readonly environment;
-    private readonly maxRetries;
-    private readonly retryBaseDelayMs;
-    private buffer;
-    private timer;
-    private flushing;
-    constructor(config: BatchCollectorConfig);
-    /**
-     * Add a finished span to the buffer.
-     * If the buffer reaches batchSize, triggers an async flush.
-     */
-    add(span: FinishedSpan): void;
-    /**
-     * Flush all buffered spans to the HTTP client.
-     * Groups spans by traceId into the TracePayload format.
-     * Retries with exponential backoff on failure.
-     */
-    flush(): Promise<void>;
-    /**
-     * Shutdown: flush remaining spans, clear interval timer.
-     */
-    shutdown(): Promise<void>;
-    private buildPayload;
-    private sendWithRetry;
-    private sleep;
-}
-//# sourceMappingURL=batch-collector.d.ts.map

package/dist/esm/tracing/batch-collector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"batch-collector.d.ts","sourceRoot":"","sources":["../../../src/tracing/batch-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,eAAe,CAAC;IAC5B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,oBAAoB;IAoBxC;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAQ7B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B,OAAO,CAAC,YAAY;YA0DN,aAAa;IAmB3B,OAAO,CAAC,KAAK;CAGd"}

package/dist/esm/tracing/batch-collector.js

@@ -1,167 +0,0 @@
-/**
- * MutagenT SDK -- Batch Collector
- *
- * Buffers finished spans in memory and flushes them to the trace HTTP client
- * when either the batch size threshold or the flush interval is reached.
- *
- * Retry with exponential backoff on failure.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-// ---------------------------------------------------------------------------
-// BatchCollector
-// ---------------------------------------------------------------------------
-export class BatchCollector {
-    constructor(config) {
-        this.buffer = [];
-        this.flushing = false;
-        this.httpClient = config.httpClient;
-        this.batchSize = config.batchSize ?? 10;
-        this.flushIntervalMs = config.flushIntervalMs ?? 5000;
-        this.source = config.source ?? "sdk";
-        this.environment = config.environment;
-        this.maxRetries = config.maxRetries ?? 3;
-        this.retryBaseDelayMs = config.retryBaseDelayMs ?? 1000;
-        // Start flush interval timer
-        this.timer = setInterval(() => {
-            void this.flush();
-        }, this.flushIntervalMs);
-        // Unref the timer so it does not keep the process alive
-        if (typeof this.timer === "object" && "unref" in this.timer) {
-            this.timer.unref();
-        }
-    }
-    /**
-     * Add a finished span to the buffer.
-     * If the buffer reaches batchSize, triggers an async flush.
-     */
-    add(span) {
-        this.buffer.push(span);
-        if (this.buffer.length >= this.batchSize) {
-            void this.flush();
-        }
-    }
-    /**
-     * Flush all buffered spans to the HTTP client.
-     * Groups spans by traceId into the TracePayload format.
-     * Retries with exponential backoff on failure.
-     */
-    async flush() {
-        if (this.buffer.length === 0 || this.flushing) {
-            return;
-        }
-        this.flushing = true;
-        // Drain buffer atomically
-        const spans = this.buffer.splice(0, this.buffer.length);
-        try {
-            const payload = this.buildPayload(spans);
-            await this.sendWithRetry(payload);
-        }
-        catch {
-            // All retries exhausted -- spans are lost
-            // In a production system we might persist to disk here.
-        }
-        finally {
-            this.flushing = false;
-        }
-    }
-    /**
-     * Shutdown: flush remaining spans, clear interval timer.
-     */
-    async shutdown() {
-        if (this.timer !== undefined) {
-            clearInterval(this.timer);
-            this.timer = undefined;
-        }
-        // Force-flush remaining
-        this.flushing = false; // Reset lock so flush can proceed
-        await this.flush();
-    }
-    // -------------------------------------------------------------------------
-    // Private helpers
-    // -------------------------------------------------------------------------
-    buildPayload(spans) {
-        // Group spans by traceId
-        const grouped = new Map();
-        for (const span of spans) {
-            let bucket = grouped.get(span.traceId);
-            if (bucket === undefined) {
-                bucket = [];
-                grouped.set(span.traceId, bucket);
-            }
-            bucket.push(span);
-        }
-        const traces = [];
-        for (const [traceId, traceSpans] of grouped.entries()) {
-            const traceEntry = {
-                traceId,
-                source: this.source,
-                spans: traceSpans.map((s) => {
-                    const span = {
-                        spanId: s.spanId,
-                        name: s.name,
-                        kind: s.kind,
-                        startTime: s.startTime,
-                        endTime: s.endTime,
-                        durationMs: s.durationMs,
-                        status: s.status,
-                    };
-                    if (s.parentSpanId !== undefined)
-                        span.parentSpanId = s.parentSpanId;
-                    if (s.input !== undefined)
-                        span.input = s.input;
-                    if (s.output !== undefined)
-                        span.output = s.output;
-                    if (s.model !== undefined)
-                        span.model = s.model;
-                    if (s.provider !== undefined)
-                        span.provider = s.provider;
-                    if (s.inputTokens !== undefined)
-                        span.inputTokens = s.inputTokens;
-                    if (s.outputTokens !== undefined)
-                        span.outputTokens = s.outputTokens;
-                    if (s.totalTokens !== undefined)
-                        span.totalTokens = s.totalTokens;
-                    if (s.costUsd !== undefined)
-                        span.costUsd = s.costUsd;
-                    if (s.statusMessage !== undefined)
-                        span.statusMessage = s.statusMessage;
-                    if (s.attributes !== undefined && Object.keys(s.attributes).length > 0) {
-                        span.attributes = s.attributes;
-                    }
-                    if (s.events !== undefined && s.events.length > 0) {
-                        span.events = s.events;
-                    }
-                    if (s.metadata !== undefined)
-                        span.metadata = s.metadata;
-                    return span;
-                }),
-            };
-            if (this.environment !== undefined) {
-                traceEntry.environment = this.environment;
-            }
-            traces.push(traceEntry);
-        }
-        return { traces };
-    }
-    async sendWithRetry(payload) {
-        let lastError;
-        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-            try {
-                return await this.httpClient.send(payload);
-            }
-            catch (err) {
-                lastError = err;
-                if (attempt < this.maxRetries) {
-                    const delayMs = this.retryBaseDelayMs * Math.pow(2, attempt);
-                    await this.sleep(delayMs);
-                }
-            }
-        }
-        throw lastError;
-    }
-    sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-}
-//# sourceMappingURL=batch-collector.js.map

package/dist/esm/tracing/batch-collector.js.map

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

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

@@ -1,37 +0,0 @@
-/**
- * MutagenT SDK -- @trace Method Decorator
- *
- * Method decorator that wraps class methods with automatic span creation,
- * input/output capture, and error handling.
- *
- * Uses legacy TypeScript decorator style (PropertyDescriptor) for broad
- * runtime compatibility (Bun, Node, tsc with experimentalDecorators).
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import type { SpanKind } from "./types.js";
-export interface TraceDecoratorOptions {
-    kind: SpanKind;
-    name?: string;
-    attributes?: Record<string, unknown>;
-}
-/**
- * Method decorator that creates a tracing span around the decorated method.
- *
- * - Auto-captures arguments as `input.raw`
- * - Auto-captures return value as `output.raw`
- * - Sets `status: 'ok'` on success, `status: 'error'` on throw
- * - No-op when tracing is not initialized
- * - Works with both sync and async methods
- * - Preserves `this` context
- *
- * Usage:
- * ```ts
- * class Agent {
- *   @trace({ kind: 'agent', name: 'my-agent' })
- *   async run(query: string): Promise<string> { ... }
- * }
- * ```
- */
-export declare function trace(options: TraceDecoratorOptions): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
-//# sourceMappingURL=decorators.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/tracing/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAA6B,MAAM,YAAY,CAAC;AAOtE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,qBAAqB,GAC7B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,kBAAkB,CA8EtG"}

package/dist/esm/tracing/decorators.js

@@ -1,96 +0,0 @@
-/**
- * MutagenT SDK -- @trace Method Decorator
- *
- * Method decorator that wraps class methods with automatic span creation,
- * input/output capture, and error handling.
- *
- * Uses legacy TypeScript decorator style (PropertyDescriptor) for broad
- * runtime compatibility (Bun, Node, tsc with experimentalDecorators).
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import { _getSpanManager } from "./init.js";
-// ---------------------------------------------------------------------------
-// @trace decorator
-// ---------------------------------------------------------------------------
-/**
- * Method decorator that creates a tracing span around the decorated method.
- *
- * - Auto-captures arguments as `input.raw`
- * - Auto-captures return value as `output.raw`
- * - Sets `status: 'ok'` on success, `status: 'error'` on throw
- * - No-op when tracing is not initialized
- * - Works with both sync and async methods
- * - Preserves `this` context
- *
- * Usage:
- * ```ts
- * class Agent {
- *   @trace({ kind: 'agent', name: 'my-agent' })
- *   async run(query: string): Promise<string> { ... }
- * }
- * ```
- */
-export function trace(options) {
-    return function (_target, propertyKey, descriptor) {
-        const originalMethod = descriptor.value;
-        const methodName = options.name ??
-            (typeof propertyKey === "string" ? propertyKey : options.kind);
-        descriptor.value = function (...args) {
-            const manager = _getSpanManager();
-            // No-op when tracing is not initialized
-            if (!manager) {
-                return originalMethod.call(this, ...args);
-            }
-            const spanOptions = {
-                kind: options.kind,
-                name: methodName,
-                input: { raw: args },
-            };
-            if (options.attributes) {
-                spanOptions.attributes = { ...options.attributes };
-            }
-            const span = manager.startSpan(spanOptions);
-            // Execute within async context for parent-child propagation
-            return manager.runInContext(span, () => {
-                try {
-                    const result = originalMethod.call(this, ...args);
-                    // Handle async (Promise-returning) methods
-                    if (result instanceof Promise) {
-                        return result.then((value) => {
-                            manager.endSpan(span, {
-                                status: "ok",
-                                output: { raw: value },
-                            });
-                            return value;
-                        }, (error) => {
-                            const message = error instanceof Error ? error.message : String(error);
-                            manager.endSpan(span, {
-                                status: "error",
-                                statusMessage: message,
-                            });
-                            throw error;
-                        });
-                    }
-                    // Sync return
-                    manager.endSpan(span, {
-                        status: "ok",
-                        output: { raw: result },
-                    });
-                    return result;
-                }
-                catch (error) {
-                    // Sync throw
-                    const message = error instanceof Error ? error.message : String(error);
-                    manager.endSpan(span, {
-                        status: "error",
-                        statusMessage: message,
-                    });
-                    throw error;
-                }
-            });
-        };
-        return descriptor;
-    };
-}
-//# sourceMappingURL=decorators.js.map

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

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

package/dist/esm/tracing/http-client.d.ts

@@ -1,29 +0,0 @@
-/**
- * MutagenT SDK — Trace HTTP Client
- *
- * Sends trace payloads to the MutagenT API via POST /api/traces.
- * Uses native fetch() with AbortController for timeout.
- *
- * NOT generated by Speakeasy — manually maintained.
- */
-import type { TraceHTTPResponse, TracePayload } from "./types.js";
-export interface TraceHTTPClientConfig {
-    endpoint: string;
-    apiKey: string;
-    timeoutMs?: number;
-}
-export declare class TraceHTTPClient {
-    private readonly endpoint;
-    private readonly apiKey;
-    private readonly timeoutMs;
-    constructor(config: TraceHTTPClientConfig);
-    /**
-     * Send a trace payload to the server.
-     *
-     * POST ${endpoint}/api/traces
-     * Headers: Content-Type: application/json, x-api-key: ${apiKey}
-     * Timeout: 10s via AbortController
-     */
-    send(payload: TracePayload): Promise<TraceHTTPResponse>;
-}
-//# sourceMappingURL=http-client.d.ts.map

package/dist/esm/tracing/http-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/tracing/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMlE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,qBAAqB;IAMzC;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA4B9D"}

package/dist/esm/tracing/http-client.js

@@ -1,47 +0,0 @@
-/**
- * MutagenT SDK — Trace HTTP Client
- *
- * Sends trace payloads to the MutagenT API via POST /api/traces.
- * Uses native fetch() with AbortController for timeout.
- *
- * NOT generated by Speakeasy — manually maintained.
- */
-export class TraceHTTPClient {
-    constructor(config) {
-        this.endpoint = config.endpoint.replace(/\/+$/, ""); // strip trailing slashes
-        this.apiKey = config.apiKey;
-        this.timeoutMs = config.timeoutMs ?? 10000;
-    }
-    /**
-     * Send a trace payload to the server.
-     *
-     * POST ${endpoint}/api/traces
-     * Headers: Content-Type: application/json, x-api-key: ${apiKey}
-     * Timeout: 10s via AbortController
-     */
-    async send(payload) {
-        const url = `${this.endpoint}/api/traces`;
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
-        try {
-            const response = await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "x-api-key": this.apiKey,
-                },
-                body: JSON.stringify(payload),
-                signal: controller.signal,
-            });
-            if (!response.ok) {
-                throw new Error(`Trace ingestion failed: HTTP ${response.status} ${response.statusText}`);
-            }
-            const body = (await response.json());
-            return body;
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-    }
-}
-//# sourceMappingURL=http-client.js.map

package/dist/esm/tracing/http-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../../src/tracing/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,MAAM,OAAO,eAAe;IAK1B,YAAY,MAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,yBAAyB;QAC9E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAM,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,OAAqB;QAC9B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;iBACzB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACzE,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

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

@@ -1,15 +0,0 @@
-/**
- * MutagenT SDK -- Tracing Module Barrel Export
- *
- * Public API for the tracing subsystem.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-export { initTracing, shutdownTracing, isTracingInitialized } from "./init.js";
-export { trace } from "./decorators.js";
-export type { TraceDecoratorOptions } from "./decorators.js";
-export { withTrace } from "./wrappers.js";
-export type { WithTraceOptions } from "./wrappers.js";
-export { startSpan, endSpan, getCurrentSpan, getCurrentTraceId, runInSpanContext, } from "./api.js";
-export type { SpanKind, SpanIO, SpanStatus, SpanEvent, SpanMetrics, SpanOptions, SpanEndOptions, SpanHandle, MutagentSpan, FinishedSpan, TracingConfig, TracePayload, TraceHTTPResponse, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAK/E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,OAAO,EACL,SAAS,EACT,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAKlB,YAAY,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/esm/tracing/index.js

@@ -1,21 +0,0 @@
-/**
- * MutagenT SDK -- Tracing Module Barrel Export
- *
- * Public API for the tracing subsystem.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-// ---------------------------------------------------------------------------
-// Initialization
-// ---------------------------------------------------------------------------
-export { initTracing, shutdownTracing, isTracingInitialized } from "./init.js";
-// ---------------------------------------------------------------------------
-// Decorator & Wrapper
-// ---------------------------------------------------------------------------
-export { trace } from "./decorators.js";
-export { withTrace } from "./wrappers.js";
-// ---------------------------------------------------------------------------
-// Low-Level API (for integration adapters)
-// ---------------------------------------------------------------------------
-export { startSpan, endSpan, getCurrentSpan, getCurrentTraceId, runInSpanContext, } from "./api.js";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE/E,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAC9E,OAAO,EACL,SAAS,EACT,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

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

@@ -1,54 +0,0 @@
-/**
- * MutagenT SDK -- Tracing Initialization
- *
- * Entry point for setting up tracing: creates singletons for
- * SpanManager, BatchCollector, and TraceHTTPClient.
- *
- * NOT generated by Speakeasy -- manually maintained.
- */
-import type { TracingConfig } from "./types.js";
-import { SpanManager } from "./span-manager.js";
-import { BatchCollector } from "./batch-collector.js";
-/**
- * Initialize tracing for the MutagenT SDK.
- *
- * Call once at application startup. Creates the SpanManager,
- * BatchCollector, and TraceHTTPClient singletons.
- *
- * Idempotent: calling again replaces the previous configuration
- * (shuts down old collector first, silently).
- */
-export declare function initTracing(config: TracingConfig): void;
-/**
- * Check if tracing has been initialized.
- */
-export declare function isTracingInitialized(): boolean;
-/**
- * Shutdown tracing: flush remaining spans, clear timers, reset state.
- */
-export declare function shutdownTracing(): Promise<void>;
-/**
- * Get the global SpanManager singleton.
- * Returns undefined if tracing is not initialized.
- * @internal Used by decorators, wrappers, and the low-level API.
- */
-export declare function _getSpanManager(): SpanManager | undefined;
-/**
- * Get the SpanManager, attempting lazy initialization from the
- * MUTAGENT_API_KEY environment variable if tracing hasn't been
- * explicitly initialized. Only attempts once per lifecycle.
- * @internal Used by the low-level API (api.ts).
- */
-export declare function _ensureTracing(): SpanManager | undefined;
-/**
- * Get the global BatchCollector singleton.
- * Returns undefined if tracing is not initialized.
- * @internal
- */
-export declare function _getBatchCollector(): BatchCollector | undefined;
-/**
- * Reset tracing state for tests. Equivalent to shutdownTracing.
- * @internal Test-only utility.
- */
-export declare function _resetTracingForTests(): Promise<void>;
-//# sourceMappingURL=init.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/tracing/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAC;AAgBjF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAqCvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAarD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,SAAS,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAiBxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,SAAS,CAE/D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D"}