@open1s/jsbos 2.2.1 → 2.2.4

package/README.md

@@ -1,4 +1,4 @@
-# @open1s/jsbos
+# @open1s/jsbos — v2.2.4
 
 > BrainOS JavaScript/Node.js bindings — AI agent framework with ReAct engine
 
@@ -32,14 +32,47 @@ yarn add @open1s/jsbos
 
 ## Quick Start
 
+### Using BrainOS (recommended)
+
+```javascript
+import { BrainOS, ToolDef } from '@open1s/jsbos';
+
+async function main() {
+  const brain = new BrainOS();
+  await brain.start();
+
+  // Define a tool
+  const addTool = new ToolDef(
+    'add',
+    'Add two numbers',
+    (args) => args.a + args.b,
+    { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } }, required: ['a', 'b'] }
+  );
+
+  // Create and configure an agent
+  const agent = brain
+    .agent('assistant')
+    .register(addTool)
+    .start();
+
+  // Run the agent
+  const response = await agent.ask('What is 15 + 23?');
+  console.log(response);
+
+  await brain.stop();
+}
+
+main().catch(console.error);
+```
+
+### Using Agent directly (low-level)
+
 ```javascript
 import { Agent, Bus } from '@open1s/jsbos';
 
 async function main() {
-  // Create a message bus for inter-agent communication
   const bus = await Bus.create();
 
-  // Create an agent with LLM configuration
   const agent = await Agent.create({
     name: 'assistant',
     model: 'gpt-4',
@@ -50,26 +83,14 @@ async function main() {
     timeoutSecs: 120,
   }, bus);
 
-  // Register a custom tool
   await agent.addTool(
     'calculator',
     'Evaluate a mathematical expression',
-    JSON.stringify({
-      expression: { type: 'string', description: 'Math expression like 2 + 2' }
-    }),
-    JSON.stringify({
-      type: 'object',
-      properties: { expression: { type: 'string' } },
-      required: ['expression']
-    }),
-    (err, args) => {
-      // Tool implementation
-      const result = eval(args.expression);
-      return JSON.stringify({ result });
-    }
+    JSON.stringify({ expression: { type: 'string', description: 'Math expression' } }),
+    JSON.stringify({ type: 'object', properties: { expression: { type: 'string' } }, required: ['expression'] }),
+    (err, args) => JSON.stringify({ result: eval(args.expression) })
   );
 
-  // Run the agent with a task
   const response = await agent.runSimple('What is 15 * 23?');
   console.log(response);
 }
@@ -79,7 +100,103 @@ main().catch(console.error);
 
 ## API Reference
 
-### Agent
+### BrainOS (High-level API)
+
+The recommended way to use jsbos — manages bus lifecycle, config loading, and tool registry.
+
+#### `new BrainOS()` — Create a BrainOS instance
+
+```javascript
+const brain = new BrainOS();
+await brain.start();  // Loads config, starts bus, registers global tools
+```
+
+#### `brain.agent(name, options)` — Create an agent builder
+
+```javascript
+const agent = brain
+  .agent('assistant', { model: 'gpt-4', systemPrompt: 'Be helpful.' })
+  .register(myTool)           // Register a ToolDef
+  .hook(HookEvent.BeforeLlmCall, (err, ctx) => 'continue')
+  .plugin('my-plugin', { onLlmRequest: (req) => req })
+  .skillsFromDir('./skills')
+  .start();                   // Returns an AgentWrapper
+```
+
+#### `agent.ask(prompt)` — Ask a question
+
+```javascript
+const response = await agent.ask('What is 2+2?');
+```
+
+#### `agent.react(task)` — Run with ReAct reasoning
+
+```javascript
+const response = await agent.react('Find files modified in the last hour');
+```
+
+#### `agent.stream(task, onToken)` — Stream responses
+
+```javascript
+await agent.stream('Write a story', (token) => {
+  if (token.type === 'Text') process.stdout.write(token.text);
+  if (token.type === 'Done') console.log('\n[Done]');
+});
+```
+
+#### `agent.streamCollect(task)` — Collect all streaming tokens
+
+```javascript
+const tokens = await agent.streamCollect('List 3 colors');
+const text = tokens.filter(t => t.type === 'Text').map(t => t.text).join('');
+```
+
+#### `agent.runSimple(prompt)` — Simple task execution
+
+```javascript
+const response = await agent.runSimple('What is 100 * 100?');
+```
+
+#### `agent.stop()` — Stop the agent
+
+```javascript
+agent.stop();
+```
+
+#### `agent.metrics()` — Get performance metrics
+
+```javascript
+const m = agent.metrics();
+console.log(m.llmCallCount, m.totalInputTokens, m.totalOutputTokens);
+```
+
+#### `agent.session` — Session management
+
+```javascript
+const session = agent.session;
+const json = session.export();
+await session.saveFull('./session.json');
+await session.restoreFull('./session.json');
+session.compact(2, 500);  // keep 2 messages, max 500 chars summary
+session.clear();
+```
+
+### ToolDef
+
+Define tools with a clean declarative API.
+
+```javascript
+import { ToolDef } from '@open1s/jsbos';
+
+const addTool = new ToolDef(
+  'add',                                    // name
+  'Add two numbers',                        // description
+  (args) => args.a + args.b,                // handler
+  { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } }, required: ['a', 'b'] }  // schema
+);
+```
+
+### Agent (Low-level API)
 
 The core AI agent class with tool-calling and ReAct reasoning capabilities.
 
@@ -103,11 +220,6 @@ const agent = await Agent.create({
   // Circuit breaker
   circuitBreakerMaxFailures: 5,
   circuitBreakerCooldownSecs: 30,
-  // Context compaction (for long conversations)
-  contextCompactionThresholdTokens: 100000,
-  contextCompactionTriggerRatio: 0.8,
-  contextCompactionKeepRecentMessages: 10,
-  contextCompactionSummaryMaxTokens: 2000,
 }, bus);  // Optional: bus for RPC communication
 ```
 
@@ -284,10 +396,12 @@ agent.clearSessionContext();
 agent.saveSession('./session.json');
 agent.restoreSession('./session.json');
 
-// Compact message log for long conversations
+// Compact-message log for long conversations
 agent.compactMessageLog();
 ```
 
+### AgentWrapper (from BrainOS)
+
 ### Bus (Message Bus)
 
 Distributed message bus for inter-agent and process communication.
@@ -463,17 +577,22 @@ See the [examples](./examples/) directory for complete examples:
 
 | Example | Description |
 |---------|-------------|
-| `agent_demo.js` | Basic agent with tools |
+| `brainos_demo.js` | High-level BrainOS API |
+| `agent_demo.js` | Agent with tools |
 | `agent_mcp_demo.js` | Agent with MCP servers |
+| `agent_stream_demo.js` | Streaming responses |
+| `agent_metrics_demo.js` | Performance metrics |
+| `agent_skill_demo.js` | Agent skills from directory |
+| `agent_resilience_demo.js` | Rate limiting + circuit breaker |
 | `bus_demo.js` | Pub/sub messaging |
 | `caller_demo.js` | RPC pattern |
 | `query_demo.js` | Request/response queries |
 | `mcp_demo.js` | Standalone MCP client |
 | `mcp_http_demo.js` | HTTP MCP connections |
-| `agent_stream_demo.js` | Streaming responses |
 | `demo-hooks.js` | Lifecycle hooks |
 | `demo-plugins.js` | Plugin system |
 | `config_demo.js` | Configuration loading |
+| `elegant-api-examples.js` | Tools, plugins, hooks, streaming, session, skills |
 
 Run an example:
 ```bash
@@ -506,15 +625,18 @@ yarn format
 │                        JavaScript/Node.js                    │
 ├─────────────────────────────────────────────────────────────┤
 │  @open1s/jsbos (NAPI-RS bindings)                           │
-│  ┌─────────┐ ┌──────┐ ┌───────┐ ┌───────┐ ┌─────────────┐  │
-│  │  Agent  │ │ Bus  │ │ Hooks │ │Plugins│ │   MCP Client│  │
-│  └────┬────┘ └──┬───┘ └───┬───┘ └───┬───┘ └──────┬──────┘  │
-└───────┼────────┼─────────┼─────────┼────────────┼──────────┘
-        │        │         │         │            │
-        ▼        ▼         ▼         ▼            ▼
+│  ┌──────────┐ ┌──────────┐ ┌──────┐ ┌───────┐ ┌──────────┐ │
+│  │ BrainOS  │ │ToolDef   │ │ Bus  │ │ Hooks │ │McpClient │ │
+│  └────┬─────┘ └────┬─────┘ └──┬───┘ └───┬───┘ └────┬─────┘ │
+│       │            │           │         │            │       │
+│  ┌────┴────────────┴───────────┴─────────┴────────────┴────┐ │
+│  │                    Agent                                │ │
+│  └────────────────────┬────────────────────────────────────┘ │
+└───────────────────────┼─────────────────────────────────────┘
+                        ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                    BrainOS (Rust Core)                       │
-│  agent/ │ bus/ │ hooks/ │ mcp/ │ plugin/ │ config/          │
+│  agent/ │ bus/ │ config/ │ logging/ │ react/ │ qserde/      │
 └─────────────────────────────────────────────────────────────┘
 ```
 

package/index.d.ts

@@ -170,11 +170,6 @@ export interface AgentConfig {
   rateLimitMaxRetries?: number
   rateLimitRetryBackoffSecs?: number
   rateLimitAutoWait?: boolean
-  contextCompactionThresholdTokens?: number
-  contextCompactionTriggerRatio?: number
-  contextCompactionKeepRecentMessages?: number
-  contextCompactionMaxSummaryChars?: number
-  contextCompactionSummaryMaxTokens?: number
 }
 
 export declare const enum BudgetStatus {
@@ -373,13 +368,14 @@ export class AgentBuilder {
     skillsFromDir(dirPath: any): this;
     mcp(namespace: any, command: any, args: any): this;
     mcpHttp(namespace: any, url: any): this;
-    start(): Promise<jsbos.Agent>;
+    start(): Promise<this>;
     ask(prompt: any): Promise<string>;
     react(task: any): Promise<string>;
     stream(task: any, onToken: any): Promise<string>;
     streamCollect(task: any): Promise<any[]>;
     stop(options?: {}): any;
     isRunning(): boolean;
+    get session(): SessionManager;
 }
 export function tool(descriptionOrOptions: any, maybeOptions?: {}): (target: any, propertyKey: any, descriptor: any) => any;
 export class ToolDef {

package/index.js

@@ -638,7 +638,7 @@ class AgentBuilder {
       }
     }
 
-    return this._inner;
+    return this;
   }
 
   async ask(prompt) {
@@ -646,6 +646,11 @@ class AgentBuilder {
     return this._inner.runSimple(prompt);
   }
 
+  async runSimple(prompt) {
+    if (!this._inner) await this.start();
+    return this._inner.runSimple(prompt);
+  }
+
   async react(task) {
     if (!this._inner) await this.start();
     return this._inner.react(task);
@@ -656,7 +661,7 @@ class AgentBuilder {
     return this._inner.stream(task, (err, token) => {
       if (err) {
         onToken({ type: 'Error', error: err.message || String(err) });
-      } else {
+      } else if (token) {
         onToken(token);
       }
     });
@@ -664,15 +669,20 @@ class AgentBuilder {
 
   async streamCollect(task) {
     const tokens = [];
-    await new Promise((resolve, reject) => {
-      this.stream(task, token => {
-        tokens.push(token);
-        if (token.type === 'Done' || token.type === 'Error' || token.type === 'Stopped') {
-          if (token.type === 'Error') reject(new Error(token.error));
-          else resolve();
-        }
+    try {
+      await new Promise((resolve, reject) => {
+        this.stream(task, token => {
+          if (!token) return;
+          tokens.push(token);
+          if (token.type === 'Done' || token.type === 'Error' || token.type === 'Stopped') {
+            if (token.type === 'Error') reject(new Error(token.error));
+            else resolve();
+          }
+        });
       });
-    });
+    } catch {
+      // Return whatever was collected before the error
+    }
     return tokens;
   }
 
@@ -686,6 +696,11 @@ class AgentBuilder {
     if (!this._inner) return false;
     return this._inner.isRunning();
   }
+
+  get session() {
+    if (!this._inner) throw new Error('Agent not started');
+    return new SessionManager(this._inner);
+  }
 }
 
 class AgentWrapperClass {
@@ -723,15 +738,20 @@ class AgentWrapperClass {
 
   async streamCollect(task) {
     const tokens = [];
-    await new Promise((resolve, reject) => {
-      this.stream(task, token => {
-        tokens.push(token);
-        if (token.type === 'Done' || token.type === 'Error' || token.type === 'Stopped') {
-          if (token.type === 'Error') reject(new Error(token.error));
-          else resolve();
-        }
+    try {
+      await new Promise((resolve, reject) => {
+        this.stream(task, token => {
+          if (!token) return;
+          tokens.push(token);
+          if (token.type === 'Done' || token.type === 'Error' || token.type === 'Stopped') {
+            if (token.type === 'Error') reject(new Error(token.error));
+            else resolve();
+          }
+        });
       });
-    });
+    } catch {
+      // Return whatever was collected before the error
+    }
     return tokens;
   }
 

package/jsbos.d.ts

@@ -172,11 +172,6 @@ export interface AgentConfig {
   rateLimitMaxRetries?: number
   rateLimitRetryBackoffSecs?: number
   rateLimitAutoWait?: boolean
-  contextCompactionThresholdTokens?: number
-  contextCompactionTriggerRatio?: number
-  contextCompactionKeepRecentMessages?: number
-  contextCompactionMaxSummaryChars?: number
-  contextCompactionSummaryMaxTokens?: number
 }
 
 export declare const enum BudgetStatus {

package/jsbos.js

@@ -81,8 +81,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-android-arm64')
         const bindingPackageVersion = require('@open1s/jsbos-android-arm64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -97,8 +97,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-android-arm-eabi')
         const bindingPackageVersion = require('@open1s/jsbos-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -118,8 +118,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-win32-x64-gnu')
         const bindingPackageVersion = require('@open1s/jsbos-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -134,8 +134,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-win32-x64-msvc')
         const bindingPackageVersion = require('@open1s/jsbos-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -151,8 +151,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-win32-ia32-msvc')
         const bindingPackageVersion = require('@open1s/jsbos-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-win32-arm64-msvc')
         const bindingPackageVersion = require('@open1s/jsbos-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -186,8 +186,8 @@ function requireNative() {
     try {
       const binding = require('@open1s/jsbos-darwin-universal')
       const bindingPackageVersion = require('@open1s/jsbos-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -202,8 +202,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-darwin-x64')
         const bindingPackageVersion = require('@open1s/jsbos-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -218,8 +218,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-darwin-arm64')
         const bindingPackageVersion = require('@open1s/jsbos-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -238,8 +238,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-freebsd-x64')
         const bindingPackageVersion = require('@open1s/jsbos-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -254,8 +254,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-freebsd-arm64')
         const bindingPackageVersion = require('@open1s/jsbos-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -275,8 +275,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-x64-musl')
           const bindingPackageVersion = require('@open1s/jsbos-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -291,8 +291,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-x64-gnu')
           const bindingPackageVersion = require('@open1s/jsbos-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -309,8 +309,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-arm64-musl')
           const bindingPackageVersion = require('@open1s/jsbos-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -325,8 +325,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-arm64-gnu')
           const bindingPackageVersion = require('@open1s/jsbos-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -343,8 +343,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-arm-musleabihf')
           const bindingPackageVersion = require('@open1s/jsbos-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -359,8 +359,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@open1s/jsbos-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -377,8 +377,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-loong64-musl')
           const bindingPackageVersion = require('@open1s/jsbos-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -393,8 +393,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-loong64-gnu')
           const bindingPackageVersion = require('@open1s/jsbos-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -411,8 +411,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-riscv64-musl')
           const bindingPackageVersion = require('@open1s/jsbos-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -427,8 +427,8 @@ function requireNative() {
         try {
           const binding = require('@open1s/jsbos-linux-riscv64-gnu')
           const bindingPackageVersion = require('@open1s/jsbos-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -444,8 +444,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-linux-ppc64-gnu')
         const bindingPackageVersion = require('@open1s/jsbos-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -460,8 +460,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-linux-s390x-gnu')
         const bindingPackageVersion = require('@open1s/jsbos-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -480,8 +480,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-openharmony-arm64')
         const bindingPackageVersion = require('@open1s/jsbos-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -496,8 +496,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-openharmony-x64')
         const bindingPackageVersion = require('@open1s/jsbos-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -512,8 +512,8 @@ function requireNative() {
       try {
         const binding = require('@open1s/jsbos-openharmony-arm')
         const bindingPackageVersion = require('@open1s/jsbos-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '2.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.2.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.2.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open1s/jsbos",
-  "version": "2.2.1",
+  "version": "2.2.4",
   "type": "module",
   "description": "BrainOS — multi-language AI agent framework. Agents, tools, event bus, MCP, skills, memory — for Node.js.",
   "main": "./index.js",
@@ -127,10 +127,10 @@
   },
   "packageManager": "yarn@4.13.0",
   "optionalDependencies": {
-    "@open1s/jsbos-darwin-arm64": "2.2.1",
-    "@open1s/jsbos-linux-arm64-gnu": "2.2.1",
-    "@open1s/jsbos-linux-x64-gnu": "2.2.1",
-    "@open1s/jsbos-win32-arm64-msvc": "2.2.1",
-    "@open1s/jsbos-win32-x64-msvc": "2.2.1"
+    "@open1s/jsbos-linux-x64-gnu": "2.2.4",
+    "@open1s/jsbos-win32-x64-msvc": "2.2.4",
+    "@open1s/jsbos-darwin-arm64": "2.2.4",
+    "@open1s/jsbos-linux-arm64-gnu": "2.2.4",
+    "@open1s/jsbos-win32-arm64-msvc": "2.2.4"
   }
 }