@gencode/agents 0.0.1

package/dist/tools/memory.js

@@ -0,0 +1,114 @@
+import { Type } from "@mariozechner/pi-ai";
+import { searchMemory, getMemoryLines, appendToMemory, listMemoryFiles, } from "../memory/memory.js";
+// ─── Memory Search Tool ───────────────────────────────────────────────────────
+const memorySearchSchema = Type.Object({
+    query: Type.String({ description: "Search query (case-insensitive substring match)" }),
+});
+export function createMemorySearchTool(dataDir, options) {
+    return {
+        name: "memory_search",
+        label: "Memory Search",
+        description: "Search memory files for relevant information",
+        parameters: memorySearchSchema,
+        async execute(_toolCallId, params) {
+            const results = await searchMemory(dataDir, params.query, {
+                providerId: options?.providerId,
+                pluginId: options?.pluginId,
+                sessionId: options?.sessionId,
+            });
+            const matches = results.map((r) => ({
+                file: r.path,
+                start_line: r.startLine,
+                end_line: r.endLine,
+                score: Number(r.score.toFixed(4)),
+                text: r.snippet,
+                source: r.source,
+                citation: r.citation,
+            }));
+            if (matches.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No results found for: ${params.query}` }],
+                    details: { matches },
+                };
+            }
+            const text = matches
+                .map((m) => {
+                const base = `${m.file}:${m.start_line}-${m.end_line} (${m.score}): ${m.text}`;
+                return m.citation ? `${base}\n${m.citation}` : base;
+            })
+                .join("\n");
+            return {
+                content: [{ type: "text", text }],
+                details: { matches },
+            };
+        },
+    };
+}
+// ─── Memory Get Tool ──────────────────────────────────────────────────────────
+const memoryGetSchema = Type.Object({
+    file: Type.String({ description: "Memory file path" }),
+    start_line: Type.Number({ description: "Start line number (1-based)" }),
+    end_line: Type.Number({ description: "End line number (1-based)" }),
+});
+export function createMemoryGetTool(dataDir, options) {
+    return {
+        name: "memory_get",
+        label: "Memory Get",
+        description: "Read specific lines from a memory file",
+        parameters: memoryGetSchema,
+        async execute(_toolCallId, params) {
+            const lines = await getMemoryLines(dataDir, params.file, params.start_line, params.end_line, {
+                providerId: options?.providerId,
+                pluginId: options?.pluginId,
+                sessionId: options?.sessionId,
+            });
+            if (lines === null) {
+                return {
+                    content: [{ type: "text", text: `File not found: ${params.file}` }],
+                    details: { lines: null },
+                };
+            }
+            const numbered = lines
+                .map((line, idx) => `${(params.start_line + idx).toString().padStart(4)} ${line}`)
+                .join("\n");
+            return {
+                content: [{ type: "text", text: numbered || "(empty)" }],
+                details: { lines },
+            };
+        },
+    };
+}
+// ─── Memory Append Tool ───────────────────────────────────────────────────────
+const memoryAppendSchema = Type.Object({
+    content: Type.String({ description: "Content to append to MEMORY.md" }),
+});
+export function createMemoryAppendTool(dataDir, options) {
+    return {
+        name: "memory_append",
+        label: "Memory Append",
+        description: "Append new information to the MEMORY.md file",
+        parameters: memoryAppendSchema,
+        async execute(_toolCallId, params) {
+            try {
+                await appendToMemory(dataDir, params.content, {
+                    providerId: options?.providerId,
+                    pluginId: options?.pluginId,
+                    sessionId: options?.sessionId,
+                    onMemoryChanged: options?.onMemoryChanged,
+                });
+                return {
+                    content: [{ type: "text", text: "Memory updated." }],
+                    details: { appended: true },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error appending to memory: ${msg}` }],
+                    details: { appended: false },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"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"}

package/dist/tools/process-registry.d.ts

@@ -0,0 +1,47 @@
+export type ProcessStatus = "running" | "completed" | "failed" | "killed" | "timeout";
+export type ProcessSessionSnapshot = {
+    sessionId: string;
+    scopeKey?: string;
+    command: string;
+    cwd: string;
+    pid?: number;
+    startedAt: number;
+    endedAt?: number;
+    status: ProcessStatus;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | null;
+    outputTail: string;
+    outputTruncated: boolean;
+};
+export type ProcessLogSlice = {
+    sessionId: string;
+    status: ProcessStatus;
+    text: string;
+    totalLines: number;
+    totalChars: number;
+    truncated: boolean;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | null;
+};
+export type ProcessStartParams = {
+    command: string;
+    cwd: string;
+    env?: Record<string, string>;
+    timeoutSec: number;
+    scopeKey?: string;
+};
+export type ProcessRegistry = {
+    start(params: ProcessStartParams): ProcessSessionSnapshot;
+    get(sessionId: string, scopeKey?: string): ProcessSessionSnapshot | null;
+    list(scopeKey?: string): ProcessSessionSnapshot[];
+    wait(sessionId: string, scopeKey: string | undefined, timeoutMs?: number): Promise<ProcessSessionSnapshot | null>;
+    readLog(params: {
+        sessionId: string;
+        scopeKey?: string;
+        offset?: number;
+        limit?: number;
+    }): ProcessLogSlice | null;
+    terminate(sessionId: string, scopeKey?: string): Promise<ProcessSessionSnapshot | null>;
+};
+export declare function createProcessRegistry(): ProcessRegistry;
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/tools/process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/tools/process-registry.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACpC,CAAC;AAqBF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,CAAC;IAC1D,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;IAClD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAClH,OAAO,CAAC,MAAM,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,eAAe,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CACzF,CAAC;AAwGF,wBAAgB,qBAAqB,IAAI,eAAe,CAqLvD"}

package/dist/tools/process-registry.js

@@ -0,0 +1,252 @@
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
+const MAX_OUTPUT_CHARS = 200_000;
+const DEFAULT_LOG_TAIL_LINES = 200;
+const MAX_FINISHED_SESSIONS = 100;
+function toOutputTail(output, maxChars = 4000) {
+    if (!output) {
+        return "";
+    }
+    return output.length > maxChars ? output.slice(-maxChars) : output;
+}
+function appendOutput(record, chunk) {
+    if (chunk.length === 0) {
+        return;
+    }
+    record.output += chunk.toString("utf-8");
+    if (record.output.length > MAX_OUTPUT_CHARS) {
+        record.output = record.output.slice(-MAX_OUTPUT_CHARS);
+        record.outputTruncated = true;
+    }
+}
+function toSnapshot(record) {
+    return {
+        sessionId: record.sessionId,
+        scopeKey: record.scopeKey,
+        command: record.command,
+        cwd: record.cwd,
+        pid: typeof record.child.pid === "number" ? record.child.pid : undefined,
+        startedAt: record.startedAt,
+        endedAt: record.endedAt,
+        status: record.status,
+        exitCode: record.exitCode,
+        exitSignal: record.exitSignal,
+        outputTail: toOutputTail(record.output),
+        outputTruncated: record.outputTruncated,
+    };
+}
+function inScope(record, scopeKey) {
+    if (!scopeKey) {
+        return true;
+    }
+    return record.scopeKey === scopeKey;
+}
+function clampPositiveInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.floor(value);
+}
+function splitLogLines(output) {
+    if (!output) {
+        return [];
+    }
+    return output.split(/\r?\n/);
+}
+function formatLogSlice(params) {
+    const lines = splitLogLines(params.record.output);
+    const usingDefaultTail = params.offset === undefined && params.limit === undefined;
+    const start = Math.max(0, (params.offset ?? 0) | 0);
+    const limit = clampPositiveInt(params.limit, usingDefaultTail ? DEFAULT_LOG_TAIL_LINES : Math.max(1, lines.length - start));
+    const selected = usingDefaultTail && lines.length > DEFAULT_LOG_TAIL_LINES
+        ? lines.slice(lines.length - DEFAULT_LOG_TAIL_LINES)
+        : lines.slice(start, start + limit);
+    const text = selected.join("\n");
+    return {
+        sessionId: params.record.sessionId,
+        status: params.record.status,
+        text,
+        totalLines: lines.length,
+        totalChars: params.record.output.length,
+        truncated: params.record.outputTruncated,
+        exitCode: params.record.exitCode,
+        exitSignal: params.record.exitSignal,
+    };
+}
+function settleDone(record) {
+    if (record.timeoutTimer) {
+        clearTimeout(record.timeoutTimer);
+        record.timeoutTimer = undefined;
+    }
+    if (record.killTimer) {
+        clearTimeout(record.killTimer);
+        record.killTimer = undefined;
+    }
+    record.resolveDone();
+}
+export function createProcessRegistry() {
+    const running = new Map();
+    const finished = new Map();
+    const finishRecord = (record) => {
+        running.delete(record.sessionId);
+        finished.set(record.sessionId, record);
+        if (finished.size <= MAX_FINISHED_SESSIONS) {
+            return;
+        }
+        const entries = Array.from(finished.values()).sort((a, b) => {
+            const aEnded = a.endedAt ?? Number.MAX_SAFE_INTEGER;
+            const bEnded = b.endedAt ?? Number.MAX_SAFE_INTEGER;
+            return aEnded - bEnded;
+        });
+        while (entries.length > MAX_FINISHED_SESSIONS) {
+            const oldest = entries.shift();
+            if (!oldest) {
+                break;
+            }
+            finished.delete(oldest.sessionId);
+        }
+    };
+    const getRecord = (sessionId) => {
+        return running.get(sessionId) ?? finished.get(sessionId) ?? null;
+    };
+    return {
+        start(params) {
+            const child = spawn("bash", ["-lc", params.command], {
+                cwd: params.cwd,
+                env: {
+                    ...process.env,
+                    ...(params.env ?? {}),
+                },
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            let resolveDone = () => { };
+            const donePromise = new Promise((resolve) => {
+                resolveDone = resolve;
+            });
+            const record = {
+                sessionId: randomUUID(),
+                scopeKey: params.scopeKey,
+                command: params.command,
+                cwd: params.cwd,
+                startedAt: Date.now(),
+                child,
+                status: "running",
+                output: "",
+                outputTruncated: false,
+                donePromise,
+                resolveDone,
+            };
+            running.set(record.sessionId, record);
+            child.stdout.on("data", (chunk) => appendOutput(record, chunk));
+            child.stderr.on("data", (chunk) => appendOutput(record, chunk));
+            const timeoutSec = clampPositiveInt(params.timeoutSec, 1800);
+            record.timeoutTimer = setTimeout(() => {
+                if (record.status !== "running") {
+                    return;
+                }
+                record.status = "timeout";
+                appendOutput(record, Buffer.from(`\n[Timed out after ${timeoutSec}s]\n`));
+                record.child.kill("SIGTERM");
+                record.killTimer = setTimeout(() => {
+                    if (record.status === "running" || record.status === "timeout") {
+                        record.child.kill("SIGKILL");
+                    }
+                }, 1000);
+            }, timeoutSec * 1000);
+            child.on("error", (err) => {
+                if (record.status === "running") {
+                    record.status = "failed";
+                }
+                appendOutput(record, Buffer.from(`\n[Process error: ${err.message}]\n`));
+            });
+            child.on("close", (code, signal) => {
+                record.endedAt = Date.now();
+                record.exitCode = code;
+                record.exitSignal = signal;
+                if (record.status === "running") {
+                    record.status = code === 0 ? "completed" : "failed";
+                }
+                else if (record.status === "killed" && code === 0) {
+                    record.status = "completed";
+                }
+                finishRecord(record);
+                settleDone(record);
+            });
+            return toSnapshot(record);
+        },
+        get(sessionId, scopeKey) {
+            const record = getRecord(sessionId);
+            if (!record || !inScope(record, scopeKey)) {
+                return null;
+            }
+            return toSnapshot(record);
+        },
+        list(scopeKey) {
+            return [...running.values(), ...finished.values()]
+                .filter((record) => inScope(record, scopeKey))
+                .sort((a, b) => b.startedAt - a.startedAt)
+                .map((record) => toSnapshot(record));
+        },
+        async wait(sessionId, scopeKey, timeoutMs) {
+            const record = getRecord(sessionId);
+            if (!record || !inScope(record, scopeKey)) {
+                return null;
+            }
+            if (record.status !== "running") {
+                return toSnapshot(record);
+            }
+            if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs >= 0) {
+                await Promise.race([
+                    record.donePromise,
+                    new Promise((resolve) => {
+                        setTimeout(resolve, timeoutMs);
+                    }),
+                ]);
+            }
+            else {
+                await record.donePromise;
+            }
+            const latest = getRecord(sessionId);
+            if (!latest || !inScope(latest, scopeKey)) {
+                return null;
+            }
+            return toSnapshot(latest);
+        },
+        readLog(params) {
+            const record = getRecord(params.sessionId);
+            if (!record || !inScope(record, params.scopeKey)) {
+                return null;
+            }
+            return formatLogSlice({
+                record,
+                offset: params.offset,
+                limit: params.limit,
+            });
+        },
+        async terminate(sessionId, scopeKey) {
+            const record = getRecord(sessionId);
+            if (!record || !inScope(record, scopeKey)) {
+                return null;
+            }
+            if (record.status !== "running") {
+                return toSnapshot(record);
+            }
+            record.status = "killed";
+            record.child.kill("SIGTERM");
+            record.killTimer = setTimeout(() => {
+                if (record.status === "running" || record.status === "killed") {
+                    record.child.kill("SIGKILL");
+                }
+            }, 1000);
+            await Promise.race([
+                record.donePromise,
+                new Promise((resolve) => {
+                    setTimeout(resolve, 1500);
+                }),
+            ]);
+            const latest = getRecord(sessionId);
+            return latest ? toSnapshot(latest) : null;
+        },
+    };
+}
+//# sourceMappingURL=process-registry.js.map

package/dist/tools/process-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.js","sourceRoot":"","sources":["../../src/tools/process-registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/process.d.ts

@@ -0,0 +1,17 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { TObject, TString, TOptional, TNumber } from "@sinclair/typebox";
+import type { ProcessRegistry } from "./process-registry.js";
+declare const processSchema: TObject<{
+    action: TString;
+    sessionId: TOptional<TString>;
+    offset: TOptional<TNumber>;
+    limit: TOptional<TNumber>;
+    timeout: TOptional<TNumber>;
+}>;
+export type ProcessToolOptions = {
+    registry: ProcessRegistry;
+    scopeKey?: string;
+};
+export declare function createProcessTool(options: ProcessToolOptions): AgentTool<typeof processSchema, Record<string, unknown>>;
+export {};
+//# sourceMappingURL=process.d.ts.map

package/dist/tools/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC7B,CAMC,CAAC;AAkBH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,SAAS,CAAC,OAAO,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6G1D"}

package/dist/tools/process.js

@@ -0,0 +1,114 @@
+import { Type } from "@mariozechner/pi-ai";
+const processSchema = Type.Object({
+    action: Type.String({ description: "Process action: list | poll | log | kill" }),
+    sessionId: Type.Optional(Type.String({ description: "Session id for non-list actions" })),
+    offset: Type.Optional(Type.Number({ description: "Log line offset (0-based)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum lines to return" })),
+    timeout: Type.Optional(Type.Number({ description: "Poll wait time in milliseconds" })),
+});
+const MAX_POLL_WAIT_MS = 120_000;
+function clampPollWaitMs(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        return 0;
+    }
+    return Math.max(0, Math.min(MAX_POLL_WAIT_MS, Math.floor(value)));
+}
+function failResult(text) {
+    return {
+        content: [{ type: "text", text }],
+        details: { status: "failed" },
+    };
+}
+export function createProcessTool(options) {
+    return {
+        name: "process",
+        label: "Process",
+        description: "Manage background exec sessions: list, poll, log, kill.",
+        parameters: processSchema,
+        async execute(_toolCallId, params) {
+            const action = params.action?.trim().toLowerCase();
+            if (action === "list") {
+                const sessions = options.registry.list(options.scopeKey);
+                const text = sessions.length === 0
+                    ? "No running or recent sessions."
+                    : sessions
+                        .map((entry) => {
+                        const runtimeMs = (entry.endedAt ?? Date.now()) - entry.startedAt;
+                        return `${entry.sessionId} ${entry.status.padEnd(9)} ${runtimeMs}ms :: ${entry.command}`;
+                    })
+                        .join("\n");
+                return {
+                    content: [{ type: "text", text }],
+                    details: { status: "completed", sessions },
+                };
+            }
+            if (!params.sessionId?.trim()) {
+                return failResult("sessionId is required for this action.");
+            }
+            const sessionId = params.sessionId.trim();
+            if (action === "poll") {
+                const snapshot = await options.registry.wait(sessionId, options.scopeKey, clampPollWaitMs(params.timeout));
+                if (!snapshot) {
+                    return failResult(`No session found for ${sessionId}`);
+                }
+                const text = snapshot.status === "running"
+                    ? `Session ${sessionId} is still running.`
+                    : `Session ${sessionId} finished with status=${snapshot.status}, exitCode=${snapshot.exitCode ?? "null"}.`;
+                return {
+                    content: [{ type: "text", text }],
+                    details: {
+                        status: snapshot.status,
+                        sessionId,
+                        exitCode: snapshot.exitCode,
+                        exitSignal: snapshot.exitSignal,
+                        aggregated: snapshot.status !== "running",
+                    },
+                };
+            }
+            if (action === "log") {
+                const slice = options.registry.readLog({
+                    sessionId,
+                    scopeKey: options.scopeKey,
+                    offset: params.offset,
+                    limit: params.limit,
+                });
+                if (!slice) {
+                    return failResult(`No session found for ${sessionId}`);
+                }
+                const text = slice.text.trim().length > 0 ? slice.text : "(no output)";
+                return {
+                    content: [{ type: "text", text }],
+                    details: {
+                        status: slice.status,
+                        sessionId,
+                        totalLines: slice.totalLines,
+                        totalChars: slice.totalChars,
+                        truncated: slice.truncated,
+                        exitCode: slice.exitCode,
+                        exitSignal: slice.exitSignal,
+                    },
+                };
+            }
+            if (action === "kill") {
+                const snapshot = await options.registry.terminate(sessionId, options.scopeKey);
+                if (!snapshot) {
+                    return failResult(`No session found for ${sessionId}`);
+                }
+                const text = snapshot.status === "running"
+                    ? `Termination signal sent to ${sessionId}.`
+                    : `Session ${sessionId} terminated with status=${snapshot.status}.`;
+                return {
+                    content: [{ type: "text", text }],
+                    details: {
+                        status: snapshot.status,
+                        sessionId,
+                        exitCode: snapshot.exitCode,
+                        exitSignal: snapshot.exitSignal,
+                    },
+                };
+            }
+            return failResult(`Unsupported action: ${params.action}`);
+        },
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/tools/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"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"}

package/dist/tools/subagent-spawn.d.ts

@@ -0,0 +1,44 @@
+import type { TObject, TString, TOptional } from "@sinclair/typebox";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { AgentRunParams, AgentRunResult } from "../types.js";
+import type { ToolLoopDetectionConfig } from "../loop-detection/tool-loop-detection.js";
+import { SubagentRegistry } from "../subagent/registry.js";
+declare const spawnSchema: TObject<{
+    task: TString;
+    label: TOptional<TString>;
+}>;
+type SpawnResult = {
+    status: "accepted";
+    childSessionId: string;
+    runId: string;
+    note: string;
+} | {
+    status: "forbidden";
+    error: string;
+} | {
+    status: "error";
+    error: string;
+};
+/** Formats the announce message injected into the parent session when a subagent completes. */
+export declare function buildSubagentAnnounceMessage(params: {
+    task: string;
+    label?: string;
+    status: "done" | "error" | "killed";
+    result?: string;
+    error?: string;
+}): string;
+/**
+ * Creates the sessions_spawn tool that allows an agent to delegate tasks to subagents.
+ *
+ * @param registry  The parent session's subagent registry.
+ * @param parentSessionId  Session ID of the agent doing the spawning.
+ * @param depth  Current nesting depth of the spawning agent (child will be depth+1).
+ * @param dataDir  User data directory (shared between parent and child).
+ * @param channel  Channel inherited from the parent session.
+ * @param llm  LLM config inherited from the parent.
+ * @param loopDetection  Tool-loop detection config inherited from the parent.
+ * @param spawnFn  Function that actually runs a child agent (injected to avoid circular imports).
+ */
+export declare function createSessionsSpawnTool(registry: SubagentRegistry, parentSessionId: string, depth: number, dataDir: string, channel: AgentRunParams["channel"], llm: AgentRunParams["llm"], loopDetection: ToolLoopDetectionConfig | undefined, spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>): AgentTool<typeof spawnSchema, SpawnResult>;
+export {};
+//# sourceMappingURL=subagent-spawn.d.ts.map

package/dist/tools/subagent-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-spawn.d.ts","sourceRoot":"","sources":["../../src/tools/subagent-spawn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,QAAA,MAAM,WAAW,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC3B,CAGC,CAAC;AAIH,KAAK,WAAW,GACZ;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,+FAA+F;AAC/F,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAST;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAClC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,EAC1B,aAAa,EAAE,uBAAuB,GAAG,SAAS,EAClD,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,GAC3D,SAAS,CAAC,OAAO,WAAW,EAAE,WAAW,CAAC,CA+E5C"}