@cleocode/core 2026.3.76 → 2026.4.0

package/dist/sessions/snapshot.js

@@ -0,0 +1,213 @@
+/**
+ * Session snapshot serialization and restoration.
+ *
+ * Provides `serializeSession()` and `restoreSession()` for full session
+ * state capture and hydration. Designed for CleoOS agent session persistence:
+ * when an agent dies, CleoOS serializes the session snapshot, and when a new
+ * agent connects, it restores the snapshot to resume seamlessly.
+ *
+ * The snapshot captures everything needed to resume work:
+ * - Full session object (scope, taskWork, notes, stats)
+ * - Handoff data (completed tasks, decisions, next suggested)
+ * - Brain context (recent observations linked to this session)
+ * - Active task state (current focus, blockers)
+ *
+ * @module sessions/snapshot
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+import { getDecisionLog } from './decisions.js';
+import { computeHandoff } from './handoff.js';
+// ============================================================================
+// Snapshot types
+// ============================================================================
+/** Version of the snapshot schema. Increment on breaking changes. */
+export const SNAPSHOT_VERSION = 1;
+// ============================================================================
+// Serialize
+// ============================================================================
+/**
+ * Serialize a session into a complete snapshot.
+ *
+ * Captures the full session state including handoff data, decisions,
+ * brain observations, and active task context. The result is a
+ * JSON-serializable object that can be stored and later restored.
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Serialization options
+ * @returns Complete session snapshot
+ */
+export async function serializeSession(projectRoot, options = {}, accessor) {
+    const acc = accessor ?? (await getAccessor(projectRoot));
+    const maxObs = options.maxObservations ?? 10;
+    const maxDescLen = options.maxDescriptionLength ?? 500;
+    // Find the session
+    const sessions = await acc.loadSessions();
+    let session;
+    if (options.sessionId) {
+        session = sessions.find((s) => s.id === options.sessionId);
+    }
+    else {
+        // Find the active session
+        session = sessions
+            .filter((s) => s.status === 'active')
+            .sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+    }
+    if (!session) {
+        throw new CleoError(ExitCode.SESSION_NOT_FOUND, options.sessionId
+            ? `Session '${options.sessionId}' not found`
+            : 'No active session to serialize', { fix: "Use 'cleo session list' to see available sessions" });
+    }
+    // Compute handoff data
+    const handoff = await computeHandoff(projectRoot, { sessionId: session.id });
+    // Get decisions
+    const decisionLog = await getDecisionLog(projectRoot, { sessionId: session.id });
+    const decisions = decisionLog.map((d) => ({
+        decision: d.decision,
+        rationale: d.rationale,
+        taskId: d.taskId,
+        recordedAt: d.timestamp ?? new Date().toISOString(),
+    }));
+    // Get brain observations linked to this session (best-effort)
+    let observations = [];
+    try {
+        const { searchBrainCompact } = await import('../memory/brain-retrieval.js');
+        const results = await searchBrainCompact(projectRoot, {
+            query: session.id,
+            limit: maxObs,
+            tables: ['observations'],
+        });
+        if (Array.isArray(results)) {
+            observations = results.map((r) => ({
+                id: r.id,
+                text: r.text ?? '',
+                type: r.type ?? 'discovery',
+                createdAt: r.createdAt ?? '',
+            }));
+        }
+    }
+    catch {
+        // Brain search is best-effort — snapshot works without it
+    }
+    // Get active task context
+    let activeTask = null;
+    if (session.taskWork?.taskId) {
+        try {
+            const { tasks } = await acc.queryTasks({});
+            const task = tasks.find((t) => t.id === session.taskWork?.taskId);
+            if (task) {
+                const desc = task.description ?? '';
+                activeTask = {
+                    taskId: task.id,
+                    title: task.title,
+                    status: task.status,
+                    priority: task.priority ?? 'medium',
+                    description: desc.length > maxDescLen ? desc.slice(0, maxDescLen) + '...' : desc,
+                    acceptance: Array.isArray(task.acceptance)
+                        ? task.acceptance.join('\n')
+                        : (task.acceptance ?? undefined),
+                };
+            }
+        }
+        catch {
+            // Task lookup is best-effort
+        }
+    }
+    // Compute duration
+    const startTime = new Date(session.startedAt).getTime();
+    const now = Date.now();
+    const durationMinutes = Math.round((now - startTime) / 60_000);
+    return {
+        version: SNAPSHOT_VERSION,
+        capturedAt: new Date().toISOString(),
+        session,
+        handoff,
+        decisions,
+        observations,
+        activeTask,
+        durationMinutes,
+    };
+}
+// ============================================================================
+// Restore
+// ============================================================================
+/**
+ * Restore a session from a snapshot.
+ *
+ * Hydrates a session from a previously serialized snapshot. The session
+ * is re-inserted into the sessions store and optionally activated.
+ * Brain observations from the snapshot are NOT re-inserted (they already
+ * exist in brain.db) — only the session state is restored.
+ *
+ * @param projectRoot - Project root directory
+ * @param snapshot - The snapshot to restore from
+ * @param options - Restoration options
+ * @returns The restored session
+ */
+export async function restoreSession(projectRoot, snapshot, options = {}, accessor) {
+    // Validate snapshot version
+    if (snapshot.version > SNAPSHOT_VERSION) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Snapshot version ${snapshot.version} is newer than supported version ${SNAPSHOT_VERSION}`, { fix: 'Upgrade @cleocode/core to a newer version that supports this snapshot format' });
+    }
+    const acc = accessor ?? (await getAccessor(projectRoot));
+    const activate = options.activate ?? true;
+    // Check for active session conflict
+    if (activate) {
+        const sessions = await acc.loadSessions();
+        const scope = snapshot.session.scope;
+        const activeConflict = sessions.find((s) => s.status === 'active' &&
+            s.scope.type === scope.type &&
+            s.scope.epicId === scope.epicId &&
+            s.id !== snapshot.session.id);
+        if (activeConflict) {
+            throw new CleoError(ExitCode.SCOPE_CONFLICT, `Active session '${activeConflict.id}' already exists for scope ${scope.type}${scope.epicId ? ':' + scope.epicId : ''}`, {
+                fix: `End the active session first with 'cleo session end' or restore without activating`,
+                alternatives: [
+                    { action: 'End conflicting session', command: 'cleo session end' },
+                    { action: 'Restore without activating', command: 'Restore with activate: false' },
+                ],
+            });
+        }
+    }
+    // Reconstruct the session
+    const restoredSession = {
+        ...snapshot.session,
+        status: activate ? 'active' : snapshot.session.status,
+        notes: [
+            ...(snapshot.session.notes ?? []),
+            `Restored from snapshot at ${new Date().toISOString()} (captured ${snapshot.capturedAt}, duration ${snapshot.durationMinutes}m)`,
+        ],
+        resumeCount: (snapshot.session.resumeCount ?? 0) + 1,
+    };
+    // Update agent if a new one is taking over
+    if (options.agent) {
+        restoredSession.agent = options.agent;
+        restoredSession.notes = [
+            ...(restoredSession.notes ?? []),
+            `Agent handoff: ${snapshot.session.agent ?? 'unknown'} → ${options.agent}`,
+        ];
+    }
+    // Store the handoff data for context
+    restoredSession.handoffJson = JSON.stringify(snapshot.handoff);
+    // Persist
+    await acc.upsertSingleSession(restoredSession);
+    // Dispatch hook (best-effort)
+    try {
+        const { hooks } = await import('../hooks/registry.js');
+        await hooks.dispatch('SessionStart', projectRoot, {
+            timestamp: new Date().toISOString(),
+            sessionId: restoredSession.id,
+            name: restoredSession.name,
+            scope: restoredSession.scope,
+            agent: restoredSession.agent,
+            restored: true,
+            snapshotCapturedAt: snapshot.capturedAt,
+        });
+    }
+    catch {
+        // Hooks are best-effort
+    }
+    return restoredSession;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/sessions/snapshot.js.map

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

package/dist/sessions/statusline-setup.js

@@ -0,0 +1,85 @@
+/**
+ * Statusline setup helper - Claude Code status line integration.
+ *
+ * Checks and configures Claude Code status line for context monitoring.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { getCleoHome } from '../paths.js';
+/** Inline Claude settings path to decouple from provider-specific paths (T5240). */
+function getClaudeSettingsPath() {
+    return (process.env['CLAUDE_SETTINGS'] ??
+        join(process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude'), 'settings.json'));
+}
+/**
+ * Check if statusline integration is configured.
+ * Returns the current integration status.
+ */
+export function checkStatuslineIntegration() {
+    const settingsPath = getClaudeSettingsPath();
+    if (!existsSync(settingsPath))
+        return 'no_settings';
+    try {
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        const statusLine = settings.statusLine;
+        if (!statusLine?.type)
+            return 'not_configured';
+        if (statusLine.type !== 'command')
+            return 'custom_no_cleo';
+        const cmd = statusLine.command ?? '';
+        // Check if it's a CLEO statusline integration
+        if (cmd.includes('context-monitor.sh') ||
+            cmd.includes('cleo-statusline') ||
+            cmd.includes('.context-state.json') ||
+            cmd.includes('context-states')) {
+            return 'configured';
+        }
+        // Check if the script writes to CLEO state file
+        const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
+        if (existsSync(scriptPath)) {
+            try {
+                const content = readFileSync(scriptPath, 'utf-8');
+                if (content.includes('context-state.json'))
+                    return 'configured';
+            }
+            catch {
+                /* unreadable */
+            }
+        }
+        return 'custom_no_cleo';
+    }
+    catch {
+        return 'no_settings';
+    }
+}
+/**
+ * Get the statusline setup command for Claude Code settings.
+ */
+export function getStatuslineConfig() {
+    const cleoHome = getCleoHome();
+    return {
+        statusLine: {
+            type: 'command',
+            command: join(cleoHome, 'lib', 'session', 'context-monitor.sh'),
+        },
+    };
+}
+/**
+ * Get human-readable setup instructions.
+ */
+export function getSetupInstructions() {
+    const settingsPath = getClaudeSettingsPath();
+    return [
+        'To enable context monitoring, add to your Claude Code settings:',
+        `File: ${settingsPath}`,
+        '',
+        JSON.stringify(getStatuslineConfig(), null, 2),
+        '',
+        'This enables real-time context window tracking in the CLI.',
+    ].join('\n');
+}
+//# sourceMappingURL=statusline-setup.js.map

package/dist/sessions/statusline-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-setup.js","sourceRoot":"","sources":["../../src/sessions/statusline-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oFAAoF;AACpF,SAAS,qBAAqB;IAC5B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,eAAe,CAAC,CAChF,CAAC;AACJ,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,aAAa,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QAEvC,IAAI,CAAC,UAAU,EAAE,IAAI;YAAE,OAAO,gBAAgB,CAAC;QAC/C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC;QAE3D,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;QAErC,8CAA8C;QAC9C,IACE,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAClC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC/B,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC9B,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE3E,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBAAE,OAAO,YAAY,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC;SAChE;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,OAAO;QACL,iEAAiE;QACjE,SAAS,YAAY,EAAE;QACvB,EAAE;QACF,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,EAAE;QACF,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/sessions/types.js

@@ -0,0 +1,8 @@
+/**
+ * Extended session types used by the engine/dispatch layer.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sessions/types.js.map

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

package/dist/signaldock/claude-code-transport.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Claude Code transport — provider-specific adapter wrapping the current SendMessage pattern.
+ *
+ * This is the Phase 0 transport that maps the AgentTransport interface onto
+ * Claude Code's native Agent SDK tools (SendMessage, TaskUpdate, etc.).
+ *
+ * It serves as the default transport when SignalDock is not enabled,
+ * preserving backward compatibility with the existing orchestration model.
+ *
+ * @task T5671
+ */
+import type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
+import type { Agent, AgentClass, Conversation, ConversationVisibility, Message, PrivacyTier } from './types.js';
+/**
+ * Claude Code transport — wraps the current provider-specific messaging.
+ *
+ * Registration and deregistration are no-ops because the Claude Code Agent SDK
+ * manages agent identity internally. Message sending is logged but actual
+ * delivery happens through the SDK's SendMessage tool at the agent level.
+ */
+export declare class ClaudeCodeTransport implements AgentTransport {
+    readonly name = "claude-code";
+    private agents;
+    private conversations;
+    private messages;
+    register(name: string, agentClass: AgentClass, privacyTier: PrivacyTier): Promise<AgentRegistration>;
+    deregister(agentId: string): Promise<void>;
+    send(fromAgentId: string, toAgentId: string, content: string, conversationId?: string): Promise<MessageResult>;
+    poll(agentId: string, since?: string): Promise<Message[]>;
+    heartbeat(agentId: string): Promise<void>;
+    createConversation(participants: string[], visibility?: ConversationVisibility): Promise<Conversation>;
+    getAgent(agentId: string): Promise<Agent | null>;
+}
+//# sourceMappingURL=claude-code-transport.d.ts.map

package/dist/signaldock/claude-code-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-transport.d.ts","sourceRoot":"","sources":["../../src/signaldock/claude-code-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAiB;IAE3B,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAWvB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC;IAyBnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,kBAAkB,CACtB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAAC,YAAY,CAAC;IAkBlB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAevD"}

package/dist/signaldock/claude-code-transport.js

@@ -0,0 +1,107 @@
+/**
+ * Claude Code transport — provider-specific adapter wrapping the current SendMessage pattern.
+ *
+ * This is the Phase 0 transport that maps the AgentTransport interface onto
+ * Claude Code's native Agent SDK tools (SendMessage, TaskUpdate, etc.).
+ *
+ * It serves as the default transport when SignalDock is not enabled,
+ * preserving backward compatibility with the existing orchestration model.
+ *
+ * @task T5671
+ */
+/**
+ * Claude Code transport — wraps the current provider-specific messaging.
+ *
+ * Registration and deregistration are no-ops because the Claude Code Agent SDK
+ * manages agent identity internally. Message sending is logged but actual
+ * delivery happens through the SDK's SendMessage tool at the agent level.
+ */
+export class ClaudeCodeTransport {
+    name = 'claude-code';
+    agents = new Map();
+    conversations = new Map();
+    messages = [];
+    async register(name, agentClass, privacyTier) {
+        const registration = {
+            agentId: `cc-${name}`,
+            name,
+            agentClass,
+            privacyTier,
+        };
+        this.agents.set(registration.agentId, registration);
+        return registration;
+    }
+    async deregister(agentId) {
+        this.agents.delete(agentId);
+    }
+    async send(fromAgentId, toAgentId, content, conversationId) {
+        const resolvedConversationId = conversationId ?? `cc-conv-${fromAgentId}-${toAgentId}`;
+        const now = new Date().toISOString();
+        const messageId = `cc-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const message = {
+            id: messageId,
+            conversationId: resolvedConversationId,
+            fromAgentId,
+            toAgentId,
+            content,
+            contentType: 'text',
+            status: 'delivered',
+            createdAt: now,
+            deliveredAt: now,
+        };
+        this.messages.push(message);
+        return {
+            messageId,
+            conversationId: resolvedConversationId,
+            status: 'delivered',
+        };
+    }
+    async poll(agentId, since) {
+        return this.messages.filter((m) => {
+            if (m.toAgentId !== agentId)
+                return false;
+            if (since && m.createdAt <= since)
+                return false;
+            return true;
+        });
+    }
+    async heartbeat(agentId) {
+        const agent = this.agents.get(agentId);
+        if (agent) {
+            this.agents.set(agentId, { ...agent });
+        }
+    }
+    async createConversation(participants, visibility) {
+        const now = new Date().toISOString();
+        const id = `cc-conv-${participants.sort().join('-')}`;
+        const existing = this.conversations.get(id);
+        if (existing)
+            return existing;
+        const conversation = {
+            id,
+            participants,
+            visibility: visibility ?? 'private',
+            messageCount: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.conversations.set(id, conversation);
+        return conversation;
+    }
+    async getAgent(agentId) {
+        const registration = this.agents.get(agentId);
+        if (!registration)
+            return null;
+        const now = new Date().toISOString();
+        return {
+            id: registration.agentId,
+            name: registration.name,
+            agentClass: registration.agentClass,
+            privacyTier: registration.privacyTier,
+            status: 'online',
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+}
+//# sourceMappingURL=claude-code-transport.js.map

package/dist/signaldock/claude-code-transport.js.map

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

package/dist/signaldock/factory.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Transport factory — selects the appropriate AgentTransport based on configuration.
+ *
+ * @task T5671
+ */
+import type { AgentTransport } from './transport.js';
+/** Configuration for transport selection. */
+export interface TransportFactoryConfig {
+    enabled: boolean;
+    mode: 'http' | 'native';
+    endpoint: string;
+    agentPrefix: string;
+    privacyTier: 'public' | 'discoverable' | 'private';
+}
+/**
+ * Create an AgentTransport instance based on configuration.
+ *
+ * Returns SignalDockTransport if signaldock is enabled,
+ * otherwise returns ClaudeCodeTransport as the default.
+ */
+export declare function createTransport(config?: TransportFactoryConfig): AgentTransport;
+//# sourceMappingURL=factory.d.ts.map

package/dist/signaldock/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/signaldock/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAY/E"}

package/dist/signaldock/factory.js

@@ -0,0 +1,25 @@
+/**
+ * Transport factory — selects the appropriate AgentTransport based on configuration.
+ *
+ * @task T5671
+ */
+import { ClaudeCodeTransport } from './claude-code-transport.js';
+import { SignalDockTransport } from './signaldock-transport.js';
+/**
+ * Create an AgentTransport instance based on configuration.
+ *
+ * Returns SignalDockTransport if signaldock is enabled,
+ * otherwise returns ClaudeCodeTransport as the default.
+ */
+export function createTransport(config) {
+    if (!config?.enabled) {
+        return new ClaudeCodeTransport();
+    }
+    const sdConfig = {
+        endpoint: config.endpoint,
+        agentPrefix: config.agentPrefix,
+        privacyTier: config.privacyTier,
+    };
+    return new SignalDockTransport(sdConfig);
+}
+//# sourceMappingURL=factory.js.map

package/dist/signaldock/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/signaldock/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAYhE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,QAAQ,GAA8B;QAC1C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;IAEF,OAAO,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/signaldock/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SignalDock integration module — provider-neutral agent transport layer.
+ *
+ * @task T5671
+ */
+export { ClaudeCodeTransport } from './claude-code-transport.js';
+export type { TransportFactoryConfig } from './factory.js';
+export { createTransport } from './factory.js';
+export type { SignalDockTransportConfig } from './signaldock-transport.js';
+export { SignalDockTransport } from './signaldock-transport.js';
+export type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
+export type { Agent, AgentClass, AgentStatus, ApiResponse, ContentType, Conversation, ConversationVisibility, Message, MessageStatus, NewAgent, NewConversation, NewMessage, PrivacyTier, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signaldock/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvF,YAAY,EACV,KAAK,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/signaldock/index.js

@@ -0,0 +1,9 @@
+/**
+ * SignalDock integration module — provider-neutral agent transport layer.
+ *
+ * @task T5671
+ */
+export { ClaudeCodeTransport } from './claude-code-transport.js';
+export { createTransport } from './factory.js';
+export { SignalDockTransport } from './signaldock-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/signaldock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/signaldock/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/signaldock/signaldock-transport.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SignalDock HTTP transport — provider-neutral agent messaging via SignalDock REST API.
+ *
+ * This transport enables CLEO agents to communicate through SignalDock's
+ * infrastructure regardless of which AI coding tool hosts them.
+ *
+ * IMPORTANT: This is a TypeScript HTTP client. No SignalDock source code
+ * has been copied. All interactions use the public REST API.
+ *
+ * @task T5671
+ */
+import type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
+import type { Agent, AgentClass, Conversation, ConversationVisibility, Message, PrivacyTier } from './types.js';
+/** Configuration for SignalDockTransport. */
+export interface SignalDockTransportConfig {
+    /** Base URL of the SignalDock API server. */
+    endpoint: string;
+    /** Prefix for agent names (e.g., "cleo-" -> "cleo-orchestrator"). */
+    agentPrefix: string;
+    /** Default privacy tier for registered agents. */
+    privacyTier: PrivacyTier;
+}
+/**
+ * SignalDock HTTP transport implementation.
+ *
+ * Communicates with a SignalDock server via its REST API to provide
+ * provider-neutral inter-agent messaging with delivery guarantees.
+ */
+export declare class SignalDockTransport implements AgentTransport {
+    readonly name = "signaldock";
+    private readonly config;
+    constructor(config: SignalDockTransportConfig);
+    register(name: string, agentClass: AgentClass, privacyTier: PrivacyTier): Promise<AgentRegistration>;
+    deregister(agentId: string): Promise<void>;
+    send(fromAgentId: string, toAgentId: string, content: string, conversationId?: string): Promise<MessageResult>;
+    poll(agentId: string, since?: string): Promise<Message[]>;
+    heartbeat(agentId: string): Promise<void>;
+    createConversation(participants: string[], visibility?: ConversationVisibility): Promise<Conversation>;
+    getAgent(agentId: string): Promise<Agent | null>;
+    /**
+     * Make an HTTP request to the SignalDock API.
+     */
+    private request;
+}
+//# sourceMappingURL=signaldock-transport.d.ts.map

package/dist/signaldock/signaldock-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signaldock-transport.d.ts","sourceRoot":"","sources":["../../src/signaldock/signaldock-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EAEV,YAAY,EACZ,sBAAsB,EACtB,OAAO,EAIP,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,EAAE,yBAAyB;IAIvC,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC;IAyBnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,kBAAkB,CACtB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,GAAE,sBAAkC,GAC7C,OAAO,CAAC,YAAY,CAAC;IASlB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAQtD;;OAEG;YACW,OAAO;CA+CtB"}