@open1s/ezbos 1.3.0 → 1.3.2

package/README.md

@@ -315,6 +315,38 @@ const mcpTools = await started.listMcpTools();
 console.log(`MCP tools available: ${mcpTools.length}`);
 ```
 
+### MCP Status Callback
+
+Get real-time notifications when each MCP server connects or fails. Useful for UI status updates.
+
+```ts
+const agent = brain.agent('my-agent', {
+  onMcpStatus: (namespace, status, error) => {
+    console.log(`[MCP] ${namespace}: ${status}`);
+    // Update UI status indicator
+  },
+})
+  .with_mcp_process('files', 'npx', ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'])
+  .with_mcp_http('api', 'http://localhost:3000/mcp');
+
+const started = await agent.start();
+```
+
+Callback parameters:
+- `namespace` - MCP server name
+- `status` - `'connected'` | `'failed'`
+- `error` - error message string (only present when `status === 'failed'`)
+
+The build continues even if an MCP server fails — use the callback to track which ones succeeded or failed.
+
+Also works with `BrainOS.with()`:
+
+```ts
+const agent = await BrainOS.with('my-agent', {
+  onMcpStatus: (ns, s, e) => { /* ... */ },
+});
+```
+
 ## Skills
 
 Add domain-specific instructions to the system prompt.

package/dist/agent.d.ts

@@ -8,6 +8,7 @@ export interface JsContent {
     base64?: string;
     name?: string;
 }
+export type McpStatusCallback = (namespace: string, status: 'connected' | 'failed', error?: string) => void;
 export declare class AgentBuilder {
     private _inner;
     private _tools;
@@ -16,6 +17,7 @@ export declare class AgentBuilder {
     private _mcp;
     private _skillsDirs;
     private _inlineSkills;
+    private _onMcpStatus?;
     private _config;
     constructor(name: string, options?: {
         model?: string;
@@ -30,6 +32,7 @@ export declare class AgentBuilder {
         rateLimitCapacity?: number;
         rateLimitWindowSecs?: number;
         rateLimitMaxRetries?: number;
+        onMcpStatus?: McpStatusCallback;
     });
     with_model(model: string): this;
     with_baseUrl(url: string): this;
@@ -56,16 +59,16 @@ export declare class AgentBuilder {
     }): this;
     start(): Promise<Agent>;
     private rebuildAgentWithPrompt;
-    ask(prompt: string): Promise<string>;
-    runSimple(prompt: string): Promise<string>;
-    react(task: string): Promise<string>;
+    ask(prompt: string | Array<JsContent>): Promise<string>;
+    runSimple(prompt: string | Array<JsContent>): Promise<string>;
+    react(task: string | Array<JsContent>): Promise<string>;
     stop(): Promise<void>;
 }
 export declare class Agent {
     private _inner;
     constructor(_inner: jsbos.Agent);
     private _resolveContent;
-    run(task: string): Promise<string>;
+    run(task: string | Array<JsContent>): Promise<string>;
     ask(prompt: string | Array<JsContent>): Promise<string>;
     runSimple(prompt: string | Array<JsContent>): Promise<string>;
     react(task: string | Array<JsContent>): Promise<string>;

package/dist/agent.js

@@ -11,6 +11,7 @@ export class AgentBuilder {
     _mcp = [];
     _skillsDirs = [];
     _inlineSkills = [];
+    _onMcpStatus;
     _config;
     constructor(name, options = {}) {
         this._config = {
@@ -28,6 +29,7 @@ export class AgentBuilder {
             rateLimitWindowSecs: options.rateLimitWindowSecs,
             rateLimitMaxRetries: options.rateLimitMaxRetries,
         };
+        this._onMcpStatus = options.onMcpStatus;
     }
     with_model(model) {
         this._config.model = model;
@@ -159,11 +161,18 @@ export class AgentBuilder {
             }) : undefined);
         }
         for (const mcp of this._mcp) {
-            if (mcp.type === 'process' && mcp.command && mcp.args) {
-                await this._inner.addMcpServer(mcp.namespace, mcp.command, mcp.args);
+            try {
+                if (mcp.type === 'process' && mcp.command && mcp.args) {
+                    await this._inner.addMcpServer(mcp.namespace, mcp.command, mcp.args);
+                }
+                else if (mcp.type === 'http' && mcp.url) {
+                    await this._inner.addMcpServerHttp(mcp.namespace, mcp.url);
+                }
+                this._onMcpStatus?.(mcp.namespace, 'connected');
             }
-            else if (mcp.type === 'http' && mcp.url) {
-                await this._inner.addMcpServerHttp(mcp.namespace, mcp.url);
+            catch (err) {
+                this._onMcpStatus?.(mcp.namespace, 'failed', String(err));
+                console.warn(`[agent] MCP server "${mcp.namespace}" connection failed, skipping:`, err);
             }
         }
         let systemPrompt = this._config.systemPrompt || '';

package/dist/brainos.d.ts

@@ -1,9 +1,10 @@
 import * as jsbos from '@open1s/jsbos';
-import { AgentBuilder, Agent } from './agent.js';
+import { AgentBuilder, Agent, McpStatusCallback } from './agent.js';
 interface BrainOSOptions {
     model?: string;
     baseUrl?: string;
     apiKey?: string;
+    onMcpStatus?: McpStatusCallback;
 }
 interface BusOptions {
     mode?: string;
@@ -29,6 +30,7 @@ export declare class BrainOS {
         temperature?: number;
         timeoutSecs?: number;
         maxTokens?: number;
+        onMcpStatus?: McpStatusCallback;
     }): AgentBuilder;
     get bus(): jsbos.Bus;
     publish(topic: string, payload: any, isJson?: boolean): Promise<void>;

package/dist/brainos.js

@@ -47,11 +47,8 @@ export class BrainOS {
             throw new Error('BrainOS not started. Call start() first.');
         }
         return new AgentBuilder(name, {
-            ...this._options,
             ...options,
-            apiKey: options.apiKey || this._options.apiKey,
-            model: options.model || this._options.model,
-            baseUrl: options.baseUrl || this._options.baseUrl,
+            ...this._options,
         });
     }
     get bus() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open1s/ezbos",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Simple BrainOS - Easy wrapper for @open1s/jsbos",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@open1s/jsbos": "^2.3.0"
+    "@open1s/jsbos": "^2.3.2"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",

package/src/agent.ts

@@ -17,6 +17,8 @@ export interface JsContent {
 const DEFAULT_MODEL = 'nvidia/meta/llama-3.1-8b-instruct';
 const DEFAULT_BASE_URL = 'https://integrate.api.nvidia.com/v1';
 
+export type McpStatusCallback = (namespace: string, status: 'connected' | 'failed', error?: string) => void;
+
 export class AgentBuilder {
   private _inner: jsbos.Agent | null = null;
   private _tools: InternalToolDef[] = [];
@@ -25,6 +27,7 @@ export class AgentBuilder {
   private _mcp: Array<{ type: 'process' | 'http', namespace: string, command?: string, args?: string[], url?: string }> = [];
   private _skillsDirs: string[] = [];
   private _inlineSkills: SkillDef[] = [];
+  private _onMcpStatus?: McpStatusCallback;
   private _config: {
     name: string;
     model: string;
@@ -54,6 +57,7 @@ export class AgentBuilder {
     rateLimitCapacity?: number;
     rateLimitWindowSecs?: number;
     rateLimitMaxRetries?: number;
+    onMcpStatus?: McpStatusCallback;
   } = {}) {
     this._config = {
       name,
@@ -70,6 +74,7 @@ export class AgentBuilder {
       rateLimitWindowSecs: options.rateLimitWindowSecs,
       rateLimitMaxRetries: options.rateLimitMaxRetries,
     };
+    this._onMcpStatus = options.onMcpStatus;
   }
 
   with_model(model: string): this {
@@ -233,10 +238,16 @@ export class AgentBuilder {
     }
 
     for (const mcp of this._mcp) {
-      if (mcp.type === 'process' && mcp.command && mcp.args) {
-        await this._inner.addMcpServer(mcp.namespace, mcp.command, mcp.args);
-      } else if (mcp.type === 'http' && mcp.url) {
-        await this._inner.addMcpServerHttp(mcp.namespace, mcp.url);
+      try {
+        if (mcp.type === 'process' && mcp.command && mcp.args) {
+          await this._inner.addMcpServer(mcp.namespace, mcp.command, mcp.args);
+        } else if (mcp.type === 'http' && mcp.url) {
+          await this._inner.addMcpServerHttp(mcp.namespace, mcp.url);
+        }
+        this._onMcpStatus?.(mcp.namespace, 'connected');
+      } catch (err) {
+        this._onMcpStatus?.(mcp.namespace, 'failed', String(err));
+        console.warn(`[agent] MCP server "${mcp.namespace}" connection failed, skipping:`, err);
       }
     }
 
@@ -290,17 +301,17 @@ export class AgentBuilder {
     return newAgent;
   }
 
-  async ask(prompt: string): Promise<string> {
+  async ask(prompt: string | Array<JsContent>): Promise<string> {
     if (!this._inner) await this.start();
     return this._inner!.react(prompt);
   }
 
-  async runSimple(prompt: string): Promise<string> {
+  async runSimple(prompt: string | Array<JsContent>): Promise<string> {
     if (!this._inner) await this.start();
     return this._inner!.runSimple(prompt);
   }
 
-  async react(task: string): Promise<string> {
+  async react(task: string | Array<JsContent>): Promise<string> {
     if (!this._inner) await this.start();
     return this._inner!.react(task);
   }
@@ -344,7 +355,7 @@ export class Agent {
     return [{ type: 'text', text: String(input) }];
   }
 
-  async run(task: string): Promise<string> {
+  async run(task: string | Array<JsContent>): Promise<string> {
     return this._inner.runSimple(this._resolveContent(task) as any);
   }
 

package/src/brainos.ts

@@ -1,10 +1,11 @@
 import * as jsbos from '@open1s/jsbos';
-import { AgentBuilder, Agent } from './agent.js';
+import { AgentBuilder, Agent, McpStatusCallback } from './agent.js';
 
 interface BrainOSOptions {
   model?: string;
   baseUrl?: string;
   apiKey?: string;
+  onMcpStatus?: McpStatusCallback;
 }
 
 interface BusOptions {
@@ -73,16 +74,14 @@ export class BrainOS {
     temperature?: number;
     timeoutSecs?: number;
     maxTokens?: number;
+    onMcpStatus?: McpStatusCallback;
   } = {}): AgentBuilder {
     if (!this._started) {
       throw new Error('BrainOS not started. Call start() first.');
     }
     return new AgentBuilder(name, {
-      ...this._options,
       ...options,
-      apiKey: options.apiKey || this._options.apiKey,
-      model: options.model || this._options.model,
-      baseUrl: options.baseUrl || this._options.baseUrl,
+      ...this._options,
     });
   }