@base44-preview/cli 0.0.56-pr.547.a0144b8 → 0.0.56-pr.547.db4783d

package/dist/cli/index.js

@@ -16349,7 +16349,7 @@ var require_front_matter = __commonJS((exports, module) => {
   var optionalByteOrderMark = "\\ufeff?";
   var platform5 = typeof process !== "undefined" ? process.platform : "";
   var pattern = "^(" + optionalByteOrderMark + "(= yaml =|---)" + "$([\\s\\S]*?)" + "^(?:\\2|\\.\\.\\.)\\s*" + "$" + (platform5 === "win32" ? "\\r?" : "") + "(?:\\n)?)";
-  var regex = new RegExp(pattern, "m");
+  var regex2 = new RegExp(pattern, "m");
   module.exports = extractor;
   module.exports.test = test;
   function extractor(string4, options) {
@@ -16384,7 +16384,7 @@ var require_front_matter = __commonJS((exports, module) => {
     return line;
   }
   function parse10(string4, allowUnsafe) {
-    var match = regex.exec(string4);
+    var match = regex2.exec(string4);
     if (!match) {
       return {
         attributes: {},
@@ -16406,7 +16406,7 @@ var require_front_matter = __commonJS((exports, module) => {
   }
   function test(string4) {
     string4 = string4 || "";
-    return regex.test(string4);
+    return regex2.test(string4);
   }
 });
 
@@ -121034,9 +121034,9 @@ function getMessage2(key2, parameters, self2) {
     assert22.ok(message.length <= parameters.length, `Code: ${key2}; The provided arguments length (${parameters.length}) does not match the required ones (${message.length}).`);
     return Reflect.apply(message, self2, parameters);
   }
-  const regex = /%[dfijoOs]/g;
+  const regex2 = /%[dfijoOs]/g;
   let expectedLength = 0;
-  while (regex.exec(message) !== null)
+  while (regex2.exec(message) !== null)
     expectedLength++;
   assert22.ok(expectedLength === parameters.length, `Code: ${key2}; The provided arguments length (${parameters.length}) does not match the required ones (${expectedLength}).`);
   if (parameters.length === 0)
@@ -121937,9 +121937,9 @@ function convertEndOfLineOptionToCharacter2(endOfLineOption) {
   return endOfLineOption === OPTION_CR2 ? CHARACTER_CR2 : endOfLineOption === OPTION_CRLF2 ? CHARACTER_CRLF2 : DEFAULT_EOL2;
 }
 function countEndOfLineCharacters(text, endOfLineCharacter) {
-  const regex = regexps.get(endOfLineCharacter);
+  const regex2 = regexps.get(endOfLineCharacter);
   if (false) {}
-  return text.match(regex)?.length ?? 0;
+  return text.match(regex2)?.length ?? 0;
 }
 function normalizeEndOfLine(text) {
   return method_replace_all_default2(0, text, END_OF_LINE_REGEXP, CHARACTER_LF2);
@@ -124141,8 +124141,8 @@ function legacyIsNextLineEmpty(text, node, locEnd) {
 }
 function makeString(rawText, enclosingQuote, unescapeUnnecessaryEscapes) {
   const otherQuote = enclosingQuote === '"' ? "'" : '"';
-  const regex = /\\(.)|(["'])/gsu;
-  const raw2 = method_replace_all_default2(0, rawText, regex, (match, escaped, quote) => {
+  const regex2 = /\\(.)|(["'])/gsu;
+  const raw2 = method_replace_all_default2(0, rawText, regex2, (match, escaped, quote) => {
     if (escaped === otherQuote) {
       return escaped;
     }
@@ -127563,17 +127563,17 @@ var init_prettier = __esm(() => {
         }
         const opts = options8 || {};
         const posix = utils3.isWindows(options8);
-        const regex = isState ? picomatch.compileRe(glob, options8) : picomatch.makeRe(glob, options8, false, true);
-        const state = regex.state;
-        delete regex.state;
+        const regex2 = isState ? picomatch.compileRe(glob, options8) : picomatch.makeRe(glob, options8, false, true);
+        const state = regex2.state;
+        delete regex2.state;
         let isIgnored2 = () => false;
         if (opts.ignore) {
           const ignoreOpts = { ...options8, ignore: null, onMatch: null, onResult: null };
           isIgnored2 = picomatch(opts.ignore, ignoreOpts, returnState);
         }
         const matcher = (input, returnObject = false) => {
-          const { isMatch, match, output } = picomatch.test(input, regex, options8, { glob, posix });
-          const result = { glob, state, regex, posix, input, output, match, isMatch };
+          const { isMatch, match, output } = picomatch.test(input, regex2, options8, { glob, posix });
+          const result = { glob, state, regex: regex2, posix, input, output, match, isMatch };
           if (typeof opts.onResult === "function") {
             opts.onResult(result);
           }
@@ -127598,7 +127598,7 @@ var init_prettier = __esm(() => {
         }
         return matcher;
       };
-      picomatch.test = (input, regex, options8, { glob, posix } = {}) => {
+      picomatch.test = (input, regex2, options8, { glob, posix } = {}) => {
         if (typeof input !== "string") {
           throw new TypeError("Expected input to be a string");
         }
@@ -127615,16 +127615,16 @@ var init_prettier = __esm(() => {
         }
         if (match === false || opts.capture === true) {
           if (opts.matchBase === true || opts.basename === true) {
-            match = picomatch.matchBase(input, regex, options8, posix);
+            match = picomatch.matchBase(input, regex2, options8, posix);
           } else {
-            match = regex.exec(output);
+            match = regex2.exec(output);
           }
         }
         return { isMatch: Boolean(match), match, output };
       };
       picomatch.matchBase = (input, glob, options8, posix = utils3.isWindows(options8)) => {
-        const regex = glob instanceof RegExp ? glob : picomatch.makeRe(glob, options8);
-        return regex.test(path152.basename(input));
+        const regex2 = glob instanceof RegExp ? glob : picomatch.makeRe(glob, options8);
+        return regex2.test(path152.basename(input));
       };
       picomatch.isMatch = (str, patterns, options8) => picomatch(patterns, options8)(str);
       picomatch.parse = (pattern, options8) => {
@@ -127644,11 +127644,11 @@ var init_prettier = __esm(() => {
         if (state && state.negated === true) {
           source2 = `^(?!${source2}).*$`;
         }
-        const regex = picomatch.toRegex(source2, options8);
+        const regex2 = picomatch.toRegex(source2, options8);
         if (returnState === true) {
-          regex.state = state;
+          regex2.state = state;
         }
-        return regex;
+        return regex2;
       };
       picomatch.makeRe = (input, options8 = {}, returnOutput = false, returnState = false) => {
         if (!input || typeof input !== "string") {
@@ -127812,8 +127812,8 @@ var init_prettier = __esm(() => {
       };
       micromatch2.capture = (glob, input, options8) => {
         let posix = utils3.isWindows(options8);
-        let regex = picomatch.makeRe(String(glob), { ...options8, capture: true });
-        let match = regex.exec(posix ? utils3.toPosixSlashes(input) : input);
+        let regex2 = picomatch.makeRe(String(glob), { ...options8, capture: true });
+        let match = regex2.exec(posix ? utils3.toPosixSlashes(input) : input);
         if (match) {
           return match.slice(1).map((v10) => v10 === undefined ? "" : v10);
         }
@@ -132252,7 +132252,7 @@ globstar while`, file2, fr10, pattern, pr8, swallowee);
       };
       Object.defineProperty(exports, "__esModule", { value: true });
       var fs42 = __importStar(__require2("fs"));
-      var regex = {
+      var regex2 = {
         section: /^\s*\[(([^#;]|\\#|\\;)+)\]\s*([#;].*)?$/,
         param: /^\s*([\w\.\-\_]+)\s*[=:]\s*(.*?)\s*([#;].*)?$/,
         comment: /^\s*[#;].*$/
@@ -132284,14 +132284,14 @@ globstar while`, file2, fr10, pattern, pr8, swallowee);
         var lines = data.split(/\r\n|\r|\n/);
         lines.forEach(function(line3) {
           var match;
-          if (regex.comment.test(line3)) {
+          if (regex2.comment.test(line3)) {
             return;
           }
-          if (regex.param.test(line3)) {
-            match = line3.match(regex.param);
+          if (regex2.param.test(line3)) {
+            match = line3.match(regex2.param);
             sectionBody[match[1]] = match[2];
-          } else if (regex.section.test(line3)) {
-            match = line3.match(regex.section);
+          } else if (regex2.section.test(line3)) {
+            match = line3.match(regex2.section);
             sectionName = match[1];
             sectionBody = {};
             value.push([sectionName, sectionBody]);
@@ -133377,8 +133377,8 @@ globstar while`, file2, fr10, pattern, pr8, swallowee);
         }
         _make(mode, key2) {
           const str = this.regexPrefix.replace(REGEX_REPLACE_TRAILING_WILDCARD, TRAILING_WILD_CARD_REPLACERS[mode]);
-          const regex = this.ignoreCase ? new RegExp(str, "i") : new RegExp(str);
-          return define2(this, key2, regex);
+          const regex2 = this.ignoreCase ? new RegExp(str, "i") : new RegExp(str);
+          return define2(this, key2, regex2);
         }
       };
       var createRule = ({
@@ -138174,8 +138174,8 @@ var require_prettier = __commonJS((exports, module) => {
   }
   function makeString2(rawText, enclosingQuote, unescapeUnnecessaryEscapes) {
     const otherQuote = enclosingQuote === '"' ? "'" : '"';
-    const regex = /\\(.)|(["'])/gsu;
-    const raw2 = method_replace_all_default3(0, rawText, regex, (match, escaped, quote) => {
+    const regex2 = /\\(.)|(["'])/gsu;
+    const raw2 = method_replace_all_default3(0, rawText, regex2, (match, escaped, quote) => {
       if (escaped === otherQuote) {
         return escaped;
       }
@@ -164333,12 +164333,12 @@ var require_ipaddr = __commonJS((exports, module) => {
         return this.toNormalizedString().replace(/((^|:)(0(:|$))+)/, "::");
       };
       IPv6.prototype.toRFC5952String = function() {
-        var bestMatchIndex, bestMatchLength, match, regex, string4;
-        regex = /((^|:)(0(:|$)){2,})/g;
+        var bestMatchIndex, bestMatchLength, match, regex2, string4;
+        regex2 = /((^|:)(0(:|$)){2,})/g;
         string4 = this.toNormalizedString();
         bestMatchIndex = 0;
         bestMatchLength = -1;
-        while (match = regex.exec(string4)) {
+        while (match = regex2.exec(string4)) {
           if (match[0].length > bestMatchLength) {
             bestMatchIndex = match.index;
             bestMatchLength = match[0].length;
@@ -169656,10 +169656,10 @@ var require_follow_redirects = __commonJS((exports, module) => {
     spread.path = spread.search ? spread.pathname + spread.search : spread.pathname;
     return spread;
   }
-  function removeMatchingHeaders(regex, headers) {
+  function removeMatchingHeaders(regex2, headers) {
     var lastValue;
     for (var header2 in headers) {
-      if (regex.test(header2)) {
+      if (regex2.test(header2)) {
         lastValue = headers[header2];
         delete headers[header2];
       }
@@ -201219,9 +201219,9 @@ var require_dist4 = __commonJS((exports, module) => {
         name2 = "/" + name2;
       let nsp = this._nsps.get(name2);
       if (!nsp) {
-        for (const [regex, parentNamespace] of this.parentNamespacesFromRegExp) {
-          if (regex.test(name2)) {
-            debug("attaching namespace %s to parent namespace %s", name2, regex);
+        for (const [regex2, parentNamespace] of this.parentNamespacesFromRegExp) {
+          if (regex2.test(name2)) {
+            debug("attaching namespace %s to parent namespace %s", name2, regex2);
             return parentNamespace.createChild(name2);
           }
         }
@@ -235840,6 +235840,24 @@ var BANNER_LINES = [
 async function printBanner() {
   await printAnimatedLines(BANNER_LINES);
 }
+// ../../node_modules/ansi-regex/index.js
+function ansiRegex({ onlyFirst = false } = {}) {
+  const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
+  const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
+  const csi = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
+  const pattern = `${osc}|${csi}`;
+  return new RegExp(pattern, onlyFirst ? undefined : "g");
+}
+
+// ../../node_modules/strip-ansi/index.js
+var regex = ansiRegex();
+function stripAnsi(string4) {
+  if (typeof string4 !== "string") {
+    throw new TypeError(`Expected a \`string\`, got \`${typeof string4}\``);
+  }
+  return string4.replace(regex, "");
+}
+
 // ../../node_modules/p-wait-for/index.js
 var resolveValue = Symbol("resolveValue");
 var sleep2 = (ms, signal) => new Promise((resolve, reject) => {
@@ -243426,7 +243444,7 @@ var ListFunctionsResponseSchema = exports_external.object({
 var LogLevelSchema = exports_external.enum(["info", "warning", "error", "debug"]);
 var FunctionLogEntrySchema = exports_external.object({
   time: exports_external.string(),
-  level: LogLevelSchema,
+  level: exports_external.preprocess((v) => v === "warn" ? "warning" : !v || v === "log" ? "info" : v, LogLevelSchema),
   message: exports_external.string()
 });
 var FunctionLogsResponseSchema = exports_external.array(FunctionLogEntrySchema);
@@ -251091,6 +251109,35 @@ function showPlainError(error48) {
 }
 
 // src/cli/utils/command/Base44Command.ts
+function writeJsonSuccess(result) {
+  if (result.stdout) {
+    if (result.outroMessage) {
+      process.stderr.write(`${result.outroMessage}
+`);
+    }
+    process.stdout.write(result.stdout);
+    return;
+  }
+  process.stdout.write(`${JSON.stringify({ output: stripAnsi(result.outroMessage ?? "") })}
+`);
+}
+function writeJsonError(error48) {
+  const envelope = {
+    error: error48 instanceof Error ? error48.message : String(error48)
+  };
+  if (isCLIError(error48)) {
+    envelope.code = error48.code;
+    if (error48.details.length > 0) {
+      envelope.details = error48.details;
+    }
+    if (error48.hints.length > 0) {
+      envelope.hints = error48.hints;
+    }
+  }
+  process.stdout.write(`${JSON.stringify(envelope)}
+`);
+}
+
 class Base44Command extends Command {
   _context;
   _commandOptions;
@@ -251113,7 +251160,8 @@ class Base44Command extends Command {
   }
   action(fn) {
     return super.action(async (...args) => {
-      const quiet = this.context.isNonInteractive;
+      const jsonMode = this.context.jsonMode;
+      const quiet = this.context.isNonInteractive || jsonMode;
       if (!quiet) {
         await showCommandStart(this._commandOptions.fullBanner);
       }
@@ -251129,6 +251177,13 @@ class Base44Command extends Command {
         const result = await fn(this.context, ...args) ?? {};
         if (!quiet) {
           await showCommandEnd(result, upgradeCheckPromise, this.context.distribution);
+        } else if (jsonMode) {
+          writeJsonSuccess(result);
+          const upgradeInfo = await upgradeCheckPromise;
+          if (upgradeInfo) {
+            process.stderr.write(`${formatPlainUpgradeMessage(upgradeInfo, this.context.distribution)}
+`);
+          }
         } else {
           if (result.outroMessage) {
             process.stdout.write(`${result.outroMessage}
@@ -251144,7 +251199,9 @@ class Base44Command extends Command {
           }
         }
       } catch (error48) {
-        if (quiet) {
+        if (jsonMode) {
+          writeJsonError(error48);
+        } else if (quiet) {
           showPlainError(error48);
         } else {
           showThemedError(error48, this.context);
@@ -252537,7 +252594,7 @@ function parseScopes(scopes) {
   return (scopes ?? []).flatMap((s) => s.split(",")).map((s) => s.trim()).filter(Boolean);
 }
 async function initiateAction(ctx, options) {
-  const { log, runTask: runTask2, isNonInteractive } = ctx;
+  const { log, runTask: runTask2, isNonInteractive, jsonMode } = ctx;
   const integrationType = parseIntegrationType(options.integrationType);
   const scopes = parseScopes(options.scopes);
   const response = await runTask2(`Initiating ${integrationType} connector`, () => setConnector(integrationType, scopes), {
@@ -252548,6 +252605,18 @@ async function initiateAction(ctx, options) {
     const detail = response.error === "different_user" && response.otherUserEmail ? ` (already authorized by ${response.otherUserEmail})` : response.errorMessage ? ` (${response.errorMessage})` : "";
     throw new InvalidInputError(`Could not initiate ${integrationType}: ${response.error}${detail}`);
   }
+  if (jsonMode) {
+    return {
+      outroMessage: response.alreadyAuthorized ? `${integrationType} already authorized` : `${integrationType} initialized`,
+      stdout: `${JSON.stringify({
+        integrationType,
+        alreadyAuthorized: response.alreadyAuthorized,
+        redirectUrl: response.redirectUrl,
+        connectionId: response.connectionId
+      }, null, 2)}
+`
+    };
+  }
   if (response.alreadyAuthorized || !response.redirectUrl) {
     return {
       outroMessage: `${integrationType} is already authorized. Run 'base44 connectors pull' to fetch its config.`
@@ -252582,7 +252651,8 @@ Examples:
 // src/cli/commands/connectors/list-available.ts
 async function listAvailableAction({
   log,
-  runTask: runTask2
+  runTask: runTask2,
+  jsonMode
 }) {
   const { integrations } = await runTask2("Fetching available integrations from Base44", async () => {
     return await listAvailableIntegrations();
@@ -252590,6 +252660,13 @@ async function listAvailableAction({
     successMessage: "Available integrations fetched successfully",
     errorMessage: "Failed to fetch available integrations"
   });
+  if (jsonMode) {
+    return {
+      outroMessage: `Found ${integrations.length} available integrations.`,
+      stdout: `${JSON.stringify({ integrations }, null, 2)}
+`
+    };
+  }
   if (integrations.length === 0) {
     return { outroMessage: "No available integrations found." };
   }
@@ -252617,7 +252694,7 @@ async function resolveConnectorsDir(options) {
   const { project: project2 } = await readProjectConfig();
   return join19(dirname15(project2.configPath), project2.connectorsDir);
 }
-async function pullConnectorsAction({ log, runTask: runTask2 }, options) {
+async function pullConnectorsAction({ log, runTask: runTask2, jsonMode }, options) {
   const connectorsDir = await resolveConnectorsDir(options);
   const remoteConnectors = await runTask2("Fetching connectors from Base44", async () => {
     return await pullAllConnectors();
@@ -252631,6 +252708,13 @@ async function pullConnectorsAction({ log, runTask: runTask2 }, options) {
     successMessage: "Connector files synced successfully",
     errorMessage: "Failed to sync connector files"
   });
+  if (jsonMode) {
+    return {
+      outroMessage: `Pulled ${remoteConnectors.length} connectors to ${connectorsDir}`,
+      stdout: `${JSON.stringify({ connectorsDir, pulled: remoteConnectors.length, written, deleted }, null, 2)}
+`
+    };
+  }
   if (written.length > 0) {
     log.success(`Written: ${written.join(", ")}`);
   }
@@ -252719,13 +252803,15 @@ function printSummary(results, oauthOutcomes, log) {
     log.error(`Failed: ${r.type} - ${r.error}`);
   }
 }
-async function pushConnectorsAction({ isNonInteractive, log, runTask: runTask2 }, options) {
+async function pushConnectorsAction({ isNonInteractive, log, runTask: runTask2, jsonMode }, options) {
   const connectors = await readConnectorsToPush(options);
-  if (connectors.length === 0) {
-    log.info("No local connectors found - checking for remote connectors to remove");
-  } else {
-    const connectorNames = connectors.map((c3) => c3.type).join(", ");
-    log.info(`Found ${connectors.length} connectors to push: ${connectorNames}`);
+  if (!jsonMode) {
+    if (connectors.length === 0) {
+      log.info("No local connectors found - checking for remote connectors to remove");
+    } else {
+      const connectorNames = connectors.map((c3) => c3.type).join(", ");
+      log.info(`Found ${connectors.length} connectors to push: ${connectorNames}`);
+    }
   }
   const { results } = await runTask2("Pushing connectors to Base44", async () => {
     return await pushConnectors(connectors);
@@ -252739,6 +252825,13 @@ async function pushConnectorsAction({ isNonInteractive, log, runTask: runTask2 }
   if (needsOAuth.length > 0 && !allAuthorized) {
     outroMessage = isNonInteractive ? "Skipped OAuth in non-interactive mode. Run 'base44 connectors push' locally or open the links above to authorize." : "Some connectors still require authorization. Run 'base44 connectors push' or open the links above to authorize.";
   }
+  if (jsonMode) {
+    return {
+      outroMessage,
+      stdout: `${JSON.stringify({ results, oauth: Object.fromEntries(oauthOutcomes) }, null, 2)}
+`
+    };
+  }
   printSummary(results, oauthOutcomes, log);
   return { outroMessage };
 }
@@ -253803,17 +253896,26 @@ var RunCommandResponseSchema = exports_external.object({
   truncated: data.truncated,
   durationMs: data.duration_ms
 }));
-var ReleaseResponseSchema = exports_external.object({
-  app_id: exports_external.string(),
-  released: exports_external.boolean()
+var CreateCheckpointResponseSchema = exports_external.object({
+  checkpoint_id: exports_external.string(),
+  name: exports_external.string().nullable(),
+  git_commit_hash: exports_external.string().nullable()
 }).transform((data) => ({
-  appId: data.app_id,
-  released: data.released
+  checkpointId: data.checkpoint_id,
+  name: data.name,
+  gitCommitHash: data.git_commit_hash
 }));
 
 // src/core/resources/sandbox/api.ts
+function isMissingSandboxScope(error48) {
+  if (error48.statusCode !== 401 && error48.statusCode !== 403) {
+    return false;
+  }
+  const text = `${error48.message} ${JSON.stringify(error48.responseBody ?? "")}`;
+  return /sandbox:write/i.test(text) || /granting sandbox access/i.test(text);
+}
 function withSandboxAuthHint(error48) {
-  if (error48.statusCode !== 403) {
+  if (!isMissingSandboxScope(error48)) {
     return error48;
   }
   return new ApiError(error48.message, {
@@ -253827,7 +253929,7 @@ function withSandboxAuthHint(error48) {
     hints: [
       ...error48.hints,
       {
-        message: "If you have admin access to this app, your login may predate sandbox support — run 'base44 login' again to grant sandbox access.",
+        message: "Run 'base44 login' again to grant sandbox access (the sandbox:write scope is only granted at login).",
         command: "base44 login"
       }
     ],
@@ -253866,8 +253968,8 @@ function grep(appId, params) {
 function runCommand(appId, params) {
   return callTool(appId, "run_command", { ...params }, RunCommandResponseSchema, "running command", false);
 }
-function releaseSession(appId) {
-  return callTool(appId, "release", {}, ReleaseResponseSchema, "releasing sandbox session");
+function createCheckpoint(appId, params) {
+  return callTool(appId, "create_checkpoint", { ...params }, CreateCheckpointResponseSchema, "creating checkpoint");
 }
 
 // src/cli/commands/sandbox/shared.ts
@@ -253895,6 +253997,19 @@ function parsePositiveInt(value, flagName) {
   return n2;
 }
 
+// src/cli/commands/sandbox/checkpoint.ts
+async function checkpointAction({ runTask: runTask2 }, options) {
+  const { id: appId } = getAppContext();
+  const result = await runTask2("Creating checkpoint", () => createCheckpoint(appId, { name: options.name }));
+  return { outroMessage: "Created checkpoint", stdout: toJsonStdout(result) };
+}
+function getSandboxCheckpointCommand() {
+  return new Base44Command("checkpoint").description("Create a restore-point checkpoint of an app's remote sandbox").option("--name <name>", "Optional message/title for the checkpoint (defaults to an auto-generated title)").addHelpText("after", `
+Examples:
+  $ base44 sandbox checkpoint
+  $ base44 sandbox checkpoint --name "before refactor"`).action(checkpointAction);
+}
+
 // src/cli/commands/sandbox/edit-file.ts
 var EditsInputSchema = exports_external.array(exports_external.object({
   old_text: exports_external.string().min(1),
@@ -253925,12 +254040,12 @@ async function editFileAction({ runTask: runTask2 }, path17, options) {
   };
 }
 function getSandboxEditFileCommand() {
-  return new Base44Command("edit-file").description("Apply exact old→new string edits to a file in the sandbox").argument("<path>", "File path relative to the app root").option("--edits-json <json>", "JSON array of edits (if omitted, read from stdin)").option("--dry-run", "Return the unified diff without writing").addHelpText("after", `
+  return new Base44Command("edit").description("Apply exact old→new string edits to a file in the sandbox").argument("<path>", "File path relative to the app root").option("--edits-json <json>", "JSON array of edits (if omitted, read from stdin)").option("--dry-run", "Return the unified diff without writing").addHelpText("after", `
 Each edit is { "old_text": "...", "new_text": "...", "replace_all"?: true }.
 
 Examples:
-  $ echo '[{"old_text":"foo","new_text":"bar"}]' | base44 sandbox edit-file src/x.ts
-  $ base44 sandbox edit-file src/x.ts --dry-run --edits-json '[{"old_text":"a","new_text":"b","replace_all":true}]'`).action(editFileAction);
+  $ echo '[{"old_text":"foo","new_text":"bar"}]' | base44 sandbox edit src/x.ts
+  $ base44 sandbox edit src/x.ts --dry-run --edits-json '[{"old_text":"a","new_text":"b","replace_all":true}]'`).action(editFileAction);
 }
 
 // src/cli/commands/sandbox/grep.ts
@@ -253964,7 +254079,7 @@ async function listDirectoryAction({ runTask: runTask2 }, path17, options) {
   return { outroMessage: "Listed directory", stdout: toJsonStdout(result) };
 }
 function getSandboxListDirectoryCommand() {
-  return new Base44Command("list-directory").description("List directory entries in an app's remote sandbox").argument("[path]", "Directory relative to the app root (default: app root)").option("--recursive", "List nested entries").option("--max-depth <n>", "Max depth when recursive (1-10, default 3)").option("--include-hidden", "Include dotfiles").action(listDirectoryAction);
+  return new Base44Command("ls").description("List directory entries in an app's remote sandbox").argument("[path]", "Directory relative to the app root (default: app root)").option("--recursive", "List nested entries").option("--max-depth <n>", "Max depth when recursive (1-10, default 3)").option("--include-hidden", "Include dotfiles").action(listDirectoryAction);
 }
 
 // src/cli/commands/sandbox/read-file.ts
@@ -253976,22 +254091,7 @@ async function readFileAction({ runTask: runTask2 }, paths, options) {
   return { outroMessage: "Read file", stdout: toJsonStdout(result) };
 }
 function getSandboxReadFileCommand() {
-  return new Base44Command("read-file").description("Read file contents from an app's remote sandbox").argument("<paths...>", "One or more file paths relative to the app root").option("--offset <n>", "1-based start line").option("--limit <n>", "Max lines to return from offset").action(readFileAction);
-}
-
-// src/cli/commands/sandbox/release.ts
-async function releaseAction({
-  runTask: runTask2
-}) {
-  const { id: appId } = getAppContext();
-  const result = await runTask2("Releasing sandbox session", () => releaseSession(appId));
-  return {
-    outroMessage: "Released sandbox session",
-    stdout: toJsonStdout(result)
-  };
-}
-function getSandboxReleaseCommand() {
-  return new Base44Command("release").description("Release the external-agent session so the in-app builder can resume").action(releaseAction);
+  return new Base44Command("read").description("Read file contents from an app's remote sandbox").argument("<paths...>", "One or more file paths relative to the app root").option("--offset <n>", "1-based start line").option("--limit <n>", "Max lines to return from offset").action(readFileAction);
 }
 
 // src/cli/commands/sandbox/run-command.ts
@@ -254003,10 +254103,10 @@ async function runCommandAction({ runTask: runTask2 }, commandParts, options) {
   return { outroMessage: "Ran command", stdout: toJsonStdout(result) };
 }
 function getSandboxRunCommandCommand() {
-  return new Base44Command("run-command").description("Run a shell command in an app's remote sandbox").argument("<command...>", "Shell command to execute (quote to keep as one)").option("--cwd <path>", "Working directory relative to the app root").option("--timeout-ms <n>", "Timeout in milliseconds (default 120000, max 600000)").addHelpText("after", `
+  return new Base44Command("run").description("Run a shell command in an app's remote sandbox").argument("<command...>", "Shell command to execute (quote to keep as one)").option("--cwd <path>", "Working directory relative to the app root").option("--timeout-ms <n>", "Timeout in milliseconds (default 120000, max 600000)").addHelpText("after", `
 Examples:
-  $ base44 sandbox run-command "npm test"
-  $ base44 sandbox run-command ls -la --cwd src`).action(runCommandAction);
+  $ base44 sandbox run "npm test"
+  $ base44 sandbox run ls -la --cwd src`).action(runCommandAction);
 }
 
 // src/cli/commands/sandbox/write-file.ts
@@ -254017,15 +254117,15 @@ async function writeFileAction({ runTask: runTask2 }, path17, options) {
   return { outroMessage: "Wrote file", stdout: toJsonStdout(result) };
 }
 function getSandboxWriteFileCommand() {
-  return new Base44Command("write-file").description("Create or overwrite a file in an app's remote sandbox").argument("<path>", "File path relative to the app root").option("--content <content>", "File content (if omitted, read from stdin)").option("--overwrite", "Overwrite the file if it already exists").addHelpText("after", `
+  return new Base44Command("write").description("Create or overwrite a file in an app's remote sandbox").argument("<path>", "File path relative to the app root").option("--content <content>", "File content (if omitted, read from stdin)").option("--overwrite", "Overwrite the file if it already exists").addHelpText("after", `
 Examples:
-  $ echo "hello" | base44 sandbox write-file notes.txt
-  $ base44 sandbox write-file notes.txt --content "hello" --overwrite`).action(writeFileAction);
+  $ echo "hello" | base44 sandbox write notes.txt
+  $ base44 sandbox write notes.txt --content "hello" --overwrite`).action(writeFileAction);
 }
 
 // src/cli/commands/sandbox/index.ts
 function getSandboxCommand() {
-  return new Command("sandbox").description("Develop an app remotely via its server-side sandbox").addCommand(getSandboxListDirectoryCommand()).addCommand(getSandboxReadFileCommand()).addCommand(getSandboxWriteFileCommand()).addCommand(getSandboxEditFileCommand()).addCommand(getSandboxGrepCommand()).addCommand(getSandboxRunCommandCommand()).addCommand(getSandboxReleaseCommand());
+  return new Command("sandbox").description("Develop an app remotely via its server-side sandbox").addCommand(getSandboxListDirectoryCommand()).addCommand(getSandboxReadFileCommand()).addCommand(getSandboxWriteFileCommand()).addCommand(getSandboxEditFileCommand()).addCommand(getSandboxGrepCommand()).addCommand(getSandboxRunCommandCommand()).addCommand(getSandboxCheckpointCommand());
 }
 
 // src/cli/commands/secrets/delete.ts
@@ -258073,7 +258173,7 @@ function getEjectCommand() {
 // src/cli/program.ts
 function createProgram(context) {
   const program2 = new Command;
-  program2.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(package_default.version).addOption(new Option("--app-id <id>", "Base44 app ID to use").env(BASE44_APP_ID_ENV_VAR));
+  program2.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(package_default.version).addOption(new Option("--app-id <id>", "Base44 app ID to use").env(BASE44_APP_ID_ENV_VAR)).addOption(new Option("--json", "Output machine-readable JSON to stdout (status/logs go to stderr)"));
   program2.configureHelp({
     sortSubcommands: true
   });
@@ -261324,9 +261424,9 @@ function matchPropertyGroup(propertyGroup, propertyValues, cohortProperties, deb
     throw new InconclusiveMatchError("can't match cohort without a given cohort property value");
   return propertyGroupType === "AND";
 }
-function isValidRegex(regex) {
+function isValidRegex(regex2) {
   try {
-    new RegExp(regex);
+    new RegExp(regex2);
     return true;
   } catch (err) {
     return false;
@@ -261344,8 +261444,8 @@ function convertToDateTime(value) {
   throw new InconclusiveMatchError(`The date provided ${value} must be a string, number, or date object`);
 }
 function relativeDateParseForFeatureFlagMatching(value) {
-  const regex = /^-?(?<number>[0-9]+)(?<interval>[a-z])$/;
-  const match = value.match(regex);
+  const regex2 = /^-?(?<number>[0-9]+)(?<interval>[a-z])$/;
+  const match = value.match(regex2);
   const parsedDt = new Date(new Date().toISOString());
   if (!match)
     return null;
@@ -262314,12 +262414,14 @@ async function runCLI(options8) {
   ensureNpmAssets(join28(__dirname4, "../assets"));
   const errorReporter = new ErrorReporter;
   errorReporter.registerProcessErrorHandlers();
-  const isNonInteractive = !process.stdin.isTTY || !process.stdout.isTTY;
+  const jsonMode = process.argv.includes("--json");
+  const isNonInteractive = !process.stdin.isTTY || !process.stdout.isTTY || jsonMode;
   const log = isNonInteractive ? new SimpleLogger : new ClackLogger;
   const runTask2 = isNonInteractive ? createSimpleRunTask(log) : createInteractiveRunTask();
   const context = {
     errorReporter,
     isNonInteractive,
+    jsonMode,
     distribution: options8?.distribution ?? "npm",
     log,
     runTask: runTask2
@@ -262348,4 +262450,4 @@ export {
   CLIExitError
 };
 
-//# debugId=99691B3EA78ED95C64756E2164756E21
+//# debugId=C107ED30593A378964756E2164756E21