@olane/o-lane 0.7.12-alpha.57 → 0.7.12-alpha.59

package/dist/src/capabilities/enums/o-capability.type-enum.d.ts

@@ -6,6 +6,7 @@ export declare enum oCapabilityType {
     HANDSHAKE = "handshake",
     EVALUATE = "evaluate",
     STOP = "stop",
+    ERROR = "error",
     UNKNOWN = "unknown"
 }
 //# sourceMappingURL=o-capability.type-enum.d.ts.map

package/dist/src/capabilities/enums/o-capability.type-enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-capability.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/enums/o-capability.type-enum.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB"}
+{"version":3,"file":"o-capability.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/enums/o-capability.type-enum.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;CACpB"}

package/dist/src/capabilities/enums/o-capability.type-enum.js

@@ -7,5 +7,6 @@ export var oCapabilityType;
     oCapabilityType["HANDSHAKE"] = "handshake";
     oCapabilityType["EVALUATE"] = "evaluate";
     oCapabilityType["STOP"] = "stop";
+    oCapabilityType["ERROR"] = "error";
     oCapabilityType["UNKNOWN"] = "unknown";
 })(oCapabilityType || (oCapabilityType = {}));

package/dist/src/capabilities/o-capability.intelligence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-capability.intelligence.d.ts","sourceRoot":"","sources":["../../../src/capabilities/o-capability.intelligence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,8BAAsB,uBAAwB,SAAQ,WAAW;IACzD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAqD3E"}
+{"version":3,"file":"o-capability.intelligence.d.ts","sourceRoot":"","sources":["../../../src/capabilities/o-capability.intelligence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,8BAAsB,uBAAwB,SAAQ,WAAW;IACzD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAoE3E"}

package/dist/src/capabilities/o-capability.intelligence.js

@@ -33,10 +33,23 @@ export class oCapabilityIntelligence extends oCapability {
             }
             // Use the parsed result value if available, otherwise fall back to full message
             const processedResult = RegexUtils.extractResultFromAI(message);
+            // Extract structured fields from AI response
+            // The AI returns JSON with fields like: type, summary, reasoning, result, etc.
+            const { type, summary, reasoning, ...rest } = processedResult;
             return new oCapabilityIntelligenceResult({
-                result: processedResult,
-                type: processedResult.type,
-                config: this.config,
+                result: processedResult, // Keep full result for backwards compatibility
+                humanResult: processedResult.result, // AI-generated result is already human-readable
+                type: type || oCapabilityType.EVALUATE,
+                config: {
+                    ...this.config,
+                    // Preserve summary and reasoning in params for access
+                    params: {
+                        ...this.config.params,
+                        ...processedResult, // Store full AI response in params
+                        summary,
+                        reasoning,
+                    },
+                },
                 error: undefined,
             });
         }

package/dist/src/capabilities/o-capability.result.d.ts

@@ -16,6 +16,7 @@ export declare class oCapabilityResult implements oCapabilityResultInterface {
     toJSON(): {
         id: string;
         result: any;
+        humanResult: any;
         type: oCapabilityType;
         error: string | undefined;
         shouldPersist: boolean | undefined;

package/dist/src/capabilities/o-capability.result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-capability.result.d.ts","sourceRoot":"","sources":["../../../src/capabilities/o-capability.result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+EAA+E,CAAC;AAC9H,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,qBAAa,iBAAkB,YAAW,0BAA0B;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EACH,uBAAuB,GACvB,6BAA6B,GAC7B,qBAAqB,GACrB,GAAG,CAAC;IACR,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;gBAEZ,MAAM,EAAE,0BAA0B;IAU9C,MAAM;;;;;;;;;;;;IAeN,QAAQ;CAGT"}
+{"version":3,"file":"o-capability.result.d.ts","sourceRoot":"","sources":["../../../src/capabilities/o-capability.result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+EAA+E,CAAC;AAC9H,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,qBAAa,iBAAkB,YAAW,0BAA0B;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EACH,uBAAuB,GACvB,6BAA6B,GAC7B,qBAAqB,GACrB,GAAG,CAAC;IACR,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;gBAEZ,MAAM,EAAE,0BAA0B;IAU9C,MAAM;;;;;;;;;;;;;IAgBN,QAAQ;CAGT"}

package/dist/src/capabilities/o-capability.result.js

@@ -14,6 +14,7 @@ export class oCapabilityResult {
         return {
             id: this.id,
             result: this.result,
+            humanResult: this.humanResult, // Include human-readable result in serialization
             type: this.type,
             error: this.error,
             shouldPersist: this.shouldPersist,

package/dist/src/capabilities-multiple-step/o-capability.multiple-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-capability.multiple-step.d.ts","sourceRoot":"","sources":["../../../src/capabilities-multiple-step/o-capability.multiple-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAElG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,qBAAa,uBAAwB,SAAQ,uBAAuB;IAC3D,MAAM,EAAG,6BAA6B,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAiC;IAEjD,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,MAAM,KAAK,IAAI,oBAEd;IAED,IAAI,OAAO,IAAI,OAAO,EAAE,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAsBvC,MAAM;CAKP"}
+{"version":3,"file":"o-capability.multiple-step.d.ts","sourceRoot":"","sources":["../../../src/capabilities-multiple-step/o-capability.multiple-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAElG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,qBAAa,uBAAwB,SAAQ,uBAAuB;IAC3D,MAAM,EAAG,6BAA6B,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAiC;IAEjD,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,MAAM,KAAK,IAAI,oBAEd;IAED,IAAI,OAAO,IAAI,OAAO,EAAE,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAuBvC,MAAM;CAKP"}

package/dist/src/capabilities-search/o-capability.search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-capability.search.d.ts","sourceRoot":"","sources":["../../../src/capabilities-search/o-capability.search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,qBAAa,iBAAkB,SAAQ,WAAW;IACzC,MAAM,EAAG,uBAAuB,CAAC;IAExC,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,MAAM,KAAK,IAAI,oBAEd;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAEjD;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BtD;;OAEG;YACW,cAAc;YA0Bd,gBAAgB;IAmC9B;;OAEG;YACW,cAAc;IAuBtB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAOxC"}
+{"version":3,"file":"o-capability.search.d.ts","sourceRoot":"","sources":["../../../src/capabilities-search/o-capability.search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,qBAAa,iBAAkB,SAAQ,WAAW;IACzC,MAAM,EAAG,uBAAuB,CAAC;IAExC,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,MAAM,KAAK,IAAI,oBAEd;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAEjD;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BtD;;OAEG;YACW,cAAc;YA0Bd,gBAAgB;IAmC9B;;OAEG;YACW,cAAc;IAwBtB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAOxC"}

package/dist/src/capabilities-search/o-capability.search.js

@@ -112,7 +112,7 @@ export class oCapabilitySearch extends oCapability {
         searchResultContext += `[Search Results End]`;
         return new oCapabilitySearchResult({
             result: searchResultContext,
-            humanResult: searchResults?.flat() || [],
+            humanResult: searchResults,
             type: oCapabilityType.EVALUATE,
             config: this.config,
         });

package/dist/src/errors/capability-errors.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Structured error types for capability execution
+ */
+export declare enum CapabilityErrorType {
+    NOT_FOUND = "not_found",
+    UNAUTHORIZED = "unauthorized",
+    FORBIDDEN = "forbidden",
+    INVALID_CONFIG = "invalid_config",
+    MISSING_PARAMETER = "missing_parameter",
+    INVALID_PARAMETER = "invalid_parameter",
+    TOOL_ERROR = "tool_error",
+    TIMEOUT = "timeout",
+    NETWORK_ERROR = "network_error",
+    INVALID_STATE = "invalid_state",
+    RESOURCE_EXHAUSTED = "resource_exhausted",
+    UNKNOWN = "unknown"
+}
+/**
+ * Context information for capability errors
+ */
+export interface CapabilityErrorContext {
+    /** The cycle number where the error occurred */
+    cycle?: number;
+    /** The capability type that failed */
+    capabilityType?: string;
+    /** The tool address that was being used */
+    toolAddress?: string;
+    /** The method that was being called */
+    method?: string;
+    /** Additional context data */
+    data?: any;
+    /** The user's original intent */
+    intent?: string;
+}
+/**
+ * Structured capability error with context and remediation suggestions
+ */
+export declare class CapabilityError extends Error {
+    readonly type: CapabilityErrorType;
+    readonly context: CapabilityErrorContext;
+    readonly originalError?: Error;
+    constructor(type: CapabilityErrorType, message: string, context?: CapabilityErrorContext, originalError?: Error);
+    /**
+     * Get a human-readable error message with context
+     */
+    toHumanReadable(): string;
+    /**
+     * Get a friendly label for the error type
+     */
+    private getErrorTypeLabel;
+    /**
+     * Get remediation suggestion based on error type
+     */
+    private getRemediation;
+    /**
+     * Convert to JSON for serialization
+     */
+    toJSON(): {
+        name: string;
+        type: CapabilityErrorType;
+        message: string;
+        context: CapabilityErrorContext;
+        humanReadable: string;
+        stack: string | undefined;
+    };
+    /**
+     * Create a CapabilityError from a generic error
+     */
+    static from(error: Error | any, context?: CapabilityErrorContext): CapabilityError;
+}
+//# sourceMappingURL=capability-errors.d.ts.map

package/dist/src/errors/capability-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/capability-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,mBAAmB;IAE7B,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IAGvB,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IAGvC,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAG/B,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IAGzC,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,OAAO,EAAE,sBAAsB,CAAC;IAChD,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAGpC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,EACpC,aAAa,CAAC,EAAE,KAAK;IAcvB;;OAEG;IACH,eAAe,IAAI,MAAM;IA2BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,MAAM;;;;;;;;IAWN;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,KAAK,GAAG,GAAG,EAClB,OAAO,GAAE,sBAA2B,GACnC,eAAe;CA8BnB"}

package/dist/src/errors/capability-errors.js

@@ -0,0 +1,142 @@
+/**
+ * Structured error types for capability execution
+ */
+export var CapabilityErrorType;
+(function (CapabilityErrorType) {
+    // Tool/Resource errors
+    CapabilityErrorType["NOT_FOUND"] = "not_found";
+    CapabilityErrorType["UNAUTHORIZED"] = "unauthorized";
+    CapabilityErrorType["FORBIDDEN"] = "forbidden";
+    // Configuration errors
+    CapabilityErrorType["INVALID_CONFIG"] = "invalid_config";
+    CapabilityErrorType["MISSING_PARAMETER"] = "missing_parameter";
+    CapabilityErrorType["INVALID_PARAMETER"] = "invalid_parameter";
+    // Execution errors
+    CapabilityErrorType["TOOL_ERROR"] = "tool_error";
+    CapabilityErrorType["TIMEOUT"] = "timeout";
+    CapabilityErrorType["NETWORK_ERROR"] = "network_error";
+    // State errors
+    CapabilityErrorType["INVALID_STATE"] = "invalid_state";
+    CapabilityErrorType["RESOURCE_EXHAUSTED"] = "resource_exhausted";
+    // Unknown
+    CapabilityErrorType["UNKNOWN"] = "unknown";
+})(CapabilityErrorType || (CapabilityErrorType = {}));
+/**
+ * Structured capability error with context and remediation suggestions
+ */
+export class CapabilityError extends Error {
+    constructor(type, message, context = {}, originalError) {
+        super(message);
+        this.name = 'CapabilityError';
+        this.type = type;
+        this.context = context;
+        this.originalError = originalError;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CapabilityError);
+        }
+    }
+    /**
+     * Get a human-readable error message with context
+     */
+    toHumanReadable() {
+        let message = `${this.getErrorTypeLabel()}: ${this.message}`;
+        if (this.context.cycle !== undefined) {
+            message += `\n\nOccurred in Cycle ${this.context.cycle}`;
+        }
+        if (this.context.capabilityType) {
+            message += `\nCapability: ${this.context.capabilityType}`;
+        }
+        if (this.context.toolAddress) {
+            message += `\nTool: ${this.context.toolAddress}`;
+        }
+        if (this.context.method) {
+            message += `\nMethod: ${this.context.method}`;
+        }
+        const remediation = this.getRemediation();
+        if (remediation) {
+            message += `\n\nSuggestion: ${remediation}`;
+        }
+        return message;
+    }
+    /**
+     * Get a friendly label for the error type
+     */
+    getErrorTypeLabel() {
+        const labels = {
+            [CapabilityErrorType.NOT_FOUND]: 'Resource Not Found',
+            [CapabilityErrorType.UNAUTHORIZED]: 'Unauthorized',
+            [CapabilityErrorType.FORBIDDEN]: 'Forbidden',
+            [CapabilityErrorType.INVALID_CONFIG]: 'Invalid Configuration',
+            [CapabilityErrorType.MISSING_PARAMETER]: 'Missing Parameter',
+            [CapabilityErrorType.INVALID_PARAMETER]: 'Invalid Parameter',
+            [CapabilityErrorType.TOOL_ERROR]: 'Tool Execution Error',
+            [CapabilityErrorType.TIMEOUT]: 'Timeout',
+            [CapabilityErrorType.NETWORK_ERROR]: 'Network Error',
+            [CapabilityErrorType.INVALID_STATE]: 'Invalid State',
+            [CapabilityErrorType.RESOURCE_EXHAUSTED]: 'Resource Exhausted',
+            [CapabilityErrorType.UNKNOWN]: 'Unknown Error',
+        };
+        return labels[this.type] || 'Error';
+    }
+    /**
+     * Get remediation suggestion based on error type
+     */
+    getRemediation() {
+        const remediations = {
+            [CapabilityErrorType.NOT_FOUND]: 'Verify the tool address exists and is accessible. Use search to find available tools.',
+            [CapabilityErrorType.UNAUTHORIZED]: 'Check that you have the necessary permissions to access this resource.',
+            [CapabilityErrorType.INVALID_CONFIG]: 'Review the configuration parameters and ensure they match the required format.',
+            [CapabilityErrorType.MISSING_PARAMETER]: 'Provide all required parameters. Use the tool\'s handshake to see parameter requirements.',
+            [CapabilityErrorType.INVALID_PARAMETER]: 'Check that parameter values match the expected types and constraints.',
+            [CapabilityErrorType.TOOL_ERROR]: 'Review the tool\'s error message and adjust your request accordingly.',
+            [CapabilityErrorType.TIMEOUT]: 'The operation took too long. Try simplifying the request or increasing the timeout.',
+            [CapabilityErrorType.NETWORK_ERROR]: 'Check your network connection and try again.',
+            [CapabilityErrorType.RESOURCE_EXHAUSTED]: 'You may have hit a rate limit or resource quota. Try again later.',
+        };
+        return remediations[this.type] || null;
+    }
+    /**
+     * Convert to JSON for serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            type: this.type,
+            message: this.message,
+            context: this.context,
+            humanReadable: this.toHumanReadable(),
+            stack: this.stack,
+        };
+    }
+    /**
+     * Create a CapabilityError from a generic error
+     */
+    static from(error, context = {}) {
+        if (error instanceof CapabilityError) {
+            return error;
+        }
+        // Try to infer error type from message
+        let type = CapabilityErrorType.UNKNOWN;
+        const message = error?.message || String(error);
+        if (message.includes('not found') || message.includes('404')) {
+            type = CapabilityErrorType.NOT_FOUND;
+        }
+        else if (message.includes('unauthorized') || message.includes('401')) {
+            type = CapabilityErrorType.UNAUTHORIZED;
+        }
+        else if (message.includes('forbidden') || message.includes('403')) {
+            type = CapabilityErrorType.FORBIDDEN;
+        }
+        else if (message.includes('timeout')) {
+            type = CapabilityErrorType.TIMEOUT;
+        }
+        else if (message.includes('network') || message.includes('ECONNREFUSED')) {
+            type = CapabilityErrorType.NETWORK_ERROR;
+        }
+        else if (message.includes('parameter') || message.includes('config')) {
+            type = CapabilityErrorType.INVALID_CONFIG;
+        }
+        return new CapabilityError(type, message, context, error instanceof Error ? error : undefined);
+    }
+}

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

@@ -0,0 +1,5 @@
+/**
+ * Error handling exports
+ */
+export { CapabilityError, CapabilityErrorType, type CapabilityErrorContext, } from './capability-errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/src/errors/index.js

@@ -0,0 +1,4 @@
+/**
+ * Error handling exports
+ */
+export { CapabilityError, CapabilityErrorType, } from './capability-errors.js';

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

@@ -0,0 +1,7 @@
+/**
+ * Utilities for programmatic markdown generation
+ * Used only for system-generated content like execution traces
+ * AI-generated responses handle their own formatting via prompts
+ */
+export { MarkdownBuilder } from './markdown-builder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/formatters/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utilities for programmatic markdown generation
+ * Used only for system-generated content like execution traces
+ * AI-generated responses handle their own formatting via prompts
+ */
+export { MarkdownBuilder } from './markdown-builder.js';

package/dist/src/formatters/markdown-builder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Utility class for building markdown formatted strings
+ * Used for programmatic content generation (execution traces, etc.)
+ * NOT used for AI-generated responses - AI handles its own formatting
+ */
+export declare class MarkdownBuilder {
+    private parts;
+    /**
+     * Add a header
+     */
+    header(text: string, level?: number): this;
+    /**
+     * Add a paragraph
+     */
+    paragraph(text: string): this;
+    /**
+     * Add a bulleted list
+     */
+    list(items: string[], ordered?: boolean): this;
+    /**
+     * Add a code block
+     */
+    code(content: string, language?: string): this;
+    /**
+     * Add inline code
+     */
+    inline(text: string): string;
+    /**
+     * Add bold text
+     */
+    bold(text: string): string;
+    /**
+     * Add italic text
+     */
+    italic(text: string): string;
+    /**
+     * Add a link
+     */
+    link(text: string, url: string): string;
+    /**
+     * Add a collapsible details section
+     */
+    details(summary: string, content: string): this;
+    /**
+     * Add a horizontal rule
+     */
+    hr(): this;
+    /**
+     * Add raw text without additional spacing
+     */
+    raw(text: string): this;
+    /**
+     * Add a line break
+     */
+    br(): this;
+    /**
+     * Build the final markdown string
+     */
+    build(): string;
+    /**
+     * Create a new builder instance
+     */
+    static create(): MarkdownBuilder;
+}
+//# sourceMappingURL=markdown-builder.d.ts.map

package/dist/src/formatters/markdown-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-builder.d.ts","sourceRoot":"","sources":["../../../src/formatters/markdown-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAE7B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAO7C;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;IASrD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,IAAI;IAQlD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU/C;;OAEG;IACH,EAAE,IAAI,IAAI;IAMV;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB;;OAEG;IACH,EAAE,IAAI,IAAI;IAKV;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,eAAe;CAGjC"}

package/dist/src/formatters/markdown-builder.js

@@ -0,0 +1,120 @@
+/**
+ * Utility class for building markdown formatted strings
+ * Used for programmatic content generation (execution traces, etc.)
+ * NOT used for AI-generated responses - AI handles its own formatting
+ */
+export class MarkdownBuilder {
+    constructor() {
+        this.parts = [];
+    }
+    /**
+     * Add a header
+     */
+    header(text, level = 1) {
+        const prefix = '#'.repeat(Math.max(1, Math.min(6, level)));
+        this.parts.push(`${prefix} ${text}`);
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Add a paragraph
+     */
+    paragraph(text) {
+        if (text) {
+            this.parts.push(text);
+            this.parts.push('');
+        }
+        return this;
+    }
+    /**
+     * Add a bulleted list
+     */
+    list(items, ordered = false) {
+        items.forEach((item, idx) => {
+            const prefix = ordered ? `${idx + 1}. ` : '- ';
+            this.parts.push(`${prefix}${item}`);
+        });
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Add a code block
+     */
+    code(content, language = '') {
+        this.parts.push(`\`\`\`${language}`);
+        this.parts.push(content);
+        this.parts.push('```');
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Add inline code
+     */
+    inline(text) {
+        return `\`${text}\``;
+    }
+    /**
+     * Add bold text
+     */
+    bold(text) {
+        return `**${text}**`;
+    }
+    /**
+     * Add italic text
+     */
+    italic(text) {
+        return `*${text}*`;
+    }
+    /**
+     * Add a link
+     */
+    link(text, url) {
+        return `[${text}](${url})`;
+    }
+    /**
+     * Add a collapsible details section
+     */
+    details(summary, content) {
+        this.parts.push('<details>');
+        this.parts.push(`<summary>${summary}</summary>`);
+        this.parts.push('');
+        this.parts.push(content);
+        this.parts.push('</details>');
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Add a horizontal rule
+     */
+    hr() {
+        this.parts.push('---');
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Add raw text without additional spacing
+     */
+    raw(text) {
+        this.parts.push(text);
+        return this;
+    }
+    /**
+     * Add a line break
+     */
+    br() {
+        this.parts.push('');
+        return this;
+    }
+    /**
+     * Build the final markdown string
+     */
+    build() {
+        return this.parts.join('\n').trim();
+    }
+    /**
+     * Create a new builder instance
+     */
+    static create() {
+        return new MarkdownBuilder();
+    }
+}

package/dist/src/o-lane.d.ts

@@ -28,6 +28,11 @@ export declare class oLane extends oObject {
     toCID(): Promise<CID>;
     store(): Promise<CID>;
     get agentHistory(): string;
+    /**
+     * Generate a human-readable execution trace of the lane
+     * Shows the decision points and flow of execution
+     */
+    getExecutionTrace(): string;
     preflight(): Promise<void>;
     execute(): Promise<oCapabilityResult | undefined>;
     get capabilities(): import("./capabilities/o-capability.js").oCapability[];

package/dist/src/o-lane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-lane.d.ts","sourceRoot":"","sources":["../../src/o-lane.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,EAGR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AAGjC,qBAAa,KAAM,SAAQ,OAAO;IAWpB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW;IAV3C,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IACnC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;IACrB,EAAE,EAAE,MAAM,CAAY;IACtB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAM;IACxB,MAAM,EAAE,WAAW,CAAuB;IAC1C,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;gBAEP,MAAM,EAAE,WAAW;IAalD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,UAAU,IAAI,GAAG;IAQjB,MAAM;;;;;IAQN,WAAW,CAAC,MAAM,EAAE,iBAAiB;IAgB/B,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAUrB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAuB3B,IAAI,YAAY,WA8Bf;IACK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,OAAO,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAgBvD,IAAI,YAAY,2DAEf;IAED,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,iBAAiB;IAcxC,YAAY,CAChB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAiBvB,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA+DlC,UAAU,CACd,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAsDzC,MAAM;IASN;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAwEjE;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAS9B,IAAI,IAAI,yCAEP;CACF"}
+{"version":3,"file":"o-lane.d.ts","sourceRoot":"","sources":["../../src/o-lane.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,EAGR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AAIjC,qBAAa,KAAM,SAAQ,OAAO;IAWpB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW;IAV3C,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IACnC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;IACrB,EAAE,EAAE,MAAM,CAAY;IACtB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAM;IACxB,MAAM,EAAE,WAAW,CAAuB;IAC1C,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;gBAEP,MAAM,EAAE,WAAW;IAalD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,UAAU,IAAI,GAAG;IAQjB,MAAM;;;;;IAQN,WAAW,CAAC,MAAM,EAAE,iBAAiB;IAgB/B,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAUrB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAuB3B,IAAI,YAAY,WA8Df;IAED;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IA+DrB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,OAAO,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IA4BvD,IAAI,YAAY,2DAEf;IAED,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,iBAAiB;IAcxC,YAAY,CAChB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAiBvB,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA+DlC,UAAU,CACd,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAsDzC,MAAM;IASN;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAwEjE;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAS9B,IAAI,IAAI,yCAEP;CACF"}

package/dist/src/o-lane.js

@@ -7,6 +7,7 @@ import { oIntentEncoder } from './intent-encoder/index.js';
 import { oLaneStatus } from './enum/o-lane.status-enum.js';
 import { oCapabilityResult, oCapabilityType, } from './capabilities/index.js';
 import { ALL_CAPABILITIES } from './capabilities-all/o-capability.all.js';
+import { MarkdownBuilder } from './formatters/index.js';
 export class oLane extends oObject {
     constructor(config) {
         super('o-lane:' + `[${config.intent.value}]`);
@@ -85,36 +86,135 @@ export class oLane extends oObject {
     }
     get agentHistory() {
         const added = {};
-        return (this.sequence
-            ?.filter((s) => {
+        const MAX_RESULT_LENGTH = 1000; // Truncate large results
+        const KEEP_FULL_DETAIL_COUNT = 3; // Keep full detail for last N cycles
+        const filteredSequence = this.sequence?.filter((s) => {
             if (added[s.id]) {
                 return false;
             }
             added[s.id] = true;
             return true;
-        })
+        });
+        return (filteredSequence
             ?.map((s, index) => {
+            const isRecent = index >= filteredSequence.length - KEEP_FULL_DETAIL_COUNT;
             const result = s.result || s.error;
-            return `[Cycle ${index + 1} Begin ${s.id}]\n
-            Cycle Intent: ${s.config?.intent.toString()}\n
-            Cycle Result:\n
-            ${typeof result === 'string'
-                ? result
-                : JSON.stringify({
-                    ...result,
-                }, null, 2)} \n[Cycle ${index + 1} End ${s.id}]`;
+            const params = s.config?.params || {};
+            // Extract summary and reasoning if available
+            const summary = params.summary || '';
+            const reasoning = params.reasoning || '';
+            // Format result, truncating if not a recent cycle
+            let formattedResult;
+            if (typeof result === 'string') {
+                formattedResult =
+                    isRecent || result.length <= MAX_RESULT_LENGTH
+                        ? result
+                        : result.substring(0, MAX_RESULT_LENGTH) + '... (truncated)';
+            }
+            else {
+                const jsonStr = JSON.stringify(result, null, 2);
+                formattedResult =
+                    isRecent || jsonStr.length <= MAX_RESULT_LENGTH
+                        ? jsonStr
+                        : jsonStr.substring(0, MAX_RESULT_LENGTH) + '... (truncated)';
+            }
+            // Build formatted history entry
+            let entry = `[Cycle ${index + 1}: ${s.type}]\n`;
+            entry += `Intent: ${s.config?.intent.toString()}\n`;
+            if (summary) {
+                entry += `Summary: ${summary}\n`;
+            }
+            if (reasoning) {
+                entry += `Reasoning: ${reasoning}\n`;
+            }
+            if (s.error) {
+                entry += `Error: ${s.error}\n`;
+            }
+            else {
+                entry += `Result: ${formattedResult}\n`;
+            }
+            return entry;
         })
             .join('\n') || '');
     }
+    /**
+     * Generate a human-readable execution trace of the lane
+     * Shows the decision points and flow of execution
+     */
+    getExecutionTrace() {
+        const mb = MarkdownBuilder.create();
+        mb.header('Execution Trace', 2);
+        mb.paragraph(`Intent: ${this.config.intent.value}`);
+        mb.paragraph(`Cycles: ${this.sequence.length}`);
+        mb.paragraph(`Status: ${this.status}`);
+        if (this.sequence.length === 0) {
+            mb.paragraph('No execution cycles recorded.');
+            return mb.build();
+        }
+        mb.br();
+        mb.header('Cycle Details', 3);
+        this.sequence.forEach((step, index) => {
+            const params = step.config?.params || {};
+            const summary = params.summary || '';
+            const reasoning = params.reasoning || '';
+            mb.br();
+            mb.raw(`${mb.bold(`Cycle ${index + 1}`)} [${step.type}]`);
+            if (summary) {
+                mb.raw(`\n└─ ${mb.italic('Summary:')} ${summary}`);
+            }
+            if (reasoning) {
+                mb.raw(`\n└─ ${mb.italic('Reasoning:')} ${reasoning}`);
+            }
+            if (step.error) {
+                mb.raw(`\n└─ ❌ ${mb.bold('Error:')} ${step.error}`);
+            }
+            else if (step.type === oCapabilityType.STOP) {
+                mb.raw(`\n└─ ✓ ${mb.bold('Completed')}`);
+            }
+        });
+        // Add final result summary
+        if (this.result) {
+            mb.br();
+            mb.hr();
+            mb.header('Final Result', 3);
+            const resultParams = this.result.config?.params || {};
+            const finalSummary = resultParams.summary || '';
+            if (finalSummary) {
+                mb.paragraph(finalSummary);
+            }
+            if (this.result.error) {
+                mb.paragraph(`${mb.bold('Status:')} Failed`);
+                mb.paragraph(`${mb.bold('Error:')} ${this.result.error}`);
+            }
+            else {
+                mb.paragraph(`${mb.bold('Status:')} Success`);
+            }
+        }
+        return mb.build();
+    }
     async preflight() {
         this.logger.debug('Preflight...');
         this.status = oLaneStatus.PREFLIGHT;
+        this.logger.debug('Pinging intelligence tool...');
+        // ping the intelligence tool to ensure it is available
+        await this.node.use(new oAddress('o://intelligence'), {
+            method: 'ping',
+            params: {},
+        });
     }
     async execute() {
         this.logger.debug('Executing...');
-        await this.preflight();
-        this.status = oLaneStatus.RUNNING;
         try {
+            await this.preflight().catch((error) => {
+                this.logger.error('Error in preflight: ', error);
+                this.result = new oCapabilityResult({
+                    type: oCapabilityType.ERROR,
+                    result: null,
+                    error: 'Intelligence services are not available. Try again later.',
+                });
+                throw new oError(oErrorCodes.INVALID_STATE, 'Intelligence services are not available. Try again later.');
+            });
+            this.status = oLaneStatus.RUNNING;
             this.result = await this.loop();
         }
         catch (error) {

package/dist/src/o-lane.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-lane.tool.d.ts","sourceRoot":"","sources":["../../src/o-lane.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,EAAa,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,qBAAa,SAAU,SAAQ,SAAS;IACtC,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,EAAE,WAAW;IAKzB,eAAe,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBrE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAiDzD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IA8B7C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}
+{"version":3,"file":"o-lane.tool.d.ts","sourceRoot":"","sources":["../../src/o-lane.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,EAAa,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,qBAAa,SAAU,SAAQ,SAAS;IACtC,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,EAAE,WAAW;IAKzB,eAAe,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBrE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAmDzD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IA8B7C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/src/o-lane.tool.js

@@ -62,6 +62,8 @@ export class oLaneTool extends oNodeTool {
         response = await pc.execute();
         const completeResponse = {
             result: response?.result,
+            humanResult: response?.humanResult, // Full human-readable formatted result (AI-generated markdown)
+            summary: response?.config?.params?.summary, // Short 1-2 sentence summary
             error: response?.error,
             cycles: pc.sequence.length,
             cid: pc.cid?.toString(),

package/dist/src/prompts/agent.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/agent.prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,WACf,MAAM,WACL,MAAM,gBACD,MAAM,qBACD,MAAM,WAsIxB,CAAC"}
+{"version":3,"file":"agent.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/agent.prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,WACf,MAAM,WACL,MAAM,gBACD,MAAM,qBACD,MAAM,WA4IxB,CAAC"}

package/dist/src/prompts/agent.prompt.js

@@ -43,9 +43,15 @@ Step 5 - Use target tool address
 
 Step 6 - Review the tool use results
 1. Analyze each tool use result
-2. Summarize the result of each tool use in 1 concise sentence
-3. In the summary, clearly mention if it succeeded or failed
-4. If it failed, make sure to include why it failed
+2. When formatting tool results for the user in a Stop Response, present as clean markdown:
+   - For general contexts, present as clean markdown:
+     * Use headings to organize different sections
+     * Use lists for multiple items
+     * Use bold for important values or labels
+     * Use code blocks for addresses (e.g., \`o://tool-address\`)
+     * Transform raw JSON into readable prose and structured lists
+3. In the summary field, provide a 1-2 sentence overview
+4. If it failed, clearly explain why in a user-friendly way
 
 
   `, `
@@ -98,10 +104,10 @@ Search Response:
 
 Stop Response:
 {
-  "result": string,
+  "result": string, // IMPORTANT: Format this as clean, readable markdown. Use headers (##, ###), lists (-, 1.), bold (**text**), and code blocks (\`code\`) to make the response easy to read. Structure tool outputs, search results, and data clearly. Focus on what the user needs to know, not raw data dumps.
   "reasoning": string,
   "addresses_to_index": [string], // COMMENT: If the results of a tool use include "address_to_index", list them in the "addresses_to_index" array.
-  "summary": string,
+  "summary": string, // A concise 1-2 sentence summary for the user
   "type": "stop",
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-lane",
-  "version": "0.7.12-alpha.57",
+  "version": "0.7.12-alpha.59",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -54,13 +54,13 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.7.12-alpha.57",
-    "@olane/o-core": "0.7.12-alpha.57",
-    "@olane/o-node": "0.7.12-alpha.57",
-    "@olane/o-protocol": "0.7.12-alpha.57",
-    "@olane/o-tool": "0.7.12-alpha.57",
+    "@olane/o-config": "0.7.12-alpha.59",
+    "@olane/o-core": "0.7.12-alpha.59",
+    "@olane/o-node": "0.7.12-alpha.59",
+    "@olane/o-protocol": "0.7.12-alpha.59",
+    "@olane/o-tool": "0.7.12-alpha.59",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0"
   },
-  "gitHead": "71a484e394405a5398d0955dabac179465384e89"
+  "gitHead": "e444856d725e14b45e3ea8bf726fcb6eef021a79"
 }