opencode-orchestrator 1.3.12 → 1.5.1

package/README.md

@@ -6,7 +6,7 @@
   [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
   [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
   <!-- VERSION:START -->
-  **Version:** `1.3.12`
+  **Version:** `1.5.1`
   <!-- VERSION:END -->
 </div>
 
@@ -34,8 +34,8 @@ Manual fallback: remove `"opencode-orchestrator"` or `["opencode-orchestrator",
 Tested compatibility:
 
 1. Node.js `24+`
-2. `@opencode-ai/plugin` `1.17.3`
-3. `@opencode-ai/sdk` `1.17.3`
+2. `@opencode-ai/plugin` `1.17.4`
+3. `@opencode-ai/sdk` `1.17.4`
 
 OpenCode plugin options belong inside the `plugin` array as `["plugin-name", {...}]` tuples. Configure `agentConcurrency` and `missionLoop` there:
 
@@ -99,6 +99,37 @@ Mission controls:
 3. `/cancel` and `/stop` deactivate the current mission loop.
 4. The default mission iteration ceiling is `1,000,000,000`.
 
+Role-aware agent sessions are created or reused on demand: Commander delegates Planner, Worker, and Reviewer tasks into a per-role session pool, then releases or cleans those sessions automatically after completion.
+
+### Authorized Shell Listener TUI
+
+For owned lab machines or explicitly authorized test environments, the bundled Rust CLI can run a multi-session TCP shell listener:
+
+```bash
+orchestrator shell-listener --bind 127.0.0.1 --port 4444
+```
+
+The listener is intentionally outside the OpenCode JSON-RPC tool surface. It is an operator-driven terminal workflow, not an LLM-callable tool.
+
+Safety defaults:
+
+1. Loopback-only bind by default.
+2. Non-loopback bind addresses require `--allow-remote`.
+3. Raw stream logs are stored under `.opencode-orchestrator/shell-listener/`.
+4. The CLI does not generate payloads, exploit targets, or bypass authentication.
+
+TUI commands:
+
+| Command | Purpose |
+| --- | --- |
+| `sessions` | Show connected sessions, peer addresses, status, and raw log paths. |
+| `use <id>` | Select the active session. |
+| `send <text>` | Send one input line to the active session. Use this for login, registry, CDK, or reverse-proxy prompts that need human input. |
+| `run <cmd>` | Send a command followed by a unique sentinel marker so completion can be recognized in output. |
+| `pty` | Send a manual PTY helper to the active session when the remote environment supports Python. |
+| `close [id]` | Close a session. |
+| `quit` | Stop the listener UI. |
+
 ## 4. How It Works
 
 ```mermaid

package/dist/agents/prompts/02_discovery/discovery_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  DISCOVERY CORE PHILOSOPHY                                 ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  발견 단계의 핵심 철학: 실행 전 충분한 탐색               ║
+ * ║  Core Philosophy of Discovery: Thorough Exploration Before Execution  ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const DISCOVERY_CORE = "\n# Discovery Phase Philosophy\n\nBefore any execution, thoroughly explore:\n1. Workspace structure\n2. Environment capabilities\n3. Available skills and tools\n4. Project patterns and conventions\n\nThe discovery phase sets the foundation for all subsequent actions.\n";

package/dist/agents/prompts/03_planning/planning_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  PLANNING CORE PHILOSOPHY                                  ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  계획 단계의 핵심 철학: 실행 가능한 명확한 계획 수립        ║
+ * ║  Core Philosophy of Planning: Establishing Clear, Actionable Plans   ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const PLANNING_CORE = "\n# Planning Phase Philosophy\n\nCreate actionable, granular plans:\n1. Break down complex tasks into atomic units\n2. Identify dependencies and execution order\n3. Plan for parallel execution where possible\n4. Define clear success criteria\n\nGood planning makes execution straightforward.\n";

package/dist/agents/prompts/04_execution/execution_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  EXECUTION CORE PHILOSOPHY                                 ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  실행 단계의 핵심 철학: 계획을 정확하게 실행                ║
+ * ║  Core Philosophy of Execution: Executing Plans with Precision       ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const EXECUTION_CORE = "\n# Execution Phase Philosophy\n\nExecute with precision and quality:\n1. Follow the plan systematically\n2. Handle errors gracefully\n3. Provide clear progress updates\n4. Maintain code quality standards\n\nExecution transforms plans into reality.\n";

package/dist/agents/prompts/05_verification/verification_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  VERIFICATION CORE PHILOSOPHY                              ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  검증 단계의 핵심 철학: 실행 기반 품질 보증                 ║
+ * ║  Core Philosophy of Verification: Execution-Based Quality Assurance ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const VERIFICATION_CORE = "\n# Verification Phase Philosophy\n\nVerify through actual execution:\n1. Build the project\n2. Run tests\n3. Check linting and type errors\n4. Validate runtime behavior\n\nReal execution is the ultimate verification.\n";

package/dist/agents/prompts/06_mission/mission_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  MISSION CORE PHILOSOPHY                                   ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  미션 관리의 핵심 철학: 전체 생명주기 관리                  ║
+ * ║  Core Philosophy of Mission Control: Managing Full Lifecycle        ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const MISSION_CORE = "\n# Mission Management Philosophy\n\nManage the entire mission lifecycle:\n1. Track mission status throughout execution\n2. Handle recovery from failures\n3. Determine completion conditions\n4. Ensure clean mission closure\n\nA mission succeeds when all objectives are met.\n";

package/dist/agents/prompts/08_tools/tools_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  TOOLS CORE PHILOSOPHY                                     ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  도구 사용의 핵심 철학: 올바른 도구를 올바르게 사용          ║
+ * ║  Core Philosophy of Tools: Using the Right Tools Correctly          ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const TOOLS_CORE = "\n# Tools Usage Philosophy\n\nUse the right tool for the right job:\n1. Understand each tool's capabilities and limitations\n2. Choose the most appropriate tool for each task\n3. Use tools efficiently and correctly\n4. Validate tool outputs\n\nProper tool usage amplifies effectiveness.\n";

package/dist/core/agents/manager.d.ts

@@ -62,7 +62,6 @@ export declare class ParallelAgentManager {
     private findBySession;
     private handleTaskError;
     private handleTaskComplete;
-    private recoverActiveTasks;
 }
 export declare const parallelAgentManager: {
     getInstance: typeof ParallelAgentManager.getInstance;

package/dist/index.js

@@ -1,7 +1,12 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -23038,9 +23043,6 @@ var ParallelAgentManager = class _ParallelAgentManager {
       (task) => this.handleTaskComplete(task)
     );
     progressNotifier.setManager(this);
-    this.recoverActiveTasks().catch((err) => {
-      log("Recovery error:", err);
-    });
   }
   static getInstance(client, directory, concurrencyConfig) {
     if (!_ParallelAgentManager._instance) {
@@ -23193,8 +23195,6 @@ This task ensures the completeness of the unit before global integration.`,
     }
     progressNotifier.update();
   }
-  async recoverActiveTasks() {
-  }
 };
 var parallelAgentManager = {
   getInstance: ParallelAgentManager.getInstance.bind(ParallelAgentManager),
@@ -36515,15 +36515,15 @@ var CONTINUE_INSTRUCTION = `<auto_continue>
 </auto_continue>`;
 var STAGNATION_INTERVENTION = `
 <system_intervention type="stagnation_detected">
-\u26A0\uFE0F **\uACBD\uACE0: \uC9C4\uD589 \uC815\uCCB4 \uAC10\uC9C0 (STAGNATION DETECTED)**
-\uCD5C\uADFC \uC5EC\uB7EC \uD134 \uB3D9\uC548 \uC2E4\uC9C8\uC801\uC778 \uC9C4\uC804\uC774 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uB2E8\uC21C "\uBAA8\uB2C8\uD130\uB9C1"\uC774\uB098 \uAC19\uC740 \uD589\uB3D9\uC744 \uBC18\uBCF5\uD558\uB294 \uAC83\uC740 \uAE08\uC9C0\uB429\uB2C8\uB2E4.
+\u26A0\uFE0F **WARNING: STAGNATION DETECTED**
+No substantive progress has been detected for the past several turns. Repeating the same action or merely "monitoring" is prohibited.
 
-**\uC790\uC728\uC801 \uC9C4\uB2E8 \uBC0F \uD574\uACB0 \uC9C0\uCE68:**
-1. **\uC2E4\uC2DC\uAC04 \uB85C\uADF8 \uD655\uC778**: \`check_background_task\` \uB610\uB294 \`read_file\`\uC744 \uC0AC\uC6A9\uD558\uC5EC \uC9C4\uD589 \uC911\uC778 \uC791\uC5C5\uC758 \uCD9C\uB825 \uB85C\uADF8\uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC2ED\uC2DC\uC624.
-2. **\uD504\uB85C\uC138\uC2A4 \uC0DD\uC874 \uC9C4\uB2E8**: \uC791\uC5C5\uC774 \uC880\uBE44 \uC0C1\uD0DC\uC774\uAC70\uB098 \uBA48\uCD98 \uAC83 \uAC19\uB2E4\uBA74 \uACFC\uAC10\uD558\uAC8C \`kill\`\uD558\uACE0 \uB2E8\uACC4\uB97C \uC138\uBD84\uD654\uD558\uC5EC \uB2E4\uC2DC \uC2E4\uD589\uD558\uC2ED\uC2DC\uC624.
-3. **\uC804\uB7B5 \uC804\uD658**: \uB3D9\uC77C\uD55C \uC811\uADFC \uBC29\uC2DD\uC774 \uC2E4\uD328\uD558\uACE0 \uC788\uB2E4\uBA74, \uB2E4\uB978 \uB3C4\uAD6C\uB098 \uBC29\uBC95\uC744 \uC0AC\uC6A9\uD558\uC5EC \uBAA9\uD45C\uC5D0 \uB3C4\uB2EC\uD558\uC2ED\uC2DC\uC624.
+**Guidelines for Autonomous Diagnosis and Resolution:**
+1. **Check Real-time Logs**: Use \`check_background_task\` or \`read_file\` to directly check the output logs of the running task.
+2. **Process Liveness Diagnosis**: If the task appears to be in a zombie state or hung, proactively \`kill\` it, break down the steps, and run it again.
+3. **Strategy Pivot**: If the same approach keeps failing, use alternative tools or methods to reach the goal.
 
-**\uC9C0\uAE08 \uBC14\uB85C \uB2A5\uB3D9\uC801\uC73C\uB85C \uAC1C\uC785\uD558\uC2ED\uC2DC\uC624. \uB300\uAE30\uD558\uC9C0 \uB9C8\uC2ED\uC2DC\uC624.**
+**Intervene proactively right now. Do not wait.**
 </system_intervention>`;
 var CLEANUP_INSTRUCTION = `
 <system_maintenance type="continuous_hygiene">

package/dist/shared/constants/system-messages.d.ts

@@ -21,5 +21,5 @@ export declare const MISSION_MESSAGES: {
 };
 export declare const COMPACTION_PROMPT: string;
 export declare const CONTINUE_INSTRUCTION: string;
-export declare const STAGNATION_INTERVENTION = "\n<system_intervention type=\"stagnation_detected\">\n\u26A0\uFE0F **\uACBD\uACE0: \uC9C4\uD589 \uC815\uCCB4 \uAC10\uC9C0 (STAGNATION DETECTED)**\n\uCD5C\uADFC \uC5EC\uB7EC \uD134 \uB3D9\uC548 \uC2E4\uC9C8\uC801\uC778 \uC9C4\uC804\uC774 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uB2E8\uC21C \"\uBAA8\uB2C8\uD130\uB9C1\"\uC774\uB098 \uAC19\uC740 \uD589\uB3D9\uC744 \uBC18\uBCF5\uD558\uB294 \uAC83\uC740 \uAE08\uC9C0\uB429\uB2C8\uB2E4.\n\n**\uC790\uC728\uC801 \uC9C4\uB2E8 \uBC0F \uD574\uACB0 \uC9C0\uCE68:**\n1. **\uC2E4\uC2DC\uAC04 \uB85C\uADF8 \uD655\uC778**: `check_background_task` \uB610\uB294 `read_file`\uC744 \uC0AC\uC6A9\uD558\uC5EC \uC9C4\uD589 \uC911\uC778 \uC791\uC5C5\uC758 \uCD9C\uB825 \uB85C\uADF8\uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC2ED\uC2DC\uC624.\n2. **\uD504\uB85C\uC138\uC2A4 \uC0DD\uC874 \uC9C4\uB2E8**: \uC791\uC5C5\uC774 \uC880\uBE44 \uC0C1\uD0DC\uC774\uAC70\uB098 \uBA48\uCD98 \uAC83 \uAC19\uB2E4\uBA74 \uACFC\uAC10\uD558\uAC8C `kill`\uD558\uACE0 \uB2E8\uACC4\uB97C \uC138\uBD84\uD654\uD558\uC5EC \uB2E4\uC2DC \uC2E4\uD589\uD558\uC2ED\uC2DC\uC624.\n3. **\uC804\uB7B5 \uC804\uD658**: \uB3D9\uC77C\uD55C \uC811\uADFC \uBC29\uC2DD\uC774 \uC2E4\uD328\uD558\uACE0 \uC788\uB2E4\uBA74, \uB2E4\uB978 \uB3C4\uAD6C\uB098 \uBC29\uBC95\uC744 \uC0AC\uC6A9\uD558\uC5EC \uBAA9\uD45C\uC5D0 \uB3C4\uB2EC\uD558\uC2ED\uC2DC\uC624.\n\n**\uC9C0\uAE08 \uBC14\uB85C \uB2A5\uB3D9\uC801\uC73C\uB85C \uAC1C\uC785\uD558\uC2ED\uC2DC\uC624. \uB300\uAE30\uD558\uC9C0 \uB9C8\uC2ED\uC2DC\uC624.**\n</system_intervention>";
+export declare const STAGNATION_INTERVENTION = "\n<system_intervention type=\"stagnation_detected\">\n\u26A0\uFE0F **WARNING: STAGNATION DETECTED**\nNo substantive progress has been detected for the past several turns. Repeating the same action or merely \"monitoring\" is prohibited.\n\n**Guidelines for Autonomous Diagnosis and Resolution:**\n1. **Check Real-time Logs**: Use `check_background_task` or `read_file` to directly check the output logs of the running task.\n2. **Process Liveness Diagnosis**: If the task appears to be in a zombie state or hung, proactively `kill` it, break down the steps, and run it again.\n3. **Strategy Pivot**: If the same approach keeps failing, use alternative tools or methods to reach the goal.\n\n**Intervene proactively right now. Do not wait.**\n</system_intervention>";
 export declare const CLEANUP_INSTRUCTION = "\n<system_maintenance type=\"continuous_hygiene\">\n\uD83E\uDDF9 **DOCUMENTATION & STATE HYGIENE (Iteration %ITER%)**\nYou must maintain a pristine workspace. **As part of your move**, perform these checks:\n\n1. **Relevance Assessment**:\n   - Review active documents (`.opencode/*.md`). Are they needed for the *current* objective?\n   - If a file represents a solved problem or obsolete context, **Archive it** to `.opencode/archive/` or delete it.\n\n2. **Synchronization**:\n   - Verify `TODO.md` matches the actual code state. Mark completed items immediately.\n   - Check `sync-issues.md`. If issues are resolved, remove them.\n\n3. **Context Optimization**:\n   - If `work-log.md` is getting noisy, summarize key decisions into `summary.md` and truncate the log.\n   - Keep context lightweight.\n\n**Rule**: A cluttered workspace leads to hallucinations. Clean as you go.\n</system_maintenance>\n";

package/package.json

@@ -2,14 +2,14 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Multi-agent mission control for OpenCode with Commander, Planner, Worker, and Reviewer workflows.",
-  "version": "1.3.12",
+  "version": "1.5.1",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/agnusdei1207/opencode-orchestrator.git"
   },
-  "homepage": "https://github.com/agnusdei1207/opencode-orchestrator/issues",
+  "homepage": "https://agnusdei1207.github.io/opencode-orchestrator/",
   "bugs": {
     "url": "https://github.com/agnusdei1207/opencode-orchestrator/issues"
   },
@@ -74,14 +74,14 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.17.3",
-    "@opencode-ai/sdk": "1.17.3",
+    "@opencode-ai/plugin": "1.17.4",
+    "@opencode-ai/sdk": "1.17.4",
     "jsonc-parser": "^3.3.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^24.13.1",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "shx": "^0.4.0",
     "typescript": "^5.7.0",
     "vitest": "^4.0.17"

package/dist/core/agents/persistence/task-wal.d.ts

@@ -1,24 +0,0 @@
-/**
- * Task WAL (Write-Ahead Log) - REMOVED
- *
- * This module is deprecated and provides no-op stubs for backward compatibility.
- * WAL was removed to reduce I/O overhead and simplify architecture.
- */
-import type { ParallelTask } from "../interfaces/index.js";
-export interface WALEntry {
-    timestamp: string;
-    action: string;
-    taskId: string;
-    data: Partial<ParallelTask>;
-}
-/**
- * No-op WAL - all methods are stubs
- */
-export declare class TaskWAL {
-    init(): Promise<void>;
-    log(): Promise<void>;
-    flush(): Promise<void>;
-    readAll(): Promise<Map<string, ParallelTask>>;
-    compact(): Promise<void>;
-}
-export declare const taskWAL: TaskWAL;