@calliopelabs/cli 2.2.0 → 2.5.0

package/dist/scuttlebot/config.js

@@ -0,0 +1,91 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parse as parseYaml } from 'yaml';
+function normalizeChannelName(channel) {
+    return channel.trim().replace(/^#/, '');
+}
+function parseChannels(raw) {
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map(normalizeChannelName)
+        .filter(Boolean);
+}
+function allChannels(config) {
+    const combined = [
+        ...(config.channel ? [config.channel] : []),
+        ...(config.channels ?? []),
+    ];
+    return combined.map(normalizeChannelName).filter(Boolean);
+}
+export function mergeChannels(existing, extra) {
+    const seen = new Set();
+    const merged = [];
+    for (const channel of [...existing, ...extra]) {
+        const normalized = normalizeChannelName(channel);
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        merged.push(normalized);
+    }
+    return merged;
+}
+export function loadRepoConfig(dir) {
+    let current = path.resolve(dir);
+    for (;;) {
+        const candidate = path.join(current, '.scuttlebot.yaml');
+        if (fs.existsSync(candidate)) {
+            const raw = fs.readFileSync(candidate, 'utf-8');
+            const parsed = parseYaml(raw);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                return {};
+            }
+            const config = parsed;
+            return {
+                channel: typeof config.channel === 'string' ? config.channel : undefined,
+                channels: Array.isArray(config.channels)
+                    ? config.channels.filter((value) => typeof value === 'string')
+                    : undefined,
+                url: typeof config.url === 'string' ? config.url : undefined,
+                irc_addr: typeof config.irc_addr === 'string' ? config.irc_addr : undefined,
+                tls: typeof config.tls === 'boolean' ? config.tls : undefined,
+                nick: typeof config.nick === 'string' ? config.nick : undefined,
+            };
+        }
+        // Stop once we reach the repo root.
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return null;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function resolveChannelConfig(cwd, channel, channelsEnv) {
+    const explicitChannel = channel ? normalizeChannelName(channel) : '';
+    let channels = parseChannels(channelsEnv);
+    if (channels.length === 0 && explicitChannel) {
+        channels = [explicitChannel];
+    }
+    const repoConfig = loadRepoConfig(cwd);
+    if (repoConfig) {
+        channels = mergeChannels(channels, allChannels(repoConfig));
+    }
+    if (channels.length === 0) {
+        channels = ['general'];
+    }
+    return {
+        channel: channels[0],
+        channels,
+        url: repoConfig?.url,
+        ircAddr: repoConfig?.irc_addr,
+        tls: repoConfig?.tls,
+        nick: repoConfig?.nick,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/scuttlebot/config.js.map

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

package/dist/scuttlebot/http-client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Scuttlebot HTTP API Client
+ *
+ * Provides agent registration and health check via the scuttlebot HTTP API.
+ * All runtime messaging goes through IRC (see irc-client.ts).
+ */
+export interface ScuttlebotConfig {
+    /** HTTP API base URL for registration (e.g. "http://localhost:3000"). */
+    url: string;
+    /** API bearer token. */
+    token: string;
+    /** IRC server address, host:port (e.g. "127.0.0.1:6667"). */
+    ircAddr: string;
+    /** Primary channel (no # prefix). */
+    channel: string;
+    /** All channels (no # prefix). */
+    channels: string[];
+    /** Agent nick. */
+    nick?: string;
+}
+export interface AgentCredentials {
+    nick: string;
+    passphrase: string;
+}
+export declare class ScuttlebotHTTPClient {
+    private config;
+    constructor(config: ScuttlebotConfig);
+    /**
+     * Register an agent (or rotate if already registered) and return IRC credentials.
+     *
+     * Mirrors the relay's registerOrRotate logic:
+     *   POST /v1/agents/register → 201 Created: use passphrase
+     *                            → 409 Conflict: rotate instead
+     *   POST /v1/agents/{nick}/rotate → use new passphrase
+     */
+    register(nick: string, agentType?: string, channels?: string[]): Promise<AgentCredentials>;
+    /**
+     * Rotate credentials for an existing agent nick.
+     *
+     * POST /v1/agents/{nick}/rotate
+     */
+    rotate(nick: string): Promise<AgentCredentials>;
+    /**
+     * Delete agent registration on close (session cleanup).
+     *
+     * DELETE /v1/agents/{nick}
+     */
+    deleteAgent(nick: string): Promise<void>;
+    /**
+     * Touch presence for a nick in a channel — marks the agent as online
+     * in the registry. Required for the admin UI to show the agent as live.
+     *
+     * POST /v1/channels/{channel}/presence
+     */
+    touchPresence(channel: string, nick: string): Promise<void>;
+    /**
+     * Check server health.
+     *
+     * GET /v1/status
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/scuttlebot/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/scuttlebot/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAIpC;;;;;;;OAOG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgChG;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAerD;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjE;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CActC"}

package/dist/scuttlebot/http-client.js

@@ -0,0 +1,124 @@
+/**
+ * Scuttlebot HTTP API Client
+ *
+ * Provides agent registration and health check via the scuttlebot HTTP API.
+ * All runtime messaging goes through IRC (see irc-client.ts).
+ */
+export class ScuttlebotHTTPClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Register an agent (or rotate if already registered) and return IRC credentials.
+     *
+     * Mirrors the relay's registerOrRotate logic:
+     *   POST /v1/agents/register → 201 Created: use passphrase
+     *                            → 409 Conflict: rotate instead
+     *   POST /v1/agents/{nick}/rotate → use new passphrase
+     */
+    async register(nick, agentType, channels) {
+        const raw = channels || this.config.channels;
+        const channelList = raw.map(c => c.startsWith('#') ? c : `#${c}`);
+        const registerResp = await fetch(`${this.config.url}/v1/agents/register`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.config.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                nick,
+                type: agentType || 'worker',
+                channels: channelList,
+            }),
+        });
+        if (registerResp.status === 201) {
+            const data = await registerResp.json();
+            return { nick: data.credentials.nick, passphrase: data.credentials.passphrase };
+        }
+        if (registerResp.status === 409) {
+            // Nick already registered — rotate to get fresh credentials
+            return this.rotate(nick);
+        }
+        const body = await registerResp.text().catch(() => '');
+        throw new Error(`Registration failed: ${registerResp.status} ${registerResp.statusText}${body ? ` — ${body}` : ''}`);
+    }
+    /**
+     * Rotate credentials for an existing agent nick.
+     *
+     * POST /v1/agents/{nick}/rotate
+     */
+    async rotate(nick) {
+        const response = await fetch(`${this.config.url}/v1/agents/${nick}/rotate`, {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${this.config.token}` },
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`Rotate failed: ${response.status} ${response.statusText}${body ? ` — ${body}` : ''}`);
+        }
+        const data = await response.json();
+        return { nick, passphrase: data.passphrase };
+    }
+    /**
+     * Delete agent registration on close (session cleanup).
+     *
+     * DELETE /v1/agents/{nick}
+     */
+    async deleteAgent(nick) {
+        try {
+            await fetch(`${this.config.url}/v1/agents/${nick}`, {
+                method: 'DELETE',
+                headers: { 'Authorization': `Bearer ${this.config.token}` },
+            });
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    /**
+     * Touch presence for a nick in a channel — marks the agent as online
+     * in the registry. Required for the admin UI to show the agent as live.
+     *
+     * POST /v1/channels/{channel}/presence
+     */
+    async touchPresence(channel, nick) {
+        if (!this.config.url || !this.config.token)
+            return;
+        const channelName = channel.startsWith('#') ? channel.slice(1) : channel;
+        try {
+            await fetch(`${this.config.url}/v1/channels/${channelName}/presence`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.config.token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ nick }),
+            });
+        }
+        catch {
+            // Silently fail — presence is best-effort
+        }
+    }
+    /**
+     * Check server health.
+     *
+     * GET /v1/status
+     */
+    async healthCheck() {
+        try {
+            const url = `${this.config.url}/v1/status`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.config.token}`,
+                },
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/scuttlebot/http-client.js.map

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

package/dist/scuttlebot/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scuttlebot Integration
+ *
+ * Native scuttlebot support for Calliope CLI.
+ * Registers via HTTP API, then connects directly to IRC for
+ * real-time mirroring and operator intervention.
+ */
+export { scuttlebotClient } from './client.js';
+export type { ScuttlebotIntegration } from './client.js';
+export type { ScuttlebotConfig, AgentCredentials } from './http-client.js';
+export type { Envelope, IRCClientOptions } from './irc-client.js';
+export { ScuttlebotIRCClient, matchesRecipient, newEnvelope, MessageTypes } from './irc-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scuttlebot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scuttlebot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/scuttlebot/index.js

@@ -0,0 +1,10 @@
+/**
+ * Scuttlebot Integration
+ *
+ * Native scuttlebot support for Calliope CLI.
+ * Registers via HTTP API, then connects directly to IRC for
+ * real-time mirroring and operator intervention.
+ */
+export { scuttlebotClient } from './client.js';
+export { ScuttlebotIRCClient, matchesRecipient, newEnvelope, MessageTypes } from './irc-client.js';
+//# sourceMappingURL=index.js.map

package/dist/scuttlebot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scuttlebot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/scuttlebot/irc-client.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Scuttlebot IRC Client
+ *
+ * Zero-dependency IRC client using Node.js net.Socket.
+ * Connects directly to Ergo IRC server with SASL PLAIN auth.
+ * Handles the scuttlebot envelope protocol (JSON over PRIVMSG).
+ */
+/** Wire envelope — matches the Go protocol.Envelope. */
+export interface Envelope {
+    v: 1;
+    type: string;
+    id: string;
+    from: string;
+    to?: string[];
+    ts: number;
+    payload?: unknown;
+}
+/** Well-known message types. */
+export declare const MessageTypes: {
+    readonly AgentHello: "agent.hello";
+    readonly AgentBye: "agent.bye";
+    readonly TaskCreate: "task.create";
+    readonly TaskUpdate: "task.update";
+    readonly TaskComplete: "task.complete";
+};
+/**
+ * Check whether an envelope is addressed to `nick` with `agentType`.
+ *
+ * Ported from Go's protocol.MatchesRecipient:
+ *   - empty/nil to     -> true (broadcast)
+ *   - @all              -> true
+ *   - @workers etc.     -> agentType match
+ *   - @prefix-*         -> nick starts with prefix-
+ *   - bare string       -> exact nick match
+ */
+export declare function matchesRecipient(env: Envelope, nick: string, agentType: string): boolean;
+/** Create a new envelope with a generated ID and current timestamp. */
+export declare function newEnvelope(type: string, from: string, opts?: {
+    to?: string[];
+    payload?: unknown;
+}): Envelope;
+export interface IRCClientOptions {
+    /** IRC server address, "host:port". */
+    serverAddr: string;
+    /** Nick (also used as SASL username). */
+    nick: string;
+    /** SASL PLAIN passphrase from registration. */
+    passphrase: string;
+    /** Channels to join (with or without # prefix). */
+    channels: string[];
+    /** Agent type for recipient matching. Defaults to 'worker'. */
+    agentType?: string;
+    /** Use TLS. Inferred from port 6697 if not specified. */
+    tls?: boolean;
+}
+type EnvelopeHandler = (env: Envelope, channel: string) => void;
+type InstructionHandler = (text: string, from: string, channel: string) => void;
+export declare class ScuttlebotIRCClient {
+    private readonly opts;
+    private readonly agentType;
+    private socket;
+    private connected;
+    private destroyed;
+    private envelopeHandlers;
+    private instructionHandlers;
+    private reconnectTimer;
+    private reconnectDelay;
+    private shouldReconnect;
+    private buffer;
+    private saslState;
+    private connectResolve;
+    private connectReject;
+    private connectTimeout;
+    private static readonly PING_INTERVAL_MS;
+    private static readonly PING_TIMEOUT_MS;
+    private pingTimer;
+    private pongTimer;
+    private pendingPing;
+    private exitHandler;
+    constructor(opts: IRCClientOptions);
+    /** Register a handler for incoming JSON envelopes. */
+    onEnvelope(handler: EnvelopeHandler): void;
+    /** Register a handler for human instructions (non-JSON PRIVMSG that mention our nick). */
+    onInstruction(handler: InstructionHandler): void;
+    /**
+     * Connect to the IRC server. Resolves once fully registered (numeric 001 received).
+     * Rejects on timeout (30s) or fatal connection error during initial connect.
+     */
+    connect(): Promise<void>;
+    /** Disconnect gracefully. Sends QUIT and closes the socket. */
+    disconnect(): Promise<void>;
+    /** Send a JSON envelope as PRIVMSG to a channel. */
+    sendEnvelope(channel: string, env: Omit<Envelope, 'id' | 'ts'>): void;
+    /** Send a plain text PRIVMSG to a channel. */
+    sendRaw(channel: string, text: string): void;
+    /** Whether we are currently connected and registered on IRC. */
+    isConnected(): boolean;
+    private createConnection;
+    private processBuffer;
+    private handleLine;
+    /**
+     * Handle non-JSON PRIVMSG as potential human instructions.
+     * Delivers to instruction handlers if:
+     * - Message mentions our nick
+     * - Sender is not a service bot
+     * - Sender is not an agent (claude-/codex-/gemini-/calliope- prefix)
+     */
+    private handleHumanChat;
+    private sendRawLine;
+    private sendPrivmsg;
+    private startPingKeepalive;
+    private stopPingKeepalive;
+    /**
+     * Register SIGINT/SIGTERM handlers so we send QUIT before the process exits.
+     * Uses a synchronous write — the OS TCP stack will flush it even if the
+     * event loop drains immediately afterward.
+     */
+    private registerExitHandler;
+    private unregisterExitHandler;
+    private scheduleReconnect;
+    private cleanupSocket;
+}
+export {};
+//# sourceMappingURL=irc-client.d.ts.map

package/dist/scuttlebot/irc-client.d.ts.map

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