gnosys 5.5.0 → 5.6.0

package/dist/lib/chat/index.js

@@ -0,0 +1,151 @@
+/**
+ * Chat orchestrator — the entry point invoked by `gnosys chat`.
+ *
+ * Phase 2 responsibilities:
+ *   - Start or resume a session (writes start event to log)
+ *   - Resolve project context (auto-detect from cwd)
+ *   - Pick the LLM provider/model
+ *   - Mount the ink ChatApp
+ *   - On exit, flush a session_end event
+ */
+import { GnosysDB } from "../db.js";
+import { startSession, appendEvent, readSession, listSessions, searchSessions, } from "./session.js";
+import { resolveTaskModel } from "../config.js";
+/** Reconstruct the conversation buffer from session log events. */
+export function bufferFromEvents(events) {
+    const turns = [];
+    for (const e of events) {
+        if (e.type === "user") {
+            turns.push({ role: "user", text: e.text, ts: e.ts });
+        }
+        else if (e.type === "assistant") {
+            turns.push({
+                role: "assistant",
+                text: e.text,
+                ts: e.ts,
+                provider: e.provider,
+                model: e.model,
+            });
+        }
+    }
+    return turns;
+}
+/** Detect the project ID from cwd, returns null if no registered project. */
+function detectProject() {
+    try {
+        const db = GnosysDB.openCentral();
+        if (!db.isAvailable()) {
+            db.close();
+            return null;
+        }
+        const proj = db.getProjectByDirectory(process.cwd());
+        db.close();
+        if (!proj)
+            return null;
+        return { id: proj.id, name: proj.name };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Start an interactive chat. Mounts the ink TUI, blocks until /quit or Ctrl-C.
+ * Lazily imports React/ink so non-chat CLI commands aren't paying for them.
+ */
+export async function startChat(opts) {
+    const { default: React } = await import("react");
+    const { render } = await import("ink");
+    const { ChatApp } = await import("./render.js");
+    const project = opts.projectId
+        ? { id: opts.projectId, name: opts.projectId.slice(0, 8) }
+        : detectProject();
+    // Resolve provider/model from config.synthesis (the default chat task)
+    const synth = resolveTaskModel(opts.config, "synthesis");
+    const provider = opts.providerName ?? synth.provider;
+    const model = opts.modelName ?? synth.model;
+    // Resume existing session or start a new one
+    let sessionId;
+    let initialBuffer = [];
+    if (opts.resume) {
+        const events = readSession(opts.resume);
+        if (events.length === 0) {
+            console.error(`Session not found: ${opts.resume}`);
+            process.exit(1);
+        }
+        sessionId = opts.resume;
+        initialBuffer = bufferFromEvents(events);
+        appendEvent(sessionId, {
+            type: "session_start",
+            ts: new Date().toISOString(),
+            project_id: project?.id,
+            provider,
+            model,
+        });
+    }
+    else {
+        sessionId = startSession({
+            project_id: project?.id,
+            provider,
+            model,
+        });
+    }
+    const initialHeader = {
+        sessionId,
+        projectName: project?.name,
+        provider,
+        model,
+        tokensIn: 0,
+        tokensOut: 0,
+    };
+    const { waitUntilExit } = render(React.createElement(ChatApp, {
+        initialHeader,
+        initialBuffer,
+        config: opts.config,
+        projectId: project?.id ?? null,
+    }));
+    await waitUntilExit();
+}
+/** Print recent sessions to stdout (for `gnosys chat --list`). */
+export function printSessionList(limit = 20) {
+    const sessions = listSessions().slice(0, limit);
+    if (sessions.length === 0) {
+        console.log("No chat sessions yet.");
+        return;
+    }
+    console.log(`Recent ${sessions.length} session(s):`);
+    for (const s of sessions) {
+        const proj = s.project_id ? s.project_id.slice(0, 8) : "—";
+        const sizeKb = (s.size_bytes / 1024).toFixed(1);
+        console.log(`  ${s.id}  ${s.last_active.slice(0, 19)}  proj=${proj}  turns=${s.turns}  ${sizeKb}KB`);
+    }
+}
+/** Print search results across all session logs (for `gnosys chat --search`). */
+export function printSearchResults(query, limit = 30) {
+    const matches = searchSessions(query, limit);
+    if (matches.length === 0) {
+        console.log(`No matches for: ${query}`);
+        return;
+    }
+    console.log(`${matches.length} match(es):`);
+    for (const m of matches) {
+        const text = (() => {
+            const e = m.event;
+            switch (e.type) {
+                case "user":
+                case "assistant":
+                    return e.text;
+                case "command":
+                    return `${e.name} ${e.args.join(" ")}`;
+                case "focus":
+                    return e.topic;
+                case "recall":
+                    return e.query;
+                default:
+                    return "";
+            }
+        })();
+        const preview = text.length > 100 ? text.slice(0, 97) + "..." : text;
+        console.log(`  ${m.sessionId.slice(0, 12)}…  [${m.event.type}]  ${preview}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/chat/index.js.map

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

package/dist/lib/chat/intent.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Free-text intent detection — converts conversational phrasings into the
+ * matching slash command. Lets the user write "let's focus on the auth
+ * refactor" instead of `/focus auth refactor`.
+ *
+ * Hybrid classifier:
+ *   1. Pattern match (regex) — instant, free, covers ~80% of intents
+ *   2. LLM classifier fallback — only when pattern returns null AND the
+ *      message has imperative-y signals
+ *   3. Confirm-before-destructive — render layer prompts [Y/n/edit] for
+ *      high-impact intents (focus/branch/quit/clear)
+ *
+ * Phase 5 wires patterns whose target commands already exist (Phases 2–4).
+ * /focus and /branch (Phase 7) are added in their own phase.
+ */
+import { GnosysConfig } from "../config.js";
+export type InferredIntent = {
+    command: "/pin";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/unpin";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/remember";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/save-turn";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/recall";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/reinforce";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/attach";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+} | {
+    command: "/quit";
+    args: string[];
+    confidence: "high" | "medium";
+    matchedPattern?: string;
+};
+export interface PatternRule {
+    /** Regex to match. Capture group 1 is the args text (joined as `args[0]` if present). */
+    pattern: RegExp;
+    command: InferredIntent["command"];
+    /** Whether this is a destructive action that needs confirm-before-fire. */
+    destructive: boolean;
+    /** Human-readable description shown in the confirm prompt. */
+    description: string;
+}
+export declare const PATTERNS: PatternRule[];
+/** Try to match a user input against the pattern rules. Returns null if no pattern fires. */
+export declare function matchPattern(userInput: string): InferredIntent | null;
+/** True when the input has imperative-y signals — a hint that LLM classification might pay off. */
+export declare function hasImperativeSignal(userInput: string): boolean;
+/**
+ * Optional: ask a cheap LLM to classify the intent.
+ * Returns null when the LLM is unavailable or the response can't be parsed.
+ */
+export declare function classifyWithLLM(config: GnosysConfig, userInput: string): Promise<InferredIntent | null>;
+/** Whether the inferred command is destructive enough to warrant a confirm prompt. */
+export declare function isDestructive(command: InferredIntent["command"]): boolean;
+/** Render a [Y/n/edit] prompt label for the inferred intent. */
+export declare function describeIntent(intent: InferredIntent): string;
+/**
+ * Hybrid classifier — returns the best-guess intent given user input,
+ * conversation context, and an optional LLM config for fallback.
+ *
+ * Strategy:
+ *   1. Pattern match first (free, fast)
+ *   2. If no pattern AND there's an imperative signal AND we have a config → ask the LLM
+ *   3. Otherwise return null (treat as a normal chat turn)
+ */
+export declare function inferIntent(userInput: string, config: GnosysConfig | null): Promise<InferredIntent | null>;
+export interface IntentAcceptanceLog {
+    /** Map of pattern source → number of times the user accepted that pattern. */
+    acceptCounts: Map<string, number>;
+}
+export declare function newAcceptanceLog(): IntentAcceptanceLog;
+/** Has this pattern been accepted enough times to skip confirmation? */
+export declare function shouldAutoAccept(log: IntentAcceptanceLog, matchedPattern: string | undefined): boolean;
+/** Record a confirmed acceptance of a pattern. */
+export declare function recordAcceptance(log: IntentAcceptanceLog, matchedPattern: string | undefined): void;
+//# sourceMappingURL=intent.d.ts.map

package/dist/lib/chat/intent.d.ts.map

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

package/dist/lib/chat/intent.js

@@ -0,0 +1,192 @@
+/**
+ * Free-text intent detection — converts conversational phrasings into the
+ * matching slash command. Lets the user write "let's focus on the auth
+ * refactor" instead of `/focus auth refactor`.
+ *
+ * Hybrid classifier:
+ *   1. Pattern match (regex) — instant, free, covers ~80% of intents
+ *   2. LLM classifier fallback — only when pattern returns null AND the
+ *      message has imperative-y signals
+ *   3. Confirm-before-destructive — render layer prompts [Y/n/edit] for
+ *      high-impact intents (focus/branch/quit/clear)
+ *
+ * Phase 5 wires patterns whose target commands already exist (Phases 2–4).
+ * /focus and /branch (Phase 7) are added in their own phase.
+ */
+import { getLLMProvider } from "../llm.js";
+// Patterns are ordered most specific → most general. First match wins.
+export const PATTERNS = [
+    // Quit/exit
+    {
+        pattern: /^\s*(?:thanks[,.\s]*)?(?:that(?:'s| is) all|i'?m done|goodbye|bye|quit|exit)\s*[.!]?\s*$/i,
+        command: "/quit",
+        destructive: true,
+        description: "exit chat",
+    },
+    // Save the last exchange — must come BEFORE /remember (which also matches "save ...")
+    {
+        pattern: /^\s*(?:let'?s\s+)?save\s+(?:that|this|the)\s+(?:exchange|turn|answer)\s*\.?\s*$/i,
+        command: "/save-turn",
+        destructive: false,
+        description: "save the last exchange",
+    },
+    // Save / remember (decision-language)
+    {
+        pattern: /^\s*(?:please\s+)?(?:remember|note|save)\s+(?:that\s+|this[:\s]+)?(.+?)\s*$/i,
+        command: "/remember",
+        destructive: false,
+        description: "save as a memory",
+    },
+    {
+        pattern: /^\s*(?:let'?s\s+)?(?:commit|note this[:\s]+)\s+(?:down\s+)?(.+?)\s*$/i,
+        command: "/remember",
+        destructive: false,
+        description: "save as a memory",
+    },
+    // Recall / lookup
+    {
+        pattern: /^\s*(?:what (?:did|do) we (?:decide|say|note)\s+(?:about\s+)?|look up\s+|find me (?:the\s+)?)(.+?)\s*\??$/i,
+        command: "/recall",
+        destructive: false,
+        description: "preview recall",
+    },
+    // Pin / unpin
+    {
+        pattern: /^\s*(?:pin|keep)\s+(?:this\s+|that\s+)?([\w-]+(?:-[A-Z0-9]+)?)\s*$/i,
+        command: "/pin",
+        destructive: false,
+        description: "pin a memory",
+    },
+    {
+        pattern: /^\s*unpin\s+([\w-]+(?:-[A-Z0-9]+)?)\s*$/i,
+        command: "/unpin",
+        destructive: false,
+        description: "unpin a memory",
+    },
+    // Reinforce — explicit positive feedback
+    {
+        pattern: /^\s*(?:that('s| was)?\s+(?:helpful|useful|perfect|great)|(?:helpful|perfect|great|exactly|spot on)|good answer)[.!\s]*$/i,
+        command: "/reinforce",
+        destructive: false,
+        description: "reinforce the most recent cited memory",
+    },
+    // Attach — when the user pastes a path that looks like a file
+    {
+        pattern: /^\s*(?:attach|ingest|see this file:?)\s+(\S+)\s*$/i,
+        command: "/attach",
+        destructive: false,
+        description: "ingest a file",
+    },
+];
+/** Try to match a user input against the pattern rules. Returns null if no pattern fires. */
+export function matchPattern(userInput) {
+    for (const rule of PATTERNS) {
+        const m = userInput.match(rule.pattern);
+        if (m) {
+            const captured = m[1]?.trim();
+            const args = captured ? [captured] : [];
+            return {
+                command: rule.command,
+                args,
+                confidence: "high",
+                matchedPattern: rule.pattern.source,
+            };
+        }
+    }
+    return null;
+}
+/** True when the input has imperative-y signals — a hint that LLM classification might pay off. */
+export function hasImperativeSignal(userInput) {
+    const trimmed = userInput.trim().toLowerCase();
+    // Starts with a verb or "let's" / "should we" — a hint of intent
+    return /^(let'?s |should we |can you |please |go (?:ahead and )?|now |next[,:.\s])/i.test(trimmed);
+}
+/**
+ * Optional: ask a cheap LLM to classify the intent.
+ * Returns null when the LLM is unavailable or the response can't be parsed.
+ */
+export async function classifyWithLLM(config, userInput) {
+    try {
+        const provider = getLLMProvider(config, "structuring");
+        const prompt = `You are a router. Map this user message to ONE of these chat commands, or "none" if it's just a normal chat turn.
+
+Commands:
+  /pin <id>           pin a memory by ID (the user named a specific memory)
+  /unpin <id>         unpin a memory by ID
+  /remember <text>    save free text as a new memory
+  /save-turn          save the last user+assistant exchange
+  /recall <query>     preview what would be recalled for this query
+  /reinforce <id>     mark a recalled memory as useful
+  /attach <path>      ingest a file
+  /quit               exit chat
+
+Output STRICT JSON only:
+{"command": "/<name>" | "none", "args": ["..."], "confidence": "high" | "medium" | "low"}
+
+User message: ${userInput}`;
+        const raw = await provider.generate(prompt, { maxTokens: 200 });
+        const trimmed = raw.replace(/^```(?:json)?\s*|\s*```$/g, "").trim();
+        const parsed = JSON.parse(trimmed);
+        if (!parsed.command || parsed.command === "none")
+            return null;
+        const validCmds = ["/pin", "/unpin", "/remember", "/save-turn", "/recall", "/reinforce", "/attach", "/quit"];
+        if (!validCmds.includes(parsed.command))
+            return null;
+        if (parsed.confidence === "low")
+            return null;
+        return {
+            command: parsed.command,
+            args: parsed.args ?? [],
+            confidence: parsed.confidence ?? "medium",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether the inferred command is destructive enough to warrant a confirm prompt. */
+export function isDestructive(command) {
+    return command === "/quit";
+}
+/** Render a [Y/n/edit] prompt label for the inferred intent. */
+export function describeIntent(intent) {
+    const argsStr = intent.args.length > 0 ? ` ${intent.args.join(" ")}` : "";
+    return `${intent.command}${argsStr}`;
+}
+/**
+ * Hybrid classifier — returns the best-guess intent given user input,
+ * conversation context, and an optional LLM config for fallback.
+ *
+ * Strategy:
+ *   1. Pattern match first (free, fast)
+ *   2. If no pattern AND there's an imperative signal AND we have a config → ask the LLM
+ *   3. Otherwise return null (treat as a normal chat turn)
+ */
+export async function inferIntent(userInput, config) {
+    const fromPattern = matchPattern(userInput);
+    if (fromPattern)
+        return fromPattern;
+    if (!config)
+        return null;
+    if (!hasImperativeSignal(userInput))
+        return null;
+    return classifyWithLLM(config, userInput);
+}
+export function newAcceptanceLog() {
+    return { acceptCounts: new Map() };
+}
+const AUTO_ACCEPT_THRESHOLD = 5;
+/** Has this pattern been accepted enough times to skip confirmation? */
+export function shouldAutoAccept(log, matchedPattern) {
+    if (!matchedPattern)
+        return false;
+    const count = log.acceptCounts.get(matchedPattern) ?? 0;
+    return count >= AUTO_ACCEPT_THRESHOLD;
+}
+/** Record a confirmed acceptance of a pattern. */
+export function recordAcceptance(log, matchedPattern) {
+    if (!matchedPattern)
+        return;
+    log.acceptCounts.set(matchedPattern, (log.acceptCounts.get(matchedPattern) ?? 0) + 1);
+}
+//# sourceMappingURL=intent.js.map

package/dist/lib/chat/intent.js.map

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

package/dist/lib/chat/llmTurn.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Run one chat turn against the LLM with streaming output.
+ *
+ * Phase 2 keeps this minimal — no recall, no system prompt customization.
+ * Phase 3 adds recall integration; Phase 5 adds intent classification;
+ * Phase 6 adds gnosys-choose protocol; Phase 7 adds focus-aware system prompt.
+ */
+import { GnosysConfig } from "../config.js";
+import { LLMProvider } from "../llm.js";
+import { LLMProviderName } from "../config.js";
+import { Turn } from "./types.js";
+import { RecalledMemory } from "./recall.js";
+export interface LLMTurnOptions {
+    /** Conversation buffer to send (will be formatted into a single prompt). */
+    buffer: Turn[];
+    /** New user input to append before sending. */
+    userInput: string;
+    /** Token-level streaming callback. */
+    onToken: (token: string) => void;
+    /** Recalled memories to inject into the system prompt. Empty disables recall. */
+    recalled?: RecalledMemory[];
+}
+export interface LLMTurnResult {
+    text: string;
+    provider: string;
+    model: string;
+    /** Memory IDs surfaced in the system prompt for this turn (used for citations). */
+    recalledIds: string[];
+}
+/**
+ * Run a single turn. Streams via opts.onToken. Returns the full assistant
+ * response plus the IDs of any memories injected as context.
+ */
+export declare function runTurn(config: GnosysConfig, opts: LLMTurnOptions): Promise<LLMTurnResult>;
+/** Build a provider for /provider switching mid-session. */
+export declare function buildProvider(config: GnosysConfig, providerName: LLMProviderName, model?: string): LLMProvider;
+//# sourceMappingURL=llmTurn.d.ts.map

package/dist/lib/chat/llmTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmTurn.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/llmTurn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAkC,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAC;AAGpE,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAsBD;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,eAAe,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,CAGb"}

package/dist/lib/chat/llmTurn.js

@@ -0,0 +1,61 @@
+/**
+ * Run one chat turn against the LLM with streaming output.
+ *
+ * Phase 2 keeps this minimal — no recall, no system prompt customization.
+ * Phase 3 adds recall integration; Phase 5 adds intent classification;
+ * Phase 6 adds gnosys-choose protocol; Phase 7 adds focus-aware system prompt.
+ */
+import { getProviderModel } from "../config.js";
+import { getLLMProvider, createProvider } from "../llm.js";
+import { formatRecallForPrompt } from "./recall.js";
+import { CHOOSE_SYSTEM_PROMPT_ADDENDUM } from "./choose.js";
+const BASE_SYSTEM_PROMPT = `You are an assistant inside the Gnosys terminal chat — a memory-aware REPL. The user has persistent memory across sessions; relevant memories are injected as <memory id="..."> blocks before their question. Cite memory IDs in square brackets like [deci-037] when you use them. Be concise and direct. Markdown renders.${CHOOSE_SYSTEM_PROMPT_ADDENDUM}`;
+function composeSystemPrompt(recalled) {
+    if (!recalled || recalled.length === 0)
+        return BASE_SYSTEM_PROMPT;
+    return `${BASE_SYSTEM_PROMPT}\n\n${formatRecallForPrompt(recalled)}`;
+}
+/** Format the conversation buffer + new input into a single prompt string. */
+function buildPrompt(buffer, userInput) {
+    const lines = [];
+    for (const turn of buffer) {
+        if (turn.role === "user")
+            lines.push(`User: ${turn.text}`);
+        else if (turn.role === "assistant")
+            lines.push(`Assistant: ${turn.text}`);
+        // System turns are not replayed into the prompt (they're TUI-side notices)
+    }
+    lines.push(`User: ${userInput}`);
+    lines.push(`Assistant:`);
+    return lines.join("\n\n");
+}
+/**
+ * Run a single turn. Streams via opts.onToken. Returns the full assistant
+ * response plus the IDs of any memories injected as context.
+ */
+export async function runTurn(config, opts) {
+    // Phase 2: use the synthesis provider (suitable for free-form chat).
+    // Future phases may route to a "chat" task type if added to config.
+    const provider = getLLMProvider(config, "synthesis");
+    const prompt = buildPrompt(opts.buffer, opts.userInput);
+    const system = composeSystemPrompt(opts.recalled);
+    let full = "";
+    await provider.generate(prompt, { system, stream: true, maxTokens: 4096 }, {
+        onToken: (token) => {
+            full += token;
+            opts.onToken(token);
+        },
+    });
+    return {
+        text: full,
+        provider: provider.name,
+        model: provider.model,
+        recalledIds: (opts.recalled ?? []).map((m) => m.id),
+    };
+}
+/** Build a provider for /provider switching mid-session. */
+export function buildProvider(config, providerName, model) {
+    const resolvedModel = model ?? getProviderModel(config, providerName);
+    return createProvider(providerName, resolvedModel, config);
+}
+//# sourceMappingURL=llmTurn.js.map

package/dist/lib/chat/llmTurn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmTurn.js","sourceRoot":"","sources":["../../../src/lib/chat/llmTurn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAe,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGxE,OAAO,EAAkB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAqB5D,MAAM,kBAAkB,GAAG,+TAA+T,6BAA6B,EAAE,CAAC;AAE1X,SAAS,mBAAmB,CAAC,QAAsC;IACjE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,OAAO,GAAG,kBAAkB,OAAO,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,SAAS,WAAW,CAAC,MAAc,EAAE,SAAiB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;aACtD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,2EAA2E;IAC7E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAoB,EACpB,IAAoB;IAEpB,qEAAqE;IACrE,oEAAoE;IACpE,MAAM,QAAQ,GAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,QAAQ,CAAC,QAAQ,CACrB,MAAM,EACN,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EACzC;QACE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,IAAI,KAAK,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;KACF,CACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,YAA6B,EAC7B,KAAc;IAEd,MAAM,aAAa,GAAG,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtE,OAAO,cAAc,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/lib/chat/recall.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Chat-side memory recall.
+ *
+ * Wraps the existing federated search to produce a set of memories suitable
+ * for injection into the LLM system prompt. Always includes pinned memories
+ * regardless of search relevance.
+ */
+import { GnosysDB } from "../db.js";
+import { Turn } from "./types.js";
+export type RecallScope = "project" | "user" | "global" | "federated";
+export interface RecallOptions {
+    /** Search query — usually the latest user input plus a tail of conversation. */
+    query: string;
+    /** Recall scope. "federated" means search across all scopes with tier boosting. */
+    scope: RecallScope;
+    /** Active project ID (used by federated search for tier boosting). Null when no project context. */
+    projectId: string | null;
+    /** Confidence threshold — drop memories below this. 0 disables. */
+    threshold: number;
+    /** Pinned memory IDs — always included, ranked first. */
+    pinnedIds: string[];
+    /** Max non-pinned results (default 5). */
+    limit?: number;
+}
+export interface RecalledMemory {
+    id: string;
+    title: string;
+    content: string;
+    category: string;
+    scope: string;
+    confidence: number;
+    /** True when included because it's pinned (not because the query matched it). */
+    pinned: boolean;
+    /** Federated search score; 0 for pinned memories that didn't match the query. */
+    score: number;
+}
+export interface RecallResult {
+    memories: RecalledMemory[];
+    /** The query string actually run (may differ from input — e.g. trimmed). */
+    query: string;
+    /** Total candidates considered before threshold/limit. */
+    considered: number;
+}
+/** Build a search query from the current user input + a few recent turns for context. */
+export declare function buildRecallQuery(userInput: string, buffer: Turn[]): string;
+/**
+ * Run recall for one chat turn. Returns pinned memories first (always),
+ * then top federated matches respecting scope and threshold.
+ */
+export declare function runRecall(db: GnosysDB, opts: RecallOptions): RecallResult;
+/**
+ * Render recalled memories as a system-prompt block. Pinned memories are
+ * marked so the model knows the user has explicitly anchored them.
+ */
+export declare function formatRecallForPrompt(memories: RecalledMemory[]): string;
+/** Reinforce a memory: bump modified date so it's surfaced as recent. */
+export declare function reinforceMemory(db: GnosysDB, memoryId: string): boolean;
+//# sourceMappingURL=recall.d.ts.map

package/dist/lib/chat/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/recall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAY,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,EAAE,WAAW,CAAC;IACnB,oGAAoG;IACpG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,YAAY,CA4DzE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAUxE;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvE"}