@shaykec/bridge 0.4.20 → 0.4.22

package/src/router.js

@@ -1,5 +1,5 @@
 /**
- * Event routing for ClaudeTeach bridge server.
+ * Event routing for Socrates bridge server.
  * Visual commands from plugin fan out to the best connected client.
  * User events from clients are stored for the plugin to poll.
  */
@@ -12,6 +12,7 @@ import {
   MSG_SYS_DISCONNECT,
   MSG_SYS_HEARTBEAT,
   MSG_EVENT_TERMINAL_COMMAND,
+  MSG_EVENT_PTY_OUTPUT,
   MSG_CHAT_SEND,
   MSG_CHAT_STOP,
 } from '@shaykec/shared';
@@ -237,6 +238,35 @@ export class EventRouter {
     this._enqueueEvent(envelope);
   }
 
+  /**
+   * Enqueue PTY output for the agent to observe.
+   * Debounced: accumulates chunks and flushes every 500ms to avoid flooding.
+   * @param {string} sessionId
+   * @param {string} data - Raw PTY output chunk
+   */
+  enqueuePtyEvent(sessionId, data) {
+    if (!this._ptyBuffers) this._ptyBuffers = new Map();
+    if (!this._ptyTimers) this._ptyTimers = new Map();
+
+    const existing = this._ptyBuffers.get(sessionId) || '';
+    this._ptyBuffers.set(sessionId, existing + data);
+
+    if (!this._ptyTimers.has(sessionId)) {
+      this._ptyTimers.set(sessionId, setTimeout(() => {
+        const buffered = this._ptyBuffers.get(sessionId) || '';
+        this._ptyBuffers.delete(sessionId);
+        this._ptyTimers.delete(sessionId);
+        if (buffered) {
+          const envelope = createEnvelope(MSG_EVENT_PTY_OUTPUT, {
+            sessionId,
+            output: buffered,
+          }, 'bridge');
+          this._enqueueEvent(envelope);
+        }
+      }, 500));
+    }
+  }
+
   /**
    * Add an event to the queue, trimming oldest if at capacity.
    * @param {object} envelope

package/src/router.test.js

@@ -1,5 +1,5 @@
 /**
- * Tests for ClaudeTeach bridge EventRouter.
+ * Tests for Socrates bridge EventRouter.
  */
 
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';

package/src/sdk-e2e.test.js

@@ -0,0 +1,101 @@
+/**
+ * SDK E2E tests — verify the bridge's Agent SDK configuration works end-to-end.
+ *
+ * These tests start a real bridge server and verify the SDK session
+ * creates properly, tools are loaded, and the teach flow works.
+ *
+ * Requires ANTHROPIC_API_KEY (or Claude SDK configured).
+ * Gated behind: the SDK being able to create a session (500 means SDK not available).
+ */
+
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { startServer } from './server.js';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PLUGIN_DIR = resolve(__dirname, '..', '..', 'plugin');
+
+let bridge, port, BASE_URL, sdkAvailable;
+
+async function postJson(path, body) {
+  const resp = await fetch(`${BASE_URL}${path}`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  });
+  const text = await resp.text();
+  let data;
+  try { data = JSON.parse(text); } catch { data = text; }
+  return { status: resp.status, data };
+}
+
+async function getJson(path) {
+  const resp = await fetch(`${BASE_URL}${path}`);
+  return { status: resp.status, data: await resp.json() };
+}
+
+beforeAll(async () => {
+  port = 20000 + Math.floor(Math.random() * 10000);
+  await new Promise((resolve) => {
+    bridge = startServer({
+      port,
+      pluginDir: PLUGIN_DIR,
+      onReady: () => resolve(),
+    });
+  });
+  BASE_URL = `http://localhost:${port}`;
+
+  const { status } = await postJson('/api/chat/start', {});
+  sdkAvailable = status === 200;
+});
+
+afterAll(() => {
+  if (bridge) bridge.close();
+});
+
+describe.skipIf(!sdkAvailable)('SDK E2E: Agent session with plugins', () => {
+  let sessionId;
+
+  it('creates a session with the Claude SDK', async () => {
+    const { status, data } = await postJson('/api/chat/start', {});
+    expect(status).toBe(200);
+    expect(data.sessionId).toBeDefined();
+    sessionId = data.sessionId;
+  });
+
+  it('session is listed in active sessions', async () => {
+    const { status, data } = await getJson('/api/chat/sessions');
+    expect(status).toBe(200);
+    expect(data.sessions.some(s => s.id === sessionId || s.sessionId === sessionId)).toBe(true);
+  });
+
+  it('can send a message and get a response', async () => {
+    if (!sessionId) return;
+
+    const { status, data } = await postJson('/api/chat/message', {
+      sessionId,
+      text: 'Say only the word "hello" and nothing else.',
+    });
+
+    expect(status).toBe(200);
+  }, 30000);
+
+  it('can stop the session', async () => {
+    if (!sessionId) return;
+
+    const { status } = await postJson('/api/chat/stop', { sessionId });
+    expect(status).toBe(200);
+  });
+});
+
+describe('SDK E2E: Agent config verification', () => {
+  it('bridge was created with agentServer', () => {
+    expect(bridge.agentServer).toBeDefined();
+  });
+
+  it('agentConfig includes systemPrompt via config', () => {
+    expect(bridge.agentServer).toBeDefined();
+  });
+});