Function buildSdkOptions

packages/agent-runtime/src/runtime.ts:298–350

(config: AgentConfig, params: {
  sessionId?: string
  requestOptions?: AgentRequestOptions
})

// --- SDK options ---

function buildSdkOptions(config: AgentConfig, params: {
  sessionId?: string
  requestOptions?: AgentRequestOptions
}): Options {
  const hooks = buildHooks(config)
  const opts = params.requestOptions
  const useMoat = isMoatEnabled()
  const cleanEnv = getCleanEnv(opts)

  // Shallow merge: request options override bundle config per-field
  const effectiveModel = opts?.model ?? config.model
  const effectiveSystemPrompt = opts?.systemPrompt ?? config.systemPrompt
  const effectiveMaxTurns = opts?.maxTurns ?? config.maxTurns
  const effectiveMaxBudgetUsd = opts?.maxBudgetUsd ?? config.maxBudgetUsd

  let directMcpServers: ReturnType<typeof buildClaudeMcpServers> | undefined
  if (!useMoat) {
    directMcpServers = buildClaudeMcpServers({
      host: "127.0.0.1",
      env: cleanEnv,
    })
    writeDirectClaudeConfig(directMcpServers)
    cleanEnv.HOME = DIRECT_CLAUDE_HOME
  }

  return {
    executable: "node",
    cwd: useMoat ? MOAT_WORKDIR : DIRECT_CLAUDE_WORKDIR,
    ...(useMoat ? { pathToClaudeCodeExecutable: "claude" } : {}),
    model: effectiveModel,
    systemPrompt: effectiveSystemPrompt,
    // Load filesystem-backed settings so Skills can be discovered from
    // ~/.claude/skills and .claude/skills relative to cwd.
    settingSources: ["user", "project"],
    permissionMode: "bypassPermissions",
    maxTurns: effectiveMaxTurns,
    ...(effectiveMaxBudgetUsd && { maxBudgetUsd: effectiveMaxBudgetUsd }),
    ...(opts?.disallowedTools && opts.disallowedTools.length > 0 && { disallowedTools: opts.disallowedTools }),
    ...(directMcpServers ? { mcpServers: directMcpServers } : {}),
    hooks,
    ...(params.sessionId && { resume: params.sessionId, continue: true }),
    includePartialMessages: true,
    env: cleanEnv,
    ...(useMoat
      ? {
          spawnClaudeCodeProcess: (options: SpawnOptions): SpawnedProcess =>
            spawnMoatProcess(options),
        }
      : {}),
    allowDangerouslySkipPermissions: true,
    sandbox: { enabled: true, autoAllowBashIfSandboxed: true },
  }
}

function writeDirectClaudeConfig(mcpServers: ReturnType<typeof buildClaudeMcpServers>) {
  let config: Record<string, unknown> = {}