lua-cli 3.17.4 → 3.17.6

package/dist/index.js

@@ -2991,10 +2991,14 @@ var init_analytics = __esm({
 function writeInfo(message) {
   process.stdout.write("\r\x1B[K" + message + "\n");
 }
+function writeProgress(message) {
+  process.stderr.write("\r\x1B[K" + message);
+}
 var init_write_info = __esm({
   "src/utils/write-info.ts"() {
     "use strict";
     __name(writeInfo, "writeInfo");
+    __name(writeProgress, "writeProgress");
   }
 });
 
@@ -3134,9 +3138,6 @@ function clearPromptLines(count = 1) {
     process.stdout.write("\x1B[1A\x1B[2K");
   }
 }
-function writeProgress(message) {
-  process.stdout.write("\r\x1B[K" + message);
-}
 function writeSuccess(message) {
   process.stdout.write("\r\x1B[K" + message + "\n");
 }
@@ -3159,7 +3160,6 @@ var init_cli = __esm({
     __name(showUpdateWarningIfNeeded, "showUpdateWarningIfNeeded");
     __name(withErrorHandling, "withErrorHandling");
     __name(clearPromptLines, "clearPromptLines");
-    __name(writeProgress, "writeProgress");
     __name(writeSuccess, "writeSuccess");
     __name(writeError, "writeError");
   }
@@ -13628,6 +13628,16 @@ var init_mcp_server_handler = __esm({
 // src/index.ts
 import { Command } from "commander";
 
+// src/cli/parse-agent-version.ts
+import { InvalidArgumentError } from "commander";
+function parseAgentVersionFlag(value) {
+  if (!/^\d+$/.test(value) || Number(value) < 1) {
+    throw new InvalidArgumentError("--agent-version must be a positive integer (the version number to preview).");
+  }
+  return Number(value);
+}
+__name(parseAgentVersionFlag, "parseAgentVersionFlag");
+
 // src/commands/configure.ts
 init_cli();
 
@@ -24863,6 +24873,74 @@ async function pushProcessorsToSandbox(apiKey, agentId, manifest, yamlConfig, is
 }
 __name(pushProcessorsToSandbox, "pushProcessorsToSandbox");
 
+// src/api/agent-version.api.service.ts
+init_http_client();
+var AgentVersionApi = class extends HttpClient {
+  static {
+    __name(this, "AgentVersionApi");
+  }
+  apiKey;
+  agentId;
+  constructor(baseUrl, apiKey, agentId) {
+    super(baseUrl);
+    this.apiKey = apiKey;
+    this.agentId = agentId;
+  }
+  get basePath() {
+    return `/developer/agents/${encodeURIComponent(this.agentId)}`;
+  }
+  get authHeader() {
+    return {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // Version CRUD
+  // ---------------------------------------------------------------------------
+  async createVersion(body) {
+    return this.httpPost(`${this.basePath}/versions`, body, this.authHeader);
+  }
+  async listVersions(query) {
+    const params = new URLSearchParams();
+    if (query?.all !== void 0) params.append("all", String(query.all));
+    if (query?.limit !== void 0) params.append("limit", String(query.limit));
+    if (query?.status !== void 0) params.append("status", query.status);
+    const qs = params.toString();
+    const url = qs ? `${this.basePath}/versions?${qs}` : `${this.basePath}/versions`;
+    return this.httpGet(url, this.authHeader);
+  }
+  async getVersion(version) {
+    return this.httpGet(`${this.basePath}/versions/${version}`, this.authHeader);
+  }
+  async deleteVersion(version) {
+    return this.httpDelete(`${this.basePath}/versions/${version}`, this.authHeader);
+  }
+  // ---------------------------------------------------------------------------
+  // Diff
+  // ---------------------------------------------------------------------------
+  async diffVersions(from, to) {
+    const url = `${this.basePath}/versions/diff?from=${from}&to=${to}`;
+    return this.httpGet(url, this.authHeader);
+  }
+  // ---------------------------------------------------------------------------
+  // Promote
+  // ---------------------------------------------------------------------------
+  async promoteVersion(version) {
+    return this.httpPost(`${this.basePath}/versions/${version}/promote`, {}, this.authHeader);
+  }
+  // ---------------------------------------------------------------------------
+  // Patch commit hash — called by `lua version create` after a successful git
+  // commit + tag to propagate the SHA to the backend AgentVersion record.
+  // Failure is non-fatal; the version snapshot is valid whether or not this
+  // PATCH lands.
+  // ---------------------------------------------------------------------------
+  async patchCommitHash(version, commitHash) {
+    return this.httpPatch(`${this.basePath}/versions/${version}/commit-hash`, {
+      commitHash
+    }, this.authHeader);
+  }
+};
+
 // src/commands/chat.ts
 init_constants();
 
@@ -25162,6 +25240,14 @@ async function chatCommand(cmdObj) {
     const delay = parseInt(cmdObj?.delay || "100", 10);
     const env = cmdObj?.env || null;
     const autoClear = !!cmdObj?.clear || !!cmdObj?.clearThread;
+    const rawVersion = cmdObj?.agentVersion;
+    let previewVersion;
+    if (rawVersion != null) {
+      if (!Number.isInteger(rawVersion) || rawVersion < 1) {
+        throw new Error("--agent-version must be a positive integer (the version number to preview).");
+      }
+      previewVersion = rawVersion;
+    }
     const rawThread = cmdObj?.thread;
     let threadId;
     if (rawThread === true) {
@@ -25170,48 +25256,68 @@ async function chatCommand(cmdObj) {
       threadId = rawThread;
     }
     const { config, agentId, apiKey } = await initializeCommand();
+    if (previewVersion != null) {
+      const versionApi = new AgentVersionApi(BASE_URLS.API, apiKey, agentId);
+      const versionResponse = await versionApi.getVersion(previewVersion);
+      if (!versionResponse.success) {
+        throw new Error(`Agent version v${previewVersion} not found.`);
+      }
+      writeInfo(`\u{1F50E} Previewing agent version v${previewVersion} in an isolated thread (not promoted) \u2026`);
+    }
     let selectedEnvironment;
-    const envResolution = resolveChatEnvironment(env, !!(message || batch));
-    switch (envResolution.type) {
-      case "resolved":
-        selectedEnvironment = envResolution.environment;
-        break;
-      case "default_sandbox":
-        console.log(`
+    let envResolutionType;
+    if (previewVersion != null) {
+      if (env != null && env !== "production") {
+        throw new Error(`--agent-version previews a server-stored version and only runs against production (got --env ${env}). Remove --env or pass --env production.`);
+      }
+      selectedEnvironment = "production";
+      envResolutionType = "preview_forced_production";
+    } else {
+      const envResolution = resolveChatEnvironment(env, !!(message || batch));
+      envResolutionType = envResolution.type;
+      switch (envResolution.type) {
+        case "resolved":
+          selectedEnvironment = envResolution.environment;
+          break;
+        case "default_sandbox":
+          console.log(`
 \u2139\uFE0F  No --env provided, defaulting to sandbox. Use --env production for production.
 `);
-        selectedEnvironment = envResolution.environment;
-        break;
-      case "prompt":
-        const { environment } = await inquirer9.prompt([
-          {
-            type: "list",
-            name: "environment",
-            message: "Select environment:",
-            choices: [
-              {
-                name: "\u{1F527} Sandbox (Agent will execute skills etc from your local machine)",
-                value: "sandbox"
-              },
-              {
-                name: "\u{1F680} Production (Agent will execute latest version of skills etc)",
-                value: "production"
-              }
-            ]
-          }
-        ]);
-        selectedEnvironment = environment;
-        break;
-      case "error":
-        console.log(`\u274C ${envResolution.message}`);
-        throw new Error(`${envResolution.message}`);
+          selectedEnvironment = envResolution.environment;
+          break;
+        case "prompt": {
+          const { environment } = await inquirer9.prompt([
+            {
+              type: "list",
+              name: "environment",
+              message: "Select environment:",
+              choices: [
+                {
+                  name: "\u{1F527} Sandbox (Agent will execute skills etc from your local machine)",
+                  value: "sandbox"
+                },
+                {
+                  name: "\u{1F680} Production (Agent will execute latest version of skills etc)",
+                  value: "production"
+                }
+              ]
+            }
+          ]);
+          selectedEnvironment = environment;
+          break;
+        }
+        case "error":
+          console.log(`\u274C ${envResolution.message}`);
+          throw new Error(`${envResolution.message}`);
+      }
     }
     let chatEnv = {
       type: selectedEnvironment,
       agentId,
       apiKey,
       threadId,
-      autoClear
+      autoClear,
+      previewVersion
     };
     if (selectedEnvironment === "sandbox") {
       writeInfo("\u{1F4A1} Sandbox mode: uses your locally compiled code \u2014 no lua push needed.");
@@ -25224,11 +25330,12 @@ async function chatCommand(cmdObj) {
     trackEvent("cli_chat_started", {
       environment: selectedEnvironment,
       non_interactive_message: !!message,
-      env_resolution_type: envResolution.type,
+      env_resolution_type: envResolutionType,
       has_preprocessor_overrides: (chatEnv.preprocessorOverrides?.length || 0) > 0,
       has_postprocessor_overrides: (chatEnv.postprocessorOverrides?.length || 0) > 0,
       has_thread_id: !!chatEnv.threadId,
-      auto_clear: chatEnv.autoClear || false
+      auto_clear: chatEnv.autoClear || false,
+      preview_version: chatEnv.previewVersion ?? null
     });
     const probeWindow = {
       value: (/* @__PURE__ */ new Date()).toISOString()
@@ -25477,6 +25584,9 @@ async function sendSandboxMessageStream(chatEnv, messages, callbacks) {
   if (chatEnv.threadId) {
     chatRequest.threadId = chatEnv.threadId;
   }
+  if (chatEnv.previewVersion != null) {
+    chatRequest.version = chatEnv.previewVersion;
+  }
   const chatApi = new ChatApi(BASE_URLS.CHAT, chatEnv.apiKey);
   await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, callbacks.onChunk, callbacks.onPostprocessComplete, callbacks.onPreprocessorBlocked, callbacks.onBatchAbort, callbacks.onBatchHandled);
 }
@@ -25492,6 +25602,9 @@ async function sendProductionMessageStream(chatEnv, messages, callbacks) {
   if (chatEnv.threadId) {
     chatRequest.threadId = chatEnv.threadId;
   }
+  if (chatEnv.previewVersion != null) {
+    chatRequest.version = chatEnv.previewVersion;
+  }
   const chatApi = new ChatApi(BASE_URLS.CHAT, chatEnv.apiKey);
   await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, callbacks.onChunk, callbacks.onPostprocessComplete, callbacks.onPreprocessorBlocked, callbacks.onBatchAbort, callbacks.onBatchHandled);
 }
@@ -41706,76 +41819,6 @@ __name(defaultRestore, "defaultRestore");
 init_cli();
 init_command_utils();
 init_analytics();
-
-// src/api/agent-version.api.service.ts
-init_http_client();
-var AgentVersionApi = class extends HttpClient {
-  static {
-    __name(this, "AgentVersionApi");
-  }
-  apiKey;
-  agentId;
-  constructor(baseUrl, apiKey, agentId) {
-    super(baseUrl);
-    this.apiKey = apiKey;
-    this.agentId = agentId;
-  }
-  get basePath() {
-    return `/developer/agents/${encodeURIComponent(this.agentId)}`;
-  }
-  get authHeader() {
-    return {
-      Authorization: `Bearer ${this.apiKey}`
-    };
-  }
-  // ---------------------------------------------------------------------------
-  // Version CRUD
-  // ---------------------------------------------------------------------------
-  async createVersion(body) {
-    return this.httpPost(`${this.basePath}/versions`, body, this.authHeader);
-  }
-  async listVersions(query) {
-    const params = new URLSearchParams();
-    if (query?.all !== void 0) params.append("all", String(query.all));
-    if (query?.limit !== void 0) params.append("limit", String(query.limit));
-    if (query?.status !== void 0) params.append("status", query.status);
-    const qs = params.toString();
-    const url = qs ? `${this.basePath}/versions?${qs}` : `${this.basePath}/versions`;
-    return this.httpGet(url, this.authHeader);
-  }
-  async getVersion(version) {
-    return this.httpGet(`${this.basePath}/versions/${version}`, this.authHeader);
-  }
-  async deleteVersion(version) {
-    return this.httpDelete(`${this.basePath}/versions/${version}`, this.authHeader);
-  }
-  // ---------------------------------------------------------------------------
-  // Diff
-  // ---------------------------------------------------------------------------
-  async diffVersions(from, to) {
-    const url = `${this.basePath}/versions/diff?from=${from}&to=${to}`;
-    return this.httpGet(url, this.authHeader);
-  }
-  // ---------------------------------------------------------------------------
-  // Promote
-  // ---------------------------------------------------------------------------
-  async promoteVersion(version) {
-    return this.httpPost(`${this.basePath}/versions/${version}/promote`, {}, this.authHeader);
-  }
-  // ---------------------------------------------------------------------------
-  // Patch commit hash — called by `lua version create` after a successful git
-  // commit + tag to propagate the SHA to the backend AgentVersion record.
-  // Failure is non-fatal; the version snapshot is valid whether or not this
-  // PATCH lands.
-  // ---------------------------------------------------------------------------
-  async patchCommitHash(version, commitHash) {
-    return this.httpPatch(`${this.basePath}/versions/${version}/commit-hash`, {
-      commitHash
-    }, this.authHeader);
-  }
-};
-
-// src/commands/version.ts
 init_files();
 init_constants();
 
@@ -41855,8 +41898,37 @@ async function versionCreateCommand(options = {}) {
   }, "version create");
 }
 __name(versionCreateCommand, "versionCreateCommand");
+function formatVersionTable(rows) {
+  const header = {
+    version: "VERSION",
+    status: "STATUS",
+    created: "CREATED",
+    by: "BY",
+    message: "MESSAGE"
+  };
+  const cols = [
+    "version",
+    "status",
+    "created",
+    "by",
+    "message"
+  ];
+  const widths = {};
+  for (const c of cols) {
+    widths[c] = Math.max(header[c].length, ...rows.map((r) => r[c].length));
+  }
+  const fmt = /* @__PURE__ */ __name((r) => cols.map((c) => r[c].padEnd(widths[c])).join("  ").trimEnd(), "fmt");
+  return [
+    fmt(header),
+    ...rows.map(fmt)
+  ];
+}
+__name(formatVersionTable, "formatVersionTable");
 async function versionListCommand(options = {}) {
   return withErrorHandling(async () => {
+    if (options.limit != null && (!Number.isInteger(options.limit) || options.limit < 1)) {
+      throw new Error(`--limit must be a positive integer (got ${options.limit}).`);
+    }
     const { apiKey, agentId } = await initializeCommand();
     const query = {};
     if (options.all) query.all = true;
@@ -41869,18 +41941,29 @@ async function versionListCommand(options = {}) {
     }
     const versions = response.data;
     if (options.json) {
-      console.log(JSON.stringify(versions, null, 2));
+      const summary = versions.map((v) => ({
+        version: v.version,
+        status: v.status,
+        message: v.message,
+        createdBy: v.createdBy,
+        createdByEmail: v.createdByEmail,
+        createdAt: v.createdAt,
+        commitHash: v.commitHash,
+        sourceManifestVersion: v.sourceManifestVersion
+      }));
+      console.log(JSON.stringify(summary, null, 2));
     } else if (versions.length === 0) {
       writeInfo("(no versions yet \u2014 run `lua version create` to make one)");
     } else {
-      console.log("VERSION    STATUS       CREATED              BY         MESSAGE");
-      for (const v of versions) {
-        const star = v.status === "active" ? "*" : " ";
-        const date = new Date(v.createdAt).toISOString().slice(0, 16).replace("T", " ");
-        const status = v.status.padEnd(11);
-        const by = (v.createdBy || "").slice(0, 10).padEnd(10);
-        const msg = (v.message || "").slice(0, 60);
-        console.log(`v${v.version}${star}    ${status} ${date}  ${by}${msg}`);
+      const rows = versions.map((v) => ({
+        version: `v${v.version}${v.status === "active" ? "*" : ""}`,
+        status: v.status,
+        created: new Date(v.createdAt).toISOString().slice(0, 16).replace("T", " "),
+        by: v.createdByEmail || (v.createdBy ? `${v.createdBy.slice(0, 8)}\u2026` : ""),
+        message: (v.message || "").slice(0, 60)
+      }));
+      for (const line of formatVersionTable(rows)) {
+        console.log(line);
       }
     }
     trackEvent("cli_version_list_completed", {
@@ -41915,7 +41998,8 @@ async function versionShowCommand(versionArg, options = {}) {
       console.log(`    Preprocessors:  ${v.snapshot.preprocessors.length}`);
       console.log(`    Postprocessors: ${v.snapshot.postprocessors.length}`);
       console.log(`    MCP servers:    ${v.snapshot.mcpServers.length}`);
-      console.log(`    Persona:        ${v.snapshot.persona.versionId || "(none)"}`);
+      const personaLabel = v.snapshot.persona.version != null ? `v${v.snapshot.persona.version}` : v.snapshot.persona.versionId || "(none)";
+      console.log(`    Persona:        ${personaLabel}`);
     }
     trackEvent("cli_version_show_completed", {
       version,
@@ -41939,6 +42023,7 @@ async function versionDiffCommand(fromArg, toArg, options = {}) {
       console.log(JSON.stringify(diff, null, 2));
     } else {
       console.log(`Diff v${from} \u2192 v${to}`);
+      const label = /* @__PURE__ */ __name((item, fallback) => item.name ?? fallback, "label");
       const sections = [
         {
           name: "Skills",
@@ -41974,25 +42059,31 @@ async function versionDiffCommand(fromArg, toArg, options = {}) {
         }
         console.log(`${name}:`);
         for (const a of entry.added) {
-          console.log(`  + ${a[key]}@${a.version} (added)`);
+          console.log(`  + ${label(a, a[key])}@${a.version} (added)`);
         }
         for (const r of entry.removed) {
-          console.log(`  - ${r[key]}@${r.version} (removed)`);
+          console.log(`  - ${label(r, r[key])}@${r.version} (removed)`);
         }
         for (const c of entry.changed) {
-          console.log(`  ~ ${c[key]} ${c.from.version} \u2192 ${c.to.version}`);
+          console.log(`  ~ ${label(c, c[key])} ${c.from.version} \u2192 ${c.to.version}`);
         }
       }
       const mcp = diff.mcpServers;
       if (mcp.added.length || mcp.removed.length || mcp.changed.length) {
         console.log("MCP servers:");
-        mcp.added.forEach((m) => console.log(`  + ${m.id} (added)`));
-        mcp.removed.forEach((m) => console.log(`  - ${m.id} (removed)`));
-        mcp.changed.forEach((m) => console.log(`  ~ ${m.id} (config changed)`));
+        mcp.added.forEach((m) => console.log(`  + ${label(m, m.id)} (added)`));
+        mcp.removed.forEach((m) => console.log(`  - ${label(m, m.id)} (removed)`));
+        mcp.changed.forEach((m) => console.log(`  ~ ${label(m, m.id)} (config changed${m.changedFields?.length ? `: ${m.changedFields.join(", ")}` : ""})`));
       } else {
         console.log("MCP servers: (no changes)");
       }
-      console.log(`Persona: ${diff.persona ? `${diff.persona.from} \u2192 ${diff.persona.to}` : "(unchanged)"}`);
+      if (!diff.persona) {
+        console.log("Persona: (unchanged)");
+      } else if (diff.persona.fromVersion != null && diff.persona.toVersion != null) {
+        console.log(`Persona: v${diff.persona.fromVersion} \u2192 v${diff.persona.toVersion}`);
+      } else {
+        console.log(`Persona: ${diff.persona.from} \u2192 ${diff.persona.to}`);
+      }
       console.log(`Model: ${diff.model ? `${diff.model.from} \u2192 ${diff.model.to}` : "(unchanged)"}`);
     }
     trackEvent("cli_version_diff_completed", {
@@ -42594,7 +42685,7 @@ Examples:
   $ lua deploy skill --name mySkill --set-version 1.0.5 --force      Deploy specific version
   $ lua deploy webhook --name myWebhook --set-version latest --force  Deploy latest webhook version
 `).action(deployCommand);
-  const chatCmd = program2.command("chat").description("\u{1F4AC} Interactive chat with your agent").option("-e, --env <environment>", "Environment: sandbox or production").option("-m, --message <text>", "Message to send (non-interactive mode)").option("-b, --batch <messages...>", "Send multiple messages concurrently to test batching").option("-d, --delay <ms>", "Delay between batch messages in ms (default: 100)").option("-t, --thread [id]", "Thread ID for conversation scoping. If no ID is provided, a UUID is auto-generated. Displayed at session start so you can reuse it later.").option("--clear", "Automatically clear chat history when session ends (clears thread if -t is used, otherwise clears all history)").option("--clear-thread", "Alias for --clear").addHelpText("after", `
+  const chatCmd = program2.command("chat").description("\u{1F4AC} Interactive chat with your agent").option("-e, --env <environment>", "Environment: sandbox or production").option("-m, --message <text>", "Message to send (non-interactive mode)").option("-b, --batch <messages...>", "Send multiple messages concurrently to test batching").option("-d, --delay <ms>", "Delay between batch messages in ms (default: 100)").option("-t, --thread [id]", "Thread ID for conversation scoping. If no ID is provided, a UUID is auto-generated. Displayed at session start so you can reuse it later.").option("--clear", "Automatically clear chat history when session ends (clears thread if -t is used, otherwise clears all history)").option("--clear-thread", "Alias for --clear").option("--agent-version <n>", "Preview a specific (unpromoted) agent version in an isolated thread", parseAgentVersionFlag).addHelpText("after", `
 Examples:
   $ lua chat                                     Start interactive chat session
   $ lua chat clear                               Clear all conversation history
@@ -42607,6 +42698,7 @@ Examples:
   $ lua chat -t my-test --clear                  Chat in "my-test" thread, clear on exit
   $ lua chat -m "test" -t my-test --clear        Non-interactive: isolated thread, clear after
   $ lua chat -b "Hello" "What is the weather?" "Tell me a joke" -d 2000 -e sandbox  Batch test
+  $ lua chat --agent-version 3 -m "test"         Preview agent version 3 in an isolated thread
 `).action(chatCommand);
   chatCmd.command("clear").description("Clear conversation history").option("--user <identifier>", "User ID, email, or mobile number of the user whose history to clear").option("-t, --thread <id>", "Clear a specific thread's history instead of all history").option("--force", "Skip confirmation prompt").addHelpText("after", `
 Examples:
@@ -43038,7 +43130,7 @@ Examples:
   $ lua version create -m "Add FAQ skill"      Include a description
   $ lua version create --auto-push             Push then snapshot in one step
 `).action((opts) => versionCreateCommand(opts));
-  versionGroup.command("list").description("List versions of the current agent").option("--all", "Show all versions (no server-side cap)").option("--limit <n>", "Cap output to this many entries", (v) => parseInt(v, 10)).option("--status <status>", "Filter by status: active | staged | all", "all").option("--json", "Output as JSON").addHelpText("after", `
+  versionGroup.command("list").description("List versions of the current agent").option("--all", "Show all versions (no server-side cap)").option("--limit <n>", "Cap output to this many entries", (v) => parseInt(v, 10)).option("--status <status>", "Filter by status: active | staged | superseded | deleted | all", "all").option("--json", "Output as JSON").addHelpText("after", `
 Examples:
   $ lua version list                     List all versions (default)
   $ lua version list --status active     Show only active versions