nemoris 0.1.0 → 0.1.2

package/src/tools/micro/http-fetch.js

@@ -1,74 +1,74 @@
-import { createToolResult } from "../tool-result-contract.js";
-import { inspectOutboundUrl } from "../../security/ssrf-check.js";
-
-const BRIEF_CAP = 3000; // chars in brief sent to LLM prompt
-const RAW_CAP = 1048576; // 1MB raw storage cap
-
-/**
- * Build a useful brief from HTTP response content.
- * - JSON arrays → first 20 items, serialised cleanly
- * - JSON objects → pretty-printed (capped)
- * - HTML → basic tag strip to text (capped)
- * - Plain text → capped
- */
-function buildBrief(status, statusText, contentType, text) {
-  const header = `HTTP ${status} ${statusText}`;
-  const isJson = contentType?.includes("application/json") || text.trimStart().startsWith("{") || text.trimStart().startsWith("[");
-  const isHtml = contentType?.includes("text/html") || text.trimStart().startsWith("<!") || text.trimStart().startsWith("<html");
-
-  if (isJson) {
-    try {
-      const parsed = JSON.parse(text);
-      let compact;
-      if (Array.isArray(parsed)) {
-        const slice = parsed.slice(0, 20);
-        compact = JSON.stringify(slice, null, 2);
-        const totalNote = parsed.length > 20 ? `\n[array length: ${parsed.length} — showing first 20]` : "";
-        return `${header}\n\n${compact.slice(0, BRIEF_CAP)}${totalNote}`;
-      } else {
-        compact = JSON.stringify(parsed, null, 2);
-        return `${header}\n\n${compact.slice(0, BRIEF_CAP)}${compact.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
-      }
-    } catch {
-      // Fall through to plain text handling
-    }
-  }
-
-  if (isHtml) {
-    // Strip tags, collapse whitespace
-    const stripped = text
-      .replace(/<script[\s\S]*?<\/script>/gi, "")
-      .replace(/<style[\s\S]*?<\/style>/gi, "")
-      .replace(/<[^>]+>/g, " ")
-      .replace(/\s+/g, " ")
-      .trim();
-    return `${header}\n\n${stripped.slice(0, BRIEF_CAP)}${stripped.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
-  }
-
-  return `${header}\n\n${text.slice(0, BRIEF_CAP)}${text.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
-}
-
-export async function httpFetchTool({ url, method = "GET", body, headers = {} }, { fetchImpl = globalThis.fetch, lookupImpl } = {}) {
-  try {
-    const parsed = new URL(url);
-    const inspection = await inspectOutboundUrl(parsed, { lookupImpl });
-    if (!inspection.ok) {
-      return "Error: request blocked — target resolves to a private/reserved IP address.";
-    }
-    const opts = {
-      method,
-      headers: { "User-Agent": "Nemoris/0.1", ...headers },
-      signal: AbortSignal.timeout(30000),
-    };
-    if (body && method !== "GET") opts.body = body;
-    const resp = await fetchImpl(url, opts);
-    const contentType = resp.headers.get("content-type") || "";
-    const text = await resp.text();
-    const raw = text.length > RAW_CAP ? text.slice(0, RAW_CAP) + "\n[truncated]" : text;
-    const brief = buildBrief(resp.status, resp.statusText, contentType, text);
-
-    return createToolResult(brief, raw, [url, `http-${resp.status}`]);
-  } catch (err) {
-    return `Error: ${err.message}`;
-  }
-}
+import { createToolResult } from "../tool-result-contract.js";
+import { inspectOutboundUrl } from "../../security/ssrf-check.js";
+
+const BRIEF_CAP = 3000; // chars in brief sent to LLM prompt
+const RAW_CAP = 1048576; // 1MB raw storage cap
+
+/**
+ * Build a useful brief from HTTP response content.
+ * - JSON arrays → first 20 items, serialised cleanly
+ * - JSON objects → pretty-printed (capped)
+ * - HTML → basic tag strip to text (capped)
+ * - Plain text → capped
+ */
+function buildBrief(status, statusText, contentType, text) {
+  const header = `HTTP ${status} ${statusText}`;
+  const isJson = contentType?.includes("application/json") || text.trimStart().startsWith("{") || text.trimStart().startsWith("[");
+  const isHtml = contentType?.includes("text/html") || text.trimStart().startsWith("<!") || text.trimStart().startsWith("<html");
+
+  if (isJson) {
+    try {
+      const parsed = JSON.parse(text);
+      let compact;
+      if (Array.isArray(parsed)) {
+        const slice = parsed.slice(0, 20);
+        compact = JSON.stringify(slice, null, 2);
+        const totalNote = parsed.length > 20 ? `\n[array length: ${parsed.length} — showing first 20]` : "";
+        return `${header}\n\n${compact.slice(0, BRIEF_CAP)}${totalNote}`;
+      } else {
+        compact = JSON.stringify(parsed, null, 2);
+        return `${header}\n\n${compact.slice(0, BRIEF_CAP)}${compact.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
+      }
+    } catch {
+      // Fall through to plain text handling
+    }
+  }
+
+  if (isHtml) {
+    // Strip tags, collapse whitespace
+    const stripped = text
+      .replace(/<script[\s\S]*?<\/script>/gi, "")
+      .replace(/<style[\s\S]*?<\/style>/gi, "")
+      .replace(/<[^>]+>/g, " ")
+      .replace(/\s+/g, " ")
+      .trim();
+    return `${header}\n\n${stripped.slice(0, BRIEF_CAP)}${stripped.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
+  }
+
+  return `${header}\n\n${text.slice(0, BRIEF_CAP)}${text.length > BRIEF_CAP ? "\n[truncated]" : ""}`;
+}
+
+export async function httpFetchTool({ url, method = "GET", body, headers = {} }, { fetchImpl = globalThis.fetch, lookupImpl } = {}) {
+  try {
+    const parsed = new URL(url);
+    const inspection = await inspectOutboundUrl(parsed, { lookupImpl });
+    if (!inspection.ok) {
+      return "Error: request blocked — target resolves to a private/reserved IP address.";
+    }
+    const opts = {
+      method,
+      headers: { "User-Agent": "Nemoris/0.1", ...headers },
+      signal: AbortSignal.timeout(30000),
+    };
+    if (body && method !== "GET") opts.body = body;
+    const resp = await fetchImpl(url, opts);
+    const contentType = resp.headers.get("content-type") || "";
+    const text = await resp.text();
+    const raw = text.length > RAW_CAP ? text.slice(0, RAW_CAP) + "\n[truncated]" : text;
+    const brief = buildBrief(resp.status, resp.statusText, contentType, text);
+
+    return createToolResult(brief, raw, [url, `http-${resp.status}`]);
+  } catch (err) {
+    return `Error: ${err.message}`;
+  }
+}

package/src/tools/micro/index.js

@@ -1,36 +1,36 @@
-import { readFileTool } from "./read-file.js";
-import { writeFileTool } from "./write-file.js";
-import { listDirTool } from "./list-dir.js";
-import { shellExecTool } from "./shell-exec.js";
-import { httpFetchTool } from "./http-fetch.js";
-import { executeTriggerJob } from "./trigger-job.js";
-import { executeCompleteTask } from "./complete-task.js";
-import { executeFailTask } from "./fail-task.js";
-import { executeCancelTask } from "./cancel-task.js";
-import { executeMemorySearch } from "./memory-search.js";
-import { writeMemoryTool } from "./write-memory.js";
-import { executeWebSearch } from "./web-search.js";
-import { lcmRecallHandler } from "./lcm-recall.js";
-import { loadSkillHandler } from "./load-skill.js";
-import { listSkillsHandler } from "./list-skills.js";
-
-export function registerMicroToolHandlers(registry, context = {}) {
-  registry.registerHandler("read_file", (input) => readFileTool(input, context));
-  registry.registerHandler("write_file", (input) => writeFileTool(input, context));
-  registry.registerHandler("list_dir", (input) => listDirTool(input, context));
-  registry.registerHandler("shell_exec", (input) => shellExecTool(input, context));
-  registry.registerHandler("http_fetch", (input) => httpFetchTool(input, context));
-  registry.registerHandler("trigger_job", (input) => executeTriggerJob(input, context));
-  registry.registerHandler("complete_task", (input) => executeCompleteTask(input, context));
-  registry.registerHandler("fail_task", (input) => executeFailTask(input, context));
-  registry.registerHandler("cancel_task", (input) => executeCancelTask(input, context));
-  registry.registerHandler("memory_search", (input) => executeMemorySearch(input, context));
-  registry.registerHandler("write_memory", (input) => writeMemoryTool(input, context));
-  registry.registerHandler("lcm_recall", (input) => lcmRecallHandler(input, context));
-  registry.registerHandler("load_skill", (input) => loadSkillHandler(input, context));
-  registry.registerHandler("list_skills", (input) => listSkillsHandler(input, context));
-  registry.registerHandler("web_search", (input) => executeWebSearch(input, {
-    fetchImpl: context.fetchImpl || globalThis.fetch,
-    apiKey: context.openRouterApiKey || process.env.OPENROUTER_API_KEY,
-  }));
-}
+import { readFileTool } from "./read-file.js";
+import { writeFileTool } from "./write-file.js";
+import { listDirTool } from "./list-dir.js";
+import { shellExecTool } from "./shell-exec.js";
+import { httpFetchTool } from "./http-fetch.js";
+import { executeTriggerJob } from "./trigger-job.js";
+import { executeCompleteTask } from "./complete-task.js";
+import { executeFailTask } from "./fail-task.js";
+import { executeCancelTask } from "./cancel-task.js";
+import { executeMemorySearch } from "./memory-search.js";
+import { writeMemoryTool } from "./write-memory.js";
+import { executeWebSearch } from "./web-search.js";
+import { lcmRecallHandler } from "./lcm-recall.js";
+import { loadSkillHandler } from "./load-skill.js";
+import { listSkillsHandler } from "./list-skills.js";
+
+export function registerMicroToolHandlers(registry, context = {}) {
+  registry.registerHandler("read_file", (input) => readFileTool(input, context));
+  registry.registerHandler("write_file", (input) => writeFileTool(input, context));
+  registry.registerHandler("list_dir", (input) => listDirTool(input, context));
+  registry.registerHandler("shell_exec", (input) => shellExecTool(input, context));
+  registry.registerHandler("http_fetch", (input) => httpFetchTool(input, context));
+  registry.registerHandler("trigger_job", (input) => executeTriggerJob(input, context));
+  registry.registerHandler("complete_task", (input) => executeCompleteTask(input, context));
+  registry.registerHandler("fail_task", (input) => executeFailTask(input, context));
+  registry.registerHandler("cancel_task", (input) => executeCancelTask(input, context));
+  registry.registerHandler("memory_search", (input) => executeMemorySearch(input, context));
+  registry.registerHandler("write_memory", (input) => writeMemoryTool(input, context));
+  registry.registerHandler("lcm_recall", (input) => lcmRecallHandler(input, context));
+  registry.registerHandler("load_skill", (input) => loadSkillHandler(input, context));
+  registry.registerHandler("list_skills", (input) => listSkillsHandler(input, context));
+  registry.registerHandler("web_search", (input) => executeWebSearch(input, {
+    fetchImpl: context.fetchImpl || globalThis.fetch,
+    apiKey: context.openRouterApiKey || process.env.OPENROUTER_API_KEY,
+  }));
+}

package/src/tools/micro/lcm-recall.js

@@ -1,60 +1,60 @@
-/**
- * lcm_recall micro tool — search compacted conversation history.
- *
- * Returns a typed tool result contract: { brief, raw, index_terms }.
- */
-
-import { createToolResult } from "../tool-result-contract.js";
-
-/**
- * @param {{ query: string, limit?: number }} input
- * @param {{ contextLedger: object, sessionId: string }} context
- * @returns {Promise<import('../tool-result-contract.js').ToolResultContract>}
- */
-export async function lcmRecallHandler(input, context) {
-  const { query, limit = 5 } = input;
-  const { contextLedger, sessionId } = context;
-
-  if (!query) throw new Error("lcm_recall requires a query parameter.");
-  if (!contextLedger) {
-    // Fallback if ledger is missing in context (e.g. some tests)
-    return createToolResult(
-      "ContextLedger not available. Cannot recall compacted context.",
-      JSON.stringify([]),
-      [query]
-    );
-  }
-
-  const summaries = contextLedger.getContextSummaries({ session_id: sessionId });
-  
-  const queryWords = query.toLowerCase().split(/\s+/).filter(Boolean);
-  
-  const matches = summaries.filter(s => {
-    const text = s.summary_text.toLowerCase();
-    return queryWords.every(word => text.includes(word));
-  }).slice(0, limit);
-
-  if (matches.length === 0) {
-    return createToolResult(
-      `No relevant compacted context found for "${query}".`,
-      JSON.stringify([]),
-      [query]
-    );
-  }
-
-  const briefLines = matches.map((s, i) => {
-    const dateStr = s.created_at || "unknown date";
-    return `${i + 1}. [Depth ${s.depth}] (${dateStr}) — ${s.summary_text}`;
-  });
-  
-  const brief = `Found ${matches.length} matching compacted summary(ies):\n${briefLines.join("\n")}`;
-  
-  const indexTerms = new Set([query]);
-  matches.forEach(s => {
-    s.summary_text.split(/\W+/).forEach(word => {
-      if (word.length > 3) indexTerms.add(word.toLowerCase());
-    });
-  });
-
-  return createToolResult(brief, JSON.stringify(matches), Array.from(indexTerms));
-}
+/**
+ * lcm_recall micro tool — search compacted conversation history.
+ *
+ * Returns a typed tool result contract: { brief, raw, index_terms }.
+ */
+
+import { createToolResult } from "../tool-result-contract.js";
+
+/**
+ * @param {{ query: string, limit?: number }} input
+ * @param {{ contextLedger: object, sessionId: string }} context
+ * @returns {Promise<import('../tool-result-contract.js').ToolResultContract>}
+ */
+export async function lcmRecallHandler(input, context) {
+  const { query, limit = 5 } = input;
+  const { contextLedger, sessionId } = context;
+
+  if (!query) throw new Error("lcm_recall requires a query parameter.");
+  if (!contextLedger) {
+    // Fallback if ledger is missing in context (e.g. some tests)
+    return createToolResult(
+      "ContextLedger not available. Cannot recall compacted context.",
+      JSON.stringify([]),
+      [query]
+    );
+  }
+
+  const summaries = contextLedger.getContextSummaries({ session_id: sessionId });
+  
+  const queryWords = query.toLowerCase().split(/\s+/).filter(Boolean);
+  
+  const matches = summaries.filter(s => {
+    const text = s.summary_text.toLowerCase();
+    return queryWords.every(word => text.includes(word));
+  }).slice(0, limit);
+
+  if (matches.length === 0) {
+    return createToolResult(
+      `No relevant compacted context found for "${query}".`,
+      JSON.stringify([]),
+      [query]
+    );
+  }
+
+  const briefLines = matches.map((s, i) => {
+    const dateStr = s.created_at || "unknown date";
+    return `${i + 1}. [Depth ${s.depth}] (${dateStr}) — ${s.summary_text}`;
+  });
+  
+  const brief = `Found ${matches.length} matching compacted summary(ies):\n${briefLines.join("\n")}`;
+  
+  const indexTerms = new Set([query]);
+  matches.forEach(s => {
+    s.summary_text.split(/\W+/).forEach(word => {
+      if (word.length > 3) indexTerms.add(word.toLowerCase());
+    });
+  });
+
+  return createToolResult(brief, JSON.stringify(matches), Array.from(indexTerms));
+}

package/src/tools/micro/list-dir.js

@@ -1,17 +1,17 @@
-import { readdir, stat } from "node:fs/promises";
-import { join } from "node:path";
-
-export async function listDirTool({ path }, context = {}) {
-  try {
-    const targetPath = path || context.workspaceRoot;
-    const entries = await readdir(targetPath);
-    const lines = [];
-    for (const entry of entries.sort()) {
-      const s = await stat(join(targetPath, entry));
-      lines.push(`${s.isDirectory() ? "d" : "-"} ${entry}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error listing directory: ${err.message}`;
-  }
-}
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+
+export async function listDirTool({ path }, context = {}) {
+  try {
+    const targetPath = path || context.workspaceRoot;
+    const entries = await readdir(targetPath);
+    const lines = [];
+    for (const entry of entries.sort()) {
+      const s = await stat(join(targetPath, entry));
+      lines.push(`${s.isDirectory() ? "d" : "-"} ${entry}`);
+    }
+    return lines.join("\n");
+  } catch (err) {
+    return `Error listing directory: ${err.message}`;
+  }
+}

package/src/tools/micro/list-skills.js

@@ -1,46 +1,46 @@
-import { readdir, access } from "node:fs/promises";
-import { join } from "node:path";
-import { createToolResult } from "../tool-result-contract.js";
-
-/**
- * List all available skills by name.
- *
- * @param {Object} input - {}
- * @param {Object} context - { workspaceRoot, installDir }
- */
-export async function listSkillsHandler(_, { workspaceRoot, installDir }) {
-  const skillDirs = [
-    { path: join(workspaceRoot, "skills"), label: "workspace" },
-    { path: join(installDir, "skills"), label: "install" },
-  ];
-
-  const skillNames = new Set();
-
-  for (const { path } of skillDirs) {
-    try {
-      const entries = await readdir(path, { withFileTypes: true });
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          const skillName = entry.name;
-          const skillPath = join(path, skillName, "SKILL.md");
-          try {
-            await access(skillPath);
-            skillNames.add(skillName);
-          } catch {
-            // No SKILL.md here, skip
-          }
-        }
-      }
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-
-  if (skillNames.size === 0) {
-    return createToolResult("No skills found.", [], ["skills"]);
-  }
-
-  const sortedNames = Array.from(skillNames).sort();
-  const brief = "Available skills:\n" + sortedNames.join("\n");
-  return createToolResult(brief, sortedNames, ["skills", "list"]);
-}
+import { readdir, access } from "node:fs/promises";
+import { join } from "node:path";
+import { createToolResult } from "../tool-result-contract.js";
+
+/**
+ * List all available skills by name.
+ *
+ * @param {Object} input - {}
+ * @param {Object} context - { workspaceRoot, installDir }
+ */
+export async function listSkillsHandler(_, { workspaceRoot, installDir }) {
+  const skillDirs = [
+    { path: join(workspaceRoot, "skills"), label: "workspace" },
+    { path: join(installDir, "skills"), label: "install" },
+  ];
+
+  const skillNames = new Set();
+
+  for (const { path } of skillDirs) {
+    try {
+      const entries = await readdir(path, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          const skillName = entry.name;
+          const skillPath = join(path, skillName, "SKILL.md");
+          try {
+            await access(skillPath);
+            skillNames.add(skillName);
+          } catch {
+            // No SKILL.md here, skip
+          }
+        }
+      }
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err;
+    }
+  }
+
+  if (skillNames.size === 0) {
+    return createToolResult("No skills found.", [], ["skills"]);
+  }
+
+  const sortedNames = Array.from(skillNames).sort();
+  const brief = "Available skills:\n" + sortedNames.join("\n");
+  return createToolResult(brief, sortedNames, ["skills", "list"]);
+}

package/src/tools/micro/load-skill.js

@@ -1,38 +1,38 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { createToolResult } from "../tool-result-contract.js";
-
-/**
- * Load a skill by name to get instructions for a specific task.
- * Skills provide step-by-step guidance for tools, APIs, and workflows.
- *
- * @param {Object} input - { name }
- * @param {Object} context - { workspaceRoot, installDir }
- */
-export async function loadSkillHandler({ name }, { workspaceRoot, installDir }) {
-  const skillPaths = [
-    join(workspaceRoot, "skills", name, "SKILL.md"),
-    join(installDir, "skills", name, "SKILL.md"),
-  ];
-
-  let content = null;
-  for (const skillPath of skillPaths) {
-    try {
-      content = await readFile(skillPath, "utf8");
-      break;
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-
-  if (content === null) {
-    return createToolResult(
-      `Skill '${name}' not found. Available skills can be listed with list_skills.`,
-      null,
-      [name]
-    );
-  }
-
-  const cappedContent = content.length > 6000 ? content.slice(0, 6000) + "\n[truncated]" : content;
-  return createToolResult(cappedContent, content, [name, "skill"]);
-}
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createToolResult } from "../tool-result-contract.js";
+
+/**
+ * Load a skill by name to get instructions for a specific task.
+ * Skills provide step-by-step guidance for tools, APIs, and workflows.
+ *
+ * @param {Object} input - { name }
+ * @param {Object} context - { workspaceRoot, installDir }
+ */
+export async function loadSkillHandler({ name }, { workspaceRoot, installDir }) {
+  const skillPaths = [
+    join(workspaceRoot, "skills", name, "SKILL.md"),
+    join(installDir, "skills", name, "SKILL.md"),
+  ];
+
+  let content = null;
+  for (const skillPath of skillPaths) {
+    try {
+      content = await readFile(skillPath, "utf8");
+      break;
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err;
+    }
+  }
+
+  if (content === null) {
+    return createToolResult(
+      `Skill '${name}' not found. Available skills can be listed with list_skills.`,
+      null,
+      [name]
+    );
+  }
+
+  const cappedContent = content.length > 6000 ? content.slice(0, 6000) + "\n[truncated]" : content;
+  return createToolResult(cappedContent, content, [name, "skill"]);
+}

package/src/tools/micro/memory-search.js

@@ -1,45 +1,45 @@
-/**
- * memory_search micro tool — semantic + lexical search across agent memory.
- *
- * Returns a typed tool result contract: { brief, raw, index_terms }.
- */
-
-import { createToolResult } from "../tool-result-contract.js";
-
-/**
- * @param {{ query: string, agentId?: string, limit?: number }} input
- * @param {{ memoryStore: object, callerAgentId: string }} context
- * @returns {Promise<import('../tool-result-contract.js').ToolResultContract>}
- */
-export async function executeMemorySearch(input, context) {
-  const { query, agentId, limit = 5 } = input;
-  const { memoryStore, callerAgentId } = context;
-
-  if (!query) throw new Error("memory_search requires a query parameter.");
-
-  const targetAgent = agentId || callerAgentId;
-  const result = await memoryStore.query(targetAgent, query, { limit });
-
-  if (!result.items || result.items.length === 0) {
-    return createToolResult(
-      `No results found for "${query}" in ${targetAgent}'s memory.`,
-      JSON.stringify(result),
-      [query]
-    );
-  }
-
-  // Brief: concise list of titles + snippet (≤200 tokens target)
-  const briefLines = result.items.map((item, i) => {
-    const snippet = (item.content || item.summary || "").slice(0, 80);
-    return `${i + 1}. **${item.title || "untitled"}** — ${snippet}${snippet.length >= 80 ? "..." : ""}`;
-  });
-  const brief = `Found ${result.items.length} result(s) for "${query}":\n${briefLines.join("\n")}`;
-
-  // Index terms: query words + titles
-  const indexTerms = [
-    query,
-    ...result.items.map((item) => item.title).filter(Boolean),
-  ];
-
-  return createToolResult(brief, JSON.stringify(result), indexTerms);
-}
+/**
+ * memory_search micro tool — semantic + lexical search across agent memory.
+ *
+ * Returns a typed tool result contract: { brief, raw, index_terms }.
+ */
+
+import { createToolResult } from "../tool-result-contract.js";
+
+/**
+ * @param {{ query: string, agentId?: string, limit?: number }} input
+ * @param {{ memoryStore: object, callerAgentId: string }} context
+ * @returns {Promise<import('../tool-result-contract.js').ToolResultContract>}
+ */
+export async function executeMemorySearch(input, context) {
+  const { query, agentId, limit = 5 } = input;
+  const { memoryStore, callerAgentId } = context;
+
+  if (!query) throw new Error("memory_search requires a query parameter.");
+
+  const targetAgent = agentId || callerAgentId;
+  const result = await memoryStore.query(targetAgent, query, { limit });
+
+  if (!result.items || result.items.length === 0) {
+    return createToolResult(
+      `No results found for "${query}" in ${targetAgent}'s memory.`,
+      JSON.stringify(result),
+      [query]
+    );
+  }
+
+  // Brief: concise list of titles + snippet (≤200 tokens target)
+  const briefLines = result.items.map((item, i) => {
+    const snippet = (item.content || item.summary || "").slice(0, 80);
+    return `${i + 1}. **${item.title || "untitled"}** — ${snippet}${snippet.length >= 80 ? "..." : ""}`;
+  });
+  const brief = `Found ${result.items.length} result(s) for "${query}":\n${briefLines.join("\n")}`;
+
+  // Index terms: query words + titles
+  const indexTerms = [
+    query,
+    ...result.items.map((item) => item.title).filter(Boolean),
+  ];
+
+  return createToolResult(brief, JSON.stringify(result), indexTerms);
+}