gnosys 5.5.0 → 5.7.0

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"}

package/dist/lib/chat/recall.js

@@ -0,0 +1,109 @@
+/**
+ * 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 { federatedSearch } from "../federated.js";
+const MAX_QUERY_LEN = 200;
+/** Build a search query from the current user input + a few recent turns for context. */
+export function buildRecallQuery(userInput, buffer) {
+    const tail = buffer
+        .filter((t) => t.role === "user" || t.role === "assistant")
+        .slice(-2)
+        .map((t) => t.text)
+        .join(" ");
+    const combined = `${userInput} ${tail}`.trim().slice(0, MAX_QUERY_LEN);
+    return combined;
+}
+/**
+ * Run recall for one chat turn. Returns pinned memories first (always),
+ * then top federated matches respecting scope and threshold.
+ */
+export function runRecall(db, opts) {
+    const limit = opts.limit ?? 5;
+    const memories = [];
+    const seen = new Set();
+    // 1. Pinned memories — always included (ranked first)
+    for (const id of opts.pinnedIds) {
+        const mem = db.getMemory(id);
+        if (!mem)
+            continue;
+        seen.add(id);
+        memories.push({
+            id: mem.id,
+            title: mem.title,
+            content: mem.content,
+            category: mem.category,
+            scope: mem.scope,
+            confidence: mem.confidence,
+            pinned: true,
+            score: 0,
+        });
+    }
+    // 2. Federated search — but exclude pinned IDs and apply scope filter
+    const scopeFilter = opts.scope === "federated" ? undefined : [opts.scope];
+    const results = federatedSearch(db, opts.query, {
+        limit: Math.max(limit * 2, 20), // over-fetch so threshold can drop some
+        projectId: opts.projectId,
+        scopeFilter: scopeFilter,
+    });
+    let considered = results.length + opts.pinnedIds.length;
+    for (const r of results) {
+        if (memories.length - opts.pinnedIds.length >= limit)
+            break;
+        if (seen.has(r.id))
+            continue;
+        const mem = db.getMemory(r.id);
+        if (!mem)
+            continue;
+        if (mem.confidence < opts.threshold)
+            continue;
+        seen.add(r.id);
+        memories.push({
+            id: mem.id,
+            title: mem.title,
+            content: mem.content,
+            category: mem.category,
+            scope: mem.scope,
+            confidence: mem.confidence,
+            pinned: false,
+            score: r.score,
+        });
+    }
+    return {
+        memories,
+        query: opts.query,
+        considered,
+    };
+}
+/**
+ * Render recalled memories as a system-prompt block. Pinned memories are
+ * marked so the model knows the user has explicitly anchored them.
+ */
+export function formatRecallForPrompt(memories) {
+    if (memories.length === 0)
+        return "";
+    const blocks = memories.map((m) => {
+        const pinTag = m.pinned ? ` pinned="true"` : "";
+        return `<memory id="${m.id}" category="${m.category}" confidence="${m.confidence}"${pinTag}>\n# ${m.title}\n${m.content}\n</memory>`;
+    });
+    return [
+        "RELEVANT MEMORY (you have persistent memory via Gnosys; cite ids when you use them):",
+        ...blocks,
+    ].join("\n\n");
+}
+/** Reinforce a memory: bump modified date so it's surfaced as recent. */
+export function reinforceMemory(db, memoryId) {
+    const mem = db.getMemory(memoryId);
+    if (!mem)
+        return false;
+    db.updateMemory(memoryId, {
+        modified: new Date().toISOString(),
+        reinforcement_count: (mem.reinforcement_count ?? 0) + 1,
+        last_reinforced: new Date().toISOString(),
+    });
+    return true;
+}
+//# sourceMappingURL=recall.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Chat TUI — ink-based React components.
+ *
+ * Layout:
+ *   ┌────────────────────────────────────────┐
+ *   │ Header: project | provider/model | tokens │
+ *   ├────────────────────────────────────────┤
+ *   │ Conversation                           │
+ *   │   user / assistant turns scroll        │
+ *   │   system messages in dim text          │
+ *   ├────────────────────────────────────────┤
+ *   │ Status: idle | thinking… | error       │
+ *   ├────────────────────────────────────────┤
+ *   │ > input prompt                         │
+ *   └────────────────────────────────────────┘
+ */
+import React from "react";
+import { ChatHeaderInfo, Turn } from "./types.js";
+import { GnosysConfig } from "../config.js";
+export interface ChatAppProps {
+    initialHeader: ChatHeaderInfo;
+    initialBuffer: Turn[];
+    config: GnosysConfig;
+    /** Project ID for recall scoping (null when no project context). */
+    projectId: string | null;
+    /** Called on exit so the parent CLI process can clean up. */
+    onExit?: () => void;
+}
+export declare const ChatApp: React.FC<ChatAppProps>;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/render.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAK3D,OAAO,EAAE,cAAc,EAAc,IAAI,EAAE,MAAM,YAAY,CAAC;AAyB9D,OAAO,EAAE,YAAY,EAAmB,MAAM,cAAc,CAAC;AAG7D,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,cAAc,CAAC;IAC9B,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA4sB1C,CAAC"}