@nexus-cortex/server 4.127.2 → 4.129.0

package/.cortex/agents/README.md

@@ -13,6 +13,20 @@ This directory contains Task Agent profiles. The orchestrator spawns agents via
 
 ---
 
+## Agent profile fields (frontmatter) — R266/R267, 2026-10-19
+
+| field | meaning |
+|---|---|
+| `name`, `description` | identity; `description` is what the parent reads when choosing a `subagent_type` |
+| `tools` | the delegate's allowlist (`all` = the deferred surface the parent has). SearchTools and EndTurn always survive it. The parent may widen it per call with `Task.tools: [...]` (ignored for `all`). |
+| `model` | `inherit`, an alias, or a full model id |
+| `anchor` | `bash-edit` \| `bash-only` \| `bash-plus` \| `lean` \| `none`. Unset = no turn-0 anchor: a delegate is a role agent and starts with its allowlist. Set it to give the delegate the parent's narrow door (see `action-agent.md`). |
+| `mcp` | comma list of MCP servers to auto-connect for this delegate (e.g. `nexus-browser`); their tools are injected and never stripped by deferred loading. Note: the `Browse` tool itself is refused inside a delegate (recursion guard) — a browsing profile declares `mcp: nexus-browser` and drives `nexus-browser__*` directly, as `web-researcher` does. |
+| body (after the frontmatter) | the delegate's SYSTEM PROMPT, replacing the card prompt. Leave it EMPTY to keep the card's own prompt (the narrow frame) — that is what `action-agent` does. |
+
+Two shipped shapes: **role agents** (`web-researcher`, the inline `browse-agent`: own prompt, tailored allowlist, no anchor) and the
+**action agent** (`action-agent`: card prompt + `bash-edit` anchor + `tools: all`, widened per call with `Task.tools`).
+
 ## Mode 1: Solo Agent
 
 A single Task tool call spawns one agent. The agent runs independently, completes its work, and returns results to the orchestrator.

package/.cortex/agents/action-agent.md

@@ -0,0 +1,7 @@
+---
+name: action-agent
+description: Narrow-frame ACTION delegate for a scoped coding sub-task. Enters through the parent's own Bash+Edit door (turn-0 anchor, orient, lift) with the card prompt — no persona. Use for "do this concrete change/run/measurement and report" work. Widen per call with Task.tools (e.g. ["Write","WebSearch"]) when the sub-task needs more than the narrow frame.
+tools: all
+model: inherit
+anchor: bash-edit
+---

package/.cortex/agents/web-researcher.md

@@ -9,10 +9,13 @@ tools:
   - Write
   - Bash
 model: inherit
+mcp: nexus-browser
 ---
 
 # Web Research Agent
 
+You run as a delegate: the `Browse` tool is NOT available inside a delegate (recursion guard). Drive the browser directly with the `nexus-browser__*` MCP tools (browse, scan, click, type, grab, extract_table, screenshot, close_session) — they are connected for you.
+
 You are a research agent specializing in gathering intelligence from live websites. Your job is to visit target URLs, capture visual references, extract design patterns, and compile structured research briefs.
 
 ## Capabilities

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/server",
-  "version": "4.127.2",
+  "version": "4.129.0",
   "description": "Thin Express server wrapper for Nexus Cortex core library",
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,8 @@
     "prepack": "node ../../scripts/copy-pkg-cortex-scaffold.mjs"
   },
   "dependencies": {
-    "@nexus-cortex/core": "4.127.2",
-    "@nexus-cortex/executors": "4.127.2",
+    "@nexus-cortex/core": "4.129.0",
+    "@nexus-cortex/executors": "4.129.0",
     "chalk": "^5.3.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.5",