agent-procedures 0.3.1 → 0.3.2

package/dist/runtime.js

@@ -1,4 +1,4 @@
-// Generated by agent-procedures@0.3.1. Do not edit.
+// Generated by agent-procedures@0.3.2. Do not edit.
 // To upgrade: npx agent-procedures init
 
 // lib/main.js
@@ -391,13 +391,15 @@ function recall(prompt, procs) {
   let text = formatSteps(best.steps, best.requires_env);
   const alt = procs.find((e) => e.parent_id === best.id && e.type === "alt" && e.enabled !== false);
   if (alt) text += "\n\nAlternative path that worked:\n" + formatSteps(alt.steps, alt.requires_env);
+  const label = best.trigger || "procedure";
   return {
     node: best,
     text: `Reflex memory found a procedure for this task:
 
 ${text}
 
-Follow these steps instead of figuring it out from scratch.`
+Follow these steps instead of figuring it out from scratch.`,
+    notice: `Reflex recalled: "${label}"`
   };
 }
 
@@ -420,9 +422,9 @@ function onPrompt(evt, reflexDir) {
     ...sanitized.unsafe ? { contains_unresolvable_secret: true } : {}
   });
   const hit = recall(sanitized.text, readAllProcedures(reflexDir));
-  if (!hit) return { context: null };
+  if (!hit) return { context: null, notice: null };
   appendTrace(reflexDir, sessionId, promptId, { t: "Recall", hit: hit.node.id });
-  return { context: hit.text };
+  return { context: hit.text, notice: hit.notice };
 }
 function onTool(evt, reflexDir) {
   const sanitized = evt.tool === "Bash" || evt.tool === "bash" ? sanitizeCommand(evt.target) : sanitizeText(evt.target);
@@ -882,9 +884,11 @@ var claude_default = {
   render(evt, result2) {
     if (evt.type !== "prompt") return "";
     if (!result2.context) return "{}";
-    return JSON.stringify({
+    const out = {
       hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: result2.context }
-    });
+    };
+    if (result2.notice) out.systemMessage = result2.notice;
+    return JSON.stringify(out);
   }
 };
 

package/lib/engine.js

@@ -18,8 +18,9 @@ import { recall } from "./recall.js";
  *   { type: "tool",   sessionId, promptId, tool, target, ok }
  *   { type: "stop",   sessionId, promptId, interrupted, busy }
  *
- * Returns { context: string | null }. `context` is text the harness should
- * inject into the agent's next turn, if it knows how.
+ * Returns { context: string | null, notice?: string | null }.
+ * `context` is text the harness should inject into the agent's next turn.
+ * `notice` is a short user-visible line; the harness maps it if the host supports it.
  */
 export function handleEvent(evt, reflexDir, deps = {}) {
   if (!evt || !evt.sessionId || !evt.promptId) return { context: null };
@@ -45,10 +46,10 @@ function onPrompt(evt, reflexDir) {
   });
 
   const hit = recall(sanitized.text, readAllProcedures(reflexDir));
-  if (!hit) return { context: null };
+  if (!hit) return { context: null, notice: null };
 
   appendTrace(reflexDir, sessionId, promptId, { t: "Recall", hit: hit.node.id });
-  return { context: hit.text };
+  return { context: hit.text, notice: hit.notice };
 }
 
 // --- tool: trace ----------------------------------------------------------

package/lib/harnesses/claude.js

@@ -70,8 +70,11 @@ export default {
   render(evt, result) {
     if (evt.type !== "prompt") return "";
     if (!result.context) return "{}";
-    return JSON.stringify({
+    const out = {
       hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: result.context },
-    });
+    };
+    // Top-level systemMessage is shown to the user; not model context.
+    if (result.notice) out.systemMessage = result.notice;
+    return JSON.stringify(out);
   },
 };

package/lib/recall.js

@@ -77,7 +77,7 @@ function formatSteps(steps, requiresEnv = []) {
 
 /**
  * Best-scoring root procedure for this prompt, or null.
- * Returns { node, text } ready to inject.
+ * Returns { node, text, notice } — text for the agent, notice for the harness UI.
  */
 export function recall(prompt, procs) {
   if (!prompt) return null;
@@ -101,8 +101,10 @@ export function recall(prompt, procs) {
   const alt = procs.find((e) => e.parent_id === best.id && e.type === "alt" && e.enabled !== false);
   if (alt) text += "\n\nAlternative path that worked:\n" + formatSteps(alt.steps, alt.requires_env);
 
+  const label = best.trigger || "procedure";
   return {
     node: best,
     text: `Reflex memory found a procedure for this task:\n\n${text}\n\nFollow these steps instead of figuring it out from scratch.`,
+    notice: `Reflex recalled: "${label}"`,
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-procedures",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Procedural memory for coding agents",
   "type": "module",
   "bin": {