import * as p from "@clack/prompts"; import pc from "picocolors"; import { configExists, readConfig, resolveConfigPath, writeConfig } from "../config/store.js"; import type { PaperclipConfig } from "../config/schema.js"; import { ensureAgentJwtSecret, resolveAgentJwtEnvFile } from "../config/env.js"; import { ensureLocalSecretsKeyFile } from "../config/secrets-key.js"; import { promptDatabase } from "../prompts/database.js"; import { promptLlm } from "../prompts/llm.js"; import { promptLogging } from "../prompts/logging.js"; import { defaultSecretsConfig } from "../prompts/secrets.js"; import { defaultStorageConfig, promptStorage } from "../prompts/storage.js"; import { promptServer } from "../prompts/server.js"; import { describeLocalInstancePaths, resolveDefaultEmbeddedPostgresDir, resolveDefaultLogsDir, resolvePaperclipInstanceId, } from "../config/home.js"; import { bootstrapCeoInvite } from "./auth-bootstrap-ceo.js"; import { printPaperclipCliBanner } from "../utils/banner.js"; type SetupMode = "quickstart" | "advanced"; type OnboardOptions = { config?: string; run?: boolean; invokedByRun?: boolean; }; function quickstartDefaults(): Pick { const instanceId = resolvePaperclipInstanceId(); return { database: { mode: "embedded-postgres", embeddedPostgresDataDir: resolveDefaultEmbeddedPostgresDir(instanceId), embeddedPostgresPort: 54329, }, logging: { mode: "file", logDir: resolveDefaultLogsDir(instanceId), }, server: { deploymentMode: "local_trusted", exposure: "private", host: "127.0.0.1", port: 3100, allowedHostnames: [], serveUi: true, }, auth: { baseUrlMode: "auto", }, storage: defaultStorageConfig(), secrets: defaultSecretsConfig(), }; } export async function onboard(opts: OnboardOptions): Promise { printPaperclipCliBanner(); p.intro(pc.bgCyan(pc.black(" paperclipai onboard "))); const configPath = resolveConfigPath(opts.config); const instance = describeLocalInstancePaths(resolvePaperclipInstanceId()); p.log.message( pc.dim( `Local home: ${instance.homeDir} | instance: ${instance.instanceId} | config: ${configPath}`, ), ); if (configExists(opts.config)) { p.log.message(pc.dim(`${configPath} exists, updating config`)); try { readConfig(opts.config); } catch (err) { p.log.message( pc.yellow( `Existing config appears invalid and will be updated.\n${err instanceof Error ? err.message : String(err)}`, ), ); } } const setupModeChoice = await p.select({ message: "Choose setup path", options: [ { value: "quickstart" as const, label: "Quickstart", hint: "Recommended: local defaults + ready to run", }, { value: "advanced" as const, label: "Advanced setup", hint: "Customize database, server, storage, and more", }, ], initialValue: "quickstart", }); if (p.isCancel(setupModeChoice)) { p.cancel("Setup cancelled."); return; } const setupMode = setupModeChoice as SetupMode; let llm: PaperclipConfig["llm"] | undefined; let { database, logging, server, auth, storage, secrets, } = quickstartDefaults(); if (setupMode === "advanced") { p.log.step(pc.bold("Database")); database = await promptDatabase(); if (database.mode === "postgres" && database.connectionString) { const s = p.spinner(); s.start("Testing database connection..."); try { const { createDb } = await import("@paperclipai/db"); const db = createDb(database.connectionString); await db.execute("SELECT 1"); s.stop("Database connection successful"); } catch { s.stop(pc.yellow("Could not connect to database — you can fix this later with `paperclipai doctor`")); } } p.log.step(pc.bold("LLM Provider")); llm = await promptLlm(); if (llm?.apiKey) { const s = p.spinner(); s.start("Validating API key..."); try { if (llm.provider === "claude") { const res = await fetch("https://api.anthropic.com/v1/messages", { method: "POST", headers: { "x-api-key": llm.apiKey, "anthropic-version": "2023-06-01", "content-type": "application/json", }, body: JSON.stringify({ model: "claude-sonnet-4-5-20250929", max_tokens: 1, messages: [{ role: "user", content: "hi" }], }), }); if (res.ok || res.status === 400) { s.stop("API key is valid"); } else if (res.status === 401) { s.stop(pc.yellow("API key appears invalid — you can update it later")); } else { s.stop(pc.yellow("Could not validate API key — continuing anyway")); } } else { const res = await fetch("https://api.openai.com/v1/models", { headers: { Authorization: `Bearer ${llm.apiKey}` }, }); if (res.ok) { s.stop("API key is valid"); } else if (res.status === 401) { s.stop(pc.yellow("API key appears invalid — you can update it later")); } else { s.stop(pc.yellow("Could not validate API key — continuing anyway")); } } } catch { s.stop(pc.yellow("Could not reach API — continuing anyway")); } } p.log.step(pc.bold("Logging")); logging = await promptLogging(); p.log.step(pc.bold("Server")); ({ server, auth } = await promptServer()); p.log.step(pc.bold("Storage")); storage = await promptStorage(defaultStorageConfig()); p.log.step(pc.bold("Secrets")); secrets = defaultSecretsConfig(); p.log.message( pc.dim( `Using defaults: provider=${secrets.provider}, strictMode=${secrets.strictMode}, keyFile=${secrets.localEncrypted.keyFilePath}`, ), ); } else { p.log.step(pc.bold("Quickstart")); p.log.message( pc.dim("Using local defaults: embedded database, no LLM provider, file storage, and local encrypted secrets."), ); } const jwtSecret = ensureAgentJwtSecret(configPath); const envFilePath = resolveAgentJwtEnvFile(configPath); if (jwtSecret.created) { p.log.success(`Created ${pc.cyan("PAPERCLIP_AGENT_JWT_SECRET")} in ${pc.dim(envFilePath)}`); } else if (process.env.PAPERCLIP_AGENT_JWT_SECRET?.trim()) { p.log.info(`Using existing ${pc.cyan("PAPERCLIP_AGENT_JWT_SECRET")} from environment`); } else { p.log.info(`Using existing ${pc.cyan("PAPERCLIP_AGENT_JWT_SECRET")} in ${pc.dim(envFilePath)}`); } const config: PaperclipConfig = { $meta: { version: 1, updatedAt: new Date().toISOString(), source: "onboard", }, ...(llm && { llm }), database, logging, server, auth, storage, secrets, }; const keyResult = ensureLocalSecretsKeyFile(config, configPath); if (keyResult.status === "created") { p.log.success(`Created local secrets key file at ${pc.dim(keyResult.path)}`); } else if (keyResult.status === "existing") { p.log.message(pc.dim(`Using existing local secrets key file at ${keyResult.path}`)); } writeConfig(config, opts.config); p.note( [ `Database: ${database.mode}`, llm ? `LLM: ${llm.provider}` : "LLM: not configured", `Logging: ${logging.mode} -> ${logging.logDir}`, `Server: ${server.deploymentMode}/${server.exposure} @ ${server.host}:${server.port}`, `Allowed hosts: ${server.allowedHostnames.length > 0 ? server.allowedHostnames.join(", ") : "(loopback only)"}`, `Auth URL mode: ${auth.baseUrlMode}${auth.publicBaseUrl ? ` (${auth.publicBaseUrl})` : ""}`, `Storage: ${storage.provider}`, `Secrets: ${secrets.provider} (strict mode ${secrets.strictMode ? "on" : "off"})`, "Agent auth: PAPERCLIP_AGENT_JWT_SECRET configured", ].join("\n"), "Configuration saved", ); p.note( [ `Run: ${pc.cyan("paperclipai run")}`, `Reconfigure later: ${pc.cyan("paperclipai configure")}`, `Diagnose setup: ${pc.cyan("paperclipai doctor")}`, ].join("\n"), "Next commands", ); if (server.deploymentMode === "authenticated") { p.log.step("Generating bootstrap CEO invite"); await bootstrapCeoInvite({ config: configPath }); } let shouldRunNow = opts.run === true; if (!shouldRunNow && !opts.invokedByRun && process.stdin.isTTY && process.stdout.isTTY) { const answer = await p.confirm({ message: "Start Paperclip now?", initialValue: true, }); if (!p.isCancel(answer)) { shouldRunNow = answer; } } if (shouldRunNow && !opts.invokedByRun) { const { runCommand } = await import("./run.js"); await runCommand({ config: configPath, repair: true, yes: true }); return; } p.outro("You're all set!"); }