import { createHash } from "node:crypto"; import { HttpError, unprocessable } from "../errors.js"; import { mkdtemp, mkdir, symlink, writeFile, readFile, rm } from "node:fs/promises"; import os from "node:os"; import path from "node:path"; import { and, eq } from "drizzle-orm"; import { type Db, companySecrets, connectionGrants } from "@paperclipai/db"; import { AI_CONNECTION_CAPABILITIES, aiConnectionMetadataSchema, aiRoutingHarness, type AiConnectionBinding, } from "@paperclipai/shared"; import { managedProviderRouting } from "./ai-provider-routing.js"; import { aiConnectionService } from "./ai-connections.js"; import { secretService } from "./secrets.js"; import { decideCodexAuthMerge } from "@paperclipai/adapter-codex-local/server"; import type { AdapterExecutionTarget } from "@paperclipai/adapter-utils/execution-target"; import { runAdapterExecutionTargetProcess } from "@paperclipai/adapter-utils/execution-target"; import { decideGrokAuthMerge } from "@paperclipai/adapter-grok-local/server"; import { resolvePaperclipInstanceRootForAdapter } from "@paperclipai/adapter-utils/server-utils"; export function isAiConnectionBusy(error: unknown): error is HttpError { return error instanceof HttpError && error.status === 422 && (error.details as { code?: unknown } | undefined)?.code === "ai_connection_busy"; } // Blank values intentionally override inherited credentials in CLI child environments. export const AI_AUTH_ENV_KEYS = [ "PAPERCLIP_AI_PROVIDER_KEY", "PAPERCLIP_AI_PROVIDER_URL", "PAPERCLIP_CODEX_PROVIDERS", "GEMINI_API_KEY", "GOOGLE_API_KEY", "GOOGLE_GEMINI_BASE_URL", "GOOGLE_GENAI_USE_VERTEXAI", "HERMES_HOME", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_BEARER_TOKEN_BEDROCK", "AWS_PROFILE", "AWS_DEFAULT_PROFILE", "AWS_SHARED_CREDENTIALS_FILE", "AWS_CONFIG_FILE", "AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN", "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "AWS_CONTAINER_CREDENTIALS_FULL_URI", "ANTHROPIC_BEDROCK_BASE_URL", "ANTHROPIC_MODEL", "ANTHROPIC_DEFAULT_OPUS_MODEL", "ANTHROPIC_DEFAULT_SONNET_MODEL", "ANTHROPIC_DEFAULT_HAIKU_MODEL", "CLAUDE_CODE_SUBAGENT_MODEL", "ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN", "CLAUDE_CODE_OAUTH_TOKEN", "OPENAI_API_KEY", "CODEX_API_KEY", "OPENROUTER_API_KEY", "XAI_API_KEY", "GROK_API_KEY", "CODEX_HOME", "GROK_HOME", "CLAUDE_CONFIG_DIR", "OPENCODE_AUTH_JSON", "OPENCODE_CONFIG_CONTENT", "OPENCODE_CONFIG", "OPENCODE_CONFIG_DIR", "PAPERCLIP_OPENCODE_PROVIDERS", "ANTHROPIC_BASE_URL", "OPENAI_BASE_URL", "XAI_BASE_URL", "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY", ] as const; export function stripAiAuthBindings(env: unknown): Record { const result = { ...(env && typeof env === "object" ? (env as Record) : {}), }; for (const key of AI_AUTH_ENV_KEYS) if ( ![ "ANTHROPIC_BASE_URL", "OPENAI_BASE_URL", "XAI_BASE_URL", "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY", "PAPERCLIP_OPENCODE_PROVIDERS", ].includes(key) ) delete result[key]; return result; } export async function assertManagedAiProjectAuth( config: Record, provider: AiConnectionBinding["provider"], target?: AdapterExecutionTarget | null, ) { const extraArgs = [ ...(Array.isArray(config.extraArgs) ? config.extraArgs : []), ...(Array.isArray(config.args) ? config.args : []), ]; if ( extraArgs.some( (arg) => typeof arg === "string" && /^(--config|-c|--settings|--setting-sources|--api-key|--auth-token)(=|$)/.test( arg, ), ) ) { throw unprocessable( "Remove authentication/configuration overrides before selecting a managed AI connection", { code: "ai_connection_incompatible" }, ); } const files = provider === "anthropic" ? [".claude/settings.json", ".claude/settings.local.json"] : provider === "openai" ? [".codex/config.toml"] : []; const pattern = "apiKeyHelper|ANTHROPIC_API_KEY|ANTHROPIC_AUTH_TOKEN|CLAUDE_CODE_OAUTH_TOKEN|OPENAI_API_KEY|model_provider[[:space:]]*=|env_key[[:space:]]*=|experimental_bearer_token|cli_auth_credentials_store"; if (target?.kind === "remote" && files.length) { // Only inspect for conflicting keys; never return configuration or credential values. const result = await runAdapterExecutionTargetProcess( `ai-auth-check-${Date.now()}`, target, "sh", [ "-c", ` directory=$1; pattern=$2; shift 2 while :; do for relative in "$@"; do file="$directory/$relative" if test -f "$file"; then grep -Eq "$pattern" "$file" result=$? if test "$result" -eq 0; then exit 42; fi if test "$result" -ne 1; then exit 43; fi fi done parent=$(dirname "$directory") if test "$parent" = "$directory"; then break; fi directory=$parent done`, "ai-auth-check", target.remoteCwd, pattern, ...files, ], { cwd: target.remoteCwd, env: {}, timeoutSec: 15, graceSec: 1, onLog: async () => {}, }, ); if (result.exitCode !== 0) throw unprocessable( "The environment's project authentication settings must be checked before using this AI connection", { code: "ai_connection_incompatible" }, ); return; } let directory = typeof config.cwd === "string" ? path.resolve(config.cwd) : process.cwd(); for (;;) { for (const relative of files) { try { const content = await readFile(path.join(directory, relative), "utf8"); if ( /apiKeyHelper|ANTHROPIC_API_KEY|ANTHROPIC_AUTH_TOKEN|CLAUDE_CODE_OAUTH_TOKEN|OPENAI_API_KEY|model_provider\s*=|env_key\s*=|experimental_bearer_token|cli_auth_credentials_store/.test( content, ) ) { throw unprocessable( "Project authentication settings conflict with the selected AI connection", { code: "ai_connection_incompatible" }, ); } } catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; } } const parent = path.dirname(directory); if (parent === directory) break; directory = parent; } } function managedAiHomeEnvironment(home: string): Record { const providerHome = path.join(home, "provider"); return { HOME: home, XDG_CONFIG_HOME: path.join(home, "config"), XDG_DATA_HOME: path.join(home, "data"), CODEX_HOME: providerHome, GROK_HOME: providerHome, CLAUDE_CONFIG_DIR: providerHome, HERMES_HOME: providerHome, }; } /** Only the server-created credential home is volatile; retain all other config. */ export function managedAiSessionFingerprintConfig( config: Record, managedHome: string | undefined, ): Record { if (!managedHome) return config; const env = { ...(config.env as Record | undefined) }; const stable = managedAiHomeEnvironment(""); for (const [key, value] of Object.entries(managedAiHomeEnvironment(managedHome))) { if (env[key] === value) env[key] = stable[key]; } const managed = config.managedAiConnection as Record | undefined; if (managed?.sessionIdentity) { for (const key of ["ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN", "CLAUDE_CODE_OAUTH_TOKEN", "OPENAI_API_KEY", "CODEX_API_KEY", "OPENROUTER_API_KEY", "XAI_API_KEY", "GROK_API_KEY", "OPENCODE_AUTH_JSON", "OPENCODE_CONFIG_CONTENT"]) { if (env[key]) env[key] = ""; } } return { ...config, env, ...(managed?.sessionIdentity ? { managedAiConnection: { ...managed, identity: managed.sessionIdentity } } : {}) }; } export async function prepareManagedAiRuntime( db: Db, input: { companyId: string; agentId: string; responsibleUserId: string | null; adapterType: string; binding: AiConnectionBinding; allowUninstalledPersonal?: boolean; allowUninstalledShared?: boolean; allowLegacyValidation?: boolean; config: Record; }, ) { const configuredEnv = input.config.env && typeof input.config.env === "object" ? (input.config.env as Record) : {}; for (const key of [ "ANTHROPIC_BASE_URL", "OPENAI_BASE_URL", "XAI_BASE_URL", "CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX", "CLAUDE_CODE_USE_FOUNDRY", "PAPERCLIP_OPENCODE_PROVIDERS", "PAPERCLIP_AI_PROVIDER_URL", "PAPERCLIP_CODEX_PROVIDERS", "OPENCODE_CONFIG_CONTENT", "OPENCODE_CONFIG", "OPENCODE_CONFIG_DIR", "GOOGLE_GEMINI_BASE_URL", "ANTHROPIC_BEDROCK_BASE_URL", ]) { if (configuredEnv[key]) throw unprocessable( "The configured provider routing is incompatible with this AI connection", { code: "ai_connection_incompatible" }, ); } const harness = aiRoutingHarness(input.adapterType, input.config.provider, input.config.acpxAgent); await assertManagedAiProjectAuth(input.config, harness === "claude_local" ? "anthropic" : harness === "codex_local" ? "openai" : input.binding.provider); const service = aiConnectionService(db); let selection = await service.select({ ...input, userId: input.responsibleUserId, model: input.config.model, runnerProvider: input.config.provider, acpxAgent: input.config.acpxAgent, }); const subscriptionFile = selection.attribution.method === "subscription" && input.binding.provider !== "anthropic"; let home: string | undefined; try { const selectedGrantId = selection.grant.id; selection = await service.select({ ...input, userId: input.responsibleUserId, model: input.config.model, runnerProvider: input.config.provider, acpxAgent: input.config.acpxAgent, }); if (selection.grant.id !== selectedGrantId) throw unprocessable( "The selected default changed. Retry this execution.", ); const credentialRef = selection.grant.credentialSecretRefs.find((ref) => ref.configPath === "ai.credential"); if (!credentialRef) throw unprocessable("The selected AI credential is unavailable"); const readFreshness = async () => (await db.select({ epoch: companySecrets.aiSessionEpoch, version: companySecrets.latestVersion }) .from(companySecrets).where(and(eq(companySecrets.companyId, input.companyId), eq(companySecrets.id, credentialRef.secretId))).limit(1))[0]; const freshness = await readFreshness(); const value = await service.credential(selection); const afterRead = await readFreshness(); if (!freshness || freshness.version !== afterRead?.version || freshness.epoch !== afterRead.epoch) throw unprocessable("The AI credential changed during preparation; retry this execution"); home = await mkdtemp( path.join( os.tmpdir(), `paperclip-ai-${input.companyId}-${selection.grant.id}-`, ), ); const providerHome = path.join(home, "provider"); await mkdir(providerHome, { mode: 0o700 }); const env: Record = { ...stripAiAuthBindings(input.config.env), ...Object.fromEntries(AI_AUTH_ENV_KEYS.map((key) => [key, ""])), ...managedAiHomeEnvironment(home), }; const routing = aiConnectionMetadataSchema.parse(selection.connection.config.ai).routing; const capability = AI_CONNECTION_CAPABILITIES[input.binding.provider].methods[ selection.attribution.method ]!; const authFile = path.join(providerHome, "auth.json"); if (harness === "codex_local") await writeFile( path.join(providerHome, "config.toml"), 'cli_auth_credentials_store = "file"\n', { mode: 0o600 }, ); if (!routing && subscriptionFile) await writeFile(authFile, value, { mode: 0o600 }); else if (!routing) env[capability.envKey] = value; if ( !routing && input.binding.provider === "openai" && selection.attribution.method === "api_key" ) { env.CODEX_API_KEY = value; await writeFile(authFile, JSON.stringify({ OPENAI_API_KEY: value }), { mode: 0o600, }); } if (!routing && input.binding.provider === "openrouter") { env.OPENCODE_CONFIG_CONTENT = JSON.stringify({ provider: { openrouter: { options: { apiKey: value } } }, }); env.OPENCODE_DISABLE_PROJECT_CONFIG = "true"; } if (!routing && input.binding.provider === "google") { // Gemini headless CLI requires an explicit auth choice even with an API key. // Seed only the disposable connection home, never the operator's settings. const geminiHome = path.join(home, ".gemini"); await mkdir(geminiHome, { mode: 0o700 }); await writeFile(path.join(geminiHome, "settings.json"), JSON.stringify({ selectedAuthType: "gemini-api-key", security: { auth: { selectedType: "gemini-api-key" } }, }), { mode: 0o600 }); } const projected = routing ? managedProviderRouting(routing, harness, value, typeof input.config.model === "string" ? input.config.model : "") : undefined; if (projected) { Object.assign(env, projected.env); if (projected.hermesConfig) await writeFile(path.join(providerHome, "config.yaml"), projected.hermesConfig, { mode: 0o600 }); if (projected.codexConfig) await writeFile(path.join(providerHome, "config.toml"), 'cli_auth_credentials_store = "file"\n' + projected.codexConfig, { mode: 0o600 }); } const generation = createHash("sha256") .update(value) .digest("hex") .slice(0, 16); const identity = `${selection.grant.id}:${input.responsibleUserId ?? "shared"}:${generation}`; const sessionIdentity = `${selection.grant.id}:${input.responsibleUserId ?? "shared"}:${credentialRef.secretId}:${freshness.epoch}`; if (input.adapterType === "grok_local") { // Retain only transcripts across disposable credential homes. Scope them // to the company, agent and credential identity, including rotations. // Removing the runtime home removes the link, never its private target. const scope = createHash("sha256") .update(JSON.stringify([input.companyId, input.agentId, sessionIdentity])) .digest("hex"); const sessions = path.join(resolvePaperclipInstanceRootForAdapter(), "companies", input.companyId, "grok-sessions", scope); await mkdir(sessions, { recursive: true, mode: 0o700 }); await symlink(sessions, path.join(providerHome, "sessions"), "dir"); } return { sessionIdentity, config: { ...input.config, ...projected?.config, ...(routing ? { managedAiRouting: routing } : {}), env, managedAiConnection: { ...selection.attribution, identity, sessionIdentity }, }, attribution: selection.attribution, accountName: selection.connection.name, accountOwnerUserId: selection.grant.subjectUserId, identity, home, cleanup: async () => { try { if (subscriptionFile) { const refreshed = await readFile(authFile, "utf8"); if (refreshed !== value) await db.transaction(async (tx) => { const [grant] = await tx .select() .from(connectionGrants) .where( and( eq(connectionGrants.id, selection.grant.id), eq(connectionGrants.companyId, input.companyId), ), ) .for("update"); // A missing or revoked grant blocks the write-back. Among // active copies, the merge decision below keeps the // credential with the newest provider freshness field. if (!grant || grant.status !== "active") return; const ref = grant.credentialSecretRefs.find( (r) => r.configPath === "ai.credential", ); if (!ref) return; // Lock the referenced secret row for the rest of this // transaction. The grant-row lock above does not cover it, // so an authorized rotation of this secret could otherwise // land between the read and the write below and be // overwritten by this stale write-back. await tx .select({ id: companySecrets.id }) .from(companySecrets) .where( and( eq(companySecrets.id, ref.secretId), eq(companySecrets.companyId, input.companyId), ), ) .for("update"); const current = await aiConnectionService( tx as unknown as Db, ).credential({ ...selection, grant }); const destination = path.join( providerHome, "current-auth.json", ); await writeFile(destination, current, { mode: 0o600 }); const decision = input.binding.provider === "openai" ? await decideCodexAuthMerge(authFile, destination, { errorLabel: "AI account refresh", }) : await decideGrokAuthMerge(authFile, destination, { errorLabel: "AI account refresh", }); if (decision !== 10) return; await secretService(tx).rotate( ref.secretId, { value: refreshed, preserveAiSessionEpoch: true }, { userId: grant.subjectUserId }, ); await tx .update(connectionGrants) .set({ updatedAt: new Date() }) .where(eq(connectionGrants.id, grant.id)); }); } } finally { if (home) await rm(home, { recursive: true, force: true }); } }, }; } catch (error) { if (home) await rm(home, { recursive: true, force: true }); throw error; } }