pi-ghost-autocomplete 0.3.1 → 0.3.2

package/dist/providers/race.js

@@ -1,3 +1,13 @@
+import { wrapAsStream } from "./types.js";
+/**
+ * PRD §M8: per-member rolling stats. A member that's been slow on 8/10
+ * recent races AND never produced the winning candidate is skipped for the
+ * next `SKIP_RACES` races. Saves cost without hurting latency when one
+ * member is consistently a drag.
+ */
+const HISTORY_SIZE = 10;
+const SLOW_THRESHOLD = 8;
+const SKIP_RACES = 5;
 /**
  * Implements {@link GhostProvider} by racing several providers in parallel.
  * First non-null result wins; losers are aborted via a shared signal.
@@ -12,10 +22,27 @@ export class RaceProvider {
     name;
     cooldownUntil = 0;
     lastTrace = null;
+    stats;
     constructor(members, cfg) {
         this.members = members;
         this.cfg = cfg;
         this.name = `ghost-race:${members.map((p) => p.name).join(",")}`;
+        this.stats = new Map();
+        for (const p of members) {
+            this.stats.set(p.name, { slowFlags: [], wins: 0, skipRemaining: 0 });
+        }
+    }
+    /** Snapshot of per-member weighting stats. Test/diagnostic only. */
+    getMemberStats() {
+        return this.members.map((p) => {
+            const s = this.stats.get(p.name);
+            return {
+                name: p.name,
+                slowCount: s.slowFlags.reduce((a, b) => a + b, 0),
+                wins: s.wins,
+                skipRemaining: s.skipRemaining,
+            };
+        });
     }
     get debounceMs() {
         return this.cfg.pauseMs;
@@ -25,6 +52,16 @@ export class RaceProvider {
         this.lastTrace = null;
         return t;
     }
+    /**
+     * Cooldown snapshot for speculative cache warm. The editor consults this
+     * synchronously in `handleTextChange` to decide whether the backspace-of-N
+     * branch may serve a result (it is the most aggressive branch and is only
+     * appropriate when a fresh race would no-op anyway). See PRD §6 M1b.
+     */
+    getCooldownState(now = Date.now()) {
+        const remainingMs = Math.max(0, this.cooldownUntil - now);
+        return { active: remainingMs > 0, remainingMs };
+    }
     async predict(req) {
         if (this.members.length === 0)
             return null;
@@ -34,6 +71,7 @@ export class RaceProvider {
             return null;
         }
         const trace = [];
+        const skipped = [];
         const localCtrl = new AbortController();
         const start = now;
         // Propagate caller cancellation; do not propagate our own internal aborts.
@@ -45,12 +83,41 @@ export class RaceProvider {
             req.signal.addEventListener("abort", onUserAbort, { once: true });
         }
         const cutoffTimer = setTimeout(() => localCtrl.abort(), this.cfg.cutoffMs);
+        // Filter out members under skip penalty (PRD §M8). Decrement their
+        // counter and record them in the trace so metrics can attribute the
+        // skip. If ALL members are skipped, race produces nothing — fall back
+        // to running them anyway (otherwise the weighting policy could starve
+        // the user permanently).
+        const active = [];
+        for (const p of this.members) {
+            const s = this.stats.get(p.name);
+            if (s.skipRemaining > 0) {
+                s.skipRemaining--;
+                skipped.push(p.name);
+                continue;
+            }
+            active.push(p);
+        }
+        const toRun = active.length > 0 ? active : this.members;
+        // NOTE: `skipped` records members that "would have been skipped" in the normal
+        // path. In the all-skipped fallback (`toRun === this.members`), skipRemaining is
+        // decremented for everyone but they still execute. This prevents starvation when
+        // the weighting policy flags all providers as slow.
         try {
-            const races = this.members.map((p) => this.runMember(p, { ...req, signal: localCtrl.signal }, start, trace));
-            const winner = await firstNonNull(races);
+            const memberRuns = toRun.map((p) => this.runMember(p, { ...req, signal: localCtrl.signal }, start, trace));
+            const winner = await firstNonNull(memberRuns);
             if (winner) {
                 localCtrl.abort();
-                this.lastTrace = { providers: trace, winner: winner.provider };
+                // Wait for losers to push their trace entries before recording
+                // stats — otherwise penalty accounting misses race-cancelled
+                // members and they're never skipped.
+                await Promise.allSettled(memberRuns);
+                this.lastTrace = {
+                    providers: trace,
+                    winner: winner.provider,
+                    ...(skipped.length > 0 ? { skipped } : {}),
+                };
+                this.recordRaceOutcome(trace, winner.provider, req.signal.aborted);
                 return winner.completion;
             }
             // Skip cooldown when the caller cancelled — that's a normal stutter,
@@ -59,7 +126,11 @@ export class RaceProvider {
             if (!req.signal.aborted) {
                 this.cooldownUntil = Date.now() + this.cfg.cooldownMs;
             }
-            this.lastTrace = { providers: trace };
+            this.lastTrace = {
+                providers: trace,
+                ...(skipped.length > 0 ? { skipped } : {}),
+            };
+            this.recordRaceOutcome(trace, null, req.signal.aborted);
             return null;
         }
         finally {
@@ -67,6 +138,215 @@ export class RaceProvider {
             req.signal.removeEventListener("abort", onUserAbort);
         }
     }
+    /**
+     * After a race resolves, update per-member rolling stats and decide who
+     * gets a skip penalty for the next `SKIP_RACES`. A member earns "slow"
+     * if it ran but didn't win this race (when there was a winner).
+     *
+     * `userAborted` distinguishes user-keystroke cancellation from
+     * race-cancellation-by-winner. Member's trace result is "aborted" in
+     * both cases; we only penalize the latter (the member could have run
+     * to completion but lost the race). User keystrokes shouldn't drift
+     * the weighting at all.
+     */
+    recordRaceOutcome(trace, winnerName, userAborted) {
+        if (userAborted)
+            return;
+        for (const entry of trace) {
+            const s = this.stats.get(entry.provider);
+            if (!s)
+                continue;
+            // Aborted-by-race-cancellation IS a slow indicator. Aborted-by-user
+            // is filtered above. Errors don't count toward slowness — that's
+            // a different failure mode.
+            if (entry.result === "error")
+                continue;
+            const slow = winnerName !== null && entry.provider !== winnerName ? 1 : 0;
+            s.slowFlags.push(slow);
+            while (s.slowFlags.length > HISTORY_SIZE)
+                s.slowFlags.shift();
+            if (entry.provider === winnerName)
+                s.wins++;
+            if (s.slowFlags.length >= HISTORY_SIZE &&
+                s.wins === 0 &&
+                s.slowFlags.reduce((a, b) => a + b, 0) >= SLOW_THRESHOLD &&
+                s.skipRemaining === 0) {
+                s.skipRemaining = SKIP_RACES;
+            }
+        }
+    }
+    /**
+     * PRD §M3.5a — streaming variant of `predict`. Each member runs its own
+     * stream under a dedicated AbortController; first member to emit a
+     * non-empty delta wins. Losing members are aborted and their iterators
+     * released. The winner's remaining chunks pass through untouched.
+     *
+     * Trace + stats are recorded identically to `predict()` so M8 weighting
+     * works the same way: winner = first to first-chunk; losers that also
+     * produced are still marked `produced` (they did emit), losers aborted
+     * before producing are `aborted`.
+     */
+    async *predictStream(req) {
+        if (this.members.length === 0)
+            return;
+        const now = Date.now();
+        if (now < this.cooldownUntil) {
+            this.lastTrace = { providers: [] };
+            return;
+        }
+        const trace = [];
+        const skipped = [];
+        const localCtrl = new AbortController();
+        const start = now;
+        const onUserAbort = () => localCtrl.abort();
+        if (req.signal.aborted)
+            localCtrl.abort();
+        else
+            req.signal.addEventListener("abort", onUserAbort, { once: true });
+        const cutoffTimer = setTimeout(() => localCtrl.abort(), this.cfg.cutoffMs);
+        // Skip-penalty filter (same as predict).
+        const active = [];
+        for (const p of this.members) {
+            const s = this.stats.get(p.name);
+            if (s.skipRemaining > 0) {
+                s.skipRemaining--;
+                skipped.push(p.name);
+                continue;
+            }
+            active.push(p);
+        }
+        const toRun = active.length > 0 ? active : this.members;
+        // NOTE: `skipped` records members that "would have been skipped" in the normal
+        // path. In the all-skipped fallback (`toRun === this.members`), skipRemaining is
+        // decremented for everyone but they still execute. This prevents starvation when
+        // the weighting policy flags all providers as slow.
+        const memberCtrls = toRun.map(() => new AbortController());
+        // Cascade localCtrl → all memberCtrls. Each member listens to its
+        // own ctrl signal in its iterator pump; aborting localCtrl propagates.
+        const onLocalAbort = () => {
+            for (const c of memberCtrls)
+                if (!c.signal.aborted)
+                    c.abort();
+        };
+        if (localCtrl.signal.aborted)
+            onLocalAbort();
+        else
+            localCtrl.signal.addEventListener("abort", onLocalAbort, { once: true });
+        const firstChunks = toRun.map((p, i) => this.firstChunkOf(p, req, memberCtrls[i].signal, start, trace, i));
+        try {
+            const winner = await firstWithChunk(firstChunks);
+            if (!winner) {
+                if (!req.signal.aborted)
+                    this.cooldownUntil = Date.now() + this.cfg.cooldownMs;
+                this.lastTrace = {
+                    providers: trace,
+                    ...(skipped.length > 0 ? { skipped } : {}),
+                };
+                this.recordRaceOutcome(trace, null, req.signal.aborted);
+                return;
+            }
+            // Abort losers. Their iterators throw AbortError on their next pump.
+            for (let i = 0; i < memberCtrls.length; i++) {
+                if (i !== winner.idx)
+                    memberCtrls[i].abort();
+            }
+            yield winner.first;
+            try {
+                while (true) {
+                    const { value, done } = await winner.iter.next();
+                    if (done)
+                        break;
+                    if (value.delta !== "")
+                        yield value;
+                }
+            }
+            catch (err) {
+                // Caller-abort or cutoff during drain: swallow so we can still
+                // record trace/stats below. Re-throw non-abort errors (real
+                // provider failures should propagate).
+                const aborted = err?.name === "AbortError";
+                if (!aborted)
+                    throw err;
+            }
+            finally {
+                // Release winner iter (matters when consumer breaks early).
+                if (typeof winner.iter.return === "function") {
+                    await winner.iter.return().catch(() => undefined);
+                }
+            }
+            // Let losers finalize their trace entries before recording stats.
+            await Promise.allSettled(firstChunks);
+            // Release loser iterators that emitted but lost the race.
+            for (const fc of firstChunks) {
+                const r = await fc.catch(() => null);
+                if (r && r.idx !== winner.idx && typeof r.iter.return === "function") {
+                    await r.iter.return().catch(() => undefined);
+                }
+            }
+            this.lastTrace = {
+                providers: trace,
+                winner: toRun[winner.idx].name,
+                ...(skipped.length > 0 ? { skipped } : {}),
+            };
+            this.recordRaceOutcome(trace, toRun[winner.idx].name, req.signal.aborted);
+        }
+        finally {
+            clearTimeout(cutoffTimer);
+            req.signal.removeEventListener("abort", onUserAbort);
+            localCtrl.signal.removeEventListener("abort", onLocalAbort);
+        }
+    }
+    /**
+     * Pump a member's stream until its first non-empty delta. Resolves to
+     * the parked iterator + that delta when produced; null on
+     * empty/aborted/error. Trace is appended for terminal outcomes; the
+     * `produced` entry is pushed once the first non-empty delta arrives so
+     * its latency reflects TTFT, not end-of-stream.
+     */
+    async firstChunkOf(provider, req, signal, start, trace, idx) {
+        const iter = wrapAsStream(provider, { ...req, signal })[Symbol.asyncIterator]();
+        try {
+            while (true) {
+                const { value, done } = await iter.next();
+                if (done) {
+                    trace.push({
+                        provider: provider.name,
+                        latencyMs: Date.now() - start,
+                        result: "empty",
+                    });
+                    return null;
+                }
+                if (value.delta !== "") {
+                    trace.push({
+                        provider: provider.name,
+                        latencyMs: Date.now() - start,
+                        result: "produced",
+                    });
+                    return { idx, iter, first: value };
+                }
+            }
+        }
+        catch (err) {
+            const aborted = err?.name === "AbortError";
+            trace.push({
+                provider: provider.name,
+                latencyMs: Date.now() - start,
+                result: aborted ? "aborted" : "error",
+            });
+            return null;
+        }
+    }
+    /**
+     * Reset all rolling stats (PRD §M8: "Reset state on `setProvider` /
+     * extension reload"). Public for editor reset paths.
+     */
+    resetStats() {
+        for (const s of this.stats.values()) {
+            s.slowFlags.length = 0;
+            s.wins = 0;
+            s.skipRemaining = 0;
+        }
+    }
     async runMember(provider, req, start, trace) {
         try {
             const result = await provider.predict(req);
@@ -94,6 +374,39 @@ export class RaceProvider {
         }
     }
 }
+/**
+ * Resolve to the first promise that fulfils with a non-null value. Resolves
+ * null when all produce null (or throw). Mirrors {@link firstNonNull} but
+ * keeps the resolved object's identity (used by `predictStream` to recover
+ * the winning iterator).
+ */
+function firstWithChunk(promises) {
+    if (promises.length === 0)
+        return Promise.resolve(null);
+    return new Promise((resolve) => {
+        let remaining = promises.length;
+        let settled = false;
+        const finish = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(v);
+        };
+        for (const p of promises) {
+            p.then((v) => {
+                if (v !== null && v.first !== null) {
+                    finish(v);
+                    return;
+                }
+                if (--remaining === 0)
+                    finish(null);
+            }, () => {
+                if (--remaining === 0)
+                    finish(null);
+            });
+        }
+    });
+}
 /**
  * Resolve to the first non-null value among `promises`. Resolves null when
  * all promises produce null (or throw). Never rejects.

package/dist/providers/race.js.map

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

package/dist/providers/truncate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/providers/truncate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,GACf;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKxC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5F"}
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/providers/truncate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,GACf;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBxC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5F"}

package/dist/providers/truncate.js

@@ -1,9 +1,27 @@
+// PRD §M3d: variable-length completions — the model picks the natural
+// boundary (word, phrase, or full line) instead of being forced to a fixed
+// upper bound. `max_tokens=64` still bounds runaway outputs. Removing the
+// 12-word cap lets the model commit a full line where appropriate, which
+// the ranker can then choose against shorter candidates via lengthPrior.
 const SYSTEM_PROMPT = "You are a terminal autocomplete engine. The user is typing a prompt for an AI coding agent. " +
-    "Predict the most likely continuation of the current line — at most one short phrase, no more than 12 words. " +
+    "Suggest a continuation of any length: a word, a phrase, or a full line — whichever best completes the current draft. " +
     "Output ONLY the continuation text, with no quotes, no markdown, no leading whitespace, no explanation. " +
     "If you cannot confidently continue, output an empty string.";
 export function buildPromptMessages(req, maxRecent) {
-    const recent = req.recentMessages.slice(-maxRecent).map((m) => `${m.role}: ${truncate(m.text, 280)}`).join("\n");
+    const recent = req.recentMessages
+        .slice(-maxRecent)
+        .map((m) => {
+        // Chat-style providers can't use OpenAI's `role: "tool"` directly
+        // (requires a paired tool_call_id we don't track). Map tool
+        // entries to a `[tool NAME]` system-message prefix instead.
+        // PRD §M6a documented decision.
+        if (m.role === "tool") {
+            const label = m.toolName ? `[tool ${m.toolName}]` : "[tool]";
+            return `${label}: ${truncate(m.text, 280)}`;
+        }
+        return `${m.role}: ${truncate(m.text, 280)}`;
+    })
+        .join("\n");
     const ctx = recent ? `Recent conversation:\n${recent}\n\n` : "";
     const user = `${ctx}Current draft (cursor at end):\n${req.editorTextBeforeCursor}`;
     return { systemPrompt: SYSTEM_PROMPT, user };

package/dist/providers/truncate.js.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/providers/truncate.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAClB,8FAA8F;IAC9F,8GAA8G;IAC9G,yGAAyG;IACzG,6DAA6D,CAAC;AAE/D,MAAM,UAAU,mBAAmB,CAClC,GAAiB,EACjB,SAAiB;IAEjB,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,yBAAyB,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,GAAG,GAAG,mCAAmC,GAAG,CAAC,sBAAsB,EAAE,CAAC;IACnF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc;IAC5E,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,UAAU,IAAI,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACpD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;YAC7D,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACrC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/providers/truncate.ts"],"names":[],"mappings":"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"}

package/dist/providers/types.d.ts

@@ -2,17 +2,112 @@ import type { PreflightResult } from "./openai-compat-provider.js";
 export interface GhostRequest {
     editorText: string;
     editorTextBeforeCursor: string;
+    /**
+     * Recent conversation messages, oldest-first. `role: "tool"` entries
+     * may carry a `toolName` for richer prompt formatting (PRD §M6a). The
+     * editor only surfaces tool entries when `includeTools` is enabled in
+     * `context-aggregator.getRecentMessages`.
+     */
     recentMessages: Array<{
-        role: "user" | "assistant";
+        role: "user" | "assistant" | "tool";
         text: string;
+        toolName?: string;
     }>;
     cwd: string;
     signal: AbortSignal;
 }
+/**
+ * One candidate completion. `avgLogprob` is the average per-token logprob if
+ * the provider returned them; undefined when not supported. Reranker treats
+ * missing logprobs as the neutral mid-value (0.5 after normalization) per
+ * PRD §M3c.
+ */
+export interface GhostCandidate {
+    text: string;
+    avgLogprob?: number;
+}
+/**
+ * Result of a multi-candidate prediction. `candidates` is ordered as the
+ * provider returned them (no rerank applied yet). Single-candidate providers
+ * return a single-element array.
+ */
+export interface CandidateSet {
+    candidates: GhostCandidate[];
+}
+/**
+ * One streaming delta from a provider. PRD §M3.5a — captures both the
+ * incremental piece (`delta`) and the running concatenation (`cumulative`)
+ * so consumers don't have to track state. `firstChunk` flags the very
+ * first non-empty delta, which is what the editor stamps as `ttftMs`.
+ */
+export interface StreamDelta {
+    delta: string;
+    cumulative: string;
+    firstChunk: boolean;
+}
 export interface GhostProvider {
     readonly name: string;
     readonly debounceMs: number;
     predict(req: GhostRequest): Promise<string | null>;
+    /**
+     * Optional multi-candidate variant. When absent the editor wraps
+     * `predict()` via `wrapAsMulti`. See PRD §M3a.
+     */
+    predictMulti?(req: GhostRequest): Promise<CandidateSet | null>;
+    /**
+     * Optional streaming variant. When present the editor uses it on
+     * single-candidate paths to capture `ttftMs` and (in a follow-up
+     * iteration) drive incremental UI rendering. Providers that don't
+     * stream (e.g. Mercury Edit FIM) omit this method.
+     */
+    predictStream?(req: GhostRequest): AsyncIterable<StreamDelta>;
     preflight?(): Promise<boolean | PreflightResult>;
+    /**
+     * PRD §M3g / §M7 capability flag — true iff the provider populates
+     * per-token logprob values on streamed `StreamDelta` events (M7
+     * entropy-stop input). `StreamDelta` will be extended in a future
+     * change to include per-token logprob data. No provider currently sets
+     * this since `@earendil-works/pi-ai` does not surface logprobs; left in
+     * place so M7 wiring can flip on once upstream support lands without
+     * changing the diagnostics surface. Wording aligns with
+     * `GhostCandidate.avgLogprob`.
+     */
+    readonly supportsLogprobs?: boolean;
 }
+/**
+ * Adapt a `predict()`-only provider into the `CandidateSet | null` shape.
+ * Used by the editor to give every provider a uniform multi-candidate
+ * surface without forcing third-party implementations to upgrade.
+ *
+ * Wrapped candidates intentionally have `avgLogprob: undefined` — the
+ * `predict()` signature returns only text, so logprobs aren't recoverable.
+ * The reranker normalizes missing logprobs to the neutral mid-value (0.5)
+ * per PRD §M3c, so single-candidate wrappers aren't penalized against
+ * providers that do return logprobs.
+ */
+export declare function wrapAsMulti(provider: GhostProvider, req: GhostRequest): Promise<CandidateSet | null>;
+/**
+ * Adapt any provider to the streaming surface. Providers with
+ * `predictStream` pass through unchanged; non-streaming providers get a
+ * single-delta stream emitted after `predict()` resolves. `firstChunk`
+ * is true on the only emission in the non-streaming case.
+ *
+ * Yields nothing when the provider returns null/empty. Consumer code
+ * pattern:
+ *
+ * ```ts
+ * let full = "";
+ * for await (const { cumulative } of wrapAsStream(p, req)) full = cumulative;
+ * ```
+ */
+export declare function wrapAsStream(provider: GhostProvider, req: GhostRequest): AsyncIterable<StreamDelta>;
+/**
+ * Drain a stream into its final cumulative text. Records the timestamp
+ * of the first non-empty chunk on `out.ttftMs` (relative to `startedAt`)
+ * for the caller. The result is the full assembled text, or null if the
+ * stream produced no content.
+ */
+export declare function streamToText(stream: AsyncIterable<StreamDelta>, startedAt: number, out?: {
+    ttftMs?: number;
+}): Promise<string | null>;
 //# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,eAAe,CAAC,CAAC;CACjD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,cAAc,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC/D;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,eAAe,CAAC,CAAC;IACjD;;;;;;;;;OASG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,YAAY,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAK9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAuB,YAAY,CAClC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,YAAY,GACf,aAAa,CAAC,WAAW,CAAC,CAQ5B;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,EAClC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}

package/dist/providers/types.js

@@ -1,2 +1,60 @@
-export {};
+/**
+ * Adapt a `predict()`-only provider into the `CandidateSet | null` shape.
+ * Used by the editor to give every provider a uniform multi-candidate
+ * surface without forcing third-party implementations to upgrade.
+ *
+ * Wrapped candidates intentionally have `avgLogprob: undefined` — the
+ * `predict()` signature returns only text, so logprobs aren't recoverable.
+ * The reranker normalizes missing logprobs to the neutral mid-value (0.5)
+ * per PRD §M3c, so single-candidate wrappers aren't penalized against
+ * providers that do return logprobs.
+ */
+export async function wrapAsMulti(provider, req) {
+    if (provider.predictMulti)
+        return provider.predictMulti(req);
+    const text = await provider.predict(req);
+    if (text === null || text === "")
+        return null;
+    return { candidates: [{ text }] };
+}
+/**
+ * Adapt any provider to the streaming surface. Providers with
+ * `predictStream` pass through unchanged; non-streaming providers get a
+ * single-delta stream emitted after `predict()` resolves. `firstChunk`
+ * is true on the only emission in the non-streaming case.
+ *
+ * Yields nothing when the provider returns null/empty. Consumer code
+ * pattern:
+ *
+ * ```ts
+ * let full = "";
+ * for await (const { cumulative } of wrapAsStream(p, req)) full = cumulative;
+ * ```
+ */
+export async function* wrapAsStream(provider, req) {
+    if (provider.predictStream) {
+        yield* provider.predictStream(req);
+        return;
+    }
+    const text = await provider.predict(req);
+    if (text === null || text === "")
+        return;
+    yield { delta: text, cumulative: text, firstChunk: true };
+}
+/**
+ * Drain a stream into its final cumulative text. Records the timestamp
+ * of the first non-empty chunk on `out.ttftMs` (relative to `startedAt`)
+ * for the caller. The result is the full assembled text, or null if the
+ * stream produced no content.
+ */
+export async function streamToText(stream, startedAt, out = {}) {
+    let full = "";
+    for await (const chunk of stream) {
+        if (chunk.firstChunk && out.ttftMs === undefined) {
+            out.ttftMs = Date.now() - startedAt;
+        }
+        full = chunk.cumulative;
+    }
+    return full.length > 0 ? full : null;
+}
 //# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAkFA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,QAAuB,EACvB,GAAiB;IAEjB,IAAI,QAAQ,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CAClC,QAAuB,EACvB,GAAiB;IAEjB,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;IACR,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO;IACzC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAkC,EAClC,SAAiB,EACjB,MAA2B,EAAE;IAE7B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClD,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACrC,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC"}