compact-agent 1.9.0 → 1.10.1

package/dist/mempalace/store.js

@@ -0,0 +1,332 @@
+/**
+ * MemPalace storage layer.
+ *
+ * Each store is a single JSON file written atomically (tmp file + rename)
+ * so a crashed write can't corrupt the existing state. The choice of JSON-
+ * over-SQLite is deliberate for v1: zero native dependencies, trivial to
+ * inspect by hand, no migration story needed for npm-published CLI.
+ *
+ * The Store interface is the swappable seam — when we outgrow JSON (>~10k
+ * drawers, slow search) we replace the implementation with SQLite/FTS5 or
+ * a vector store without touching callers.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { randomBytes } from 'node:crypto';
+import { SCHEMA_VERSION } from './types.js';
+import { searchDrawers } from './search.js';
+// ── Paths ─────────────────────────────────────────────────
+/** ~/.crowcoder/memory/store.json — cross-project knowledge */
+export function globalStorePath() {
+    return join(homedir(), '.crowcoder', 'memory', 'store.json');
+}
+/** <cwd>/.crowcoder/memory/store.json — per-repo knowledge */
+export function projectStorePath(cwd) {
+    return join(cwd, '.crowcoder', 'memory', 'store.json');
+}
+// ── ID generation ─────────────────────────────────────────
+/**
+ * Time-ordered ID: hex timestamp + 8 random hex chars. Sorts naturally by
+ * creation time, no UUID library needed. ~96 bits of entropy total which
+ * is overkill for a single-user store but keeps collision chances at
+ * effective zero even across machines.
+ */
+export function newId(prefix) {
+    const ts = Date.now().toString(16).padStart(11, '0');
+    const rand = randomBytes(4).toString('hex');
+    return `${prefix}_${ts}${rand}`;
+}
+// ── Atomic JSON read/write ────────────────────────────────
+function readState(path) {
+    if (!existsSync(path)) {
+        return { schemaVersion: SCHEMA_VERSION, drawers: [], tunnels: [], triples: [] };
+    }
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        // Defensive: future schema migrations would dispatch on parsed.schemaVersion here
+        return {
+            schemaVersion: parsed.schemaVersion ?? SCHEMA_VERSION,
+            drawers: parsed.drawers ?? [],
+            tunnels: parsed.tunnels ?? [],
+            triples: parsed.triples ?? [],
+        };
+    }
+    catch {
+        // Corrupted store — log and return empty so we don't crash the agent.
+        // The bad file is preserved alongside as .corrupt for forensic recovery.
+        try {
+            renameSync(path, path + '.corrupt-' + Date.now());
+        }
+        catch { /* noop */ }
+        return { schemaVersion: SCHEMA_VERSION, drawers: [], tunnels: [], triples: [] };
+    }
+}
+function writeState(path, state) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = path + '.tmp-' + process.pid;
+    writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf-8');
+    try {
+        renameSync(tmp, path);
+    }
+    catch (e) {
+        // On some Windows filesystems renaming over an existing file can fail.
+        // Fall back to unlink + rename.
+        try {
+            unlinkSync(path);
+        }
+        catch { /* noop */ }
+        renameSync(tmp, path);
+    }
+}
+// ── Store class ───────────────────────────────────────────
+/**
+ * A single-file MemPalace store backed by JSON. Mutations are immediately
+ * persisted to disk — there's no in-memory cache to flush. Trades a small
+ * amount of throughput for crash safety, which matters more for a memory
+ * system.
+ */
+export class JsonStore {
+    path;
+    scope;
+    constructor(path, scope) {
+        this.path = path;
+        this.scope = scope;
+    }
+    read() { return readState(this.path); }
+    write(s) { writeState(this.path, s); }
+    // ── Drawers ───────────────────────────────────────────
+    addDrawer(input) {
+        const now = new Date().toISOString();
+        const drawer = {
+            id: newId('drw'),
+            createdAt: now,
+            updatedAt: now,
+            scope: this.scope,
+            ...input,
+            // Defensive normalization
+            tags: (input.tags || []).map((t) => t.toLowerCase().trim()).filter(Boolean),
+            importance: clamp01(input.importance ?? 0.5),
+            wing: input.wing.toLowerCase().trim(),
+            room: input.room.toLowerCase().trim(),
+        };
+        const state = this.read();
+        state.drawers.push(drawer);
+        this.write(state);
+        return drawer;
+    }
+    getDrawer(id) {
+        return this.read().drawers.find((d) => d.id === id) || null;
+    }
+    updateDrawer(id, patch) {
+        const state = this.read();
+        const idx = state.drawers.findIndex((d) => d.id === id);
+        if (idx < 0)
+            return null;
+        const updated = {
+            ...state.drawers[idx],
+            ...patch,
+            updatedAt: new Date().toISOString(),
+            tags: patch.tags
+                ? patch.tags.map((t) => t.toLowerCase().trim()).filter(Boolean)
+                : state.drawers[idx].tags,
+            importance: patch.importance !== undefined ? clamp01(patch.importance) : state.drawers[idx].importance,
+        };
+        state.drawers[idx] = updated;
+        this.write(state);
+        return updated;
+    }
+    deleteDrawer(id) {
+        const state = this.read();
+        const before = state.drawers.length;
+        state.drawers = state.drawers.filter((d) => d.id !== id);
+        // Cascade: drop tunnels touching this drawer + triples sourced from it
+        state.tunnels = state.tunnels.filter((t) => t.fromDrawerId !== id && t.toDrawerId !== id);
+        state.triples = state.triples.filter((t) => t.sourceDrawerId !== id);
+        const removed = state.drawers.length < before;
+        if (removed)
+            this.write(state);
+        return removed;
+    }
+    listDrawers(filter = {}) {
+        let drawers = this.read().drawers;
+        if (filter.wing)
+            drawers = drawers.filter((d) => d.wing === filter.wing.toLowerCase());
+        if (filter.room)
+            drawers = drawers.filter((d) => d.room === filter.room.toLowerCase());
+        if (filter.tag)
+            drawers = drawers.filter((d) => d.tags.includes(filter.tag.toLowerCase()));
+        return drawers;
+    }
+    // ── Wings + Rooms (derived views) ─────────────────────
+    listWings() {
+        const drawers = this.read().drawers;
+        const byWing = new Map();
+        for (const d of drawers) {
+            const entry = byWing.get(d.wing) ?? { rooms: new Set(), count: 0 };
+            entry.rooms.add(d.room);
+            entry.count++;
+            byWing.set(d.wing, entry);
+        }
+        return [...byWing.entries()]
+            .map(([name, v]) => ({ name, rooms: [...v.rooms].sort(), drawerCount: v.count }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    listRooms(wing) {
+        const drawers = this.read().drawers;
+        const filtered = wing ? drawers.filter((d) => d.wing === wing.toLowerCase()) : drawers;
+        const byRoom = new Map();
+        for (const d of filtered) {
+            const key = `${d.wing}/${d.room}`;
+            const entry = byRoom.get(key) ?? { wing: d.wing, count: 0, lastTouched: d.updatedAt };
+            entry.count++;
+            if (d.updatedAt > entry.lastTouched)
+                entry.lastTouched = d.updatedAt;
+            byRoom.set(key, entry);
+        }
+        return [...byRoom.entries()]
+            .map(([key, v]) => ({
+            wing: v.wing,
+            name: key.split('/')[1],
+            drawerCount: v.count,
+            lastTouched: v.lastTouched,
+        }))
+            .sort((a, b) => b.lastTouched.localeCompare(a.lastTouched));
+    }
+    // ── Tunnels (drawer relationships) ────────────────────
+    addTunnel(fromDrawerId, toDrawerId, relation) {
+        const tunnel = {
+            id: newId('tun'),
+            fromDrawerId,
+            toDrawerId,
+            relation: relation.toLowerCase().trim(),
+            createdAt: new Date().toISOString(),
+            scope: this.scope,
+        };
+        const state = this.read();
+        state.tunnels.push(tunnel);
+        this.write(state);
+        return tunnel;
+    }
+    /**
+     * Find all tunnels touching a drawer, in either direction. Useful for
+     * "what is this drawer related to?" queries.
+     */
+    findTunnels(drawerId) {
+        const tunnels = this.read().tunnels;
+        return {
+            outgoing: tunnels.filter((t) => t.fromDrawerId === drawerId),
+            incoming: tunnels.filter((t) => t.toDrawerId === drawerId),
+        };
+    }
+    /**
+     * Walk outgoing tunnels from a start drawer for up to maxDepth hops,
+     * returning every drawer reached and the path that got us there.
+     * Bounded by visited-set so cycles don't loop forever.
+     */
+    traverse(startId, maxDepth = 3) {
+        const state = this.read();
+        const drawerById = new Map(state.drawers.map((d) => [d.id, d]));
+        const tunnelsByFrom = new Map();
+        for (const t of state.tunnels) {
+            const arr = tunnelsByFrom.get(t.fromDrawerId) ?? [];
+            arr.push(t);
+            tunnelsByFrom.set(t.fromDrawerId, arr);
+        }
+        const visited = new Set();
+        const results = [];
+        const queue = [{ id: startId, depth: 0, via: [] }];
+        while (queue.length > 0) {
+            const cur = queue.shift();
+            if (visited.has(cur.id))
+                continue;
+            visited.add(cur.id);
+            const drawer = drawerById.get(cur.id);
+            if (drawer && cur.depth > 0) {
+                results.push({ drawer, depth: cur.depth, via: cur.via });
+            }
+            if (cur.depth >= maxDepth)
+                continue;
+            const outgoing = tunnelsByFrom.get(cur.id) ?? [];
+            for (const t of outgoing) {
+                if (!visited.has(t.toDrawerId)) {
+                    queue.push({ id: t.toDrawerId, depth: cur.depth + 1, via: [...cur.via, t.relation] });
+                }
+            }
+        }
+        return results;
+    }
+    deleteTunnel(id) {
+        const state = this.read();
+        const before = state.tunnels.length;
+        state.tunnels = state.tunnels.filter((t) => t.id !== id);
+        const removed = state.tunnels.length < before;
+        if (removed)
+            this.write(state);
+        return removed;
+    }
+    // ── Knowledge graph triples ───────────────────────────
+    addTriple(t) {
+        const triple = {
+            ...t,
+            id: newId('kg'),
+            createdAt: new Date().toISOString(),
+            scope: this.scope,
+            confidence: clamp01(t.confidence ?? 1.0),
+        };
+        const state = this.read();
+        state.triples.push(triple);
+        this.write(state);
+        return triple;
+    }
+    /**
+     * Query triples with optional s/p/o filters. Any field left undefined
+     * acts as a wildcard. Matching is case-insensitive equality on each
+     * specified field.
+     */
+    queryTriples(q) {
+        const triples = this.read().triples;
+        const lc = (s) => s?.toLowerCase();
+        const s = lc(q.subject);
+        const p = lc(q.predicate);
+        const o = lc(q.object);
+        return triples.filter((t) => (s === undefined || t.subject.toLowerCase() === s) &&
+            (p === undefined || t.predicate.toLowerCase() === p) &&
+            (o === undefined || t.object.toLowerCase() === o));
+    }
+    /** Most-recent triples first. For "what have I been learning?" views. */
+    recentTriples(limit = 20) {
+        return [...this.read().triples]
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt))
+            .slice(0, limit);
+    }
+    // ── Search ────────────────────────────────────────────
+    search(query, opts = {}) {
+        const drawers = this.read().drawers;
+        return searchDrawers(drawers, query, opts);
+    }
+    // ── Stats ─────────────────────────────────────────────
+    stats() {
+        const state = this.read();
+        const wings = new Set(state.drawers.map((d) => d.wing));
+        const rooms = new Set(state.drawers.map((d) => `${d.wing}/${d.room}`));
+        return {
+            drawers: state.drawers.length,
+            tunnels: state.tunnels.length,
+            triples: state.triples.length,
+            wings: wings.size,
+            rooms: rooms.size,
+        };
+    }
+}
+function clamp01(n) {
+    if (Number.isNaN(n))
+        return 0.5;
+    if (n < 0)
+        return 0;
+    if (n > 1)
+        return 1;
+    return n;
+}
+//# sourceMappingURL=store.js.map

package/dist/mempalace/store.js.map

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

package/dist/mempalace/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * MemPalace data model — TypeScript port of the core MemPalace concepts.
+ *
+ * Mental model:
+ *
+ *   Wing     ─ a top-level domain ("projects", "people", "code", "wisdom")
+ *   Room     ─ a category inside a wing ("crowcoder", "abc-reborn", ...)
+ *   Drawer   ─ an individual memory item: a chunk of text + tags + metadata
+ *   Tunnel   ─ a directed link between two drawers, typed by relation
+ *   Triple   ─ a knowledge-graph fact: (subject, predicate, object)
+ *
+ * Drawers are the atomic unit of memory. Wings + rooms give them addressable
+ * structure. Tunnels and KG triples give them relational structure.
+ *
+ * Two stores live side-by-side:
+ *   GLOBAL   ~/.crowcoder/memory/    cross-project knowledge (user prefs,
+ *                                    recurring patterns, skills)
+ *   PROJECT  <cwd>/.crowcoder/memory/  this-codebase-specific (e.g. "build
+ *                                    is broken because X", "the queue lives
+ *                                    in services/queue/...")
+ *
+ * The agent picks which store to query based on the request. User-modeling
+ * queries hit global; codebase queries hit project. Search APIs accept a
+ * Scope hint or 'both' to search across.
+ */
+/**
+ * Which memory store an operation targets.
+ *
+ *   'global'  — ~/.crowcoder/memory/ (cross-project)
+ *   'project' — <cwd>/.crowcoder/memory/ (per-repo)
+ *   'both'    — search both; writes pick based on content (global for user
+ *               preferences, project for codebase facts)
+ */
+export type Scope = 'global' | 'project' | 'both';
+/**
+ * A drawer is one memory item — a chunk of text living at wing/room. Tags
+ * are free-form lowercase strings used for filtering. Importance is a 0–1
+ * heuristic the agent or user can set to bias search ordering.
+ */
+export interface Drawer {
+    id: string;
+    wing: string;
+    room: string;
+    content: string;
+    tags: string[];
+    importance: number;
+    createdAt: string;
+    updatedAt: string;
+    scope: Scope;
+    sourceSessionId?: string;
+}
+/**
+ * Convenience metadata about a wing — populated by `listWings` for UI/
+ * status output. Not stored separately; derived from drawer counts.
+ */
+export interface WingMeta {
+    name: string;
+    rooms: string[];
+    drawerCount: number;
+}
+/**
+ * Same for rooms.
+ */
+export interface RoomMeta {
+    wing: string;
+    name: string;
+    drawerCount: number;
+    lastTouched: string;
+}
+/**
+ * A tunnel is a directed link from one drawer to another with a labelled
+ * relation. Use cases:
+ *   - "drawer A inspired drawer B" (relation: "inspired")
+ *   - "drawer A supersedes drawer B" (relation: "supersedes")
+ *   - "drawer A is part of drawer B's project" (relation: "in-project")
+ *
+ * Bidirectional traversal is supported by following tunnels in reverse.
+ */
+export interface Tunnel {
+    id: string;
+    fromDrawerId: string;
+    toDrawerId: string;
+    relation: string;
+    createdAt: string;
+    scope: Scope;
+}
+/**
+ * A knowledge-graph triple — semantic-web style. Stored separately from
+ * drawers because triples express *facts* (small, atomic, queryable in
+ * aggregate) whereas drawers express *content* (larger, narrative).
+ *
+ * Example: ("rsfit", "owns", "Crowcoder") or ("compact-agent", "uses",
+ * "OpenRouter").
+ */
+export interface KGTriple {
+    id: string;
+    subject: string;
+    predicate: string;
+    object: string;
+    confidence: number;
+    sourceDrawerId?: string;
+    sourceSessionId?: string;
+    createdAt: string;
+    scope: Scope;
+}
+/**
+ * Internal disk schema. One JSON file per store containing all drawers,
+ * tunnels, and triples. Simple, atomic-write-via-rename safe.
+ *
+ * For very large stores (>10k drawers) this approach will get slow; the
+ * intent is to swap to SQLite/FTS5 later behind the same Store interface.
+ */
+export interface StoreState {
+    schemaVersion: number;
+    drawers: Drawer[];
+    tunnels: Tunnel[];
+    triples: KGTriple[];
+}
+export declare const SCHEMA_VERSION = 1;
+/**
+ * Search options shared across query APIs.
+ */
+export interface SearchOptions {
+    scope?: Scope;
+    wing?: string;
+    room?: string;
+    tags?: string[];
+    limit?: number;
+    minImportance?: number;
+}
+/**
+ * A scored search hit — the drawer plus the relevance score the search
+ * function computed. Higher = more relevant. Score is unitless; only
+ * meaningful for ordering, not absolute comparison.
+ */
+export interface SearchHit {
+    drawer: Drawer;
+    score: number;
+    matchedFields: ('content' | 'tags' | 'wing' | 'room')[];
+}

package/dist/mempalace/types.js

@@ -0,0 +1,27 @@
+/**
+ * MemPalace data model — TypeScript port of the core MemPalace concepts.
+ *
+ * Mental model:
+ *
+ *   Wing     ─ a top-level domain ("projects", "people", "code", "wisdom")
+ *   Room     ─ a category inside a wing ("crowcoder", "abc-reborn", ...)
+ *   Drawer   ─ an individual memory item: a chunk of text + tags + metadata
+ *   Tunnel   ─ a directed link between two drawers, typed by relation
+ *   Triple   ─ a knowledge-graph fact: (subject, predicate, object)
+ *
+ * Drawers are the atomic unit of memory. Wings + rooms give them addressable
+ * structure. Tunnels and KG triples give them relational structure.
+ *
+ * Two stores live side-by-side:
+ *   GLOBAL   ~/.crowcoder/memory/    cross-project knowledge (user prefs,
+ *                                    recurring patterns, skills)
+ *   PROJECT  <cwd>/.crowcoder/memory/  this-codebase-specific (e.g. "build
+ *                                    is broken because X", "the queue lives
+ *                                    in services/queue/...")
+ *
+ * The agent picks which store to query based on the request. User-modeling
+ * queries hit global; codebase queries hit project. Search APIs accept a
+ * Scope hint or 'both' to search across.
+ */
+export const SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/mempalace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mempalace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA6GH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/system-prompt.js

@@ -96,6 +96,34 @@ ${fileList ? `- Files in cwd: ${fileList}` : ''}
 # Available Tools (these and ONLY these — do not invent tool names)
 ${buildToolList()}
 
+${config.memory?.enabled !== false ? `# Memory (MemPalace) — when to use the memory_* tools
+
+This agent has a persistent memory subsystem with two scopes:
+  - **global** memory at ~/.crowcoder/memory/ — cross-project: user preferences,
+    style choices, recurring patterns, identity
+  - **project** memory at <cwd>/.crowcoder/memory/ — this-codebase-specific:
+    landmarks ("auth lives in src/auth"), gotchas, decisions
+
+You have these memory tools available:
+  - **memory_search** — ALWAYS check before proposing something the user may
+    have told you before. If a search hits, recall + use the existing fact
+    instead of asking again.
+  - **memory_recall** — fetch a specific drawer's full content by id
+  - **memory_add** — save a NEW drawer when the user states a durable fact:
+    a preference ("I always use vitest"), a codebase landmark ("the queue
+    lives in services/queue/"), or a lesson worth keeping across sessions.
+    Use scope:"auto" by default — the system infers global vs project from
+    content signals.
+  - **memory_link** — connect related drawers (sparingly; only when the
+    relationship will be useful for later traversal)
+  - **memory_list** — orient yourself: what wings/rooms exist
+  - **memory_fact_add / memory_fact_query** — for atomic (subject, predicate,
+    object) facts you want to query in aggregate later
+
+Be conservative — don't write a drawer for every passing comment. Write
+when the user makes a STATEMENT OF FACT or PREFERENCE that you'd benefit
+from knowing in a future session. Quality > quantity.` : ''}
+
 # Turn semantics — read carefully
 Each user message is an INDEPENDENT request. Conversation history is a record
 of past requests that are ALREADY DONE. Specifically:

package/dist/system-prompt.js.map

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

package/dist/tools/index.js

@@ -9,11 +9,19 @@ import { WebSearchTool } from './web-search.js';
 import { ListDirTool } from './list-dir.js';
 import { StitchTool } from './stitch.js';
 import { stitchConfigured } from '../stitch.js';
+import { MEMORY_TOOLS } from './memory.js';
+import { isMemoryEnabled } from '../mempalace/index.js';
 // Stitch is only listed in the tool registry when configured — otherwise
 // free models hallucinate calls to it and waste turns on auth errors.
 const OPTIONAL_TOOLS = [];
 if (stitchConfigured())
     OPTIONAL_TOOLS.push(StitchTool);
+// MemPalace memory tools — only registered when the user enabled the
+// feature (default true). Disabling it during the setup wizard or via
+// /memory disable removes them from the registry entirely so the model
+// doesn't see them at all (no wasted tokens advertising tools it can't
+// use, no risk of the model hallucinating memory calls).
+const MEMORY_TOOLS_IF_ENABLED = isMemoryEnabled() ? MEMORY_TOOLS : [];
 export const ALL_TOOLS = [
     BashTool,
     ReadTool,
@@ -24,6 +32,7 @@ export const ALL_TOOLS = [
     ListDirTool,
     WebFetchTool,
     WebSearchTool,
+    ...MEMORY_TOOLS_IF_ENABLED,
     ...OPTIONAL_TOOLS,
 ];
 export function getToolNames() {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,yEAAyE;AACzE,sEAAsE;AACtE,MAAM,cAAc,GAAW,EAAE,CAAC;AAClC,IAAI,gBAAgB,EAAE;IAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,aAAa;IACb,GAAG,cAAc;CAClB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,yEAAyE;AACzE,sEAAsE;AACtE,MAAM,cAAc,GAAW,EAAE,CAAC;AAClC,IAAI,gBAAgB,EAAE;IAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAExD,qEAAqE;AACrE,sEAAsE;AACtE,uEAAuE;AACvE,uEAAuE;AACvE,yDAAyD;AACzD,MAAM,uBAAuB,GAAW,eAAe,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,aAAa;IACb,GAAG,uBAAuB;IAC1B,GAAG,cAAc;CAClB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 type { Tool } from './types.js';
+export declare const MemoryAddTool: Tool;
+export declare const MemorySearchTool: Tool;
+export declare const MemoryRecallTool: Tool;
+export declare const MemoryLinkTool: Tool;
+export declare const MemoryListTool: Tool;
+export declare const MemoryFactAddTool: Tool;
+export declare const MemoryFactQueryTool: Tool;
+export declare const MEMORY_TOOLS: Tool[];