@brainpilot/runtime 0.0.1

package/dist/session-manager.js

@@ -0,0 +1,365 @@
+/**
+ * SessionManager — orchestration core + STATE AUTHORITY (§10).
+ *
+ * Owns all sessions. Each session owns its agents (MasAgent), Mailbox, trace
+ * (GraphOfTrace), and EventBus. The manager is the sole authority for agent
+ * status; it surfaces `GET /sessions/:id/agents`, `agent_status_update` SSE
+ * events, and feeds `/metrics`.
+ *
+ * Persistence (§5): config/history/state live under `<dataRoot>/.bp/{sid}/`,
+ * work files under `<dataRoot>/workspaces/{sid}/`.
+ */
+import { mkdir, readFile, writeFile, readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { EventBus } from "./event-bus.js";
+import { Mailbox } from "./mailbox.js";
+import { GraphOfTrace } from "./trace.js";
+import { MasAgent } from "./mas-agent.js";
+import { systemToolsForRole, builtinToolNamesForRole } from "./tools/system-tools.js";
+import { ev } from "./events.js";
+import { selectFactory, isMockMode } from "./agent-factory.js";
+import { McpBridge, loadMcpServersConfig } from "./mcp-bridge.js";
+/** Roles inferred from agent name. */
+function roleFor(name) {
+    if (name === "principal")
+        return "principal";
+    if (name === "trace")
+        return "trace";
+    return "expert";
+}
+export class SessionManager {
+    sessions = new Map();
+    dataRoot;
+    agentFactory;
+    persist;
+    lastActivityAt = 0;
+    // External MCP tools (§9 decision 2): loaded once, lazily, shared by all
+    // non-trace agents. Null until first agent is created.
+    mcpBridge;
+    mcpTools = [];
+    mcpLoaded = false;
+    constructor(opts = {}) {
+        this.dataRoot = opts.dataRoot ?? process.env.BP_DATA_DIR ?? join(process.cwd(), ".bp-data");
+        this.agentFactory = opts.agentFactory ?? selectFactory();
+        this.persist = opts.persist ?? true;
+        this.mcpBridge = opts.mcpBridge ?? null;
+    }
+    /**
+     * Load external MCP tools once. No-op in mock mode (BP_MOCK=1) and when no
+     * `mcp_servers.json` is present, so the default path stays zero-overhead.
+     */
+    async ensureMcpTools() {
+        if (this.mcpLoaded)
+            return this.mcpTools;
+        this.mcpLoaded = true;
+        if (isMockMode() && !this.mcpBridge)
+            return this.mcpTools;
+        try {
+            const cfg = await loadMcpServersConfig(this.dataRoot);
+            if (!cfg)
+                return this.mcpTools;
+            if (!this.mcpBridge)
+                this.mcpBridge = new McpBridge();
+            this.mcpTools = await this.mcpBridge.connectAll(cfg);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error("[mcp] bridge load failed:", err.message);
+        }
+        return this.mcpTools;
+    }
+    bpDir(sid) {
+        return join(this.dataRoot, ".bp", sid);
+    }
+    workspaceDir(sid) {
+        return join(this.dataRoot, "workspaces", sid);
+    }
+    historyPath(sid, agent) {
+        return join(this.bpDir(sid), "history", `${agent}.jsonl`);
+    }
+    /* ---------------------------- session CRUD ---------------------------- */
+    async createSession(input = {}) {
+        const id = input.id ?? randomUUID();
+        if (this.sessions.has(id))
+            return this.toSession(this.sessions.get(id));
+        const nowIso = new Date().toISOString();
+        const persistBase = this.persist ? this.bpDir(id) : undefined;
+        const bus = new EventBus({ persistPath: persistBase ? join(persistBase, "events.jsonl") : undefined });
+        const mailbox = new Mailbox(id, persistBase ? join(persistBase, "mailbox") : undefined);
+        const trace = new GraphOfTrace(id, persistBase ? join(persistBase, "trace.json") : undefined);
+        const entry = {
+            id,
+            title: input.title ?? "Untitled session",
+            createdAt: nowIso,
+            updatedAt: nowIso,
+            lastActivityAt: Date.now(),
+            bus,
+            mailbox,
+            trace,
+            agents: new Map(),
+            tasks: new Map(),
+            runActive: false,
+            activeRunId: null,
+        };
+        this.sessions.set(id, entry);
+        this.touch(entry);
+        if (this.persist) {
+            await mkdir(join(this.bpDir(id), "history"), { recursive: true });
+            await mkdir(this.workspaceDir(id), { recursive: true });
+            await this.writeMeta(entry);
+            await mailbox.recover();
+            await this.loadTrace(entry);
+        }
+        return this.toSession(entry);
+    }
+    getSession(id) {
+        const e = this.sessions.get(id);
+        return e ? this.toSession(e) : undefined;
+    }
+    listSessions() {
+        return [...this.sessions.values()].map((e) => this.toSession(e));
+    }
+    async deleteSession(id) {
+        const e = this.sessions.get(id);
+        if (!e)
+            return false;
+        for (const a of e.agents.values())
+            a.stop();
+        e.bus.clear();
+        this.sessions.delete(id);
+        if (this.persist) {
+            await rm(this.bpDir(id), { recursive: true, force: true }).catch(() => { });
+            await rm(this.workspaceDir(id), { recursive: true, force: true }).catch(() => { });
+        }
+        return true;
+    }
+    /** Evict idle session: stop agents + drop from memory, KEEP disk (§修正2). */
+    async evictSession(id) {
+        const e = this.sessions.get(id);
+        if (!e)
+            return { evicted: false, agentsKilled: 0 };
+        let killed = 0;
+        for (const a of e.agents.values()) {
+            a.stop();
+            killed++;
+        }
+        await e.bus.flush();
+        await e.mailbox.flush();
+        await e.trace.flush();
+        e.bus.clear();
+        this.sessions.delete(id);
+        return { evicted: true, agentsKilled: killed };
+    }
+    /* ----------------------------- messaging ----------------------------- */
+    /** Send a user message to an agent (default principal). §7 L3 isolated. */
+    async sendMessage(sessionId, content, agentName = "principal") {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            throw new Error(`session not found: ${sessionId}`);
+        this.touch(entry);
+        const agent = await this.ensureAgent(sessionId, agentName);
+        entry.runActive = true;
+        entry.activeRunId = `run_${randomUUID()}`;
+        const runId = entry.activeRunId;
+        // Fire-and-track: don't block the HTTP response on the full run.
+        void agent
+            .prompt(content)
+            .catch((err) => {
+            entry.bus.emit(ev.systemMessage(sessionId, "error", `发送消息失败: ${err.message}`, { agent: agentName }));
+        })
+            .finally(() => {
+            entry.runActive = false;
+            entry.activeRunId = null;
+            this.touch(entry);
+        });
+        return { accepted: true, runId };
+    }
+    /** Interrupt a session (or a specific agent). */
+    async interrupt(sessionId, agentName) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return false;
+        const targets = agentName ? [entry.agents.get(agentName)].filter(Boolean) : [...entry.agents.values()];
+        for (const a of targets)
+            await a.abort();
+        entry.runActive = false;
+        entry.activeRunId = null;
+        return targets.length > 0;
+    }
+    /* ------------------------------ agents ------------------------------- */
+    /** Ensure an agent exists (create or resurrect). */
+    async ensureAgent(sessionId, name) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            throw new Error(`session not found: ${sessionId}`);
+        const existing = entry.agents.get(name);
+        if (existing && existing.status !== "stopped")
+            return existing;
+        const role = roleFor(name);
+        const deps = {
+            sessionId,
+            fromAgent: name,
+            mailbox: entry.mailbox,
+            trace: entry.trace,
+            ensureAgent: async (target) => {
+                await this.ensureAgent(sessionId, target);
+            },
+            destroyAgent: async (target) => {
+                await this.destroyAgent(sessionId, target);
+            },
+        };
+        const systemTools = systemToolsForRole(role, name, deps);
+        // External MCP tools go to non-trace agents (trace agent is graph-only, §9).
+        const mcpTools = role === "trace" ? [] : await this.ensureMcpTools();
+        const agentTools = [...systemTools, ...mcpTools];
+        const builtins = builtinToolNamesForRole(role);
+        const allowedToolNames = [...builtins, ...agentTools.map((t) => t.name)];
+        const session = await this.agentFactory({
+            sessionId,
+            agentName: name,
+            role,
+            historyPath: this.historyPath(sessionId, name),
+            cwd: this.workspaceDir(sessionId),
+            systemTools: agentTools,
+            allowedToolNames,
+            systemPrompt: `You are the ${name} agent (${role}).`,
+        });
+        const agent = new MasAgent({
+            sessionId,
+            name,
+            role,
+            session,
+            bus: entry.bus,
+            onStatusChange: () => this.touch(entry),
+        });
+        entry.agents.set(name, agent);
+        if (!entry.tasks.has(name))
+            entry.tasks.set(name, "");
+        return agent;
+    }
+    async destroyAgent(sessionId, name) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return;
+        const agent = entry.agents.get(name);
+        if (!agent)
+            return;
+        agent.stop();
+        entry.agents.delete(name); // history on disk is kept (§5).
+    }
+    /* -------------------------- state authority -------------------------- */
+    /** §10 polling fallback: list agents with authoritative status. */
+    listAgents(sessionId) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return [];
+        return [...entry.agents.values()].map((a) => {
+            const st = a.state();
+            const out = {
+                name: a.name,
+                status: st.status,
+                task: entry.tasks.get(a.name) ?? "",
+                updatedAt: new Date().toISOString(),
+                alive: st.status !== "stopped",
+            };
+            return out;
+        });
+    }
+    getSessionState(sessionId) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return undefined;
+        return {
+            runState: { active: entry.runActive, runId: entry.activeRunId },
+            agents: this.listAgents(sessionId),
+            lastActivityTs: new Date(entry.lastActivityAt).toISOString(),
+        };
+    }
+    metrics() {
+        let runningAgents = 0;
+        for (const e of this.sessions.values()) {
+            for (const a of e.agents.values())
+                if (a.status === "running")
+                    runningAgents++;
+        }
+        return {
+            activeSessions: this.sessions.size,
+            runningAgents,
+            lastActivityAt: this.lastActivityAt ? new Date(this.lastActivityAt).toISOString() : null,
+            memRss: process.memoryUsage().rss,
+        };
+    }
+    /* ----------------------------- SSE/events ---------------------------- */
+    subscribe(sessionId, listener) {
+        const entry = this.sessions.get(sessionId);
+        return entry?.bus.subscribe(listener);
+    }
+    recentEvents(sessionId) {
+        return this.sessions.get(sessionId)?.bus.recent() ?? [];
+    }
+    /* ----------------------------- shutdown ------------------------------ */
+    /** §7: flush all persisted state before exit. */
+    async emergencySaveAll() {
+        await Promise.all([...this.sessions.values()].flatMap((e) => [e.bus.flush(), e.mailbox.flush(), e.trace.flush(), this.writeMeta(e)]));
+        await this.mcpBridge?.close().catch(() => { });
+    }
+    /* ------------------------------ helpers ------------------------------ */
+    touch(entry) {
+        entry.lastActivityAt = Date.now();
+        entry.updatedAt = new Date().toISOString();
+        this.lastActivityAt = entry.lastActivityAt;
+    }
+    toSession(e) {
+        return { id: e.id, title: e.title, createdAt: e.createdAt, updatedAt: e.updatedAt };
+    }
+    async writeMeta(entry) {
+        if (!this.persist)
+            return;
+        const meta = {
+            id: entry.id,
+            title: entry.title,
+            createdAt: entry.createdAt,
+            updatedAt: entry.updatedAt,
+            lastActivityAt: entry.lastActivityAt,
+        };
+        await mkdir(this.bpDir(entry.id), { recursive: true }).catch(() => { });
+        await writeFile(join(this.bpDir(entry.id), "meta.json"), JSON.stringify(meta, null, 2), "utf8").catch(() => { });
+    }
+    async loadTrace(entry) {
+        try {
+            const raw = await readFile(join(this.bpDir(entry.id), "trace.json"), "utf8");
+            entry.trace.load(JSON.parse(raw));
+        }
+        catch {
+            /* no trace yet */
+        }
+    }
+    /** Restore session list from disk (§10 策略A: agents start idle, lazily revived). */
+    async restoreFromDisk() {
+        const restored = [];
+        const root = join(this.dataRoot, ".bp");
+        let ids;
+        try {
+            ids = await readdir(root);
+        }
+        catch {
+            return restored;
+        }
+        for (const id of ids) {
+            try {
+                const raw = await readFile(join(root, id, "meta.json"), "utf8");
+                const meta = JSON.parse(raw);
+                if (!this.sessions.has(meta.id)) {
+                    await this.createSession({ id: meta.id, title: meta.title });
+                    restored.push(meta.id);
+                }
+            }
+            catch {
+                /* skip non-session dirs */
+            }
+        }
+        return restored;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/tools/system-tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * BrainPilot system tools (§9 decision 1) — defined as plain `SystemTool`
+ * objects (name + JSON-schema params + execute closure). The real agent
+ * factory wraps these with Pi's `defineTool`; the mock invokes `execute`
+ * directly. Closures capture session context (mailbox, trace, manager).
+ *
+ * Per-agent access control (§9, ported from legacy `agent_tool_config`) is
+ * applied by `toolsForRole` — each role only receives its allowed tools.
+ */
+import type { AgentRole, SystemTool } from "../types.js";
+import type { Mailbox } from "../mailbox.js";
+import type { GraphOfTrace } from "../trace.js";
+export interface ToolDeps {
+    sessionId: string;
+    fromAgent: string;
+    mailbox: Mailbox;
+    trace: GraphOfTrace;
+    /** Ensure an agent exists (auto-create/resurrect). */
+    ensureAgent: (name: string) => Promise<void>;
+    /** Destroy an agent (memory only; history kept). */
+    destroyAgent: (name: string) => Promise<void>;
+}
+export declare function createSendMessageTool(deps: ToolDeps): SystemTool;
+export declare function createCreateAgentTool(deps: ToolDeps): SystemTool;
+export declare function createDestroyAgentTool(deps: ToolDeps): SystemTool;
+export declare function createRecordTraceTool(deps: ToolDeps): SystemTool;
+export declare function createTraceNodeTool(deps: ToolDeps): SystemTool;
+export declare function createUpdateTraceNodeTool(deps: ToolDeps): SystemTool;
+export declare function createAddTraceRelationTool(deps: ToolDeps): SystemTool;
+export declare function createGetTraceGraphTool(deps: ToolDeps): SystemTool;
+/** All system tools, keyed by name. */
+export declare function allSystemTools(deps: ToolDeps): Map<string, SystemTool>;
+/**
+ * Per-agent system-tool access control (§9, ported from legacy
+ * `agent_tool_config`). Returns the system tools a role may use. Built-in Pi
+ * tools (read/bash/grep/...) are controlled separately via `builtinToolsForRole`.
+ */
+export declare const AGENT_TOOL_CONFIG: Record<string, string[]>;
+/** Built-in Pi tool allowlist per role. */
+export declare const BUILTIN_TOOL_CONFIG: Record<string, string[]>;
+export declare function systemToolNamesForRole(role: AgentRole, agentName: string): string[];
+export declare function builtinToolNamesForRole(role: AgentRole): string[];
+export declare function systemToolsForRole(role: AgentRole, agentName: string, deps: ToolDeps): SystemTool[];
+//# sourceMappingURL=system-tools.d.ts.map

package/dist/tools/system-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,sDAAsD;IACtD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,oDAAoD;IACpD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAsBhE;AAOD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAehE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAejE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CA0BhE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CA4B9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAwBpE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAwBrE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAOlE;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAYtE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAMtD,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKxD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAEjE;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GACb,UAAU,EAAE,CAId"}

package/dist/tools/system-tools.js

@@ -0,0 +1,225 @@
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function createSendMessageTool(deps) {
+    return {
+        name: "send_message",
+        description: "Send a message to another agent (e.g. principal or an expert).",
+        parameters: {
+            type: "object",
+            properties: {
+                content: { type: "string", description: "Message body" },
+                to: { type: "string", description: "Target agent name", default: "principal" },
+                msg_type: { type: "string", enum: ["result_deliver", "task_delegate"] },
+            },
+            required: ["content"],
+        },
+        execute: async (params) => {
+            const to = params.to ?? "principal";
+            const content = String(params.content ?? "");
+            const msgType = params.msg_type ?? deriveMsgType(deps.fromAgent, to);
+            await deps.ensureAgent(to);
+            await deps.mailbox.write({ fromAgent: deps.fromAgent, toAgent: to, content, msgType });
+            return ok(`delivered to ${to}`);
+        },
+    };
+}
+function deriveMsgType(from, to) {
+    if (to === "principal")
+        return "result_deliver";
+    return "task_delegate";
+}
+export function createCreateAgentTool(deps) {
+    return {
+        name: "create_agent",
+        description: "Create (or resurrect) an expert agent by type.",
+        parameters: {
+            type: "object",
+            properties: { agent_type: { type: "string" } },
+            required: ["agent_type"],
+        },
+        execute: async (params) => {
+            const name = String(params.agent_type ?? "");
+            await deps.ensureAgent(name);
+            return ok(`agent ${name} ready`);
+        },
+    };
+}
+export function createDestroyAgentTool(deps) {
+    return {
+        name: "destroy_agent",
+        description: "Destroy an expert agent (history preserved; can be revived).",
+        parameters: {
+            type: "object",
+            properties: { agent_type: { type: "string" } },
+            required: ["agent_type"],
+        },
+        execute: async (params) => {
+            const name = String(params.agent_type ?? "");
+            await deps.destroyAgent(name);
+            return ok(`agent ${name} destroyed`);
+        },
+    };
+}
+export function createRecordTraceTool(deps) {
+    return {
+        name: "record_trace",
+        description: "Record a reasoning/trace event into the Graph of Trace.",
+        parameters: {
+            type: "object",
+            properties: {
+                description: { type: "string" },
+                artifacts: { type: "array", items: { type: "string" } },
+                context: { type: "string" },
+            },
+            required: ["description"],
+        },
+        execute: async (params) => {
+            const node = deps.trace.createNode({
+                title: String(params.description ?? "trace"),
+                type: "trace",
+                status: "completed",
+                agent: deps.fromAgent,
+                description: String(params.description ?? ""),
+                content: String(params.context ?? ""),
+                artifacts: (params.artifacts ?? []).map((p) => ({ path: p })),
+            });
+            return ok(`trace recorded: ${node.id}`);
+        },
+    };
+}
+export function createTraceNodeTool(deps) {
+    return {
+        name: "create_trace_node",
+        description: "Create a node in the Graph of Trace.",
+        parameters: {
+            type: "object",
+            properties: {
+                title: { type: "string" },
+                type: { type: "string" },
+                status: { type: "string" },
+                description: { type: "string" },
+                parent_id: { type: "string" },
+            },
+            required: ["title"],
+        },
+        execute: async (params) => {
+            const parentId = params.parent_id ? String(params.parent_id) : undefined;
+            const node = deps.trace.createNode({
+                title: String(params.title ?? ""),
+                type: params.type ? String(params.type) : undefined,
+                status: params.status ? String(params.status) : undefined,
+                description: params.description ? String(params.description) : undefined,
+                agent: deps.fromAgent,
+                parents: parentId ? [{ id: parentId, relation: "parent" }] : undefined,
+            });
+            return ok(`node ${node.id} created`);
+        },
+    };
+}
+export function createUpdateTraceNodeTool(deps) {
+    return {
+        name: "update_trace_node",
+        description: "Update fields of an existing trace node.",
+        parameters: {
+            type: "object",
+            properties: {
+                node_id: { type: "string" },
+                status: { type: "string" },
+                summary: { type: "string" },
+                content: { type: "string" },
+            },
+            required: ["node_id"],
+        },
+        execute: async (params) => {
+            const id = String(params.node_id ?? "");
+            const updates = {};
+            for (const k of ["status", "summary", "content", "title", "description"]) {
+                if (params[k] !== undefined)
+                    updates[k] = params[k];
+            }
+            const node = deps.trace.updateNode(id, updates);
+            return node ? ok(`node ${id} updated`) : { ...ok(`node ${id} not found`), isError: true };
+        },
+    };
+}
+export function createAddTraceRelationTool(deps) {
+    return {
+        name: "add_trace_relation",
+        description: "Add a relation (edge) between two trace nodes.",
+        parameters: {
+            type: "object",
+            properties: {
+                from_id: { type: "string" },
+                to_id: { type: "string" },
+                explanation: { type: "string" },
+            },
+            required: ["from_id", "to_id", "explanation"],
+        },
+        execute: async (params) => {
+            const okEdge = deps.trace.addRelation(String(params.from_id ?? ""), String(params.to_id ?? ""), String(params.explanation ?? ""));
+            return okEdge
+                ? ok("relation added")
+                : { ...ok("relation failed: node not found"), isError: true };
+        },
+    };
+}
+export function createGetTraceGraphTool(deps) {
+    return {
+        name: "get_trace_graph",
+        description: "Get the current Graph of Trace as JSON.",
+        parameters: { type: "object", properties: {} },
+        execute: async () => ok(JSON.stringify(deps.trace.getGraph())),
+    };
+}
+/** All system tools, keyed by name. */
+export function allSystemTools(deps) {
+    const tools = [
+        createSendMessageTool(deps),
+        createCreateAgentTool(deps),
+        createDestroyAgentTool(deps),
+        createRecordTraceTool(deps),
+        createTraceNodeTool(deps),
+        createUpdateTraceNodeTool(deps),
+        createAddTraceRelationTool(deps),
+        createGetTraceGraphTool(deps),
+    ];
+    return new Map(tools.map((t) => [t.name, t]));
+}
+/**
+ * Per-agent system-tool access control (§9, ported from legacy
+ * `agent_tool_config`). Returns the system tools a role may use. Built-in Pi
+ * tools (read/bash/grep/...) are controlled separately via `builtinToolsForRole`.
+ */
+export const AGENT_TOOL_CONFIG = {
+    principal: ["send_message", "create_agent", "destroy_agent", "record_trace"],
+    trace: ["create_trace_node", "update_trace_node", "add_trace_relation", "get_trace_graph"],
+    expert: ["send_message", "record_trace"],
+    // Default for any other expert-like agent.
+    _default: ["send_message", "record_trace"],
+};
+/** Built-in Pi tool allowlist per role. */
+export const BUILTIN_TOOL_CONFIG = {
+    principal: [],
+    trace: ["read"],
+    expert: ["read", "grep", "find"],
+    _default: ["read", "grep", "find"],
+};
+export function systemToolNamesForRole(role, agentName) {
+    // `trace` agent keyed by role; principal by role; experts share `_default`
+    // unless a named override exists.
+    if (role === "principal")
+        return AGENT_TOOL_CONFIG.principal;
+    if (role === "trace")
+        return AGENT_TOOL_CONFIG.trace;
+    return AGENT_TOOL_CONFIG[agentName] ?? AGENT_TOOL_CONFIG.expert ?? AGENT_TOOL_CONFIG._default;
+}
+export function builtinToolNamesForRole(role) {
+    return BUILTIN_TOOL_CONFIG[role] ?? BUILTIN_TOOL_CONFIG._default;
+}
+export function systemToolsForRole(role, agentName, deps) {
+    const allowed = new Set(systemToolNamesForRole(role, agentName));
+    const all = allSystemTools(deps);
+    return [...allowed].map((n) => all.get(n)).filter((t) => !!t);
+}
+//# sourceMappingURL=system-tools.js.map