@timmeck/brain-core 1.0.0 → 1.1.0

package/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: timmeck

package/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+        if: ${{ hashFiles('vitest.config.*', 'src/**/*.test.ts', 'tests/**/*.test.ts') != '' }}

package/dist/cross-brain/client.d.ts

@@ -0,0 +1,27 @@
+export interface BrainPeer {
+    name: string;
+    pipeName: string;
+}
+export declare class CrossBrainClient {
+    private selfName;
+    private peers;
+    constructor(selfName: string, peers?: BrainPeer[]);
+    /**
+     * Query a specific peer brain by name.
+     * Returns null if the peer is not available.
+     */
+    query(peerName: string, method: string, params?: unknown): Promise<unknown | null>;
+    /**
+     * Broadcast a query to all available peer brains.
+     * Returns results from all peers that responded.
+     */
+    broadcast(method: string, params?: unknown): Promise<{
+        name: string;
+        result: unknown;
+    }[]>;
+    /**
+     * Check which peer brains are currently running.
+     */
+    getAvailablePeers(): Promise<string[]>;
+    getPeerNames(): string[];
+}

package/dist/cross-brain/client.js

@@ -0,0 +1,84 @@
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+const DEFAULT_PEERS = [
+    { name: 'brain', pipeName: getPipeName('brain') },
+    { name: 'trading-brain', pipeName: getPipeName('trading-brain') },
+    { name: 'marketing-brain', pipeName: getPipeName('marketing-brain') },
+];
+export class CrossBrainClient {
+    selfName;
+    peers;
+    constructor(selfName, peers) {
+        this.selfName = selfName;
+        this.peers = (peers ?? DEFAULT_PEERS).filter(p => p.name !== selfName);
+    }
+    /**
+     * Query a specific peer brain by name.
+     * Returns null if the peer is not available.
+     */
+    async query(peerName, method, params) {
+        const peer = this.peers.find(p => p.name === peerName);
+        if (!peer)
+            return null;
+        const client = new IpcClient(peer.pipeName, 3000);
+        try {
+            await client.connect();
+            const result = await client.request(method, params);
+            return result;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            client.disconnect();
+        }
+    }
+    /**
+     * Broadcast a query to all available peer brains.
+     * Returns results from all peers that responded.
+     */
+    async broadcast(method, params) {
+        const results = [];
+        const promises = this.peers.map(async (peer) => {
+            const client = new IpcClient(peer.pipeName, 3000);
+            try {
+                await client.connect();
+                const result = await client.request(method, params);
+                results.push({ name: peer.name, result });
+            }
+            catch {
+                // Peer not available — skip
+            }
+            finally {
+                client.disconnect();
+            }
+        });
+        await Promise.all(promises);
+        return results;
+    }
+    /**
+     * Check which peer brains are currently running.
+     */
+    async getAvailablePeers() {
+        const available = [];
+        const checks = this.peers.map(async (peer) => {
+            const client = new IpcClient(peer.pipeName, 1000);
+            try {
+                await client.connect();
+                available.push(peer.name);
+            }
+            catch {
+                // Not available
+            }
+            finally {
+                client.disconnect();
+            }
+        });
+        await Promise.all(checks);
+        return available;
+    }
+    getPeerNames() {
+        return this.peers.map(p => p.name);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/cross-brain/client.js.map

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

package/dist/index.d.ts

@@ -16,3 +16,5 @@ export type { McpHttpServerOptions } from './mcp/http-server.js';
 export { c, baseIcons, header, keyValue, statusBadge, progressBar, divider, table, stripAnsi } from './cli/colors.js';
 export { BaseApiServer } from './api/server.js';
 export type { ApiServerOptions, RouteDefinition } from './api/server.js';
+export { CrossBrainClient } from './cross-brain/client.js';
+export type { BrainPeer } from './cross-brain/client.js';

package/dist/index.js

@@ -16,4 +16,6 @@ export { McpHttpServer } from './mcp/http-server.js';
 export { c, baseIcons, header, keyValue, statusBadge, progressBar, divider, table, stripAnsi } from './cli/colors.js';
 // ── API ────────────────────────────────────────────────────
 export { BaseApiServer } from './api/server.js';
+// ── Cross-Brain ────────────────────────────────────────────
+export { CrossBrainClient } from './cross-brain/client.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtH,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtH,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,8 @@
     "./mcp/server": "./dist/mcp/server.js",
     "./mcp/http-server": "./dist/mcp/http-server.js",
     "./cli/colors": "./dist/cli/colors.js",
-    "./api/server": "./dist/api/server.js"
+    "./api/server": "./dist/api/server.js",
+    "./cross-brain": "./dist/cross-brain/client.js"
   },
   "scripts": {
     "build": "tsc",

package/src/cross-brain/client.ts

@@ -0,0 +1,94 @@
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+
+export interface BrainPeer {
+  name: string;
+  pipeName: string;
+}
+
+const DEFAULT_PEERS: BrainPeer[] = [
+  { name: 'brain', pipeName: getPipeName('brain') },
+  { name: 'trading-brain', pipeName: getPipeName('trading-brain') },
+  { name: 'marketing-brain', pipeName: getPipeName('marketing-brain') },
+];
+
+export class CrossBrainClient {
+  private peers: BrainPeer[];
+
+  constructor(
+    private selfName: string,
+    peers?: BrainPeer[],
+  ) {
+    this.peers = (peers ?? DEFAULT_PEERS).filter(p => p.name !== selfName);
+  }
+
+  /**
+   * Query a specific peer brain by name.
+   * Returns null if the peer is not available.
+   */
+  async query(peerName: string, method: string, params?: unknown): Promise<unknown | null> {
+    const peer = this.peers.find(p => p.name === peerName);
+    if (!peer) return null;
+
+    const client = new IpcClient(peer.pipeName, 3000);
+    try {
+      await client.connect();
+      const result = await client.request(method, params);
+      return result;
+    } catch {
+      return null;
+    } finally {
+      client.disconnect();
+    }
+  }
+
+  /**
+   * Broadcast a query to all available peer brains.
+   * Returns results from all peers that responded.
+   */
+  async broadcast(method: string, params?: unknown): Promise<{ name: string; result: unknown }[]> {
+    const results: { name: string; result: unknown }[] = [];
+
+    const promises = this.peers.map(async (peer) => {
+      const client = new IpcClient(peer.pipeName, 3000);
+      try {
+        await client.connect();
+        const result = await client.request(method, params);
+        results.push({ name: peer.name, result });
+      } catch {
+        // Peer not available — skip
+      } finally {
+        client.disconnect();
+      }
+    });
+
+    await Promise.all(promises);
+    return results;
+  }
+
+  /**
+   * Check which peer brains are currently running.
+   */
+  async getAvailablePeers(): Promise<string[]> {
+    const available: string[] = [];
+
+    const checks = this.peers.map(async (peer) => {
+      const client = new IpcClient(peer.pipeName, 1000);
+      try {
+        await client.connect();
+        available.push(peer.name);
+      } catch {
+        // Not available
+      } finally {
+        client.disconnect();
+      }
+    });
+
+    await Promise.all(checks);
+    return available;
+  }
+
+  getPeerNames(): string[] {
+    return this.peers.map(p => p.name);
+  }
+}

package/src/index.ts

@@ -29,3 +29,7 @@ export { c, baseIcons, header, keyValue, statusBadge, progressBar, divider, tabl
 // ── API ────────────────────────────────────────────────────
 export { BaseApiServer } from './api/server.js';
 export type { ApiServerOptions, RouteDefinition } from './api/server.js';
+
+// ── Cross-Brain ────────────────────────────────────────────
+export { CrossBrainClient } from './cross-brain/client.js';
+export type { BrainPeer } from './cross-brain/client.js';