cccc-sdk 0.1.0 → 0.1.2

package/dist/transport.js

@@ -1,142 +1,298 @@
 /**
- * Unix Socket Transport Layer for CCCC daemon IPC
- *
- * Protocol:
- * - Uses Unix Domain Socket at $CCCC_HOME/daemon/ccccd.sock
- * - Messages are newline-delimited JSON
- * - Request: {"v": 1, "op": "xxx", "args": {...}}
- * - Response: {"v": 1, "ok": true/false, "result": {...}, "error": {...}}
+ * CCCC SDK transport layer - Unix socket / TCP
  */
 import * as net from 'node:net';
+import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import * as os from 'node:os';
-import * as fs from 'node:fs';
-import { CCCCError } from './errors.js';
-const DEFAULT_TIMEOUT_MS = 60_000;
-const MAX_RESPONSE_SIZE = 4_000_000; // 4MB
-/**
- * Get default CCCC home directory
- */
-export function getDefaultCcccHome() {
-    return process.env['CCCC_HOME'] || path.join(os.homedir(), '.cccc');
+import { DaemonUnavailableError } from './errors.js';
+// ============================================================
+// Constants
+// ============================================================
+export const MAX_LINE_SIZE = 4000000; // 4MB
+export const DEFAULT_TIMEOUT_MS = 30000;
+const MAX_PORT = 65535;
+function normalizeTcpConnectHost(rawHost) {
+    const host = String(rawHost ?? '').trim();
+    if (!host || host === 'localhost' || host === '0.0.0.0') {
+        return '127.0.0.1';
+    }
+    // Daemon IPC currently uses AF_INET only; fall back to loopback for
+    // IPv6-style addresses (contains ':') or the IPv6 loopback literal.
+    if (host.includes(':') || host === '::1') {
+        return '127.0.0.1';
+    }
+    return host;
 }
+// ============================================================
+// Endpoint discovery
+// ============================================================
 /**
- * Get socket path for CCCC daemon
+ * Get the default CCCC home directory path.
+ * Uses `$CCCC_HOME` if set, otherwise `~/.cccc`.
+ * @returns Absolute path to the CCCC home directory.
  */
-export function getSocketPath(ccccHome) {
-    const home = ccccHome || getDefaultCcccHome();
-    return path.join(home, 'daemon', 'ccccd.sock');
+export function defaultHome() {
+    return process.env['CCCC_HOME'] || path.join(os.homedir(), '.cccc');
 }
 /**
- * Check if daemon socket exists
+ * Discover the daemon IPC endpoint by reading `ccccd.addr.json`.
+ * Falls back to the default Unix socket path if the address file is missing or unreadable.
+ * @param home - Optional CCCC home directory override.
+ * @returns The resolved {@link DaemonEndpoint} (TCP or Unix).
  */
-export function socketExists(ccccHome) {
-    const sockPath = getSocketPath(ccccHome);
+export async function discoverEndpoint(home) {
+    const ccccHome = home || defaultHome();
+    const addrPath = path.join(ccccHome, 'daemon', 'ccccd.addr.json');
     try {
-        fs.accessSync(sockPath, fs.constants.F_OK);
-        return true;
+        const content = await fs.readFile(addrPath, 'utf-8');
+        const descriptor = JSON.parse(content);
+        if (descriptor.v === 1) {
+            if (descriptor.transport === 'tcp' && descriptor.port) {
+                const port = Number(descriptor.port);
+                if (!Number.isInteger(port) || port <= 0 || port > MAX_PORT) {
+                    throw new Error(`invalid daemon tcp port: ${descriptor.port}`);
+                }
+                return {
+                    transport: 'tcp',
+                    host: normalizeTcpConnectHost(descriptor.host),
+                    port,
+                    path: '',
+                };
+            }
+            if (descriptor.transport === 'unix' && descriptor.path) {
+                return {
+                    transport: 'unix',
+                    path: descriptor.path,
+                    host: '',
+                    port: 0,
+                };
+            }
+        }
     }
     catch {
-        return false;
+        // Ignore read errors and try fallback.
     }
+    // Fallback to Unix socket.
+    const sockPath = path.join(ccccHome, 'daemon', 'ccccd.sock');
+    return {
+        transport: 'unix',
+        path: sockPath,
+        host: '',
+        port: 0,
+    };
 }
+// ============================================================
+// Socket connection
+// ============================================================
 /**
- * Send a request to the CCCC daemon and receive a response
+ * Create socket connection
  */
-export async function callDaemon(request, options = {}) {
-    const { ccccHome, timeoutMs = DEFAULT_TIMEOUT_MS } = options;
-    const sockPath = getSocketPath(ccccHome);
-    // Check socket exists
-    if (!socketExists(ccccHome)) {
-        throw new CCCCError('SOCKET_NOT_FOUND', `Socket not found at ${sockPath}`);
-    }
+function connect(endpoint, timeoutMs) {
     return new Promise((resolve, reject) => {
-        const socket = net.createConnection(sockPath);
-        let buffer = '';
-        let resolved = false;
+        const socket = new net.Socket();
+        socket.setTimeout(timeoutMs);
         const cleanup = () => {
             socket.removeAllListeners();
+        };
+        const onError = (err) => {
+            cleanup();
             socket.destroy();
+            reject(new DaemonUnavailableError(err.message));
         };
-        const handleError = (error) => {
-            if (resolved)
-                return;
-            resolved = true;
+        const onTimeout = () => {
             cleanup();
-            if (error.code === 'ECONNREFUSED') {
-                reject(new CCCCError('DAEMON_NOT_RUNNING', 'Daemon is not running'));
-            }
-            else if (error.code === 'ENOENT') {
-                reject(new CCCCError('SOCKET_NOT_FOUND', `Socket not found at ${sockPath}`));
-            }
-            else {
-                reject(new CCCCError('INTERNAL', error.message));
-            }
+            socket.destroy();
+            reject(new DaemonUnavailableError('Connection timeout'));
         };
-        // Set timeout
-        const timeoutId = setTimeout(() => {
-            if (resolved)
-                return;
-            resolved = true;
+        socket.once('error', onError);
+        socket.once('timeout', onTimeout);
+        const onConnect = () => {
             cleanup();
-            reject(new CCCCError('TIMEOUT', `Request timed out after ${timeoutMs}ms`));
-        }, timeoutMs);
-        socket.on('connect', () => {
-            // Send request as newline-delimited JSON
-            const payload = JSON.stringify(request) + '\n';
-            socket.write(payload, 'utf-8');
-        });
+            resolve(socket);
+        };
+        if (endpoint.transport === 'tcp') {
+            socket.connect(endpoint.port, endpoint.host, onConnect);
+        }
+        else if (endpoint.transport === 'unix') {
+            socket.connect(endpoint.path, onConnect);
+        }
+        else {
+            reject(new DaemonUnavailableError(`Invalid endpoint transport: ${endpoint.transport}`));
+        }
+    });
+}
+// ============================================================
+// IPC calls
+// ============================================================
+/**
+ * Send a single IPC request to the daemon and return the response.
+ * Opens a new socket, sends the JSON-line request, reads exactly one JSON-line response,
+ * then destroys the socket.
+ * @param endpoint - The daemon endpoint to connect to.
+ * @param request - The IPC request envelope.
+ * @param timeoutMs - Connection and response timeout in milliseconds.
+ * @returns The parsed {@link DaemonResponse}.
+ * @throws {DaemonUnavailableError} On connection, write, or parse failure.
+ */
+export async function callDaemon(endpoint, request, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const socket = await connect(endpoint, timeoutMs);
+    return new Promise((resolve, reject) => {
+        let buffer = '';
+        let resolved = false;
+        const cleanup = () => {
+            socket.removeAllListeners();
+        };
         socket.on('data', (chunk) => {
             buffer += chunk.toString('utf-8');
-            // Check size limit
-            if (buffer.length > MAX_RESPONSE_SIZE) {
-                if (resolved)
+            const newlineIndex = buffer.indexOf('\n');
+            if (newlineIndex !== -1 && !resolved) {
+                resolved = true;
+                const line = buffer.slice(0, newlineIndex);
+                cleanup();
+                socket.destroy();
+                if (line.length > MAX_LINE_SIZE) {
+                    reject(new DaemonUnavailableError('Response too large'));
                     return;
+                }
+                try {
+                    resolve(JSON.parse(line));
+                }
+                catch {
+                    reject(new DaemonUnavailableError('Invalid JSON response'));
+                }
+            }
+        });
+        socket.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                socket.destroy();
+                reject(new DaemonUnavailableError(err.message));
+            }
+        });
+        socket.on('close', () => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                socket.destroy();
+                reject(new DaemonUnavailableError('Connection closed unexpectedly'));
+            }
+        });
+        // Send request.
+        const line = JSON.stringify(request) + '\n';
+        socket.write(line, (err) => {
+            if (err && !resolved) {
                 resolved = true;
-                clearTimeout(timeoutId);
                 cleanup();
-                reject(new CCCCError('INTERNAL', 'Response too large'));
-                return;
+                socket.destroy();
+                reject(new DaemonUnavailableError(`Write failed: ${err.message}`));
             }
-            // Check for complete response (newline terminated)
+        });
+    });
+}
+/**
+ * Open a long-lived event stream connection to the daemon.
+ * Sends the request, reads the handshake response, and returns the socket
+ * for continued streaming via {@link readLines}.
+ * @param endpoint - The daemon endpoint to connect to.
+ * @param request - The IPC request envelope (op should be `events_stream`).
+ * @param timeoutMs - Connection and handshake timeout in milliseconds.
+ * @returns The socket, handshake response, and any buffered data after the handshake.
+ * @throws {DaemonUnavailableError} On connection or handshake failure.
+ */
+export async function openEventsStream(endpoint, request, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const socket = await connect(endpoint, timeoutMs);
+    // Send request.
+    const line = JSON.stringify(request) + '\n';
+    await new Promise((resolve, reject) => {
+        socket.write(line, (err) => {
+            if (err) {
+                socket.destroy();
+                reject(new DaemonUnavailableError(`Write failed: ${err.message}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    // Read handshake response.
+    const { handshake, remainingBuffer } = await new Promise((resolve, reject) => {
+        let buffer = '';
+        let resolved = false;
+        const cleanup = () => {
+            socket.removeAllListeners();
+        };
+        const onData = (chunk) => {
+            buffer += chunk.toString('utf-8');
             const newlineIndex = buffer.indexOf('\n');
-            if (newlineIndex !== -1) {
-                if (resolved)
-                    return;
+            if (newlineIndex !== -1 && !resolved) {
                 resolved = true;
-                clearTimeout(timeoutId);
                 cleanup();
-                const line = buffer.slice(0, newlineIndex);
+                const responseLine = buffer.slice(0, newlineIndex);
+                const remaining = buffer.slice(newlineIndex + 1);
                 try {
-                    const response = JSON.parse(line);
-                    resolve(response);
+                    resolve({
+                        handshake: JSON.parse(responseLine),
+                        remainingBuffer: remaining,
+                    });
                 }
                 catch {
-                    reject(new CCCCError('INTERNAL', 'Invalid JSON response from daemon'));
+                    socket.destroy();
+                    reject(new DaemonUnavailableError('Invalid handshake JSON'));
                 }
             }
+        };
+        socket.on('data', onData);
+        socket.once('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                socket.destroy();
+                reject(new DaemonUnavailableError(err.message));
+            }
         });
-        socket.on('error', handleError);
-        socket.on('close', () => {
-            if (resolved)
-                return;
-            resolved = true;
-            clearTimeout(timeoutId);
-            cleanup();
-            reject(new CCCCError('DAEMON_NOT_RUNNING', 'Connection closed unexpectedly'));
+        socket.once('close', () => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                socket.destroy();
+                reject(new DaemonUnavailableError('Connection closed during handshake'));
+            }
         });
     });
+    // Remove timeout after handshake.
+    socket.setTimeout(0);
+    return { socket, handshake, initialBuffer: remainingBuffer };
 }
 /**
- * Ping the daemon to check if it's running
+ * Async generator that yields newline-delimited lines from a socket.
+ * Handles buffering and splits on `\n`. Empty/whitespace-only lines are skipped.
+ * @param socket - The connected socket to read from.
+ * @param initialBuffer - Any data already buffered before this generator starts.
+ * @yields Each non-empty line as a string (without the trailing newline).
  */
-export async function pingDaemon(options = {}) {
-    try {
-        const response = await callDaemon({ v: 1, op: 'ping', args: {} }, options);
-        return response.ok;
+export async function* readLines(socket, initialBuffer = '') {
+    let buffer = initialBuffer;
+    // Handle lines from initial buffer.
+    let newlineIndex;
+    while ((newlineIndex = buffer.indexOf('\n')) !== -1) {
+        const line = buffer.slice(0, newlineIndex);
+        buffer = buffer.slice(newlineIndex + 1);
+        if (line.trim()) {
+            yield line;
+        }
     }
-    catch {
-        return false;
+    // Continue reading from socket.
+    for await (const chunk of socket) {
+        buffer += chunk.toString('utf-8');
+        while ((newlineIndex = buffer.indexOf('\n')) !== -1) {
+            const line = buffer.slice(0, newlineIndex);
+            buffer = buffer.slice(newlineIndex + 1);
+            if (line.trim()) {
+                yield line;
+            }
+        }
     }
 }
 //# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,273 @@
+/**
+ * CCCC SDK type definitions
+ */
+/** IPC request envelope */
+export interface DaemonRequest {
+    v: 1;
+    op: string;
+    args?: Record<string, unknown>;
+}
+/** IPC response envelope */
+export interface DaemonResponse {
+    v?: 1;
+    ok: boolean;
+    result?: Record<string, unknown>;
+    error?: DaemonErrorPayload;
+}
+/** Error payload */
+export interface DaemonErrorPayload {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/** Daemon endpoint */
+export interface DaemonEndpoint {
+    readonly transport: 'unix' | 'tcp' | '';
+    readonly path: string;
+    readonly host: string;
+    readonly port: number;
+}
+/** Address descriptor (ccccd.addr.json) */
+export interface AddressDescriptor {
+    v: 1;
+    transport: 'unix' | 'tcp';
+    path?: string;
+    host?: string;
+    port?: number;
+    pid?: number;
+    version?: string;
+    ts?: string;
+}
+/** Event stream item */
+export type EventStreamItem = {
+    t: 'event';
+    event: CCCSEvent;
+} | {
+    t: 'heartbeat';
+    ts: string;
+} | {
+    t: string;
+    [key: string]: unknown;
+};
+/** CCCS event */
+export interface CCCSEvent {
+    id: string;
+    ts: string;
+    kind: string;
+    group_id: string;
+    data: Record<string, unknown>;
+}
+/** Client initialization options */
+export interface CCCCClientOptions {
+    ccccHome?: string;
+    endpoint?: DaemonEndpoint;
+    timeoutMs?: number;
+}
+/** Compatibility check options */
+export interface CompatibilityOptions {
+    requireIpcV?: number;
+    requireCapabilities?: Record<string, boolean>;
+    requireOps?: string[];
+}
+/** Send message options */
+export interface SendOptions {
+    groupId: string;
+    text: string;
+    by?: string;
+    to?: string[];
+    priority?: 'normal' | 'attention';
+    replyRequired?: boolean;
+    path?: string;
+}
+/** Send-cross-group options */
+export interface SendCrossGroupOptions {
+    groupId: string;
+    dstGroupId: string;
+    text: string;
+    by?: string;
+    to?: string[];
+    priority?: 'normal' | 'attention';
+    replyRequired?: boolean;
+}
+/** Reply message options */
+export interface ReplyOptions {
+    groupId: string;
+    replyTo: string;
+    text: string;
+    by?: string;
+    to?: string[];
+    priority?: 'normal' | 'attention';
+    replyRequired?: boolean;
+}
+/** Add actor options */
+export interface ActorAddOptions {
+    groupId: string;
+    actorId?: string;
+    title?: string;
+    runtime?: string;
+    runner?: string;
+    command?: string[];
+    env?: Record<string, string>;
+    envPrivate?: Record<string, string>;
+    defaultScopeKey?: string;
+    submit?: string;
+    by?: string;
+}
+/** Update actor options */
+export interface ActorUpdateOptions {
+    groupId: string;
+    actorId: string;
+    patch: Record<string, unknown>;
+    by?: string;
+}
+/** Actor private env vars (secrets, runtime-only) */
+export interface ActorEnvPrivateUpdateOptions {
+    groupId: string;
+    actorId: string;
+    by?: string;
+    set?: Record<string, string>;
+    unset?: string[];
+    clear?: boolean;
+}
+/** Create group options */
+export interface GroupCreateOptions {
+    title?: string;
+    topic?: string;
+    by?: string;
+}
+/** Update group options */
+export interface GroupUpdateOptions {
+    groupId: string;
+    patch: Record<string, unknown>;
+    by?: string;
+}
+/** Automation notify priority */
+export type AutomationNotifyPriority = 'low' | 'normal' | 'high' | 'urgent';
+/** Automation trigger (interval) */
+export interface AutomationTriggerInterval {
+    kind: 'interval';
+    every_seconds: number;
+}
+/** Automation trigger (cron) */
+export interface AutomationTriggerCron {
+    kind: 'cron';
+    cron: string;
+    timezone?: string;
+}
+/** Automation trigger (one-time) */
+export interface AutomationTriggerAt {
+    kind: 'at';
+    at: string;
+}
+/** Automation trigger */
+export type AutomationTrigger = AutomationTriggerInterval | AutomationTriggerCron | AutomationTriggerAt;
+/** Automation action (notify) */
+export interface AutomationActionNotify {
+    kind: 'notify';
+    title?: string;
+    snippet_ref?: string | null;
+    message?: string;
+    priority?: AutomationNotifyPriority;
+    requires_ack?: boolean;
+}
+/** Automation action (group state) */
+export interface AutomationActionGroupState {
+    kind: 'group_state';
+    state: 'active' | 'idle' | 'paused' | 'stopped';
+}
+/** Automation action (actor control) */
+export interface AutomationActionActorControl {
+    kind: 'actor_control';
+    operation: 'start' | 'stop' | 'restart';
+    targets?: string[];
+}
+/** Automation action */
+export type AutomationAction = AutomationActionNotify | AutomationActionGroupState | AutomationActionActorControl;
+/** Automation rule */
+export interface AutomationRule {
+    id: string;
+    enabled?: boolean;
+    scope?: 'group' | 'personal';
+    owner_actor_id?: string | null;
+    to?: string[];
+    trigger?: AutomationTrigger;
+    action?: AutomationAction;
+}
+/** Automation ruleset */
+export interface AutomationRuleSet {
+    rules: AutomationRule[];
+    snippets: Record<string, string>;
+}
+/** Automation manage action: create rule */
+export interface AutomationManageCreateRule {
+    type: 'create_rule';
+    rule: AutomationRule;
+}
+/** Automation manage action: update rule */
+export interface AutomationManageUpdateRule {
+    type: 'update_rule';
+    rule: AutomationRule;
+}
+/** Automation manage action: toggle rule */
+export interface AutomationManageSetRuleEnabled {
+    type: 'set_rule_enabled';
+    rule_id: string;
+    enabled: boolean;
+}
+/** Automation manage action: delete rule */
+export interface AutomationManageDeleteRule {
+    type: 'delete_rule';
+    rule_id: string;
+}
+/** Automation manage action: replace all */
+export interface AutomationManageReplaceAllRules {
+    type: 'replace_all_rules';
+    ruleset: AutomationRuleSet;
+}
+/** Automation manage action */
+export type AutomationManageAction = AutomationManageCreateRule | AutomationManageUpdateRule | AutomationManageSetRuleEnabled | AutomationManageDeleteRule | AutomationManageReplaceAllRules;
+/** Group automation update options */
+export interface GroupAutomationUpdateOptions {
+    groupId: string;
+    ruleset: AutomationRuleSet;
+    by?: string;
+    expectedVersion?: number;
+}
+/** Group automation incremental-manage options */
+export interface GroupAutomationManageOptions {
+    groupId: string;
+    by?: string;
+    expectedVersion?: number;
+    actions: AutomationManageAction[];
+}
+/** Group automation reset options */
+export interface GroupAutomationResetBaselineOptions {
+    groupId: string;
+    by?: string;
+    expectedVersion?: number;
+}
+/** Inbox list options */
+export interface InboxListOptions {
+    groupId: string;
+    actorId: string;
+    by?: string;
+    limit?: number;
+    kindFilter?: string;
+}
+/** Context sync options */
+export interface ContextSyncOptions {
+    groupId: string;
+    ops: Record<string, unknown>[];
+    by?: string;
+    dryRun?: boolean;
+}
+/** Event stream options */
+export interface EventsStreamOptions {
+    groupId: string;
+    by?: string;
+    kinds?: Set<string> | string[];
+    sinceEventId?: string;
+    sinceTs?: string;
+    timeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map