pi-ghost-autocomplete 0.9.1 → 0.10.0

package/dist/ghost-utils.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 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]";
+/**
+ * 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

@@ -4,7 +4,7 @@
  */
 import { type ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import { type GhostConfig } from "./config.js";
-import type { GhostDiagnostics } from "./ghost-editor.js";
+import type { GhostDiagnostics } from "./ghost-utils.js";
 declare const ghost: ExtensionFactory;
 /**
  * PRD §M3g — render the diagnostic snapshot from `GhostEditor.getDiagnostics`
@@ -32,8 +32,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";