compact-agent 1.9.0 → 1.10.1

package/dist/tools/memory.js

@@ -0,0 +1,319 @@
+/**
+ * MemPalace-backed memory tools the agent can call.
+ *
+ * Surface (kept small, action-oriented):
+ *   memory_search   read    full-text search across global + project stores
+ *   memory_recall   read    fetch a specific drawer by id, plus its tunnels
+ *   memory_add      write   create a new drawer (or save a fact via KG)
+ *   memory_link     write   tunnel between two drawers
+ *   memory_list     read    inventory: wings/rooms/recent drawers
+ *
+ * The agent should reach for these whenever the user mentions facts that
+ * are worth keeping across sessions ("I always use vitest, never jest"),
+ * codebase landmarks ("the auth flow lives in src/auth/oauth.ts"), or
+ * lessons learned during this turn that future sessions would benefit
+ * from. The system prompt nudges this — see src/system-prompt.ts.
+ *
+ * All write tools are marked isDestructive: false because they only
+ * append to a local file — no network, no external state. They still
+ * require permission in `ask` mode by default but don't trigger the
+ * destructive-action verbal-confirm path.
+ */
+import { addDrawer, getDrawer, listDrawers, search, linkDrawers, kgAdd, kgQuery, listWings, listRooms, stats, } from '../mempalace/index.js';
+// ── memory_add ────────────────────────────────────────────
+export const MemoryAddTool = {
+    name: 'memory_add',
+    description: 'Save a memory drawer to the MemPalace store. Use this when the user mentions ' +
+        'a fact, preference, codebase landmark, or lesson worth remembering across sessions. ' +
+        'Scope: "global" for user preferences / cross-project facts, "project" for ' +
+        'codebase-specific knowledge, "auto" (default) to infer from content. ' +
+        'Pick a sensible wing ("preferences", "code", "people", "projects", "lessons") and ' +
+        'a room (the project name, person name, or topic). Tag generously — tags are the ' +
+        'strongest search signal.',
+    parameters: {
+        type: 'object',
+        properties: {
+            wing: { type: 'string', description: 'Top-level domain, e.g. "preferences" / "code" / "lessons"' },
+            room: { type: 'string', description: 'Category within the wing, e.g. project name or topic' },
+            content: { type: 'string', description: 'The memory text. Be concise but specific.' },
+            tags: { type: 'array', description: 'Lowercase keywords for filtering + search', items: { type: 'string' } },
+            importance: { type: 'number', description: '0..1, default 0.5. Boosts search ranking.' },
+            scope: { type: 'string', description: '"global" | "project" | "auto" (default auto)' },
+        },
+        required: ['wing', 'room', 'content'],
+    },
+    isReadOnly: false,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const drawer = addDrawer({
+                wing: input.wing,
+                room: input.room,
+                content: input.content,
+                tags: input.tags || [],
+                importance: typeof input.importance === 'number' ? input.importance : undefined,
+                scope: input.scope || 'auto',
+                cwd,
+            });
+            return {
+                output: `Saved drawer ${drawer.id} (${drawer.scope}: ${drawer.wing}/${drawer.room}).`,
+                isError: false,
+            };
+        }
+        catch (e) {
+            return { output: `Error saving drawer: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// ── memory_search ─────────────────────────────────────────
+export const MemorySearchTool = {
+    name: 'memory_search',
+    description: 'Search the MemPalace store for drawers matching a query. Searches both ' +
+        'global and project memory by default; pass scope to narrow. Returns top ' +
+        'hits ranked by relevance with their wing/room and content excerpt. Use ' +
+        'this BEFORE proposing something the user may have said before, and to ' +
+        'recall codebase landmarks instead of re-discovering them.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Free-text query; keywords work best' },
+            scope: { type: 'string', description: '"global" | "project" | "both" (default both)' },
+            wing: { type: 'string', description: 'Optional wing filter' },
+            room: { type: 'string', description: 'Optional room filter' },
+            tags: { type: 'array', description: 'Optional tag AND-filter', items: { type: 'string' } },
+            limit: { type: 'number', description: 'Max results, default 10' },
+        },
+        required: ['query'],
+    },
+    isReadOnly: true,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const hits = search(input.query, cwd, {
+                scope: input.scope || 'both',
+                wing: input.wing,
+                room: input.room,
+                tags: input.tags || undefined,
+                limit: typeof input.limit === 'number' ? input.limit : 10,
+            });
+            if (hits.length === 0) {
+                return { output: `No drawers matched "${input.query}".`, isError: false };
+            }
+            const lines = hits.map((h) => {
+                const excerpt = h.drawer.content.length > 200
+                    ? h.drawer.content.slice(0, 200) + '…'
+                    : h.drawer.content;
+                const tagStr = h.drawer.tags.length > 0 ? ` [${h.drawer.tags.join(', ')}]` : '';
+                return `${h.drawer.id} (${h.drawer.scope} · ${h.drawer.wing}/${h.drawer.room}${tagStr}) score=${h.score.toFixed(2)}\n  ${excerpt}`;
+            });
+            return { output: `Found ${hits.length} drawer(s):\n\n${lines.join('\n\n')}`, isError: false };
+        }
+        catch (e) {
+            return { output: `Error searching: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// ── memory_recall ─────────────────────────────────────────
+export const MemoryRecallTool = {
+    name: 'memory_recall',
+    description: 'Fetch a specific drawer by its id (returned by memory_search). Also lists ' +
+        'any tunnels (relationships) the drawer has to other drawers. Use to get ' +
+        'the full content + context of something a search surfaced.',
+    parameters: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Drawer id, e.g. "drw_xxxxxxx"' },
+        },
+        required: ['id'],
+    },
+    isReadOnly: true,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const id = input.id;
+            const drawer = getDrawer(id, cwd);
+            if (!drawer)
+                return { output: `No drawer with id ${id} in either store.`, isError: false };
+            const tagStr = drawer.tags.length > 0 ? ` [${drawer.tags.join(', ')}]` : '';
+            const out = [
+                `${drawer.id} (${drawer.scope} · ${drawer.wing}/${drawer.room}${tagStr})`,
+                `importance: ${drawer.importance}  created: ${drawer.createdAt}  updated: ${drawer.updatedAt}`,
+                '',
+                drawer.content,
+            ];
+            return { output: out.join('\n'), isError: false };
+        }
+        catch (e) {
+            return { output: `Error recalling: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// ── memory_link ───────────────────────────────────────────
+export const MemoryLinkTool = {
+    name: 'memory_link',
+    description: 'Create a directed tunnel from one drawer to another with a labelled relation. ' +
+        'Both drawers must be in the same store (global or project). Examples of ' +
+        'relations: "supersedes", "inspired", "in-project", "depends-on", "refines". ' +
+        'Use sparingly — only link when the connection is genuinely useful for later ' +
+        'traversal.',
+    parameters: {
+        type: 'object',
+        properties: {
+            from_id: { type: 'string', description: 'Source drawer id' },
+            to_id: { type: 'string', description: 'Target drawer id' },
+            relation: { type: 'string', description: 'Verb describing how from relates to to' },
+        },
+        required: ['from_id', 'to_id', 'relation'],
+    },
+    isReadOnly: false,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const t = linkDrawers(input.from_id, input.to_id, input.relation, cwd);
+            return { output: `Linked ${t.fromDrawerId} → ${t.toDrawerId} via "${t.relation}" (tunnel ${t.id}).`, isError: false };
+        }
+        catch (e) {
+            return { output: `Error linking: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// ── memory_list ───────────────────────────────────────────
+export const MemoryListTool = {
+    name: 'memory_list',
+    description: 'Inventory the MemPalace store. With no args, returns wings + drawer counts ' +
+        'in both stores. With a wing arg, lists rooms within that wing. With wing + ' +
+        'room, lists drawer summaries. Use to orient before searching, or to see ' +
+        '"what do I know about X" at a glance.',
+    parameters: {
+        type: 'object',
+        properties: {
+            wing: { type: 'string', description: 'Optional wing to drill into' },
+            room: { type: 'string', description: 'Optional room (requires wing)' },
+            scope: { type: 'string', description: '"global" | "project" | "both" (default both)' },
+        },
+    },
+    isReadOnly: true,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const scope = input.scope || 'both';
+            const wing = input.wing;
+            const room = input.room;
+            if (wing && room) {
+                const drawers = listDrawers({ wing, room, scope, cwd });
+                if (drawers.length === 0)
+                    return { output: `No drawers in ${wing}/${room}.`, isError: false };
+                const lines = drawers.map((d) => {
+                    const excerpt = d.content.length > 80 ? d.content.slice(0, 80) + '…' : d.content;
+                    return `${d.id} (${d.scope}) ${excerpt}`;
+                });
+                return { output: `${drawers.length} drawer(s) in ${wing}/${room}:\n${lines.join('\n')}`, isError: false };
+            }
+            if (wing) {
+                const r = listRooms(cwd, wing, scope);
+                const all = [...r.global, ...r.project];
+                if (all.length === 0)
+                    return { output: `No rooms in wing "${wing}".`, isError: false };
+                const lines = all.map((rm) => `  ${rm.wing}/${rm.name} — ${rm.drawerCount} drawer(s), last ${rm.lastTouched.slice(0, 10)}`);
+                return { output: `Rooms in "${wing}":\n${lines.join('\n')}`, isError: false };
+            }
+            const w = listWings(cwd, scope);
+            const s = stats(cwd);
+            const out = [];
+            out.push(`Global store: ${s.global.drawers} drawer(s), ${s.global.tunnels} tunnel(s), ${s.global.triples} triple(s)`);
+            for (const wm of w.global) {
+                out.push(`  ${wm.name}: ${wm.drawerCount} drawer(s) across ${wm.rooms.length} room(s)`);
+            }
+            out.push('');
+            out.push(`Project store: ${s.project.drawers} drawer(s), ${s.project.tunnels} tunnel(s), ${s.project.triples} triple(s)${s.projectExists ? '' : ' (not yet created)'}`);
+            for (const wm of w.project) {
+                out.push(`  ${wm.name}: ${wm.drawerCount} drawer(s) across ${wm.rooms.length} room(s)`);
+            }
+            return { output: out.join('\n'), isError: false };
+        }
+        catch (e) {
+            return { output: `Error listing: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// ── memory_fact_add / memory_fact_query (knowledge graph) ──
+export const MemoryFactAddTool = {
+    name: 'memory_fact_add',
+    description: 'Record a structured fact in the knowledge graph: (subject, predicate, object). ' +
+        'Example: subject="rsfit" predicate="prefers" object="vitest over jest". ' +
+        'Use for atomic facts you want to be able to QUERY later by parts ' +
+        '("what does rsfit prefer?"). For longer narrative content, use memory_add ' +
+        'instead.',
+    parameters: {
+        type: 'object',
+        properties: {
+            subject: { type: 'string', description: 'Entity the fact is about' },
+            predicate: { type: 'string', description: 'Relation/verb' },
+            object: { type: 'string', description: 'Value or related entity' },
+            confidence: { type: 'number', description: '0..1, default 1.0 (certain)' },
+            scope: { type: 'string', description: '"global" | "project" (default global)' },
+        },
+        required: ['subject', 'predicate', 'object'],
+    },
+    isReadOnly: false,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const scope = (input.scope || 'global');
+            const t = kgAdd({
+                subject: input.subject,
+                predicate: input.predicate,
+                object: input.object,
+                confidence: typeof input.confidence === 'number' ? input.confidence : 1.0,
+            }, scope, cwd);
+            return { output: `Added fact: (${t.subject}, ${t.predicate}, ${t.object}) [${t.scope}, confidence ${t.confidence}]`, isError: false };
+        }
+        catch (e) {
+            return { output: `Error adding fact: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+export const MemoryFactQueryTool = {
+    name: 'memory_fact_query',
+    description: 'Query the knowledge graph for facts. Any of subject/predicate/object can be ' +
+        'left unspecified to act as a wildcard. e.g. predicate="prefers" finds all ' +
+        'preferences; subject="rsfit" finds everything we know about the user.',
+    parameters: {
+        type: 'object',
+        properties: {
+            subject: { type: 'string' },
+            predicate: { type: 'string' },
+            object: { type: 'string' },
+            scope: { type: 'string', description: '"global" | "project" | "both" (default both)' },
+        },
+    },
+    isReadOnly: true,
+    isDestructive: false,
+    async call(input, cwd) {
+        try {
+            const triples = kgQuery({
+                subject: input.subject,
+                predicate: input.predicate,
+                object: input.object,
+            }, cwd, input.scope || 'both');
+            if (triples.length === 0)
+                return { output: 'No matching facts.', isError: false };
+            const lines = triples.map((t) => `(${t.subject}, ${t.predicate}, ${t.object}) [${t.scope}, confidence ${t.confidence}, ${t.createdAt.slice(0, 10)}]`);
+            return { output: `${triples.length} fact(s):\n${lines.join('\n')}`, isError: false };
+        }
+        catch (e) {
+            return { output: `Error querying: ${e instanceof Error ? e.message : e}`, isError: true };
+        }
+    },
+};
+// Convenience export for the tool registry
+export const MEMORY_TOOLS = [
+    MemorySearchTool,
+    MemoryRecallTool,
+    MemoryAddTool,
+    MemoryLinkTool,
+    MemoryListTool,
+    MemoryFactAddTool,
+    MemoryFactQueryTool,
+];
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/types.d.ts

@@ -22,6 +22,12 @@ export interface CrowcoderConfig {
     palette?: string;
     showThinking?: boolean;
     voice?: VoiceConfig;
+    memory?: MemoryConfig;
+}
+export interface MemoryConfig {
+    enabled?: boolean;
+    globalScope?: boolean;
+    projectScope?: boolean;
 }
 export interface VoiceConfig {
     enabled?: boolean;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmFA,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,SAAS,EAAE;QACT,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,+BAA+B;QACxC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,IAAI;KAClB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,8BAA8B;QACvC,YAAY,EAAE,2BAA2B;QACzC,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,0DAA0D;QACnE,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,IAAI;KAClB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,6BAA6B;QACtC,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE,KAAK;KACnB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,0BAA0B;QACnC,YAAY,EAAE,cAAc;QAC5B,WAAW,EAAE,KAAK;KACnB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,sCAAsC;QAC/C,YAAY,EAAE,YAAY;QAC1B,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,IAAI;KAClB;CACF,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA+FA,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,SAAS,EAAE;QACT,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,+BAA+B;QACxC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,IAAI;KAClB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,8BAA8B;QACvC,YAAY,EAAE,2BAA2B;QACzC,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,0DAA0D;QACnE,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,IAAI;KAClB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,6BAA6B;QACtC,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE,KAAK;KACnB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,0BAA0B;QACnC,YAAY,EAAE,cAAc;QAC5B,WAAW,EAAE,KAAK;KACnB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,sCAAsC;QAC/C,YAAY,EAAE,YAAY;QAC1B,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,IAAI;KAClB;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compact-agent",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "A dense, feature-rich AI coding agent for the terminal. Built-in voice dictation (Whisper) + TTS readout (ElevenLabs) + screen-reader mode for blind / low-vision users. 80+ slash commands, 9 modes including Hermes self-improving loop, multi-agent orchestration, bundled everything-claude-code skills library, learning system, and observable LLM transport. Works with OpenRouter, OpenAI, Anthropic-compatible, Ollama, LM Studio, DeepSeek, or any OpenAI-compatible API.",
   "type": "module",
   "license": "MIT",
@@ -29,7 +29,10 @@
     "tts",
     "screen-reader",
     "dictation",
-    "blind"
+    "blind",
+    "memory",
+    "mempalace",
+    "knowledge-graph"
   ],
   "bin": {
     "compact-agent": "./bin/crowcoder.js"