agentful 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -3044,7 +3044,7 @@ var VERSION, brand, useColor, wrap, paint, sym, ui;
 var init_branding = __esm({
   "src/branding.ts"() {
     "use strict";
-    VERSION = "0.3.0" ? "0.3.0" : null.version;
+    VERSION = "0.3.1" ? "0.3.1" : null.version;
     brand = {
       name: "agentful",
       // the command users type
@@ -5873,6 +5873,135 @@ function describeBackendState(state) {
   return out;
 }
 
+// src/lib/backendConsent.ts
+var import_node_fs7 = require("fs");
+var import_node_path9 = require("path");
+var import_promises2 = require("readline/promises");
+function declaresManagedDatabase(decl) {
+  if (!decl) return false;
+  return Boolean(decl.managed_db) || (decl.collections?.length ?? 0) > 0 || authMethodsOf(decl).length > 0;
+}
+function decideConsent(input) {
+  if (!declaresManagedDatabase(input.declaration)) return { kind: "not_applicable" };
+  if (input.state === null) return { kind: "state_unknown" };
+  if (input.state.databaseEnabled) return { kind: "already_enabled" };
+  if (input.yes) return { kind: "enable", via: "flag" };
+  if (input.rememberedDecline) return { kind: "skip", reason: "remembered_decline" };
+  if (!input.interactive) return { kind: "skip", reason: "non_interactive" };
+  return { kind: "ask" };
+}
+function consentQuestion(decl) {
+  const names = (decl.collections ?? []).map((c) => c.name).filter(Boolean);
+  const what = names.length ? `a managed database with ${names.length} collection(s): ${names.slice(0, 6).join(", ")}${names.length > 6 ? ", \u2026" : ""}` : "a managed database";
+  return [
+    `This project declares ${what}.`,
+    "Enable it on the platform now? Two things change:",
+    "  \u2022 /api/* on your preview domain is routed to the backend \u2014 a static file under /api/ would no longer be served",
+    "  \u2022 the data API goes live under the declared access rules (a `public` collection is readable AND writable without login)",
+    'It is the same switch as the Backend tab; this push then applies the declaration. A "no" is remembered for this project (`agentful push --yes` or `agentful backend` enables it later).'
+  ].join("\n");
+}
+var consentFile = () => (0, import_node_path9.join)(configDir(), "backend-consent.json");
+function readConsentFile() {
+  try {
+    const raw = JSON.parse((0, import_node_fs7.readFileSync)(consentFile(), "utf8"));
+    return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+  } catch {
+    return {};
+  }
+}
+function hasRememberedDecline(projectId) {
+  return Boolean(readConsentFile()[projectId]);
+}
+function rememberDecline(projectId) {
+  const all = readConsentFile();
+  all[projectId] = { declined_at: (/* @__PURE__ */ new Date()).toISOString() };
+  (0, import_node_fs7.mkdirSync)(configDir(), { recursive: true });
+  (0, import_node_fs7.writeFileSync)(consentFile(), JSON.stringify(all, null, 2) + "\n", "utf8");
+}
+function forgetDecline(projectId) {
+  if (!(0, import_node_fs7.existsSync)(consentFile())) return;
+  const all = readConsentFile();
+  if (!(projectId in all)) return;
+  delete all[projectId];
+  (0, import_node_fs7.writeFileSync)(consentFile(), JSON.stringify(all, null, 2) + "\n", "utf8");
+}
+async function enableManagedDatabase(auth, userId, projectId) {
+  try {
+    const body = await request(`${API_URL}/api/projects/${userId}/${projectId}/backend/database`, {
+      method: "PUT",
+      token: auth.pb_token,
+      timeoutMs: 6e4,
+      body: { mode: "managed", provider: "managed_document" }
+    });
+    const status = String(body?.data?.status ?? body?.status ?? "");
+    return status === "active" ? { ok: true, status } : { ok: false, status, message: body?.error?.message || body?.message };
+  } catch (err2) {
+    return { ok: false, message: err2?.message || String(err2) };
+  }
+}
+async function ensureDatabaseConsent(opts) {
+  const lines = [];
+  if (!declaresManagedDatabase(opts.declaration)) {
+    return { decision: { kind: "not_applicable" }, enabled: false, lines };
+  }
+  const state = await fetchBackendSessionState(opts.auth, opts.userId, opts.projectId);
+  const interactive = opts.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  let decision = decideConsent({
+    declaration: opts.declaration,
+    state,
+    yes: opts.yes,
+    interactive,
+    rememberedDecline: hasRememberedDecline(opts.projectId)
+  });
+  if (decision.kind === "ask") {
+    const ask = opts.ask ?? (async (q) => {
+      const rl = (0, import_promises2.createInterface)({ input: process.stdin, output: process.stdout });
+      try {
+        return await rl.question(`${q}
+Enable the managed database? [y/N] `);
+      } finally {
+        rl.close();
+      }
+    });
+    const answer = (await ask(consentQuestion(opts.declaration))).trim().toLowerCase();
+    if (answer === "y" || answer === "yes") {
+      decision = { kind: "enable", via: "answer" };
+    } else {
+      rememberDecline(opts.projectId);
+      decision = { kind: "skip", reason: "declined" };
+    }
+  }
+  switch (decision.kind) {
+    case "state_unknown":
+      lines.push({ kind: "warn", text: "Could not read the backend state \u2014 the database is NOT enabled by this push; the declaration is stored and reported." });
+      return { decision, enabled: false, lines };
+    case "already_enabled":
+      return { decision, enabled: true, lines };
+    case "skip":
+      if (decision.reason === "non_interactive") {
+        lines.push({ kind: "info", text: "Managed database declared but not enabled \u2014 non-interactive push never enables it. Use `agentful push --yes` (CI) or enable it in the Backend tab (`agentful backend`)." });
+      } else if (decision.reason === "remembered_decline") {
+        lines.push({ kind: "info", text: "Managed database declared but not enabled \u2014 you declined earlier for this project. `agentful push --yes` or `agentful backend` enables it." });
+      } else {
+        lines.push({ kind: "info", text: "Not enabled. The declaration is stored; `agentful push --yes` or the Backend tab enables the database later." });
+      }
+      return { decision, enabled: false, lines };
+    case "enable": {
+      const result = await enableManagedDatabase(opts.auth, opts.userId, opts.projectId);
+      if (result.ok) {
+        forgetDecline(opts.projectId);
+        lines.push({ kind: "ok", text: `Managed database enabled${decision.via === "flag" ? " (--yes)" : ""} \u2014 this push applies the declaration.` });
+        return { decision, enabled: true, lines };
+      }
+      lines.push({ kind: "warn", text: `Could not enable the managed database${result.message ? `: ${result.message}` : ""}. The push continues; enable it in the Backend tab (\`agentful backend\`).` });
+      return { decision, enabled: false, lines };
+    }
+    default:
+      return { decision, enabled: false, lines };
+  }
+}
+
 // src/lib/buildStatus.ts
 init_branding();
 var DIAGNOSIS_MAX_AGE_MS = 15 * 60 * 1e3;
@@ -5962,8 +6091,22 @@ async function pushCommand(opts) {
       `Packed ${(zip.bytes / 1024 / 1024).toFixed(1)} MB compressed \u2014 the platform caps uploads at ${Math.floor(MAX_ZIP_UPLOAD_BYTES / (1024 * 1024))} MB. Remove large media or generated files from the source tree (node_modules, dist and .git are excluded automatically); large assets belong in the platform asset flow.`
     );
   }
-  ui.step("Uploading to your workspace\u2026");
   const declaration = mode === "source" ? readBackendDeclaration() : null;
+  if (declaration) {
+    const consent = await ensureDatabaseConsent({
+      auth,
+      userId,
+      projectId,
+      declaration,
+      yes: opts.yes
+    });
+    for (const line of consent.lines) {
+      if (line.kind === "ok") ui.ok(line.text);
+      else if (line.kind === "warn") ui.warn(line.text);
+      else ui.info(line.text);
+    }
+  }
+  ui.step("Uploading to your workspace\u2026");
   const upload = await request(
     `${API_URL}/api/workspaces/${userId}/${projectId}/source-zip`,
     {
@@ -6150,15 +6293,15 @@ async function openCommand() {
 
 // src/commands/tui.ts
 var import_node_child_process5 = require("child_process");
-var import_node_path17 = require("path");
+var import_node_path18 = require("path");
 
 // src/lib/binWrapper.ts
-var import_node_fs7 = require("fs");
-var import_node_path9 = require("path");
+var import_node_fs8 = require("fs");
+var import_node_path10 = require("path");
 var import_node_os3 = require("os");
 function ensureCliOnPath() {
-  const binDir = (0, import_node_path9.join)((0, import_node_os3.homedir)(), ".local", "share", "agentful", "bin");
-  (0, import_node_fs7.mkdirSync)(binDir, { recursive: true });
+  const binDir = (0, import_node_path10.join)((0, import_node_os3.homedir)(), ".local", "share", "agentful", "bin");
+  (0, import_node_fs8.mkdirSync)(binDir, { recursive: true });
   const entry = process.argv[1];
   if (!entry) return binDir;
   const restore = (name) => {
@@ -6167,8 +6310,8 @@ function ensureCliOnPath() {
 ` : `export ${name}=${JSON.stringify(original)}
 `;
   };
-  const wrapper = (0, import_node_path9.join)(binDir, "agentful");
-  (0, import_node_fs7.writeFileSync)(
+  const wrapper = (0, import_node_path10.join)(binDir, "agentful");
+  (0, import_node_fs8.writeFileSync)(
     wrapper,
     `#!/bin/sh
 # Generated by the Agentful CLI so the coding agent can run \`agentful \u2026\`.
@@ -6178,7 +6321,7 @@ function ensureCliOnPath() {
     "utf8"
   );
   try {
-    (0, import_node_fs7.chmodSync)(wrapper, 493);
+    (0, import_node_fs8.chmodSync)(wrapper, 493);
   } catch {
   }
   return binDir;
@@ -6188,13 +6331,13 @@ function ensureCliOnPath() {
 init_branding();
 
 // src/lib/engine.ts
-var import_node_fs8 = require("fs");
+var import_node_fs9 = require("fs");
 var import_node_crypto = require("crypto");
-var import_node_path10 = require("path");
+var import_node_path11 = require("path");
 var import_node_os4 = require("os");
 var import_node_child_process3 = require("child_process");
 var import_node_stream = require("stream");
-var import_promises2 = require("stream/promises");
+var import_promises3 = require("stream/promises");
 init_branding();
 var ENGINE_BINARY = "agentful-engine";
 var FALLBACK_ENGINE_VERSION = "v1.18.18";
@@ -6235,8 +6378,8 @@ function platformKey() {
   );
 }
 function cacheDir(version) {
-  const base = process.env.XDG_CACHE_HOME || (0, import_node_path10.join)((0, import_node_os4.homedir)(), ".cache");
-  return (0, import_node_path10.join)(base, "agentful", "engine", version);
+  const base = process.env.XDG_CACHE_HOME || (0, import_node_path11.join)((0, import_node_os4.homedir)(), ".cache");
+  return (0, import_node_path11.join)(base, "agentful", "engine", version);
 }
 async function fetchManifest() {
   try {
@@ -6247,7 +6390,7 @@ async function fetchManifest() {
 }
 async function sha256File(path) {
   const hash = (0, import_node_crypto.createHash)("sha256");
-  await (0, import_promises2.pipeline)((0, import_node_fs8.createReadStream)(path), hash);
+  await (0, import_promises3.pipeline)((0, import_node_fs9.createReadStream)(path), hash);
   return hash.digest("hex");
 }
 async function ensureEngine() {
@@ -6256,12 +6399,12 @@ async function ensureEngine() {
   noticeIfOutdated(manifest);
   const version = manifest?.engine_version || FALLBACK_ENGINE_VERSION;
   const dir = cacheDir(version);
-  const binPath = (0, import_node_path10.join)(dir, ENGINE_BINARY);
-  if ((0, import_node_fs8.existsSync)(binPath)) return binPath;
+  const binPath = (0, import_node_path11.join)(dir, ENGINE_BINARY);
+  if ((0, import_node_fs9.existsSync)(binPath)) return binPath;
   const artifact = manifest?.artifacts?.[key];
   const url = artifact?.url || `${APP_URL}/cli/engine/${version}/${key}${key.startsWith("darwin") ? ".zip" : ".tar.gz"}`;
-  (0, import_node_fs8.mkdirSync)(dir, { recursive: true });
-  const archivePath = (0, import_node_path10.join)(dir, key.startsWith("darwin") ? "engine.zip" : "engine.tar.gz");
+  (0, import_node_fs9.mkdirSync)(dir, { recursive: true });
+  const archivePath = (0, import_node_path11.join)(dir, key.startsWith("darwin") ? "engine.zip" : "engine.tar.gz");
   ui.step(`Preparing the ${brand.displayName} engine (first run only)\u2026`);
   const resp = await fetch(url, {
     redirect: "follow",
@@ -6275,11 +6418,11 @@ async function ensureEngine() {
       `Could not download the engine (HTTP ${resp.status}). Check your connection and try again.`
     );
   }
-  await (0, import_promises2.pipeline)(import_node_stream.Readable.fromWeb(resp.body), (0, import_node_fs8.createWriteStream)(archivePath));
+  await (0, import_promises3.pipeline)(import_node_stream.Readable.fromWeb(resp.body), (0, import_node_fs9.createWriteStream)(archivePath));
   if (artifact?.sha256) {
     const actual = await sha256File(archivePath);
     if (actual !== artifact.sha256) {
-      (0, import_node_fs8.rmSync)(archivePath, { force: true });
+      (0, import_node_fs9.rmSync)(archivePath, { force: true });
       throw new ApiError(
         0,
         "engine_checksum_mismatch",
@@ -6288,7 +6431,7 @@ async function ensureEngine() {
     }
   }
   const extract = archivePath.endsWith(".zip") ? (0, import_node_child_process3.spawnSync)("unzip", ["-oq", archivePath], { cwd: dir, stdio: "ignore" }) : (0, import_node_child_process3.spawnSync)("tar", ["-xzf", archivePath], { cwd: dir, stdio: "ignore" });
-  (0, import_node_fs8.rmSync)(archivePath, { force: true });
+  (0, import_node_fs9.rmSync)(archivePath, { force: true });
   if (extract.status !== 0) {
     throw new ApiError(
       0,
@@ -6296,24 +6439,24 @@ async function ensureEngine() {
       `Could not unpack the engine (needs ${archivePath.endsWith(".zip") ? "unzip" : "tar"} on PATH).`
     );
   }
-  const extracted = (0, import_node_path10.join)(dir, "opencode");
-  if ((0, import_node_fs8.existsSync)(extracted) && !(0, import_node_fs8.existsSync)(binPath)) (0, import_node_fs8.renameSync)(extracted, binPath);
-  if (!(0, import_node_fs8.existsSync)(binPath)) {
+  const extracted = (0, import_node_path11.join)(dir, "opencode");
+  if ((0, import_node_fs9.existsSync)(extracted) && !(0, import_node_fs9.existsSync)(binPath)) (0, import_node_fs9.renameSync)(extracted, binPath);
+  if (!(0, import_node_fs9.existsSync)(binPath)) {
     throw new ApiError(0, "engine_extract_failed", "Engine archive did not contain the expected binary.");
   }
-  (0, import_node_fs8.chmodSync)(binPath, 493);
+  (0, import_node_fs9.chmodSync)(binPath, 493);
   ui.ok(`Engine ready.`);
   console.log(paint.dim("  powered by opencode (MIT) \xB7 run `agentful licenses` for details"));
   return binPath;
 }
 
 // src/lib/gatewayToken.ts
-var import_node_fs9 = require("fs");
-var import_node_path11 = require("path");
-var cachePath = () => (0, import_node_path11.join)(configDir(), "gateway.json");
+var import_node_fs10 = require("fs");
+var import_node_path12 = require("path");
+var cachePath = () => (0, import_node_path12.join)(configDir(), "gateway.json");
 async function ensureGatewaySession(auth, projectId) {
   try {
-    const cached = JSON.parse((0, import_node_fs9.readFileSync)(cachePath(), "utf8"));
+    const cached = JSON.parse((0, import_node_fs10.readFileSync)(cachePath(), "utf8"));
     if (cached?.token && cached.expires_at - Date.now() / 1e3 > 3600) {
       return cached;
     }
@@ -6324,18 +6467,18 @@ async function ensureGatewaySession(auth, projectId) {
     body: projectId ? { project_id: projectId } : {},
     timeoutMs: 3e4
   });
-  (0, import_node_fs9.mkdirSync)(configDir(), { recursive: true });
-  (0, import_node_fs9.writeFileSync)(cachePath(), JSON.stringify(res, null, 2) + "\n", "utf8");
+  (0, import_node_fs10.mkdirSync)(configDir(), { recursive: true });
+  (0, import_node_fs10.writeFileSync)(cachePath(), JSON.stringify(res, null, 2) + "\n", "utf8");
   try {
-    (0, import_node_fs9.chmodSync)(cachePath(), 384);
+    (0, import_node_fs10.chmodSync)(cachePath(), 384);
   } catch {
   }
   return res;
 }
 
 // src/lib/engineConfig.ts
-var import_node_fs11 = require("fs");
-var import_node_path13 = require("path");
+var import_node_fs12 = require("fs");
+var import_node_path14 = require("path");
 var import_node_os5 = require("os");
 
 // src/branding/agentful-theme.json
@@ -6478,22 +6621,22 @@ ${cmd.template}
 }
 
 // src/lib/tools.ts
-var import_node_fs10 = require("fs");
-var import_node_path12 = require("path");
+var import_node_fs11 = require("fs");
+var import_node_path13 = require("path");
 function assetsDir() {
-  const here = (0, import_node_path12.dirname)(process.argv[1] || "");
-  for (const candidate of [(0, import_node_path12.join)(here, "..", "assets"), (0, import_node_path12.join)(here, "assets")]) {
-    if ((0, import_node_fs10.existsSync)((0, import_node_path12.join)(candidate, "tools", "imagegen.ts"))) return candidate;
+  const here = (0, import_node_path13.dirname)(process.argv[1] || "");
+  for (const candidate of [(0, import_node_path13.join)(here, "..", "assets"), (0, import_node_path13.join)(here, "assets")]) {
+    if ((0, import_node_fs11.existsSync)((0, import_node_path13.join)(candidate, "tools", "imagegen.ts"))) return candidate;
   }
   return null;
 }
 function installEngineTools(configDir2) {
   const assets = assetsDir();
   if (!assets) return false;
-  const target = (0, import_node_path12.join)(configDir2, "tools");
-  (0, import_node_fs10.mkdirSync)(target, { recursive: true });
+  const target = (0, import_node_path13.join)(configDir2, "tools");
+  (0, import_node_fs11.mkdirSync)(target, { recursive: true });
   try {
-    (0, import_node_fs10.cpSync)((0, import_node_path12.join)(assets, "tools"), target, { recursive: true });
+    (0, import_node_fs11.cpSync)((0, import_node_path13.join)(assets, "tools"), target, { recursive: true });
     return true;
   } catch {
     return false;
@@ -6675,7 +6818,9 @@ without an address. Read \`.agentful/project.json\` and give the full URL
 \`https://app.agentful.dev/workspace/<userId>/<projectId>?view=backend\` \u2014 or
 simply the command \`agentful backend\`, which opens exactly that page and
 shows the live state. Declaring a backend never enables it; enabling is the
-user's conscious step in that tab.
+user's conscious step \u2014 in that tab, or by answering the question
+\`agentful push\` asks once (it names both consequences; a non-interactive
+push never enables anything).
 
 ## Diagnosing failed pushes and cloud builds (hard rule)
 
@@ -6703,7 +6848,7 @@ var CLOUD_AGENT_PROMPT = `You are the Agentful Cloud build agent: everything you
 var LOCAL_AGENT_PROMPT = "You are in local-only mode: free local development with no cloud deployment target \u2014 any stack is fine. Be clear that this directory will NOT be deployable with `agentful push` unless it satisfies the platform contract in AGENTFUL_CLOUD.md (static files only). If the user asks to deploy or push, check the contract first and say honestly whether the project can ship on the platform; never claim cloud deployability without evidence.";
 function readAuthFile(path) {
   try {
-    return (0, import_node_fs11.readFileSync)(path, "utf8");
+    return (0, import_node_fs12.readFileSync)(path, "utf8");
   } catch {
     return null;
   }
@@ -6768,11 +6913,11 @@ function buildEngineConfig(opts) {
   };
 }
 function engineXdg() {
-  const root = (0, import_node_path13.join)((0, import_node_os5.homedir)(), ".local", "share", "agentful");
+  const root = (0, import_node_path14.join)((0, import_node_os5.homedir)(), ".local", "share", "agentful");
   return {
-    configHome: (0, import_node_path13.join)(root, "engine-config"),
-    dataHome: (0, import_node_path13.join)(root, "engine-data"),
-    stateHome: (0, import_node_path13.join)(root, "engine-state")
+    configHome: (0, import_node_path14.join)(root, "engine-config"),
+    dataHome: (0, import_node_path14.join)(root, "engine-data"),
+    stateHome: (0, import_node_path14.join)(root, "engine-state")
   };
 }
 async function resolveTheme() {
@@ -6791,24 +6936,24 @@ async function resolveTheme() {
 }
 async function writeEngineSession(session, catalog, localProviders = {}, framework = "unknown", skillsInstruction = null, backendState) {
   const xdg = engineXdg();
-  const configDir2 = (0, import_node_path13.join)(xdg.configHome, "opencode");
-  const dataDir = (0, import_node_path13.join)(xdg.dataHome, "opencode");
-  const themesDir = (0, import_node_path13.join)(configDir2, "themes");
-  const pluginsDir = (0, import_node_path13.join)(configDir2, "plugins");
-  const commandsDir = (0, import_node_path13.join)(configDir2, "commands");
-  for (const dir of [themesDir, pluginsDir, commandsDir, dataDir, (0, import_node_path13.join)(xdg.stateHome, "opencode")]) {
-    (0, import_node_fs11.mkdirSync)(dir, { recursive: true });
+  const configDir2 = (0, import_node_path14.join)(xdg.configHome, "opencode");
+  const dataDir = (0, import_node_path14.join)(xdg.dataHome, "opencode");
+  const themesDir = (0, import_node_path14.join)(configDir2, "themes");
+  const pluginsDir = (0, import_node_path14.join)(configDir2, "plugins");
+  const commandsDir = (0, import_node_path14.join)(configDir2, "commands");
+  for (const dir of [themesDir, pluginsDir, commandsDir, dataDir, (0, import_node_path14.join)(xdg.stateHome, "opencode")]) {
+    (0, import_node_fs12.mkdirSync)(dir, { recursive: true });
   }
   const imagegenAvailable = installEngineTools(configDir2) && session.img_on !== false;
-  const cloudInstructionsPath = (0, import_node_path13.join)(configDir2, CLOUD_INSTRUCTIONS_FILENAME);
-  (0, import_node_fs11.writeFileSync)(cloudInstructionsPath, renderCloudInstructions(framework, backendState));
-  const skillsPath = (0, import_node_path13.join)(configDir2, "AGENTFUL_SKILLS.md");
+  const cloudInstructionsPath = (0, import_node_path14.join)(configDir2, CLOUD_INSTRUCTIONS_FILENAME);
+  (0, import_node_fs12.writeFileSync)(cloudInstructionsPath, renderCloudInstructions(framework, backendState));
+  const skillsPath = (0, import_node_path14.join)(configDir2, "AGENTFUL_SKILLS.md");
   const instructionPaths = [cloudInstructionsPath];
   if (skillsInstruction) {
-    (0, import_node_fs11.writeFileSync)(skillsPath, skillsInstruction);
+    (0, import_node_fs12.writeFileSync)(skillsPath, skillsInstruction);
     instructionPaths.push(skillsPath);
   } else {
-    (0, import_node_fs11.rmSync)(skillsPath, { force: true });
+    (0, import_node_fs12.rmSync)(skillsPath, { force: true });
   }
   const config = buildEngineConfig({
     session,
@@ -6817,23 +6962,23 @@ async function writeEngineSession(session, catalog, localProviders = {}, framewo
     imagegenAvailable,
     instructionPaths
   });
-  (0, import_node_fs11.writeFileSync)((0, import_node_path13.join)(configDir2, "config.json"), JSON.stringify(config, null, 2));
-  const authPath2 = (0, import_node_path13.join)(dataDir, "auth.json");
-  (0, import_node_fs11.writeFileSync)(authPath2, mergedAuthJson(readAuthFile(authPath2), session.token));
+  (0, import_node_fs12.writeFileSync)((0, import_node_path14.join)(configDir2, "config.json"), JSON.stringify(config, null, 2));
+  const authPath2 = (0, import_node_path14.join)(dataDir, "auth.json");
+  (0, import_node_fs12.writeFileSync)(authPath2, mergedAuthJson(readAuthFile(authPath2), session.token));
   const { brandingPluginSource: brandingPluginSource2 } = await Promise.resolve().then(() => (init_plugin(), plugin_exports));
-  const pluginPath = (0, import_node_path13.join)(pluginsDir, "agentful-branding.tsx");
-  (0, import_node_fs11.writeFileSync)(pluginPath, brandingPluginSource2());
-  (0, import_node_fs11.writeFileSync)((0, import_node_path13.join)(configDir2, "tui.json"), JSON.stringify({
+  const pluginPath = (0, import_node_path14.join)(pluginsDir, "agentful-branding.tsx");
+  (0, import_node_fs12.writeFileSync)(pluginPath, brandingPluginSource2());
+  (0, import_node_fs12.writeFileSync)((0, import_node_path14.join)(configDir2, "tui.json"), JSON.stringify({
     theme: "agentful",
     plugin: [`file://${pluginPath}`]
   }, null, 2));
-  (0, import_node_fs11.writeFileSync)((0, import_node_path13.join)(themesDir, "agentful.json"), JSON.stringify(await resolveTheme(), null, 2));
+  (0, import_node_fs12.writeFileSync)((0, import_node_path14.join)(themesDir, "agentful.json"), JSON.stringify(await resolveTheme(), null, 2));
   for (const name of Object.keys(SLASH_COMMANDS)) {
-    (0, import_node_fs11.writeFileSync)((0, import_node_path13.join)(commandsDir, `${name}.md`), commandMarkdown(name));
+    (0, import_node_fs12.writeFileSync)((0, import_node_path14.join)(commandsDir, `${name}.md`), commandMarkdown(name));
   }
   for (const legacy of ["xdg-config", "xdg-data", "xdg-state"]) {
     try {
-      (0, import_node_fs11.rmSync)((0, import_node_path13.join)((0, import_node_os5.homedir)(), ".local", "share", "agentful", legacy), { recursive: true, force: true });
+      (0, import_node_fs12.rmSync)((0, import_node_path14.join)((0, import_node_os5.homedir)(), ".local", "share", "agentful", legacy), { recursive: true, force: true });
     } catch {
     }
   }
@@ -6841,8 +6986,8 @@ async function writeEngineSession(session, catalog, localProviders = {}, framewo
 }
 
 // src/lib/skills.ts
-var import_node_fs12 = require("fs");
-var import_node_path14 = require("path");
+var import_node_fs13 = require("fs");
+var import_node_path15 = require("path");
 
 // src/generated/skills.json
 var skills_default = {
@@ -6911,7 +7056,7 @@ var SCAFFOLD_BY_FRAMEWORK = {
 };
 function hasVueDependency(rootDir) {
   try {
-    const pkg = JSON.parse((0, import_node_fs12.readFileSync)((0, import_node_path14.join)(rootDir, "package.json"), "utf8"));
+    const pkg = JSON.parse((0, import_node_fs13.readFileSync)((0, import_node_path15.join)(rootDir, "package.json"), "utf8"));
     return Boolean({ ...pkg.dependencies, ...pkg.devDependencies }["vue"]);
   } catch {
     return false;
@@ -6941,7 +7086,7 @@ function renderSkillsInstruction(names) {
   return "# Platform deployment skills (mandatory)\n\nThese are the same skills the cloud build agent loads for this stack.\nFollow them when scaffolding or editing \u2014 they are not optional hints.\n\n" + sections.join("\n\n---\n\n") + "\n";
 }
 function skillsInstructionFor(framework, rootDir) {
-  if (!(0, import_node_fs12.existsSync)(rootDir)) return null;
+  if (!(0, import_node_fs13.existsSync)(rootDir)) return null;
   return renderSkillsInstruction(selectSkills(framework, rootDir));
 }
 
@@ -7056,15 +7201,15 @@ function decideLocalProviders(policy) {
 }
 
 // src/lib/localProviders.ts
-var import_node_fs13 = require("fs");
-var import_node_path15 = require("path");
+var import_node_fs14 = require("fs");
+var import_node_path16 = require("path");
 var LOCAL_PROVIDERS_FILE = "local-providers.json";
 function localProvidersPath() {
-  return (0, import_node_path15.join)(configDir(), LOCAL_PROVIDERS_FILE);
+  return (0, import_node_path16.join)(configDir(), LOCAL_PROVIDERS_FILE);
 }
 function readLocalProviders() {
   try {
-    const raw = JSON.parse((0, import_node_fs13.readFileSync)(localProvidersPath(), "utf8"));
+    const raw = JSON.parse((0, import_node_fs14.readFileSync)(localProvidersPath(), "utf8"));
     if (raw && typeof raw === "object" && !Array.isArray(raw)) {
       const map = raw.providers && typeof raw.providers === "object" ? raw.providers : raw;
       const usable = {};
@@ -7099,8 +7244,8 @@ function resolveLocalProviders(policy) {
 }
 function writeLocalProvidersExample() {
   const path = localProvidersPath();
-  if ((0, import_node_fs13.existsSync)(path)) return path;
-  (0, import_node_fs13.mkdirSync)(configDir(), { recursive: true });
+  if ((0, import_node_fs14.existsSync)(path)) return path;
+  (0, import_node_fs14.mkdirSync)(configDir(), { recursive: true });
   const example = {
     _comment: 'Providers with your own API key, running locally. Requests go directly to the provider \u2014 no Agentful credits, no platform region guarantee. Remove the leading underscore from "_anthropic" and fill in your key to enable it.',
     _anthropic: {
@@ -7110,21 +7255,21 @@ function writeLocalProvidersExample() {
       models: { "claude-sonnet-4-5": { name: "Claude Sonnet 4.5 (my key)" } }
     }
   };
-  (0, import_node_fs13.writeFileSync)(path, JSON.stringify(example, null, 2) + "\n", "utf8");
+  (0, import_node_fs14.writeFileSync)(path, JSON.stringify(example, null, 2) + "\n", "utf8");
   try {
-    (0, import_node_fs13.chmodSync)(path, 384);
+    (0, import_node_fs14.chmodSync)(path, 384);
   } catch {
   }
   return path;
 }
 
 // src/lib/sessions.ts
-var import_node_fs14 = require("fs");
-var import_node_path16 = require("path");
+var import_node_fs15 = require("fs");
+var import_node_path17 = require("path");
 var import_node_child_process4 = require("child_process");
 function lastSessionForDirectory(cwd = process.cwd()) {
-  const dbPath = (0, import_node_path16.join)(engineXdg().dataHome, "opencode", "opencode.db");
-  if (!(0, import_node_fs14.existsSync)(dbPath)) return null;
+  const dbPath = (0, import_node_path17.join)(engineXdg().dataHome, "opencode", "opencode.db");
+  if (!(0, import_node_fs15.existsSync)(dbPath)) return null;
   const escaped = cwd.replace(/'/g, "''");
   const res = (0, import_node_child_process4.spawnSync)(
     "sqlite3",
@@ -7216,7 +7361,7 @@ async function tuiCommand(opts = {}) {
         ...process.env,
         // Slash commands run `agentful …` through the agent's bash tool, which
         // has no access to the user's shell aliases.
-        PATH: `${binDir}${import_node_path17.delimiter}${process.env.PATH || ""}`,
+        PATH: `${binDir}${import_node_path18.delimiter}${process.env.PATH || ""}`,
         XDG_CONFIG_HOME: xdg.configHome,
         XDG_DATA_HOME: xdg.dataHome,
         XDG_STATE_HOME: xdg.stateHome,
@@ -7321,28 +7466,28 @@ async function shareCommand(opts) {
 }
 
 // src/commands/pull.ts
-var import_node_fs15 = require("fs");
-var import_node_path18 = require("path");
+var import_node_fs16 = require("fs");
+var import_node_path19 = require("path");
 init_branding();
 init_branding();
 function isProbablyBase64Binary(path) {
   return /\.(png|jpe?g|gif|webp|ico|woff2?|ttf|otf|eot|pdf|zip|mp[34]|webm|avif)$/i.test(path);
 }
 function writeEntry(root, rel, value) {
-  const target = (0, import_node_path18.join)(root, rel);
-  (0, import_node_fs15.mkdirSync)((0, import_node_path18.dirname)(target), { recursive: true });
+  const target = (0, import_node_path19.join)(root, rel);
+  (0, import_node_fs16.mkdirSync)((0, import_node_path19.dirname)(target), { recursive: true });
   const content = typeof value === "object" && value !== null && "content" in value ? String(value.content) : String(value ?? "");
   if (isProbablyBase64Binary(rel)) {
-    (0, import_node_fs15.writeFileSync)(target, Buffer.from(content, "base64"));
+    (0, import_node_fs16.writeFileSync)(target, Buffer.from(content, "base64"));
   } else {
-    (0, import_node_fs15.writeFileSync)(target, content, "utf8");
+    (0, import_node_fs16.writeFileSync)(target, content, "utf8");
   }
 }
 async function pullCommand(opts) {
   console.log(banner());
   const auth = await ensureAuth();
   const project = requireProject();
-  const nonHidden = (0, import_node_fs15.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
+  const nonHidden = (0, import_node_fs16.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
   if (nonHidden.length > 0 && !opts.force) {
     throw new ApiError(
       0,
@@ -7366,9 +7511,9 @@ async function pullCommand(opts) {
         ui.warn(`Skipped ${rel} (HTTP ${resp.status})`);
         continue;
       }
-      const target = (0, import_node_path18.join)(process.cwd(), rel);
-      (0, import_node_fs15.mkdirSync)((0, import_node_path18.dirname)(target), { recursive: true });
-      (0, import_node_fs15.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
+      const target = (0, import_node_path19.join)(process.cwd(), rel);
+      (0, import_node_fs16.mkdirSync)((0, import_node_path19.dirname)(target), { recursive: true });
+      (0, import_node_fs16.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
       written++;
     }
   } else if (data.files) {
@@ -7522,7 +7667,7 @@ program2.command("login").description("Sign in to your Agentful account (device
 program2.command("logout").description("Remove the stored credentials").action(run(logoutCommand));
 program2.command("whoami").description("Show the signed-in account").action(run(whoamiCommand));
 program2.command("init").description("Create (or link) the Agentful cloud project for this directory").argument("[directory]", "with --template: new folder to scaffold into (created for you)").option("--link <projectId>", "link an existing project instead of creating one").option("--title <title>", "project title (skips the prompt)").option("--template <framework>", "scaffold from a platform starter (nextjs, react, vue, vanilla)").action(run((directory, opts) => initCommand(opts, directory)));
-program2.command("push").description("Upload this project and get a live preview URL").option("--prebuilt", "upload a locally built output instead of building in the cloud").option("--dir <path>", "built-output directory for --prebuilt (default: auto-detect)").option("--force", "push even when the pre-upload compatibility check finds blocking issues").action(run((opts) => pushCommand(opts)));
+program2.command("push").description("Upload this project and get a live preview URL").option("--prebuilt", "upload a locally built output instead of building in the cloud").option("--dir <path>", "built-output directory for --prebuilt (default: auto-detect)").option("--force", "push even when the pre-upload compatibility check finds blocking issues").option("-y, --yes", "enable the declared managed database without asking (CI); a non-interactive push never enables it").action(run((opts) => pushCommand(opts)));
 program2.command("build-status").description("Show the cloud's record of the last build (the real error on failures)").action(run(buildStatusCommand));
 program2.command("backend").description("Open this project's Backend tab (managed DB + server actions) in the browser").action(run(backendCommand));
 program2.command("open").description("Open the live preview in the browser").action(run(openCommand));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentful",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Agentful in your terminal — local development with push-to-cloud previews",
   "license": "Apache-2.0",
   "homepage": "https://agentful.dev",