@olane/o-core 0.5.1 → 0.6.1

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

@@ -7,6 +7,8 @@ export declare class oPlan {
     protected logger: Logger;
     sequence: oPlan[];
     cid: CID | undefined;
+    id: string;
+    parentId: string | undefined;
     result: oPlanResult | undefined;
     constructor(config: oPlanConfig);
     get caller(): oAddress;
@@ -19,12 +21,12 @@ export declare class oPlan {
         sequence: string[];
         result: oPlanResult | undefined;
     };
+    addSequencePlan(plan: oPlan): void;
     toCID(): Promise<CID>;
     storePlan(): Promise<void>;
     get agentHistory(): string;
     searchPlans(): Promise<any>;
     preflight(): Promise<void>;
-    extractResultFromAI(message: string): oPlanResult;
     run(): Promise<oPlanResult>;
     execute(): Promise<oPlanResult>;
     handleNetworkChanges(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"o-plan.d.ts","sourceRoot":"","sources":["../../../src/plan/o-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,qBAAa,KAAK;IAOJ,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW;IANlD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,EAAE,CAAM;IACvB,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;IAErB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;gBAER,MAAM,EAAE,WAAW;IAKlD,IAAI,MAAM,aAET;IAED,IAAI,QAAQ,yBAEX;IAED,IAAI,IAAI,6CAEP;IAED,UAAU,IAAI,GAAG;IAQjB,IAAI;IAIJ,MAAM;;;;;IAQA,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAUrB,SAAS;IAef,IAAI,YAAY,WAef;IAEK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAmB3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAoB3C,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAqC3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAQ/B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7B,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAc9D"}
+{"version":3,"file":"o-plan.d.ts","sourceRoot":"","sources":["../../../src/plan/o-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK1D,qBAAa,KAAK;IASJ,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW;IARlD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,EAAE,CAAM;IACvB,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;IACrB,EAAE,EAAE,MAAM,CAAY;IACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;gBAER,MAAM,EAAE,WAAW;IAMlD,IAAI,MAAM,aAET;IAED,IAAI,QAAQ,yBAEX;IAED,IAAI,IAAI,6CAEP;IAED,UAAU,IAAI,GAAG;IAQjB,IAAI;IAIJ,MAAM;;;;;IAQN,eAAe,CAAC,IAAI,EAAE,KAAK;IAarB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAUrB,SAAS;IAef,IAAI,YAAY,WA0Bf;IAEK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAmB3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAsC3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAQ/B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7B,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAc9D"}

package/dist/src/plan/o-plan.js

@@ -3,14 +3,16 @@ import { CID } from 'multiformats';
 import * as json from 'multiformats/codecs/json';
 import { sha256 } from 'multiformats/hashes/sha2';
 import { AGENT_PROMPT } from './prompts/agent.prompt.js';
-import { oToolError } from '../error/tool.error.js';
 import { v4 as uuidv4 } from 'uuid';
+import { RegexUtils } from '../utils/index.js';
 export class oPlan {
     constructor(config) {
         this.config = config;
         this.sequence = [];
+        this.id = uuidv4();
         this.logger = new Logger('oPlan:' + `[${this.config.intent}]`);
-        this.sequence = this.config.sequence || [];
+        this.sequence = Object.assign([], this.config.sequence || []);
+        this.parentId = this.config.parentId;
     }
     get caller() {
         return this.config.caller;
@@ -38,6 +40,18 @@ export class oPlan {
             result: this.result,
         };
     }
+    addSequencePlan(plan) {
+        this.sequence.push(plan);
+        // console.log(
+        //   `${this.parentId ? '--[Child ' : '['}Cycle ${this.sequence.length} - ${this.id}]\n ${JSON.stringify(
+        //     {
+        //       ...plan.result,
+        //     },
+        //     null,
+        //     2,
+        //   )}\n${this.parentId ? '--[Child ' : '['}Cycle ${this.sequence.length} - ${this.id}]`,
+        // );
+    }
     async toCID() {
         if (this.cid) {
             return this.cid;
@@ -61,10 +75,21 @@ export class oPlan {
         });
     }
     get agentHistory() {
+        const added = {};
         return (this.sequence
-            ?.map((s, index) => `[Cycle ${index + 1} Begin]\n${JSON.stringify({
+            ?.filter((s) => {
+            if (added[s.id]) {
+                return false;
+            }
+            added[s.id] = true;
+            return true;
+        })
+            ?.map((s, index) => `[Cycle ${index + 1} Begin ${s.id}]\n
+            Cycle Intent: ${s.config.intent}\n
+            Cycle Result:\n
+            ${JSON.stringify({
             ...s.result,
-        }, null, 2)} \n[Cycle ${index + 1} End]`)
+        }, null, 2)} \n[Cycle ${index + 1} End ${s.id}]`)
             .join('\n') || '');
     }
     async searchPlans() {
@@ -87,48 +112,29 @@ export class oPlan {
         this.logger.debug('Preflight...');
         this.cid = await this.toCID();
     }
-    extractResultFromAI(message) {
-        this.logger.debug('Extracting result from AI: ', message);
-        // handle 4 levels of nested JSON
-        const matches = message.match(/\{(?:[^{}]*|\{(?:[^{}]*|\{(?:[^{}]*|\{(?:[^{}]*|\{[^{}]*\})*\})*\})*\})*\}/);
-        if (!matches || matches.length === 0) {
-            // AI failed to return a valid JSON object
-            throw new Error('AI failed to return a valid JSON object');
-        }
-        const json = matches[0];
-        this.logger.debug('[AGENT PLAN] Analysis result: ', json);
-        // process the result and react
-        const planResult = JSON.parse(json);
-        return planResult;
-    }
     async run() {
         this.logger.debug('Running plan...');
         const ctxt = this.config.context?.toString() || '';
-        this.logger.debug('Agent history: ', this.agentHistory);
         let prompt = null;
         if (this.config.promptFunction) {
             this.logger.debug('Using prompt function: ', this.config.promptFunction);
-            prompt = this.config.promptFunction(this.config.intent, ctxt, this.agentHistory);
+            prompt = this.config.promptFunction(this.config.intent, ctxt, this.agentHistory, this.config.extraInstructions || '');
         }
         else {
-            prompt = AGENT_PROMPT(this.config.intent, ctxt, this.agentHistory);
+            prompt = AGENT_PROMPT(this.config.intent, ctxt, this.agentHistory, this.config.extraInstructions || '');
         }
-        this.logger.debug('Prompt: ', prompt);
+        // this.logger.debug('Prompt: ', prompt);
         const response = await this.node.use(new oAddress('o://intelligence'), {
             method: 'prompt',
             params: {
                 prompt: prompt,
+                response_format: 'json_object',
             },
         });
-        if (response.result.error) {
-            this.logger.error('Error in plan: ', response.result.error);
-            const error = response.result.error;
-            throw new oToolError(error.code, error.message);
-        }
         const data = response.result.data;
         this.logger.debug('Plan response: ', data);
         const message = data.message;
-        const planResult = this.extractResultFromAI(message);
+        const planResult = RegexUtils.extractResultFromAI(message);
         return planResult;
     }
     async execute() {
@@ -147,23 +153,23 @@ export class oPlan {
         });
     }
     async addReasoning() {
-        if (this.result?.reasoning) {
-            this.logger.debug('Adding knowledge: ', this.result?.reasoning);
-            await this.node.use(new oAddress('o://vector-store'), {
-                method: 'add_documents',
-                params: {
-                    documents: [
-                        {
-                            pageContent: this.result?.reasoning,
-                            metadata: {
-                                address: this.caller?.toString(),
-                                id: uuidv4(),
-                            },
-                        },
-                    ],
-                },
-            });
-        }
+        // if (this.result?.reasoning) {
+        //   this.logger.debug('Adding knowledge: ', this.result?.reasoning);
+        //   await this.node.use(new oAddress('o://vector-store'), {
+        //     method: 'add_documents',
+        //     params: {
+        //       documents: [
+        //         {
+        //           pageContent: this.result?.reasoning,
+        //           metadata: {
+        //             address: this.caller?.toString(),
+        //             id: uuidv4(),
+        //           },
+        //         },
+        //       ],
+        //     },
+        //   });
+        // }
     }
     async postflight(response) {
         this.logger.debug('Postflight...');

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

@@ -1,2 +1,2 @@
-export declare const AGENT_PROMPT: (intent: string, context: string, agentHistory: string) => string;
+export declare const AGENT_PROMPT: (intent: string, context: string, agentHistory: string, extraInstructions: string) => string;
 //# sourceMappingURL=agent.prompt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/agent.prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,cAAc,MAAM,WAoGnB,CAAC"}
+{"version":3,"file":"agent.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/agent.prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,mBAAmB,MAAM,WAsHxB,CAAC"}

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

@@ -1,11 +1,12 @@
 import { CUSTOM_AGENT_PROMPT } from './custom.prompt.js';
-export const AGENT_PROMPT = (intent, context, agentHistory) => CUSTOM_AGENT_PROMPT(intent, context, agentHistory, `
+export const AGENT_PROMPT = (intent, context, agentHistory, extraInstructions) => CUSTOM_AGENT_PROMPT(intent, context, agentHistory, `
   Every Step Instructions:
 1. Review the provided user intent and context
 2. If you can complete the user intent, return the answer using the "Return Instructions" steps
-3. If you experience an error trying to use a tool more than 2 times, stop here and follow the "Return Instructions" steps to indicate the error.
-3. Review the current step number and perform the instructions associated with that step.
-4. Start with step 1
+3. If the intent is already completed in past cycles, stop here and follow the "Return Instructions" steps
+4. If you experience 3 similar errors in a row, stop here and follow the "Return Instructions" steps to indicate the error.
+5. Review the current step number and perform the instructions associated with that step.
+6. Start with step 1
 
 Step 1 - Evaluate the intent
 1. A complex step means there are multiple actions required to complete the user's intent
@@ -16,7 +17,10 @@ Step 2 - Search for tools and context
 1. If all entities and tool addresses are known within the user intent, continue to step 3
 2. Review the user's intent, the current node's functionality, rules and context
 3. If there are unknown tool addresses or entities within the user intent, generate search queries to resolve the unknown entities. 
-4. Search queries can be internal or external. If they are internal, they should be vector database queries. If they are external, they should be concise queries to internet search providers. Stop here and follow the "Return Instructions" steps
+4. If there is a placeholder address used (o://.../placeholder), do not extract the contents of the placeholder address unless necessary for completing the user intent.
+5. Search for internal "search tools" that might contain information about the unknown entities.
+6. Use the search result data & tooling to help you resolve the unknown entities.
+7. Continue to step 3.
 
 Step 3 - Filter Search Results
 1. If all search results are relevant to the user intent resolution, continue to step 4.
@@ -33,14 +37,16 @@ Step 5 - Review the tool use results
 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
+
   `, `
-  These are the types of cycle results: "Complex Intent Results", "Search Results", "Use Tool Results", "Answer Results", "Error Results".
+  These are the types of cycle results: "Complex Intent Results", "Search Results", "Use Tool Results", "Answer Results", "Error Results", "Configure Results".
 
 All Return Step Instructions:
-1. Determine what type of results we have
-2. Output the respective results using the matching output type.
-3. Generate a reasoning statement for why this result was returned.
-4. Do not include \`\`\`json or \`\`\` in your output.
+1. Do not explain your reasoning process, just return the output in the correct format.
+2. Determine what type of results we have
+3. Output the respective results using the matching output type.
+4. Generate a reasoning key value pair for why this result was returned.
+5. Do not include \`\`\`json or \`\`\` in your output.
 
 Complex Intent Results:
 {
@@ -50,7 +56,7 @@ Complex Intent Results:
     "simple intent 3",
   ],
   "reasoning": string,
-  "type": "complex-intent",
+  "type": "multiple_step",
 }
 
 Use Tool Results:
@@ -69,8 +75,8 @@ Search Results:
 {
   "queries": [
     {
-      "query": "key terms to search for",
-      "provider": "internal" | "external",
+      "query": "vector database query key terms to search for",
+      "provider": "internal",
     }
   ],
   "reasoning": string,
@@ -91,4 +97,15 @@ Error Results:
   "type": "error",
 }
 
-  `);
+Configure Results:
+{
+  "configure": {
+    "task": {
+      "address": string,
+      "payload": { "method": string, "params": any }
+    }
+  },
+  "type": "configure",
+}
+
+  `, extraInstructions);

package/dist/src/plan/prompts/configure.prompt.d.ts

@@ -1,2 +1,2 @@
-export declare const CONFIGURE_PROMPT: (intent: string, context: string, agentHistory: string) => string;
+export declare const CONFIGURE_INSTRUCTIONS = "\n  Configure Request Instructions:\n1. Review the provided user intent and context\n2. If you can complete the user intent, return the answer using the \"Return Instructions\" steps\n3. If you experience an error trying to use a tool more than 2 times, stop here and follow the \"Return Instructions\" steps to indicate the error.\n3. Review the current step number and perform the instructions associated with that step.\n4. Start with step 1\n\nStep 1 - Validate the intent\n1. If the intent is not a configure request, continue to step 5\n2. If the context provided would suggest that the intent is already solved, continue to step 5\n2. Continue to step 2\n\nStep 2 - Choose Method\n1. Review the method options and metadata to determine the best method to resolve the user's intent.\n2. Choose the best method to resolve the user's intent.\n3. Continue to step 3\n\nStep 3 - Select Parameters\n1. Review the parameters for the selected best method.\n2. Extract the parameter values from the agent history, provided context and intent. Do NOT use a parameter value that is not mentioned previously.\n3. Do not use placeholder values for parameter values.\n4. Do not use parameter values that are not explicitly mentioned in the agent history, provided context or intent.\n3. Identify missing parameter values.\n4. If you have enough information to complete the configure request, go to step 5.\n5. Continue to step 4\n\nStep 4 - Search for missing parameter values\n1. Identify other methods that can be used to resolve the missing parameter values.\n2. Identify methods that can be used to resolve the missing parameter values.\n3. Continue to step 5\n\nStep 5 - Finish\n1. If the intent seems to be already solved, return answer results.\n1. If this is not a configure request, return an error.\n2. If you are missing parameter values, generate the intents for the \"Complex Intent\" results using other methods or search to help.\n2. If you have enough information to complete the configure request, follow the \"Return Instructions\" steps to return the \"configure results\".\n3. If you do not have enough information to complete the configure request, return an error.\n\n  ";
 //# sourceMappingURL=configure.prompt.d.ts.map

package/dist/src/plan/prompts/configure.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/configure.prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,cAAc,MAAM,WA6DnB,CAAC"}
+{"version":3,"file":"configure.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/configure.prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8oEAuChC,CAAC"}

package/dist/src/plan/prompts/configure.prompt.js

@@ -1,55 +1,40 @@
-import { CUSTOM_AGENT_PROMPT } from './custom.prompt.js';
-export const CONFIGURE_PROMPT = (intent, context, agentHistory) => CUSTOM_AGENT_PROMPT(intent, context, agentHistory, `
-  Every Step Instructions:
+export const CONFIGURE_INSTRUCTIONS = `
+  Configure Request Instructions:
 1. Review the provided user intent and context
 2. If you can complete the user intent, return the answer using the "Return Instructions" steps
 3. If you experience an error trying to use a tool more than 2 times, stop here and follow the "Return Instructions" steps to indicate the error.
 3. Review the current step number and perform the instructions associated with that step.
 4. Start with step 1
 
-Step 1 - Evaluate the intent
-1. A complex step means there are multiple actions required to complete the user's intent
-2. If the intent is not-complex, continue to step 2
-3. If the intent is complex, break it up into a list of simple concise intents. Stop here and follow the "Return Instructions" steps
-
-Step 2 - Handshake
-1. If this is not a handshake request, continue to step 3
-2. Method options are listed in the [Method Options Begin] section.
-3. Method metadata context is listed in the [Method Metadata Begin] section.
-4. Review the method information and select the best method to resolve the user's intent.
-5. If you have enough information to complete the handshake, follow the "Return Instructions" steps to return the "handshake results" do not return "Use Tool Results".
-6. Continue to step 3
-
-  `, `
-These are the types of cycle results: "Answer Results", "Handshake Results", "Error Results".
-
-All Return Step Instructions:
-1. Determine what type of results we have
-2. Output the respective results using the matching output type.
-3. Generate a reasoning statement for why this result was returned.
-4. Do not include \`\`\`json or \`\`\` in your output.
-
-Handshake Results:
-{
-  "handshake": {
-    "address": string,
-    "payload": { "method": string, "params": any }
-  },
-  "type": "handshake",
-}
-
-Answer Results:
-{
-  "result": string,
-  "reasoning": string,
-  "type": "result",
-}
-
-Error Results:
-{
-  "error": string,
-  "reasoning": string,
-  "type": "error",
-}
-
-    `);
+Step 1 - Validate the intent
+1. If the intent is not a configure request, continue to step 5
+2. If the context provided would suggest that the intent is already solved, continue to step 5
+2. Continue to step 2
+
+Step 2 - Choose Method
+1. Review the method options and metadata to determine the best method to resolve the user's intent.
+2. Choose the best method to resolve the user's intent.
+3. Continue to step 3
+
+Step 3 - Select Parameters
+1. Review the parameters for the selected best method.
+2. Extract the parameter values from the agent history, provided context and intent. Do NOT use a parameter value that is not mentioned previously.
+3. Do not use placeholder values for parameter values.
+4. Do not use parameter values that are not explicitly mentioned in the agent history, provided context or intent.
+3. Identify missing parameter values.
+4. If you have enough information to complete the configure request, go to step 5.
+5. Continue to step 4
+
+Step 4 - Search for missing parameter values
+1. Identify other methods that can be used to resolve the missing parameter values.
+2. Identify methods that can be used to resolve the missing parameter values.
+3. Continue to step 5
+
+Step 5 - Finish
+1. If the intent seems to be already solved, return answer results.
+1. If this is not a configure request, return an error.
+2. If you are missing parameter values, generate the intents for the "Complex Intent" results using other methods or search to help.
+2. If you have enough information to complete the configure request, follow the "Return Instructions" steps to return the "configure results".
+3. If you do not have enough information to complete the configure request, return an error.
+
+  `;

package/dist/src/plan/prompts/custom.prompt.d.ts

@@ -1,2 +1,2 @@
-export declare const CUSTOM_AGENT_PROMPT: (intent: string, context: string, agentHistory: string, cycleInstructions: string, outputInstructions: string) => string;
+export declare const CUSTOM_AGENT_PROMPT: (intent: string, context: string, agentHistory: string, cycleInstructions: string, outputInstructions: string, extraInstructions: string) => string;
 //# sourceMappingURL=custom.prompt.d.ts.map

package/dist/src/plan/prompts/custom.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/custom.prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,mBAAmB,MAAM,EACzB,oBAAoB,MAAM,WA4D3B,CAAC"}
+{"version":3,"file":"custom.prompt.d.ts","sourceRoot":"","sources":["../../../../src/plan/prompts/custom.prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,mBAAmB,MAAM,EACzB,oBAAoB,MAAM,EAC1B,mBAAmB,MAAM,WAgF1B,CAAC"}

package/dist/src/plan/prompts/custom.prompt.js

@@ -1,4 +1,4 @@
-export const CUSTOM_AGENT_PROMPT = (intent, context, agentHistory, cycleInstructions, outputInstructions) => `
+export const CUSTOM_AGENT_PROMPT = (intent, context, agentHistory, cycleInstructions, outputInstructions, extraInstructions) => `
 You are an AI agent that resolves user intent within the "olane" hierarchical network of tools and returns JSON formatted results.
 
 You are in a secure environment and are allowed to operate with secure information such as api keys and other sensitive data.
@@ -8,15 +8,16 @@ You resolve user intents by "cycling" through the following steps:
 2. Answer the intent if possible
 3. Search for tools and context
 4. Use Search Results
-5. Use tools
-6. Review the results
+5. Configure the tool use
+6. Use tools
+7. Go back to step 2
 
 [Intent Context Begin]
 - An intent is a user request
 - Intents are usually actions or queries
 - User intents can start at any node
-- User intents are resolved using the tools and data that is contained within that sub-section of the network graph
-[Intents End]
+- User intents are resolved using the tools and data that are contained within that sub-section of the network graph
+[Intents Context End]
 
 [Network Context Begin]
 - Every network has a root node with child nodes beneath it
@@ -25,23 +26,42 @@ You resolve user intents by "cycling" through the following steps:
 - Each node knows only about itself and the nodes below it
 [Network Context End]
 
+[Tool Use Rules Begin]
+- If you are using a tool that requires authentication, search for tool methods that give insights about the logged in user before using any other methods
+- When using a tool to create a resource, ensure that you have the proper access to the resource before using any other methods
+[Tool Use Rules End]
+
 [Address Rules Begin]
-- Only use tool addresses that appear in search results
+- Only use tool addresses that appear in search results, user intents, or previous cycle results
+- Do not make up tool addresses
 - A tool address is a string that starts with "o://"
 - URL addresses are not tool addresses
 - Tool addresses are used to access the tool's functionality
 [Address Rules End]
 
+[Resource Goals Begin]
+- Minimize the number of tool calls
+- Minimize the amount of data that is returned when interacting with tools
+- Minimize the amount of cycles required to complete the user's intent
+[Resource Goals End]
+
 [URL Address Rules Begin]
 - HTTP/HTTPS URL addresses are not olane tool addresses
 - When an address is provided in a user intent, get and analyze the contents of the address before assuming to know how to use it
 [URL Address Rules End]
 
+[Extra Instructions Begin]
+${extraInstructions}
+[Extra Instructions End]
+
 [Cycle Instructions Begin]
 ${cycleInstructions}
 [Cycle Instructions End]
 
 [Cycle Return Instructions Begin]
+GLOBAL RETURN INSTRUCTIONS:
+1. Do not include \`\`\`json or \`\`\` in your output.
+2. Only return the JSON object, do not include any other text.
 ${outputInstructions}
 [Cycle Return Instructions End]
 

package/dist/src/plan/search/search.plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.plan.d.ts","sourceRoot":"","sources":["../../../../src/plan/search/search.plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,qBAAa,WAAY,SAAQ,KAAK;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAU;gBACd,MAAM,EAAE,WAAW,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAMtE;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,cAAc;IAatB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;CAOlC"}
+{"version":3,"file":"search.plan.d.ts","sourceRoot":"","sources":["../../../../src/plan/search/search.plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,qBAAa,WAAY,SAAQ,KAAK;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAU;gBACd,MAAM,EAAE,WAAW,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAMtE;;OAEG;YACW,cAAc;IAqB5B;;OAEG;YACW,cAAc;IActB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;CAOlC"}

package/dist/src/plan/search/search.plan.js

@@ -10,22 +10,29 @@ export class oSearchPlan extends oPlan {
      * Search external providers.
      */
     async externalSearch() {
+        const response = await this.node.use(new oAddress('o://perplexity'), {
+            method: 'completion',
+            params: {
+                model: 'sonar',
+                messages: [
+                    {
+                        role: 'user',
+                        content: this.query,
+                    },
+                ],
+            },
+        });
+        this.logger.debug('External search response: ', response.result.data);
         return {
-            result: [],
+            result: [response.result.data],
             type: 'result',
         };
-        // const response = await this.node.use(new oAddress('o://search'), {
-        //   method: 'vector',
-        //   params: {
-        //     query: this.query,
-        //   },
-        // });
-        // return response.result.data;
     }
     /**
      * Search internal providers such as the local vector store, local database, etc.
      */
     async internalSearch() {
+        // find all tools that are search tools
         const response = await this.node.use(new oAddress('o://search'), {
             method: 'vector',
             params: {

package/dist/src/plan/use/use.plan.d.ts

@@ -8,6 +8,9 @@ import { oPlanResult } from '../interfaces/plan.result.js';
 export declare class oUsePlan extends oPlan {
     type(): oPlanType;
     handleDependencies(dependencies: oDependency[]): Promise<oResponse[]>;
+    static hasOlaneAddress(value: string): boolean;
+    static extractAddresses(value: string): string[];
     run(): Promise<oPlanResult>;
+    postflight(result: oPlanResult): Promise<oPlanResult>;
 }
 //# sourceMappingURL=use.plan.d.ts.map

package/dist/src/plan/use/use.plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use.plan.d.ts","sourceRoot":"","sources":["../../../../src/plan/use/use.plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI;IAIE,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAUrE,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;CAuDlC"}
+{"version":3,"file":"use.plan.d.ts","sourceRoot":"","sources":["../../../../src/plan/use/use.plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAU3D;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI;IAIE,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAU3E,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ9C,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAK1C,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IA8F3B,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAwC5D"}