@elizaos/plugin-task-coordinator 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @elizaos/plugin-task-coordinator
+
+UI workbench for managing coding-agent task threads and PTY sessions inside elizaOS.
+
+## What it does
+
+This plugin adds two interactive surfaces to the elizaOS dashboard:
+
+**Task Coordinator** — lists active coding-agent sessions and task threads, shows live PTY output from running agents, and lets you stop individual sessions or all sessions at once.
+
+**Orchestrator** — a multi-agent task orchestration workbench. Create task threads with goals and acceptance criteria, assign sub-agents (elizaOS, Claude Code, Codex, OpenCode, Pi Agent), monitor their timeline of events and messages, fork tasks, validate results, and send messages to running tasks — all from one panel.
+
+Both surfaces are available in standard, XR, and TUI (terminal) variants.
+
+The plugin also fills the coding-agent slot components that `@elizaos/ui` leaves empty until a slot provider registers them:
+- A header control chip showing active agent count with a stop-all button.
+- The per-framework settings section (model, LLM provider, approval preset, GitHub connection).
+- The PTY console (drawer, side-panel, and full-screen variants).
+
+## Capabilities
+
+The Orchestrator panel supports these operations:
+
+| Capability | Description |
+|---|---|
+| Status | Get current orchestrator status |
+| List tasks | List task threads, filter by status, search, include archived |
+| Open task | Open a task thread detail view |
+| Create task | Create a new task with title, goal, priority, acceptance criteria |
+| Pause / resume task | Pause or resume a single task |
+| Pause all / resume all | Bulk pause or resume |
+| Delete task | Remove a task thread |
+| Fork task | Fork an existing task with a new title/goal/priority |
+| Update task | Edit title, goal, summary, priority, acceptance criteria |
+| Validate task | Record a validation pass/fail result with evidence |
+| Add agent | Attach a sub-agent (framework, model, workdir, repo) to a task |
+| Stop agent | Stop a specific sub-agent session |
+| Send message | Send a message to a task thread |
+
+## Requirements
+
+- `@elizaos/core` (workspace dependency)
+- `@elizaos/ui` (workspace dependency — provides client API, slot registry, shared types)
+- `@elizaos/plugin-agent-orchestrator` must be running to provide task/session state; this plugin is display-only.
+
+## Enabling
+
+Add `@elizaos/plugin-task-coordinator` to your agent's plugin list. No env vars are required.
+
+Per-framework coding-agent settings (model, LLM provider, approval preset) are configured through the Settings panel in the dashboard UI, not via environment variables.
+
+## Supported agent frameworks
+
+The settings panel manages configuration for: elizaOS, Pi Agent, OpenCode, Claude, and Codex.
+
+## Build
+
+```bash
+bun run --cwd plugins/plugin-task-coordinator build
+```
+
+This runs tsup (plugin JS) + Vite (view bundle → `dist/views/bundle.js`) + tsc (type declarations).
+
+## Tests
+
+```bash
+bun run --cwd plugins/plugin-task-coordinator test
+```
+
+A live end-to-end test (`test:e2e:manual`) requires the `codex` CLI to be installed and authenticated (`~/.codex/auth.json`). It is skipped automatically when those conditions are not met.

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@elizaos/plugin-task-coordinator",
+  "version": "2.0.3-beta.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/plugin-calendar": "2.0.3-beta.2",
+    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/ui": "2.0.3-beta.2",
+    "@xterm/addon-fit": "^0.10.0",
+    "@xterm/xterm": "^5.5.0",
+    "lucide-react": "^1.0.0",
+    "marked": "^18.0.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "heroImage": "assets/hero.png"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "rm -rf dist",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json",
+    "test": "vitest run --config vitest.config.ts",
+    "test:unit": "vitest run --config vitest.config.ts",
+    "test:e2e:manual": "vitest run --config vitest.live.config.ts"
+  },
+  "files": [
+    "assets",
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "vite": "^8.0.0"
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}