sim-setup 1.0.1 → 1.0.2-preview.34.1

package/README.md

@@ -9,3 +9,9 @@ npx sim-setup
 Outside a Sim source checkout, the command creates a Docker Compose installation using published
 images. Inside a Sim source checkout, use `bun run sim-setup` to expose the complete development
 and deployment wizard.
+
+To connect or replace the Chat API key without rerunning the full wizard:
+
+```bash
+npx sim-setup add chat
+```

package/dist/index.js

@@ -1521,9 +1521,12 @@ var init_env_capabilities = __esm(() => {
     ...new Set([
       ...CORE_CONFIGURATION_KEYS,
       ...ENV_CAPABILITIES.flatMap(capabilityKeys),
+      "COPILOT_API_KEY",
       "EMAIL_VERIFICATION_ENABLED",
+      "NEXT_PUBLIC_CHAT_DISABLED",
       "NEXT_PUBLIC_E2B_ENABLED",
       "NEXT_PUBLIC_SANDBOXES_ENABLED",
+      "SIM_AGENT_API_URL",
       ...Object.values(LLM_KEY_POOLS).flatMap((pool) => [
         ...pool.keys,
         ..."fallbackKey" in pool ? [pool.fallbackKey] : []
@@ -27897,6 +27900,7 @@ var init_capability_config = __esm(() => {
       id: setup.definition.id,
       label: setup.label
     })),
+    { id: "chat", label: "Chat" },
     { id: "llm", label: "LLM API keys" },
     { id: "integration", label: "OAuth integration" }
   ];
@@ -32992,7 +32996,7 @@ var init_setup_status = __esm(() => {
   init_theme();
   SECRET_KEYS2 = new Set(["BETTER_AUTH_SECRET", "ENCRYPTION_KEY", "INTERNAL_API_SECRET"]);
   URL_KEYS2 = new Set(["DATABASE_URL", "BETTER_AUTH_URL", "NEXT_PUBLIC_APP_URL"]);
-  FEATURE_ORDER = SETUP_FEATURES.flatMap((feature) => feature.id === "integration" ? [] : [feature.id]);
+  FEATURE_ORDER = SETUP_FEATURES.flatMap((feature) => feature.id === "chat" || feature.id === "integration" ? [] : [feature.id]);
 });
 
 // ../../node_modules/fast-string-truncated-width/dist/utils.js
@@ -35251,418 +35255,10 @@ var init_capability_setup = __esm(() => {
   init_prompter();
 });
 
-// src/feature-setup.ts
-var exports_feature_setup = {};
-__export(exports_feature_setup, {
-  setupFeatureUsage: () => setupFeatureUsage,
-  runFeatureSetup: () => runFeatureSetup,
-  resolveFeatureSetupDestination: () => resolveFeatureSetupDestination,
-  reconcileLlmSetup: () => reconcileLlmSetup
-});
-function isSetupFeatureId(value) {
-  return SETUP_FEATURES.some((feature) => feature.id === value);
-}
-async function setupIntegration(requestedId, vars) {
-  if (!requestedId) {
-    throw new Error("Missing integration id. Example: npx sim-setup add integration slack");
-  }
-  const providerId = resolveOAuthClientCapabilityId(requestedId);
-  if (!providerId) {
-    throw new Error(`Unknown OAuth integration "${requestedId}". Expected one of: ${Object.keys(OAUTH_CLIENT_CAPABILITIES).join(", ")}`);
-  }
-  const fields = getOAuthClientSetupFields(providerId);
-  const values2 = {};
-  for (const field of fields) {
-    const existing = vars.get(field.key);
-    if (field.input === "secret") {
-      const value = await password2({
-        message: existing ? `${field.key} (Currently used); leave empty to keep it` : field.key,
-        validate: (candidate) => candidate || existing ? undefined : "required"
-      });
-      const resolved = value || existing;
-      if (!resolved)
-        throw new Error(`${field.key} was not provided`);
-      values2[field.key] = resolved;
-    } else {
-      values2[field.key] = await text2({
-        message: `${field.key}${existing ? " (Currently used)" : ""}`,
-        initialValue: existing,
-        validate: (candidate) => candidate ? undefined : "required"
-      });
-    }
-  }
-  log2.info(`Configured the ${providerId} OAuth client.`);
-  return values2;
-}
-function reconcileLlmSetup(providerId, values2) {
-  const pool = LLM_KEY_POOLS[providerId];
-  const fields = [...pool.keys, ..."fallbackKey" in pool ? [pool.fallbackKey] : []];
-  return {
-    values: values2,
-    remove: fields.filter((key) => !Object.hasOwn(values2, key))
-  };
-}
-async function setupLlm(vars) {
-  const currentProvider = Object.entries(LLM_KEY_POOLS).find(([, pool2]) => [...pool2.keys, ..."fallbackKey" in pool2 ? [pool2.fallbackKey] : []].some((key) => vars.has(key)))?.[0];
-  const provider = await select3({
-    message: "LLM key pool?",
-    options: Object.keys(LLM_KEY_POOLS).map((id) => ({
-      value: id,
-      label: id,
-      hint: id === currentProvider ? "Currently used" : undefined
-    })),
-    initialValue: currentProvider
-  });
-  const pool = LLM_KEY_POOLS[provider];
-  const keys = pool.keys;
-  const values2 = {};
-  for (const [index, key] of keys.entries()) {
-    const legacyKey = index === 0 && "fallbackKey" in pool ? pool.fallbackKey : undefined;
-    const existingKey = vars.has(key) ? key : legacyKey;
-    const existing = existingKey ? vars.get(existingKey) : undefined;
-    const value = await password2({
-      message: existing ? `${key} (${existingKey} is currently used); leave empty to keep it` : `${key}${index === 0 ? "" : " (empty to finish)"}`,
-      validate: index === 0 ? (candidate) => candidate || existing ? undefined : "required" : undefined
-    });
-    const resolved = value || existing;
-    if (!resolved)
-      break;
-    values2[key] = resolved;
-  }
-  return reconcileLlmSetup(provider, values2);
-}
-function setupFeatureUsage() {
-  return SETUP_FEATURES.map((feature) => feature.id === "integration" ? "integration <slug>" : feature.id).join(" | ");
-}
-function resolveFeatureSetupDestination(sources) {
-  if (sources.length === 0) {
-    throw new Error("No Sim configuration was detected. Run npx sim-setup first.");
-  }
-  const managed = sources.filter((source2) => source2.managedByCurrentCheckout);
-  if (managed.length === 0) {
-    throw new Error("No effective configuration is safely writable by this checkout. Process overrides, higher-precedence development env files, external Compose projects, and Helm releases must be updated at their source. Run npx sim-setup config for the detected sources.");
-  }
-  if (managed.length > 1) {
-    throw new Error(`More than one effective configuration is writable by this checkout (${managed.map((source2) => source2.label).join(", ")}). Run npx sim-setup config and remove the ambiguity before configuring a feature.`);
-  }
-  const source = managed[0];
-  if (!source.values) {
-    throw new Error(`${source.label} is managed by this checkout, but its effective environment could not be resolved. Run npx sim-setup config and fix the reported source error first.`);
-  }
-  if (source.kind === "helm") {
-    throw new Error("Helm configuration cannot be updated by npx sim-setup add. Update the release Secret or values and upgrade the release.");
-  }
-  return {
-    source,
-    target: source.kind === "compose" ? "root" : "sim",
-    vars: source.values,
-    containerized: source.kind === "compose"
-  };
-}
-async function runFeatureSetup(feature, args) {
-  if (!isSetupFeatureId(feature)) {
-    throw new Error(`Unknown setup feature "${feature}". Expected: ${setupFeatureUsage()}`);
-  }
-  const destination = resolveFeatureSetupDestination(discoverConfigurationSources());
-  const { target, vars } = destination;
-  let values2;
-  let remove;
-  const capabilitySetup = getCapabilitySetup(feature);
-  if (capabilitySetup) {
-    const result = await promptCapabilitySetup(capabilitySetup, vars, {
-      containerized: destination.containerized
-    });
-    values2 = result.values;
-    remove = result.remove;
-  } else if (feature === "integration") {
-    values2 = await setupIntegration(args[0], vars);
-    remove = [];
-  } else if (feature === "llm") {
-    const result = await setupLlm(vars);
-    values2 = result.values;
-    remove = result.remove;
-  } else {
-    throw new Error(`Setup feature ${feature} has no handler`);
-  }
-  reconcileEnvValues(target, remove, values2);
-  const label = SETUP_FEATURES.find((item) => item.id === feature)?.label;
-  outro2(theme.accent(destination.containerized ? `${label} written to .env. Recreate the app container for it to take effect.` : `${label} configured.`));
-}
-var init_feature_setup = __esm(() => {
-  init_env_capabilities();
-  init_capability_config();
-  init_capability_setup();
-  init_configuration_sources();
-  init_env_files();
-  init_prompter();
-  init_theme();
-});
-
-// src/doctor.ts
-var exports_doctor = {};
-__export(exports_doctor, {
-  runDoctor: () => runDoctor
-});
-function render(findings, fixedCount) {
-  console.log(`
-${theme.heading("◆ Sim doctor")}
-`);
-  for (const group of GROUP_ORDER) {
-    const groupFindings = findings.filter((f2) => f2.group === group);
-    if (groupFindings.length === 0)
-      continue;
-    console.log(theme.heading(GROUP_TITLES[group]));
-    for (const finding of groupFindings) {
-      console.log(` ${glyph[finding.status]} ${finding.message}`);
-      if (finding.fix && finding.status !== "pass") {
-        console.log(`   ${theme.muted(`fix: ${finding.fix}`)}`);
-      }
-    }
-    console.log();
-  }
-  const counts = {
-    pass: findings.filter((f2) => f2.status === "pass").length,
-    warn: findings.filter((f2) => f2.status === "warn").length,
-    fail: findings.filter((f2) => f2.status === "fail").length
-  };
-  const summary = [`${counts.pass} passed`];
-  if (counts.warn)
-    summary.push(theme.warn(`${counts.warn} warning${counts.warn > 1 ? "s" : ""}`));
-  if (counts.fail)
-    summary.push(theme.error(`${counts.fail} failed`));
-  if (fixedCount)
-    summary.push(theme.success(`${fixedCount} fixed`));
-  console.log(summary.join(theme.muted(" · ")));
-}
-async function runDoctor(options) {
-  let findings = await runChecks(loadCheckContext(true));
-  let fixedCount = 0;
-  if (options.fix) {
-    const fixable = findings.filter((f2) => (f2.status === "fail" || f2.status === "warn") && f2.autofix);
-    for (const finding of fixable) {
-      finding.autofix?.();
-      fixedCount++;
-    }
-    if (fixedCount > 0)
-      findings = await runChecks(loadCheckContext(true));
-  }
-  if (options.json) {
-    console.log(JSON.stringify(findings.map(({ autofix: _autofix, ...rest }) => rest), null, 2));
-  } else {
-    render(findings, fixedCount);
-  }
-  return findings.some((f2) => f2.status === "fail") ? 1 : 0;
-}
-var GROUP_TITLES, GROUP_ORDER;
-var init_doctor = __esm(() => {
-  init_checks();
-  init_theme();
-  GROUP_TITLES = {
-    files: "Env files",
-    schema: "Schema",
-    consistency: "Consistency",
-    coherence: "Coherence",
-    live: "Live"
-  };
-  GROUP_ORDER = ["files", "schema", "consistency", "coherence", "live"];
-});
-
-// src/compose-asset.ts
-import { createHash } from "node:crypto";
-import { copyFileSync, existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "node:fs";
-import path6 from "node:path";
-import { fileURLToPath } from "node:url";
-function sha2562(contents) {
-  return createHash("sha256").update(contents).digest("hex");
-}
-function readManagedState(root) {
-  const file = path6.join(root, MANAGED_STATE_FILE);
-  if (!existsSync6(file))
-    return null;
-  const parsed = JSON.parse(readFileSync6(file, "utf8"));
-  if (typeof parsed !== "object" || parsed === null || !("schemaVersion" in parsed) || parsed.schemaVersion !== 1 || !("composeSha256" in parsed) || typeof parsed.composeSha256 !== "string") {
-    throw new Error(`${file} is not a valid sim-setup managed-state file`);
-  }
-  return { schemaVersion: 1, composeSha256: parsed.composeSha256 };
-}
-function writeManagedState(root, contents) {
-  const state = { schemaVersion: 1, composeSha256: sha2562(contents) };
-  writeFileSync2(path6.join(root, MANAGED_STATE_FILE), `${JSON.stringify(state, null, 2)}
-`);
-}
-function packagedComposeFile() {
-  const moduleDirectory = path6.dirname(fileURLToPath(import.meta.url));
-  return path6.basename(moduleDirectory) === "src" ? path6.resolve(moduleDirectory, "../../..", COMPOSE_FILE2) : path6.join(moduleDirectory, COMPOSE_FILE2);
-}
-function ensureProductionComposeFile(context = SETUP_CONTEXT) {
-  const destination = path6.join(context.root, COMPOSE_FILE2);
-  if (context.kind === "source") {
-    if (!existsSync6(destination)) {
-      throw new Error(`Sim source checkout is missing ${COMPOSE_FILE2}`);
-    }
-    return destination;
-  }
-  const bundled = packagedComposeFile();
-  if (!existsSync6(bundled)) {
-    throw new Error(`The sim-setup package is missing its bundled ${COMPOSE_FILE2}`);
-  }
-  mkdirSync2(context.root, { recursive: true });
-  const packaged = readFileSync6(bundled, "utf8");
-  if (existsSync6(destination)) {
-    const current = readFileSync6(destination, "utf8");
-    if (current === packaged) {
-      writeManagedState(context.root, packaged);
-      return destination;
-    }
-    if (!current.includes(SIM_COMPOSE_MARKER2)) {
-      throw new Error(`${destination} exists but is not a recognized Sim Compose file`);
-    }
-    const managed = readManagedState(context.root);
-    if (!managed || managed.composeSha256 !== sha2562(current)) {
-      throw new Error(`${destination} has local changes; preserve or remove your customizations before updating it.`);
-    }
-  }
-  copyFileSync(bundled, destination);
-  writeManagedState(context.root, packaged);
-  return destination;
-}
-var COMPOSE_FILE2 = "docker-compose.prod.yml", SIM_COMPOSE_MARKER2 = "ghcr.io/simstudioai/simstudio", MANAGED_STATE_FILE = ".sim-setup.json";
-var init_compose_asset = __esm(() => {
-  init_context();
-});
-
-// src/compose-project.ts
-import { createHash as createHash2 } from "node:crypto";
-import path7 from "node:path";
-function standaloneComposeProjectName(root) {
-  const digest = createHash2("sha256").update(path7.resolve(root)).digest("hex").slice(0, 12);
-  return `sim-${digest}`;
-}
-function legacyComposeProjectName(root) {
-  const name = path7.basename(path7.resolve(root)).toLowerCase().replace(/[^a-z0-9_-]/g, "");
-  if (!/^[a-z0-9]/.test(name)) {
-    throw new Error(`Cannot derive the existing Compose project name from ${root}; set COMPOSE_PROJECT_NAME in its .env file.`);
-  }
-  return name;
-}
-var init_compose_project = () => {};
-
-// src/docker.ts
-import { spawnSync as spawnSync4 } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-function daemonUp() {
-  return spawnSync4("docker", ["info"], { stdio: "ignore" }).status === 0;
-}
-function installed() {
-  return executableExists("docker");
-}
-function orbstackSelected() {
-  const host = process.env.DOCKER_HOST;
-  if (host)
-    return host.includes(".orbstack/");
-  const result = spawnSync4("docker", ["context", "show"], { encoding: "utf8" });
-  return result.status === 0 && result.stdout.trim() === "orbstack";
-}
-function appInstalled(app) {
-  return APP_DIRS.some((dir) => existsSync7(join(dir, app.bundle)));
-}
-function macDockerApp() {
-  if (orbstackSelected())
-    return { app: ORBSTACK_APP, explicit: true };
-  const orbstackOnly = appInstalled(ORBSTACK_APP) && !appInstalled(DOCKER_DESKTOP_APP);
-  return { app: orbstackOnly ? ORBSTACK_APP : DOCKER_DESKTOP_APP, explicit: false };
-}
-function openApp(app) {
-  return spawnSync4("open", ["-a", app.name], { stdio: "ignore" }).status === 0;
-}
-function startDockerApp({ app, explicit }) {
-  if (openApp(app))
-    return app;
-  if (explicit)
-    return null;
-  const other = app === ORBSTACK_APP ? DOCKER_DESKTOP_APP : ORBSTACK_APP;
-  return openApp(other) ? other : null;
-}
-function launchFailed(required, message, hints) {
-  if (required)
-    throw new SetupError(message, hints);
-  log2.warn([message, ...hints].join(`
-`));
-  return false;
-}
-async function ensureDocker(required) {
-  if (daemonUp())
-    return true;
-  if (!installed()) {
-    if (required)
-      throw new SetupError("Docker is not installed.", INSTALL_HINTS);
-    return false;
-  }
-  if (process.platform !== "darwin") {
-    if (required) {
-      throw new SetupError("Docker is installed but the daemon is not running.", [
-        `start it: ${theme.command("sudo systemctl start docker")} (Linux)`
-      ]);
-    }
-    return false;
-  }
-  const choice = macDockerApp();
-  const launch = await confirm2({
-    message: `Docker is installed but not running — start ${choice.app.name} now?`,
-    initialValue: true
-  });
-  if (!launch) {
-    if (required) {
-      throw new SetupError("Docker is required for this mode.", [
-        `start ${choice.app.name}, then re-run the wizard`
-      ]);
-    }
-    return false;
-  }
-  const app = startDockerApp(choice);
-  if (!app) {
-    return choice.explicit ? launchFailed(required, "The docker CLI is pointed at OrbStack, which is not installed.", [
-      `reinstall it: ${theme.command("brew install orbstack")}`,
-      `or point the CLI elsewhere: unset DOCKER_HOST and DOCKER_CONTEXT, then ${theme.command("docker context use <name>")}`
-    ]) : launchFailed(required, "Found the docker CLI, but no app to start.", NO_APP_HINTS);
-  }
-  const spin = spinner2();
-  spin.start(`Waiting for the Docker daemon (${app.name})…`);
-  const up = await waitFor(async () => daemonUp(), 90000, 2000);
-  spin.stop(up ? "Docker is running" : `${glyph.fail} daemon did not come up`);
-  if (!up) {
-    return launchFailed(required, `${app.name} did not start within 90s.`, [
-      app === ORBSTACK_APP ? "open OrbStack manually once to finish its first-run setup, then re-run" : "first-ever launch needs a GUI license acceptance — open Docker Desktop manually once, then re-run"
-    ]);
-  }
-  return true;
-}
-var INSTALL_HINTS, NO_APP_HINTS, ORBSTACK_APP, DOCKER_DESKTOP_APP, APP_DIRS;
-var init_docker = __esm(() => {
-  init_errors();
-  init_executables();
-  init_probes();
-  init_prompter();
-  init_theme();
-  INSTALL_HINTS = [
-    "install Docker Desktop: https://docker.com/products/docker-desktop",
-    `or OrbStack (lighter on macOS): ${theme.command("brew install orbstack")}`
-  ];
-  NO_APP_HINTS = [
-    ...INSTALL_HINTS,
-    `or start your existing runtime its own way, e.g. ${theme.command("colima start")}`
-  ];
-  ORBSTACK_APP = { name: "OrbStack", bundle: "OrbStack.app" };
-  DOCKER_DESKTOP_APP = { name: "Docker", bundle: "Docker.app" };
-  APP_DIRS = ["/Applications", join(homedir(), "Applications")];
-});
-
 // ../security/src/hash.ts
-import { createHash as createHash3 } from "node:crypto";
+import { createHash } from "node:crypto";
 function sha256Base64Url(input) {
-  const hash = createHash3("sha256");
+  const hash = createHash("sha256");
   if (typeof input === "string") {
     hash.update(input, "utf8");
   } else {
@@ -35716,19 +35312,19 @@ var init_string = __esm(() => {
 });
 
 // src/cli-auth.ts
-import { spawnSync as spawnSync5 } from "node:child_process";
+import { spawnSync as spawnSync4 } from "node:child_process";
 function openBrowser(url) {
   if (process.env.SIM_SETUP_NO_BROWSER)
     return;
   if (process.platform === "win32") {
-    spawnSync5("cmd", ["/c", "start", '""', `"${url}"`], {
+    spawnSync4("cmd", ["/c", "start", '""', `"${url}"`], {
       stdio: "ignore",
       windowsVerbatimArguments: true
     });
     return;
   }
   const command = process.platform === "darwin" ? "open" : "xdg-open";
-  spawnSync5(command, [url], { stdio: "ignore" });
+  spawnSync4(command, [url], { stdio: "ignore" });
 }
 function createPairingCode() {
   const chars = generateShortId(8, PAIRING_ALPHABET);
@@ -35751,8 +35347,8 @@ function normalizeAuthOrigin(origin) {
   const prefix = parsed.pathname.replace(/\/+$/, "");
   return `${parsed.origin}${prefix}`;
 }
-function authUrl(origin, path8) {
-  return `${normalizeAuthOrigin(origin)}${path8}`;
+function authUrl(origin, path6) {
+  return `${normalizeAuthOrigin(origin)}${path6}`;
 }
 function buildApprovalUrl(origin, request, challenge, pairing) {
   const query = new URLSearchParams({ request, challenge, pairing });
@@ -36111,6 +35707,430 @@ var init_steps = __esm(() => {
   };
 });
 
+// src/feature-setup.ts
+var exports_feature_setup = {};
+__export(exports_feature_setup, {
+  setupFeatureUsage: () => setupFeatureUsage,
+  runFeatureSetup: () => runFeatureSetup,
+  resolveFeatureSetupDestination: () => resolveFeatureSetupDestination,
+  reconcileLlmSetup: () => reconcileLlmSetup
+});
+function isSetupFeatureId(value) {
+  return SETUP_FEATURES.some((feature) => feature.id === value);
+}
+async function setupIntegration(requestedId, vars) {
+  if (!requestedId) {
+    throw new Error("Missing integration id. Example: npx sim-setup add integration slack");
+  }
+  const providerId = resolveOAuthClientCapabilityId(requestedId);
+  if (!providerId) {
+    throw new Error(`Unknown OAuth integration "${requestedId}". Expected one of: ${Object.keys(OAUTH_CLIENT_CAPABILITIES).join(", ")}`);
+  }
+  const fields = getOAuthClientSetupFields(providerId);
+  const values2 = {};
+  for (const field of fields) {
+    const existing = vars.get(field.key);
+    if (field.input === "secret") {
+      const value = await password2({
+        message: existing ? `${field.key} (Currently used); leave empty to keep it` : field.key,
+        validate: (candidate) => candidate || existing ? undefined : "required"
+      });
+      const resolved = value || existing;
+      if (!resolved)
+        throw new Error(`${field.key} was not provided`);
+      values2[field.key] = resolved;
+    } else {
+      values2[field.key] = await text2({
+        message: `${field.key}${existing ? " (Currently used)" : ""}`,
+        initialValue: existing,
+        validate: (candidate) => candidate ? undefined : "required"
+      });
+    }
+  }
+  log2.info(`Configured the ${providerId} OAuth client.`);
+  return values2;
+}
+function reconcileLlmSetup(providerId, values2) {
+  const pool = LLM_KEY_POOLS[providerId];
+  const fields = [...pool.keys, ..."fallbackKey" in pool ? [pool.fallbackKey] : []];
+  return {
+    values: values2,
+    remove: fields.filter((key) => !Object.hasOwn(values2, key))
+  };
+}
+async function setupLlm(vars) {
+  const currentProvider = Object.entries(LLM_KEY_POOLS).find(([, pool2]) => [...pool2.keys, ..."fallbackKey" in pool2 ? [pool2.fallbackKey] : []].some((key) => vars.has(key)))?.[0];
+  const provider = await select3({
+    message: "LLM key pool?",
+    options: Object.keys(LLM_KEY_POOLS).map((id) => ({
+      value: id,
+      label: id,
+      hint: id === currentProvider ? "Currently used" : undefined
+    })),
+    initialValue: currentProvider
+  });
+  const pool = LLM_KEY_POOLS[provider];
+  const keys = pool.keys;
+  const values2 = {};
+  for (const [index, key] of keys.entries()) {
+    const legacyKey = index === 0 && "fallbackKey" in pool ? pool.fallbackKey : undefined;
+    const existingKey = vars.has(key) ? key : legacyKey;
+    const existing = existingKey ? vars.get(existingKey) : undefined;
+    const value = await password2({
+      message: existing ? `${key} (${existingKey} is currently used); leave empty to keep it` : `${key}${index === 0 ? "" : " (empty to finish)"}`,
+      validate: index === 0 ? (candidate) => candidate || existing ? undefined : "required" : undefined
+    });
+    const resolved = value || existing;
+    if (!resolved)
+      break;
+    values2[key] = resolved;
+  }
+  return reconcileLlmSetup(provider, values2);
+}
+async function setupChat(vars) {
+  const overrides = mothershipOverride();
+  const copilotKey = await promptCopilotKey(vars.get("COPILOT_API_KEY"));
+  if (!copilotKey) {
+    throw new Error("Chat setup did not receive an API key. No configuration was changed.");
+  }
+  return {
+    ...overrides,
+    COPILOT_API_KEY: copilotKey,
+    ...chatFlagValues(copilotKey)
+  };
+}
+function setupFeatureUsage() {
+  return SETUP_FEATURES.map((feature) => feature.id === "integration" ? "integration <slug>" : feature.id).join(" | ");
+}
+function resolveFeatureSetupDestination(sources) {
+  if (sources.length === 0) {
+    throw new Error("No Sim configuration was detected. Run npx sim-setup first.");
+  }
+  const managed = sources.filter((source2) => source2.managedByCurrentCheckout);
+  if (managed.length === 0) {
+    throw new Error("No effective configuration is safely writable by this checkout. Process overrides, higher-precedence development env files, external Compose projects, and Helm releases must be updated at their source. Run npx sim-setup config for the detected sources.");
+  }
+  if (managed.length > 1) {
+    throw new Error(`More than one effective configuration is writable by this checkout (${managed.map((source2) => source2.label).join(", ")}). Run npx sim-setup config and remove the ambiguity before configuring a feature.`);
+  }
+  const source = managed[0];
+  if (!source.values) {
+    throw new Error(`${source.label} is managed by this checkout, but its effective environment could not be resolved. Run npx sim-setup config and fix the reported source error first.`);
+  }
+  if (source.kind === "helm") {
+    throw new Error("Helm configuration cannot be updated by npx sim-setup add. Update the release Secret or values and upgrade the release.");
+  }
+  return {
+    source,
+    target: source.kind === "compose" ? "root" : "sim",
+    vars: source.values,
+    containerized: source.kind === "compose"
+  };
+}
+async function runFeatureSetup(feature, args) {
+  if (!isSetupFeatureId(feature)) {
+    throw new Error(`Unknown setup feature "${feature}". Expected: ${setupFeatureUsage()}`);
+  }
+  const destination = resolveFeatureSetupDestination(discoverConfigurationSources());
+  const { target, vars } = destination;
+  let values2;
+  let remove;
+  const capabilitySetup = getCapabilitySetup(feature);
+  if (capabilitySetup) {
+    const result = await promptCapabilitySetup(capabilitySetup, vars, {
+      containerized: destination.containerized
+    });
+    values2 = result.values;
+    remove = result.remove;
+  } else if (feature === "chat") {
+    values2 = await setupChat(vars);
+    remove = [];
+  } else if (feature === "integration") {
+    values2 = await setupIntegration(args[0], vars);
+    remove = [];
+  } else if (feature === "llm") {
+    const result = await setupLlm(vars);
+    values2 = result.values;
+    remove = result.remove;
+  } else {
+    throw new Error(`Setup feature ${feature} has no handler`);
+  }
+  reconcileEnvValues(target, remove, values2);
+  const label = SETUP_FEATURES.find((item) => item.id === feature)?.label;
+  outro2(theme.accent(destination.containerized ? `${label} written to .env. Recreate the app container for it to take effect.` : `${label} configured.`));
+}
+var init_feature_setup = __esm(() => {
+  init_env_capabilities();
+  init_capability_config();
+  init_capability_setup();
+  init_configuration_sources();
+  init_env_files();
+  init_prompter();
+  init_steps();
+  init_theme();
+});
+
+// src/doctor.ts
+var exports_doctor = {};
+__export(exports_doctor, {
+  runDoctor: () => runDoctor
+});
+function render(findings, fixedCount) {
+  console.log(`
+${theme.heading("◆ Sim doctor")}
+`);
+  for (const group of GROUP_ORDER) {
+    const groupFindings = findings.filter((f2) => f2.group === group);
+    if (groupFindings.length === 0)
+      continue;
+    console.log(theme.heading(GROUP_TITLES[group]));
+    for (const finding of groupFindings) {
+      console.log(` ${glyph[finding.status]} ${finding.message}`);
+      if (finding.fix && finding.status !== "pass") {
+        console.log(`   ${theme.muted(`fix: ${finding.fix}`)}`);
+      }
+    }
+    console.log();
+  }
+  const counts = {
+    pass: findings.filter((f2) => f2.status === "pass").length,
+    warn: findings.filter((f2) => f2.status === "warn").length,
+    fail: findings.filter((f2) => f2.status === "fail").length
+  };
+  const summary = [`${counts.pass} passed`];
+  if (counts.warn)
+    summary.push(theme.warn(`${counts.warn} warning${counts.warn > 1 ? "s" : ""}`));
+  if (counts.fail)
+    summary.push(theme.error(`${counts.fail} failed`));
+  if (fixedCount)
+    summary.push(theme.success(`${fixedCount} fixed`));
+  console.log(summary.join(theme.muted(" · ")));
+}
+async function runDoctor(options) {
+  let findings = await runChecks(loadCheckContext(true));
+  let fixedCount = 0;
+  if (options.fix) {
+    const fixable = findings.filter((f2) => (f2.status === "fail" || f2.status === "warn") && f2.autofix);
+    for (const finding of fixable) {
+      finding.autofix?.();
+      fixedCount++;
+    }
+    if (fixedCount > 0)
+      findings = await runChecks(loadCheckContext(true));
+  }
+  if (options.json) {
+    console.log(JSON.stringify(findings.map(({ autofix: _autofix, ...rest }) => rest), null, 2));
+  } else {
+    render(findings, fixedCount);
+  }
+  return findings.some((f2) => f2.status === "fail") ? 1 : 0;
+}
+var GROUP_TITLES, GROUP_ORDER;
+var init_doctor = __esm(() => {
+  init_checks();
+  init_theme();
+  GROUP_TITLES = {
+    files: "Env files",
+    schema: "Schema",
+    consistency: "Consistency",
+    coherence: "Coherence",
+    live: "Live"
+  };
+  GROUP_ORDER = ["files", "schema", "consistency", "coherence", "live"];
+});
+
+// src/compose-asset.ts
+import { createHash as createHash2 } from "node:crypto";
+import { copyFileSync, existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "node:fs";
+import path6 from "node:path";
+import { fileURLToPath } from "node:url";
+function sha2562(contents) {
+  return createHash2("sha256").update(contents).digest("hex");
+}
+function readManagedState(root) {
+  const file = path6.join(root, MANAGED_STATE_FILE);
+  if (!existsSync6(file))
+    return null;
+  const parsed = JSON.parse(readFileSync6(file, "utf8"));
+  if (typeof parsed !== "object" || parsed === null || !("schemaVersion" in parsed) || parsed.schemaVersion !== 1 || !("composeSha256" in parsed) || typeof parsed.composeSha256 !== "string") {
+    throw new Error(`${file} is not a valid sim-setup managed-state file`);
+  }
+  return { schemaVersion: 1, composeSha256: parsed.composeSha256 };
+}
+function writeManagedState(root, contents) {
+  const state = { schemaVersion: 1, composeSha256: sha2562(contents) };
+  writeFileSync2(path6.join(root, MANAGED_STATE_FILE), `${JSON.stringify(state, null, 2)}
+`);
+}
+function packagedComposeFile() {
+  const moduleDirectory = path6.dirname(fileURLToPath(import.meta.url));
+  return path6.basename(moduleDirectory) === "src" ? path6.resolve(moduleDirectory, "../../..", COMPOSE_FILE2) : path6.join(moduleDirectory, COMPOSE_FILE2);
+}
+function ensureProductionComposeFile(context = SETUP_CONTEXT) {
+  const destination = path6.join(context.root, COMPOSE_FILE2);
+  if (context.kind === "source") {
+    if (!existsSync6(destination)) {
+      throw new Error(`Sim source checkout is missing ${COMPOSE_FILE2}`);
+    }
+    return destination;
+  }
+  const bundled = packagedComposeFile();
+  if (!existsSync6(bundled)) {
+    throw new Error(`The sim-setup package is missing its bundled ${COMPOSE_FILE2}`);
+  }
+  mkdirSync2(context.root, { recursive: true });
+  const packaged = readFileSync6(bundled, "utf8");
+  if (existsSync6(destination)) {
+    const current = readFileSync6(destination, "utf8");
+    if (current === packaged) {
+      writeManagedState(context.root, packaged);
+      return destination;
+    }
+    if (!current.includes(SIM_COMPOSE_MARKER2)) {
+      throw new Error(`${destination} exists but is not a recognized Sim Compose file`);
+    }
+    const managed = readManagedState(context.root);
+    if (!managed || managed.composeSha256 !== sha2562(current)) {
+      throw new Error(`${destination} has local changes; preserve or remove your customizations before updating it.`);
+    }
+  }
+  copyFileSync(bundled, destination);
+  writeManagedState(context.root, packaged);
+  return destination;
+}
+var COMPOSE_FILE2 = "docker-compose.prod.yml", SIM_COMPOSE_MARKER2 = "ghcr.io/simstudioai/simstudio", MANAGED_STATE_FILE = ".sim-setup.json";
+var init_compose_asset = __esm(() => {
+  init_context();
+});
+
+// src/compose-project.ts
+import { createHash as createHash3 } from "node:crypto";
+import path7 from "node:path";
+function standaloneComposeProjectName(root) {
+  const digest = createHash3("sha256").update(path7.resolve(root)).digest("hex").slice(0, 12);
+  return `sim-${digest}`;
+}
+function legacyComposeProjectName(root) {
+  const name = path7.basename(path7.resolve(root)).toLowerCase().replace(/[^a-z0-9_-]/g, "");
+  if (!/^[a-z0-9]/.test(name)) {
+    throw new Error(`Cannot derive the existing Compose project name from ${root}; set COMPOSE_PROJECT_NAME in its .env file.`);
+  }
+  return name;
+}
+var init_compose_project = () => {};
+
+// src/docker.ts
+import { spawnSync as spawnSync5 } from "node:child_process";
+import { existsSync as existsSync7 } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function daemonUp() {
+  return spawnSync5("docker", ["info"], { stdio: "ignore" }).status === 0;
+}
+function installed() {
+  return executableExists("docker");
+}
+function orbstackSelected() {
+  const host = process.env.DOCKER_HOST;
+  if (host)
+    return host.includes(".orbstack/");
+  const result = spawnSync5("docker", ["context", "show"], { encoding: "utf8" });
+  return result.status === 0 && result.stdout.trim() === "orbstack";
+}
+function appInstalled(app) {
+  return APP_DIRS.some((dir) => existsSync7(join(dir, app.bundle)));
+}
+function macDockerApp() {
+  if (orbstackSelected())
+    return { app: ORBSTACK_APP, explicit: true };
+  const orbstackOnly = appInstalled(ORBSTACK_APP) && !appInstalled(DOCKER_DESKTOP_APP);
+  return { app: orbstackOnly ? ORBSTACK_APP : DOCKER_DESKTOP_APP, explicit: false };
+}
+function openApp(app) {
+  return spawnSync5("open", ["-a", app.name], { stdio: "ignore" }).status === 0;
+}
+function startDockerApp({ app, explicit }) {
+  if (openApp(app))
+    return app;
+  if (explicit)
+    return null;
+  const other = app === ORBSTACK_APP ? DOCKER_DESKTOP_APP : ORBSTACK_APP;
+  return openApp(other) ? other : null;
+}
+function launchFailed(required, message, hints) {
+  if (required)
+    throw new SetupError(message, hints);
+  log2.warn([message, ...hints].join(`
+`));
+  return false;
+}
+async function ensureDocker(required) {
+  if (daemonUp())
+    return true;
+  if (!installed()) {
+    if (required)
+      throw new SetupError("Docker is not installed.", INSTALL_HINTS);
+    return false;
+  }
+  if (process.platform !== "darwin") {
+    if (required) {
+      throw new SetupError("Docker is installed but the daemon is not running.", [
+        `start it: ${theme.command("sudo systemctl start docker")} (Linux)`
+      ]);
+    }
+    return false;
+  }
+  const choice = macDockerApp();
+  const launch = await confirm2({
+    message: `Docker is installed but not running — start ${choice.app.name} now?`,
+    initialValue: true
+  });
+  if (!launch) {
+    if (required) {
+      throw new SetupError("Docker is required for this mode.", [
+        `start ${choice.app.name}, then re-run the wizard`
+      ]);
+    }
+    return false;
+  }
+  const app = startDockerApp(choice);
+  if (!app) {
+    return choice.explicit ? launchFailed(required, "The docker CLI is pointed at OrbStack, which is not installed.", [
+      `reinstall it: ${theme.command("brew install orbstack")}`,
+      `or point the CLI elsewhere: unset DOCKER_HOST and DOCKER_CONTEXT, then ${theme.command("docker context use <name>")}`
+    ]) : launchFailed(required, "Found the docker CLI, but no app to start.", NO_APP_HINTS);
+  }
+  const spin = spinner2();
+  spin.start(`Waiting for the Docker daemon (${app.name})…`);
+  const up = await waitFor(async () => daemonUp(), 90000, 2000);
+  spin.stop(up ? "Docker is running" : `${glyph.fail} daemon did not come up`);
+  if (!up) {
+    return launchFailed(required, `${app.name} did not start within 90s.`, [
+      app === ORBSTACK_APP ? "open OrbStack manually once to finish its first-run setup, then re-run" : "first-ever launch needs a GUI license acceptance — open Docker Desktop manually once, then re-run"
+    ]);
+  }
+  return true;
+}
+var INSTALL_HINTS, NO_APP_HINTS, ORBSTACK_APP, DOCKER_DESKTOP_APP, APP_DIRS;
+var init_docker = __esm(() => {
+  init_errors();
+  init_executables();
+  init_probes();
+  init_prompter();
+  init_theme();
+  INSTALL_HINTS = [
+    "install Docker Desktop: https://docker.com/products/docker-desktop",
+    `or OrbStack (lighter on macOS): ${theme.command("brew install orbstack")}`
+  ];
+  NO_APP_HINTS = [
+    ...INSTALL_HINTS,
+    `or start your existing runtime its own way, e.g. ${theme.command("colima start")}`
+  ];
+  ORBSTACK_APP = { name: "OrbStack", bundle: "OrbStack.app" };
+  DOCKER_DESKTOP_APP = { name: "Docker", bundle: "Docker.app" };
+  APP_DIRS = ["/Applications", join(homedir(), "Applications")];
+});
+
 // src/urls.ts
 var APP_URL = "http://localhost:3000", APP_SIGNUP_URL;
 var init_urls = __esm(() => {
@@ -38103,7 +38123,7 @@ function parseSetupArguments(rawArgs) {
 init_errors();
 init_theme();
 init_version();
-var SETUP_FEATURES2 = "email | storage | sandbox | jobs | cache | knowledge | knowledge-embeddings | llm | integration <slug>";
+var SETUP_FEATURES2 = "email | storage | sandbox | jobs | cache | knowledge | knowledge-embeddings | chat | llm | integration <slug>";
 var USAGE = `Usage:
   sim-setup [--quick] [--dir <path>] [--mode compose|dev|k8s]
   sim-setup config                         show configured capabilities and integrations

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim-setup",
-  "version": "1.0.1",
+  "version": "1.0.2-preview.34.1",
   "description": "Set up and manage a self-hosted Sim installation",
   "type": "module",
   "bin": {