pi-ghost-autocomplete 0.9.1 → 0.11.0

package/dist/ghost-editor.d.ts

@@ -5,42 +5,14 @@
 import { CustomEditor, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { KeybindingsManager } from "@earendil-works/pi-coding-agent";
 import { type EditorTheme, type TUI } from "@earendil-works/pi-tui";
-import type { AcceptKeyId, GhostConfig, ProviderConfig } from "./config.js";
+import type { GhostConfig } from "./config.js";
 import type { SnoozeController } from "./snooze.js";
-import { type RecentMessage } from "./context-aggregator.js";
 import type { MetricsLogger } from "./metrics.js";
 import type { PathIndex } from "./path-index.js";
 import type { ProfileStore } from "./profile-store.js";
 export { cycleCandidateIdx, nextLineChunk, nextWordChunk } from "./cycle-manager.js";
 import { type GhostProvider } from "./providers/types.js";
-/**
- * #5 helper — classify a stale event as divergent or typed-through given
- * the ghost state at render time and the post-change text. Returns true
- * when the user typed characters that are NOT a prefix of the suggested
- * ghost. Pure / exported for testability — the editor wraps this in
- * `recordDivergentTyped` to track the consecutive run.
- */
-export declare function isTypedPastDivergent(ghost: string, ghostForText: string, textAfterChange: string): boolean;
-/** Parse `PI_GHOST_SHORT_HOVER_MS`. Falls back to the default on invalid
- *  or non-positive input. Exposed for tests; called once per dismiss. */
-export declare function parseShortHoverEnv(raw: string | undefined): number;
-/** Gap-fix P1.3 — one-shot discoverability suffix on the first painted ghost. */
-export declare const ACCEPT_HINT_SUFFIX = "  [\u2192 accept]";
-/**
- * Build the visible ghost string (markers + optional accept hint).
- * Pure helper so render logic is unit-testable without a TUI.
- */
-export declare function formatGhostDisplay(input: {
-    ghost: string;
-    replaceMode: boolean;
-    provisional: boolean;
-    showAcceptHint: boolean;
-}): string;
-/**
- * Gap-fix P2.2 — which keys trigger a full accept (before popup/cursor guards).
- * Pure so unit tests cover the key matrix without a live editor.
- */
-export declare function isFullAcceptKey(data: string, acceptKeys: readonly AcceptKeyId[]): boolean;
+import { type GhostDiagnostics } from "./ghost-utils.js";
 /** Gap-fix P2.3 — optional lifecycle events for future AT / telemetry bridges. */
 export type GhostLifecycleEvent = {
     type: "shown";
@@ -93,7 +65,15 @@ export declare class GhostEditor extends CustomEditor {
     private shownMetric;
     private recentPaths;
     private recentPathsAt;
+    /** pi-api #2 — exact tool-input paths (read/edit/write) with record
+     *  timestamps. Kept separately from `recentPaths` so the 5 s scrape
+     *  refresh never drops them; pruned by TOOL_PATH_TTL_MS at merge. */
+    private readonly toolPaths;
     private readonly fastPath;
+    /** Static context-selection env knobs (PRD §M6d), snapshotted once at
+     *  construction instead of re-read per prediction (#3 — was 5 env reads
+     *  per request in `buildSelectedContext`). */
+    private readonly contextEnvOpts;
     private readonly providerFingerprint;
     private readonly versionFingerprint;
     /** Tracks the prefix shown alongside the current ghost so commit-time
@@ -337,6 +317,14 @@ export declare class GhostEditor extends CustomEditor {
     private trySlashFastPath;
     private tryDeterministicWithLines;
     private getRecentPaths;
+    /**
+     * pi-api-suggestion-sources #2 — record an exact path from a successful
+     * read/edit/write tool call. Tool inputs are the precise strings the
+     * agent used; regex-scraped message mentions only approximate them.
+     * The path is normalized to the PathIndex's coordinate system
+     * (root-relative POSIX) so it exact-hits index entries in `recentBoost`.
+     */
+    recordRecentToolPath(rawPath: string): void;
     private applyDeterministic;
     private replaceTokenAtCursor;
     /**
@@ -359,49 +347,39 @@ export declare class GhostEditor extends CustomEditor {
     /**
      * Post-provider-call disposition: stamp TTFT, run the post-flight gate,
      * sanitize empty results, rerank, apply confidence gate, reconcile with
-     * any displayed provisional, and commit. Each early-return emits the
-     * appropriate metric; the happy path lands in `commitDisplayedGhost`.
-     *
-     * Extracted from `requestPrediction` as part of refactor #57 phase 1 so
-     * the orchestrator stays a thin sequence (build → await → finalize).
+     * any displayed provisional, and commit. Delegates to
+     * `ghost-provider-finalizer.ts` (#57 slice 4d + 4e): the finalization
+     * pipeline (finalize + commit) moved out; the editor supplies every
+     * collaborator (state refs + bound side-effect callbacks) so mutations
+     * stay owned here while the logic is unit-testable in isolation.
      */
     private finalizeProviderResult;
     /**
      * Centralized post-provider-call disposition. Returns `null` when the
      * result is good to render; otherwise the abort reason the caller should
-     * report via `emitMetric`. Clears `this.inflight` only on the happy path
-     * (matches the prior in-line behavior at the first non-aborted check) so
-     * an `aborted` return leaves `inflight` for the catch / next request to
-     * deal with.
+     * report via `emitMetric`. Delegates to `ghost-request-pipeline.ts`
+     * (#57 slice 4c): the pure fn reads a state snapshot; the editor owns
+     * the `inflight` mutation and clears it whenever the fn says to (every
+     * branch except the first `aborted`, which leaves `inflight` for the
+     * catch / next request to clear).
      */
     private postFlightCheck;
     /**
-     * PRD §M3.5a — invoke the provider in either streaming or multi-candidate
-     * mode and (when streaming) drive incremental UI paint via `onChunk`.
-     * Stamps TTFT on the first stream chunk and returns it for the caller to
-     * attach to the pending metric.
-     *
-     * - Streaming path: provider exposes `predictStream` AND lacks
-     *   `predictMulti`. Used by Mercury FIM streaming + LocalProvider.
-     * - Multi path: everything else (openai-compat FIM, race with sync
-     *   members). `onChunk` is ignored.
-     *
-     * Extracted from `requestPrediction` as part of refactor #57 so the
-     * orchestrator stays focused on rerank / reconcile / commit.
+     * PRD §M3.5a — invoke the provider in streaming or multi-candidate mode
+     * and drive incremental UI paint via `onChunk`. Delegates to
+     * `ghost-request-pipeline.ts` (#57 slice 4c): pure async dispatch + TTFT
+     * stamp, no editor state.
      */
     private runPredictionPath;
+    private emitMetric;
     /**
-     * Commit a successfully-reconciled LLM ghost to all on-screen + fast-path
-     * structures: ranked candidate list, ghost text, cache, speculative ring,
-     * and the pending metric record. Extracted from `requestPrediction` as
-     * part of refactor #57 to keep the orchestrator readable.
-     *
-     * Cache + speculative ring store the *reranked* top — a subsequent cache
-     * hit must reproduce what the user actually saw, not the provider's
-     * pre-rerank order.
+     * Finalize a shown ghost on accept / dismiss / stale / expired: build the
+     * metrics record, apply cache/trie side effects, manage the regret-window
+     * supersede invariant, and either arm the regret window (accepts) or log.
+     * Delegates to `ghost-provider-finalizer.ts` (#57 slice 4g); the regret
+     * state machine (handle + timer) stays editor-owned and is surfaced as
+     * callbacks so the acceptance decision tree is unit-testable in isolation.
      */
-    private commitDisplayedGhost;
-    private emitMetric;
     private finalizeShown;
     /**
      * Detach + clear the pending-regret watch (handle + timer) atomically
@@ -421,102 +399,3 @@ export declare class GhostEditor extends CustomEditor {
      */
     private flushRegret;
 }
-/**
- * Render a recent-messages array into a single string for eval capture
- * (PRD §M5c). Format mirrors the provider context shape — `role: text`
- * joined by newlines — so a CLI replay can feed it back to the same
- * provider. Tool entries get a `tool ${name}:` label.
- */
-export declare function renderContextForEval(recent: RecentMessage[]): string;
-export interface GhostDiagnostics {
-    provider: string | null;
-    providerFingerprint: string;
-    versionFingerprint: string;
-    /** PRD §M3g — capability flags detected from the active provider. */
-    capabilities: {
-        streaming: boolean;
-        multiCandidate: boolean;
-        preflight: boolean;
-        /** PRD §M7 — provider populates per-token `-logprob` on stream events. */
-        logprobs: boolean;
-    };
-    cache: {
-        size: number;
-        hits: number;
-        misses: number;
-        hitRate: number;
-    };
-    trie: {
-        prefixes: number;
-        candidates: number;
-        insertsSinceDecay: number;
-    };
-    profile: {
-        enabled: boolean;
-        ngrams: number;
-        paths: number;
-        slash: number;
-        accepts: number;
-        decayDays: number;
-    };
-    race: {
-        cooldown: {
-            active: boolean;
-            remainingMs: number;
-        };
-        members: Array<{
-            name: string;
-            slowCount: number;
-            wins: number;
-            skipRemaining: number;
-        }>;
-    } | null;
-    ghostShown: boolean;
-    /** PRD §M5a — regret window state. `null` when no accept is being
-     *  watched; otherwise the remaining ms until the window closes. */
-    pendingRegret: {
-        remainingMs: number;
-        insertedLen: number;
-    } | null;
-    /**
-     * Enhancement #1 — edit-history snapshot for `/ghost` diag. `enabled`
-     * mirrors `PI_GHOST_EDIT_HISTORY`; the remaining fields are populated
-     * even when disabled (they'll just report zeros).
-     */
-    editHistory: {
-        enabled: boolean;
-        events: number;
-        capacity: number;
-        uris: number;
-        topAdded: string[];
-        topRemoved: string[];
-        oldestAgeMs: number | null;
-        halfLifeMs: number;
-    };
-}
-/**
- * Build a stable provider fingerprint from the config. For race configs, fold
- * each member into the `extras` map so member rotation invalidates cache.
- */
-export declare function providerFingerprintFromConfig(cfg: ProviderConfig): string;
-/**
- * Pure helper: replace the slice `[from.col, end-of-line]` on `from.line` of
- * `text` with `replacement`. Exported for testability.
- *
- * Caller must guarantee the cursor sits at end of `from.line` and that the
- * replacement is intended to land there; this helper does not validate.
- */
-export declare function computeReplacement(text: string, from: {
-    line: number;
-    col: number;
-}, replacement: string): string;
-/**
- * Visible column width of a possibly-ANSI-colored string.
- * Uses string-width which handles wide chars, combining marks, and emoji.
- */
-export declare function visualWidth(s: string): number;
-/**
- * Clip a string to fit in `maxCols` terminal columns, grapheme-aware.
- * Returns the empty string if `maxCols <= 0` or no characters fit.
- */
-export declare function clipToWidth(s: string, maxCols: number): string;

package/dist/ghost-utils.d.ts

@@ -0,0 +1,150 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro.pungitore.ch>
+ */
+import type { AcceptKeyId, ProviderConfig } from "./config.js";
+import type { RecentMessage } from "./context-aggregator.js";
+/** Parse `PI_GHOST_SHORT_HOVER_MS`. Falls back to the default on invalid
+ *  or non-positive input. Exposed for tests; called once per dismiss. */
+export declare function parseShortHoverEnv(raw: string | undefined): number;
+/**
+ * #5 — was the user's typed tail divergent from the ghost? `false` when the
+ * ghost is empty, when nothing was typed, or when the typed tail is a prefix
+ * of the ghost (accept-in-progress). Drives `recordDivergentTyped`.
+ */
+export declare function isTypedPastDivergent(ghost: string, ghostForText: string, textAfterChange: string): boolean;
+/** Gap-fix P1.3 — one-shot discoverability suffix on the first painted ghost. */
+export declare const ACCEPT_HINT_SUFFIX = "  [\u2192 accept]";
+/** Historical ghost styling (pi < 0.99): SGR 2 faint + bright black (256-color 8/90). */
+export declare const GHOST_ANSI_FALLBACK: Readonly<{
+    open: string;
+    close: string;
+}>;
+/**
+ * Theme-aware ghost text styling. Pi 0.99 exposes the live `Theme` object as
+ * `ctx.ui.theme`; its `getFgAnsi("dim")` returns the opening escape sequence
+ * for the active theme's dim/faint token (faint tokens include SGR 2). With
+ * 0.99's default `system` theme the color is derived from the terminal's own
+ * palette and follows light/dark switches — instead of our hardcoded
+ * bright-black, which can be invisible or indistinguishable on palettes where
+ * color 8 sits near the foreground or background. Feature-detected so pi
+ * 0.84 hosts keep the historical fallback; pure over the passed ui handle.
+ */
+export declare function resolveGhostAnsi(ui: unknown): {
+    open: string;
+    close: string;
+};
+/**
+ * Build the visible ghost string (markers + optional accept hint).
+ * Pure helper so render logic is unit-testable without a TUI.
+ */
+export declare function formatGhostDisplay(input: {
+    ghost: string;
+    replaceMode: boolean;
+    provisional: boolean;
+    showAcceptHint: boolean;
+}): string;
+/**
+ * Gap-fix P2.2 — which keys trigger a full accept (before popup/cursor guards).
+ * Pure so unit tests cover the key matrix without a live editor.
+ */
+export declare function isFullAcceptKey(data: string, acceptKeys: readonly AcceptKeyId[]): boolean;
+/**
+ * Build a stable provider fingerprint from the config. For race configs, fold
+ * each member into the `extras` map so member rotation invalidates cache.
+ */
+export declare function providerFingerprintFromConfig(cfg: ProviderConfig): string;
+/**
+ * Render a recent-messages array into a single string for eval capture
+ * (PRD §M5c). Format mirrors the provider context shape — `role: text`
+ * joined by newlines — so a CLI replay can feed it back to the same
+ * provider. Tool entries get a `tool ${name}:` label.
+ */
+export declare function renderContextForEval(recent: RecentMessage[]): string;
+/**
+ * Pure helper: replace the slice `[from.col, end-of-line]` on `from.line` of
+ * `text` with `replacement`. Exported for testability.
+ *
+ * Caller must guarantee the cursor sits at end of `from.line` and that the
+ * replacement is intended to land there; this helper does not validate.
+ */
+export declare function computeReplacement(text: string, from: {
+    line: number;
+    col: number;
+}, replacement: string): string;
+/**
+ * Visible column width of a possibly-ANSI-colored string.
+ * Uses string-width which handles wide chars, combining marks, and emoji.
+ */
+export declare function visualWidth(s: string): number;
+/**
+ * Clip a string to fit in `maxCols` terminal columns, grapheme-aware.
+ * Returns the empty string if `maxCols <= 0` or no characters fit.
+ */
+export declare function clipToWidth(s: string, maxCols: number): string;
+export interface GhostDiagnostics {
+    provider: string | null;
+    providerFingerprint: string;
+    versionFingerprint: string;
+    /** PRD §M3g — capability flags detected from the active provider. */
+    capabilities: {
+        streaming: boolean;
+        multiCandidate: boolean;
+        preflight: boolean;
+        /** PRD §M7 — provider populates per-token `-logprob` on stream events. */
+        logprobs: boolean;
+    };
+    cache: {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    trie: {
+        prefixes: number;
+        candidates: number;
+        insertsSinceDecay: number;
+    };
+    profile: {
+        enabled: boolean;
+        ngrams: number;
+        paths: number;
+        slash: number;
+        accepts: number;
+        decayDays: number;
+    };
+    race: {
+        cooldown: {
+            active: boolean;
+            remainingMs: number;
+        };
+        members: Array<{
+            name: string;
+            slowCount: number;
+            wins: number;
+            skipRemaining: number;
+        }>;
+    } | null;
+    ghostShown: boolean;
+    /** PRD §M5a — regret window state. `null` when no accept is being
+     *  watched; otherwise the remaining ms until the window closes. */
+    pendingRegret: {
+        remainingMs: number;
+        insertedLen: number;
+    } | null;
+    /**
+     * Enhancement #1 — edit-history snapshot for `/ghost` diag. `enabled`
+     * mirrors `PI_GHOST_EDIT_HISTORY`; the remaining fields are populated
+     * even when disabled (they'll just report zeros).
+     */
+    editHistory: {
+        enabled: boolean;
+        events: number;
+        capacity: number;
+        uris: number;
+        topAdded: string[];
+        topRemoved: string[];
+        oldestAgeMs: number | null;
+        halfLifeMs: number;
+    };
+}

package/dist/index.d.ts

@@ -2,10 +2,20 @@
  * SPDX-License-Identifier: SSPL-1.0
  * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
  */
-import { type ExtensionFactory } from "@earendil-works/pi-coding-agent";
-import { type GhostConfig } from "./config.js";
-import type { GhostDiagnostics } from "./ghost-editor.js";
+import { type ExtensionFactory, type ModelRegistry } from "@earendil-works/pi-coding-agent";
+import { type GhostConfig, type PiModelProviderConfig } from "./config.js";
+import type { GhostDiagnostics } from "./ghost-utils.js";
+import { PiModelProvider } from "./providers/pi-model-provider.js";
 declare const ghost: ExtensionFactory;
+/**
+ * Build a router's pi chat leg and drop it when its (local-only, cheap)
+ * preflight fails. Returned warning is null when the leg is healthy.
+ * Exported for tests; pure over (config, registry).
+ */
+export declare function resolvePiChatLeg(cfg: PiModelProviderConfig, registry: ModelRegistry): Promise<{
+    provider: PiModelProvider | null;
+    warning: string | null;
+}>;
 /**
  * PRD §M3g — render the diagnostic snapshot from `GhostEditor.getDiagnostics`
  * alongside the provider config. The output is a single notify-friendly
@@ -32,8 +42,10 @@ export { RouterProvider, routeToChat, routeToChatByRegister } from "./providers/
 export type { PreflightResult } from "./providers/openai-compat-provider.js";
 export { RaceProvider, firstNonNull } from "./providers/race.js";
 export type { RaceConfig, RaceTrace } from "./providers/race.js";
-export { GhostEditor, computeReplacement, isFullAcceptKey } from "./ghost-editor.js";
-export type { GhostDiagnostics, GhostLifecycleEvent, GhostLifecycleListener } from "./ghost-editor.js";
+export { GhostEditor } from "./ghost-editor.js";
+export type { GhostLifecycleEvent, GhostLifecycleListener } from "./ghost-editor.js";
+export { computeReplacement, isFullAcceptKey } from "./ghost-utils.js";
+export type { GhostDiagnostics } from "./ghost-utils.js";
 export type { GhostConfig, AcceptKeyId, ProviderConfig, CloudProviderConfig, LocalProviderConfig, OpenAICompatProviderConfig, OpenAICompatChatProviderConfig, RaceProviderConfig, RouterProviderConfig, } from "./config.js";
 export { parseAcceptKeys, DEFAULT_ACCEPT_KEYS } from "./config.js";
 export { BUILTIN_SLASH_COMMANDS, mergeKnownCommands, seedCommandTrie, COLD_START_TRIE_WEIGHT, } from "./cold-start.js";