@gonzih/cc-wire 0.1.0

package/dist/cjs/channels.cjs

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * cc-wire: channels.ts
+ *
+ * Single source of truth for every Redis key pattern and pub/sub channel
+ * used across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * Conventions:
+ *   - SCREAMING_SNAKE_CASE — static key/channel names (no parameters)
+ *   - camelCase functions  — dynamic key/channel builders (one or more parameters)
+ *
+ * All values match the exact strings used in the source repos as of 2026-05.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMING = exports.CAP = exports.TTL = exports.swarmKey = exports.cronsKey = exports.learningsKey = exports.metaAgentStatusKey = exports.metaInputKey = exports.metaKey = exports.chatOutgoingChannel = exports.chatIncomingChannel = exports.chatLogKey = exports.notifyLogKey = exports.notifyChannel = exports.profileKey = exports.planKey = exports.coordinatorPlanKey = exports.jobDoneQueueKey = exports.jobDoneChannel = exports.jobOutputLiveChannel = exports.jobInputKey = exports.jobSignalKey = exports.jobOutputKey = exports.jobKey = exports.jobIndexKey = exports.SWARM_REQUESTS_KEY = exports.VOICE_FAILED_KEY = exports.VOICE_PENDING_KEY = exports.CC_TG_VERSION_KEY = exports.CC_AGENT_VERSION_KEY = exports.TOKEN_INDEX_KEY = exports.PROFILES_INDEX = exports.META_AGENTS_INDEX = exports.COORDINATOR_GROUP = exports.EVENT_STREAM = void 0;
+// ─── Static Keys ─────────────────────────────────────────────────────────────
+/** Redis Stream written by cc-agent on every job status change. */
+exports.EVENT_STREAM = "cca:event-stream";
+/** Consumer group name used by the coordinator to read from EVENT_STREAM. */
+exports.COORDINATOR_GROUP = "coordinator";
+/** SET — canonical registry of meta-agent namespaces. */
+exports.META_AGENTS_INDEX = "cca:meta:agents:index";
+/** SET — index of saved profile names. */
+exports.PROFILES_INDEX = "cca:profiles:index";
+/** STRING — current token rotation index (INCR/GET). */
+exports.TOKEN_INDEX_KEY = "cca:token:index";
+/** STRING — running cc-agent npm version. */
+exports.CC_AGENT_VERSION_KEY = "cca:meta:cc-agent:version";
+/** STRING — running cc-tg npm version. */
+exports.CC_TG_VERSION_KEY = "cca:meta:cc-tg:version";
+/** LIST — cc-tg voice transcription pending queue (RPUSH, LRANGE, LREM). */
+exports.VOICE_PENDING_KEY = "voice:pending";
+/** LIST — cc-tg voice transcription failure log (RPUSH), TTL 48h. */
+exports.VOICE_FAILED_KEY = "voice:failed";
+/** LIST — swarm task request queue (LPUSH). */
+exports.SWARM_REQUESTS_KEY = "cca:swarm:requests";
+// ─── Job Keys (dynamic) ───────────────────────────────────────────────────────
+/** SET — job IDs for a given namespace. */
+const jobIndexKey = (namespace) => `cca:jobs:${namespace}`;
+exports.jobIndexKey = jobIndexKey;
+/** STRING (JSON) — full JobRecord, TTL 7 days. */
+const jobKey = (jobId) => `cca:job:${jobId}`;
+exports.jobKey = jobKey;
+/** LIST — log lines (RPUSH, LRANGE), TTL 7 days. */
+const jobOutputKey = (jobId) => `cca:job:${jobId}:output`;
+exports.jobOutputKey = jobOutputKey;
+/** STRING — control signal written by cancel/wake: `"cancel"` | `"wake"`. */
+const jobSignalKey = (jobId) => `cca:job:${jobId}:signal`;
+exports.jobSignalKey = jobSignalKey;
+/** LIST — in-flight messages queued for a running job (RPUSH/RPOP). */
+const jobInputKey = (jobId) => `cca:job:${jobId}:input`;
+exports.jobInputKey = jobInputKey;
+/** CHANNEL — live output lines published as the job runs (pub/sub). */
+const jobOutputLiveChannel = (jobId) => `cca:job:${jobId}:output:live`;
+exports.jobOutputLiveChannel = jobOutputLiveChannel;
+/** CHANNEL — job completion notification (pub/sub). */
+const jobDoneChannel = (jobId) => `cca:job:done:${jobId}`;
+exports.jobDoneChannel = jobDoneChannel;
+/** LIST — LPUSH/BLPOP queue for wait_for_job, TTL 7 days. */
+const jobDoneQueueKey = (jobId) => `cca:job:done:${jobId}:queue`;
+exports.jobDoneQueueKey = jobDoneQueueKey;
+// ─── Coordinator Keys (dynamic) ───────────────────────────────────────────────
+/** STRING — coordinator plan JSON stored per job. */
+const coordinatorPlanKey = (jobId) => `cca:coordinator:plan:${jobId}`;
+exports.coordinatorPlanKey = coordinatorPlanKey;
+// ─── Plan Keys (dynamic) ──────────────────────────────────────────────────────
+/** STRING (JSON) — PlanRecord, TTL 30 days. */
+const planKey = (planId) => `cca:plan:${planId}`;
+exports.planKey = planKey;
+// ─── Profile Keys (dynamic) ───────────────────────────────────────────────────
+/** STRING (JSON) — saved Profile. */
+const profileKey = (name) => `cca:profile:${name}`;
+exports.profileKey = profileKey;
+// ─── Notify / Chat Keys (dynamic) ────────────────────────────────────────────
+/** CHANNEL — job completion notifications published by coordinator (pub/sub). */
+const notifyChannel = (namespace) => `cca:notify:${namespace}`;
+exports.notifyChannel = notifyChannel;
+/** LIST — notification log (LPUSH capped at 100, LIFO). */
+const notifyLogKey = (namespace) => `cca:notify-log:${namespace}`;
+exports.notifyLogKey = notifyLogKey;
+/** LIST — chat history (LPUSH capped at 500, LIFO — newest at index 0). */
+const chatLogKey = (namespace) => `cca:chat:log:${namespace}`;
+exports.chatLogKey = chatLogKey;
+/** CHANNEL — UI → cc-tg messages (pub/sub). */
+const chatIncomingChannel = (namespace) => `cca:chat:incoming:${namespace}`;
+exports.chatIncomingChannel = chatIncomingChannel;
+/** CHANNEL — cc-tg / meta-agent → UI messages (pub/sub). */
+const chatOutgoingChannel = (namespace) => `cca:chat:outgoing:${namespace}`;
+exports.chatOutgoingChannel = chatOutgoingChannel;
+// ─── Meta-Agent Keys (dynamic) ───────────────────────────────────────────────
+/** STRING (JSON) — MetaAgentInfo state, TTL 30 days. */
+const metaKey = (namespace) => `cca:meta:${namespace}`;
+exports.metaKey = metaKey;
+/** LIST — input queue for a meta-agent (RPUSH by cc-tg, RPOP by cc-agent). */
+const metaInputKey = (namespace) => `cca:meta:${namespace}:input`;
+exports.metaInputKey = metaInputKey;
+/** STRING (JSON) — live meta-agent status (typing, tool, etc.), TTL 7 days. */
+const metaAgentStatusKey = (namespace) => `cca:meta-agent:status:${namespace}`;
+exports.metaAgentStatusKey = metaAgentStatusKey;
+// ─── Learnings Keys (dynamic) ─────────────────────────────────────────────────
+/** LIST — learnings for a namespace (LPUSH capped at 50, LIFO), TTL 90 days. */
+const learningsKey = (namespace) => `cca:learnings:${namespace}`;
+exports.learningsKey = learningsKey;
+// ─── Cron Keys (dynamic) ──────────────────────────────────────────────────────
+/** STRING (JSON array) — cron job definitions for a namespace. */
+const cronsKey = (namespace) => `cca:crons:${namespace}`;
+exports.cronsKey = cronsKey;
+// ─── Swarm Keys (dynamic) ─────────────────────────────────────────────────────
+/** STRING (JSON) — SwarmRecord for a given swarm ID. */
+const swarmKey = (swarmId) => `cca:swarm:${swarmId}`;
+exports.swarmKey = swarmKey;
+// ─── TTL Constants ────────────────────────────────────────────────────────────
+exports.TTL = {
+    /** 7 days in seconds — job records, output lists, done queues, meta-agent status. */
+    JOB_SECONDS: 7 * 24 * 60 * 60,
+    /** 30 days in seconds — plans, meta-agent state. */
+    PLAN_SECONDS: 30 * 24 * 60 * 60,
+    /** 90 days in seconds — learnings lists. */
+    LEARNINGS_SECONDS: 90 * 24 * 60 * 60,
+    /** 48 hours in seconds — voice:failed list. */
+    VOICE_FAILED_SECONDS: 48 * 60 * 60,
+};
+// ─── Cap Constants ────────────────────────────────────────────────────────────
+exports.CAP = {
+    /** Maximum entries in cca:notify-log:{ns} (LTRIM 0 N-1). */
+    NOTIFY_LOG: 100,
+    /** Maximum entries in cca:chat:log:{ns} (LTRIM 0 N-1). */
+    CHAT_LOG: 500,
+    /** Maximum entries in cca:learnings:{ns} (LTRIM 0 N-1). */
+    LEARNINGS: 50,
+    /** Maximum entries in cca:event-stream (XTRIM MAXLEN ~). */
+    EVENT_STREAM: 500,
+};
+// ─── Timing Constants ─────────────────────────────────────────────────────────
+exports.TIMING = {
+    /** How often the coordinator polls the event stream for new entries (ms). */
+    COORDINATOR_POLL_MS: 2000,
+    /** How often the dependency scheduler checks pending jobs (ms). */
+    DEPENDENCY_TICK_MS: 3000,
+    /** How often the meta-agent poller drains input queues (ms). */
+    INPUT_POLL_INTERVAL_MS: 3000,
+    /** Debounce delay before cc-tg flushes meta-agent streaming output (ms). */
+    META_AGENT_FLUSH_DELAY_MS: 1500,
+};

package/dist/cjs/index.cjs

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @gonzih/cc-wire
+ *
+ * Single source of truth for Redis channel names, key patterns, and message
+ * shapes across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * No runtime deps, no Redis client — just constants, builders, and types.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./channels.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);

package/dist/cjs/types.cjs

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * cc-wire: types.ts
+ *
+ * TypeScript interfaces for every message payload and record shape
+ * published/stored on each Redis channel or key across the cc-suite.
+ *
+ * Derived from actual source: cc-agent/src/types.ts, cc-agent/src/store.ts,
+ * cc-agent/src/meta-agent.ts, cc-tg/src/notifier.ts, cc-agent-ui/server.js,
+ * and docs/redis-protocol.md (both repos).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/channels.d.ts

@@ -0,0 +1,107 @@
+/**
+ * cc-wire: channels.ts
+ *
+ * Single source of truth for every Redis key pattern and pub/sub channel
+ * used across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * Conventions:
+ *   - SCREAMING_SNAKE_CASE — static key/channel names (no parameters)
+ *   - camelCase functions  — dynamic key/channel builders (one or more parameters)
+ *
+ * All values match the exact strings used in the source repos as of 2026-05.
+ */
+/** Redis Stream written by cc-agent on every job status change. */
+export declare const EVENT_STREAM = "cca:event-stream";
+/** Consumer group name used by the coordinator to read from EVENT_STREAM. */
+export declare const COORDINATOR_GROUP = "coordinator";
+/** SET — canonical registry of meta-agent namespaces. */
+export declare const META_AGENTS_INDEX = "cca:meta:agents:index";
+/** SET — index of saved profile names. */
+export declare const PROFILES_INDEX = "cca:profiles:index";
+/** STRING — current token rotation index (INCR/GET). */
+export declare const TOKEN_INDEX_KEY = "cca:token:index";
+/** STRING — running cc-agent npm version. */
+export declare const CC_AGENT_VERSION_KEY = "cca:meta:cc-agent:version";
+/** STRING — running cc-tg npm version. */
+export declare const CC_TG_VERSION_KEY = "cca:meta:cc-tg:version";
+/** LIST — cc-tg voice transcription pending queue (RPUSH, LRANGE, LREM). */
+export declare const VOICE_PENDING_KEY = "voice:pending";
+/** LIST — cc-tg voice transcription failure log (RPUSH), TTL 48h. */
+export declare const VOICE_FAILED_KEY = "voice:failed";
+/** LIST — swarm task request queue (LPUSH). */
+export declare const SWARM_REQUESTS_KEY = "cca:swarm:requests";
+/** SET — job IDs for a given namespace. */
+export declare const jobIndexKey: (namespace: string) => string;
+/** STRING (JSON) — full JobRecord, TTL 7 days. */
+export declare const jobKey: (jobId: string) => string;
+/** LIST — log lines (RPUSH, LRANGE), TTL 7 days. */
+export declare const jobOutputKey: (jobId: string) => string;
+/** STRING — control signal written by cancel/wake: `"cancel"` | `"wake"`. */
+export declare const jobSignalKey: (jobId: string) => string;
+/** LIST — in-flight messages queued for a running job (RPUSH/RPOP). */
+export declare const jobInputKey: (jobId: string) => string;
+/** CHANNEL — live output lines published as the job runs (pub/sub). */
+export declare const jobOutputLiveChannel: (jobId: string) => string;
+/** CHANNEL — job completion notification (pub/sub). */
+export declare const jobDoneChannel: (jobId: string) => string;
+/** LIST — LPUSH/BLPOP queue for wait_for_job, TTL 7 days. */
+export declare const jobDoneQueueKey: (jobId: string) => string;
+/** STRING — coordinator plan JSON stored per job. */
+export declare const coordinatorPlanKey: (jobId: string) => string;
+/** STRING (JSON) — PlanRecord, TTL 30 days. */
+export declare const planKey: (planId: string) => string;
+/** STRING (JSON) — saved Profile. */
+export declare const profileKey: (name: string) => string;
+/** CHANNEL — job completion notifications published by coordinator (pub/sub). */
+export declare const notifyChannel: (namespace: string) => string;
+/** LIST — notification log (LPUSH capped at 100, LIFO). */
+export declare const notifyLogKey: (namespace: string) => string;
+/** LIST — chat history (LPUSH capped at 500, LIFO — newest at index 0). */
+export declare const chatLogKey: (namespace: string) => string;
+/** CHANNEL — UI → cc-tg messages (pub/sub). */
+export declare const chatIncomingChannel: (namespace: string) => string;
+/** CHANNEL — cc-tg / meta-agent → UI messages (pub/sub). */
+export declare const chatOutgoingChannel: (namespace: string) => string;
+/** STRING (JSON) — MetaAgentInfo state, TTL 30 days. */
+export declare const metaKey: (namespace: string) => string;
+/** LIST — input queue for a meta-agent (RPUSH by cc-tg, RPOP by cc-agent). */
+export declare const metaInputKey: (namespace: string) => string;
+/** STRING (JSON) — live meta-agent status (typing, tool, etc.), TTL 7 days. */
+export declare const metaAgentStatusKey: (namespace: string) => string;
+/** LIST — learnings for a namespace (LPUSH capped at 50, LIFO), TTL 90 days. */
+export declare const learningsKey: (namespace: string) => string;
+/** STRING (JSON array) — cron job definitions for a namespace. */
+export declare const cronsKey: (namespace: string) => string;
+/** STRING (JSON) — SwarmRecord for a given swarm ID. */
+export declare const swarmKey: (swarmId: string) => string;
+export declare const TTL: {
+    /** 7 days in seconds — job records, output lists, done queues, meta-agent status. */
+    readonly JOB_SECONDS: number;
+    /** 30 days in seconds — plans, meta-agent state. */
+    readonly PLAN_SECONDS: number;
+    /** 90 days in seconds — learnings lists. */
+    readonly LEARNINGS_SECONDS: number;
+    /** 48 hours in seconds — voice:failed list. */
+    readonly VOICE_FAILED_SECONDS: number;
+};
+export declare const CAP: {
+    /** Maximum entries in cca:notify-log:{ns} (LTRIM 0 N-1). */
+    readonly NOTIFY_LOG: 100;
+    /** Maximum entries in cca:chat:log:{ns} (LTRIM 0 N-1). */
+    readonly CHAT_LOG: 500;
+    /** Maximum entries in cca:learnings:{ns} (LTRIM 0 N-1). */
+    readonly LEARNINGS: 50;
+    /** Maximum entries in cca:event-stream (XTRIM MAXLEN ~). */
+    readonly EVENT_STREAM: 500;
+};
+export declare const TIMING: {
+    /** How often the coordinator polls the event stream for new entries (ms). */
+    readonly COORDINATOR_POLL_MS: 2000;
+    /** How often the dependency scheduler checks pending jobs (ms). */
+    readonly DEPENDENCY_TICK_MS: 3000;
+    /** How often the meta-agent poller drains input queues (ms). */
+    readonly INPUT_POLL_INTERVAL_MS: 3000;
+    /** Debounce delay before cc-tg flushes meta-agent streaming output (ms). */
+    readonly META_AGENT_FLUSH_DELAY_MS: 1500;
+};
+//# sourceMappingURL=channels.d.ts.map

package/dist/esm/channels.d.ts.map

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

package/dist/esm/channels.js

@@ -0,0 +1,120 @@
+/**
+ * cc-wire: channels.ts
+ *
+ * Single source of truth for every Redis key pattern and pub/sub channel
+ * used across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * Conventions:
+ *   - SCREAMING_SNAKE_CASE — static key/channel names (no parameters)
+ *   - camelCase functions  — dynamic key/channel builders (one or more parameters)
+ *
+ * All values match the exact strings used in the source repos as of 2026-05.
+ */
+// ─── Static Keys ─────────────────────────────────────────────────────────────
+/** Redis Stream written by cc-agent on every job status change. */
+export const EVENT_STREAM = "cca:event-stream";
+/** Consumer group name used by the coordinator to read from EVENT_STREAM. */
+export const COORDINATOR_GROUP = "coordinator";
+/** SET — canonical registry of meta-agent namespaces. */
+export const META_AGENTS_INDEX = "cca:meta:agents:index";
+/** SET — index of saved profile names. */
+export const PROFILES_INDEX = "cca:profiles:index";
+/** STRING — current token rotation index (INCR/GET). */
+export const TOKEN_INDEX_KEY = "cca:token:index";
+/** STRING — running cc-agent npm version. */
+export const CC_AGENT_VERSION_KEY = "cca:meta:cc-agent:version";
+/** STRING — running cc-tg npm version. */
+export const CC_TG_VERSION_KEY = "cca:meta:cc-tg:version";
+/** LIST — cc-tg voice transcription pending queue (RPUSH, LRANGE, LREM). */
+export const VOICE_PENDING_KEY = "voice:pending";
+/** LIST — cc-tg voice transcription failure log (RPUSH), TTL 48h. */
+export const VOICE_FAILED_KEY = "voice:failed";
+/** LIST — swarm task request queue (LPUSH). */
+export const SWARM_REQUESTS_KEY = "cca:swarm:requests";
+// ─── Job Keys (dynamic) ───────────────────────────────────────────────────────
+/** SET — job IDs for a given namespace. */
+export const jobIndexKey = (namespace) => `cca:jobs:${namespace}`;
+/** STRING (JSON) — full JobRecord, TTL 7 days. */
+export const jobKey = (jobId) => `cca:job:${jobId}`;
+/** LIST — log lines (RPUSH, LRANGE), TTL 7 days. */
+export const jobOutputKey = (jobId) => `cca:job:${jobId}:output`;
+/** STRING — control signal written by cancel/wake: `"cancel"` | `"wake"`. */
+export const jobSignalKey = (jobId) => `cca:job:${jobId}:signal`;
+/** LIST — in-flight messages queued for a running job (RPUSH/RPOP). */
+export const jobInputKey = (jobId) => `cca:job:${jobId}:input`;
+/** CHANNEL — live output lines published as the job runs (pub/sub). */
+export const jobOutputLiveChannel = (jobId) => `cca:job:${jobId}:output:live`;
+/** CHANNEL — job completion notification (pub/sub). */
+export const jobDoneChannel = (jobId) => `cca:job:done:${jobId}`;
+/** LIST — LPUSH/BLPOP queue for wait_for_job, TTL 7 days. */
+export const jobDoneQueueKey = (jobId) => `cca:job:done:${jobId}:queue`;
+// ─── Coordinator Keys (dynamic) ───────────────────────────────────────────────
+/** STRING — coordinator plan JSON stored per job. */
+export const coordinatorPlanKey = (jobId) => `cca:coordinator:plan:${jobId}`;
+// ─── Plan Keys (dynamic) ──────────────────────────────────────────────────────
+/** STRING (JSON) — PlanRecord, TTL 30 days. */
+export const planKey = (planId) => `cca:plan:${planId}`;
+// ─── Profile Keys (dynamic) ───────────────────────────────────────────────────
+/** STRING (JSON) — saved Profile. */
+export const profileKey = (name) => `cca:profile:${name}`;
+// ─── Notify / Chat Keys (dynamic) ────────────────────────────────────────────
+/** CHANNEL — job completion notifications published by coordinator (pub/sub). */
+export const notifyChannel = (namespace) => `cca:notify:${namespace}`;
+/** LIST — notification log (LPUSH capped at 100, LIFO). */
+export const notifyLogKey = (namespace) => `cca:notify-log:${namespace}`;
+/** LIST — chat history (LPUSH capped at 500, LIFO — newest at index 0). */
+export const chatLogKey = (namespace) => `cca:chat:log:${namespace}`;
+/** CHANNEL — UI → cc-tg messages (pub/sub). */
+export const chatIncomingChannel = (namespace) => `cca:chat:incoming:${namespace}`;
+/** CHANNEL — cc-tg / meta-agent → UI messages (pub/sub). */
+export const chatOutgoingChannel = (namespace) => `cca:chat:outgoing:${namespace}`;
+// ─── Meta-Agent Keys (dynamic) ───────────────────────────────────────────────
+/** STRING (JSON) — MetaAgentInfo state, TTL 30 days. */
+export const metaKey = (namespace) => `cca:meta:${namespace}`;
+/** LIST — input queue for a meta-agent (RPUSH by cc-tg, RPOP by cc-agent). */
+export const metaInputKey = (namespace) => `cca:meta:${namespace}:input`;
+/** STRING (JSON) — live meta-agent status (typing, tool, etc.), TTL 7 days. */
+export const metaAgentStatusKey = (namespace) => `cca:meta-agent:status:${namespace}`;
+// ─── Learnings Keys (dynamic) ─────────────────────────────────────────────────
+/** LIST — learnings for a namespace (LPUSH capped at 50, LIFO), TTL 90 days. */
+export const learningsKey = (namespace) => `cca:learnings:${namespace}`;
+// ─── Cron Keys (dynamic) ──────────────────────────────────────────────────────
+/** STRING (JSON array) — cron job definitions for a namespace. */
+export const cronsKey = (namespace) => `cca:crons:${namespace}`;
+// ─── Swarm Keys (dynamic) ─────────────────────────────────────────────────────
+/** STRING (JSON) — SwarmRecord for a given swarm ID. */
+export const swarmKey = (swarmId) => `cca:swarm:${swarmId}`;
+// ─── TTL Constants ────────────────────────────────────────────────────────────
+export const TTL = {
+    /** 7 days in seconds — job records, output lists, done queues, meta-agent status. */
+    JOB_SECONDS: 7 * 24 * 60 * 60,
+    /** 30 days in seconds — plans, meta-agent state. */
+    PLAN_SECONDS: 30 * 24 * 60 * 60,
+    /** 90 days in seconds — learnings lists. */
+    LEARNINGS_SECONDS: 90 * 24 * 60 * 60,
+    /** 48 hours in seconds — voice:failed list. */
+    VOICE_FAILED_SECONDS: 48 * 60 * 60,
+};
+// ─── Cap Constants ────────────────────────────────────────────────────────────
+export const CAP = {
+    /** Maximum entries in cca:notify-log:{ns} (LTRIM 0 N-1). */
+    NOTIFY_LOG: 100,
+    /** Maximum entries in cca:chat:log:{ns} (LTRIM 0 N-1). */
+    CHAT_LOG: 500,
+    /** Maximum entries in cca:learnings:{ns} (LTRIM 0 N-1). */
+    LEARNINGS: 50,
+    /** Maximum entries in cca:event-stream (XTRIM MAXLEN ~). */
+    EVENT_STREAM: 500,
+};
+// ─── Timing Constants ─────────────────────────────────────────────────────────
+export const TIMING = {
+    /** How often the coordinator polls the event stream for new entries (ms). */
+    COORDINATOR_POLL_MS: 2000,
+    /** How often the dependency scheduler checks pending jobs (ms). */
+    DEPENDENCY_TICK_MS: 3000,
+    /** How often the meta-agent poller drains input queues (ms). */
+    INPUT_POLL_INTERVAL_MS: 3000,
+    /** Debounce delay before cc-tg flushes meta-agent streaming output (ms). */
+    META_AGENT_FLUSH_DELAY_MS: 1500,
+};
+//# sourceMappingURL=channels.js.map

package/dist/esm/channels.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @gonzih/cc-wire
+ *
+ * Single source of truth for Redis channel names, key patterns, and message
+ * shapes across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * No runtime deps, no Redis client — just constants, builders, and types.
+ */
+export * from "./channels.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+/**
+ * @gonzih/cc-wire
+ *
+ * Single source of truth for Redis channel names, key patterns, and message
+ * shapes across the cc-suite (cc-agent, cc-tg, cc-agent-ui).
+ *
+ * No runtime deps, no Redis client — just constants, builders, and types.
+ */
+export * from "./channels.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/esm/types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * cc-wire: types.ts
+ *
+ * TypeScript interfaces for every message payload and record shape
+ * published/stored on each Redis channel or key across the cc-suite.
+ *
+ * Derived from actual source: cc-agent/src/types.ts, cc-agent/src/store.ts,
+ * cc-agent/src/meta-agent.ts, cc-tg/src/notifier.ts, cc-agent-ui/server.js,
+ * and docs/redis-protocol.md (both repos).
+ */
+export type JobStatus = "pending" | "cloning" | "running" | "done" | "failed" | "cancelled" | "sleeping" | "pending_approval" | "rejected" | "interrupted";
+/**
+ * Full job metadata stored in `cca:job:{id}`.
+ * JSON-encoded string, TTL 7 days.
+ */
+export interface JobRecord {
+    id: string;
+    status: JobStatus;
+    repoUrl: string;
+    task: string;
+    branch?: string;
+    createBranch?: string;
+    dependsOn?: string[];
+    startedAt?: string;
+    finishedAt?: string;
+    exitCode?: number;
+    error?: string;
+    pid?: number;
+    sessionIdAfter?: string;
+    totalInputTokens?: number;
+    totalOutputTokens?: number;
+    totalCacheReadTokens?: number;
+    totalCacheWriteTokens?: number;
+    costUsd?: number;
+    recentTools: string[];
+    outputLineCount: number;
+    sleepUntil?: string;
+    sleepReason?: string;
+    approvalIssueUrl?: string;
+    approvalRepo?: string;
+    approvalIssueNumber?: number;
+    score?: number | null;
+    scoreSource?: "self_reported" | "heuristic" | null;
+    variantIndex?: number;
+    parentVariant?: string;
+    siblings?: string[];
+    dockerIsolation?: boolean;
+    isolation?: "docker" | "host";
+    resumedFrom?: string;
+    interruptedAt?: string;
+    tokenIndex?: number;
+    agentDriver?: string;
+    agentModel?: string;
+    noPreamble?: boolean;
+    retryCount?: number;
+    timeoutMinutes?: number;
+    timedOut?: boolean;
+    failReason?: string;
+}
+/** Values that may be written to `cca:job:{id}:signal`. */
+export type JobSignal = "cancel" | "wake";
+/**
+ * JSON payload published to `cca:job:done:{id}` and LPUSH'd to
+ * `cca:job:done:{id}:queue`.
+ */
+export interface JobDonePayload {
+    job_id: string;
+    status: JobStatus;
+    score?: number | null;
+    score_source?: "self_reported" | "heuristic" | null;
+    finished_at?: string;
+    exit_code?: number;
+}
+/**
+ * Fields written to `cca:event-stream` via XADD.
+ * All field values are strings (Redis Stream requirement).
+ */
+export interface JobEvent {
+    jobId: string;
+    status: string;
+    title: string;
+    repoUrl: string;
+    lastLines: string[];
+    score?: number;
+    timestamp: string;
+    coordinatorPlan?: CoordinatorPlan;
+}
+/** Optional follow-up job plan attached to a job event. */
+export interface CoordinatorPlan {
+    next_step?: {
+        repo_url: string;
+        task: string;
+    };
+    summary?: string;
+}
+/**
+ * JSON payload published to `cca:notify:{namespace}` and LPUSH'd to
+ * `cca:notify-log:{namespace}`.
+ */
+export interface NotificationPayload {
+    text: string;
+    driver?: string;
+    model?: string;
+    cost?: number;
+}
+/**
+ * Shape for all messages written to chat channels and the chat log.
+ *
+ * Ordering note: `cca:chat:log:{ns}` is LIFO (LPUSH). Consumers must reverse
+ * the LRANGE result for chronological display.
+ */
+export interface ChatMessage {
+    id: string;
+    source: "telegram" | "ui" | "claude" | "cc-tg";
+    role: "user" | "assistant" | "tool";
+    content: string;
+    timestamp: string;
+    chatId: number;
+}
+/**
+ * Persisted meta-agent state stored in `cca:meta:{namespace}`.
+ * JSON-encoded string, TTL 30 days.
+ */
+export interface MetaAgentInfo {
+    namespace: string;
+    repoUrl: string;
+    cwd: string;
+    pid?: number;
+    status: "running" | "idle";
+    startedAt: string;
+    lastMessageAt?: string;
+    lastActivity?: string;
+    currentTool?: string;
+    isTyping?: boolean;
+    lastMessage?: string;
+    turnCount?: number;
+}
+/**
+ * Live status written to `cca:meta-agent:status:{namespace}` on every change.
+ * JSON-encoded string, TTL 7 days.
+ */
+export interface MetaAgentStatus {
+    namespace: string;
+    status: "running" | "idle";
+    pid?: number;
+    startedAt?: string;
+    lastActivity?: string;
+    currentTool?: string;
+    isTyping: boolean;
+    lastMessage?: string;
+    turnCount: number;
+    updatedAt: string;
+}
+/**
+ * Saved spawn profile stored in `cca:profile:{name}`.
+ * JSON-encoded string (no TTL).
+ */
+export interface Profile {
+    name: string;
+    repoUrl: string;
+    taskTemplate: string;
+    defaultBudgetUsd?: number;
+    branch?: string;
+    description?: string;
+    preamble?: string;
+    builtin?: boolean;
+    createdAt: string;
+}
+/**
+ * Multi-step plan record stored in `cca:plan:{id}`.
+ * JSON-encoded string, TTL 30 days.
+ */
+export interface PlanRecord {
+    id: string;
+    goal: string;
+    steps: Array<{
+        stepId: string;
+        jobId: string;
+        status: string;
+    }>;
+    createdAt: string;
+}
+/**
+ * A single cron job entry inside the JSON array at `cca:crons:{namespace}`.
+ */
+export interface CronJob {
+    id: string;
+    schedule: string;
+    prompt: string;
+    createdAt: string;
+}
+/**
+ * Swarm orchestration record stored in `cca:swarm:{swarm_id}`.
+ * JSON-encoded string.
+ */
+export interface SwarmRecord {
+    swarm_id: string;
+    [key: string]: unknown;
+}
+/**
+ * Entry in the `voice:pending` list (RPUSH'd by cc-tg).
+ * JSON-encoded string.
+ */
+export interface VoicePendingEntry {
+    id: string;
+    chatId: number;
+    threadId?: number;
+    filePath: string;
+    enqueuedAt: string;
+}
+/** Token usage breakdown reported by agent drivers. */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/esm/types.js

@@ -0,0 +1,12 @@
+/**
+ * cc-wire: types.ts
+ *
+ * TypeScript interfaces for every message payload and record shape
+ * published/stored on each Redis channel or key across the cc-suite.
+ *
+ * Derived from actual source: cc-agent/src/types.ts, cc-agent/src/store.ts,
+ * cc-agent/src/meta-agent.ts, cc-tg/src/notifier.ts, cc-agent-ui/server.js,
+ * and docs/redis-protocol.md (both repos).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gonzih/cc-wire",
+  "version": "0.1.0",
+  "description": "Single source of truth for Redis channel names, key patterns, and message shapes across the cc-suite (cc-tg, cc-agent, cc-agent-ui)",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gonzih/cc-wire.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/fix-cjs.mjs"
+  },
+  "devDependencies": {
+    "typescript": "5.8.3"
+  },
+  "keywords": [
+    "redis",
+    "cc-agent",
+    "cc-tg",
+    "cc-suite",
+    "channels"
+  ],
+  "license": "MIT"
+}