@serkanalgur/opencode-nexus 2.7.0 → 2.8.0

package/dist/tui.js

@@ -121,6 +121,9 @@ var DEFAULT_CONFIG = {
     enabled: true,
     port: 4747,
     host: "127.0.0.1"
+  },
+  notifications: {
+    enabled: true
   }
 };
 
@@ -130,10 +133,12 @@ class NexusConfigManager {
   storageConfig = null;
   loadInfo = null;
   dashboardBase;
-  constructor(dashboardBase) {
+  notificationsBase;
+  constructor(dashboardBase, notificationsBase) {
     this.projectConfig = null;
     this.globalConfig = null;
     this.dashboardBase = { ...DEFAULT_CONFIG.dashboard, ...dashboardBase };
+    this.notificationsBase = { ...DEFAULT_CONFIG.notifications, ...notificationsBase };
   }
   loadConfigs(basePath) {
     if (this.loadInfo === null)
@@ -200,6 +205,9 @@ class NexusConfigManager {
         enabled: this.storageConfig?.dashboard?.enabled ?? this.projectConfig?.dashboard?.enabled ?? this.globalConfig?.dashboard?.enabled ?? this.dashboardBase.enabled,
         port: this.storageConfig?.dashboard?.port ?? this.projectConfig?.dashboard?.port ?? this.globalConfig?.dashboard?.port ?? this.dashboardBase.port,
         host: this.storageConfig?.dashboard?.host ?? this.projectConfig?.dashboard?.host ?? this.globalConfig?.dashboard?.host ?? this.dashboardBase.host
+      },
+      notifications: {
+        enabled: this.storageConfig?.notifications?.enabled ?? this.projectConfig?.notifications?.enabled ?? this.globalConfig?.notifications?.enabled ?? this.notificationsBase.enabled
       }
     };
   }
@@ -321,6 +329,7 @@ class NexusConfigManager {
     result.budget = { ...current.budget };
     result.selfHealing = { ...current.selfHealing };
     result.dashboard = { ...current.dashboard };
+    result.notifications = { ...current.notifications };
     return result;
   }
   resetToDefaults() {
@@ -597,6 +606,11 @@ function parseWebDashboardTarget(input, fallback) {
   }
   return { target: { port, host } };
 }
+var LISTEN_CONFIRM_ATTEMPTS = 15;
+var LISTEN_CONFIRM_INTERVAL_MS = 200;
+function defaultWait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 async function handleWebDashboard(input, deps) {
   const parsed = parseWebDashboardTarget(input, {
     port: deps.dashboard.port,
@@ -629,7 +643,7 @@ async function handleWebDashboard(input, deps) {
     await deps.openBrowser(url);
     deps.showToast({
       title: "\u26A1 Nexus Web Dashboard",
-      message: `Opened ${url} \u2014 a dashboard is already running there.`,
+      message: `Opened ${url} \u2014 a dashboard is already running there, so nothing was started.`,
       variant: "success",
       duration: 6000
     });
@@ -650,22 +664,62 @@ async function handleWebDashboard(input, deps) {
     });
     return;
   }
+  let submitted;
+  try {
+    await deps.submitCommand(`/nexus dashboard ${port} ${host}`);
+    submitted = `/nexus dashboard ${port} ${host}`;
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    deps.showToast({
+      title: "Nexus Web Dashboard \u2014 could not start",
+      message: [
+        `The dashboard start command never reached the OpenCode server: ${detail}`,
+        "",
+        "No server is listening on that port and no browser was opened.",
+        "The dashboard runs in the server process, so this needs the server's",
+        "HTTP endpoint to be reachable from the TUI."
+      ].join(`
+`),
+      variant: "error",
+      duration: 15000
+    });
+    return;
+  }
+  const wait = deps.waitImpl ?? defaultWait;
+  const attempts = deps.confirmAttempts ?? LISTEN_CONFIRM_ATTEMPTS;
+  const intervalMs = deps.confirmIntervalMs ?? LISTEN_CONFIRM_INTERVAL_MS;
+  for (let attempt = 0;attempt < attempts; attempt++) {
+    if (attempt > 0)
+      await wait(intervalMs);
+    const check = await probeDashboard(host, port, deps.fetchImpl);
+    if (check.isNexusDashboard) {
+      await deps.openBrowser(url);
+      deps.showToast({
+        title: "\u26A1 Nexus Web Dashboard",
+        message: `Started and opened ${url} \u2014 a dashboard is serving there now.`,
+        variant: "success",
+        duration: 8000
+      });
+      return;
+    }
+  }
   deps.showToast({
-    title: "\u26A1 Nexus Web Dashboard",
+    title: "Nexus Web Dashboard \u2014 not started",
     message: [
-      `No dashboard is running on ${url} (${probe.detail}), and no browser was opened.`,
-      "",
-      "The dashboard server cannot be started from the TUI: it runs in the OpenCode",
-      "server process, next to the orchestrator that feeds it, and the TUI has no",
-      "handle on either. So start it from the agent \u2014 this is the one call:",
+      `Ran \`${submitted}\`, but nothing is serving on ${host}:${port} after ${Math.round(attempts * intervalMs / 1000)}s,`,
+      "so no browser was opened and there is no URL to give you.",
       "",
-      `  nexus.dashboard.start(port=${port}, host="${host}")`,
-      "",
-      `Then re-run /nexus web and it will open ${url} for you.`
+      "The command runs in the OpenCode server process, which is the only place",
+      "the dashboard can start. If a Nexus plugin is active in that process, its",
+      `result is in this session as the reply to \`${submitted}\` \u2014 that text names`,
+      "the reason (a port already in use, or `dashboard.enabled: false`). If no",
+      "plugin is active there, the command was never handled at all. If the port",
+      "is held by another process, free it or pass a different one:",
+      "/nexus web 4748."
     ].join(`
 `),
-    variant: "info",
-    duration: 15000
+    variant: "error",
+    duration: 20000
   });
 }
 async function openInBrowser(url) {
@@ -766,14 +820,28 @@ var tui_default = define({
         variant: "success"
       });
     };
+    const activeSessionID = () => {
+      const route = context.ui.router.current();
+      if (route.type === "session")
+        return route.sessionID;
+      return context.ui.tabs.list().find((tab) => tab.active)?.sessionID;
+    };
+    const submitServerCommand = async (text) => {
+      const sessionID = activeSessionID();
+      if (!sessionID) {
+        throw new Error("no session is open to run the command in");
+      }
+      await context.client.session.prompt({ sessionID, text });
+    };
     const runWebDashboard = async (input) => {
       await handleWebDashboard(input, {
         dashboard: configManager.getConfig().dashboard,
         showToast: (options) => context.ui.toast.show(options),
-        openBrowser: openInBrowser
+        openBrowser: openInBrowser,
+        submitCommand: submitServerCommand
       });
     };
-    const handleDashboard = async () => {
+    const handleOverview = async () => {
       const config = configManager.getConfig();
       const lines = [
         "\u26A1 Nexus Overview",
@@ -800,7 +868,9 @@ var tui_default = define({
       lines.push("  /nexus status   - Show config summary");
       lines.push("  /nexus config   - Configure models & budget");
       lines.push("  /nexus model    - Select model for role");
-      lines.push("  /nexus web      - Open the web dashboard, if one is running");
+      lines.push("  /nexus dashboard - Start the web dashboard and open it");
+      lines.push("  /nexus web      - Same: start it if needed, then open it");
+      lines.push("  /nexus overview - Show this overview");
       lines.push("  /nexus reset    - Reset to defaults");
       lines.push("");
       lines.push("\uD83D\uDD27 Tools (use in agent prompt):");
@@ -813,7 +883,7 @@ var tui_default = define({
       lines.push("\uD83D\uDCCA Web Dashboard:");
       lines.push(`  Enabled: ${config.dashboard.enabled ? "\u2705" : "\u274C"}`);
       lines.push(`  Address: http://${config.dashboard.host}:${config.dashboard.port} (when running)`);
-      lines.push("  Not running? Ask the agent for nexus.dashboard.start, then /nexus web.");
+      lines.push("  Not running? /nexus dashboard starts it and opens it.");
       context.ui.toast.show({
         title: "Nexus Overview",
         message: lines.join(`
@@ -858,7 +928,10 @@ var tui_default = define({
                       break;
                     case "dashboard":
                     case "d":
-                      await handleDashboard();
+                      await runWebDashboard(parts.slice(1).join(" "));
+                      break;
+                    case "overview":
+                      await handleOverview();
                       break;
                     case "web":
                     case "w":
@@ -900,7 +973,7 @@ var tui_default = define({
                     default:
                       context.ui.toast.show({
                         title: "Nexus",
-                        message: "Commands: config, status, dashboard, web [port], model <role>, reset",
+                        message: "Commands: config, status, dashboard [port], web [port], overview, model <role>, reset",
                         variant: "info"
                       });
                   }
@@ -922,21 +995,34 @@ var tui_default = define({
               }
             },
             {
-              id: "nexus.dashboard",
+              id: "nexus.overview",
               title: "Nexus Overview (config, budget, dashboard status)",
               group: "Nexus",
               palette: true,
-              slash: { name: "nexus-dashboard", aliases: ["nd"], arguments: true },
+              slash: { name: "nexus-overview", aliases: ["no"], arguments: true },
               enabled: () => true,
               suggested: true,
               run: async () => {
-                await handleDashboard();
+                await handleOverview();
+              }
+            },
+            {
+              id: "nexus.dashboard",
+              title: "Start the Nexus Web Dashboard",
+              description: "Starts the dashboard server if it is not already running, then opens it in your browser",
+              group: "Nexus",
+              palette: true,
+              slash: { name: "nexus-dashboard", aliases: ["nd"], arguments: true },
+              enabled: () => true,
+              suggested: true,
+              run: async (input) => {
+                await runWebDashboard(input);
               }
             },
             {
               id: "nexus.web",
               title: "Open the Nexus Web Dashboard",
-              description: "Open the dashboard in your browser if one is already serving; otherwise say how to start it",
+              description: "Alias of Nexus Dashboard: starts it if needed, then opens it in your browser",
               group: "Nexus",
               palette: true,
               slash: { name: "nexus-web", aliases: ["nw"], arguments: true },
@@ -1186,6 +1272,8 @@ var tui_default = define({
   }
 });
 export {
+  LISTEN_CONFIRM_ATTEMPTS,
+  LISTEN_CONFIRM_INTERVAL_MS,
   collectSidebarAgents,
   tui_default as default,
   handleWebDashboard,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serkanalgur/opencode-nexus",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Adaptive Multi-Agent Orchestration with Cost Intelligence for OpenCode V2",
   "keywords": [
     "opencode",