ccgateway 0.1.0

package/dist/context.d.ts

@@ -0,0 +1,45 @@
+import type { SessionManager } from "./sessions.js";
+import type { SkillManager } from "./skills.js";
+import type { AgentRegistry } from "./agents.js";
+export interface InboxMessage {
+    from: string;
+    content: string;
+    ts: number;
+    read: boolean;
+}
+export declare class ContextBuilder {
+    private sessions;
+    private skills;
+    private ccgHome;
+    private agents?;
+    constructor(sessions: SessionManager, skills: SkillManager, ccgHome: string, agents?: AgentRegistry | undefined);
+    /**
+     * Build the complete context string for an agent turn.
+     * Assembles in this order:
+     * 1. Conversation history (windowed from session JSONL)
+     * 2. Skill index
+     * 3. Inbox messages (unread, for non-gateway agents)
+     * 4. Memory hints (today's date, daily log path, recent daily log contents)
+     */
+    build(agentId: string, sessionKey: string): Promise<string>;
+    private buildSessionInfo;
+    /**
+     * Resolve the workspace path for an agent.
+     * Returns undefined if no AgentRegistry is available or agent not found.
+     */
+    private getWorkspace;
+    /**
+     * Read identity files from the agent's workspace.
+     * Loads CLAUDE.md, SOUL.md, IDENTITY.md, AGENTS.md (whichever exist).
+     */
+    private buildIdentitySection;
+    private buildHistorySection;
+    private buildInboxSection;
+    private buildMemorySection;
+    /**
+     * Read a daily log file. Checks the agent's workspace memory/ dir first,
+     * then falls back to $CCG_HOME/agents/{agentId}/memory/.
+     */
+    private readDailyLog;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;CACf;AAaD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM,CAAC;gBAHP,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,aAAa,YAAA;IAGhC;;;;;;;OAOG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BjE,OAAO,CAAC,gBAAgB;IAoBxB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;YACW,oBAAoB;YAuBpB,mBAAmB;YAwBnB,iBAAiB;YA2CjB,kBAAkB;IAkChC;;;OAGG;YACW,YAAY;CAuB3B"}

package/dist/context.js

@@ -0,0 +1,201 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// ── Identity files loaded from workspace ──────────────────────────────────
+const IDENTITY_FILES = [
+    "CLAUDE.md",
+    "SOUL.md",
+    "IDENTITY.md",
+    "AGENTS.md",
+];
+// ── ContextBuilder ─────────────────────────────────────────────────────────
+export class ContextBuilder {
+    sessions;
+    skills;
+    ccgHome;
+    agents;
+    constructor(sessions, skills, ccgHome, agents) {
+        this.sessions = sessions;
+        this.skills = skills;
+        this.ccgHome = ccgHome;
+        this.agents = agents;
+    }
+    /**
+     * Build the complete context string for an agent turn.
+     * Assembles in this order:
+     * 1. Conversation history (windowed from session JSONL)
+     * 2. Skill index
+     * 3. Inbox messages (unread, for non-gateway agents)
+     * 4. Memory hints (today's date, daily log path, recent daily log contents)
+     */
+    async build(agentId, sessionKey) {
+        const parts = [];
+        // 0. Session context — tell the agent where this conversation is happening
+        parts.push(this.buildSessionInfo(sessionKey));
+        // 1. Agent identity (CLAUDE.md, SOUL.md, IDENTITY.md, AGENTS.md from workspace)
+        const identitySection = await this.buildIdentitySection(agentId);
+        if (identitySection) {
+            parts.push(identitySection);
+        }
+        // 2. Conversation history
+        parts.push(await this.buildHistorySection(agentId, sessionKey));
+        // 3. Skill index
+        parts.push(await this.skills.buildSkillIndex(agentId));
+        // 4. Inbox messages
+        const inboxSection = await this.buildInboxSection(agentId);
+        if (inboxSection) {
+            parts.push(inboxSection);
+        }
+        // 5. Memory section
+        parts.push(await this.buildMemorySection(agentId));
+        return parts.join("\n\n");
+    }
+    buildSessionInfo(sessionKey) {
+        // sessionKey format: agentId:source:sourceId
+        const [agentId, source, ...rest] = sessionKey.split(":");
+        const sourceId = rest.join(":");
+        const lines = ["--- Session ---"];
+        lines.push(`Agent: ${agentId}`);
+        lines.push(`Source: ${source}`);
+        if (source === "discord") {
+            lines.push(`Discord channel ID: ${sourceId}`);
+        }
+        else if (source === "slack") {
+            lines.push(`Slack channel ID: ${sourceId}`);
+        }
+        else if (source === "cli") {
+            lines.push("Direct CLI chat session");
+        }
+        lines.push(`Session key: ${sessionKey}`);
+        return lines.join("\n");
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────
+    /**
+     * Resolve the workspace path for an agent.
+     * Returns undefined if no AgentRegistry is available or agent not found.
+     */
+    getWorkspace(agentId) {
+        if (!this.agents)
+            return undefined;
+        const agent = this.agents.getAgent(agentId);
+        return agent?.workspace;
+    }
+    /**
+     * Read identity files from the agent's workspace.
+     * Loads CLAUDE.md, SOUL.md, IDENTITY.md, AGENTS.md (whichever exist).
+     */
+    async buildIdentitySection(agentId) {
+        const workspace = this.getWorkspace(agentId);
+        if (!workspace)
+            return null;
+        const parts = [];
+        for (const filename of IDENTITY_FILES) {
+            const filePath = join(workspace, filename);
+            if (existsSync(filePath)) {
+                try {
+                    const content = await readFile(filePath, "utf-8");
+                    parts.push(`=== ${filename} ===\n${content.trim()}`);
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+        if (parts.length === 0)
+            return null;
+        return `--- Agent Identity ---\n${parts.join("\n\n")}`;
+    }
+    async buildHistorySection(agentId, sessionKey) {
+        const messages = await this.sessions.getWindowedHistory(agentId, sessionKey);
+        if (messages.length === 0) {
+            return "--- Conversation History ---\n(empty)";
+        }
+        const lines = messages.map((msg) => {
+            if (msg.role === "user") {
+                const name = msg.sourceUser || "User";
+                return `[user] ${name}: ${msg.content}`;
+            }
+            return `[assistant]: ${msg.content}`;
+        });
+        return `--- Conversation History ---\n${lines.join("\n")}`;
+    }
+    async buildInboxSection(agentId) {
+        const inboxPath = join(this.ccgHome, "agents", agentId, "inbox.jsonl");
+        if (!existsSync(inboxPath)) {
+            return null;
+        }
+        const raw = await readFile(inboxPath, "utf-8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        if (lines.length === 0) {
+            return null;
+        }
+        const allMessages = lines.map((line) => JSON.parse(line));
+        const unread = allMessages.filter((m) => !m.read);
+        if (unread.length === 0) {
+            return null;
+        }
+        // Build the section
+        const header = `--- Inbox (${unread.length} unread) ---`;
+        const msgLines = unread.map((m) => `[${m.from} → you] ${m.content}`);
+        // Mark messages as read: rewrite the file with all messages marked read
+        const updated = allMessages.map((m) => ({ ...m, read: true }));
+        const updatedContent = updated.map((m) => JSON.stringify(m)).join("\n") + "\n";
+        await writeFile(inboxPath, updatedContent, "utf-8");
+        return `${header}\n${msgLines.join("\n")}`;
+    }
+    async buildMemorySection(agentId) {
+        const today = new Date();
+        const todayStr = formatDate(today);
+        const yesterday = new Date(today);
+        yesterday.setDate(yesterday.getDate() - 1);
+        const yesterdayStr = formatDate(yesterday);
+        const parts = [];
+        parts.push("--- Memory ---");
+        parts.push(`Today's date: ${todayStr}`);
+        parts.push(`Daily log: memory/${todayStr}.md (create if missing, append observations)`);
+        // Read today's daily log
+        const todayLog = await this.readDailyLog(agentId, todayStr);
+        if (todayLog !== null) {
+            parts.push("");
+            parts.push(`=== memory/${todayStr}.md ===`);
+            parts.push(todayLog);
+        }
+        // Read yesterday's daily log
+        const yesterdayLog = await this.readDailyLog(agentId, yesterdayStr);
+        if (yesterdayLog !== null) {
+            parts.push("");
+            parts.push(`=== memory/${yesterdayStr}.md ===`);
+            parts.push(yesterdayLog);
+        }
+        return parts.join("\n");
+    }
+    /**
+     * Read a daily log file. Checks the agent's workspace memory/ dir first,
+     * then falls back to $CCG_HOME/agents/{agentId}/memory/.
+     */
+    async readDailyLog(agentId, dateStr) {
+        const filename = `${dateStr}.md`;
+        // 1. Try workspace memory/ dir
+        const workspace = this.getWorkspace(agentId);
+        if (workspace) {
+            const wsPath = join(workspace, "memory", filename);
+            if (existsSync(wsPath)) {
+                return readFile(wsPath, "utf-8");
+            }
+        }
+        // 2. Fallback to $CCG_HOME/agents/{agentId}/memory/
+        const ccgPath = join(this.ccgHome, "agents", agentId, "memory", filename);
+        if (existsSync(ccgPath)) {
+            return readFile(ccgPath, "utf-8");
+        }
+        return null;
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function formatDate(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Start the ccgateway daemon (foreground).
+ *
+ * 1. Loads config and ensures directory structure
+ * 2. Builds core components (AgentRegistry, SessionManager, etc.)
+ * 3. Loads and starts all enabled plugins
+ * 4. Writes PID file for lifecycle management
+ * 5. Sets up signal handlers for graceful shutdown
+ */
+export declare function startDaemon(): Promise<void>;
+/**
+ * Stop the running ccgateway daemon.
+ *
+ * Reads the PID file, sends SIGTERM, waits briefly, then SIGKILL if needed.
+ */
+export declare function stopDaemon(): void;
+/**
+ * Get the status of the ccgateway daemon.
+ */
+export declare function getDaemonStatus(): {
+    running: boolean;
+    pid?: number;
+    uptime?: number;
+};
+/** Get the PID file path. */
+export declare function pidPath(): string;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwGjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAgDjC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAuBrF;AAID,6BAA6B;AAC7B,wBAAgB,OAAO,IAAI,MAAM,CAEhC"}

package/dist/daemon.js

@@ -0,0 +1,207 @@
+import { loadConfig, getCcgHome, ensureDirectories } from './config.js';
+import { AgentRegistry } from './agents.js';
+import { SessionManager } from './sessions.js';
+import { SkillManager } from './skills.js';
+import { ContextBuilder } from './context.js';
+import { CCSpawner } from './spawner.js';
+import { MessageRouter } from './router.js';
+import { PluginLoader } from './plugin.js';
+import { CrossAgentMessenger } from './messaging.js';
+import { configureLogger, logger } from './logger.js';
+import { writeFileSync, readFileSync, existsSync, unlinkSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+// Built-in plugin factories
+import createDiscordGateway from './plugins/discord-gateway.js';
+import createSlackGateway from './plugins/slack-gateway.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const BUILTIN_PLUGINS = {
+    'discord-gateway': createDiscordGateway,
+    'slack-gateway': createSlackGateway,
+};
+/**
+ * Start the ccgateway daemon (foreground).
+ *
+ * 1. Loads config and ensures directory structure
+ * 2. Builds core components (AgentRegistry, SessionManager, etc.)
+ * 3. Loads and starts all enabled plugins
+ * 4. Writes PID file for lifecycle management
+ * 5. Sets up signal handlers for graceful shutdown
+ */
+export async function startDaemon() {
+    // 1. Load config
+    const config = await loadConfig();
+    // 2. Ensure directories
+    await ensureDirectories();
+    // 3. Enable file logging for daemon mode
+    configureLogger({ file: true });
+    // 4. Create core components
+    const ccgHome = getCcgHome();
+    const registry = new AgentRegistry(config);
+    const sessions = new SessionManager(ccgHome);
+    const skills = new SkillManager(ccgHome);
+    const context = new ContextBuilder(sessions, skills, ccgHome, registry);
+    const spawner = new CCSpawner();
+    const router = new MessageRouter(registry, sessions, context, spawner, config.bindings);
+    // 5. Create PluginLoader and messenger (messenger needs loader reference)
+    const loader = new PluginLoader();
+    const messenger = new CrossAgentMessenger(registry, config.bindings, loader, ccgHome);
+    messenger.setRouter(router);
+    // 6. Build CcgCore object for plugins
+    const core = {
+        config,
+        agents: registry,
+        sessions,
+        router,
+        async send(agentId, message, fromAgent) {
+            await messenger.send(agentId, message, fromAgent);
+        },
+    };
+    // 7. Load built-in plugins + any external plugins
+    for (const entry of config.plugins) {
+        if (!entry.enabled)
+            continue;
+        let plugin;
+        const builtinFactory = BUILTIN_PLUGINS[entry.name];
+        if (builtinFactory) {
+            plugin = builtinFactory(entry.config);
+        }
+        else {
+            // Fall back to generic import for external plugins
+            await loader.loadPlugins({ ...config, plugins: [entry] }, core);
+            continue;
+        }
+        await plugin.init(core);
+        loader.registerPlugin(plugin);
+        logger.info(`plugin: loaded built-in "${plugin.name}" (type=${plugin.type})`);
+    }
+    // 8. Start all plugins
+    await loader.startAll();
+    // 9. Write PID file
+    const pid = process.pid;
+    writeFileSync(pidPath(), String(pid), 'utf-8');
+    // 10. Set up signal handlers for graceful shutdown
+    const shutdown = async (signal) => {
+        logger.info(`ccgateway received ${signal}, shutting down...`);
+        try {
+            await loader.stopAll();
+        }
+        catch (err) {
+            logger.error(`Error stopping plugins: ${err.message}`);
+        }
+        removePidFile();
+        logger.info('ccgateway stopped.');
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => { void shutdown('SIGTERM'); });
+    process.on('SIGINT', () => { void shutdown('SIGINT'); });
+    // 11. Log startup
+    const agentCount = registry.listAgents().length;
+    const pluginCount = loader.getPlugins().length;
+    logger.info(`ccgateway started (pid=${pid}, agents=${agentCount}, plugins=${pluginCount})`);
+    console.log(`ccgateway started (pid=${pid}, agents=${agentCount}, plugins=${pluginCount})`);
+    // 12. Keep process alive — plugins maintain connections via event loops.
+    // If no plugins are keeping the event loop alive, use a heartbeat interval.
+    const keepAlive = setInterval(() => {
+        // no-op: keeps the event loop alive
+    }, 60_000);
+    keepAlive.unref(); // allow process to exit if all plugins stop
+}
+/**
+ * Stop the running ccgateway daemon.
+ *
+ * Reads the PID file, sends SIGTERM, waits briefly, then SIGKILL if needed.
+ */
+export function stopDaemon() {
+    const path = pidPath();
+    if (!existsSync(path)) {
+        console.error('ccgateway is not running (no PID file found).');
+        process.exitCode = 1;
+        return;
+    }
+    const pid = parseInt(readFileSync(path, 'utf-8').trim(), 10);
+    if (isNaN(pid)) {
+        console.error('Invalid PID file. Removing it.');
+        removePidFile();
+        process.exitCode = 1;
+        return;
+    }
+    // Check if process is actually running
+    if (!isProcessRunning(pid)) {
+        console.log('ccgateway process is not running. Cleaning up stale PID file.');
+        removePidFile();
+        return;
+    }
+    // Send SIGTERM for graceful shutdown
+    try {
+        process.kill(pid, 'SIGTERM');
+        console.log(`Sent SIGTERM to ccgateway (pid=${pid}).`);
+    }
+    catch {
+        console.error(`Failed to send SIGTERM to pid ${pid}. Removing stale PID file.`);
+        removePidFile();
+        process.exitCode = 1;
+        return;
+    }
+    // Wait briefly and check if still running, then SIGKILL
+    setTimeout(() => {
+        if (isProcessRunning(pid)) {
+            try {
+                process.kill(pid, 'SIGKILL');
+                console.log(`Process did not exit gracefully. Sent SIGKILL to pid=${pid}.`);
+            }
+            catch {
+                // Process may have exited between check and kill
+            }
+        }
+        removePidFile();
+    }, 3000);
+}
+/**
+ * Get the status of the ccgateway daemon.
+ */
+export function getDaemonStatus() {
+    const path = pidPath();
+    if (!existsSync(path)) {
+        return { running: false };
+    }
+    const raw = readFileSync(path, 'utf-8').trim();
+    const pid = parseInt(raw, 10);
+    if (isNaN(pid)) {
+        return { running: false };
+    }
+    if (!isProcessRunning(pid)) {
+        return { running: false, pid };
+    }
+    // Estimate uptime from PID file modification time
+    const { mtimeMs } = statSync(path);
+    const uptime = Math.floor((Date.now() - mtimeMs) / 1000);
+    return { running: true, pid, uptime };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/** Get the PID file path. */
+export function pidPath() {
+    return join(getCcgHome(), 'ccgateway.pid');
+}
+/** Check if a process is running. */
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Remove the PID file if it exists. */
+function removePidFile() {
+    const path = pidPath();
+    if (existsSync(path)) {
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            // ignore removal errors
+        }
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,42 @@
+import type { AgentRegistry } from "./agents.js";
+import type { CCSpawner } from "./spawner.js";
+import type { HeartbeatConfig } from "./config.js";
+export declare class HeartbeatManager {
+    private agents;
+    private spawner;
+    private heartbeats;
+    constructor(agents: AgentRegistry, spawner: CCSpawner, heartbeats: HeartbeatConfig[]);
+    /**
+     * 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.
+     */
+    runHeartbeat(agentId: string): Promise<{
+        silent: boolean;
+        response?: string;
+    }>;
+    /**
+     * Generate crontab lines from heartbeats config.
+     * Format: <cron> TZ=<tz> ccg heartbeat run <agent>
+     */
+    generateCronLines(): string[];
+    /**
+     * Install cron jobs to system crontab.
+     * Returns the generated crontab lines (for display).
+     */
+    installCron(): string;
+    /**
+     * Remove ccgateway cron jobs from system crontab.
+     */
+    uninstallCron(): void;
+    /**
+     * List configured heartbeats.
+     */
+    listHeartbeats(): HeartbeatConfig[];
+    /**
+     * Remove the ccgateway section from crontab content.
+     */
+    private removeCcgSection;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAYnD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,UAAU;gBAFV,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,SAAS,EAClB,UAAU,EAAE,eAAe,EAAE;IAGvC;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgClD;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAM7B;;;OAGG;IACH,WAAW,IAAI,MAAM;IAuCrB;;OAEG;IACH,aAAa,IAAI,IAAI;IA0BrB;;OAEG;IACH,cAAc,IAAI,eAAe,EAAE;IAMnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}