nexus-agents 2.128.2 → 2.128.3

package/dist/{chunk-HFIYXKDQ.js → chunk-BKZ5YD66.js}

@@ -3,6 +3,7 @@ import {
   MCP_TIMEOUTS,
   SecurityError,
   TIMEOUT_GUARD,
+  TOOL_MANIFEST,
   ValidationError,
   createLogger,
   createMetricsMiddleware,
@@ -12,7 +13,7 @@ import {
   getTimeProvider,
   ok,
   resolveToolClassGuardMs
-} from "./chunk-QT3VRHNP.js";
+} from "./chunk-VBAGMX5I.js";
 import {
   getNexusDataDir
 } from "./chunk-ZGLIHPGJ.js";
@@ -1767,652 +1768,14 @@ function toSdkCallbackWithBudgetCheck(handler, toolName, configuredTimeoutMs, lo
 }
 
 // src/mcp/tools/tool-annotations.ts
-var TOOL_ANNOTATIONS = {
-  run: {
-    annotations: {
-      title: "Run (Adaptive Entry Point)",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "implicit", description: "Records a routing decision for observability" }
-    ]
-  },
-  delegate_to_model: {
-    annotations: {
-      title: "Delegate to Model",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  orchestrate: {
-    annotations: {
-      title: "Orchestrate Task",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Creates and executes expert agents" },
-      { category: "implicit", description: "Consumes API tokens from configured provider" },
-      { category: "coupling", description: "May trigger rate limiting on model adapter" },
-      { category: "coupling", description: "Records task outcome in OutcomeFeedbackCollector" }
-    ]
-  },
-  create_expert: {
-    annotations: {
-      title: "Create Expert",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "explicit", description: "Creates expert agent in shared registry" },
-      { category: "coupling", description: "Expert ID required by execute_expert" }
-    ]
-  },
-  execute_expert: {
-    annotations: {
-      title: "Execute Expert",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Executes expert agent task via model adapter" },
-      { category: "implicit", description: "Consumes API tokens from configured provider" },
-      { category: "coupling", description: "Requires expert created by create_expert" },
-      { category: "coupling", description: "May trigger rate limiting on model adapter" }
-    ]
-  },
-  run_workflow: {
-    annotations: {
-      title: "Run Workflow",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Executes multi-step workflow template" },
-      { category: "implicit", description: "Consumes API tokens if workflow uses model adapter" },
-      { category: "coupling", description: "May trigger rate limiting on model adapter" }
-    ]
-  },
-  list_experts: {
-    annotations: {
-      title: "List Experts",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  list_workflows: {
-    annotations: {
-      title: "List Workflows",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  consensus_vote: {
-    annotations: {
-      title: "Consensus Vote",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Executes multi-agent voting across CLIs" },
-      { category: "implicit", description: "Consumes API tokens from multiple providers" },
-      { category: "coupling", description: "Records vote outcomes for weather report" }
-    ]
-  },
-  research_query: {
-    annotations: {
-      title: "Research Query",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  research_add: {
-    annotations: {
-      title: "Research Add",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Adds paper to research registry on disk" },
-      { category: "implicit", description: "Fetches metadata from arXiv API" }
-    ]
-  },
-  research_discover: {
-    annotations: {
-      title: "Research Discover",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "implicit", description: "Queries external APIs (arXiv, GitHub, etc.)" },
-      { category: "coupling", description: "Auto-catalogs discovered references" }
-    ]
-  },
-  survey_oss_landscape: {
-    annotations: {
-      title: "Survey OSS Landscape",
-      readOnlyHint: true,
-      destructiveHint: false,
-      // Same query may return different results day-to-day as star counts
-      // and last-commit dates evolve; idempotentHint=false matches reality.
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [{ category: "implicit", description: "Queries the GitHub search API" }]
-  },
-  vendor_publishing_audit: {
-    annotations: {
-      title: "Vendor Publishing Audit",
-      readOnlyHint: true,
-      destructiveHint: false,
-      // Pure static lookup against the in-process seed dataset.
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  compare_data_feeds: {
-    annotations: {
-      title: "Compare Data Feeds",
-      readOnlyHint: true,
-      destructiveHint: false,
-      // Same input → same output; pure file diff with no external calls.
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Reads two files from the workspace" }]
-  },
-  research_analyze: {
-    annotations: {
-      title: "Research Analyze",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  research_catalog_review: {
-    annotations: {
-      title: "Research Catalog Review",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "explicit", description: "Approves or dismisses cataloged references" },
-      { category: "coupling", description: "Approved items added to research registry" }
-    ]
-  },
-  memory_query: {
-    annotations: {
-      title: "Memory Query",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "implicit", description: "Consumes rate limit quota" },
-      { category: "implicit", description: "May trigger reflective retrieval (MemR3)" }
-    ]
-  },
-  memory_stats: {
-    annotations: {
-      title: "Memory Stats",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  memory_write: {
-    annotations: {
-      title: "Memory Write",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "explicit", description: "Writes data to memory backend" },
-      { category: "implicit", description: "Consumes rate limit quota" }
-    ]
-  },
-  weather_report: {
-    annotations: {
-      title: "Weather Report",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Consumes rate limit quota" }]
-  },
-  improvement_review: {
-    annotations: {
-      title: "Improvement Review",
-      readOnlyHint: false,
-      destructiveHint: false,
-      // When fileIssues=true, creates GitHub issues — not idempotent.
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "implicit", description: "Reads OutcomeStore and runs fitness audit" },
-      {
-        category: "explicit",
-        description: "When fileIssues=true, files candidate GitHub issues via gh CLI"
-      },
-      { category: "implicit", description: "Consumes rate limit quota" }
-    ]
-  },
-  run_quality_gate: {
-    annotations: {
-      title: "Run Quality Gate",
-      // Spawns build/test toolchains which can write artifacts — not read-only.
-      readOnlyHint: false,
-      destructiveHint: false,
-      // Same checks against the same code yield the same verdict.
-      idempotentHint: true,
-      // build/test/security invoke local toolchains and may reach the network.
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Spawns local toolchain processes (tsc/eslint/vitest/build) in the target project dir"
-      },
-      {
-        category: "implicit",
-        description: "build/test checks may write build artifacts and coverage output to disk"
-      }
-    ]
-  },
-  issue_triage: {
-    annotations: {
-      title: "Issue Triage",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "implicit", description: "Fetches issue data from GitHub API" },
-      { category: "implicit", description: "Consumes rate limit quota" }
-    ]
-  },
-  run_graph_workflow: {
-    annotations: {
-      title: "Run Graph Workflow",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Executes graph-based workflow with checkpointing" },
-      { category: "implicit", description: "Writes checkpoint files to disk" },
-      { category: "coupling", description: "May trigger rate limiting on model adapters" }
-    ]
-  },
-  execute_spec: {
-    annotations: {
-      title: "Execute Spec",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Parses and executes markdown specification" },
-      { category: "implicit", description: "Consumes API tokens from configured provider" },
-      { category: "implicit", description: "Writes execution trace to disk" }
-    ]
-  },
-  registry_import: {
-    annotations: {
-      title: "Registry Import",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "explicit", description: "Generates draft model registry entry" }]
-  },
-  query_trace: {
-    annotations: {
-      title: "Query Trace",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "implicit", description: "Reads execution trace JSONL files from disk" }
-    ]
-  },
-  repo_analyze: {
-    annotations: {
-      title: "Repo Analyze",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Fetches repository metadata from GitHub API via gh CLI"
-      },
-      { category: "implicit", description: "Consumes rate limit quota" }
-    ]
-  },
-  repo_security_plan: {
-    annotations: {
-      title: "Repo Security Plan",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Fetches repository metadata from GitHub API via gh CLI"
-      },
-      { category: "implicit", description: "Consumes rate limit quota" }
-    ]
-  },
-  research_add_source: {
-    annotations: {
-      title: "Research Add Source",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Adds a non-paper source to the research registry" },
-      { category: "coupling", description: "New entries affect research_discover/research_query" }
-    ]
-  },
-  research_synthesize: {
-    annotations: {
-      title: "Research Synthesize",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Reads research catalog + alignment map" }]
-  },
-  query_task_state: {
-    annotations: {
-      title: "Query Task State",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      { category: "implicit", description: "Reads the structured task-state log (#2278)" }
-    ]
-  },
-  get_job_result: {
-    annotations: {
-      title: "Get Job Result",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Reads the async-mode job-result sidecar (#3042 / epic #2631)"
-      }
-    ]
-  },
-  list_jobs: {
-    annotations: {
-      title: "List Jobs",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Lists async-mode job summaries from the sidecar dir (#3046 / epic #2631 Stage 5)"
-      }
-    ]
-  },
-  cancel_job: {
-    annotations: {
-      title: "Cancel Job",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      {
-        category: "explicit",
-        description: "Writes cancellation record to the async-mode sidecar (#3042 Stage 1b)"
-      },
-      {
-        category: "coupling",
-        description: "Triggers AbortSignal unwind in same-process dispatcher (cross-process workers must poll)"
-      }
-    ]
-  },
-  verify_audit_chain: {
-    annotations: {
-      title: "Verify Audit Chain",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Reads the immutable audit log and verifies the hash chain"
-      }
-    ]
-  },
-  ci_health_check: {
-    annotations: {
-      // #3530: NOT read-only / idempotent — every call appends a CI-health
-      // telemetry event (appendCiHealthEvent in ci-health-check-tool.ts), which
-      // both writes local state and accumulates per call. The check itself only
-      // reads upstream, but the per-call telemetry append is a real side effect.
-      title: "CI Health Check",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      // Outbound network to githubstatus.com + GitHub API.
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Fetches GitHub status-page + repo actions/runs to assess CI infrastructure health (#3076)"
-      },
-      {
-        category: "implicit",
-        description: "Appends a local CI-health telemetry event per call for observability (#3530)"
-      }
-    ]
-  },
-  extract_symbols: {
-    annotations: {
-      title: "Extract Symbols",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [{ category: "implicit", description: "Reads source files and walks their ASTs" }]
-  },
-  search_codebase: {
-    annotations: {
-      title: "Search Codebase",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Reads source files and builds an in-memory symbol index"
-      }
-    ]
-  },
-  run_dev_pipeline: {
-    annotations: {
-      title: "Run Dev Pipeline",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "explicit",
-        description: "Executes the V2 dev pipeline (delegates to CLI adapters)"
-      },
-      {
-        category: "implicit",
-        description: "Consumes API tokens; persists outcomes and checkpoints"
-      },
-      {
-        category: "coupling",
-        description: "Writes routing/learning state consumed by future runs"
-      }
-    ]
-  },
-  run_pipeline: {
-    annotations: {
-      title: "Run Pipeline",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      { category: "explicit", description: "Executes a generic V2 pipeline TaskContract" },
-      { category: "implicit", description: "Consumes API tokens; emits pipeline events" },
-      { category: "coupling", description: "Writes policy/audit state consumed by other tools" }
-    ]
-  },
-  pr_review: {
-    annotations: {
-      title: "PR Review",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "explicit",
-        description: "Runs multi-voter PR review with verification gate (#2233)"
-      },
-      { category: "implicit", description: "Consumes API tokens across voter CLIs" },
-      { category: "coupling", description: "Records voter outcomes for weather report" }
-    ]
-  },
-  suggest_research_tasks: {
-    annotations: {
-      title: "Suggest Research Tasks",
-      // SUGGEST-ONLY: discovers/reads via research_discover and returns
-      // candidate tasks. Files nothing, executes nothing, mutates nothing.
-      readOnlyHint: true,
-      destructiveHint: false,
-      // Discovery results vary run-to-run as external sources evolve.
-      idempotentHint: false,
-      // Reaches external research APIs (arXiv/GitHub/etc.) via the engine.
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Queries research_discover / external research APIs; consumes tokens"
-      }
-    ]
-  },
-  list_available_models: {
-    annotations: {
-      title: "List Available Models",
-      // Probes discovery transports and reports health. Reads only; mutates
-      // nothing and does not change routing.
-      readOnlyHint: true,
-      destructiveHint: false,
-      // Probe results vary as catalogs/CLIs change.
-      idempotentHint: false,
-      // Reaches the OpenRouter API + spawns CLI probes.
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "implicit",
-        description: "Fetches the OpenRouter catalog + probes CLI adapters (network/subprocess)"
-      }
-    ]
-  },
-  supply_chain_tradeoff_panel: {
-    annotations: {
-      title: "Supply-chain Tradeoff Panel",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true
-    },
-    sideEffects: [
-      {
-        category: "explicit",
-        description: "Runs per-axis tradeoff vote (build_time_determinism / supply_chain_risk / update_cadence) (#2294)"
-      },
-      { category: "implicit", description: "Consumes API tokens across voter CLIs" },
-      { category: "coupling", description: "Records voter outcomes for weather report" }
-    ]
-  }
-};
+var TOOL_ANNOTATIONS = Object.freeze(
+  Object.fromEntries(
+    TOOL_MANIFEST.map((entry) => [
+      entry.name,
+      { annotations: entry.annotations, sideEffects: entry.sideEffects }
+    ])
+  )
+);
 function getMcpAnnotations(toolName) {
   return TOOL_ANNOTATIONS[toolName]?.annotations;
 }
@@ -2627,4 +1990,4 @@ export {
   VOTING_THRESHOLDS,
   ConsensusMetricsSchema
 };
-//# sourceMappingURL=chunk-HFIYXKDQ.js.map
+//# sourceMappingURL=chunk-BKZ5YD66.js.map