@skaft/hamr 0.4.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../../src/hamr/extensions/subagents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAUzF;;;;;;;;;GASG;AAEH,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,eAAuC,CAAC;AAqR3E,wBAAgB,4BAA4B,CAC3C,kBAAkB,EAAE,MAAM,gBAAgB,EAAE,EAC5C,KAAK,SAAI,GACP,gBAAgB,CAelB"}

package/dist/hamr/extensions/subagents.js

@@ -0,0 +1,264 @@
+import { Text } from "@hamr/tui";
+import { Type } from "typebox";
+import { getAgentDir } from "../../config.js";
+import { defineTool } from "../../core/extensions/types.js";
+import { DefaultResourceLoader } from "../../core/resource-loader.js";
+import { createAgentSession } from "../../core/sdk.js";
+import { SessionManager } from "../../core/session-manager.js";
+import { SettingsManager } from "../../core/settings-manager.js";
+import { getAssistantText } from "../helpers.js";
+import { getCurrentTurnId, getMemory } from "../memory.js";
+/**
+ * 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 const HAMR_SUBAGENTS_FACTORY = Symbol.for("hamr.subagents.factory");
+/** Recursion bound. Root = 0; at this depth the worker gets no delegate tool. */
+const MAX_DEPTH = 3;
+const subagentRuns = new Map();
+let runCounter = 0;
+function nextRunId() {
+    return `subagent-${Date.now()}-${++runCounter}`;
+}
+const RUNNING_FRAMES = ["◐", "◓", "◑", "◒"];
+function animationFrame() {
+    return RUNNING_FRAMES[Math.floor(Date.now() / 180) % RUNNING_FRAMES.length];
+}
+function formatTokens(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(1)}m`;
+    if (tokens >= 10_000)
+        return `${Math.round(tokens / 1000)}k`;
+    if (tokens >= 1000)
+        return `${(tokens / 1000).toFixed(1)}k`;
+    return `${tokens}`;
+}
+function summarizeRuns() {
+    return Array.from(subagentRuns.values()).reduce((acc, run) => {
+        acc[run.status] += 1;
+        acc.totalTokens += run.usage?.totalTokens ?? 0;
+        return acc;
+    }, { running: 0, done: 0, failed: 0, totalTokens: 0 });
+}
+function renderStatusLine() {
+    if (subagentRuns.size === 0)
+        return undefined;
+    const counts = summarizeRuns();
+    const parts = [];
+    if (counts.running > 0)
+        parts.push(`${animationFrame()} ${counts.running} working`);
+    if (counts.done > 0)
+        parts.push(`✓ ${counts.done} done`);
+    if (counts.failed > 0)
+        parts.push(`✕ ${counts.failed} failed`);
+    if (counts.totalTokens > 0)
+        parts.push(`${formatTokens(counts.totalTokens)} tok`);
+    return `subagents ${parts.join(" · ")}`;
+}
+/** Animated one-liner above the editor showing workers working / done. */
+class AgentStatusWidget {
+    constructor(tui, theme) {
+        this.tui = tui;
+        this.theme = theme;
+        this.interval = setInterval(() => {
+            if (summarizeRuns().running > 0)
+                this.tui.requestRender();
+        }, 180);
+    }
+    render() {
+        const line = renderStatusLine();
+        return line ? [` ${this.theme.fg("muted", line)}`] : [];
+    }
+    invalidate() { }
+    dispose() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+    }
+}
+function updateStatusWidget(ctx) {
+    if (ctx.mode !== "tui")
+        return;
+    const widget = renderStatusLine() ? (tui, theme) => new AgentStatusWidget(tui, theme) : undefined;
+    ctx.ui.setWidget("hamr.subagents.status", widget, { placement: "aboveEditor" });
+}
+async function runOneSubagent(pi, task, signal, ctx, getChildExtensions) {
+    const runId = nextRunId();
+    const name = task.slice(0, 48);
+    subagentRuns.set(runId, { name, status: "running", task, startedAt: Date.now() });
+    updateStatusWidget(ctx);
+    const prompt = [
+        "You are a focused Hamr subagent. Complete only the delegated task and return a concise handoff.",
+        `Task:\n${task}`,
+    ].join("\n\n");
+    try {
+        const agentDir = getAgentDir();
+        const settingsManager = SettingsManager.create(ctx.cwd, agentDir);
+        const resourceLoader = new DefaultResourceLoader({
+            cwd: ctx.cwd,
+            agentDir,
+            settingsManager,
+            extensionFactories: getChildExtensions(),
+        });
+        await resourceLoader.reload();
+        // Fork the live session into a real node in the session tree: the worker
+        // inherits the parent context and is navigable via the session selector
+        // (nested under the parent). Falls back to in-memory if not persisted.
+        const parentFile = ctx.sessionManager.getSessionFile();
+        const workerSessionManager = parentFile
+            ? SessionManager.forkFrom(parentFile, ctx.cwd, ctx.sessionManager.getSessionDir())
+            : SessionManager.inMemory(ctx.cwd);
+        const child = await createAgentSession({
+            cwd: ctx.cwd,
+            agentDir,
+            model: ctx.model,
+            thinkingLevel: pi.getThinkingLevel(),
+            modelRegistry: ctx.modelRegistry,
+            settingsManager,
+            resourceLoader,
+            sessionManager: workerSessionManager,
+        });
+        if (signal?.aborted) {
+            subagentRuns.set(runId, {
+                name,
+                status: "failed",
+                task,
+                startedAt: Date.now(),
+                endedAt: Date.now(),
+                error: "aborted",
+            });
+            updateStatusWidget(ctx);
+            return { task, text: "Subagent aborted before start.", error: "aborted" };
+        }
+        await child.session.prompt(prompt, { source: "extension" });
+        const assistant = [...child.session.messages].reverse().find((m) => m.role === "assistant");
+        const text = assistant
+            ? getAssistantText(assistant) || "(subagent returned no text)"
+            : "(subagent returned no message)";
+        getMemory(ctx)?.store({
+            sessionId: ctx.sessionManager.getSessionId(),
+            turnId: getCurrentTurnId(),
+            role: "tool",
+            toolName: "delegate_subagent",
+            content: `Task: ${task}\n\n${text}`,
+            domainTags: ["hamr", "subagent"],
+        });
+        subagentRuns.set(runId, {
+            name,
+            status: "done",
+            task,
+            startedAt: subagentRuns.get(runId)?.startedAt ?? Date.now(),
+            endedAt: Date.now(),
+            usage: assistant?.usage,
+            result: text,
+        });
+        updateStatusWidget(ctx);
+        return { task, text };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        subagentRuns.set(runId, {
+            name,
+            status: "failed",
+            task,
+            startedAt: subagentRuns.get(runId)?.startedAt ?? Date.now(),
+            endedAt: Date.now(),
+            error: message,
+        });
+        updateStatusWidget(ctx);
+        return { task, text: `Subagent failed: ${message}`, error: message };
+    }
+}
+// ─── Tool ─────────────────────────────────────────────────────────────────────
+function registerSubagentTool(pi, getChildExtensions) {
+    pi.registerTool(defineTool({
+        name: "delegate_subagents",
+        label: "Subagents",
+        description: "Delegate one or more focused subtasks to worker subagents. Each worker is a fork of the current session that runs its narrow task and returns a handoff. Workers run one at a time (serial). Use to divide-and-conquer large efforts.",
+        promptSnippet: "Use delegate_subagents to hand focused subtasks to serial worker subagents.",
+        promptGuidelines: [
+            "Each subtask should be a clearly scoped, self-contained piece of work.",
+            "Workers run serially in order and cannot see each other's results; for dependent steps, call again after reading the handoffs.",
+            "Delegate only as many subtasks as the work genuinely warrants.",
+        ],
+        parameters: Type.Object({
+            subtasks: Type.Array(Type.Object({
+                task: Type.String({ description: "Focused, self-contained task for one worker subagent." }),
+            }), { description: "One or more subtasks, run in order.", minItems: 1 }),
+        }),
+        renderCall: (_args, theme) => new Text(theme.fg("toolTitle", theme.bold("delegate_subagents")), 0, 0),
+        renderResult: (result, options, theme) => {
+            const results = result.details?.results ?? [];
+            const failed = results.filter((r) => r.error && r.error !== "aborted").length;
+            const done = results.length - failed;
+            if (!options.expanded) {
+                const status = failed > 0
+                    ? `${done}/${results.length} done, ${failed} failed`
+                    : `${results.length} subagent${results.length !== 1 ? "s" : ""} done`;
+                return new Text(theme.fg("dim", status), 0, 0);
+            }
+            // Expanded: per-worker handoff — the pi-native way to observe each subagent.
+            const lines = results
+                .map((r, i) => {
+                const glyph = r.error ? theme.fg("error", "✕") : theme.fg("success", "✓");
+                const head = `${glyph} ${theme.fg("toolTitle", `${i + 1}. ${r.task.slice(0, 64)}`)}`;
+                return `${head}\n${theme.fg("toolOutput", r.text.slice(0, 1200))}`;
+            })
+                .join("\n\n");
+            return new Text(lines || theme.fg("dim", "(no subagents)"), 0, 0);
+        },
+        execute: async (_toolCallId, params, signal, onUpdate, ctx) => {
+            if (!ctx.model) {
+                return { content: [{ type: "text", text: "No current model is available for subagents." }], details: {} };
+            }
+            if (params.subtasks.length === 0) {
+                return { content: [{ type: "text", text: "No subtasks provided." }], details: {} };
+            }
+            // Fresh status for this call; serial — one forked worker at a time.
+            subagentRuns.clear();
+            const results = [];
+            const total = params.subtasks.length;
+            for (let i = 0; i < total; i++) {
+                onUpdate?.({
+                    content: [{ type: "text", text: `subagent ${i + 1}/${total}: ${params.subtasks[i].task.slice(0, 60)}` }],
+                    details: { results: [...results] },
+                });
+                results.push(await runOneSubagent(pi, params.subtasks[i].task, signal, ctx, getChildExtensions));
+                if (signal?.aborted)
+                    break;
+            }
+            const errors = results.filter((r) => r.error && r.error !== "aborted");
+            const summary = results
+                .map((r, i) => `${i + 1}. ${r.error ? "✗" : "✓"} ${r.task.slice(0, 60)}\n${r.text.slice(0, 300)}`)
+                .join("\n\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                details: { results },
+                ...(errors.length > 0 ? { isError: true } : {}),
+            };
+        },
+    }));
+}
+// ─── Extension factory ────────────────────────────────────────────────────────
+export function createHamrSubagentsExtension(getChildExtensions, depth = 0) {
+    const factory = async (pi) => {
+        // Leaf: no delegate tool, so recursion stops here.
+        if (depth >= MAX_DEPTH)
+            return;
+        // Workers load the identical set, with THIS factory bumped to depth + 1.
+        registerSubagentTool(pi, () => getChildExtensions().map((f) => f[HAMR_SUBAGENTS_FACTORY]
+            ? createHamrSubagentsExtension(getChildExtensions, depth + 1)
+            : f));
+    };
+    factory[HAMR_SUBAGENTS_FACTORY] = true;
+    return factory;
+}
+//# sourceMappingURL=subagents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../../../src/hamr/extensions/subagents.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage, Usage } from \"@hamr/ai\";\nimport { type Component, Text, type TUI } from \"@hamr/tui\";\nimport { Type } from \"typebox\";\nimport { getAgentDir } from \"../../config.ts\";\nimport type { ExtensionContext, ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport { defineTool } from \"../../core/extensions/types.ts\";\nimport { DefaultResourceLoader } from \"../../core/resource-loader.ts\";\nimport { createAgentSession } from \"../../core/sdk.ts\";\nimport { SessionManager } from \"../../core/session-manager.ts\";\nimport { SettingsManager } from \"../../core/settings-manager.ts\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport { getAssistantText } from \"../helpers.ts\";\nimport { getCurrentTurnId, getMemory } from \"../memory.ts\";\n\n/**\n * Subagents extension: the `delegate_subagents` tool, a fork-per-worker executor,\n * and a small live status line above the editor.\n *\n * A subagent is a SERIAL pi worker spawned as a fork of the live session\n * (`SessionManager.forkFrom`) — a real node in the session tree, observable the\n * pi-native way: the tool result expands (Ctrl+O) to each worker's handoff, and\n * the worker forks are navigable in the session selector (nested under the parent).\n * Recursion is bounded by depth: at MAX_DEPTH a worker gets no delegate tool.\n */\n\n/** Marks the subagents factory so a parent can re-create it at depth + 1 for workers. */\nexport const HAMR_SUBAGENTS_FACTORY = Symbol.for(\"hamr.subagents.factory\");\n\n/** Recursion bound. Root = 0; at this depth the worker gets no delegate tool. */\nconst MAX_DEPTH = 3;\n\n// ─── Live status (above the editor) ───────────────────────────────────────────\n\ntype SubagentRun = {\n\tname: string;\n\tstatus: \"running\" | \"done\" | \"failed\";\n\ttask: string;\n\tstartedAt: number;\n\tendedAt?: number;\n\tusage?: Usage;\n\tresult?: string;\n\terror?: string;\n};\n\nconst subagentRuns = new Map<string, SubagentRun>();\nlet runCounter = 0;\n\nfunction nextRunId(): string {\n\treturn `subagent-${Date.now()}-${++runCounter}`;\n}\n\nconst RUNNING_FRAMES = [\"◐\", \"◓\", \"◑\", \"◒\"];\nfunction animationFrame(): string {\n\treturn RUNNING_FRAMES[Math.floor(Date.now() / 180) % RUNNING_FRAMES.length]!;\n}\n\nfunction formatTokens(tokens: number): string {\n\tif (tokens >= 1_000_000) return `${(tokens / 1_000_000).toFixed(1)}m`;\n\tif (tokens >= 10_000) return `${Math.round(tokens / 1000)}k`;\n\tif (tokens >= 1000) return `${(tokens / 1000).toFixed(1)}k`;\n\treturn `${tokens}`;\n}\n\nfunction summarizeRuns(): { running: number; done: number; failed: number; totalTokens: number } {\n\treturn Array.from(subagentRuns.values()).reduce(\n\t\t(acc, run) => {\n\t\t\tacc[run.status] += 1;\n\t\t\tacc.totalTokens += run.usage?.totalTokens ?? 0;\n\t\t\treturn acc;\n\t\t},\n\t\t{ running: 0, done: 0, failed: 0, totalTokens: 0 },\n\t);\n}\n\nfunction renderStatusLine(): string | undefined {\n\tif (subagentRuns.size === 0) return undefined;\n\tconst counts = summarizeRuns();\n\tconst parts: string[] = [];\n\tif (counts.running > 0) parts.push(`${animationFrame()} ${counts.running} working`);\n\tif (counts.done > 0) parts.push(`✓ ${counts.done} done`);\n\tif (counts.failed > 0) parts.push(`✕ ${counts.failed} failed`);\n\tif (counts.totalTokens > 0) parts.push(`${formatTokens(counts.totalTokens)} tok`);\n\treturn `subagents ${parts.join(\" · \")}`;\n}\n\n/** Animated one-liner above the editor showing workers working / done. */\nclass AgentStatusWidget implements Component {\n\tprivate interval: ReturnType<typeof setInterval> | undefined;\n\tprivate tui: TUI;\n\tprivate theme: Theme;\n\n\tconstructor(tui: TUI, theme: Theme) {\n\t\tthis.tui = tui;\n\t\tthis.theme = theme;\n\t\tthis.interval = setInterval(() => {\n\t\t\tif (summarizeRuns().running > 0) this.tui.requestRender();\n\t\t}, 180);\n\t}\n\n\trender(): string[] {\n\t\tconst line = renderStatusLine();\n\t\treturn line ? [` ${this.theme.fg(\"muted\", line)}`] : [];\n\t}\n\n\tinvalidate(): void {}\n\n\tdispose(): void {\n\t\tif (this.interval) {\n\t\t\tclearInterval(this.interval);\n\t\t\tthis.interval = undefined;\n\t\t}\n\t}\n}\n\nfunction updateStatusWidget(ctx: ExtensionContext): void {\n\tif (ctx.mode !== \"tui\") return;\n\tconst widget = renderStatusLine() ? (tui: TUI, theme: Theme) => new AgentStatusWidget(tui, theme) : undefined;\n\tctx.ui.setWidget(\"hamr.subagents.status\", widget, { placement: \"aboveEditor\" });\n}\n\n// ─── Worker (fork of the live session) ────────────────────────────────────────\n\ntype SubagentResult = { task: string; text: string; error?: string };\n\nasync function runOneSubagent(\n\tpi: Parameters<ExtensionFactory>[0],\n\ttask: string,\n\tsignal: AbortSignal | undefined,\n\tctx: ExtensionContext,\n\tgetChildExtensions: () => ExtensionFactory[],\n): Promise<SubagentResult> {\n\tconst runId = nextRunId();\n\tconst name = task.slice(0, 48);\n\tsubagentRuns.set(runId, { name, status: \"running\", task, startedAt: Date.now() });\n\tupdateStatusWidget(ctx);\n\n\tconst prompt = [\n\t\t\"You are a focused Hamr subagent. Complete only the delegated task and return a concise handoff.\",\n\t\t`Task:\\n${task}`,\n\t].join(\"\\n\\n\");\n\n\ttry {\n\t\tconst agentDir = getAgentDir();\n\t\tconst settingsManager = SettingsManager.create(ctx.cwd, agentDir);\n\t\tconst resourceLoader = new DefaultResourceLoader({\n\t\t\tcwd: ctx.cwd,\n\t\t\tagentDir,\n\t\t\tsettingsManager,\n\t\t\textensionFactories: getChildExtensions(),\n\t\t});\n\t\tawait resourceLoader.reload();\n\t\t// Fork the live session into a real node in the session tree: the worker\n\t\t// inherits the parent context and is navigable via the session selector\n\t\t// (nested under the parent). Falls back to in-memory if not persisted.\n\t\tconst parentFile = ctx.sessionManager.getSessionFile();\n\t\tconst workerSessionManager = parentFile\n\t\t\t? SessionManager.forkFrom(parentFile, ctx.cwd, ctx.sessionManager.getSessionDir())\n\t\t\t: SessionManager.inMemory(ctx.cwd);\n\t\tconst child = await createAgentSession({\n\t\t\tcwd: ctx.cwd,\n\t\t\tagentDir,\n\t\t\tmodel: ctx.model!,\n\t\t\tthinkingLevel: pi.getThinkingLevel(),\n\t\t\tmodelRegistry: ctx.modelRegistry,\n\t\t\tsettingsManager,\n\t\t\tresourceLoader,\n\t\t\tsessionManager: workerSessionManager,\n\t\t});\n\t\tif (signal?.aborted) {\n\t\t\tsubagentRuns.set(runId, {\n\t\t\t\tname,\n\t\t\t\tstatus: \"failed\",\n\t\t\t\ttask,\n\t\t\t\tstartedAt: Date.now(),\n\t\t\t\tendedAt: Date.now(),\n\t\t\t\terror: \"aborted\",\n\t\t\t});\n\t\t\tupdateStatusWidget(ctx);\n\t\t\treturn { task, text: \"Subagent aborted before start.\", error: \"aborted\" };\n\t\t}\n\t\tawait child.session.prompt(prompt, { source: \"extension\" });\n\t\tconst assistant = [...child.session.messages].reverse().find((m) => m.role === \"assistant\") as\n\t\t\t| AssistantMessage\n\t\t\t| undefined;\n\t\tconst text = assistant\n\t\t\t? getAssistantText(assistant) || \"(subagent returned no text)\"\n\t\t\t: \"(subagent returned no message)\";\n\t\tgetMemory(ctx)?.store({\n\t\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\t\tturnId: getCurrentTurnId(),\n\t\t\trole: \"tool\",\n\t\t\ttoolName: \"delegate_subagent\",\n\t\t\tcontent: `Task: ${task}\\n\\n${text}`,\n\t\t\tdomainTags: [\"hamr\", \"subagent\"],\n\t\t});\n\t\tsubagentRuns.set(runId, {\n\t\t\tname,\n\t\t\tstatus: \"done\",\n\t\t\ttask,\n\t\t\tstartedAt: subagentRuns.get(runId)?.startedAt ?? Date.now(),\n\t\t\tendedAt: Date.now(),\n\t\t\tusage: assistant?.usage,\n\t\t\tresult: text,\n\t\t});\n\t\tupdateStatusWidget(ctx);\n\t\treturn { task, text };\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tsubagentRuns.set(runId, {\n\t\t\tname,\n\t\t\tstatus: \"failed\",\n\t\t\ttask,\n\t\t\tstartedAt: subagentRuns.get(runId)?.startedAt ?? Date.now(),\n\t\t\tendedAt: Date.now(),\n\t\t\terror: message,\n\t\t});\n\t\tupdateStatusWidget(ctx);\n\t\treturn { task, text: `Subagent failed: ${message}`, error: message };\n\t}\n}\n\n// ─── Tool ─────────────────────────────────────────────────────────────────────\n\nfunction registerSubagentTool(pi: Parameters<ExtensionFactory>[0], getChildExtensions: () => ExtensionFactory[]): void {\n\tpi.registerTool(\n\t\tdefineTool({\n\t\t\tname: \"delegate_subagents\",\n\t\t\tlabel: \"Subagents\",\n\t\t\tdescription:\n\t\t\t\t\"Delegate one or more focused subtasks to worker subagents. Each worker is a fork of the current session that runs its narrow task and returns a handoff. Workers run one at a time (serial). Use to divide-and-conquer large efforts.\",\n\t\t\tpromptSnippet: \"Use delegate_subagents to hand focused subtasks to serial worker subagents.\",\n\t\t\tpromptGuidelines: [\n\t\t\t\t\"Each subtask should be a clearly scoped, self-contained piece of work.\",\n\t\t\t\t\"Workers run serially in order and cannot see each other's results; for dependent steps, call again after reading the handoffs.\",\n\t\t\t\t\"Delegate only as many subtasks as the work genuinely warrants.\",\n\t\t\t],\n\t\t\tparameters: Type.Object({\n\t\t\t\tsubtasks: Type.Array(\n\t\t\t\t\tType.Object({\n\t\t\t\t\t\ttask: Type.String({ description: \"Focused, self-contained task for one worker subagent.\" }),\n\t\t\t\t\t}),\n\t\t\t\t\t{ description: \"One or more subtasks, run in order.\", minItems: 1 },\n\t\t\t\t),\n\t\t\t}),\n\t\t\trenderCall: (_args, theme) => new Text(theme.fg(\"toolTitle\", theme.bold(\"delegate_subagents\")), 0, 0),\n\t\t\trenderResult: (result, options, theme) => {\n\t\t\t\tconst results = (result.details as { results?: SubagentResult[] } | undefined)?.results ?? [];\n\t\t\t\tconst failed = results.filter((r) => r.error && r.error !== \"aborted\").length;\n\t\t\t\tconst done = results.length - failed;\n\t\t\t\tif (!options.expanded) {\n\t\t\t\t\tconst status =\n\t\t\t\t\t\tfailed > 0\n\t\t\t\t\t\t\t? `${done}/${results.length} done, ${failed} failed`\n\t\t\t\t\t\t\t: `${results.length} subagent${results.length !== 1 ? \"s\" : \"\"} done`;\n\t\t\t\t\treturn new Text(theme.fg(\"dim\", status), 0, 0);\n\t\t\t\t}\n\t\t\t\t// Expanded: per-worker handoff — the pi-native way to observe each subagent.\n\t\t\t\tconst lines = results\n\t\t\t\t\t.map((r, i) => {\n\t\t\t\t\t\tconst glyph = r.error ? theme.fg(\"error\", \"✕\") : theme.fg(\"success\", \"✓\");\n\t\t\t\t\t\tconst head = `${glyph} ${theme.fg(\"toolTitle\", `${i + 1}. ${r.task.slice(0, 64)}`)}`;\n\t\t\t\t\t\treturn `${head}\\n${theme.fg(\"toolOutput\", r.text.slice(0, 1200))}`;\n\t\t\t\t\t})\n\t\t\t\t\t.join(\"\\n\\n\");\n\t\t\t\treturn new Text(lines || theme.fg(\"dim\", \"(no subagents)\"), 0, 0);\n\t\t\t},\n\t\t\texecute: async (_toolCallId, params, signal, onUpdate, ctx) => {\n\t\t\t\tif (!ctx.model) {\n\t\t\t\t\treturn { content: [{ type: \"text\", text: \"No current model is available for subagents.\" }], details: {} };\n\t\t\t\t}\n\t\t\t\tif (params.subtasks.length === 0) {\n\t\t\t\t\treturn { content: [{ type: \"text\", text: \"No subtasks provided.\" }], details: {} };\n\t\t\t\t}\n\n\t\t\t\t// Fresh status for this call; serial — one forked worker at a time.\n\t\t\t\tsubagentRuns.clear();\n\t\t\t\tconst results: SubagentResult[] = [];\n\t\t\t\tconst total = params.subtasks.length;\n\t\t\t\tfor (let i = 0; i < total; i++) {\n\t\t\t\t\tonUpdate?.({\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: `subagent ${i + 1}/${total}: ${params.subtasks[i]!.task.slice(0, 60)}` }],\n\t\t\t\t\t\tdetails: { results: [...results] },\n\t\t\t\t\t});\n\t\t\t\t\tresults.push(await runOneSubagent(pi, params.subtasks[i]!.task, signal, ctx, getChildExtensions));\n\t\t\t\t\tif (signal?.aborted) break;\n\t\t\t\t}\n\n\t\t\t\tconst errors = results.filter((r) => r.error && r.error !== \"aborted\");\n\t\t\t\tconst summary = results\n\t\t\t\t\t.map((r, i) => `${i + 1}. ${r.error ? \"✗\" : \"✓\"} ${r.task.slice(0, 60)}\\n${r.text.slice(0, 300)}`)\n\t\t\t\t\t.join(\"\\n\\n\");\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: summary }],\n\t\t\t\t\tdetails: { results },\n\t\t\t\t\t...(errors.length > 0 ? { isError: true } : {}),\n\t\t\t\t};\n\t\t\t},\n\t\t}),\n\t);\n}\n\n// ─── Extension factory ────────────────────────────────────────────────────────\n\nexport function createHamrSubagentsExtension(\n\tgetChildExtensions: () => ExtensionFactory[],\n\tdepth = 0,\n): ExtensionFactory {\n\tconst factory: ExtensionFactory = async (pi) => {\n\t\t// Leaf: no delegate tool, so recursion stops here.\n\t\tif (depth >= MAX_DEPTH) return;\n\t\t// Workers load the identical set, with THIS factory bumped to depth + 1.\n\t\tregisterSubagentTool(pi, () =>\n\t\t\tgetChildExtensions().map((f) =>\n\t\t\t\t(f as { [HAMR_SUBAGENTS_FACTORY]?: boolean })[HAMR_SUBAGENTS_FACTORY]\n\t\t\t\t\t? createHamrSubagentsExtension(getChildExtensions, depth + 1)\n\t\t\t\t\t: f,\n\t\t\t),\n\t\t);\n\t};\n\t(factory as { [HAMR_SUBAGENTS_FACTORY]?: boolean })[HAMR_SUBAGENTS_FACTORY] = true;\n\treturn factory;\n}\n"]}

package/dist/hamr/handoff/HandoffManager.d.ts

@@ -0,0 +1,46 @@
+import type { ExtensionFactory } from "../../core/extensions/types.ts";
+import type { HolographicMemory } from "../memory/HolographicMemory.ts";
+export interface HandoffOptions {
+    /** Why the handoff was triggered. */
+    reason: "context_exhaustion" | "task_delegation" | "explicit";
+    /** The task being handed off. */
+    task: string;
+    /** Files modified in this session. */
+    filesChanged?: string[];
+    /** Files read/inspected in this session. */
+    filesRead?: string[];
+    /** Work still pending. */
+    pendingWork?: string[];
+    /** Orchestration context (subtask id, plan id, sibling summaries). */
+    orchestrationContext?: string;
+}
+export interface StructuredHandoff {
+    handoffId: string;
+    parentSessionId: string;
+    reason: HandoffOptions["reason"];
+    task: string;
+    status: string;
+    keyFindings: string[];
+    filesChanged: string[];
+    filesRead: string[];
+    pendingWork: string[];
+    suggestedSearchTerms: string[];
+    depth: number;
+    createdAt: string;
+    orchestrationContext?: string;
+}
+export declare class HandoffManager {
+    private depth;
+    constructor(initialDepth?: number);
+    get currentDepth(): number;
+    canHandoff(): boolean;
+    /**
+     * Generate a structured handoff manifest combining FTS5 memory data
+     * with session-level metadata.
+     */
+    createHandoff(sessionId: string, memory: HolographicMemory | undefined, options: HandoffOptions): StructuredHandoff;
+    /** Increment depth for a child handoff. Returns a new HandoffManager for the child. */
+    forChild(): HandoffManager;
+}
+export declare function registerHandoffTool(pi: Parameters<ExtensionFactory>[0]): void;
+//# sourceMappingURL=HandoffManager.d.ts.map

package/dist/hamr/handoff/HandoffManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandoffManager.d.ts","sourceRoot":"","sources":["../../../src/hamr/handoff/HandoffManager.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGzF,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,UAAU,CAAC;IAC9D,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,qBAAa,cAAc;IAC1B,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,YAAY,SAAI,EAE3B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,UAAU,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,iBAAiB,CA2ClH;IAED,uFAAuF;IACvF,QAAQ,IAAI,cAAc,CAEzB;CACD;AAiBD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CA8E7E"}

package/dist/hamr/handoff/HandoffManager.js

@@ -0,0 +1,147 @@
+/**
+ * HandoffManager — structured context handoff over FTS5 memory.
+ *
+ * Tracks handoff depth (max 3), generates structured manifests consumable
+ * by subagents and future turns. Lean — uses HolographicMemory for all storage.
+ */
+import { Type } from "typebox";
+import { defineTool } from "../../core/extensions/types.js";
+import { getMemory } from "../memory.js";
+const MAX_DEPTH = 3;
+export class HandoffManager {
+    constructor(initialDepth = 0) {
+        this.depth = 0;
+        this.depth = Math.min(initialDepth, MAX_DEPTH);
+    }
+    get currentDepth() {
+        return this.depth;
+    }
+    canHandoff() {
+        return this.depth < MAX_DEPTH;
+    }
+    /**
+     * Generate a structured handoff manifest combining FTS5 memory data
+     * with session-level metadata.
+     */
+    createHandoff(sessionId, memory, options) {
+        const memoryManifest = memory?.handoff();
+        const handoffId = `handoff-${Date.now()}-${this.depth}`;
+        // Merge memory-derived findings with caller-supplied context
+        const keyFindings = [
+            ...(memoryManifest?.keyFindings ?? []),
+            ...(options.pendingWork ?? []).map((w) => `pending: ${w}`),
+        ].slice(0, 15);
+        const filesChanged = [...new Set([...(options.filesChanged ?? []), ...(memoryManifest?.filesTouched ?? [])])].slice(0, 30);
+        const filesRead = [...new Set(options.filesRead ?? [])].slice(0, 30);
+        const statusParts = [];
+        if (memoryManifest) {
+            statusParts.push(`${memoryManifest.entryCount} memory entries across ${memoryManifest.turnCount} turns`);
+        }
+        if (filesChanged.length > 0) {
+            statusParts.push(`${filesChanged.length} files changed`);
+        }
+        if (filesRead.length > 0) {
+            statusParts.push(`${filesRead.length} files read`);
+        }
+        return {
+            handoffId,
+            parentSessionId: sessionId,
+            reason: options.reason,
+            task: options.task,
+            status: statusParts.length > 0 ? statusParts.join("; ") : "no prior state",
+            keyFindings,
+            filesChanged,
+            filesRead,
+            pendingWork: options.pendingWork ?? [],
+            suggestedSearchTerms: memoryManifest?.suggestedSearchTerms ?? [],
+            depth: this.depth,
+            createdAt: new Date().toISOString(),
+            orchestrationContext: options.orchestrationContext,
+        };
+    }
+    /** Increment depth for a child handoff. Returns a new HandoffManager for the child. */
+    forChild() {
+        return new HandoffManager(this.depth + 1);
+    }
+}
+// ── Per-session HandoffManager instances ──────────────────────────────────────
+const managersBySession = new Map();
+function getManager(sessionId) {
+    let manager = managersBySession.get(sessionId);
+    if (!manager) {
+        manager = new HandoffManager();
+        managersBySession.set(sessionId, manager);
+    }
+    return manager;
+}
+// ── Tool registration ────────────────────────────────────────────────────────
+export function registerHandoffTool(pi) {
+    pi.registerTool(defineTool({
+        name: "create_handoff",
+        label: "Create handoff",
+        description: "Create a structured handoff manifest from FTS5 memory. Consumable by subagents for context inheritance. Tracks depth (max 3).",
+        promptSnippet: "Use create_handoff to checkpoint state before spawning subagents or when context is exhausted.",
+        parameters: Type.Object({
+            task: Type.String({ description: "The task being handed off." }),
+            reason: Type.Optional(Type.Union([Type.Literal("context_exhaustion"), Type.Literal("task_delegation"), Type.Literal("explicit")], {
+                description: "Why the handoff was triggered. Defaults to explicit.",
+            })),
+            filesChanged: Type.Optional(Type.Array(Type.String(), { description: "Files modified in this session." })),
+            filesRead: Type.Optional(Type.Array(Type.String(), { description: "Files read/inspected in this session." })),
+            pendingWork: Type.Optional(Type.Array(Type.String(), { description: "Work still pending." })),
+        }),
+        execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
+            const sessionId = ctx.sessionManager.getSessionId();
+            const manager = getManager(sessionId);
+            if (!manager.canHandoff()) {
+                return {
+                    content: [{ type: "text", text: `Handoff depth limit reached (max ${3}). Cannot create another handoff.` }],
+                    details: { depth: manager.currentDepth },
+                    isError: true,
+                };
+            }
+            const memory = getMemory(ctx);
+            const handoff = manager.createHandoff(sessionId, memory, {
+                reason: params.reason ?? "explicit",
+                task: params.task,
+                filesChanged: params.filesChanged,
+                filesRead: params.filesRead,
+                pendingWork: params.pendingWork,
+            });
+            // Store the handoff in FTS5 memory for future search
+            memory?.store({
+                sessionId,
+                turnId: 0,
+                role: "tool",
+                toolName: "create_handoff",
+                content: JSON.stringify(handoff, null, 2),
+                domainTags: ["hamr", "handoff"],
+            });
+            const lines = [
+                `📋 Handoff manifest (depth ${handoff.depth}/3)`,
+                `ID: ${handoff.handoffId}`,
+                `Task: ${handoff.task}`,
+                `Status: ${handoff.status}`,
+            ];
+            if (handoff.keyFindings.length > 0) {
+                lines.push(`\nKey findings:\n${handoff.keyFindings.map((f) => `  - ${f}`).join("\n")}`);
+            }
+            if (handoff.filesChanged.length > 0) {
+                lines.push(`\nFiles changed: ${handoff.filesChanged.join(", ")}`);
+            }
+            if (handoff.pendingWork.length > 0) {
+                lines.push(`\nPending:\n${handoff.pendingWork.map((w) => `  - ${w}`).join("\n")}`);
+            }
+            if (handoff.suggestedSearchTerms.length > 0) {
+                lines.push(`\nSearch terms: ${handoff.suggestedSearchTerms.join(", ")}`);
+            }
+            // Advance depth for next handoff
+            managersBySession.set(sessionId, manager.forChild());
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                details: handoff,
+            };
+        },
+    }));
+}
+//# sourceMappingURL=HandoffManager.js.map

package/dist/hamr/handoff/HandoffManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandoffManager.js","sourceRoot":"","sources":["../../../src/hamr/handoff/HandoffManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HandoffManager — structured context handoff over FTS5 memory.\n *\n * Tracks handoff depth (max 3), generates structured manifests consumable\n * by subagents and future turns. Lean — uses HolographicMemory for all storage.\n */\nimport { Type } from \"typebox\";\nimport type { ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport { defineTool } from \"../../core/extensions/types.ts\";\nimport type { HandoffManifest, HolographicMemory } from \"../memory/HolographicMemory.ts\";\nimport { getMemory } from \"../memory.ts\";\n\nexport interface HandoffOptions {\n\t/** Why the handoff was triggered. */\n\treason: \"context_exhaustion\" | \"task_delegation\" | \"explicit\";\n\t/** The task being handed off. */\n\ttask: string;\n\t/** Files modified in this session. */\n\tfilesChanged?: string[];\n\t/** Files read/inspected in this session. */\n\tfilesRead?: string[];\n\t/** Work still pending. */\n\tpendingWork?: string[];\n\t/** Orchestration context (subtask id, plan id, sibling summaries). */\n\torchestrationContext?: string;\n}\n\nexport interface StructuredHandoff {\n\thandoffId: string;\n\tparentSessionId: string;\n\treason: HandoffOptions[\"reason\"];\n\ttask: string;\n\tstatus: string;\n\tkeyFindings: string[];\n\tfilesChanged: string[];\n\tfilesRead: string[];\n\tpendingWork: string[];\n\tsuggestedSearchTerms: string[];\n\tdepth: number;\n\tcreatedAt: string;\n\torchestrationContext?: string;\n}\n\nconst MAX_DEPTH = 3;\n\nexport class HandoffManager {\n\tprivate depth = 0;\n\n\tconstructor(initialDepth = 0) {\n\t\tthis.depth = Math.min(initialDepth, MAX_DEPTH);\n\t}\n\n\tget currentDepth(): number {\n\t\treturn this.depth;\n\t}\n\n\tcanHandoff(): boolean {\n\t\treturn this.depth < MAX_DEPTH;\n\t}\n\n\t/**\n\t * Generate a structured handoff manifest combining FTS5 memory data\n\t * with session-level metadata.\n\t */\n\tcreateHandoff(sessionId: string, memory: HolographicMemory | undefined, options: HandoffOptions): StructuredHandoff {\n\t\tconst memoryManifest: HandoffManifest | undefined = memory?.handoff();\n\t\tconst handoffId = `handoff-${Date.now()}-${this.depth}`;\n\n\t\t// Merge memory-derived findings with caller-supplied context\n\t\tconst keyFindings = [\n\t\t\t...(memoryManifest?.keyFindings ?? []),\n\t\t\t...(options.pendingWork ?? []).map((w) => `pending: ${w}`),\n\t\t].slice(0, 15);\n\n\t\tconst filesChanged = [...new Set([...(options.filesChanged ?? []), ...(memoryManifest?.filesTouched ?? [])])].slice(\n\t\t\t0,\n\t\t\t30,\n\t\t);\n\n\t\tconst filesRead = [...new Set(options.filesRead ?? [])].slice(0, 30);\n\n\t\tconst statusParts: string[] = [];\n\t\tif (memoryManifest) {\n\t\t\tstatusParts.push(`${memoryManifest.entryCount} memory entries across ${memoryManifest.turnCount} turns`);\n\t\t}\n\t\tif (filesChanged.length > 0) {\n\t\t\tstatusParts.push(`${filesChanged.length} files changed`);\n\t\t}\n\t\tif (filesRead.length > 0) {\n\t\t\tstatusParts.push(`${filesRead.length} files read`);\n\t\t}\n\n\t\treturn {\n\t\t\thandoffId,\n\t\t\tparentSessionId: sessionId,\n\t\t\treason: options.reason,\n\t\t\ttask: options.task,\n\t\t\tstatus: statusParts.length > 0 ? statusParts.join(\"; \") : \"no prior state\",\n\t\t\tkeyFindings,\n\t\t\tfilesChanged,\n\t\t\tfilesRead,\n\t\t\tpendingWork: options.pendingWork ?? [],\n\t\t\tsuggestedSearchTerms: memoryManifest?.suggestedSearchTerms ?? [],\n\t\t\tdepth: this.depth,\n\t\t\tcreatedAt: new Date().toISOString(),\n\t\t\torchestrationContext: options.orchestrationContext,\n\t\t};\n\t}\n\n\t/** Increment depth for a child handoff. Returns a new HandoffManager for the child. */\n\tforChild(): HandoffManager {\n\t\treturn new HandoffManager(this.depth + 1);\n\t}\n}\n\n// ── Per-session HandoffManager instances ──────────────────────────────────────\n\nconst managersBySession = new Map<string, HandoffManager>();\n\nfunction getManager(sessionId: string): HandoffManager {\n\tlet manager = managersBySession.get(sessionId);\n\tif (!manager) {\n\t\tmanager = new HandoffManager();\n\t\tmanagersBySession.set(sessionId, manager);\n\t}\n\treturn manager;\n}\n\n// ── Tool registration ────────────────────────────────────────────────────────\n\nexport function registerHandoffTool(pi: Parameters<ExtensionFactory>[0]): void {\n\tpi.registerTool(\n\t\tdefineTool({\n\t\t\tname: \"create_handoff\",\n\t\t\tlabel: \"Create handoff\",\n\t\t\tdescription:\n\t\t\t\t\"Create a structured handoff manifest from FTS5 memory. Consumable by subagents for context inheritance. Tracks depth (max 3).\",\n\t\t\tpromptSnippet: \"Use create_handoff to checkpoint state before spawning subagents or when context is exhausted.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\ttask: Type.String({ description: \"The task being handed off.\" }),\n\t\t\t\treason: Type.Optional(\n\t\t\t\t\tType.Union([Type.Literal(\"context_exhaustion\"), Type.Literal(\"task_delegation\"), Type.Literal(\"explicit\")], {\n\t\t\t\t\t\tdescription: \"Why the handoff was triggered. Defaults to explicit.\",\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t\tfilesChanged: Type.Optional(Type.Array(Type.String(), { description: \"Files modified in this session.\" })),\n\t\t\t\tfilesRead: Type.Optional(Type.Array(Type.String(), { description: \"Files read/inspected in this session.\" })),\n\t\t\t\tpendingWork: Type.Optional(Type.Array(Type.String(), { description: \"Work still pending.\" })),\n\t\t\t}),\n\t\t\texecute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {\n\t\t\t\tconst sessionId = ctx.sessionManager.getSessionId();\n\t\t\t\tconst manager = getManager(sessionId);\n\t\t\t\tif (!manager.canHandoff()) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: `Handoff depth limit reached (max ${3}). Cannot create another handoff.` }],\n\t\t\t\t\t\tdetails: { depth: manager.currentDepth },\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst memory = getMemory(ctx);\n\t\t\t\tconst handoff = manager.createHandoff(sessionId, memory, {\n\t\t\t\t\treason: params.reason ?? \"explicit\",\n\t\t\t\t\ttask: params.task,\n\t\t\t\t\tfilesChanged: params.filesChanged,\n\t\t\t\t\tfilesRead: params.filesRead,\n\t\t\t\t\tpendingWork: params.pendingWork,\n\t\t\t\t});\n\n\t\t\t\t// Store the handoff in FTS5 memory for future search\n\t\t\t\tmemory?.store({\n\t\t\t\t\tsessionId,\n\t\t\t\t\tturnId: 0,\n\t\t\t\t\trole: \"tool\",\n\t\t\t\t\ttoolName: \"create_handoff\",\n\t\t\t\t\tcontent: JSON.stringify(handoff, null, 2),\n\t\t\t\t\tdomainTags: [\"hamr\", \"handoff\"],\n\t\t\t\t});\n\n\t\t\t\tconst lines = [\n\t\t\t\t\t`📋 Handoff manifest (depth ${handoff.depth}/3)`,\n\t\t\t\t\t`ID: ${handoff.handoffId}`,\n\t\t\t\t\t`Task: ${handoff.task}`,\n\t\t\t\t\t`Status: ${handoff.status}`,\n\t\t\t\t];\n\t\t\t\tif (handoff.keyFindings.length > 0) {\n\t\t\t\t\tlines.push(`\\nKey findings:\\n${handoff.keyFindings.map((f) => `  - ${f}`).join(\"\\n\")}`);\n\t\t\t\t}\n\t\t\t\tif (handoff.filesChanged.length > 0) {\n\t\t\t\t\tlines.push(`\\nFiles changed: ${handoff.filesChanged.join(\", \")}`);\n\t\t\t\t}\n\t\t\t\tif (handoff.pendingWork.length > 0) {\n\t\t\t\t\tlines.push(`\\nPending:\\n${handoff.pendingWork.map((w) => `  - ${w}`).join(\"\\n\")}`);\n\t\t\t\t}\n\t\t\t\tif (handoff.suggestedSearchTerms.length > 0) {\n\t\t\t\t\tlines.push(`\\nSearch terms: ${handoff.suggestedSearchTerms.join(\", \")}`);\n\t\t\t\t}\n\n\t\t\t\t// Advance depth for next handoff\n\t\t\t\tmanagersBySession.set(sessionId, manager.forChild());\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: lines.join(\"\\n\") }],\n\t\t\t\t\tdetails: handoff,\n\t\t\t\t};\n\t\t\t},\n\t\t}),\n\t);\n}\n"]}

package/dist/hamr/helpers.d.ts

@@ -0,0 +1,8 @@
+import type { AssistantMessage } from "@hamr/ai";
+export declare function modelKey(provider: string, model: string): string;
+export declare function contentText(content: unknown): string;
+export declare function getAssistantText(message: AssistantMessage): string;
+export declare function getThinkingText(message: AssistantMessage): string | undefined;
+export declare function hasToolCalls(message: AssistantMessage): boolean;
+export declare function fileHints(text: string): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/hamr/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/hamr/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,UAAU,CAAC;AAE9D,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAKlE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAO7E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE/D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD"}

package/dist/hamr/helpers.js

@@ -0,0 +1,35 @@
+export function modelKey(provider, model) {
+    return `${provider}/${model}`;
+}
+export function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((part) => typeof part === "object" && part !== null && "type" in part && part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
+export function getAssistantText(message) {
+    return message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
+export function getThinkingText(message) {
+    const thinking = message.content
+        .filter((part) => part.type === "thinking")
+        .map((part) => part.thinking)
+        .join("\n")
+        .trim();
+    return thinking || undefined;
+}
+export function hasToolCalls(message) {
+    return message.content.some((part) => part.type === "toolCall");
+}
+export function fileHints(text) {
+    const matches = text.match(/(?:^|\s)([./~]?[A-Za-z0-9._@/-]+\.[A-Za-z0-9]{1,8})(?=\s|$|[:),])/g) ?? [];
+    return [...new Set(matches.map((match) => match.trim()).filter((match) => match.length < 240))].slice(0, 12);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/hamr/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/hamr/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,KAAa;IACvD,OAAO,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACZ,MAAM,CACN,CAAC,IAAI,EAAuB,EAAE,CAC7B,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CACpF;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACzD,OAAO,OAAO,CAAC,OAAO;SACpB,MAAM,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO;SAC9B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IACT,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyB;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,oEAAoE,CAAC,IAAI,EAAE,CAAC;IACvG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9G,CAAC","sourcesContent":["import type { AssistantMessage, TextContent } from \"@hamr/ai\";\n\nexport function modelKey(provider: string, model: string): string {\n\treturn `${provider}/${model}`;\n}\n\nexport function contentText(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.filter(\n\t\t\t(part): part is TextContent =>\n\t\t\t\ttypeof part === \"object\" && part !== null && \"type\" in part && part.type === \"text\",\n\t\t)\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\nexport function getAssistantText(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}\n\nexport function getThinkingText(message: AssistantMessage): string | undefined {\n\tconst thinking = message.content\n\t\t.filter((part) => part.type === \"thinking\")\n\t\t.map((part) => part.thinking)\n\t\t.join(\"\\n\")\n\t\t.trim();\n\treturn thinking || undefined;\n}\n\nexport function hasToolCalls(message: AssistantMessage): boolean {\n\treturn message.content.some((part) => part.type === \"toolCall\");\n}\n\nexport function fileHints(text: string): string[] {\n\tconst matches = text.match(/(?:^|\\s)([./~]?[A-Za-z0-9._@/-]+\\.[A-Za-z0-9]{1,8})(?=\\s|$|[:),])/g) ?? [];\n\treturn [...new Set(matches.map((match) => match.trim()).filter((match) => match.length < 240))].slice(0, 12);\n}\n"]}