wotann 0.5.0

package/dist/telemetry/observability-export.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Observability Export — LangSmith + Langfuse trace export.
+ * Every tool call, LLM query, and decision is logged and exportable.
+ * DeerFlow-inspired dual observability.
+ */
+export interface TraceEvent {
+    readonly id: string;
+    readonly parentId?: string;
+    readonly type: "llm_call" | "tool_call" | "decision" | "error" | "metric";
+    readonly name: string;
+    readonly input: string;
+    readonly output: string;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly metadata: Readonly<Record<string, unknown>>;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly tokensUsed?: number;
+    readonly costUsd?: number;
+}
+export interface TraceSession {
+    readonly sessionId: string;
+    readonly startTime: number;
+    readonly events: readonly TraceEvent[];
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+export type ExportFormat = "langsmith" | "langfuse" | "jsonl" | "otlp";
+export interface OTLPSpan {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly name: string;
+    readonly kind: "INTERNAL" | "CLIENT" | "SERVER";
+    readonly startTimeUnixNano: string;
+    readonly endTimeUnixNano: string;
+    readonly attributes: readonly OTLPAttribute[];
+    readonly status: {
+        readonly code: "OK" | "ERROR";
+        readonly message?: string;
+    };
+}
+export interface OTLPAttribute {
+    readonly key: string;
+    readonly value: {
+        readonly stringValue?: string;
+        readonly intValue?: string;
+    };
+}
+export interface ExportConfig {
+    readonly format: ExportFormat;
+    readonly endpoint?: string;
+    readonly apiKey?: string;
+    readonly batchSize: number;
+    readonly flushIntervalMs: number;
+    /**
+     * V9 T14.1 — Optional inbound HTTP headers carrying a W3C
+     * `traceparent`. When supplied, the OTLP exporter parses + uses
+     * the parent's traceId for outbound spans so cross-service traces
+     * link up. When absent, a fresh root traceId is generated per flush.
+     */
+    readonly inboundHeaders?: Readonly<Record<string, string | readonly string[] | undefined>>;
+}
+export declare class ObservabilityExporter {
+    private readonly events;
+    private readonly config;
+    private readonly logDir;
+    private flushTimer;
+    constructor(wotannDir: string, config?: Partial<ExportConfig>);
+    /**
+     * Record a trace event.
+     *
+     * Honours the telemetry opt-out gate — if the user set DO_NOT_TRACK=1,
+     * WOTANN_NO_TELEMETRY=1, or dropped a ~/.wotann/no-telemetry sentinel,
+     * the event is silently dropped. Local JSONL still runs so users keep
+     * their own logs; only remote exports are suppressed, but we suppress
+     * everything here as a defence in depth.
+     */
+    record(event: TraceEvent): void;
+    /**
+     * Record an LLM call.
+     */
+    recordLLMCall(params: {
+        name: string;
+        input: string;
+        output: string;
+        provider: string;
+        model: string;
+        tokensUsed: number;
+        costUsd: number;
+        durationMs: number;
+        parentId?: string;
+    }): void;
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(params: {
+        name: string;
+        args: string;
+        result: string;
+        success: boolean;
+        durationMs: number;
+        parentId?: string;
+    }): void;
+    /**
+     * Record a decision event (architectural, routing, model selection, etc.).
+     */
+    recordDecision(params: {
+        name: string;
+        input: string;
+        decision: string;
+        reasoning: string;
+        parentId?: string;
+    }): void;
+    /**
+     * Record a metric event (latency, token count, cost, etc.).
+     */
+    recordMetric(params: {
+        name: string;
+        value: number;
+        unit: string;
+        parentId?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    /**
+     * Get a session snapshot with all pending events.
+     */
+    getSession(sessionId: string): TraceSession;
+    /**
+     * Flush events to the configured export target.
+     */
+    flush(): void;
+    /**
+     * Stop the exporter and flush remaining events.
+     */
+    stop(): void;
+    /**
+     * Get event count (for monitoring).
+     */
+    getEventCount(): number;
+    private exportJSONL;
+    private exportLangSmith;
+    private exportLangfuse;
+    private exportOTLP;
+}
+//# sourceMappingURL=observability-export.d.ts.map

package/dist/telemetry/observability-export.d.ts.map

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

package/dist/telemetry/observability-export.js

@@ -0,0 +1,339 @@
+/**
+ * Observability Export — LangSmith + Langfuse trace export.
+ * Every tool call, LLM query, and decision is logged and exportable.
+ * DeerFlow-inspired dual observability.
+ */
+import { existsSync, mkdirSync, appendFileSync } from "node:fs";
+import { writeFileAtomic } from "../utils/atomic-io.js";
+import { join } from "node:path";
+import { isTelemetryOptedOut } from "./opt-out.js";
+// V9 T14.1 — W3C Trace Context helpers. Used by the OTLP exporter to
+// emit a spec-compliant `traceparent` header alongside each batch and
+// to honor inbound parent context when the caller supplies one. This
+// makes WOTANN telemetry interoperable with any OpenTelemetry-aware
+// collector (Jaeger, Tempo, Datadog, Honeycomb).
+import { buildTraceparent, childOf, extractTraceparent, formatTraceparent, generateTraceId as generateW3cTraceId, parseTraceparent, } from "./traceparent.js";
+// ── Observability Exporter ───────────────────────────────
+export class ObservabilityExporter {
+    events = [];
+    config;
+    logDir;
+    flushTimer = null;
+    constructor(wotannDir, config) {
+        this.logDir = join(wotannDir, "traces");
+        this.config = {
+            format: "jsonl",
+            batchSize: 100,
+            flushIntervalMs: 30_000,
+            ...config,
+        };
+        if (!existsSync(this.logDir)) {
+            mkdirSync(this.logDir, { recursive: true });
+        }
+        // Auto-flush on interval
+        this.flushTimer = setInterval(() => this.flush(), this.config.flushIntervalMs);
+    }
+    /**
+     * Record a trace event.
+     *
+     * Honours the telemetry opt-out gate — if the user set DO_NOT_TRACK=1,
+     * WOTANN_NO_TELEMETRY=1, or dropped a ~/.wotann/no-telemetry sentinel,
+     * the event is silently dropped. Local JSONL still runs so users keep
+     * their own logs; only remote exports are suppressed, but we suppress
+     * everything here as a defence in depth.
+     */
+    record(event) {
+        if (isTelemetryOptedOut())
+            return;
+        this.events.push(event);
+        // Auto-flush when batch is full
+        if (this.events.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    /**
+     * Record an LLM call.
+     */
+    recordLLMCall(params) {
+        const now = Date.now();
+        this.record({
+            id: `llm-${now}`,
+            parentId: params.parentId,
+            type: "llm_call",
+            name: params.name,
+            input: params.input.slice(0, 1000),
+            output: params.output.slice(0, 1000),
+            startTime: now - params.durationMs,
+            endTime: now,
+            metadata: {},
+            provider: params.provider,
+            model: params.model,
+            tokensUsed: params.tokensUsed,
+            costUsd: params.costUsd,
+        });
+    }
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(params) {
+        const now = Date.now();
+        this.record({
+            id: `tool-${now}`,
+            parentId: params.parentId,
+            type: "tool_call",
+            name: params.name,
+            input: params.args.slice(0, 500),
+            output: params.result.slice(0, 500),
+            startTime: now - params.durationMs,
+            endTime: now,
+            metadata: { success: params.success },
+        });
+    }
+    /**
+     * Record a decision event (architectural, routing, model selection, etc.).
+     */
+    recordDecision(params) {
+        const now = Date.now();
+        this.record({
+            id: `decision-${now}`,
+            parentId: params.parentId,
+            type: "decision",
+            name: params.name,
+            input: params.input.slice(0, 500),
+            output: params.decision.slice(0, 500),
+            startTime: now,
+            endTime: now,
+            metadata: { reasoning: params.reasoning },
+        });
+    }
+    /**
+     * Record a metric event (latency, token count, cost, etc.).
+     */
+    recordMetric(params) {
+        const now = Date.now();
+        this.record({
+            id: `metric-${now}`,
+            type: "metric",
+            name: params.name,
+            input: String(params.value),
+            output: params.unit,
+            startTime: now,
+            endTime: now,
+            metadata: { ...params.metadata, value: params.value, unit: params.unit },
+            parentId: params.parentId,
+        });
+    }
+    /**
+     * Get a session snapshot with all pending events.
+     */
+    getSession(sessionId) {
+        return {
+            sessionId,
+            startTime: this.events.length > 0 ? this.events[0].startTime : Date.now(),
+            events: [...this.events],
+            metadata: { format: this.config.format },
+        };
+    }
+    /**
+     * Flush events to the configured export target.
+     */
+    flush() {
+        if (this.events.length === 0)
+            return;
+        const batch = this.events.splice(0);
+        switch (this.config.format) {
+            case "jsonl":
+                this.exportJSONL(batch);
+                break;
+            case "langsmith":
+                this.exportLangSmith(batch);
+                break;
+            case "langfuse":
+                this.exportLangfuse(batch);
+                break;
+            case "otlp":
+                this.exportOTLP(batch);
+                break;
+            default:
+                this.exportJSONL(batch);
+        }
+    }
+    /**
+     * Stop the exporter and flush remaining events.
+     */
+    stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.flush();
+    }
+    /**
+     * Get event count (for monitoring).
+     */
+    getEventCount() {
+        return this.events.length;
+    }
+    // ── Export Implementations ──────────────────────────────
+    exportJSONL(events) {
+        const date = new Date().toISOString().slice(0, 10);
+        const filePath = join(this.logDir, `trace-${date}.jsonl`);
+        const lines = events.map((e) => JSON.stringify(e)).join("\n") + "\n";
+        appendFileSync(filePath, lines, "utf-8");
+    }
+    exportLangSmith(events) {
+        // LangSmith format: POST to /api/v1/runs
+        // In production, would use fetch() to send to LangSmith API
+        // For now, export as LangSmith-compatible JSONL
+        const formatted = events.map((e) => ({
+            id: e.id,
+            parent_run_id: e.parentId,
+            name: e.name,
+            run_type: e.type === "llm_call" ? "llm" : e.type === "tool_call" ? "tool" : "chain",
+            inputs: { input: e.input },
+            outputs: { output: e.output },
+            start_time: new Date(e.startTime).toISOString(),
+            end_time: new Date(e.endTime).toISOString(),
+            extra: e.metadata,
+        }));
+        const filePath = join(this.logDir, `langsmith-${Date.now()}.jsonl`);
+        // Wave 6.5-UU (H-22) — telemetry export. Atomic write.
+        writeFileAtomic(filePath, formatted.map((f) => JSON.stringify(f)).join("\n") + "\n", {
+            encoding: "utf-8",
+        });
+    }
+    exportLangfuse(events) {
+        // Langfuse format: POST to /api/public/ingestion
+        const formatted = events.map((e) => ({
+            id: e.id,
+            type: e.type === "llm_call" ? "generation" : "span",
+            name: e.name,
+            startTime: new Date(e.startTime).toISOString(),
+            endTime: new Date(e.endTime).toISOString(),
+            input: e.input,
+            output: e.output,
+            model: e.model,
+            usage: e.tokensUsed ? { totalTokens: e.tokensUsed } : undefined,
+            metadata: e.metadata,
+        }));
+        const filePath = join(this.logDir, `langfuse-${Date.now()}.jsonl`);
+        // Wave 6.5-UU (H-22) — telemetry export. Atomic write.
+        writeFileAtomic(filePath, formatted.map((f) => JSON.stringify(f)).join("\n") + "\n", {
+            encoding: "utf-8",
+        });
+    }
+    exportOTLP(events) {
+        // OpenTelemetry Protocol format — OTLP/JSON
+        // In production, would POST to an OTLP collector endpoint.
+        // For now, export as OTLP-compatible JSON for file-based collection.
+        //
+        // V9 T14.1 — Honor inbound W3C `traceparent` for cross-service
+        // span linking. When the caller passed `inboundHeaders` carrying a
+        // traceparent, parse it and reuse its traceId so the OTLP spans
+        // chain up to the upstream parent. Absent headers → generate a
+        // fresh W3C-spec traceId.
+        const inbound = this.config.inboundHeaders
+            ? extractTraceparent(this.config.inboundHeaders)
+            : null;
+        const traceId = inbound?.traceId ?? generateTraceId();
+        // Build the header we'd emit on outbound HTTP for the next hop.
+        // Either propagate the inbound parent into a fresh child span, or
+        // open a brand-new root traceparent. We don't actually send it
+        // (this exporter is file-backed) but we record it on the payload
+        // so downstream collectors can correlate.
+        const outboundParent = inbound
+            ? childOf(inbound)
+            : (parseTraceparent(buildTraceparent({ traceId })) ?? null);
+        const outboundHeader = outboundParent ? formatTraceparent(outboundParent) : null;
+        const spans = events.map((e) => {
+            const attributes = [
+                { key: "wotann.event.type", value: { stringValue: e.type } },
+                { key: "wotann.event.name", value: { stringValue: e.name } },
+            ];
+            if (e.provider) {
+                attributes.push({ key: "llm.provider", value: { stringValue: e.provider } });
+            }
+            if (e.model) {
+                attributes.push({ key: "llm.model", value: { stringValue: e.model } });
+            }
+            if (e.tokensUsed !== undefined) {
+                attributes.push({ key: "llm.tokens", value: { intValue: String(e.tokensUsed) } });
+            }
+            if (e.costUsd !== undefined) {
+                attributes.push({ key: "llm.cost_usd", value: { stringValue: e.costUsd.toFixed(6) } });
+            }
+            for (const [key, val] of Object.entries(e.metadata)) {
+                attributes.push({
+                    key: `wotann.meta.${key}`,
+                    value: { stringValue: String(val) },
+                });
+            }
+            return {
+                traceId,
+                spanId: e.id
+                    .replace(/[^a-f0-9]/g, "")
+                    .slice(0, 16)
+                    .padEnd(16, "0"),
+                parentSpanId: e.parentId
+                    ?.replace(/[^a-f0-9]/g, "")
+                    .slice(0, 16)
+                    .padEnd(16, "0"),
+                name: e.name,
+                kind: e.type === "llm_call" ? "CLIENT" : "INTERNAL",
+                startTimeUnixNano: String(e.startTime * 1_000_000),
+                endTimeUnixNano: String(e.endTime * 1_000_000),
+                attributes,
+                status: {
+                    code: e.type === "error" ? "ERROR" : "OK",
+                    message: e.type === "error" ? e.output : undefined,
+                },
+            };
+        });
+        const otlpPayload = {
+            resourceSpans: [
+                {
+                    resource: {
+                        attributes: [
+                            { key: "service.name", value: { stringValue: "wotann" } },
+                            { key: "service.version", value: { stringValue: "0.1.0" } },
+                        ],
+                    },
+                    scopeSpans: [
+                        {
+                            scope: { name: "wotann-telemetry", version: "0.1.0" },
+                            spans,
+                        },
+                    ],
+                },
+            ],
+            // V9 T14.1 — outbound W3C traceparent + (when relevant) the
+            // inbound parent. Downstream collectors / agents that pick up
+            // this file can use the headers to link the trace into a
+            // distributed view (Jaeger / Tempo / Datadog).
+            ...(outboundHeader ? { traceparent: outboundHeader } : {}),
+            ...(inbound ? { _inboundTraceparent: formatTraceparent(inbound) } : {}),
+        };
+        const filePath = join(this.logDir, `otlp-${Date.now()}.json`);
+        // Wave 6.5-UU (H-22) — telemetry OTLP export. Atomic write.
+        writeFileAtomic(filePath, JSON.stringify(otlpPayload, null, 2), { encoding: "utf-8" });
+    }
+}
+// ── Helpers ──────────────────────────────────────────────
+/**
+ * V9 T14.1 — Generate a W3C-spec-compliant 32-hex-char trace ID.
+ * Delegates to the canonical helper in `traceparent.ts` (which uses
+ * crypto.randomBytes and rejects all-zero ids per spec). Kept as a
+ * local wrapper so the exportOTLP code reads naturally.
+ */
+function generateTraceId() {
+    return generateW3cTraceId();
+}
+// Legacy weak-random implementation (unreachable, kept for reference).
+function _legacyGenerateTraceId() {
+    const bytes = [];
+    for (let i = 0; i < 32; i++) {
+        bytes.push(Math.floor(Math.random() * 16).toString(16));
+    }
+    return bytes.join("");
+}
+//# sourceMappingURL=observability-export.js.map

package/dist/telemetry/observability-export.js.map

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

package/dist/telemetry/opt-out.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Telemetry opt-out gate (A10).
+ *
+ * Honours the standard `DO_NOT_TRACK=1` env var, the WOTANN-specific
+ * `WOTANN_NO_TELEMETRY=1`, and a `~/.wotann/no-telemetry` sentinel file.
+ * Every telemetry sink must call `isTelemetryEnabled()` before emitting —
+ * this is the single source of truth so users have exactly one lever to
+ * pull for full privacy mode.
+ */
+/**
+ * Returns true if telemetry should be emitted, false if the user opted out.
+ *
+ * Opt-out triggers:
+ *  - `DO_NOT_TRACK=1` or `DO_NOT_TRACK=true` (industry standard)
+ *  - `WOTANN_NO_TELEMETRY=1` or `=true`
+ *  - File `~/.wotann/no-telemetry` exists (survives env wipes, works in CI)
+ *
+ * Default: telemetry enabled. Result is cached after first call for
+ * hot-path performance; call `resetTelemetryCache()` in tests.
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Invert of isTelemetryEnabled — convenience predicate for "opted out" checks.
+ */
+export declare function isTelemetryOptedOut(): boolean;
+/**
+ * Clear the cached opt-out decision. Primarily for tests; production code
+ * should not toggle telemetry mid-session.
+ */
+export declare function resetTelemetryCache(): void;
+//# sourceMappingURL=opt-out.d.ts.map

package/dist/telemetry/opt-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.d.ts","sourceRoot":"","sources":["../../src/telemetry/opt-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAsB5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/telemetry/opt-out.js

@@ -0,0 +1,58 @@
+/**
+ * Telemetry opt-out gate (A10).
+ *
+ * Honours the standard `DO_NOT_TRACK=1` env var, the WOTANN-specific
+ * `WOTANN_NO_TELEMETRY=1`, and a `~/.wotann/no-telemetry` sentinel file.
+ * Every telemetry sink must call `isTelemetryEnabled()` before emitting —
+ * this is the single source of truth so users have exactly one lever to
+ * pull for full privacy mode.
+ */
+import { existsSync } from "node:fs";
+import { resolveWotannHomeSubdir } from "../utils/wotann-home.js";
+const SENTINEL_PATH = resolveWotannHomeSubdir("no-telemetry");
+let cachedValue = null;
+/**
+ * Returns true if telemetry should be emitted, false if the user opted out.
+ *
+ * Opt-out triggers:
+ *  - `DO_NOT_TRACK=1` or `DO_NOT_TRACK=true` (industry standard)
+ *  - `WOTANN_NO_TELEMETRY=1` or `=true`
+ *  - File `~/.wotann/no-telemetry` exists (survives env wipes, works in CI)
+ *
+ * Default: telemetry enabled. Result is cached after first call for
+ * hot-path performance; call `resetTelemetryCache()` in tests.
+ */
+export function isTelemetryEnabled() {
+    if (cachedValue !== null)
+        return cachedValue;
+    const doNotTrack = process.env["DO_NOT_TRACK"];
+    if (doNotTrack === "1" || doNotTrack?.toLowerCase() === "true") {
+        cachedValue = false;
+        return false;
+    }
+    const wotannOptOut = process.env["WOTANN_NO_TELEMETRY"];
+    if (wotannOptOut === "1" || wotannOptOut?.toLowerCase() === "true") {
+        cachedValue = false;
+        return false;
+    }
+    if (existsSync(SENTINEL_PATH)) {
+        cachedValue = false;
+        return false;
+    }
+    cachedValue = true;
+    return true;
+}
+/**
+ * Invert of isTelemetryEnabled — convenience predicate for "opted out" checks.
+ */
+export function isTelemetryOptedOut() {
+    return !isTelemetryEnabled();
+}
+/**
+ * Clear the cached opt-out decision. Primarily for tests; production code
+ * should not toggle telemetry mid-session.
+ */
+export function resetTelemetryCache() {
+    cachedValue = null;
+}
+//# sourceMappingURL=opt-out.js.map

package/dist/telemetry/opt-out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.js","sourceRoot":"","sources":["../../src/telemetry/opt-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,aAAa,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;AAE9D,IAAI,WAAW,GAAmB,IAAI,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC/D,WAAW,GAAG,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,GAAG,IAAI,YAAY,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACnE,WAAW,GAAG,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,WAAW,GAAG,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}