Function createSession

src/services/acp/agent/createSessionMethod.ts:62–302

(
  this: AcpAgent,
  params: NewSessionRequest,
  opts: {
    forceNewId?: boolean
    sessionId?: string
    initialMessages?: Message[]
  } = {},
)

// ── createSession ────────────────────────────────────────────────

async function createSession(
  this: AcpAgent,
  params: NewSessionRequest,
  opts: {
    forceNewId?: boolean
    sessionId?: string
    initialMessages?: Message[]
  } = {},
): Promise<NewSessionResponse> {
  enableConfigs()

  const sessionId = opts.sessionId ?? randomUUID()
  const cwd = params.cwd

  // Align the global session state so that transcript persistence,
  // analytics, and cost tracking use the ACP session ID.
  // Preserve the projectDir set by getOrCreateSession so that
  // getSessionProjectDir() continues to resolve correctly.
  const currentProjectDir = getSessionProjectDir()
  switchSession(sessionId as SessionId, currentProjectDir)

  // Set CWD for the session
  setOriginalCwd(cwd)
  const previousProcessCwd = process.cwd()
  let processCwdChanged = false
  try {
    process.chdir(cwd)
    processCwdChanged = true
  } catch {
    // CWD may not exist yet; best-effort
  }

  // entry.ts calls applySafeConfigEnvironmentVariables() during handshake so the
  // API client can authenticate before createSession arrives. At that point
  // getOriginalCwd() is still the spawn cwd (not the project dir), so
  // loadSettingsFromDisk() resolves localSettings/projectSettings against the
  // wrong root and caches the empty result. Now that we've set the real project
  // cwd, drop the cache and re-apply so settings.local.json and project env
  // become visible to readSettingsPermissionMode() and downstream consumers.
  resetSettingsCache()
  applySafeConfigEnvironmentVariables()

  try {
    // Build tools with a permissive permission context.
    const permissionContext = getEmptyToolPermissionContext()
    const tools: Tools = getTools(permissionContext)

    // Parse permission mode from _meta (passed by RCS/acp-link) or settings.
    const meta = params._meta as Record<string, unknown> | null | undefined
    const hasMetaPermissionMode = hasOwnField(meta, 'permissionMode')
    const metaPermissionMode = hasMetaPermissionMode
      ? meta?.permissionMode
      : undefined
    const settingsPermissionMode = readSettingsPermissionMode()
    const permissionMode = resolveSessionPermissionMode(
      metaPermissionMode,
      hasMetaPermissionMode,
      settingsPermissionMode,