opencode-orchestrator 0.2.2 → 0.4.0

package/dist/tools/async-agent.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Task Delegation Tools
+ *
+ * Tools for delegating work to agents:
+ * - delegate_task: Delegate work to an agent (sync or background)
+ * - get_task_result: Retrieve completed task result
+ * - list_tasks: View all parallel tasks
+ * - cancel_task: Stop a running task
+ */
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import { ParallelAgentManager } from "../core/async-agent.js";
+export { ParallelAgentManager as AsyncAgentManager } from "../core/async-agent.js";
+/**
+ * delegate_task - Delegate work to an agent (sync or background)
+ */
+export declare const createDelegateTaskTool: (manager: ParallelAgentManager, client: unknown) => {
+    description: string;
+    args: {
+        agent: import("zod").ZodString;
+        description: import("zod").ZodString;
+        prompt: import("zod").ZodString;
+        background: import("zod").ZodBoolean;
+    };
+    execute(args: {
+        agent: string;
+        description: string;
+        prompt: string;
+        background: boolean;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * get_task_result - Get result from a completed background task
+ */
+export declare const createGetTaskResultTool: (manager: ParallelAgentManager) => {
+    description: string;
+    args: {
+        taskId: import("zod").ZodString;
+    };
+    execute(args: {
+        taskId: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * list_tasks - List all background tasks
+ */
+export declare const createListTasksTool: (manager: ParallelAgentManager) => {
+    description: string;
+    args: {
+        status: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        status?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * cancel_task - Cancel a running background task
+ */
+export declare const createCancelTaskTool: (manager: ParallelAgentManager) => {
+    description: string;
+    args: {
+        taskId: import("zod").ZodString;
+    };
+    execute(args: {
+        taskId: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Factory function to create all task delegation tools
+ */
+export declare function createAsyncAgentTools(manager: ParallelAgentManager, client?: unknown): Record<string, ToolDefinition>;

package/dist/tools/background.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Background Task Tools for OpenCode Orchestrator
+ *
+ * These tools allow the AI to run commands in the background and check their results later.
+ * This is useful for long-running builds, tests, or other operations.
+ */
+export declare const runBackgroundTool: {
+    description: string;
+    args: {
+        command: import("zod").ZodString;
+        cwd: import("zod").ZodOptional<import("zod").ZodString>;
+        timeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+        label: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        command: string;
+        cwd?: string | undefined;
+        timeout?: number | undefined;
+        label?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const checkBackgroundTool: {
+    description: string;
+    args: {
+        taskId: import("zod").ZodString;
+        tailLines: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    execute(args: {
+        taskId: string;
+        tailLines?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const listBackgroundTool: {
+    description: string;
+    args: {
+        status: import("zod").ZodOptional<import("zod").ZodEnum<{
+            error: "error";
+            running: "running";
+            done: "done";
+            all: "all";
+        }>>;
+    };
+    execute(args: {
+        status?: "error" | "running" | "done" | "all" | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const killBackgroundTool: {
+    description: string;
+    args: {
+        taskId: import("zod").ZodString;
+    };
+    execute(args: {
+        taskId: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};

package/dist/tools/search.d.ts

@@ -28,3 +28,25 @@ export declare const globSearchTool: (directory: string) => {
         dir?: string | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
+/**
+ * Multi-grep (mgrep) tool - search multiple patterns in parallel
+ * High-performance parallel search powered by Rust
+ *
+ * Use cases:
+ * - Find all usages of multiple functions at once
+ * - Search for related patterns (imports, exports, usages)
+ * - Codebase-wide refactoring analysis
+ */
+export declare const mgrepTool: (directory: string) => {
+    description: string;
+    args: {
+        patterns: import("zod").ZodArray<import("zod").ZodString>;
+        dir: import("zod").ZodOptional<import("zod").ZodString>;
+        max_results_per_pattern: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    execute(args: {
+        patterns: string[];
+        dir?: string | undefined;
+        max_results_per_pattern?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};

package/dist/utils/common.d.ts

@@ -2,3 +2,14 @@ export declare function detectSlashCommand(text: string): {
     command: string;
     args: string;
 } | null;
+/**
+ * Format a timestamp in human-readable format: YYYY-MM-DD HH:mm:ss
+ */
+export declare function formatTimestamp(date?: Date): string;
+/**
+ * Calculate and format elapsed time between two timestamps in human-readable format
+ * @param startMs Start timestamp in milliseconds
+ * @param endMs End timestamp in milliseconds (defaults to now)
+ * @returns Formatted string like "2h 30m 15s" or "45s"
+ */
+export declare function formatElapsedTime(startMs: number, endMs?: number): string;

package/dist/utils/sanity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Output Sanity Check - LLM degeneration/gibberish detection
+ *
+ * Detects common LLM failure modes:
+ * - Single character repetition (SSSSSS...)
+ * - Pattern loops (茅茅茅茅...)
+ * - Low information density
+ * - Visual gibberish (box drawing characters)
+ * - Line repetition
+ */
+export interface SanityResult {
+    isHealthy: boolean;
+    reason?: string;
+    severity: "ok" | "warning" | "critical";
+}
+/**
+ * Check if LLM output shows signs of degeneration
+ */
+export declare function checkOutputSanity(text: string): SanityResult;
+/**
+ * Check if text is completely empty or meaningless
+ */
+export declare function isEmptyOrMeaningless(text: string): boolean;
+/**
+ * Recovery prompt for single anomaly
+ */
+export declare const RECOVERY_PROMPT = "<anomaly_recovery>\n\u26A0\uFE0F SYSTEM NOTICE: Previous output was malformed (gibberish/loop detected).\n\n<recovery_protocol>\n1. DISCARD the corrupted output completely - do not reference it\n2. RECALL the original mission objective\n3. IDENTIFY the last confirmed successful step\n4. RESTART with a simpler, more focused approach\n</recovery_protocol>\n\n<instructions>\n- If a sub-agent produced bad output: try a different agent or simpler task\n- If stuck in a loop: break down the task into smaller pieces\n- If context seems corrupted: call recorder to restore context\n- THINK in English for maximum stability\n</instructions>\n\nWhat was the original task? Proceed from the last known good state.\n</anomaly_recovery>";
+/**
+ * Escalation prompt for multiple consecutive anomalies
+ */
+export declare const ESCALATION_PROMPT = "<critical_anomaly>\n\uD83D\uDEA8 CRITICAL: Multiple consecutive malformed outputs detected.\n\n<emergency_protocol>\n1. STOP current execution path immediately\n2. DO NOT continue with the same approach - it is failing\n3. CALL architect for a completely new strategy\n4. If architect also fails: report status to user and await guidance\n</emergency_protocol>\n\n<diagnosis>\nThe current approach is producing corrupted output.\nThis may indicate: context overload, model instability, or task complexity.\n</diagnosis>\n\nRequest a fresh plan from architect with reduced scope.\n</critical_anomaly>";

package/package.json

@@ -2,7 +2,7 @@
     "name": "opencode-orchestrator",
     "displayName": "OpenCode Orchestrator",
     "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-    "version": "0.2.2",
+    "version": "0.4.0",
     "author": "agnusdei1207",
     "license": "MIT",
     "repository": {
@@ -55,10 +55,13 @@
         "postinstall": "node dist/scripts/postinstall.js 2>/dev/null || true",
         "preuninstall": "node dist/scripts/preuninstall.js 2>/dev/null || true",
         "prepublishOnly": "npm run build:js",
-        "dev:install": "npm run build:js && npm install -g .",
-        "dev:uninstall": "npm uninstall -g opencode-orchestrator",
-        "dev:link": "npm run build:js && npm link",
-        "dev:unlink": "npm unlink -g opencode-orchestrator",
+        "dev:install": "npm run build:js && npm uninstall -g opencode-orchestrator >/dev/null 2>&1 || true && npm install -g . && echo '✅ Installed globally'",
+        "dev:uninstall": "npm unlink -g opencode-orchestrator >/dev/null 2>&1 || true && npm uninstall -g opencode-orchestrator >/dev/null 2>&1 || true && rm -rf $(npm root -g)/opencode-orchestrator && echo '✅ Forcefully Uninstalled'",
+        "dev:link": "npm run build:js && npm unlink -g opencode-orchestrator >/dev/null 2>&1 || true && npm unlink >/dev/null 2>&1 || true && rm -rf $(npm root -g)/opencode-orchestrator && npm link && echo '✅ Re-linked. Restart OpenCode.'",
+        "dev:unlink": "npm unlink -g opencode-orchestrator >/dev/null 2>&1 || true && npm unlink >/dev/null 2>&1 || true && rm -rf $(npm root -g)/opencode-orchestrator && echo '✅ Unlinked and Cleaned'",
+        "dev:reload": "npm run dev:link",
+        "dev:build": "npm run build:js && echo '✅ Built (no link change)'",
+        "dev:status": "echo '=== Global Link Status ===' && ls -l $(npm root -g)/opencode-orchestrator 2>/dev/null || echo 'Not found'",
         "util:stars": "gh api repos/agnusdei1207/opencode-orchestrator/stargazers --jq '.[].login'"
     },
     "dependencies": {