opencandle 0.11.1 → 0.12.0

package/src/routing/router.ts

@@ -1,1332 +0,0 @@
-import {
-  extractEntities,
-  isAmbiguousConceptUsage,
-  isCurrencyCodeUsage,
-} from "./entity-extractor.js";
-import { classifyWithLegacyRules } from "./legacy-rule-router.js";
-import {
-  computeMissingRequiredSlots,
-  isDispatchableWorkflow,
-  isRouteKind,
-  isToolBundleName,
-  legacyRouteForRouteKind,
-  routeKindFromLegacyRoute,
-  selectToolBundles,
-  workflowRequiredSlots,
-} from "./route-manifest.js";
-import { buildRouterPrompt } from "./router-prompt.js";
-import type {
-  RouterDiagnostic,
-  RouterInputContext,
-  RouterLlmClient,
-  RouterOutput,
-  RouterPreferenceUpdate,
-  RouterRoute,
-  RouterRouteKind,
-  RouterSlot,
-  ToolBundleName,
-} from "./router-types.js";
-import { mapDteHintToTarget } from "./slot-resolver.js";
-import { disambiguateSymbols } from "./symbol-disambiguator.js";
-import type { ExtractedEntities, WorkflowType } from "./types.js";
-
-const VALID_ROUTES: readonly RouterRoute[] = ["workflow", "fallback"];
-const VALID_WORKFLOWS: ReadonlyArray<Exclude<WorkflowType, "unclassified">> = [
-  "portfolio_builder",
-  "options_screener",
-  "compare_assets",
-  "single_asset_analysis",
-  "watchlist_or_tracking",
-  "general_finance_qa",
-];
-const VALID_SOURCES = new Set(["user", "preference", "default", "prior_context", "memory"]);
-const VALID_CONFIDENCE = new Set(["high", "medium", "low"]);
-
-/**
- * Run the LLM router against the given input context. Retries once on
- * validation failure with a corrective message. Falls back to a minimal
- * `route: "fallback"` output on persistent failure.
- *
- * The LLM client is injected so unit tests can supply deterministic responses.
- */
-export async function route(
-  input: RouterInputContext,
-  client: RouterLlmClient,
-): Promise<RouterOutput> {
-  const prompt = buildRouterPrompt(input);
-
-  let firstError: string | undefined;
-  try {
-    const raw = await client.complete(prompt);
-    return postProcessRouterOutput(input.text, validateRouterOutput(raw), input);
-  } catch (err) {
-    firstError = err instanceof Error ? err.message : String(err);
-  }
-
-  // Retry once with error feedback.
-  try {
-    const retryPrompt = `${prompt}\n\n(Your previous response failed validation: ${firstError}. Return a valid JSON object conforming to RouterOutput. Nothing else.)`;
-    const raw = await client.complete(retryPrompt);
-    return postProcessRouterOutput(input.text, validateRouterOutput(raw), input);
-  } catch {
-    // Persistent failure — return a minimal fallback with regex-extracted symbols.
-    return postProcessRouterOutput(input.text, minimalFallback(input.text), input);
-  }
-}
-
-export function validateRouterOutput(raw: string): RouterOutput {
-  const parsed = parseJsonPayload(raw);
-
-  if (!parsed || typeof parsed !== "object") {
-    throw new Error("router output was not a JSON object");
-  }
-  const obj = parsed as Record<string, unknown>;
-
-  const rawMissingRequired = validateStringArray(obj.missing_required, "missing_required");
-
-  const explicitRouteKind = obj.routeKind;
-  if (
-    explicitRouteKind !== undefined &&
-    (typeof explicitRouteKind !== "string" || !isRouteKind(explicitRouteKind))
-  ) {
-    throw new Error(`invalid routeKind: ${JSON.stringify(explicitRouteKind)}`);
-  }
-
-  const rawRoute = obj.route;
-  let route: RouterRoute;
-  if (typeof rawRoute === "string") {
-    if (!VALID_ROUTES.includes(rawRoute as RouterRoute)) {
-      throw new Error(`invalid route: ${JSON.stringify(rawRoute)}`);
-    }
-    route = rawRoute as RouterRoute;
-  } else if (typeof explicitRouteKind === "string" && isRouteKind(explicitRouteKind)) {
-    route = legacyRouteForRouteKind(explicitRouteKind);
-  } else {
-    throw new Error(`invalid route: ${JSON.stringify(rawRoute)}`);
-  }
-
-  let workflow: RouterOutput["workflow"];
-  const routeKind: RouterRouteKind =
-    typeof explicitRouteKind === "string" && isRouteKind(explicitRouteKind)
-      ? explicitRouteKind
-      : routeKindFromLegacyRoute(route, rawMissingRequired);
-
-  if (route === "workflow" || routeKind === "workflow_dispatch") {
-    if (
-      typeof obj.workflow !== "string" ||
-      !VALID_WORKFLOWS.includes(obj.workflow as Exclude<WorkflowType, "unclassified">)
-    ) {
-      throw new Error(
-        `workflow route requires a valid workflow; got ${JSON.stringify(obj.workflow)}`,
-      );
-    }
-    workflow = obj.workflow as Exclude<WorkflowType, "unclassified">;
-  } else if (
-    typeof obj.workflow === "string" &&
-    VALID_WORKFLOWS.includes(obj.workflow as Exclude<WorkflowType, "unclassified">)
-  ) {
-    workflow = obj.workflow as Exclude<WorkflowType, "unclassified">;
-  }
-
-  const entities = validateEntities(obj.entities);
-  const slots = canonicalizeSymbolSlots(workflow, validateSlots(obj.slots));
-  const preference_updates = validatePreferenceUpdates(obj.preference_updates);
-  const missing_required = rawMissingRequired;
-  const tool_bundles = validateToolBundles(obj.tool_bundles);
-  const diagnostics = validateDiagnostics(obj.diagnostics);
-  const reasoning = typeof obj.reasoning === "string" ? obj.reasoning : "";
-
-  return {
-    routeKind,
-    route: legacyRouteForRouteKind(routeKind),
-    workflow,
-    entities,
-    slots,
-    preference_updates,
-    missing_required,
-    tool_bundles,
-    diagnostics,
-    reasoning,
-  };
-}
-
-function parseJsonPayload(raw: string): unknown {
-  const trimmed = raw.trim();
-  // Tolerate ```json ... ``` fences even though the prompt forbids them.
-  const stripped = trimmed
-    .replace(/^```(?:json)?\s*/i, "")
-    .replace(/\s*```$/i, "")
-    .trim();
-  try {
-    return JSON.parse(stripped);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new Error(`router output was not valid JSON: ${msg}`);
-  }
-}
-
-function validateEntities(raw: unknown): ExtractedEntities {
-  if (!raw || typeof raw !== "object") {
-    throw new Error("entities must be an object");
-  }
-  const e = raw as Record<string, unknown>;
-  const symbols = validateStringArray(e.symbols, "entities.symbols").map((s) => s.toUpperCase());
-
-  const out: ExtractedEntities = { symbols };
-  if (typeof e.budget === "number") out.budget = e.budget;
-  if (typeof e.maxPremium === "number") out.maxPremium = e.maxPremium;
-  if (typeof e.costBasis === "number") out.costBasis = e.costBasis;
-  if (typeof e.shareQuantity === "number") out.shareQuantity = e.shareQuantity;
-  if (typeof e.timeHorizon === "string") out.timeHorizon = e.timeHorizon;
-  if (typeof e.riskProfile === "string") out.riskProfile = e.riskProfile;
-  if (e.direction === "bullish" || e.direction === "bearish") out.direction = e.direction;
-  if (typeof e.dteHint === "string") out.dteHint = e.dteHint;
-  if (e.optionStrategy === "covered_call" || e.optionStrategy === "protective_put")
-    out.optionStrategy = e.optionStrategy;
-  if (typeof e.heldSymbol === "string") out.heldSymbol = e.heldSymbol.toUpperCase();
-  const catalystSymbols = validateStringArray(e.catalystSymbols, "entities.catalystSymbols").map(
-    (s) => s.toUpperCase(),
-  );
-  if (catalystSymbols.length > 0) out.catalystSymbols = catalystSymbols;
-  const compareMetrics = validateStringArray(e.compareMetrics, "entities.compareMetrics");
-  if (compareMetrics.length > 0) out.compareMetrics = compareMetrics;
-  return out;
-}
-
-export function postProcessRouterOutput(
-  text: string,
-  output: RouterOutput,
-  inputContext?: Pick<RouterInputContext, "priorTurns" | "profileSnapshot">,
-): RouterOutput {
-  const extracted = extractEntities(text);
-  const deterministic = classifyWithLegacyRules(text);
-  let diagnostics: RouterDiagnostic[] = [...output.diagnostics];
-  const symbolsAfterAmbiguousFilter = output.entities.symbols.filter(
-    (symbol) => !isAmbiguousConceptUsage(text, symbol),
-  );
-  const droppedAmbiguousSymbols = output.entities.symbols.filter(
-    (symbol) => !symbolsAfterAmbiguousFilter.includes(symbol),
-  );
-  let next: RouterOutput = {
-    ...output,
-    entities: {
-      ...output.entities,
-      symbols: symbolsAfterAmbiguousFilter,
-      budget: output.entities.budget ?? extracted.budget,
-      maxPremium: output.entities.maxPremium ?? extracted.maxPremium,
-      timeHorizon: output.entities.timeHorizon ?? extracted.timeHorizon,
-      riskProfile: output.entities.riskProfile ?? extracted.riskProfile,
-      assetScope: output.entities.assetScope ?? extracted.assetScope,
-      compareMetrics: mergeStringArrays(output.entities.compareMetrics, extracted.compareMetrics),
-      direction: output.entities.direction ?? extracted.direction,
-      optionStrategy: output.entities.optionStrategy ?? extracted.optionStrategy,
-      costBasis: output.entities.costBasis ?? extracted.costBasis,
-      shareQuantity: output.entities.shareQuantity ?? extracted.shareQuantity,
-      heldSymbol: output.entities.heldSymbol ?? extracted.heldSymbol,
-      catalystSymbols: output.entities.catalystSymbols ?? extracted.catalystSymbols,
-      dteHint:
-        output.entities.dteHint ??
-        (output.workflow === "options_screener" ? extracted.dteHint : undefined),
-    },
-    diagnostics,
-  };
-
-  if (next.workflow === "compare_assets") {
-    const restorableExtractedSymbols = extracted.symbols.filter(
-      (symbol) => disambiguateSymbols([symbol], text).kept.length > 0,
-    );
-    const orderedSymbols = orderSymbolsByText(
-      text,
-      mergeSymbols(next.entities.symbols, restorableExtractedSymbols),
-    );
-    if (!sameStringArray(orderedSymbols, next.entities.symbols)) {
-      diagnostics.push({
-        code: "compare_symbols_canonicalized",
-        message: "compare symbols restored from deterministic extraction and ordered by user text",
-      });
-      next = {
-        ...next,
-        entities: {
-          ...next.entities,
-          symbols: orderedSymbols,
-        },
-        slots: syncSymbolListSlot(next.slots, orderedSymbols),
-        diagnostics,
-      };
-    }
-
-    // Prior-turn symbols merged into the slot (by the model or by the sync
-    // above) must not claim user provenance: the user typed only what is in
-    // this turn's text, and the Assumptions block renders slot sources.
-    // preference/memory/default sources legitimately reference out-of-text
-    // symbols and are left alone.
-    if (symbolsSlotClaimsPriorTurnUserProvenance(next.slots, text, inputContext?.priorTurns)) {
-      diagnostics.push({
-        code: "symbols_slot_provenance_prior_context",
-        message:
-          "compare symbols slot includes symbols absent from the user text; source downgraded from user to prior_context",
-      });
-      next = {
-        ...next,
-        slots: {
-          ...next.slots,
-          symbols: {
-            ...next.slots.symbols,
-            source: "prior_context",
-          },
-        },
-        diagnostics,
-      };
-    }
-  }
-
-  // The DTE horizon is a named historical loss class; when the model drops
-  // the slot on an options dispatch, the deterministic extraction preserves
-  // the user's stated range (mirrors the profile risk-slot fill below).
-  const dteHint = next.entities.dteHint ?? extracted.dteHint;
-  if (next.workflow === "options_screener" && !next.slots.dte_target && dteHint) {
-    const dteTarget = mapDteHintToTarget(dteHint);
-    if (dteTarget) {
-      diagnostics.push({
-        code: "dte_slot_filled_from_extraction",
-        message: "dte_target slot filled from deterministic horizon extraction",
-      });
-      next = {
-        ...next,
-        slots: {
-          ...next.slots,
-          dte_target: {
-            value: dteTarget,
-            source: "user",
-            confidence: "high",
-          },
-        },
-        diagnostics,
-      };
-    }
-  }
-
-  // Model-vocabulary synonyms for the canonical asset_scope value
-  // ("etf_only" for "etf_focused") drift saved preferences and slot
-  // consumers onto private vocabularies; canonicalize before the echo
-  // suppression below so restatements still match the profile.
-  next = canonicalizeAssetScopeVocabulary(next);
-
-  // A preference update that restates the saved profile value is an echo,
-  // not a change; writing it pollutes preference provenance (the
-  // preference-ECHO contract, fixture 029).
-  const echoedUpdates = next.preference_updates.filter(
-    (update) => readProfileString(inputContext?.profileSnapshot, update.key) === update.value,
-  );
-  if (echoedUpdates.length > 0) {
-    diagnostics.push({
-      code: "preference_echo_suppressed",
-      message: `dropped preference update(s) restating the saved profile: ${echoedUpdates
-        .map((update) => update.key)
-        .join(", ")}`,
-    });
-    next = {
-      ...next,
-      preference_updates: next.preference_updates.filter(
-        (update) => !echoedUpdates.includes(update),
-      ),
-      diagnostics,
-    };
-  }
-
-  const profileRiskProfile = readProfileString(inputContext?.profileSnapshot, "risk_profile");
-  if (
-    next.workflow === "portfolio_builder" &&
-    profileRiskProfile &&
-    !next.slots.risk_profile &&
-    !next.entities.riskProfile
-  ) {
-    diagnostics.push({
-      code: "profile_risk_slot_filled",
-      message: "risk_profile slot filled from investor profile snapshot",
-    });
-    next = {
-      ...next,
-      slots: {
-        ...next.slots,
-        risk_profile: {
-          value: profileRiskProfile,
-          source: "preference",
-          confidence: "high",
-        },
-      },
-      diagnostics,
-    };
-  }
-
-  if (
-    next.routeKind === "pass_through" &&
-    extracted.riskProfile &&
-    isConversationalRiskPreferenceUpdate(text, inputContext)
-  ) {
-    diagnostics.push({
-      code: "conversational_risk_preference_recovered",
-      message: "risk preference update recovered from profile/prior-turn context",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      entities: {
-        ...next.entities,
-        riskProfile: extracted.riskProfile,
-      },
-      slots: {
-        ...next.slots,
-        risk_profile: {
-          value: extracted.riskProfile,
-          source: "user",
-          confidence: "high",
-        },
-      },
-      preference_updates: ensurePreferenceUpdate(next.preference_updates, {
-        key: "risk_profile",
-        value: extracted.riskProfile,
-        confidence: "high",
-        source: "inferred",
-      }),
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "options_screener" &&
-    isExistingPositionOptionRequest(text, extracted) &&
-    extracted.heldSymbol
-  ) {
-    const reorderedSymbols = [
-      extracted.heldSymbol,
-      ...mergeSymbols(next.entities.symbols, extracted.symbols).filter(
-        (symbol) => symbol !== extracted.heldSymbol,
-      ),
-    ];
-    if (next.entities.symbols[0] !== extracted.heldSymbol) {
-      diagnostics.push({
-        code:
-          extracted.optionStrategy === "protective_put"
-            ? "existing_position_underlying_corrected"
-            : "covered_call_underlying_corrected",
-        message: `using owned position ${extracted.heldSymbol} as the option-chain underlying`,
-      });
-    }
-    next = {
-      ...next,
-      entities: {
-        ...next.entities,
-        symbols: reorderedSymbols,
-        optionStrategy: extracted.optionStrategy ?? next.entities.optionStrategy,
-        direction: extracted.direction ?? next.entities.direction,
-        heldSymbol: extracted.heldSymbol,
-        catalystSymbols: reorderedSymbols.filter((symbol) => symbol !== extracted.heldSymbol),
-        costBasis: extracted.costBasis ?? next.entities.costBasis,
-        shareQuantity: extracted.shareQuantity ?? next.entities.shareQuantity,
-        dteHint: extracted.dteHint ?? next.entities.dteHint,
-      },
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "options_screener" &&
-    isOptionsEducationOrSuitabilityRequest(text) &&
-    !isSpecificOptionContractSelectionRequest(text)
-  ) {
-    diagnostics.push({
-      code: "options_workflow_corrected_to_policy_task",
-      message:
-        "options education or suitability prompt should use policy-card synthesis, not contract-screen workflow dispatch",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "options_screener" &&
-    next.entities.symbols.length >= 2 &&
-    isPlainMultiAssetComparisonRequest(text)
-  ) {
-    diagnostics.push({
-      code: "options_comparison_corrected_to_compare_assets",
-      message:
-        "explicit multi-asset comparison without option contract language should use compare_assets",
-    });
-    next = {
-      ...next,
-      routeKind: "workflow_dispatch",
-      route: "workflow",
-      workflow: "compare_assets",
-      missing_required: [],
-      entities: {
-        ...next.entities,
-        direction: undefined,
-        dteHint: undefined,
-        optionStrategy: undefined,
-      },
-      diagnostics,
-    };
-  }
-
-  // Legacy rules may recover a primary route only when the LLM router path has
-  // already failed validation. Otherwise they are limited to enrichment and
-  // narrow corrections below.
-  if (
-    next.diagnostics.some((d) => d.code === "router_validation_failed") &&
-    deterministic.workflow !== "unclassified"
-  ) {
-    next = {
-      ...next,
-      routeKind: isDispatchableWorkflow(deterministic.workflow)
-        ? "workflow_dispatch"
-        : "agent_task",
-      route: isDispatchableWorkflow(deterministic.workflow) ? "workflow" : "fallback",
-      workflow: deterministic.workflow,
-      entities: {
-        ...deterministic.entities,
-        budget: deterministic.entities.budget ?? extracted.budget,
-        maxPremium: deterministic.entities.maxPremium ?? extracted.maxPremium,
-        timeHorizon: deterministic.entities.timeHorizon ?? extracted.timeHorizon,
-        riskProfile: deterministic.entities.riskProfile ?? extracted.riskProfile,
-        assetScope: deterministic.entities.assetScope ?? extracted.assetScope,
-        compareMetrics: mergeStringArrays(
-          deterministic.entities.compareMetrics,
-          extracted.compareMetrics,
-        ),
-        direction: deterministic.entities.direction ?? extracted.direction,
-        costBasis: deterministic.entities.costBasis ?? extracted.costBasis,
-        shareQuantity: deterministic.entities.shareQuantity ?? extracted.shareQuantity,
-        heldSymbol: deterministic.entities.heldSymbol ?? extracted.heldSymbol,
-        catalystSymbols: deterministic.entities.catalystSymbols ?? extracted.catalystSymbols,
-      },
-      diagnostics: [
-        ...diagnostics,
-        {
-          code: "deterministic_failure_recovery",
-          message: `deterministic classifier selected ${deterministic.workflow} after router validation failure`,
-        },
-      ],
-      reasoning: next.reasoning
-        ? `${next.reasoning}; deterministic classifier selected ${deterministic.workflow}`
-        : `deterministic classifier selected ${deterministic.workflow}`,
-    };
-    diagnostics = next.diagnostics;
-  }
-
-  if (next.routeKind === "workflow_dispatch" && !isDispatchableWorkflow(next.workflow)) {
-    diagnostics.push({
-      code: "route_kind_corrected_to_agent_task",
-      message: next.workflow
-        ? `${next.workflow} is not a dispatchable workflow`
-        : "workflow_dispatch requires a dispatchable workflow",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      diagnostics,
-    };
-  }
-
-  if (
-    (next.workflow === "compare_assets" || next.workflow === "portfolio_builder") &&
-    isStatefulTrackingRequest(text)
-  ) {
-    diagnostics.push({
-      code: "stateful_tracking_corrected_to_agent_task",
-      message:
-        "portfolio/watchlist tracking mutation should use stateful tracking tools, not compare or construction workflow dispatch",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "watchlist_or_tracking",
-      missing_required: [],
-      entities: {
-        ...next.entities,
-        symbols: filterCurrencyUnitSymbols(text, next.entities.symbols),
-      },
-      slots: removeCurrencyUnitSymbolSlots(text, next.slots),
-      diagnostics,
-    };
-  }
-
-  if (next.routeKind === "agent_task" && isDispatchableWorkflow(next.workflow)) {
-    diagnostics.push({
-      code: "dispatchable_workflow_corrected_to_workflow_dispatch",
-      message: `${next.workflow} is a dispatchable workflow`,
-    });
-    next = {
-      ...next,
-      routeKind: "workflow_dispatch",
-      route: "workflow",
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "compare_assets" &&
-    next.entities.symbols.length === 0 &&
-    isExplicitMacroDataRequest(text)
-  ) {
-    diagnostics.push({
-      code: "compare_route_corrected_to_macro_task",
-      message: "macro/source acronyms were not explicit tickers",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (next.workflow === "compare_assets" && isPortfolioEvaluationRequest(text)) {
-    diagnostics.push({
-      code: "portfolio_evaluation_corrected_to_agent_task",
-      message:
-        "existing portfolio/allocation risk review should not be reduced to asset comparison",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (
-    next.routeKind === "agent_task" &&
-    !next.workflow &&
-    next.entities.symbols.length === 0 &&
-    isExplicitMacroDataRequest(text)
-  ) {
-    diagnostics.push({
-      code: "macro_task_inferred_from_prompt",
-      message: "macro data terms were present without explicit tickers",
-    });
-    next = {
-      ...next,
-      workflow: "general_finance_qa",
-      diagnostics,
-    };
-  }
-
-  if (next.workflow === "portfolio_builder" && isCryptoSizingRequest(text)) {
-    diagnostics.push({
-      code: "crypto_sizing_corrected_to_agent_task",
-      message:
-        "crypto allocation-range and drawdown questions are advisory tradeoffs, not portfolio construction",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (next.workflow === "portfolio_builder" && isPortfolioEvaluationRequest(text)) {
-    diagnostics.push({
-      code: "portfolio_evaluation_corrected_to_agent_task",
-      message:
-        "existing portfolio/allocation evaluation does not require portfolio-construction budget",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "portfolio_builder" &&
-    next.entities.symbols.length >= 2 &&
-    isPortfolioTradeoffComparisonRequest(text)
-  ) {
-    diagnostics.push({
-      code: "portfolio_tradeoff_corrected_to_compare_assets",
-      message:
-        "explicit multi-asset tradeoff question should compare the requested assets before constructing a portfolio",
-    });
-    next = {
-      ...next,
-      routeKind: "workflow_dispatch",
-      route: "workflow",
-      workflow: "compare_assets",
-      missing_required: [],
-      diagnostics,
-    };
-  }
-
-  if (next.workflow === "single_asset_analysis" && isSpecializedSingleAssetPolicyRequest(text)) {
-    diagnostics.push({
-      code: "single_asset_workflow_corrected_to_general_policy_task",
-      message: "prompt asks for policy-card planning outside a single-asset buy/sell analysis",
-    });
-    next = {
-      ...next,
-      workflow: "general_finance_qa",
-      diagnostics,
-    };
-  }
-
-  const disambiguated = disambiguateSymbols(next.entities.symbols, text);
-  if (disambiguated.dropped.length > 0) {
-    for (const drop of disambiguated.dropped) {
-      diagnostics.push({
-        code: "symbol_dropped",
-        message: `${drop.token} dropped: ${drop.reason}`,
-        details: {
-          token: drop.token,
-          reason: drop.reason,
-          signalsChecked: drop.signalsChecked,
-          source: "llm",
-        },
-      });
-    }
-    next = {
-      ...next,
-      entities: {
-        ...next.entities,
-        symbols: disambiguated.kept,
-      },
-      slots: removeDroppedSymbolSlots(
-        next.slots,
-        disambiguated.dropped.map((drop) => drop.token),
-      ),
-      diagnostics,
-    };
-  }
-
-  if (
-    next.workflow === "compare_assets" &&
-    (disambiguated.dropped.length > 0 || droppedAmbiguousSymbols.length > 0) &&
-    next.entities.symbols.length < 2 &&
-    isExplicitMacroDataRequest(text)
-  ) {
-    diagnostics.push({
-      code: "compare_route_corrected_to_macro_task",
-      message: "macro/source acronyms were not explicit tickers",
-    });
-    next = {
-      ...next,
-      routeKind: "agent_task",
-      route: "fallback",
-      workflow: "general_finance_qa",
-      missing_required: [],
-      slots: removeSymbolSlots(next.slots),
-      diagnostics,
-    };
-  }
-
-  const missingRequired = computeMissingRequiredSlots(
-    next.workflow,
-    next.entities,
-    next.slots,
-    next.missing_required,
-  );
-  if (missingRequired.length > 0 && next.routeKind !== "pass_through") {
-    if (next.routeKind !== "clarification") {
-      diagnostics.push({
-        code: "route_kind_corrected_to_clarification",
-        message: `missing required slots: ${missingRequired.join(", ")}`,
-      });
-    }
-    next = {
-      ...next,
-      routeKind: "clarification",
-      route: "fallback",
-      missing_required: missingRequired,
-      diagnostics,
-    };
-  }
-
-  const selectedToolBundles = isConceptualEducationRequest(text, next)
-    ? []
-    : selectToolBundles(next);
-  if (selectedToolBundles.length === 0 && isConceptualEducationRequest(text, next)) {
-    diagnostics.push({
-      code: "conceptual_education_no_tools",
-      message: "conceptual education prompt does not need live finance tools",
-    });
-  }
-  const emittedUnsupported = next.tool_bundles.filter(
-    (bundle) => !selectedToolBundles.includes(bundle),
-  );
-  if (emittedUnsupported.length > 0) {
-    diagnostics.push({
-      code: "tool_bundles_corrected",
-      message: `unsupported emitted bundles dropped: ${emittedUnsupported.join(", ")}`,
-    });
-  }
-
-  return omitUndefined({
-    ...next,
-    route: legacyRouteForRouteKind(next.routeKind),
-    tool_bundles: selectedToolBundles,
-    diagnostics,
-  });
-}
-
-function isExplicitMacroDataRequest(text: string): boolean {
-  return /\b(?:get_economic_data|fred|cpi|inflation|fed\s+funds?|unemployment|gdp|macro)\b/i.test(
-    text,
-  );
-}
-
-function isConceptualEducationRequest(text: string, output: RouterOutput): boolean {
-  if (output.routeKind !== "agent_task") return false;
-  if (output.entities.symbols.length > 0) return false;
-  if (isForwardLookingMacroContextRequest(text)) return false;
-  if (
-    /\b(?:current|recent|today|right now|latest|news|sentiment|build|portfolio|buy|sell|allocate|compare)\b/i.test(
-      text,
-    )
-  ) {
-    return false;
-  }
-  return /\b(?:explain|what is|define|how (?:do|should|to)|teach me|help me understand)\b/i.test(
-    text,
-  );
-}
-
-function isForwardLookingMacroContextRequest(text: string): boolean {
-  return (
-    /\b(?:rates?|rate\s*cuts?|fed|inflation|macro)\b/i.test(text) &&
-    /\b(?:next\s+(?:year|12\s*months?)|over\s+the\s+next|outlook|affect|impact|falling|rising)\b/i.test(
-      text,
-    )
-  );
-}
-
-function isCoveredCallRequest(text: string): boolean {
-  return /\bcovered\s+calls?\b/i.test(text);
-}
-
-function isPortfolioEvaluationRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  const hasEvaluationIntent =
-    /\b(?:evaluat(?:e|ion)|review|assess|analy[sz]e|prospects?|risks?|risky|opportunities?|mitigat(?:e|ion)|adjust(?:ment)?|change|rebalance|diversify|concentration|overweight|underweight|expos(?:ed|ure)|target\s+bands?|drift|worried|crash|protect|protection|missing\s+out\s+on\s+growth)\b/.test(
-      lower,
-    );
-  const hasExplicitPortfolioSubject =
-    /\b(?:portfolio|allocation|asset\s+allocation|60\/40|holdings?|positions?)\b/.test(lower);
-  const hasOwnedAssetMix =
-    /\b(?:my|current|have|holding|hold|own|invested|positions?|\d+(?:\.\d+)?%)\b/.test(lower) &&
-    /\b(?:equity|fixed\s+income|bonds?|cash|stocks?|etfs?|funds?)\b/.test(lower);
-  const hasConstructionIntent =
-    /\b(?:build|create|construct|put\s+together|invest|allocate)\b/.test(lower) &&
-    /\$\s*\d|\b\d+(?:\.\d+)?\s*k\b|\bbudget\b|\bcapital\b/.test(lower);
-  return (
-    hasEvaluationIntent &&
-    (hasExplicitPortfolioSubject || hasOwnedAssetMix) &&
-    !hasConstructionIntent
-  );
-}
-
-function isStatefulTrackingRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  const hasPortfolioConstructionIntent =
-    /\b(?:build|create|construct|put\s+together)\b/.test(lower) &&
-    /\bportfolio\b/.test(lower) &&
-    /\$\s*\d|\b\d+(?:\.\d+)?\s*k\b|\bbudget\b|\bcapital\b/.test(lower);
-  const hasStateVerb =
-    /\b(?:add|remove|update|record|track|create|configure|check|show|list|view|cancel)\b/.test(
-      lower,
-    );
-  const hasStateObject =
-    /\b(?:watchlist|portfolio|holding|holdings|position|positions|alert|alerts|daily\s+report|watchlist\s+report|report\s+history)\b/.test(
-      lower,
-    );
-  const hasPortfolioLotShape =
-    /\b(?:add|record|track)\b/.test(lower) &&
-    /\b\d+(?:\.\d+)?\s+shares?\b/.test(lower) &&
-    /\b(?:portfolio|holding|holdings|position|positions)\b/.test(lower);
-  if (hasPortfolioConstructionIntent) return false;
-  return (hasStateVerb && hasStateObject) || hasPortfolioLotShape;
-}
-
-function filterCurrencyUnitSymbols(text: string, symbols: string[]): string[] {
-  return symbols.filter((symbol) => !isCurrencyCodeUsage(text, symbol));
-}
-
-function removeCurrencyUnitSymbolSlots(
-  text: string,
-  slots: Record<string, RouterSlot>,
-): Record<string, RouterSlot> {
-  const next = { ...slots };
-  for (const key of ["symbol", "symbols"]) {
-    const slot = next[key];
-    if (!slot) continue;
-    if (Array.isArray(slot.value)) {
-      const value = slot.value.filter(
-        (item) => typeof item !== "string" || !isCurrencyCodeUsage(text, item.toUpperCase()),
-      );
-      if (value.length === 0) delete next[key];
-      else next[key] = { ...slot, value };
-      continue;
-    }
-    if (typeof slot.value === "string" && isCurrencyCodeUsage(text, slot.value.toUpperCase())) {
-      delete next[key];
-    }
-  }
-  return next;
-}
-
-function isPortfolioTradeoffComparisonRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  return (
-    /\b(?:prioritize|tradeoffs?|growth[-\s]?oriented|dividend|income|which\s+(?:one|is)\s+better|should\s+i)\b/.test(
-      lower,
-    ) && /\b(?:or|vs\.?|versus|compare)\b/.test(lower)
-  );
-}
-
-function isCryptoSizingRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  const hasPortfolioConstructionIntent =
-    /\b(?:build|create|construct|put\s+together)\b/.test(lower) &&
-    /\b(?:portfolio|allocation)\b/.test(lower);
-  if (hasPortfolioConstructionIntent) return false;
-  return (
-    /\b(?:btc|bitcoin|crypto)\b/.test(lower) &&
-    /\b(?:allocation|range|position\s+size|sizing|exposure|drawdown)\b/.test(lower)
-  );
-}
-
-function isSpecializedSingleAssetPolicyRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  return (
-    /\b(?:ticker|symbol|formerly|old ticker|earnings are|earnings tonight)\b/.test(lower) ||
-    /\b(?:today|right now|this morning|after close|moved|catalyst)\b/.test(lower) ||
-    /\b(?:sentiment|mood|reddit|twitter|x\/twitter)\b/.test(lower) ||
-    /\b(?:filing|10-k|10-q|8-k|sec)\b/.test(lower)
-  );
-}
-
-function isExistingPositionOptionRequest(text: string, extracted: ExtractedEntities): boolean {
-  return isCoveredCallRequest(text) || extracted.optionStrategy === "protective_put";
-}
-
-function isOptionsEducationOrSuitabilityRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  return (
-    /\b(?:how\s+does|how\s+do|explain|what\s+is|good\s+idea|make\s+sense|suitable|suitability|is\s+it\s+(?:good|worth|smart))\b/.test(
-      lower,
-    ) &&
-    /\b(?:covered\s+calls?|protective\s+puts?|options?|selling\s+calls?|option\s+income)\b/.test(
-      lower,
-    )
-  );
-}
-
-function isPlainMultiAssetComparisonRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  const hasCompareIntent =
-    /\bcompare\b/.test(lower) ||
-    /\bvs\.?\b/.test(lower) ||
-    /\bversus\b/.test(lower) ||
-    /\bwhich\s+is\s+better\b/.test(lower);
-  return hasCompareIntent && !hasExplicitOptionContractLanguage(lower);
-}
-
-function hasExplicitOptionContractLanguage(lower: string): boolean {
-  return (
-    /\bcalls?\b(?!\s+out\b)/.test(lower) ||
-    /\bputs?\b/.test(lower) ||
-    /\boption(?:s)?\s*chain\b/.test(lower) ||
-    /\boptions?\b/.test(lower) ||
-    /\b(?:strike|expiration|dte|premium|delta|theta|greeks?|contract)\b/.test(lower)
-  );
-}
-
-function isSpecificOptionContractSelectionRequest(text: string): boolean {
-  const lower = text.toLowerCase();
-  return (
-    /\b(?:best|which|what\s+(?:strike|contract|option)|rank|screen|specific|right\s+now|today|around\s+earnings|expiration|dte|premium\s+under)\b/.test(
-      lower,
-    ) && /\b(?:sell|buy|trade|contract|strike|expiration|premium|call|put)\b/.test(lower)
-  );
-}
-
-function mergeSymbols(primary: string[], secondary: string[]): string[] {
-  const merged: string[] = [];
-  for (const symbol of [...primary, ...secondary]) {
-    if (!merged.includes(symbol)) merged.push(symbol);
-  }
-  return merged;
-}
-
-function mergeStringArrays(primary?: string[], secondary?: string[]): string[] | undefined {
-  const merged: string[] = [];
-  for (const value of [...(primary ?? []), ...(secondary ?? [])]) {
-    if (!merged.includes(value)) merged.push(value);
-  }
-  return merged.length > 0 ? merged : undefined;
-}
-
-function omitUndefined<T>(value: T): T {
-  if (Array.isArray(value)) return value.map(omitUndefined) as T;
-  if (!value || typeof value !== "object") return value;
-  const out: Record<string, unknown> = {};
-  for (const [key, entry] of Object.entries(value)) {
-    if (entry !== undefined) out[key] = omitUndefined(entry);
-  }
-  return out as T;
-}
-
-function validateSlots(raw: unknown): Record<string, RouterSlot> {
-  if (raw === undefined || raw === null) return {};
-  if (typeof raw !== "object") {
-    throw new Error("slots must be an object");
-  }
-  const out: Record<string, RouterSlot> = {};
-  for (const [key, val] of Object.entries(raw as Record<string, unknown>)) {
-    if (!val || typeof val !== "object") {
-      throw new Error(`slot ${key} must be an object`);
-    }
-    const s = val as Record<string, unknown>;
-    if (!VALID_SOURCES.has(s.source as string)) {
-      throw new Error(`slot ${key} has invalid source: ${JSON.stringify(s.source)}`);
-    }
-    if (!VALID_CONFIDENCE.has(s.confidence as string)) {
-      throw new Error(`slot ${key} has invalid confidence: ${JSON.stringify(s.confidence)}`);
-    }
-    const canonicalKey = canonicalSlotKey(key);
-    out[canonicalKey] = {
-      value: s.value,
-      source: s.source as RouterSlot["source"],
-      confidence: s.confidence as RouterSlot["confidence"],
-    };
-  }
-  return out;
-}
-
-// The slot contract uses snake_case keys; non-Claude router models sometimes
-// emit camelCase (timeHorizon, riskProfile). Canonicalize deterministically so
-// downstream slot resolution and missing-required checks match.
-function canonicalSlotKey(key: string): string {
-  return key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase();
-}
-
-// Models also drift between scalar `symbol` and one-element `symbols` slot
-// shapes. Canonicalize toward the workflow's manifest-declared required slot
-// name when the conversion is unambiguous.
-function canonicalizeSymbolSlots(
-  workflow: RouterOutput["workflow"],
-  slots: Record<string, RouterSlot>,
-): Record<string, RouterSlot> {
-  if (!workflow) return slots;
-  const required = workflowRequiredSlots(workflow);
-  const next = { ...slots };
-  if (required.includes("symbol") && next.symbol == null && next.symbols != null) {
-    const value = next.symbols.value;
-    if (Array.isArray(value) && value.length === 1) {
-      next.symbol = { ...next.symbols, value: value[0] };
-      delete next.symbols;
-    }
-  }
-  if (required.includes("symbols") && next.symbols == null && next.symbol != null) {
-    const value = next.symbol.value;
-    if (typeof value === "string" && value.length > 0) {
-      next.symbols = { ...next.symbol, value: [value] };
-      delete next.symbol;
-    }
-  }
-  return next;
-}
-
-function syncSymbolListSlot(
-  slots: Record<string, RouterSlot>,
-  symbols: string[],
-): Record<string, RouterSlot> {
-  if (!slots.symbols || symbols.length === 0) return slots;
-  return {
-    ...slots,
-    symbols: {
-      ...slots.symbols,
-      value: symbols,
-    },
-  };
-}
-
-const ASSET_SCOPE_SYNONYMS: Record<string, string> = {
-  etf_only: "etf_focused",
-  etfs_only: "etf_focused",
-  only_etfs: "etf_focused",
-  etf: "etf_focused",
-  etfs: "etf_focused",
-};
-
-function canonicalAssetScope(value: unknown): string | undefined {
-  if (typeof value !== "string") return undefined;
-  return ASSET_SCOPE_SYNONYMS[value.toLowerCase()];
-}
-
-function canonicalizeAssetScopeVocabulary(output: RouterOutput): RouterOutput {
-  let next = output;
-  const slotCanonical = canonicalAssetScope(next.slots.asset_scope?.value);
-  if (slotCanonical) {
-    next = {
-      ...next,
-      slots: {
-        ...next.slots,
-        asset_scope: { ...next.slots.asset_scope, value: slotCanonical },
-      },
-    };
-  }
-  const entityCanonical = canonicalAssetScope(next.entities.assetScope);
-  if (entityCanonical) {
-    next = {
-      ...next,
-      entities: { ...next.entities, assetScope: entityCanonical },
-    };
-  }
-  if (
-    next.preference_updates.some(
-      (update) => update.key === "asset_scope" && canonicalAssetScope(update.value),
-    )
-  ) {
-    next = {
-      ...next,
-      preference_updates: next.preference_updates.map((update) =>
-        update.key === "asset_scope"
-          ? { ...update, value: canonicalAssetScope(update.value) ?? update.value }
-          : update,
-      ),
-    };
-  }
-  return next;
-}
-
-function symbolsSlotClaimsPriorTurnUserProvenance(
-  slots: Record<string, RouterSlot>,
-  text: string,
-  priorTurns: RouterInputContext["priorTurns"] | undefined,
-): boolean {
-  const slot = slots.symbols;
-  if (!slot || slot.source !== "user" || !Array.isArray(slot.value)) return false;
-  if (!priorTurns || priorTurns.length === 0) return false;
-  const priorText = priorTurns.map((turn) => turn.text).join("\n");
-  // A symbol absent from this turn's text but present in prior turns is a
-  // carryover, not a user-typed value. Symbols absent from both (e.g. tickers
-  // resolved from company names in the current text) are left alone.
-  return slot.value.some(
-    (symbol) =>
-      typeof symbol === "string" &&
-      symbolPosition(text, symbol) === Number.MAX_SAFE_INTEGER &&
-      symbolPosition(priorText, symbol) !== Number.MAX_SAFE_INTEGER,
-  );
-}
-
-function removeSymbolSlots(slots: Record<string, RouterSlot>): Record<string, RouterSlot> {
-  const next = { ...slots };
-  delete next.symbol;
-  delete next.symbols;
-  return next;
-}
-
-function orderSymbolsByText(text: string, symbols: string[]): string[] {
-  return [...symbols].sort((a, b) => symbolPosition(text, a) - symbolPosition(text, b));
-}
-
-function symbolPosition(text: string, symbol: string): number {
-  const escaped = escapeRegExp(symbol);
-  const match = new RegExp(`\\$?${escaped}\\b`, "i").exec(text);
-  return match?.index ?? Number.MAX_SAFE_INTEGER;
-}
-
-function sameStringArray(left: string[], right: string[]): boolean {
-  return left.length === right.length && left.every((value, index) => value === right[index]);
-}
-
-function readProfileString(
-  profileSnapshot: RouterInputContext["profileSnapshot"] | undefined,
-  key: string,
-): string | undefined {
-  const value = profileSnapshot?.[key];
-  return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-
-function isConversationalRiskPreferenceUpdate(
-  text: string,
-  inputContext: Pick<RouterInputContext, "priorTurns" | "profileSnapshot"> | undefined,
-): boolean {
-  if (!/\b(?:now|lately|getting|becoming|thinking|feel|feeling|prefer|preference)\b/i.test(text)) {
-    return false;
-  }
-  // Finance context must come from the conversation itself — a saved
-  // risk_profile alone must not convert non-finance chat ("more aggressive
-  // on the tennis court lately") into a routed preference write.
-  const priorText = inputContext?.priorTurns.map((turn) => turn.text).join(" ") ?? "";
-  return /\b(?:profile|risk|portfolio|position|invest|sizing)\b/i.test(`${text} ${priorText}`);
-}
-
-function ensurePreferenceUpdate(
-  updates: RouterPreferenceUpdate[],
-  update: RouterPreferenceUpdate,
-): RouterPreferenceUpdate[] {
-  if (updates.some((item) => item.key === update.key && item.value === update.value)) {
-    return updates;
-  }
-  return [...updates, update];
-}
-
-function escapeRegExp(value: string): string {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-function validatePreferenceUpdates(raw: unknown): RouterPreferenceUpdate[] {
-  if (raw === undefined || raw === null) return [];
-  if (!Array.isArray(raw)) {
-    throw new Error("preference_updates must be an array");
-  }
-  return raw.map((item, idx) => {
-    if (!item || typeof item !== "object") {
-      throw new Error(`preference_updates[${idx}] must be an object`);
-    }
-    const p = item as Record<string, unknown>;
-    if (typeof p.key !== "string" || p.key.length === 0) {
-      throw new Error(`preference_updates[${idx}].key must be a non-empty string`);
-    }
-    if (typeof p.value !== "string") {
-      throw new Error(`preference_updates[${idx}].value must be a string`);
-    }
-    if (!VALID_CONFIDENCE.has(p.confidence as string)) {
-      throw new Error(`preference_updates[${idx}].confidence is invalid`);
-    }
-    // Router-emitted preferences are always inferred — absent is accepted
-    // (normalized), but any explicit non-"inferred" value is an invariant
-    // violation the caller should see rather than silently lose.
-    if (p.source !== undefined && p.source !== "inferred") {
-      throw new Error(
-        `preference_updates[${idx}].source must be "inferred" (got ${JSON.stringify(p.source)})`,
-      );
-    }
-    return {
-      key: p.key,
-      value: p.value,
-      confidence: p.confidence as RouterPreferenceUpdate["confidence"],
-      source: "inferred",
-    };
-  });
-}
-
-function validateToolBundles(raw: unknown): ToolBundleName[] {
-  const bundles = validateStringArray(raw, "tool_bundles");
-  return bundles.filter(isToolBundleName);
-}
-
-function removeDroppedSymbolSlots(
-  slots: Record<string, RouterSlot>,
-  droppedTokens: string[],
-): Record<string, RouterSlot> {
-  if (droppedTokens.length === 0) return slots;
-  const dropped = new Set(droppedTokens.map((token) => token.toUpperCase()));
-  const next = { ...slots };
-
-  for (const key of ["symbol", "symbols"]) {
-    const slot = next[key];
-    if (!slot) continue;
-    if (Array.isArray(slot.value)) {
-      const value = slot.value.filter(
-        (item) => typeof item !== "string" || !dropped.has(item.toUpperCase()),
-      );
-      if (value.length === 0) {
-        delete next[key];
-      } else {
-        next[key] = { ...slot, value };
-      }
-      continue;
-    }
-    if (typeof slot.value === "string" && dropped.has(slot.value.toUpperCase())) {
-      delete next[key];
-    }
-  }
-
-  return next;
-}
-
-function validateDiagnostics(raw: unknown): RouterDiagnostic[] {
-  if (raw === undefined || raw === null) return [];
-  if (!Array.isArray(raw)) {
-    throw new Error("diagnostics must be an array");
-  }
-  return raw.map((item, idx) => {
-    if (!item || typeof item !== "object") {
-      throw new Error(`diagnostics[${idx}] must be an object`);
-    }
-    const diagnostic = item as Record<string, unknown>;
-    if (typeof diagnostic.code !== "string" || diagnostic.code.length === 0) {
-      throw new Error(`diagnostics[${idx}].code must be a non-empty string`);
-    }
-    if (typeof diagnostic.message !== "string") {
-      throw new Error(`diagnostics[${idx}].message must be a string`);
-    }
-    const out: RouterDiagnostic = {
-      code: diagnostic.code,
-      message: diagnostic.message,
-    };
-    if (
-      diagnostic.details &&
-      typeof diagnostic.details === "object" &&
-      !Array.isArray(diagnostic.details)
-    ) {
-      out.details = diagnostic.details as Record<string, unknown>;
-    }
-    return out;
-  });
-}
-
-function validateStringArray(raw: unknown, field: string): string[] {
-  if (raw === undefined || raw === null) return [];
-  if (!Array.isArray(raw)) {
-    throw new Error(`${field} must be an array`);
-  }
-  return raw.map((item, idx) => {
-    if (typeof item !== "string") {
-      throw new Error(`${field}[${idx}] must be a string`);
-    }
-    return item;
-  });
-}
-
-function minimalFallback(text: string): RouterOutput {
-  const entities = extractEntities(text);
-  return {
-    routeKind: "agent_task",
-    route: "fallback",
-    entities,
-    slots: {},
-    preference_updates: [],
-    missing_required: [],
-    tool_bundles: [],
-    diagnostics: [
-      {
-        code: "router_validation_failed",
-        message: "router validation failed persistently; emitted minimal fallback",
-      },
-    ],
-    reasoning: "router validation failed; emitted minimal fallback",
-  };
-}