pi-ghost-autocomplete 0.3.2 → 0.4.0

package/dist/candidate-rerank.js

@@ -1,78 +0,0 @@
-/**
- * Pure rerank pipeline for an LLM `CandidateSet`. Extracted from
- * `GhostEditor.requestPrediction` as part of refactor #57 so the editor
- * stays thin and the rerank-+-confidence-gate path is unit-testable in
- * isolation.
- *
- * PRD §M3c (weighted reranker) + §M3c.1 (confidence gate) + §M4
- * (profile-bias signal). Single-candidate sets bypass the reranker
- * entirely — there is no reordering to do and the confidence gate is
- * not applicable (it operates on the reranked top-vs-second margin).
- *
- * No `this`, no I/O, no editor state — caller supplies env strings and
- * an optional `profileBias` function.
- */
-import { applyConfidenceGate, parseMinConfidenceEnv, parseWeightsEnv, rerank, } from "./reranker.js";
-/**
- * Rerank a candidate set + apply the optional confidence gate. Returns
- * `{ gated: true }` when the gate rejected the result (caller should emit
- * a `rejected` metric and skip rendering). Otherwise returns the reordered
- * candidate texts plus the top pick.
- */
-export function rerankCandidateSet(input) {
-    // Empty set is structurally invalid for this function — the caller
-    // must guard for `!result || !set` BEFORE invoking. Treat as gated so
-    // any future re-use can't silently render an empty ghost.
-    if (input.candidates.length === 0) {
-        return { gated: true };
-    }
-    // Single-candidate path: nothing to reorder, gate doesn't apply
-    // (it needs a top-vs-second margin). Still surface editProximity raw
-    // score for metric capture when scorer was supplied.
-    if (input.candidates.length === 1) {
-        const only = input.candidates[0];
-        const ep = input.editProximityScorer ? input.editProximityScorer(only.text) : undefined;
-        return {
-            gated: false,
-            candidateTexts: [only.text],
-            topText: only.text,
-            ...(ep !== undefined ? { topEditProximityScore: ep } : {}),
-        };
-    }
-    const local = input.providerName === "ghost-local";
-    const inputs = input.candidates.map((c) => ({
-        text: c.text,
-        provider: input.providerName,
-        local,
-        ...(c.avgLogprob !== undefined ? { avgLogprob: c.avgLogprob } : {}),
-    }));
-    // PRD-adjacent (#5): pass last-line prefix length so the lengthPrior
-    // curve scales for long-prefix queries. Document-level length would
-    // over-extend the curve on multi-line buffers; the active line is
-    // what the user is currently typing.
-    const lastLinePrefix = input.prefix.split("\n").pop() ?? "";
-    const ranked = rerank(inputs, {
-        weights: parseWeightsEnv(input.weightsEnvRaw),
-        prefixLen: lastLinePrefix.length,
-        ...(input.profileBias ? { profileBias: input.profileBias } : {}),
-        ...(input.editProximityScorer ? { editProximityScorer: input.editProximityScorer } : {}),
-    });
-    if (input.minConfidenceEnvRaw !== undefined) {
-        const gated = applyConfidenceGate(ranked, {
-            minConfidence: parseMinConfidenceEnv(input.minConfidenceEnvRaw),
-        });
-        if (!gated)
-            return { gated: true };
-    }
-    const topText = ranked[0].text;
-    const topEditProximityScore = input.editProximityScorer
-        ? input.editProximityScorer(topText)
-        : undefined;
-    return {
-        gated: false,
-        candidateTexts: ranked.map((r) => r.text),
-        topText,
-        ...(topEditProximityScore !== undefined ? { topEditProximityScore } : {}),
-    };
-}
-//# sourceMappingURL=candidate-rerank.js.map

package/dist/candidate-rerank.js.map

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

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC,mBAAmB,GAAG,mBAAmB,GAAG,0BAA0B,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GACvB,mBAAmB,GACnB,mBAAmB,GACnB,0BAA0B,GAC1B,kBAAkB,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,oBAAoB,EAAE,mBAQlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAQlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,0BAUpC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAqBF,wBAAgB,iBAAiB,IAAI,WAAW,CAwD/C;AAsHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEzC;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAsB,GAAG,MAAM,GAAG,IAAI,CAsB3F"}

package/dist/config.js

@@ -1,317 +0,0 @@
-import { getModels } from "@earendil-works/pi-ai";
-export const DEFAULT_CLOUD_CONFIG = {
-    kind: "cloud",
-    provider: "groq",
-    modelId: "llama-3.1-8b-instant",
-    debounceMs: 150,
-    maxTokens: 64,
-    maxRecentMessages: 4,
-    temperature: 0,
-};
-export const DEFAULT_LOCAL_CONFIG = {
-    kind: "local",
-    baseUrl: "http://localhost:11434",
-    modelId: "qwen2.5-coder:1.5b",
-    debounceMs: 400,
-    maxTokens: 48,
-    maxRecentMessages: 2,
-    temperature: 0,
-};
-export const DEFAULT_MERCURY_CONFIG = {
-    kind: "openai-compat",
-    providerName: "mercury-edit",
-    baseUrl: "https://api.inceptionlabs.ai/v1",
-    modelId: "mercury-edit-2",
-    debounceMs: 150,
-    maxTokens: 64,
-    maxRecentMessages: 4,
-    temperature: 0,
-    parallelN: 1,
-};
-export const DEFAULT_CONFIG = {
-    enabled: true,
-    provider: DEFAULT_MERCURY_CONFIG,
-    minChars: 3,
-    maxLineLength: 240,
-};
-/**
- * Default per-provider model id when racing. Models chosen for speed; users
- * can override individually with `PI_GHOST_RACE_<NAME>_MODEL`.
- */
-const RACE_DEFAULT_MODELS = {
-    groq: "llama-3.1-8b-instant",
-    cerebras: "llama-3.1-8b",
-};
-/**
- * Aliases recognized as Mercury Edit (Inception Labs). Limited to the brand
- * name and the specific model version — broader aliases like bare "mercury"
- * or "inception" would lock in a routing that might surprise a user wanting
- * a future model from the same vendor.
- */
-const MERCURY_ALIASES = new Set(["mercury", "mercury-2", "mercury-edit", "mercury-edit-2"]);
-const MERCURY_DEFAULT_BASE_URL = "https://api.inceptionlabs.ai/v1";
-const MERCURY_DEFAULT_MODEL = "mercury-edit-2";
-export function readConfigFromEnv() {
-    const raceList = process.env.PI_GHOST_RACE_PROVIDERS;
-    const mode = process.env.PI_GHOST_PROVIDER?.toLowerCase();
-    const cfg = {
-        enabled: process.env.PI_GHOST_DISABLED !== "1",
-        provider: raceList
-            ? buildRaceFromEnv(raceList)
-            : mode === "local"
-                ? { ...DEFAULT_LOCAL_CONFIG }
-                : mode === "cloud"
-                    ? { ...DEFAULT_CLOUD_CONFIG }
-                    : { ...DEFAULT_MERCURY_CONFIG },
-        minChars: numEnv("PI_GHOST_MIN_CHARS", DEFAULT_CONFIG.minChars),
-        maxLineLength: numEnv("PI_GHOST_MAX_LINE", DEFAULT_CONFIG.maxLineLength),
-    };
-    if (cfg.provider.kind === "cloud") {
-        if (process.env.PI_GHOST_PROVIDER_NAME)
-            cfg.provider.provider = process.env.PI_GHOST_PROVIDER_NAME;
-        if (process.env.PI_GHOST_MODEL)
-            cfg.provider.modelId = process.env.PI_GHOST_MODEL;
-        const apiKey = sanitizeApiKey(process.env.PI_GHOST_API_KEY);
-        if (apiKey !== undefined)
-            cfg.provider.apiKey = apiKey;
-        cfg.provider.debounceMs = numEnv("PI_GHOST_DEBOUNCE_MS", cfg.provider.debounceMs);
-        cfg.provider.maxTokens = numEnv("PI_GHOST_MAX_TOKENS", cfg.provider.maxTokens);
-        cfg.provider.maxRecentMessages = numEnv("PI_GHOST_RECENT", cfg.provider.maxRecentMessages);
-        cfg.provider.temperature = tempEnv(cfg.provider.temperature);
-    }
-    else if (cfg.provider.kind === "openai-compat") {
-        const baseUrlRaw = process.env.PI_GHOST_BASE_URL ?? process.env.INCEPTION_BASE_URL;
-        if (baseUrlRaw) {
-            const fieldName = process.env.PI_GHOST_BASE_URL ? "PI_GHOST_BASE_URL" : "INCEPTION_BASE_URL";
-            const validated = validateBaseUrl(baseUrlRaw, fieldName);
-            if (validated)
-                cfg.provider.baseUrl = validated;
-        }
-        if (process.env.PI_GHOST_MODEL)
-            cfg.provider.modelId = process.env.PI_GHOST_MODEL;
-        const apiKey = sanitizeApiKey(process.env.PI_GHOST_API_KEY ?? process.env.INCEPTION_API_KEY);
-        if (apiKey !== undefined)
-            cfg.provider.apiKey = apiKey;
-        cfg.provider.debounceMs = numEnv("PI_GHOST_DEBOUNCE_MS", cfg.provider.debounceMs);
-        cfg.provider.maxTokens = numEnv("PI_GHOST_MAX_TOKENS", cfg.provider.maxTokens);
-        cfg.provider.maxRecentMessages = numEnv("PI_GHOST_RECENT", cfg.provider.maxRecentMessages);
-        cfg.provider.temperature = tempEnv(cfg.provider.temperature);
-        cfg.provider.parallelN = parallelNEnv(cfg.provider.parallelN);
-    }
-    else if (cfg.provider.kind === "local") {
-        if (process.env.PI_GHOST_BASE_URL) {
-            const validated = validateBaseUrl(process.env.PI_GHOST_BASE_URL, "PI_GHOST_BASE_URL");
-            if (validated)
-                cfg.provider.baseUrl = validated;
-        }
-        if (process.env.PI_GHOST_MODEL)
-            cfg.provider.modelId = process.env.PI_GHOST_MODEL;
-        cfg.provider.debounceMs = numEnv("PI_GHOST_DEBOUNCE_MS", cfg.provider.debounceMs);
-        cfg.provider.maxTokens = numEnv("PI_GHOST_MAX_TOKENS", cfg.provider.maxTokens);
-        cfg.provider.maxRecentMessages = numEnv("PI_GHOST_RECENT", cfg.provider.maxRecentMessages);
-        cfg.provider.temperature = tempEnv(cfg.provider.temperature);
-    }
-    else if (cfg.provider.kind === "race") {
-        for (const m of cfg.provider.members) {
-            m.temperature = tempEnv(m.temperature);
-        }
-    }
-    return cfg;
-}
-function buildRaceFromEnv(raceList) {
-    const names = raceList
-        .split(",")
-        .map((s) => s.trim().toLowerCase())
-        .filter((s) => s.length > 0);
-    const members = [];
-    for (const name of names) {
-        const member = buildRaceMember(name);
-        if (member)
-            members.push(member);
-    }
-    const pauseMs = numEnv("PI_GHOST_RACE_PAUSE_MS", 400);
-    const cooldownMs = numEnv("PI_GHOST_RACE_COOLDOWN_MS", 1500);
-    const cutoffMs = numEnv("PI_GHOST_RACE_CUTOFF_MS", 700);
-    return {
-        kind: "race",
-        members,
-        pauseMs,
-        cooldownMs,
-        cutoffMs,
-        maxRecentMessages: numEnv("PI_GHOST_RECENT", DEFAULT_CLOUD_CONFIG.maxRecentMessages),
-    };
-}
-function buildRaceMember(name) {
-    const upper = name.replace(/[^A-Za-z0-9]/g, "_").toUpperCase();
-    if (name === "local" || name === "ollama") {
-        const rawBase = process.env[`PI_GHOST_RACE_${upper}_BASE_URL`];
-        const baseUrl = rawBase
-            ? (validateBaseUrl(rawBase, `PI_GHOST_RACE_${upper}_BASE_URL`) ?? DEFAULT_LOCAL_CONFIG.baseUrl)
-            : DEFAULT_LOCAL_CONFIG.baseUrl;
-        return {
-            ...DEFAULT_LOCAL_CONFIG,
-            baseUrl,
-            modelId: process.env[`PI_GHOST_RACE_${upper}_MODEL`] ?? DEFAULT_LOCAL_CONFIG.modelId,
-        };
-    }
-    if (MERCURY_ALIASES.has(name)) {
-        const rawBase = process.env[`PI_GHOST_RACE_${upper}_BASE_URL`] ?? process.env.INCEPTION_BASE_URL;
-        const baseUrl = rawBase
-            ? (validateBaseUrl(rawBase, `PI_GHOST_RACE_${upper}_BASE_URL`) ?? MERCURY_DEFAULT_BASE_URL)
-            : MERCURY_DEFAULT_BASE_URL;
-        const modelId = process.env[`PI_GHOST_RACE_${upper}_MODEL`] ?? MERCURY_DEFAULT_MODEL;
-        const apiKey = sanitizeApiKey(process.env[`PI_GHOST_RACE_${upper}_API_KEY`] ?? process.env.INCEPTION_API_KEY);
-        return {
-            kind: "openai-compat",
-            providerName: "mercury-edit",
-            baseUrl,
-            modelId,
-            ...(apiKey !== undefined ? { apiKey } : {}),
-            debounceMs: DEFAULT_CLOUD_CONFIG.debounceMs,
-            maxTokens: DEFAULT_CLOUD_CONFIG.maxTokens,
-            maxRecentMessages: DEFAULT_CLOUD_CONFIG.maxRecentMessages,
-            temperature: DEFAULT_MERCURY_CONFIG.temperature,
-            parallelN: DEFAULT_MERCURY_CONFIG.parallelN,
-        };
-    }
-    const provider = name;
-    if (!isKnownCloudProvider(provider)) {
-        process.stderr.write(`Pi Ghost: ignoring unknown race provider '${name}' in PI_GHOST_RACE_PROVIDERS\n`);
-        return null;
-    }
-    const modelEnv = process.env[`PI_GHOST_RACE_${upper}_MODEL`];
-    const modelId = modelEnv ?? RACE_DEFAULT_MODELS[provider] ?? DEFAULT_CLOUD_CONFIG.modelId;
-    const apiKey = sanitizeApiKey(process.env[`PI_GHOST_RACE_${upper}_API_KEY`]);
-    return {
-        ...DEFAULT_CLOUD_CONFIG,
-        provider,
-        modelId,
-        ...(apiKey !== undefined ? { apiKey } : {}),
-    };
-}
-/**
- * Return true when pi-ai recognizes `name` as a cloud provider with at least
- * one registered model. Used at config-parse time to reject typos in
- * `PI_GHOST_RACE_PROVIDERS` before they cause repeated runtime errors.
- */
-function isKnownCloudProvider(name) {
-    try {
-        const models = getModels(name);
-        return Array.isArray(models) && models.length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-function numEnv(name, fallback) {
-    const raw = process.env[name];
-    if (!raw)
-        return fallback;
-    const v = Number(raw);
-    return Number.isFinite(v) && v >= 0 ? v : fallback;
-}
-/**
- * Parse PI_GHOST_TEMPERATURE. Returns fallback when unset or out of [0, 2].
- * The provider implementations use 0 by default; users can opt back in to
- * sampling for cache-miss diversity. Note: temperature=0 is best-effort
- * across vendors and does NOT guarantee identical outputs across calls
- * (kernel scheduling / batching cause variance). The completion cache is
- * the real determinism guarantee.
- */
-function tempEnv(fallback) {
-    const raw = process.env.PI_GHOST_TEMPERATURE;
-    if (raw === undefined)
-        return fallback;
-    const v = Number(raw);
-    return Number.isFinite(v) && v >= 0 && v <= 2 ? v : fallback;
-}
-/**
- * Strip CR/LF and surrounding whitespace from an API key (SEC-7). Prevents
- * HTTP header injection via `Authorization: Bearer ${apiKey}` when a
- * malformed `.env` file or environment manipulation injects newlines.
- * Returns undefined for empty results so callers fall back to env lookup.
- */
-export function sanitizeApiKey(raw) {
-    if (raw === undefined)
-        return undefined;
-    const cleaned = raw.replace(/[\r\n]/g, "").trim();
-    return cleaned.length > 0 ? cleaned : undefined;
-}
-/**
- * Produce a deep copy of a config with all `apiKey` fields removed (SEC-8).
- * Use before any logging, diagnostics dump, telemetry, or serialization.
- * The original config remains live with its keys for actual provider use.
- *
- * Defensive: even fields not currently typed as containing keys are scrubbed
- * via a recursive walk that drops any property named `apiKey` (case-sensitive).
- *
- * Caveats: class instances become plain objects (methods lost). Cyclic
- * structures would recurse infinitely — caller must ensure acyclic input.
- * Both caveats are fine for `GhostConfig` which is plain JSON-shaped.
- */
-export function redactConfig(cfg) {
-    return redactWalk(cfg);
-}
-function redactWalk(value) {
-    if (value === null || typeof value !== "object")
-        return value;
-    if (Array.isArray(value))
-        return value.map(redactWalk);
-    const out = {};
-    for (const [k, v] of Object.entries(value)) {
-        if (k === "apiKey")
-            continue;
-        out[k] = redactWalk(v);
-    }
-    return out;
-}
-/**
- * Validate a provider baseUrl (SEC-1). Returns the URL on success, null
- * on failure with a stderr warning. Rules:
- *  - Must be a parseable absolute URL.
- *  - `https:` always allowed.
- *  - `http:` only allowed for `localhost` / `127.0.0.1` / `::1` — sending
- *    API keys + prompt context in cleartext to anything else is almost
- *    certainly a misconfiguration. Setting `PI_GHOST_ALLOW_INSECURE=1`
- *    bypasses this check.
- *  - Other schemes (`file:`, `data:`, etc.) rejected unconditionally.
- */
-export function validateBaseUrl(raw, fieldName = "PI_GHOST_BASE_URL") {
-    let url;
-    try {
-        url = new URL(raw);
-    }
-    catch {
-        process.stderr.write(`Pi Ghost: ignoring invalid ${fieldName}=${raw}\n`);
-        return null;
-    }
-    if (url.protocol === "https:")
-        return raw;
-    if (url.protocol === "http:") {
-        const host = url.hostname;
-        if (host === "localhost" || host === "127.0.0.1" || host === "::1")
-            return raw;
-        if (process.env.PI_GHOST_ALLOW_INSECURE === "1")
-            return raw;
-        process.stderr.write(`Pi Ghost: refusing to use insecure ${fieldName}=${raw} (set PI_GHOST_ALLOW_INSECURE=1 to override)\n`);
-        return null;
-    }
-    process.stderr.write(`Pi Ghost: rejecting ${fieldName} with unsupported scheme '${url.protocol}'\n`);
-    return null;
-}
-/**
- * Parse PI_GHOST_MERCURY_PARALLEL_N. Returns fallback when unset, non-integer,
- * or outside [1, 8]. The upper bound prevents accidental cost explosions —
- * each parallel call costs the same as a normal completion.
- */
-function parallelNEnv(fallback) {
-    const raw = process.env.PI_GHOST_MERCURY_PARALLEL_N;
-    if (raw === undefined)
-        return fallback;
-    const v = Number(raw);
-    if (!Number.isFinite(v))
-        return fallback;
-    const n = Math.floor(v);
-    return n >= 1 && n <= 8 ? n : fallback;
-}
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context-aggregator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-aggregator.d.ts","sourceRoot":"","sources":["../src/context-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,aAAa,EAAE,CA0BjB;AAmCD,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAYrD"}

package/dist/context-aggregator.js

@@ -1,87 +0,0 @@
-/**
- * Read up to `max` recent messages from the current branch. By default
- * returns user + assistant entries; pass `includeTools: true` to also
- * surface tool calls/results as `role: "tool"` entries with `toolName`
- * populated where available. Returns oldest-first.
- */
-export function getRecentMessages(ctx, max, opts = {}) {
-    if (max <= 0)
-        return [];
-    const branch = safeBranch(ctx);
-    if (!branch)
-        return [];
-    const includeTools = opts.includeTools ?? false;
-    const out = [];
-    for (let i = branch.length - 1; i >= 0 && out.length < max; i--) {
-        const entry = branch[i];
-        if (!entry || entry.type !== "message")
-            continue;
-        const role = roleOf(entry.message);
-        if (role === "user" || role === "assistant") {
-            const text = extractText(entry.message);
-            if (!text)
-                continue;
-            out.push({ role, text });
-            continue;
-        }
-        if (includeTools && role === "tool") {
-            const text = extractText(entry.message);
-            if (!text)
-                continue;
-            const toolName = toolNameOf(entry.message);
-            out.push(toolName ? { role: "tool", text, toolName } : { role: "tool", text });
-        }
-    }
-    out.reverse();
-    return out;
-}
-/**
- * Best-effort extraction of the tool name from an `AgentMessage`. Tool
- * messages may carry the name on either the message itself or on a
- * tool_use/tool_result content part — handle both shapes.
- */
-function toolNameOf(msg) {
-    if (!msg || typeof msg !== "object")
-        return undefined;
-    if ("name" in msg && typeof msg.name === "string")
-        return msg.name;
-    if ("content" in msg && Array.isArray(msg.content)) {
-        for (const c of msg.content) {
-            if (c && typeof c === "object" && "name" in c && typeof c.name === "string") {
-                return c.name;
-            }
-        }
-    }
-    return undefined;
-}
-function safeBranch(ctx) {
-    try {
-        return ctx.sessionManager.getBranch();
-    }
-    catch {
-        return undefined;
-    }
-}
-function roleOf(msg) {
-    if (msg && typeof msg === "object" && "role" in msg && typeof msg.role === "string") {
-        return msg.role;
-    }
-    return undefined;
-}
-export function extractText(msg) {
-    if (!msg || typeof msg !== "object" || !("content" in msg))
-        return "";
-    const content = msg.content;
-    if (typeof content === "string")
-        return content.trim();
-    if (!Array.isArray(content))
-        return "";
-    const parts = [];
-    for (const c of content) {
-        if (c && typeof c === "object" && "type" in c && c.type === "text" && "text" in c && typeof c.text === "string") {
-            parts.push(c.text);
-        }
-    }
-    return parts.join("").trim();
-}
-//# sourceMappingURL=context-aggregator.js.map

package/dist/context-aggregator.js.map

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

package/dist/context-selector.d.ts

@@ -1,128 +0,0 @@
-/**
- * Relevance-pruned context selection. See PRD §M6b.
- *
- * Replaces the "last N messages" recency window with a scan-then-select
- * design motivated by ChaI-TeA (RESEARCH §2): models can exploit distant
- * conversation history; a pure recency window blinds the selector to
- * high-IDF distant turns.
- *
- * Pipeline:
- *  1. Scan up to `maxScan` candidates from the branch (newest first).
- *  2. Tokenize each candidate's text (lower-case, drop stopwords).
- *  3. Score each candidate as `0.7 * recencyWeight + 0.3 * bm25Score`,
- *     both normalized to [0, 1].
- *  4. Sort by score, take top `maxSelected`, enforce `maxChars` budget by
- *     truncating the lowest-recency tail.
- *
- * Pure module: no I/O, no editor state.
- */
-export declare const DEFAULT_MAX_SCAN = 200;
-export declare const DEFAULT_MAX_SELECTED = 8;
-export declare const DEFAULT_MAX_CHARS = 4000;
-export declare const DEFAULT_BM25_WEIGHT = 0.3;
-/**
- * Enhancement #1: weight on the edit-history token-overlap locality
- * signal. Default 0 (opt-in). When > 0, the score formula becomes:
- *   `score = (1 - bm25Weight - editLocalityWeight) * recency
- *          + bm25Weight * bm25
- *          + editLocalityWeight * editLocality`
- * where `editLocality` is 1 if the candidate text shares any token with
- * `editTokens`, else 0. `bm25Weight + editLocalityWeight` is clamped to
- * 1; recency coefficient gets whatever remains.
- */
-export declare const DEFAULT_EDIT_LOCALITY_WEIGHT = 0;
-export declare const RECENCY_HALF_LIFE = 4;
-/**
- * Small fixed English stopword list. No language detection — when ghost
- * autocomplete moves to non-English prompts, this set may need expansion
- * or a per-language switch. Until then, the cost of leaving these in is
- * higher than the cost of an English-only set.
- */
-export declare const STOPWORDS: ReadonlySet<string>;
-export interface ContextCandidate {
-    role: "user" | "assistant" | "tool";
-    text: string;
-    toolName?: string;
-}
-export interface ContextSelectorOpts {
-    maxScan?: number;
-    maxSelected?: number;
-    maxChars?: number;
-    /** Weight on BM25 vs recency: score = (1 - w) * recency + w * bm25. */
-    bm25Weight?: number;
-    /**
-     * Enhancement #1: weight on the edit-history token-overlap bonus.
-     * Default 0. Requires `editTokens` to have any effect.
-     */
-    editLocalityWeight?: number;
-    /**
-     * Enhancement #1: set of tokens recently added in nearby edits. A
-     * candidate whose text contains any of these tokens earns the full
-     * `editLocalityWeight` bonus. Missing or empty → no effect.
-     */
-    editTokens?: ReadonlySet<string>;
-}
-export interface SelectedContext {
-    candidates: ContextCandidate[];
-    scannedCount: number;
-    selectedCount: number;
-    totalChars: number;
-}
-/**
- * Tokenize text into lower-case alphanumeric words, dropping stopwords and
- * single-character noise. Kept intentionally simple — proper tokenization
- * (subword, punctuation handling, code identifiers) would over-fit the
- * v0.5 prompt corpus.
- *
- * Caveat: camelCase identifiers do NOT split. `getRecentMessages` becomes a
- * single token `getrecentmessages`. File paths and snake_case split on the
- * separator characters and tokenize as expected.
- */
-export declare function tokenize(text: string): string[];
-/**
- * Compute document frequencies over a candidate pool. Used as the corpus
- * for BM25's IDF term.
- */
-export declare function computeDocFreqs(candidates: ContextCandidate[]): {
-    docFreqs: Map<string, number>;
-    avgDocLen: number;
-    docLens: number[];
-};
-/**
- * BM25 score for `queryTokens` against a document. Uses an IDF floor
- * `log(1 + 1/N)` so terms appearing in every candidate still contribute a
- * small positive score instead of zero — PRD §M6b "BM25-on-small-corpus
- * caveat".
- */
-export declare function bm25Score(queryTokens: string[], docTokens: string[], docFreqs: Map<string, number>, N: number, avgDocLen: number): number;
-/**
- * Exponential recency weight: 1.0 at the newest position, decays e-fold
- * every `RECENCY_HALF_LIFE` positions. `distance` is positions from the
- * newest end of the candidate pool (0 = newest).
- */
-export declare function recencyWeight(distance: number): number;
-/**
- * Select the most relevant subset of `candidates` for the current prefix.
- * `candidates` should be newest-first (index 0 = newest). Returns selected
- * entries in their original branch order (oldest-first of those selected)
- * for natural prompt rendering.
- */
-export declare function selectContext(candidates: ContextCandidate[], prefix: string, opts?: ContextSelectorOpts): SelectedContext;
-/**
- * Parse `PI_GHOST_CONTEXT_BM25_WEIGHT`. Returns fallback on bad input or
- * outside [0, 1].
- */
-export declare function parseBm25WeightEnv(raw: string | undefined): number;
-/**
- * Parse `PI_GHOST_CONTEXT_EDIT_LOCALITY_WEIGHT`. Returns 0 (no-op) on bad
- * input or outside [0, 1]. Enhancement #1.
- */
-export declare function parseEditLocalityWeightEnv(raw: string | undefined): number;
-/**
- * Build a `ContextSelectorOpts` from the documented env knobs (PRD §M6d).
- * Returns a defaulted opts object. `editTokens` is omitted — the caller
- * must inject the live edit-history token set on each call (env can only
- * configure the weight, not the dynamic data).
- */
-export declare function readContextEnv(): Omit<Required<ContextSelectorOpts>, "editTokens">;
-//# sourceMappingURL=context-selector.d.ts.map

package/dist/context-selector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-selector.d.ts","sourceRoot":"","sources":["../src/context-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAKnC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,CAexC,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG;IAChE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB,CAiBA;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,CAAC,EAAE,MAAM,EACT,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAeD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAwB,GAC5B,eAAe,CAiGjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK1E;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,YAAY,CAAC,CAUlF"}