@burtson-labs/host-kit 0.3.1

package/dist/tools/extraTools.js

@@ -0,0 +1,471 @@
+"use strict";
+/**
+ * Extra tools layered onto the core ToolRegistry for the CLI host:
+ * - todo_write: in-agent todo tracking, persisted in-memory for the session
+ * - web_fetch: GET a URL and return a trimmed text body
+ * - web_search: query a search API (Tavily), return ranked snippets
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoStore = void 0;
+exports.buildTodoWriteTool = buildTodoWriteTool;
+exports.buildRememberTool = buildRememberTool;
+exports.isPrivateHost = isPrivateHost;
+exports.buildWebFetchTool = buildWebFetchTool;
+exports.buildWebSearchTool = buildWebSearchTool;
+const node_dns_1 = require("node:dns");
+const node_net_1 = require("node:net");
+const memory_1 = require("../memory");
+/**
+ * Models don't agree on status vocabulary — some emit `"done"`, others
+ * `"complete"`, `"completed"`, `"in-progress"`, `"inprogress"`, etc.
+ * Normalize to the three statuses the store actually stores so the UI
+ * (which only knows `done` / `in_progress` / `pending`) reliably ticks
+ * items off. Without this, a model saying `"complete"` leaves items
+ * visually stuck on `○` forever despite the plan advancing.
+ */
+function normalizeStatus(raw) {
+    const s = typeof raw === 'string' ? raw.trim().toLowerCase().replace(/[-\s]/g, '_') : '';
+    if (s === 'done' || s === 'complete' || s === 'completed' || s === 'finished')
+        return 'done';
+    if (s === 'in_progress' || s === 'inprogress' || s === 'active' || s === 'working' || s === 'running')
+        return 'in_progress';
+    return 'pending';
+}
+class TodoStore {
+    constructor() {
+        this.items = [];
+        this.nextId = 1;
+    }
+    snapshot() {
+        return [...this.items];
+    }
+    render() {
+        if (this.items.length === 0)
+            return '(no todos)';
+        return this.items
+            .map(t => {
+            const mark = t.status === 'done' ? '[x]' : t.status === 'in_progress' ? '[~]' : '[ ]';
+            return `${mark} ${t.id}. ${t.content}`;
+        })
+            .join('\n');
+    }
+    /**
+     * Accepts a JSON array of { content, status? } to replace the list, or a
+     * single string 'content' for append. Simple to be forgiving of small models.
+     */
+    upsert(raw) {
+        const trimmed = raw.trim();
+        if (!trimmed)
+            return 'No todo payload provided.';
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                // Small models (Qwen 2.5 Coder on S3Api
+                // turn) sometimes pass a bare string array — ["Read X", "Edit Y"]
+                // — instead of the documented [{content, status}] shape. Treat
+                // each string as a pending todo with its content equal to the
+                // string. Previous code did String(undefined ?? '') here and
+                // rendered N empty bullets in the Plan block.
+                //
+                // Mark 2026-05-26: when the tool was declared with `type: string`,
+                // the agent-core parser stringified each nested {content,status}
+                // object on the way in. The array branch then saw a list of
+                // JSON-SHAPED STRINGS like '{"content":"Install TypeScript",
+                // "status":"done"}' and the string branch below set content
+                // to the whole JSON dump — Plan rendered raw JSON instead of
+                // a clean checklist. We now detect JSON-object-shaped strings
+                // and re-parse them so the legacy path (and any provider that
+                // still stringifies nested values) recovers the right shape.
+                this.items = parsed.map((entry, i) => {
+                    if (typeof entry === 'string') {
+                        const candidate = entry.trim();
+                        if (candidate.startsWith('{') && candidate.endsWith('}')) {
+                            try {
+                                const obj = JSON.parse(candidate);
+                                if (obj && typeof obj === 'object' && typeof obj.content === 'string') {
+                                    return {
+                                        id: i + 1,
+                                        status: normalizeStatus(obj.status),
+                                        content: obj.content,
+                                    };
+                                }
+                            }
+                            catch {
+                                /* fall through to bare-string treatment */
+                            }
+                        }
+                        return { id: i + 1, status: 'pending', content: entry };
+                    }
+                    return {
+                        id: i + 1,
+                        status: normalizeStatus(entry?.status),
+                        content: String(entry?.content ?? '')
+                    };
+                });
+                this.nextId = this.items.length + 1;
+                return `Todo list updated (${this.items.length} items).`;
+            }
+            if (parsed && typeof parsed === 'object' && typeof parsed.content === 'string') {
+                this.items.push({ id: this.nextId++, status: normalizeStatus(parsed.status), content: parsed.content });
+                return `Added todo #${this.items.length}.`;
+            }
+        }
+        catch {
+            // Fall through: treat as plain text append.
+        }
+        this.items.push({ id: this.nextId++, status: 'pending', content: trimmed });
+        return `Added todo #${this.items.length}.`;
+    }
+    /**
+     * A short progress summary the tool returns so the model reads a
+     * clear "update succeeded, here's what's left" signal instead of
+     * interpreting the echoed list as a reset. The trailing nudge is
+     * deliberately blunt — bandit-core-1 and similar small models have
+     * been observed to claim completion without invoking the write
+     * tool, and this helper is the most direct place to remind the
+     * model of the expectation between tool calls.
+     */
+    summary() {
+        const done = this.items.filter(t => t.status === 'done').length;
+        const inProgress = this.items.filter(t => t.status === 'in_progress').length;
+        const pending = this.items.filter(t => t.status === 'pending');
+        if (this.items.length === 0)
+            return '';
+        const nextPending = pending[0];
+        const pieces = [
+            `${done} of ${this.items.length} complete`,
+            inProgress > 0 ? `${inProgress} in progress` : null,
+            nextPending ? `next: "${nextPending.content}"` : null
+        ].filter(Boolean);
+        const status = pieces.join(' · ');
+        if (done === this.items.length) {
+            return `\n\n${status}. Before finalizing, verify the work is actually complete — a todo marked "done" is not proof the underlying change was made.`;
+        }
+        return `\n\n${status}. Continue the task — DO NOT claim completion in your response until the underlying work (write_file / apply_edit / replace_range / run_command) has actually executed.`;
+    }
+}
+exports.TodoStore = TodoStore;
+function buildTodoWriteTool(store) {
+    return {
+        name: 'todo_write',
+        description: 'Track progress on the current task. Pass an array of {content, status} objects to replace the list, or a plain string to append one item. Call this whenever you change plans or finish a step.',
+        parameters: [
+            {
+                name: 'items',
+                description: 'Array of {content, status} objects, where status is one of "pending" | "in_progress" | "done". Send a real array — do NOT pre-stringify the objects.',
+                required: true,
+                schema: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            content: { type: 'string', description: 'The todo item text shown to the user.' },
+                            status: {
+                                type: 'string',
+                                description: 'One of "pending" | "in_progress" | "done".',
+                                enum: ['pending', 'in_progress', 'done'],
+                            },
+                        },
+                        required: ['content'],
+                    },
+                },
+            }
+        ],
+        async execute(params, _ctx) {
+            // params.items may arrive as a real array (native-tools providers
+            // honouring the schema), a JSON string (text-tool-loop tool_call
+            // parser), or undefined. The interface types params as
+            // Record<string,string> but the agent runtime delivers richer
+            // shapes when the param schema declares them — cast and normalize.
+            // Normalize to a JSON string so the existing store.upsert()
+            // text-based parsing keeps working unchanged; if a richer-shaped
+            // array arrives, JSON.stringify round-trips it cleanly.
+            const raw = params.items;
+            const serialized = typeof raw === 'string'
+                ? raw
+                : raw === undefined || raw === null
+                    ? ''
+                    : JSON.stringify(raw);
+            const header = store.upsert(serialized);
+            const summary = store.summary();
+            return { output: `${header}\n\n${store.render()}${summary}`, isError: false };
+        }
+    };
+}
+/**
+ * `remember` tool — persists a single fact to the workspace's BANDIT.md
+ * so it survives across sessions. Use case: the user says "remember
+ * that all my repos live in ~/Documents/GitHub" and wants the next
+ * Bandit session to know that without being re-told.
+ *
+ * Why a dedicated tool instead of asking the model to apply_edit
+ * BANDIT.md directly: small models (gemma4:e4b, qwen 4B) hallucinated
+ * the existing file contents when invited to edit it, and even on
+ * larger models the apply_edit dance for "append a bullet" was
+ * comically inefficient (4-5 turns minimum). This is one tool call
+ * with a single string parameter — same shape as todo_write.
+ *
+ * on the CLI: user said "you should add to your
+ * memory where my repos are", model used `todo_write` thinking it was
+ * the persistence mechanism, nothing actually landed on disk and the
+ * next session knew nothing.
+ */
+function buildRememberTool() {
+    return {
+        name: 'remember',
+        description: 'Persist a single fact to project memory (BANDIT.md at the workspace root) so it survives across sessions. Use this when the user says "remember X", "always do Y", "note that I", or otherwise asks for cross-session persistence — NOT for transient task tracking (use `todo_write` for that). One bullet per call. Examples: "All repos live in ~/Documents/GitHub", "Prefer pnpm over npm", "Local Ollama at http://k3s.lan:11434".',
+        parameters: [
+            { name: 'fact', description: 'The single fact to remember. Will be appended as a bullet under the "## Notes" heading in BANDIT.md (file is created with a minimal scaffold if missing).', required: true }
+        ],
+        async execute(params, ctx) {
+            const fact = (params.fact ?? '').trim();
+            if (!fact)
+                return { output: 'Error: fact parameter is required and must be a non-empty string.', isError: true };
+            try {
+                const abs = await (0, memory_1.appendMemory)(ctx.workspaceRoot, fact);
+                return { output: `Saved to project memory: "${fact}"\n\nPersisted to ${abs}. The next Bandit session in this workspace will load this automatically.` };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { output: `Could not write to BANDIT.md: ${msg}`, isError: true };
+            }
+        }
+    };
+}
+/**
+ * SSRF guard for web_fetch — resolves the URL's hostname and refuses to
+ * proceed if it lands on a private/loopback/link-local address. This is
+ * the difference between "agent can read public docs" and "attacker prompt
+ * tricks agent into hitting http://169.254.169.254/latest/meta-data/ or
+ * http://localhost:6443 on the user's box."
+ *
+ * Set BANDIT_ALLOW_PRIVATE_WEB_FETCH=1 to opt out — appropriate when the
+ * user is intentionally pointing the agent at internal docs.
+ */
+const PRIVATE_HOSTNAMES = new Set(['localhost', 'ip6-localhost', 'ip6-loopback']);
+function isPrivateIPv4(ip) {
+    const parts = ip.split('.').map((p) => Number(p));
+    if (parts.length !== 4 || parts.some((p) => !Number.isInteger(p) || p < 0 || p > 255))
+        return false;
+    const [a, b] = parts;
+    if (a === 0)
+        return true; // 0.0.0.0/8 — "this network"
+    if (a === 10)
+        return true; // 10.0.0.0/8 — RFC1918
+    if (a === 127)
+        return true; // 127.0.0.0/8 — loopback
+    if (a === 169 && b === 254)
+        return true; // 169.254.0.0/16 — link-local (cloud metadata)
+    if (a === 172 && b >= 16 && b <= 31)
+        return true; // 172.16.0.0/12 — RFC1918
+    if (a === 192 && b === 168)
+        return true; // 192.168.0.0/16 — RFC1918
+    if (a === 100 && b >= 64 && b <= 127)
+        return true; // 100.64.0.0/10 — CGNAT (often internal)
+    return false;
+}
+function isPrivateIPv6(ip) {
+    const lower = ip.toLowerCase();
+    if (lower === '::1' || lower === '::')
+        return true;
+    // IPv4-mapped IPv6 (::ffff:a.b.c.d) — re-check the embedded IPv4.
+    const mapped = lower.match(/^::ffff:([0-9.]+)$/);
+    if (mapped && (0, node_net_1.isIP)(mapped[1]) === 4)
+        return isPrivateIPv4(mapped[1]);
+    if (/^f[cd][0-9a-f]{2}:/.test(lower))
+        return true; // fc00::/7 — Unique Local
+    if (/^fe[89ab][0-9a-f]:/.test(lower))
+        return true; // fe80::/10 — link-local
+    return false;
+}
+async function isPrivateHost(hostname) {
+    // Node's URL.hostname returns IPv6 literals WITH brackets (e.g. "[::1]").
+    // Strip them so isIP() classifies the address and DNS doesn't try to
+    // resolve a bracketed string.
+    const stripped = hostname.startsWith('[') && hostname.endsWith(']')
+        ? hostname.slice(1, -1)
+        : hostname;
+    const lower = stripped.toLowerCase();
+    if (PRIVATE_HOSTNAMES.has(lower))
+        return true;
+    const family = (0, node_net_1.isIP)(stripped);
+    if (family === 4)
+        return isPrivateIPv4(stripped);
+    if (family === 6)
+        return isPrivateIPv6(stripped);
+    try {
+        const records = await node_dns_1.promises.lookup(stripped, { all: true, verbatim: true });
+        for (const rec of records) {
+            if (rec.family === 4 && isPrivateIPv4(rec.address))
+                return true;
+            if (rec.family === 6 && isPrivateIPv6(rec.address))
+                return true;
+        }
+        return false;
+    }
+    catch {
+        // DNS resolution failure isn't itself a security signal — let fetch
+        // report the network error so the model sees a normal failure path.
+        return false;
+    }
+}
+function buildWebFetchTool() {
+    return {
+        name: 'web_fetch',
+        description: 'HTTP GET a URL and return a trimmed plaintext body (up to ~16 KB). Use for docs, RFCs, release notes. No JS execution, no auth.',
+        parameters: [
+            { name: 'url', description: 'Absolute http(s) URL', required: true }
+        ],
+        async execute(params, _ctx) {
+            const raw = params.url?.trim();
+            if (!raw)
+                return { output: 'Missing url parameter.', isError: true };
+            let url;
+            try {
+                url = new URL(raw);
+            }
+            catch {
+                return { output: `Invalid URL: ${raw}`, isError: true };
+            }
+            if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+                return { output: `Unsupported protocol: ${url.protocol}`, isError: true };
+            }
+            if (process.env.BANDIT_ALLOW_PRIVATE_WEB_FETCH !== '1') {
+                if (await isPrivateHost(url.hostname)) {
+                    return {
+                        output: `Blocked: ${url.hostname} resolves to a private/loopback/link-local address. Set BANDIT_ALLOW_PRIVATE_WEB_FETCH=1 to allow fetches against internal networks.`,
+                        isError: true
+                    };
+                }
+            }
+            try {
+                const res = await fetch(url.toString(), {
+                    redirect: 'follow',
+                    headers: { 'User-Agent': 'bandit-cli/0.1', Accept: 'text/html,text/plain,application/json;q=0.9,*/*;q=0.5' },
+                    signal: AbortSignal.timeout(15000)
+                });
+                const ct = res.headers.get('content-type') ?? '';
+                const text = await res.text();
+                const body = ct.includes('html') ? stripHtml(text) : text;
+                const trimmed = body.length > 16 * 1024 ? body.slice(0, 16 * 1024) + '\n… (truncated)' : body;
+                return {
+                    output: `HTTP ${res.status} ${res.statusText} • ${url.host}\nContent-Type: ${ct || '(unknown)'}\n\n${trimmed}`,
+                    isError: !res.ok
+                };
+            }
+            catch (err) {
+                return { output: `Fetch failed: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+            }
+        }
+    };
+}
+function stripHtml(html) {
+    return html
+        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '')
+        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Build a `web_search` tool backed by Tavily (purpose-built for LLM
+ * agents — returns ranked snippets, not raw HTML). When TAVILY_API_KEY
+ * is unset the tool returns a clear configuration error so the model
+ * can fall back to other tools (web_fetch with a known URL, ask the
+ * user, etc.) instead of hallucinating results.
+ *
+ * Why Tavily over scraping or Google CSE:
+ * - Generous free tier (1k req/mo at time of writing)
+ * - Single API call returns ranked snippets ready for the model
+ * - No CAPTCHA / rate-limit roulette like search-result scraping
+ * - Optional `answer` field gives the model an LLM-summarized answer
+ * directly when one fits the query
+ */
+function buildWebSearchTool(options = {}) {
+    const endpoint = options.endpoint ?? 'https://api.tavily.com/search';
+    return {
+        name: 'web_search',
+        description: 'Search the web and return ranked snippets. Use for: looking up library APIs, finding documentation, checking what a CLI flag does, researching error messages. Each result has a title, URL, and a short content snippet — call `web_fetch` on the URL when you need the full page. Requires a Tavily API key (configure via the host or set TAVILY_API_KEY).',
+        parameters: [
+            { name: 'query', description: 'The search query — natural language works ("how to configure typescript paths"), keywords work too ("typescript paths config").', required: true },
+            { name: 'num_results', description: 'Number of results to return. Default 5, max 10.', required: false }
+        ],
+        async execute(params, _ctx) {
+            const query = params.query?.trim();
+            if (!query) {
+                return { output: 'Missing query parameter.', isError: true };
+            }
+            const apiKey = options.apiKey?.trim() || process.env.TAVILY_API_KEY?.trim();
+            if (!apiKey) {
+                return {
+                    output: 'web_search is not configured. Set the TAVILY_API_KEY environment variable (free tier: https://tavily.com), or use `web_fetch` with a known URL instead.',
+                    isError: true
+                };
+            }
+            const requestedCount = Number.parseInt(params.num_results ?? '', 10);
+            const maxResults = Number.isFinite(requestedCount) && requestedCount > 0
+                ? Math.min(requestedCount, 10)
+                : 5;
+            try {
+                const res = await fetch(endpoint, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        api_key: apiKey,
+                        query,
+                        search_depth: 'basic',
+                        include_answer: true,
+                        max_results: maxResults
+                    }),
+                    signal: AbortSignal.timeout(15000)
+                });
+                if (!res.ok) {
+                    const detail = await res.text().catch(() => '');
+                    return {
+                        output: `Search failed: HTTP ${res.status} ${res.statusText}${detail ? ` — ${detail.slice(0, 240)}` : ''}`,
+                        isError: true
+                    };
+                }
+                const data = (await res.json());
+                const results = Array.isArray(data.results) ? data.results : [];
+                if (results.length === 0) {
+                    return {
+                        output: `No results for "${query}".${data.answer ? `\n\nDirect answer: ${data.answer}` : ''}`,
+                        isError: false
+                    };
+                }
+                const blocks = [];
+                if (data.answer) {
+                    blocks.push(`Direct answer: ${data.answer}`);
+                    blocks.push('');
+                }
+                blocks.push(`Results for "${query}":`);
+                results.slice(0, maxResults).forEach((r, idx) => {
+                    const title = r.title?.trim() || '(untitled)';
+                    const url = r.url?.trim() || '';
+                    const snippet = (r.content ?? '').trim();
+                    const trimmedSnippet = snippet.length > 600 ? snippet.slice(0, 600) + '…' : snippet;
+                    blocks.push('');
+                    blocks.push(`${idx + 1}. ${title}`);
+                    if (url)
+                        blocks.push(`   ${url}`);
+                    if (trimmedSnippet)
+                        blocks.push(`   ${trimmedSnippet}`);
+                });
+                return { output: blocks.join('\n'), isError: false };
+            }
+            catch (err) {
+                return {
+                    output: `Search failed: ${err instanceof Error ? err.message : String(err)}`,
+                    isError: true
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=extraTools.js.map

package/dist/tools/extraTools.js.map

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

package/dist/tools/readMemoryTool.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@burtson-labs/agent-core';
+export declare function buildReadMemoryTool(): AgentTool;
+//# sourceMappingURL=readMemoryTool.d.ts.map

package/dist/tools/readMemoryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readMemoryTool.d.ts","sourceRoot":"","sources":["../../src/tools/readMemoryTool.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAoC,MAAM,0BAA0B,CAAC;AAO5F,wBAAgB,mBAAmB,IAAI,SAAS,CAmE/C"}

package/dist/tools/readMemoryTool.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReadMemoryTool = buildReadMemoryTool;
+/**
+ * `read_memory` — load a single topic file from `memory/<name>.md` on
+ * demand. Paired with `loadMemoryIndex` (the MEMORY.md index injected
+ * into the system prompt every turn). The agent decides whether a topic
+ * is relevant by reading the index's hook, then calls this tool to
+ * pull the full file into context.
+ *
+ * Rejects path traversal (`..`, absolute paths). On miss, the error
+ * lists the available slugs so the model can self-correct.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const memoryIndex_1 = require("../memoryIndex");
+function buildReadMemoryTool() {
+    return {
+        name: 'read_memory',
+        description: 'Read a single topic memory file by slug. Use this when MEMORY.md (shown in the system prompt) lists a topic whose hook matches the current task. The slug is the part after "memory/" in [Title](memory/<slug>.md) — without the .md suffix. Returns the full file content (capped at 32 KB).',
+        parameters: [
+            {
+                name: 'name',
+                description: 'Memory file slug (no `memory/` prefix, no `.md` suffix). Example: "auth-conventions" loads memory/auth-conventions.md.',
+                required: true
+            }
+        ],
+        async execute(params, ctx) {
+            const requested = (params.name ?? '').trim();
+            if (!requested) {
+                return { output: 'Error: name parameter is required.', isError: true };
+            }
+            // Reject path traversal and absolute paths up front — slug must be a
+            // plain filename, not a path. The MEMORY.md format only ever yields
+            // simple filenames (the parser enforces this on the index side),
+            // and any model passing a `..` here is either confused or hostile.
+            if (requested.includes('/') ||
+                requested.includes('\\') ||
+                requested.includes('..') ||
+                path.isAbsolute(requested)) {
+                return {
+                    output: `Error: name must be a plain slug like "auth-conventions", not a path. Got: "${requested}"`,
+                    isError: true
+                };
+            }
+            const slug = requested.replace(/\.md$/i, '');
+            const index = await (0, memoryIndex_1.loadMemoryIndex)(ctx.workspaceRoot);
+            const entry = index.entries.find((e) => e.name === slug);
+            if (!entry) {
+                const available = index.entries.map((e) => e.name);
+                if (available.length === 0) {
+                    return {
+                        output: `No memory index found. MEMORY.md is missing or has no entries at ${path.resolve(ctx.workspaceRoot, 'MEMORY.md')}.`,
+                        isError: true
+                    };
+                }
+                return {
+                    output: `Memory slug "${slug}" not found. Available: ${available.join(', ')}`,
+                    isError: true
+                };
+            }
+            try {
+                const raw = await fs.promises.readFile(entry.absPath);
+                const truncated = raw.byteLength > memoryIndex_1.MAX_MEMORY_FILE_BYTES;
+                const text = raw.subarray(0, memoryIndex_1.MAX_MEMORY_FILE_BYTES).toString('utf-8');
+                const body = truncated ? `${text}\n… (truncated — file exceeds ${memoryIndex_1.MAX_MEMORY_FILE_BYTES} bytes)` : text;
+                return {
+                    output: `<!-- source: ${entry.relPath} -->\n${body}`,
+                    isError: false
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    output: `Could not read ${memoryIndex_1.MEMORY_DIR}/${slug}.md: ${msg}`,
+                    isError: true
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=readMemoryTool.js.map

package/dist/tools/readMemoryTool.js.map

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