@olane/o-lane 0.8.3 → 0.8.4

package/README.md

@@ -76,6 +76,39 @@ console.log(response.result.data);
 // }
 ```
 
+### Response Structure
+
+When calling `use()` on a lane-enabled tool, responses follow the standard O-Network wrapping structure:
+
+```typescript
+// Response from use() follows this structure:
+// {
+//   jsonrpc: "2.0",
+//   id: "request-id",
+//   result: {
+//     success: boolean,    // Whether the operation succeeded
+//     data: any,           // The returned data (on success)
+//     error?: string       // Error details (on failure)
+//   }
+// }
+
+const response = await agent.use(agent.address, {
+  method: 'intent',
+  params: { intent: 'Analyze sales data' }
+});
+
+// Always check response.result.success before accessing data
+if (response.result.success) {
+  const data = response.result.data;
+  console.log('Result:', data.result);
+  console.log('Cycles:', data.cycles);
+} else {
+  console.error('Error:', response.result.error);
+}
+```
+
+> **Important**: Access data via `response.result.data`, not `response.data` directly. The `result` object contains the wrapping fields (`success`, `data`, `error`).
+
 ### Expected Output
 
 After executing an intent, you'll receive:
@@ -338,6 +371,8 @@ import { oCapabilityEvaluate } from '@olane/o-lane';
 
 **When Used**: Agent needs to call a tool (API, database, computation, etc.)
 
+> **Note**: `oCapabilityExecute` is exported directly from `@olane/o-lane` and can be imported alongside other lane primitives.
+
 ```typescript
 import { oCapabilityExecute } from '@olane/o-lane';
 
@@ -696,7 +731,7 @@ Result object returned by capabilities.
 import { oCapabilityResult, oCapabilityType } from '@olane/o-lane';
 
 const result = new oCapabilityResult({
-  type: oCapabilityType.TASK,
+  type: oCapabilityType.EXECUTE,
   result: { data: 'success' },
   config: { /* next capability config */ },
   error: undefined
@@ -733,11 +768,11 @@ enum oLaneStatus {
 
 ```typescript
 enum oCapabilityType {
-  TASK = 'task',
+  TASK = 'task',           // Legacy alias - prefer EXECUTE for new code
   SEARCH = 'search',
   MULTIPLE_STEP = 'multiple_step',
   CONFIGURE = 'configure',
-  EXECUTE = 'execute',
+  EXECUTE = 'execute',     // Primary type for executing tool methods
   HANDSHAKE = 'handshake',
   EVALUATE = 'evaluate',
   STOP = 'stop',
@@ -745,6 +780,8 @@ enum oCapabilityType {
 }
 ```
 
+> **Note on TASK vs EXECUTE**: `TASK` is a legacy capability type that predates `EXECUTE`. For new code, prefer using `oCapabilityType.EXECUTE` which maps to the `oCapabilityExecute` capability class. Both exist in the enum for backward compatibility.
+
 ## Examples
 
 ### Basic Intent Resolution
@@ -1253,9 +1290,9 @@ describe('Lane Execution', () => {
 import { oCapability, oCapabilityResult, oCapabilityType } from '@olane/o-lane';
 
 // Create mock capability for testing
-class MockTaskCapability extends oCapability {
+class MockExecuteCapability extends oCapability {
   get type() {
-    return oCapabilityType.TASK;
+    return oCapabilityType.EXECUTE;
   }
 
   async run(): Promise<oCapabilityResult> {
@@ -1271,7 +1308,7 @@ class MockTaskCapability extends oCapability {
 it('should use mock capabilities', async () => {
   const mockCapabilities = [
     new oCapabilityEvaluate(),
-    new MockTaskCapability()
+    new MockExecuteCapability()
   ];
 
   const lane = await manager.createLane({

package/dist/src/index.d.ts

@@ -7,6 +7,7 @@ export * from './o-lane.tool.js';
 export * from './capabilities/index.js';
 export * from './intent/index.js';
 export * from './capabilities-all/o-capability.all.js';
+export * from './capabilities-execute/execute.capability.js';
 export * from './capabilities-evaluate/o-capability.evaluate.js';
 export * from './capabilities-multiple-step/o-capability.multiple-step.js';
 export * from './capabilities-search/o-capability.search.js';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wCAAwC,CAAC;AACvD,cAAc,kDAAkD,CAAC;AACjE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,8CAA8C,CAAC;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kDAAkD,CAAC;AACjE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,8CAA8C,CAAC;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -7,6 +7,7 @@ export * from './o-lane.tool.js';
 export * from './capabilities/index.js';
 export * from './intent/index.js';
 export * from './capabilities-all/o-capability.all.js';
+export * from './capabilities-execute/execute.capability.js';
 export * from './capabilities-evaluate/o-capability.evaluate.js';
 export * from './capabilities-multiple-step/o-capability.multiple-step.js';
 export * from './capabilities-search/o-capability.search.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-lane",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -36,7 +36,7 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.29.0",
-    "@olane/o-test": "0.8.3",
+    "@olane/o-test": "0.8.4",
     "@tsconfig/node20": "^20.1.6",
     "@types/handlebars": "^4.1.0",
     "@types/jest": "^30.0.0",
@@ -57,15 +57,15 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.8.3",
-    "@olane/o-core": "0.8.3",
-    "@olane/o-node": "0.8.3",
-    "@olane/o-protocol": "0.8.3",
-    "@olane/o-storage": "0.8.3",
-    "@olane/o-tool": "0.8.3",
+    "@olane/o-config": "0.8.4",
+    "@olane/o-core": "0.8.4",
+    "@olane/o-node": "0.8.4",
+    "@olane/o-protocol": "0.8.4",
+    "@olane/o-storage": "0.8.4",
+    "@olane/o-tool": "0.8.4",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0",
     "handlebars": "^4.7.8"
   },
-  "gitHead": "189c0cf7b6dd9d5d961f5424af21d37978092d9e"
+  "gitHead": "b53623b1ad4365133911722f80d5597a72b65bf2"
 }