@serkanalgur/opencode-nexus 1.8.3 → 1.9.0

package/dist/index.js

@@ -11454,6 +11454,19 @@ The currency of the whole orchestration is the **validated commit**: a delivery
 
 Execute the five phases in order. Never skip the quality gate.
 
+## ⛔ STRICT RULE: Agent Spawning
+
+**NEVER use OpenCode's built-in \`subagent\` tool. It bypasses Nexus entirely — no cost tracking, no sidebar updates, no self-healing, no session linking.**
+
+**ALWAYS use \`nexus.spawn\` or \`nexus.delegate\` to create sub-agents.** These tools:
+- Track costs against your budget
+- Update the sidebar in real-time
+- Link child sessions to your parent session in the OpenCode UI
+- Enable self-healing on failure
+- Record performance metrics for model selection
+
+If you accidentally use \`subagent\`, the task will be invisible to Nexus and will not appear in the dashboard or sidebar. This is a hard requirement, not a suggestion.
+
 ## Model configuration
 
 Read your model pools from the first file that exists: \`.opencode/nexus.jsonc\` in the project, then \`~/.config/opencode/nexus.jsonc\`. The configuration maps complexity levels to model pools:

package/dist/tui.js

@@ -34763,6 +34763,34 @@ var tui_default = define({
         }
       });
     });
+    const unsubSessionCreated = context.data.on("session.created", (event) => {
+      const newSession = event.data;
+      const newSessionID = newSession.sessionID;
+      const currentRoute = context.ui.router.current();
+      const currentSessionID = currentRoute.type === "session" ? currentRoute.sessionID : null;
+      if (!currentSessionID || !newSessionID)
+        return;
+      const family = context.data.session.family(newSessionID);
+      if (family.includes(currentSessionID) && newSessionID !== currentSessionID) {
+        const meta = newSession.metadata || {};
+        setSidebarState((draft) => {
+          const exists = draft.agents.some((a) => a.sessionID === newSessionID);
+          if (!exists) {
+            draft.agents.push({
+              id: newSessionID,
+              name: newSession.title || newSessionID.slice(0, 12),
+              role: meta.nexusRole || "agent",
+              status: "working",
+              model: meta.nexusModel || "",
+              sessionID: newSessionID,
+              spawnedAt: new Date().toISOString(),
+              tasksCompleted: 0,
+              tasksFailed: 0
+            });
+          }
+        });
+      }
+    });
     const unsubSidebar = context.ui.slot({
       append: "sidebar.content",
       render: (props) => {
@@ -34870,6 +34898,7 @@ var tui_default = define({
     return () => {
       unsubSessionSucceeded();
       unsubSessionFailed();
+      unsubSessionCreated();
       unsubSidebar();
     };
   }

package/package.json

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