@olane/os 0.8.3 → 0.8.5

package/README.md

@@ -34,7 +34,7 @@ Think of OlaneOS as the orchestration layer that:
 ## Installation
 
 ```bash
-npm install @olane/os
+pnpm install @olane/os
 ```
 
 ### Peer Dependencies
@@ -42,7 +42,7 @@ npm install @olane/os
 OlaneOS requires the following peer dependencies:
 
 ```bash
-npm install @olane/o-core @olane/o-config @olane/o-protocol \
+pnpm install @olane/o-core @olane/o-config @olane/o-protocol \
   @olane/o-tool @olane/o-tools-common @olane/o-tool-registry \
   @olane/o-intelligence @olane/o-leader @olane/o-lane @olane/o-storage
 ```
@@ -77,7 +77,7 @@ const os = new OlaneOS({
 await os.start();
 
 // Use a node via the OS
-const result = await os.use(
+const response = await os.use(
   new oAddress('o://node'),
   {
     method: 'some_tool',
@@ -85,6 +85,13 @@ const result = await os.use(
   }
 );
 
+// Check response using the standard wrapping structure
+if (response.result.success) {
+  console.log('Data:', response.result.data);
+} else {
+  console.error('Error:', response.result.error);
+}
+
 // Stop the OS gracefully
 await os.stop();
 ```
@@ -177,9 +184,10 @@ OlaneOS uses round-robin routing to distribute requests across nodes:
 
 ```typescript
 // Requests are automatically load-balanced
-const result1 = await os.use(address, params); // → Node 1
-const result2 = await os.use(address, params); // → Node 2
-const result3 = await os.use(address, params); // → Node 1
+const response1 = await os.use(address, params); // → Node 1
+const response2 = await os.use(address, params); // → Node 2
+const response3 = await os.use(address, params); // → Node 1
+// Access data via response.result.data on each response
 ```
 
 This provides:
@@ -187,6 +195,40 @@ This provides:
 - **Fault tolerance** if nodes fail
 - **Scalability** by adding more node instances
 
+### Response Structure
+
+When calling tools via `os.use()`, responses follow a standard wrapped structure:
+
+```typescript
+{
+  jsonrpc: "2.0",
+  id: "request-id",
+  result: {
+    success: boolean,    // Whether the call succeeded
+    data: any,           // The return value on success
+    error?: string       // Error message on failure
+  }
+}
+```
+
+Always access response fields through the `result` property:
+
+```typescript
+const response = await os.use(address, {
+  method: 'some_method',
+  params: { /* ... */ }
+});
+
+// Check success
+if (response.result.success) {
+  const data = response.result.data;    // Access return value
+} else {
+  const error = response.result.error;  // Access error message
+}
+```
+
+> **Common mistake**: Accessing `response.success` or `response.data` directly will not work. Always use `response.result.success`, `response.result.data`, and `response.result.error`.
+
 ### Configuration Management
 
 OlaneOS supports two configuration approaches:
@@ -383,11 +425,22 @@ Routes a request to a node via the entry point router.
 - `address` - Target node address (e.g., `o://node/tool`)
 - `params` - Request parameters including method and params
 
-**Returns**: Result from the target node
+**Returns**: A wrapped response object with the following structure:
+```typescript
+{
+  jsonrpc: "2.0",
+  id: "request-id",
+  result: {
+    success: boolean,    // Whether the call succeeded
+    data: any,           // Response data on success
+    error?: string       // Error message on failure
+  }
+}
+```
 
 **Example**:
 ```typescript
-const result = await os.use(
+const response = await os.use(
   new oAddress('o://financial-analyst'),
   {
     method: 'intent',
@@ -396,6 +449,12 @@ const result = await os.use(
     }
   }
 );
+
+if (response.result.success) {
+  console.log('Analysis:', response.result.data);
+} else {
+  console.error('Failed:', response.result.error);
+}
 ```
 
 #### addNode()
@@ -941,7 +1000,6 @@ ISC © oLane Inc.
 
 ---
 
-**Package Version**: 0.6.12  
-**Last Updated**: October 1, 2025  
+**Package Version**: 0.8.3
 **Status**: Active development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/os",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -58,23 +58,23 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-client-limited": "0.8.3",
-    "@olane/o-config": "0.8.3",
-    "@olane/o-core": "0.8.3",
-    "@olane/o-intelligence": "0.8.3",
-    "@olane/o-lane": "0.8.3",
-    "@olane/o-leader": "0.8.3",
-    "@olane/o-login": "0.8.3",
-    "@olane/o-protocol": "0.8.3",
-    "@olane/o-storage": "0.8.3",
-    "@olane/o-tool": "0.8.3",
-    "@olane/o-tool-registry": "0.8.3",
-    "@olane/o-tools-common": "0.8.3",
+    "@olane/o-client-limited": "0.8.5",
+    "@olane/o-config": "0.8.5",
+    "@olane/o-core": "0.8.5",
+    "@olane/o-intelligence": "0.8.5",
+    "@olane/o-lane": "0.8.5",
+    "@olane/o-leader": "0.8.5",
+    "@olane/o-login": "0.8.5",
+    "@olane/o-protocol": "0.8.5",
+    "@olane/o-storage": "0.8.5",
+    "@olane/o-tool": "0.8.5",
+    "@olane/o-tool-registry": "0.8.5",
+    "@olane/o-tools-common": "0.8.5",
     "chalk": "^5.4.1",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0",
     "fs-extra": "^11.3.0",
     "touch": "^3.1.1"
   },
-  "gitHead": "189c0cf7b6dd9d5d961f5424af21d37978092d9e"
+  "gitHead": "e88f1e55dcc92d9a410d28200e4220697116f82f"
 }