@lcv-ideas-software/cross-review 4.0.0

package/dist/src/peers/perplexity.js

@@ -0,0 +1,375 @@
+import { statusInstruction, statusJsonSchema } from "../core/status.js";
+import { BasePeerAdapter, StreamBuffer } from "./base.js";
+import { classifyProviderError } from "./errors.js";
+import { loadOpenAICtor } from "./openai.js";
+import { withRetry } from "./retry.js";
+import { userPrompt } from "./text.js";
+const PERPLEXITY_BASE_URL = "https://api.perplexity.ai";
+function usageFromSonar(usage, searchPerformed) {
+    if (!usage)
+        return undefined;
+    const result = {
+        input_tokens: usage.prompt_tokens,
+        output_tokens: usage.completion_tokens,
+        total_tokens: usage.total_tokens,
+        reasoning_tokens: usage.reasoning_tokens,
+    };
+    // Perplexity does NOT document a prompt-cache surface in the public
+    // Sonar API. Surface this explicitly so the cost layer + dashboard
+    // never silently treat the absence as a hit.
+    result.cache_provider_mode = "not_supported";
+    // v3.0.0: Sonar-specific categories surfaced so the cost layer can
+    // compute citation_tokens_cost + search_queries_cost (deep-research
+    // models). Absent on non-deep-research models.
+    if (typeof usage.citation_tokens === "number") {
+        result.citation_tokens = usage.citation_tokens;
+    }
+    if (typeof usage.num_search_queries === "number") {
+        result.num_search_queries = usage.num_search_queries;
+    }
+    // v3.0.0 R1 fix (codex cross-review catch 2026-05-12): per-call
+    // signal that the cost layer needs to correctly attribute the
+    // request fee. Relator (generate) calls force disable_search:true
+    // on the wire regardless of operator config — without this signal,
+    // estimateCost() would charge a request fee for searches that did
+    // not actually run.
+    result.search_performed = searchPerformed;
+    // v3.0.0: capture provider-reported total cost for telemetry. The
+    // config-driven cost.ts estimateCost remains authoritative; this is
+    // a sanity-check signal only.
+    if (typeof usage.cost?.total_cost === "number") {
+        result.provider_reported_total_cost_usd = usage.cost.total_cost;
+    }
+    return result;
+}
+// Extract plain text from a Sonar non-streamed response. Tolerant of
+// soft-format outputs because, per #2 above, the search component may
+// not strictly honor the requested JSON schema. Callers downstream
+// (resultFromText -> status.ts decisionQualityFromStatus) classify the
+// quality of the parsed response.
+//
+// v3.2.0 fix (codex catch sess 41244a1c, observed across v3.0.0+):
+// sonar-reasoning-pro and sonar-deep-research models always emit a
+// `<think>...</think>` reasoning preamble before the actual structured
+// answer. The shared status parser in `core/status.ts` requires the
+// text to begin with JSON-shaped content (or contain it within
+// extractable shape); the thinking block breaks both code paths and
+// the format-recovery retry inherits the same problem. Strip every
+// `<think>...</think>` block (greedy across lines, multiple
+// occurrences) before downstream extraction. Real Sonar responses
+// never legitimately include the literal substring "<think>" inside
+// the structured payload, so this is safe.
+const PERPLEXITY_THINKING_BLOCK = /<think\b[^>]*>[\s\S]*?<\/think>/gi;
+export function stripPerplexityThinkingBlock(raw) {
+    return raw.replace(PERPLEXITY_THINKING_BLOCK, "").trim();
+}
+function sonarText(response) {
+    const raw = response.choices?.[0]?.message?.content?.trim() || JSON.stringify(response);
+    return stripPerplexityThinkingBlock(raw);
+}
+export function clampEffortForPerplexity(effort) {
+    switch (effort) {
+        case "none":
+        case "minimal":
+            return "minimal";
+        case "low":
+            return "low";
+        case "medium":
+            return "medium";
+        case "high":
+        case "xhigh":
+        case "max":
+        case undefined:
+        default:
+            return "high";
+    }
+}
+// v3.0.0: Sonar models that accept the `reasoning_effort` body field.
+// Per docs, only `sonar-reasoning-pro` and `sonar-deep-research`
+// recognize it; `sonar` and `sonar-pro` ignore the field (no chain-
+// of-thought stage). Exported for smoke verification.
+export const PERPLEXITY_REASONING_EFFORT_MODELS = new Set([
+    "sonar-reasoning-pro",
+    "sonar-deep-research",
+]);
+export function perplexityAcceptsReasoningEffort(model) {
+    return PERPLEXITY_REASONING_EFFORT_MODELS.has(model);
+}
+function buildSonarOptions(config, model, role, effortOverride) {
+    const opts = {
+        web_search_options: { search_context_size: config.perplexity.search_context_size },
+    };
+    // Relator (generate) role: search is structurally inappropriate
+    // because the task is to synthesize a revised draft from the other
+    // peers' verdicts, not to consult external sources. Force-off
+    // regardless of operator config.
+    // Reviewer (call) role: search active per config (default true; can
+    // be disabled via CROSS_REVIEW_PERPLEXITY_DISABLE_SEARCH=true).
+    if (role === "relator" || config.perplexity.disable_search) {
+        opts.disable_search = true;
+    }
+    if (perplexityAcceptsReasoningEffort(model)) {
+        opts.reasoning_effort = clampEffortForPerplexity(effortOverride ?? config.reasoning_effort.perplexity);
+    }
+    return opts;
+}
+export class PerplexityAdapter extends BasePeerAdapter {
+    id = "perplexity";
+    provider = "perplexity";
+    model;
+    constructor(config, modelOverride) {
+        super(config);
+        this.model = modelOverride ?? config.models.perplexity;
+    }
+    // Per v2.27.1 cold-start hardening: reuse the lazy OpenAI SDK ctor
+    // shared with peers/openai.ts + peers/deepseek.ts + peers/grok.ts so
+    // the `openai` module is loaded exactly once across all four
+    // OpenAI-SDK-driven adapters.
+    async client() {
+        const apiKey = this.config.api_keys.perplexity;
+        if (!apiKey)
+            throw new Error("PERPLEXITY_API_KEY was not found in environment variables.");
+        const Ctor = await loadOpenAICtor();
+        return new Ctor({ apiKey, baseURL: PERPLEXITY_BASE_URL });
+    }
+    async probe() {
+        const started = Date.now();
+        const authPresent = Boolean(this.config.api_keys.perplexity);
+        if (!authPresent) {
+            return {
+                peer: this.id,
+                provider: this.provider,
+                model: this.model,
+                available: false,
+                auth_present: false,
+                latency_ms: Date.now() - started,
+                model_selection: this.config.model_selection.perplexity,
+                message: "PERPLEXITY_API_KEY is missing.",
+            };
+        }
+        // Perplexity does not document a public `models.list` endpoint via
+        // the OpenAI-SDK base path. Probe with a minimal `disable_search`
+        // call to avoid burning a request fee on the health check; payload
+        // is single-token so token cost is negligible.
+        try {
+            const probeClient = await this.client();
+            await probeClient.chat.completions.create({
+                model: this.model,
+                messages: [{ role: "user", content: "probe" }],
+                max_tokens: 1,
+                disable_search: true,
+            }, { timeout: this.config.retry.timeout_ms });
+            return {
+                peer: this.id,
+                provider: this.provider,
+                model: this.model,
+                available: true,
+                auth_present: true,
+                latency_ms: Date.now() - started,
+                model_selection: this.config.model_selection.perplexity,
+            };
+        }
+        catch (error) {
+            const failure = classifyProviderError(this.id, this.provider, this.model, error, 1, started);
+            return {
+                peer: this.id,
+                provider: this.provider,
+                model: this.model,
+                available: false,
+                auth_present: true,
+                latency_ms: Date.now() - started,
+                model_selection: this.config.model_selection.perplexity,
+                message: failure.message,
+            };
+        }
+    }
+    async call(prompt, context) {
+        const started = Date.now();
+        return withRetry(this.config, async (attempt) => {
+            context.emit({
+                type: "peer.call.started",
+                session_id: context.session_id,
+                round: context.round,
+                peer: this.id,
+                message: `Perplexity review attempt ${attempt}`,
+            });
+            const sonarOptions = buildSonarOptions(this.config, this.model, "reviewer", context.reasoning_effort_override);
+            // v3.0.0 R1 fix (codex catch): the reviewer role HONORS config;
+            // disable_search is only set on the wire when config explicitly
+            // turns it off. Derive search_performed from the actual on-wire
+            // option so the cost layer charges request fee iff a search
+            // really ran.
+            const searchPerformed = sonarOptions.disable_search !== true;
+            const payload = {
+                ...sonarOptions,
+                model: this.model,
+                messages: [
+                    { role: "system", content: this.systemPrompt(context) },
+                    { role: "user", content: `${userPrompt(prompt)}\n\n${statusInstruction()}` },
+                ],
+                // Perplexity supports the OpenAI structured-output shape, but
+                // the docs warn the FIRST request with a new schema can
+                // incur 10-30s latency. Because the same statusJsonSchema is
+                // reused across every cross-review call, that one-time cost
+                // is amortized for the operator. Schema `name` is required
+                // (1-64 alphanumeric chars).
+                response_format: {
+                    type: "json_schema",
+                    json_schema: { name: "cross_review_status", schema: statusJsonSchema },
+                },
+                max_tokens: this.config.max_output_tokens,
+            };
+            if (this.shouldStreamTokens(context)) {
+                const streamPayload = {
+                    ...payload,
+                    stream: true,
+                    stream_options: { include_usage: true },
+                };
+                const reviewClient = await this.client();
+                const stream = await reviewClient.chat.completions.create(streamPayload, {
+                    signal: context.signal,
+                    timeout: this.config.retry.timeout_ms,
+                });
+                const stream_buffer = new StreamBuffer(this.id);
+                const tokenStream = this.createTokenEventBuffer(context, "review", "chat.completion.chunk.delta");
+                let usage;
+                let modelReported;
+                let chunks = 0;
+                for await (const chunk of stream) {
+                    chunks += 1;
+                    modelReported = chunk.model ?? modelReported;
+                    usage =
+                        usageFromSonar(chunk.usage, searchPerformed) ??
+                            usage;
+                    for (const choice of chunk.choices ?? []) {
+                        const delta = choice.delta?.content ?? "";
+                        stream_buffer.append(delta);
+                        tokenStream.append(delta);
+                    }
+                }
+                // v3.4.0 Fix #1: apply stripPerplexityThinkingBlock to the
+                // streamed text. Non-streaming path at line ~426 uses
+                // sonarText(response) which already strips; streaming path was
+                // bypassing the strip entirely, causing <think> preambles from
+                // sonar-reasoning-pro to reach the status parser and fail with
+                // unparseable_after_recovery despite valid trailing JSON.
+                // Forensic evidence: sess f9a19401 (v3.3.0 self-investigation)
+                // — 4 peers converged READY on this exact diagnosis. Affected
+                // sessions: f72e597a, 99d46a2b, 00d92cce, 59776026, 41244a1c,
+                // e23d6920. Perplexity ready_rate was 0.28125 vs ~1.0 for
+                // other peers; this restores parity at the streaming path.
+                const text = stripPerplexityThinkingBlock(stream_buffer.text());
+                tokenStream.complete(text.length);
+                return this.resultFromText({
+                    text,
+                    raw: { streamed: true, provider: this.provider, chunks, model: modelReported },
+                    usage,
+                    started,
+                    attempts: attempt,
+                    modelReported,
+                });
+            }
+            const reviewClient = await this.client();
+            const response = await reviewClient.chat.completions.create(payload, {
+                signal: context.signal,
+                timeout: this.config.retry.timeout_ms,
+            });
+            return this.resultFromText({
+                text: sonarText(response),
+                raw: response,
+                usage: usageFromSonar(response.usage, searchPerformed),
+                started,
+                attempts: attempt,
+                modelReported: response.model,
+            });
+        }, (error, attempt) => classifyProviderError(this.id, this.provider, this.model, error, attempt, started));
+    }
+    async generate(prompt, context) {
+        const started = Date.now();
+        return withRetry(this.config, async (attempt) => {
+            context.emit({
+                type: "peer.generate.started",
+                session_id: context.session_id,
+                round: context.round,
+                peer: this.id,
+                message: `Perplexity generation attempt ${attempt}`,
+            });
+            const sonarOptions = buildSonarOptions(this.config, this.model, "relator", context.reasoning_effort_override);
+            // v3.0.0 R1 fix (codex catch): the relator role ALWAYS forces
+            // disable_search:true on the wire (synthesis task, not external
+            // lookup). search_performed is unconditionally false so the
+            // cost layer's request-fee accounting does not charge for a
+            // search that did not run.
+            const searchPerformed = sonarOptions.disable_search !== true;
+            const payload = {
+                ...sonarOptions,
+                model: this.model,
+                messages: [
+                    { role: "system", content: this.systemPrompt(context) },
+                    { role: "user", content: userPrompt(prompt) },
+                ],
+                max_tokens: this.config.max_output_tokens,
+            };
+            if (this.shouldStreamTokens(context)) {
+                const streamPayload = {
+                    ...payload,
+                    stream: true,
+                    stream_options: { include_usage: true },
+                };
+                const generateClient = await this.client();
+                const stream = await generateClient.chat.completions.create(streamPayload, {
+                    signal: context.signal,
+                    timeout: this.config.retry.timeout_ms,
+                });
+                const stream_buffer = new StreamBuffer(this.id);
+                const tokenStream = this.createTokenEventBuffer(context, "generation", "chat.completion.chunk.delta");
+                let usage;
+                let modelReported;
+                let chunks = 0;
+                for await (const chunk of stream) {
+                    chunks += 1;
+                    modelReported = chunk.model ?? modelReported;
+                    usage =
+                        usageFromSonar(chunk.usage, searchPerformed) ??
+                            usage;
+                    for (const choice of chunk.choices ?? []) {
+                        const delta = choice.delta?.content ?? "";
+                        stream_buffer.append(delta);
+                        tokenStream.append(delta);
+                    }
+                }
+                // v3.4.0 Fix #1: streaming-path strip parity for generation
+                // (relator) path — same root cause as the call() branch above.
+                // When Perplexity is sortead as relator (e.g. sess 51973fac),
+                // the streamed `<think>` block reached round-N-draft.md
+                // verbatim and confused downstream reviewers into reviewing
+                // the think reasoning itself. Strip at the streaming boundary
+                // so the relator artifact is clean before persistence.
+                const text = stripPerplexityThinkingBlock(stream_buffer.text());
+                tokenStream.complete(text.length);
+                return this.generationFromText({
+                    text,
+                    raw: { streamed: true, provider: this.provider, chunks, model: modelReported },
+                    usage,
+                    started,
+                    attempts: attempt,
+                    modelReported,
+                });
+            }
+            const generateClient = await this.client();
+            const response = await generateClient.chat.completions.create(payload, {
+                signal: context.signal,
+                timeout: this.config.retry.timeout_ms,
+            });
+            return this.generationFromText({
+                text: sonarText(response),
+                raw: response,
+                usage: usageFromSonar(response.usage, searchPerformed),
+                started,
+                attempts: attempt,
+                modelReported: response.model,
+            });
+        }, (error, attempt) => classifyProviderError(this.id, this.provider, this.model, error, attempt, started));
+    }
+}
+//# sourceMappingURL=perplexity.js.map

package/dist/src/peers/perplexity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity.js","sourceRoot":"","sources":["../../../src/peers/perplexity.ts"],"names":[],"mappings":"AAuDA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAyBxD,SAAS,cAAc,CACrB,KAAoC,EACpC,eAAwB;IAExB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAe;QACzB,YAAY,EAAE,KAAK,CAAC,aAAa;QACjC,aAAa,EAAE,KAAK,CAAC,iBAAiB;QACtC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;KACzC,CAAC;IACF,oEAAoE;IACpE,mEAAmE;IACnE,6CAA6C;IAC7C,MAAM,CAAC,mBAAmB,GAAG,eAAe,CAAC;IAC7C,mEAAmE;IACnE,oEAAoE;IACpE,+CAA+C;IAC/C,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACvD,CAAC;IACD,gEAAgE;IAChE,8DAA8D;IAC9D,kEAAkE;IAClE,mEAAmE;IACnE,kEAAkE;IAClE,oBAAoB;IACpB,MAAM,CAAC,gBAAgB,GAAG,eAAe,CAAC;IAC1C,kEAAkE;IAClE,oEAAoE;IACpE,8BAA8B;IAC9B,IAAI,OAAO,KAAK,CAAC,IAAI,EAAE,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,CAAC,gCAAgC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,sEAAsE;AACtE,mEAAmE;AACnE,uEAAuE;AACvE,kCAAkC;AAClC,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,uEAAuE;AACvE,oEAAoE;AACpE,+DAA+D;AAC/D,oEAAoE;AACpE,mEAAmE;AACnE,4DAA4D;AAC5D,kEAAkE;AAClE,oEAAoE;AACpE,2CAA2C;AAC3C,MAAM,yBAAyB,GAAG,mCAAmC,CAAC;AAEtE,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,QAElB;IACC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxF,OAAO,4BAA4B,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAWD,MAAM,UAAU,wBAAwB,CACtC,MAA6C;IAE7C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,SAAS,CAAC;QACf;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,iEAAiE;AACjE,oEAAoE;AACpE,sDAAsD;AACtD,MAAM,CAAC,MAAM,kCAAkC,GAAwB,IAAI,GAAG,CAAC;IAC7E,qBAAqB;IACrB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,gCAAgC,CAAC,KAAa;IAC5D,OAAO,kCAAkC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAmCD,SAAS,iBAAiB,CACxB,MAAiB,EACjB,KAAa,EACb,IAAe,EACf,cAAsD;IAEtD,MAAM,IAAI,GAA2B;QACnC,kBAAkB,EAAE,EAAE,mBAAmB,EAAE,MAAM,CAAC,UAAU,CAAC,mBAAmB,EAAE;KACnF,CAAC;IACF,gEAAgE;IAChE,mEAAmE;IACnE,8DAA8D;IAC9D,iCAAiC;IACjC,oEAAoE;IACpE,gEAAgE;IAChE,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAC3D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,gBAAgB,GAAG,wBAAwB,CAC9C,cAAc,IAAI,MAAM,CAAC,gBAAgB,CAAC,UAAU,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,EAAE,GAAW,YAAY,CAAC;IAC1B,QAAQ,GAAG,YAAY,CAAC;IACxB,KAAK,CAAS;IAEd,YAAY,MAAiB,EAAE,aAAsB;QACnD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;IACzD,CAAC;IAED,mEAAmE;IACnE,qEAAqE;IACrE,6DAA6D;IAC7D,8BAA8B;IACtB,KAAK,CAAC,MAAM;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;QACpC,OAAO,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,KAAK;gBAChB,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;gBAChC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU;gBACvD,OAAO,EAAE,gCAAgC;aAC1C,CAAC;QACJ,CAAC;QACD,mEAAmE;QACnE,kEAAkE;QAClE,mEAAmE;QACnE,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACvC;gBACE,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBAC9C,UAAU,EAAE,CAAC;gBACb,cAAc,EAAE,IAAI;aACI,EAC1B,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAC1C,CAAC;YACF,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;gBAChC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU;aACxD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7F,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,KAAK;gBAChB,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;gBAChC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU;gBACvD,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,OAAwB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,SAAS,CACd,IAAI,CAAC,MAAM,EACX,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,mBAAmB;gBACzB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,OAAO,EAAE,6BAA6B,OAAO,EAAE;aAChD,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,iBAAiB,CACpC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,UAAU,EACV,OAAO,CAAC,yBAAyB,CAClC,CAAC;YACF,gEAAgE;YAChE,gEAAgE;YAChE,gEAAgE;YAChE,4DAA4D;YAC5D,cAAc;YACd,MAAM,eAAe,GAAG,YAAY,CAAC,cAAc,KAAK,IAAI,CAAC;YAC7D,MAAM,OAAO,GAA0B;gBACrC,GAAG,YAAY;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;oBACvD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,iBAAiB,EAAE,EAAE,EAAE;iBAC7E;gBACD,8DAA8D;gBAC9D,wDAAwD;gBACxD,6DAA6D;gBAC7D,4DAA4D;gBAC5D,2DAA2D;gBAC3D,6BAA6B;gBAC7B,eAAe,EAAE;oBACf,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,gBAAgB,EAAE;iBACf;gBACzD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;aAC1C,CAAC;YACF,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrC,MAAM,aAAa,GAAgC;oBACjD,GAAG,OAAO;oBACV,MAAM,EAAE,IAAI;oBACZ,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;iBACxC,CAAC;gBACF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE;oBACvE,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;iBACtC,CAAC,CAAC;gBACH,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChD,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAC7C,OAAO,EACP,QAAQ,EACR,6BAA6B,CAC9B,CAAC;gBACF,IAAI,KAA6B,CAAC;gBAClC,IAAI,aAAiC,CAAC;gBACtC,IAAI,MAAM,GAAG,CAAC,CAAC;gBACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,CAAC,CAAC;oBACZ,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC;oBAC7C,KAAK;wBACH,cAAc,CAAC,KAAK,CAAC,KAAsC,EAAE,eAAe,CAAC;4BAC7E,KAAK,CAAC;oBACR,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;wBACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;wBAC1C,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBAC5B,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBACD,2DAA2D;gBAC3D,sDAAsD;gBACtD,+DAA+D;gBAC/D,+DAA+D;gBAC/D,+DAA+D;gBAC/D,0DAA0D;gBAC1D,+DAA+D;gBAC/D,8DAA8D;gBAC9D,8DAA8D;gBAC9D,0DAA0D;gBAC1D,2DAA2D;gBAC3D,MAAM,IAAI,GAAG,4BAA4B,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChE,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClC,OAAO,IAAI,CAAC,cAAc,CAAC;oBACzB,IAAI;oBACJ,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE;oBAC9E,KAAK;oBACL,OAAO;oBACP,QAAQ,EAAE,OAAO;oBACjB,aAAa;iBACd,CAAC,CAAC;YACL,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE;gBACnE,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,cAAc,CAAC;gBACzB,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC;gBACzB,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,cAAc,CAAE,QAAmC,CAAC,KAAK,EAAE,eAAe,CAAC;gBAClF,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,aAAa,EAAE,QAAQ,CAAC,KAAK;aAC9B,CAAC,CAAC;QACL,CAAC,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CACrF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAwB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,SAAS,CACd,IAAI,CAAC,MAAM,EACX,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,uBAAuB;gBAC7B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,IAAI,CAAC,EAAE;gBACb,OAAO,EAAE,iCAAiC,OAAO,EAAE;aACpD,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,iBAAiB,CACpC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,SAAS,EACT,OAAO,CAAC,yBAAyB,CAClC,CAAC;YACF,8DAA8D;YAC9D,gEAAgE;YAChE,4DAA4D;YAC5D,4DAA4D;YAC5D,2BAA2B;YAC3B,MAAM,eAAe,GAAG,YAAY,CAAC,cAAc,KAAK,IAAI,CAAC;YAC7D,MAAM,OAAO,GAA0B;gBACrC,GAAG,YAAY;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;oBACvD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE;iBAC9C;gBACD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;aAC1C,CAAC;YACF,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrC,MAAM,aAAa,GAAgC;oBACjD,GAAG,OAAO;oBACV,MAAM,EAAE,IAAI;oBACZ,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;iBACxC,CAAC;gBACF,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE;oBACzE,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;iBACtC,CAAC,CAAC;gBACH,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChD,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAC7C,OAAO,EACP,YAAY,EACZ,6BAA6B,CAC9B,CAAC;gBACF,IAAI,KAA6B,CAAC;gBAClC,IAAI,aAAiC,CAAC;gBACtC,IAAI,MAAM,GAAG,CAAC,CAAC;gBACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,CAAC,CAAC;oBACZ,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC;oBAC7C,KAAK;wBACH,cAAc,CAAC,KAAK,CAAC,KAAsC,EAAE,eAAe,CAAC;4BAC7E,KAAK,CAAC;oBACR,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;wBACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;wBAC1C,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBAC5B,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBACD,4DAA4D;gBAC5D,+DAA+D;gBAC/D,8DAA8D;gBAC9D,wDAAwD;gBACxD,4DAA4D;gBAC5D,8DAA8D;gBAC9D,uDAAuD;gBACvD,MAAM,IAAI,GAAG,4BAA4B,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChE,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClC,OAAO,IAAI,CAAC,kBAAkB,CAAC;oBAC7B,IAAI;oBACJ,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE;oBAC9E,KAAK;oBACL,OAAO;oBACP,QAAQ,EAAE,OAAO;oBACjB,aAAa;iBACd,CAAC,CAAC;YACL,CAAC;YACD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE;gBACrE,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,kBAAkB,CAAC;gBAC7B,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC;gBACzB,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,cAAc,CAAE,QAAmC,CAAC,KAAK,EAAE,eAAe,CAAC;gBAClF,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,aAAa,EAAE,QAAQ,CAAC,KAAK;aAC9B,CAAC,CAAC;QACL,CAAC,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CACrF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/peers/registry.d.ts

@@ -0,0 +1,3 @@
+import type { AppConfig, PeerAdapter, PeerId } from "../core/types.js";
+export declare function createAdapters(config: AppConfig, modelOverrides?: Partial<Record<PeerId, string>>): Record<PeerId, PeerAdapter>;
+export declare function selectAdapters(adapters: Record<PeerId, PeerAdapter>, peers?: PeerId[]): PeerAdapter[];

package/dist/src/peers/registry.js

@@ -0,0 +1,77 @@
+import { PEERS } from "../core/types.js";
+import { AnthropicAdapter } from "./anthropic.js";
+import { DeepSeekAdapter } from "./deepseek.js";
+import { GeminiAdapter } from "./gemini.js";
+import { GrokAdapter } from "./grok.js";
+import { OpenAIAdapter } from "./openai.js";
+import { PerplexityAdapter } from "./perplexity.js";
+import { StubAdapter } from "./stub.js";
+// v2.4.0 / audit closure (P1.1) — refined after cross-review R1 (gemini
+// caught a financial-safety regression in the initial fallback design).
+//
+// Pre-v2.4.0 a single env var (CROSS_REVIEW_STUB=1) replaced every
+// real provider adapter with a stub that returned synthetic READY
+// verdicts at $0 cost — so a stray dotenv or CI variable could silently
+// invalidate a cross-review used as a pre-commit gate.
+//
+// Initial v2.4.0 attempt: when the flag was set without confirmation, the
+// boot path emitted a notice and FELL BACK to real adapters. R1 (gemini)
+// caught the financial-safety regression: an operator who deliberately
+// set CROSS_REVIEW_STUB=1 to avoid paid calls (local dev, CI offline,
+// budget kill) would now BE BILLED for real provider calls instead. The
+// silent fallback violates explicit operator intent.
+//
+// Final v2.4.0 contract: the flag and the confirmation are paired
+// — set both together or neither. If the flag is set without
+// confirmation we FAIL FAST with a clear error so the operator must
+// either (a) opt in deliberately to stubs by adding the confirmation,
+// or (b) unset the stub flag if real adapters are intended. This
+// preserves the original financial safety net that flag-only operators
+// were depending on without re-introducing the silent-stub-in-prod risk.
+function stubsAreSafelyEnabled(config) {
+    if (!config.stub)
+        return false;
+    const confirmed = process.env.NODE_ENV === "test" ||
+        /^(1|true|yes|on)$/i.test(process.env.CROSS_REVIEW_STUB_CONFIRMED ?? "");
+    if (!confirmed) {
+        throw new Error("CROSS_REVIEW_STUB=1 is set but stub activation is NOT confirmed. " +
+            "Stubs would invalidate real cross-review decisions; falling back to real adapters " +
+            "would charge for paid provider calls against your explicit STUB intent. " +
+            "To deliberately enable stubs, also set NODE_ENV=test OR " +
+            "CROSS_REVIEW_STUB_CONFIRMED=1 in the same environment. " +
+            "To deliberately use real adapters, unset CROSS_REVIEW_STUB.");
+    }
+    process.stderr.write("[cross-review] notice: stub adapters ACTIVE — every peer call returns synthetic data. " +
+        "Do NOT use this configuration to gate real cross-review decisions.\n");
+    return true;
+}
+export function createAdapters(config, modelOverrides = {}) {
+    if (stubsAreSafelyEnabled(config)) {
+        return {
+            codex: new StubAdapter(config, "codex", modelOverrides.codex),
+            claude: new StubAdapter(config, "claude", modelOverrides.claude),
+            gemini: new StubAdapter(config, "gemini", modelOverrides.gemini),
+            deepseek: new StubAdapter(config, "deepseek", modelOverrides.deepseek),
+            // v2.14.0: Grok stub for offline / CI / budget-kill smoke runs.
+            grok: new StubAdapter(config, "grok", modelOverrides.grok),
+            // v3.0.0: Perplexity stub for offline / CI / budget-kill smoke runs.
+            perplexity: new StubAdapter(config, "perplexity", modelOverrides.perplexity),
+        };
+    }
+    return {
+        codex: new OpenAIAdapter(config, modelOverrides.codex),
+        claude: new AnthropicAdapter(config, modelOverrides.claude),
+        gemini: new GeminiAdapter(config, modelOverrides.gemini),
+        deepseek: new DeepSeekAdapter(config, modelOverrides.deepseek),
+        // v2.14.0: Grok via xAI's OpenAI-Responses-API surface.
+        grok: new GrokAdapter(config, modelOverrides.grok),
+        // v3.0.0: Perplexity via Sonar API at https://api.perplexity.ai
+        // (OpenAI-Chat-Completions compatible; uses the shared
+        // loadOpenAICtor helper from peers/openai.ts).
+        perplexity: new PerplexityAdapter(config, modelOverrides.perplexity),
+    };
+}
+export function selectAdapters(adapters, peers = [...PEERS]) {
+    return peers.map((peer) => adapters[peer]);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/peers/registry.js.map

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

package/dist/src/peers/retry.d.ts

@@ -0,0 +1,2 @@
+import type { AppConfig, PeerFailure } from "../core/types.js";
+export declare function withRetry<T>(config: AppConfig, run: (attempt: number) => Promise<T>, onFailure: (error: unknown, attempt: number, started: number) => PeerFailure): Promise<T>;

package/dist/src/peers/retry.js

@@ -0,0 +1,36 @@
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// v2.4.0 / audit closure (P2.6): full jitter on the exponential backoff.
+// Without jitter, multiple peers hitting the same provider rate-limit
+// synchronize their retries (10ms, 20ms, 40ms... in lockstep) and produce
+// thundering-herd that prolongs the rate limit instead of relieving it.
+// Full jitter (random in [0, capped]) is the AWS-recommended pattern and
+// is appropriate here because the cap (`config.retry.max_delay_ms`)
+// already bounds tail latency. When the provider returns an explicit
+// `retry_after_ms` (P2.7 wires this), we respect it as-is — that value
+// is server-authoritative and adding jitter on top would only delay
+// recovery further.
+function backoffWithJitter(attempt, config) {
+    const exponential = config.retry.base_delay_ms * 2 ** (attempt - 1);
+    const capped = Math.min(config.retry.max_delay_ms, exponential);
+    return Math.floor(Math.random() * capped);
+}
+export async function withRetry(config, run, onFailure) {
+    const started = Date.now();
+    let last = null;
+    for (let attempt = 1; attempt <= config.retry.max_attempts; attempt++) {
+        try {
+            return await run(attempt);
+        }
+        catch (error) {
+            last = onFailure(error, attempt, started);
+            if (!last.retryable || attempt >= config.retry.max_attempts)
+                throw error;
+            const wait = last.retry_after_ms ?? backoffWithJitter(attempt, config);
+            await delay(wait);
+        }
+    }
+    throw new Error(last?.message ?? "retry loop exhausted");
+}
+//# sourceMappingURL=retry.js.map

package/dist/src/peers/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/peers/retry.ts"],"names":[],"mappings":"AAEA,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,yEAAyE;AACzE,sEAAsE;AACtE,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AACzE,oEAAoE;AACpE,qEAAqE;AACrE,uEAAuE;AACvE,oEAAoE;AACpE,oBAAoB;AACpB,SAAS,iBAAiB,CAAC,OAAe,EAAE,MAAiB;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAiB,EACjB,GAAoC,EACpC,SAA4E;IAE5E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAuB,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;QACtE,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY;gBAAE,MAAM,KAAK,CAAC;YACzE,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,IAAI,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,sBAAsB,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/peers/stub.d.ts

@@ -0,0 +1,13 @@
+import type { AppConfig, EvidenceAskJudgment, GenerationResult, PeerAdapter, PeerCallContext, PeerId, PeerProbeResult, PeerResult } from "../core/types.js";
+import { BasePeerAdapter } from "./base.js";
+export declare class StubAdapter extends BasePeerAdapter implements PeerAdapter {
+    readonly id: PeerId;
+    provider: string;
+    model: string;
+    constructor(config: AppConfig, id: PeerId, modelOverride?: string);
+    private streamStubText;
+    probe(): Promise<PeerProbeResult>;
+    call(prompt: string, context: PeerCallContext): Promise<PeerResult>;
+    generate(prompt: string, context: PeerCallContext): Promise<GenerationResult>;
+    judgeEvidenceAsk(ask: string, draft: string, context: PeerCallContext): Promise<EvidenceAskJudgment>;
+}