@eko-ai/eko 3.0.8 → 3.0.9

package/README.md

@@ -15,6 +15,22 @@
 
 Eko (pronounced like 'echo') is a production-ready JavaScript framework that enables developers to create reliable agents, **from simple commands to complex workflows**. It provides a unified interface for running agents in both **computer and browser environments**.
 
+## News
+
+- **2025-09:** Eko 3.0 introduces dependency-aware parallel agent execution.
+- **2025-09:** New pause, resume, and interrupt controls with `task_snapshot` workflow recovery.
+- **2025-09:** Monorepo tooling migrated to pnpm for consistent workspace management.
+
+## Upgrading to Eko 3.0
+
+Follow these steps when moving an existing Eko 2.x project to 3.0:
+
+1. Update dependencies with `pnpm up @eko-ai/eko @eko-ai/eko-nodejs @eko-ai/eko-web @eko-ai/eko-extension`.
+2. Regenerate saved workflows or exported plans so they use the v3 schema and dependency graph format.
+3. Clean and reinstall using pnpm (`rm -rf node_modules && pnpm install`), then rebuild any browser or desktop bundles.
+4. Re-run automated demos and update documentation to reflect the new pause/interrupt APIs and parallel agent behavior.
+
+
 ## Framework Comparison
 
 | Feature                              | Eko   | Langchain  | Browser-use  | Dify.ai  | Coze   |
@@ -83,6 +99,41 @@ let result = await eko.run("Search for the latest news about Musk, summarize and
 $ pnpm install @eko-ai/eko
 ```
 
+## Example Projects
+
+The repository ships with three workspace examples under the `example/` folder. After running the
+core install (`pnpm install`) you can launch any of them with the commands below. Each example
+consumes the local 3.0 packages, so rebuilding the main workspace automatically refreshes them.
+
+### Browser Extension (`example/extension`)
+
+```bash
+pnpm --filter @eko-ai/eko-extension build
+pnpm --filter @eko-ai/eko-extension-example run build
+```
+
+Load the generated `example/extension/dist` directory via `chrome://extensions` → Developer Mode →
+Load unpacked. Configure your API key in the extension options before running the automation task.
+
+### Node.js Automation (`example/nodejs`)
+
+```bash
+pnpm --filter @eko-ai/eko-nodejs-example run build
+pnpm --filter @eko-ai/eko-nodejs-example run playwright   # first time only, installs browsers
+OPENAI_API_KEY=... ANTHROPIC_API_KEY=... pnpm --filter @eko-ai/eko-nodejs-example run start
+```
+
+The Node.js demo drives Playwright through Eko; provide at least one model API key before running it.
+
+### Web Login Demo (`example/web`)
+
+```bash
+pnpm --filter @eko-ai/eko-web-example run start
+```
+
+This starts a React dev server on the default port with a simple login flow that you can automate
+with the browser or web agents.
+
 ## Use Cases
 
 - Browser automation and web scraping
@@ -116,7 +167,19 @@ Eko can be used in multiple environments:
 
 [![Star History Chart](https://api.star-history.com/svg?repos=FellouAI/eko&type=Date)](https://star-history.com/#FellouAI/eko&Date)
 
+
+## Community Spotlight
+
+- **Career Co-Pilot**: https://github.com/wangwangbobo/career_skill_learnig.git
+- **Slides Agent by Eko**: https://github.com/MICAHFANG/slides-agent-by-eko
+- **Universal Sidebar Assistant**: https://github.com/San12341/eko-broser-extension.git
+- **48 Hour Browser Challenge**: https://github.com/MoonIRL/eko
+- **Orbit X Smart Terminal**: https://github.com/Skywang16/OrbitX/tree/main
+- **EkoMeet Recommender**: https://github.com/JasonRobertDestiny/EkoMeet
+- **Vision-Eko Plugin**: https://github.com/dcpwilliam/vision-eko/tree/main/serviceNowPlugin
+- **IC Cafe Platform**: https://cnb.cool/giggle_giraffe/ic-info-wxapp
+- **AI Monitoring Assistant**: https://github.com/yuhoudecheqiancao/eko-ai-monitoring
+
 ## License
 
 Eko is released under the MIT License. See the [LICENSE](LICENSE) file for details.
-

package/dist/agent/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agent/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agent/base.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs.js

@@ -34261,7 +34261,10 @@ class SimpleSseMcpClient {
                 version: "1.0.0",
             },
         });
-        // this.request("notifications/initialized", {});
+        try {
+            await this.request("notifications/initialized", {});
+        }
+        catch (ignored) { }
     }
     ping() {
         this.request("ping", {});
@@ -34279,7 +34282,7 @@ class SimpleSseMcpClient {
         return message.result;
     }
     async request(method, params, signal) {
-        const id = uuidv4();
+        const id = method.startsWith("notifications/") ? undefined : uuidv4();
         try {
             const callback = new Promise((resolve, reject) => {
                 if (signal) {
@@ -34289,7 +34292,7 @@ class SimpleSseMcpClient {
                         reject(error);
                     });
                 }
-                this.requestMap.set(id, resolve);
+                id && this.requestMap.set(id, resolve);
             });
             Log.debug(`MCP Client, ${method}`, id, params);
             const response = await fetch(this.msgUrl, {
@@ -34336,7 +34339,7 @@ class SimpleSseMcpClient {
             }
         }
         finally {
-            this.requestMap.delete(id);
+            id && this.requestMap.delete(id);
         }
     }
     isConnected() {
@@ -34346,6 +34349,13 @@ class SimpleSseMcpClient {
         return false;
     }
     async close() {
+        try {
+            await this.request("notifications/cancelled", {
+                requestId: uuidv4(),
+                reason: "User requested cancellation",
+            });
+        }
+        catch (ignored) { }
         this.pingTimer && clearInterval(this.pingTimer);
         this.reconnectTimer && clearTimeout(this.reconnectTimer);
         this.sseHandler && this.sseHandler.close && this.sseHandler.close();
@@ -34458,6 +34468,12 @@ class SimpleHttpMcpClient {
                 version: "1.0.0",
             },
         }, signal);
+        if (this.mcpSessionId) {
+            try {
+                await this.request("notifications/initialized", {});
+            }
+            catch (ignored) { }
+        }
         this.connected = true;
     }
     async listTools(param, signal) {
@@ -34478,16 +34494,19 @@ class SimpleHttpMcpClient {
     async close() {
         this.connected = false;
         if (this.mcpSessionId) {
-            this.request("notifications/cancelled", {
-                requestId: uuidv4(),
-                reason: "User requested cancellation",
-            });
+            try {
+                await this.request("notifications/cancelled", {
+                    requestId: uuidv4(),
+                    reason: "User requested cancellation",
+                });
+            }
+            catch (ignored) { }
             this.mcpSessionId = null;
         }
     }
     async request(method, params, signal) {
         try {
-            const id = uuidv4();
+            const id = method.startsWith("notifications/") ? undefined : uuidv4();
             const extHeaders = {};
             if (this.mcpSessionId && method !== "initialize") {
                 extHeaders["Mcp-Session-Id"] = this.mcpSessionId;
@@ -35631,7 +35650,9 @@ class Agent {
             return results.map((s) => s.text).join("\n\n");
         }
         const toolCalls = results.filter((s) => s.type == "tool-call");
-        if (toolCalls.length > 1 && this.canParallelToolCalls(toolCalls)) {
+        if (toolCalls.length > 1 &&
+            this.canParallelToolCalls(toolCalls) &&
+            toolCalls.every((s) => agentTools.find((t) => t.name == s.toolName)?.supportParallelCalls)) {
             const results = await Promise.all(toolCalls.map((toolCall) => this.callToolCall(agentContext, agentTools, toolCall, user_messages)));
             for (let i = 0; i < results.length; i++) {
                 toolResults.push(results[i]);