@mastra/code-sdk 0.2.0-alpha.9 → 1.0.0-alpha.13

package/dist/goal-manager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/goal-manager.ts"],"sourcesContent":["/**\n * GoalManager — persistent cross-turn goals, backed by the Agent's native goal\n * mechanism.\n *\n * The objective lives in the durable `threadState` `'goal'` slot (via\n * `agent.setObjective`/`getObjective`/`clearObjective`/`updateObjectiveOptions`)\n * and is judged in-loop by the core goal step. This manager is a thin adapter:\n * it keeps a synchronous in-memory view of the current objective for the TUI\n * (status line, modal, keyboard shortcuts) and delegates persistence to the\n * agent. There is no standalone judge agent and no between-turn re-invocation —\n * the core goal step drives continuation and surfaces progress via `goal` stream\n * chunks.\n */\nimport { randomUUID } from 'node:crypto';\nimport type { Agent } from '@mastra/core/agent';\nimport type { AgentController, Session } from '@mastra/core/agent-controller';\nimport type { GoalObjectiveRecord } from '@mastra/core/storage';\nimport { loadSettings } from './onboarding/settings.js';\n\nexport interface GoalManagerState<TState extends Record<string, unknown> = Record<string, unknown>> {\n  controller: AgentController<TState>;\n  session: Session<TState>;\n}\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type GoalStatus = 'active' | 'paused' | 'done';\n\n/**\n * TUI-facing view of a goal. Derived from the durable {@link GoalObjectiveRecord}\n * plus the effective judge/max-runs settings, with display-only timer fields and\n * a stable `id` used to match plan-started goals.\n */\nexport interface GoalState {\n  id: string;\n  objective: string;\n  status: GoalStatus;\n  turnsUsed: number;\n  maxTurns: number;\n  judgeModelId: string;\n  startedAt: string;\n  activeStartedAt?: string;\n  activeDurationMs?: number;\n}\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nexport const DEFAULT_MAX_TURNS = 50;\nconst THREAD_GOAL_KEY = 'goal';\n\n// =============================================================================\n// GoalManager\n// =============================================================================\n\nexport class GoalManager {\n  /** Synchronous in-memory view of the active objective record (source of truth is ThreadState). */\n  private record: (GoalObjectiveRecord & { id: string }) | null = null;\n  /** Display-only active-timer accounting (not persisted to the objective record). */\n  private activeStartedAt: string | null = null;\n  private activeDurationMs = 0;\n  private persistGoalOnNextThreadCreate = false;\n\n  // ---------------------------------------------------------------------------\n  // Synchronous TUI surface\n  // ---------------------------------------------------------------------------\n\n  getGoal(): GoalState | null {\n    if (!this.record) return null;\n    const { judgeModelId, maxTurns } = this.effectiveSettings(this.record);\n    return {\n      id: this.record.id,\n      objective: this.record.objective,\n      status: this.record.status,\n      turnsUsed: this.record.runsUsed,\n      maxTurns,\n      judgeModelId,\n      startedAt: new Date(this.record.startedAt).toISOString(),\n      activeStartedAt: this.activeStartedAt ?? undefined,\n      activeDurationMs: this.activeDurationMs,\n    };\n  }\n\n  isActive(): boolean {\n    return this.record?.status === 'active';\n  }\n\n  persistOnNextThreadCreate(): void {\n    this.persistGoalOnNextThreadCreate = true;\n  }\n\n  consumePersistOnNextThreadCreate(): boolean {\n    if (!this.persistGoalOnNextThreadCreate) return false;\n    this.persistGoalOnNextThreadCreate = false;\n    return true;\n  }\n\n  startActiveTimer(): void {\n    if (this.record?.status === 'active' && !this.activeStartedAt) {\n      this.activeStartedAt = new Date().toISOString();\n    }\n  }\n\n  stopActiveTimer(): void {\n    if (!this.activeStartedAt) return;\n    const startedMs = Date.parse(this.activeStartedAt);\n    if (Number.isFinite(startedMs)) {\n      this.activeDurationMs += Math.max(0, Date.now() - startedMs);\n    }\n    this.activeStartedAt = null;\n  }\n\n  /** Reset active-timer accounting to zero (e.g. for an untriggered plan goal). */\n  resetActiveTimer(): void {\n    this.activeStartedAt = null;\n    this.activeDurationMs = 0;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Objective lifecycle (ThreadState-backed via the agent)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Set a new objective. Persists to ThreadState via `agent.setObjective` and\n   * updates the in-memory view. Only the provided settings are persisted into\n   * the record; unset ones fall back to the agent's `goal` config at read time.\n   */\n  async setGoal(\n    state: GoalManagerState,\n    objective: string,\n    judgeModelId: string,\n    maxTurns: number = DEFAULT_MAX_TURNS,\n  ): Promise<GoalState | null> {\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    const now = Date.now();\n    const id = randomUUID();\n\n    if (agent && threadId) {\n      const persisted = await agent.setObjective(objective, {\n        id,\n        threadId,\n        resourceId: state.session.identity.getResourceId(),\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n      });\n      this.record = persisted\n        ? { ...persisted, id: persisted.id ?? id }\n        : this.localRecord(objective, judgeModelId, maxTurns, now, id);\n    } else {\n      this.record = this.localRecord(objective, judgeModelId, maxTurns, now, id);\n    }\n\n    this.activeStartedAt = new Date(now).toISOString();\n    this.activeDurationMs = 0;\n    return this.getGoal();\n  }\n\n  /**\n   * Update the judge model / max-runs defaults. Persists into the active record\n   * (so the override is remembered in thread state) when a goal is set.\n   */\n  async updateJudgeDefaults(\n    state: GoalManagerState,\n    judgeModelId: string,\n    maxTurns: number,\n  ): Promise<GoalState | null> {\n    if (!this.record) return null;\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    if (agent && threadId) {\n      const updated = await agent.updateObjectiveOptions({\n        threadId,\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n      });\n      if (updated) this.record = { ...updated, id: this.record.id };\n    } else {\n      this.record = {\n        ...this.record,\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n        updatedAt: Date.now(),\n      };\n    }\n    return this.getGoal();\n  }\n\n  pause(reason?: string): GoalState | null {\n    if (this.record && this.record.status === 'active') {\n      this.stopActiveTimer();\n      this.record = { ...this.record, status: 'paused', pausedReason: reason, updatedAt: Date.now() };\n    }\n    return this.getGoal();\n  }\n\n  resume(): GoalState | null {\n    if (this.record && this.record.status === 'paused') {\n      this.record = { ...this.record, status: 'active', pausedReason: undefined, updatedAt: Date.now() };\n      this.startActiveTimer();\n    }\n    return this.getGoal();\n  }\n\n  markDone(): void {\n    if (this.record) {\n      this.stopActiveTimer();\n      this.record = { ...this.record, status: 'done', updatedAt: Date.now() };\n    }\n  }\n\n  clear(): void {\n    this.record = null;\n    this.activeStartedAt = null;\n    this.activeDurationMs = 0;\n    this.persistGoalOnNextThreadCreate = false;\n  }\n\n  /**\n   * Sync the latest objective record from ThreadState into the in-memory view.\n   * Called from the `goal` stream-chunk handler after each evaluation.\n   */\n  applyEvaluation(update: { runsUsed: number; status: GoalStatus }): GoalState | null {\n    if (!this.record) return null;\n    this.record = { ...this.record, runsUsed: update.runsUsed, status: update.status, updatedAt: Date.now() };\n    if (update.status !== 'active') this.stopActiveTimer();\n    return this.getGoal();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Persistence\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Persist the active objective to ThreadState via the agent. The objective\n   * record is the source of truth; the legacy thread-metadata key is cleared so\n   * stale state from older sessions does not resurface.\n   */\n  async saveToThread(state: GoalManagerState): Promise<void> {\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    try {\n      if (agent && threadId) {\n        if (this.record) {\n          // Push the current status/options into the existing record. If no\n          // record is persisted yet (e.g. first save), create one.\n          const updated = await agent.updateObjectiveOptions({\n            threadId,\n            status: this.record.status,\n            ...(this.record.pausedReason ? { pausedReason: this.record.pausedReason } : {}),\n            ...(this.record.judgeModelId ? { judgeModelId: this.record.judgeModelId } : {}),\n            ...(this.record.maxRuns !== undefined ? { maxRuns: this.record.maxRuns } : {}),\n          });\n          if (!updated) {\n            // No persisted record yet: create one. `setObjective` always writes\n            // `status: 'active'`, so re-apply the in-memory status afterwards if\n            // the local goal was already paused/done — otherwise the resumed\n            // thread state would no longer match the in-memory state.\n            const desiredStatus = this.record.status;\n            await agent.setObjective(this.record.objective, {\n              id: this.record.id,\n              threadId,\n              resourceId: state.session.identity.getResourceId(),\n              ...(this.record.judgeModelId ? { judgeModelId: this.record.judgeModelId } : {}),\n              ...(this.record.maxRuns !== undefined ? { maxRuns: this.record.maxRuns } : {}),\n            });\n            if (desiredStatus !== 'active') {\n              await agent.updateObjectiveOptions({\n                threadId,\n                status: desiredStatus,\n                ...(this.record.pausedReason ? { pausedReason: this.record.pausedReason } : {}),\n              });\n            }\n          }\n        } else {\n          await agent.clearObjective({ threadId });\n        }\n      }\n      // Clear any legacy thread-metadata goal so it can't shadow the record.\n      await state.session.thread.setSetting({ key: THREAD_GOAL_KEY, value: undefined });\n    } catch {\n      // Persistence is not critical.\n    }\n  }\n\n  /**\n   * Load the objective from ThreadState (called on thread switch). Falls back to\n   * the legacy thread-metadata goal for threads created before this migration.\n   */\n  async loadFromThread(state: GoalManagerState): Promise<void> {\n    this.persistGoalOnNextThreadCreate = false;\n    this.activeStartedAt = null;\n    this.activeDurationMs = 0;\n\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    if (agent && threadId) {\n      try {\n        const record = await agent.getObjective({ threadId });\n        if (record) {\n          this.record = { ...record, id: record.id ?? randomUUID() };\n          return;\n        }\n      } catch {\n        // fall through to legacy metadata\n      }\n    }\n    this.record = null;\n  }\n\n  /**\n   * Legacy entry point retained for thread-switch call sites that only have the\n   * thread metadata available. Hydrates from a previously-persisted GoalState.\n   */\n  loadFromThreadMetadata(metadata: Record<string, unknown> | undefined): void {\n    const saved = metadata?.[THREAD_GOAL_KEY] as Partial<GoalState> | undefined;\n    this.persistGoalOnNextThreadCreate = false;\n    this.activeStartedAt = null;\n    this.activeDurationMs = 0;\n    if (saved && saved.objective && saved.status) {\n      this.record = {\n        objective: saved.objective,\n        status: saved.status,\n        runsUsed: saved.turnsUsed ?? 0,\n        maxRuns: saved.maxTurns ?? DEFAULT_MAX_TURNS,\n        judgeModelId: saved.judgeModelId ?? '',\n        startedAt: saved.startedAt ? Date.parse(saved.startedAt) || Date.now() : Date.now(),\n        updatedAt: Date.now(),\n        id: saved.id ?? randomUUID(),\n      };\n      this.activeDurationMs = saved.activeDurationMs ?? 0;\n    } else {\n      this.record = null;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private\n  // ---------------------------------------------------------------------------\n\n  private getAgent(state: GoalManagerState): Agent | undefined {\n    try {\n      return state.controller.getCurrentAgent(state.session);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /** Resolve effective judge model + max runs (record value → settings default). */\n  private effectiveSettings(record: GoalObjectiveRecord): { judgeModelId: string; maxTurns: number } {\n    const settings = loadSettings();\n    return {\n      judgeModelId: record.judgeModelId ?? settings.models.goalJudgeModel ?? '',\n      maxTurns: record.maxRuns ?? settings.models.goalMaxTurns ?? DEFAULT_MAX_TURNS,\n    };\n  }\n\n  private localRecord(\n    objective: string,\n    judgeModelId: string,\n    maxTurns: number,\n    now: number,\n    id: string,\n  ): GoalObjectiveRecord & { id: string } {\n    return {\n      objective,\n      status: 'active',\n      runsUsed: 0,\n      maxRuns: maxTurns,\n      ...(judgeModelId ? { judgeModelId } : {}),\n      startedAt: now,\n      updatedAt: now,\n      id,\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/goal-manager.ts"],"sourcesContent":["/**\n * GoalManager — persistent cross-turn goals, backed by the Agent's native goal\n * mechanism.\n *\n * The objective lives in the durable `threadState` `'goal'` slot (via\n * `agent.setObjective`/`getObjective`/`clearObjective`/`updateObjectiveOptions`)\n * and is judged in-loop by the core goal step. This manager is a thin adapter:\n * it keeps a synchronous in-memory view of the current objective for the TUI\n * (status line, modal, keyboard shortcuts) and delegates persistence to the\n * agent. There is no standalone judge agent and no between-turn re-invocation —\n * the core goal step drives continuation and surfaces progress via `goal` stream\n * chunks.\n */\nimport { randomUUID } from 'node:crypto';\nimport { getGoalActivityDurationMs } from '@mastra/core/agent';\nimport type { Agent } from '@mastra/core/agent';\nimport type { AgentController, Session } from '@mastra/core/agent-controller';\nimport type { GoalObjectiveRecord } from '@mastra/core/storage';\nimport { loadSettings } from './onboarding/settings.js';\n\nexport interface GoalManagerState<TState extends Record<string, unknown> = Record<string, unknown>> {\n  controller: AgentController<TState>;\n  session: Session<TState>;\n}\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type GoalStatus = 'active' | 'paused' | 'done';\n\n/**\n * TUI-facing view of a goal. Derived from the durable {@link GoalObjectiveRecord}\n * plus the effective judge/max-runs settings, with display-only timer fields and\n * a stable `id` used to match plan-started goals.\n */\nexport interface GoalState {\n  id: string;\n  objective: string;\n  status: GoalStatus;\n  turnsUsed: number;\n  maxTurns: number;\n  judgeModelId: string;\n  startedAt: string;\n  activeStartedAt?: string;\n  activeDurationMs?: number;\n}\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nexport const DEFAULT_MAX_TURNS = 50;\nconst THREAD_GOAL_KEY = 'goal';\n\nfunction normalizeActiveDurationMs(value: number | undefined): number {\n  return value !== undefined && Number.isFinite(value) && value >= 0 ? value : 0;\n}\n\n// =============================================================================\n// GoalManager\n// =============================================================================\n\nexport class GoalManager {\n  /** Synchronous in-memory view of the active objective record (source of truth is ThreadState). */\n  private record: (GoalObjectiveRecord & { id: string }) | null = null;\n  private threadId: string | undefined;\n  private agentId: string | undefined;\n  private persistGoalOnNextThreadCreate = false;\n\n  // ---------------------------------------------------------------------------\n  // Synchronous TUI surface\n  // ---------------------------------------------------------------------------\n\n  getGoal(): GoalState | null {\n    if (!this.record) return null;\n    const { judgeModelId, maxTurns } = this.effectiveSettings(this.record);\n    return {\n      id: this.record.id,\n      objective: this.record.objective,\n      status: this.record.status,\n      turnsUsed: this.record.runsUsed,\n      maxTurns,\n      judgeModelId,\n      startedAt: new Date(this.record.startedAt).toISOString(),\n      activeDurationMs:\n        this.agentId && this.threadId\n          ? getGoalActivityDurationMs({\n              agentId: this.agentId,\n              threadId: this.threadId,\n              objectiveId: this.record.id,\n              activeDurationMs: this.record.activeDurationMs,\n            })\n          : normalizeActiveDurationMs(this.record.activeDurationMs),\n    };\n  }\n\n  isActive(): boolean {\n    return this.record?.status === 'active';\n  }\n\n  persistOnNextThreadCreate(): void {\n    this.persistGoalOnNextThreadCreate = true;\n  }\n\n  consumePersistOnNextThreadCreate(): boolean {\n    if (!this.persistGoalOnNextThreadCreate) return false;\n    this.persistGoalOnNextThreadCreate = false;\n    return true;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Objective lifecycle (ThreadState-backed via the agent)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Set a new objective. Persists to ThreadState via `agent.setObjective` and\n   * updates the in-memory view. Only the provided settings are persisted into\n   * the record; unset ones fall back to the agent's `goal` config at read time.\n   */\n  async setGoal(\n    state: GoalManagerState,\n    objective: string,\n    judgeModelId: string,\n    maxTurns: number = DEFAULT_MAX_TURNS,\n  ): Promise<GoalState | null> {\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    const now = Date.now();\n    const id = randomUUID();\n    this.threadId = threadId ?? undefined;\n    this.agentId = agent?.id;\n\n    if (agent && threadId) {\n      const persisted = await agent.setObjective(objective, {\n        id,\n        threadId,\n        resourceId: state.session.identity.getResourceId(),\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n      });\n      this.record = persisted\n        ? { ...persisted, id: persisted.id ?? id }\n        : this.localRecord(objective, judgeModelId, maxTurns, now, id);\n    } else {\n      this.record = this.localRecord(objective, judgeModelId, maxTurns, now, id);\n    }\n\n    return this.getGoal();\n  }\n\n  /**\n   * Update the judge model / max-runs defaults. Persists into the active record\n   * (so the override is remembered in thread state) when a goal is set.\n   */\n  async updateJudgeDefaults(\n    state: GoalManagerState,\n    judgeModelId: string,\n    maxTurns: number,\n  ): Promise<GoalState | null> {\n    if (!this.record) return null;\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    if (agent && threadId) {\n      const updated = await agent.updateObjectiveOptions({\n        threadId,\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n      });\n      if (updated) this.record = { ...updated, id: this.record.id };\n    } else {\n      this.record = {\n        ...this.record,\n        ...(judgeModelId ? { judgeModelId } : {}),\n        maxRuns: maxTurns,\n        updatedAt: Date.now(),\n      };\n    }\n    return this.getGoal();\n  }\n\n  pause(reason?: string): GoalState | null {\n    if (this.record && this.record.status === 'active') {\n      this.record = { ...this.record, status: 'paused', pausedReason: reason, updatedAt: Date.now() };\n    }\n    return this.getGoal();\n  }\n\n  resume(): GoalState | null {\n    if (this.record && this.record.status === 'paused') {\n      this.record = { ...this.record, status: 'active', pausedReason: undefined, updatedAt: Date.now() };\n    }\n    return this.getGoal();\n  }\n\n  markDone(): void {\n    if (this.record) {\n      this.record = { ...this.record, status: 'done', updatedAt: Date.now() };\n    }\n  }\n\n  clear(): void {\n    this.record = null;\n    this.threadId = undefined;\n    this.agentId = undefined;\n    this.persistGoalOnNextThreadCreate = false;\n  }\n\n  /**\n   * Sync the latest objective record from ThreadState into the in-memory view.\n   * Called from the `goal` stream-chunk handler after each evaluation.\n   */\n  applyEvaluation(update: { runsUsed: number; status: GoalStatus }): GoalState | null {\n    if (!this.record) return null;\n    this.record = { ...this.record, runsUsed: update.runsUsed, status: update.status, updatedAt: Date.now() };\n    return this.getGoal();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Persistence\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Persist the active objective to ThreadState via the agent. The objective\n   * record is the source of truth; the legacy thread-metadata key is cleared so\n   * stale state from older sessions does not resurface.\n   */\n  async saveToThread(state: GoalManagerState): Promise<void> {\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    try {\n      if (agent && threadId) {\n        if (this.record) {\n          // Push the current status/options into the existing record. If no\n          // record is persisted yet (e.g. first save), create one.\n          const updated = await agent.updateObjectiveOptions({\n            threadId,\n            status: this.record.status,\n            ...(this.record.pausedReason ? { pausedReason: this.record.pausedReason } : {}),\n            ...(this.record.judgeModelId ? { judgeModelId: this.record.judgeModelId } : {}),\n            ...(this.record.maxRuns !== undefined ? { maxRuns: this.record.maxRuns } : {}),\n          });\n          if (!updated) {\n            // No persisted record yet: create one. `setObjective` always writes\n            // `status: 'active'`, so re-apply the in-memory status afterwards if\n            // the local goal was already paused/done — otherwise the resumed\n            // thread state would no longer match the in-memory state.\n            const desiredStatus = this.record.status;\n            await agent.setObjective(this.record.objective, {\n              id: this.record.id,\n              threadId,\n              resourceId: state.session.identity.getResourceId(),\n              activeDurationMs: normalizeActiveDurationMs(this.record.activeDurationMs),\n              ...(this.record.judgeModelId ? { judgeModelId: this.record.judgeModelId } : {}),\n              ...(this.record.maxRuns !== undefined ? { maxRuns: this.record.maxRuns } : {}),\n            });\n            if (desiredStatus !== 'active') {\n              await agent.updateObjectiveOptions({\n                threadId,\n                status: desiredStatus,\n                ...(this.record.pausedReason ? { pausedReason: this.record.pausedReason } : {}),\n              });\n            }\n          }\n        } else {\n          await agent.clearObjective({ threadId });\n        }\n      }\n      // Clear any legacy thread-metadata goal so it can't shadow the record.\n      await state.session.thread.setSetting({ key: THREAD_GOAL_KEY, value: undefined });\n    } catch {\n      // Persistence is not critical.\n    }\n  }\n\n  /**\n   * Load the objective from ThreadState (called on thread switch). Falls back to\n   * the legacy thread-metadata goal for threads created before this migration.\n   */\n  async loadFromThread(state: GoalManagerState): Promise<void> {\n    this.persistGoalOnNextThreadCreate = false;\n\n    const threadId = state.session.thread.getId();\n    const agent = this.getAgent(state);\n    this.threadId = threadId ?? undefined;\n    this.agentId = agent?.id;\n    if (agent && threadId) {\n      try {\n        const record = await agent.getObjective({ threadId });\n        if (record) {\n          this.record = {\n            ...record,\n            id: record.id ?? randomUUID(),\n            activeDurationMs: normalizeActiveDurationMs(record.activeDurationMs),\n          };\n          return;\n        }\n      } catch {\n        // fall through to legacy metadata\n      }\n    }\n    this.record = null;\n  }\n\n  /**\n   * Legacy entry point retained for thread-switch call sites that only have the\n   * thread metadata available. Hydrates from a previously-persisted GoalState.\n   */\n  loadFromThreadMetadata(metadata: Record<string, unknown> | undefined): void {\n    const saved = metadata?.[THREAD_GOAL_KEY] as Partial<GoalState> | undefined;\n    this.persistGoalOnNextThreadCreate = false;\n    this.threadId = undefined;\n    this.agentId = undefined;\n    if (saved && saved.objective && saved.status) {\n      this.record = {\n        objective: saved.objective,\n        status: saved.status,\n        runsUsed: saved.turnsUsed ?? 0,\n        activeDurationMs: normalizeActiveDurationMs(saved.activeDurationMs),\n        maxRuns: saved.maxTurns ?? DEFAULT_MAX_TURNS,\n        judgeModelId: saved.judgeModelId ?? '',\n        startedAt: saved.startedAt ? Date.parse(saved.startedAt) || Date.now() : Date.now(),\n        updatedAt: Date.now(),\n        id: saved.id ?? randomUUID(),\n      };\n    } else {\n      this.record = null;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private\n  // ---------------------------------------------------------------------------\n\n  private getAgent(state: GoalManagerState): Agent | undefined {\n    try {\n      return state.controller.getCurrentAgent(state.session);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /** Resolve effective judge model + max runs (record value → settings default). */\n  private effectiveSettings(record: GoalObjectiveRecord): { judgeModelId: string; maxTurns: number } {\n    const settings = loadSettings();\n    return {\n      judgeModelId: record.judgeModelId ?? settings.models.goalJudgeModel ?? '',\n      maxTurns: record.maxRuns ?? settings.models.goalMaxTurns ?? DEFAULT_MAX_TURNS,\n    };\n  }\n\n  private localRecord(\n    objective: string,\n    judgeModelId: string,\n    maxTurns: number,\n    now: number,\n    id: string,\n  ): GoalObjectiveRecord & { id: string } {\n    return {\n      objective,\n      status: 'active',\n      runsUsed: 0,\n      activeDurationMs: 0,\n      maxRuns: maxTurns,\n      ...(judgeModelId ? { judgeModelId } : {}),\n      startedAt: now,\n      updatedAt: now,\n      id,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { AgentController } from '@mastra/core/agent-controller';
 import type { IntervalHandler, AgentControllerConfig, AgentControllerMode, AgentControllerSubagent, Session } from '@mastra/core/agent-controller';
 import type { PubSub } from '@mastra/core/events';
 import { Mastra } from '@mastra/core/mastra';
+import type { InputProcessor } from '@mastra/core/processors';
 import { RequestContext } from '@mastra/core/request-context';
 import type { ApiRoute } from '@mastra/core/server';
 import { MastraCompositeStore } from '@mastra/core/storage';
@@ -32,6 +33,11 @@ export interface MastraCodeConfig {
     }) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);
     /** Observe completed tool calls without replacing or modifying the built-in tool implementation. */
     postToolObserver?: PostToolObserver;
+    /**
+     * Stateless input processor instances prepended before Mastra Code's mandatory processors.
+     * Embedders may extend processing but cannot replace built-in safety and compatibility policy.
+     */
+    inputProcessors?: InputProcessor[];
     /** Tools removed from the dynamic tool set before exposure to the model */
     disabledTools?: string[];
     /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAErB,mBAAmB,EACnB,uBAAuB,EAEvB,OAAO,EACR,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAQ7C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAmB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EACL,aAAa,EAId,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAA+D,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAU9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AASrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAoEzE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACtC,uIAAuI;IACvI,UAAU,CAAC,EACP,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GACpC,CAAC,CAAC,GAAG,EAAE;QACL,cAAc,EAAE,cAAc,CAAC;KAChC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAChG,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,oBAAoB,CAAC;IAC/C,mGAAmG;IACnG,cAAc,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,kGAAkG;IAClG,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,uGAAuG;IACvG,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACxC,6FAA6F;IAC7F,WAAW,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC,aAAa,CAAC,CAAC;IACpE,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,kGAAkG;IAClG,SAAS,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC;IAChE,oMAAoM;IACpM,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4GAA4G;IAC5G,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAClE,wGAAwG;IACxG,OAAO,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5D,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,iBAAiB,gBAOhC;AA2CD,wBAAsB,+BAA+B,CAAC,MAAM,CAAC,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;gCAonB/C,OAAO,CAAC,eAAe,CAAC;GAIvD;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC;AAEpG;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,aAAa,GAAG,eAAe,GAAG,kBAAkB,CAAC,EAC3F,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,CAAC,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;gCA/ExC,OAAO,CAAC,eAAe,CAAC;GAyFvD;AAED,6FAA6F;AAC7F,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,CAAC,EAAE,gBAAgB,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,KAAK,QAAQ,EAAE,CAAC;IACjH;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QACzB,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC5C,WAAW,EAAE,WAAW,CAAC;KAC1B,KAAK,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;CACzF,GACA,OAAO,CAAC,iBAAiB,CAAC,CAY5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,CAAC,EAAE,gBAAgB,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,KAAK,QAAQ,EAAE,CAAC;IACjH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QACzB,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC5C,WAAW,EAAE,WAAW,CAAC;KAC1B,KAAK,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;CACzF,GACA,OAAO,CAAC;IACT,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC;IAClE,UAAU,EAAE,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC,CA6BD;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,iCAA2B,CAAC;AAEzD;;;;GAIG;AACH,OAAO,EACL,KAAK,EACL,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,KAAK,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -401,6 +401,7 @@ async function createMastraCodeAgentController(config) {
       tools: getGoalJudgeTools
     },
     inputProcessors: [
+      ...config?.inputProcessors ?? [],
       new PlanRejectionAbortProcessor(),
       new AgentsMDInjector({
         getIgnoredInstructionPaths: ({ requestContext }) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { hostname } from 'node:os';\nimport path from 'node:path';\n\nimport type { Agent } from '@mastra/core/agent';\nimport { AgentController } from '@mastra/core/agent-controller';\nimport type {\n  IntervalHandler,\n  AgentControllerConfig,\n  AgentControllerEvent,\n  AgentControllerMode,\n  AgentControllerSubagent,\n  AgentControllerRequestContext,\n  Session,\n} from '@mastra/core/agent-controller';\nimport { createCodingAgent } from '@mastra/core/coding-agent';\nimport type { PubSub } from '@mastra/core/events';\nimport { PROVIDER_REGISTRY } from '@mastra/core/llm';\nimport type { ProviderConfig } from '@mastra/core/llm';\nimport { Mastra } from '@mastra/core/mastra';\nimport {\n  AgentsMDInjector,\n  isBadRequestError,\n  PrefillErrorHandler,\n  ProviderHistoryCompat,\n  StreamErrorRetryProcessor,\n} from '@mastra/core/processors';\nimport { RequestContext } from '@mastra/core/request-context';\nimport type { PublicSchema } from '@mastra/core/schema';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { TaskSignalProvider } from '@mastra/core/signals';\nimport { InMemoryHarness, MastraCompositeStore } from '@mastra/core/storage';\nimport { DEFAULT_GOAL_JUDGE_PROMPT } from '@mastra/core/tools';\nimport type { MastraVector } from '@mastra/core/vector';\nimport { DuckDBStore } from '@mastra/duckdb';\n\nimport { GithubSignals } from '@mastra/github-signals';\nimport { LibSQLStore, LibSQLVector } from '@mastra/libsql';\nimport {\n  Observability,\n  MastraStorageExporter,\n  MastraPlatformExporter,\n  SensitiveDataFilter,\n} from '@mastra/observability';\nimport { PostgresStore } from '@mastra/pg';\n\nimport { hasCredentialStoreProvider } from './agents/credential-resolver.js';\nimport { getDynamicInstructions } from './agents/instructions.js';\nimport { getDynamicMemory } from './agents/memory.js';\nimport { createMastraCodeGateway, getDynamicModel, getGoalJudgeModel, resolveModel } from './agents/model.js';\nimport { buildMode } from './agents/modes/build.js';\nimport { fastMode } from './agents/modes/explore.js';\nimport { planMode } from './agents/modes/plan.js';\nimport { getStaticallyLoadedInstructionPaths } from './agents/prompts/agent-instructions.js';\n// import { executeSubagent } from './agents/subagents/execute.js';\n// import { exploreSubagent } from './agents/subagents/explore.js';\n// import { planSubagent } from './agents/subagents/plan.js';\nimport { attachOMThreadStatePersistence, restoreOMThreadStateForCurrentThread } from './agents/thread-caveman-state.js';\nimport { createDynamicTools, createToolHooks } from './agents/tools.js';\nimport type { PostToolObserver, ToolLike } from './agents/tools.js';\n\nimport { getDynamicWorkspace, getGoalJudgeTools } from './agents/workspace.js';\nimport { AuthStorage } from './auth/storage.js';\nimport { DEFAULT_CONFIG_DIR, validateConfigDirName } from './constants.js';\nimport { createOutcomeScorer, createEfficiencyScorer } from './evals/scorers/index.js';\nimport { HookManager } from './hooks/index.js';\nimport { createMcpManager } from './mcp/index.js';\nimport type { McpServerConfig } from './mcp/index.js';\nimport type { ProviderAccess } from './onboarding/packs.js';\nimport { getAvailableModePacks, getAvailableOmPacks } from './onboarding/packs.js';\nimport {\n  loadSettings,\n  MASTRA_GATEWAY_PROVIDER,\n  OBSERVABILITY_AUTH_PREFIX,\n  resolveModelDefaults,\n  resolveOmRoleModel,\n  saveSettings,\n} from './onboarding/settings.js';\nimport { getToolCategory } from './permissions.js';\nimport { PluginManager } from './plugins/manager.js';\nimport { PlanRejectionAbortProcessor } from './processors/plan-rejection-abort.js';\nimport { createAmazonBedrockGateway } from './providers/amazon-bedrock-gateway.js';\nimport { setAuthStorage } from './providers/claude-max.js';\nimport { setAuthStorage as setGitHubCopilotAuthStorage } from './providers/github-copilot.js';\nimport { setAuthStorage as setOpenAIAuthStorage } from './providers/openai-codex.js';\nimport { setAuthStorage as setXAIAuthStorage } from './providers/xai.js';\n\nimport { stateSchema } from './schema.js';\nimport type { MastraCodeState } from './schema.js';\n\nimport { mastraBrand } from './theme-palette.js';\nimport { syncGateways } from './utils/gateway-sync.js';\nimport {\n  detectProject,\n  getObservabilityDatabasePath,\n  getStorageConfig,\n  getResourceIdOverride,\n} from './utils/project.js';\nimport type { StorageConfig } from './utils/project.js';\nimport { createSignalsPubSub } from './utils/signals-pubsub.js';\nimport { createStorage, createVectorStore } from './utils/storage-factory.js';\nimport type { StorageResult } from './utils/storage-factory.js';\nimport { createStorageMaintenance, DEFAULT_RETENTION, resolveLocalDbFiles } from './utils/storage-maintenance.js';\nimport type { StorageMaintenance } from './utils/storage-maintenance.js';\nimport { acquireThreadLock, releaseThreadLock } from './utils/thread-lock.js';\n\nconst CODE_AGENT_ID = 'code-agent';\n\n// Global retry policy for transient connection failures (e.g. provider sockets dropping mid-stream).\n// Applied centrally to every model call via StreamErrorRetryProcessor, independent of model-pack\n// settings, so all modes/subagents benefit from a short wait before retrying a dropped connection.\n// Delay uses exponential backoff: initialDelay * 2^retryCount, capped at maxDelay.\nconst MASTRACODE_TRANSIENT_CONNECTION_MAX_RETRIES = 2;\nconst MASTRACODE_TRANSIENT_CONNECTION_RETRY_INITIAL_DELAY_MS = 1000;\nconst MASTRACODE_TRANSIENT_CONNECTION_RETRY_MAX_DELAY_MS = 30000;\n\nconst TRANSIENT_CONNECTION_ERROR_CODES = new Set(['ECONNRESET', 'EPIPE']);\nconst TRANSIENT_CONNECTION_MESSAGE_PATTERN = /econnreset|socket hang up|write epipe|other side closed/i;\n\n/**\n * Matcher for transient connection failures. Cause-chain traversal is handled\n * by `StreamErrorRetryProcessor.isRetryableStreamError`, which calls each\n * matcher at every level of the cause chain.\n */\nfunction isTransientConnectionError(error: unknown): boolean {\n  if (!error) return false;\n\n  const code = typeof error === 'object' && 'code' in error ? (error as { code?: unknown }).code : undefined;\n  if (typeof code === 'string' && TRANSIENT_CONNECTION_ERROR_CODES.has(code.toUpperCase())) return true;\n\n  const message = error instanceof Error ? error.message : undefined;\n  if (typeof message === 'string' && TRANSIENT_CONNECTION_MESSAGE_PATTERN.test(message)) return true;\n\n  return false;\n}\n\n/** Short deterministic hash (sha256, first 12 hex chars) matching project.ts shortHash style. */\nfunction shortHash(input: string): string {\n  return createHash('sha256').update(input).digest('hex').slice(0, 12);\n}\n\nfunction applyEffectiveDefaultsToModes(\n  modes: AgentControllerMode[],\n  effectiveDefaults: Record<string, string>,\n): AgentControllerMode[] {\n  return modes.map(mode => {\n    const savedModel = effectiveDefaults[mode.id];\n    if (!savedModel) {\n      return mode;\n    }\n    return {\n      ...mode,\n      defaultModelId: savedModel,\n    };\n  });\n}\n\nfunction addPluginToolsToModeAllowlists(\n  modes: AgentControllerMode[],\n  pluginToolNames: string[],\n): AgentControllerMode[] {\n  if (pluginToolNames.length === 0) return modes;\n  return modes.map(mode => {\n    if (!mode.availableTools) return mode;\n    return {\n      ...mode,\n      availableTools: Array.from(new Set([...mode.availableTools, ...pluginToolNames])),\n    };\n  });\n}\n\nexport interface MastraCodeConfig {\n  /** Working directory for project detection. Default: process.cwd() */\n  cwd?: string;\n  /** Home directory for global config discovery. Default: os.homedir() */\n  homeDir?: string;\n  /** Override modes (model IDs, colors, which modes exist). Default: build/plan/fast */\n  modes?: AgentControllerMode[];\n  /** Override or extend subagent definitions. Default: explore/plan/execute */\n  subagents?: AgentControllerSubagent[];\n  /** Extra tools merged into the dynamic tool set. Can be a static record or a (sync or async) function that receives requestContext. */\n  extraTools?:\n    | Record<string, ToolLike | undefined>\n    | ((ctx: {\n        requestContext: RequestContext;\n      }) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);\n  /** Observe completed tool calls without replacing or modifying the built-in tool implementation. */\n  postToolObserver?: PostToolObserver;\n  /** Tools removed from the dynamic tool set before exposure to the model */\n  disabledTools?: string[];\n  /**\n   * Custom storage config instead of auto-detected default, or a pre-built\n   * store instance. An instance is used as-is: no connection test and no\n   * LibSQL fallback — if the injected store fails, that's a hard error.\n   */\n  storage?: StorageConfig | MastraCompositeStore;\n  /** Backend for an injected custom storage instance. Inferred for LibSQLStore and PostgresStore. */\n  storageBackend?: 'libsql' | 'pg';\n  /** Pre-built vector store instance for recall search. Skips the default vector store creation. */\n  vector?: MastraVector;\n  /** Observational memory scope. Default: auto-detected from env/config files, falls back to 'thread' */\n  omScope?: 'thread' | 'resource';\n  /** Path to a custom settings.json file. Default: global settings */\n  settingsPath?: string;\n  /** Initial state overrides (yolo, thinkingLevel, etc.) */\n  initialState?: Partial<MastraCodeState>;\n  /** Override id generation for threads/messages. Primarily useful for deterministic tests. */\n  idGenerator?: AgentControllerConfig<MastraCodeState>['idGenerator'];\n  /** Override interval handlers. Default: gateway-sync */\n  intervalHandlers?: IntervalHandler[];\n  /** Override the workspace. Default: local filesystem + local sandbox based on detected project */\n  workspace?: AgentControllerConfig<MastraCodeState>['workspace'];\n  /** Override the config directory name. Default: '.mastracode'. Replaces '.mastracode' in all project-level and global config paths (MCP, hooks, commands, database, skills, agent instructions). */\n  configDir?: string;\n  /** Programmatic MCP server configurations, merged with (and overriding) file-based configs. */\n  mcpServers?: Record<string, McpServerConfig>;\n  /** Disable MCP server discovery. Default: false */\n  disableMcp?: boolean;\n  /** Disable hooks. Default: false */\n  disableHooks?: boolean;\n  /** Disable plugin discovery/loading. Default: false */\n  disablePlugins?: boolean;\n  /** Disable the polling-based GitHub signal provider even when enabled in global settings. Default: false */\n  disableGithubSignals?: boolean;\n  /** Override the plugin manager. Primarily useful for tests or embedding. */\n  pluginManager?: PluginManager;\n  /**\n   * Override the memory instance (or dynamic factory) passed to the AgentController.\n   * When provided, this replaces the default `getDynamicMemory(storage, vector)` which\n   * uses mastracode's built-in model gateway (Anthropic OAuth, OpenAI Codex,\n   * custom providers, and models.dev fallback).\n   *\n   * Use this when you need to override memory model behavior completely.\n   */\n  memory?: AgentControllerConfig<MastraCodeState>['memory'] | false;\n  /** Browser provider for browser automation tools. When set, the agent gains access to browser tools. */\n  browser?: AgentControllerConfig<MastraCodeState>['browser'];\n  /** PubSub for signal routing. When crossProcessPubSub is true, thread locks are disabled. */\n  pubsub?: PubSub;\n  /** Use Mastra Code's built-in Unix socket PubSub for local cross-process signal routing. */\n  unixSocketPubSub?: boolean;\n  /** Marks the configured PubSub as cross-process-safe, allowing Mastra Code to skip file thread locks. */\n  crossProcessPubSub?: boolean;\n}\n\nexport function createAuthStorage() {\n  const authStorage = new AuthStorage();\n  setAuthStorage(authStorage);\n  setOpenAIAuthStorage(authStorage);\n  setGitHubCopilotAuthStorage(authStorage);\n  setXAIAuthStorage(authStorage);\n  return authStorage;\n}\n\n/**\n * Resolve cloud observability credentials for the MastraPlatformExporter.\n * Priority: per-resource settings > environment variables > disabled.\n */\nfunction resolveCloudObservabilityConfig(\n  settings: ReturnType<typeof loadSettings>,\n  authStorage: AuthStorage,\n  resourceId: string,\n): { accessToken?: string; projectId?: string } {\n  const resourceConfig = settings.observability.resources[resourceId];\n  if (resourceConfig) {\n    const token = authStorage.getStoredApiKey(`${OBSERVABILITY_AUTH_PREFIX}${resourceId}`);\n    if (token) {\n      return { accessToken: token, projectId: resourceConfig.projectId };\n    }\n  }\n  // Fall back to environment variables for backwards compatibility\n  return {\n    accessToken: process.env.MASTRA_CLOUD_ACCESS_TOKEN,\n    projectId: process.env.MASTRA_PROJECT_ID,\n  };\n}\n\n/**\n * Base factory: builds every shared MastraCode resource (storage, observability,\n * memory, MCP, providers, gateways, agent, modes) and the {@link AgentController}, but\n * does NOT call `init()` or create a session. The controller is returned inert so\n * the composition layer can decide its Mastra ownership and session model.\n *\n * See {@link bootLocalAgentController} (Case 3) and `mountAgentControllerOnMastra` (Cases 1 & 2).\n */\nfunction resolveInjectedStorageBackend(\n  storage: MastraCompositeStore,\n  configuredBackend?: 'libsql' | 'pg',\n): 'libsql' | 'pg' {\n  if (configuredBackend) return configuredBackend;\n  if (storage instanceof LibSQLStore) return 'libsql';\n  if (storage instanceof PostgresStore) return 'pg';\n  throw new Error('storageBackend is required when injecting a custom storage instance.');\n}\n\nexport async function createMastraCodeAgentController(config?: MastraCodeConfig) {\n  const cwd = config?.cwd ?? process.cwd();\n  const homeDir = config?.homeDir ?? config?.initialState?.homeDir;\n  const configDir = config?.configDir ?? DEFAULT_CONFIG_DIR;\n  // The single session for this process, assigned once `createSession()` runs\n  // below. Config callbacks defined before then (e.g. notification stream\n  // options) read it lazily through this holder.\n  let activeSession: Session<MastraCodeState> | undefined;\n  if (configDir !== DEFAULT_CONFIG_DIR) {\n    validateConfigDirName(configDir);\n  }\n\n  // Load .env file from cwd if present (for observability API keys, etc.)\n  try {\n    process.loadEnvFile(path.join(cwd, '.env'));\n  } catch {\n    // No .env file — that's fine, keys may be in shell environment\n  }\n\n  // Auth storage (shared with Claude Max / OpenAI providers and AgentController)\n  const authStorage = createAuthStorage();\n  const globalSettings = loadSettings(config?.settingsPath);\n  const storedGatewayKey = authStorage.getStoredApiKey(MASTRA_GATEWAY_PROVIDER);\n  const storedGatewayUrl = globalSettings.memoryGateway?.baseUrl;\n\n  if (storedGatewayKey) {\n    process.env['MASTRA_GATEWAY_API_KEY'] ??= storedGatewayKey;\n  }\n\n  if (storedGatewayUrl) {\n    process.env['MASTRA_GATEWAY_URL'] ??= storedGatewayUrl;\n  }\n\n  // Load user-entered API keys from auth.json into process.env\n  // (only sets env vars that aren't already present — env vars take precedence).\n  // Skipped in deployed multi-tenant mode: when a per-tenant credential store\n  // provider is registered, provider keys are resolved per request and must\n  // never leak into process-global env vars.\n  if (!hasCredentialStoreProvider()) {\n    try {\n      const registry = PROVIDER_REGISTRY as Record<string, ProviderConfig>;\n      const providerEnvVars: Record<string, string | undefined> = {};\n      for (const [provider, cfg] of Object.entries(registry)) {\n        const envVars = cfg?.apiKeyEnvVar;\n        providerEnvVars[provider] = Array.isArray(envVars) ? envVars[0] : envVars;\n      }\n      providerEnvVars[MASTRA_GATEWAY_PROVIDER] ??= 'MASTRA_GATEWAY_API_KEY';\n      authStorage.loadStoredApiKeysIntoEnv(providerEnvVars);\n    } catch {\n      // Registry unavailable — load well-known provider keys so non-gateway flows still work\n      authStorage.loadStoredApiKeysIntoEnv({\n        [MASTRA_GATEWAY_PROVIDER]: 'MASTRA_GATEWAY_API_KEY',\n        anthropic: 'ANTHROPIC_API_KEY',\n        openai: 'OPENAI_API_KEY',\n        google: 'GOOGLE_GENERATIVE_AI_API_KEY',\n        cerebras: 'CEREBRAS_API_KEY',\n        deepseek: 'DEEPSEEK_API_KEY',\n      });\n    }\n  }\n\n  const mgApiKey = process.env['MASTRA_GATEWAY_API_KEY'] ?? storedGatewayKey;\n  const mastraGatewayBaseUrl = (\n    process.env['MASTRA_GATEWAY_URL'] ??\n    storedGatewayUrl ??\n    'https://gateway-api.mastra.ai'\n  )\n    .replace(/\\/+$/, '')\n    .replace(/\\/v1$/, '');\n  const mastraCodeGateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl,\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: false,\n    settingsPath: config?.settingsPath,\n  });\n  const amazonBedrockGateway = createAmazonBedrockGateway();\n\n  // Project detection\n  const project = detectProject(cwd);\n\n  const resourceIdOverride = getResourceIdOverride(project.rootPath, configDir);\n  if (resourceIdOverride) {\n    project.resourceId = resourceIdOverride;\n    project.resourceIdOverride = true;\n  }\n\n  // Stable session id unique to this project/resource, and a machine-bound owner\n  // id. resourceId encodes root path + git identity and honors overrides, so it\n  // is the right input for scoping the session to the cwd/project.\n  const sessionId = `mastracode-session-${shortHash(project.resourceId)}`;\n  const ownerId = `mastracode-${shortHash(`${hostname()}\\0${project.rootPath}`)}`;\n\n  const configuredPubSub = config?.pubsub;\n  const useUnixSocketPubSub =\n    (config?.unixSocketPubSub ?? globalSettings.signals?.unixSocketPubSub ?? false) && process.platform !== 'win32';\n  const signalsPubSub = configuredPubSub ?? (useUnixSocketPubSub ? createSignalsPubSub(project.resourceId) : undefined);\n  const crossProcessPubSub = config?.crossProcessPubSub ?? (!configuredPubSub && useUnixSocketPubSub);\n  if (crossProcessPubSub && !signalsPubSub) {\n    throw new Error('crossProcessPubSub requires a pubsub instance');\n  }\n\n  // Storage. An injected instance is used as-is — no connection test, no\n  // LibSQL fallback: if the injected store fails, that's a hard error.\n  const injectedStorage = config?.storage instanceof MastraCompositeStore ? config.storage : undefined;\n  const storageConfig = injectedStorage\n    ? undefined\n    : ((config?.storage as StorageConfig | undefined) ??\n      getStorageConfig(project.rootPath, globalSettings.storage, configDir));\n  const storageResult: StorageResult = injectedStorage\n    ? { storage: injectedStorage, backend: resolveInjectedStorageBackend(injectedStorage, config?.storageBackend) }\n    : await createStorage(storageConfig!);\n  const storageWarning = storageResult.warning;\n\n  // Observability storage (DuckDB — separate file for OLAP-style trace/score/feedback queries).\n  // Local tracing is opt-in via `/observability local on`. When disabled, the\n  // MastraStorageExporter is omitted entirely so traces never fall through to\n  // the default libsql backend.\n  let observabilityDomain: DuckDBStore['observability'] | undefined;\n  let observabilityWarning: string | undefined;\n  if (globalSettings.observability.localTracing) {\n    try {\n      const observabilityDuckDB = new DuckDBStore({\n        id: 'mastra-code-observability',\n        path: getObservabilityDatabasePath(),\n      });\n      // Force an early connection attempt so the lock error surfaces now, not mid-session.\n      await observabilityDuckDB.db.getConnection();\n      observabilityDomain = observabilityDuckDB.observability;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const isLockError = /lock|locked|busy/i.test(message);\n      if (isLockError) {\n        observabilityWarning =\n          'Observability unavailable — another MastraCode instance holds the database lock. Traces, scores, and feedback will not be recorded in this session.';\n      } else {\n        observabilityWarning = `Observability unavailable — DuckDB initialization failed: ${message}`;\n      }\n    }\n  }\n\n  const harnessStorage = new InMemoryHarness();\n\n  const storage = new MastraCompositeStore({\n    id: 'mastra-code-storage',\n    default: storageResult.storage,\n    domains: {\n      // When local tracing is off, disable the observability domain entirely so\n      // trace/score/feedback writes never fall through to the default libsql store.\n      observability: observabilityDomain ?? false,\n      harness: harnessStorage,\n    },\n  });\n\n  // Observability (tracing, scoring, feedback)\n  const observability = new Observability({\n    configs: {\n      default: {\n        serviceName: 'mastracode',\n        // Only these requestContext keys are stored on spans — prevents leaking\n        // large objects (controller state, workspace, env vars) into trace data.\n        // Use dot-notation because these are nested inside the 'controller' key.\n        //\n        // Session identifiers:\n        //   threadId, resourceId, session.modeId, agentControllerId\n        // Environment & project:\n        //   state.projectName, state.gitBranch\n        // Model configuration:\n        //   session.modelId, state.subagentModelId\n        // Agent settings:\n        //   state.yolo, state.thinkingLevel, state.smartEditing\n        // Observational memory settings:\n        //   state.omScope, state.observerModelId, state.reflectorModelId,\n        //   state.observationThreshold, state.reflectionThreshold\n        requestContextKeys: [\n          // Session identifiers\n          'controller.threadId',\n          'controller.resourceId',\n          'controller.session.modeId',\n          'controller.controllerId',\n          // Environment & project\n          'controller.state.projectName',\n          'controller.state.gitBranch',\n          // Model configuration\n          'controller.session.modelId',\n          'controller.state.subagentModelId',\n          // Agent settings\n          'controller.state.yolo',\n          'controller.state.thinkingLevel',\n          'controller.state.smartEditing',\n          // Observational memory settings\n          'controller.state.omScope',\n          'controller.state.observerModelId',\n          'controller.state.reflectorModelId',\n          'controller.state.observationThreshold',\n          'controller.state.reflectionThreshold',\n        ],\n        exporters: [\n          // Only persist traces locally when DuckDB observability is available\n          // (via `/observability local on`). Without this guard the storage\n          // exporter falls through to the default libsql backend and silently\n          // fills the main database with gigabytes of span data.\n          ...(observabilityDomain ? [new MastraStorageExporter({ strategy: 'event-sourced' })] : []),\n          new MastraPlatformExporter(resolveCloudObservabilityConfig(globalSettings, authStorage, project.resourceId)),\n        ],\n        spanOutputProcessors: [new SensitiveDataFilter()],\n      },\n    },\n  });\n\n  // Vector store for recall search (separate DB file to avoid bloating main\n  // storage). An injected instance is used as-is; with an injected storage\n  // instance and no injected vector, recall search stays vector-less.\n  const vector =\n    config?.vector ?? (storageConfig ? await createVectorStore(storageConfig, storageResult.backend) : undefined);\n\n  // Maintenance handle for /prune: prunes via the inner store (whose retention\n  // config covers every domain, including legacy libsql observability spans)\n  // and can compact local libsql files to reclaim disk. The vector store's\n  // connection must close alongside storage — the compaction's file swap\n  // refuses to run while any connection is open.\n  const storageMaintenance: StorageMaintenance = createStorageMaintenance({\n    storage: storageResult.storage,\n    backend: storageResult.backend,\n    retention: DEFAULT_RETENTION,\n    localDbFiles: storageConfig ? resolveLocalDbFiles(storageConfig, storageResult.backend) : [],\n    closeVector: vector instanceof LibSQLVector ? () => vector.close() : undefined,\n  });\n\n  const memory = config?.memory === false ? undefined : (config?.memory ?? getDynamicMemory(storage, vector));\n\n  // MCP\n  const mcpManager = config?.disableMcp ? undefined : createMcpManager(project.rootPath, configDir, config?.mcpServers);\n\n  // Hooks\n  const hookManager = config?.disableHooks\n    ? undefined\n    : new HookManager(project.rootPath, 'session-init', configDir, homeDir);\n\n  const pluginManager = config?.disablePlugins\n    ? undefined\n    : (config?.pluginManager ?? new PluginManager({ projectRoot: project.rootPath, configDir, homeDir }));\n  const loadedPlugins = pluginManager ? await pluginManager.reload() : [];\n  const pluginTools = pluginManager?.getPluginTools() ?? {};\n\n  // Scorers (live evaluation with sampling)\n  const outcomeScorer = createOutcomeScorer();\n  const efficiencyScorer = createEfficiencyScorer();\n\n  // Agent — githubSignals is created before `controller` but the closure below\n  // captures `controller` by reference; it is only invoked at notification time,\n  // well after controller is constructed (line ~692). Explicit type annotations\n  // on githubSignals, codeAgent, modes, and controller break the circular\n  // inference chain this forward reference would otherwise create.\n  const githubSignals: GithubSignals | undefined =\n    globalSettings.signals?.experimentalGithubSignals && !config?.disableGithubSignals\n      ? new GithubSignals({\n          cwd: project.rootPath,\n          gitcrawlCommand:\n            process.env.MASTRACODE_GITCRAWL_BIN ??\n            process.env.GITCRAWL_BIN ??\n            process.env.MASTRACODE_GITCRAWL_COMMAND ??\n            process.env.GITCRAWL_COMMAND,\n          getNotificationStreamOptions: async ({ resourceId, threadId }) => {\n            // Run the woken notification as the session that owns the target\n            // resource so it uses that session's model/mode/state. Fall back to\n            // the current session only when no session owns the resource yet.\n            const session = (await controller.getSessionByResource(resourceId)) ?? activeSession!;\n            // A long-running system must be able to drive work unattended, so a\n            // target session without an explicit model selection falls back to a\n            // real model rather than failing the run: the current session's live\n            // selection (what the user actually picked), then the mode's default.\n            const modeId = session.mode.get();\n            const defaultModeModelId = controller.listModes().find(mode => mode.id === modeId)?.defaultModelId;\n            const modelId = session.model.get() || activeSession?.model.get() || defaultModeModelId || '';\n            const requestContext = new RequestContext();\n            const agentControllerContext: AgentControllerRequestContext = {\n              controllerId: controller.id,\n              state: session.state.get(),\n              getState: () => session.state.get(),\n              setState: updates => session.state.set(updates),\n              threadId,\n              resourceId,\n              session: {\n                id: session.identity.getId(),\n                ownerId: session.identity.getOwnerId(),\n                modeId,\n                modelId,\n                state: {\n                  get: () => session.state.get(),\n                  set: updates => session.state.set(updates),\n                  update: updater => session.state.update(updater),\n                },\n              },\n              workspace: controller.getWorkspace(),\n              getSubagentModelId: params => session.subagents.model.get(params ?? {}),\n            };\n            requestContext.set('controller', agentControllerContext);\n\n            return {\n              memory: { thread: threadId, resource: resourceId },\n              requestContext,\n              maxSteps: 1000,\n              savePerStep: false,\n              requireToolApproval: (session.state.get() as Record<string, unknown>).yolo !== true,\n              modelSettings: { temperature: 1 },\n            };\n          },\n        })\n      : undefined;\n  const codeAgent: Agent = createCodingAgent({\n    id: CODE_AGENT_ID,\n    name: 'Code Agent',\n    // Workspace is wired per-request at the AgentController level (see\n    // `config.workspace` below), so opt out of the factory's default local\n    // workspace. An explicit `undefined` is required: the factory only builds a\n    // default when the `workspace` key is absent.\n    workspace: undefined,\n    instructions: getDynamicInstructions,\n    model: getDynamicModel,\n    tools: createDynamicTools(mcpManager, config?.extraTools, config?.disabledTools, storage, pluginTools),\n    hooks: createToolHooks(hookManager, config?.postToolObserver),\n    scorers: {\n      outcome: {\n        scorer: outcomeScorer,\n        sampling: { type: 'none' },\n      },\n      efficiency: {\n        scorer: efficiencyScorer,\n        sampling: { type: 'ratio', rate: 0.3 },\n      },\n    },\n    // TaskSignalProvider bundles the task tools + TaskStateProcessor: it merges\n    // the tools into the toolset and registers the task state-signal processor,\n    // so the task list persists across turns and survives OM truncation.\n    signals: [new TaskSignalProvider(), ...(githubSignals ? [githubSignals] : [])],\n    // Native goal mechanism: the in-loop goal step judges the thread's active\n    // objective each qualifying iteration. The judge model is required for any\n    // gating to occur; when unset the goal step is a complete no-op. A6 auto-wires\n    // the GoalStateProcessor so the `<current-objective>` signal persists across\n    // turns. Per-thread overrides live in the ThreadState `goal` record and win\n    // over these defaults.\n    goal: {\n      // Resolve the judge model through mastracode's gateway (a model-resolver\n      // function) so provider credentials are injected; returns undefined when no\n      // judge model is configured, keeping the goal step a no-op. Bind the same\n      // `settingsPath` used above so the judge model and `maxRuns` come from one\n      // config (a custom settings file would otherwise diverge).\n      judge: ctx => getGoalJudgeModel(ctx, config?.settingsPath),\n      maxRuns: globalSettings.models.goalMaxTurns ?? 50,\n      maxSteps: 1000,\n      prompt: DEFAULT_GOAL_JUDGE_PROMPT,\n      // Read-only workspace tools the default goal judge may call to verify the\n      // agent's work against the actual filesystem (view, search_content,\n      // find_files, file_stat, lsp_inspect) rather than grading prose alone —\n      // restoring the original MastraCode judge's verification ability. Resolved\n      // per-request from the active workspace (mirrors `judge`).\n      tools: getGoalJudgeTools,\n    },\n    inputProcessors: [\n      new PlanRejectionAbortProcessor(),\n      new AgentsMDInjector({\n        getIgnoredInstructionPaths: ({ requestContext }) => {\n          const agentControllerContext = requestContext?.get('controller') as\n            AgentControllerRequestContext<{ projectPath?: string }> | undefined;\n          const state = agentControllerContext?.getState();\n          return getStaticallyLoadedInstructionPaths(state?.projectPath ?? project.rootPath);\n        },\n      }),\n      new ProviderHistoryCompat(),\n    ],\n    errorProcessors: [\n      new StreamErrorRetryProcessor({\n        matchers: [\n          { match: isBadRequestError, maxRetries: 1, delayMs: 2000 },\n          {\n            match: isTransientConnectionError,\n            maxRetries: MASTRACODE_TRANSIENT_CONNECTION_MAX_RETRIES,\n            delayMs: ({ retryCount }) =>\n              Math.min(\n                MASTRACODE_TRANSIENT_CONNECTION_RETRY_INITIAL_DELAY_MS * Math.pow(2, retryCount),\n                MASTRACODE_TRANSIENT_CONNECTION_RETRY_MAX_DELAY_MS,\n              ),\n          },\n        ],\n      }),\n      new PrefillErrorHandler(),\n      new ProviderHistoryCompat(),\n    ],\n  });\n\n  // const defaultSubAgents: Array<AgentControllerSubagent> = [];\n  // const defaultSubagents = [exploreSubagent, planSubagent, executeSubagent];\n\n  const defaultModes: AgentControllerMode[] = [\n    {\n      ...buildMode,\n      metadata: {\n        ...buildMode.metadata,\n        color: mastraBrand.green,\n      },\n    },\n    {\n      ...planMode,\n      metadata: {\n        ...planMode.metadata,\n        color: mastraBrand.purple,\n      },\n    },\n    {\n      ...fastMode,\n      metadata: {\n        ...fastMode.metadata,\n        color: mastraBrand.orange,\n      },\n    },\n  ];\n\n  const defaultIntervalHandlers: IntervalHandler[] = [\n    {\n      id: 'gateway-sync',\n      intervalMs: 5 * 60 * 1000,\n      immediate: false,\n      handler: () => syncGateways(),\n    },\n  ];\n  const intervalHandlers = config?.intervalHandlers ?? defaultIntervalHandlers;\n\n  // Build lightweight provider access for resolving built-in packs at startup.\n  // Anthropic/OpenAI use AuthStorage; other providers use env API keys.\n  // Also scan the full provider registry so configured API keys satisfy access checks.\n  const anthropicCred = authStorage.get('anthropic');\n  const openaiCred = authStorage.get('openai-codex');\n  const githubCopilotCred = authStorage.get('github-copilot');\n  const startupAccess: ProviderAccess = {\n    anthropic:\n      anthropicCred?.type === 'oauth'\n        ? 'oauth'\n        : anthropicCred?.type === 'api_key' && anthropicCred.key.trim().length > 0\n          ? 'apikey'\n          : false,\n    openai:\n      openaiCred?.type === 'oauth'\n        ? 'oauth'\n        : openaiCred?.type === 'api_key' && openaiCred.key.trim().length > 0\n          ? 'apikey'\n          : false,\n    cerebras: process.env.CEREBRAS_API_KEY ? 'apikey' : false,\n    google: process.env.GOOGLE_GENERATIVE_AI_API_KEY ? 'apikey' : false,\n    deepseek: process.env.DEEPSEEK_API_KEY ? 'apikey' : false,\n    'github-copilot': githubCopilotCred?.type === 'oauth' ? 'oauth' : false,\n  };\n  // Gateway covers all providers — ensure Anthropic/OpenAI packs are visible\n  if (mgApiKey) {\n    if (!startupAccess.anthropic) startupAccess.anthropic = 'apikey';\n    if (!startupAccess.openai) startupAccess.openai = 'apikey';\n  }\n  // Check all providers in the registry for API keys\n  try {\n    const registry = PROVIDER_REGISTRY as Record<string, ProviderConfig>;\n    for (const [provider, config] of Object.entries(registry)) {\n      if (startupAccess[provider] === 'oauth' || startupAccess[provider] === 'apikey') continue; // Already enabled above\n      if (provider === 'anthropic' || provider === 'openai') continue;\n      const envVars = config?.apiKeyEnvVar;\n      const envVarList = Array.isArray(envVars) ? envVars : envVars ? [envVars] : [];\n      if (envVarList.some(envVar => process.env[envVar])) {\n        startupAccess[provider] = 'apikey';\n      }\n    }\n  } catch {\n    // Registry may not be loaded yet; the 5 hardcoded providers are sufficient fallback\n  }\n  const builtinPacks = getAvailableModePacks(startupAccess);\n  const builtinOmPacks = getAvailableOmPacks(startupAccess);\n  const effectiveDefaults = resolveModelDefaults(globalSettings, builtinPacks);\n  const effectiveObserverModel = resolveOmRoleModel(globalSettings, 'observer', builtinOmPacks);\n  const effectiveReflectorModel = resolveOmRoleModel(globalSettings, 'reflector', builtinOmPacks);\n  const effectiveObservationThreshold = globalSettings.models.omObservationThreshold ?? undefined;\n  const effectiveReflectionThreshold = globalSettings.models.omReflectionThreshold ?? undefined;\n  const effectiveCavemanObservations = globalSettings.models.omCavemanObservations ?? undefined;\n  const effectiveObserveAttachments = globalSettings.models.omObserveAttachments ?? 'auto';\n\n  const modes = addPluginToolsToModeAllowlists(\n    applyEffectiveDefaultsToModes(config?.modes ? config.modes : defaultModes, effectiveDefaults),\n    Object.keys(pluginTools),\n  );\n  const defaultModeId =\n    modes.find(mode => mode.metadata?.default === true)?.id ??\n    modes.find(mode => mode.id === 'build')?.id ??\n    modes[0]?.id;\n  if (!defaultModeId) {\n    throw new Error('MastraCode requires at least one mode');\n  }\n\n  // Map subagent types to mode models: explore→fast, plan→plan, execute→build\n  // const subagentModeMap: Record<string, string> = { explore: 'fast', plan: 'plan', execute: 'build' };\n  // Subagents inherit workspace tools from the parent agent's workspace automatically.\n  // Apply disabledTools filter to both default and custom subagents.\n  // const subagents = [];\n\n  // Build initial state with global preferences\n  const globalInitialState: Partial<MastraCodeState> = {};\n  if (effectiveObserverModel) {\n    globalInitialState.observerModelId = effectiveObserverModel;\n  }\n  if (effectiveReflectorModel) {\n    globalInitialState.reflectorModelId = effectiveReflectorModel;\n  }\n  if (effectiveObservationThreshold !== undefined) {\n    globalInitialState.observationThreshold = effectiveObservationThreshold;\n  }\n  if (effectiveReflectionThreshold !== undefined) {\n    globalInitialState.reflectionThreshold = effectiveReflectionThreshold;\n  }\n  if (effectiveCavemanObservations !== undefined) {\n    globalInitialState.cavemanObservations = effectiveCavemanObservations;\n  }\n  if (effectiveObserveAttachments !== undefined) {\n    globalInitialState.observeAttachments = effectiveObserveAttachments;\n  }\n  if (globalSettings.preferences.yolo !== null) {\n    globalInitialState.yolo = globalSettings.preferences.yolo;\n  }\n  globalInitialState.thinkingLevel = globalSettings.preferences.thinkingLevel;\n  if (config?.omScope) {\n    globalInitialState.omScope = config.omScope;\n  }\n  // Seed subagent models from global settings\n  for (const [key, modelId] of Object.entries(globalSettings.models.subagentModels)) {\n    if (key === 'default' || key === '_default') {\n      globalInitialState.subagentModelId = modelId;\n    } else {\n      globalInitialState[`subagentModelId_${key}`] = modelId;\n    }\n  }\n\n  const typedStateSchema = stateSchema as PublicSchema<MastraCodeState>;\n  const controller: AgentController<MastraCodeState> = new AgentController<MastraCodeState>({\n    id: 'mastra-code',\n    resourceId: project.resourceId,\n    storage,\n    observability,\n    memory,\n    pubsub: signalsPubSub,\n    stateSchema: typedStateSchema,\n    agent: codeAgent,\n    subagents: config?.subagents ?? [],\n    gateways: [amazonBedrockGateway, mastraCodeGateway],\n    workspace: config?.workspace ?? (args => getDynamicWorkspace(args)),\n    browser: config?.browser,\n    idGenerator: config?.idGenerator,\n    toolCategoryResolver: getToolCategory,\n    initialState: {\n      projectPath: project.rootPath,\n      projectName: project.name,\n      gitBranch: project.gitBranch,\n      pluginSkillPaths: loadedPlugins.flatMap(plugin => (plugin.status === 'active' ? (plugin.skillPaths ?? []) : [])),\n      pluginCommandPaths: loadedPlugins.flatMap(plugin =>\n        plugin.status === 'active' ? (plugin.commandPaths ?? []) : [],\n      ),\n      pluginInstructions: loadedPlugins.flatMap(plugin =>\n        plugin.status === 'active' && plugin.instructions ? [plugin.instructions] : [],\n      ),\n      yolo: true,\n      ...globalInitialState,\n      ...config?.initialState,\n      // configDir must always win over initialState spreads to stay in sync\n      // with MCP/hooks/storage which were already initialized with this value.\n      configDir,\n    },\n    modes,\n    intervalHandlers,\n    modelUseCountProvider: () => loadSettings().modelUseCounts,\n    modelUseCountTracker: modelId => {\n      try {\n        const settings = loadSettings();\n        settings.modelUseCounts[modelId] = (settings.modelUseCounts[modelId] ?? 0) + 1;\n        saveSettings(settings);\n      } catch (error) {\n        console.error('Failed to persist model usage count', error);\n      }\n    },\n    threadLock: crossProcessPubSub\n      ? undefined\n      : {\n          acquire: acquireThreadLock,\n          release: releaseThreadLock,\n        },\n  });\n\n  // The AgentController is fully constructed but intentionally NOT inited here. Init and\n  // session creation are deferred to the composition layer (see below) so the\n  // controller can be wired in three ways:\n  //\n  //   1. Server + Web   — registered on a server Mastra, then inited; sessions\n  //                       minted per browser client over HTTP.\n  //   2. Server + TUI   — same server composition; the TUI drives a session\n  //                       (in-process today; remote transport is future work).\n  //   3. Local  + TUI   — controller builds its own internal Mastra on init() and\n  //                       mints one eager session for the whole process.\n  //\n  // Cases 1 & 2 use `mountAgentControllerOnMastra` (register-before-init, no eager\n  // session). Case 3 uses `bootLocalAgentController` (init + one wired session).\n  return {\n    controller: controller,\n    storage,\n    storageMaintenance,\n    observability,\n    memory,\n    mcpManager,\n    hookManager,\n    pluginManager,\n    loadedPlugins,\n    pluginTools,\n    signalsPubSub,\n    authStorage,\n    resolveModel,\n    storageWarning,\n    observabilityWarning,\n    builtinPacks,\n    builtinOmPacks,\n    effectiveDefaults,\n    githubSignals,\n    // Identity for the single local session (Case 3). Servers ignore these and\n    // mint per-request sessions with client-supplied resourceIds instead.\n    sessionId,\n    ownerId,\n    // Lets the composition layer publish the created session back into the\n    // config closures (e.g. notification stream options read it lazily).\n    setActiveSession: (session: Session<MastraCodeState>) => {\n      activeSession = session;\n    },\n  };\n}\n\n/**\n * Result of {@link createMastraCodeAgentController}: every shared resource plus the\n * inert AgentController, ready to be either booted locally or mounted on a server\n * Mastra.\n */\nexport type MastraCodeAgentController = Awaited<ReturnType<typeof createMastraCodeAgentController>>;\n\n/**\n * Wires the session-scoped concerns MastraCode layers on top of a Session:\n * hookManager thread-id sync, GitHub PR polling for the current thread, and\n * per-thread persistence of the mastracode-only `/om` settings.\n *\n * Used by {@link bootLocalAgentController} for the single local session. A server can\n * call this for any session it mints if it wants the same background wiring.\n */\nexport async function wireSessionConcerns(\n  base: Pick<MastraCodeAgentController, 'hookManager' | 'githubSignals' | 'setActiveSession'>,\n  session: Session<MastraCodeState>,\n): Promise<void> {\n  const { hookManager, githubSignals } = base;\n  base.setActiveSession(session);\n\n  // Sync hookManager session ID on thread changes\n  if (hookManager) {\n    session.subscribe((event: AgentControllerEvent) => {\n      if (event.type === 'thread_changed') {\n        hookManager.setSessionId(event.threadId);\n      } else if (event.type === 'thread_created') {\n        hookManager.setSessionId(event.thread.id);\n      }\n    });\n  }\n\n  if (githubSignals) {\n    const startGithubPollingForCurrentThread = async (threadId?: string | null) => {\n      if (!threadId) return;\n      githubSignals.stopAllPolling();\n      try {\n        const threads = await session.thread.list({ allResources: true });\n        const thread = threads.find((item: { id: string }) => item.id === threadId);\n        await githubSignals.startPollingForThread(\n          {\n            threadId,\n            resourceId: thread?.resourceId ?? session.identity.getResourceId(),\n          },\n          { pollImmediately: true },\n        );\n      } catch (error) {\n        console.warn('Failed to start GitHub PR polling:', error);\n      }\n    };\n\n    session.subscribe((event: AgentControllerEvent) => {\n      if (event.type === 'thread_changed') void startGithubPollingForCurrentThread(event.threadId);\n      else if (event.type === 'thread_created') void startGithubPollingForCurrentThread(event.thread.id);\n    });\n    void startGithubPollingForCurrentThread(session.thread.getId());\n  }\n\n  // Persist MastraCode-owned /om settings per-thread (mastracode-only concern;\n  // intentionally not in core's controller loadThreadMetadata).\n  const omThreadStateSession = session as unknown as Session<Record<string, unknown>>;\n  attachOMThreadStatePersistence(omThreadStateSession);\n  await restoreOMThreadStateForCurrentThread(omThreadStateSession).catch(() => {\n    // Persistence is best-effort; don't crash startup if storage hiccups.\n  });\n}\n\n/**\n * Case 3 (AgentController local + TUI/headless): build the controller, let it stand up its\n * own internal Mastra via `init()`, and mint the single eager session that all\n * work in this process runs through. The AgentController owns no session of its own.\n */\nexport async function bootLocalAgentController(config?: MastraCodeConfig) {\n  const base = await createMastraCodeAgentController(config);\n  const { controller, sessionId, ownerId } = base;\n\n  await controller.init();\n  await controller.getMastra()?.startWorkers();\n  const session = await controller.createSession({ id: sessionId, ownerId });\n  await wireSessionConcerns(base, session);\n\n  return { ...base, session };\n}\n\n/** Result of {@link mountAgentControllerOnMastra}: shared handles plus the owning Mastra. */\nexport type MountedMastraCode = MastraCodeAgentController & { mastra: Mastra };\n\n/**\n * Cases 1 & 2 (AgentController in Server + Web/TUI): build the controller, register it on a\n * server-owned Mastra, THEN init it. Registering before `init()` is what makes\n * the controller inherit the server's Mastra (storage, agents, gateways) instead of\n * spinning up its own internal one — there is a single shared Mastra.\n *\n * No eager session is minted: each client (browser or terminal) creates/resumes\n * its own isolated session via `controller.createSession({ resourceId })`, so one\n * server can drive many concurrent users.\n *\n * Pass an existing `mastra` to mount onto a Mastra that already hosts other\n * primitives; otherwise a Mastra is created that owns the controller's storage so\n * durability is configured in one place.\n */\nexport async function mountAgentControllerOnMastra(\n  config?: MastraCodeConfig & {\n    mastra?: Mastra;\n    controllerId?: string;\n    buildApiRoutes?: (deps: { controller: MountedMastraCode['controller']; authStorage: AuthStorage }) => ApiRoute[];\n    /**\n     * Additional `server` config to fold onto the constructed Mastra alongside\n     * the assembled `apiRoutes` (e.g. `middleware`, `cors`). Used by the\n     * platform entry (`src/mastra/index.ts`) to own the WorkOS gate + tenant\n     * dispatcher + CORS on the instance the deployer generates its server from.\n     * Ignored when `mastra` is provided (mounting onto a caller-owned instance).\n     */\n    buildServerConfig?: (deps: {\n      controller: MountedMastraCode['controller'];\n      authStorage: AuthStorage;\n    }) => Omit<NonNullable<ConstructorParameters<typeof Mastra>[0]>['server'], 'apiRoutes'>;\n  },\n): Promise<MountedMastraCode> {\n  const prepared = await prepareAgentControllerMount(config);\n  if (config?.mastra) {\n    // Mounting onto a Mastra the caller already built. Ensure the controller's\n    // back-reference points at it (idempotent — only sets #externalMastra).\n    prepared.base.controller.__registerMastra(config.mastra);\n    await prepared.finalize();\n    return { ...prepared.base, mastra: config.mastra };\n  }\n  const mastra = new Mastra(prepared.mastraArgs);\n  await prepared.finalize();\n  return { ...prepared.base, mastra };\n}\n\n/**\n * Assemble everything needed to construct the server-owned Mastra WITHOUT\n * constructing it, so a caller (the platform entry `src/mastra/index.ts`) can\n * run the `new Mastra(...)` literal in its own module. The deployer's\n * `checkConfigExport` Babel plugin only marks the config valid when it finds a\n * top-level `new Mastra(...)` exported as `mastra` in the ENTRY file; hiding the\n * construction inside this helper would trip the \"Invalid Mastra config\" warning.\n *\n * Returns the constructor args plus a `finalize()` that runs the post-construct\n * boot (`controller.init()` + `startWorkers()`). The controller is registered on\n * the Mastra via the `agentControllers` arg at construction time.\n */\nexport async function prepareAgentControllerMount(\n  config?: MastraCodeConfig & {\n    mastra?: Mastra;\n    controllerId?: string;\n    buildApiRoutes?: (deps: { controller: MountedMastraCode['controller']; authStorage: AuthStorage }) => ApiRoute[];\n    buildServerConfig?: (deps: {\n      controller: MountedMastraCode['controller'];\n      authStorage: AuthStorage;\n    }) => Omit<NonNullable<ConstructorParameters<typeof Mastra>[0]>['server'], 'apiRoutes'>;\n  },\n): Promise<{\n  base: Awaited<ReturnType<typeof createMastraCodeAgentController>>;\n  mastraArgs: NonNullable<ConstructorParameters<typeof Mastra>[0]>;\n  finalize: () => Promise<void>;\n}> {\n  const base = await createMastraCodeAgentController(config);\n  const { controller, storage, authStorage } = base;\n  const controllerId = config?.controllerId ?? controller.id;\n  const apiRoutes = config?.buildApiRoutes?.({ controller, authStorage });\n  const extraServerConfig = config?.buildServerConfig?.({ controller, authStorage });\n\n  const serverConfig = {\n    ...extraServerConfig,\n    ...(apiRoutes?.length ? { apiRoutes } : {}),\n  };\n  const mastraArgs = {\n    agentControllers: { [controllerId]: controller },\n    storage,\n    // Mirror the controller's internal-Mastra construction (which passes\n    // `config.pubsub` through): the server-owned Mastra must run its event\n    // bus on the same transport so streams/workflows/signals stay\n    // cross-process when a distributed PubSub (e.g. Redis Streams) is\n    // configured.\n    ...(base.signalsPubSub ? { pubsub: base.signalsPubSub } : {}),\n    ...(Object.keys(serverConfig).length ? { server: serverConfig } : {}),\n  };\n\n  const finalize = async () => {\n    await controller.init();\n    await controller.getMastra()?.startWorkers();\n  };\n\n  return { base, mastraArgs, finalize };\n}\n\n/**\n * Back-compat alias. Historically `createMastraCode` built and booted a local\n * controller with a single session; that behavior now lives in\n * {@link bootLocalAgentController}. New code should call the explicit factory for its\n * case: `bootLocalAgentController` (local) or {@link mountAgentControllerOnMastra} (server).\n */\nexport const createMastraCode = bootLocalAgentController;\n\n/**\n * Programmatic headless API. `runMC` runs an already-built controller/session\n * (from {@link createMastraCode}) as an async-iterable run that also resolves to\n * a typed result. Also available via the `mastracode/headless` subpath.\n */\nexport {\n  runMC,\n  runMCCli,\n  hasHeadlessFlag,\n  autoApprovePolicy,\n  denyPolicy,\n  permissionModeToPolicy,\n  formatHuman,\n  formatJsonl,\n  renderTextResult,\n  renderJsonResult,\n} from './headless/index.js';\nexport type {\n  RunMCOptions,\n  RunMCResult,\n  RunMCStatus,\n  RunMCUsage,\n  RunMCToolCall,\n  RunMCToolResult,\n  RunMCError,\n  RunMCThreadOptions,\n  MCRun,\n  ResolutionPolicy,\n  PermissionMode,\n} from './headless/index.js';\n"],"mappings":"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","names":["config"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { hostname } from 'node:os';\nimport path from 'node:path';\n\nimport type { Agent } from '@mastra/core/agent';\nimport { AgentController } from '@mastra/core/agent-controller';\nimport type {\n  IntervalHandler,\n  AgentControllerConfig,\n  AgentControllerEvent,\n  AgentControllerMode,\n  AgentControllerSubagent,\n  AgentControllerRequestContext,\n  Session,\n} from '@mastra/core/agent-controller';\nimport { createCodingAgent } from '@mastra/core/coding-agent';\nimport type { PubSub } from '@mastra/core/events';\nimport { PROVIDER_REGISTRY } from '@mastra/core/llm';\nimport type { ProviderConfig } from '@mastra/core/llm';\nimport { Mastra } from '@mastra/core/mastra';\nimport {\n  AgentsMDInjector,\n  isBadRequestError,\n  PrefillErrorHandler,\n  ProviderHistoryCompat,\n  StreamErrorRetryProcessor,\n} from '@mastra/core/processors';\nimport type { InputProcessor } from '@mastra/core/processors';\nimport { RequestContext } from '@mastra/core/request-context';\nimport type { PublicSchema } from '@mastra/core/schema';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { TaskSignalProvider } from '@mastra/core/signals';\nimport { InMemoryHarness, MastraCompositeStore } from '@mastra/core/storage';\nimport { DEFAULT_GOAL_JUDGE_PROMPT } from '@mastra/core/tools';\nimport type { MastraVector } from '@mastra/core/vector';\nimport { DuckDBStore } from '@mastra/duckdb';\n\nimport { GithubSignals } from '@mastra/github-signals';\nimport { LibSQLStore, LibSQLVector } from '@mastra/libsql';\nimport {\n  Observability,\n  MastraStorageExporter,\n  MastraPlatformExporter,\n  SensitiveDataFilter,\n} from '@mastra/observability';\nimport { PostgresStore } from '@mastra/pg';\n\nimport { hasCredentialStoreProvider } from './agents/credential-resolver.js';\nimport { getDynamicInstructions } from './agents/instructions.js';\nimport { getDynamicMemory } from './agents/memory.js';\nimport { createMastraCodeGateway, getDynamicModel, getGoalJudgeModel, resolveModel } from './agents/model.js';\nimport { buildMode } from './agents/modes/build.js';\nimport { fastMode } from './agents/modes/explore.js';\nimport { planMode } from './agents/modes/plan.js';\nimport { getStaticallyLoadedInstructionPaths } from './agents/prompts/agent-instructions.js';\n// import { executeSubagent } from './agents/subagents/execute.js';\n// import { exploreSubagent } from './agents/subagents/explore.js';\n// import { planSubagent } from './agents/subagents/plan.js';\nimport { attachOMThreadStatePersistence, restoreOMThreadStateForCurrentThread } from './agents/thread-caveman-state.js';\nimport { createDynamicTools, createToolHooks } from './agents/tools.js';\nimport type { PostToolObserver, ToolLike } from './agents/tools.js';\n\nimport { getDynamicWorkspace, getGoalJudgeTools } from './agents/workspace.js';\nimport { AuthStorage } from './auth/storage.js';\nimport { DEFAULT_CONFIG_DIR, validateConfigDirName } from './constants.js';\nimport { createOutcomeScorer, createEfficiencyScorer } from './evals/scorers/index.js';\nimport { HookManager } from './hooks/index.js';\nimport { createMcpManager } from './mcp/index.js';\nimport type { McpServerConfig } from './mcp/index.js';\nimport type { ProviderAccess } from './onboarding/packs.js';\nimport { getAvailableModePacks, getAvailableOmPacks } from './onboarding/packs.js';\nimport {\n  loadSettings,\n  MASTRA_GATEWAY_PROVIDER,\n  OBSERVABILITY_AUTH_PREFIX,\n  resolveModelDefaults,\n  resolveOmRoleModel,\n  saveSettings,\n} from './onboarding/settings.js';\nimport { getToolCategory } from './permissions.js';\nimport { PluginManager } from './plugins/manager.js';\nimport { PlanRejectionAbortProcessor } from './processors/plan-rejection-abort.js';\nimport { createAmazonBedrockGateway } from './providers/amazon-bedrock-gateway.js';\nimport { setAuthStorage } from './providers/claude-max.js';\nimport { setAuthStorage as setGitHubCopilotAuthStorage } from './providers/github-copilot.js';\nimport { setAuthStorage as setOpenAIAuthStorage } from './providers/openai-codex.js';\nimport { setAuthStorage as setXAIAuthStorage } from './providers/xai.js';\n\nimport { stateSchema } from './schema.js';\nimport type { MastraCodeState } from './schema.js';\n\nimport { mastraBrand } from './theme-palette.js';\nimport { syncGateways } from './utils/gateway-sync.js';\nimport {\n  detectProject,\n  getObservabilityDatabasePath,\n  getStorageConfig,\n  getResourceIdOverride,\n} from './utils/project.js';\nimport type { StorageConfig } from './utils/project.js';\nimport { createSignalsPubSub } from './utils/signals-pubsub.js';\nimport { createStorage, createVectorStore } from './utils/storage-factory.js';\nimport type { StorageResult } from './utils/storage-factory.js';\nimport { createStorageMaintenance, DEFAULT_RETENTION, resolveLocalDbFiles } from './utils/storage-maintenance.js';\nimport type { StorageMaintenance } from './utils/storage-maintenance.js';\nimport { acquireThreadLock, releaseThreadLock } from './utils/thread-lock.js';\n\nconst CODE_AGENT_ID = 'code-agent';\n\n// Global retry policy for transient connection failures (e.g. provider sockets dropping mid-stream).\n// Applied centrally to every model call via StreamErrorRetryProcessor, independent of model-pack\n// settings, so all modes/subagents benefit from a short wait before retrying a dropped connection.\n// Delay uses exponential backoff: initialDelay * 2^retryCount, capped at maxDelay.\nconst MASTRACODE_TRANSIENT_CONNECTION_MAX_RETRIES = 2;\nconst MASTRACODE_TRANSIENT_CONNECTION_RETRY_INITIAL_DELAY_MS = 1000;\nconst MASTRACODE_TRANSIENT_CONNECTION_RETRY_MAX_DELAY_MS = 30000;\n\nconst TRANSIENT_CONNECTION_ERROR_CODES = new Set(['ECONNRESET', 'EPIPE']);\nconst TRANSIENT_CONNECTION_MESSAGE_PATTERN = /econnreset|socket hang up|write epipe|other side closed/i;\n\n/**\n * Matcher for transient connection failures. Cause-chain traversal is handled\n * by `StreamErrorRetryProcessor.isRetryableStreamError`, which calls each\n * matcher at every level of the cause chain.\n */\nfunction isTransientConnectionError(error: unknown): boolean {\n  if (!error) return false;\n\n  const code = typeof error === 'object' && 'code' in error ? (error as { code?: unknown }).code : undefined;\n  if (typeof code === 'string' && TRANSIENT_CONNECTION_ERROR_CODES.has(code.toUpperCase())) return true;\n\n  const message = error instanceof Error ? error.message : undefined;\n  if (typeof message === 'string' && TRANSIENT_CONNECTION_MESSAGE_PATTERN.test(message)) return true;\n\n  return false;\n}\n\n/** Short deterministic hash (sha256, first 12 hex chars) matching project.ts shortHash style. */\nfunction shortHash(input: string): string {\n  return createHash('sha256').update(input).digest('hex').slice(0, 12);\n}\n\nfunction applyEffectiveDefaultsToModes(\n  modes: AgentControllerMode[],\n  effectiveDefaults: Record<string, string>,\n): AgentControllerMode[] {\n  return modes.map(mode => {\n    const savedModel = effectiveDefaults[mode.id];\n    if (!savedModel) {\n      return mode;\n    }\n    return {\n      ...mode,\n      defaultModelId: savedModel,\n    };\n  });\n}\n\nfunction addPluginToolsToModeAllowlists(\n  modes: AgentControllerMode[],\n  pluginToolNames: string[],\n): AgentControllerMode[] {\n  if (pluginToolNames.length === 0) return modes;\n  return modes.map(mode => {\n    if (!mode.availableTools) return mode;\n    return {\n      ...mode,\n      availableTools: Array.from(new Set([...mode.availableTools, ...pluginToolNames])),\n    };\n  });\n}\n\nexport interface MastraCodeConfig {\n  /** Working directory for project detection. Default: process.cwd() */\n  cwd?: string;\n  /** Home directory for global config discovery. Default: os.homedir() */\n  homeDir?: string;\n  /** Override modes (model IDs, colors, which modes exist). Default: build/plan/fast */\n  modes?: AgentControllerMode[];\n  /** Override or extend subagent definitions. Default: explore/plan/execute */\n  subagents?: AgentControllerSubagent[];\n  /** Extra tools merged into the dynamic tool set. Can be a static record or a (sync or async) function that receives requestContext. */\n  extraTools?:\n    | Record<string, ToolLike | undefined>\n    | ((ctx: {\n        requestContext: RequestContext;\n      }) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);\n  /** Observe completed tool calls without replacing or modifying the built-in tool implementation. */\n  postToolObserver?: PostToolObserver;\n  /**\n   * Stateless input processor instances prepended before Mastra Code's mandatory processors.\n   * Embedders may extend processing but cannot replace built-in safety and compatibility policy.\n   */\n  inputProcessors?: InputProcessor[];\n  /** Tools removed from the dynamic tool set before exposure to the model */\n  disabledTools?: string[];\n  /**\n   * Custom storage config instead of auto-detected default, or a pre-built\n   * store instance. An instance is used as-is: no connection test and no\n   * LibSQL fallback — if the injected store fails, that's a hard error.\n   */\n  storage?: StorageConfig | MastraCompositeStore;\n  /** Backend for an injected custom storage instance. Inferred for LibSQLStore and PostgresStore. */\n  storageBackend?: 'libsql' | 'pg';\n  /** Pre-built vector store instance for recall search. Skips the default vector store creation. */\n  vector?: MastraVector;\n  /** Observational memory scope. Default: auto-detected from env/config files, falls back to 'thread' */\n  omScope?: 'thread' | 'resource';\n  /** Path to a custom settings.json file. Default: global settings */\n  settingsPath?: string;\n  /** Initial state overrides (yolo, thinkingLevel, etc.) */\n  initialState?: Partial<MastraCodeState>;\n  /** Override id generation for threads/messages. Primarily useful for deterministic tests. */\n  idGenerator?: AgentControllerConfig<MastraCodeState>['idGenerator'];\n  /** Override interval handlers. Default: gateway-sync */\n  intervalHandlers?: IntervalHandler[];\n  /** Override the workspace. Default: local filesystem + local sandbox based on detected project */\n  workspace?: AgentControllerConfig<MastraCodeState>['workspace'];\n  /** Override the config directory name. Default: '.mastracode'. Replaces '.mastracode' in all project-level and global config paths (MCP, hooks, commands, database, skills, agent instructions). */\n  configDir?: string;\n  /** Programmatic MCP server configurations, merged with (and overriding) file-based configs. */\n  mcpServers?: Record<string, McpServerConfig>;\n  /** Disable MCP server discovery. Default: false */\n  disableMcp?: boolean;\n  /** Disable hooks. Default: false */\n  disableHooks?: boolean;\n  /** Disable plugin discovery/loading. Default: false */\n  disablePlugins?: boolean;\n  /** Disable the polling-based GitHub signal provider even when enabled in global settings. Default: false */\n  disableGithubSignals?: boolean;\n  /** Override the plugin manager. Primarily useful for tests or embedding. */\n  pluginManager?: PluginManager;\n  /**\n   * Override the memory instance (or dynamic factory) passed to the AgentController.\n   * When provided, this replaces the default `getDynamicMemory(storage, vector)` which\n   * uses mastracode's built-in model gateway (Anthropic OAuth, OpenAI Codex,\n   * custom providers, and models.dev fallback).\n   *\n   * Use this when you need to override memory model behavior completely.\n   */\n  memory?: AgentControllerConfig<MastraCodeState>['memory'] | false;\n  /** Browser provider for browser automation tools. When set, the agent gains access to browser tools. */\n  browser?: AgentControllerConfig<MastraCodeState>['browser'];\n  /** PubSub for signal routing. When crossProcessPubSub is true, thread locks are disabled. */\n  pubsub?: PubSub;\n  /** Use Mastra Code's built-in Unix socket PubSub for local cross-process signal routing. */\n  unixSocketPubSub?: boolean;\n  /** Marks the configured PubSub as cross-process-safe, allowing Mastra Code to skip file thread locks. */\n  crossProcessPubSub?: boolean;\n}\n\nexport function createAuthStorage() {\n  const authStorage = new AuthStorage();\n  setAuthStorage(authStorage);\n  setOpenAIAuthStorage(authStorage);\n  setGitHubCopilotAuthStorage(authStorage);\n  setXAIAuthStorage(authStorage);\n  return authStorage;\n}\n\n/**\n * Resolve cloud observability credentials for the MastraPlatformExporter.\n * Priority: per-resource settings > environment variables > disabled.\n */\nfunction resolveCloudObservabilityConfig(\n  settings: ReturnType<typeof loadSettings>,\n  authStorage: AuthStorage,\n  resourceId: string,\n): { accessToken?: string; projectId?: string } {\n  const resourceConfig = settings.observability.resources[resourceId];\n  if (resourceConfig) {\n    const token = authStorage.getStoredApiKey(`${OBSERVABILITY_AUTH_PREFIX}${resourceId}`);\n    if (token) {\n      return { accessToken: token, projectId: resourceConfig.projectId };\n    }\n  }\n  // Fall back to environment variables for backwards compatibility\n  return {\n    accessToken: process.env.MASTRA_CLOUD_ACCESS_TOKEN,\n    projectId: process.env.MASTRA_PROJECT_ID,\n  };\n}\n\n/**\n * Base factory: builds every shared MastraCode resource (storage, observability,\n * memory, MCP, providers, gateways, agent, modes) and the {@link AgentController}, but\n * does NOT call `init()` or create a session. The controller is returned inert so\n * the composition layer can decide its Mastra ownership and session model.\n *\n * See {@link bootLocalAgentController} (Case 3) and `mountAgentControllerOnMastra` (Cases 1 & 2).\n */\nfunction resolveInjectedStorageBackend(\n  storage: MastraCompositeStore,\n  configuredBackend?: 'libsql' | 'pg',\n): 'libsql' | 'pg' {\n  if (configuredBackend) return configuredBackend;\n  if (storage instanceof LibSQLStore) return 'libsql';\n  if (storage instanceof PostgresStore) return 'pg';\n  throw new Error('storageBackend is required when injecting a custom storage instance.');\n}\n\nexport async function createMastraCodeAgentController(config?: MastraCodeConfig) {\n  const cwd = config?.cwd ?? process.cwd();\n  const homeDir = config?.homeDir ?? config?.initialState?.homeDir;\n  const configDir = config?.configDir ?? DEFAULT_CONFIG_DIR;\n  // The single session for this process, assigned once `createSession()` runs\n  // below. Config callbacks defined before then (e.g. notification stream\n  // options) read it lazily through this holder.\n  let activeSession: Session<MastraCodeState> | undefined;\n  if (configDir !== DEFAULT_CONFIG_DIR) {\n    validateConfigDirName(configDir);\n  }\n\n  // Load .env file from cwd if present (for observability API keys, etc.)\n  try {\n    process.loadEnvFile(path.join(cwd, '.env'));\n  } catch {\n    // No .env file — that's fine, keys may be in shell environment\n  }\n\n  // Auth storage (shared with Claude Max / OpenAI providers and AgentController)\n  const authStorage = createAuthStorage();\n  const globalSettings = loadSettings(config?.settingsPath);\n  const storedGatewayKey = authStorage.getStoredApiKey(MASTRA_GATEWAY_PROVIDER);\n  const storedGatewayUrl = globalSettings.memoryGateway?.baseUrl;\n\n  if (storedGatewayKey) {\n    process.env['MASTRA_GATEWAY_API_KEY'] ??= storedGatewayKey;\n  }\n\n  if (storedGatewayUrl) {\n    process.env['MASTRA_GATEWAY_URL'] ??= storedGatewayUrl;\n  }\n\n  // Load user-entered API keys from auth.json into process.env\n  // (only sets env vars that aren't already present — env vars take precedence).\n  // Skipped in deployed multi-tenant mode: when a per-tenant credential store\n  // provider is registered, provider keys are resolved per request and must\n  // never leak into process-global env vars.\n  if (!hasCredentialStoreProvider()) {\n    try {\n      const registry = PROVIDER_REGISTRY as Record<string, ProviderConfig>;\n      const providerEnvVars: Record<string, string | undefined> = {};\n      for (const [provider, cfg] of Object.entries(registry)) {\n        const envVars = cfg?.apiKeyEnvVar;\n        providerEnvVars[provider] = Array.isArray(envVars) ? envVars[0] : envVars;\n      }\n      providerEnvVars[MASTRA_GATEWAY_PROVIDER] ??= 'MASTRA_GATEWAY_API_KEY';\n      authStorage.loadStoredApiKeysIntoEnv(providerEnvVars);\n    } catch {\n      // Registry unavailable — load well-known provider keys so non-gateway flows still work\n      authStorage.loadStoredApiKeysIntoEnv({\n        [MASTRA_GATEWAY_PROVIDER]: 'MASTRA_GATEWAY_API_KEY',\n        anthropic: 'ANTHROPIC_API_KEY',\n        openai: 'OPENAI_API_KEY',\n        google: 'GOOGLE_GENERATIVE_AI_API_KEY',\n        cerebras: 'CEREBRAS_API_KEY',\n        deepseek: 'DEEPSEEK_API_KEY',\n      });\n    }\n  }\n\n  const mgApiKey = process.env['MASTRA_GATEWAY_API_KEY'] ?? storedGatewayKey;\n  const mastraGatewayBaseUrl = (\n    process.env['MASTRA_GATEWAY_URL'] ??\n    storedGatewayUrl ??\n    'https://gateway-api.mastra.ai'\n  )\n    .replace(/\\/+$/, '')\n    .replace(/\\/v1$/, '');\n  const mastraCodeGateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl,\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: false,\n    settingsPath: config?.settingsPath,\n  });\n  const amazonBedrockGateway = createAmazonBedrockGateway();\n\n  // Project detection\n  const project = detectProject(cwd);\n\n  const resourceIdOverride = getResourceIdOverride(project.rootPath, configDir);\n  if (resourceIdOverride) {\n    project.resourceId = resourceIdOverride;\n    project.resourceIdOverride = true;\n  }\n\n  // Stable session id unique to this project/resource, and a machine-bound owner\n  // id. resourceId encodes root path + git identity and honors overrides, so it\n  // is the right input for scoping the session to the cwd/project.\n  const sessionId = `mastracode-session-${shortHash(project.resourceId)}`;\n  const ownerId = `mastracode-${shortHash(`${hostname()}\\0${project.rootPath}`)}`;\n\n  const configuredPubSub = config?.pubsub;\n  const useUnixSocketPubSub =\n    (config?.unixSocketPubSub ?? globalSettings.signals?.unixSocketPubSub ?? false) && process.platform !== 'win32';\n  const signalsPubSub = configuredPubSub ?? (useUnixSocketPubSub ? createSignalsPubSub(project.resourceId) : undefined);\n  const crossProcessPubSub = config?.crossProcessPubSub ?? (!configuredPubSub && useUnixSocketPubSub);\n  if (crossProcessPubSub && !signalsPubSub) {\n    throw new Error('crossProcessPubSub requires a pubsub instance');\n  }\n\n  // Storage. An injected instance is used as-is — no connection test, no\n  // LibSQL fallback: if the injected store fails, that's a hard error.\n  const injectedStorage = config?.storage instanceof MastraCompositeStore ? config.storage : undefined;\n  const storageConfig = injectedStorage\n    ? undefined\n    : ((config?.storage as StorageConfig | undefined) ??\n      getStorageConfig(project.rootPath, globalSettings.storage, configDir));\n  const storageResult: StorageResult = injectedStorage\n    ? { storage: injectedStorage, backend: resolveInjectedStorageBackend(injectedStorage, config?.storageBackend) }\n    : await createStorage(storageConfig!);\n  const storageWarning = storageResult.warning;\n\n  // Observability storage (DuckDB — separate file for OLAP-style trace/score/feedback queries).\n  // Local tracing is opt-in via `/observability local on`. When disabled, the\n  // MastraStorageExporter is omitted entirely so traces never fall through to\n  // the default libsql backend.\n  let observabilityDomain: DuckDBStore['observability'] | undefined;\n  let observabilityWarning: string | undefined;\n  if (globalSettings.observability.localTracing) {\n    try {\n      const observabilityDuckDB = new DuckDBStore({\n        id: 'mastra-code-observability',\n        path: getObservabilityDatabasePath(),\n      });\n      // Force an early connection attempt so the lock error surfaces now, not mid-session.\n      await observabilityDuckDB.db.getConnection();\n      observabilityDomain = observabilityDuckDB.observability;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const isLockError = /lock|locked|busy/i.test(message);\n      if (isLockError) {\n        observabilityWarning =\n          'Observability unavailable — another MastraCode instance holds the database lock. Traces, scores, and feedback will not be recorded in this session.';\n      } else {\n        observabilityWarning = `Observability unavailable — DuckDB initialization failed: ${message}`;\n      }\n    }\n  }\n\n  const harnessStorage = new InMemoryHarness();\n\n  const storage = new MastraCompositeStore({\n    id: 'mastra-code-storage',\n    default: storageResult.storage,\n    domains: {\n      // When local tracing is off, disable the observability domain entirely so\n      // trace/score/feedback writes never fall through to the default libsql store.\n      observability: observabilityDomain ?? false,\n      harness: harnessStorage,\n    },\n  });\n\n  // Observability (tracing, scoring, feedback)\n  const observability = new Observability({\n    configs: {\n      default: {\n        serviceName: 'mastracode',\n        // Only these requestContext keys are stored on spans — prevents leaking\n        // large objects (controller state, workspace, env vars) into trace data.\n        // Use dot-notation because these are nested inside the 'controller' key.\n        //\n        // Session identifiers:\n        //   threadId, resourceId, session.modeId, agentControllerId\n        // Environment & project:\n        //   state.projectName, state.gitBranch\n        // Model configuration:\n        //   session.modelId, state.subagentModelId\n        // Agent settings:\n        //   state.yolo, state.thinkingLevel, state.smartEditing\n        // Observational memory settings:\n        //   state.omScope, state.observerModelId, state.reflectorModelId,\n        //   state.observationThreshold, state.reflectionThreshold\n        requestContextKeys: [\n          // Session identifiers\n          'controller.threadId',\n          'controller.resourceId',\n          'controller.session.modeId',\n          'controller.controllerId',\n          // Environment & project\n          'controller.state.projectName',\n          'controller.state.gitBranch',\n          // Model configuration\n          'controller.session.modelId',\n          'controller.state.subagentModelId',\n          // Agent settings\n          'controller.state.yolo',\n          'controller.state.thinkingLevel',\n          'controller.state.smartEditing',\n          // Observational memory settings\n          'controller.state.omScope',\n          'controller.state.observerModelId',\n          'controller.state.reflectorModelId',\n          'controller.state.observationThreshold',\n          'controller.state.reflectionThreshold',\n        ],\n        exporters: [\n          // Only persist traces locally when DuckDB observability is available\n          // (via `/observability local on`). Without this guard the storage\n          // exporter falls through to the default libsql backend and silently\n          // fills the main database with gigabytes of span data.\n          ...(observabilityDomain ? [new MastraStorageExporter({ strategy: 'event-sourced' })] : []),\n          new MastraPlatformExporter(resolveCloudObservabilityConfig(globalSettings, authStorage, project.resourceId)),\n        ],\n        spanOutputProcessors: [new SensitiveDataFilter()],\n      },\n    },\n  });\n\n  // Vector store for recall search (separate DB file to avoid bloating main\n  // storage). An injected instance is used as-is; with an injected storage\n  // instance and no injected vector, recall search stays vector-less.\n  const vector =\n    config?.vector ?? (storageConfig ? await createVectorStore(storageConfig, storageResult.backend) : undefined);\n\n  // Maintenance handle for /prune: prunes via the inner store (whose retention\n  // config covers every domain, including legacy libsql observability spans)\n  // and can compact local libsql files to reclaim disk. The vector store's\n  // connection must close alongside storage — the compaction's file swap\n  // refuses to run while any connection is open.\n  const storageMaintenance: StorageMaintenance = createStorageMaintenance({\n    storage: storageResult.storage,\n    backend: storageResult.backend,\n    retention: DEFAULT_RETENTION,\n    localDbFiles: storageConfig ? resolveLocalDbFiles(storageConfig, storageResult.backend) : [],\n    closeVector: vector instanceof LibSQLVector ? () => vector.close() : undefined,\n  });\n\n  const memory = config?.memory === false ? undefined : (config?.memory ?? getDynamicMemory(storage, vector));\n\n  // MCP\n  const mcpManager = config?.disableMcp ? undefined : createMcpManager(project.rootPath, configDir, config?.mcpServers);\n\n  // Hooks\n  const hookManager = config?.disableHooks\n    ? undefined\n    : new HookManager(project.rootPath, 'session-init', configDir, homeDir);\n\n  const pluginManager = config?.disablePlugins\n    ? undefined\n    : (config?.pluginManager ?? new PluginManager({ projectRoot: project.rootPath, configDir, homeDir }));\n  const loadedPlugins = pluginManager ? await pluginManager.reload() : [];\n  const pluginTools = pluginManager?.getPluginTools() ?? {};\n\n  // Scorers (live evaluation with sampling)\n  const outcomeScorer = createOutcomeScorer();\n  const efficiencyScorer = createEfficiencyScorer();\n\n  // Agent — githubSignals is created before `controller` but the closure below\n  // captures `controller` by reference; it is only invoked at notification time,\n  // well after controller is constructed (line ~692). Explicit type annotations\n  // on githubSignals, codeAgent, modes, and controller break the circular\n  // inference chain this forward reference would otherwise create.\n  const githubSignals: GithubSignals | undefined =\n    globalSettings.signals?.experimentalGithubSignals && !config?.disableGithubSignals\n      ? new GithubSignals({\n          cwd: project.rootPath,\n          gitcrawlCommand:\n            process.env.MASTRACODE_GITCRAWL_BIN ??\n            process.env.GITCRAWL_BIN ??\n            process.env.MASTRACODE_GITCRAWL_COMMAND ??\n            process.env.GITCRAWL_COMMAND,\n          getNotificationStreamOptions: async ({ resourceId, threadId }) => {\n            // Run the woken notification as the session that owns the target\n            // resource so it uses that session's model/mode/state. Fall back to\n            // the current session only when no session owns the resource yet.\n            const session = (await controller.getSessionByResource(resourceId)) ?? activeSession!;\n            // A long-running system must be able to drive work unattended, so a\n            // target session without an explicit model selection falls back to a\n            // real model rather than failing the run: the current session's live\n            // selection (what the user actually picked), then the mode's default.\n            const modeId = session.mode.get();\n            const defaultModeModelId = controller.listModes().find(mode => mode.id === modeId)?.defaultModelId;\n            const modelId = session.model.get() || activeSession?.model.get() || defaultModeModelId || '';\n            const requestContext = new RequestContext();\n            const agentControllerContext: AgentControllerRequestContext = {\n              controllerId: controller.id,\n              state: session.state.get(),\n              getState: () => session.state.get(),\n              setState: updates => session.state.set(updates),\n              threadId,\n              resourceId,\n              session: {\n                id: session.identity.getId(),\n                ownerId: session.identity.getOwnerId(),\n                modeId,\n                modelId,\n                state: {\n                  get: () => session.state.get(),\n                  set: updates => session.state.set(updates),\n                  update: updater => session.state.update(updater),\n                },\n              },\n              workspace: controller.getWorkspace(),\n              getSubagentModelId: params => session.subagents.model.get(params ?? {}),\n            };\n            requestContext.set('controller', agentControllerContext);\n\n            return {\n              memory: { thread: threadId, resource: resourceId },\n              requestContext,\n              maxSteps: 1000,\n              savePerStep: false,\n              requireToolApproval: (session.state.get() as Record<string, unknown>).yolo !== true,\n              modelSettings: { temperature: 1 },\n            };\n          },\n        })\n      : undefined;\n  const codeAgent: Agent = createCodingAgent({\n    id: CODE_AGENT_ID,\n    name: 'Code Agent',\n    // Workspace is wired per-request at the AgentController level (see\n    // `config.workspace` below), so opt out of the factory's default local\n    // workspace. An explicit `undefined` is required: the factory only builds a\n    // default when the `workspace` key is absent.\n    workspace: undefined,\n    instructions: getDynamicInstructions,\n    model: getDynamicModel,\n    tools: createDynamicTools(mcpManager, config?.extraTools, config?.disabledTools, storage, pluginTools),\n    hooks: createToolHooks(hookManager, config?.postToolObserver),\n    scorers: {\n      outcome: {\n        scorer: outcomeScorer,\n        sampling: { type: 'none' },\n      },\n      efficiency: {\n        scorer: efficiencyScorer,\n        sampling: { type: 'ratio', rate: 0.3 },\n      },\n    },\n    // TaskSignalProvider bundles the task tools + TaskStateProcessor: it merges\n    // the tools into the toolset and registers the task state-signal processor,\n    // so the task list persists across turns and survives OM truncation.\n    signals: [new TaskSignalProvider(), ...(githubSignals ? [githubSignals] : [])],\n    // Native goal mechanism: the in-loop goal step judges the thread's active\n    // objective each qualifying iteration. The judge model is required for any\n    // gating to occur; when unset the goal step is a complete no-op. A6 auto-wires\n    // the GoalStateProcessor so the `<current-objective>` signal persists across\n    // turns. Per-thread overrides live in the ThreadState `goal` record and win\n    // over these defaults.\n    goal: {\n      // Resolve the judge model through mastracode's gateway (a model-resolver\n      // function) so provider credentials are injected; returns undefined when no\n      // judge model is configured, keeping the goal step a no-op. Bind the same\n      // `settingsPath` used above so the judge model and `maxRuns` come from one\n      // config (a custom settings file would otherwise diverge).\n      judge: ctx => getGoalJudgeModel(ctx, config?.settingsPath),\n      maxRuns: globalSettings.models.goalMaxTurns ?? 50,\n      maxSteps: 1000,\n      prompt: DEFAULT_GOAL_JUDGE_PROMPT,\n      // Read-only workspace tools the default goal judge may call to verify the\n      // agent's work against the actual filesystem (view, search_content,\n      // find_files, file_stat, lsp_inspect) rather than grading prose alone —\n      // restoring the original MastraCode judge's verification ability. Resolved\n      // per-request from the active workspace (mirrors `judge`).\n      tools: getGoalJudgeTools,\n    },\n    inputProcessors: [\n      ...(config?.inputProcessors ?? []),\n      new PlanRejectionAbortProcessor(),\n      new AgentsMDInjector({\n        getIgnoredInstructionPaths: ({ requestContext }) => {\n          const agentControllerContext = requestContext?.get('controller') as\n            AgentControllerRequestContext<{ projectPath?: string }> | undefined;\n          const state = agentControllerContext?.getState();\n          return getStaticallyLoadedInstructionPaths(state?.projectPath ?? project.rootPath);\n        },\n      }),\n      new ProviderHistoryCompat(),\n    ],\n    errorProcessors: [\n      new StreamErrorRetryProcessor({\n        matchers: [\n          { match: isBadRequestError, maxRetries: 1, delayMs: 2000 },\n          {\n            match: isTransientConnectionError,\n            maxRetries: MASTRACODE_TRANSIENT_CONNECTION_MAX_RETRIES,\n            delayMs: ({ retryCount }) =>\n              Math.min(\n                MASTRACODE_TRANSIENT_CONNECTION_RETRY_INITIAL_DELAY_MS * Math.pow(2, retryCount),\n                MASTRACODE_TRANSIENT_CONNECTION_RETRY_MAX_DELAY_MS,\n              ),\n          },\n        ],\n      }),\n      new PrefillErrorHandler(),\n      new ProviderHistoryCompat(),\n    ],\n  });\n\n  // const defaultSubAgents: Array<AgentControllerSubagent> = [];\n  // const defaultSubagents = [exploreSubagent, planSubagent, executeSubagent];\n\n  const defaultModes: AgentControllerMode[] = [\n    {\n      ...buildMode,\n      metadata: {\n        ...buildMode.metadata,\n        color: mastraBrand.green,\n      },\n    },\n    {\n      ...planMode,\n      metadata: {\n        ...planMode.metadata,\n        color: mastraBrand.purple,\n      },\n    },\n    {\n      ...fastMode,\n      metadata: {\n        ...fastMode.metadata,\n        color: mastraBrand.orange,\n      },\n    },\n  ];\n\n  const defaultIntervalHandlers: IntervalHandler[] = [\n    {\n      id: 'gateway-sync',\n      intervalMs: 5 * 60 * 1000,\n      immediate: false,\n      handler: () => syncGateways(),\n    },\n  ];\n  const intervalHandlers = config?.intervalHandlers ?? defaultIntervalHandlers;\n\n  // Build lightweight provider access for resolving built-in packs at startup.\n  // Anthropic/OpenAI use AuthStorage; other providers use env API keys.\n  // Also scan the full provider registry so configured API keys satisfy access checks.\n  const anthropicCred = authStorage.get('anthropic');\n  const openaiCred = authStorage.get('openai-codex');\n  const githubCopilotCred = authStorage.get('github-copilot');\n  const startupAccess: ProviderAccess = {\n    anthropic:\n      anthropicCred?.type === 'oauth'\n        ? 'oauth'\n        : anthropicCred?.type === 'api_key' && anthropicCred.key.trim().length > 0\n          ? 'apikey'\n          : false,\n    openai:\n      openaiCred?.type === 'oauth'\n        ? 'oauth'\n        : openaiCred?.type === 'api_key' && openaiCred.key.trim().length > 0\n          ? 'apikey'\n          : false,\n    cerebras: process.env.CEREBRAS_API_KEY ? 'apikey' : false,\n    google: process.env.GOOGLE_GENERATIVE_AI_API_KEY ? 'apikey' : false,\n    deepseek: process.env.DEEPSEEK_API_KEY ? 'apikey' : false,\n    'github-copilot': githubCopilotCred?.type === 'oauth' ? 'oauth' : false,\n  };\n  // Gateway covers all providers — ensure Anthropic/OpenAI packs are visible\n  if (mgApiKey) {\n    if (!startupAccess.anthropic) startupAccess.anthropic = 'apikey';\n    if (!startupAccess.openai) startupAccess.openai = 'apikey';\n  }\n  // Check all providers in the registry for API keys\n  try {\n    const registry = PROVIDER_REGISTRY as Record<string, ProviderConfig>;\n    for (const [provider, config] of Object.entries(registry)) {\n      if (startupAccess[provider] === 'oauth' || startupAccess[provider] === 'apikey') continue; // Already enabled above\n      if (provider === 'anthropic' || provider === 'openai') continue;\n      const envVars = config?.apiKeyEnvVar;\n      const envVarList = Array.isArray(envVars) ? envVars : envVars ? [envVars] : [];\n      if (envVarList.some(envVar => process.env[envVar])) {\n        startupAccess[provider] = 'apikey';\n      }\n    }\n  } catch {\n    // Registry may not be loaded yet; the 5 hardcoded providers are sufficient fallback\n  }\n  const builtinPacks = getAvailableModePacks(startupAccess);\n  const builtinOmPacks = getAvailableOmPacks(startupAccess);\n  const effectiveDefaults = resolveModelDefaults(globalSettings, builtinPacks);\n  const effectiveObserverModel = resolveOmRoleModel(globalSettings, 'observer', builtinOmPacks);\n  const effectiveReflectorModel = resolveOmRoleModel(globalSettings, 'reflector', builtinOmPacks);\n  const effectiveObservationThreshold = globalSettings.models.omObservationThreshold ?? undefined;\n  const effectiveReflectionThreshold = globalSettings.models.omReflectionThreshold ?? undefined;\n  const effectiveCavemanObservations = globalSettings.models.omCavemanObservations ?? undefined;\n  const effectiveObserveAttachments = globalSettings.models.omObserveAttachments ?? 'auto';\n\n  const modes = addPluginToolsToModeAllowlists(\n    applyEffectiveDefaultsToModes(config?.modes ? config.modes : defaultModes, effectiveDefaults),\n    Object.keys(pluginTools),\n  );\n  const defaultModeId =\n    modes.find(mode => mode.metadata?.default === true)?.id ??\n    modes.find(mode => mode.id === 'build')?.id ??\n    modes[0]?.id;\n  if (!defaultModeId) {\n    throw new Error('MastraCode requires at least one mode');\n  }\n\n  // Map subagent types to mode models: explore→fast, plan→plan, execute→build\n  // const subagentModeMap: Record<string, string> = { explore: 'fast', plan: 'plan', execute: 'build' };\n  // Subagents inherit workspace tools from the parent agent's workspace automatically.\n  // Apply disabledTools filter to both default and custom subagents.\n  // const subagents = [];\n\n  // Build initial state with global preferences\n  const globalInitialState: Partial<MastraCodeState> = {};\n  if (effectiveObserverModel) {\n    globalInitialState.observerModelId = effectiveObserverModel;\n  }\n  if (effectiveReflectorModel) {\n    globalInitialState.reflectorModelId = effectiveReflectorModel;\n  }\n  if (effectiveObservationThreshold !== undefined) {\n    globalInitialState.observationThreshold = effectiveObservationThreshold;\n  }\n  if (effectiveReflectionThreshold !== undefined) {\n    globalInitialState.reflectionThreshold = effectiveReflectionThreshold;\n  }\n  if (effectiveCavemanObservations !== undefined) {\n    globalInitialState.cavemanObservations = effectiveCavemanObservations;\n  }\n  if (effectiveObserveAttachments !== undefined) {\n    globalInitialState.observeAttachments = effectiveObserveAttachments;\n  }\n  if (globalSettings.preferences.yolo !== null) {\n    globalInitialState.yolo = globalSettings.preferences.yolo;\n  }\n  globalInitialState.thinkingLevel = globalSettings.preferences.thinkingLevel;\n  if (config?.omScope) {\n    globalInitialState.omScope = config.omScope;\n  }\n  // Seed subagent models from global settings\n  for (const [key, modelId] of Object.entries(globalSettings.models.subagentModels)) {\n    if (key === 'default' || key === '_default') {\n      globalInitialState.subagentModelId = modelId;\n    } else {\n      globalInitialState[`subagentModelId_${key}`] = modelId;\n    }\n  }\n\n  const typedStateSchema = stateSchema as PublicSchema<MastraCodeState>;\n  const controller: AgentController<MastraCodeState> = new AgentController<MastraCodeState>({\n    id: 'mastra-code',\n    resourceId: project.resourceId,\n    storage,\n    observability,\n    memory,\n    pubsub: signalsPubSub,\n    stateSchema: typedStateSchema,\n    agent: codeAgent,\n    subagents: config?.subagents ?? [],\n    gateways: [amazonBedrockGateway, mastraCodeGateway],\n    workspace: config?.workspace ?? (args => getDynamicWorkspace(args)),\n    browser: config?.browser,\n    idGenerator: config?.idGenerator,\n    toolCategoryResolver: getToolCategory,\n    initialState: {\n      projectPath: project.rootPath,\n      projectName: project.name,\n      gitBranch: project.gitBranch,\n      pluginSkillPaths: loadedPlugins.flatMap(plugin => (plugin.status === 'active' ? (plugin.skillPaths ?? []) : [])),\n      pluginCommandPaths: loadedPlugins.flatMap(plugin =>\n        plugin.status === 'active' ? (plugin.commandPaths ?? []) : [],\n      ),\n      pluginInstructions: loadedPlugins.flatMap(plugin =>\n        plugin.status === 'active' && plugin.instructions ? [plugin.instructions] : [],\n      ),\n      yolo: true,\n      ...globalInitialState,\n      ...config?.initialState,\n      // configDir must always win over initialState spreads to stay in sync\n      // with MCP/hooks/storage which were already initialized with this value.\n      configDir,\n    },\n    modes,\n    intervalHandlers,\n    modelUseCountProvider: () => loadSettings().modelUseCounts,\n    modelUseCountTracker: modelId => {\n      try {\n        const settings = loadSettings();\n        settings.modelUseCounts[modelId] = (settings.modelUseCounts[modelId] ?? 0) + 1;\n        saveSettings(settings);\n      } catch (error) {\n        console.error('Failed to persist model usage count', error);\n      }\n    },\n    threadLock: crossProcessPubSub\n      ? undefined\n      : {\n          acquire: acquireThreadLock,\n          release: releaseThreadLock,\n        },\n  });\n\n  // The AgentController is fully constructed but intentionally NOT inited here. Init and\n  // session creation are deferred to the composition layer (see below) so the\n  // controller can be wired in three ways:\n  //\n  //   1. Server + Web   — registered on a server Mastra, then inited; sessions\n  //                       minted per browser client over HTTP.\n  //   2. Server + TUI   — same server composition; the TUI drives a session\n  //                       (in-process today; remote transport is future work).\n  //   3. Local  + TUI   — controller builds its own internal Mastra on init() and\n  //                       mints one eager session for the whole process.\n  //\n  // Cases 1 & 2 use `mountAgentControllerOnMastra` (register-before-init, no eager\n  // session). Case 3 uses `bootLocalAgentController` (init + one wired session).\n  return {\n    controller: controller,\n    storage,\n    storageMaintenance,\n    observability,\n    memory,\n    mcpManager,\n    hookManager,\n    pluginManager,\n    loadedPlugins,\n    pluginTools,\n    signalsPubSub,\n    authStorage,\n    resolveModel,\n    storageWarning,\n    observabilityWarning,\n    builtinPacks,\n    builtinOmPacks,\n    effectiveDefaults,\n    githubSignals,\n    // Identity for the single local session (Case 3). Servers ignore these and\n    // mint per-request sessions with client-supplied resourceIds instead.\n    sessionId,\n    ownerId,\n    // Lets the composition layer publish the created session back into the\n    // config closures (e.g. notification stream options read it lazily).\n    setActiveSession: (session: Session<MastraCodeState>) => {\n      activeSession = session;\n    },\n  };\n}\n\n/**\n * Result of {@link createMastraCodeAgentController}: every shared resource plus the\n * inert AgentController, ready to be either booted locally or mounted on a server\n * Mastra.\n */\nexport type MastraCodeAgentController = Awaited<ReturnType<typeof createMastraCodeAgentController>>;\n\n/**\n * Wires the session-scoped concerns MastraCode layers on top of a Session:\n * hookManager thread-id sync, GitHub PR polling for the current thread, and\n * per-thread persistence of the mastracode-only `/om` settings.\n *\n * Used by {@link bootLocalAgentController} for the single local session. A server can\n * call this for any session it mints if it wants the same background wiring.\n */\nexport async function wireSessionConcerns(\n  base: Pick<MastraCodeAgentController, 'hookManager' | 'githubSignals' | 'setActiveSession'>,\n  session: Session<MastraCodeState>,\n): Promise<void> {\n  const { hookManager, githubSignals } = base;\n  base.setActiveSession(session);\n\n  // Sync hookManager session ID on thread changes\n  if (hookManager) {\n    session.subscribe((event: AgentControllerEvent) => {\n      if (event.type === 'thread_changed') {\n        hookManager.setSessionId(event.threadId);\n      } else if (event.type === 'thread_created') {\n        hookManager.setSessionId(event.thread.id);\n      }\n    });\n  }\n\n  if (githubSignals) {\n    const startGithubPollingForCurrentThread = async (threadId?: string | null) => {\n      if (!threadId) return;\n      githubSignals.stopAllPolling();\n      try {\n        const threads = await session.thread.list({ allResources: true });\n        const thread = threads.find((item: { id: string }) => item.id === threadId);\n        await githubSignals.startPollingForThread(\n          {\n            threadId,\n            resourceId: thread?.resourceId ?? session.identity.getResourceId(),\n          },\n          { pollImmediately: true },\n        );\n      } catch (error) {\n        console.warn('Failed to start GitHub PR polling:', error);\n      }\n    };\n\n    session.subscribe((event: AgentControllerEvent) => {\n      if (event.type === 'thread_changed') void startGithubPollingForCurrentThread(event.threadId);\n      else if (event.type === 'thread_created') void startGithubPollingForCurrentThread(event.thread.id);\n    });\n    void startGithubPollingForCurrentThread(session.thread.getId());\n  }\n\n  // Persist MastraCode-owned /om settings per-thread (mastracode-only concern;\n  // intentionally not in core's controller loadThreadMetadata).\n  const omThreadStateSession = session as unknown as Session<Record<string, unknown>>;\n  attachOMThreadStatePersistence(omThreadStateSession);\n  await restoreOMThreadStateForCurrentThread(omThreadStateSession).catch(() => {\n    // Persistence is best-effort; don't crash startup if storage hiccups.\n  });\n}\n\n/**\n * Case 3 (AgentController local + TUI/headless): build the controller, let it stand up its\n * own internal Mastra via `init()`, and mint the single eager session that all\n * work in this process runs through. The AgentController owns no session of its own.\n */\nexport async function bootLocalAgentController(config?: MastraCodeConfig) {\n  const base = await createMastraCodeAgentController(config);\n  const { controller, sessionId, ownerId } = base;\n\n  await controller.init();\n  await controller.getMastra()?.startWorkers();\n  const session = await controller.createSession({ id: sessionId, ownerId });\n  await wireSessionConcerns(base, session);\n\n  return { ...base, session };\n}\n\n/** Result of {@link mountAgentControllerOnMastra}: shared handles plus the owning Mastra. */\nexport type MountedMastraCode = MastraCodeAgentController & { mastra: Mastra };\n\n/**\n * Cases 1 & 2 (AgentController in Server + Web/TUI): build the controller, register it on a\n * server-owned Mastra, THEN init it. Registering before `init()` is what makes\n * the controller inherit the server's Mastra (storage, agents, gateways) instead of\n * spinning up its own internal one — there is a single shared Mastra.\n *\n * No eager session is minted: each client (browser or terminal) creates/resumes\n * its own isolated session via `controller.createSession({ resourceId })`, so one\n * server can drive many concurrent users.\n *\n * Pass an existing `mastra` to mount onto a Mastra that already hosts other\n * primitives; otherwise a Mastra is created that owns the controller's storage so\n * durability is configured in one place.\n */\nexport async function mountAgentControllerOnMastra(\n  config?: MastraCodeConfig & {\n    mastra?: Mastra;\n    controllerId?: string;\n    buildApiRoutes?: (deps: { controller: MountedMastraCode['controller']; authStorage: AuthStorage }) => ApiRoute[];\n    /**\n     * Additional `server` config to fold onto the constructed Mastra alongside\n     * the assembled `apiRoutes` (e.g. `middleware`, `cors`). Used by the\n     * platform entry (`src/mastra/index.ts`) to own the WorkOS gate + tenant\n     * dispatcher + CORS on the instance the deployer generates its server from.\n     * Ignored when `mastra` is provided (mounting onto a caller-owned instance).\n     */\n    buildServerConfig?: (deps: {\n      controller: MountedMastraCode['controller'];\n      authStorage: AuthStorage;\n    }) => Omit<NonNullable<ConstructorParameters<typeof Mastra>[0]>['server'], 'apiRoutes'>;\n  },\n): Promise<MountedMastraCode> {\n  const prepared = await prepareAgentControllerMount(config);\n  if (config?.mastra) {\n    // Mounting onto a Mastra the caller already built. Ensure the controller's\n    // back-reference points at it (idempotent — only sets #externalMastra).\n    prepared.base.controller.__registerMastra(config.mastra);\n    await prepared.finalize();\n    return { ...prepared.base, mastra: config.mastra };\n  }\n  const mastra = new Mastra(prepared.mastraArgs);\n  await prepared.finalize();\n  return { ...prepared.base, mastra };\n}\n\n/**\n * Assemble everything needed to construct the server-owned Mastra WITHOUT\n * constructing it, so a caller (the platform entry `src/mastra/index.ts`) can\n * run the `new Mastra(...)` literal in its own module. The deployer's\n * `checkConfigExport` Babel plugin only marks the config valid when it finds a\n * top-level `new Mastra(...)` exported as `mastra` in the ENTRY file; hiding the\n * construction inside this helper would trip the \"Invalid Mastra config\" warning.\n *\n * Returns the constructor args plus a `finalize()` that runs the post-construct\n * boot (`controller.init()` + `startWorkers()`). The controller is registered on\n * the Mastra via the `agentControllers` arg at construction time.\n */\nexport async function prepareAgentControllerMount(\n  config?: MastraCodeConfig & {\n    mastra?: Mastra;\n    controllerId?: string;\n    buildApiRoutes?: (deps: { controller: MountedMastraCode['controller']; authStorage: AuthStorage }) => ApiRoute[];\n    buildServerConfig?: (deps: {\n      controller: MountedMastraCode['controller'];\n      authStorage: AuthStorage;\n    }) => Omit<NonNullable<ConstructorParameters<typeof Mastra>[0]>['server'], 'apiRoutes'>;\n  },\n): Promise<{\n  base: Awaited<ReturnType<typeof createMastraCodeAgentController>>;\n  mastraArgs: NonNullable<ConstructorParameters<typeof Mastra>[0]>;\n  finalize: () => Promise<void>;\n}> {\n  const base = await createMastraCodeAgentController(config);\n  const { controller, storage, authStorage } = base;\n  const controllerId = config?.controllerId ?? controller.id;\n  const apiRoutes = config?.buildApiRoutes?.({ controller, authStorage });\n  const extraServerConfig = config?.buildServerConfig?.({ controller, authStorage });\n\n  const serverConfig = {\n    ...extraServerConfig,\n    ...(apiRoutes?.length ? { apiRoutes } : {}),\n  };\n  const mastraArgs = {\n    agentControllers: { [controllerId]: controller },\n    storage,\n    // Mirror the controller's internal-Mastra construction (which passes\n    // `config.pubsub` through): the server-owned Mastra must run its event\n    // bus on the same transport so streams/workflows/signals stay\n    // cross-process when a distributed PubSub (e.g. Redis Streams) is\n    // configured.\n    ...(base.signalsPubSub ? { pubsub: base.signalsPubSub } : {}),\n    ...(Object.keys(serverConfig).length ? { server: serverConfig } : {}),\n  };\n\n  const finalize = async () => {\n    await controller.init();\n    await controller.getMastra()?.startWorkers();\n  };\n\n  return { base, mastraArgs, finalize };\n}\n\n/**\n * Back-compat alias. Historically `createMastraCode` built and booted a local\n * controller with a single session; that behavior now lives in\n * {@link bootLocalAgentController}. New code should call the explicit factory for its\n * case: `bootLocalAgentController` (local) or {@link mountAgentControllerOnMastra} (server).\n */\nexport const createMastraCode = bootLocalAgentController;\n\n/**\n * Programmatic headless API. `runMC` runs an already-built controller/session\n * (from {@link createMastraCode}) as an async-iterable run that also resolves to\n * a typed result. Also available via the `mastracode/headless` subpath.\n */\nexport {\n  runMC,\n  runMCCli,\n  hasHeadlessFlag,\n  autoApprovePolicy,\n  denyPolicy,\n  permissionModeToPolicy,\n  formatHuman,\n  formatJsonl,\n  renderTextResult,\n  renderJsonResult,\n} from './headless/index.js';\nexport type {\n  RunMCOptions,\n  RunMCResult,\n  RunMCStatus,\n  RunMCUsage,\n  RunMCToolCall,\n  RunMCToolResult,\n  RunMCError,\n  RunMCThreadOptions,\n  MCRun,\n  ResolutionPolicy,\n  PermissionMode,\n} from './headless/index.js';\n"],"mappings":"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","names":["config"]}

package/dist/mcp/config.d.ts

@@ -10,7 +10,27 @@
  * `.mcp.json` is read so a project that already keeps MCP servers there for
  * Claude Code does not need to duplicate them under `.mastracode/`.
  */
-import type { McpConfig } from './types.js';
+import type { McpConfig, McpHttpOAuthConfig } from './types.js';
+/**
+ * Default OAuth redirect URL for servers that do not configure one.
+ * Port 1458 is stable across sessions so persisted tokens keep the same
+ * storage fingerprint; it sits clear of the ports the Codex login flow
+ * reserves (1455/1457). When 1458 is busy the callback server falls back
+ * to the next sequential port, which stays covered by the client
+ * registration (see `@mastra/mcp`'s `getCallbackUrlCandidates`).
+ */
+export declare const DEFAULT_OAUTH_REDIRECT_URL = "http://127.0.0.1:1458/oauth/callback";
+/**
+ * Resolve the effective OAuth redirect URL for a server config.
+ *
+ * `callbackPort` (the Claude Code / Codex convention) takes precedence and
+ * synthesizes `http://localhost:<port>/callback`. Config-file entries are
+ * normalized by `parseOAuthConfig` (which also enforces that `callbackPort`
+ * and `redirectUrl` are mutually exclusive), but programmatically registered
+ * servers bypass the parser, so every consumer of the redirect URL must
+ * resolve it through this helper rather than reading `redirectUrl` directly.
+ */
+export declare function resolveOAuthRedirectUrl(oauth: McpHttpOAuthConfig | undefined): string;
 export declare function loadMcpConfig(projectDir: string, configDirName?: string): McpConfig;
 export declare function getProjectMcpPath(projectDir: string, configDirName?: string): string;
 export declare function getRootMcpPath(projectDir: string): string;

package/dist/mcp/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAyD,MAAM,YAAY,CAAC;AAEnG,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,SAAS,CAO/F;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,MAAM,CAEhG;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,aAAa,SAAqB,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AA4BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUzF;AA4BD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BtG;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAiDtD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAqC,MAAM,YAAY,CAAC;AAEnG;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,yCAAyC,CAAC;AAYjF;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAKrF;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,SAAS,CAO/F;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,MAAM,CAEhG;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,aAAa,SAAqB,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AA4BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUzF;AA4BD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BtG;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAiDtD"}

package/dist/mcp/config.js

@@ -2,6 +2,17 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { DEFAULT_CONFIG_DIR } from "../constants.js";
+const DEFAULT_OAUTH_REDIRECT_URL = "http://127.0.0.1:1458/oauth/callback";
+const LOOPBACK_IPV4 = /^127\.(?:\d{1,3})\.(?:\d{1,3})\.(?:\d{1,3})$/;
+function isLoopbackHostname(hostname) {
+  return hostname === "localhost" || hostname === "[::1]" || hostname === "::1" || LOOPBACK_IPV4.test(hostname);
+}
+function resolveOAuthRedirectUrl(oauth) {
+  if (oauth?.callbackPort !== void 0) {
+    return `http://localhost:${oauth.callbackPort}/callback`;
+  }
+  return oauth?.redirectUrl ?? DEFAULT_OAUTH_REDIRECT_URL;
+}
 function loadMcpConfig(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
   const claudeConfig = loadClaudeSettings(projectDir);
   const globalConfig = loadSingleConfig(getGlobalMcpPath(configDirName));
@@ -139,24 +150,35 @@ function parseOAuthConfig(raw) {
     return { reason: "Invalid OAuth config: expected an object" };
   }
   const obj = raw;
-  if (typeof obj.redirectUrl !== "string") {
-    return { reason: 'Invalid OAuth config: missing required field "redirectUrl"' };
+  if (obj.redirectUrl !== void 0 && typeof obj.redirectUrl !== "string") {
+    return { reason: 'Invalid OAuth config: "redirectUrl" must be a string' };
+  }
+  let callbackPortRedirectUrl;
+  if (obj.callbackPort !== void 0) {
+    if (obj.redirectUrl !== void 0) {
+      return { reason: 'Invalid OAuth config: set either "redirectUrl" or "callbackPort", not both' };
+    }
+    if (typeof obj.callbackPort !== "number" || !Number.isInteger(obj.callbackPort) || obj.callbackPort < 1 || obj.callbackPort > 65535) {
+      return { reason: 'Invalid OAuth config: "callbackPort" must be an integer between 1 and 65535' };
+    }
+    callbackPortRedirectUrl = resolveOAuthRedirectUrl({ callbackPort: obj.callbackPort });
   }
+  const rawRedirectUrl = callbackPortRedirectUrl ?? obj.redirectUrl ?? DEFAULT_OAUTH_REDIRECT_URL;
   try {
-    const redirectUrl = new URL(obj.redirectUrl);
-    const isLoopback = redirectUrl.hostname === "localhost" || redirectUrl.hostname.startsWith("127.") || redirectUrl.hostname === "[::1]";
+    const redirectUrl = new URL(rawRedirectUrl);
+    const isLoopback = isLoopbackHostname(redirectUrl.hostname);
     if (redirectUrl.protocol !== "https:" && !(redirectUrl.protocol === "http:" && isLoopback)) {
       return { reason: "Invalid OAuth redirectUrl: must use HTTPS unless it is a loopback HTTP URL" };
     }
   } catch {
-    return { reason: `Invalid OAuth redirectUrl: "${obj.redirectUrl}"` };
+    return { reason: `Invalid OAuth redirectUrl: "${rawRedirectUrl}"` };
   }
   if (obj.scopes !== void 0 && (!Array.isArray(obj.scopes) || obj.scopes.some((scope) => typeof scope !== "string"))) {
     return { reason: 'Invalid OAuth config: "scopes" must be an array of strings' };
   }
   return {
     config: {
-      redirectUrl: obj.redirectUrl,
+      redirectUrl: rawRedirectUrl,
       clientName: typeof obj.clientName === "string" ? obj.clientName : void 0,
       scopes: obj.scopes,
       clientId: typeof obj.clientId === "string" ? obj.clientId : void 0,
@@ -193,6 +215,7 @@ function mergeConfigs(...configs) {
   return result;
 }
 export {
+  DEFAULT_OAUTH_REDIRECT_URL,
   classifyServerEntry,
   expandEnvVars,
   getClaudeSettingsPath,
@@ -200,6 +223,7 @@ export {
   getProjectMcpPath,
   getRootMcpPath,
   loadMcpConfig,
+  resolveOAuthRedirectUrl,
   validateConfig
 };
 //# sourceMappingURL=config.js.map