pi-ghost-autocomplete 0.4.0 → 0.5.0

package/dist/providers/openai-compat-chat-provider.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
+import type { OpenAICompatChatProviderConfig } from "../config.js";
+import type { PreflightResult } from "./openai-compat-provider.js";
+import type { GhostProvider, GhostRequest } from "./types.js";
+/**
+ * Chat-register provider for OpenAI-compatible `/chat/completions` backends
+ * (e.g. Inception Mercury's conversational model). Sibling of
+ * {@link OpenAICompatProvider}, which uses `/fim/completions` for code.
+ *
+ * This is the natural-language leg of {@link RouterProvider}: instead of
+ * completing code, it completes the developer's *message to the AI coding
+ * agent*. The persona that frames the model — "continue the developer's
+ * request, don't perform the task" — lives in {@link buildPromptMessages}'s
+ * system prompt, shared with the cloud/local chat providers so the wording
+ * can't drift across backends.
+ */
+export declare class OpenAICompatChatProvider implements GhostProvider {
+    private readonly config;
+    readonly name: string;
+    constructor(config: OpenAICompatChatProviderConfig);
+    get debounceMs(): number;
+    /**
+     * Validate the API key with a minimal chat request. A successful response
+     * (even an empty completion) proves auth + connectivity.
+     */
+    preflight(): Promise<PreflightResult>;
+    predict(req: GhostRequest): Promise<string | null>;
+}

package/dist/providers/router.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SPDX-License-Identifier: SSPL-1.0
+ * SPDX-FileCopyrightText: 2025 Alessandro Pungitore <alessandro@pungitore.ch>
+ */
+/**
+ * Register-routing provider (PRD §M3h). Holds two legs and dispatches each
+ * request to the one whose *register* fits the user's intent:
+ *
+ *  - **FIM leg** (code register) — `command`, `path-ref`, and unclassified
+ *    requests. A code fill-in-the-middle model (Mercury Edit) completes
+ *    commands, paths, and code-shaped drafts.
+ *  - **chat leg** (instruction register) — `instruction`, `question`, `prose`.
+ *    A conversational model completes the developer's *message to the AI coding
+ *    agent* (their request/instruction), instead of writing the solution. This
+ *    is the fix for "the autocomplete keeps suggesting solutions": a code-FIM
+ *    model, fed a natural-language prompt, completes it like code.
+ *
+ * When `chat` is null the router degrades to FIM-only — byte-for-byte the
+ * default behavior before routing existed, so enabling router mode without a
+ * reachable chat backend never regresses.
+ */
+import type { PromptIntent } from "../intent.js";
+import type { PreflightResult } from "./openai-compat-provider.js";
+import { type CandidateSet, type GhostProvider, type GhostRequest } from "./types.js";
+/** Pure routing predicate — exported for direct testing. */
+export declare function routeToChat(intent: PromptIntent | undefined): boolean;
+export declare class RouterProvider implements GhostProvider {
+    private readonly fim;
+    private readonly chat;
+    readonly name = "ghost-router";
+    constructor(fim: GhostProvider, chat: GhostProvider | null);
+    get debounceMs(): number;
+    /**
+     * Which leg an intent resolves to — `"chat"` only when a chat leg is
+     * present AND the intent is natural-language; otherwise `"fim"` (including
+     * the chat-absent fallback). Pure; used by the editor to tag metrics with
+     * the served register so bench can split FIM-vs-chat quality.
+     */
+    legFor(intent: PromptIntent | undefined): "fim" | "chat";
+    /** Choose the leg for this request. Chat leg only when present AND the
+     *  intent is natural-language; otherwise FIM. */
+    private leg;
+    predict(req: GhostRequest): Promise<string | null>;
+    /**
+     * Route, then adapt the chosen leg to the multi-candidate surface. The
+     * editor calls this (router exposes no `predictStream`, so it takes the
+     * `wrapAsMulti` branch). `wrapAsMulti` uses the leg's own `predictMulti`
+     * when present (FIM parallel-fire) and otherwise wraps `predict`.
+     */
+    predictMulti(req: GhostRequest): Promise<CandidateSet | null>;
+    /**
+     * Preflight the FIM leg — it carries the primary key/endpoint and is the
+     * always-present leg. The chat leg shares the same vendor/key by default;
+     * its own failures surface as silently-dropped NL completions (which fall
+     * back to nothing rather than a wrong answer), so we don't block startup
+     * on it.
+     */
+    preflight(): Promise<boolean | PreflightResult>;
+}