@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

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

@@ -0,0 +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 { getCredentialProviderId, normalizeLegacyModelId } from '../providers/model-ids.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 = normalizeLegacyModelId(modelId)\n    .replace(/^mastracode\\//, '')\n    .split('/');\n  const providerId = segments[0] ? getCredentialProviderId(segments[0]) : undefined;\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      /** The host has no modes, so per-mode thinking defaults never apply. */\n      modeless?: boolean;\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        ...(!this.options.modeless && {\n          session: { modeId: typeof controller?.session?.modeId === 'string' ? controller.session.modeId : 'build' },\n        }),\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,2BAA2B;;AAqCxC,MAAM,qBAAqB,IAAI,IAAI,kBAAkB,CAAC,CAAC,KAAI,aAAY,SAAS,EAAE,CAAC;;AAGnF,MAAM,yBAAkD;CACtD,CAAC,+BAA+B,WAAW;CAC3C,CAAC,0BAA0B,iBAAiB;CAC5C,CAAC,sBAAsB,KAAK;CAC5B,CAAC,wBAAwB,cAAc;CACvC,CAAC,kCAAkC,cAAc;CACjD,CAAC,8BAA8B,gBAAgB;CAC/C,CAAC,4BAA4B,gBAAgB;AAC/C;;;;;;;;AASA,MAAM,8BACJ;AAEF,MAAM,sCAAsB,IAAI,IAAI;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,0BACJ;AAEF,MAAM,kBAAkB;;AAGxB,MAAa,2BAA2B;;AAWxC,MAAa,2BAA2B;AAiBxC,SAAS,gBAAgB,OAA6C;CACpE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;AAEA,SAAS,gBAAgB,OAAoC;CAC3D,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,WAAW,QAAQ,iBAAiB,SAAS;EAC/D,IAAI,OAAO,YAAY,UAAU;EACjC,MAAM,EAAE,YAAY,WAAW;EAC/B,IAAI,OAAO,eAAe,UAAU,OAAO;EAC3C,IAAI,OAAO,WAAW,UAAU,OAAO;EACvC,UAAW,QAAgC;CAC7C;AAEF;AAEA,SAAS,4BAA4B,OAAyB;CAC5D,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,WAAW,QAAQ,iBAAiB,SAAS;EAC/D,IACE,mBAAmB,6BAClB,mBAAmB,SAAS,QAAQ,SAAA,6BAErC,OAAO;EAET,IAAI,OAAO,YAAY,UAAU;EACjC,UAAW,QAAgC;CAC7C;CACA,OAAO;AACT;;AAGA,SAAS,iBAAiB,OAAwB;CAChD,MAAM,QAAkB,CAAC;CACzB,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,WAAW,QAAQ,iBAAiB,SACtD,IAAI,mBAAmB,OAAO;EAC5B,MAAM,KAAK,QAAQ,OAAO;EAC1B,UAAU,QAAQ;CACpB,OAAO,IAAI,OAAO,YAAY,YAAY,aAAa,SAAS;EAC9D,MAAM,UAAW,QAAkC;EACnD,IAAI,OAAO,YAAY,UAAU,MAAM,KAAK,OAAO;EACnD,UAAW,QAAgC;CAC7C,OACE;CAGJ,OAAO,MAAM,KAAK,KAAK;AACzB;AAEA,SAAS,mBAAmB,OAAyB;CACnD,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,WAAW,QAAQ,iBAAiB,SAAS;EAC/D,IACE,gBAAgB,OAAO,KACvB,OAAO,QAAQ,SAAS,YACxB,oBAAoB,IAAI,QAAQ,KAAK,YAAY,CAAC,GAElD,OAAO;EAET,IAAI,mBAAmB,OAAO;GAC5B,IAAI,wBAAwB,KAAK,QAAQ,OAAO,GAAG,OAAO;GAC1D,UAAU,QAAQ;EACpB,OAAO,IAAI,OAAO,YAAY,UAC5B,UAAW,QAAgC;OAE3C;CAEJ;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,sBAAsB,OAAwC;CAC5E,IAAI,4BAA4B,KAAK,GACnC,OAAO;EAAE,MAAM;EAAU,QAAQ;CAAc;CAGjD,MAAM,SAAS,gBAAgB,KAAK;CAEpC,IAAI,WAAW,KAAK,OAAO;EAAE,MAAM;EAAU,QAAQ;CAAa;CAClE,IAAI,WAAW,KAAK,OAAO;EAAE,MAAM;EAAU,QAAQ;CAAkB;CACvE,IAAI,WAAW,OAAO,WAAW,KAAK,OAAO;EAAE,MAAM;EAAU,QAAQ;CAAc;CACrF,IAAI,WAAW,KAAA,KAAa,UAAU,OAAO,SAAS,KAAK,OAAO,EAAE,MAAM,MAAM;CAOhF,IAAI,WAAW,KAAA,KAAa,WAAW,KACjC;MAAA,4BAA4B,KAAK,iBAAiB,KAAK,CAAC,GAC1D,OAAO;GAAE,MAAM;GAAU,QAAQ;EAAkB;CAAA;CAGvD,IAAI,mBAAmB,KAAK,GAAG,OAAO,EAAE,MAAM,MAAM;CAEpD,OAAO,EAAE,MAAM,QAAQ;AACzB;;AAGA,SAAgB,oBAAoB,SAAqC;CACvE,MAAM,WAAW,uBAAuB,OAAO,CAAC,CAC7C,QAAQ,iBAAiB,EAAE,CAAC,CAC5B,MAAM,GAAG;CACZ,MAAM,aAAa,SAAS,KAAK,wBAAwB,SAAS,EAAE,IAAI,KAAA;CACxE,OAAO,cAAc,mBAAmB,IAAI,UAAU,IAAI,aAAa,KAAA;AACzE;AAEA,SAAS,iBAAiB,UAAsC;CAC9D,KAAK,MAAM,CAAC,SAAS,eAAe,wBAClC,IAAI,QAAQ,KAAK,QAAQ,GAAG,OAAO;AAGvC;;;;;;AAOA,SAAgB,kBAAkB,OAAoC;CACpE,MAAM,aAAuB,CAAC;CAC9B,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,WAAW,QAAQ,iBAAiB,SAAS;EAC/D,IAAI,OAAO,YAAY,UAAU;EACjC,WAAW,KAAK,OAAO;EACvB,UAAW,QAAgC;CAC7C;CAMA,KAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,OAAO;GACV,KAA2B;GAC3B,KAAkC;GAClC,KAAkC;EACrC;EACA,KAAK,MAAM,OAAO,MAAM;GACtB,IAAI,OAAO,QAAQ,UAAU;GAC7B,IAAI;IACF,MAAM,aAAa,iBAAiB,IAAI,IAAI,GAAG,CAAC,CAAC,QAAQ;IACzD,IAAI,YAAY,OAAO;GACzB,QAAQ,CAER;EACF;CACF;CAEA,KAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,UAAW,KAA+B;EAChD,IAAI,OAAO,YAAY,UAAU;EACjC,MAAM,aAAa,oBAAoB,OAAO;EAC9C,IAAI,YAAY,OAAO;CACzB;AAEF;AAEA,SAAS,kBAAkB,OAA6C;CACtE,MAAM,WAAW,MAAM;CACvB,IAAI,oBAAoB,KAAK,OAAO;CACpC,MAAM,0BAAU,IAAI,IAAY;CAChC,MAAM,iBAAiB;CACvB,OAAO;AACT;AAEA,SAAS,0BAA0B,OAA6C;CAC9E,MAAM,WAAW,MAAM;CACvB,IAAI,oBAAoB,KAAK,OAAO;CACpC,MAAM,0BAAU,IAAI,IAAY;CAChC,MAAM,oBAAoB;CAC1B,OAAO;AACT;;AAGA,MAAa,yBAAiD;CAC5D,WAAW;CACX,mBAAmB;CACnB,gBAAgB;CAChB,kBAAkB;CAClB,KAAK;AACP;AAEA,MAAM,cAA+D;CACnE,cAAc;CACd,mBAAmB;CACnB,eAAe;CACf,kBAAkB;CAClB,qBAAqB;CACrB,qBAAqB;AACvB;;AAGA,SAAgB,sBAAsB,OAA0D;CAG9F,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,eAAe,KAAK,aAAa,KAAK;AAC7F;;;;;;;AAQA,SAAgB,wBAAwB,MAAqC;CAC3E,MAAM,WAAW,uBAAuB,KAAK,aAAa,KAAK;CAC/D,MAAM,SAAS,YAAY,KAAK;CAChC,IAAI,KAAK,OAAO,MAAM;EAIpB,IAAI,KAAK,WACP,OAAO,UAAU,SAAS,wBAAwB,OAAO;EAE3D,OAAO,OAAO,SAAS,yBAAyB,OAAO;CACzD;CAEA,OAAO,YAAY,SAAS,YADf,KAAK,MAAM,SAAS,UACY,KAAK,KAAK,GAAG,MAAM,IAAI,OAAO;AAC7E;;AAGA,SAAgB,wBAAwB,MAAqC;CAC3E,MAAM,SAAS,YAAY,KAAK,WAAW,KAAK;CAChD,OAAO,yBAAyB,KAAK,KAAK,MAAM,KAAK,KAAK,GAAG,MAAM,IAAI,OAAO;AAChF;;;;;;;;AASA,SAAgB,sBAAsB,OAA0D;CAC9F,OAAO,UAAU,oBAAoB,UAAU;AACjD;AAEA,eAAe,sBACb,MACA,MACe;CAGf,MAAM,KAAK,QAAQ,OAAO;EACxB,MAAM;EACN;CACF,CAAC;CAOD,CAH0B,KAAK,gBAAgB,IAAI,YAAY,EAAA,EAG5C,YAAY;EAAE,MAAM;EAAQ,SAAS,wBAAwB,IAAI;CAAE,CAAC;AACzF;;;;;;;AAQA,SAAS,oBACP,MACoB;CAEpB,MAAM,WADa,KAAK,gBAAgB,IAAI,YAAY,EAAA,EAC5B,SAAS;CACrC,OAAO,OAAO,YAAY,WAAW,oBAAoB,OAAO,IAAI,KAAA;AACtE;AAmCA,SAAS,qBACP,MACsC;CACtC,OAAO,KAAK,gBAAgB,IAAI,YAAY;AAC9C;;AAGA,SAAS,wBAAwB,OAAgD;CAC/E,OAAO,OAAO;AAChB;AAEA,SAAS,wBACP,MACA,OACA,YACA;CACA,IAAI,iCAAiC,KAAK,gBAAgB,UAAU,GAAG,OAAO,KAAA;CAC9E,MAAM,aAAa,2BAA2B,KAAK,gBAAgB,UAAU;CAC7E,IAAI,YAAY,OAAO,MAAM,eAAe,UAAU,CAAC,CAAC,MAAK,YAAW,QAAQ,OAAO,UAAU;CACjG,OAAO,MAAM,mBAAmB,UAAU,KAAK,MAAM,eAAe,UAAU,CAAC,CAAC,MAAK,YAAW,QAAQ,MAAM;AAChH;AAEA,SAAS,oBACP,MACA,UACqB;CACrB,MAAM,aAAa,qBAAqB,IAAI;CAC5C,MAAM,QAAQ,YAAY,WAAW;CACrC,MAAM,UAAU,OAAO;CAIvB,MAAM,uBACJ,WACA,OAAO,QAAQ,cAAc,YAC7B,OAAO,QAAQ,cAAc,aAC5B,QAAQ,aAAa,KAAA,KAAa,QAAQ,aAAa,YAAY;CACtE,MAAM,eAAe,MAAM,SAAS,OAAO,WAAA,EAAkD,OAAO,KAC9F,OAAO,WAAA,CAA4F,WACrG,CAAC,IACD,CAAC;CACL,MAAM,QAAQ,WACV,WACA,uBACE,aAAa,MAAK,cAAa,UAAU,OAAO,QAAQ,aAAa,UAAU,YAAY,QAAQ,SAAS,IAC5G,aAAa,MAAK,cAAa,UAAU,YAAY,YAAY,SAAS,OAAO;CACvF,IAAI,CAAC,SAAS,OAAO,MAAM,OAAO,YAAY,OAAO,MAAM,YAAY,UAAU,OAAO;CACxF,MAAM,aAAa,oBAAoB,MAAM,OAAO;CACpD,IAAI,CAAC,YAAY,OAAO;CACxB,OAAO;EACL,SAAS,MAAM;EACf,SAAS,MAAM;EACf;EACA,GAAI,OAAO,MAAM,cAAc,WAAW,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;CAC9E;AACF;;;;;;;;;AAUA,SAAS,wBAAwB,UAAgC,UAA8B;CAC7F,MAAM,QAAQ,aAAa,KAAA,IAAY,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,QAAQ;CACjG,IAAI,SAAS,GAAG,OAAO;CACvB,OAAO,CAAC,GAAG,SAAS,MAAM,KAAK,GAAG,GAAG,SAAS,MAAM,GAAG,KAAK,CAAC;AAC/D;AAEA,eAAe,2BACb,MACA,OACA,OACkB;CAClB,MAAM,OAAO;CACb,MAAM,cAAc,wBAAwB,KAAK;CACjD,MAAM,WAAW,MAAM,eAAe,MAAM,UAAU,KAAK,CAAC;CAC5D,IAAI,SAAS,WAAW,KAAK,gBAAgB,KAAA,GAAW,OAAO;CAC/D,MAAM,QAAQ,kBAAkB,KAAK,KAAK;CAC1C,MAAM,cAAc,IAAI,IAAI,SAAS,QAAO,YAAW,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAI,YAAW,QAAQ,EAAE,CAAC;CACxG,MAAM,SAAS,wBAAwB,MAAM,OAAO,MAAM,UAAU,KAAK,MAAM,mBAAmB,MAAM,UAAU;CAClH,MAAM,YAIF,cACI,SAAS,QAAO,YAAW,QAAQ,OAAO,WAAW,IACrD,wBAAwB,UAAU,QAAQ,EAAE,EAAA,CAChD,MAAK,YAAW,CAAC,YAAY,IAAI,QAAQ,EAAE,CAAC;CAEhD,KAAK,MAAM,aAAa,aAAa,MAAM,IAAI,SAAS;CACxD,IAAI,CAAC,UAAU;EACb,mCAAmC,KAAK,gBAAgB,MAAM,UAAU;EACxE,OAAO;CACT;CAEA,IAAI,QAAQ,OAAO,SAAS,IAAI;EAC9B,2BAA2B,KAAK,gBAAgB,MAAM,YAAY,SAAS,EAAE;EAC7E,OAAO;CACT;CAIA,MAAM,YAAY,MAAM,kBAAkB,MAAM,gBAAgB,MAAM,YAAY,SAAS,EAAE,IAAI;CACjG,IAAI,CAAC,WAAW;EAId,IAAI,gBAAgB,KAAA,GAAW,mCAAmC,KAAK,gBAAgB,MAAM,UAAU;EACvG,OAAO;CACT;CACA,2BAA2B,KAAK,gBAAgB,MAAM,YAAY,UAAU,EAAE;CAG9E,IAAI,gBAAgB,KAAA,GAClB,MAAM,sBAAsB,MAAM;EAChC,UAAU,MAAM;EAChB,MAAM,SAAS;GAAE,IAAI,OAAO;GAAI,OAAO,OAAO;EAAM,IAAI;EACxD,IAAI;GAAE,IAAI,UAAU;GAAI,OAAO,UAAU;EAAM;EAC/C,QAAQ;EACR,qBAAI,IAAI,KAAK,EAAA,CAAE,YAAY;CAC7B,CAAC;CAEH,OAAO;AACT;AAEA,IAAa,2BAAb,MAA2D;CAItC;CAHnB,KAAc;CAEd,YACE,SAOA;EAPiB,KAAA,UAAA;CAOhB;CAEH,MAAM,gBAAgB,MAAwD;EAC5E,MAAM,EAAE,OAAO,UAAU;EASzB,IAAI,KAAK,cAAc,KAAK,QAAQ,qBAAqB;GACvD,MAAM,KAAK,aAAa,MAAM,KAAK;GACnC,OAAO,EAAE,OAAO,MAAM;EACxB;EAKA,MAAM,iBAAiB,sBAAsB,KAAK;EAKlD,IAAI,eAAe,SAAS,SAAS;GACnC,MAAM,KAAK,aAAa,MAAM,KAAK;GACnC,OAAO,EAAE,OAAO,MAAM;EACxB;EAEA,MAAM,UAAU,MAAM,KAAK,qBAAqB,IAAI;EACpD,MAAM,eAAe,SAAS,QAAQ,QAAQ;EAC9C,MAAM,aACJ,kBAAkB,KAAK,MACtB,eAAe,oBAAoB,aAAa,OAAO,IAAI,KAAA,OAC3D,UAAU,KAAA,IAAY,oBAAoB,IAAI;EACjD,IAAI,CAAC,YAAY;GACf,MAAM,KAAK,sBAAsB,MAAM,eAAe,SAAS,QAAQ,sBAAsB,gBAAgB;GAC7G,OAAO,EAAE,OAAO,MAAM;EACxB;EAQA,MAAM,QAAiC,uBAAuB,KAAK,cAAc,KAAK,KAAK,QAAQ;EACnG,MAAM,OAAO;EACb,MAAM,WAAW,MAAM,eAAe,UAAU,KAAK,CAAC;EACtD,MAAM,SAAS,wBAAwB,MAAM,OAAO,UAAU;EAC9D,MAAM,QAAQ,eAAe,oBAAoB,MAAM,YAAY,IAAI,oBAAoB,IAAI;EAU/F,IAAI,eAAe,SAAS,YAAY,eAAe,WAAW,iBAAiB,QAAQ;GACzF,MAAM,SAAS,0BAA0B,KAAK;GAC9C,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,MAAM;GAClD,IAAI,CAAC,OAAO,IAAI,UAAU,KAAK,OAAO,MAAM,8BAA8B,YAAY;IACpF,OAAO,IAAI,UAAU;IAErB,IAAI,MADgB,MAAM,0BAA0B,YAAY,QAAQ,EAAE,MAC5D,KAAA,GACZ,OAAO,EAAE,OAAO,KAAK;GAEzB;EACF;EAQA,MAAM,kBAAkB,OAAO,eAAe,aAAa,wBAAwB,KAAK,IAAI,KAAA;EAE5F,IAAI,eAAe,SAAS,OAC1B,OAAO,KAAK,uBAAuB,MAAM,YAAY,qBAAqB,oBAAoB,KAAA,CAAS;EASzG,IAAI,oBAAoB,KAAA,GACtB,OAAO,KAAK,uBAAuB,MAAM,YAAY,kBAAkB,IAAI;EAO7E,MAAM,QAAQ,kBAAkB,KAAK;EACrC,IAAI,QAAQ,MAAM,IAAI,OAAO,EAAE;EAI/B,IADyB,SAAS,QAAO,YAAW,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,UACnD,SAAS,QAC/B,OAAO,KAAK,uBAAuB,MAAM,YAAY,gBAAgB;EAMvE,MAAM,iBADa,SAAS,WAAW,wBAAwB,UAAU,MAAM,mBAAmB,UAAU,CAAC,EAAE,EAAE,EAAA,CAChF,MAAK,YAAW,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;EAEvE,MAAM,OAAO,gBAAgB,MAAM,kBAAkB,YAAY,cAAc,EAAE,IAAI,KAAA;EACrF,IAAI,CAAC,MACH,OAAO,KAAK,uBAAuB,MAAM,YAAY,gBAAgB;EAEvE,2BAA2B,KAAK,gBAAgB,YAAY,KAAK,EAAE;EACnE,MAAM,IAAI,KAAK,EAAE;EAKjB,KAAK,0BAA0B;EAE/B,MAAM,sBAAsB,MAAM;GAChC,UAAU;GACV,MAAM,SAAS;IAAE,IAAI,OAAO;IAAI,OAAO,OAAO;GAAM,IAAI;GACxD,IAAI;IAAE,IAAI,KAAK;IAAI,OAAO,KAAK;GAAM;GACrC,QAAQ,eAAe;GACvB,qBAAI,IAAI,KAAK,EAAA,CAAE,YAAY;EAC7B,CAAC;EAED,OAAO,EAAE,OAAO,KAAK;CACvB;;;;;;CAOA,MAAc,qBAAqB,MAA8D;EAC/F,IAAI,KAAK,MAAM,sBAAsB,KAAA,GACnC,OAAQ,KAAK,MAAM,qBAAkD;EAEvE,MAAM,aAAa,qBAAqB,IAAI;EAC5C,MAAM,QAAQ,YAAY,WAAW;EACrC,MAAM,SACJ,OAAO,WAAA,EAGN;EACH,MAAM,UAAU,OAAO;EAQvB,MAAM,aAHJ,WACA,OAAO,QAAQ,cAAc,aAC5B,QAAQ,aAAa,KAAA,KAAa,QAAQ,aAAa,YAAY,YAElE,OAAO,WAAU,UAAS,MAAM,OAAO,QAAQ,SAAS,IACxD,OAAO,WAAU,UAAS,MAAM,YAAY,YAAY,SAAS,OAAO;EAC5E,IAAI,CAAC,SAAS,eAAe,KAAA,KAAa,aAAa,KAAK,MAAM,SAAS,aAAa,GAAG;GACzF,KAAK,MAAM,oBAAoB;GAC/B,OAAO;EACT;EAEA,MAAM,gBAAgB,4BACpB;GACE,OAAO,EAAE,eAAe,OAAO,cAAc;GAC7C,GAAI,CAAC,KAAK,QAAQ,YAAY,EAC5B,SAAS,EAAE,QAAQ,OAAO,YAAY,SAAS,WAAW,WAAW,WAAW,QAAQ,SAAS,QAAQ,EAC3G;EACF,GACA,KAAK,QAAQ,YACf;EACA,MAAM,UAAwC,CAAC;EAC/C,KAAK,MAAM,SAAS,MAAM,MAAM,UAAU,GAAG;GAC3C,IACE,OAAO,MAAM,OAAO,YACpB,MAAM,GAAG,WAAW,KACpB,OAAO,MAAM,YAAY,YACzB,MAAM,QAAQ,WAAW,GAEzB;GAEF,IAAI,QAAQ,SAAS,GACnB,IAAI;IACF,aAAa,MAAM,SAAS;KAC1B;KACA,oBAAoB;KACpB,gBAAgB,KAAK;IACvB,CAAC;GACH,QAAQ;IACN;GACF;GAEF,QAAQ,KAAK;IACX,IAAI,MAAM;IACV,OAAO,OAAO,MAAM,UAAU,YAAY,MAAM,MAAM,SAAS,IAAI,MAAM,QAAQ,MAAM;IACvF,SAAS,MAAM;IACf,GAAI,OAAO,MAAM,cAAc,WAAW,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;GAC9E,CAAC;EACH;EACA,IAAI,QAAQ,SAAS,GAAG;GACtB,KAAK,MAAM,oBAAoB;GAC/B,OAAO;EACT;EACA,MAAM,UAA6B;GAAE;GAAS,UAAU;EAAE;EAC1D,KAAK,MAAM,oBAAoB;EAC/B,OAAO;CACT;;;;;;;;;;;CAYA,MAAc,aAAa,MAA2B,OAA+B;EACnF,MAAM,UAAU,MAAM,KAAK,qBAAqB,IAAI;EACpD,IAAI,CAAC,SAAS;EACd,IAAI,QAAQ,YAAY,QAAQ,QAAQ,SAAS,GAAG;EAEpD,MAAM,IAAI,SADK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACzC,CAAC,GAAG,KAAK,EAAE;CACxC;;CAGA,MAAc,sBACZ,MACA,QACe;EACf,MAAM,UAAU,MAAM,KAAK,qBAAqB,IAAI;EACpD,IAAI,CAAC,SAAS;EAEd,MAAM,OAAO,QAAQ,QAAQ,QAAQ;EACrC,MAAM,KAAK,QAAQ,QAAQ,QAAQ,WAAW;EAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI;EAElB,MAAM,aAAa,KAAK,gBAAgB,IAAI,YAAY;EAQxD,MAAM,sBAAK,IAAI,KAAK,EAAA,CAAE,YAAY;EAClC,MAAM,WAAW,OAAO,YAAY,aAAa,WAAW,WAAW,WAAW,KAAA;EAClF,MAAM,UAAU;GACd,aAAa,KAAK;GAClB,WAAW,GAAG;GACd,WAAW,GAAG;GACd,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;GAC/B;GACA;EACF;EACA,MAAM,YAAY,mBAAmB;GAAE,KAAK;GAA0B,OAAO;EAAQ,CAAC;EACtF,MAAM,OAA8B;GAClC,MAAM;IAAE,SAAS,KAAK;IAAI,OAAO,KAAK;GAAM;GAC5C,IAAI;IAAE,SAAS,GAAG;IAAI,OAAO,GAAG;GAAM;GACtC;GACA;EACF;EACA,IAAI;GACF,MAAM,KAAK,QAAQ,OAAO;IAAE,MAAM;IAA0B;GAAK,CAAC;EACpE,SAAS,OAAO;GACd,MAAM,YAAY,mBAAmB;IAAE,KAAK;IAA0B,OAAO,KAAA;GAAU,CAAC;GACxF,MAAM;EACR;EACA,MAAM,YAAY,WAAW,GAAG,2BAA2B,QAAQ,CAAC;EACpE,KAAK,MAAM,qBAAqB;EAChC,MAAM,cAAc,oBAAoB,MAAM,EAAE;EAChD,IAAI,aAEF,MAAM,2BAA2B,MADnB,uBAAuB,KAAK,cAAc,KAAK,KAAK,QAAQ,iBAC5B,WAAW,CAAC,CAAC,YAAY,KAAA,CAAS;EAElF,YAAY,YAAY;GAAE,MAAM;GAAQ,SAAS,wBAAwB,IAAI;EAAE,CAAC;EAChF,QAAQ;CACV;;;;;;;;CASA,MAAc,uBACZ,MACA,YACA,QACA,YAAY,OACiB;EAC7B,MAAM,QAAQ,uBAAuB,KAAK,cAAc,KAAK,KAAK,QAAQ;EAC1E,MAAM,WAAW,MAAM,eAAe,UAAU,KAAK,CAAC;EACtD,IAAI,SAAS,WAAW,GAAG;GAGzB,MAAM,KAAK,sBAAsB,MAAM,MAAM;GAC7C,OAAO,EAAE,OAAO,MAAM;EACxB;EAEA,MAAM,QAAQ,kBAAkB,KAAK,KAAK;EAC1C,KAAK,MAAM,WAAW,UAAU,MAAM,IAAI,QAAQ,EAAE;EAEpD,MAAM,SAAS,wBAAwB,MAAM,OAAO,UAAU;EAE9D,MAAM,sBAAsB,MAAM;GAChC,UAAU;GACV,MAAM,SAAS;IAAE,IAAI,OAAO;IAAI,OAAO,OAAO;GAAM,IAAI;GACxD,IAAI;GACJ;GACA,qBAAI,IAAI,KAAK,EAAA,CAAE,YAAY;GAC3B,GAAI,YAAY,EAAE,WAAW,KAAK,IAAI,CAAC;EACzC,CAAC;EAED,MAAM,KAAK,sBAAsB,MAAM,MAAM;EAE7C,OAAO,EAAE,OAAO,MAAM;CACxB;AACF;;;;;;;;;;;AAYA,IAAa,8BAAb,MAA8D;CAG/B;CAF7B,KAAc;CAEd,YAAY,SAAgE;EAA/C,KAAA,UAAA;CAAgD;CAE7E,MAAM,aAAa,MAAqD;EACtE,IAAI,KAAK,MAAM,oBAAoB,OAAO,KAAK;EAK/C,MAAM,QAAQ,uBAAuB,KAAK,cAAc,KAAK,KAAK,QAAQ;EAE1E,MAAM,QAAQ,oBAAoB,IAAI;EACtC,IAAI,CAAC,OAAO;GACV,MAAM,OAAO;GACb,OAAO,KAAK;EACd;EAUA,IAAI,MADmB,2BAA2B,MAAM,OAAO,KAAK,KACpD,wBAAwB,KAAK,MAAM,KAAA,GACjD,KAAK,MAAM,qBAAqB;EAElC,OAAO,KAAK;CACd;AACF"}

package/dist/auth/account-routing-context.d.ts

@@ -0,0 +1,13 @@
+import type { RequestContext } from '@mastra/core/request-context';
+export declare function getRequestAccountSelection(requestContext: RequestContext | undefined, providerId: string): string | undefined;
+export declare function setRequestAccountSelection(requestContext: RequestContext | undefined, providerId: string, accountInstanceId: string): void;
+/**
+ * Record that routing found no usable account for this provider on this
+ * request. Kept separate from the account selection: a sentinel *id* would be
+ * handed to credential lookup, where an unknown id makes `get()` fall back to
+ * the provider's active account — the very account routing just rejected.
+ */
+export declare function markRequestAccountRoutingExhausted(requestContext: RequestContext | undefined, providerId: string): void;
+/** Whether routing already rejected every account for this provider on this request. */
+export declare function isRequestAccountRoutingExhausted(requestContext: RequestContext | undefined, providerId: string): boolean;
+//# sourceMappingURL=account-routing-context.d.ts.map

package/dist/auth/account-routing-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-routing-context.d.ts","sourceRoot":"","sources":["../../src/auth/account-routing-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAWnE,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,sBAExG;AAED,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAMN;AASD;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,UAAU,EAAE,MAAM,GACjB,IAAI,CAKN;AAED,wFAAwF;AACxF,wBAAgB,gCAAgC,CAC9C,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAET"}

package/dist/auth/account-routing-context.js

@@ -0,0 +1,41 @@
+//#region src/auth/account-routing-context.ts
+const ACCOUNT_ROUTING_SELECTIONS_KEY = "mastracodeAccountRoutingSelections";
+function getSelections(requestContext) {
+	const value = requestContext?.get(ACCOUNT_ROUTING_SELECTIONS_KEY);
+	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function getRequestAccountSelection(requestContext, providerId) {
+	return getSelections(requestContext)?.[providerId];
+}
+function setRequestAccountSelection(requestContext, providerId, accountInstanceId) {
+	if (!requestContext || typeof requestContext.set !== "function") return;
+	requestContext.set(ACCOUNT_ROUTING_SELECTIONS_KEY, {
+		...getSelections(requestContext),
+		[providerId]: accountInstanceId
+	});
+}
+const ACCOUNT_ROUTING_EXHAUSTED_KEY = "mastracodeAccountRoutingExhaustedProviders";
+function getExhaustedProviders(requestContext) {
+	const value = requestContext?.get(ACCOUNT_ROUTING_EXHAUSTED_KEY);
+	return Array.isArray(value) ? value : [];
+}
+/**
+* Record that routing found no usable account for this provider on this
+* request. Kept separate from the account selection: a sentinel *id* would be
+* handed to credential lookup, where an unknown id makes `get()` fall back to
+* the provider's active account — the very account routing just rejected.
+*/
+function markRequestAccountRoutingExhausted(requestContext, providerId) {
+	if (!requestContext || typeof requestContext.set !== "function") return;
+	const exhausted = getExhaustedProviders(requestContext);
+	if (exhausted.includes(providerId)) return;
+	requestContext.set(ACCOUNT_ROUTING_EXHAUSTED_KEY, [...exhausted, providerId]);
+}
+/** Whether routing already rejected every account for this provider on this request. */
+function isRequestAccountRoutingExhausted(requestContext, providerId) {
+	return getExhaustedProviders(requestContext).includes(providerId);
+}
+//#endregion
+export { getRequestAccountSelection, isRequestAccountRoutingExhausted, markRequestAccountRoutingExhausted, setRequestAccountSelection };
+
+//# sourceMappingURL=account-routing-context.js.map

package/dist/auth/account-routing-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-routing-context.js","names":[],"sources":["../../src/auth/account-routing-context.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\n\nconst ACCOUNT_ROUTING_SELECTIONS_KEY = 'mastracodeAccountRoutingSelections';\n\ntype AccountRoutingSelections = Record<string, string>;\n\nfunction getSelections(requestContext?: RequestContext): AccountRoutingSelections | undefined {\n  const value = requestContext?.get(ACCOUNT_ROUTING_SELECTIONS_KEY);\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as AccountRoutingSelections) : undefined;\n}\n\nexport function getRequestAccountSelection(requestContext: RequestContext | undefined, providerId: string) {\n  return getSelections(requestContext)?.[providerId];\n}\n\nexport function setRequestAccountSelection(\n  requestContext: RequestContext | undefined,\n  providerId: string,\n  accountInstanceId: string,\n): void {\n  if (!requestContext || typeof requestContext.set !== 'function') return;\n  requestContext.set(ACCOUNT_ROUTING_SELECTIONS_KEY, {\n    ...getSelections(requestContext),\n    [providerId]: accountInstanceId,\n  });\n}\n\nconst ACCOUNT_ROUTING_EXHAUSTED_KEY = 'mastracodeAccountRoutingExhaustedProviders';\n\nfunction getExhaustedProviders(requestContext?: RequestContext): string[] {\n  const value = requestContext?.get(ACCOUNT_ROUTING_EXHAUSTED_KEY);\n  return Array.isArray(value) ? (value as string[]) : [];\n}\n\n/**\n * Record that routing found no usable account for this provider on this\n * request. Kept separate from the account selection: a sentinel *id* would be\n * handed to credential lookup, where an unknown id makes `get()` fall back to\n * the provider's active account — the very account routing just rejected.\n */\nexport function markRequestAccountRoutingExhausted(\n  requestContext: RequestContext | undefined,\n  providerId: string,\n): void {\n  if (!requestContext || typeof requestContext.set !== 'function') return;\n  const exhausted = getExhaustedProviders(requestContext);\n  if (exhausted.includes(providerId)) return;\n  requestContext.set(ACCOUNT_ROUTING_EXHAUSTED_KEY, [...exhausted, providerId]);\n}\n\n/** Whether routing already rejected every account for this provider on this request. */\nexport function isRequestAccountRoutingExhausted(\n  requestContext: RequestContext | undefined,\n  providerId: string,\n): boolean {\n  return getExhaustedProviders(requestContext).includes(providerId);\n}\n"],"mappings":";AAEA,MAAM,iCAAiC;AAIvC,SAAS,cAAc,gBAAuE;CAC5F,MAAM,QAAQ,gBAAgB,IAAI,8BAA8B;CAChE,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAK,QAAqC,KAAA;AAC7G;AAEA,SAAgB,2BAA2B,gBAA4C,YAAoB;CACzG,OAAO,cAAc,cAAc,CAAC,GAAG;AACzC;AAEA,SAAgB,2BACd,gBACA,YACA,mBACM;CACN,IAAI,CAAC,kBAAkB,OAAO,eAAe,QAAQ,YAAY;CACjE,eAAe,IAAI,gCAAgC;EACjD,GAAG,cAAc,cAAc;GAC9B,aAAa;CAChB,CAAC;AACH;AAEA,MAAM,gCAAgC;AAEtC,SAAS,sBAAsB,gBAA2C;CACxE,MAAM,QAAQ,gBAAgB,IAAI,6BAA6B;CAC/D,OAAO,MAAM,QAAQ,KAAK,IAAK,QAAqB,CAAC;AACvD;;;;;;;AAQA,SAAgB,mCACd,gBACA,YACM;CACN,IAAI,CAAC,kBAAkB,OAAO,eAAe,QAAQ,YAAY;CACjE,MAAM,YAAY,sBAAsB,cAAc;CACtD,IAAI,UAAU,SAAS,UAAU,GAAG;CACpC,eAAe,IAAI,+BAA+B,CAAC,GAAG,WAAW,UAAU,CAAC;AAC9E;;AAGA,SAAgB,iCACd,gBACA,YACS;CACT,OAAO,sBAAsB,cAAc,CAAC,CAAC,SAAS,UAAU;AAClE"}

package/dist/auth/authorization-input.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Forgiving parser for user-pasted OAuth authorization input.
+ *
+ * Accepts, in order of preference:
+ *   - a full redirect URL (`https://.../callback?code=...&state=...`)
+ *   - the `code#state` form shown on Anthropic's hosted callback page
+ *   - a raw query string (`code=...&state=...`)
+ *   - a bare authorization code
+ *
+ * Ported from pi-mono's `parseAuthorizationInput`.
+ */
+export declare function parseAuthorizationInput(input: string): {
+    code?: string;
+    state?: string;
+};
+//# sourceMappingURL=authorization-input.d.ts.map

package/dist/auth/authorization-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization-input.d.ts","sourceRoot":"","sources":["../../src/auth/authorization-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA4BA"}

package/dist/auth/authorization-input.js

@@ -0,0 +1,42 @@
+//#region src/auth/authorization-input.ts
+/**
+* Forgiving parser for user-pasted OAuth authorization input.
+*
+* Accepts, in order of preference:
+*   - a full redirect URL (`https://.../callback?code=...&state=...`)
+*   - the `code#state` form shown on Anthropic's hosted callback page
+*   - a raw query string (`code=...&state=...`)
+*   - a bare authorization code
+*
+* Ported from pi-mono's `parseAuthorizationInput`.
+*/
+function parseAuthorizationInput(input) {
+	const value = input.trim();
+	if (!value) return {};
+	try {
+		const url = new URL(value);
+		return {
+			code: url.searchParams.get("code") ?? void 0,
+			state: url.searchParams.get("state") ?? void 0
+		};
+	} catch {}
+	if (value.includes("#")) {
+		const [code, state] = value.split("#", 2);
+		return {
+			code,
+			state
+		};
+	}
+	if (value.includes("code=")) {
+		const params = new URLSearchParams(value);
+		return {
+			code: params.get("code") ?? void 0,
+			state: params.get("state") ?? void 0
+		};
+	}
+	return { code: value };
+}
+//#endregion
+export { parseAuthorizationInput };
+
+//# sourceMappingURL=authorization-input.js.map

package/dist/auth/authorization-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization-input.js","names":[],"sources":["../../src/auth/authorization-input.ts"],"sourcesContent":["/**\n * Forgiving parser for user-pasted OAuth authorization input.\n *\n * Accepts, in order of preference:\n *   - a full redirect URL (`https://.../callback?code=...&state=...`)\n *   - the `code#state` form shown on Anthropic's hosted callback page\n *   - a raw query string (`code=...&state=...`)\n *   - a bare authorization code\n *\n * Ported from pi-mono's `parseAuthorizationInput`.\n */\nexport function parseAuthorizationInput(input: string): {\n  code?: string;\n  state?: string;\n} {\n  const value = input.trim();\n  if (!value) return {};\n\n  try {\n    const url = new URL(value);\n    return {\n      code: url.searchParams.get('code') ?? undefined,\n      state: url.searchParams.get('state') ?? undefined,\n    };\n  } catch {\n    // not a URL\n  }\n\n  if (value.includes('#')) {\n    const [code, state] = value.split('#', 2);\n    return { code, state };\n  }\n\n  if (value.includes('code=')) {\n    const params = new URLSearchParams(value);\n    return {\n      code: params.get('code') ?? undefined,\n      state: params.get('state') ?? undefined,\n    };\n  }\n\n  return { code: value };\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,wBAAwB,OAGtC;CACA,MAAM,QAAQ,MAAM,KAAK;CACzB,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,KAAK;EACzB,OAAO;GACL,MAAM,IAAI,aAAa,IAAI,MAAM,KAAK,KAAA;GACtC,OAAO,IAAI,aAAa,IAAI,OAAO,KAAK,KAAA;EAC1C;CACF,QAAQ,CAER;CAEA,IAAI,MAAM,SAAS,GAAG,GAAG;EACvB,MAAM,CAAC,MAAM,SAAS,MAAM,MAAM,KAAK,CAAC;EACxC,OAAO;GAAE;GAAM;EAAM;CACvB;CAEA,IAAI,MAAM,SAAS,OAAO,GAAG;EAC3B,MAAM,SAAS,IAAI,gBAAgB,KAAK;EACxC,OAAO;GACL,MAAM,OAAO,IAAI,MAAM,KAAK,KAAA;GAC5B,OAAO,OAAO,IAAI,OAAO,KAAK,KAAA;EAChC;CACF;CAEA,OAAO,EAAE,MAAM,MAAM;AACvB"}

package/dist/auth/device-code.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Generic RFC 8628 (OAuth 2.0 Device Authorization Grant) polling helpers.
+ *
+ * Ported from pi-mono's device-code utility, restructured as a single-step
+ * API so the same poll semantics can be driven two ways:
+ *   - `pollDeviceCodeUntilComplete()` — blocking loop for TUI flows.
+ *   - `stepDeviceCodePoll()` — exactly one upstream poll per call, with a
+ *     JSON-serializable `DeviceCodePollState` so web routes can persist the
+ *     state between HTTP requests (any replica can continue the poll).
+ *
+ * Inspired by pi-mono:
+ * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/device-code.ts
+ */
+/**
+ * Serializable poll-loop state. Safe to round-trip through JSON (e.g. a
+ * `pending jsonb` column) so device-code polling can span HTTP requests.
+ */
+export interface DeviceCodePollState {
+    /** ms epoch after which the device authorization is considered expired. */
+    deadlineAt: number;
+    /** Current base poll interval in ms (grows on slow_down responses). */
+    intervalMs: number;
+    /** Number of slow_down responses observed so far. */
+    slowDownResponses: number;
+}
+export declare function createDeviceCodePollState(options: {
+    /** Poll interval suggested by the server, in seconds. Defaults to 5 (RFC 8628). */
+    intervalSeconds?: number;
+    /** Lifetime of the device code, in seconds. */
+    expiresInSeconds: number;
+    /** Override "now" for tests. */
+    now?: number;
+}): DeviceCodePollState;
+/**
+ * Classified result of one upstream token-endpoint poll. Providers implement
+ * the HTTP request and map their response shape onto this union.
+ */
+export type DeviceCodePollOutcome<T> = {
+    status: 'complete';
+    result: T;
+} | {
+    status: 'pending';
+    intervalSeconds?: number;
+} | {
+    status: 'slow_down';
+    intervalSeconds?: number;
+} | {
+    status: 'failed';
+    error: string;
+};
+export type DeviceCodeStepResult<T> = {
+    status: 'complete';
+    result: T;
+    state: DeviceCodePollState;
+} | {
+    status: 'pending';
+    nextPollMs: number;
+    state: DeviceCodePollState;
+} | {
+    status: 'slow_down';
+    nextPollMs: number;
+    state: DeviceCodePollState;
+} | {
+    status: 'failed';
+    error: string;
+    state: DeviceCodePollState;
+};
+/**
+ * Delay to wait before the next poll, honoring slow_down growth and clamped
+ * to the remaining lifetime of the device code.
+ */
+export declare function nextPollDelayMs(state: DeviceCodePollState, now?: number): number;
+/**
+ * Perform exactly one upstream poll and fold the outcome into the poll state.
+ * Never throws for flow-level conditions — timeouts and provider errors are
+ * reported as `{ status: 'failed' }` so callers can persist/report them.
+ */
+export declare function stepDeviceCodePoll<T>(state: DeviceCodePollState, pollOnce: () => Promise<DeviceCodePollOutcome<T>>, now?: number): Promise<DeviceCodeStepResult<T>>;
+/** Sleep that can be interrupted by an AbortSignal. */
+export declare function abortableSleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Blocking poll loop for TUI flows: waits the appropriate interval between
+ * polls, honors slow_down growth, aborts on the signal, and throws on
+ * failure/timeout (with a clock-drift hint after slow_down responses).
+ */
+export declare function pollDeviceCodeUntilComplete<T>(options: {
+    state: DeviceCodePollState;
+    pollOnce: () => Promise<DeviceCodePollOutcome<T>>;
+    signal?: AbortSignal;
+    /** Override the sleep implementation for tests. */
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}): Promise<T>;
+//# sourceMappingURL=device-code.d.ts.map

package/dist/auth/device-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-code.d.ts","sourceRoot":"","sources":["../../src/auth/device-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,mBAAmB,CAWtB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAC/B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAC9B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACvE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAWpE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAK5F;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EACjD,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAiClC;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EAAE,OAAO,EAAE;IAC5D,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBb"}

package/dist/auth/device-code.js

@@ -0,0 +1,129 @@
+//#region src/auth/device-code.ts
+/**
+* Generic RFC 8628 (OAuth 2.0 Device Authorization Grant) polling helpers.
+*
+* Ported from pi-mono's device-code utility, restructured as a single-step
+* API so the same poll semantics can be driven two ways:
+*   - `pollDeviceCodeUntilComplete()` — blocking loop for TUI flows.
+*   - `stepDeviceCodePoll()` — exactly one upstream poll per call, with a
+*     JSON-serializable `DeviceCodePollState` so web routes can persist the
+*     state between HTTP requests (any replica can continue the poll).
+*
+* Inspired by pi-mono:
+* https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/device-code.ts
+*/
+const DEFAULT_INTERVAL_SECONDS = 5;
+const INITIAL_POLL_INTERVAL_MULTIPLIER = 1.2;
+const SLOW_DOWN_POLL_INTERVAL_MULTIPLIER = 1.4;
+const SLOW_DOWN_INTERVAL_INCREMENT_MS = 5e3;
+function createDeviceCodePollState(options) {
+	const now = options.now ?? Date.now();
+	const intervalSeconds = typeof options.intervalSeconds === "number" && options.intervalSeconds > 0 ? options.intervalSeconds : DEFAULT_INTERVAL_SECONDS;
+	return {
+		deadlineAt: now + options.expiresInSeconds * 1e3,
+		intervalMs: Math.max(1e3, Math.floor(intervalSeconds * 1e3)),
+		slowDownResponses: 0
+	};
+}
+function timeoutMessage(state) {
+	if (state.slowDownResponses > 0) return "Device flow timed out after one or more slow_down responses. This is often caused by clock drift in WSL or VM environments. Please sync or restart the VM clock and try again.";
+	return "Device flow timed out";
+}
+/**
+* Delay to wait before the next poll, honoring slow_down growth and clamped
+* to the remaining lifetime of the device code.
+*/
+function nextPollDelayMs(state, now = Date.now()) {
+	const multiplier = state.slowDownResponses > 0 ? SLOW_DOWN_POLL_INTERVAL_MULTIPLIER : INITIAL_POLL_INTERVAL_MULTIPLIER;
+	const remainingMs = Math.max(0, state.deadlineAt - now);
+	return Math.min(Math.ceil(state.intervalMs * multiplier), remainingMs);
+}
+/**
+* Perform exactly one upstream poll and fold the outcome into the poll state.
+* Never throws for flow-level conditions — timeouts and provider errors are
+* reported as `{ status: 'failed' }` so callers can persist/report them.
+*/
+async function stepDeviceCodePoll(state, pollOnce, now = Date.now()) {
+	if (now >= state.deadlineAt) return {
+		status: "failed",
+		error: timeoutMessage(state),
+		state
+	};
+	const outcome = await pollOnce();
+	switch (outcome.status) {
+		case "complete": return {
+			status: "complete",
+			result: outcome.result,
+			state
+		};
+		case "failed": return {
+			status: "failed",
+			error: outcome.error,
+			state
+		};
+		case "slow_down": {
+			const next = {
+				...state,
+				slowDownResponses: state.slowDownResponses + 1,
+				intervalMs: typeof outcome.intervalSeconds === "number" && outcome.intervalSeconds > 0 ? outcome.intervalSeconds * 1e3 : Math.max(1e3, state.intervalMs + SLOW_DOWN_INTERVAL_INCREMENT_MS)
+			};
+			return {
+				status: "slow_down",
+				nextPollMs: nextPollDelayMs(next, now),
+				state: next
+			};
+		}
+		case "pending": {
+			const next = typeof outcome.intervalSeconds === "number" && outcome.intervalSeconds > 0 ? {
+				...state,
+				intervalMs: Math.max(1e3, outcome.intervalSeconds * 1e3)
+			} : state;
+			return {
+				status: "pending",
+				nextPollMs: nextPollDelayMs(next, now),
+				state: next
+			};
+		}
+	}
+}
+/** Sleep that can be interrupted by an AbortSignal. */
+function abortableSleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(/* @__PURE__ */ new Error("Login cancelled"));
+			return;
+		}
+		let timeout;
+		const onAbort = () => {
+			clearTimeout(timeout);
+			reject(/* @__PURE__ */ new Error("Login cancelled"));
+		};
+		timeout = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* Blocking poll loop for TUI flows: waits the appropriate interval between
+* polls, honors slow_down growth, aborts on the signal, and throws on
+* failure/timeout (with a clock-drift hint after slow_down responses).
+*/
+async function pollDeviceCodeUntilComplete(options) {
+	let state = options.state;
+	const sleep = options.sleep ?? abortableSleep;
+	while (true) {
+		if (options.signal?.aborted) throw new Error("Login cancelled");
+		if (Date.now() >= state.deadlineAt) throw new Error(timeoutMessage(state));
+		await sleep(nextPollDelayMs(state), options.signal);
+		const step = await stepDeviceCodePoll(state, options.pollOnce);
+		state = step.state;
+		if (step.status === "complete") return step.result;
+		if (step.status === "failed") throw new Error(step.error);
+	}
+}
+//#endregion
+export { abortableSleep, createDeviceCodePollState, nextPollDelayMs, pollDeviceCodeUntilComplete, stepDeviceCodePoll };
+
+//# sourceMappingURL=device-code.js.map

package/dist/auth/device-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-code.js","names":[],"sources":["../../src/auth/device-code.ts"],"sourcesContent":["/**\n * Generic RFC 8628 (OAuth 2.0 Device Authorization Grant) polling helpers.\n *\n * Ported from pi-mono's device-code utility, restructured as a single-step\n * API so the same poll semantics can be driven two ways:\n *   - `pollDeviceCodeUntilComplete()` — blocking loop for TUI flows.\n *   - `stepDeviceCodePoll()` — exactly one upstream poll per call, with a\n *     JSON-serializable `DeviceCodePollState` so web routes can persist the\n *     state between HTTP requests (any replica can continue the poll).\n *\n * Inspired by pi-mono:\n * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/device-code.ts\n */\n\nconst DEFAULT_INTERVAL_SECONDS = 5;\nconst INITIAL_POLL_INTERVAL_MULTIPLIER = 1.2;\nconst SLOW_DOWN_POLL_INTERVAL_MULTIPLIER = 1.4;\nconst SLOW_DOWN_INTERVAL_INCREMENT_MS = 5000;\n\n/**\n * Serializable poll-loop state. Safe to round-trip through JSON (e.g. a\n * `pending jsonb` column) so device-code polling can span HTTP requests.\n */\nexport interface DeviceCodePollState {\n  /** ms epoch after which the device authorization is considered expired. */\n  deadlineAt: number;\n  /** Current base poll interval in ms (grows on slow_down responses). */\n  intervalMs: number;\n  /** Number of slow_down responses observed so far. */\n  slowDownResponses: number;\n}\n\nexport function createDeviceCodePollState(options: {\n  /** Poll interval suggested by the server, in seconds. Defaults to 5 (RFC 8628). */\n  intervalSeconds?: number;\n  /** Lifetime of the device code, in seconds. */\n  expiresInSeconds: number;\n  /** Override \"now\" for tests. */\n  now?: number;\n}): DeviceCodePollState {\n  const now = options.now ?? Date.now();\n  const intervalSeconds =\n    typeof options.intervalSeconds === 'number' && options.intervalSeconds > 0\n      ? options.intervalSeconds\n      : DEFAULT_INTERVAL_SECONDS;\n  return {\n    deadlineAt: now + options.expiresInSeconds * 1000,\n    intervalMs: Math.max(1000, Math.floor(intervalSeconds * 1000)),\n    slowDownResponses: 0,\n  };\n}\n\n/**\n * Classified result of one upstream token-endpoint poll. Providers implement\n * the HTTP request and map their response shape onto this union.\n */\nexport type DeviceCodePollOutcome<T> =\n  | { status: 'complete'; result: T }\n  | { status: 'pending'; intervalSeconds?: number }\n  | { status: 'slow_down'; intervalSeconds?: number }\n  | { status: 'failed'; error: string };\n\nexport type DeviceCodeStepResult<T> =\n  | { status: 'complete'; result: T; state: DeviceCodePollState }\n  | { status: 'pending'; nextPollMs: number; state: DeviceCodePollState }\n  | { status: 'slow_down'; nextPollMs: number; state: DeviceCodePollState }\n  | { status: 'failed'; error: string; state: DeviceCodePollState };\n\nfunction timeoutMessage(state: DeviceCodePollState): string {\n  if (state.slowDownResponses > 0) {\n    // Repeated slow_down responses followed by a timeout usually means the\n    // local clock is behind the server's (common in WSL/VMs after sleep).\n    return 'Device flow timed out after one or more slow_down responses. This is often caused by clock drift in WSL or VM environments. Please sync or restart the VM clock and try again.';\n  }\n  return 'Device flow timed out';\n}\n\n/**\n * Delay to wait before the next poll, honoring slow_down growth and clamped\n * to the remaining lifetime of the device code.\n */\nexport function nextPollDelayMs(state: DeviceCodePollState, now: number = Date.now()): number {\n  const multiplier =\n    state.slowDownResponses > 0 ? SLOW_DOWN_POLL_INTERVAL_MULTIPLIER : INITIAL_POLL_INTERVAL_MULTIPLIER;\n  const remainingMs = Math.max(0, state.deadlineAt - now);\n  return Math.min(Math.ceil(state.intervalMs * multiplier), remainingMs);\n}\n\n/**\n * Perform exactly one upstream poll and fold the outcome into the poll state.\n * Never throws for flow-level conditions — timeouts and provider errors are\n * reported as `{ status: 'failed' }` so callers can persist/report them.\n */\nexport async function stepDeviceCodePoll<T>(\n  state: DeviceCodePollState,\n  pollOnce: () => Promise<DeviceCodePollOutcome<T>>,\n  now: number = Date.now(),\n): Promise<DeviceCodeStepResult<T>> {\n  if (now >= state.deadlineAt) {\n    return { status: 'failed', error: timeoutMessage(state), state };\n  }\n\n  const outcome = await pollOnce();\n\n  switch (outcome.status) {\n    case 'complete':\n      return { status: 'complete', result: outcome.result, state };\n    case 'failed':\n      return { status: 'failed', error: outcome.error, state };\n    case 'slow_down': {\n      const next: DeviceCodePollState = {\n        ...state,\n        slowDownResponses: state.slowDownResponses + 1,\n        // RFC 8628 section 3.5: grow the interval by 5 seconds, unless the\n        // server told us the interval to use.\n        intervalMs:\n          typeof outcome.intervalSeconds === 'number' && outcome.intervalSeconds > 0\n            ? outcome.intervalSeconds * 1000\n            : Math.max(1000, state.intervalMs + SLOW_DOWN_INTERVAL_INCREMENT_MS),\n      };\n      return { status: 'slow_down', nextPollMs: nextPollDelayMs(next, now), state: next };\n    }\n    case 'pending': {\n      const next: DeviceCodePollState =\n        typeof outcome.intervalSeconds === 'number' && outcome.intervalSeconds > 0\n          ? { ...state, intervalMs: Math.max(1000, outcome.intervalSeconds * 1000) }\n          : state;\n      return { status: 'pending', nextPollMs: nextPollDelayMs(next, now), state: next };\n    }\n  }\n}\n\n/** Sleep that can be interrupted by an AbortSignal. */\nexport function abortableSleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error('Login cancelled'));\n      return;\n    }\n\n    let timeout: ReturnType<typeof setTimeout>;\n    const onAbort = () => {\n      clearTimeout(timeout);\n      reject(new Error('Login cancelled'));\n    };\n\n    timeout = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/**\n * Blocking poll loop for TUI flows: waits the appropriate interval between\n * polls, honors slow_down growth, aborts on the signal, and throws on\n * failure/timeout (with a clock-drift hint after slow_down responses).\n */\nexport async function pollDeviceCodeUntilComplete<T>(options: {\n  state: DeviceCodePollState;\n  pollOnce: () => Promise<DeviceCodePollOutcome<T>>;\n  signal?: AbortSignal;\n  /** Override the sleep implementation for tests. */\n  sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n}): Promise<T> {\n  let state = options.state;\n  const sleep = options.sleep ?? abortableSleep;\n\n  while (true) {\n    if (options.signal?.aborted) {\n      throw new Error('Login cancelled');\n    }\n    if (Date.now() >= state.deadlineAt) {\n      throw new Error(timeoutMessage(state));\n    }\n\n    await sleep(nextPollDelayMs(state), options.signal);\n\n    const step = await stepDeviceCodePoll(state, options.pollOnce);\n    state = step.state;\n\n    if (step.status === 'complete') {\n      return step.result;\n    }\n    if (step.status === 'failed') {\n      throw new Error(step.error);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/auth/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OAuth credential management for AI providers.
+ */
+export * from './types.js';
+export * from './provider-auth-error.js';
+export * from './storage.js';
+export * from './account-rotation-processor.js';
+export { anthropicOAuthProvider } from './providers/anthropic.js';
+export { githubCopilotOAuthProvider } from './providers/github-copilot.js';
+export { kimiCodingOAuthProvider } from './providers/kimi-coding.js';
+export { openaiCodexOAuthProvider } from './providers/openai-codex.js';
+export { xaiOAuthProvider } from './providers/xai.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,9 @@
+import { anthropicOAuthProvider } from "./providers/anthropic.js";
+import { githubCopilotOAuthProvider } from "./providers/github-copilot.js";
+import { kimiCodingOAuthProvider } from "./providers/kimi-coding.js";
+import { openaiCodexOAuthProvider } from "./providers/openai-codex.js";
+import { xaiOAuthProvider } from "./providers/xai.js";
+import { AuthStorage, PROVIDER_DEFAULT_MODELS, getOAuthProvider, getOAuthProviders } from "./storage.js";
+import { PROVIDER_AUTH_REQUIRED_ERROR, ProviderAuthRequiredError } from "./provider-auth-error.js";
+import { ACCOUNT_SWITCH_PART_TYPE, AccountRotationProcessor, AccountStartNoticeProcessor, MODEL_FALLBACK_PART_TYPE, MODEL_FALLBACK_STATE_KEY, PROVIDER_DISPLAY_NAMES, accountSwitchNoticeText, classifyRotationError, isAccountSwitchReason, isModelFallbackReason, modelFallbackNoticeText, providerFromError, providerFromModelId } from "./account-rotation-processor.js";
+export { ACCOUNT_SWITCH_PART_TYPE, AccountRotationProcessor, AccountStartNoticeProcessor, AuthStorage, MODEL_FALLBACK_PART_TYPE, MODEL_FALLBACK_STATE_KEY, PROVIDER_AUTH_REQUIRED_ERROR, PROVIDER_DEFAULT_MODELS, PROVIDER_DISPLAY_NAMES, ProviderAuthRequiredError, accountSwitchNoticeText, anthropicOAuthProvider, classifyRotationError, getOAuthProvider, getOAuthProviders, githubCopilotOAuthProvider, isAccountSwitchReason, isModelFallbackReason, kimiCodingOAuthProvider, modelFallbackNoticeText, openaiCodexOAuthProvider, providerFromError, providerFromModelId, xaiOAuthProvider };

package/dist/auth/pkce.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PKCE utilities using Web Crypto API.
+ * Works in both Node.js 20+ and browsers.
+ */
+/**
+ * Generate PKCE code verifier and challenge.
+ * Uses Web Crypto API for cross-platform compatibility.
+ */
+export declare function generatePKCE(): Promise<{
+    verifier: string;
+    challenge: string;
+}>;
+//# sourceMappingURL=pkce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.d.ts","sourceRoot":"","sources":["../../src/auth/pkce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAaD"}

package/dist/auth/pkce.js

@@ -0,0 +1,32 @@
+//#region src/auth/pkce.ts
+/**
+* PKCE utilities using Web Crypto API.
+* Works in both Node.js 20+ and browsers.
+*/
+/**
+* Encode bytes as base64url string.
+*/
+function base64urlEncode(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+/**
+* Generate PKCE code verifier and challenge.
+* Uses Web Crypto API for cross-platform compatibility.
+*/
+async function generatePKCE() {
+	const verifierBytes = /* @__PURE__ */ new Uint8Array(32);
+	crypto.getRandomValues(verifierBytes);
+	const verifier = base64urlEncode(verifierBytes);
+	const data = new TextEncoder().encode(verifier);
+	const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+	return {
+		verifier,
+		challenge: base64urlEncode(new Uint8Array(hashBuffer))
+	};
+}
+//#endregion
+export { generatePKCE };
+
+//# sourceMappingURL=pkce.js.map

package/dist/auth/pkce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.js","names":[],"sources":["../../src/auth/pkce.ts"],"sourcesContent":["/**\n * PKCE utilities using Web Crypto API.\n * Works in both Node.js 20+ and browsers.\n */\n\n/**\n * Encode bytes as base64url string.\n */\nfunction base64urlEncode(bytes: Uint8Array): string {\n  let binary = '';\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n  return btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n}\n\n/**\n * Generate PKCE code verifier and challenge.\n * Uses Web Crypto API for cross-platform compatibility.\n */\nexport async function generatePKCE(): Promise<{\n  verifier: string;\n  challenge: string;\n}> {\n  // Generate random verifier\n  const verifierBytes = new Uint8Array(32);\n  crypto.getRandomValues(verifierBytes);\n  const verifier = base64urlEncode(verifierBytes);\n\n  // Compute SHA-256 challenge\n  const encoder = new TextEncoder();\n  const data = encoder.encode(verifier);\n  const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n  const challenge = base64urlEncode(new Uint8Array(hashBuffer));\n\n  return { verifier, challenge };\n}\n"],"mappings":";;;;;;;;AAQA,SAAS,gBAAgB,OAA2B;CAClD,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,OACjB,UAAU,OAAO,aAAa,IAAI;CAEpC,OAAO,KAAK,MAAM,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,MAAM,EAAE;AAC9E;;;;;AAMA,eAAsB,eAGnB;CAED,MAAM,gCAAgB,IAAI,WAAW,EAAE;CACvC,OAAO,gBAAgB,aAAa;CACpC,MAAM,WAAW,gBAAgB,aAAa;CAI9C,MAAM,OAAO,IADO,YACD,CAAC,CAAC,OAAO,QAAQ;CACpC,MAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;CAG7D,OAAO;EAAE;EAAU,WAFD,gBAAgB,IAAI,WAAW,UAAU,CAEhC;CAAE;AAC/B"}

package/dist/auth/provider-auth-error.d.ts

@@ -0,0 +1,12 @@
+/** Wire-stable `Error.name`: the server flattens errors to `{ name, message }`, so hosts match on this. */
+export declare const PROVIDER_AUTH_REQUIRED_ERROR = "ProviderAuthRequiredError";
+/**
+ * A provider credential is missing or no longer usable. The message states the
+ * fact only — how the user re-authenticates is the host's call (`/login` in the
+ * TUI, Settings → Models in the factory web UI), so no host advertises a
+ * command another host doesn't have.
+ */
+export declare class ProviderAuthRequiredError extends Error {
+    readonly name = "ProviderAuthRequiredError";
+}
+//# sourceMappingURL=provider-auth-error.d.ts.map