cccc-sdk 0.1.0

package/dist/transport.js

@@ -0,0 +1,142 @@
+/**
+ * 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": {...}}
+ */
+import * as net from 'node:net';
+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');
+}
+/**
+ * Get socket path for CCCC daemon
+ */
+export function getSocketPath(ccccHome) {
+    const home = ccccHome || getDefaultCcccHome();
+    return path.join(home, 'daemon', 'ccccd.sock');
+}
+/**
+ * Check if daemon socket exists
+ */
+export function socketExists(ccccHome) {
+    const sockPath = getSocketPath(ccccHome);
+    try {
+        fs.accessSync(sockPath, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Send a request to the CCCC daemon and receive a response
+ */
+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}`);
+    }
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection(sockPath);
+        let buffer = '';
+        let resolved = false;
+        const cleanup = () => {
+            socket.removeAllListeners();
+            socket.destroy();
+        };
+        const handleError = (error) => {
+            if (resolved)
+                return;
+            resolved = true;
+            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));
+            }
+        };
+        // Set timeout
+        const timeoutId = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            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');
+        });
+        socket.on('data', (chunk) => {
+            buffer += chunk.toString('utf-8');
+            // Check size limit
+            if (buffer.length > MAX_RESPONSE_SIZE) {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutId);
+                cleanup();
+                reject(new CCCCError('INTERNAL', 'Response too large'));
+                return;
+            }
+            // Check for complete response (newline terminated)
+            const newlineIndex = buffer.indexOf('\n');
+            if (newlineIndex !== -1) {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutId);
+                cleanup();
+                const line = buffer.slice(0, newlineIndex);
+                try {
+                    const response = JSON.parse(line);
+                    resolve(response);
+                }
+                catch {
+                    reject(new CCCCError('INTERNAL', 'Invalid JSON response from daemon'));
+                }
+            }
+        });
+        socket.on('error', handleError);
+        socket.on('close', () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timeoutId);
+            cleanup();
+            reject(new CCCCError('DAEMON_NOT_RUNNING', 'Connection closed unexpectedly'));
+        });
+    });
+}
+/**
+ * Ping the daemon to check if it's running
+ */
+export async function pingDaemon(options = {}) {
+    try {
+        const response = await callDaemon({ v: 1, op: 'ping', args: {} }, options);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/types/actor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Actor-related types
+ */
+export type ActorRole = 'foreman' | 'peer';
+export type ActorSubmit = 'enter' | 'newline' | 'none';
+export type RunnerKind = 'pty' | 'headless';
+export type AgentRuntime = 'amp' | 'auggie' | 'claude' | 'codex' | 'cursor' | 'droid' | 'gemini' | 'kilocode' | 'neovate' | 'opencode' | 'copilot' | 'custom';
+export type GroupState = 'active' | 'idle' | 'paused';
+export interface Actor {
+    v: number;
+    id: string;
+    role?: ActorRole | null;
+    title: string;
+    command: string[];
+    env: Record<string, string>;
+    default_scope_key: string;
+    submit: ActorSubmit;
+    enabled: boolean;
+    runner: RunnerKind;
+    runtime: AgentRuntime;
+    created_at: string;
+    updated_at: string;
+}
+export interface HeadlessState {
+    v: number;
+    group_id: string;
+    actor_id: string;
+    status: 'idle' | 'working' | 'waiting' | 'stopped';
+    current_task_id?: string | null;
+    last_message_id?: string | null;
+    started_at: string;
+    updated_at: string;
+}
+export interface ActorAddOptions {
+    actor_id: string;
+    runtime?: AgentRuntime;
+    runner?: RunnerKind;
+    title?: string;
+    command?: string[];
+    env?: Record<string, string>;
+}
+//# sourceMappingURL=actor.d.ts.map

package/dist/types/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../types/actor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}

package/dist/types/actor.js

@@ -0,0 +1,5 @@
+/**
+ * Actor-related types
+ */
+export {};
+//# sourceMappingURL=actor.js.map

package/dist/types/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../types/actor.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/context.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Context-related types
+ */
+export type MilestoneStatus = 'planned' | 'active' | 'done' | 'archived';
+export type TaskStatus = 'planned' | 'active' | 'done' | 'archived';
+export type StepStatus = 'pending' | 'in_progress' | 'done';
+export interface Milestone {
+    id: string;
+    name: string;
+    description: string;
+    status: MilestoneStatus;
+    started?: string | null;
+    completed?: string | null;
+    outcomes?: string | null;
+}
+export interface Step {
+    id: string;
+    name: string;
+    acceptance: string;
+    status: StepStatus;
+}
+export interface Task {
+    id: string;
+    name: string;
+    goal: string;
+    status: TaskStatus;
+    milestone?: string | null;
+    assignee?: string | null;
+    steps: Step[];
+    created_at: string;
+    updated_at: string;
+}
+export interface Note {
+    id: string;
+    content: string;
+}
+export interface ContextReference {
+    id: string;
+    url: string;
+    note: string;
+}
+export interface Presence {
+    agent_id: string;
+    status: string;
+    updated_at: string;
+}
+export interface Context {
+    vision: string;
+    sketch: string;
+    milestones: Milestone[];
+    tasks_summary: {
+        total: number;
+        by_status: Record<TaskStatus, number>;
+    };
+    active_task?: Task | null;
+    notes: Note[];
+    references: ContextReference[];
+    presence: Presence[];
+}
+export interface ContextSyncOp {
+    op: string;
+    [key: string]: unknown;
+}
+export interface TaskCreateOptions {
+    name: string;
+    goal: string;
+    steps: Array<{
+        name: string;
+        acceptance: string;
+    }>;
+    milestone_id?: string;
+    assignee?: string;
+}
+export interface TaskUpdateOptions {
+    task_id: string;
+    name?: string;
+    goal?: string;
+    status?: TaskStatus;
+    assignee?: string;
+    milestone_id?: string;
+    step_id?: string;
+    step_status?: StepStatus;
+}
+export interface MilestoneCreateOptions {
+    name: string;
+    description: string;
+    status?: MilestoneStatus;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

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

package/dist/types/context.js

@@ -0,0 +1,5 @@
+/**
+ * Context-related types
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../types/context.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/event.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event-related types
+ */
+export type EventKind = 'group.create' | 'group.update' | 'group.attach' | 'group.detach_scope' | 'group.set_active_scope' | 'group.start' | 'group.stop' | 'actor.add' | 'actor.update' | 'actor.set_role' | 'actor.start' | 'actor.stop' | 'actor.restart' | 'actor.remove' | 'context.sync' | 'chat.message' | 'chat.read' | 'chat.reaction' | 'system.notify' | 'system.notify_ack';
+export interface Event {
+    v: number;
+    id: string;
+    ts: string;
+    kind: EventKind | string;
+    group_id: string;
+    scope_key: string;
+    by: string;
+    data: Record<string, unknown>;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/types/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../types/event.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,cAAc,GACd,cAAc,GACd,oBAAoB,GACpB,wBAAwB,GACxB,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,eAAe,GACf,cAAc,GACd,cAAc,GACd,cAAc,GACd,WAAW,GACX,eAAe,GACf,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

package/dist/types/event.js

@@ -0,0 +1,5 @@
+/**
+ * Event-related types
+ */
+export {};
+//# sourceMappingURL=event.js.map

package/dist/types/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../types/event.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/group.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Group-related types
+ */
+import type { Actor, GroupState } from './actor.js';
+export interface Scope {
+    scope_key: string;
+    url: string;
+    label: string;
+    git_remote: string;
+}
+export interface GroupInfo {
+    v: number;
+    group_id: string;
+    title: string;
+    topic: string;
+    created_at: string;
+    updated_at: string;
+    running: boolean;
+    state: GroupState;
+    active_scope_key: string;
+    scopes: Scope[];
+    actors: Actor[];
+}
+export interface GroupCreateOptions {
+    title: string;
+    topic?: string;
+    url?: string;
+}
+export interface GroupUpdatePatch {
+    title?: string;
+    topic?: string;
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/types/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../types/group.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/group.js

@@ -0,0 +1,5 @@
+/**
+ * Group-related types
+ */
+export {};
+//# sourceMappingURL=group.js.map

package/dist/types/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../types/group.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CCCC SDK Type Definitions
+ */
+export * from './ipc.js';
+export * from './actor.js';
+export * from './group.js';
+export * from './message.js';
+export * from './event.js';
+export * from './context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * CCCC SDK Type Definitions
+ */
+export * from './ipc.js';
+export * from './actor.js';
+export * from './group.js';
+export * from './message.js';
+export * from './event.js';
+export * from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/types/ipc.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IPC protocol types for CCCC daemon communication
+ */
+export interface DaemonRequest {
+    v: number;
+    op: string;
+    args: Record<string, unknown>;
+}
+export interface DaemonError {
+    code: string;
+    message: string;
+    details: Record<string, unknown>;
+}
+export interface DaemonResponse {
+    v: number;
+    ok: boolean;
+    result: Record<string, unknown>;
+    error: DaemonError | null;
+}
+/**
+ * Create a daemon request
+ */
+export declare function createRequest(op: string, args?: Record<string, unknown>): DaemonRequest;
+//# sourceMappingURL=ipc.d.ts.map

package/dist/types/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../types/ipc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,aAAa,CAE3F"}

package/dist/types/ipc.js

@@ -0,0 +1,10 @@
+/**
+ * IPC protocol types for CCCC daemon communication
+ */
+/**
+ * Create a daemon request
+ */
+export function createRequest(op, args = {}) {
+    return { v: 1, op, args };
+}
+//# sourceMappingURL=ipc.js.map

package/dist/types/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../types/ipc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,OAAgC,EAAE;IAC1E,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/types/message.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Message-related types
+ */
+export interface Reference {
+    kind: 'file' | 'url' | 'commit' | 'text';
+    url: string;
+    path: string;
+    title: string;
+    sha: string;
+    bytes: number;
+}
+export interface Attachment {
+    kind: 'text' | 'image' | 'file';
+    path: string;
+    title: string;
+    mime_type: string;
+    bytes: number;
+    sha256: string;
+}
+export interface ChatMessageData {
+    text: string;
+    format: 'plain' | 'markdown';
+    to: string[];
+    reply_to?: string | null;
+    quote_text?: string | null;
+    refs: Record<string, unknown>[];
+    attachments: Record<string, unknown>[];
+    thread: string;
+    client_id?: string | null;
+}
+export interface SendMessageOptions {
+    text: string;
+    to?: string[];
+    format?: 'plain' | 'markdown';
+    attachments?: string[];
+}
+export interface ReplyMessageOptions {
+    event_id: string;
+    text: string;
+    to?: string[];
+}
+export interface InboxMessage {
+    event_id: string;
+    ts: string;
+    kind: string;
+    by: string;
+    data: ChatMessageData;
+}
+export interface InboxListOptions {
+    kind_filter?: 'all' | 'chat' | 'notify';
+    limit?: number;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../types/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC;IAC7B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/message.js

@@ -0,0 +1,5 @@
+/**
+ * Message-related types
+ */
+export {};
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../types/message.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "cccc-sdk",
+  "version": "0.1.0",
+  "description": "CCCC Client SDK for Node.js - IPC client for CCCC daemon",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test dist/tests/*.js",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "cccc",
+    "agent",
+    "sdk",
+    "ipc",
+    "daemon",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/*.js",
+    "dist/*.d.ts",
+    "dist/types",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aspect-build/cccc.git",
+    "directory": "src/sdk/ts"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}