ccgateway 0.1.0

package/dist/heartbeat.js

@@ -0,0 +1,153 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+// ── Constants ──────────────────────────────────────────────────────────────
+const CRON_MARKER_BEGIN = "# BEGIN ccgateway heartbeats";
+const CRON_MARKER_END = "# END ccgateway heartbeats";
+const HEARTBEAT_PROMPT = "Read HEARTBEAT.md. Follow it strictly. If nothing needs attention, reply HEARTBEAT_OK.";
+// ── HeartbeatManager ──────────────────────────────────────────────────────
+export class HeartbeatManager {
+    agents;
+    spawner;
+    heartbeats;
+    constructor(agents, spawner, heartbeats) {
+        this.agents = agents;
+        this.spawner = spawner;
+        this.heartbeats = heartbeats;
+    }
+    /**
+     * Run a heartbeat for an agent.
+     * - If no HEARTBEAT.md exists in the workspace, returns silent.
+     * - If the agent responds with "HEARTBEAT_OK", returns silent.
+     * - Otherwise returns the response.
+     */
+    async runHeartbeat(agentId) {
+        // 1. Get agent config, validate
+        const agent = this.agents.getAgent(agentId);
+        if (!agent) {
+            throw new Error(`Agent "${agentId}" not found`);
+        }
+        // 2. Check if HEARTBEAT.md exists in workspace
+        const heartbeatPath = join(agent.workspace, "HEARTBEAT.md");
+        if (!existsSync(heartbeatPath)) {
+            return { silent: true };
+        }
+        // 3. Spawn claude --print with heartbeat prompt
+        const result = await this.spawner.spawn({
+            workspace: agent.workspace,
+            message: HEARTBEAT_PROMPT,
+            systemPrompt: "",
+            model: agent.model,
+            allowedTools: agent.allowedTools,
+        });
+        // 4. Check if response is HEARTBEAT_OK
+        const trimmed = result.response.trim();
+        if (trimmed === "HEARTBEAT_OK") {
+            return { silent: true };
+        }
+        // 5. Otherwise return the response
+        return { silent: false, response: result.response };
+    }
+    /**
+     * Generate crontab lines from heartbeats config.
+     * Format: <cron> TZ=<tz> ccg heartbeat run <agent>
+     */
+    generateCronLines() {
+        return this.heartbeats.map((hb) => `${hb.cron} TZ=${hb.tz} ccg heartbeat run ${hb.agent}`);
+    }
+    /**
+     * Install cron jobs to system crontab.
+     * Returns the generated crontab lines (for display).
+     */
+    installCron() {
+        const lines = this.generateCronLines();
+        if (lines.length === 0) {
+            return "(no heartbeats configured)";
+        }
+        // Read existing crontab
+        let existing = "";
+        try {
+            existing = execSync("crontab -l 2>/dev/null", {
+                encoding: "utf-8",
+            });
+        }
+        catch {
+            // No existing crontab — that's fine
+        }
+        // Remove any existing ccgateway section
+        const cleaned = this.removeCcgSection(existing);
+        // Build new crontab
+        const ccgSection = [
+            CRON_MARKER_BEGIN,
+            ...lines,
+            CRON_MARKER_END,
+        ].join("\n");
+        const newCrontab = cleaned.trim()
+            ? `${cleaned.trim()}\n${ccgSection}\n`
+            : `${ccgSection}\n`;
+        // Install
+        execSync(`echo ${JSON.stringify(newCrontab)} | crontab -`, {
+            encoding: "utf-8",
+        });
+        return lines.join("\n");
+    }
+    /**
+     * Remove ccgateway cron jobs from system crontab.
+     */
+    uninstallCron() {
+        let existing = "";
+        try {
+            existing = execSync("crontab -l 2>/dev/null", {
+                encoding: "utf-8",
+            });
+        }
+        catch {
+            return; // No crontab to clean
+        }
+        const cleaned = this.removeCcgSection(existing);
+        if (cleaned.trim() === "") {
+            // Remove crontab entirely if empty
+            try {
+                execSync("crontab -r 2>/dev/null", { encoding: "utf-8" });
+            }
+            catch {
+                // Already empty
+            }
+        }
+        else {
+            execSync(`echo ${JSON.stringify(cleaned.trim() + "\n")} | crontab -`, {
+                encoding: "utf-8",
+            });
+        }
+    }
+    /**
+     * List configured heartbeats.
+     */
+    listHeartbeats() {
+        return this.heartbeats;
+    }
+    // ── Private helpers ────────────────────────────────────────────────────
+    /**
+     * Remove the ccgateway section from crontab content.
+     */
+    removeCcgSection(crontab) {
+        const lines = crontab.split("\n");
+        const result = [];
+        let inSection = false;
+        for (const line of lines) {
+            if (line.trim() === CRON_MARKER_BEGIN) {
+                inSection = true;
+                continue;
+            }
+            if (line.trim() === CRON_MARKER_END) {
+                inSection = false;
+                continue;
+            }
+            if (!inSection) {
+                result.push(line);
+            }
+        }
+        return result.join("\n");
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK9C,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AACzD,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD,MAAM,gBAAgB,GACpB,wFAAwF,CAAC;AAE3F,6EAA6E;AAE7E,MAAM,OAAO,gBAAgB;IAEjB;IACA;IACA;IAHV,YACU,MAAqB,EACrB,OAAkB,EAClB,UAA6B;QAF7B,WAAM,GAAN,MAAM,CAAe;QACrB,YAAO,GAAP,OAAO,CAAW;QAClB,eAAU,GAAV,UAAU,CAAmB;IACpC,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAAe;QAEf,gCAAgC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,aAAa,CAAC,CAAC;QAClD,CAAC;QAED,+CAA+C;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YACtC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,gBAAgB;YACzB,YAAY,EAAE,EAAE;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;QAEH,uCAAuC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,mCAAmC;QACnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CACxB,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,sBAAsB,EAAE,CAAC,KAAK,EAAE,CAC/D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,4BAA4B,CAAC;QACtC,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,wBAAwB,EAAE;gBAC5C,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAEhD,oBAAoB;QACpB,MAAM,UAAU,GAAG;YACjB,iBAAiB;YACjB,GAAG,KAAK;YACR,eAAe;SAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE;YAC/B,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,UAAU,IAAI;YACtC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC;QAEtB,UAAU;QACV,QAAQ,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,EAAE;YACzD,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,wBAAwB,EAAE;gBAC5C,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,sBAAsB;QAChC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1B,mCAAmC;YACnC,IAAI,CAAC;gBACH,QAAQ,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE;gBACpE,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,0EAA0E;IAE1E;;OAEG;IACK,gBAAgB,CAAC,OAAe;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;gBACtC,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,eAAe,EAAE,CAAC;gBACpC,SAAS,GAAG,KAAK,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * Configure the logger.
+ */
+export declare function configureLogger(opts: {
+    level?: LogLevel;
+    file?: boolean;
+}): void;
+export declare const logger: {
+    debug: (msg: string) => Promise<void>;
+    info: (msg: string) => Promise<void>;
+    warn: (msg: string) => Promise<void>;
+    error: (msg: string) => Promise<void>;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA4C3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAGP;AAuBD,eAAO,MAAM,MAAM;iBACJ,MAAM;gBACP,MAAM;gBACN,MAAM;iBACL,MAAM;CACpB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,70 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { getCcgHome } from "./config.js";
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// ── State ───────────────────────────────────────────────────────────────────
+let minLevel = "info";
+let fileLogging = false;
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function timestamp() {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ` +
+        `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`);
+}
+function logFilePath() {
+    return join(getCcgHome(), "logs", "ccgateway.log");
+}
+function format(level, message) {
+    return `[${timestamp()}] [${level.toUpperCase()}] ${message}`;
+}
+async function writeToFile(line) {
+    const path = logFilePath();
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    await appendFile(path, line + "\n", "utf-8");
+}
+// ── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Configure the logger.
+ */
+export function configureLogger(opts) {
+    if (opts.level !== undefined)
+        minLevel = opts.level;
+    if (opts.file !== undefined)
+        fileLogging = opts.file;
+}
+/**
+ * Core log function.
+ */
+async function log(level, message) {
+    if (LEVEL_ORDER[level] < LEVEL_ORDER[minLevel])
+        return;
+    const line = format(level, message);
+    // Always write to stdout
+    if (level === "error") {
+        process.stderr.write(line + "\n");
+    }
+    else {
+        process.stdout.write(line + "\n");
+    }
+    // Optionally write to file
+    if (fileLogging) {
+        await writeToFile(line);
+    }
+}
+export const logger = {
+    debug: (msg) => log("debug", msg),
+    info: (msg) => log("info", msg),
+    warn: (msg) => log("warn", msg),
+    error: (msg) => log("error", msg),
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/messaging.d.ts

@@ -0,0 +1,43 @@
+import type { AgentRegistry } from "./agents.js";
+import type { MessageRouter } from "./router.js";
+import type { PluginLoader } from "./plugin.js";
+import type { BindingConfig } from "./config.js";
+export interface InboxMessage {
+    from: string;
+    content: string;
+    ts: number;
+    read: boolean;
+}
+export declare class CrossAgentMessenger {
+    private agents;
+    private bindings;
+    private plugins;
+    private ccgHome;
+    private router?;
+    constructor(agents: AgentRegistry, bindings: BindingConfig[], plugins: PluginLoader, ccgHome: string);
+    /** Set the router for internal message routing (called after router is created) */
+    setRouter(router: MessageRouter): void;
+    /**
+     * Send a message to an agent. Uses channel-native messaging if the agent
+     * has a gateway binding, otherwise falls back to file-based inbox.
+     */
+    send(toAgentId: string, content: string, fromAgentId?: string): Promise<void>;
+    /**
+     * Direct file-based inbox write.
+     * Appends to $CCG_HOME/agents/{toAgentId}/inbox.jsonl
+     */
+    sendToInbox(toAgentId: string, content: string, fromAgentId?: string): Promise<void>;
+    /**
+     * Read unread inbox messages for an agent.
+     */
+    readInbox(agentId: string): Promise<InboxMessage[]>;
+    /**
+     * Mark all inbox messages as read.
+     */
+    markInboxRead(agentId: string): Promise<void>;
+    /**
+     * Get inbox file path for an agent.
+     */
+    getInboxPath(agentId: string): string;
+}
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../src/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;CACf;AAID,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,MAAM,CAAC,CAAgB;gBAGrB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM;IAGzB,mFAAmF;IACnF,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAItC;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAoEhB;;;OAGG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqBzD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGtC"}

package/dist/messaging.js

@@ -0,0 +1,132 @@
+import { appendFile, readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// ── CrossAgentMessenger ──────────────────────────────────────────────────
+export class CrossAgentMessenger {
+    agents;
+    bindings;
+    plugins;
+    ccgHome;
+    router;
+    constructor(agents, bindings, plugins, ccgHome) {
+        this.agents = agents;
+        this.bindings = bindings;
+        this.plugins = plugins;
+        this.ccgHome = ccgHome;
+    }
+    /** Set the router for internal message routing (called after router is created) */
+    setRouter(router) {
+        this.router = router;
+    }
+    /**
+     * Send a message to an agent. Uses channel-native messaging if the agent
+     * has a gateway binding, otherwise falls back to file-based inbox.
+     */
+    async send(toAgentId, content, fromAgentId) {
+        // Validate target agent exists
+        const targetAgent = this.agents.getAgent(toAgentId);
+        if (!targetAgent) {
+            throw new Error(`Agent "${toAgentId}" not found`);
+        }
+        // 1. Find target agent's primary binding (first binding where agent matches)
+        const binding = this.bindings.find((b) => b.agent === toAgentId);
+        if (binding) {
+            // 2a. Post to Discord/Slack for human visibility (optional)
+            const gatewayPlugins = this.plugins.getPluginsByType("gateway");
+            const plugin = gatewayPlugins.find((p) => p.name === `${binding.gateway}-gateway`);
+            if (plugin && typeof plugin.sendToChannel === "function") {
+                let senderBotId = binding.bot;
+                if (fromAgentId) {
+                    const senderBinding = this.bindings.find((b) => b.agent === fromAgentId && b.gateway === binding.gateway);
+                    if (senderBinding) {
+                        senderBotId = senderBinding.bot;
+                    }
+                }
+                // Post to channel so humans can see the cross-agent message
+                await plugin.sendToChannel(binding.channel, senderBotId, content);
+            }
+            // 2b. Route internally so the target agent actually processes it.
+            //     Bot messages are ignored by the gateway, so we route directly.
+            if (this.router) {
+                const response = await this.router.route({
+                    from: {
+                        gateway: "internal",
+                        channel: binding.channel,
+                        user: fromAgentId || "system",
+                        userId: fromAgentId || "system",
+                        messageId: `xagent-${Date.now()}`,
+                    },
+                    to: { agent: toAgentId },
+                    content,
+                    attachments: [],
+                });
+                // Post the agent's response back to their channel for visibility
+                if (plugin && typeof plugin.sendToChannel === "function") {
+                    await plugin.sendToChannel(binding.channel, binding.bot, response);
+                }
+            }
+            return;
+        }
+        // 3. No binding or no usable gateway plugin — fall back to inbox
+        await this.sendToInbox(toAgentId, content, fromAgentId);
+    }
+    /**
+     * Direct file-based inbox write.
+     * Appends to $CCG_HOME/agents/{toAgentId}/inbox.jsonl
+     */
+    async sendToInbox(toAgentId, content, fromAgentId) {
+        const msg = {
+            from: fromAgentId || "system",
+            content,
+            ts: Date.now(),
+            read: false,
+        };
+        const inboxPath = this.getInboxPath(toAgentId);
+        const dir = join(this.ccgHome, "agents", toAgentId);
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        await appendFile(inboxPath, JSON.stringify(msg) + "\n", "utf-8");
+    }
+    /**
+     * Read unread inbox messages for an agent.
+     */
+    async readInbox(agentId) {
+        const inboxPath = this.getInboxPath(agentId);
+        if (!existsSync(inboxPath)) {
+            return [];
+        }
+        const raw = await readFile(inboxPath, "utf-8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        if (lines.length === 0) {
+            return [];
+        }
+        const messages = lines.map((line) => JSON.parse(line));
+        return messages.filter((m) => !m.read);
+    }
+    /**
+     * Mark all inbox messages as read.
+     */
+    async markInboxRead(agentId) {
+        const inboxPath = this.getInboxPath(agentId);
+        if (!existsSync(inboxPath)) {
+            return;
+        }
+        const raw = await readFile(inboxPath, "utf-8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        if (lines.length === 0) {
+            return;
+        }
+        const messages = lines.map((line) => JSON.parse(line));
+        const updated = messages.map((m) => ({ ...m, read: true }));
+        const content = updated.map((m) => JSON.stringify(m)).join("\n") + "\n";
+        await writeFile(inboxPath, content, "utf-8");
+    }
+    /**
+     * Get inbox file path for an agent.
+     */
+    getInboxPath(agentId) {
+        return join(this.ccgHome, "agents", agentId, "inbox.jsonl");
+    }
+}
+//# sourceMappingURL=messaging.js.map

package/dist/messaging.js.map

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

package/dist/migrate.d.ts

@@ -0,0 +1,24 @@
+export interface MigrateOptions {
+    configPath?: string;
+    dryRun?: boolean;
+}
+/**
+ * Strip provider prefix from a model name.
+ * e.g. "anthropic/claude-opus-4-6" -> "claude-opus-4-6"
+ */
+export declare function stripModelPrefix(model: string): string;
+/**
+ * Generate a Discord bot token env var name.
+ * e.g. "ginger" -> "DISCORD_GINGER_TOKEN"
+ */
+export declare function botTokenEnvVar(accountName: string): string;
+/**
+ * Migrate from OpenClaw configuration to ccgateway config.
+ */
+export declare function migrateFromOpenClaw(options?: MigrateOptions): Promise<void>;
+/**
+ * Interactive setup for new users (no OpenClaw).
+ * Creates the ~/.ccgateway/ structure with a minimal starter config.
+ */
+export declare function initNew(): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAwED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmIrF;AAmMD;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkD7C"}