gnosys 5.5.0 → 5.7.0

package/dist/lib/chat/tools.js

@@ -0,0 +1,338 @@
+/**
+ * Chat-side tool catalog.
+ *
+ * The LLM in `gnosys chat` can call gnosys functions directly via a fenced
+ * protocol (gnosys-tool). Each tool is a small read-only query into the
+ * central DB; the result is injected back into the conversation as a system
+ * turn before the LLM's next response.
+ *
+ * Why a fenced protocol instead of native tool_use APIs:
+ * - Provider-agnostic: works with Anthropic, OpenAI, Groq, Ollama, LM Studio,
+ *   and anything that streams plain text. Same approach as gnosys-choose.
+ * - Same in-process function calls the MCP server uses internally — no MCP
+ *   roundtrip, no schema duplication.
+ * - The model can chain tool calls naturally (call list_projects, then
+ *   briefing on a name) because each tool result is a normal turn.
+ *
+ * Format the model emits:
+ *
+ *   ```gnosys-tool
+ *   tool: list_projects
+ *   ```
+ *
+ *   ```gnosys-tool
+ *   tool: search
+ *   query: ULID encoding
+ *   limit: 5
+ *   ```
+ *
+ *   ```gnosys-tool
+ *   tool: read
+ *   id: deci-037
+ *   ```
+ *
+ * The fence syntax is parsed by toolFence.ts.
+ */
+import { GnosysDB } from "../db.js";
+import { federatedSearch } from "../federated.js";
+const TOOLS = [
+    {
+        name: "list_projects",
+        description: "List every registered project across the central DB",
+        params: {},
+        run: async () => {
+            const db = GnosysDB.openCentral();
+            try {
+                const projects = db.getAllProjects();
+                if (projects.length === 0)
+                    return "No projects registered.";
+                const lines = ["Projects:"];
+                for (const p of projects) {
+                    const memCount = db.getMemoriesByProject(p.id).length;
+                    lines.push(`- ${p.name} (id: \`${p.id}\`, ${memCount} active memories) — ${p.working_directory}`);
+                }
+                return lines.join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "search",
+        description: "Search memories by free text. Federated across project/user/global with tier boosting.",
+        params: {
+            query: "the search string (required)",
+            limit: "max results (default 10)",
+            project_id: "optional — filter to a project ID",
+        },
+        run: async (args) => {
+            if (!args.query)
+                return "Error: `query` is required for the search tool.";
+            const db = GnosysDB.openCentral();
+            try {
+                const results = federatedSearch(db, args.query, {
+                    limit: args.limit ? parseInt(args.limit, 10) : 10,
+                    projectId: args.project_id ?? null,
+                });
+                if (results.length === 0)
+                    return `No matches for "${args.query}".`;
+                const lines = [`Results for "${args.query}" (${results.length}):`];
+                for (const r of results) {
+                    const score = r.score.toFixed(2);
+                    lines.push(`- [${r.id}] ${r.title} (${r.scope}, score=${score})`);
+                    lines.push(`    ${r.snippet.slice(0, 140)}${r.snippet.length > 140 ? "..." : ""}`);
+                }
+                return lines.join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "read",
+        description: "Read a specific memory by ID. Use after `search` to fetch full content.",
+        params: {
+            id: "the memory ID (required)",
+        },
+        run: async (args) => {
+            if (!args.id)
+                return "Error: `id` is required for the read tool.";
+            const db = GnosysDB.openCentral();
+            try {
+                const mem = db.getMemory(args.id);
+                if (!mem)
+                    return `Memory not found: \`${args.id}\``;
+                const tags = (() => {
+                    try {
+                        const t = JSON.parse(mem.tags || "[]");
+                        return Array.isArray(t) ? t.join(", ") : "—";
+                    }
+                    catch {
+                        return "—";
+                    }
+                })();
+                return [
+                    `# ${mem.title}`,
+                    `id: ${mem.id} · category: ${mem.category} · scope: ${mem.scope} · confidence: ${mem.confidence}`,
+                    `tags: ${tags}`,
+                    "",
+                    mem.content,
+                ].join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "briefing",
+        description: "Generate a project briefing — categories, recent activity, top tags. Pass project_id OR project_name (current project if neither given).",
+        params: {
+            project_id: "the project ID (optional)",
+            project_name: "the project name (optional, looked up if id not given)",
+        },
+        run: async (args) => {
+            const db = GnosysDB.openCentral();
+            try {
+                const { generateBriefing, detectCurrentProject } = await import("../federated.js");
+                let pid = args.project_id ?? null;
+                if (!pid && args.project_name) {
+                    const all = db.getAllProjects();
+                    const found = all.find((p) => p.name === args.project_name);
+                    if (found)
+                        pid = found.id;
+                }
+                if (!pid)
+                    pid = await detectCurrentProject(db, undefined);
+                if (!pid)
+                    return "No project specified or detected.";
+                const briefing = generateBriefing(db, pid);
+                if (!briefing)
+                    return `Project not found: ${pid}`;
+                return briefing.summary;
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "stats",
+        description: "Memory counts by project (active, archived, reinforcements). The 'how many memories?' tool.",
+        params: {},
+        run: async () => {
+            const db = GnosysDB.openCentral();
+            try {
+                const projects = db.getAllProjects();
+                const all = db.getAllMemories();
+                const lines = ["Project statistics:"];
+                let totalActive = 0;
+                for (const p of projects) {
+                    const ms = all.filter((m) => m.project_id === p.id);
+                    const active = ms.filter((m) => m.tier === "active" && m.status === "active").length;
+                    const archived = ms.filter((m) => m.tier === "archive").length;
+                    totalActive += active;
+                    lines.push(`- ${p.name}: ${active} active, ${archived} archived`);
+                }
+                const userScope = all.filter((m) => !m.project_id && m.scope === "user").length;
+                const globalScope = all.filter((m) => !m.project_id && m.scope === "global").length;
+                if (userScope > 0)
+                    lines.push(`- (user-scope): ${userScope}`);
+                if (globalScope > 0)
+                    lines.push(`- (global): ${globalScope}`);
+                lines.push(`Total active: ${totalActive + userScope + globalScope}`);
+                return lines.join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "tags",
+        description: "List all tags used across memories with their occurrence counts.",
+        params: {
+            limit: "max tags to return (default 30)",
+        },
+        run: async (args) => {
+            const db = GnosysDB.openCentral();
+            try {
+                const all = db.getActiveMemories();
+                const counts = new Map();
+                for (const m of all) {
+                    try {
+                        const tags = JSON.parse(m.tags || "[]");
+                        if (Array.isArray(tags)) {
+                            for (const t of tags)
+                                counts.set(t, (counts.get(t) ?? 0) + 1);
+                        }
+                    }
+                    catch { /* skip malformed */ }
+                }
+                const limit = args.limit ? parseInt(args.limit, 10) : 30;
+                const sorted = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, limit);
+                if (sorted.length === 0)
+                    return "No tags found.";
+                return ["Tags (most common):", ...sorted.map(([t, n]) => `- ${t}: ${n}`)].join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "audit",
+        description: "Recent operations from the audit log (writes, reads, dream cycles). Useful for 'what did you do recently?'",
+        params: {
+            days: "look back N days (default 7)",
+            operation: "filter by operation (write, read, recall, dream_complete, etc.)",
+            limit: "max entries (default 20)",
+        },
+        run: async (args) => {
+            const db = GnosysDB.openCentral();
+            try {
+                const days = args.days ? parseInt(args.days, 10) : 7;
+                const cutoff = new Date();
+                cutoff.setDate(cutoff.getDate() - days);
+                const limit = args.limit ? parseInt(args.limit, 10) : 20;
+                const entries = db.queryAuditLog({
+                    sinceIso: cutoff.toISOString(),
+                    operation: args.operation,
+                    limit,
+                });
+                if (entries.length === 0)
+                    return `No audit entries in the last ${days} day(s).`;
+                const lines = [`Recent ${entries.length} audit entr${entries.length === 1 ? "y" : "ies"} (last ${days} days):`];
+                for (const e of entries) {
+                    const memRef = e.memory_id ? ` → ${e.memory_id}` : "";
+                    const dur = e.duration_ms ? ` (${e.duration_ms}ms)` : "";
+                    lines.push(`- ${e.timestamp.slice(0, 19)}  ${e.operation}${memRef}${dur}`);
+                }
+                return lines.join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+    {
+        name: "recent_memories",
+        description: "Memories created or modified recently. Useful for 'what's the latest in project X?'",
+        params: {
+            project_name: "filter to a project name (optional)",
+            project_id: "filter to a project ID (optional)",
+            days: "look back N days (default 7)",
+            limit: "max results (default 20)",
+        },
+        run: async (args) => {
+            const db = GnosysDB.openCentral();
+            try {
+                const days = args.days ? parseInt(args.days, 10) : 7;
+                const limit = args.limit ? parseInt(args.limit, 10) : 20;
+                const cutoff = new Date();
+                cutoff.setDate(cutoff.getDate() - days);
+                const cutoffStr = cutoff.toISOString().slice(0, 10);
+                let pid = args.project_id ?? null;
+                if (!pid && args.project_name) {
+                    const found = db.getAllProjects().find((p) => p.name === args.project_name);
+                    if (found)
+                        pid = found.id;
+                }
+                const all = pid
+                    ? db.getMemoriesByProject(pid)
+                    : db.getActiveMemories();
+                const recent = all
+                    .filter((m) => (m.modified || m.created) >= cutoffStr)
+                    .sort((a, b) => (b.modified || b.created).localeCompare(a.modified || a.created))
+                    .slice(0, limit);
+                if (recent.length === 0) {
+                    return `No memories modified in the last ${days} day(s)${pid ? " for that project" : ""}.`;
+                }
+                const lines = [`Recent ${recent.length} memor${recent.length === 1 ? "y" : "ies"} (last ${days} days):`];
+                for (const m of recent) {
+                    lines.push(`- [${m.id}] ${m.title}  (${m.modified || m.created})`);
+                }
+                return lines.join("\n");
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+];
+// ─── Public API ────────────────────────────────────────────────────────────
+const TOOL_INDEX = new Map(TOOLS.map((t) => [t.name, t]));
+export function findTool(name) {
+    return TOOL_INDEX.get(name);
+}
+export function listTools() {
+    return [...TOOLS];
+}
+/** System prompt addendum that teaches the LLM the tool-fence syntax. */
+export function buildToolsSystemPrompt() {
+    const lines = [
+        "",
+        "You can call gnosys functions to look up live data the user is asking about. Emit a fenced block:",
+        "",
+        "```gnosys-tool",
+        "tool: <name>",
+        "<param>: <value>",
+        "```",
+        "",
+        "After the fence, STOP. The runtime will execute the tool and inject the result before your next message. Then continue your reply naturally, citing the tool result.",
+        "",
+        "Available tools:",
+    ];
+    for (const t of TOOLS) {
+        const params = Object.keys(t.params).length > 0
+            ? ` (params: ${Object.entries(t.params).map(([k, d]) => `${k} — ${d}`).join("; ")})`
+            : "";
+        lines.push(`- ${t.name}: ${t.description}${params}`);
+    }
+    lines.push("");
+    lines.push("Don't make up data — call a tool when the user asks anything specific about projects, memories, recent activity, tags, or stats.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/lib/chat/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,QAAQ,EAAiB,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAalD,MAAM,KAAK,GAAqB;IAC9B;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qDAAqD;QAClE,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;gBACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,yBAAyB,CAAC;gBAC5D,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;oBACtD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,OAAO,QAAQ,uBAAuB,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;gBACpG,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wFAAwF;QACrG,MAAM,EAAE;YACN,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE,0BAA0B;YACjC,UAAU,EAAE,mCAAmC;SAChD;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO,iDAAiD,CAAC;YAC1E,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE;oBAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;oBACjD,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;iBACnC,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,mBAAmB,IAAI,CAAC,KAAK,IAAI,CAAC;gBACnE,MAAM,KAAK,GAAG,CAAC,gBAAgB,IAAI,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACjC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,WAAW,KAAK,GAAG,CAAC,CAAC;oBAClE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrF,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,yEAAyE;QACtF,MAAM,EAAE;YACN,EAAE,EAAE,0BAA0B;SAC/B;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,IAAI,CAAC,IAAI,CAAC,EAAE;gBAAE,OAAO,4CAA4C,CAAC;YAClE,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,CAAC,GAAG;oBAAE,OAAO,uBAAuB,IAAI,CAAC,EAAE,IAAI,CAAC;gBACpD,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;oBACjB,IAAI,CAAC;wBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;wBACvC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC/C,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,GAAG,CAAC;oBACb,CAAC;gBACH,CAAC,CAAC,EAAE,CAAC;gBACL,OAAO;oBACL,KAAK,GAAG,CAAC,KAAK,EAAE;oBAChB,OAAO,GAAG,CAAC,EAAE,gBAAgB,GAAG,CAAC,QAAQ,aAAa,GAAG,CAAC,KAAK,kBAAkB,GAAG,CAAC,UAAU,EAAE;oBACjG,SAAS,IAAI,EAAE;oBACf,EAAE;oBACF,GAAG,CAAC,OAAO;iBACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0IAA0I;QACvJ,MAAM,EAAE;YACN,UAAU,EAAE,2BAA2B;YACvC,YAAY,EAAE,wDAAwD;SACvE;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBACnF,IAAI,GAAG,GAAkB,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;gBACjD,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;oBAChC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC5D,IAAI,KAAK;wBAAE,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC5B,CAAC;gBACD,IAAI,CAAC,GAAG;oBAAE,GAAG,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;gBAC1D,IAAI,CAAC,GAAG;oBAAE,OAAO,mCAAmC,CAAC;gBACrD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC3C,IAAI,CAAC,QAAQ;oBAAE,OAAO,sBAAsB,GAAG,EAAE,CAAC;gBAClD,OAAO,QAAQ,CAAC,OAAO,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,6FAA6F;QAC1G,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;gBACrC,MAAM,GAAG,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,CAAC,qBAAqB,CAAC,CAAC;gBACtC,IAAI,WAAW,GAAG,CAAC,CAAC;gBACpB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBACpD,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;oBACrF,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;oBAC/D,WAAW,IAAI,MAAM,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,YAAY,QAAQ,WAAW,CAAC,CAAC;gBACpE,CAAC;gBACD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;gBAChF,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;gBACpF,IAAI,SAAS,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;gBAC9D,IAAI,WAAW,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC;gBACrE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE;YACN,KAAK,EAAE,iCAAiC;SACzC;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;gBACzC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;oBACpB,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;wBACxC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;4BACxB,KAAK,MAAM,CAAC,IAAI,IAAI;gCAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;wBAChE,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,gBAAgB,CAAC;gBACjD,OAAO,CAAC,qBAAqB,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvF,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4GAA4G;QACzH,MAAM,EAAE;YACN,IAAI,EAAE,8BAA8B;YACpC,SAAS,EAAE,iEAAiE;YAC5E,KAAK,EAAE,0BAA0B;SAClC;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;gBACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC;oBAC/B,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE;oBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,KAAK;iBACN,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,gCAAgC,IAAI,UAAU,CAAC;gBAChF,MAAM,KAAK,GAAG,CAAC,UAAU,OAAO,CAAC,MAAM,cAAc,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,SAAS,CAAC,CAAC;gBAChH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtD,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,qFAAqF;QAClG,MAAM,EAAE;YACN,YAAY,EAAE,qCAAqC;YACnD,UAAU,EAAE,mCAAmC;YAC/C,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,0BAA0B;SAClC;QACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;gBACxC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAEpD,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;gBAClC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBAC9B,MAAM,KAAK,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC5E,IAAI,KAAK;wBAAE,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC5B,CAAC;gBAED,MAAM,GAAG,GAAe,GAAG;oBACzB,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC;oBAC9B,CAAC,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,GAAG;qBACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;qBACrD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;qBAChF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,oCAAoC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC7F,CAAC;gBACD,MAAM,KAAK,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,SAAS,CAAC,CAAC;gBACzG,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;gBACrE,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF;CACF,CAAC;AAEF,8EAA8E;AAE9E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAyB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAElF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,mGAAmG;QACnG,EAAE;QACF,gBAAgB;QAChB,cAAc;QACd,kBAAkB;QAClB,KAAK;QACL,EAAE;QACF,sKAAsK;QACtK,EAAE;QACF,kBAAkB;KACnB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;YAC7C,CAAC,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACpF,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kIAAkI,CAAC,CAAC;IAC/I,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Shared types for the chat TUI. Kept separate from session.ts so the
+ * React/ink components can import without pulling fs/path dependencies.
+ */
+export type Turn = {
+    role: "user";
+    text: string;
+    ts: string;
+} | {
+    role: "assistant";
+    text: string;
+    ts: string;
+    provider?: string;
+    model?: string;
+    tokensIn?: number;
+    tokensOut?: number;
+    citedMemoryIds?: string[];
+} | {
+    role: "system";
+    text: string;
+    ts: string;
+};
+export type ChatStatus = {
+    kind: "idle";
+} | {
+    kind: "thinking";
+} | {
+    kind: "streaming";
+    partial: string;
+} | {
+    kind: "error";
+    message: string;
+};
+export interface ChatHeaderInfo {
+    sessionId: string;
+    projectName?: string;
+    provider: string;
+    model: string;
+    tokensIn: number;
+    tokensOut: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACpJ;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/lib/chat/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared types for the chat TUI. Kept separate from session.ts so the
+ * React/ink components can import without pulling fs/path dependencies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/chat/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,66 @@
+/**
+ * Chat-side memory writing — promote chat content to gnosys memories.
+ *
+ * Handles three triggers:
+ *   /remember <text>     explicit user-marked insight
+ *   /save-turn           distill the last user+assistant exchange
+ *   /attach <file>       ingest a file via the multimodal pipeline
+ *
+ * All promoted memories carry session provenance:
+ *   tags.session: [<sessionId>]
+ *   tags.from-chat: ["true"]
+ *   tags.source: ["remember" | "save-turn" | "auto" | "attach"]
+ */
+import { GnosysDB } from "../db.js";
+import { GnosysConfig } from "../config.js";
+import { Turn } from "./types.js";
+export type PromoteSource = "remember" | "save-turn" | "auto" | "attach";
+export interface PromoteOptions {
+    /** Free-form text to save. */
+    content: string;
+    /** Optional override for category (default depends on source). */
+    category?: string;
+    /** Optional override for title (default: derived from first line / LLM). */
+    title?: string;
+    /** Source trigger — recorded as a tag for provenance. */
+    source: PromoteSource;
+    /** Session ID for provenance. */
+    sessionId: string;
+    /** Project ID to scope the memory to (null → user scope). */
+    projectId: string | null;
+    /** Optional structuring config (when LLM is available). Set to null to skip LLM. */
+    config?: GnosysConfig | null;
+}
+export interface PromoteResult {
+    id: string;
+    title: string;
+    category: string;
+}
+/**
+ * Write a chat-sourced memory to the central DB. Returns the assigned ID.
+ *
+ * Uses LLM structuring when config is provided and the structuring provider
+ * is reachable; falls back to a heuristic title + category otherwise.
+ */
+export declare function promoteToMemory(db: GnosysDB, opts: PromoteOptions): Promise<PromoteResult>;
+/** Build the content for /save-turn from the most recent user+assistant exchange. */
+export declare function lastExchange(buffer: Turn[]): {
+    user: string;
+    assistant: string;
+} | null;
+/** Format a save-turn pair as a markdown exchange suitable for memory content. */
+export declare function formatExchange(pair: {
+    user: string;
+    assistant: string;
+}): string;
+export interface AutoPromoteHint {
+    reason: string;
+    match: string;
+}
+/**
+ * Scan a user turn for "looks like a decision/insight worth saving" patterns.
+ * Returns a hint that the TUI can surface as an inline confirm prompt.
+ * Returns null when nothing matches.
+ */
+export declare function detectAutoPromote(userText: string): AutoPromoteHint | null;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAY,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,EAAE,aAAa,CAAC;IACtB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgFD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CA8DxB;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBvF;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEhF;AAUD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQ1E"}