@mastra/code-sdk 1.11.0 → 1.12.0-alpha.1

package/dist/auth/account-rotation-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-rotation-processor.js","names":[],"sources":["../../src/auth/account-rotation-processor.ts"],"sourcesContent":["/**\n * Error-driven rotation across a provider's OAuth account registry.\n *\n * When the active account cannot serve a request (rate limit, quota\n * exhaustion, dead token, persistent outage), the next account in insertion\n * order is selected for the request and the request retried. OAuth fetch\n * wrappers read that request-scoped selection on every HTTP attempt, so\n * concurrent runs can't swap each other's credentials. Every switch is\n * persisted as a non-transient `data-mastracode-account-switch` part so it\n * shows in the transcript and survives history reload.\n *\n * Two classes, two lanes — the split is load-bearing. The processor runner\n * walks `[...inputProcessors, ...outputProcessors, ...errorProcessors]` when\n * running `processAPIError`, so a processor registered in the input lane that\n * also implemented `processAPIError` would run BEFORE\n * `StreamErrorRetryProcessor` and hop on 5xx errors before transient retries\n * had a chance. `AccountRotationProcessor` therefore implements\n * `processAPIError` only and is registered in `errorProcessors` after\n * `StreamErrorRetryProcessor`; `AccountStartNoticeProcessor` implements\n * `processInput` only and is registered in `inputProcessors`.\n */\nimport { TripWire } from '@mastra/core/agent';\nimport type { ProcessAPIErrorArgs, ProcessInputArgs, ProcessInputResult, Processor } from '@mastra/core/processors';\n\nimport { resolveCredentialStore } from '../agents/credential-resolver.js';\nimport { resolveModel, resolveRequestThinkingLevel } from '../agents/model.js';\nimport {\n  getRequestAccountSelection,\n  isRequestAccountRoutingExhausted,\n  markRequestAccountRoutingExhausted,\n  setRequestAccountSelection,\n} from './account-routing-context.js';\nimport { ProviderAuthRequiredError, PROVIDER_AUTH_REQUIRED_ERROR } from './provider-auth-error.js';\nimport { getOAuthProviders } from './storage.js';\nimport type { CredentialStore, OAuthAccountRecord } from './types.js';\n\nexport const ACCOUNT_SWITCH_PART_TYPE = 'data-mastracode-account-switch';\n\n/** Labels and instance ids only — never token material (do-not list). */\nexport interface AccountSwitchPartData {\n  provider: string;\n  from: { id: string; label: string } | null;\n  to: { id: string; label: string } | null;\n  reason:\n    | 'rate-limit'\n    | 'quota-exhausted'\n    | 'auth-failed'\n    | 'pool-exhausted'\n    | 'persistent-outage'\n    | 'preferred-routing'\n    | 'starting-on-account';\n  at: string;\n  /**\n   * Set on a `to: null` part when a route pinned to a single account reported\n   * that account unusable. The provider's other subscriptions were never\n   * consulted (A12), so \"all accounts unavailable\" would misreport what\n   * happened.\n   */\n  exclusive?: boolean;\n}\n\n/** The store surface rotation needs; `AuthStorage` satisfies it structurally. */\nexport type RotationCredentialStore = CredentialStore & {\n  /**\n   * Force one refresh of the active account's tokens regardless of expiry\n   * (401/403 path — a rejected-but-unexpired token usually means clock skew\n   * or a refresh race). `AuthStorage` provides it; deployed per-tenant stores\n   * don't, and the auth path degrades to plain rotation (which itself no-ops\n   * without registry methods).\n   */\n  forceRefreshActiveAccount?(providerId: string, accountInstanceId?: string): Promise<string | undefined>;\n};\n\n/** Rotatable providers = the OAuth provider registry; API-key-only providers never rotate. */\nconst KNOWN_PROVIDER_IDS = new Set(getOAuthProviders().map(provider => provider.id));\n\n/** Hostname suffixes → provider ids, for `APICallError.url`. */\nconst PROVIDER_HOST_PATTERNS: Array<[RegExp, string]> = [\n  [/(^|\\.)api\\.anthropic\\.com$/i, 'anthropic'],\n  [/(^|\\.)api\\.kimi\\.com$/i, 'kimi-for-coding'],\n  [/(^|\\.)api\\.x\\.ai$/i, 'xai'],\n  [/(^|\\.)chatgpt\\.com$/i, 'openai-codex'],\n  [/(^|\\.)backend-api\\.codex\\.ai$/i, 'openai-codex'],\n  [/(^|\\.)githubcopilot\\.com$/i, 'github-copilot'],\n  [/(^|\\.)api\\.github\\.com$/i, 'github-copilot'],\n];\n\n/**\n * Provider usage/quota-limit wording (locked Q7 bucket 1). Statuses 429/402\n * are matched before this; some providers deliver quota errors as plain 400s,\n * which only the message reveals. Deliberately restricted to unambiguous\n * quota phrases — a generic \"exceeded your … limit\" can appear on non-quota\n * client errors (request size, context length) that must never rotate.\n */\nconst USAGE_LIMIT_MESSAGE_PATTERN =\n  /usage (?:limit|cap)|insufficient[_ ]quota|quota (?:exceeded|exhausted|reached)|exceeded (?:your )?current quota|insufficient (?:balance|credits?)|credits? exhausted|rate limit (?:exceeded|reached)|weekly limit|monthly limit/i;\n\nconst NETWORK_ERROR_CODES = new Set([\n  'ECONNRESET',\n  'EPIPE',\n  'ECONNREFUSED',\n  'ENOTFOUND',\n  'ETIMEDOUT',\n  'EAI_AGAIN',\n  'UND_ERR_CONNECT_TIMEOUT',\n  'UND_ERR_SOCKET',\n]);\n\nconst NETWORK_MESSAGE_PATTERN =\n  /fetch failed|network error|socket hang up|getaddrinfo|econnrefused|enotfound|etimedout|connection (?:refused|reset|closed|timed out)|other side closed|write epipe/i;\n\nconst MAX_CAUSE_DEPTH = 4;\n\n/** Persisted data-part type for a model-route hop. */\nexport const MODEL_FALLBACK_PART_TYPE = 'data-mastracode-model-fallback' as const;\n\n/** Non-secret transcript payload for a model-route hop. */\nexport interface ModelFallbackPartData {\n  from: { entryId: string; label: string };\n  to: { entryId: string; label: string };\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\n/** Session-state key set when account rotation advances the model route. */\nexport const MODEL_FALLBACK_STATE_KEY = 'mastracodePendingModelFallback' as const;\n\n/** Payload written to session state under MODEL_FALLBACK_STATE_KEY. */\nexport interface PendingModelFallback {\n  fromEntryId: string;\n  toEntryId: string;\n  toModelId: string;\n  threadId?: string;\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\nexport type RotationClassification =\n  | { kind: 'rotate'; reason: 'rate-limit' | 'quota-exhausted' | 'auth-failed' }\n  | { kind: 'hop' }\n  | { kind: 'never' };\n\nfunction isErrorWithCode(error: unknown): error is { code?: unknown } {\n  return typeof error === 'object' && error !== null && 'code' in error;\n}\n\nfunction readErrorStatus(error: unknown): number | undefined {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (typeof current !== 'object') break;\n    const { statusCode, status } = current as { statusCode?: unknown; status?: unknown };\n    if (typeof statusCode === 'number') return statusCode;\n    if (typeof status === 'number') return status;\n    current = (current as { cause?: unknown }).cause;\n  }\n  return undefined;\n}\n\nfunction isProviderAuthRequiredError(error: unknown): boolean {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (\n      current instanceof ProviderAuthRequiredError ||\n      (current instanceof Error && current.name === PROVIDER_AUTH_REQUIRED_ERROR)\n    ) {\n      return true;\n    }\n    if (typeof current !== 'object') break;\n    current = (current as { cause?: unknown }).cause;\n  }\n  return false;\n}\n\n/** Concatenate the error's message with its cause chain (bounded). */\nfunction collectErrorText(error: unknown): string {\n  const parts: string[] = [];\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (current instanceof Error) {\n      parts.push(current.message);\n      current = current.cause;\n    } else if (typeof current === 'object' && 'message' in current) {\n      const message = (current as { message?: unknown }).message;\n      if (typeof message === 'string') parts.push(message);\n      current = (current as { cause?: unknown }).cause;\n    } else {\n      break;\n    }\n  }\n  return parts.join(' | ');\n}\n\nfunction isNetworkErrorLike(error: unknown): boolean {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (\n      isErrorWithCode(current) &&\n      typeof current.code === 'string' &&\n      NETWORK_ERROR_CODES.has(current.code.toUpperCase())\n    ) {\n      return true;\n    }\n    if (current instanceof Error) {\n      if (NETWORK_MESSAGE_PATTERN.test(current.message)) return true;\n      current = current.cause;\n    } else if (typeof current === 'object') {\n      current = (current as { cause?: unknown }).cause;\n    } else {\n      break;\n    }\n  }\n  return false;\n}\n\n/**\n * The locked Q7 taxonomy. 429/402/usage-limit rotate immediately (429 is not\n * covered by any transient matcher, so it arrives here on first occurrence);\n * 401/403 and `ProviderAuthRequiredError` rotate after one forced refresh;\n * 5xx/network hop only when the transient retry budget is already spent (they\n * reach this processor because `StreamErrorRetryProcessor` declined); 400 and\n * everything unknown never touch the registry.\n */\nexport function classifyRotationError(error: unknown): RotationClassification {\n  if (isProviderAuthRequiredError(error)) {\n    return { kind: 'rotate', reason: 'auth-failed' };\n  }\n\n  const status = readErrorStatus(error);\n\n  if (status === 429) return { kind: 'rotate', reason: 'rate-limit' };\n  if (status === 402) return { kind: 'rotate', reason: 'quota-exhausted' };\n  if (status === 401 || status === 403) return { kind: 'rotate', reason: 'auth-failed' };\n  if (status !== undefined && status >= 500 && status < 600) return { kind: 'hop' };\n\n  // Quota wording only rotates when it co-occurs with a statusless or 400\n  // error — the shapes providers actually use for message-only quota\n  // failures. Any other status keeps its own classification above (401/403\n  // auth, 5xx outage hop, 404/422 never), so limit-ish text riding a\n  // non-quota client error can no longer burn the whole pool.\n  if (status === undefined || status === 400) {\n    if (USAGE_LIMIT_MESSAGE_PATTERN.test(collectErrorText(error))) {\n      return { kind: 'rotate', reason: 'quota-exhausted' };\n    }\n  }\n  if (isNetworkErrorLike(error)) return { kind: 'hop' };\n\n  return { kind: 'never' };\n}\n\n/** Provider id off a router model id: `mastracode/<provider>/<model>` or `<provider>/<model>`. */\nexport function providerFromModelId(modelId: string): string | undefined {\n  const segments = modelId.replace(/^mastracode\\//, '').split('/');\n  const providerId = segments[0];\n  if (providerId === 'openai') return 'openai-codex';\n  return providerId && KNOWN_PROVIDER_IDS.has(providerId) ? providerId : undefined;\n}\n\nfunction providerFromHost(hostname: string): string | undefined {\n  for (const [pattern, providerId] of PROVIDER_HOST_PATTERNS) {\n    if (pattern.test(hostname)) return providerId;\n  }\n  return undefined;\n}\n\n/**\n * Identify the provider an error came from: the request URL's hostname\n * (`APICallError.url`, cause chain included), falling back to the router\n * model id. Unknown → undefined (caller treats as never-rotate).\n */\nexport function providerFromError(error: unknown): string | undefined {\n  const causeChain: object[] = [];\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (typeof current !== 'object') break;\n    causeChain.push(current);\n    current = (current as { cause?: unknown }).cause;\n  }\n\n  // A request URL identifies the provider that actually handled the failed\n  // call. Check every supported URL field throughout the cause chain before\n  // falling back to router model metadata, which may describe the original\n  // session model rather than the active cascade entry.\n  for (const item of causeChain) {\n    const urls = [\n      (item as { url?: unknown }).url,\n      (item as { requestURL?: unknown }).requestURL,\n      (item as { requestUrl?: unknown }).requestUrl,\n    ];\n    for (const url of urls) {\n      if (typeof url !== 'string') continue;\n      try {\n        const providerId = providerFromHost(new URL(url).hostname);\n        if (providerId) return providerId;\n      } catch {\n        // Not a parseable URL — try the other fields and causes.\n      }\n    }\n  }\n\n  for (const item of causeChain) {\n    const modelId = (item as { modelId?: unknown }).modelId;\n    if (typeof modelId !== 'string') continue;\n    const providerId = providerFromModelId(modelId);\n    if (providerId) return providerId;\n  }\n  return undefined;\n}\n\nfunction getTriedInstances(state: Record<string, unknown>): Set<string> {\n  const existing = state.triedInstances;\n  if (existing instanceof Set) return existing;\n  const created = new Set<string>();\n  state.triedInstances = created;\n  return created;\n}\n\nfunction getForcedRefreshInstances(state: Record<string, unknown>): Set<string> {\n  const existing = state.forcedAuthRefresh;\n  if (existing instanceof Set) return existing;\n  const created = new Set<string>();\n  state.forcedAuthRefresh = created;\n  return created;\n}\n\n/** Friendly names for the part/notice copy (display only — never auth data). */\nexport const PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n  anthropic: 'Anthropic',\n  'kimi-for-coding': 'Kimi',\n  'openai-codex': 'Codex',\n  'github-copilot': 'GitHub Copilot',\n  xai: 'xAI',\n};\n\nconst REASON_TEXT: Record<Exclude<AccountSwitchPartData['reason'], 'starting-on-account'>, string> = {\n  'rate-limit': 'rate limit',\n  'quota-exhausted': 'quota exhausted',\n  'auth-failed': 'auth failed',\n  'pool-exhausted': 'pool exhausted',\n  'persistent-outage': 'persistent outage',\n  'preferred-routing': 'subscription routing',\n};\n\n/** Validates untrusted `reason` values (e.g. persisted message parts). */\nexport function isAccountSwitchReason(value: unknown): value is AccountSwitchPartData['reason'] {\n  return (\n    value === 'starting-on-account' ||\n    // Own-property check: `in` would accept prototype names like 'toString',\n    // which would then interpolate the inherited function into the notice text.\n    (typeof value === 'string' && Object.prototype.hasOwnProperty.call(REASON_TEXT, value))\n  );\n}\n\n/**\n * One-line transcript copy for a switch part. Shared by the live `info`\n * controller event (the TUI shows controller `info` events as transcript\n * lines, and no message event carries data parts mid-run) and by the TUI's\n * history rendering of the persisted part — one formatter, identical text.\n */\nexport function accountSwitchNoticeText(data: AccountSwitchPartData): string {\n  const provider = PROVIDER_DISPLAY_NAMES[data.provider] ?? data.provider;\n  if (data.reason === 'starting-on-account' && data.to) {\n    return `Starting on ${provider} account: ${data.to.label}`;\n  }\n  const reason = data.reason === 'starting-on-account' ? data.reason : REASON_TEXT[data.reason];\n  if (data.to === null) {\n    // A12: a targeted route reports *its* account, not the pool — the other\n    // subscriptions were never tried, so \"all accounts unavailable\" would be\n    // wrong and would read as if the pool had been walked.\n    if (data.exclusive) {\n      return `Pinned ${provider} account unavailable (${reason})`;\n    }\n    return `All ${provider} accounts unavailable (${reason})`;\n  }\n  const from = data.from?.label ?? 'unknown';\n  return `Switched ${provider} account: ${from} → ${data.to.label} (${reason})`;\n}\n\n/** Transcript line for a model-route hop; shared by the live info event and the TUI's history render. */\nexport function modelFallbackNoticeText(data: ModelFallbackPartData): string {\n  const reason = REASON_TEXT[data.reason] ?? data.reason;\n  return `Switched model route: ${data.from.label} → ${data.to.label} (${reason})`;\n}\n\n/**\n * Whether a persisted model-fallback reason is one this build understands.\n * `REASON_TEXT` also covers the account-switch reasons, so the notice text\n * alone would happily render a foreign value such as `rate-limit` as a\n * model-fallback reason; history parsed from another build's part must be\n * rejected instead.\n */\nexport function isModelFallbackReason(value: unknown): value is ModelFallbackPartData['reason'] {\n  return value === 'pool-exhausted' || value === 'persistent-outage';\n}\n\nasync function emitAccountSwitchPart(\n  args: Pick<ProcessAPIErrorArgs, 'writer' | 'requestContext'> | Pick<ProcessInputArgs, 'writer' | 'requestContext'>,\n  data: AccountSwitchPartData,\n): Promise<void> {\n  // Non-transient on purpose (contrast the transient tool-progress parts):\n  // switches must persist into the assistant message and render from history.\n  await args.writer?.custom({\n    type: ACCOUNT_SWITCH_PART_TYPE,\n    data,\n  });\n  // Data parts surface in the TUI only on history reload; emit the same line\n  // as a controller `info` event so the switch is visible live (precedent:\n  // emitTransientRetry emits controller events from the retry matcher).\n  const controllerContext = args.requestContext?.get('controller') as\n    | { emitEvent?: (event: { type: 'info'; message: string }) => void }\n    | undefined;\n  controllerContext?.emitEvent?.({ type: 'info', message: accountSwitchNoticeText(data) });\n}\n\n/**\n * Provider of the model the controller session is currently running — the\n * fallback identification path for errors that carry neither a request URL\n * nor a model id (e.g. `ProviderAuthRequiredError` thrown by a fetch wrapper\n * before any HTTP request exists).\n */\nfunction providerFromSession(\n  args: Pick<ProcessAPIErrorArgs, 'requestContext'> | Pick<ProcessInputArgs, 'requestContext'>,\n): string | undefined {\n  const controller = args.requestContext?.get('controller') as { session?: { modelId?: unknown } } | undefined;\n  const modelId = controller?.session?.modelId;\n  return typeof modelId === 'string' ? providerFromModelId(modelId) : undefined;\n}\n\n/**\n * Rotates the active OAuth account on classified API errors.\n *\n * Registered in `errorProcessors` AFTER `StreamErrorRetryProcessor` — a\n * transient error reaching this processor means the transient budget is\n * spent, which is exactly the hop condition. Implements `processAPIError`\n * ONLY (see the file header for the runner-order rationale).\n */\n/** Cached per-request model route cascade. */\ninterface ModelRouteCascade {\n  entries: Array<{ id: string; label: string; modelId: string; accountId?: string }>;\n  position: number;\n}\n\ninterface AccountRoute {\n  entryId: string;\n  modelId: string;\n  providerId: string;\n  accountId?: string;\n}\n\ntype RoutingProcessorArgs = Pick<ProcessAPIErrorArgs, 'requestContext' | 'state' | 'writer'> | ProcessInputArgs;\n\nexport type RoutingControllerContext = {\n  session?: { modelId?: unknown; modeId?: unknown };\n  threadId?: unknown;\n  getState?: () => Record<string, unknown>;\n  setState?: (updates: Record<string, unknown>) => Promise<void>;\n  getThreadSetting?: (key: string) => Promise<unknown>;\n  setThreadSetting?: (setting: { key: string; value: unknown }) => Promise<void>;\n  isThreadActive?: () => boolean;\n};\n\nfunction getRoutingController(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n): RoutingControllerContext | undefined {\n  return args.requestContext?.get('controller') as RoutingControllerContext | undefined;\n}\n\n/** A targeted route is exclusive; an entry without accountId uses automatic pool rotation. */\nfunction getRouteTargetAccountId(route: AccountRoute | null): string | undefined {\n  return route?.accountId;\n}\n\nfunction getRequestActiveAccount(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n  store: CredentialStore,\n  providerId: string,\n) {\n  if (isRequestAccountRoutingExhausted(args.requestContext, providerId)) return undefined;\n  const selectedId = getRequestAccountSelection(args.requestContext, providerId);\n  if (selectedId) return store.listAccounts?.(providerId).find(account => account.id === selectedId);\n  return store.getActiveAccount?.(providerId) ?? store.listAccounts?.(providerId).find(account => account.active);\n}\n\nfunction resolveAccountRoute(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n  explicit?: { id: string; modelId: string; accountId?: string },\n): AccountRoute | null {\n  const controller = getRoutingController(args);\n  const state = controller?.getState?.();\n  const pending = state?.mastracodePendingModelFallback as\n    | { toEntryId?: unknown; toModelId?: unknown; threadId?: unknown }\n    | null\n    | undefined;\n  const pendingMatchesThread =\n    pending &&\n    typeof pending.toEntryId === 'string' &&\n    typeof pending.toModelId === 'string' &&\n    (pending.threadId === undefined || pending.threadId === controller?.threadId);\n  const routeEntries = Array.isArray((state?.modelRoute as { entries?: unknown } | undefined)?.entries)\n    ? ((state?.modelRoute as { entries: Array<{ id?: unknown; modelId?: unknown; accountId?: unknown }> }).entries ??\n      [])\n    : [];\n  const entry = explicit\n    ? explicit\n    : pendingMatchesThread\n      ? routeEntries.find(candidate => candidate.id === pending.toEntryId && candidate.modelId === pending.toModelId)\n      : routeEntries.find(candidate => candidate.modelId === controller?.session?.modelId);\n  if (!entry || typeof entry.id !== 'string' || typeof entry.modelId !== 'string') return null;\n  const providerId = providerFromModelId(entry.modelId);\n  if (!providerId) return null;\n  return {\n    entryId: entry.id,\n    modelId: entry.modelId,\n    providerId,\n    ...(typeof entry.accountId === 'string' ? { accountId: entry.accountId } : {}),\n  };\n}\n\n/**\n * A14: `Automatic` rotation starts *at* the persisted active account and walks\n * insertion order from there, wrapping once. The active account is the cursor\n * rotation last left at, so a turn that starts at index 0 regardless would\n * re-activate and re-try an account the previous turn already moved past —\n * which is the whole job the removed sticky-exclusion set was doing badly.\n * With no persisted active account the order is plain insertion order.\n */\nfunction orderAccountsFromActive(accounts: OAuthAccountRecord[], activeId: string | undefined) {\n  const index = activeId === undefined ? -1 : accounts.findIndex(account => account.id === activeId);\n  if (index <= 0) return accounts;\n  return [...accounts.slice(index), ...accounts.slice(0, index)];\n}\n\nasync function applyPreferredAccountRoute(\n  args: RoutingProcessorArgs,\n  store: CredentialStore,\n  route: AccountRoute,\n): Promise<boolean> {\n  store.reload();\n  const preferredId = getRouteTargetAccountId(route);\n  const accounts = store.listAccounts?.(route.providerId) ?? [];\n  if (accounts.length === 0 && preferredId === undefined) return false;\n  const tried = getTriedInstances(args.state);\n  const unavailable = new Set(accounts.filter(account => tried.has(account.id)).map(account => account.id));\n  const active = getRequestActiveAccount(args, store, route.providerId) ?? store.getActiveAccount?.(route.providerId);\n  const selected = // A12: a targeted route may use only the account it names. `Automatic`\n    // keeps insertion order with full pool rotation (A10), starting from the\n    // account the cursor already points at (A14).\n    (\n      preferredId\n        ? accounts.filter(account => account.id === preferredId)\n        : orderAccountsFromActive(accounts, active?.id)\n    ).find(account => !unavailable.has(account.id));\n\n  for (const accountId of unavailable) tried.add(accountId);\n  if (!selected) {\n    markRequestAccountRoutingExhausted(args.requestContext, route.providerId);\n    return false;\n  }\n\n  if (active?.id === selected.id) {\n    setRequestAccountSelection(args.requestContext, route.providerId, selected.id);\n    return false;\n  }\n  // Activate before recording the request-scoped selection: a failed\n  // activation must not leave the selection claiming an account that never\n  // became the provider's active credential.\n  const activated = store.activateAccount ? store.activateAccount(route.providerId, selected.id) : selected;\n  if (!activated) {\n    // Only a targeted route is out of options here. The exhausted marker is\n    // request-wide and fails every credential read closed, so setting it for\n    // `Automatic` would stop error recovery from retrying on a survivor.\n    if (preferredId !== undefined) markRequestAccountRoutingExhausted(args.requestContext, route.providerId);\n    return false;\n  }\n  setRequestAccountSelection(args.requestContext, route.providerId, activated.id);\n\n  // Applying an explicit account choice is routine, not a failover notice.\n  if (preferredId === undefined) {\n    await emitAccountSwitchPart(args, {\n      provider: route.providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: { id: activated.id, label: activated.label },\n      reason: 'preferred-routing',\n      at: new Date().toISOString(),\n    });\n  }\n  return true;\n}\n\nexport class AccountRotationProcessor implements Processor {\n  readonly id = 'mastracode-account-rotation' as const;\n\n  constructor(\n    private readonly options: {\n      credentialStore: RotationCredentialStore;\n      maxProcessorRetries: number;\n      settingsPath?: string;\n    },\n  ) {}\n\n  async processAPIError(args: ProcessAPIErrorArgs): Promise<{ retry: boolean }> {\n    const { error, state } = args;\n\n    // Core runs error processors even after the shared retry budget is spent\n    // and silently discards `retry: true` then (llm-execution-step.ts\n    // canRetryError) — rotating the cursor or emitting a switch part for a\n    // retry that will never run would lie to both auth.json and the\n    // transcript. With a fallback chain configured, a bare `retry: false`\n    // here would silently advance the route for an error we never classified, so the\n    // chain gate surfaces the error instead.\n    if (args.retryCount >= this.options.maxProcessorRetries) {\n      await this.gateChainHop(args, error);\n      return { retry: false };\n    }\n\n    // Classify before attributing: an error from a provider outside the OAuth\n    // registry (API-key/router providers are valid route entries) still hops on\n    // rotate/hop classes — there is just no account cursor to advance.\n    const classification = classifyRotationError(error);\n    // Q14: 400/unknown errors never rotate and never advance routes. With a chain\n    // active, core's fallback array would still advance on a bare\n    // `retry: false` (it advances on any thrown non-TripWire error), so the\n    // gate converts that into a surfaced error instead of a silent hop.\n    if (classification.kind === 'never') {\n      await this.gateChainHop(args, error);\n      return { retry: false };\n    }\n\n    const cascade = await this.getModelRouteCascade(args);\n    const currentEntry = cascade?.entries[cascade.position];\n    const providerId =\n      providerFromError(error) ??\n      (currentEntry ? providerFromModelId(currentEntry.modelId) : undefined) ??\n      (cascade ? undefined : providerFromSession(args));\n    if (!providerId) {\n      await this.emitModelFallbackPart(args, classification.kind === 'hop' ? 'persistent-outage' : 'pool-exhausted');\n      return { retry: false };\n    }\n\n    // Deployed requests resolve the tenant-scoped store; local mode keeps the\n    // host storage. Reading the host registry here would rotate or announce\n    // host accounts for a tenant request. Annotated as the rotation surface:\n    // `resolveCredentialStore` returns a plain CredentialStore, and the 401\n    // path below uses the optional `forceRefreshActiveAccount` when the host\n    // provides it.\n    const store: RotationCredentialStore = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n    store.reload();\n    const accounts = store.listAccounts?.(providerId) ?? [];\n    const active = getRequestActiveAccount(args, store, providerId);\n    const route = currentEntry ? resolveAccountRoute(args, currentEntry) : resolveAccountRoute(args);\n\n    // Q7 bucket 2: force one refresh of the active instance before rotating.\n    // A 401 usually means a fresh-but-rejected token; the forced refresh\n    // covers server-side clock skew and refresh-token races. Success retries\n    // the same account — no rotation, no part. With no active account (e.g.\n    // `ProviderAuthRequiredError` from an empty registry) a refresh can never\n    // succeed, so skip it and fall through to the retry:false surface below,\n    // which rethrows the original auth error instead of a generic pool\n    // exhaustion message.\n    if (classification.kind === 'rotate' && classification.reason === 'auth-failed' && active) {\n      const forced = getForcedRefreshInstances(state);\n      const refreshKey = `${providerId}:${active?.id ?? 'active'}`;\n      if (!forced.has(refreshKey) && typeof store.forceRefreshActiveAccount === 'function') {\n        forced.add(refreshKey);\n        const token = await store.forceRefreshActiveAccount(providerId, active?.id);\n        if (token !== undefined) {\n          return { retry: true };\n        }\n      }\n    }\n\n    // A12: only a pin on the provider that actually failed makes this failure\n    // exclusive. `route.providerId` is derived from the route's model while\n    // `providerId` comes from the failed request's URL, which during a cascade\n    // can still describe the session model rather than the entry being retried;\n    // when they differ the pin belongs to an unrelated route, so the provider\n    // that failed keeps its normal pool handling.\n    const targetAccountId = route?.providerId === providerId ? getRouteTargetAccountId(route) : undefined;\n\n    if (classification.kind === 'hop') {\n      return this.declarePoolUnavailable(args, providerId, 'persistent-outage', targetAccountId !== undefined);\n    }\n\n    // A12: a targeted route never activates a sibling subscription. A\n    // rotate-classified failure on the account the route selected proceeds to\n    // the model route instead — the request hops, it does not spill\n    // onto another subscription's quota. A targeted route has nothing to\n    // rotate to at any pool size. A stale id for an account the user removed\n    // reads the same way: fail closed rather than silently land on a sibling.\n    if (targetAccountId !== undefined) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted', true);\n    }\n\n    // Count only this provider's instances: `tried` spans the whole request\n    // (a cascade can visit several providers), so comparing its raw size to\n    // this provider's account count would falsely report exhaustion when an\n    // earlier provider in the same request already used up accounts.\n    const tried = getTriedInstances(state);\n    if (active) tried.add(active.id);\n    // The tried-set is request-global and shared across providers after a\n    // route hop, so exhaustion must count only this provider's ids.\n    const triedForProvider = accounts.filter(account => tried.has(account.id)).length;\n    if (triedForProvider >= accounts.length) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted');\n    }\n\n    // If the selected account was removed elsewhere, even a single survivor\n    // is still untried. Resume from the freshly loaded global cursor.\n    const candidates = active ? accounts : orderAccountsFromActive(accounts, store.getActiveAccount?.(providerId)?.id);\n    const nextCandidate = candidates.find(account => !tried.has(account.id));\n\n    const next = nextCandidate ? store.activateAccount?.(providerId, nextCandidate.id) : undefined;\n    if (!next) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted');\n    }\n    setRequestAccountSelection(args.requestContext, providerId, next.id);\n    tried.add(next.id);\n\n    // The retry replays the request from scratch (Q10): rotate the assistant\n    // message id so the retried response starts a fresh message instead of\n    // appending to the partially streamed one.\n    args.rotateResponseMessageId?.();\n\n    await emitAccountSwitchPart(args, {\n      provider: providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: { id: next.id, label: next.label },\n      reason: classification.reason,\n      at: new Date().toISOString(),\n    });\n\n    return { retry: true };\n  }\n\n  /**\n   * Resolve the request's host-supplied model route once and cache the reachable\n   * prefix in processor state. Resolution mirrors getDynamicModel so a hop is\n   * never announced for an entry core cannot reach.\n   */\n  private async getModelRouteCascade(args: ProcessAPIErrorArgs): Promise<ModelRouteCascade | null> {\n    if (args.state.modelRouteCascade !== undefined) {\n      return (args.state.modelRouteCascade as ModelRouteCascade | null) ?? null;\n    }\n    const controller = getRoutingController(args);\n    const state = controller?.getState?.();\n    const route = (\n      state?.modelRoute as\n        | { entries?: Array<{ id?: unknown; label?: unknown; modelId?: unknown; accountId?: unknown }> }\n        | undefined\n    )?.entries;\n    const pending = state?.mastracodePendingModelFallback as\n      | { toEntryId?: unknown; threadId?: unknown }\n      | null\n      | undefined;\n    const pendingMatchesThread =\n      pending &&\n      typeof pending.toEntryId === 'string' &&\n      (pending.threadId === undefined || pending.threadId === controller?.threadId);\n    const startIndex = pendingMatchesThread\n      ? route?.findIndex(entry => entry.id === pending.toEntryId)\n      : route?.findIndex(entry => entry.modelId === controller?.session?.modelId);\n    if (!route || startIndex === undefined || startIndex < 0 || route.length - startIndex < 2) {\n      args.state.modelRouteCascade = null;\n      return null;\n    }\n\n    const thinkingLevel = resolveRequestThinkingLevel(\n      {\n        state: { thinkingLevel: state?.thinkingLevel },\n        session: { modeId: typeof controller?.session?.modeId === 'string' ? controller.session.modeId : 'build' },\n      },\n      this.options.settingsPath,\n    );\n    const entries: ModelRouteCascade['entries'] = [];\n    for (const entry of route.slice(startIndex)) {\n      if (\n        typeof entry.id !== 'string' ||\n        entry.id.length === 0 ||\n        typeof entry.modelId !== 'string' ||\n        entry.modelId.length === 0\n      ) {\n        break;\n      }\n      if (entries.length > 0) {\n        try {\n          resolveModel(entry.modelId, {\n            thinkingLevel,\n            remapForCodexOAuth: true,\n            requestContext: args.requestContext,\n          });\n        } catch {\n          break;\n        }\n      }\n      entries.push({\n        id: entry.id,\n        label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.id,\n        modelId: entry.modelId,\n        ...(typeof entry.accountId === 'string' ? { accountId: entry.accountId } : {}),\n      });\n    }\n    if (entries.length < 2) {\n      args.state.modelRouteCascade = null;\n      return null;\n    }\n    const cascade: ModelRouteCascade = { entries, position: 0 };\n    args.state.modelRouteCascade = cascade;\n    return cascade;\n  }\n\n  /**\n   * Q14 gate: 400/unknown/unattributable errors never advance routes. Core's\n   * fallback array advances on ANY thrown error except TripWire\n   * (llm-execution-step.ts), so when the session route has another entry and the\n   * current entry is non-last, a bare `retry: false` would silently hop on an\n   * error class the user excluded from hop triggers. TripWire is the only\n   * no-advance escape: the runner rethrows it and the fallback loop declines\n   * to advance. No chain (or already on the last entry) → return and let the\n   * plain `retry: false` surface the error exactly as before.\n   */\n  private async gateChainHop(args: ProcessAPIErrorArgs, error: unknown): Promise<void> {\n    const cascade = await this.getModelRouteCascade(args);\n    if (!cascade) return;\n    if (cascade.position >= cascade.entries.length - 1) return;\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new TripWire(reason, {}, this.id);\n  }\n\n  /** Announce and persist the next model-route hop before core advances. */\n  private async emitModelFallbackPart(\n    args: ProcessAPIErrorArgs,\n    reason: 'pool-exhausted' | 'persistent-outage',\n  ): Promise<void> {\n    const cascade = await this.getModelRouteCascade(args);\n    if (!cascade) return;\n\n    const from = cascade.entries[cascade.position];\n    const to = cascade.entries[cascade.position + 1];\n    if (!from || !to) return;\n\n    const controller = args.requestContext?.get('controller') as\n      | {\n          threadId?: unknown;\n          setState?: (updates: Record<string, unknown>) => Promise<void>;\n          setThreadSetting?: (setting: { key: string; value: unknown }) => Promise<void>;\n          emitEvent?: (event: { type: 'info'; message: string }) => void;\n        }\n      | undefined;\n    const at = new Date().toISOString();\n    const threadId = typeof controller?.threadId === 'string' ? controller.threadId : undefined;\n    const pending = {\n      fromEntryId: from.id,\n      toEntryId: to.id,\n      toModelId: to.modelId,\n      ...(threadId ? { threadId } : {}),\n      reason,\n      at,\n    } satisfies PendingModelFallback;\n    await controller?.setThreadSetting?.({ key: MODEL_FALLBACK_STATE_KEY, value: pending });\n    const data: ModelFallbackPartData = {\n      from: { entryId: from.id, label: from.label },\n      to: { entryId: to.id, label: to.label },\n      reason,\n      at,\n    };\n    try {\n      await args.writer?.custom({ type: MODEL_FALLBACK_PART_TYPE, data });\n    } catch (error) {\n      await controller?.setThreadSetting?.({ key: MODEL_FALLBACK_STATE_KEY, value: undefined });\n      throw error;\n    }\n    await controller?.setState?.({ [MODEL_FALLBACK_STATE_KEY]: pending });\n    args.state.startNoticeEmitted = false;\n    const targetRoute = resolveAccountRoute(args, to);\n    if (targetRoute) {\n      const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n      await applyPreferredAccountRoute(args, store, targetRoute).catch(() => undefined);\n    }\n    controller?.emitEvent?.({ type: 'info', message: modelFallbackNoticeText(data) });\n    cascade.position++;\n  }\n\n  /**\n   * Pool done for this request: every instance recorded in the tried-set and\n   * a `to: null` part emitted. Returns `retry: false` so core's fallback\n   * array can hop to the next route entry (announced by `emitModelFallbackPart`).\n   * Silent on the account part when the provider has no registry at all —\n   * there are no accounts to declare unavailable, but the hop still applies.\n   */\n  private async declarePoolUnavailable(\n    args: ProcessAPIErrorArgs,\n    providerId: string,\n    reason: 'pool-exhausted' | 'persistent-outage',\n    exclusive = false,\n  ): Promise<{ retry: boolean }> {\n    const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n    const accounts = store.listAccounts?.(providerId) ?? [];\n    if (accounts.length === 0) {\n      // No account registry (API-key-only provider): nothing rotated, but the\n      // hop still happens — announce the model fallback before core advances.\n      await this.emitModelFallbackPart(args, reason);\n      return { retry: false };\n    }\n\n    const tried = getTriedInstances(args.state);\n    for (const account of accounts) tried.add(account.id);\n\n    const active = getRequestActiveAccount(args, store, providerId);\n\n    await emitAccountSwitchPart(args, {\n      provider: providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: null,\n      reason,\n      at: new Date().toISOString(),\n      ...(exclusive ? { exclusive: true } : {}),\n    });\n\n    await this.emitModelFallbackPart(args, reason);\n\n    return { retry: false };\n  }\n}\n\n/**\n * Emits the \"starting on a non-default account\" notice (Q19) once per\n * request when the active registry account is not the first entry.\n *\n * TYPE CONSTRAINT: this class must NEVER implement `processAPIError`. It\n * lives in `inputProcessors`; the runner walks input processors first when\n * running `processAPIError`, so adding the method here would classify and\n * rotate errors BEFORE `StreamErrorRetryProcessor`'s transient retries run.\n */\nexport class AccountStartNoticeProcessor implements Processor {\n  readonly id = 'mastracode-account-start-notice' as const;\n\n  constructor(private readonly options: { credentialStore: CredentialStore }) {}\n\n  async processInput(args: ProcessInputArgs): Promise<ProcessInputResult> {\n    if (args.state.startNoticeEmitted) return args.messageList;\n\n    // Deployed requests resolve the tenant-scoped store so host accounts are\n    // never listed, activated, or announced for a tenant run. Local mode keeps\n    // the constructor's storage.\n    const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n\n    const route = resolveAccountRoute(args);\n    if (route) {\n      const switched = await applyPreferredAccountRoute(args, store, route);\n      if (switched || getRouteTargetAccountId(route) !== undefined) {\n        args.state.startNoticeEmitted = true;\n        return args.messageList;\n      }\n    } else {\n      store.reload();\n    }\n\n    // A14: a route whose accounts are all unavailable is not a pre-emptive\n    // abort. `applyPreferredAccountRoute` marks the provider on the request so\n    // credential reads fail closed rather than falling through to the active\n    // account, and the request then runs and fails at the provider — which is\n    // what lets the error lane classify it and hand the turn to the route's\n    // configured fallback chain. The removed persisted set threw here instead,\n    // before any socket opened, so the chain was never reached.\n    const providerId = route?.providerId ?? providerFromSession(args);\n    if (!providerId) return args.messageList;\n\n    const accounts = store.listAccounts?.(providerId) ?? [];\n    if (accounts.length < 2) return args.messageList;\n\n    const active = store.getActiveAccount?.(providerId);\n    const first = accounts[0];\n    if (!active || !first || active.id === first.id) return args.messageList;\n\n    args.state.startNoticeEmitted = true;\n\n    await emitAccountSwitchPart(args, {\n      provider: providerId,\n      from: null,\n      to: { id: active.id, label: active.label },\n      reason: 'starting-on-account',\n      at: new Date().toISOString(),\n    });\n\n    return args.messageList;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"account-rotation-processor.js","names":[],"sources":["../../src/auth/account-rotation-processor.ts"],"sourcesContent":["/**\n * Error-driven rotation across a provider's OAuth account registry.\n *\n * When the active account cannot serve a request (rate limit, quota\n * exhaustion, dead token, persistent outage), the next account in insertion\n * order is selected for the request and the request retried. OAuth fetch\n * wrappers read that request-scoped selection on every HTTP attempt, so\n * concurrent runs can't swap each other's credentials. Every switch is\n * persisted as a non-transient `data-mastracode-account-switch` part so it\n * shows in the transcript and survives history reload.\n *\n * Two classes, two lanes — the split is load-bearing. The processor runner\n * walks `[...inputProcessors, ...outputProcessors, ...errorProcessors]` when\n * running `processAPIError`, so a processor registered in the input lane that\n * also implemented `processAPIError` would run BEFORE\n * `StreamErrorRetryProcessor` and hop on 5xx errors before transient retries\n * had a chance. `AccountRotationProcessor` therefore implements\n * `processAPIError` only and is registered in `errorProcessors` after\n * `StreamErrorRetryProcessor`; `AccountStartNoticeProcessor` implements\n * `processInput` only and is registered in `inputProcessors`.\n */\nimport { TripWire } from '@mastra/core/agent';\nimport type { ProcessAPIErrorArgs, ProcessInputArgs, ProcessInputResult, Processor } from '@mastra/core/processors';\n\nimport { resolveCredentialStore } from '../agents/credential-resolver.js';\nimport { resolveModel, resolveRequestThinkingLevel } from '../agents/model.js';\nimport {\n  getRequestAccountSelection,\n  isRequestAccountRoutingExhausted,\n  markRequestAccountRoutingExhausted,\n  setRequestAccountSelection,\n} from './account-routing-context.js';\nimport { ProviderAuthRequiredError, PROVIDER_AUTH_REQUIRED_ERROR } from './provider-auth-error.js';\nimport { getOAuthProviders } from './storage.js';\nimport type { CredentialStore, OAuthAccountRecord } from './types.js';\n\nexport const ACCOUNT_SWITCH_PART_TYPE = 'data-mastracode-account-switch';\n\n/** Labels and instance ids only — never token material (do-not list). */\nexport interface AccountSwitchPartData {\n  provider: string;\n  from: { id: string; label: string } | null;\n  to: { id: string; label: string } | null;\n  reason:\n    | 'rate-limit'\n    | 'quota-exhausted'\n    | 'auth-failed'\n    | 'pool-exhausted'\n    | 'persistent-outage'\n    | 'preferred-routing';\n  at: string;\n  /**\n   * Set on a `to: null` part when a route pinned to a single account reported\n   * that account unusable. The provider's other subscriptions were never\n   * consulted (A12), so \"all accounts unavailable\" would misreport what\n   * happened.\n   */\n  exclusive?: boolean;\n}\n\n/** The store surface rotation needs; `AuthStorage` satisfies it structurally. */\nexport type RotationCredentialStore = CredentialStore & {\n  /**\n   * Force one refresh of the active account's tokens regardless of expiry\n   * (401/403 path — a rejected-but-unexpired token usually means clock skew\n   * or a refresh race). `AuthStorage` provides it; deployed per-tenant stores\n   * don't, and the auth path degrades to plain rotation (which itself no-ops\n   * without registry methods).\n   */\n  forceRefreshActiveAccount?(providerId: string, accountInstanceId?: string): Promise<string | undefined>;\n};\n\n/** Rotatable providers = the OAuth provider registry; API-key-only providers never rotate. */\nconst KNOWN_PROVIDER_IDS = new Set(getOAuthProviders().map(provider => provider.id));\n\n/** Hostname suffixes → provider ids, for `APICallError.url`. */\nconst PROVIDER_HOST_PATTERNS: Array<[RegExp, string]> = [\n  [/(^|\\.)api\\.anthropic\\.com$/i, 'anthropic'],\n  [/(^|\\.)api\\.kimi\\.com$/i, 'kimi-for-coding'],\n  [/(^|\\.)api\\.x\\.ai$/i, 'xai'],\n  [/(^|\\.)chatgpt\\.com$/i, 'openai-codex'],\n  [/(^|\\.)backend-api\\.codex\\.ai$/i, 'openai-codex'],\n  [/(^|\\.)githubcopilot\\.com$/i, 'github-copilot'],\n  [/(^|\\.)api\\.github\\.com$/i, 'github-copilot'],\n];\n\n/**\n * Provider usage/quota-limit wording (locked Q7 bucket 1). Statuses 429/402\n * are matched before this; some providers deliver quota errors as plain 400s,\n * which only the message reveals. Deliberately restricted to unambiguous\n * quota phrases — a generic \"exceeded your … limit\" can appear on non-quota\n * client errors (request size, context length) that must never rotate.\n */\nconst USAGE_LIMIT_MESSAGE_PATTERN =\n  /usage (?:limit|cap)|insufficient[_ ]quota|quota (?:exceeded|exhausted|reached)|exceeded (?:your )?current quota|insufficient (?:balance|credits?)|credits? exhausted|rate limit (?:exceeded|reached)|weekly limit|monthly limit/i;\n\nconst NETWORK_ERROR_CODES = new Set([\n  'ECONNRESET',\n  'EPIPE',\n  'ECONNREFUSED',\n  'ENOTFOUND',\n  'ETIMEDOUT',\n  'EAI_AGAIN',\n  'UND_ERR_CONNECT_TIMEOUT',\n  'UND_ERR_SOCKET',\n]);\n\nconst NETWORK_MESSAGE_PATTERN =\n  /fetch failed|network error|socket hang up|getaddrinfo|econnrefused|enotfound|etimedout|connection (?:refused|reset|closed|timed out)|other side closed|write epipe/i;\n\nconst MAX_CAUSE_DEPTH = 4;\n\n/** Persisted data-part type for a model-route hop. */\nexport const MODEL_FALLBACK_PART_TYPE = 'data-mastracode-model-fallback' as const;\n\n/** Non-secret transcript payload for a model-route hop. */\nexport interface ModelFallbackPartData {\n  from: { entryId: string; label: string };\n  to: { entryId: string; label: string };\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\n/** Session-state key set when account rotation advances the model route. */\nexport const MODEL_FALLBACK_STATE_KEY = 'mastracodePendingModelFallback' as const;\n\n/** Payload written to session state under MODEL_FALLBACK_STATE_KEY. */\nexport interface PendingModelFallback {\n  fromEntryId: string;\n  toEntryId: string;\n  toModelId: string;\n  threadId?: string;\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\nexport type RotationClassification =\n  | { kind: 'rotate'; reason: 'rate-limit' | 'quota-exhausted' | 'auth-failed' }\n  | { kind: 'hop' }\n  | { kind: 'never' };\n\nfunction isErrorWithCode(error: unknown): error is { code?: unknown } {\n  return typeof error === 'object' && error !== null && 'code' in error;\n}\n\nfunction readErrorStatus(error: unknown): number | undefined {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (typeof current !== 'object') break;\n    const { statusCode, status } = current as { statusCode?: unknown; status?: unknown };\n    if (typeof statusCode === 'number') return statusCode;\n    if (typeof status === 'number') return status;\n    current = (current as { cause?: unknown }).cause;\n  }\n  return undefined;\n}\n\nfunction isProviderAuthRequiredError(error: unknown): boolean {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (\n      current instanceof ProviderAuthRequiredError ||\n      (current instanceof Error && current.name === PROVIDER_AUTH_REQUIRED_ERROR)\n    ) {\n      return true;\n    }\n    if (typeof current !== 'object') break;\n    current = (current as { cause?: unknown }).cause;\n  }\n  return false;\n}\n\n/** Concatenate the error's message with its cause chain (bounded). */\nfunction collectErrorText(error: unknown): string {\n  const parts: string[] = [];\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (current instanceof Error) {\n      parts.push(current.message);\n      current = current.cause;\n    } else if (typeof current === 'object' && 'message' in current) {\n      const message = (current as { message?: unknown }).message;\n      if (typeof message === 'string') parts.push(message);\n      current = (current as { cause?: unknown }).cause;\n    } else {\n      break;\n    }\n  }\n  return parts.join(' | ');\n}\n\nfunction isNetworkErrorLike(error: unknown): boolean {\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (\n      isErrorWithCode(current) &&\n      typeof current.code === 'string' &&\n      NETWORK_ERROR_CODES.has(current.code.toUpperCase())\n    ) {\n      return true;\n    }\n    if (current instanceof Error) {\n      if (NETWORK_MESSAGE_PATTERN.test(current.message)) return true;\n      current = current.cause;\n    } else if (typeof current === 'object') {\n      current = (current as { cause?: unknown }).cause;\n    } else {\n      break;\n    }\n  }\n  return false;\n}\n\n/**\n * The locked Q7 taxonomy. 429/402/usage-limit rotate immediately (429 is not\n * covered by any transient matcher, so it arrives here on first occurrence);\n * 401/403 and `ProviderAuthRequiredError` rotate after one forced refresh;\n * 5xx/network hop only when the transient retry budget is already spent (they\n * reach this processor because `StreamErrorRetryProcessor` declined); 400 and\n * everything unknown never touch the registry.\n */\nexport function classifyRotationError(error: unknown): RotationClassification {\n  if (isProviderAuthRequiredError(error)) {\n    return { kind: 'rotate', reason: 'auth-failed' };\n  }\n\n  const status = readErrorStatus(error);\n\n  if (status === 429) return { kind: 'rotate', reason: 'rate-limit' };\n  if (status === 402) return { kind: 'rotate', reason: 'quota-exhausted' };\n  if (status === 401 || status === 403) return { kind: 'rotate', reason: 'auth-failed' };\n  if (status !== undefined && status >= 500 && status < 600) return { kind: 'hop' };\n\n  // Quota wording only rotates when it co-occurs with a statusless or 400\n  // error — the shapes providers actually use for message-only quota\n  // failures. Any other status keeps its own classification above (401/403\n  // auth, 5xx outage hop, 404/422 never), so limit-ish text riding a\n  // non-quota client error can no longer burn the whole pool.\n  if (status === undefined || status === 400) {\n    if (USAGE_LIMIT_MESSAGE_PATTERN.test(collectErrorText(error))) {\n      return { kind: 'rotate', reason: 'quota-exhausted' };\n    }\n  }\n  if (isNetworkErrorLike(error)) return { kind: 'hop' };\n\n  return { kind: 'never' };\n}\n\n/** Provider id off a router model id: `mastracode/<provider>/<model>` or `<provider>/<model>`. */\nexport function providerFromModelId(modelId: string): string | undefined {\n  const segments = modelId.replace(/^mastracode\\//, '').split('/');\n  const providerId = segments[0];\n  if (providerId === 'openai') return 'openai-codex';\n  return providerId && KNOWN_PROVIDER_IDS.has(providerId) ? providerId : undefined;\n}\n\nfunction providerFromHost(hostname: string): string | undefined {\n  for (const [pattern, providerId] of PROVIDER_HOST_PATTERNS) {\n    if (pattern.test(hostname)) return providerId;\n  }\n  return undefined;\n}\n\n/**\n * Identify the provider an error came from: the request URL's hostname\n * (`APICallError.url`, cause chain included), falling back to the router\n * model id. Unknown → undefined (caller treats as never-rotate).\n */\nexport function providerFromError(error: unknown): string | undefined {\n  const causeChain: object[] = [];\n  let current: unknown = error;\n  for (let depth = 0; current && depth < MAX_CAUSE_DEPTH; depth++) {\n    if (typeof current !== 'object') break;\n    causeChain.push(current);\n    current = (current as { cause?: unknown }).cause;\n  }\n\n  // A request URL identifies the provider that actually handled the failed\n  // call. Check every supported URL field throughout the cause chain before\n  // falling back to router model metadata, which may describe the original\n  // session model rather than the active cascade entry.\n  for (const item of causeChain) {\n    const urls = [\n      (item as { url?: unknown }).url,\n      (item as { requestURL?: unknown }).requestURL,\n      (item as { requestUrl?: unknown }).requestUrl,\n    ];\n    for (const url of urls) {\n      if (typeof url !== 'string') continue;\n      try {\n        const providerId = providerFromHost(new URL(url).hostname);\n        if (providerId) return providerId;\n      } catch {\n        // Not a parseable URL — try the other fields and causes.\n      }\n    }\n  }\n\n  for (const item of causeChain) {\n    const modelId = (item as { modelId?: unknown }).modelId;\n    if (typeof modelId !== 'string') continue;\n    const providerId = providerFromModelId(modelId);\n    if (providerId) return providerId;\n  }\n  return undefined;\n}\n\nfunction getTriedInstances(state: Record<string, unknown>): Set<string> {\n  const existing = state.triedInstances;\n  if (existing instanceof Set) return existing;\n  const created = new Set<string>();\n  state.triedInstances = created;\n  return created;\n}\n\nfunction getForcedRefreshInstances(state: Record<string, unknown>): Set<string> {\n  const existing = state.forcedAuthRefresh;\n  if (existing instanceof Set) return existing;\n  const created = new Set<string>();\n  state.forcedAuthRefresh = created;\n  return created;\n}\n\n/** Friendly names for the part/notice copy (display only — never auth data). */\nexport const PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n  anthropic: 'Anthropic',\n  'kimi-for-coding': 'Kimi',\n  'openai-codex': 'Codex',\n  'github-copilot': 'GitHub Copilot',\n  xai: 'xAI',\n};\n\nconst REASON_TEXT: Record<AccountSwitchPartData['reason'], string> = {\n  'rate-limit': 'rate limit',\n  'quota-exhausted': 'quota exhausted',\n  'auth-failed': 'auth failed',\n  'pool-exhausted': 'pool exhausted',\n  'persistent-outage': 'persistent outage',\n  'preferred-routing': 'subscription routing',\n};\n\n/** Validates untrusted `reason` values (e.g. persisted message parts). */\nexport function isAccountSwitchReason(value: unknown): value is AccountSwitchPartData['reason'] {\n  // Own-property check: `in` would accept prototype names like 'toString',\n  // which would then interpolate the inherited function into the notice text.\n  return typeof value === 'string' && Object.prototype.hasOwnProperty.call(REASON_TEXT, value);\n}\n\n/**\n * One-line transcript copy for a switch part. Shared by the live `info`\n * controller event (the TUI shows controller `info` events as transcript\n * lines, and no message event carries data parts mid-run) and by the TUI's\n * history rendering of the persisted part — one formatter, identical text.\n */\nexport function accountSwitchNoticeText(data: AccountSwitchPartData): string {\n  const provider = PROVIDER_DISPLAY_NAMES[data.provider] ?? data.provider;\n  const reason = REASON_TEXT[data.reason];\n  if (data.to === null) {\n    // A12: a targeted route reports *its* account, not the pool — the other\n    // subscriptions were never tried, so \"all accounts unavailable\" would be\n    // wrong and would read as if the pool had been walked.\n    if (data.exclusive) {\n      return `Pinned ${provider} account unavailable (${reason})`;\n    }\n    return `All ${provider} accounts unavailable (${reason})`;\n  }\n  const from = data.from?.label ?? 'unknown';\n  return `Switched ${provider} account: ${from} → ${data.to.label} (${reason})`;\n}\n\n/** Transcript line for a model-route hop; shared by the live info event and the TUI's history render. */\nexport function modelFallbackNoticeText(data: ModelFallbackPartData): string {\n  const reason = REASON_TEXT[data.reason] ?? data.reason;\n  return `Switched model route: ${data.from.label} → ${data.to.label} (${reason})`;\n}\n\n/**\n * Whether a persisted model-fallback reason is one this build understands.\n * `REASON_TEXT` also covers the account-switch reasons, so the notice text\n * alone would happily render a foreign value such as `rate-limit` as a\n * model-fallback reason; history parsed from another build's part must be\n * rejected instead.\n */\nexport function isModelFallbackReason(value: unknown): value is ModelFallbackPartData['reason'] {\n  return value === 'pool-exhausted' || value === 'persistent-outage';\n}\n\nasync function emitAccountSwitchPart(\n  args: Pick<ProcessAPIErrorArgs, 'writer' | 'requestContext'> | Pick<ProcessInputArgs, 'writer' | 'requestContext'>,\n  data: AccountSwitchPartData,\n): Promise<void> {\n  // Non-transient on purpose (contrast the transient tool-progress parts):\n  // switches must persist into the assistant message and render from history.\n  await args.writer?.custom({\n    type: ACCOUNT_SWITCH_PART_TYPE,\n    data,\n  });\n  // Data parts surface in the TUI only on history reload; emit the same line\n  // as a controller `info` event so the switch is visible live (precedent:\n  // emitTransientRetry emits controller events from the retry matcher).\n  const controllerContext = args.requestContext?.get('controller') as\n    | { emitEvent?: (event: { type: 'info'; message: string }) => void }\n    | undefined;\n  controllerContext?.emitEvent?.({ type: 'info', message: accountSwitchNoticeText(data) });\n}\n\n/**\n * Provider of the model the controller session is currently running — the\n * fallback identification path for errors that carry neither a request URL\n * nor a model id (e.g. `ProviderAuthRequiredError` thrown by a fetch wrapper\n * before any HTTP request exists).\n */\nfunction providerFromSession(\n  args: Pick<ProcessAPIErrorArgs, 'requestContext'> | Pick<ProcessInputArgs, 'requestContext'>,\n): string | undefined {\n  const controller = args.requestContext?.get('controller') as { session?: { modelId?: unknown } } | undefined;\n  const modelId = controller?.session?.modelId;\n  return typeof modelId === 'string' ? providerFromModelId(modelId) : undefined;\n}\n\n/**\n * Rotates the active OAuth account on classified API errors.\n *\n * Registered in `errorProcessors` AFTER `StreamErrorRetryProcessor` — a\n * transient error reaching this processor means the transient budget is\n * spent, which is exactly the hop condition. Implements `processAPIError`\n * ONLY (see the file header for the runner-order rationale).\n */\n/** Cached per-request model route cascade. */\ninterface ModelRouteCascade {\n  entries: Array<{ id: string; label: string; modelId: string; accountId?: string }>;\n  position: number;\n}\n\ninterface AccountRoute {\n  entryId: string;\n  modelId: string;\n  providerId: string;\n  accountId?: string;\n}\n\ntype RoutingProcessorArgs = Pick<ProcessAPIErrorArgs, 'requestContext' | 'state' | 'writer'> | ProcessInputArgs;\n\nexport type RoutingControllerContext = {\n  session?: { modelId?: unknown; modeId?: unknown };\n  threadId?: unknown;\n  getState?: () => Record<string, unknown>;\n  setState?: (updates: Record<string, unknown>) => Promise<void>;\n  getThreadSetting?: (key: string) => Promise<unknown>;\n  setThreadSetting?: (setting: { key: string; value: unknown }) => Promise<void>;\n  isThreadActive?: () => boolean;\n};\n\nfunction getRoutingController(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n): RoutingControllerContext | undefined {\n  return args.requestContext?.get('controller') as RoutingControllerContext | undefined;\n}\n\n/** A targeted route is exclusive; an entry without accountId uses automatic pool rotation. */\nfunction getRouteTargetAccountId(route: AccountRoute | null): string | undefined {\n  return route?.accountId;\n}\n\nfunction getRequestActiveAccount(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n  store: CredentialStore,\n  providerId: string,\n) {\n  if (isRequestAccountRoutingExhausted(args.requestContext, providerId)) return undefined;\n  const selectedId = getRequestAccountSelection(args.requestContext, providerId);\n  if (selectedId) return store.listAccounts?.(providerId).find(account => account.id === selectedId);\n  return store.getActiveAccount?.(providerId) ?? store.listAccounts?.(providerId).find(account => account.active);\n}\n\nfunction resolveAccountRoute(\n  args: Pick<RoutingProcessorArgs, 'requestContext'>,\n  explicit?: { id: string; modelId: string; accountId?: string },\n): AccountRoute | null {\n  const controller = getRoutingController(args);\n  const state = controller?.getState?.();\n  const pending = state?.mastracodePendingModelFallback as\n    | { toEntryId?: unknown; toModelId?: unknown; threadId?: unknown }\n    | null\n    | undefined;\n  const pendingMatchesThread =\n    pending &&\n    typeof pending.toEntryId === 'string' &&\n    typeof pending.toModelId === 'string' &&\n    (pending.threadId === undefined || pending.threadId === controller?.threadId);\n  const routeEntries = Array.isArray((state?.modelRoute as { entries?: unknown } | undefined)?.entries)\n    ? ((state?.modelRoute as { entries: Array<{ id?: unknown; modelId?: unknown; accountId?: unknown }> }).entries ??\n      [])\n    : [];\n  const entry = explicit\n    ? explicit\n    : pendingMatchesThread\n      ? routeEntries.find(candidate => candidate.id === pending.toEntryId && candidate.modelId === pending.toModelId)\n      : routeEntries.find(candidate => candidate.modelId === controller?.session?.modelId);\n  if (!entry || typeof entry.id !== 'string' || typeof entry.modelId !== 'string') return null;\n  const providerId = providerFromModelId(entry.modelId);\n  if (!providerId) return null;\n  return {\n    entryId: entry.id,\n    modelId: entry.modelId,\n    providerId,\n    ...(typeof entry.accountId === 'string' ? { accountId: entry.accountId } : {}),\n  };\n}\n\n/**\n * A14: `Automatic` rotation starts *at* the persisted active account and walks\n * insertion order from there, wrapping once. The active account is the cursor\n * rotation last left at, so a turn that starts at index 0 regardless would\n * re-activate and re-try an account the previous turn already moved past —\n * which is the whole job the removed sticky-exclusion set was doing badly.\n * With no persisted active account the order is plain insertion order.\n */\nfunction orderAccountsFromActive(accounts: OAuthAccountRecord[], activeId: string | undefined) {\n  const index = activeId === undefined ? -1 : accounts.findIndex(account => account.id === activeId);\n  if (index <= 0) return accounts;\n  return [...accounts.slice(index), ...accounts.slice(0, index)];\n}\n\nasync function applyPreferredAccountRoute(\n  args: RoutingProcessorArgs,\n  store: CredentialStore,\n  route: AccountRoute,\n): Promise<boolean> {\n  store.reload();\n  const preferredId = getRouteTargetAccountId(route);\n  const accounts = store.listAccounts?.(route.providerId) ?? [];\n  if (accounts.length === 0 && preferredId === undefined) return false;\n  const tried = getTriedInstances(args.state);\n  const unavailable = new Set(accounts.filter(account => tried.has(account.id)).map(account => account.id));\n  const active = getRequestActiveAccount(args, store, route.providerId) ?? store.getActiveAccount?.(route.providerId);\n  const selected = // A12: a targeted route may use only the account it names. `Automatic`\n    // keeps insertion order with full pool rotation (A10), starting from the\n    // account the cursor already points at (A14).\n    (\n      preferredId\n        ? accounts.filter(account => account.id === preferredId)\n        : orderAccountsFromActive(accounts, active?.id)\n    ).find(account => !unavailable.has(account.id));\n\n  for (const accountId of unavailable) tried.add(accountId);\n  if (!selected) {\n    markRequestAccountRoutingExhausted(args.requestContext, route.providerId);\n    return false;\n  }\n\n  if (active?.id === selected.id) {\n    setRequestAccountSelection(args.requestContext, route.providerId, selected.id);\n    return false;\n  }\n  // Activate before recording the request-scoped selection: a failed\n  // activation must not leave the selection claiming an account that never\n  // became the provider's active credential.\n  const activated = store.activateAccount ? store.activateAccount(route.providerId, selected.id) : selected;\n  if (!activated) {\n    // Only a targeted route is out of options here. The exhausted marker is\n    // request-wide and fails every credential read closed, so setting it for\n    // `Automatic` would stop error recovery from retrying on a survivor.\n    if (preferredId !== undefined) markRequestAccountRoutingExhausted(args.requestContext, route.providerId);\n    return false;\n  }\n  setRequestAccountSelection(args.requestContext, route.providerId, activated.id);\n\n  // Applying an explicit account choice is routine, not a failover notice.\n  if (preferredId === undefined) {\n    await emitAccountSwitchPart(args, {\n      provider: route.providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: { id: activated.id, label: activated.label },\n      reason: 'preferred-routing',\n      at: new Date().toISOString(),\n    });\n  }\n  return true;\n}\n\nexport class AccountRotationProcessor implements Processor {\n  readonly id = 'mastracode-account-rotation' as const;\n\n  constructor(\n    private readonly options: {\n      credentialStore: RotationCredentialStore;\n      maxProcessorRetries: number;\n      settingsPath?: string;\n    },\n  ) {}\n\n  async processAPIError(args: ProcessAPIErrorArgs): Promise<{ retry: boolean }> {\n    const { error, state } = args;\n\n    // Core runs error processors even after the shared retry budget is spent\n    // and silently discards `retry: true` then (llm-execution-step.ts\n    // canRetryError) — rotating the cursor or emitting a switch part for a\n    // retry that will never run would lie to both auth.json and the\n    // transcript. With a fallback chain configured, a bare `retry: false`\n    // here would silently advance the route for an error we never classified, so the\n    // chain gate surfaces the error instead.\n    if (args.retryCount >= this.options.maxProcessorRetries) {\n      await this.gateChainHop(args, error);\n      return { retry: false };\n    }\n\n    // Classify before attributing: an error from a provider outside the OAuth\n    // registry (API-key/router providers are valid route entries) still hops on\n    // rotate/hop classes — there is just no account cursor to advance.\n    const classification = classifyRotationError(error);\n    // Q14: 400/unknown errors never rotate and never advance routes. With a chain\n    // active, core's fallback array would still advance on a bare\n    // `retry: false` (it advances on any thrown non-TripWire error), so the\n    // gate converts that into a surfaced error instead of a silent hop.\n    if (classification.kind === 'never') {\n      await this.gateChainHop(args, error);\n      return { retry: false };\n    }\n\n    const cascade = await this.getModelRouteCascade(args);\n    const currentEntry = cascade?.entries[cascade.position];\n    const providerId =\n      providerFromError(error) ??\n      (currentEntry ? providerFromModelId(currentEntry.modelId) : undefined) ??\n      (cascade ? undefined : providerFromSession(args));\n    if (!providerId) {\n      await this.emitModelFallbackPart(args, classification.kind === 'hop' ? 'persistent-outage' : 'pool-exhausted');\n      return { retry: false };\n    }\n\n    // Deployed requests resolve the tenant-scoped store; local mode keeps the\n    // host storage. Reading the host registry here would rotate or announce\n    // host accounts for a tenant request. Annotated as the rotation surface:\n    // `resolveCredentialStore` returns a plain CredentialStore, and the 401\n    // path below uses the optional `forceRefreshActiveAccount` when the host\n    // provides it.\n    const store: RotationCredentialStore = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n    store.reload();\n    const accounts = store.listAccounts?.(providerId) ?? [];\n    const active = getRequestActiveAccount(args, store, providerId);\n    const route = currentEntry ? resolveAccountRoute(args, currentEntry) : resolveAccountRoute(args);\n\n    // Q7 bucket 2: force one refresh of the active instance before rotating.\n    // A 401 usually means a fresh-but-rejected token; the forced refresh\n    // covers server-side clock skew and refresh-token races. Success retries\n    // the same account — no rotation, no part. With no active account (e.g.\n    // `ProviderAuthRequiredError` from an empty registry) a refresh can never\n    // succeed, so skip it and fall through to the retry:false surface below,\n    // which rethrows the original auth error instead of a generic pool\n    // exhaustion message.\n    if (classification.kind === 'rotate' && classification.reason === 'auth-failed' && active) {\n      const forced = getForcedRefreshInstances(state);\n      const refreshKey = `${providerId}:${active?.id ?? 'active'}`;\n      if (!forced.has(refreshKey) && typeof store.forceRefreshActiveAccount === 'function') {\n        forced.add(refreshKey);\n        const token = await store.forceRefreshActiveAccount(providerId, active?.id);\n        if (token !== undefined) {\n          return { retry: true };\n        }\n      }\n    }\n\n    // A12: only a pin on the provider that actually failed makes this failure\n    // exclusive. `route.providerId` is derived from the route's model while\n    // `providerId` comes from the failed request's URL, which during a cascade\n    // can still describe the session model rather than the entry being retried;\n    // when they differ the pin belongs to an unrelated route, so the provider\n    // that failed keeps its normal pool handling.\n    const targetAccountId = route?.providerId === providerId ? getRouteTargetAccountId(route) : undefined;\n\n    if (classification.kind === 'hop') {\n      return this.declarePoolUnavailable(args, providerId, 'persistent-outage', targetAccountId !== undefined);\n    }\n\n    // A12: a targeted route never activates a sibling subscription. A\n    // rotate-classified failure on the account the route selected proceeds to\n    // the model route instead — the request hops, it does not spill\n    // onto another subscription's quota. A targeted route has nothing to\n    // rotate to at any pool size. A stale id for an account the user removed\n    // reads the same way: fail closed rather than silently land on a sibling.\n    if (targetAccountId !== undefined) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted', true);\n    }\n\n    // Count only this provider's instances: `tried` spans the whole request\n    // (a cascade can visit several providers), so comparing its raw size to\n    // this provider's account count would falsely report exhaustion when an\n    // earlier provider in the same request already used up accounts.\n    const tried = getTriedInstances(state);\n    if (active) tried.add(active.id);\n    // The tried-set is request-global and shared across providers after a\n    // route hop, so exhaustion must count only this provider's ids.\n    const triedForProvider = accounts.filter(account => tried.has(account.id)).length;\n    if (triedForProvider >= accounts.length) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted');\n    }\n\n    // If the selected account was removed elsewhere, even a single survivor\n    // is still untried. Resume from the freshly loaded global cursor.\n    const candidates = active ? accounts : orderAccountsFromActive(accounts, store.getActiveAccount?.(providerId)?.id);\n    const nextCandidate = candidates.find(account => !tried.has(account.id));\n\n    const next = nextCandidate ? store.activateAccount?.(providerId, nextCandidate.id) : undefined;\n    if (!next) {\n      return this.declarePoolUnavailable(args, providerId, 'pool-exhausted');\n    }\n    setRequestAccountSelection(args.requestContext, providerId, next.id);\n    tried.add(next.id);\n\n    // The retry replays the request from scratch (Q10): rotate the assistant\n    // message id so the retried response starts a fresh message instead of\n    // appending to the partially streamed one.\n    args.rotateResponseMessageId?.();\n\n    await emitAccountSwitchPart(args, {\n      provider: providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: { id: next.id, label: next.label },\n      reason: classification.reason,\n      at: new Date().toISOString(),\n    });\n\n    return { retry: true };\n  }\n\n  /**\n   * Resolve the request's host-supplied model route once and cache the reachable\n   * prefix in processor state. Resolution mirrors getDynamicModel so a hop is\n   * never announced for an entry core cannot reach.\n   */\n  private async getModelRouteCascade(args: ProcessAPIErrorArgs): Promise<ModelRouteCascade | null> {\n    if (args.state.modelRouteCascade !== undefined) {\n      return (args.state.modelRouteCascade as ModelRouteCascade | null) ?? null;\n    }\n    const controller = getRoutingController(args);\n    const state = controller?.getState?.();\n    const route = (\n      state?.modelRoute as\n        | { entries?: Array<{ id?: unknown; label?: unknown; modelId?: unknown; accountId?: unknown }> }\n        | undefined\n    )?.entries;\n    const pending = state?.mastracodePendingModelFallback as\n      | { toEntryId?: unknown; threadId?: unknown }\n      | null\n      | undefined;\n    const pendingMatchesThread =\n      pending &&\n      typeof pending.toEntryId === 'string' &&\n      (pending.threadId === undefined || pending.threadId === controller?.threadId);\n    const startIndex = pendingMatchesThread\n      ? route?.findIndex(entry => entry.id === pending.toEntryId)\n      : route?.findIndex(entry => entry.modelId === controller?.session?.modelId);\n    if (!route || startIndex === undefined || startIndex < 0 || route.length - startIndex < 2) {\n      args.state.modelRouteCascade = null;\n      return null;\n    }\n\n    const thinkingLevel = resolveRequestThinkingLevel(\n      {\n        state: { thinkingLevel: state?.thinkingLevel },\n        session: { modeId: typeof controller?.session?.modeId === 'string' ? controller.session.modeId : 'build' },\n      },\n      this.options.settingsPath,\n    );\n    const entries: ModelRouteCascade['entries'] = [];\n    for (const entry of route.slice(startIndex)) {\n      if (\n        typeof entry.id !== 'string' ||\n        entry.id.length === 0 ||\n        typeof entry.modelId !== 'string' ||\n        entry.modelId.length === 0\n      ) {\n        break;\n      }\n      if (entries.length > 0) {\n        try {\n          resolveModel(entry.modelId, {\n            thinkingLevel,\n            remapForCodexOAuth: true,\n            requestContext: args.requestContext,\n          });\n        } catch {\n          break;\n        }\n      }\n      entries.push({\n        id: entry.id,\n        label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.id,\n        modelId: entry.modelId,\n        ...(typeof entry.accountId === 'string' ? { accountId: entry.accountId } : {}),\n      });\n    }\n    if (entries.length < 2) {\n      args.state.modelRouteCascade = null;\n      return null;\n    }\n    const cascade: ModelRouteCascade = { entries, position: 0 };\n    args.state.modelRouteCascade = cascade;\n    return cascade;\n  }\n\n  /**\n   * Q14 gate: 400/unknown/unattributable errors never advance routes. Core's\n   * fallback array advances on ANY thrown error except TripWire\n   * (llm-execution-step.ts), so when the session route has another entry and the\n   * current entry is non-last, a bare `retry: false` would silently hop on an\n   * error class the user excluded from hop triggers. TripWire is the only\n   * no-advance escape: the runner rethrows it and the fallback loop declines\n   * to advance. No chain (or already on the last entry) → return and let the\n   * plain `retry: false` surface the error exactly as before.\n   */\n  private async gateChainHop(args: ProcessAPIErrorArgs, error: unknown): Promise<void> {\n    const cascade = await this.getModelRouteCascade(args);\n    if (!cascade) return;\n    if (cascade.position >= cascade.entries.length - 1) return;\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new TripWire(reason, {}, this.id);\n  }\n\n  /** Announce and persist the next model-route hop before core advances. */\n  private async emitModelFallbackPart(\n    args: ProcessAPIErrorArgs,\n    reason: 'pool-exhausted' | 'persistent-outage',\n  ): Promise<void> {\n    const cascade = await this.getModelRouteCascade(args);\n    if (!cascade) return;\n\n    const from = cascade.entries[cascade.position];\n    const to = cascade.entries[cascade.position + 1];\n    if (!from || !to) return;\n\n    const controller = args.requestContext?.get('controller') as\n      | {\n          threadId?: unknown;\n          setState?: (updates: Record<string, unknown>) => Promise<void>;\n          setThreadSetting?: (setting: { key: string; value: unknown }) => Promise<void>;\n          emitEvent?: (event: { type: 'info'; message: string }) => void;\n        }\n      | undefined;\n    const at = new Date().toISOString();\n    const threadId = typeof controller?.threadId === 'string' ? controller.threadId : undefined;\n    const pending = {\n      fromEntryId: from.id,\n      toEntryId: to.id,\n      toModelId: to.modelId,\n      ...(threadId ? { threadId } : {}),\n      reason,\n      at,\n    } satisfies PendingModelFallback;\n    await controller?.setThreadSetting?.({ key: MODEL_FALLBACK_STATE_KEY, value: pending });\n    const data: ModelFallbackPartData = {\n      from: { entryId: from.id, label: from.label },\n      to: { entryId: to.id, label: to.label },\n      reason,\n      at,\n    };\n    try {\n      await args.writer?.custom({ type: MODEL_FALLBACK_PART_TYPE, data });\n    } catch (error) {\n      await controller?.setThreadSetting?.({ key: MODEL_FALLBACK_STATE_KEY, value: undefined });\n      throw error;\n    }\n    await controller?.setState?.({ [MODEL_FALLBACK_STATE_KEY]: pending });\n    args.state.startNoticeEmitted = false;\n    const targetRoute = resolveAccountRoute(args, to);\n    if (targetRoute) {\n      const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n      await applyPreferredAccountRoute(args, store, targetRoute).catch(() => undefined);\n    }\n    controller?.emitEvent?.({ type: 'info', message: modelFallbackNoticeText(data) });\n    cascade.position++;\n  }\n\n  /**\n   * Pool done for this request: every instance recorded in the tried-set and\n   * a `to: null` part emitted. Returns `retry: false` so core's fallback\n   * array can hop to the next route entry (announced by `emitModelFallbackPart`).\n   * Silent on the account part when the provider has no registry at all —\n   * there are no accounts to declare unavailable, but the hop still applies.\n   */\n  private async declarePoolUnavailable(\n    args: ProcessAPIErrorArgs,\n    providerId: string,\n    reason: 'pool-exhausted' | 'persistent-outage',\n    exclusive = false,\n  ): Promise<{ retry: boolean }> {\n    const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n    const accounts = store.listAccounts?.(providerId) ?? [];\n    if (accounts.length === 0) {\n      // No account registry (API-key-only provider): nothing rotated, but the\n      // hop still happens — announce the model fallback before core advances.\n      await this.emitModelFallbackPart(args, reason);\n      return { retry: false };\n    }\n\n    const tried = getTriedInstances(args.state);\n    for (const account of accounts) tried.add(account.id);\n\n    const active = getRequestActiveAccount(args, store, providerId);\n\n    await emitAccountSwitchPart(args, {\n      provider: providerId,\n      from: active ? { id: active.id, label: active.label } : null,\n      to: null,\n      reason,\n      at: new Date().toISOString(),\n      ...(exclusive ? { exclusive: true } : {}),\n    });\n\n    await this.emitModelFallbackPart(args, reason);\n\n    return { retry: false };\n  }\n}\n\n/**\n * Applies the pack's preferred account route once per request, before the\n * first model call. Without a route it only reloads the credential store so\n * the request sees accounts changed by other processes.\n *\n * TYPE CONSTRAINT: this class must NEVER implement `processAPIError`. It\n * lives in `inputProcessors`; the runner walks input processors first when\n * running `processAPIError`, so adding the method here would classify and\n * rotate errors BEFORE `StreamErrorRetryProcessor`'s transient retries run.\n */\nexport class AccountStartNoticeProcessor implements Processor {\n  readonly id = 'mastracode-account-start-notice' as const;\n\n  constructor(private readonly options: { credentialStore: CredentialStore }) {}\n\n  async processInput(args: ProcessInputArgs): Promise<ProcessInputResult> {\n    if (args.state.startNoticeEmitted) return args.messageList;\n\n    // Deployed requests resolve the tenant-scoped store so host accounts are\n    // never listed, activated, or announced for a tenant run. Local mode keeps\n    // the constructor's storage.\n    const store = resolveCredentialStore(args.requestContext) ?? this.options.credentialStore;\n\n    const route = resolveAccountRoute(args);\n    if (!route) {\n      store.reload();\n      return args.messageList;\n    }\n\n    // A14: a route whose accounts are all unavailable is not a pre-emptive\n    // abort. `applyPreferredAccountRoute` marks the provider on the request so\n    // credential reads fail closed rather than falling through to the active\n    // account, and the request then runs and fails at the provider — which is\n    // what lets the error lane classify it and hand the turn to the route's\n    // configured fallback chain. The removed persisted set threw here instead,\n    // before any socket opened, so the chain was never reached.\n    const switched = await applyPreferredAccountRoute(args, store, route);\n    if (switched || getRouteTargetAccountId(route) !== undefined) {\n      args.state.startNoticeEmitted = true;\n    }\n    return args.messageList;\n  }\n}\n"],"mappings":"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"}

package/dist/auth/types.d.ts

@@ -119,6 +119,13 @@ export type AuthStorageData = Record<string, AuthCredential | OAuthAccountRecord
 export interface CredentialStore {
     /** Whether model resolution may fall back to process environment credentials. */
     readonly allowEnvironmentFallback?: boolean;
+    /**
+     * Whether `provider` may authenticate with credentials the server process
+     * supplies (an operator opt-in), even when `allowEnvironmentFallback` is
+     * false. Used by gateways whose auth is process-scoped by design, such as
+     * Amazon Bedrock's AWS credential chain.
+     */
+    allowsDeploymentCredentials?(provider: string): boolean;
     /** Refresh any cached view (no-op for sources that are always fresh). */
     reload(): void;
     /** Credential in the provider's main slot (`anthropic`, `openai-codex`, …). */

package/dist/auth/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE7C,wDAAwD;IACxD,KAAK,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjE,yEAAyE;IACzE,YAAY,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEvE,6DAA6D;IAC7D,SAAS,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAEjD;;;OAGG;IACH,eAAe,CAAC,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE7E;;;;;;;;;OASG;IACH,kBAAkB,CAAC,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,gBAAgB,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG;IACtD,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAAC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,yEAAyE;IACzE,MAAM,IAAI,IAAI,CAAC;IACf,+EAA+E;IAC/E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAClD,uDAAuD;IACvD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtD;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrF;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;IAEhH;;;OAGG;IACH,YAAY,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAExD,kEAAkE;IAClE,gBAAgB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAEtE;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE1F,mFAAmF;IACnF,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"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"}

package/dist/headless/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/headless/cli.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAsC9D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA+BzC;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACzD,OAAO,CAAC,KAAK,CAAC,CA8IhB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/headless/cli.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAsC9D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA+BzC;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACzD,OAAO,CAAC,KAAK,CAAC,CAoJhB"}

package/dist/headless/cli.js

@@ -192,6 +192,9 @@ async function runMCCli(predrainedInput, options) {
 	} finally {
 		releaseAllThreadLocks();
 		if (boot) {
+			try {
+				boot.releaseThreadClaims();
+			} catch {}
 			try {
 				boot.stopPluginSignalProviders();
 			} catch {}

package/dist/headless/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../../src/headless/cli.ts"],"sourcesContent":["/**\n * CLI adapter for headless MastraCode runs.\n *\n * This is the only headless layer that touches the process: it parses argv,\n * reads stdin, bootstraps MastraCode via `createMastraCode`, drives `runMC`,\n * renders events/results to stdout/stderr through the pure formatters, maps the\n * result to an exit code, and owns teardown + `process.exit`.\n */\nimport { existsSync } from 'node:fs';\nimport { parseArgs } from 'node:util';\n\nimport { createMastraCode } from '../index.js';\nimport { listBuiltinModePacks } from '../onboarding/packs.js';\nimport { loadSettings, resolveModelDefaults } from '../onboarding/settings.js';\nimport {\n  createProcessMemoryDiagnosticsFromEnvironment,\n  startConfiguredProcessMemoryDiagnostics,\n  stopProcessMemoryDiagnosticsWithTimeout,\n} from '../process-memory-diagnostics.js';\nimport { setupDebugLogging } from '../utils/debug-log.js';\nimport { releaseAllThreadLocks } from '../utils/thread-lock.js';\n\nimport { buildParseArgsOptions, FLAGS, renderFlagUsage } from './flags.js';\nimport { createHumanFormatState, formatHuman, formatJsonl, renderJsonResult } from './format.js';\nimport { permissionModeToPolicy } from './policy.js';\nimport { runMC } from './run-mc.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\n\n/** Consolidated output mode (replaces the old `--format` + `--output-format`). */\nexport type OutputMode = 'human' | 'json' | 'jsonl';\n\nexport interface HeadlessArgs {\n  prompt?: string;\n  /** Timeout in seconds (CLI surface); converted to ms before `runMC`. */\n  timeout?: number;\n  output: OutputMode;\n  continue_: boolean;\n  model?: string;\n  mode?: RunMode;\n  thinkingLevel?: ThinkingLevel;\n  settings?: string;\n  thread?: string;\n  title?: string;\n  cloneThread: boolean;\n  resourceId?: string;\n  /** Max agentic turns before the run aborts with exit code 1. */\n  maxTurns?: number;\n  /** Named permission mode resolving to a built-in policy. Defaults to `auto`. */\n  permissionMode?: PermissionMode;\n}\n\nconst parseArgsOptions = buildParseArgsOptions();\nconst STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS = 2_000;\n\n/**\n * Returns true if `argv` selects headless mode. This must agree with what\n * {@link parseHeadlessArgs} (and `runMCCli`) accept as a prompt: `--prompt`/`-p`\n * or a bare positional prompt (e.g. `mastracode \"Fix the bug\"`). Note that a\n * prompt piped via stdin without a flag is handled separately by the caller.\n */\nexport function hasHeadlessFlag(argv: string[]): boolean {\n  if (argv.some(a => a === '--prompt' || a === '-p')) return true;\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv.slice(2),\n      options: parseArgsOptions,\n      strict: false,\n      allowPositionals: true,\n    });\n    // A positional prompt only counts when not asking for help.\n    return positionals.length > 0 && !values.help;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse CLI arguments for headless mode. The flag table in `flags.ts` is the\n * single source of truth: each flag carries its own coercion/validation, so this\n * function just walks {@link FLAGS} and assembles the typed {@link HeadlessArgs}.\n */\nexport function parseHeadlessArgs(argv: string[]): HeadlessArgs {\n  const { values, positionals } = parseArgs({\n    args: argv.slice(2),\n    options: parseArgsOptions,\n    strict: false,\n    allowPositionals: true,\n  });\n\n  // Seed defaults; per-flag values below override these.\n  const args: HeadlessArgs = {\n    output: 'human',\n    continue_: false,\n    cloneThread: false,\n  };\n  const sink = args as unknown as Record<string, unknown>;\n\n  for (const flag of FLAGS) {\n    if (!flag.field) continue; // e.g. --help, handled by the caller\n    const raw = values[flag.key];\n    if (raw === undefined) continue;\n\n    if (flag.type === 'boolean') {\n      sink[flag.field] = Boolean(raw);\n    } else if (typeof raw === 'string') {\n      sink[flag.field] = flag.coerce ? flag.coerce(raw) : raw;\n    }\n  }\n\n  // A bare positional acts as the prompt when --prompt/-p is absent.\n  if (args.prompt === undefined && positionals[0] !== undefined) {\n    args.prompt = positionals[0];\n  }\n\n  if (args.continue_ && args.thread) {\n    throw new Error('--continue and --thread cannot be used together');\n  }\n\n  return args;\n}\n\nexport function printHeadlessUsage(): void {\n  process.stdout.write(`\nUsage: mastracode --prompt <text> [options]\n\nHeadless (non-interactive) mode options:\n${renderFlagUsage()}\n\nThread behavior:\n  By default, a new thread is created for each run.\n  Use --continue to resume the most recent thread, or --thread to target a specific one.\n  Use --clone-thread to branch off a copy before running.\n\nSettings file:\n  Uses the same settings.json as the interactive TUI. Pass --settings to use\n  a custom settings file (e.g., settings-ci.json for CI). All model, pack,\n  subagent, and OM configuration is resolved from settings at startup.\n\nExit codes:\n  0  Agent completed successfully\n  1  Error, aborted, or max turns reached\n  2  Timeout\n\nExamples:\n  mastracode --prompt \"Fix the bug in auth.ts\"\n  mastracode --prompt \"Add tests\" --timeout 300 --output json\n  mastracode --prompt \"Refactor\" --output jsonl\n  mastracode --prompt \"Review this PR\" --permission-mode deny --max-turns 10\n  mastracode --settings ./settings-ci.json --prompt \"Run tests\"\n  mastracode -c --prompt \"Continue where you left off\"\n  echo \"Summarize the repo\" | mastracode --prompt -\n`);\n}\n\n/**\n * Headless CLI entry point: parse arguments, read stdin, initialize MastraCode,\n * run via `runMC`, render output, and exit with the mapped code.\n */\nexport async function runMCCli(\n  predrainedInput?: string | null,\n  options?: { coAuthor?: { name?: string; email?: string } },\n): Promise<never> {\n  if (process.argv.includes('--help') || process.argv.includes('-h')) {\n    printHeadlessUsage();\n    process.exit(0);\n  }\n\n  let args: HeadlessArgs;\n  try {\n    args = parseHeadlessArgs(process.argv);\n  } catch (e) {\n    process.stderr.write(`Error: ${(e as Error).message}\\n`);\n    process.exit(1);\n  }\n\n  let prompt = args.prompt;\n  if (predrainedInput !== undefined) {\n    prompt = predrainedInput ?? '';\n  } else if (prompt === '-' || (!prompt && !process.stdin.isTTY)) {\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk as Buffer);\n    }\n    prompt = Buffer.concat(chunks).toString('utf-8').trim();\n  }\n\n  if (!prompt) {\n    printHeadlessUsage();\n    process.stderr.write('Error: --prompt is required (or pipe via stdin)\\n');\n    process.exit(1);\n  }\n\n  if (args.settings && !existsSync(args.settings)) {\n    process.stderr.write(`Error: Settings file not found: ${args.settings}\\n`);\n    process.exit(1);\n  }\n\n  const diagnosticsSetup = createProcessMemoryDiagnosticsFromEnvironment(process.env);\n  const processMemoryDiagnostics = await startConfiguredProcessMemoryDiagnostics(diagnosticsSetup, warning => {\n    process.stderr.write(`Warning: ${warning}\\n`);\n  });\n\n  let boot: Awaited<ReturnType<typeof createMastraCode>> | undefined;\n  // Default to a non-zero exit so an unexpected throw before the run resolves\n  // still surfaces as a failure to the caller / CI.\n  let exitCode = 1;\n  try {\n    boot = await createMastraCode({ settingsPath: args.settings, coAuthor: options?.coAuthor });\n    const { controller, session, mcpManager } = boot;\n    const effectiveDefaults = resolveModelDefaults(loadSettings(args.settings), listBuiltinModePacks());\n\n    if (mcpManager?.hasServers()) {\n      try {\n        await mcpManager.initInBackground();\n      } catch (err) {\n        process.stderr.write(`Warning: MCP server initialization failed: ${(err as Error).message ?? err}\\n`);\n      }\n    }\n\n    setupDebugLogging();\n\n    const humanState = createHumanFormatState();\n    const run = runMC({\n      controller,\n      session,\n      prompt,\n      model: args.model,\n      mode: args.mode,\n      modeDefaults: effectiveDefaults,\n      thinkingLevel: args.thinkingLevel,\n      thread: { id: args.thread, continueLatest: args.continue_, clone: args.cloneThread },\n      resourceId: args.resourceId,\n      title: args.title,\n      timeoutMs: args.timeout ? args.timeout * 1000 : undefined,\n      maxTurns: args.maxTurns,\n      policy: args.permissionMode ? permissionModeToPolicy(args.permissionMode) : undefined,\n    });\n\n    // Stream live events for human + jsonl modes. (json mode prints only the final object.)\n    for await (const event of run) {\n      if (args.output === 'human') {\n        const out = formatHuman(event, humanState);\n        if (out.stdout) process.stdout.write(out.stdout);\n        if (out.stderr) process.stderr.write(out.stderr);\n      } else if (args.output === 'jsonl') {\n        process.stdout.write(JSON.stringify(formatJsonl(event)) + '\\n');\n      }\n    }\n\n    const result = await run.result;\n    exitCode = result.exitCode;\n\n    if (args.output === 'json') {\n      process.stdout.write(renderJsonResult(result));\n    } else if (args.output === 'jsonl') {\n      process.stdout.write(JSON.stringify({ type: 'result', ...result }) + '\\n');\n    }\n\n    if (result.status === 'timeout') {\n      process.stderr.write(`\\nTimeout elapsed. Aborted.\\n`);\n    } else if (result.error && args.output === 'human') {\n      process.stderr.write(`Error: ${result.error.message}\\n`);\n    }\n  } catch (err) {\n    process.stderr.write(`Error: ${(err as Error).message ?? err}\\n`);\n    exitCode = 1;\n  } finally {\n    // --- Teardown (always runs, even on a thrown error) ---\n    releaseAllThreadLocks();\n    if (boot) {\n      // Stop plugin-contributed signal providers (and the plugin reload listener)\n      // before quiescing workers: a provider that keeps polling past this point\n      // could dispatch into a controller that is shutting down.\n      try {\n        boot.stopPluginSignalProviders();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      const { controller, mcpManager } = boot;\n      // Release notification dispatch leases before the pubsub that holds them\n      // closes. Headless has no shutdown deadline, so don't let a stalled\n      // in-flight dispatch hold up exit.\n      await Promise.race([\n        boot.stopNotificationDispatch?.().catch(() => {}),\n        new Promise<void>(resolve => setTimeout(resolve, STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS).unref()),\n      ]);\n      await Promise.allSettled([\n        mcpManager?.disconnect(),\n        controller.getMastra()?.stopWorkers(),\n        controller.stopIntervals(),\n      ]);\n      // The signals pubsub is Mastra's event bus, so close it after the workers\n      // stop. Call close() on the object; a detached method loses `this` and\n      // rejects silently, leaving socket files behind.\n      const signalsPubSub = boot.signalsPubSub as { close?: () => Promise<void> | void } | undefined;\n      await Promise.allSettled([signalsPubSub?.close?.()]);\n    }\n    await stopProcessMemoryDiagnosticsWithTimeout(processMemoryDiagnostics, warning => {\n      process.stderr.write(`Warning: ${warning}\\n`);\n    });\n  }\n\n  process.exit(exitCode);\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../../src/headless/cli.ts"],"sourcesContent":["/**\n * CLI adapter for headless MastraCode runs.\n *\n * This is the only headless layer that touches the process: it parses argv,\n * reads stdin, bootstraps MastraCode via `createMastraCode`, drives `runMC`,\n * renders events/results to stdout/stderr through the pure formatters, maps the\n * result to an exit code, and owns teardown + `process.exit`.\n */\nimport { existsSync } from 'node:fs';\nimport { parseArgs } from 'node:util';\n\nimport { createMastraCode } from '../index.js';\nimport { listBuiltinModePacks } from '../onboarding/packs.js';\nimport { loadSettings, resolveModelDefaults } from '../onboarding/settings.js';\nimport {\n  createProcessMemoryDiagnosticsFromEnvironment,\n  startConfiguredProcessMemoryDiagnostics,\n  stopProcessMemoryDiagnosticsWithTimeout,\n} from '../process-memory-diagnostics.js';\nimport { setupDebugLogging } from '../utils/debug-log.js';\nimport { releaseAllThreadLocks } from '../utils/thread-lock.js';\n\nimport { buildParseArgsOptions, FLAGS, renderFlagUsage } from './flags.js';\nimport { createHumanFormatState, formatHuman, formatJsonl, renderJsonResult } from './format.js';\nimport { permissionModeToPolicy } from './policy.js';\nimport { runMC } from './run-mc.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\n\n/** Consolidated output mode (replaces the old `--format` + `--output-format`). */\nexport type OutputMode = 'human' | 'json' | 'jsonl';\n\nexport interface HeadlessArgs {\n  prompt?: string;\n  /** Timeout in seconds (CLI surface); converted to ms before `runMC`. */\n  timeout?: number;\n  output: OutputMode;\n  continue_: boolean;\n  model?: string;\n  mode?: RunMode;\n  thinkingLevel?: ThinkingLevel;\n  settings?: string;\n  thread?: string;\n  title?: string;\n  cloneThread: boolean;\n  resourceId?: string;\n  /** Max agentic turns before the run aborts with exit code 1. */\n  maxTurns?: number;\n  /** Named permission mode resolving to a built-in policy. Defaults to `auto`. */\n  permissionMode?: PermissionMode;\n}\n\nconst parseArgsOptions = buildParseArgsOptions();\nconst STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS = 2_000;\n\n/**\n * Returns true if `argv` selects headless mode. This must agree with what\n * {@link parseHeadlessArgs} (and `runMCCli`) accept as a prompt: `--prompt`/`-p`\n * or a bare positional prompt (e.g. `mastracode \"Fix the bug\"`). Note that a\n * prompt piped via stdin without a flag is handled separately by the caller.\n */\nexport function hasHeadlessFlag(argv: string[]): boolean {\n  if (argv.some(a => a === '--prompt' || a === '-p')) return true;\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv.slice(2),\n      options: parseArgsOptions,\n      strict: false,\n      allowPositionals: true,\n    });\n    // A positional prompt only counts when not asking for help.\n    return positionals.length > 0 && !values.help;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse CLI arguments for headless mode. The flag table in `flags.ts` is the\n * single source of truth: each flag carries its own coercion/validation, so this\n * function just walks {@link FLAGS} and assembles the typed {@link HeadlessArgs}.\n */\nexport function parseHeadlessArgs(argv: string[]): HeadlessArgs {\n  const { values, positionals } = parseArgs({\n    args: argv.slice(2),\n    options: parseArgsOptions,\n    strict: false,\n    allowPositionals: true,\n  });\n\n  // Seed defaults; per-flag values below override these.\n  const args: HeadlessArgs = {\n    output: 'human',\n    continue_: false,\n    cloneThread: false,\n  };\n  const sink = args as unknown as Record<string, unknown>;\n\n  for (const flag of FLAGS) {\n    if (!flag.field) continue; // e.g. --help, handled by the caller\n    const raw = values[flag.key];\n    if (raw === undefined) continue;\n\n    if (flag.type === 'boolean') {\n      sink[flag.field] = Boolean(raw);\n    } else if (typeof raw === 'string') {\n      sink[flag.field] = flag.coerce ? flag.coerce(raw) : raw;\n    }\n  }\n\n  // A bare positional acts as the prompt when --prompt/-p is absent.\n  if (args.prompt === undefined && positionals[0] !== undefined) {\n    args.prompt = positionals[0];\n  }\n\n  if (args.continue_ && args.thread) {\n    throw new Error('--continue and --thread cannot be used together');\n  }\n\n  return args;\n}\n\nexport function printHeadlessUsage(): void {\n  process.stdout.write(`\nUsage: mastracode --prompt <text> [options]\n\nHeadless (non-interactive) mode options:\n${renderFlagUsage()}\n\nThread behavior:\n  By default, a new thread is created for each run.\n  Use --continue to resume the most recent thread, or --thread to target a specific one.\n  Use --clone-thread to branch off a copy before running.\n\nSettings file:\n  Uses the same settings.json as the interactive TUI. Pass --settings to use\n  a custom settings file (e.g., settings-ci.json for CI). All model, pack,\n  subagent, and OM configuration is resolved from settings at startup.\n\nExit codes:\n  0  Agent completed successfully\n  1  Error, aborted, or max turns reached\n  2  Timeout\n\nExamples:\n  mastracode --prompt \"Fix the bug in auth.ts\"\n  mastracode --prompt \"Add tests\" --timeout 300 --output json\n  mastracode --prompt \"Refactor\" --output jsonl\n  mastracode --prompt \"Review this PR\" --permission-mode deny --max-turns 10\n  mastracode --settings ./settings-ci.json --prompt \"Run tests\"\n  mastracode -c --prompt \"Continue where you left off\"\n  echo \"Summarize the repo\" | mastracode --prompt -\n`);\n}\n\n/**\n * Headless CLI entry point: parse arguments, read stdin, initialize MastraCode,\n * run via `runMC`, render output, and exit with the mapped code.\n */\nexport async function runMCCli(\n  predrainedInput?: string | null,\n  options?: { coAuthor?: { name?: string; email?: string } },\n): Promise<never> {\n  if (process.argv.includes('--help') || process.argv.includes('-h')) {\n    printHeadlessUsage();\n    process.exit(0);\n  }\n\n  let args: HeadlessArgs;\n  try {\n    args = parseHeadlessArgs(process.argv);\n  } catch (e) {\n    process.stderr.write(`Error: ${(e as Error).message}\\n`);\n    process.exit(1);\n  }\n\n  let prompt = args.prompt;\n  if (predrainedInput !== undefined) {\n    prompt = predrainedInput ?? '';\n  } else if (prompt === '-' || (!prompt && !process.stdin.isTTY)) {\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk as Buffer);\n    }\n    prompt = Buffer.concat(chunks).toString('utf-8').trim();\n  }\n\n  if (!prompt) {\n    printHeadlessUsage();\n    process.stderr.write('Error: --prompt is required (or pipe via stdin)\\n');\n    process.exit(1);\n  }\n\n  if (args.settings && !existsSync(args.settings)) {\n    process.stderr.write(`Error: Settings file not found: ${args.settings}\\n`);\n    process.exit(1);\n  }\n\n  const diagnosticsSetup = createProcessMemoryDiagnosticsFromEnvironment(process.env);\n  const processMemoryDiagnostics = await startConfiguredProcessMemoryDiagnostics(diagnosticsSetup, warning => {\n    process.stderr.write(`Warning: ${warning}\\n`);\n  });\n\n  let boot: Awaited<ReturnType<typeof createMastraCode>> | undefined;\n  // Default to a non-zero exit so an unexpected throw before the run resolves\n  // still surfaces as a failure to the caller / CI.\n  let exitCode = 1;\n  try {\n    boot = await createMastraCode({ settingsPath: args.settings, coAuthor: options?.coAuthor });\n    const { controller, session, mcpManager } = boot;\n    const effectiveDefaults = resolveModelDefaults(loadSettings(args.settings), listBuiltinModePacks());\n\n    if (mcpManager?.hasServers()) {\n      try {\n        await mcpManager.initInBackground();\n      } catch (err) {\n        process.stderr.write(`Warning: MCP server initialization failed: ${(err as Error).message ?? err}\\n`);\n      }\n    }\n\n    setupDebugLogging();\n\n    const humanState = createHumanFormatState();\n    const run = runMC({\n      controller,\n      session,\n      prompt,\n      model: args.model,\n      mode: args.mode,\n      modeDefaults: effectiveDefaults,\n      thinkingLevel: args.thinkingLevel,\n      thread: { id: args.thread, continueLatest: args.continue_, clone: args.cloneThread },\n      resourceId: args.resourceId,\n      title: args.title,\n      timeoutMs: args.timeout ? args.timeout * 1000 : undefined,\n      maxTurns: args.maxTurns,\n      policy: args.permissionMode ? permissionModeToPolicy(args.permissionMode) : undefined,\n    });\n\n    // Stream live events for human + jsonl modes. (json mode prints only the final object.)\n    for await (const event of run) {\n      if (args.output === 'human') {\n        const out = formatHuman(event, humanState);\n        if (out.stdout) process.stdout.write(out.stdout);\n        if (out.stderr) process.stderr.write(out.stderr);\n      } else if (args.output === 'jsonl') {\n        process.stdout.write(JSON.stringify(formatJsonl(event)) + '\\n');\n      }\n    }\n\n    const result = await run.result;\n    exitCode = result.exitCode;\n\n    if (args.output === 'json') {\n      process.stdout.write(renderJsonResult(result));\n    } else if (args.output === 'jsonl') {\n      process.stdout.write(JSON.stringify({ type: 'result', ...result }) + '\\n');\n    }\n\n    if (result.status === 'timeout') {\n      process.stderr.write(`\\nTimeout elapsed. Aborted.\\n`);\n    } else if (result.error && args.output === 'human') {\n      process.stderr.write(`Error: ${result.error.message}\\n`);\n    }\n  } catch (err) {\n    process.stderr.write(`Error: ${(err as Error).message ?? err}\\n`);\n    exitCode = 1;\n  } finally {\n    // --- Teardown (always runs, even on a thrown error) ---\n    releaseAllThreadLocks();\n    if (boot) {\n      // Stop plugin-contributed signal providers (and the plugin reload listener)\n      // before quiescing workers: a provider that keeps polling past this point\n      // could dispatch into a controller that is shutting down. Release thread\n      // claims first so a restarted process need not wait out this teardown.\n      try {\n        boot.releaseThreadClaims();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      try {\n        boot.stopPluginSignalProviders();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      const { controller, mcpManager } = boot;\n      // Release notification dispatch leases before the pubsub that holds them\n      // closes. Headless has no shutdown deadline, so don't let a stalled\n      // in-flight dispatch hold up exit.\n      await Promise.race([\n        boot.stopNotificationDispatch?.().catch(() => {}),\n        new Promise<void>(resolve => setTimeout(resolve, STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS).unref()),\n      ]);\n      await Promise.allSettled([\n        mcpManager?.disconnect(),\n        controller.getMastra()?.stopWorkers(),\n        controller.stopIntervals(),\n      ]);\n      // The signals pubsub is Mastra's event bus, so close it after the workers\n      // stop. Call close() on the object; a detached method loses `this` and\n      // rejects silently, leaving socket files behind.\n      const signalsPubSub = boot.signalsPubSub as { close?: () => Promise<void> | void } | undefined;\n      await Promise.allSettled([signalsPubSub?.close?.()]);\n    }\n    await stopProcessMemoryDiagnosticsWithTimeout(processMemoryDiagnostics, warning => {\n      process.stderr.write(`Warning: ${warning}\\n`);\n    });\n  }\n\n  process.exit(exitCode);\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -219,6 +219,13 @@ export declare function createMastraCodeAgentController(config?: MastraCodeConfi
      * PubSub, whose shared dispatch schedule keeps delivering everything.
      */
     startNotificationDispatch: () => void;
+    /**
+     * Stops advertising every live session's threads and releases their
+     * ownership claims. Call first on shutdown: a claim otherwise stays held
+     * (and renewed) through the rest of teardown, so a restarted process cannot
+     * claim the thread — and peers cannot reach it — until this one exits.
+     */
+    releaseThreadClaims: () => void;
     /** Stops this process's notification dispatch and releases its leases. Call on shutdown. */
     stopNotificationDispatch: () => Promise<void>;
     /**
@@ -317,6 +324,13 @@ export declare function bootLocalAgentController(config?: MastraCodeConfig): Pro
      * PubSub, whose shared dispatch schedule keeps delivering everything.
      */
     startNotificationDispatch: () => void;
+    /**
+     * Stops advertising every live session's threads and releases their
+     * ownership claims. Call first on shutdown: a claim otherwise stays held
+     * (and renewed) through the rest of teardown, so a restarted process cannot
+     * claim the thread — and peers cannot reach it — until this one exits.
+     */
+    releaseThreadClaims: () => void;
     /** Stops this process's notification dispatch and releases its leases. Call on shutdown. */
     stopNotificationDispatch: () => Promise<void>;
     /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -69,10 +69,10 @@ import path from "path";
 import { createHash, randomUUID } from "crypto";
 import { statSync } from "fs";
 import { homedir, hostname } from "os";
+import { PROVIDER_REGISTRY, findGatewayForModel, getGatewayId } from "@mastra/core/llm";
 import { readFile } from "fs/promises";
 import { AgentController, migratePersistedModelSelection } from "@mastra/core/agent-controller";
 import { createCodingAgent } from "@mastra/core/coding-agent";
-import { PROVIDER_REGISTRY, findGatewayForModel, getGatewayId } from "@mastra/core/llm";
 import { Mastra } from "@mastra/core/mastra";
 import { defaultNotificationDeliveryDecision } from "@mastra/core/notifications";
 import { AgentsMDInjector, CyberRefusalHandler, ProviderHistoryCompat, StreamErrorRetryProcessor, createBackgroundWorkSignalProcessor, isBadRequestError } from "@mastra/core/processors";
@@ -987,6 +987,18 @@ async function createMastraCodeAgentController(config) {
 		startNotificationDispatch: () => {
 			if (ownsNotificationDispatch) notificationDispatcher.start();
 		},
+		/**
+		* Stops advertising every live session's threads and releases their
+		* ownership claims. Call first on shutdown: a claim otherwise stays held
+		* (and renewed) through the rest of teardown, so a restarted process cannot
+		* claim the thread — and peers cannot reach it — until this one exits.
+		*/
+		releaseThreadClaims: () => {
+			for (const session of liveSessions) {
+				sessionPeerCleanup.get(session)?.();
+				sessionPeerCleanup.delete(session);
+			}
+		},
 		/** Stops this process's notification dispatch and releases its leases. Call on shutdown. */
 		stopNotificationDispatch: async () => {
 			await notificationDispatcher.stop();