@skaft/hamr 0.4.1

package/dist/hamr/extensions/memory.js

@@ -0,0 +1,405 @@
+import { registerHandoffTool } from "../handoff/HandoffManager.js";
+import { contentText } from "../helpers.js";
+import { getMemory, registerMemoryTools, sanitizeMemoryTranscriptText, setCurrentTurnId, storeMessage, } from "../memory.js";
+import { isCloudProvider, loadHamrStartupConfig } from "../startup-config.js";
+/**
+ * Builds the user message injected into context from FTS5 auto-retrieval.
+ *
+ * A survival manifest (from a prior local-model compaction) is surfaced first
+ * and prominently — it is the resumed instance's primary orientation, not a
+ * generic search hit. Returns null only when there is nothing worth injecting.
+ */
+export function buildMemoryContextMessage(autoResults, index, options = {}) {
+    const { survivalManifest, timestamp = Date.now() } = options;
+    if (autoResults.length === 0 && !survivalManifest)
+        return null;
+    const sections = [];
+    if (survivalManifest) {
+        sections.push(`\nSURVIVAL MANIFEST (most recent local-model compaction — your primary orientation; use search_memory on the keys to recover full detail):\n${survivalManifest}`);
+    }
+    if (autoResults.length > 0) {
+        sections.push(`\nAuto-retrieved context from prior sessions:\n${autoResults.join("\n")}`);
+    }
+    sections.push(`\n${index}`);
+    return { role: "user", content: sections.join("\n"), timestamp };
+}
+export function selectCompactionPolicy(options) {
+    const contextWindow = options.contextWindow && options.contextWindow > 0 ? options.contextWindow : 16_384;
+    if (options.cloud) {
+        return {
+            tier: "cloud",
+            contextWindow,
+            keyLimit: 8,
+            searchTermLimit: 5,
+            resultsPerTerm: 3,
+            snippetChars: 180,
+            instructions: "Use pi's default LLM compaction; FTS5 stores a structured bookkeeping handoff.",
+        };
+    }
+    if (contextWindow >= 96_000) {
+        return {
+            tier: "local-131k",
+            contextWindow,
+            keyLimit: 10,
+            searchTermLimit: 6,
+            resultsPerTerm: 3,
+            snippetChars: 180,
+            instructions: "Large local context: keep a compact structured handoff and recover deeper provenance from FTS5 only as needed.",
+        };
+    }
+    if (contextWindow >= 49_152) {
+        return {
+            tier: "local-64k",
+            contextWindow,
+            keyLimit: 12,
+            searchTermLimit: 5,
+            resultsPerTerm: 2,
+            snippetChars: 160,
+            instructions: "Medium local context: prefer targeted FTS5 recovery over broad automatic replay.",
+        };
+    }
+    if (contextWindow >= 24_576) {
+        return {
+            tier: "local-32k",
+            contextWindow,
+            keyLimit: 14,
+            searchTermLimit: 4,
+            resultsPerTerm: 2,
+            snippetChars: 140,
+            instructions: "Small local context: carry only decisions/status plus search keys; call search_memory for details.",
+        };
+    }
+    return {
+        tier: "local-16k",
+        contextWindow,
+        keyLimit: 16,
+        searchTermLimit: 3,
+        resultsPerTerm: 1,
+        snippetChars: 120,
+        instructions: "Tiny local context: do not replay history. Use the manifest as a map, then recover one key at a time with search_memory.",
+    };
+}
+const INTENT_RE = /\b(i'?ll|i will|let me|let'?s|going to|next,? i|next step|the fix|plan to|need to|then i)\b/i;
+const EDIT_TOOLS = new Set(["edit", "write", "str_replace", "str_replace_editor", "create_file", "apply_patch"]);
+const PATH_ARG_KEYS = ["file_path", "path", "filePath", "filename", "file"];
+function assistantText(message) {
+    return message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("")
+        .trim();
+}
+function toolCalls(message) {
+    return message.content.filter((part) => part.type === "toolCall");
+}
+function argPath(args) {
+    if (!args)
+        return undefined;
+    for (const key of PATH_ARG_KEYS) {
+        const value = args[key];
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function splitSentences(text) {
+    return text
+        .split(/(?<=[.!?])\s+|\n+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function truncate(text, max) {
+    const clean = text.replace(/\s+/g, " ").trim();
+    return clean.length > max ? `${clean.slice(0, max - 1)}…` : clean;
+}
+/** Parse a `git switch`/`git checkout [-b]` command into the target branch name. */
+function parseBranch(command) {
+    const match = command.match(/git\s+(?:switch|checkout)\s+(?:-[bc]\s+)?([\w./-]+)/);
+    const name = match?.[1];
+    if (!name || name === "-" || name.startsWith("-"))
+        return undefined;
+    return name;
+}
+/** Extract the first specific error line from tool-result text. */
+function firstErrorLine(text) {
+    for (const raw of text.split("\n")) {
+        const line = raw.trim();
+        if (line.length < 8 || line.length > 200)
+            continue;
+        if (/\b(error|failed|failure|exception|cannot|not found|undefined)\b/i.test(line)) {
+            return truncate(line, 160);
+        }
+    }
+    return undefined;
+}
+/** Backticked tokens are how assistants name the specific identifiers central to the work. */
+function backtickedIdentifiers(text) {
+    const out = [];
+    for (const match of text.matchAll(/`([^`\n]{2,60})`/g)) {
+        const token = match[1].trim();
+        // Keep specific identifiers/paths; drop prose-y multi-word backtick spans.
+        if (token && !/\s/.test(token))
+            out.push(token);
+    }
+    return out;
+}
+export function extractSurvivalData(messages, policy = selectCompactionPolicy({ cloud: false, contextWindow: 16_384 })) {
+    const assistants = [];
+    const orderedCalls = [];
+    const resultsByCallId = new Map();
+    let firstUserText = "";
+    for (const message of messages) {
+        if (message.role === "user") {
+            const text = contentText(message.content).trim();
+            if (!firstUserText && text)
+                firstUserText = text;
+        }
+        else if (message.role === "assistant") {
+            const assistant = message;
+            assistants.push(assistant);
+            for (const call of toolCalls(assistant))
+                orderedCalls.push(call);
+        }
+        else if (message.role === "toolResult") {
+            const result = message;
+            resultsByCallId.set(result.toolCallId, { isError: result.isError, text: contentText(result.content) });
+        }
+    }
+    // Task: the verbatim goal. The user's first message is the truest source;
+    // fall back to the earliest assistant text when no user message survived.
+    const firstAssistantText = assistants.map(assistantText).find((t) => t.length > 0) ?? "";
+    const taskSource = firstUserText || firstAssistantText;
+    const task = taskSource ? truncate(splitSentences(taskSource).slice(0, 2).join(" "), 240) : "(task not recovered)";
+    // Next: the planned action lives in the last assistant message(s).
+    let next = "";
+    for (let i = assistants.length - 1; i >= 0 && !next; i--) {
+        const sentences = splitSentences(assistantText(assistants[i]));
+        const intent = sentences.find((s) => INTENT_RE.test(s));
+        if (intent)
+            next = truncate(intent, 200);
+    }
+    if (!next)
+        next = "(no explicit next action recorded)";
+    // Status: ground truth from tool calls/results.
+    const modified = new Set();
+    let lastBash;
+    let branch;
+    for (const call of orderedCalls) {
+        if (EDIT_TOOLS.has(call.name)) {
+            const path = argPath(call.arguments);
+            if (path)
+                modified.add(path);
+        }
+        else if (call.name === "bash" && typeof call.arguments?.command === "string") {
+            const command = call.arguments.command;
+            lastBash = { command, result: resultsByCallId.get(call.id) };
+            const parsed = parseBranch(command);
+            if (parsed)
+                branch = parsed;
+        }
+    }
+    const status = [];
+    if (modified.size > 0)
+        status.push(`modified: ${Array.from(modified).slice(0, 8).join(", ")}`);
+    if (lastBash) {
+        const outcome = lastBash.result ? (lastBash.result.isError ? "failed" : "succeeded") : "result unknown";
+        status.push(`last command: \`${truncate(lastBash.command, 100)}\` (${outcome})`);
+    }
+    if (branch)
+        status.push(`branch: ${branch}`);
+    // Keys: specific terms that each recover something lossless from FTS5.
+    const keys = [];
+    const provenance = [];
+    const seen = new Set();
+    const add = (candidate) => {
+        if (keys.length >= policy.keyLimit || !candidate)
+            return;
+        const value = candidate.trim();
+        if (!value || value.length > 160 || seen.has(value.toLowerCase()))
+            return;
+        seen.add(value.toLowerCase());
+        keys.push(value);
+    };
+    const addProvenance = (candidate) => {
+        if (!candidate || provenance.length >= 12)
+            return;
+        const value = candidate.trim();
+        if (!value || provenance.some((p) => p.toLowerCase() === value.toLowerCase()))
+            return;
+        provenance.push(value);
+    };
+    // 1. Exact error strings being fought.
+    for (const { isError, text } of resultsByCallId.values()) {
+        if (keys.length >= policy.keyLimit)
+            break;
+        if (isError || /\b(error|failed|exception)\b/i.test(text))
+            add(firstErrorLine(text));
+    }
+    // 2. Specific file paths actively being worked in.
+    for (const call of orderedCalls) {
+        if (keys.length >= policy.keyLimit)
+            break;
+        const path = argPath(call.arguments);
+        add(path);
+        addProvenance(path);
+    }
+    // 3. Specific identifiers / decisions named in assistant text.
+    for (const assistant of assistants) {
+        if (keys.length >= policy.keyLimit)
+            break;
+        for (const id of backtickedIdentifiers(assistantText(assistant)))
+            add(id);
+    }
+    for (const call of orderedCalls.slice(-8)) {
+        addProvenance(`${call.name}${argPath(call.arguments) ? `:${argPath(call.arguments)}` : ""}`);
+    }
+    return {
+        tier: policy.tier,
+        contextWindow: policy.contextWindow,
+        task,
+        status,
+        next,
+        keys,
+        provenance,
+        instructions: policy.instructions,
+    };
+}
+export function formatSurvivalManifest(data) {
+    const lines = [
+        "## Survival manifest (local-model compaction)",
+        `Tier: ${data.tier} (${data.contextWindow.toLocaleString()} token window)`,
+        `Task: ${data.task}`,
+        `Recovery: ${data.instructions}`,
+    ];
+    if (data.status.length > 0) {
+        lines.push("Status:", ...data.status.map((s) => `- ${s}`));
+    }
+    else {
+        lines.push("Status: (no concrete state recorded)");
+    }
+    lines.push(`Next: ${data.next}`);
+    if (data.keys.length > 0) {
+        lines.push("Search keys (use search_memory to recover full detail from FTS5):");
+        for (const key of data.keys)
+            lines.push(`- ${key}`);
+    }
+    if (data.provenance.length > 0) {
+        lines.push("Provenance anchors:");
+        for (const item of data.provenance)
+            lines.push(`- ${item}`);
+    }
+    return lines.join("\n");
+}
+/** Build the survival manifest string for a set of messages about to be discarded. */
+export function buildSurvivalManifest(messages, policy) {
+    return formatSurvivalManifest(extractSurvivalData(messages, policy));
+}
+/**
+ * Cloud bookkeeping handoff: a lightweight manifest stored in FTS5 so the
+ * resumed (LLM-summarized) session still has structured search hooks. Cloud
+ * models keep pi's default compaction, so this never overrides the summary.
+ */
+function storeCompactionHandoff(memory, ctx, event) {
+    const manifest = memory.handoff();
+    memory.store({
+        sessionId: ctx.sessionManager.getSessionId(),
+        turnId: 0,
+        role: "tool",
+        toolName: "compaction_handoff",
+        content: JSON.stringify({
+            task: "Compaction handoff from pi auto-compaction",
+            manifest,
+            branchEntries: event.branchEntries?.length ?? 0,
+        }, null, 2),
+        domainTags: ["hamr", "compaction"],
+    });
+}
+/**
+ * Memory extension: FTS5 memory tools (search/save/handoff), message storage,
+ * a two-path compaction strategy, and the turn counter. Orthogonal to session
+ * topology — purely about persistence.
+ */
+export const hamrMemoryExtension = async (pi) => {
+    registerMemoryTools(pi);
+    registerHandoffTool(pi);
+    // Cloud vs local is decided from the startup config (loaded once — compaction
+    // is rare and the config is just a TOML read).
+    const config = loadHamrStartupConfig(process.cwd());
+    // Store every completed message into FTS5 memory.
+    pi.on("message_end", (event, ctx) => {
+        storeMessage(ctx, event.message);
+    });
+    // Two-path compaction. Cloud models have headroom for pi's LLM summary, so we
+    // only record a bookkeeping manifest and let pi proceed. Local/relay models
+    // do NOT have headroom near the limit — instead of an LLM call we emit a small
+    // survival manifest that maps back into FTS5, and hand it to pi as the
+    // compaction override so it becomes the resumed session's carried context.
+    pi.on("session_before_compact", (event, ctx) => {
+        const memory = getMemory(ctx);
+        if (!memory)
+            return; // FTS5 unavailable → silent no-op, pi handles it.
+        const provider = ctx.model?.provider;
+        // Missing model → treat as cloud (safe default: pi handles compaction).
+        const cloud = !provider || isCloudProvider(config, provider);
+        const policy = selectCompactionPolicy({ cloud, contextWindow: ctx.model?.contextWindow });
+        if (cloud) {
+            storeCompactionHandoff(memory, ctx, event);
+            return; // undefined → pi runs its default LLM compaction.
+        }
+        const manifest = buildSurvivalManifest(event.preparation.messagesToSummarize, policy);
+        memory.store({
+            sessionId: ctx.sessionManager.getSessionId(),
+            turnId: 0,
+            role: "tool",
+            toolName: "survival_manifest",
+            content: manifest,
+            domainTags: ["hamr", "survival", "compaction"],
+        });
+        return {
+            compaction: {
+                summary: manifest,
+                firstKeptEntryId: event.preparation.firstKeptEntryId,
+                tokensBefore: event.preparation.tokensBefore,
+            },
+        };
+    });
+    // Context injection: auto-search memory and prepend retrieved context for
+    // resumed sessions. A survival manifest (if any) is surfaced first and
+    // prominently. Skipped entirely when there is nothing to inject.
+    pi.on("context", (event, ctx) => {
+        const memory = getMemory(ctx);
+        if (!memory)
+            return;
+        const index = memory.buildMemoryIndex();
+        if (!index)
+            return;
+        const sessionId = ctx.sessionManager.getSessionId();
+        // Skip auto-retrieval on the first prompt of a new session — there's
+        // nothing to retrieve yet and pulling results from prior sessions just
+        // confuses the model.
+        if (!memory.hasSessionEntries(sessionId))
+            return;
+        const survival = memory.getLatestByDomainTag("survival", sessionId);
+        const survivalManifest = survival?.content ?? null;
+        const provider = ctx.model?.provider;
+        const cloud = !provider || isCloudProvider(config, provider);
+        const policy = selectCompactionPolicy({ cloud, contextWindow: ctx.model?.contextWindow });
+        const terms = memory.getSuggestedSearchTerms();
+        const autoResults = [];
+        for (const term of terms.slice(0, policy.searchTermLimit)) {
+            const results = memory.searchWithSnippets(term, policy.resultsPerTerm);
+            if (results.length > 0) {
+                autoResults.push(`// Search "${term}": ${results.length} results`, ...results.map((r) => `//   turn ${r.turnId} ${r.role}${r.toolName ? `/${r.toolName}` : ""}: ${sanitizeMemoryTranscriptText(r.snippet || r.content.slice(0, policy.snippetChars))}`));
+            }
+        }
+        const message = buildMemoryContextMessage(autoResults, index, { survivalManifest });
+        if (!message)
+            return;
+        return { messages: [message, ...event.messages] };
+    });
+    // Advance the memory turn counter at the end of each turn.
+    pi.on("turn_end", (event) => {
+        setCurrentTurnId(event.turnIndex + 1);
+    });
+};
+//# sourceMappingURL=memory.js.map

package/dist/hamr/extensions/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/hamr/extensions/memory.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@hamr/agent\";\nimport type { AssistantMessage, TextContent, ToolCall, ToolResultMessage } from \"@hamr/ai\";\nimport type { ExtensionContext, ExtensionFactory, SessionBeforeCompactEvent } from \"../../core/extensions/types.ts\";\nimport { registerHandoffTool } from \"../handoff/HandoffManager.ts\";\nimport { contentText } from \"../helpers.ts\";\nimport type { HolographicMemory } from \"../memory/HolographicMemory.ts\";\nimport {\n\tgetMemory,\n\tregisterMemoryTools,\n\tsanitizeMemoryTranscriptText,\n\tsetCurrentTurnId,\n\tstoreMessage,\n} from \"../memory.ts\";\nimport { isCloudProvider, loadHamrStartupConfig } from \"../startup-config.ts\";\n\n/**\n * Builds the user message injected into context from FTS5 auto-retrieval.\n *\n * A survival manifest (from a prior local-model compaction) is surfaced first\n * and prominently — it is the resumed instance's primary orientation, not a\n * generic search hit. Returns null only when there is nothing worth injecting.\n */\nexport function buildMemoryContextMessage(\n\tautoResults: string[],\n\tindex: string,\n\toptions: { survivalManifest?: string | null; timestamp?: number } = {},\n): { role: \"user\"; content: string; timestamp: number } | null {\n\tconst { survivalManifest, timestamp = Date.now() } = options;\n\tif (autoResults.length === 0 && !survivalManifest) return null;\n\n\tconst sections: string[] = [];\n\tif (survivalManifest) {\n\t\tsections.push(\n\t\t\t`\\nSURVIVAL MANIFEST (most recent local-model compaction — your primary orientation; use search_memory on the keys to recover full detail):\\n${survivalManifest}`,\n\t\t);\n\t}\n\tif (autoResults.length > 0) {\n\t\tsections.push(`\\nAuto-retrieved context from prior sessions:\\n${autoResults.join(\"\\n\")}`);\n\t}\n\tsections.push(`\\n${index}`);\n\treturn { role: \"user\", content: sections.join(\"\\n\"), timestamp };\n}\n\n// ─── Local compaction tiers ─────────────────────────────────────────────────\n\nexport type LocalCompactionTier = \"cloud\" | \"local-131k\" | \"local-64k\" | \"local-32k\" | \"local-16k\";\n\nexport interface LocalCompactionPolicy {\n\ttier: LocalCompactionTier;\n\tcontextWindow: number;\n\tkeyLimit: number;\n\tsearchTermLimit: number;\n\tresultsPerTerm: number;\n\tsnippetChars: number;\n\tinstructions: string;\n}\n\nexport function selectCompactionPolicy(options: { cloud: boolean; contextWindow?: number }): LocalCompactionPolicy {\n\tconst contextWindow = options.contextWindow && options.contextWindow > 0 ? options.contextWindow : 16_384;\n\tif (options.cloud) {\n\t\treturn {\n\t\t\ttier: \"cloud\",\n\t\t\tcontextWindow,\n\t\t\tkeyLimit: 8,\n\t\t\tsearchTermLimit: 5,\n\t\t\tresultsPerTerm: 3,\n\t\t\tsnippetChars: 180,\n\t\t\tinstructions: \"Use pi's default LLM compaction; FTS5 stores a structured bookkeeping handoff.\",\n\t\t};\n\t}\n\tif (contextWindow >= 96_000) {\n\t\treturn {\n\t\t\ttier: \"local-131k\",\n\t\t\tcontextWindow,\n\t\t\tkeyLimit: 10,\n\t\t\tsearchTermLimit: 6,\n\t\t\tresultsPerTerm: 3,\n\t\t\tsnippetChars: 180,\n\t\t\tinstructions:\n\t\t\t\t\"Large local context: keep a compact structured handoff and recover deeper provenance from FTS5 only as needed.\",\n\t\t};\n\t}\n\tif (contextWindow >= 49_152) {\n\t\treturn {\n\t\t\ttier: \"local-64k\",\n\t\t\tcontextWindow,\n\t\t\tkeyLimit: 12,\n\t\t\tsearchTermLimit: 5,\n\t\t\tresultsPerTerm: 2,\n\t\t\tsnippetChars: 160,\n\t\t\tinstructions: \"Medium local context: prefer targeted FTS5 recovery over broad automatic replay.\",\n\t\t};\n\t}\n\tif (contextWindow >= 24_576) {\n\t\treturn {\n\t\t\ttier: \"local-32k\",\n\t\t\tcontextWindow,\n\t\t\tkeyLimit: 14,\n\t\t\tsearchTermLimit: 4,\n\t\t\tresultsPerTerm: 2,\n\t\t\tsnippetChars: 140,\n\t\t\tinstructions:\n\t\t\t\t\"Small local context: carry only decisions/status plus search keys; call search_memory for details.\",\n\t\t};\n\t}\n\treturn {\n\t\ttier: \"local-16k\",\n\t\tcontextWindow,\n\t\tkeyLimit: 16,\n\t\tsearchTermLimit: 3,\n\t\tresultsPerTerm: 1,\n\t\tsnippetChars: 120,\n\t\tinstructions:\n\t\t\t\"Tiny local context: do not replay history. Use the manifest as a map, then recover one key at a time with search_memory.\",\n\t};\n}\n\n// ─── Survival manifest ─────────────────────────────────────────────────────\n\n/**\n * The survival manifest is NOT a summary — it is a small map back into FTS5 for\n * a local/relay model that cannot afford an LLM compaction call near its limit.\n * Its job is to carry the few things a cold-resumed instance can't reconstruct\n * by searching: the verbatim task, ground-truth status, the planned next action,\n * and a handful of specific FTS5 keys that each recover something important.\n */\nexport interface SurvivalData {\n\t/** Tier policy selected for this compaction. */\n\ttier: LocalCompactionTier;\n\t/** Context window used to select the tier. */\n\tcontextWindow: number;\n\t/** Verbatim goal — can't be searched for because the resumed instance doesn't know the words. */\n\ttask: string;\n\t/** Ground truth right now: files modified, last command + result, branch. */\n\tstatus: string[];\n\t/** The next concrete action that was planned (lives only in the last assistant message). */\n\tnext: string;\n\t/** 4-8 specific FTS5 search terms that each recover something important. */\n\tkeys: string[];\n\t/** Files and identifiers that explain where the keys came from. */\n\tprovenance: string[];\n\t/** Recovery guidance tuned for the selected tier. */\n\tinstructions: string;\n}\n\nconst INTENT_RE = /\\b(i'?ll|i will|let me|let'?s|going to|next,? i|next step|the fix|plan to|need to|then i)\\b/i;\nconst EDIT_TOOLS = new Set([\"edit\", \"write\", \"str_replace\", \"str_replace_editor\", \"create_file\", \"apply_patch\"]);\nconst PATH_ARG_KEYS = [\"file_path\", \"path\", \"filePath\", \"filename\", \"file\"];\n\nfunction assistantText(message: AssistantMessage): string {\n\treturn message.content\n\t\t.filter((part): part is TextContent => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\")\n\t\t.trim();\n}\n\nfunction toolCalls(message: AssistantMessage): ToolCall[] {\n\treturn message.content.filter((part): part is ToolCall => part.type === \"toolCall\");\n}\n\nfunction argPath(args: Record<string, unknown> | undefined): string | undefined {\n\tif (!args) return undefined;\n\tfor (const key of PATH_ARG_KEYS) {\n\t\tconst value = args[key];\n\t\tif (typeof value === \"string\" && value.trim()) return value.trim();\n\t}\n\treturn undefined;\n}\n\nfunction splitSentences(text: string): string[] {\n\treturn text\n\t\t.split(/(?<=[.!?])\\s+|\\n+/)\n\t\t.map((s) => s.trim())\n\t\t.filter(Boolean);\n}\n\nfunction truncate(text: string, max: number): string {\n\tconst clean = text.replace(/\\s+/g, \" \").trim();\n\treturn clean.length > max ? `${clean.slice(0, max - 1)}…` : clean;\n}\n\n/** Parse a `git switch`/`git checkout [-b]` command into the target branch name. */\nfunction parseBranch(command: string): string | undefined {\n\tconst match = command.match(/git\\s+(?:switch|checkout)\\s+(?:-[bc]\\s+)?([\\w./-]+)/);\n\tconst name = match?.[1];\n\tif (!name || name === \"-\" || name.startsWith(\"-\")) return undefined;\n\treturn name;\n}\n\n/** Extract the first specific error line from tool-result text. */\nfunction firstErrorLine(text: string): string | undefined {\n\tfor (const raw of text.split(\"\\n\")) {\n\t\tconst line = raw.trim();\n\t\tif (line.length < 8 || line.length > 200) continue;\n\t\tif (/\\b(error|failed|failure|exception|cannot|not found|undefined)\\b/i.test(line)) {\n\t\t\treturn truncate(line, 160);\n\t\t}\n\t}\n\treturn undefined;\n}\n\n/** Backticked tokens are how assistants name the specific identifiers central to the work. */\nfunction backtickedIdentifiers(text: string): string[] {\n\tconst out: string[] = [];\n\tfor (const match of text.matchAll(/`([^`\\n]{2,60})`/g)) {\n\t\tconst token = match[1].trim();\n\t\t// Keep specific identifiers/paths; drop prose-y multi-word backtick spans.\n\t\tif (token && !/\\s/.test(token)) out.push(token);\n\t}\n\treturn out;\n}\n\nexport function extractSurvivalData(\n\tmessages: AgentMessage[],\n\tpolicy: LocalCompactionPolicy = selectCompactionPolicy({ cloud: false, contextWindow: 16_384 }),\n): SurvivalData {\n\tconst assistants: AssistantMessage[] = [];\n\tconst orderedCalls: ToolCall[] = [];\n\tconst resultsByCallId = new Map<string, { isError: boolean; text: string }>();\n\tlet firstUserText = \"\";\n\n\tfor (const message of messages) {\n\t\tif (message.role === \"user\") {\n\t\t\tconst text = contentText((message as { content: unknown }).content).trim();\n\t\t\tif (!firstUserText && text) firstUserText = text;\n\t\t} else if (message.role === \"assistant\") {\n\t\t\tconst assistant = message as AssistantMessage;\n\t\t\tassistants.push(assistant);\n\t\t\tfor (const call of toolCalls(assistant)) orderedCalls.push(call);\n\t\t} else if (message.role === \"toolResult\") {\n\t\t\tconst result = message as ToolResultMessage;\n\t\t\tresultsByCallId.set(result.toolCallId, { isError: result.isError, text: contentText(result.content) });\n\t\t}\n\t}\n\n\t// Task: the verbatim goal. The user's first message is the truest source;\n\t// fall back to the earliest assistant text when no user message survived.\n\tconst firstAssistantText = assistants.map(assistantText).find((t) => t.length > 0) ?? \"\";\n\tconst taskSource = firstUserText || firstAssistantText;\n\tconst task = taskSource ? truncate(splitSentences(taskSource).slice(0, 2).join(\" \"), 240) : \"(task not recovered)\";\n\n\t// Next: the planned action lives in the last assistant message(s).\n\tlet next = \"\";\n\tfor (let i = assistants.length - 1; i >= 0 && !next; i--) {\n\t\tconst sentences = splitSentences(assistantText(assistants[i]));\n\t\tconst intent = sentences.find((s) => INTENT_RE.test(s));\n\t\tif (intent) next = truncate(intent, 200);\n\t}\n\tif (!next) next = \"(no explicit next action recorded)\";\n\n\t// Status: ground truth from tool calls/results.\n\tconst modified = new Set<string>();\n\tlet lastBash: { command: string; result?: { isError: boolean; text: string } } | undefined;\n\tlet branch: string | undefined;\n\tfor (const call of orderedCalls) {\n\t\tif (EDIT_TOOLS.has(call.name)) {\n\t\t\tconst path = argPath(call.arguments);\n\t\t\tif (path) modified.add(path);\n\t\t} else if (call.name === \"bash\" && typeof call.arguments?.command === \"string\") {\n\t\t\tconst command = call.arguments.command as string;\n\t\t\tlastBash = { command, result: resultsByCallId.get(call.id) };\n\t\t\tconst parsed = parseBranch(command);\n\t\t\tif (parsed) branch = parsed;\n\t\t}\n\t}\n\n\tconst status: string[] = [];\n\tif (modified.size > 0) status.push(`modified: ${Array.from(modified).slice(0, 8).join(\", \")}`);\n\tif (lastBash) {\n\t\tconst outcome = lastBash.result ? (lastBash.result.isError ? \"failed\" : \"succeeded\") : \"result unknown\";\n\t\tstatus.push(`last command: \\`${truncate(lastBash.command, 100)}\\` (${outcome})`);\n\t}\n\tif (branch) status.push(`branch: ${branch}`);\n\n\t// Keys: specific terms that each recover something lossless from FTS5.\n\tconst keys: string[] = [];\n\tconst provenance: string[] = [];\n\tconst seen = new Set<string>();\n\tconst add = (candidate: string | undefined): void => {\n\t\tif (keys.length >= policy.keyLimit || !candidate) return;\n\t\tconst value = candidate.trim();\n\t\tif (!value || value.length > 160 || seen.has(value.toLowerCase())) return;\n\t\tseen.add(value.toLowerCase());\n\t\tkeys.push(value);\n\t};\n\tconst addProvenance = (candidate: string | undefined): void => {\n\t\tif (!candidate || provenance.length >= 12) return;\n\t\tconst value = candidate.trim();\n\t\tif (!value || provenance.some((p) => p.toLowerCase() === value.toLowerCase())) return;\n\t\tprovenance.push(value);\n\t};\n\n\t// 1. Exact error strings being fought.\n\tfor (const { isError, text } of resultsByCallId.values()) {\n\t\tif (keys.length >= policy.keyLimit) break;\n\t\tif (isError || /\\b(error|failed|exception)\\b/i.test(text)) add(firstErrorLine(text));\n\t}\n\t// 2. Specific file paths actively being worked in.\n\tfor (const call of orderedCalls) {\n\t\tif (keys.length >= policy.keyLimit) break;\n\t\tconst path = argPath(call.arguments);\n\t\tadd(path);\n\t\taddProvenance(path);\n\t}\n\t// 3. Specific identifiers / decisions named in assistant text.\n\tfor (const assistant of assistants) {\n\t\tif (keys.length >= policy.keyLimit) break;\n\t\tfor (const id of backtickedIdentifiers(assistantText(assistant))) add(id);\n\t}\n\n\tfor (const call of orderedCalls.slice(-8)) {\n\t\taddProvenance(`${call.name}${argPath(call.arguments) ? `:${argPath(call.arguments)}` : \"\"}`);\n\t}\n\n\treturn {\n\t\ttier: policy.tier,\n\t\tcontextWindow: policy.contextWindow,\n\t\ttask,\n\t\tstatus,\n\t\tnext,\n\t\tkeys,\n\t\tprovenance,\n\t\tinstructions: policy.instructions,\n\t};\n}\n\nexport function formatSurvivalManifest(data: SurvivalData): string {\n\tconst lines = [\n\t\t\"## Survival manifest (local-model compaction)\",\n\t\t`Tier: ${data.tier} (${data.contextWindow.toLocaleString()} token window)`,\n\t\t`Task: ${data.task}`,\n\t\t`Recovery: ${data.instructions}`,\n\t];\n\tif (data.status.length > 0) {\n\t\tlines.push(\"Status:\", ...data.status.map((s) => `- ${s}`));\n\t} else {\n\t\tlines.push(\"Status: (no concrete state recorded)\");\n\t}\n\tlines.push(`Next: ${data.next}`);\n\tif (data.keys.length > 0) {\n\t\tlines.push(\"Search keys (use search_memory to recover full detail from FTS5):\");\n\t\tfor (const key of data.keys) lines.push(`- ${key}`);\n\t}\n\tif (data.provenance.length > 0) {\n\t\tlines.push(\"Provenance anchors:\");\n\t\tfor (const item of data.provenance) lines.push(`- ${item}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/** Build the survival manifest string for a set of messages about to be discarded. */\nexport function buildSurvivalManifest(messages: AgentMessage[], policy?: LocalCompactionPolicy): string {\n\treturn formatSurvivalManifest(extractSurvivalData(messages, policy));\n}\n\n/**\n * Cloud bookkeeping handoff: a lightweight manifest stored in FTS5 so the\n * resumed (LLM-summarized) session still has structured search hooks. Cloud\n * models keep pi's default compaction, so this never overrides the summary.\n */\nfunction storeCompactionHandoff(\n\tmemory: HolographicMemory,\n\tctx: ExtensionContext,\n\tevent: SessionBeforeCompactEvent,\n): void {\n\tconst manifest = memory.handoff();\n\tmemory.store({\n\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\tturnId: 0,\n\t\trole: \"tool\",\n\t\ttoolName: \"compaction_handoff\",\n\t\tcontent: JSON.stringify(\n\t\t\t{\n\t\t\t\ttask: \"Compaction handoff from pi auto-compaction\",\n\t\t\t\tmanifest,\n\t\t\t\tbranchEntries: event.branchEntries?.length ?? 0,\n\t\t\t},\n\t\t\tnull,\n\t\t\t2,\n\t\t),\n\t\tdomainTags: [\"hamr\", \"compaction\"],\n\t});\n}\n\n/**\n * Memory extension: FTS5 memory tools (search/save/handoff), message storage,\n * a two-path compaction strategy, and the turn counter. Orthogonal to session\n * topology — purely about persistence.\n */\nexport const hamrMemoryExtension: ExtensionFactory = async (pi) => {\n\tregisterMemoryTools(pi);\n\tregisterHandoffTool(pi);\n\n\t// Cloud vs local is decided from the startup config (loaded once — compaction\n\t// is rare and the config is just a TOML read).\n\tconst config = loadHamrStartupConfig(process.cwd());\n\n\t// Store every completed message into FTS5 memory.\n\tpi.on(\"message_end\", (event, ctx) => {\n\t\tstoreMessage(ctx, event.message);\n\t});\n\n\t// Two-path compaction. Cloud models have headroom for pi's LLM summary, so we\n\t// only record a bookkeeping manifest and let pi proceed. Local/relay models\n\t// do NOT have headroom near the limit — instead of an LLM call we emit a small\n\t// survival manifest that maps back into FTS5, and hand it to pi as the\n\t// compaction override so it becomes the resumed session's carried context.\n\tpi.on(\"session_before_compact\", (event, ctx) => {\n\t\tconst memory = getMemory(ctx);\n\t\tif (!memory) return; // FTS5 unavailable → silent no-op, pi handles it.\n\n\t\tconst provider = ctx.model?.provider;\n\t\t// Missing model → treat as cloud (safe default: pi handles compaction).\n\t\tconst cloud = !provider || isCloudProvider(config, provider);\n\t\tconst policy = selectCompactionPolicy({ cloud, contextWindow: ctx.model?.contextWindow });\n\t\tif (cloud) {\n\t\t\tstoreCompactionHandoff(memory, ctx, event);\n\t\t\treturn; // undefined → pi runs its default LLM compaction.\n\t\t}\n\n\t\tconst manifest = buildSurvivalManifest(event.preparation.messagesToSummarize, policy);\n\t\tmemory.store({\n\t\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\t\tturnId: 0,\n\t\t\trole: \"tool\",\n\t\t\ttoolName: \"survival_manifest\",\n\t\t\tcontent: manifest,\n\t\t\tdomainTags: [\"hamr\", \"survival\", \"compaction\"],\n\t\t});\n\t\treturn {\n\t\t\tcompaction: {\n\t\t\t\tsummary: manifest,\n\t\t\t\tfirstKeptEntryId: event.preparation.firstKeptEntryId,\n\t\t\t\ttokensBefore: event.preparation.tokensBefore,\n\t\t\t},\n\t\t};\n\t});\n\n\t// Context injection: auto-search memory and prepend retrieved context for\n\t// resumed sessions. A survival manifest (if any) is surfaced first and\n\t// prominently. Skipped entirely when there is nothing to inject.\n\tpi.on(\"context\", (event, ctx) => {\n\t\tconst memory = getMemory(ctx);\n\t\tif (!memory) return;\n\t\tconst index = memory.buildMemoryIndex();\n\t\tif (!index) return;\n\n\t\tconst sessionId = ctx.sessionManager.getSessionId();\n\n\t\t// Skip auto-retrieval on the first prompt of a new session — there's\n\t\t// nothing to retrieve yet and pulling results from prior sessions just\n\t\t// confuses the model.\n\t\tif (!memory.hasSessionEntries(sessionId)) return;\n\n\t\tconst survival = memory.getLatestByDomainTag(\"survival\", sessionId);\n\t\tconst survivalManifest = survival?.content ?? null;\n\t\tconst provider = ctx.model?.provider;\n\t\tconst cloud = !provider || isCloudProvider(config, provider);\n\t\tconst policy = selectCompactionPolicy({ cloud, contextWindow: ctx.model?.contextWindow });\n\n\t\tconst terms = memory.getSuggestedSearchTerms();\n\t\tconst autoResults: string[] = [];\n\t\tfor (const term of terms.slice(0, policy.searchTermLimit)) {\n\t\t\tconst results = memory.searchWithSnippets(term, policy.resultsPerTerm);\n\t\t\tif (results.length > 0) {\n\t\t\t\tautoResults.push(\n\t\t\t\t\t`// Search \"${term}\": ${results.length} results`,\n\t\t\t\t\t...results.map(\n\t\t\t\t\t\t(r) =>\n\t\t\t\t\t\t\t`//   turn ${r.turnId} ${r.role}${r.toolName ? `/${r.toolName}` : \"\"}: ${sanitizeMemoryTranscriptText(\n\t\t\t\t\t\t\t\tr.snippet || r.content.slice(0, policy.snippetChars),\n\t\t\t\t\t\t\t)}`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tconst message = buildMemoryContextMessage(autoResults, index, { survivalManifest });\n\t\tif (!message) return;\n\t\treturn { messages: [message, ...event.messages] };\n\t});\n\n\t// Advance the memory turn counter at the end of each turn.\n\tpi.on(\"turn_end\", (event) => {\n\t\tsetCurrentTurnId(event.turnIndex + 1);\n\t});\n};\n"]}

package/dist/hamr/extensions/providers.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionFactory } from "../../core/extensions/types.ts";
+/**
+ * Providers/relay extension: registers hamr's configured providers, repairs
+ * local-model tool calls, drives the relay cold-start indicator, and surfaces
+ * turn failures. This is hamr's "identity" layer — relay/local model support.
+ */
+export declare const hamrProvidersExtension: ExtensionFactory;
+//# sourceMappingURL=providers.d.ts.map

package/dist/hamr/extensions/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/hamr/extensions/providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AA2BvE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAqDpC,CAAC"}

package/dist/hamr/extensions/providers.js

@@ -0,0 +1,81 @@
+import { hasSubstantialContent, registerHamrProviders, repairLocalToolCalls } from "../repair.js";
+import { RAINBOW_WORD_FRAMES } from "../shimmer.js";
+import { loadHamrStartupConfig } from "../startup-config.js";
+const COLD_START_TIMEOUT_MS = 5_000;
+let coldStartTimer = null;
+let hasReceivedContent = false;
+function clearColdStartTimer() {
+    if (coldStartTimer !== null) {
+        clearTimeout(coldStartTimer);
+        coldStartTimer = null;
+    }
+}
+/** Condense a raw turn-error message (which may be a 502 HTML page) to one line. */
+function summarizeTurnError(raw) {
+    if (!raw)
+        return "unknown error";
+    const stripped = raw
+        .replace(/<[^>]*>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const text = stripped || raw.trim();
+    return text.length > 200 ? `${text.slice(0, 197)}…` : text;
+}
+/**
+ * Providers/relay extension: registers hamr's configured providers, repairs
+ * local-model tool calls, drives the relay cold-start indicator, and surfaces
+ * turn failures. This is hamr's "identity" layer — relay/local model support.
+ */
+export const hamrProvidersExtension = async (pi) => {
+    const config = loadHamrStartupConfig(process.cwd());
+    await registerHamrProviders(pi, config);
+    // Cold-start detection: show a warning if a relay/local model takes >5s for
+    // first content. Cloud models skip the cold-start logic entirely.
+    pi.on("message_start", (_event, ctx) => {
+        if (_event.message.role === "assistant") {
+            hasReceivedContent = false;
+            const model = ctx.model;
+            const isRelay = model?.provider === "relay" || model?.api === "relay";
+            if (!isRelay)
+                return;
+            clearColdStartTimer();
+            coldStartTimer = setTimeout(() => {
+                coldStartTimer = null;
+                if (!hasReceivedContent) {
+                    ctx.ui.setWorkingIndicator({ frames: ["Cold starting..."], intervalMs: 1000 });
+                }
+            }, COLD_START_TIMEOUT_MS);
+        }
+    });
+    pi.on("message_update", (_event, ctx) => {
+        if (_event.message.role !== "assistant")
+            return;
+        if (!hasReceivedContent && hasSubstantialContent(_event.assistantMessageEvent)) {
+            hasReceivedContent = true;
+            clearColdStartTimer();
+            ctx.ui.setWorkingIndicator({ frames: RAINBOW_WORD_FRAMES, intervalMs: 150 });
+        }
+    });
+    pi.on("session_shutdown", () => {
+        clearColdStartTimer();
+        hasReceivedContent = false;
+    });
+    // Repair local-model tool calls once a message completes.
+    pi.on("message_end", (event, ctx) => {
+        clearColdStartTimer();
+        hasReceivedContent = false;
+        if (event.message.role !== "assistant")
+            return;
+        const replacement = repairLocalToolCalls(event.message, ctx);
+        return replacement ? { message: replacement } : undefined;
+    });
+    // Surface a display-only note when a turn fails (relay 502/timeout, terminated
+    // stream, …). Does NOT inject a prompt back to the model or prefill the editor.
+    pi.on("turn_end", (event, ctx) => {
+        const message = event.message;
+        if (message.role === "assistant" && message.stopReason === "error") {
+            ctx.ui.notify(`Model request failed: ${summarizeTurnError(message.errorMessage)}`, "error");
+        }
+    });
+};
+//# sourceMappingURL=providers.js.map

package/dist/hamr/extensions/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/hamr/extensions/providers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage } from \"@hamr/ai\";\nimport type { ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport { hasSubstantialContent, registerHamrProviders, repairLocalToolCalls } from \"../repair.ts\";\nimport { RAINBOW_WORD_FRAMES } from \"../shimmer.ts\";\nimport { loadHamrStartupConfig } from \"../startup-config.ts\";\n\nconst COLD_START_TIMEOUT_MS = 5_000;\nlet coldStartTimer: ReturnType<typeof setTimeout> | null = null;\nlet hasReceivedContent = false;\n\nfunction clearColdStartTimer(): void {\n\tif (coldStartTimer !== null) {\n\t\tclearTimeout(coldStartTimer);\n\t\tcoldStartTimer = null;\n\t}\n}\n\n/** Condense a raw turn-error message (which may be a 502 HTML page) to one line. */\nfunction summarizeTurnError(raw: string | undefined): string {\n\tif (!raw) return \"unknown error\";\n\tconst stripped = raw\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\tconst text = stripped || raw.trim();\n\treturn text.length > 200 ? `${text.slice(0, 197)}…` : text;\n}\n\n/**\n * Providers/relay extension: registers hamr's configured providers, repairs\n * local-model tool calls, drives the relay cold-start indicator, and surfaces\n * turn failures. This is hamr's \"identity\" layer — relay/local model support.\n */\nexport const hamrProvidersExtension: ExtensionFactory = async (pi) => {\n\tconst config = loadHamrStartupConfig(process.cwd());\n\tawait registerHamrProviders(pi, config);\n\n\t// Cold-start detection: show a warning if a relay/local model takes >5s for\n\t// first content. Cloud models skip the cold-start logic entirely.\n\tpi.on(\"message_start\", (_event, ctx) => {\n\t\tif (_event.message.role === \"assistant\") {\n\t\t\thasReceivedContent = false;\n\t\t\tconst model: any = ctx.model;\n\t\t\tconst isRelay = model?.provider === \"relay\" || model?.api === \"relay\";\n\t\t\tif (!isRelay) return;\n\t\t\tclearColdStartTimer();\n\t\t\tcoldStartTimer = setTimeout(() => {\n\t\t\t\tcoldStartTimer = null;\n\t\t\t\tif (!hasReceivedContent) {\n\t\t\t\t\tctx.ui.setWorkingIndicator({ frames: [\"Cold starting...\"], intervalMs: 1000 });\n\t\t\t\t}\n\t\t\t}, COLD_START_TIMEOUT_MS);\n\t\t}\n\t});\n\n\tpi.on(\"message_update\", (_event, ctx) => {\n\t\tif (_event.message.role !== \"assistant\") return;\n\t\tif (!hasReceivedContent && hasSubstantialContent(_event.assistantMessageEvent)) {\n\t\t\thasReceivedContent = true;\n\t\t\tclearColdStartTimer();\n\t\t\tctx.ui.setWorkingIndicator({ frames: RAINBOW_WORD_FRAMES, intervalMs: 150 });\n\t\t}\n\t});\n\n\tpi.on(\"session_shutdown\", () => {\n\t\tclearColdStartTimer();\n\t\thasReceivedContent = false;\n\t});\n\n\t// Repair local-model tool calls once a message completes.\n\tpi.on(\"message_end\", (event, ctx) => {\n\t\tclearColdStartTimer();\n\t\thasReceivedContent = false;\n\t\tif (event.message.role !== \"assistant\") return;\n\t\tconst replacement = repairLocalToolCalls(event.message as AssistantMessage, ctx);\n\t\treturn replacement ? { message: replacement } : undefined;\n\t});\n\n\t// Surface a display-only note when a turn fails (relay 502/timeout, terminated\n\t// stream, …). Does NOT inject a prompt back to the model or prefill the editor.\n\tpi.on(\"turn_end\", (event, ctx) => {\n\t\tconst message = event.message;\n\t\tif (message.role === \"assistant\" && (message as AssistantMessage).stopReason === \"error\") {\n\t\t\tctx.ui.notify(`Model request failed: ${summarizeTurnError((message as AssistantMessage).errorMessage)}`, \"error\");\n\t\t}\n\t});\n};\n"]}

package/dist/hamr/extensions/read-loop-guard.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionFactory } from "../../core/extensions/types.ts";
+export declare const hamrReadLoopGuardExtension: ExtensionFactory;
+//# sourceMappingURL=read-loop-guard.d.ts.map

package/dist/hamr/extensions/read-loop-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-loop-guard.d.ts","sourceRoot":"","sources":["../../../src/hamr/extensions/read-loop-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,eAAO,MAAM,0BAA0B,EAAE,gBA2BxC,CAAC"}

package/dist/hamr/extensions/read-loop-guard.js

@@ -0,0 +1,26 @@
+const READ_ONLY_TOOLS = new Set(["read", "grep", "find", "ls"]);
+export const hamrReadLoopGuardExtension = (pi) => {
+    let readOnlyCounter = 0;
+    let lastNudge = 0;
+    pi.on("turn_end", (event, ctx) => {
+        const toolResults = event.toolResults ?? [];
+        if (toolResults.length === 0) {
+            readOnlyCounter = 0;
+            return;
+        }
+        const allReadOnly = toolResults.every((t) => READ_ONLY_TOOLS.has(t.toolName));
+        if (allReadOnly) {
+            readOnlyCounter++;
+            if (readOnlyCounter >= 5 && Date.now() - lastNudge > 30000) {
+                lastNudge = Date.now();
+                if (!ctx.isIdle()) {
+                    pi.sendUserMessage(`(You've done ${readOnlyCounter} consecutive read-only operations. If you have enough context, consider editing or writing.)`, { deliverAs: "steer" });
+                }
+            }
+        }
+        else {
+            readOnlyCounter = 0;
+        }
+    });
+};
+//# sourceMappingURL=read-loop-guard.js.map

package/dist/hamr/extensions/read-loop-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-loop-guard.js","sourceRoot":"","sources":["../../../src/hamr/extensions/read-loop-guard.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,0BAA0B,GAAqB,CAAC,EAAE,EAAE,EAAE;IAClE,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,eAAe,GAAG,CAAC,CAAC;YACpB,OAAO;QACR,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,IAAI,eAAe,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;gBAC5D,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;oBACnB,EAAE,CAAC,eAAe,CACjB,gBAAgB,eAAe,8FAA8F,EAC7H,EAAE,SAAS,EAAE,OAAO,EAAE,CACtB,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;aAAM,CAAC;YACP,eAAe,GAAG,CAAC,CAAC;QACrB,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import type { ExtensionFactory } from \"../../core/extensions/types.ts\";\n\nconst READ_ONLY_TOOLS = new Set([\"read\", \"grep\", \"find\", \"ls\"]);\n\nexport const hamrReadLoopGuardExtension: ExtensionFactory = (pi) => {\n\tlet readOnlyCounter = 0;\n\tlet lastNudge = 0;\n\n\tpi.on(\"turn_end\", (event, ctx) => {\n\t\tconst toolResults = event.toolResults ?? [];\n\t\tif (toolResults.length === 0) {\n\t\t\treadOnlyCounter = 0;\n\t\t\treturn;\n\t\t}\n\n\t\tconst allReadOnly = toolResults.every((t) => READ_ONLY_TOOLS.has(t.toolName));\n\t\tif (allReadOnly) {\n\t\t\treadOnlyCounter++;\n\t\t\tif (readOnlyCounter >= 5 && Date.now() - lastNudge > 30000) {\n\t\t\t\tlastNudge = Date.now();\n\t\t\t\tif (!ctx.isIdle()) {\n\t\t\t\t\tpi.sendUserMessage(\n\t\t\t\t\t\t`(You've done ${readOnlyCounter} consecutive read-only operations. If you have enough context, consider editing or writing.)`,\n\t\t\t\t\t\t{ deliverAs: \"steer\" },\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\treadOnlyCounter = 0;\n\t\t}\n\t});\n};\n"]}

package/dist/hamr/extensions/subagents.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionFactory } from "../../core/extensions/types.ts";
+/**
+ * Subagents extension: the `delegate_subagents` tool, a fork-per-worker executor,
+ * and a small live status line above the editor.
+ *
+ * A subagent is a SERIAL pi worker spawned as a fork of the live session
+ * (`SessionManager.forkFrom`) — a real node in the session tree, observable the
+ * pi-native way: the tool result expands (Ctrl+O) to each worker's handoff, and
+ * the worker forks are navigable in the session selector (nested under the parent).
+ * Recursion is bounded by depth: at MAX_DEPTH a worker gets no delegate tool.
+ */
+/** Marks the subagents factory so a parent can re-create it at depth + 1 for workers. */
+export declare const HAMR_SUBAGENTS_FACTORY: unique symbol;
+export declare function createHamrSubagentsExtension(getChildExtensions: () => ExtensionFactory[], depth?: number): ExtensionFactory;
+//# sourceMappingURL=subagents.d.ts.map