teckel-ai 0.5.1 → 0.7.1

package/dist/index.d.ts

@@ -1,107 +1,11 @@
+import { T as TeckelConfig, a as TraceData, F as FeedbackData } from './types-c7iVpo4d.js';
+export { B as BatchConfig, D as Document, g as FeedbackResult, e as FeedbackType, S as SpanData, d as SpanStatus, c as SpanType, b as TokenUsage, f as TraceResult } from './types-c7iVpo4d.js';
 import { z } from 'zod';
 
-/**
- * Type definitions for teckel-ai SDK
- */
-interface TeckelConfig {
-    /** Teckel API key (tk_live_...) */
-    apiKey: string;
-    /** API endpoint (default: https://app.teckel.ai/api) */
-    endpoint?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Network timeout in ms (default: 5000) */
-    timeoutMs?: number;
-}
-/**
- * Document/chunk from your RAG pipeline.
- * The `id` field is your stable identifier - server generates internal UUIDs via deterministic hashing.
- */
-interface Document {
-    /** Your document identifier (any format: "overview.md", "doc-123", etc.) */
-    id: string;
-    /** Human-readable document name */
-    name: string;
-    /** The actual text/chunk content */
-    text: string;
-    /** ISO 8601 timestamp - enables version tracking */
-    lastUpdated?: string;
-    /** Link to source (URL, intranet, file://) */
-    url?: string;
-    /** Storage platform: confluence, slack, gdrive, etc. */
-    source?: string;
-    /** File format: pdf, docx, md, etc. */
-    fileFormat?: string;
-    /** Vector similarity score (0-1) */
-    similarity?: number;
-    /** Position in results */
-    rank?: number;
-    /** Document owner email */
-    ownerEmail?: string;
-}
-interface TokenUsage {
-    prompt: number;
-    completion: number;
-    total: number;
-}
-/**
- * Trace data for a single query-response interaction.
- * Sessions are created implicitly when traces share the same sessionId.
- */
-interface TraceData {
-    /** User's question/prompt */
-    query: string;
-    /** LLM's response */
-    response: string;
-    /** Model name (e.g., 'gpt-4') */
-    model?: string;
-    /** Response time in milliseconds */
-    latencyMs?: number;
-    /** Token usage */
-    tokens?: TokenUsage;
-    /** Source documents used in RAG */
-    documents?: Document[];
-    /** Groups traces into a session (any string up to 200 chars, OTEL compatible) */
-    sessionId?: string;
-    /** User identifier */
-    userId?: string;
-    /** Client-provided trace ID (UUID, auto-generated if omitted) */
-    traceId?: string;
-    /** LLM system prompt/instructions */
-    systemPrompt?: string;
-    /** Custom metadata (max 10KB) */
-    metadata?: Record<string, unknown>;
-}
-type FeedbackType = 'thumbs_up' | 'thumbs_down' | 'flag' | 'rating';
-/**
- * User feedback signal. Target either a specific trace or an entire session.
- */
-interface FeedbackData {
-    /** Target trace (UUID) */
-    traceId?: string;
-    /** Target session (any string up to 200 chars) */
-    sessionId?: string;
-    /** Feedback type */
-    type: FeedbackType;
-    /** For ratings: '1'-'5' */
-    value?: string;
-    /** Optional comment */
-    comment?: string;
-}
-interface TraceResult {
-    traceId: string;
-    sessionId?: string;
-    chunkCount: number;
-}
-interface FeedbackResult {
-    feedbackId: string;
-    type: FeedbackType;
-    traceId?: string;
-    sessionId?: string;
-}
-
 /**
  * TeckelTracer - Fire-and-forget trace collection for AI applications
+ *
+ * v0.6.0: Added batch ingestion for high-throughput scenarios (100x improvement)
  */
 
 declare class TeckelTracer {
@@ -109,24 +13,82 @@ declare class TeckelTracer {
     private readonly endpoint;
     private readonly debug;
     private readonly timeoutMs;
+    private readonly batchConfig;
     private sendQueue;
+    private batchBuffer;
+    private batchByteCount;
+    private batchFlushTimer;
+    private isDestroyed;
     constructor(config: TeckelConfig);
     /**
      * Record a trace. Fire-and-forget - call flush() in serverless before termination.
+     *
+     * With batching enabled (default), traces are buffered and sent in batches
+     * for dramatically improved throughput (100x for high-volume scenarios).
+     *
+     * Token auto-aggregation: If you provide `spans` but not `tokens`, the tracer
+     * automatically aggregates token counts from all spans. OTel spans contain
+     * per-span token usage (promptTokens, completionTokens) which are summed to
+     * produce the trace-level totals. You can also provide your own `tokens` object
+     * to override this behavior.
+     *
+     * Cost calculation: If you provide `costUsd`, we use your value directly.
+     * Otherwise, cost is automatically calculated server-side from token counts.
+     * Per-span `costUsd` is also supported for detailed breakdown.
      */
     trace(data: TraceData): void;
     /**
      * Submit feedback for a trace or session.
+     * Feedback is always sent immediately (not batched).
      */
     feedback(data: FeedbackData): void;
     /**
      * Wait for queued requests to complete. Essential for serverless environments.
+     * This will flush any pending batch and wait for all requests to complete.
      */
     flush(timeoutMs?: number): Promise<void>;
+    /**
+     * Cleanup tracer resources. Call when done with the tracer.
+     * This flushes pending traces and stops the auto-flush timer.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get current batch buffer size (for testing/debugging)
+     */
+    get pendingTraceCount(): number;
+    /**
+     * Start the auto-flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Stop the auto-flush timer
+     */
+    private stopFlushTimer;
+    /**
+     * Flush the current batch buffer
+     */
+    private flushBatch;
+    /**
+     * Send a batch of traces
+     */
+    private sendBatch;
     private send;
     private fetchWithRetry;
     private enqueue;
+    /**
+     * Log validation errors with actionable hints for common issues.
+     * Optionally reports to platform for internal debugging.
+     */
     private logValidationError;
+    /**
+     * Provide actionable hints for common validation errors.
+     */
+    private getValidationHint;
+    /**
+     * Report dropped traces to platform for internal debugging.
+     * Fire-and-forget - never blocks or throws.
+     */
+    private reportDropped;
     private logHttpError;
 }
 
@@ -187,9 +149,121 @@ declare const TokenUsageSchema: z.ZodObject<{
     completion: number;
     total: number;
 }>;
+/** Span size limits */
+declare const SPAN_SIZE_LIMITS: {
+    readonly MAX_SPANS: 100;
+    readonly JSONB_MAX_BYTES: 512000;
+};
+/** Span type enum - 6 meaningful operation types */
+declare const SpanTypeSchema: z.ZodEnum<["llm_call", "tool_call", "retrieval", "agent", "guardrail", "custom"]>;
+/** Span status enum */
+declare const SpanStatusSchema: z.ZodEnum<["running", "completed", "error"]>;
+/** Schema for span data */
+declare const SpanDataSchema: z.ZodEffects<z.ZodObject<{
+    spanId: z.ZodOptional<z.ZodString>;
+    parentSpanId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    name: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<["llm_call", "tool_call", "retrieval", "agent", "guardrail", "custom"]>>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<["running", "completed", "error"]>>;
+    statusMessage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    toolName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    toolArguments: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+    toolResult: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+    model: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    promptTokens: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    completionTokens: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    costUsd: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    input: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+    output: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+    metadata: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+    status: "running" | "completed" | "error";
+    startedAt: string;
+    spanId?: string | undefined;
+    parentSpanId?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    durationMs?: number | undefined;
+    statusMessage?: string | null | undefined;
+    toolName?: string | null | undefined;
+    toolArguments?: Record<string, unknown> | null | undefined;
+    toolResult?: Record<string, unknown> | null | undefined;
+    model?: string | null | undefined;
+    promptTokens?: number | null | undefined;
+    completionTokens?: number | null | undefined;
+    costUsd?: number | null | undefined;
+    input?: Record<string, unknown> | null | undefined;
+    output?: Record<string, unknown> | null | undefined;
+    metadata?: Record<string, unknown> | null | undefined;
+}, {
+    name: string;
+    startedAt: string;
+    type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+    status?: "running" | "completed" | "error" | undefined;
+    spanId?: string | undefined;
+    parentSpanId?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    durationMs?: number | undefined;
+    statusMessage?: string | null | undefined;
+    toolName?: string | null | undefined;
+    toolArguments?: Record<string, unknown> | null | undefined;
+    toolResult?: Record<string, unknown> | null | undefined;
+    model?: string | null | undefined;
+    promptTokens?: number | null | undefined;
+    completionTokens?: number | null | undefined;
+    costUsd?: number | null | undefined;
+    input?: Record<string, unknown> | null | undefined;
+    output?: Record<string, unknown> | null | undefined;
+    metadata?: Record<string, unknown> | null | undefined;
+}>, {
+    name: string;
+    type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+    status: "running" | "completed" | "error";
+    startedAt: string;
+    spanId?: string | undefined;
+    parentSpanId?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    durationMs?: number | undefined;
+    statusMessage?: string | null | undefined;
+    toolName?: string | null | undefined;
+    toolArguments?: Record<string, unknown> | null | undefined;
+    toolResult?: Record<string, unknown> | null | undefined;
+    model?: string | null | undefined;
+    promptTokens?: number | null | undefined;
+    completionTokens?: number | null | undefined;
+    costUsd?: number | null | undefined;
+    input?: Record<string, unknown> | null | undefined;
+    output?: Record<string, unknown> | null | undefined;
+    metadata?: Record<string, unknown> | null | undefined;
+}, {
+    name: string;
+    startedAt: string;
+    type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+    status?: "running" | "completed" | "error" | undefined;
+    spanId?: string | undefined;
+    parentSpanId?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    durationMs?: number | undefined;
+    statusMessage?: string | null | undefined;
+    toolName?: string | null | undefined;
+    toolArguments?: Record<string, unknown> | null | undefined;
+    toolResult?: Record<string, unknown> | null | undefined;
+    model?: string | null | undefined;
+    promptTokens?: number | null | undefined;
+    completionTokens?: number | null | undefined;
+    costUsd?: number | null | undefined;
+    input?: Record<string, unknown> | null | undefined;
+    output?: Record<string, unknown> | null | undefined;
+    metadata?: Record<string, unknown> | null | undefined;
+}>;
 declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
     query: z.ZodString;
     response: z.ZodString;
+    agentName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     model: z.ZodOptional<z.ZodString>;
     latencyMs: z.ZodOptional<z.ZodNumber>;
     tokens: z.ZodOptional<z.ZodObject<{
@@ -205,6 +279,7 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         completion: number;
         total: number;
     }>>;
+    costUsd: z.ZodOptional<z.ZodNumber>;
     documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
@@ -239,6 +314,107 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         rank?: number | undefined;
         ownerEmail?: string | undefined;
     }>, "many">>;
+    spans: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        spanId: z.ZodOptional<z.ZodString>;
+        parentSpanId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        name: z.ZodString;
+        type: z.ZodDefault<z.ZodEnum<["llm_call", "tool_call", "retrieval", "agent", "guardrail", "custom"]>>;
+        startedAt: z.ZodString;
+        endedAt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodDefault<z.ZodEnum<["running", "completed", "error"]>>;
+        statusMessage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        toolName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        toolArguments: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+        toolResult: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+        model: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        promptTokens: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        completionTokens: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        costUsd: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        input: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+        output: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+        metadata: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown> | null | undefined, Record<string, unknown> | null | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+        status: "running" | "completed" | "error";
+        startedAt: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }, {
+        name: string;
+        startedAt: string;
+        type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+        status?: "running" | "completed" | "error" | undefined;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }>, {
+        name: string;
+        type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+        status: "running" | "completed" | "error";
+        startedAt: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }, {
+        name: string;
+        startedAt: string;
+        type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+        status?: "running" | "completed" | "error" | undefined;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }>, "many">>;
     sessionId: z.ZodOptional<z.ZodString>;
     userId: z.ZodOptional<z.ZodString>;
     traceId: z.ZodOptional<z.ZodString>;
@@ -248,6 +424,9 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
     query: string;
     response: string;
     model?: string | undefined;
+    costUsd?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    agentName?: string | null | undefined;
     latencyMs?: number | undefined;
     tokens?: {
         prompt: number;
@@ -266,15 +445,38 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         rank?: number | undefined;
         ownerEmail?: string | undefined;
     }[] | undefined;
+    spans?: {
+        name: string;
+        type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+        status: "running" | "completed" | "error";
+        startedAt: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }[] | undefined;
     sessionId?: string | undefined;
     userId?: string | undefined;
     traceId?: string | undefined;
     systemPrompt?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }, {
     query: string;
     response: string;
     model?: string | undefined;
+    costUsd?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    agentName?: string | null | undefined;
     latencyMs?: number | undefined;
     tokens?: {
         prompt: number;
@@ -293,15 +495,38 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         rank?: number | undefined;
         ownerEmail?: string | undefined;
     }[] | undefined;
+    spans?: {
+        name: string;
+        startedAt: string;
+        type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+        status?: "running" | "completed" | "error" | undefined;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }[] | undefined;
     sessionId?: string | undefined;
     userId?: string | undefined;
     traceId?: string | undefined;
     systemPrompt?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }>, {
     query: string;
     response: string;
     model?: string | undefined;
+    costUsd?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    agentName?: string | null | undefined;
     latencyMs?: number | undefined;
     tokens?: {
         prompt: number;
@@ -320,15 +545,38 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         rank?: number | undefined;
         ownerEmail?: string | undefined;
     }[] | undefined;
+    spans?: {
+        name: string;
+        type: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom";
+        status: "running" | "completed" | "error";
+        startedAt: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }[] | undefined;
     sessionId?: string | undefined;
     userId?: string | undefined;
     traceId?: string | undefined;
     systemPrompt?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }, {
     query: string;
     response: string;
     model?: string | undefined;
+    costUsd?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    agentName?: string | null | undefined;
     latencyMs?: number | undefined;
     tokens?: {
         prompt: number;
@@ -347,11 +595,31 @@ declare const TraceDataSchema: z.ZodEffects<z.ZodObject<{
         rank?: number | undefined;
         ownerEmail?: string | undefined;
     }[] | undefined;
+    spans?: {
+        name: string;
+        startedAt: string;
+        type?: "llm_call" | "tool_call" | "retrieval" | "agent" | "guardrail" | "custom" | undefined;
+        status?: "running" | "completed" | "error" | undefined;
+        spanId?: string | undefined;
+        parentSpanId?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        durationMs?: number | undefined;
+        statusMessage?: string | null | undefined;
+        toolName?: string | null | undefined;
+        toolArguments?: Record<string, unknown> | null | undefined;
+        toolResult?: Record<string, unknown> | null | undefined;
+        model?: string | null | undefined;
+        promptTokens?: number | null | undefined;
+        completionTokens?: number | null | undefined;
+        costUsd?: number | null | undefined;
+        input?: Record<string, unknown> | null | undefined;
+        output?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+    }[] | undefined;
     sessionId?: string | undefined;
     userId?: string | undefined;
     traceId?: string | undefined;
     systemPrompt?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }>;
 declare const FeedbackDataSchema: z.ZodEffects<z.ZodObject<{
     traceId: z.ZodOptional<z.ZodString>;
@@ -384,21 +652,58 @@ declare const FeedbackDataSchema: z.ZodEffects<z.ZodObject<{
     traceId?: string | undefined;
     comment?: string | undefined;
 }>;
+/** Batch configuration schema for high-throughput ingestion */
+declare const BatchConfigSchema: z.ZodObject<{
+    maxSize: z.ZodOptional<z.ZodNumber>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+    flushIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxSize?: number | undefined;
+    maxBytes?: number | undefined;
+    flushIntervalMs?: number | undefined;
+}, {
+    maxSize?: number | undefined;
+    maxBytes?: number | undefined;
+    flushIntervalMs?: number | undefined;
+}>;
 declare const TeckelConfigSchema: z.ZodObject<{
     apiKey: z.ZodString;
     endpoint: z.ZodOptional<z.ZodString>;
     debug: z.ZodOptional<z.ZodBoolean>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
+    batch: z.ZodOptional<z.ZodObject<{
+        maxSize: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        flushIntervalMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxSize?: number | undefined;
+        maxBytes?: number | undefined;
+        flushIntervalMs?: number | undefined;
+    }, {
+        maxSize?: number | undefined;
+        maxBytes?: number | undefined;
+        flushIntervalMs?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     apiKey: string;
     endpoint?: string | undefined;
     debug?: boolean | undefined;
     timeoutMs?: number | undefined;
+    batch?: {
+        maxSize?: number | undefined;
+        maxBytes?: number | undefined;
+        flushIntervalMs?: number | undefined;
+    } | undefined;
 }, {
     apiKey: string;
     endpoint?: string | undefined;
     debug?: boolean | undefined;
     timeoutMs?: number | undefined;
+    batch?: {
+        maxSize?: number | undefined;
+        maxBytes?: number | undefined;
+        flushIntervalMs?: number | undefined;
+    } | undefined;
 }>;
 
-export { type Document, DocumentSchema, type FeedbackData, FeedbackDataSchema, type FeedbackResult, type FeedbackType, TRACE_SIZE_LIMITS, type TeckelConfig, TeckelConfigSchema, TeckelTracer, type TokenUsage, TokenUsageSchema, type TraceData, TraceDataSchema, type TraceResult };
+export { BatchConfigSchema, DocumentSchema, FeedbackData, FeedbackDataSchema, SPAN_SIZE_LIMITS, SpanDataSchema, SpanStatusSchema, SpanTypeSchema, TRACE_SIZE_LIMITS, TeckelConfig, TeckelConfigSchema, TeckelTracer, TokenUsageSchema, TraceData, TraceDataSchema };