thoth-agents 0.1.18 → 0.2.0

package/dist/index.js

@@ -1,492 +1,24 @@
 import {
+  createAgents,
+  renderOpenCodeAgentConfigs,
   spawn,
   spawnSync
-} from "./chunk-DYGVRAMS.js";
+} from "./chunk-4WYCZ5Z7.js";
 import {
-  DEFAULT_MODELS,
   DEFAULT_THOTH_COMMAND,
-  OPENCODE_PROMPT_DIALECT,
   POLL_INTERVAL_BACKGROUND_MS,
-  SUBAGENT_NAMES,
-  appendPromptSections,
-  composeAgentPrompt,
   context7,
-  createOrchestratorPromptSections,
-  createReadOnlySpecialistPromptSections,
-  createWriteCapableSpecialistPromptSections,
-  detectModelFamily,
   exa,
-  getAgentOverride,
-  getModelFamilyPromptSection,
   getOpenCodeConfigPaths,
-  getStepBudgetPromptSection,
   grep_app,
   installCustomSkills,
-  loadAgentPrompt,
   loadPluginConfig,
-  renderRolePrompt,
   stripJsonComments
-} from "./chunk-6K3ZXIMC.js";
+} from "./chunk-3NOVCFN7.js";
 
 // src/index.ts
 import path4 from "path";
 
-// src/agents/deep.ts
-var DEEP_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("deep"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createDeepAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: DEEP_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("deep", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "deep",
-    description: "Synchronous write-capable implementation agent optimized for thorough context analysis, edge cases, and correctness \u2014 not for bulk mechanical changes.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "secondary"
-      // steps: 80,
-    }
-  };
-}
-
-// src/agents/designer.ts
-var DESIGNER_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("designer"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createDesignerAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: DESIGNER_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("designer", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "designer",
-    description: "Synchronous write-capable UI/UX implementation agent with ownership of approach, execution, and visual verification.",
-    config: {
-      model,
-      temperature: 0.4,
-      prompt,
-      color: "accent"
-      // steps: 50,
-    }
-  };
-}
-
-// src/agents/explorer.ts
-var EXPLORER_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("explorer"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createExplorerAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: EXPLORER_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("explorer", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "explorer",
-    description: "Read-only local discovery agent for fast codebase search, references, and repository mapping.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "info"
-    }
-  };
-}
-
-// src/agents/librarian.ts
-var LIBRARIAN_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("librarian"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createLibrarianAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: LIBRARIAN_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("librarian", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "librarian",
-    description: "Read-only research agent for official docs, public examples, and externally sourced implementation guidance.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "info"
-    }
-  };
-}
-
-// src/agents/oracle.ts
-var ORACLE_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("oracle"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createOracleAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: ORACLE_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("oracle", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "oracle",
-    description: "Synchronous read-only strategic advisor for debugging, architecture, code review, and SDD plan review.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "warning"
-    }
-  };
-}
-
-// src/agents/orchestrator.ts
-var ORCHESTRATOR_PROMPT = renderRolePrompt(
-  createOrchestratorPromptSections(),
-  OPENCODE_PROMPT_DIALECT
-);
-function createOrchestratorAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: ORCHESTRATOR_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("orchestrator", model),
-      customAppendPrompt
-    )
-  });
-  const definition = {
-    name: "orchestrator",
-    description: "Delegate-first coordinator for SDD workflow, specialist dispatch, and root-session memory ownership.",
-    config: {
-      temperature: 0.1,
-      prompt,
-      color: "primary"
-      // steps: 100,
-    }
-  };
-  if (Array.isArray(model)) {
-    definition._modelArray = model.map(
-      (entry) => typeof entry === "string" ? { id: entry } : entry
-    );
-  } else if (typeof model === "string" && model) {
-    definition.config.model = model;
-  }
-  return definition;
-}
-
-// src/agents/quick.ts
-var QUICK_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("quick"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createQuickAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: QUICK_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("quick", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "quick",
-    description: "Synchronous write-capable implementation agent optimized for fast, mechanical, well-bounded changes \u2014 including uniform patterns across multiple files.",
-    config: {
-      model,
-      temperature: 0.2,
-      prompt,
-      color: "success"
-      // steps: 30,
-    }
-  };
-}
-
-// src/agents/index.ts
-var GEMINI_DEFAULT_STEPS = {
-  explorer: 120,
-  librarian: 80,
-  oracle: 80,
-  designer: 80,
-  quick: 40,
-  deep: 120
-};
-var BUILTIN_PERMISSION_PRESETS = {
-  orchestrator: {
-    read: "allow",
-    edit: "allow",
-    write: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    todowrite: "allow",
-    task: "allow",
-    external_directory: "allow"
-  },
-  explorer: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  librarian: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    codesearch: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  oracle: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    lsp: "allow",
-    codesearch: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  designer: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  },
-  quick: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    question: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  },
-  deep: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  }
-};
-function normalizeModelArray(model) {
-  return model.map(
-    (entry) => typeof entry === "string" ? { id: entry } : entry
-  );
-}
-function applyOverrides(agent, override) {
-  if (override.model) {
-    if (Array.isArray(override.model)) {
-      agent._modelArray = normalizeModelArray(override.model);
-      agent.config.model = void 0;
-    } else {
-      agent.config.model = override.model;
-    }
-  }
-  if (override.variant) {
-    agent.config.variant = override.variant;
-  }
-  if (override.temperature !== void 0) {
-    agent.config.temperature = override.temperature;
-  }
-  if (override.steps !== void 0) {
-    agent.config.steps = override.steps;
-  }
-}
-function applyStepBudgetPrompt(agent) {
-  const stepBudgetPrompt = getStepBudgetPromptSection(agent.config.steps);
-  if (!stepBudgetPrompt) {
-    return;
-  }
-  agent.config.prompt = appendPromptSections(
-    agent.config.prompt,
-    stepBudgetPrompt
-  );
-}
-function applyGeminiDefaultSteps(agent) {
-  if (!isSubagent(agent.name) || agent.config.steps !== void 0) {
-    return;
-  }
-  if (detectModelFamily(agent._modelArray ?? agent.config.model) !== "gemini") {
-    return;
-  }
-  agent.config.steps = GEMINI_DEFAULT_STEPS[agent.name];
-}
-function clonePermissionConfig(permission) {
-  if (typeof permission === "string") {
-    return permission;
-  }
-  return Object.fromEntries(
-    Object.entries(permission).map(([key, value]) => [
-      key,
-      value && typeof value === "object" && !Array.isArray(value) ? { ...value } : value
-    ])
-  );
-}
-function getBuiltinPermissionPreset(name) {
-  return clonePermissionConfig(BUILTIN_PERMISSION_PRESETS[name]);
-}
-function getExplicitPermissionOverride(override) {
-  return override?.permission;
-}
-function getPrimaryModelForPrompt(model) {
-  if (Array.isArray(model)) {
-    const first = model[0];
-    return typeof first === "string" ? first : first?.id;
-  }
-  return model;
-}
-function isSubagent(name) {
-  return SUBAGENT_NAMES.includes(name);
-}
-var SUBAGENT_FACTORIES = {
-  explorer: createExplorerAgent,
-  librarian: createLibrarianAgent,
-  oracle: createOracleAgent,
-  designer: createDesignerAgent,
-  quick: createQuickAgent,
-  deep: createDeepAgent
-};
-function createAgents(config) {
-  const protoSubAgents = Object.entries(SUBAGENT_FACTORIES).map(([name, factory]) => {
-    const override = getAgentOverride(config, name);
-    const prompts = loadAgentPrompt(name, config?.preset);
-    const model = getPrimaryModelForPrompt(override?.model) ?? DEFAULT_MODELS[name];
-    return factory(model, prompts.prompt, prompts.appendPrompt);
-  });
-  const allSubAgents = protoSubAgents.map((agent) => {
-    const override = getAgentOverride(config, agent.name);
-    if (override) {
-      applyOverrides(agent, override);
-    }
-    applyGeminiDefaultSteps(agent);
-    applyStepBudgetPrompt(agent);
-    return agent;
-  });
-  const orchestratorOverride = getAgentOverride(config, "orchestrator");
-  const orchestratorPrompts = loadAgentPrompt("orchestrator", config?.preset);
-  const orchestrator = createOrchestratorAgent(
-    orchestratorOverride?.model ?? DEFAULT_MODELS.orchestrator,
-    orchestratorPrompts.prompt,
-    orchestratorPrompts.appendPrompt
-  );
-  if (orchestratorOverride) {
-    applyOverrides(orchestrator, orchestratorOverride);
-  }
-  applyStepBudgetPrompt(orchestrator);
-  return [orchestrator, ...allSubAgents];
-}
-function getAgentConfigs(config) {
-  const agents = createAgents(config);
-  return Object.fromEntries(
-    agents.map((agent) => {
-      const override = getAgentOverride(config, agent.name);
-      const sdkConfig = {
-        ...agent.config,
-        description: agent.description
-      };
-      const builtinPermission = isSubagent(agent.name) ? getBuiltinPermissionPreset(agent.name) : agent.name === "orchestrator" ? getBuiltinPermissionPreset("orchestrator") : void 0;
-      const explicitPermissionOverride = getExplicitPermissionOverride(override);
-      sdkConfig.permission = explicitPermissionOverride ?? agent.config.permission ?? builtinPermission;
-      if (isSubagent(agent.name)) {
-        sdkConfig.mode = "subagent";
-      } else if (agent.name === "orchestrator") {
-        sdkConfig.mode = "primary";
-      }
-      return [agent.name, sdkConfig];
-    })
-  );
-}
-
-// src/harness/adapters/opencode.ts
-function renderOpenCodeAgentConfigs(config) {
-  return getAgentConfigs(config);
-}
-
 // src/utils/logger.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
@@ -1744,6 +1276,14 @@ Understand \u2192 split discovery into surgical probes with explorer/librarian \
 If delegating, write sub-agent prompts in English and launch the specialist in the same turn you mention it. If multiple delegations are independent, emit all tool calls in a single response.
 Before write-capable dispatch, give concrete scope, anchors, steps, non-goals, and verification.
 In SDD, after oracle returns [OKAY], give a deep approved-plan overview, then ask the user before implementation.</reminder>`;
+var PHASE_REMINDER_SEPARATOR = "\n\n---\n\n";
+function stripPhaseReminder(text) {
+  if (!text) {
+    return "";
+  }
+  const prefix = `${PHASE_REMINDER}${PHASE_REMINDER_SEPARATOR}`;
+  return text.startsWith(prefix) ? text.slice(prefix.length) : text;
+}
 function createPhaseReminderHook() {
   return {
     "experimental.chat.messages.transform": async (_input, output) => {
@@ -1776,11 +1316,7 @@ function createPhaseReminderHook() {
       if (originalText.includes(LITE_INTERNAL_INITIATOR_MARKER)) {
         return;
       }
-      lastUserMessage.parts[textPartIndex].text = `${PHASE_REMINDER}
-
----
-
-${originalText}`;
+      lastUserMessage.parts[textPartIndex].text = `${PHASE_REMINDER}${PHASE_REMINDER_SEPARATOR}${originalText}`;
     }
   };
 }
@@ -2013,8 +1549,8 @@ function createThothClient(options) {
 
 // src/hooks/thoth-mem/protocol.ts
 var SDD_TOPIC_KEY_FORMAT = "sdd/{change}/{artifact}";
-var FIRST_ACTION_INSTRUCTION = 'FIRST ACTION REQUIRED: Call mem_session_summary with the content of the compacted summary. This preserves what was accomplished before compaction. Do this BEFORE any other work. Then call mem_context for a recent-session overview, and use the 3-layer recall protocol (mem_search with mode "compact" -> mem_timeline -> mem_get_observation) for precise retrieval.';
-var SESSION_SUMMARY_TEMPLATE = `Use this exact structure for \`mem_session_summary\` content:
+var FIRST_ACTION_INSTRUCTION = 'FIRST ACTION REQUIRED: Call mem_session(action="summary") with the content of the compacted summary. This preserves what was accomplished before compaction. Do this BEFORE any other work. Then call mem_context(recall_query=...) for fused recent context, and use the recall funnel (mem_recall(mode="compact") -> mem_recall(mode="context") -> mem_get(...)) for precise retrieval.';
+var SESSION_SUMMARY_TEMPLATE = `Use this exact structure for \`mem_session(action="summary")\` content:
 
 ## Goal
 [What we were working on this session]
@@ -2034,10 +1570,10 @@ var SESSION_SUMMARY_TEMPLATE = `Use this exact structure for \`mem_session_summa
 ## Relevant Files
 - path/to/file.ts - [what it does or what changed]`;
 function buildCompactionReminder(sessionID) {
-  return `FIRST ACTION REQUIRED: this session was compacted. Call \`mem_session_summary\` with the content of the compacted summary and \`session_id\` \`${sessionID}\`. This preserves what was accomplished before compaction. Do this BEFORE any other work. After that, call \`mem_capture_passive\` if the summary includes \`## Key Learnings:\`, call \`mem_context\` for a recent-session overview, and use the 3-layer recall protocol (\`mem_search\` with \`mode: "compact"\` -> \`mem_timeline\` -> \`mem_get_observation\`) for precise retrieval.`;
+  return `FIRST ACTION REQUIRED: this session was compacted. Call \`mem_session(action="summary")\` with the content of the compacted summary and \`session_id\` \`${sessionID}\`. This preserves what was accomplished before compaction. Do this BEFORE any other work. After that, call \`mem_context(recall_query=...)\` for fused recent context, and use the recall funnel (\`mem_recall(mode="compact")\` -> \`mem_recall(mode="context")\` -> \`mem_get(...)\`) for precise retrieval.`;
 }
 function buildCompactorInstruction(project) {
-  return `CRITICAL INSTRUCTION: place this at the TOP of the compacted summary exactly as an action item for the resumed agent: "FIRST ACTION REQUIRED: Call mem_session_summary with the content of this compacted summary. Use project: '${project}'. This preserves what was accomplished before compaction. Do this BEFORE any other work."`;
+  return `CRITICAL INSTRUCTION: place this at the TOP of the compacted summary exactly as an action item for the resumed agent: "FIRST ACTION REQUIRED: Call mem_session(action="summary") with the content of this compacted summary. Use project: '${project}'. This preserves what was accomplished before compaction. Do this BEFORE any other work."`;
 }
 function buildMemoryInstructions(sessionID, project) {
   return `
@@ -2045,18 +1581,20 @@ function buildMemoryInstructions(sessionID, project) {
 Persistent memory is available through thoth-mem. Follow this protocol.
 
 IMPORTANT: Your current session_id is \`${sessionID}\` and project is \`${project}\`.
-Always pass these values when calling memory tools that accept them (mem_session_summary, mem_save, mem_capture_passive, etc.).
+Always pass these values when calling memory tools that accept them.
 
 ### CORE TOOLS
-mem_save, mem_search, mem_context, mem_session_summary, mem_get_observation, mem_save_prompt, mem_update, mem_suggest_topic_key, mem_timeline, mem_capture_passive
+mem_save, mem_recall, mem_context, mem_get, mem_project, mem_session
 
-### SUBAGENT HANDOFF
-- When dispatching subagents for thoth-mem work, load the bundled \`thoth-mem-agents\` skill.
-- Orchestrator owns \`mem_session_start\`, \`mem_session_summary\`, and \`mem_save_prompt\`.
-- Do not ask subagents to save prompts or session summaries; pass parent \`session_id\` and \`project\` instead.
+### OWNERSHIP AND SUBAGENT HANDOFF
+- Root owns \`mem_session(action="start"|"checkpoint"|"summary")\` and \`mem_save(kind="prompt"|"session_summary")\`.
+- Start root memory-backed workflows with \`mem_session(action="start")\` before any other thoth-mem operation when tools and identity are available.
+- Save the real user prompt with \`mem_save(kind="prompt")\`; never save generated subagent prompts as user intent.
+- Before memory-dependent delegation, save the handoff body with \`mem_session(action="summary")\` or \`mem_save(kind="session_summary")\`.
+- Subagent handoff prompts carry parent \`session_id\`, \`project\`, permissions, and recovery instructions only; do not ask subagents to own session lifecycle actions or save prompts.
 
 ### WHEN TO SAVE
-Call \`mem_save\` IMMEDIATELY after ANY of these:
+Call \`mem_save(kind="observation")\` IMMEDIATELY after ANY of these:
 - Architecture, design, or workflow decision made
 - Bug fixed (include root cause)
 - Non-obvious discovery, gotcha, or edge case found
@@ -2069,44 +1607,45 @@ Call \`mem_save\` IMMEDIATELY after ANY of these:
 - Discussion concludes with a clear direction chosen
 
 Use \`title\` as Verb + what changed or was learned.
+Use \`kind\` intentionally: \`observation\`, \`prompt\`, \`session_summary\`, or \`passive_learnings\`.
 Use \`type\` from: bugfix | decision | architecture | discovery | pattern | config | learning | manual.
 Set \`scope\` intentionally.
-Reuse \`topic_key\` for the same evolving topic. Do not overwrite unrelated topics.
-If unsure about a stable \`topic_key\`, call \`mem_suggest_topic_key\` first.
-If you need to modify a known observation by exact ID, call \`mem_update\` instead of creating a new record.
-Put the durable details in \`content\` with this structure:
+Reuse a stable \`topic_key\` for the same evolving topic. Do not overwrite unrelated topics.
+Put durable observation details in \`content\` with this structure:
   - What: concise description of what changed or was learned
   - Why: why it mattered or what problem it solved
   - Where: files, paths, or systems involved
   - Learned: edge cases, caveats, or follow-up notes
 
-**Self-check after EVERY task**: "Did I or the user just make a decision, confirm a recommendation, express a preference, fix a bug, learn something, or establish a convention? If yes \u2192 mem_save NOW."
+**Self-check after EVERY task**: "Did I or the user just make a decision, confirm a recommendation, express a preference, fix a bug, learn something, or establish a convention? If yes \u2192 mem_save(kind="observation") NOW."
 
-You can also call \`mem_save_prompt\` to manually save a user prompt that you consider particularly important for future context.
-
-### WHEN TO SEARCH MEMORY
-- Broad recovery (session start, after compaction): call \`mem_context\` for a recent-session overview.
-- Targeted 3-layer recall (specific memory retrieval):
-  1. Call \`mem_search\` with \`mode: "compact"\` (default) to scan the compact index of IDs + titles.
-  2. Call \`mem_timeline\` around promising observation IDs for chronological context within the same session.
-  3. Call \`mem_get_observation\` only for observations you need in full.
-- Use \`mode: "preview"\` with \`mem_search\` only when compact results are insufficient to disambiguate.
+### RECALL FUNNEL
+- Broad recovery (session start, after compaction): call \`mem_context(recall_query=...)\` for fused recent context when useful.
+- Targeted retrieval:
+  1. Call \`mem_recall(mode="compact")\` to scan candidate IDs and titles.
+  2. Call \`mem_recall(mode="context")\` to expand the strongest hits into retrieved context.
+  3. Call \`mem_get(...)\` only for records you need in full.
+- Use HyDE/fused recall for semantic or ambiguous searches.
+- Set \`mem_recall\` \`limit\` from 1 to 20 for candidate/result count.
+- Narrow with \`topic_key\`, \`type\`, \`time_from\`, \`time_to\`, \`scope\`, \`project\`, and \`session_id\` filters.
+- Use \`mem_get\` with \`kind="observation"|"prompt"\`; use \`mem_get(include_timeline=true)\` with \`before\`/\`after\`, and \`offset\`/\`max_length\` for large content.
+- Use bounded \`mem_project(action="graph"|"topics"|"topic")\` for relationship and topic navigation; \`mem_project(action="graph")\` relations are \`HAS_TYPE\`, \`IN_PROJECT\`, \`HAS_TOPIC_KEY\`, \`HAS_WHAT\`, \`HAS_WHY\`, \`HAS_WHERE\`, and \`HAS_LEARNED\`; these calls supplement, not replace, the recall funnel.
 - Search proactively on the first message about a project, feature, or problem when prior context may matter.
 - Search before starting work that may have been done before.
 - Search when the user mentions a topic that lacks enough local context.
 
 ### SESSION CLOSE PROTOCOL
-- Before ending the session, call \`mem_session_summary\` with this exact template.
+- Before ending the session, call \`mem_session(action="summary")\` with this exact template.
 - This is NOT optional. If you skip this, the next session starts blind.
 - Do not claim memory was saved unless the tool call succeeded.
-- If your response includes \`## Key Learnings:\`, also call \`mem_capture_passive\`.
+- If your response includes \`## Key Learnings:\`, preserve them with \`mem_save(kind="passive_learnings")\`.
 
 ${SESSION_SUMMARY_TEMPLATE}
 
 ### AFTER COMPACTION
-- IMMEDIATELY call \`mem_session_summary\` with the compacted summary content.
-- Then call \`mem_context\` for a recent-session overview.
-- Use the 3-layer recall protocol (\`mem_search\` with \`mode: "compact"\` -> \`mem_timeline\` -> \`mem_get_observation\`) for precise artifact/prior-observation retrieval.
+- IMMEDIATELY call \`mem_session(action="summary")\` with the compacted summary content.
+- Then call \`mem_context(recall_query=...)\` for fused recent context.
+- Use the recall funnel (\`mem_recall(mode="compact")\` -> \`mem_recall(mode="context")\` -> \`mem_get(...)\`) for precise artifact/prior-observation retrieval.
 - Only then continue working.
 
 ### SDD TOPIC KEY CONVENTION
@@ -2155,11 +1694,15 @@ function truncate(str, max) {
   return str.length > max ? `${str.slice(0, max)}...` : str;
 }
 function sanitizePromptText(text) {
-  return truncate(stripPrivateTags(text), 2e3);
+  return truncate(stripPrivateTags(stripPhaseReminder(text)), 2e3);
 }
-function isSessionSummaryTool(toolName) {
+function isSessionSummaryTool(toolName, args) {
+  if (!args || typeof args !== "object" || Array.isArray(args)) {
+    return false;
+  }
   const normalized = toolName.toLowerCase();
-  return normalized === "mem_session_summary" || normalized.endsWith(".mem_session_summary") || normalized.endsWith("_mem_session_summary");
+  const isMemSessionTool = normalized === "mem_session" || normalized.endsWith(".mem_session") || normalized.endsWith("_mem_session");
+  return isMemSessionTool && args.action === "summary";
 }
 function isMemSaveTool(toolName) {
   const normalized = toolName.toLowerCase();
@@ -2331,7 +1874,6 @@ function createThothMemHook(options) {
     },
     "tool.execute.after": async (input, output) => {
       void input.callID;
-      void input.args;
       void output.title;
       void output.output;
       void output.metadata;
@@ -2342,7 +1884,7 @@ function createThothMemHook(options) {
         lastMemSaveAt.set(input.sessionID, Date.now());
         nudgePending.delete(input.sessionID);
       }
-      if (isSessionSummaryTool(input.tool)) {
+      if (isSessionSummaryTool(input.tool, input.args)) {
         needsCompactionFollowUp.delete(input.sessionID);
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.1.18",
+  "version": "0.2.0",
   "description": "Delegate-first OpenCode plugin with seven agents, thoth-mem persistence, and bundled SDD skills.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",