@aigne/agent-library 1.23.0 → 1.24.0-beta.2

package/CHANGELOG.md

@@ -7,6 +7,47 @@
     * @aigne/core bumped to 1.22.0
     * @aigne/openai bumped to 0.3.4
 
+## [1.24.0-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.24.0-beta.1...agent-library-v1.24.0-beta.2) (2025-12-19)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.2
+    * @aigne/openai bumped to 0.16.16-beta.2
+
+## [1.24.0-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.24.0-beta...agent-library-v1.24.0-beta.1) (2025-12-17)
+
+
+### Bug Fixes
+
+* bump version ([70d217c](https://github.com/AIGNE-io/aigne-framework/commit/70d217c8360dd0dda7f5f17011c4e92ec836e801))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.1
+    * @aigne/openai bumped to 0.16.16-beta.1
+    * @aigne/sqlite bumped to 0.4.9-beta
+
+## [1.24.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.23.0...agent-library-v1.24.0-beta) (2025-12-17)
+
+
+### Features
+
+* **agent-library:** add parallel tasks support for orchestrator agent ([#834](https://github.com/AIGNE-io/aigne-framework/issues/834)) ([7314eb1](https://github.com/AIGNE-io/aigne-framework/commit/7314eb1ef5f1eb4bf6f2b8160c61ef627a6aa3cc))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta
+    * @aigne/openai bumped to 0.16.16-beta
+
 ## [1.23.0](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.23.0-beta.8...agent-library-v1.23.0) (2025-12-12)
 
 

package/lib/cjs/orchestrator/index.d.ts

@@ -15,6 +15,7 @@ export interface OrchestratorAgentOptions<I extends Message = Message, O extends
      * Prevents context overflow during long-running executions
      */
     stateManagement?: StateManagementOptions;
+    concurrency?: number;
 }
 export interface LoadOrchestratorAgentOptions<I extends Message = Message, O extends Message = Message> extends Omit<AIAgentOptions<I, O>, "instructions"> {
     objective?: string | PromptBuilder | Instructions;
@@ -67,6 +68,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private worker;
     private completer;
     private stateManagement?;
+    private concurrency;
     /**
      * Compress execution state to prevent context overflow
      * Uses reverse accumulation to efficiently find optimal task count

package/lib/cjs/orchestrator/index.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrchestratorAgent = void 0;
 const core_1 = require("@aigne/core");
@@ -6,6 +39,7 @@ const agent_yaml_js_1 = require("@aigne/core/loader/agent-yaml.js");
 const index_js_1 = require("@aigne/core/loader/index.js");
 const schema_js_1 = require("@aigne/core/loader/schema.js");
 const agent_utils_js_1 = require("@aigne/core/utils/agent-utils.js");
+const fastq = __importStar(require("@aigne/core/utils/queue.js"));
 const token_estimator_js_1 = require("@aigne/core/utils/token-estimator.js");
 const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
 const zod_1 = require("zod");
@@ -38,6 +72,7 @@ const defaultCompleterOptions = {
         disabled: true,
     },
 };
+const DEFAULT_CONCURRENCY = 5;
 /**
  * Orchestrator Agent Class
  *
@@ -123,12 +158,14 @@ class OrchestratorAgent extends core_1.AIAgent {
             });
         // Initialize state management config
         this.stateManagement = options.stateManagement;
+        this.concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
     }
     objective;
     planner;
     worker;
     completer;
     stateManagement;
+    concurrency;
     /**
      * Compress execution state to prevent context overflow
      * Uses reverse accumulation to efficiently find optimal task count
@@ -198,33 +235,31 @@ class OrchestratorAgent extends core_1.AIAgent {
                 executionState: compressedState,
                 ...(0, type_utils_js_1.pick)(input, this.planner.inputKeys),
             }, { ...options, model, streaming: false });
-            if (plan.finished || !plan.nextTask) {
+            if (plan.finished || !plan.nextTasks?.length) {
                 break;
             }
-            const task = plan.nextTask;
             const createdAt = Date.now();
-            const taskResult = await this.invokeChildAgent(this.worker, {
-                objective,
-                executionState: compressedState,
-                task,
-                ...(0, type_utils_js_1.pick)(input, this.worker.inputKeys),
-            }, { ...options, model, streaming: false })
-                .then((res) => {
-                if (res.error || res.success === false) {
-                    return { status: "failed", result: res.result, error: res.error };
-                }
-                return { status: "completed", result: res.result };
-            })
-                .catch((error) => ({
-                status: "failed",
-                error: { message: error instanceof Error ? error.message : String(error) },
-            }));
-            executionState.tasks.push({
-                ...taskResult,
-                task: task,
-                createdAt,
-                completedAt: Date.now(),
-            });
+            const queue = fastq.promise(async ({ task }) => {
+                const taskResult = await this.invokeChildAgent(this.worker, {
+                    objective,
+                    executionState: compressedState,
+                    task,
+                    ...(0, type_utils_js_1.pick)(input, this.worker.inputKeys),
+                }, { ...options, model, streaming: false })
+                    .then((res) => {
+                    if (res.error || res.success === false) {
+                        return { status: "failed", result: res.result, error: res.error };
+                    }
+                    return { status: "completed", result: res.result };
+                })
+                    .catch((error) => ({
+                    status: "failed",
+                    error: { message: error instanceof Error ? error.message : String(error) },
+                }));
+                return { ...taskResult, task, createdAt, completedAt: Date.now() };
+            }, plan.parallelTasks ? this.concurrency : 1);
+            const taskResults = await Promise.all(plan.nextTasks.map((task) => queue.push({ task })));
+            executionState.tasks.push(...taskResults);
         }
         // Compress state for completer input if needed
         const compressedState = this.compressState(executionState);
@@ -246,5 +281,6 @@ function getOrchestratorAgentSchema({ filepath }) {
         worker: (0, schema_js_1.optionalize)(nestAgentSchema),
         completer: (0, schema_js_1.optionalize)(nestAgentSchema),
         stateManagement: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(type_js_1.stateManagementOptionsSchema)),
+        concurrency: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(1).default(DEFAULT_CONCURRENCY)),
     }));
 }

package/lib/cjs/orchestrator/prompt.d.ts

@@ -1,3 +1,3 @@
 export declare const ORCHESTRATOR_COMPLETE_PROMPT = "You are an intelligent assistant that synthesizes and presents the results of completed tasks.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's latest objective you need to address\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Task\nBased on the execution results above, provide a comprehensive and helpful response to the user's objective.\n";
-export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next task based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTask\"\n2. **Worker** executes the task and updates the execution state\n3. **Loop back to step 1**, Planner plans the next task based on the new state\n4. **Repeat steps 1-3** until Planner determines the task is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan the Next Task\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan only one specific task at a time**: Don't try to plan all steps at once\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after each task completes, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- Gradually collect information, focusing on one aspect at a time\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTask: \"[task description]\" # optional, describe the next task to be performed to achieve the objective, null if no further tasks are needed\nfinished: false  # set to true if no further tasks are needed and the objective is achieved\n```\n\nNote: Task descriptions should be **goal-oriented**, not specifying concrete operations. Let the worker autonomously decide how to complete the task based on the task objective.\n";
+export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next tasks based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTasks\" (one or more tasks)\n2. **Worker** executes the tasks and updates the execution state\n3. **Loop back to step 1**, Planner plans the next tasks based on the new state\n4. **Repeat steps 1-3** until Planner determines the objective is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan Tasks\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan one or more tasks per iteration**: You can output multiple tasks when they are independent\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after tasks complete, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Parallel vs Sequential Execution\n\nYou can specify whether tasks should run in parallel or sequentially using `parallelTasks`.\n\n**IMPORTANT: When tasks run in parallel, they CANNOT see each other's results.** Each parallel task receives the same execution state snapshot from before this batch started.\n\n**Set `parallelTasks: true` ONLY when ALL conditions are met:**\n- Tasks operate on **completely independent** data sources or resources\n- Task results are **not needed by other tasks** in the same batch\n- Tasks have **no ordering requirements** between them\n- You are **100% certain** there are no dependencies\n\n**Set `parallelTasks: false` (default) when ANY of these apply:**\n- Any task needs results from another task in the same batch\n- Tasks must be executed in a specific order\n- Tasks operate on shared resources that could conflict\n- You are **uncertain** whether tasks are truly independent\n\n**When in doubt, use sequential execution.** It's safer to be slower than to produce incorrect results.\n\n### 5. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- If exploring multiple independent sources, consider parallel execution\n\n**Processing Stage**:\n- Process gathered information\n- Use sequential execution when processing depends on previous results\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTasks:            # List of tasks to execute (omit if finished)\n  - \"task description 1\"\n  - \"task description 2\"\nparallelTasks: false  # true if tasks can run in parallel, false for sequential (default: false)\nfinished: false       # true if objective is achieved and no more tasks needed\n```\n\n**Notes:**\n- Task descriptions should be **goal-oriented**, not specifying concrete operations\n- Let the worker autonomously decide how to complete each task\n- Default to sequential execution (`parallelTasks: false`) unless you're certain tasks are independent\n- When `finished: true`, omit `nextTasks`\n";
 export declare const TODO_WORKER_PROMPT_TEMPLATE = "You are a task execution agent. Your job is to execute the specific task assigned to you - nothing more, nothing less.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's objective provide for context only\"\n{{ objective }}\n```\n\n**CRITICAL CONSTRAINT**: The objective above is provided ONLY for context. You must NOT attempt to:\n- Solve the entire objective\n- Plan additional steps beyond your current task\n- Make decisions about what should happen next\n- Execute any tasks other than the one explicitly assigned to you below\n\n## Latest Execution State\n\n```yaml alt=\"The latest execution state for your reference\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Current Task\n\n```txt alt=\"The specific task you need to execute now\"\n{{ task }}\n```\n\n## Important Instructions\n- Focus EXCLUSIVELY on completing the current task described above\n- The task is self-contained - execute it completely and accurately\n- Do NOT perform additional tasks beyond what is specified\n- Do NOT try to determine what should happen after this task\n- Use the available tools and skills to accomplish this specific task\n- Return a clear result that the planner can use to decide the next step\n\n## Output Format\nReturn your task execution result as a structured response. The output schema will guide you on the required fields.\n";

package/lib/cjs/orchestrator/prompt.js

@@ -31,16 +31,16 @@ ${"```"}
 Based on the execution results above, provide a comprehensive and helpful response to the user's objective.
 `;
 exports.TODO_PLANNER_PROMPT_TEMPLATE = `\
-Your responsibility is to decide the next task based on the current execution state.
+Your responsibility is to decide the next tasks based on the current execution state.
 
 ## Responsibilities
 
 You are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:
 
-1. **Planner (you)** analyzes the current state and outputs "nextTask"
-2. **Worker** executes the task and updates the execution state
-3. **Loop back to step 1**, Planner plans the next task based on the new state
-4. **Repeat steps 1-3** until Planner determines the task is complete
+1. **Planner (you)** analyzes the current state and outputs "nextTasks" (one or more tasks)
+2. **Worker** executes the tasks and updates the execution state
+3. **Loop back to step 1**, Planner plans the next tasks based on the new state
+4. **Repeat steps 1-3** until Planner determines the objective is complete
 5. **Planner** sets "finished: true"
 6. **Completer** generates the final report and returns it to the user
 
@@ -67,7 +67,7 @@ ${"```"}yaml alt="The latest execution state"
 {{ executionState | yaml.stringify }}
 ${"```"}
 
-## How to Plan the Next Task
+## How to Plan Tasks
 
 ### 1. Determine if Tasks Are Needed
 
@@ -100,20 +100,44 @@ If tasks are needed, think about the current state and objective:
 
 ### 3. Decision Principles
 
-- **Plan only one specific task at a time**: Don't try to plan all steps at once
+- **Plan one or more tasks per iteration**: You can output multiple tasks when they are independent
 - **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker
-- **Trust the iterative process**: You will be called again after each task completes, allowing you to adjust the plan dynamically
+- **Trust the iterative process**: You will be called again after tasks complete, allowing you to adjust the plan dynamically
 - **Avoid duplicate work**: Review the execution history to understand what has been completed
 - **Goal-oriented descriptions**: Task descriptions should state "what to do", not "how to do it"
 - **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach
 
-### 4. Decision Making at Different Stages
+### 4. Parallel vs Sequential Execution
+
+You can specify whether tasks should run in parallel or sequentially using \`parallelTasks\`.
+
+**IMPORTANT: When tasks run in parallel, they CANNOT see each other's results.** Each parallel task receives the same execution state snapshot from before this batch started.
+
+**Set \`parallelTasks: true\` ONLY when ALL conditions are met:**
+- Tasks operate on **completely independent** data sources or resources
+- Task results are **not needed by other tasks** in the same batch
+- Tasks have **no ordering requirements** between them
+- You are **100% certain** there are no dependencies
+
+**Set \`parallelTasks: false\` (default) when ANY of these apply:**
+- Any task needs results from another task in the same batch
+- Tasks must be executed in a specific order
+- Tasks operate on shared resources that could conflict
+- You are **uncertain** whether tasks are truly independent
+
+**When in doubt, use sequential execution.** It's safer to be slower than to produce incorrect results.
+
+### 5. Decision Making at Different Stages
 
 Flexibly decide the next step based on current progress:
 
 **Exploration Stage**:
 - Plan exploration tasks to gather required information
-- Gradually collect information, focusing on one aspect at a time
+- If exploring multiple independent sources, consider parallel execution
+
+**Processing Stage**:
+- Process gathered information
+- Use sequential execution when processing depends on previous results
 
 **Summary Stage**:
 - When sufficient information is collected, plan to generate a summary or report task
@@ -135,11 +159,18 @@ Each task in the execution state has a status:
 ## Output Format
 
 ${"```"}yaml
-nextTask: "[task description]" # optional, describe the next task to be performed to achieve the objective, null if no further tasks are needed
-finished: false  # set to true if no further tasks are needed and the objective is achieved
+nextTasks:            # List of tasks to execute (omit if finished)
+  - "task description 1"
+  - "task description 2"
+parallelTasks: false  # true if tasks can run in parallel, false for sequential (default: false)
+finished: false       # true if objective is achieved and no more tasks needed
 ${"```"}
 
-Note: Task descriptions should be **goal-oriented**, not specifying concrete operations. Let the worker autonomously decide how to complete the task based on the task objective.
+**Notes:**
+- Task descriptions should be **goal-oriented**, not specifying concrete operations
+- Let the worker autonomously decide how to complete each task
+- Default to sequential execution (\`parallelTasks: false\`) unless you're certain tasks are independent
+- When \`finished: true\`, omit \`nextTasks\`
 `;
 exports.TODO_WORKER_PROMPT_TEMPLATE = `\
 You are a task execution agent. Your job is to execute the specific task assigned to you - nothing more, nothing less.

package/lib/cjs/orchestrator/type.d.ts

@@ -176,17 +176,21 @@ export declare const plannerInputSchema: z.ZodObject<{
     } | undefined;
 }>;
 export interface PlannerOutput extends Message {
-    nextTask?: string;
+    nextTasks?: string[];
+    parallelTasks?: boolean;
     finished?: boolean;
 }
 export declare const plannerOutputSchema: z.ZodObject<{
-    nextTask: z.ZodOptional<z.ZodString>;
+    nextTasks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    parallelTasks: z.ZodOptional<z.ZodBoolean>;
     finished: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }>;
 export interface WorkerInput extends Message {

package/lib/cjs/orchestrator/type.js

@@ -31,14 +31,23 @@ exports.plannerInputSchema = zod_1.default.object({
     executionState: (0, schema_js_1.optionalize)(exports.executionStateSchema),
 });
 exports.plannerOutputSchema = zod_1.default.object({
-    nextTask: zod_1.default
-        .string()
+    nextTasks: zod_1.default
+        .array(zod_1.default.string())
         .optional()
         .describe(`\
-The next task to be executed by the worker.
-Provide a clear, actionable task description that specifies what needs to be done.
+The next tasks to be executed by the worker.
+Provide clear, actionable task descriptions that specify what needs to be done.
 Include relevant context from previous task results if needed for execution.
 Omit this field when all necessary work has been completed.
+`),
+    parallelTasks: zod_1.default
+        .boolean()
+        .optional()
+        .describe(`\
+Indicates whether the next tasks can be executed in parallel.
+Set to true if tasks are independent and can run simultaneously.
+Set to false if tasks must be executed sequentially.
+default is false.
 `),
     finished: zod_1.default
         .boolean()

package/lib/dts/orchestrator/index.d.ts

@@ -15,6 +15,7 @@ export interface OrchestratorAgentOptions<I extends Message = Message, O extends
      * Prevents context overflow during long-running executions
      */
     stateManagement?: StateManagementOptions;
+    concurrency?: number;
 }
 export interface LoadOrchestratorAgentOptions<I extends Message = Message, O extends Message = Message> extends Omit<AIAgentOptions<I, O>, "instructions"> {
     objective?: string | PromptBuilder | Instructions;
@@ -67,6 +68,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private worker;
     private completer;
     private stateManagement?;
+    private concurrency;
     /**
      * Compress execution state to prevent context overflow
      * Uses reverse accumulation to efficiently find optimal task count

package/lib/dts/orchestrator/prompt.d.ts

@@ -1,3 +1,3 @@
 export declare const ORCHESTRATOR_COMPLETE_PROMPT = "You are an intelligent assistant that synthesizes and presents the results of completed tasks.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's latest objective you need to address\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Task\nBased on the execution results above, provide a comprehensive and helpful response to the user's objective.\n";
-export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next task based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTask\"\n2. **Worker** executes the task and updates the execution state\n3. **Loop back to step 1**, Planner plans the next task based on the new state\n4. **Repeat steps 1-3** until Planner determines the task is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan the Next Task\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan only one specific task at a time**: Don't try to plan all steps at once\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after each task completes, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- Gradually collect information, focusing on one aspect at a time\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTask: \"[task description]\" # optional, describe the next task to be performed to achieve the objective, null if no further tasks are needed\nfinished: false  # set to true if no further tasks are needed and the objective is achieved\n```\n\nNote: Task descriptions should be **goal-oriented**, not specifying concrete operations. Let the worker autonomously decide how to complete the task based on the task objective.\n";
+export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next tasks based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTasks\" (one or more tasks)\n2. **Worker** executes the tasks and updates the execution state\n3. **Loop back to step 1**, Planner plans the next tasks based on the new state\n4. **Repeat steps 1-3** until Planner determines the objective is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan Tasks\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan one or more tasks per iteration**: You can output multiple tasks when they are independent\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after tasks complete, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Parallel vs Sequential Execution\n\nYou can specify whether tasks should run in parallel or sequentially using `parallelTasks`.\n\n**IMPORTANT: When tasks run in parallel, they CANNOT see each other's results.** Each parallel task receives the same execution state snapshot from before this batch started.\n\n**Set `parallelTasks: true` ONLY when ALL conditions are met:**\n- Tasks operate on **completely independent** data sources or resources\n- Task results are **not needed by other tasks** in the same batch\n- Tasks have **no ordering requirements** between them\n- You are **100% certain** there are no dependencies\n\n**Set `parallelTasks: false` (default) when ANY of these apply:**\n- Any task needs results from another task in the same batch\n- Tasks must be executed in a specific order\n- Tasks operate on shared resources that could conflict\n- You are **uncertain** whether tasks are truly independent\n\n**When in doubt, use sequential execution.** It's safer to be slower than to produce incorrect results.\n\n### 5. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- If exploring multiple independent sources, consider parallel execution\n\n**Processing Stage**:\n- Process gathered information\n- Use sequential execution when processing depends on previous results\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTasks:            # List of tasks to execute (omit if finished)\n  - \"task description 1\"\n  - \"task description 2\"\nparallelTasks: false  # true if tasks can run in parallel, false for sequential (default: false)\nfinished: false       # true if objective is achieved and no more tasks needed\n```\n\n**Notes:**\n- Task descriptions should be **goal-oriented**, not specifying concrete operations\n- Let the worker autonomously decide how to complete each task\n- Default to sequential execution (`parallelTasks: false`) unless you're certain tasks are independent\n- When `finished: true`, omit `nextTasks`\n";
 export declare const TODO_WORKER_PROMPT_TEMPLATE = "You are a task execution agent. Your job is to execute the specific task assigned to you - nothing more, nothing less.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's objective provide for context only\"\n{{ objective }}\n```\n\n**CRITICAL CONSTRAINT**: The objective above is provided ONLY for context. You must NOT attempt to:\n- Solve the entire objective\n- Plan additional steps beyond your current task\n- Make decisions about what should happen next\n- Execute any tasks other than the one explicitly assigned to you below\n\n## Latest Execution State\n\n```yaml alt=\"The latest execution state for your reference\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Current Task\n\n```txt alt=\"The specific task you need to execute now\"\n{{ task }}\n```\n\n## Important Instructions\n- Focus EXCLUSIVELY on completing the current task described above\n- The task is self-contained - execute it completely and accurately\n- Do NOT perform additional tasks beyond what is specified\n- Do NOT try to determine what should happen after this task\n- Use the available tools and skills to accomplish this specific task\n- Return a clear result that the planner can use to decide the next step\n\n## Output Format\nReturn your task execution result as a structured response. The output schema will guide you on the required fields.\n";

package/lib/dts/orchestrator/type.d.ts

@@ -176,17 +176,21 @@ export declare const plannerInputSchema: z.ZodObject<{
     } | undefined;
 }>;
 export interface PlannerOutput extends Message {
-    nextTask?: string;
+    nextTasks?: string[];
+    parallelTasks?: boolean;
     finished?: boolean;
 }
 export declare const plannerOutputSchema: z.ZodObject<{
-    nextTask: z.ZodOptional<z.ZodString>;
+    nextTasks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    parallelTasks: z.ZodOptional<z.ZodBoolean>;
     finished: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }>;
 export interface WorkerInput extends Message {

package/lib/esm/orchestrator/index.d.ts

@@ -15,6 +15,7 @@ export interface OrchestratorAgentOptions<I extends Message = Message, O extends
      * Prevents context overflow during long-running executions
      */
     stateManagement?: StateManagementOptions;
+    concurrency?: number;
 }
 export interface LoadOrchestratorAgentOptions<I extends Message = Message, O extends Message = Message> extends Omit<AIAgentOptions<I, O>, "instructions"> {
     objective?: string | PromptBuilder | Instructions;
@@ -67,6 +68,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private worker;
     private completer;
     private stateManagement?;
+    private concurrency;
     /**
      * Compress execution state to prevent context overflow
      * Uses reverse accumulation to efficiently find optimal task count

package/lib/esm/orchestrator/index.js

@@ -3,6 +3,7 @@ import { getInstructionsSchema, getNestAgentSchema, } from "@aigne/core/loader/a
 import { instructionsToPromptBuilder, loadNestAgent, } from "@aigne/core/loader/index.js";
 import { camelizeSchema, optionalize } from "@aigne/core/loader/schema.js";
 import { isAgent } from "@aigne/core/utils/agent-utils.js";
+import * as fastq from "@aigne/core/utils/queue.js";
 import { estimateTokens } from "@aigne/core/utils/token-estimator.js";
 import { omit, pick } from "@aigne/core/utils/type-utils.js";
 import { z } from "zod";
@@ -35,6 +36,7 @@ const defaultCompleterOptions = {
         disabled: true,
     },
 };
+const DEFAULT_CONCURRENCY = 5;
 /**
  * Orchestrator Agent Class
  *
@@ -120,12 +122,14 @@ export class OrchestratorAgent extends AIAgent {
             });
         // Initialize state management config
         this.stateManagement = options.stateManagement;
+        this.concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
     }
     objective;
     planner;
     worker;
     completer;
     stateManagement;
+    concurrency;
     /**
      * Compress execution state to prevent context overflow
      * Uses reverse accumulation to efficiently find optimal task count
@@ -195,33 +199,31 @@ export class OrchestratorAgent extends AIAgent {
                 executionState: compressedState,
                 ...pick(input, this.planner.inputKeys),
             }, { ...options, model, streaming: false });
-            if (plan.finished || !plan.nextTask) {
+            if (plan.finished || !plan.nextTasks?.length) {
                 break;
             }
-            const task = plan.nextTask;
             const createdAt = Date.now();
-            const taskResult = await this.invokeChildAgent(this.worker, {
-                objective,
-                executionState: compressedState,
-                task,
-                ...pick(input, this.worker.inputKeys),
-            }, { ...options, model, streaming: false })
-                .then((res) => {
-                if (res.error || res.success === false) {
-                    return { status: "failed", result: res.result, error: res.error };
-                }
-                return { status: "completed", result: res.result };
-            })
-                .catch((error) => ({
-                status: "failed",
-                error: { message: error instanceof Error ? error.message : String(error) },
-            }));
-            executionState.tasks.push({
-                ...taskResult,
-                task: task,
-                createdAt,
-                completedAt: Date.now(),
-            });
+            const queue = fastq.promise(async ({ task }) => {
+                const taskResult = await this.invokeChildAgent(this.worker, {
+                    objective,
+                    executionState: compressedState,
+                    task,
+                    ...pick(input, this.worker.inputKeys),
+                }, { ...options, model, streaming: false })
+                    .then((res) => {
+                    if (res.error || res.success === false) {
+                        return { status: "failed", result: res.result, error: res.error };
+                    }
+                    return { status: "completed", result: res.result };
+                })
+                    .catch((error) => ({
+                    status: "failed",
+                    error: { message: error instanceof Error ? error.message : String(error) },
+                }));
+                return { ...taskResult, task, createdAt, completedAt: Date.now() };
+            }, plan.parallelTasks ? this.concurrency : 1);
+            const taskResults = await Promise.all(plan.nextTasks.map((task) => queue.push({ task })));
+            executionState.tasks.push(...taskResults);
         }
         // Compress state for completer input if needed
         const compressedState = this.compressState(executionState);
@@ -242,5 +244,6 @@ function getOrchestratorAgentSchema({ filepath }) {
         worker: optionalize(nestAgentSchema),
         completer: optionalize(nestAgentSchema),
         stateManagement: optionalize(camelizeSchema(stateManagementOptionsSchema)),
+        concurrency: optionalize(z.number().int().min(1).default(DEFAULT_CONCURRENCY)),
     }));
 }

package/lib/esm/orchestrator/prompt.d.ts

@@ -1,3 +1,3 @@
 export declare const ORCHESTRATOR_COMPLETE_PROMPT = "You are an intelligent assistant that synthesizes and presents the results of completed tasks.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's latest objective you need to address\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Task\nBased on the execution results above, provide a comprehensive and helpful response to the user's objective.\n";
-export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next task based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTask\"\n2. **Worker** executes the task and updates the execution state\n3. **Loop back to step 1**, Planner plans the next task based on the new state\n4. **Repeat steps 1-3** until Planner determines the task is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan the Next Task\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan only one specific task at a time**: Don't try to plan all steps at once\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after each task completes, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- Gradually collect information, focusing on one aspect at a time\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTask: \"[task description]\" # optional, describe the next task to be performed to achieve the objective, null if no further tasks are needed\nfinished: false  # set to true if no further tasks are needed and the objective is achieved\n```\n\nNote: Task descriptions should be **goal-oriented**, not specifying concrete operations. Let the worker autonomously decide how to complete the task based on the task objective.\n";
+export declare const TODO_PLANNER_PROMPT_TEMPLATE = "Your responsibility is to decide the next tasks based on the current execution state.\n\n## Responsibilities\n\nYou are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:\n\n1. **Planner (you)** analyzes the current state and outputs \"nextTasks\" (one or more tasks)\n2. **Worker** executes the tasks and updates the execution state\n3. **Loop back to step 1**, Planner plans the next tasks based on the new state\n4. **Repeat steps 1-3** until Planner determines the objective is complete\n5. **Planner** sets \"finished: true\"\n6. **Completer** generates the final report and returns it to the user\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's next objective you need to plan for\"\n{{ objective }}\n```\n\n## Current Execution State\n\n```yaml alt=\"The latest execution state\"\n{{ executionState | yaml.stringify }}\n```\n\n## How to Plan Tasks\n\n### 1. Determine if Tasks Are Needed\n\nFirst, assess whether the objective requires any tasks at all. Ask yourself:\n\n**Does this objective require tasks?**\n\nConsider if completing the objective needs:\n- **Information gathering**: Does it need to collect or retrieve information?\n- **Analysis or processing**: Does it need to analyze, process, or compute something?\n- **State dependency**: Does it depend on information not yet in the execution state?\n\n**Set \"finished: true\" immediately when:**\n- The objective requires no exploration, analysis, or information gathering\n- The current execution state already contains everything needed to respond\n- The objective is purely conversational without requiring any action\n\n**Plan tasks when:**\n- The objective requires gathering information from external sources\n- The objective requires analysis, processing, or computation to be performed\n- Additional information must be collected before a complete response can be given\n\n### 2. Analyze Information Requirements\n\nIf tasks are needed, think about the current state and objective:\n- What information is needed to complete the objective?\n- Where can this information be obtained from?\n- What information has already been collected? What is still missing?\n- Is deeper exploration needed, or is it ready to generate a summary?\n\n### 3. Decision Principles\n\n- **Plan one or more tasks per iteration**: You can output multiple tasks when they are independent\n- **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker\n- **Trust the iterative process**: You will be called again after tasks complete, allowing you to adjust the plan dynamically\n- **Avoid duplicate work**: Review the execution history to understand what has been completed\n- **Goal-oriented descriptions**: Task descriptions should state \"what to do\", not \"how to do it\"\n- **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach\n\n### 4. Parallel vs Sequential Execution\n\nYou can specify whether tasks should run in parallel or sequentially using `parallelTasks`.\n\n**IMPORTANT: When tasks run in parallel, they CANNOT see each other's results.** Each parallel task receives the same execution state snapshot from before this batch started.\n\n**Set `parallelTasks: true` ONLY when ALL conditions are met:**\n- Tasks operate on **completely independent** data sources or resources\n- Task results are **not needed by other tasks** in the same batch\n- Tasks have **no ordering requirements** between them\n- You are **100% certain** there are no dependencies\n\n**Set `parallelTasks: false` (default) when ANY of these apply:**\n- Any task needs results from another task in the same batch\n- Tasks must be executed in a specific order\n- Tasks operate on shared resources that could conflict\n- You are **uncertain** whether tasks are truly independent\n\n**When in doubt, use sequential execution.** It's safer to be slower than to produce incorrect results.\n\n### 5. Decision Making at Different Stages\n\nFlexibly decide the next step based on current progress:\n\n**Exploration Stage**:\n- Plan exploration tasks to gather required information\n- If exploring multiple independent sources, consider parallel execution\n\n**Processing Stage**:\n- Process gathered information\n- Use sequential execution when processing depends on previous results\n\n**Summary Stage**:\n- When sufficient information is collected, plan to generate a summary or report task\n\n**Completion Stage**:\n- Set \"finished: true\" when:\n  - The objective doesn't require any tasks\n  - All necessary tasks are completed\n  - The objective is fully achieved\n- This will trigger the Completer to integrate all information and generate the final report\n\n## Understanding Task Status\n\nEach task in the execution state has a status:\n- **completed**: Task finished successfully, result is available\n- **failed**: Task encountered an error, check error field for details\n- **pending**: Task has not been executed yet\n\n## Output Format\n\n```yaml\nnextTasks:            # List of tasks to execute (omit if finished)\n  - \"task description 1\"\n  - \"task description 2\"\nparallelTasks: false  # true if tasks can run in parallel, false for sequential (default: false)\nfinished: false       # true if objective is achieved and no more tasks needed\n```\n\n**Notes:**\n- Task descriptions should be **goal-oriented**, not specifying concrete operations\n- Let the worker autonomously decide how to complete each task\n- Default to sequential execution (`parallelTasks: false`) unless you're certain tasks are independent\n- When `finished: true`, omit `nextTasks`\n";
 export declare const TODO_WORKER_PROMPT_TEMPLATE = "You are a task execution agent. Your job is to execute the specific task assigned to you - nothing more, nothing less.\n\n{% if $afs.enabled %}\n## Environment\n\n### AFS\n{{ $afs.description }}\n\n```yaml alt=\"The modules available in the AFS\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n## User's Objective\n\n```txt alt=\"The user's objective provide for context only\"\n{{ objective }}\n```\n\n**CRITICAL CONSTRAINT**: The objective above is provided ONLY for context. You must NOT attempt to:\n- Solve the entire objective\n- Plan additional steps beyond your current task\n- Make decisions about what should happen next\n- Execute any tasks other than the one explicitly assigned to you below\n\n## Latest Execution State\n\n```yaml alt=\"The latest execution state for your reference\"\n{{ executionState | yaml.stringify }}\n```\n\n## Your Current Task\n\n```txt alt=\"The specific task you need to execute now\"\n{{ task }}\n```\n\n## Important Instructions\n- Focus EXCLUSIVELY on completing the current task described above\n- The task is self-contained - execute it completely and accurately\n- Do NOT perform additional tasks beyond what is specified\n- Do NOT try to determine what should happen after this task\n- Use the available tools and skills to accomplish this specific task\n- Return a clear result that the planner can use to decide the next step\n\n## Output Format\nReturn your task execution result as a structured response. The output schema will guide you on the required fields.\n";

package/lib/esm/orchestrator/prompt.js

@@ -28,16 +28,16 @@ ${"```"}
 Based on the execution results above, provide a comprehensive and helpful response to the user's objective.
 `;
 export const TODO_PLANNER_PROMPT_TEMPLATE = `\
-Your responsibility is to decide the next task based on the current execution state.
+Your responsibility is to decide the next tasks based on the current execution state.
 
 ## Responsibilities
 
 You are the Planner in the Orchestrator. The entire Orchestrator completes tasks through collaboration of three roles:
 
-1. **Planner (you)** analyzes the current state and outputs "nextTask"
-2. **Worker** executes the task and updates the execution state
-3. **Loop back to step 1**, Planner plans the next task based on the new state
-4. **Repeat steps 1-3** until Planner determines the task is complete
+1. **Planner (you)** analyzes the current state and outputs "nextTasks" (one or more tasks)
+2. **Worker** executes the tasks and updates the execution state
+3. **Loop back to step 1**, Planner plans the next tasks based on the new state
+4. **Repeat steps 1-3** until Planner determines the objective is complete
 5. **Planner** sets "finished: true"
 6. **Completer** generates the final report and returns it to the user
 
@@ -64,7 +64,7 @@ ${"```"}yaml alt="The latest execution state"
 {{ executionState | yaml.stringify }}
 ${"```"}
 
-## How to Plan the Next Task
+## How to Plan Tasks
 
 ### 1. Determine if Tasks Are Needed
 
@@ -97,20 +97,44 @@ If tasks are needed, think about the current state and objective:
 
 ### 3. Decision Principles
 
-- **Plan only one specific task at a time**: Don't try to plan all steps at once
+- **Plan one or more tasks per iteration**: You can output multiple tasks when they are independent
 - **Only decide, don't execute**: You only output task descriptions, actual execution is done by the Worker
-- **Trust the iterative process**: You will be called again after each task completes, allowing you to adjust the plan dynamically
+- **Trust the iterative process**: You will be called again after tasks complete, allowing you to adjust the plan dynamically
 - **Avoid duplicate work**: Review the execution history to understand what has been completed
 - **Goal-oriented descriptions**: Task descriptions should state "what to do", not "how to do it"
 - **Handle failures appropriately**: If a previous task failed, decide whether to retry, skip, or use an alternative approach
 
-### 4. Decision Making at Different Stages
+### 4. Parallel vs Sequential Execution
+
+You can specify whether tasks should run in parallel or sequentially using \`parallelTasks\`.
+
+**IMPORTANT: When tasks run in parallel, they CANNOT see each other's results.** Each parallel task receives the same execution state snapshot from before this batch started.
+
+**Set \`parallelTasks: true\` ONLY when ALL conditions are met:**
+- Tasks operate on **completely independent** data sources or resources
+- Task results are **not needed by other tasks** in the same batch
+- Tasks have **no ordering requirements** between them
+- You are **100% certain** there are no dependencies
+
+**Set \`parallelTasks: false\` (default) when ANY of these apply:**
+- Any task needs results from another task in the same batch
+- Tasks must be executed in a specific order
+- Tasks operate on shared resources that could conflict
+- You are **uncertain** whether tasks are truly independent
+
+**When in doubt, use sequential execution.** It's safer to be slower than to produce incorrect results.
+
+### 5. Decision Making at Different Stages
 
 Flexibly decide the next step based on current progress:
 
 **Exploration Stage**:
 - Plan exploration tasks to gather required information
-- Gradually collect information, focusing on one aspect at a time
+- If exploring multiple independent sources, consider parallel execution
+
+**Processing Stage**:
+- Process gathered information
+- Use sequential execution when processing depends on previous results
 
 **Summary Stage**:
 - When sufficient information is collected, plan to generate a summary or report task
@@ -132,11 +156,18 @@ Each task in the execution state has a status:
 ## Output Format
 
 ${"```"}yaml
-nextTask: "[task description]" # optional, describe the next task to be performed to achieve the objective, null if no further tasks are needed
-finished: false  # set to true if no further tasks are needed and the objective is achieved
+nextTasks:            # List of tasks to execute (omit if finished)
+  - "task description 1"
+  - "task description 2"
+parallelTasks: false  # true if tasks can run in parallel, false for sequential (default: false)
+finished: false       # true if objective is achieved and no more tasks needed
 ${"```"}
 
-Note: Task descriptions should be **goal-oriented**, not specifying concrete operations. Let the worker autonomously decide how to complete the task based on the task objective.
+**Notes:**
+- Task descriptions should be **goal-oriented**, not specifying concrete operations
+- Let the worker autonomously decide how to complete each task
+- Default to sequential execution (\`parallelTasks: false\`) unless you're certain tasks are independent
+- When \`finished: true\`, omit \`nextTasks\`
 `;
 export const TODO_WORKER_PROMPT_TEMPLATE = `\
 You are a task execution agent. Your job is to execute the specific task assigned to you - nothing more, nothing less.

package/lib/esm/orchestrator/type.d.ts

@@ -176,17 +176,21 @@ export declare const plannerInputSchema: z.ZodObject<{
     } | undefined;
 }>;
 export interface PlannerOutput extends Message {
-    nextTask?: string;
+    nextTasks?: string[];
+    parallelTasks?: boolean;
     finished?: boolean;
 }
 export declare const plannerOutputSchema: z.ZodObject<{
-    nextTask: z.ZodOptional<z.ZodString>;
+    nextTasks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    parallelTasks: z.ZodOptional<z.ZodBoolean>;
     finished: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }, {
-    nextTask?: string | undefined;
+    nextTasks?: string[] | undefined;
+    parallelTasks?: boolean | undefined;
     finished?: boolean | undefined;
 }>;
 export interface WorkerInput extends Message {

package/lib/esm/orchestrator/type.js

@@ -25,14 +25,23 @@ export const plannerInputSchema = z.object({
     executionState: optionalize(executionStateSchema),
 });
 export const plannerOutputSchema = z.object({
-    nextTask: z
-        .string()
+    nextTasks: z
+        .array(z.string())
         .optional()
         .describe(`\
-The next task to be executed by the worker.
-Provide a clear, actionable task description that specifies what needs to be done.
+The next tasks to be executed by the worker.
+Provide clear, actionable task descriptions that specify what needs to be done.
 Include relevant context from previous task results if needed for execution.
 Omit this field when all necessary work has been completed.
+`),
+    parallelTasks: z
+        .boolean()
+        .optional()
+        .describe(`\
+Indicates whether the next tasks can be executed in parallel.
+Set to true if tasks are independent and can run simultaneously.
+Set to false if tasks must be executed sequentially.
+default is false.
 `),
     finished: z
         .boolean()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/agent-library",
-  "version": "1.23.0",
+  "version": "1.24.0-beta.2",
   "description": "Collection of agent libraries for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -57,9 +57,9 @@
     "yaml": "^2.8.1",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/openai": "^0.16.15",
-    "@aigne/core": "^1.71.0",
-    "@aigne/sqlite": "^0.4.8"
+    "@aigne/core": "^1.72.0-beta.2",
+    "@aigne/sqlite": "^0.4.9-beta",
+    "@aigne/openai": "^0.16.16-beta.2"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",