tuplet 2.36.0 → 2.38.0

package/dist/tools/ask-user.js

@@ -21,7 +21,26 @@ Example: ${toolName}({ "questions": [{"question": "What is your goal?", "header"
             properties: {
                 questions: {
                     type: "array",
-                    description: "Array of 1-4 questions. Each item has: question (string, required), header (short label, optional), options (array of {label, description}, optional)",
+                    description: "Array of 1-4 questions. Each item has: question (string, required), header (short label, optional), options (array of strings, optional).",
+                    items: {
+                        type: "object",
+                        properties: {
+                            question: {
+                                type: "string",
+                                description: "The complete question to ask the user.",
+                            },
+                            header: {
+                                type: "string",
+                                description: "Short label (max 12 chars), e.g. 'Goal', 'Budget'.",
+                            },
+                            options: {
+                                type: "array",
+                                description: "Suggested answers shown as quick-pick chips.",
+                                items: { type: "string" },
+                            },
+                        },
+                        required: ["question"],
+                    },
                 },
             },
             required: ["questions"],

package/dist/tools/ask-user.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;WAIN,QAAQ;CAClB;QACG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,uJAAuJ;iBAC1J;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,iDAAiD;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;WAIN,QAAQ;CAClB;QACG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,2IAA2I;oBAC7I,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wCAAwC;6BACtD;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oDAAoD;6BAClE;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,OAAO;gCACb,WAAW,EAAE,8CAA8C;gCAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC1B;yBACF;wBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;qBACvB;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,iDAAiD;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/trace/index.d.ts

@@ -8,4 +8,7 @@ export { OPENROUTER_MODEL_PRICING } from './openrouter-pricing.js';
 export { TraceBuilder } from './builder.js';
 export type { ConsoleTraceConfig } from './console.js';
 export { ConsoleTraceProvider } from './console.js';
+export type { LangfuseTraceConfig } from './langfuse.js';
+export { LangfuseTraceProvider } from './langfuse.js';
+export { MultiTraceProvider } from './multi.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/trace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG5D,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG5D,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAGnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/trace/index.js

@@ -8,4 +8,7 @@ export { OPENROUTER_MODEL_PRICING } from './openrouter-pricing.js';
 // Builder
 export { TraceBuilder } from './builder.js';
 export { ConsoleTraceProvider } from './console.js';
+export { LangfuseTraceProvider } from './langfuse.js';
+// Multi Provider (fan-out to multiple providers)
+export { MultiTraceProvider } from './multi.js';
 //# sourceMappingURL=index.js.map

package/dist/trace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE5D,UAAU;AACV,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAElE,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAI3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE5D,UAAU;AACV,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAElE,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAI3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAInD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,iDAAiD;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/trace/langfuse.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Langfuse Trace Provider — native (no dependencies)
+ *
+ * Posts directly to Langfuse's ingestion API
+ * (`POST {baseUrl}/api/public/ingestion`) using Node 20+ built-in fetch.
+ * The user only needs credentials — no OpenTelemetry SDK required.
+ *
+ *   const trace = new LangfuseTraceProvider()  // reads LANGFUSE_* env vars
+ *
+ * Env vars (any of):
+ *   LANGFUSE_PUBLIC_KEY   (required)
+ *   LANGFUSE_SECRET_KEY   (required)
+ *   LANGFUSE_BASE_URL  |  LANGFUSE_BASEURL  |  LANGFUSE_HOST
+ *     (default: https://cloud.langfuse.com)
+ */
+import type { Trace, TraceProvider, AgentSpan, LLMCallEvent, ToolCallEvent, ModelPricing } from './types.js';
+export interface LangfuseTraceConfig {
+    /** Langfuse public key. Defaults to env LANGFUSE_PUBLIC_KEY. */
+    publicKey?: string;
+    /** Langfuse secret key. Defaults to env LANGFUSE_SECRET_KEY. */
+    secretKey?: string;
+    /** Langfuse base URL. Defaults to env LANGFUSE_BASE_URL / LANGFUSE_BASEURL / LANGFUSE_HOST or https://cloud.langfuse.com. */
+    baseUrl?: string;
+    /** Number of events to buffer before flushing. Default: 20. */
+    flushAt?: number;
+    /** Max time (ms) to hold buffered events before flushing. Default: 3000. */
+    flushIntervalMs?: number;
+    /** Network timeout (ms) per ingest request. Default: 10_000. */
+    requestTimeoutMs?: number;
+    /** Group runs into a Langfuse session. */
+    sessionId?: string;
+    /** Attach a Langfuse user id. */
+    userId?: string;
+    /** Tags applied to the trace. */
+    tags?: string[];
+    /** Free-form metadata applied to the trace. */
+    metadata?: Record<string, unknown>;
+    /** App release identifier (e.g. git sha). */
+    release?: string;
+    /** App version. */
+    version?: string;
+    /** Capture LLM messages/responses (default: true). Disable for sensitive data. */
+    captureMessages?: boolean;
+    /** Capture tool inputs/outputs (default: true). */
+    captureToolIO?: boolean;
+    /** Truncate captured payloads to this many characters. Default: 32_768. */
+    maxPayloadChars?: number;
+    /** Print ingestion errors to console (default: true). */
+    debug?: boolean;
+    /** Print a one-time confirmation line on first successful flush (default: false). */
+    verbose?: boolean;
+    /** Custom model pricing forwarded to the trace builder. */
+    modelPricing?: Record<string, ModelPricing>;
+}
+/**
+ * Sends tuplet trace events to Langfuse via the ingestion HTTP API.
+ */
+export declare class LangfuseTraceProvider implements TraceProvider {
+    readonly modelPricing?: Record<string, ModelPricing>;
+    private readonly endpoint;
+    private readonly auth;
+    private readonly flushAt;
+    private readonly flushIntervalMs;
+    private readonly requestTimeoutMs;
+    private readonly sessionId?;
+    private readonly userId?;
+    private readonly tags?;
+    private readonly metadata?;
+    private readonly release?;
+    private readonly version?;
+    private readonly captureMessages;
+    private readonly captureToolIO;
+    private readonly maxPayloadChars;
+    private readonly debug;
+    private readonly verbose;
+    private queue;
+    private flushTimer?;
+    private inFlight;
+    private firstSendLogged;
+    constructor(config?: LangfuseTraceConfig);
+    onTraceStart(trace: Trace): void;
+    onTraceEnd(trace: Trace): void;
+    onAgentStart(span: AgentSpan, trace: Trace): void;
+    onAgentEnd(span: AgentSpan, trace: Trace): void;
+    onLLMCall(event: LLMCallEvent, span: AgentSpan, trace: Trace): void;
+    onToolCall(event: ToolCallEvent, span: AgentSpan, trace: Trace): void;
+    /** Force-send any buffered events. Awaits the in-flight request too. */
+    flush(): Promise<void>;
+    /** Flush remaining events. Call before process exit. */
+    shutdown(): Promise<void>;
+    private observationParent;
+    private enqueue;
+    private send;
+    private cap;
+}
+//# sourceMappingURL=langfuse.d.ts.map

package/dist/trace/langfuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuse.d.ts","sourceRoot":"","sources":["../../src/trace/langfuse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6HAA6H;IAC7H,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC5C;AASD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAEzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAQ;IAEjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,UAAU,CAAC,CAA+B;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,eAAe,CAAQ;gBAEnB,MAAM,GAAE,mBAAwB;IAyC5C,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAgBhC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAsB9B,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAYjD,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAY/C,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAkCnE,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAkBrE,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,OAAO;YAeD,IAAI;IA6DlB,OAAO,CAAC,GAAG;CAgBZ"}

package/dist/trace/langfuse.js

@@ -0,0 +1,317 @@
+/**
+ * Langfuse Trace Provider — native (no dependencies)
+ *
+ * Posts directly to Langfuse's ingestion API
+ * (`POST {baseUrl}/api/public/ingestion`) using Node 20+ built-in fetch.
+ * The user only needs credentials — no OpenTelemetry SDK required.
+ *
+ *   const trace = new LangfuseTraceProvider()  // reads LANGFUSE_* env vars
+ *
+ * Env vars (any of):
+ *   LANGFUSE_PUBLIC_KEY   (required)
+ *   LANGFUSE_SECRET_KEY   (required)
+ *   LANGFUSE_BASE_URL  |  LANGFUSE_BASEURL  |  LANGFUSE_HOST
+ *     (default: https://cloud.langfuse.com)
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Sends tuplet trace events to Langfuse via the ingestion HTTP API.
+ */
+export class LangfuseTraceProvider {
+    modelPricing;
+    endpoint;
+    auth;
+    flushAt;
+    flushIntervalMs;
+    requestTimeoutMs;
+    sessionId;
+    userId;
+    tags;
+    metadata;
+    release;
+    version;
+    captureMessages;
+    captureToolIO;
+    maxPayloadChars;
+    debug;
+    verbose;
+    queue = [];
+    flushTimer;
+    inFlight = Promise.resolve();
+    firstSendLogged = false;
+    constructor(config = {}) {
+        const publicKey = config.publicKey ?? process.env.LANGFUSE_PUBLIC_KEY;
+        const secretKey = config.secretKey ?? process.env.LANGFUSE_SECRET_KEY;
+        const baseUrl = config.baseUrl ??
+            process.env.LANGFUSE_BASE_URL ??
+            process.env.LANGFUSE_BASEURL ??
+            process.env.LANGFUSE_HOST ??
+            'https://cloud.langfuse.com';
+        if (!publicKey || !secretKey) {
+            throw new Error('LangfuseTraceProvider: missing credentials. Set LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY env vars or pass them in config.');
+        }
+        this.endpoint = `${baseUrl.replace(/\/+$/, '')}/api/public/ingestion`;
+        this.auth = Buffer.from(`${publicKey}:${secretKey}`).toString('base64');
+        this.flushAt = config.flushAt ?? 20;
+        this.flushIntervalMs = config.flushIntervalMs ?? 3000;
+        this.requestTimeoutMs = config.requestTimeoutMs ?? 10_000;
+        this.sessionId = config.sessionId;
+        this.userId = config.userId;
+        this.tags = config.tags;
+        this.metadata = config.metadata;
+        this.release = config.release;
+        this.version = config.version;
+        this.captureMessages = config.captureMessages ?? true;
+        this.captureToolIO = config.captureToolIO ?? true;
+        this.maxPayloadChars = config.maxPayloadChars ?? 32_768;
+        this.debug = config.debug ?? true;
+        this.verbose = config.verbose ?? false;
+        this.modelPricing = config.modelPricing;
+    }
+    // ----- TraceProvider hooks ------------------------------------------------
+    onTraceStart(trace) {
+        const root = trace.rootSpan;
+        this.enqueue('trace-create', {
+            id: trace.traceId,
+            timestamp: isoFrom(trace.startTime),
+            name: root.agentName,
+            input: this.captureMessages ? this.cap(root.inputMessage) : undefined,
+            userId: this.userId,
+            sessionId: this.sessionId,
+            tags: this.tags,
+            metadata: this.metadata,
+            release: this.release,
+            version: this.version
+        });
+    }
+    onTraceEnd(trace) {
+        this.enqueue('trace-create', {
+            id: trace.traceId,
+            timestamp: isoFrom(trace.startTime),
+            name: trace.rootSpan.agentName,
+            output: this.captureMessages ? this.cap(trace.rootSpan.outputResponse) : undefined,
+            metadata: {
+                ...this.metadata,
+                durationMs: trace.durationMs,
+                totalCost: trace.totalCost,
+                totalInputTokens: trace.totalInputTokens,
+                totalOutputTokens: trace.totalOutputTokens,
+                totalCacheReadTokens: trace.totalCacheReadTokens,
+                totalCacheCreationTokens: trace.totalCacheCreationTokens,
+                totalLLMCalls: trace.totalLLMCalls,
+                totalToolCalls: trace.totalToolCalls,
+                costByModel: trace.costByModel
+            }
+        });
+        void this.flush();
+    }
+    onAgentStart(span, trace) {
+        if (span.depth === 0)
+            return; // root agent is the trace itself
+        this.enqueue('span-create', {
+            id: span.spanId,
+            traceId: trace.traceId,
+            name: span.agentName,
+            startTime: isoFrom(span.startTime),
+            parentObservationId: this.observationParent(span),
+            input: this.captureMessages ? this.cap(span.inputMessage) : undefined
+        });
+    }
+    onAgentEnd(span, trace) {
+        if (span.depth === 0)
+            return;
+        this.enqueue('span-update', {
+            id: span.spanId,
+            traceId: trace.traceId,
+            endTime: isoFrom(span.endTime ?? Date.now()),
+            output: this.captureMessages ? this.cap(span.outputResponse) : undefined,
+            level: span.status === 'error' ? 'ERROR' : 'DEFAULT',
+            statusMessage: span.status === 'interrupted' ? 'interrupted' : undefined
+        });
+    }
+    onLLMCall(event, span, trace) {
+        const startTime = event.timestamp - event.durationMs;
+        const usageDetails = {
+            input: event.inputTokens,
+            output: event.outputTokens,
+            total: event.inputTokens + event.outputTokens
+        };
+        if (event.cacheReadTokens)
+            usageDetails.cache_read_input = event.cacheReadTokens;
+        if (event.cacheCreationTokens)
+            usageDetails.cache_creation_input = event.cacheCreationTokens;
+        let input;
+        if (this.captureMessages) {
+            const wrapped = {};
+            if (event.systemPrompt)
+                wrapped.system = event.systemPrompt;
+            if (event.messages)
+                wrapped.messages = event.messages;
+            if (Object.keys(wrapped).length > 0)
+                input = wrapped;
+        }
+        this.enqueue('generation-create', {
+            id: event.spanId,
+            traceId: trace.traceId,
+            name: `llm.${event.modelId}`,
+            startTime: isoFrom(startTime),
+            endTime: isoFrom(event.timestamp),
+            parentObservationId: span.depth === 0 ? undefined : span.spanId,
+            model: event.modelId,
+            input: this.cap(input),
+            output: this.captureMessages ? this.cap(event.response) : undefined,
+            usageDetails,
+            costDetails: event.cost > 0 ? { total: event.cost } : undefined
+        });
+    }
+    onToolCall(event, span, trace) {
+        const startTime = event.timestamp - event.durationMs;
+        this.enqueue('span-create', {
+            id: event.spanId,
+            traceId: trace.traceId,
+            name: `tool.${event.toolName}`,
+            startTime: isoFrom(startTime),
+            endTime: isoFrom(event.timestamp),
+            parentObservationId: span.depth === 0 ? undefined : span.spanId,
+            input: this.captureToolIO ? this.cap(event.input) : undefined,
+            output: this.captureToolIO ? this.cap(event.output) : undefined,
+            level: event.output.success ? 'DEFAULT' : 'ERROR',
+            statusMessage: event.output.success ? undefined : event.output.error
+        });
+    }
+    // ----- public lifecycle ---------------------------------------------------
+    /** Force-send any buffered events. Awaits the in-flight request too. */
+    async flush() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        if (this.queue.length === 0) {
+            await this.inFlight;
+            return;
+        }
+        const batch = this.queue;
+        this.queue = [];
+        this.inFlight = this.inFlight.then(() => this.send(batch));
+        await this.inFlight;
+    }
+    /** Flush remaining events. Call before process exit. */
+    async shutdown() {
+        await this.flush();
+    }
+    // ----- internals ----------------------------------------------------------
+    observationParent(span) {
+        // Sub-agent at depth 1 is parented directly to the trace (root has no observation).
+        // Deeper agents parent to the enclosing sub-agent observation.
+        if (!span.parentSpanId)
+            return undefined;
+        const parentDepth = (span.depth ?? 0) - 1;
+        return parentDepth >= 1 ? span.parentSpanId : undefined;
+    }
+    enqueue(type, body) {
+        this.queue.push({
+            id: randomUUID(),
+            type,
+            timestamp: new Date().toISOString(),
+            body: stripUndefined(body)
+        });
+        if (this.queue.length >= this.flushAt) {
+            void this.flush();
+        }
+        else if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => void this.flush(), this.flushIntervalMs);
+            this.flushTimer.unref?.();
+        }
+    }
+    async send(batch) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.requestTimeoutMs);
+        try {
+            const res = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Basic ${this.auth}`
+                },
+                body: JSON.stringify({ batch }),
+                signal: ctrl.signal
+            });
+            const text = await res.text().catch(() => '');
+            const parsed = parseJson(text);
+            if (!res.ok && res.status !== 207) {
+                if (this.debug) {
+                    console.error(`[langfuse] ${res.status} ${res.statusText}: ${truncateForLog(text)}`);
+                }
+                return;
+            }
+            const successCount = parsed?.successes?.length ?? 0;
+            const errors = parsed?.errors ?? [];
+            if (this.verbose && !this.firstSendLogged) {
+                this.firstSendLogged = true;
+                console.log(`[langfuse] connected → ${this.endpoint} (sent ${batch.length}, accepted ${successCount}, rejected ${errors.length})`);
+            }
+            if (this.debug && errors.length > 0) {
+                for (const err of errors) {
+                    const detail = typeof err.error === 'string'
+                        ? err.error
+                        : err.error
+                            ? JSON.stringify(err.error)
+                            : err.message ?? 'unknown';
+                    console.error(`[langfuse] event ${err.id ?? '?'} rejected (${err.status ?? '?'}): ${truncateForLog(detail)}`);
+                }
+            }
+        }
+        catch (err) {
+            if (this.debug) {
+                console.error('[langfuse] ingest failed:', err instanceof Error ? err.message : err);
+            }
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    cap(value) {
+        if (value == null)
+            return undefined;
+        if (typeof value === 'string') {
+            return value.length <= this.maxPayloadChars
+                ? value
+                : value.slice(0, this.maxPayloadChars - 14) + '…[truncated]';
+        }
+        let serialized;
+        try {
+            serialized = JSON.stringify(value);
+        }
+        catch {
+            return String(value).slice(0, this.maxPayloadChars);
+        }
+        if (serialized.length <= this.maxPayloadChars)
+            return value;
+        return serialized.slice(0, this.maxPayloadChars - 14) + '…[truncated]';
+    }
+}
+function isoFrom(ms) {
+    return ms == null ? undefined : new Date(ms).toISOString();
+}
+function parseJson(text) {
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function truncateForLog(text) {
+    return text.length > 500 ? text.slice(0, 500) + '…' : text;
+}
+function stripUndefined(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=langfuse.js.map

package/dist/trace/langfuse.js.map

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

package/dist/trace/multi.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Multi Trace Provider — fans out trace events to multiple TraceProviders.
+ *
+ * Useful when you want to record traces in two places at once (e.g. an internal
+ * Firestore/Postgres store *and* Langfuse for observability) without having to
+ * write a wrapper that forwards every callback by hand.
+ *
+ *   const trace = new MultiTraceProvider([
+ *     new ConsoleTraceProvider(),
+ *     new LangfuseTraceProvider()
+ *   ])
+ *
+ *   new Tuplet({ ..., trace })
+ *
+ * Behavior:
+ *  - Every callback fans out to all child providers in parallel via Promise.all.
+ *  - Errors from any single child are caught and logged so one bad sink can't
+ *    take down the agent run or block the other providers.
+ *  - `modelPricing` resolves to the first child that defines one, so cost
+ *    calculations stay consistent.
+ *  - `flush()` / `shutdown()` fan out to children that implement them
+ *    (e.g. LangfuseTraceProvider).
+ */
+import type { Trace, TraceProvider, AgentSpan, LLMCallEvent, ToolCallEvent, ModelPricing, CostUpdate } from './types.js';
+export declare class MultiTraceProvider implements TraceProvider {
+    readonly modelPricing?: Record<string, ModelPricing>;
+    private readonly providers;
+    constructor(providers: TraceProvider[]);
+    onTraceStart(trace: Trace): Promise<void>;
+    onTraceEnd(trace: Trace): Promise<void>;
+    onAgentStart(span: AgentSpan, trace: Trace): Promise<void>;
+    onAgentEnd(span: AgentSpan, trace: Trace): Promise<void>;
+    onLLMCall(event: LLMCallEvent, span: AgentSpan, trace: Trace): Promise<void>;
+    onToolCall(event: ToolCallEvent, span: AgentSpan, trace: Trace): Promise<void>;
+    onCostUpdate(update: CostUpdate): Promise<void>;
+    /** Fan out flush() to children that implement it. Best-effort. */
+    flush(): Promise<void>;
+    /** Fan out shutdown() to children that implement it. Best-effort. */
+    shutdown(): Promise<void>;
+    private fanOut;
+}
+//# sourceMappingURL=multi.d.ts.map

package/dist/trace/multi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.d.ts","sourceRoot":"","sources":["../../src/trace/multi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAA;AAOnB,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAE/B,SAAS,EAAE,aAAa,EAAE;IAKhC,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,kEAAkE;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,qEAAqE;IAC/D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,MAAM;CAarB"}

package/dist/trace/multi.js

@@ -0,0 +1,71 @@
+/**
+ * Multi Trace Provider — fans out trace events to multiple TraceProviders.
+ *
+ * Useful when you want to record traces in two places at once (e.g. an internal
+ * Firestore/Postgres store *and* Langfuse for observability) without having to
+ * write a wrapper that forwards every callback by hand.
+ *
+ *   const trace = new MultiTraceProvider([
+ *     new ConsoleTraceProvider(),
+ *     new LangfuseTraceProvider()
+ *   ])
+ *
+ *   new Tuplet({ ..., trace })
+ *
+ * Behavior:
+ *  - Every callback fans out to all child providers in parallel via Promise.all.
+ *  - Errors from any single child are caught and logged so one bad sink can't
+ *    take down the agent run or block the other providers.
+ *  - `modelPricing` resolves to the first child that defines one, so cost
+ *    calculations stay consistent.
+ *  - `flush()` / `shutdown()` fan out to children that implement them
+ *    (e.g. LangfuseTraceProvider).
+ */
+export class MultiTraceProvider {
+    modelPricing;
+    providers;
+    constructor(providers) {
+        this.providers = providers;
+        this.modelPricing = providers.find((p) => p.modelPricing)?.modelPricing;
+    }
+    async onTraceStart(trace) {
+        await this.fanOut((p) => p.onTraceStart?.(trace));
+    }
+    async onTraceEnd(trace) {
+        await this.fanOut((p) => p.onTraceEnd?.(trace));
+    }
+    async onAgentStart(span, trace) {
+        await this.fanOut((p) => p.onAgentStart?.(span, trace));
+    }
+    async onAgentEnd(span, trace) {
+        await this.fanOut((p) => p.onAgentEnd?.(span, trace));
+    }
+    async onLLMCall(event, span, trace) {
+        await this.fanOut((p) => p.onLLMCall?.(event, span, trace));
+    }
+    async onToolCall(event, span, trace) {
+        await this.fanOut((p) => p.onToolCall?.(event, span, trace));
+    }
+    async onCostUpdate(update) {
+        await this.fanOut((p) => p.onCostUpdate?.(update));
+    }
+    /** Fan out flush() to children that implement it. Best-effort. */
+    async flush() {
+        await this.fanOut((p) => p.flush?.());
+    }
+    /** Fan out shutdown() to children that implement it. Best-effort. */
+    async shutdown() {
+        await this.fanOut((p) => p.shutdown?.());
+    }
+    async fanOut(invoke) {
+        await Promise.all(this.providers.map(async (p) => {
+            try {
+                await invoke(p);
+            }
+            catch (err) {
+                console.error('[multi-trace] provider failed:', err);
+            }
+        }));
+    }
+}
+//# sourceMappingURL=multi.js.map

package/dist/trace/multi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.js","sourceRoot":"","sources":["../../src/trace/multi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAiBH,MAAM,OAAO,kBAAkB;IACpB,YAAY,CAA+B;IACnC,SAAS,CAAiB;IAE3C,YAAY,SAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAY;QAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAY;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAe,EAAE,KAAY;QAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAe,EAAE,KAAY;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAmB,EAAE,IAAe,EAAE,KAAY;QAChE,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAoB,EAAE,IAAe,EAAE,KAAY;QAClE,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAkB;QACnC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAuB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAuB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACjE,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,MAAkD;QAElD,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAA;YACtD,CAAC;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC;CACF"}

package/dist/trace/multi.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multi.test.d.ts.map

package/dist/trace/multi.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.test.d.ts","sourceRoot":"","sources":["../../src/trace/multi.test.ts"],"names":[],"mappings":""}