opencode-orchestrator 1.2.67 → 1.2.69

package/README.md

@@ -9,7 +9,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.2.67`
+  **Version:** `1.2.69`
   <!-- VERSION:END -->
 </div>
 
@@ -24,6 +24,15 @@ npm install -g opencode-orchestrator
 
 Install hooks are source-checkout safe, prefer `opencode.jsonc` when present, preserve sibling plugin entries, and skip automatic config mutation in CI environments.
 
+To remove the plugin safely later, run:
+
+```bash
+npm explore -g opencode-orchestrator -- npm run cleanup:plugin
+npm uninstall -g opencode-orchestrator
+```
+
+`npm uninstall -g` does not run dependency uninstall hooks in the npm 11 flow verified for this repo, so config cleanup is explicit.
+
 Inside an OpenCode environment:
 ```bash
 /task "Implement a new authentication module with JWT and audit logs"
@@ -284,6 +293,18 @@ The installation process is **production-safe** with multiple protection layers:
 7. ✅ **Timeout protection** — 30s timeout prevents hanging
 8. ✅ **Graceful degradation** — exits 0 on non-critical failures
 
+### Safe Removal
+OpenCode config cleanup is provided as an explicit command because global package uninstall does not invoke dependency uninstall hooks in the npm flow validated for this package.
+
+```bash
+npm explore -g opencode-orchestrator -- npm run cleanup:plugin
+npm uninstall -g opencode-orchestrator
+```
+
+Manual fallback:
+- Open `~/.config/opencode/opencode.json` or `opencode.jsonc`
+- Remove `"opencode-orchestrator"` from the `plugin` array
+
 ### Configuration Logs
 - Unix: `/tmp/opencode-orchestrator.log`
 - Windows: `%TEMP%\opencode-orchestrator.log`

package/dist/core/notification/task-toast-manager.d.ts

@@ -21,6 +21,9 @@ export declare class TaskToastManager {
     private client;
     private concurrency;
     private todoSync;
+    private getSafeTaskDescription;
+    private getSafeAgent;
+    private showToast;
     /**
      * Initialize the manager with OpenCode client
      */

package/dist/core/notification/toast-sanitizer.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeToastTitle(value: string): string;
+export declare function sanitizeToastInline(value: string, maxLength?: number): string;
+export declare function sanitizeToastMessage(value: string, maxLength?: number, maxLines?: number): string;

package/dist/index.js

@@ -939,6 +939,77 @@ var init_types4 = __esm({
   }
 });
 
+// src/core/notification/toast-sanitizer.ts
+function stripTerminalSequences(value) {
+  return value.replace(/\r\n?/g, "\n").replace(ANSI_PATTERN, "").replace(C0_CONTROL_PATTERN, "");
+}
+function truncate(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, Math.max(0, maxLength - 1)).trimEnd()}\u2026`;
+}
+function sanitizeInternal(value, options) {
+  const stripped = stripTerminalSequences(value);
+  if (options.singleLine) {
+    const singleLine = stripped.replace(/\s+/g, " ").trim();
+    return singleLine ? truncate(singleLine, options.maxLength) : "";
+  }
+  const rawLines = stripped.split("\n");
+  const lines = [];
+  for (const rawLine of rawLines) {
+    const normalizedLine = rawLine.replace(/\t/g, "    ").replace(/[^\S\n]+/g, " ").trim();
+    if (normalizedLine.length === 0) {
+      if (!options.singleLine && lines.length > 0 && lines[lines.length - 1] !== "") {
+        lines.push("");
+      }
+      continue;
+    }
+    lines.push(normalizedLine);
+    if (lines.length >= options.maxLines) {
+      break;
+    }
+  }
+  const collapsed = lines.join("\n").trim();
+  if (!collapsed) {
+    return "";
+  }
+  const truncated = truncate(collapsed, options.maxLength);
+  if (rawLines.length > options.maxLines && !truncated.endsWith("\u2026")) {
+    return truncate(`${truncated}
+\u2026`, options.maxLength);
+  }
+  return truncated;
+}
+function sanitizeToastTitle(value) {
+  return sanitizeInternal(value, {
+    maxLength: 80,
+    maxLines: 1,
+    singleLine: true
+  });
+}
+function sanitizeToastInline(value, maxLength = 120) {
+  return sanitizeInternal(value, {
+    maxLength,
+    maxLines: 1,
+    singleLine: true
+  });
+}
+function sanitizeToastMessage(value, maxLength = 600, maxLines = 10) {
+  return sanitizeInternal(value, {
+    maxLength,
+    maxLines
+  });
+}
+var ANSI_PATTERN, C0_CONTROL_PATTERN;
+var init_toast_sanitizer = __esm({
+  "src/core/notification/toast-sanitizer.ts"() {
+    "use strict";
+    ANSI_PATTERN = /\u001B(?:\][^\u0007\u001B]*(?:\u0007|\u001B\\)|[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+    C0_CONTROL_PATTERN = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
+  }
+});
+
 // src/core/notification/toast-core.ts
 function initToastClient(client) {
   tuiClient = client;
@@ -950,10 +1021,12 @@ function initToastClient(client) {
   return cleanup;
 }
 function show(options) {
+  const title = sanitizeToastTitle(options.title);
+  const message = sanitizeToastMessage(options.message);
   const toast = {
     id: `toast_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
-    title: options.title,
-    message: options.message,
+    title,
+    message,
     variant: options.variant || "info",
     timestamp: /* @__PURE__ */ new Date(),
     duration: options.duration ?? 5e3,
@@ -1009,6 +1082,7 @@ var init_toast_core = __esm({
   "src/core/notification/toast-core.ts"() {
     "use strict";
     init_shared();
+    init_toast_sanitizer();
     tuiClient = null;
     toasts = [];
     handlers = [];
@@ -6488,11 +6562,30 @@ init_shared();
 
 // src/core/notification/task-toast-manager.ts
 init_shared();
+init_toast_sanitizer();
 var TaskToastManager = class {
   tasks = /* @__PURE__ */ new Map();
   client = null;
   concurrency = null;
   todoSync = null;
+  getSafeTaskDescription(task) {
+    return sanitizeToastInline(task.description, 100) || "Untitled task";
+  }
+  getSafeAgent(agent) {
+    return sanitizeToastInline(agent, 32) || "unknown";
+  }
+  showToast(title, message, variant, duration5) {
+    if (!this.client || !this.client.tui) return;
+    this.client.tui.showToast({
+      body: {
+        title: sanitizeToastTitle(title) || "Notification",
+        message: sanitizeToastMessage(message),
+        variant,
+        duration: duration5
+      }
+    }).catch(() => {
+    });
+  }
   /**
    * Initialize the manager with OpenCode client
    */
@@ -6607,7 +6700,7 @@ var TaskToastManager = class {
         const duration5 = this.formatDuration(task.startedAt);
         const bgTag = task.isBackground ? TUI_TAGS.BACKGROUND : TUI_TAGS.FOREGROUND;
         const isNew = newTask && task.id === newTask.id ? TUI_ICONS.NEW : "";
-        lines.push(`${bgTag} ${task.description} (${task.agent}) - ${duration5}${isNew}`);
+        lines.push(`${bgTag} ${this.getSafeTaskDescription(task)} (${this.getSafeAgent(task.agent)}) - ${duration5}${isNew}`);
       }
     }
     if (queued.length > 0) {
@@ -6615,7 +6708,7 @@ var TaskToastManager = class {
       lines.push(`${TUI_ICONS.QUEUED} Queued (${queued.length}):`);
       for (const task of queued) {
         const bgTag = task.isBackground ? TUI_TAGS.WAITING : TUI_TAGS.PENDING;
-        lines.push(`${bgTag} ${task.description} (${task.agent})`);
+        lines.push(`${bgTag} ${this.getSafeTaskDescription(task)} (${this.getSafeAgent(task.agent)})`);
       }
     }
     return lines.join("\n");
@@ -6624,40 +6717,37 @@ var TaskToastManager = class {
    * Show consolidated toast with all running/queued tasks
    */
   showTaskListToast(newTask) {
-    if (!this.client || !this.client.tui) return;
     const message = this.buildTaskListMessage(newTask);
     const running = this.getRunningTasks();
     const queued = this.getQueuedTasks();
     const title = newTask.isBackground ? `Background Task Started` : `Task Started`;
-    this.client.tui.showToast({
-      body: {
-        title,
-        message: message || `${newTask.description} (${newTask.agent})`,
-        variant: STATUS_LABEL.INFO,
-        duration: running.length + queued.length > 2 ? 5e3 : 3e3
-      }
-    }).catch(() => {
-    });
+    this.showToast(
+      title,
+      message || `${this.getSafeTaskDescription(newTask)} (${this.getSafeAgent(newTask.agent)})`,
+      STATUS_LABEL.INFO,
+      running.length + queued.length > 2 ? 5e3 : 3e3
+    );
   }
   /**
    * Show task completion toast
    */
   showCompletionToast(info) {
-    if (!this.client || !this.client.tui) return;
     this.removeTask(info.id);
     const remaining = this.getRunningTasks();
     const queued = this.getQueuedTasks();
     let message;
     let title;
     let variant;
+    const safeDescription = sanitizeToastInline(info.description, 100) || "Untitled task";
+    const safeError = info.error ? sanitizeToastMessage(info.error, 240, 4) : "";
     if (info.status === STATUS_LABEL.ERROR || info.status === STATUS_LABEL.CANCELLED || info.status === STATUS_LABEL.FAILED) {
       title = info.status === STATUS_LABEL.ERROR ? "Task Failed" : "Task Cancelled";
-      message = `[FAIL] "${info.description}" ${info.status}
-${info.error || ""}`;
+      message = `[FAIL] "${safeDescription}" ${info.status}
+${safeError}`;
       variant = STATUS_LABEL.ERROR;
     } else {
       title = "Task Completed";
-      message = `[DONE] "${info.description}" finished in ${info.duration}`;
+      message = `[DONE] "${safeDescription}" finished in ${info.duration}`;
       variant = STATUS_LABEL.SUCCESS;
     }
     if (remaining.length > 0 || queued.length > 0) {
@@ -6665,41 +6755,28 @@ ${info.error || ""}`;
 
 Still running: ${remaining.length} | Queued: ${queued.length}`;
     }
-    this.client.tui.showToast({
-      body: {
-        title,
-        message,
-        variant,
-        duration: 5e3
-      }
-    }).catch(() => {
-    });
+    this.showToast(title, message, variant, 5e3);
   }
   /**
    * Show all-tasks-complete summary toast
    */
   showAllCompleteToast(parentSessionID, completedTasks) {
-    if (!this.client || !this.client.tui) return;
     const successCount = completedTasks.filter((t) => t.status === STATUS_LABEL.COMPLETED).length;
     const failCount = completedTasks.filter((t) => t.status === STATUS_LABEL.ERROR || t.status === STATUS_LABEL.CANCELLED || t.status === STATUS_LABEL.FAILED).length;
-    const taskList = completedTasks.map((t) => `- [${t.status === STATUS_LABEL.COMPLETED ? "OK" : "FAIL"}] ${t.description} (${t.duration})`).join("\n");
-    this.client.tui.showToast({
-      body: {
-        title: "All Tasks Completed",
-        message: `${successCount} succeeded, ${failCount} failed
+    const taskList = completedTasks.map((t) => `- [${t.status === STATUS_LABEL.COMPLETED ? "OK" : "FAIL"}] ${sanitizeToastInline(t.description, 80) || "Untitled task"} (${t.duration})`).join("\n");
+    this.showToast(
+      "All Tasks Completed",
+      `${successCount} succeeded, ${failCount} failed
 
 ${taskList}`,
-        variant: failCount > 0 ? STATUS_LABEL.WARNING : STATUS_LABEL.SUCCESS,
-        duration: 7e3
-      }
-    }).catch(() => {
-    });
+      failCount > 0 ? STATUS_LABEL.WARNING : STATUS_LABEL.SUCCESS,
+      7e3
+    );
   }
   /**
    * Show Mission Complete toast (Grand Finale)
    */
   showMissionCompleteToast(title = "Mission Complete", message = "All tasks completed successfully.") {
-    if (!this.client || !this.client.tui) return;
     const decoratedMessage = `
 ${TUI_ICONS.MISSION_COMPLETE} ${TUI_MESSAGES.MISSION_COMPLETE_TITLE} ${TUI_ICONS.MISSION_COMPLETE}
 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
@@ -6707,36 +6784,23 @@ ${message}
 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 ${TUI_MESSAGES.MISSION_COMPLETE_SUBTITLE}
 `.trim();
-    this.client.tui.showToast({
-      body: {
-        title: `${TUI_ICONS.SHIELD} ${title}`,
-        message: decoratedMessage,
-        variant: STATUS_LABEL.SUCCESS,
-        duration: 1e4
-        // Longer duration for the finale
-      }
-    }).catch(() => {
-    });
+    this.showToast(`${TUI_ICONS.SHIELD} ${title}`, decoratedMessage, STATUS_LABEL.SUCCESS, 1e4);
   }
   /**
    * Show progress toast (for long-running tasks)
    */
   showProgressToast(taskId, progress) {
-    if (!this.client || !this.client.tui) return;
     const task = this.tasks.get(taskId);
     if (!task) return;
     const percentage = Math.round(progress.current / progress.total * 100);
     const progressBar = `[${"#".repeat(Math.floor(percentage / 10))}${"-".repeat(10 - Math.floor(percentage / 10))}]`;
-    this.client.tui.showToast({
-      body: {
-        title: `Task Progress: ${task.description}`,
-        message: `${progressBar} ${percentage}%
+    this.showToast(
+      `Task Progress: ${this.getSafeTaskDescription(task)}`,
+      `${progressBar} ${percentage}%
 ${progress.message || ""}`,
-        variant: STATUS_LABEL.INFO,
-        duration: 2e3
-      }
-    }).catch(() => {
-    });
+      STATUS_LABEL.INFO,
+      2e3
+    );
   }
   /**
    * Clear all tracked tasks