@cleocode/core 2026.3.76 → 2026.4.2

package/src/conduit/__tests__/dual-api-e2e.test.ts

@@ -0,0 +1,212 @@
+/**
+ * Dual-API E2E test — verify messaging across both SignalDock endpoints.
+ *
+ * Tests that agents can exchange messages on:
+ * 1. api.signaldock.io (canonical)
+ * 2. api.clawmsgr.com (legacy)
+ * 3. Local signaldock.db (offline)
+ *
+ * These tests hit real APIs and require valid credentials.
+ * Set SKIP_E2E=1 to skip when running in CI without network.
+ *
+ * @task T226
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { HttpTransport } from '../http-transport.js';
+
+// ============================================================================
+// Config helpers
+// ============================================================================
+
+const CLEO_DIR = join(process.cwd(), '.cleo');
+const SKIP_E2E = process.env['SKIP_E2E'] === '1';
+
+/** Load a ClawMsgr/SignalDock config file. */
+function loadConfig(
+  filename: string,
+): { agentId: string; apiKey: string; apiBaseUrl: string } | null {
+  const path = join(CLEO_DIR, filename);
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, 'utf-8')) as {
+      agentId: string;
+      apiKey: string;
+      apiBaseUrl: string;
+    };
+  } catch {
+    return null;
+  }
+}
+
+/** Send a test message and verify it arrives. */
+async function testMessageExchange(
+  apiBaseUrl: string,
+  senderConfig: { agentId: string; apiKey: string },
+  receiverAgentId: string,
+): Promise<{ sent: boolean; messageId: string | null; error: string | null }> {
+  const transport = new HttpTransport();
+  try {
+    await transport.connect({
+      agentId: senderConfig.agentId,
+      apiKey: senderConfig.apiKey,
+      apiBaseUrl,
+    });
+
+    const testContent = `/info @${receiverAgentId} #e2e-test T226 verification at ${new Date().toISOString()}`;
+    const result = await transport.push(receiverAgentId, testContent);
+
+    await transport.disconnect();
+    return { sent: true, messageId: result.messageId, error: null };
+  } catch (err) {
+    await transport.disconnect();
+    return { sent: false, messageId: null, error: String(err) };
+  }
+}
+
+// ============================================================================
+// Test suite
+// ============================================================================
+
+describe('Dual-API E2E', () => {
+  // --------------------------------------------------------------------------
+  // Config verification
+  // --------------------------------------------------------------------------
+
+  describe('config files exist', () => {
+    it('has clawmsgr configs (legacy)', () => {
+      const config = loadConfig('clawmsgr-cleo-rust-lead.json');
+      if (!config) {
+        console.log('SKIP: clawmsgr config not found');
+        return;
+      }
+      expect(config.agentId).toBe('cleo-rust-lead');
+      expect(config.apiBaseUrl).toContain('clawmsgr.com');
+    });
+
+    it('has signaldock configs (canonical)', () => {
+      const config = loadConfig('signaldock-cleo-rust-lead.json');
+      if (!config) {
+        console.log('SKIP: signaldock config not found');
+        return;
+      }
+      expect(config.agentId).toBe('cleo-rust-lead');
+      expect(config.apiBaseUrl).toContain('signaldock.io');
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // API health checks
+  // --------------------------------------------------------------------------
+
+  describe('API health', () => {
+    it('api.signaldock.io is healthy', async () => {
+      if (SKIP_E2E) return;
+      const response = await fetch('https://api.signaldock.io/health', {
+        signal: AbortSignal.timeout(10_000),
+      });
+      expect(response.ok).toBe(true);
+      const data = (await response.json()) as { data?: { status?: string } };
+      expect(data.data?.status).toBe('ok');
+    });
+
+    it('api.clawmsgr.com is healthy', async () => {
+      if (SKIP_E2E) return;
+      const response = await fetch('https://api.clawmsgr.com/health', {
+        signal: AbortSignal.timeout(10_000),
+      });
+      expect(response.ok).toBe(true);
+      const data = (await response.json()) as { data?: { status?: string } };
+      expect(data.data?.status).toBe('ok');
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // Message exchange on api.signaldock.io
+  // --------------------------------------------------------------------------
+
+  describe('api.signaldock.io messaging', () => {
+    it('can send a message via signaldock.io', async () => {
+      if (SKIP_E2E) return;
+      const config = loadConfig('signaldock-cleo-rust-lead.json');
+      if (!config) {
+        console.log('SKIP: no signaldock config');
+        return;
+      }
+      const result = await testMessageExchange(
+        'https://api.signaldock.io',
+        { agentId: config.agentId, apiKey: config.apiKey },
+        'cleo-dev',
+      );
+      expect(result.sent).toBe(true);
+      expect(result.messageId).toBeDefined();
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // Message exchange on api.clawmsgr.com
+  // --------------------------------------------------------------------------
+
+  describe('api.clawmsgr.com messaging', () => {
+    it('can send a message via clawmsgr.com', async () => {
+      if (SKIP_E2E) return;
+      const config = loadConfig('clawmsgr-cleo-rust-lead.json');
+      if (!config) {
+        console.log('SKIP: no clawmsgr config');
+        return;
+      }
+      const result = await testMessageExchange(
+        'https://api.clawmsgr.com',
+        { agentId: config.agentId, apiKey: config.apiKey },
+        'cleo-dev',
+      );
+      expect(result.sent).toBe(true);
+      expect(result.messageId).toBeDefined();
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // Cross-API metadata consistency
+  // --------------------------------------------------------------------------
+
+  describe('cross-API consistency', () => {
+    it('agent profile exists on both APIs', async () => {
+      if (SKIP_E2E) return;
+      const clawConfig = loadConfig('clawmsgr-cleo-rust-lead.json');
+      const sdConfig = loadConfig('signaldock-cleo-rust-lead.json');
+      if (!clawConfig || !sdConfig) {
+        console.log('SKIP: missing configs');
+        return;
+      }
+
+      // Check agent exists on clawmsgr
+      const clawResp = await fetch('https://api.clawmsgr.com/agents/cleo-rust-lead', {
+        headers: {
+          Authorization: `Bearer ${clawConfig.apiKey}`,
+          'X-Agent-Id': 'cleo-rust-lead',
+        },
+        signal: AbortSignal.timeout(10_000),
+      });
+
+      // Check agent exists on signaldock
+      const sdResp = await fetch('https://api.signaldock.io/agents/cleo-rust-lead', {
+        headers: {
+          Authorization: `Bearer ${sdConfig.apiKey}`,
+          'X-Agent-Id': 'cleo-rust-lead',
+        },
+        signal: AbortSignal.timeout(10_000),
+      });
+
+      expect(clawResp.ok).toBe(true);
+      expect(sdResp.ok).toBe(true);
+
+      const clawData = (await clawResp.json()) as { data?: { agent?: { agentId?: string } } };
+      const sdData = (await sdResp.json()) as { data?: { agent?: { agentId?: string } } };
+
+      expect(clawData.data?.agent?.agentId).toBe('cleo-rust-lead');
+      expect(sdData.data?.agent?.agentId).toBe('cleo-rust-lead');
+    });
+  });
+});

package/src/conduit/__tests__/local-credential-flow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-credential-flow.test.d.ts","sourceRoot":"","sources":["local-credential-flow.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/src/conduit/__tests__/local-credential-flow.test.js

@@ -0,0 +1,185 @@
+/**
+ * Local credential flow — end-to-end validation.
+ *
+ * Tests the full lifecycle: signaldock.db creation → agent register →
+ * credential encryption/decryption → LocalTransport connect →
+ * push/poll/ack messaging.
+ *
+ * @task T227
+ */
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ensureSignaldockDb, getSignaldockDbPath } from '../../store/signaldock-sqlite.js';
+import { LocalTransport } from '../local-transport.js';
+// ============================================================================
+// Test helpers
+// ============================================================================
+let testDir;
+let originalCwd;
+async function setupTestEnvironment() {
+    const dir = join(tmpdir(), `credential-flow-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    mkdirSync(join(dir, '.cleo'), { recursive: true });
+    // Create a minimal .cleo/project-context.json so paths resolve
+    writeFileSync(join(dir, '.cleo', 'project-context.json'), JSON.stringify({ schemaVersion: '1.0.0', projectTypes: ['node'], primaryType: 'node' }));
+    return dir;
+}
+// ============================================================================
+// Test suite
+// ============================================================================
+describe('Local Credential Flow E2E', () => {
+    beforeEach(async () => {
+        originalCwd = process.cwd();
+        testDir = await setupTestEnvironment();
+        process.chdir(testDir);
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        if (testDir && existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    // --------------------------------------------------------------------------
+    // Step 1: cleo init creates signaldock.db
+    // --------------------------------------------------------------------------
+    describe('Step 1: signaldock.db creation', () => {
+        it('ensureSignaldockDb creates the database file', async () => {
+            const result = await ensureSignaldockDb(testDir);
+            expect(result.action).toBe('created');
+            expect(existsSync(result.path)).toBe(true);
+        });
+        it('ensureSignaldockDb is idempotent', async () => {
+            const first = await ensureSignaldockDb(testDir);
+            const second = await ensureSignaldockDb(testDir);
+            expect(first.action).toBe('created');
+            expect(second.action).toBe('exists');
+            expect(first.path).toBe(second.path);
+        });
+        it('signaldock.db has the messages table', async () => {
+            await ensureSignaldockDb(testDir);
+            const dbPath = getSignaldockDbPath(testDir);
+            expect(existsSync(dbPath)).toBe(true);
+            // Verify by connecting LocalTransport (which checks for messages table)
+            const transport = new LocalTransport();
+            await transport.connect({
+                agentId: 'test',
+                apiKey: 'sk_test',
+                apiBaseUrl: 'http://localhost',
+            });
+            await transport.disconnect();
+        });
+    });
+    // --------------------------------------------------------------------------
+    // Step 2: LocalTransport availability
+    // --------------------------------------------------------------------------
+    describe('Step 2: LocalTransport availability', () => {
+        it('isAvailable returns false before init', () => {
+            const emptyDir = join(tmpdir(), `no-init-${Date.now()}`);
+            mkdirSync(join(emptyDir, '.cleo'), { recursive: true });
+            expect(LocalTransport.isAvailable(emptyDir)).toBe(false);
+            rmSync(emptyDir, { recursive: true, force: true });
+        });
+        it('isAvailable returns true after init', async () => {
+            await ensureSignaldockDb(testDir);
+            expect(LocalTransport.isAvailable(testDir)).toBe(true);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // Step 3: Full messaging lifecycle
+    // --------------------------------------------------------------------------
+    describe('Step 3: messaging lifecycle', () => {
+        it('complete flow: init → connect → push → poll → ack', async () => {
+            // 1. Init signaldock.db
+            await ensureSignaldockDb(testDir);
+            // 2. Connect two agents
+            const agent1 = new LocalTransport();
+            const agent2 = new LocalTransport();
+            await agent1.connect({
+                agentId: 'cleo-rust-lead',
+                apiKey: 'sk_live_fake1',
+                apiBaseUrl: 'http://localhost',
+            });
+            await agent2.connect({
+                agentId: 'cleo-dev',
+                apiKey: 'sk_live_fake2',
+                apiBaseUrl: 'http://localhost',
+            });
+            // 3. Agent 1 sends a message to Agent 2
+            const sendResult = await agent1.push('cleo-dev', '/action @cleo-dev #test Hello from rust-lead');
+            expect(sendResult.messageId).toBeDefined();
+            // 4. Agent 2 polls and receives the message
+            const messages = await agent2.poll();
+            expect(messages).toHaveLength(1);
+            expect(messages[0].from).toBe('cleo-rust-lead');
+            expect(messages[0].content).toContain('Hello from rust-lead');
+            // 5. Agent 2 acknowledges the message
+            await agent2.ack([messages[0].id]);
+            // 6. Subsequent poll returns empty (message was acked)
+            const afterAck = await agent2.poll();
+            expect(afterAck).toHaveLength(0);
+            // 7. Agent 2 replies
+            const replyResult = await agent2.push('cleo-rust-lead', '/ack Received.');
+            expect(replyResult.messageId).toBeDefined();
+            // 8. Agent 1 receives the reply
+            const replies = await agent1.poll();
+            expect(replies).toHaveLength(1);
+            expect(replies[0].from).toBe('cleo-dev');
+            expect(replies[0].content).toBe('/ack Received.');
+            // Cleanup
+            await agent1.disconnect();
+            await agent2.disconnect();
+        });
+        it('messages persist across transport reconnections', async () => {
+            await ensureSignaldockDb(testDir);
+            // Send a message
+            const sender = new LocalTransport();
+            await sender.connect({
+                agentId: 'sender',
+                apiKey: 'sk_test',
+                apiBaseUrl: 'http://localhost',
+            });
+            await sender.push('receiver', 'persistent message');
+            await sender.disconnect();
+            // New transport instance reads the same DB
+            const receiver = new LocalTransport();
+            await receiver.connect({
+                agentId: 'receiver',
+                apiKey: 'sk_test',
+                apiBaseUrl: 'http://localhost',
+            });
+            const messages = await receiver.poll();
+            expect(messages).toHaveLength(1);
+            expect(messages[0].content).toBe('persistent message');
+            await receiver.disconnect();
+        });
+        it('multiple agents can communicate in the same conversation', async () => {
+            await ensureSignaldockDb(testDir);
+            const prime = new LocalTransport();
+            const rustLead = new LocalTransport();
+            const dbLead = new LocalTransport();
+            await prime.connect({ agentId: 'prime', apiKey: 'sk1', apiBaseUrl: 'http://localhost' });
+            await rustLead.connect({
+                agentId: 'rust-lead',
+                apiKey: 'sk2',
+                apiBaseUrl: 'http://localhost',
+            });
+            await dbLead.connect({ agentId: 'db-lead', apiKey: 'sk3', apiBaseUrl: 'http://localhost' });
+            // Prime sends to rust-lead
+            await prime.push('rust-lead', 'Fix cant-lsp');
+            // Prime sends to db-lead
+            await prime.push('db-lead', 'Review schemas');
+            // Each agent only sees their own messages
+            const rustMessages = await rustLead.poll();
+            const dbMessages = await dbLead.poll();
+            expect(rustMessages).toHaveLength(1);
+            expect(rustMessages[0].content).toBe('Fix cant-lsp');
+            expect(dbMessages).toHaveLength(1);
+            expect(dbMessages[0].content).toBe('Review schemas');
+            await prime.disconnect();
+            await rustLead.disconnect();
+            await dbLead.disconnect();
+        });
+    });
+});
+//# sourceMappingURL=local-credential-flow.test.js.map

package/src/conduit/__tests__/local-credential-flow.test.js.map

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

package/src/conduit/__tests__/local-credential-flow.test.ts

@@ -0,0 +1,230 @@
+/**
+ * Local credential flow — end-to-end validation.
+ *
+ * Tests the full lifecycle: signaldock.db creation → agent register →
+ * credential encryption/decryption → LocalTransport connect →
+ * push/poll/ack messaging.
+ *
+ * @task T227
+ */
+
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ensureSignaldockDb, getSignaldockDbPath } from '../../store/signaldock-sqlite.js';
+import { LocalTransport } from '../local-transport.js';
+
+// ============================================================================
+// Test helpers
+// ============================================================================
+
+let testDir: string;
+let originalCwd: string;
+
+async function setupTestEnvironment(): Promise<string> {
+  const dir = join(
+    tmpdir(),
+    `credential-flow-test-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+  );
+  mkdirSync(join(dir, '.cleo'), { recursive: true });
+  // Create a minimal .cleo/project-context.json so paths resolve
+  writeFileSync(
+    join(dir, '.cleo', 'project-context.json'),
+    JSON.stringify({ schemaVersion: '1.0.0', projectTypes: ['node'], primaryType: 'node' }),
+  );
+  return dir;
+}
+
+// ============================================================================
+// Test suite
+// ============================================================================
+
+describe('Local Credential Flow E2E', () => {
+  beforeEach(async () => {
+    originalCwd = process.cwd();
+    testDir = await setupTestEnvironment();
+    process.chdir(testDir);
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    if (testDir && existsSync(testDir)) {
+      rmSync(testDir, { recursive: true, force: true });
+    }
+  });
+
+  // --------------------------------------------------------------------------
+  // Step 1: cleo init creates signaldock.db
+  // --------------------------------------------------------------------------
+
+  describe('Step 1: signaldock.db creation', () => {
+    it('ensureSignaldockDb creates the database file', async () => {
+      const result = await ensureSignaldockDb(testDir);
+      expect(result.action).toBe('created');
+      expect(existsSync(result.path)).toBe(true);
+    });
+
+    it('ensureSignaldockDb is idempotent', async () => {
+      const first = await ensureSignaldockDb(testDir);
+      const second = await ensureSignaldockDb(testDir);
+      expect(first.action).toBe('created');
+      expect(second.action).toBe('exists');
+      expect(first.path).toBe(second.path);
+    });
+
+    it('signaldock.db has the messages table', async () => {
+      await ensureSignaldockDb(testDir);
+      const dbPath = getSignaldockDbPath(testDir);
+      expect(existsSync(dbPath)).toBe(true);
+
+      // Verify by connecting LocalTransport (which checks for messages table)
+      const transport = new LocalTransport();
+      await transport.connect({
+        agentId: 'test',
+        apiKey: 'sk_test',
+        apiBaseUrl: 'http://localhost',
+      });
+      await transport.disconnect();
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // Step 2: LocalTransport availability
+  // --------------------------------------------------------------------------
+
+  describe('Step 2: LocalTransport availability', () => {
+    it('isAvailable returns false before init', () => {
+      const emptyDir = join(tmpdir(), `no-init-${Date.now()}`);
+      mkdirSync(join(emptyDir, '.cleo'), { recursive: true });
+      expect(LocalTransport.isAvailable(emptyDir)).toBe(false);
+      rmSync(emptyDir, { recursive: true, force: true });
+    });
+
+    it('isAvailable returns true after init', async () => {
+      await ensureSignaldockDb(testDir);
+      expect(LocalTransport.isAvailable(testDir)).toBe(true);
+    });
+  });
+
+  // --------------------------------------------------------------------------
+  // Step 3: Full messaging lifecycle
+  // --------------------------------------------------------------------------
+
+  describe('Step 3: messaging lifecycle', () => {
+    it('complete flow: init → connect → push → poll → ack', async () => {
+      // 1. Init signaldock.db
+      await ensureSignaldockDb(testDir);
+
+      // 2. Connect two agents
+      const agent1 = new LocalTransport();
+      const agent2 = new LocalTransport();
+
+      await agent1.connect({
+        agentId: 'cleo-rust-lead',
+        apiKey: 'sk_live_fake1',
+        apiBaseUrl: 'http://localhost',
+      });
+      await agent2.connect({
+        agentId: 'cleo-dev',
+        apiKey: 'sk_live_fake2',
+        apiBaseUrl: 'http://localhost',
+      });
+
+      // 3. Agent 1 sends a message to Agent 2
+      const sendResult = await agent1.push(
+        'cleo-dev',
+        '/action @cleo-dev #test Hello from rust-lead',
+      );
+      expect(sendResult.messageId).toBeDefined();
+
+      // 4. Agent 2 polls and receives the message
+      const messages = await agent2.poll();
+      expect(messages).toHaveLength(1);
+      expect(messages[0].from).toBe('cleo-rust-lead');
+      expect(messages[0].content).toContain('Hello from rust-lead');
+
+      // 5. Agent 2 acknowledges the message
+      await agent2.ack([messages[0].id]);
+
+      // 6. Subsequent poll returns empty (message was acked)
+      const afterAck = await agent2.poll();
+      expect(afterAck).toHaveLength(0);
+
+      // 7. Agent 2 replies
+      const replyResult = await agent2.push('cleo-rust-lead', '/ack Received.');
+      expect(replyResult.messageId).toBeDefined();
+
+      // 8. Agent 1 receives the reply
+      const replies = await agent1.poll();
+      expect(replies).toHaveLength(1);
+      expect(replies[0].from).toBe('cleo-dev');
+      expect(replies[0].content).toBe('/ack Received.');
+
+      // Cleanup
+      await agent1.disconnect();
+      await agent2.disconnect();
+    });
+
+    it('messages persist across transport reconnections', async () => {
+      await ensureSignaldockDb(testDir);
+
+      // Send a message
+      const sender = new LocalTransport();
+      await sender.connect({
+        agentId: 'sender',
+        apiKey: 'sk_test',
+        apiBaseUrl: 'http://localhost',
+      });
+      await sender.push('receiver', 'persistent message');
+      await sender.disconnect();
+
+      // New transport instance reads the same DB
+      const receiver = new LocalTransport();
+      await receiver.connect({
+        agentId: 'receiver',
+        apiKey: 'sk_test',
+        apiBaseUrl: 'http://localhost',
+      });
+      const messages = await receiver.poll();
+      expect(messages).toHaveLength(1);
+      expect(messages[0].content).toBe('persistent message');
+
+      await receiver.disconnect();
+    });
+
+    it('multiple agents can communicate in the same conversation', async () => {
+      await ensureSignaldockDb(testDir);
+
+      const prime = new LocalTransport();
+      const rustLead = new LocalTransport();
+      const dbLead = new LocalTransport();
+
+      await prime.connect({ agentId: 'prime', apiKey: 'sk1', apiBaseUrl: 'http://localhost' });
+      await rustLead.connect({
+        agentId: 'rust-lead',
+        apiKey: 'sk2',
+        apiBaseUrl: 'http://localhost',
+      });
+      await dbLead.connect({ agentId: 'db-lead', apiKey: 'sk3', apiBaseUrl: 'http://localhost' });
+
+      // Prime sends to rust-lead
+      await prime.push('rust-lead', 'Fix cant-lsp');
+      // Prime sends to db-lead
+      await prime.push('db-lead', 'Review schemas');
+
+      // Each agent only sees their own messages
+      const rustMessages = await rustLead.poll();
+      const dbMessages = await dbLead.poll();
+
+      expect(rustMessages).toHaveLength(1);
+      expect(rustMessages[0].content).toBe('Fix cant-lsp');
+      expect(dbMessages).toHaveLength(1);
+      expect(dbMessages[0].content).toBe('Review schemas');
+
+      await prime.disconnect();
+      await rustLead.disconnect();
+      await dbLead.disconnect();
+    });
+  });
+});

package/src/conduit/__tests__/local-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.test.d.ts","sourceRoot":"","sources":["local-transport.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}