pi-ghost-autocomplete 0.3.2 → 0.5.0

package/dist/config.d.ts

@@ -1,5 +1,9 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
 import { type KnownProvider } from "@earendil-works/pi-ai";
-export type ProviderKind = "cloud" | "local" | "openai-compat" | "race";
+export type ProviderKind = "cloud" | "local" | "openai-compat" | "openai-compat-chat" | "race" | "router";
 export interface OpenAICompatProviderConfig {
     kind: "openai-compat";
     /** Logical name shown in metrics/UI (e.g. "mercury-edit"). */
@@ -22,6 +26,27 @@ export interface OpenAICompatProviderConfig {
      */
     parallelN: number;
 }
+/**
+ * Chat-register sibling of {@link OpenAICompatProviderConfig}. Targets the
+ * OpenAI-compatible `/chat/completions` endpoint (e.g. Inception Mercury's chat
+ * model) instead of `/fim/completions`. Used as the natural-language leg of a
+ * {@link RouterProviderConfig}: where FIM completes code, this completes the
+ * developer's *message to the agent* with a persona system prompt.
+ */
+export interface OpenAICompatChatProviderConfig {
+    kind: "openai-compat-chat";
+    /** Logical name shown in metrics/UI (e.g. "mercury-chat"). */
+    providerName: string;
+    baseUrl: string;
+    apiKey?: string;
+    modelId: string;
+    debounceMs: number;
+    maxTokens: number;
+    maxRecentMessages: number;
+    temperature: number;
+    /** Optional context-window hint. Defaults to 8192 where consulted. */
+    contextWindow?: number;
+}
 export interface CloudProviderConfig {
     kind: "cloud";
     provider: KnownProvider;
@@ -51,7 +76,19 @@ export interface RaceProviderConfig {
     cutoffMs: number;
     maxRecentMessages: number;
 }
-export type ProviderConfig = CloudProviderConfig | LocalProviderConfig | OpenAICompatProviderConfig | RaceProviderConfig;
+/**
+ * Register-routing provider (PRD §M3h): dispatches each request to the FIM leg
+ * or the chat leg based on the classified prompt intent. Code-shaped intents
+ * (`command`, `path-ref`, unclassified) go to `fim`; natural-language intents
+ * (`instruction`, `question`, `prose`) go to `chat`. When `chat` is absent the
+ * router degrades to FIM-only — identical to today's default behavior.
+ */
+export interface RouterProviderConfig {
+    kind: "router";
+    fim: OpenAICompatProviderConfig;
+    chat: OpenAICompatChatProviderConfig | CloudProviderConfig | LocalProviderConfig | null;
+}
+export type ProviderConfig = CloudProviderConfig | LocalProviderConfig | OpenAICompatProviderConfig | OpenAICompatChatProviderConfig | RaceProviderConfig | RouterProviderConfig;
 export interface GhostConfig {
     enabled: boolean;
     provider: ProviderConfig;
@@ -61,6 +98,13 @@ export interface GhostConfig {
 export declare const DEFAULT_CLOUD_CONFIG: CloudProviderConfig;
 export declare const DEFAULT_LOCAL_CONFIG: LocalProviderConfig;
 export declare const DEFAULT_MERCURY_CONFIG: OpenAICompatProviderConfig;
+/**
+ * Default chat-register leg for router mode. Same Inception base URL + key as
+ * the FIM leg, but the general (non-edit) Mercury model over `/chat/completions`.
+ * `mercury-2` is Inception's conversational model; override with
+ * `PI_GHOST_CHAT_MODEL` if the account exposes a different chat model id.
+ */
+export declare const DEFAULT_MERCURY_CHAT_CONFIG: OpenAICompatChatProviderConfig;
 export declare const DEFAULT_CONFIG: GhostConfig;
 export declare function readConfigFromEnv(): GhostConfig;
 /**
@@ -95,4 +139,3 @@ export declare function redactConfig<T>(cfg: T): T;
  *  - Other schemes (`file:`, `data:`, etc.) rejected unconditionally.
  */
 export declare function validateBaseUrl(raw: string, fieldName?: string): string | null;
-//# sourceMappingURL=config.d.ts.map

package/dist/context-aggregator.d.ts

@@ -1,3 +1,7 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
 /**
@@ -20,4 +24,3 @@ export declare function getRecentMessages(ctx: ExtensionContext, max: number, op
     includeTools?: boolean;
 }): RecentMessage[];
 export declare function extractText(msg: AgentMessage): string;
-//# sourceMappingURL=context-aggregator.d.ts.map

package/dist/cycle-manager.d.ts

@@ -1,24 +1,6 @@
 /**
- * CycleManager — owns multi-candidate state and word-level partial-accept
- * gestures for the GREAT Ghost autocomplete.
- *
- * PRD §M3e (Alt+]/Alt+[ cycling with clamp-at-edges, no wrap) +
- * PRD §M3f (Ctrl+Right word-by-word acceptance in append mode).
- *
- * Design notes:
- *
- *  - Candidate list is stored read-only (frozen) so that future refactors
- *    don't accidentally mutate ranked text. Per-candidate consumption from
- *    word-level accepts is tracked separately in `consumed[idx]`.
- *  - `current` returns `string | null` — `null` distinguishes "no candidates
- *    installed" from "current candidate is empty after full consumption".
- *  - `acceptPartialWordAppend()` is named to make the append-mode invariant
- *    impossible to forget at call sites. Replace-mode ghosts (fuzzy/path)
- *    accept atomically; word-by-word doesn't apply.
- *  - No hidden auto-reset: caller is responsible for `reset()` after the
- *    final-chunk accept so the lifecycle is explicit.
- *
- * Extracted as part of refactor #57 so `GhostEditor` stays thin.
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
  */
 /**
  * Pure helper: compute the next index for Alt+]/Alt[+ cycle.
@@ -99,4 +81,3 @@ export declare class CycleManager {
         partials: number;
     };
 }
-//# sourceMappingURL=cycle-manager.d.ts.map

package/dist/entropy-stop.d.ts

@@ -1,3 +1,7 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
 /**
  * Entropy-based early stop. PRD §M7.
  *
@@ -99,4 +103,3 @@ export declare function runWithStop(tokens: Iterable<{
     stopped: boolean;
     reason?: "entropy-spike" | "max-tokens";
 };
-//# sourceMappingURL=entropy-stop.d.ts.map

package/dist/eval-dataset.d.ts

@@ -1,16 +1,6 @@
 /**
- * Offline-eval dataset — capture + load. PRD §M5c.
- *
- * One JSONL example per committed prompt sample. The shape captures
- * everything a replay run needs to reproduce the original ghost call:
- * `(context, prefix, expected continuation, provider fingerprint)`.
- *
- * Privacy: examples DO contain raw prompt text. Capture is gated on the
- * `PI_GHOST_EVAL_CAPTURE=1` env (not a default behavior — opt-in only).
- * Sanitization still applies through `containsSensitive` so messages
- * with API keys are dropped at capture time. Downstream tooling (CLI
- * replay) ships a `--redact` flag that emits aggregate metrics without
- * raw examples for publication.
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
  */
 export declare const EVAL_REL = ".pi/ghost-autocomplete/eval.jsonl";
 /** Char positions at which to sample prefixes from a committed line. */
@@ -63,4 +53,3 @@ export declare function loadExamples(cwd: string): Promise<EvalExample[]>;
 export declare function parseExamples(body: string): EvalExample[];
 /** Parse `PI_GHOST_EVAL_CAPTURE`. Returns true only when set to "1". */
 export declare function parseEvalCaptureEnv(raw: string | undefined): boolean;
-//# sourceMappingURL=eval-dataset.d.ts.map

package/dist/fuzzy-matcher.d.ts

@@ -1,3 +1,7 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
 import type { PathIndex } from "./path-index.js";
 export interface FindFuzzyOptions {
     recentPaths?: Set<string> | null;
@@ -55,4 +59,3 @@ export declare function hasActionTrigger(prefix: string): boolean;
  * 70-84). Scores < 70 should not be shown deterministically.
  */
 export declare function findFuzzyFilename(index: PathIndex, token: string, opts?: FindFuzzyOptions): FuzzyMatch | null;
-//# sourceMappingURL=fuzzy-matcher.d.ts.map

package/dist/ghost-editor.d.ts

@@ -1,3 +1,7 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
 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";
@@ -41,6 +45,12 @@ export declare class GhostEditor extends CustomEditor {
     private debounceTimer;
     private inflight;
     private lastTextSeen;
+    /** Last classified intent, set during handleTextChange and consumed
+     *  by buildPredictionContext when the LLM fires after debounce. */
+    private currentIntent;
+    /** Ring buffer of recently-dismissed deterministic completions,
+     *  used to suppress re-showing the same path in the same context. */
+    private readonly dismissCache;
     private disposed;
     private shownMetric;
     private recentPaths;
@@ -194,7 +204,7 @@ export declare class GhostEditor extends CustomEditor {
      * served. Profile must exist; line must start with `/`.
      */
     private trySlashFastPath;
-    private tryDeterministic;
+    private tryDeterministicWithLines;
     private getRecentPaths;
     private applyDeterministic;
     private replaceTokenAtCursor;
@@ -379,4 +389,3 @@ export declare function visualWidth(s: string): number;
  * Returns the empty string if `maxCols <= 0` or no characters fit.
  */
 export declare function clipToWidth(s: string, maxCols: number): string;
-//# sourceMappingURL=ghost-editor.d.ts.map

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+/**
+ * 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";
@@ -13,12 +17,14 @@ export default ghost;
 export { CloudProvider } from "./providers/cloud-provider.js";
 export { LocalProvider } from "./providers/local-provider.js";
 export { OpenAICompatProvider } from "./providers/openai-compat-provider.js";
+export { OpenAICompatChatProvider } from "./providers/openai-compat-chat-provider.js";
+export { RouterProvider, routeToChat } from "./providers/router.js";
 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 } from "./ghost-editor.js";
 export type { GhostDiagnostics } from "./ghost-editor.js";
-export type { GhostConfig, ProviderConfig, CloudProviderConfig, LocalProviderConfig, OpenAICompatProviderConfig, RaceProviderConfig } from "./config.js";
+export type { GhostConfig, ProviderConfig, CloudProviderConfig, LocalProviderConfig, OpenAICompatProviderConfig, OpenAICompatChatProviderConfig, RaceProviderConfig, RouterProviderConfig } from "./config.js";
 export type { GhostProvider, GhostRequest } from "./providers/types.js";
 export { MetricsLogger, readMetricsConfigFromEnv } from "./metrics.js";
 export { ProfileStore } from "./profile-store.js";
@@ -39,4 +45,3 @@ export type { FindPathPrefixOptions } from "./path-matcher.js";
 export { extractRecentPaths, getRoleWeightedRecent, recentBoost } from "./recent-paths.js";
 export { formatReport, loadMetrics, parseMetricsText, quantile, runBenchmark, summarize, THRESHOLDS, } from "./bench.js";
 export type { BenchmarkReport, ModeStats, ProviderStats } from "./bench.js";
-//# sourceMappingURL=index.d.ts.map