agent-comms 1.0.0 → 1.0.4

package/dist/bridges/pi/index.js

@@ -0,0 +1,140 @@
+/**
+ * Agent Comms — pi bridge extension.
+ *
+ * Provides the `agent_comms` tool and watches the delivery queue,
+ * pushing incoming messages via sendUserMessage().
+ *
+ * Install: add bridge path to ~/.pi/agent/settings.json extensions array
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { Type } from "typebox";
+import { StringEnum } from "@mariozechner/pi-ai";
+import { BusStore, BusTool, buildAction, ensureRegistered, drainAndFormat, } from "../../core/index.js";
+import { nanoid } from "../../core/nanoid.js";
+const BUS_ROOT = path.join(os.homedir(), ".agents", "bus");
+export default function (pi) {
+    const store = new BusStore(BUS_ROOT);
+    const tool = new BusTool(store);
+    let agentId;
+    let watcher;
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    pi.on("session_start", async (_event, ctx) => {
+        const reg = await ensureRegistered({
+            store,
+            harness: "pi",
+            defaultName: `pi-${nanoid(4)}`,
+        });
+        agentId = reg.agentId;
+        if (!reg.isNew) {
+            ctx.ui.notify(`Agent Comms: resumed as ${reg.agentId}`, "info");
+            await drainAndPush();
+        }
+        startWatching();
+    });
+    pi.on("session_shutdown", async () => {
+        watcher?.close();
+        if (agentId) {
+            await store.setAgentOffline(agentId);
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Delivery watcher
+    // -----------------------------------------------------------------------
+    function startWatching() {
+        if (!agentId)
+            return;
+        const deliveryDir = store.deliveryDir(agentId);
+        fs.mkdirSync(deliveryDir, { recursive: true });
+        watcher = fs.watch(deliveryDir, (event, filename) => {
+            if (event !== "rename" || !filename?.endsWith(".json"))
+                return;
+            void drainAndPush();
+        });
+    }
+    async function drainAndPush() {
+        if (!agentId)
+            return;
+        const lines = await drainAndFormat(store, agentId);
+        for (const line of lines) {
+            pi.sendUserMessage(`📬 ${line}`, { deliverAs: "followUp" });
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Tool registration
+    // -----------------------------------------------------------------------
+    pi.registerTool({
+        name: "agent_comms",
+        label: "Agent Comms",
+        description: [
+            "Cross-harness agent communication bus. Send messages to rooms and DM other agents.",
+            "Actions: register, update, whoami, create_room, list_rooms, join_room, leave_room,",
+            "send, dm, list_agents, read_room, invite, kick, destroy_room.",
+            "Register first, then join or create rooms to communicate.",
+        ].join(" "),
+        promptSnippet: "Communicate with other LLM agents via rooms and DMs",
+        promptGuidelines: [
+            "Use agent_comms to coordinate with other running agents. Register on session start, join rooms for collaboration.",
+        ],
+        parameters: Type.Object({
+            action: StringEnum([
+                "register",
+                "update",
+                "whoami",
+                "create_room",
+                "list_rooms",
+                "join_room",
+                "leave_room",
+                "send",
+                "dm",
+                "list_agents",
+                "read_room",
+                "invite",
+                "kick",
+                "destroy_room",
+            ], { description: "Action to perform" }),
+            name: Type.Optional(Type.String({
+                description: "Agent display name (for register/update)",
+            })),
+            visibility: Type.Optional(StringEnum(["visible", "hidden", "ghost"], {
+                description: "Visibility to other agents",
+            })),
+            tags: Type.Optional(Type.Array(Type.String(), { description: "Agent capability tags" })),
+            status: Type.Optional(StringEnum(["active", "idle", "busy"], {
+                description: "Agent status (for update)",
+            })),
+            room: Type.Optional(Type.String({ description: "Room name/ID" })),
+            type: Type.Optional(StringEnum(["public", "private", "secret"], {
+                description: "Room type (for create_room)",
+            })),
+            description: Type.Optional(Type.String({ description: "Room description (for create_room)" })),
+            target: Type.Optional(Type.String({ description: "Target room name or agent ID" })),
+            content: Type.Optional(Type.String({ description: "Message content" })),
+            replyTo: Type.Optional(Type.String({ description: "Message ID to reply to" })),
+            agent: Type.Optional(Type.String({ description: "Target agent ID (for invite/kick)" })),
+            since: Type.Optional(Type.String({
+                description: "ISO timestamp to read messages since",
+            })),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            if (!agentId) {
+                return {
+                    content: [{ type: "text", text: "Error: not registered" }],
+                    details: {},
+                    isError: true,
+                };
+            }
+            const action = buildAction(params);
+            const result = await tool.handle({ agentId, harness: "pi", pid: process.pid }, action);
+            return {
+                content: [{ type: "text", text: result.content }],
+                details: { action: params.action },
+                isError: result.isError,
+            };
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/bridges/pi/index.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+/**
+ * agent-comms — cross-harness LLM agent communication bus.
+ *
+ * Usage:
+ *   npx agent-comms              # setup (auto-detect and configure)
+ *   npx agent-comms setup        # same as above
+ *   npx agent-comms status       # check current configuration
+ *   npx agent-comms remove       # undo configuration
+ *   npx agent-comms bridge <id>  # run a bridge (used by harness configs)
+ *
+ * The bridge subcommand lets harnesses invoke the bridge via npx:
+ *   .mcp.json:  { "command": "npx", "args": ["agent-comms", "bridge", "claude-code"] }
+ *   config.toml: command = "npx", args = ["agent-comms", "bridge", "codex"]
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/cli.js

@@ -0,0 +1,505 @@
+/**
+ * agent-comms — cross-harness LLM agent communication bus.
+ *
+ * Usage:
+ *   npx agent-comms              # setup (auto-detect and configure)
+ *   npx agent-comms setup        # same as above
+ *   npx agent-comms status       # check current configuration
+ *   npx agent-comms remove       # undo configuration
+ *   npx agent-comms bridge <id>  # run a bridge (used by harness configs)
+ *
+ * The bridge subcommand lets harnesses invoke the bridge via npx:
+ *   .mcp.json:  { "command": "npx", "args": ["agent-comms", "bridge", "claude-code"] }
+ *   config.toml: command = "npx", args = ["agent-comms", "bridge", "codex"]
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { execSync, spawn } from "node:child_process";
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Zod schemas for config files
+// ---------------------------------------------------------------------------
+const PiSettingsSchema = z
+    .object({
+    extensions: z.array(z.string()).optional(),
+})
+    .loose();
+const McpServersSchema = z
+    .object({
+    mcpServers: z.record(z.string(), z
+        .object({
+        command: z.string(),
+        args: z.array(z.string()).optional(),
+    })
+        .loose()),
+})
+    .loose();
+const HooksSchema = z
+    .object({
+    hooks: z
+        .object({
+        Stop: z
+            .array(z
+            .object({
+            hooks: z
+                .array(z
+                .object({
+                type: z.string(),
+                command: z.string(),
+                timeout: z.number().optional(),
+            })
+                .loose())
+                .optional(),
+        })
+            .loose())
+            .optional(),
+    })
+        .optional(),
+})
+    .loose();
+const OpenCodeConfigSchema = z
+    .object({
+    plugin: z.array(z.string()).optional(),
+})
+    .loose();
+// ---------------------------------------------------------------------------
+// Config I/O
+// ---------------------------------------------------------------------------
+function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJsonFile(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+    console.log(`  → Wrote ${filePath}`);
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const HOME = os.homedir();
+const PKG_DIR = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+// ---------------------------------------------------------------------------
+// Harness definitions
+// ---------------------------------------------------------------------------
+const harnesses = [
+    {
+        id: "pi",
+        detect: () => fs.existsSync(path.join(HOME, ".pi", "agent", "extensions")),
+        configure: () => {
+            configurePi();
+        },
+        remove: () => {
+            removePi();
+        },
+        check: () => checkPi(),
+    },
+    {
+        id: "claude-code",
+        detect: () => {
+            try {
+                execSync("which claude", { stdio: "pipe" });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        configure: () => {
+            configureClaudeCode();
+        },
+        remove: () => {
+            removeClaudeCode();
+        },
+        check: () => checkClaudeCode(),
+    },
+    {
+        id: "codex",
+        detect: () => {
+            try {
+                execSync("which codex", { stdio: "pipe" });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        configure: () => {
+            configureCodex();
+        },
+        remove: () => {
+            removeCodex();
+        },
+        check: () => checkCodex(),
+    },
+    {
+        id: "opencode",
+        detect: () => {
+            try {
+                execSync("which opencode", { stdio: "pipe" });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        configure: () => {
+            configureOpenCode();
+        },
+        remove: () => {
+            removeOpenCode();
+        },
+        check: () => checkOpenCode(),
+    },
+];
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+const command = process.argv[2] ?? "setup";
+switch (command) {
+    case "setup":
+        setup();
+        break;
+    case "status":
+        status();
+        break;
+    case "remove":
+        remove();
+        break;
+    case "bridge": {
+        const bridgeId = process.argv[3];
+        if (!bridgeId) {
+            console.error("Usage: agent-comms bridge <id>");
+            process.exit(1);
+        }
+        runBridge(bridgeId);
+        break;
+    }
+    default:
+        console.log("Usage: agent-comms [setup|status|remove|bridge <id>]");
+        process.exit(1);
+}
+// ---------------------------------------------------------------------------
+// Bridge runner
+// ---------------------------------------------------------------------------
+function runBridge(id) {
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", id);
+    const entryPoints = [
+        path.join(bridgeDir, "channel.ts"),
+        path.join(bridgeDir, "tool.ts"),
+        path.join(bridgeDir, "index.ts"),
+        path.join(bridgeDir, "plugin.ts"),
+        path.join(bridgeDir, "stop_hook.ts"),
+    ];
+    const entry = entryPoints.find((f) => fs.existsSync(f));
+    if (!entry) {
+        console.error(`Unknown bridge: ${id}`);
+        process.exit(1);
+    }
+    const cmd = process.execPath;
+    const args = [entry, ...process.argv.slice(4)];
+    const child = spawn(cmd, args, { stdio: "inherit" });
+    child.on("exit", (code) => process.exit(code ?? 0));
+}
+// ---------------------------------------------------------------------------
+// Commands
+// ---------------------------------------------------------------------------
+function setup() {
+    console.log("🔌 Agent Comms setup\n");
+    const detected = harnesses.filter((h) => h.detect());
+    console.log("Detected harnesses:");
+    for (const h of harnesses) {
+        console.log(`  ${detected.includes(h) ? "✓" : "✗"} ${h.id}`);
+    }
+    if (detected.length === 0) {
+        console.log("\nNo supported harnesses found. Install one of: pi, Claude Code, Codex, OpenCode");
+        process.exit(1);
+    }
+    console.log();
+    for (const h of detected) {
+        console.log(`Configuring ${h.id}...`);
+        h.configure();
+    }
+    const plural = detected.length === 1 ? "" : "es";
+    console.log(`\n✓ Done! ${String(detected.length)} harness${plural} configured.`);
+    console.log("\nBridges run via: npx agent-comms bridge <id>");
+}
+function status() {
+    console.log("🔌 Agent Comms status\n");
+    for (const h of harnesses) {
+        const installed = h.detect();
+        const result = installed
+            ? h.check()
+            : { configured: false, details: Array() };
+        if (!installed) {
+            console.log(`  ✗ ${h.id} — not found`);
+        }
+        else if (result.configured) {
+            console.log(`  ✓ ${h.id} — configured`);
+            for (const detail of result.details)
+                console.log(`    ${detail}`);
+        }
+        else {
+            console.log(`  ⚠ ${h.id} — detected but not configured`);
+            for (const detail of result.details)
+                console.log(`    ${detail}`);
+        }
+    }
+}
+function remove() {
+    console.log("🔌 Agent Comms removal\n");
+    for (const h of harnesses) {
+        if (h.detect()) {
+            console.log(`Removing ${h.id}...`);
+            h.remove();
+        }
+    }
+    console.log("\n✓ Done!");
+}
+// ---------------------------------------------------------------------------
+// pi
+// ---------------------------------------------------------------------------
+function configurePi() {
+    const settingsPath = path.join(HOME, ".pi", "agent", "settings.json");
+    const parsed = readJsonFile(settingsPath);
+    const settings = PiSettingsSchema.parse(parsed ?? {});
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "pi");
+    const extensions = settings.extensions ?? [];
+    if (!extensions.includes(bridgeDir)) {
+        extensions.push(bridgeDir);
+        settings.extensions = extensions;
+        writeJsonFile(settingsPath, settings);
+    }
+    else {
+        console.log(`  → Already in ${settingsPath}`);
+    }
+}
+function removePi() {
+    const settingsPath = path.join(HOME, ".pi", "agent", "settings.json");
+    const parsed = readJsonFile(settingsPath);
+    const settings = PiSettingsSchema.parse(parsed ?? {});
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "pi");
+    const extensions = settings.extensions;
+    if (extensions) {
+        settings.extensions = extensions.filter((e) => e !== bridgeDir);
+        writeJsonFile(settingsPath, settings);
+    }
+}
+function checkPi() {
+    const settingsPath = path.join(HOME, ".pi", "agent", "settings.json");
+    const parsed = readJsonFile(settingsPath);
+    const settings = PiSettingsSchema.parse(parsed ?? {});
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "pi");
+    const configured = (settings.extensions ?? []).includes(bridgeDir);
+    return {
+        configured,
+        details: configured
+            ? [`Extension: ${bridgeDir}`]
+            : [`Not in ${settingsPath} extensions`],
+    };
+}
+// ---------------------------------------------------------------------------
+// Claude Code
+// ---------------------------------------------------------------------------
+function configureClaudeCode() {
+    const mcpPath = path.join(process.cwd(), ".mcp.json");
+    const parsed = readJsonFile(mcpPath);
+    const config = McpServersSchema.parse(parsed ?? {});
+    config.mcpServers["agent-comms"] = {
+        command: "npx",
+        args: ["agent-comms", "bridge", "claude-code"],
+    };
+    writeJsonFile(mcpPath, config);
+}
+function removeClaudeCode() {
+    const mcpPath = path.join(process.cwd(), ".mcp.json");
+    const parsed = readJsonFile(mcpPath);
+    if (parsed === undefined)
+        return;
+    const config = McpServersSchema.safeParse(parsed);
+    if (!config.success)
+        return;
+    if ("agent-comms" in config.data.mcpServers) {
+        delete config.data.mcpServers["agent-comms"];
+        writeJsonFile(mcpPath, config.data);
+        console.log(`  Removed agent-comms from ${mcpPath}`);
+    }
+}
+function checkClaudeCode() {
+    const mcpPath = path.join(process.cwd(), ".mcp.json");
+    const parsed = readJsonFile(mcpPath);
+    const config = McpServersSchema.safeParse(parsed ?? {});
+    const entry = config.success
+        ? config.data.mcpServers["agent-comms"]
+        : undefined;
+    const configured = entry !== undefined;
+    return {
+        configured,
+        details: configured
+            ? [`Config: ${mcpPath}`, `Command: ${entry.command}`]
+            : [`Not in ${mcpPath}`],
+    };
+}
+// ---------------------------------------------------------------------------
+// Codex
+// ---------------------------------------------------------------------------
+function configureCodex() {
+    const configDir = path.join(HOME, ".codex");
+    // Add MCP server to config.toml
+    const tomlPath = path.join(configDir, "config.toml");
+    if (fs.existsSync(tomlPath)) {
+        const content = fs.readFileSync(tomlPath, "utf-8");
+        if (!content.includes("agent-comms")) {
+            const block = [
+                "",
+                "# Agent Comms MCP tool server",
+                "[mcp_servers.agent-comms]",
+                'command = "npx"',
+                'args = ["agent-comms", "bridge", "codex"]',
+            ].join("\n");
+            fs.writeFileSync(tomlPath, content.trimEnd() + block + "\n");
+            console.log(`  → Appended MCP server to ${tomlPath}`);
+        }
+        else {
+            console.log(`  → Already in ${tomlPath}`);
+        }
+    }
+    else {
+        const content = [
+            "# Agent Comms MCP tool server",
+            "[mcp_servers.agent-comms]",
+            'command = "npx"',
+            'args = ["agent-comms", "bridge", "codex"]',
+        ].join("\n");
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(tomlPath, content + "\n");
+        console.log(`  → Created ${tomlPath}`);
+    }
+    // Add Stop hook for delivery push
+    const hooksPath = path.join(configDir, "hooks.json");
+    const parsed = readJsonFile(hooksPath);
+    const hooks = HooksSchema.parse(parsed ?? {});
+    const hookEntry = {
+        type: "command",
+        command: `npx agent-comms bridge codex-stop`,
+        timeout: 10,
+    };
+    const stopHooks = hooks.hooks?.Stop ?? [{ hooks: [] }];
+    const firstHook = stopHooks[0];
+    if (firstHook === undefined)
+        return;
+    const innerHooks = firstHook.hooks ?? [];
+    const alreadyHasHook = innerHooks.some((h) => h.command.includes("agent-comms"));
+    if (!alreadyHasHook) {
+        innerHooks.push(hookEntry);
+        firstHook.hooks = innerHooks;
+        hooks.hooks = { Stop: stopHooks };
+        writeJsonFile(hooksPath, hooks);
+    }
+    else {
+        console.log(`  → Hook already in ${hooksPath}`);
+    }
+}
+function removeCodex() {
+    const configDir = path.join(HOME, ".codex");
+    // Remove from config.toml
+    const tomlPath = path.join(configDir, "config.toml");
+    if (fs.existsSync(tomlPath)) {
+        const content = fs.readFileSync(tomlPath, "utf-8");
+        const lines = content
+            .split("\n")
+            .filter((line) => !line.includes("agent-comms") && !line.includes("Agent Comms"));
+        fs.writeFileSync(tomlPath, lines.join("\n").trimEnd() + "\n");
+        console.log(`  Removed agent-comms from ${tomlPath}`);
+    }
+    // Remove from hooks.json
+    const hooksPath = path.join(configDir, "hooks.json");
+    const parsed = readJsonFile(hooksPath);
+    if (parsed === undefined)
+        return;
+    const hooks = HooksSchema.safeParse(parsed);
+    if (!hooks.success)
+        return;
+    const stopHooks = hooks.data.hooks?.Stop;
+    if (stopHooks?.[0]?.hooks) {
+        stopHooks[0].hooks = stopHooks[0].hooks.filter((h) => !h.command.includes("agent-comms"));
+        writeJsonFile(hooksPath, hooks.data);
+        console.log(`  Removed agent-comms hook from ${hooksPath}`);
+    }
+}
+function checkCodex() {
+    const details = [];
+    let tomlOk = false;
+    let hookOk = false;
+    const tomlPath = path.join(HOME, ".codex", "config.toml");
+    if (fs.existsSync(tomlPath)) {
+        const content = fs.readFileSync(tomlPath, "utf-8");
+        tomlOk = content.includes("agent-comms");
+        details.push(tomlOk ? `MCP server in ${tomlPath}` : `Not in ${tomlPath}`);
+    }
+    else {
+        details.push(`${tomlPath} not found`);
+    }
+    const hooksPath = path.join(HOME, ".codex", "hooks.json");
+    const parsed = readJsonFile(hooksPath);
+    const hooks = HooksSchema.safeParse(parsed ?? {});
+    if (hooks.success && hooks.data.hooks?.Stop?.[0]?.hooks) {
+        hookOk = hooks.data.hooks.Stop[0].hooks.some((h) => h.command.includes("agent-comms"));
+        details.push(hookOk ? `Stop hook in ${hooksPath}` : `No hook in ${hooksPath}`);
+    }
+    else {
+        details.push(`${hooksPath} not configured`);
+    }
+    return { configured: tomlOk && hookOk, details };
+}
+// ---------------------------------------------------------------------------
+// OpenCode
+// ---------------------------------------------------------------------------
+function configureOpenCode() {
+    const configPath = path.join(process.cwd(), "opencode.json");
+    const parsed = readJsonFile(configPath);
+    const config = OpenCodeConfigSchema.parse(parsed ?? {});
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "opencode", "plugin.ts");
+    const plugins = config.plugin ?? [];
+    if (!plugins.includes(bridgeDir)) {
+        plugins.push(bridgeDir);
+        config.plugin = plugins;
+        writeJsonFile(configPath, config);
+    }
+    else {
+        console.log(`  → Already in ${configPath}`);
+    }
+}
+function removeOpenCode() {
+    const configPath = path.join(process.cwd(), "opencode.json");
+    const parsed = readJsonFile(configPath);
+    if (parsed === undefined)
+        return;
+    const config = OpenCodeConfigSchema.safeParse(parsed);
+    if (!config.success)
+        return;
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "opencode", "plugin.ts");
+    const plugins = config.data.plugin;
+    if (plugins) {
+        config.data.plugin = plugins.filter((p) => p !== bridgeDir);
+        writeJsonFile(configPath, config.data);
+        console.log(`  Removed agent-comms from ${configPath}`);
+    }
+}
+function checkOpenCode() {
+    const configPath = path.join(process.cwd(), "opencode.json");
+    const parsed = readJsonFile(configPath);
+    const config = OpenCodeConfigSchema.safeParse(parsed ?? {});
+    const bridgeDir = path.join(PKG_DIR, "src", "bridges", "opencode", "plugin.ts");
+    const configured = config.success && (config.data.plugin ?? []).includes(bridgeDir);
+    return {
+        configured,
+        details: configured ? [`Plugin: ${bridgeDir}`] : [`Not in ${configPath}`],
+    };
+}
+//# sourceMappingURL=cli.js.map