live-traces 0.1.0

package/dist/react/store.js

@@ -0,0 +1,273 @@
+// ============================================================================
+// Store
+// ============================================================================
+/** TTL for completed traces before eviction (ms) */
+const COMPLETED_TTL_MS = 30_000;
+/** Maximum events per span */
+const MAX_SPAN_EVENTS = 50;
+/** Replay filter: skip events older than 30 minutes */
+const REPLAY_MAX_AGE_MS = 30 * 60 * 1000;
+export class TraceStore {
+    traces = new Map();
+    listeners = new Set();
+    cleanupTimer = null;
+    constructor() {
+        this.cleanupTimer = setInterval(() => this.cleanup(), 5_000);
+    }
+    /** Subscribe to store changes (for useSyncExternalStore) */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    /** Get snapshot (for useSyncExternalStore) */
+    getSnapshot = () => this.traces;
+    /** Dispatch a single trace event */
+    dispatch(event) {
+        // Skip ancient events on replay
+        if (Date.now() - event.timestamp > REPLAY_MAX_AGE_MS)
+            return;
+        switch (event._tag) {
+            case "TraceStart":
+                this.handleTraceStart(event);
+                break;
+            case "SpanStart":
+                this.handleSpanStart(event);
+                break;
+            case "SpanEnd":
+                this.handleSpanEnd(event);
+                break;
+            case "SpanEvent":
+                this.handleSpanEvent(event);
+                break;
+            case "TraceEnd":
+                this.handleTraceEnd(event);
+                break;
+        }
+        this.notify();
+    }
+    /** Dispatch a batch of events */
+    dispatchBatch(events) {
+        for (const event of events) {
+            // Inline without notify per event
+            if (Date.now() - event.timestamp > REPLAY_MAX_AGE_MS)
+                continue;
+            switch (event._tag) {
+                case "TraceStart":
+                    this.handleTraceStart(event);
+                    break;
+                case "SpanStart":
+                    this.handleSpanStart(event);
+                    break;
+                case "SpanEnd":
+                    this.handleSpanEnd(event);
+                    break;
+                case "SpanEvent":
+                    this.handleSpanEvent(event);
+                    break;
+                case "TraceEnd":
+                    this.handleTraceEnd(event);
+                    break;
+            }
+        }
+        this.notify();
+    }
+    /** Get a single trace */
+    getTrace(traceId) {
+        return this.traces.get(traceId);
+    }
+    /** Get all traces as array, sorted by startedAt descending */
+    getAllTraces() {
+        return Array.from(this.traces.values()).toSorted((a, b) => b.startedAt - a.startedAt);
+    }
+    /** Get step spans (ui.step=true) for a trace, in order */
+    getSteps(traceId) {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return [];
+        return Array.from(trace.spans.values())
+            .filter((s) => s.isStep)
+            .toSorted((a, b) => a.startedAt - b.startedAt);
+    }
+    /** Build the span tree for a trace */
+    getSpanTree(traceId) {
+        const trace = this.traces.get(traceId);
+        if (!trace || !trace.rootSpanId)
+            return undefined;
+        return trace.spans.get(trace.rootSpanId);
+    }
+    /** Destroy the store (stop cleanup timer) */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.listeners.clear();
+    }
+    // -- Event handlers --
+    handleTraceStart(event) {
+        const existing = this.traces.get(event.traceId);
+        if (existing)
+            return; // idempotent
+        this.traces = new Map(this.traces);
+        this.traces.set(event.traceId, {
+            traceId: event.traceId,
+            label: event.label,
+            scope: event.scope,
+            status: "running",
+            spans: new Map(),
+            startedAt: event.timestamp,
+            updatedAt: event.timestamp,
+        });
+    }
+    handleSpanStart(event) {
+        const trace = this.traces.get(event.traceId);
+        if (!trace)
+            return;
+        const span = {
+            spanId: event.spanId,
+            parentSpanId: event.parentSpanId,
+            name: event.name,
+            status: "running",
+            attributes: event.attributes,
+            events: [],
+            children: [],
+            startedAt: event.timestamp,
+            isStep: event.attributes["ui.step"] === true,
+        };
+        const newSpans = new Map(trace.spans);
+        newSpans.set(event.spanId, span);
+        // Add as child of parent span
+        if (event.parentSpanId) {
+            const parent = newSpans.get(event.parentSpanId);
+            if (parent) {
+                newSpans.set(event.parentSpanId, {
+                    ...parent,
+                    children: [...parent.children, span],
+                });
+            }
+        }
+        this.traces = new Map(this.traces);
+        this.traces.set(event.traceId, {
+            ...trace,
+            spans: newSpans,
+            rootSpanId: trace.rootSpanId ?? event.spanId,
+            updatedAt: event.timestamp,
+        });
+    }
+    handleSpanEnd(event) {
+        const trace = this.traces.get(event.traceId);
+        if (!trace)
+            return;
+        const span = trace.spans.get(event.spanId);
+        if (!span)
+            return;
+        const newSpans = new Map(trace.spans);
+        const updatedSpan = {
+            ...span,
+            status: event.status,
+            durationMs: event.durationMs,
+        };
+        newSpans.set(event.spanId, updatedSpan);
+        // Update in parent's children array too
+        if (span.parentSpanId) {
+            const parent = newSpans.get(span.parentSpanId);
+            if (parent) {
+                newSpans.set(span.parentSpanId, {
+                    ...parent,
+                    children: parent.children.map((c) => (c.spanId === event.spanId ? updatedSpan : c)),
+                });
+            }
+        }
+        this.traces = new Map(this.traces);
+        this.traces.set(event.traceId, {
+            ...trace,
+            spans: newSpans,
+            updatedAt: event.timestamp,
+        });
+    }
+    handleSpanEvent(event) {
+        const trace = this.traces.get(event.traceId);
+        if (!trace)
+            return;
+        const span = trace.spans.get(event.spanId);
+        if (!span)
+            return;
+        const entry = {
+            name: event.name,
+            level: event.level,
+            attributes: event.attributes,
+            timestamp: event.timestamp,
+        };
+        const newEvents = span.events.length >= MAX_SPAN_EVENTS ? [...span.events.slice(-MAX_SPAN_EVENTS + 1), entry] : [...span.events, entry];
+        const newSpans = new Map(trace.spans);
+        newSpans.set(event.spanId, { ...span, events: newEvents });
+        this.traces = new Map(this.traces);
+        this.traces.set(event.traceId, {
+            ...trace,
+            spans: newSpans,
+            updatedAt: event.timestamp,
+        });
+    }
+    handleTraceEnd(event) {
+        const trace = this.traces.get(event.traceId);
+        if (!trace)
+            return;
+        // Close any still-running spans (handles lost SpanEnd events)
+        const finalStatus = event.status === "completed" ? "ok" : "error";
+        let newSpans = trace.spans;
+        let hasRunningSpans = false;
+        for (const span of trace.spans.values()) {
+            if (span.status === "running") {
+                hasRunningSpans = true;
+                break;
+            }
+        }
+        if (hasRunningSpans) {
+            newSpans = new Map(trace.spans);
+            for (const [id, span] of newSpans) {
+                if (span.status === "running") {
+                    newSpans.set(id, { ...span, status: finalStatus, durationMs: event.timestamp - span.startedAt });
+                }
+            }
+        }
+        this.traces = new Map(this.traces);
+        this.traces.set(event.traceId, {
+            ...trace,
+            spans: newSpans,
+            status: event.status === "completed" ? "completed" : "failed",
+            completedAt: event.timestamp,
+            durationMs: event.durationMs,
+            error: event.error,
+            updatedAt: event.timestamp,
+        });
+    }
+    cleanup() {
+        const now = Date.now();
+        let changed = false;
+        for (const [traceId, trace] of this.traces) {
+            if (trace.completedAt && now - trace.completedAt > COMPLETED_TTL_MS) {
+                if (!changed) {
+                    this.traces = new Map(this.traces);
+                    changed = true;
+                }
+                this.traces.delete(traceId);
+            }
+        }
+        if (changed)
+            this.notify();
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+}
+/** Singleton store instance */
+let _store = null;
+export function getTraceStore() {
+    if (!_store) {
+        _store = new TraceStore();
+    }
+    return _store;
+}
+//# sourceMappingURL=store.js.map

package/dist/react/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../react/store.ts"],"names":[],"mappings":"AAmDA,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,8BAA8B;AAC9B,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,uDAAuD;AACvD,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAIzC,MAAM,OAAO,UAAU;IACX,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAChC,YAAY,GAA0C,IAAI,CAAC;IAEnE;QACI,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IAED,4DAA4D;IAC5D,SAAS,GAAG,CAAC,QAAkB,EAAgB,EAAE;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,8CAA8C;IAC9C,WAAW,GAAG,GAA4B,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IAEzD,oCAAoC;IACpC,QAAQ,CAAC,KAAiB;QACtB,gCAAgC;QAChC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,iBAAiB;YAAE,OAAO;QAE7D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,YAAY;gBACb,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAC7B,MAAM;YACV,KAAK,WAAW;gBACZ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;YACV,KAAK,SAAS;gBACV,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC1B,MAAM;YACV,KAAK,WAAW;gBACZ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;YACV,KAAK,UAAU;gBACX,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM;QACd,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,iCAAiC;IACjC,aAAa,CAAC,MAAoB;QAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,kCAAkC;YAClC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,iBAAiB;gBAAE,SAAS;YAC/D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,YAAY;oBACb,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBAC7B,MAAM;gBACV,KAAK,WAAW;oBACZ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;oBAC5B,MAAM;gBACV,KAAK,SAAS;oBACV,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;oBAC1B,MAAM;gBACV,KAAK,WAAW;oBACZ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;oBAC5B,MAAM;gBACV,KAAK,UAAU;oBACX,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;oBAC3B,MAAM;YACd,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,yBAAyB;IACzB,QAAQ,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,8DAA8D;IAC9D,YAAY;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED,0DAA0D;IAC1D,QAAQ,CAAC,OAAe;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACvB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,sCAAsC;IACtC,WAAW,CAAC,OAAe;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACH,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,uBAAuB;IAEf,gBAAgB,CAAC,KAAiB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ;YAAE,OAAO,CAAC,aAAa;QAEnC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;IACP,CAAC;IAEO,eAAe,CAAC,KAAgB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,IAAI,GAAa;YACnB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI;SAC/C,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEjC,8BAA8B;QAC9B,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,MAAM,EAAE,CAAC;gBACT,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE;oBAC7B,GAAG,MAAM;oBACT,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;iBACvC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG,KAAK;YACR,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM;YAC5C,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;IACP,CAAC;IAEO,aAAa,CAAC,KAAc;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG;YAChB,GAAG,IAAI;YACP,MAAM,EAAE,KAAK,CAAC,MAAwB;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC/B,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAExC,wCAAwC;QACxC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACT,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE;oBAC5B,GAAG,MAAM;oBACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACtF,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG,KAAK;YACR,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;IACP,CAAC;IAEO,eAAe,CAAC,KAAgB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,KAAK,GAAmB;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAExI,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG,KAAK;YACR,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;IACP,CAAC;IAEO,cAAc,CAAC,KAAe;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,8DAA8D;QAC9D,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAE,IAAc,CAAC,CAAC,CAAE,OAAiB,CAAC;QACxF,IAAI,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC5B,eAAe,GAAG,IAAI,CAAC;gBACvB,MAAM;YACV,CAAC;QACL,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YAClB,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBACrG,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG,KAAK;YACR,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;YAC7D,WAAW,EAAE,KAAK,CAAC,SAAS;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;IACP,CAAC;IAEO,OAAO;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,WAAW,IAAI,GAAG,GAAG,KAAK,CAAC,WAAW,GAAG,gBAAgB,EAAE,CAAC;gBAClE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACX,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACnC,OAAO,GAAG,IAAI,CAAC;gBACnB,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;QAED,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAEO,MAAM;QACV,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,QAAQ,EAAE,CAAC;QACf,CAAC;IACL,CAAC;CACJ;AAED,+BAA+B;AAC/B,IAAI,MAAM,GAAsB,IAAI,CAAC;AAErC,MAAM,UAAU,aAAa;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/LiveTrace.d.ts

@@ -0,0 +1,55 @@
+import type { AnySpan } from "effect/Tracer";
+/**
+ * LiveTrace — User-facing API for starting traced scopes.
+ *
+ * Usage:
+ * ```ts
+ * yield* pipe(
+ *   myWorkflow,
+ *   LiveTrace.withTrace({
+ *     traceId: `doc:${documentId}`,
+ *     label: "Processing report.pdf",
+ *     scope: { type: "team", id: teamId },
+ *   }),
+ * )
+ * ```
+ *
+ * Inside the scope, all `Effect.withSpan` and `Effect.log` calls
+ * are automatically captured and streamed to the frontend.
+ */
+import * as Effect from "effect/Effect";
+import * as FiberRef from "effect/FiberRef";
+import { type TraceScope } from "./types.js";
+export interface LiveTraceConfig {
+    /** Logical trace ID for stream routing (e.g., "doc:abc123") */
+    readonly traceId: string;
+    /** Human-readable label (e.g., filename) */
+    readonly label: string;
+    /** Stream routing scope */
+    readonly scope: TraceScope;
+    /** Optional provider key for source-page filtering (e.g. "notion", "google-drive") */
+    readonly provider?: string;
+}
+/**
+ * FiberRef that holds the current WrappedSpan (if inside a withTrace/step scope).
+ * Used by LiveTraceLogger to bridge Effect.log() → SpanEvent automatically.
+ * Inherited by child fibers so forked work stays attributed to the correct span.
+ */
+export declare const LiveSpanRef: FiberRef.FiberRef<AnySpan | null>;
+/**
+ * Wrap an effect in a live-traced scope.
+ *
+ * All `Effect.withSpan` and `Effect.log` calls within this scope
+ * are captured by the LiveTraceLayer and streamed to the sink.
+ */
+export declare const withTrace: (config: LiveTraceConfig) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Create a traced step span. Shows as a top-level section in the UI.
+ *
+ * ```ts
+ * yield* LiveTrace.step("Parsing")(parseDocument(doc))
+ * yield* LiveTrace.step("Embedding")(embedChunks(chunks))
+ * ```
+ */
+export declare const step: (name: string, attributes?: Record<string, unknown>) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+//# sourceMappingURL=LiveTrace.d.ts.map

package/dist/src/LiveTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveTrace.d.ts","sourceRoot":"","sources":["../../src/LiveTrace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAOH,KAAK,UAAU,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAA6C,CAAC;AAexG;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACjB,QAAQ,eAAe,MACvB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAU1D,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GACZ,MAAM,MAAM,EAAE,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAClD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAG1D,CAAC"}

package/dist/src/LiveTrace.js

@@ -0,0 +1,66 @@
+/**
+ * LiveTrace — User-facing API for starting traced scopes.
+ *
+ * Usage:
+ * ```ts
+ * yield* pipe(
+ *   myWorkflow,
+ *   LiveTrace.withTrace({
+ *     traceId: `doc:${documentId}`,
+ *     label: "Processing report.pdf",
+ *     scope: { type: "team", id: teamId },
+ *   }),
+ * )
+ * ```
+ *
+ * Inside the scope, all `Effect.withSpan` and `Effect.log` calls
+ * are automatically captured and streamed to the frontend.
+ */
+import * as Effect from "effect/Effect";
+import * as FiberRef from "effect/FiberRef";
+import { LIVE_TRACE, LIVE_TRACE_ID, LIVE_TRACE_LABEL, LIVE_TRACE_PROVIDER, LIVE_TRACE_SCOPE_ID, LIVE_TRACE_SCOPE_TYPE, UI_STEP, } from "./types.js";
+/**
+ * FiberRef that holds the current WrappedSpan (if inside a withTrace/step scope).
+ * Used by LiveTraceLogger to bridge Effect.log() → SpanEvent automatically.
+ * Inherited by child fibers so forked work stays attributed to the correct span.
+ */
+export const LiveSpanRef = FiberRef.unsafeMake(null);
+/**
+ * After Effect.withSpan creates the span, read it via Effect.currentSpan
+ * and store it in LiveSpanRef so the Logger can access it synchronously.
+ */
+const propagateSpan = (effect) => Effect.gen(function* () {
+    const span = yield* Effect.currentSpan.pipe(Effect.orElseSucceed(() => null));
+    if (span) {
+        yield* FiberRef.set(LiveSpanRef, span);
+    }
+    return yield* effect;
+});
+/**
+ * Wrap an effect in a live-traced scope.
+ *
+ * All `Effect.withSpan` and `Effect.log` calls within this scope
+ * are captured by the LiveTraceLayer and streamed to the sink.
+ */
+export const withTrace = (config) => (effect) => Effect.withSpan(propagateSpan(effect), config.label, {
+    attributes: {
+        [LIVE_TRACE]: true,
+        [LIVE_TRACE_ID]: config.traceId,
+        [LIVE_TRACE_LABEL]: config.label,
+        [LIVE_TRACE_SCOPE_TYPE]: config.scope.type,
+        [LIVE_TRACE_SCOPE_ID]: config.scope.id,
+        ...(config.provider !== undefined ? { [LIVE_TRACE_PROVIDER]: config.provider } : {}),
+    },
+});
+/**
+ * Create a traced step span. Shows as a top-level section in the UI.
+ *
+ * ```ts
+ * yield* LiveTrace.step("Parsing")(parseDocument(doc))
+ * yield* LiveTrace.step("Embedding")(embedChunks(chunks))
+ * ```
+ */
+export const step = (name, attributes) => (effect) => Effect.withSpan(propagateSpan(effect), name, {
+    attributes: { [UI_STEP]: true, ...attributes },
+});
+//# sourceMappingURL=LiveTrace.js.map

package/dist/src/LiveTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveTrace.js","sourceRoot":"","sources":["../../src/LiveTrace.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACH,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EAErB,OAAO,GACV,MAAM,YAAY,CAAC;AAapB;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsC,QAAQ,CAAC,UAAU,CAAiB,IAAI,CAAC,CAAC;AAExG;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAU,MAA8B,EAA0B,EAAE,CACtF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,EAAE,CAAC;QACP,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC;AACzB,CAAC,CAA2B,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAClB,CAAC,MAAuB,EAAE,EAAE,CAC5B,CAAU,MAA8B,EAA0B,EAAE,CAChE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE;IACjD,UAAU,EAAE;QACR,CAAC,UAAU,CAAC,EAAE,IAAI;QAClB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,OAAO;QAC/B,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,KAAK;QAChC,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;QAC1C,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;QACtC,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvF;CACJ,CAAC,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GACb,CAAC,IAAY,EAAE,UAAoC,EAAE,EAAE,CACvD,CAAU,MAA8B,EAA0B,EAAE,CAChE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE;IACzC,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE;CACjD,CAAC,CAAC"}

package/dist/src/Logger.d.ts

@@ -0,0 +1,3 @@
+import * as Logger from "effect/Logger";
+export declare const liveTraceLogger: Logger.Logger<unknown, void>;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/src/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/Logger.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,eAAO,MAAM,eAAe,8BAa1B,CAAC"}

package/dist/src/Logger.js

@@ -0,0 +1,30 @@
+/**
+ * LiveTraceLogger — Bridges Effect.log() → SpanEvent automatically.
+ *
+ * When inside a `withTrace()` or `step()` scope, this Logger reads
+ * the current WrappedSpan from LiveSpanRef and calls span.event()
+ * so the log message appears in the trace card's step event list.
+ *
+ * Outside a traced scope, this Logger is a no-op (other loggers
+ * like Logger.pretty still handle the log normally).
+ *
+ * Wire via `Logger.add(liveTraceLogger)` in the services layer.
+ */
+import * as FiberRefs from "effect/FiberRefs";
+import * as HashMap from "effect/HashMap";
+import * as Logger from "effect/Logger";
+import { LiveSpanRef } from "./LiveTrace.js";
+import { isWrappedSpan } from "./WrappedSpan.js";
+export const liveTraceLogger = Logger.make(({ message, logLevel, context: fiberRefs, annotations }) => {
+    const span = FiberRefs.getOrDefault(fiberRefs, LiveSpanRef);
+    if (!span || !isWrappedSpan(span))
+        return;
+    // Flatten message to string
+    const msg = Array.isArray(message) ? message.join(" ") : String(message);
+    const attrs = { "effect.logLevel": logLevel.label };
+    for (const [k, v] of HashMap.entries(annotations)) {
+        attrs[k] = v;
+    }
+    span.event(msg, BigInt(Date.now()) * 1000000n, attrs);
+});
+//# sourceMappingURL=Logger.js.map

package/dist/src/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE;IAClG,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO;IAE1C,4BAA4B;IAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEzE,MAAM,KAAK,GAA4B,EAAE,iBAAiB,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC7E,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAU,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC"}

package/dist/src/Schema.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Effect Schema wrappers for TraceEvent types.
+ *
+ * Used for runtime NDJSON validation. Optional — consumers
+ * can use plain types from "./types" if they don't need validation.
+ */
+import * as Schema from "effect/Schema";
+export declare const TraceScopeSchema: Schema.Struct<{
+    type: Schema.Literal<["team", "org", "user"]>;
+    id: typeof Schema.String;
+}>;
+export declare const TraceStartSchema: Schema.Struct<{
+    _tag: Schema.Literal<["TraceStart"]>;
+    traceId: typeof Schema.String;
+    label: typeof Schema.String;
+    scope: Schema.Struct<{
+        type: Schema.Literal<["team", "org", "user"]>;
+        id: typeof Schema.String;
+    }>;
+    timestamp: typeof Schema.Number;
+}>;
+export declare const SpanStartSchema: Schema.Struct<{
+    _tag: Schema.Literal<["SpanStart"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    parentSpanId: Schema.optional<typeof Schema.String>;
+    name: typeof Schema.String;
+    attributes: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    timestamp: typeof Schema.Number;
+}>;
+export declare const SpanEndSchema: Schema.Struct<{
+    _tag: Schema.Literal<["SpanEnd"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    status: Schema.Literal<["ok", "error"]>;
+    durationMs: typeof Schema.Number;
+    timestamp: typeof Schema.Number;
+}>;
+export declare const SpanEventSchema: Schema.Struct<{
+    _tag: Schema.Literal<["SpanEvent"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    name: typeof Schema.String;
+    level: Schema.optional<Schema.Literal<["Debug", "Info", "Warning", "Error"]>>;
+    attributes: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    timestamp: typeof Schema.Number;
+}>;
+export declare const TraceEndSchema: Schema.Struct<{
+    _tag: Schema.Literal<["TraceEnd"]>;
+    traceId: typeof Schema.String;
+    status: Schema.Literal<["completed", "failed"]>;
+    durationMs: typeof Schema.Number;
+    error: Schema.optional<typeof Schema.String>;
+    timestamp: typeof Schema.Number;
+}>;
+export declare const TraceEventSchema: Schema.Union<[Schema.Struct<{
+    _tag: Schema.Literal<["TraceStart"]>;
+    traceId: typeof Schema.String;
+    label: typeof Schema.String;
+    scope: Schema.Struct<{
+        type: Schema.Literal<["team", "org", "user"]>;
+        id: typeof Schema.String;
+    }>;
+    timestamp: typeof Schema.Number;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["SpanStart"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    parentSpanId: Schema.optional<typeof Schema.String>;
+    name: typeof Schema.String;
+    attributes: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    timestamp: typeof Schema.Number;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["SpanEnd"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    status: Schema.Literal<["ok", "error"]>;
+    durationMs: typeof Schema.Number;
+    timestamp: typeof Schema.Number;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["SpanEvent"]>;
+    traceId: typeof Schema.String;
+    spanId: typeof Schema.String;
+    name: typeof Schema.String;
+    level: Schema.optional<Schema.Literal<["Debug", "Info", "Warning", "Error"]>>;
+    attributes: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    timestamp: typeof Schema.Number;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["TraceEnd"]>;
+    traceId: typeof Schema.String;
+    status: Schema.Literal<["completed", "failed"]>;
+    durationMs: typeof Schema.Number;
+    error: Schema.optional<typeof Schema.String>;
+    timestamp: typeof Schema.Number;
+}>]>;
+export type TraceEventEncoded = Schema.Schema.Encoded<typeof TraceEventSchema>;
+//# sourceMappingURL=Schema.d.ts.map

package/dist/src/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/Schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,eAAO,MAAM,gBAAgB;;;EAG3B,CAAC;AAMH,eAAO,MAAM,gBAAgB;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;EAQ1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;EAQ1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAkG,CAAC;AAEhI,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/src/Schema.js

@@ -0,0 +1,60 @@
+/**
+ * Effect Schema wrappers for TraceEvent types.
+ *
+ * Used for runtime NDJSON validation. Optional — consumers
+ * can use plain types from "./types" if they don't need validation.
+ */
+import * as Schema from "effect/Schema";
+// ============================================================================
+// Scope
+// ============================================================================
+export const TraceScopeSchema = Schema.Struct({
+    type: Schema.Literal("team", "org", "user"),
+    id: Schema.String,
+});
+// ============================================================================
+// Events
+// ============================================================================
+export const TraceStartSchema = Schema.Struct({
+    _tag: Schema.Literal("TraceStart"),
+    traceId: Schema.String,
+    label: Schema.String,
+    scope: TraceScopeSchema,
+    timestamp: Schema.Number,
+});
+export const SpanStartSchema = Schema.Struct({
+    _tag: Schema.Literal("SpanStart"),
+    traceId: Schema.String,
+    spanId: Schema.String,
+    parentSpanId: Schema.optional(Schema.String),
+    name: Schema.String,
+    attributes: Schema.Record({ key: Schema.String, value: Schema.Unknown }),
+    timestamp: Schema.Number,
+});
+export const SpanEndSchema = Schema.Struct({
+    _tag: Schema.Literal("SpanEnd"),
+    traceId: Schema.String,
+    spanId: Schema.String,
+    status: Schema.Literal("ok", "error"),
+    durationMs: Schema.Number,
+    timestamp: Schema.Number,
+});
+export const SpanEventSchema = Schema.Struct({
+    _tag: Schema.Literal("SpanEvent"),
+    traceId: Schema.String,
+    spanId: Schema.String,
+    name: Schema.String,
+    level: Schema.optional(Schema.Literal("Debug", "Info", "Warning", "Error")),
+    attributes: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+    timestamp: Schema.Number,
+});
+export const TraceEndSchema = Schema.Struct({
+    _tag: Schema.Literal("TraceEnd"),
+    traceId: Schema.String,
+    status: Schema.Literal("completed", "failed"),
+    durationMs: Schema.Number,
+    error: Schema.optional(Schema.String),
+    timestamp: Schema.Number,
+});
+export const TraceEventSchema = Schema.Union(TraceStartSchema, SpanStartSchema, SpanEndSchema, SpanEventSchema, TraceEndSchema);
+//# sourceMappingURL=Schema.js.map

package/dist/src/Schema.js.map

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