nexus-agents 8.57.0 → 8.58.1

package/dist/{chunk-H3PRTTXF.js → chunk-CFQWCVDI.js}

@@ -1,6 +1,6 @@
 // src/version.ts
 import semver from "semver";
-var VERSION = true ? "8.57.0" : "dev";
+var VERSION = true ? "8.58.1" : "dev";
 var NODE_ENGINE_RANGE = ">=22.5.0";
 function isNodeVersionSupported(version) {
   return semver.satisfies(version, NODE_ENGINE_RANGE);
@@ -11,4 +11,4 @@ export {
   NODE_ENGINE_RANGE,
   isNodeVersionSupported
 };
-//# sourceMappingURL=chunk-H3PRTTXF.js.map
+//# sourceMappingURL=chunk-CFQWCVDI.js.map

package/dist/{chunk-W6VHVDZM.js → chunk-EQDO4IGT.js}

@@ -21,11 +21,12 @@ import {
 import {
   DEFAULT_TASK_TTL_MS,
   clampTaskTtl
-} from "./chunk-IJMAA7MV.js";
+} from "./chunk-YWG3G4OH.js";
 import {
   executeExpert
 } from "./chunk-QMGMD6JB.js";
 import {
+  DEPRECATED_MODE_ALIAS_INPUT,
   JobStatusSchema,
   VOTER_ROLES,
   VoterProjectInputSchema,
@@ -35,12 +36,16 @@ import {
   appendResult,
   assertNotSourceCheckoutWrite,
   assignPanelSeats,
+  asyncDispatchInput,
+  asyncDispatchInputDefaultSync,
   checkSimulationAllowed,
   collectRealVotes,
   defaultBusyEnvelope,
   defaultCollisionEnvelope,
   defaultPendingEnvelope,
   defaultReplayEnvelope,
+  deprecatedModeWarning,
+  dispatchFieldDefaultSync,
   initTaskState,
   isAbandonedJob,
   isAbsentSeat,
@@ -48,12 +53,15 @@ import {
   isRateLimitError,
   listJobsWithDiagnostics,
   listTaskStateIds,
+  modeEnumErrorNamingDispatch,
   readJobResult,
   readTaskState,
   recordDecisionCost,
+  refineDispatchModeAgreement,
   registerIdempotentJob,
   resolveAdapter,
   resolveAndLogVoterProject,
+  resolveDispatch,
   resolveIdempotency,
   runAsJob,
   runConsensusForGoal,
@@ -61,8 +69,9 @@ import {
   simulationDeniedResult,
   toJobSummary,
   updateStage,
+  withWarnings,
   writeJobCancelled
-} from "./chunk-XU72ZQ5Z.js";
+} from "./chunk-QRTJ7AAM.js";
 import {
   allOf,
   anyOf
@@ -82,7 +91,7 @@ import {
 } from "./chunk-RNWUIQTZ.js";
 import {
   withPrerequisite
-} from "./chunk-3KOCMFOK.js";
+} from "./chunk-T4SXP67G.js";
 import {
   NOOP_NOTIFIER,
   RateLimiter,
@@ -107,7 +116,7 @@ import {
   withAuditTrail,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-VCLNGU3S.js";
+} from "./chunk-L2BSHP47.js";
 import {
   createAuditTrail,
   createGraphAuditBridge,
@@ -29169,11 +29178,14 @@ var RunWorkflowInputSchema = z57.object({
    * cap is enforced in-process via NEXUS_JOB_MAX_CONCURRENT_RUN_WORKFLOW;
    * over-cap returns `{ status: 'busy', retryAfterMs }` synchronously.
    *
-   * Kept optional (no `.default()`) so the inferred type doesn't force
-   * `mode: 'sync'` on every existing call site / test fixture. The
-   * handler treats `undefined` as `'sync'`.
+   * The key is `dispatch` (#4968); `mode` is the deprecated alias this tool
+   * used to spell it with, resolved as `dispatch ?? mode` by the handler and
+   * rejected when the two disagree (the `superRefine` below). Both optional
+   * (no `.default()`) so the inferred type doesn't force a value onto every
+   * existing call site / test fixture; the handler treats `undefined` as
+   * `'sync'`.
    */
-  mode: z57.enum(["sync", "async"]).optional().describe('Dispatch mode (default: sync). Use "async" for long-running workflows.'),
+  ...DEPRECATED_MODE_ALIAS_INPUT,
   /**
    * Idempotency key for async-mode replay-safety (#3042 Stage 1c / epic
    * #2631). When set: identical (key, inputs) returns the existing job;
@@ -29183,7 +29195,8 @@ var RunWorkflowInputSchema = z57.object({
   idempotencyKey: z57.string().min(1).max(256).optional().describe(
     "Replay-safe key for async-mode dispatch (#3042 Stage 1c). Same (key, inputs) returns existing jobId."
   )
-});
+  // #4968: `dispatch` and the deprecated `mode` alias must agree when both are sent.
+}).superRefine(refineDispatchModeAgreement);
 
 // src/mcp/tools/run-workflow-helpers.ts
 import { resolve as resolve5, sep as sep2 } from "node:path";
@@ -29563,7 +29576,7 @@ function dispatchAsyncRunWorkflow(deps, args) {
       busy: (retryAfterMs) => successResponse({
         status: "busy",
         retryAfterMs,
-        note: 'Async-mode concurrency cap reached for run_workflow. Retry later or use mode: "sync".'
+        note: 'Async-mode concurrency cap reached for run_workflow. Retry later or use dispatch: "sync".'
       }),
       replay: buildRunWorkflowReplayEnvelope,
       collision: buildRunWorkflowCollisionEnvelope
@@ -29579,22 +29592,24 @@ function createRunWorkflowHandler(deps) {
       const errorMessage2 = validated.error.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
       return errorResponse(`Validation error: ${errorMessage2}`);
     }
+    const dispatch = resolveDispatch(validated.data);
+    const modeWarning = deprecatedModeWarning(validated.data);
     ctx.logger.debug("Running workflow", {
       template: validated.data.template,
       dryRun: validated.data.dryRun,
-      ...validated.data.mode !== void 0 ? { mode: validated.data.mode } : {}
+      ...dispatch !== void 0 ? { dispatch } : {}
     });
     notifier.info("run_workflow", { event: "workflow_start", template: validated.data.template });
     const startMs = getTimeProvider().now();
-    if (validated.data.mode === "async" && !validated.data.dryRun) {
+    if (dispatch === "async" && !validated.data.dryRun) {
       const asyncResult = dispatchAsyncRunWorkflow(deps, validated.data);
       notifier.info("run_workflow", {
         event: "workflow_dispatched_async",
         template: validated.data.template
       });
-      return asyncResult;
+      return withWarnings(asyncResult, [modeWarning]);
     }
-    const result = await handleRunWorkflow(deps, validated.data);
+    const result = withWarnings(await handleRunWorkflow(deps, validated.data), [modeWarning]);
     if (result.isError !== true) {
       notifier.info("run_workflow", {
         event: "workflow_complete",
@@ -29619,7 +29634,7 @@ function registerRunWorkflowTool(server, deps) {
   server.registerTool(
     "run_workflow",
     {
-      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. Supports mode: 'async' (non-dryRun runs) \u2014 returns a jobId immediately; poll get_job_result.",
+      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. Supports dispatch: 'async' (non-dryRun runs; `mode` is a deprecated alias) \u2014 returns a jobId immediately; poll get_job_result.",
       inputSchema: toolInputSchema,
       annotations: getToolAnnotations("run_workflow")
     },
@@ -32965,11 +32980,14 @@ var OrchestrateInputSchema = z61.object({
    * orchestrations (#2631 evidence: 28.6% timeout-shaped errors on
    * `run_workflow` at the gate-firing measurement).
    *
-   * Kept optional (no `.default()`) so the inferred type doesn't force
-   * `mode: 'sync'` on every existing call site / test fixture. The
-   * handler treats `undefined` as `'sync'`.
+   * The key is `dispatch` (#4968); `mode` is the deprecated alias this tool
+   * used to spell it with, resolved as `dispatch ?? mode` by the handler and
+   * rejected when the two disagree (the `superRefine` below). Both optional
+   * (no `.default()`) so the inferred type doesn't force a value onto every
+   * existing call site / test fixture; the handler treats `undefined` as
+   * `'sync'`.
    */
-  mode: z61.enum(["sync", "async"]).optional().describe('Dispatch mode (default: sync). Use "async" for long-running orchestrations.'),
+  ...DEPRECATED_MODE_ALIAS_INPUT,
   /**
    * Idempotency key for async-mode replay-safety (#3042 Stage 1c / epic
    * #2631). When set: identical (key, inputs) returns the existing job;
@@ -32981,7 +32999,8 @@ var OrchestrateInputSchema = z61.object({
   idempotencyKey: z61.string().min(1).max(256).optional().describe(
     "Replay-safe key for async-mode dispatch (#3042 Stage 1c). Same (key, inputs) returns existing jobId; same key + different inputs fails closed."
   )
-});
+  // #4968: `dispatch` and the deprecated `mode` alias must agree when both are sent.
+}).superRefine(refineDispatchModeAgreement);
 var OrchestrateOutputSchema = z61.object({
   taskId: z61.string().describe("Unique execution ID"),
   analysis: z61.object({
@@ -33037,9 +33056,9 @@ var ORCHESTRATE_TOOL_SCHEMA = {
   context: z61.record(z61.string(), z61.unknown()).optional().describe("Additional context for the task"),
   maxIterations: z61.number().min(1).max(50).optional().describe("Maximum iterations for orchestration (default: 10)"),
   timeout: z61.number().min(1e3).max(6e5).optional().describe("Timeout in milliseconds for orchestration (default: 300000)"),
-  mode: z61.enum(["sync", "async"]).optional().describe(
-    'Dispatch mode (default: sync). "async" returns { jobId } immediately; poll via get_job_result.'
-  ),
+  // #4968: the same fragment the internal schema composes, so the advertised
+  // shape cannot omit `dispatch` (the SDK strips what is not advertised).
+  ...DEPRECATED_MODE_ALIAS_INPUT,
   idempotencyKey: z61.string().min(1).max(256).optional().describe(
     "Replay-safe key for async-mode dispatch (#3042 Stage 1c). Same (key, inputs) returns existing jobId."
   )
@@ -37235,17 +37254,22 @@ function createOrchestrateHandler(deps) {
         message: `Validation error: ${formatZodError(validated.error)}`
       });
     }
-    if (validated.data.mode === "async") {
-      return dispatchAsyncOrchestrate({
-        input: validated.data,
-        deps,
-        notifier,
-        logger: ctx.logger,
-        trustTier: ctx.requestContext.trustTier
-      });
+    const dispatch = resolveDispatch(validated.data);
+    const modeWarning = deprecatedModeWarning(validated.data);
+    if (dispatch === "async") {
+      return withWarnings(
+        dispatchAsyncOrchestrate({
+          input: validated.data,
+          deps,
+          notifier,
+          logger: ctx.logger,
+          trustTier: ctx.requestContext.trustTier
+        }),
+        [modeWarning]
+      );
     }
     try {
-      return await withDepthGuard(
+      const result = await withDepthGuard(
         "orchestrate",
         () => runOrchestratePipeline({
           input: validated.data,
@@ -37256,6 +37280,7 @@ function createOrchestrateHandler(deps) {
           trustTier: ctx.requestContext.trustTier
         })
       );
+      return withWarnings(result, [modeWarning]);
     } catch (depthError) {
       const msg = depthError instanceof Error ? depthError.message : String(depthError);
       ctx.logger.warn("Orchestration depth guard triggered", { error: msg });
@@ -41441,9 +41466,7 @@ var RunGraphWorkflowInputSchema = z80.object({
    * envelope immediately and runs in the background; poll
    * `get_job_result({ jobId })` for the result. Ignored for the `list` sentinel.
    */
-  dispatch: z80.enum(["sync", "async"]).optional().default("sync").describe(
-    "Dispatch mode (#3732). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result)."
-  )
+  ...asyncDispatchInputDefaultSync("Ignored for the `list` sentinel.")
 });
 function resolveGraph(workflow, startTime) {
   const registry = getGraphRegistry();
@@ -41536,9 +41559,9 @@ var GRAPH_WORKFLOW_SCHEMA = {
   inputs: z80.record(z80.string(), z80.unknown()).optional().describe("Input values for the workflow"),
   enableCheckpointing: z80.boolean().optional().describe("Enable checkpoint saving"),
   enableAuditTrail: z80.boolean().optional().describe("Enable audit trail logging"),
-  dispatch: z80.enum(["sync", "async"]).optional().describe(
-    "Dispatch mode (#3732). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result)."
-  )
+  // #4968: the same fragment the internal schema composes — the advertised
+  // shape is what the SDK parses, so the wrong-key trap must be here too.
+  ...asyncDispatchInput("Ignored for the `list` sentinel.")
 };
 async function executeGraphWorkflowBody(input, logger57, notifier, auditLogger) {
   const result = await handleRunGraphWorkflow(input, logger57, auditLogger);
@@ -42150,9 +42173,7 @@ var ExecuteSpecInputSchema = z81.object({
    * background; poll `get_job_result({ jobId })` for the result. Ignored when
    * `dryRun` is true (parse+decompose completes fast, so dry runs stay sync).
    */
-  dispatch: z81.enum(["sync", "async"]).default("sync").describe(
-    "Dispatch mode (#3732). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result). Ignored for dryRun."
-  )
+  ...asyncDispatchInputDefaultSync("Ignored for dryRun.")
 });
 var DRY_RUN_MODE = "dry_run";
 function createDryRunResponse(input, logger57) {
@@ -42256,9 +42277,9 @@ function registerExecuteSpecTool(server, deps) {
       'Markdown specification to execute. Must contain "## Requirements" and "## Acceptance Criteria" sections.'
     ),
     dryRun: z81.boolean().optional().describe("Parse and decompose only (no execution)"),
-    dispatch: z81.enum(["sync", "async"]).optional().describe(
-      "Dispatch mode (#3732). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result). Ignored for dryRun."
-    )
+    // #4968: the same fragment the internal schema composes — the advertised
+    // shape is what the SDK parses, so the wrong-key trap must be here too.
+    ...asyncDispatchInput("Ignored for dryRun.")
   };
   const description = "Execute a markdown specification through the full pipeline: parse, decompose into task DAG, compile to graph, execute, validate against acceptance criteria, and analyze failures. Without a configured handler factory, execute mode runs placeholder handlers and reports mode 'dry_run'.";
   server.registerTool(
@@ -43980,7 +44001,7 @@ function resolveJobListing(customDir) {
 
 // src/mcp/tools/get-job-result-tool.ts
 var GetJobResultInputSchema = z96.object({
-  jobId: z96.string().min(1).max(128).describe('Job ID returned by orchestrate({ mode: "async" })')
+  jobId: z96.string().min(1).max(128).describe('Job ID returned by any tool called with dispatch: "async" (e.g. orchestrate)')
 });
 function getJobResultHandler(args) {
   const parsed = GetJobResultInputSchema.safeParse(args);
@@ -44019,7 +44040,7 @@ function getJobResultHandler(args) {
 function registerGetJobResultTool(server, deps) {
   const logger57 = deps.logger ?? createLogger({ tool: "get_job_result" });
   const toolSchema = {
-    jobId: z96.string().min(1).max(128).describe('Job ID returned by orchestrate({ mode: "async" })')
+    jobId: z96.string().min(1).max(128).describe('Job ID returned by any tool called with dispatch: "async" (e.g. orchestrate)')
   };
   const description = `Read the result of an async-mode tool invocation by jobId. Returns the structured record (status, result | error, timestamps, producerVersion) plus producerVersionMeasured \u2014 false when the producer was a dev build or the record predates the field, so its version must not be compared to this server's _meta build stamp \u2014 and producerVersionSource (sidecar | task_state; a task_state record never carries a version). Poll until status !== "pending". Stage-1 of epic #2631 \u2014 Stage 2 will fold this into query_task_state once StructuredTaskState gains the result field.`;
   const secureHandler = createSecureHandler(getJobResultHandler, {
@@ -46182,7 +46203,7 @@ function buildVotingInput(plan, config) {
 }
 async function executeSingleVote(plan, config, log) {
   try {
-    const { executeVoting } = await import("./consensus-vote-ITVEKN2M.js");
+    const { executeVoting } = await import("./consensus-vote-XXT4XWAS.js");
     const input = buildVotingInput(plan, config);
     const result = await executeVoting(input, log);
     return parseVotingResult(result);
@@ -47980,7 +48001,7 @@ ${contextBlock}`;
       const strategy = config.votingStrategy ?? "higher_order";
       await postProgress(config, "Vote", `Running consensus with ${strategy} strategy...`);
       try {
-        const { executeVoting } = await import("./consensus-vote-ITVEKN2M.js");
+        const { executeVoting } = await import("./consensus-vote-XXT4XWAS.js");
         const votingResult = await executeVoting(
           {
             proposal: buildVoteProposal(plan, research),
@@ -49745,9 +49766,7 @@ var PrReviewInputSchema = z104.object({
    * runs the panel in the background; poll `get_job_result({ jobId })` for the
    * result.
    */
-  dispatch: z104.enum(["sync", "async"]).default("sync").describe(
-    "Dispatch mode (#3731). 'sync' (default): run inline. 'async': return a jobId immediately + run the panel in background (poll get_job_result)."
-  )
+  ...asyncDispatchInputDefaultSync()
 });
 function mapVoteDecisionToPrDecision(voteDecision) {
   if (voteDecision === "reject") return "request_changes";
@@ -52343,21 +52362,24 @@ var DevPipelineInputSchema = z116.object({
   quickMode: z116.boolean().default(false).describe("Use 3 agents instead of 6 for faster consensus voting"),
   /** Maximum execution time per stage in milliseconds (min 30s, max 600s). */
   timeoutMs: z116.number().int().min(3e4).max(6e5).optional().describe("Max time per stage in ms (30000-600000). Default: varies by stage complexity"),
-  /** Pipeline execution mode. */
-  mode: z116.enum(["autonomous", "harness"]).default("autonomous").describe(
-    "'autonomous': full pipeline. 'harness': stops after decompose, returns tasks for caller to implement."
-  ),
   /**
-   * Dispatch mode (#3726). `sync` (default) runs the pipeline inline and
-   * returns the result — but a real autonomous run can exceed the 900s MCP
-   * request timeout. `async` returns a `{ status: 'pending', jobId }`
-   * envelope immediately and runs the pipeline in the background; poll
-   * `get_job_result({ jobId })` for the result. Ignored when `dryRun` is
-   * true (plan+vote completes fast, so dry runs always stay sync).
+   * Pipeline execution mode — a REAL field on this tool, unrelated to async
+   * dispatch. A caller who learned `mode: 'async'` elsewhere gets an error
+   * naming `dispatch` rather than the bare enum message (#4968).
    */
-  dispatch: z116.enum(["sync", "async"]).default("sync").describe(
-    "Dispatch mode (#3726). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result). Ignored for dryRun."
+  mode: z116.enum(["autonomous", "harness"], { error: modeEnumErrorNamingDispatch }).default("autonomous").describe(
+    "'autonomous': full pipeline. 'harness': stops after decompose, returns tasks for caller to implement. (Not the async switch \u2014 that is `dispatch`.)"
   ),
+  /**
+   * Async dispatch (#3726, canonical key per #4968). `sync` (default) runs the
+   * pipeline inline and returns the result — but a real autonomous run can
+   * exceed the 900s MCP request timeout. `async` returns a
+   * `{ status: 'pending', jobId }` envelope immediately and runs the pipeline
+   * in the background; poll `get_job_result({ jobId })` for the result.
+   * Ignored when `dryRun` is true (plan+vote completes fast, so dry runs
+   * always stay sync).
+   */
+  dispatch: dispatchFieldDefaultSync("Ignored for dryRun."),
   /** Local pre-ship quality gate (typecheck/lint/tests) mode (#3356). */
   qualityGate: z116.enum(["off", "advisory", "blocking"]).default("off").describe(
     "Pre-ship local quality gate. 'off' (default): skip. 'advisory': run + record feedback, never fail. 'blocking': a red gate fails the pipeline."
@@ -52624,9 +52646,7 @@ var PipelineInputSchema = z117.object({
    * `get_job_result({ jobId })` for the result. Ignored when `dryRun` is true
    * (plan+vote completes fast, so dry runs always stay sync).
    */
-  dispatch: z117.enum(["sync", "async"]).default("sync").describe(
-    "Dispatch mode (#3730). 'sync' (default): run inline. 'async': return a jobId immediately + run in background (poll get_job_result). Ignored for dryRun."
-  ),
+  ...asyncDispatchInputDefaultSync("Ignored for dryRun."),
   /** TESTS ONLY — random output, must not be used for real decisions. (#2319) */
   simulateVotes: z117.boolean().default(false).describe("TESTS ONLY \u2014 random output, must not be used for real decisions (#2319)")
 });
@@ -52842,9 +52862,7 @@ var RunInputSchema = z118.object({
    * envelope immediately and runs in the background; poll
    * `get_job_result({ jobId })`. Ignored for read-only routing (execute:false).
    */
-  dispatch: z118.enum(["sync", "async"]).optional().describe(
-    "Dispatch mode (#3732). 'sync' (default): run inline. 'async' (only with execute:true): return a jobId immediately + run in background (poll get_job_result)."
-  )
+  ...asyncDispatchInput("Only with execute:true.")
 });
 var NOTE = "Routing decision only (read-only). Invoke the recommendedTool to execute, or re-run with execute: true for inline execution. The other pipeline tools remain available as advanced force-strategy paths.";
 function toMetaInput(input, mode) {
@@ -53247,9 +53265,7 @@ var SupplyChainTradeoffPanelInputSchema = z121.object({
    * immediately and runs the panel in the background; poll
    * `get_job_result({ jobId })` for the result.
    */
-  dispatch: z121.enum(["sync", "async"]).default("sync").describe(
-    "Dispatch mode (#3731). 'sync' (default): run inline. 'async': return a jobId immediately + run the panel in background (poll get_job_result)."
-  )
+  ...asyncDispatchInputDefaultSync()
 });
 function buildTradeoffProposal(input) {
   const axes = input.axes ?? DEFAULT_AXES;
@@ -57179,4 +57195,4 @@ export {
   startPipelineEventBridge,
   shutdownPipelineEventBridge
 };
-//# sourceMappingURL=chunk-W6VHVDZM.js.map
+//# sourceMappingURL=chunk-EQDO4IGT.js.map