@debriefer/core 2.0.0

package/dist/rate-limiter.js

@@ -0,0 +1,79 @@
+/**
+ * Per-domain async rate limiter shared across all source instances.
+ *
+ * Uses an async queue per domain to prevent thundering herd — when multiple
+ * callers request the same domain simultaneously, they're serialized so each
+ * waits the correct delay after the previous one, rather than all sleeping
+ * the same amount and firing together.
+ *
+ * Example: Three sources all query en.wikipedia.org. Without rate limiting,
+ * they'd fire simultaneously and risk being blocked. The rate limiter
+ * serializes them with configurable delays between requests.
+ */
+export class SourceRateLimiter {
+    domains = new Map();
+    getOrCreateDomain(domain) {
+        let state = this.domains.get(domain);
+        if (!state) {
+            state = {
+                lastRequestTime: 0,
+                queue: [],
+                processing: false,
+                totalRequests: 0,
+                totalWaitMs: 0,
+            };
+            this.domains.set(domain, state);
+        }
+        return state;
+    }
+    /**
+     * Acquire permission to make a request to the given domain.
+     * Blocks until minDelayMs has passed since the last request to this domain.
+     */
+    async acquire(domain, minDelayMs) {
+        const state = this.getOrCreateDomain(domain);
+        return new Promise((resolve) => {
+            state.queue.push({ minDelayMs, resolve });
+            this.processQueue(state);
+        });
+    }
+    async processQueue(state) {
+        if (state.processing || state.queue.length === 0)
+            return;
+        state.processing = true;
+        try {
+            while (state.queue.length > 0) {
+                const item = state.queue.shift();
+                const now = Date.now();
+                const timeSinceLast = now - state.lastRequestTime;
+                const waitTime = Math.max(0, item.minDelayMs - timeSinceLast);
+                if (waitTime > 0) {
+                    state.totalWaitMs += waitTime;
+                    await new Promise((r) => setTimeout(r, waitTime));
+                }
+                state.lastRequestTime = Date.now();
+                state.totalRequests++;
+                item.resolve();
+            }
+        }
+        finally {
+            state.processing = false;
+        }
+    }
+    /** Get rate limiting stats per domain */
+    getStats() {
+        const stats = new Map();
+        for (const [domain, state] of this.domains) {
+            stats.set(domain, {
+                totalRequests: state.totalRequests,
+                totalWaitMs: state.totalWaitMs,
+            });
+        }
+        return stats;
+    }
+    /** Reset all state (useful for testing) */
+    reset() {
+        this.domains.clear();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAA;IAExC,iBAAiB,CAAC,MAAc;QACtC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,eAAe,EAAE,CAAC;gBAClB,KAAK,EAAE,EAAE;gBACT,UAAU,EAAE,KAAK;gBACjB,aAAa,EAAE,CAAC;gBAChB,WAAW,EAAE,CAAC;aACf,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,UAAkB;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;QAE5C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;YACzC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAkB;QAC3C,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACxD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;QAEvB,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAG,CAAA;gBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACtB,MAAM,aAAa,GAAG,GAAG,GAAG,KAAK,CAAC,eAAe,CAAA;gBACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC,CAAA;gBAE7D,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACjB,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAA;oBAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;gBACzD,CAAC;gBAED,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAClC,KAAK,CAAC,aAAa,EAAE,CAAA;gBACrB,IAAI,CAAC,OAAO,EAAE,CAAA;YAChB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,UAAU,GAAG,KAAK,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAA;QACjD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;gBAChB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/reliability.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Source reliability scoring based on Wikipedia's Reliable Sources Perennial list (RSP).
+ * https://en.wikipedia.org/wiki/Wikipedia:Reliable_sources/Perennial_sources
+ *
+ * RSP is a community-maintained assessment of source trustworthiness for encyclopedic use.
+ * We map their ratings to numeric scores (0.0-1.0).
+ *
+ * This is independent from content confidence:
+ * - Reliability = "how trustworthy is this publisher?" (Reuters vs TMZ)
+ * - Confidence = "does this specific page answer the question?" (Reuters weather article vs Reuters obituary)
+ */
+export declare enum ReliabilityTier {
+    /** Wikidata, government databases: community-curated structured data */
+    STRUCTURED_DATA = "structured_data",
+    /** AP, NYT, BBC, Guardian, Reuters, WaPo: independent, fact-checking reputation */
+    TIER_1_NEWS = "tier_1_news",
+    /** Variety, Deadline, THR, BFI, Nature, Lancet: reliable within their domain */
+    TRADE_PRESS = "trade_press",
+    /** Trove, Europeana, Chronicling America: institutional archives */
+    ARCHIVAL = "archival",
+    /** Wikipedia: secondary compilation, varies by article */
+    SECONDARY_COMPILATION = "secondary",
+    /** Google, Bing, DDG, Brave, NewsAPI: depends on linked pages */
+    SEARCH_AGGREGATOR = "search_aggregator",
+    /** Internet Archive: mirrors of other sources */
+    ARCHIVE_MIRROR = "archive_mirror",
+    /** People Magazine: celebrity magazine, decent for announcements */
+    MARGINAL_EDITORIAL = "marginal_editorial",
+    /** Legacy.com, FamilySearch: mix of official and user-submitted */
+    MARGINAL_MIXED = "marginal_mixed",
+    /** Claude, GPT, Gemini: hallucination risk, no original reporting */
+    AI_MODEL = "ai_model",
+    /** TMZ: fast on announcements, weak on cause details */
+    UNRELIABLE_FAST = "unreliable_fast",
+    /** Find a Grave: user-generated, no editorial oversight */
+    UNRELIABLE_UGC = "unreliable_ugc"
+}
+/**
+ * Numeric reliability scores for each tier (0.0-1.0).
+ *
+ * Higher scores indicate more trustworthy publishers. These are based on
+ * Wikipedia's RSP community assessments mapped to our tier system.
+ */
+export declare const RELIABILITY_SCORES: Record<ReliabilityTier, number>;
+/** Get the numeric reliability score for a tier */
+export declare function getReliabilityScore(tier: ReliabilityTier): number;
+/** Check if a source meets a minimum reliability threshold */
+export declare function meetsReliabilityThreshold(tier: ReliabilityTier, threshold: number): boolean;
+//# sourceMappingURL=reliability.d.ts.map

package/dist/reliability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.d.ts","sourceRoot":"","sources":["../src/reliability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oBAAY,eAAe;IACzB,wEAAwE;IACxE,eAAe,oBAAoB;IACnC,mFAAmF;IACnF,WAAW,gBAAgB;IAC3B,gFAAgF;IAChF,WAAW,gBAAgB;IAC3B,oEAAoE;IACpE,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,qBAAqB,cAAc;IACnC,iEAAiE;IACjE,iBAAiB,sBAAsB;IACvC,iDAAiD;IACjD,cAAc,mBAAmB;IACjC,oEAAoE;IACpE,kBAAkB,uBAAuB;IACzC,mEAAmE;IACnE,cAAc,mBAAmB;IACjC,qEAAqE;IACrE,QAAQ,aAAa;IACrB,wDAAwD;IACxD,eAAe,oBAAoB;IACnC,2DAA2D;IAC3D,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAa9D,CAAA;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3F"}

package/dist/reliability.js

@@ -0,0 +1,67 @@
+/**
+ * Source reliability scoring based on Wikipedia's Reliable Sources Perennial list (RSP).
+ * https://en.wikipedia.org/wiki/Wikipedia:Reliable_sources/Perennial_sources
+ *
+ * RSP is a community-maintained assessment of source trustworthiness for encyclopedic use.
+ * We map their ratings to numeric scores (0.0-1.0).
+ *
+ * This is independent from content confidence:
+ * - Reliability = "how trustworthy is this publisher?" (Reuters vs TMZ)
+ * - Confidence = "does this specific page answer the question?" (Reuters weather article vs Reuters obituary)
+ */
+export var ReliabilityTier;
+(function (ReliabilityTier) {
+    /** Wikidata, government databases: community-curated structured data */
+    ReliabilityTier["STRUCTURED_DATA"] = "structured_data";
+    /** AP, NYT, BBC, Guardian, Reuters, WaPo: independent, fact-checking reputation */
+    ReliabilityTier["TIER_1_NEWS"] = "tier_1_news";
+    /** Variety, Deadline, THR, BFI, Nature, Lancet: reliable within their domain */
+    ReliabilityTier["TRADE_PRESS"] = "trade_press";
+    /** Trove, Europeana, Chronicling America: institutional archives */
+    ReliabilityTier["ARCHIVAL"] = "archival";
+    /** Wikipedia: secondary compilation, varies by article */
+    ReliabilityTier["SECONDARY_COMPILATION"] = "secondary";
+    /** Google, Bing, DDG, Brave, NewsAPI: depends on linked pages */
+    ReliabilityTier["SEARCH_AGGREGATOR"] = "search_aggregator";
+    /** Internet Archive: mirrors of other sources */
+    ReliabilityTier["ARCHIVE_MIRROR"] = "archive_mirror";
+    /** People Magazine: celebrity magazine, decent for announcements */
+    ReliabilityTier["MARGINAL_EDITORIAL"] = "marginal_editorial";
+    /** Legacy.com, FamilySearch: mix of official and user-submitted */
+    ReliabilityTier["MARGINAL_MIXED"] = "marginal_mixed";
+    /** Claude, GPT, Gemini: hallucination risk, no original reporting */
+    ReliabilityTier["AI_MODEL"] = "ai_model";
+    /** TMZ: fast on announcements, weak on cause details */
+    ReliabilityTier["UNRELIABLE_FAST"] = "unreliable_fast";
+    /** Find a Grave: user-generated, no editorial oversight */
+    ReliabilityTier["UNRELIABLE_UGC"] = "unreliable_ugc";
+})(ReliabilityTier || (ReliabilityTier = {}));
+/**
+ * Numeric reliability scores for each tier (0.0-1.0).
+ *
+ * Higher scores indicate more trustworthy publishers. These are based on
+ * Wikipedia's RSP community assessments mapped to our tier system.
+ */
+export const RELIABILITY_SCORES = {
+    [ReliabilityTier.STRUCTURED_DATA]: 1.0,
+    [ReliabilityTier.TIER_1_NEWS]: 0.95,
+    [ReliabilityTier.TRADE_PRESS]: 0.9,
+    [ReliabilityTier.ARCHIVAL]: 0.9,
+    [ReliabilityTier.SECONDARY_COMPILATION]: 0.85,
+    [ReliabilityTier.SEARCH_AGGREGATOR]: 0.7,
+    [ReliabilityTier.ARCHIVE_MIRROR]: 0.7,
+    [ReliabilityTier.MARGINAL_EDITORIAL]: 0.65,
+    [ReliabilityTier.MARGINAL_MIXED]: 0.6,
+    [ReliabilityTier.AI_MODEL]: 0.55,
+    [ReliabilityTier.UNRELIABLE_FAST]: 0.5,
+    [ReliabilityTier.UNRELIABLE_UGC]: 0.35,
+};
+/** Get the numeric reliability score for a tier */
+export function getReliabilityScore(tier) {
+    return RELIABILITY_SCORES[tier];
+}
+/** Check if a source meets a minimum reliability threshold */
+export function meetsReliabilityThreshold(tier, threshold) {
+    return RELIABILITY_SCORES[tier] >= threshold;
+}
+//# sourceMappingURL=reliability.js.map

package/dist/reliability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.js","sourceRoot":"","sources":["../src/reliability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAN,IAAY,eAyBX;AAzBD,WAAY,eAAe;IACzB,wEAAwE;IACxE,sDAAmC,CAAA;IACnC,mFAAmF;IACnF,8CAA2B,CAAA;IAC3B,gFAAgF;IAChF,8CAA2B,CAAA;IAC3B,oEAAoE;IACpE,wCAAqB,CAAA;IACrB,0DAA0D;IAC1D,sDAAmC,CAAA;IACnC,iEAAiE;IACjE,0DAAuC,CAAA;IACvC,iDAAiD;IACjD,oDAAiC,CAAA;IACjC,oEAAoE;IACpE,4DAAyC,CAAA;IACzC,mEAAmE;IACnE,oDAAiC,CAAA;IACjC,qEAAqE;IACrE,wCAAqB,CAAA;IACrB,wDAAwD;IACxD,sDAAmC,CAAA;IACnC,2DAA2D;IAC3D,oDAAiC,CAAA;AACnC,CAAC,EAzBW,eAAe,KAAf,eAAe,QAyB1B;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,GAAG;IACtC,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,IAAI;IACnC,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,GAAG;IAClC,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,GAAG;IAC/B,CAAC,eAAe,CAAC,qBAAqB,CAAC,EAAE,IAAI;IAC7C,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,GAAG;IACxC,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,GAAG;IACrC,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,IAAI;IAC1C,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,GAAG;IACrC,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI;IAChC,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,GAAG;IACtC,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,IAAI;CACvC,CAAA;AAED,mDAAmD;AACnD,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,yBAAyB,CAAC,IAAqB,EAAE,SAAiB;IAChF,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;AAC9C,CAAC"}

package/dist/synthesizer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Synthesis utilities and NoopSynthesizer for the debriefer core.
+ *
+ * ClaudeSynthesizer has been moved to @debriefer/ai. This module retains
+ * NoopSynthesizer (pass-through) and the stripMarkdownCodeFences utility
+ * which has no AI dependency.
+ */
+import type { ResearchSubject, ScoredFinding, SynthesisResult, Synthesizer } from "./types.js";
+/**
+ * Strip markdown code fences from Claude's response.
+ *
+ * Claude sometimes wraps JSON responses in ```json ... ``` or ``` ... ```
+ * code fences despite being told to return raw JSON. This utility removes
+ * those wrappings to allow JSON.parse to succeed.
+ */
+export declare function stripMarkdownCodeFences(text: string): string;
+/**
+ * No-op synthesizer that returns findings as-is without AI processing.
+ *
+ * Useful for consumers who want raw gathered data without paying for
+ * AI synthesis, or for testing/debugging the source gathering pipeline.
+ *
+ * @typeParam TSubject - The research subject type
+ */
+export declare class NoopSynthesizer<TSubject extends ResearchSubject> implements Synthesizer<TSubject, ScoredFinding[]> {
+    /**
+     * Returns the findings array unchanged with zero cost.
+     */
+    synthesize(_subject: TSubject, findings: ScoredFinding[]): Promise<SynthesisResult<ScoredFinding[]>>;
+}
+//# sourceMappingURL=synthesizer.d.ts.map

package/dist/synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesizer.d.ts","sourceRoot":"","sources":["../src/synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE9F;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe,CAAC,QAAQ,SAAS,eAAe,CAAE,YAAW,WAAW,CACnF,QAAQ,EACR,aAAa,EAAE,CAChB;IACC;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC,CAAC;CAS7C"}

package/dist/synthesizer.js

@@ -0,0 +1,47 @@
+/**
+ * Synthesis utilities and NoopSynthesizer for the debriefer core.
+ *
+ * ClaudeSynthesizer has been moved to @debriefer/ai. This module retains
+ * NoopSynthesizer (pass-through) and the stripMarkdownCodeFences utility
+ * which has no AI dependency.
+ */
+/**
+ * Strip markdown code fences from Claude's response.
+ *
+ * Claude sometimes wraps JSON responses in ```json ... ``` or ``` ... ```
+ * code fences despite being told to return raw JSON. This utility removes
+ * those wrappings to allow JSON.parse to succeed.
+ */
+export function stripMarkdownCodeFences(text) {
+    const trimmed = text.trim();
+    if (trimmed.startsWith("```")) {
+        const lines = trimmed.split("\n");
+        // Remove first line (```json or ```) and last line (```)
+        const inner = lines.slice(1, lines.length - 1).join("\n");
+        return inner.trim();
+    }
+    return trimmed;
+}
+/**
+ * No-op synthesizer that returns findings as-is without AI processing.
+ *
+ * Useful for consumers who want raw gathered data without paying for
+ * AI synthesis, or for testing/debugging the source gathering pipeline.
+ *
+ * @typeParam TSubject - The research subject type
+ */
+export class NoopSynthesizer {
+    /**
+     * Returns the findings array unchanged with zero cost.
+     */
+    async synthesize(_subject, findings) {
+        return {
+            data: findings,
+            costUsd: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            model: "none",
+        };
+    }
+}
+//# sourceMappingURL=synthesizer.js.map

package/dist/synthesizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesizer.js","sourceRoot":"","sources":["../src/synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,yDAAyD;QACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAI1B;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,QAAkB,EAClB,QAAyB;QAEzB,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,KAAK,EAAE,MAAM;SACd,CAAA;IACH,CAAC;CACF"}

package/dist/telemetry/console.d.ts

@@ -0,0 +1,7 @@
+import type { TelemetryProvider, TelemetrySpan } from "../types.js";
+export declare class ConsoleTelemetry implements TelemetryProvider {
+    recordEvent(name: string, data: Record<string, unknown>): void;
+    startSpan(name: string): TelemetrySpan;
+    recordError(error: Error, context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/telemetry/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/telemetry/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEnE,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAatC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGnE"}

package/dist/telemetry/console.js

@@ -0,0 +1,21 @@
+export class ConsoleTelemetry {
+    recordEvent(name, data) {
+        console.log(`[debriefer] ${name}`, data);
+    }
+    startSpan(name) {
+        const start = Date.now();
+        console.log(`[debriefer] span:start ${name}`);
+        return {
+            end() {
+                console.log(`[debriefer] span:end ${name} (${Date.now() - start}ms)`);
+            },
+            setAttributes(_attrs) {
+                // Console telemetry ignores attributes
+            },
+        };
+    }
+    recordError(error, context) {
+        console.error(`[debriefer] error: ${error.message}`, context);
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/telemetry/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/telemetry/console.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IAC3B,WAAW,CAAC,IAAY,EAAE,IAA6B;QACrD,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;IAC1C,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAA;QAC7C,OAAO;YACL,GAAG;gBACD,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,CAAC,CAAA;YACvE,CAAC;YACD,aAAa,CAAC,MAAiD;gBAC7D,uCAAuC;YACzC,CAAC;SACF,CAAA;IACH,CAAC;IAED,WAAW,CAAC,KAAY,EAAE,OAAiC;QACzD,OAAO,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/D,CAAC;CACF"}

package/dist/telemetry/noop.d.ts

@@ -0,0 +1,7 @@
+import type { TelemetryProvider, TelemetrySpan } from "../types.js";
+export declare class NoopTelemetry implements TelemetryProvider {
+    recordEvent(_name: string, _data: Record<string, unknown>): void;
+    startSpan(_name: string): TelemetrySpan;
+    recordError(_error: Error, _context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/telemetry/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/telemetry/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOnE,qBAAa,aAAc,YAAW,iBAAiB;IACrD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAChE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAGvC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CACrE"}

package/dist/telemetry/noop.js

@@ -0,0 +1,12 @@
+const NOOP_SPAN = {
+    end() { },
+    setAttributes(_attrs) { },
+};
+export class NoopTelemetry {
+    recordEvent(_name, _data) { }
+    startSpan(_name) {
+        return NOOP_SPAN;
+    }
+    recordError(_error, _context) { }
+}
+//# sourceMappingURL=noop.js.map

package/dist/telemetry/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/telemetry/noop.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAkB;IAC/B,GAAG,KAAI,CAAC;IACR,aAAa,CAAC,MAAiD,IAAG,CAAC;CACpE,CAAA;AAED,MAAM,OAAO,aAAa;IACxB,WAAW,CAAC,KAAa,EAAE,KAA8B,IAAS,CAAC;IACnE,SAAS,CAAC,KAAa;QACrB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,WAAW,CAAC,MAAa,EAAE,QAAkC,IAAS,CAAC;CACxE"}