nexus-agents 2.77.0 → 2.77.2

package/dist/{chunk-KYCZCROX.js → chunk-6UDFAXUI.js}

@@ -9,7 +9,7 @@ import {
   defaultConfig,
   initDataDirectories,
   probeAllClis
-} from "./chunk-N2QNLBS5.js";
+} from "./chunk-RFITLMH4.js";
 import {
   BUILT_IN_EXPERTS
 } from "./chunk-ZM4O442V.js";
@@ -1946,4 +1946,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=chunk-KYCZCROX.js.map
+//# sourceMappingURL=chunk-6UDFAXUI.js.map

package/dist/{chunk-T3LEOO3A.js → chunk-N3HOBUU4.js}

@@ -70,7 +70,7 @@ import {
   clampTaskTtl,
   getAvailabilityCache,
   resolveFallback
-} from "./chunk-N2QNLBS5.js";
+} from "./chunk-RFITLMH4.js";
 import {
   DEFAULTS
 } from "./chunk-YQMQSJQK.js";
@@ -1521,6 +1521,10 @@ var BaseAgentOptionsSchema = z4.object({
     "pm_expert",
     "ux_expert",
     "infrastructure_expert",
+    "qa_expert",
+    // #2715 — was missing from this Zod copy; canonical AgentRole has it
+    "data_visualization_expert",
+    // #2715 — same
     "thinker",
     "worker",
     "verifier",
@@ -10603,17 +10607,7 @@ function createManyExperts(configs, options) {
   return ok(experts);
 }
 function createAllBuiltInExperts(options) {
-  const types = [
-    "code",
-    "architecture",
-    "security",
-    "documentation",
-    "testing",
-    "devops",
-    "research",
-    "pm",
-    "ux"
-  ];
+  const types = Object.keys(BUILT_IN_EXPERTS);
   const experts = [];
   for (const type of types) {
     const result = createBuiltInExpert(type, options);
@@ -26231,7 +26225,7 @@ function registerRunWorkflowTool(server, deps) {
   server.registerTool(
     "run_workflow",
     {
-      description: "Execute a workflow template with provided inputs, supporting built-in templates and custom paths",
+      description: "Run a LINEAR (single-path) workflow template by name with typed inputs. For DAG-shaped workflows with branching, checkpoints, or rollback, use `run_graph_workflow` instead.",
       inputSchema: toolInputSchema,
       annotations: getToolAnnotations("run_workflow")
     },
@@ -34196,7 +34190,7 @@ function registerDelegateToModelTool(server, deps) {
   server.registerTool(
     "delegate_to_model",
     {
-      description: "Route a task to the optimal model based on capability matching. Returns model recommendation with reasoning.",
+      description: "Pick which EXISTING model should handle a task. Inspects task complexity and returns the best-fit model from the routing registry \u2014 does NOT add a new model. Read-only. (For drafting a registry entry for a new model, use `registry_import`.)",
       inputSchema: TOOL_SCHEMA,
       outputSchema: DelegateOutputSchema.shape,
       annotations: getToolAnnotations("delegate_to_model")
@@ -35149,7 +35143,7 @@ function registerListExpertsTool(server, deps) {
   const toolSchema = {
     format: z57.enum(["full", "names"]).optional().describe("Output format: full (with details) or names (just role names)")
   };
-  const description2 = "List available expert types that can be created with create_expert. Returns role names, descriptions, and capabilities for each expert type.";
+  const description2 = "Inventory of expert ROLES available to `create_expert` (architect, security, devex, etc.). Use this BEFORE create_expert to pick a role; returns role name, capability summary, default model.";
   const secureHandler = createSecureHandler(listExpertsHandler, {
     toolName: "list_experts",
     rateLimiter: deps.rateLimiter,
@@ -35242,7 +35236,7 @@ function registerListWorkflowsTool(server, deps) {
     category: z58.string().optional().describe("Filter by category (e.g., development, security)"),
     format: z58.enum(["full", "names"]).optional().describe("Output format: full (with details) or names (just template names)")
   };
-  const description2 = "List available workflow templates that can be executed with run_workflow. Returns template names, versions, descriptions, and categories.";
+  const description2 = "Inventory of multi-step TEMPLATES available to `run_workflow` (code-review, security-audit, etc.). Use this BEFORE run_workflow to pick a template; returns template name, version, description, category, and required inputs.";
   const secureHandler = createSecureHandler(createListWorkflowsHandler(deps.workflowEngine), {
     toolName: "list_workflows",
     rateLimiter: deps.rateLimiter,
@@ -35835,7 +35829,7 @@ function registerExecuteExpertTool(server, deps) {
   const logger51 = deps.logger ?? createLogger({ tool: "execute_expert" });
   const notifier = deps.notifier ?? createMcpNotifier(server);
   const depsWithNotifier = { ...deps, notifier };
-  const description2 = "Execute a task using a previously created expert agent. Returns the expert analysis including output, confidence, and token usage.";
+  const description2 = "Run a task through an expert YOU PREVIOUSLY CREATED via `create_expert`. Requires the expertId returned by create_expert; not for ad-hoc execution. Returns the expert analysis including output, confidence, and token usage.";
   server.experimental.tasks.registerToolTask(
     "execute_expert",
     {
@@ -37328,7 +37322,7 @@ function registerResearchAddTool(server, deps) {
     priority: z63.enum(["P1", "P2", "P3", "P4"]).optional().describe("Priority level"),
     dryRun: z63.boolean().optional().default(false).describe("Preview without persisting")
   };
-  const description2 = "Add an arXiv paper to the research registry. Fetches metadata from the arXiv API and persists to the registry. Use dryRun=true to preview without saving.";
+  const description2 = "PAPER-only: add an arXiv preprint to the research registry by arXiv ID. Fetches metadata from arxiv.org and persists to the registry. For non-paper sources (GitHub repos, tools, blogs) use `research_add_source` instead. Use dryRun=true to preview without saving.";
   const secureHandler = createSecureHandler(createResearchAddHandler(deps), {
     toolName: "research_add",
     rateLimiter: deps.rateLimiter,
@@ -37544,7 +37538,7 @@ function registerResearchAddSourceTool(server, deps) {
     verdict_notes: z64.string().max(500).optional().describe("Verdict notes"),
     dryRun: z64.boolean().optional().default(false).describe("Preview only")
   };
-  const description2 = "Add a non-paper source (GitHub repo, tool, blog) to the research registry. Auto-computes quality_score from provided quality_signals. Use dryRun=true to preview without saving.";
+  const description2 = "NON-PAPER source: add a GitHub repo / tool / blog URL to the research registry. Auto-computes quality_score from provided quality_signals. For arXiv papers use `research_add` instead. Use dryRun=true to preview without saving.";
   const secureHandler = createSecureHandler(createResearchAddSourceHandler(deps), {
     toolName: "research_add_source",
     securityTier: "external",
@@ -38793,7 +38787,7 @@ async function handleRunGraphWorkflow(input, logger51) {
     checkpointCount
   };
 }
-var GRAPH_WORKFLOW_DESCRIPTION = "Execute a predefined graph-based workflow with checkpointing, event streaming, and audit trail support";
+var GRAPH_WORKFLOW_DESCRIPTION = "Run a DAG-shaped workflow with per-node checkpoints, rollback, event streaming, and audit trail. Use for multi-step pipelines where intermediate state must survive failures. For straight linear templates, use `run_workflow` instead.";
 var GRAPH_WORKFLOW_SCHEMA = {
   workflow: z70.string().min(1).max(100).describe(
     'Workflow name: echo, pipeline, code-review, security-scan. Use "list" for available workflows.'
@@ -40211,7 +40205,7 @@ function registerRegistryImportTool(server, deps) {
     modelId: z77.string().min(1).describe("Provider model identifier"),
     dryRun: z77.boolean().optional().describe("Preview without persisting (default: true)")
   };
-  const description2 = "Add an AI model to the registry. Generates a draft ModelCapability entry with conservative quality scores (5/10) for human review. Use dryRun=true (default) to preview the entry without saving.";
+  const description2 = "Draft a registry ENTRY for a NEW model so routing can consider it later. Generates a ModelCapability YAML with conservative quality scores (5/10) for human review. For picking among ALREADY-registered models, use `delegate_to_model`. Use dryRun=true (default) to preview the entry without saving.";
   const secureHandler = createSecureHandler(registryImportHandler, {
     toolName: "registry_import",
     rateLimiter: deps.rateLimiter,
@@ -40432,7 +40426,7 @@ function registerSearchCodebaseTool(server, deps) {
     limit: z82.number().min(1).max(50).optional().describe("Max results"),
     mode: z82.enum(["search", "summary", "list"]).optional().describe("search/summary/list")
   };
-  const description2 = "Search a codebase for functions, classes, methods, interfaces, and types. Builds an in-memory symbol index and supports keyword search with relevance scoring. Modes: search (find symbols), summary (file overview), list (all indexed files).";
+  const description2 = "Cross-file ripgrep-style search across the working directory. Builds an in-memory symbol index and ranks matches with relevance scoring. Use when you need usages of a symbol or pattern across MANY files. For the AST of a single file, use `extract_symbols` instead. Modes: search (find by keyword), summary (per-file overview), list (all indexed files).";
   const secureHandler = createSecureHandler(searchCodebaseHandler, {
     toolName: "search_codebase",
     rateLimiter: deps.rateLimiter,
@@ -40517,7 +40511,7 @@ function registerExtractSymbolsTool(server, deps) {
     filePath: z83.string().min(1).max(500).describe("Path to TypeScript/JavaScript file"),
     mode: z83.enum(["index", "full"]).optional().describe("index (default): names+lines. full: includes source text")
   };
-  const description2 = "Extract function, class, method, interface, and type definitions from a TypeScript/JavaScript file. Returns a compact symbol index (80%+ smaller than reading the full file) for token-efficient code retrieval.";
+  const description2 = "Parse a SINGLE TypeScript/JavaScript file with tree-sitter and return its structural AST symbols. Use when you need the structure of one file \u2014 function/class/method/interface/type definitions. Not a cross-file search; for that use `search_codebase`. Output is 80%+ smaller than reading the full file.";
   const secureHandler = createSecureHandler(extractSymbolsHandler, {
     toolName: "extract_symbols",
     rateLimiter: deps.rateLimiter,
@@ -45668,7 +45662,7 @@ var PipelineInputSchema = z97.object({
   task: z97.string().min(5).max(1e4).describe("Task description \u2014 pipeline template auto-selected based on content"),
   /** Path to a spec file (.md, .yaml) to use as task input. */
   specFile: z97.string().max(500).optional().describe("Path to a spec file \u2014 content prepended to task for greenfield projects"),
-  /** Override template (dev, research, audit, greenfield). Auto-detected if omitted. */
+  /** Override template — see `listTemplateIds()` for the canonical list (#2728). Auto-detected if omitted. */
   template: z97.string().max(50).optional().describe(`Pipeline template override. Available: ${listTemplateIds().join(", ")}`),
   /** Voting strategy for consensus stages. */
   votingStrategy: z97.enum([
@@ -45734,7 +45728,7 @@ function selectStageRegistry(template, task, agentStages) {
   }
   return createDevStageRegistry(agentStages);
 }
-var RUN_PIPELINE_DESCRIPTION = "Single unified entry point for all pipeline templates (dev/research/audit/greenfield). Auto-detects template from task content or accepts an explicit override.";
+var RUN_PIPELINE_DESCRIPTION = `Single unified entry point for all pipeline templates (${listTemplateIds().join("/")}). Auto-detects template from task content or accepts an explicit override.`;
 function registerPipelineTool(server, _deps) {
   server.registerTool(
     "run_pipeline",
@@ -50007,4 +50001,4 @@ export {
   detectBackend,
   createTaskTracker
 };
-//# sourceMappingURL=chunk-T3LEOO3A.js.map
+//# sourceMappingURL=chunk-N3HOBUU4.js.map