lua-cli 3.18.0 → 3.20.0

package/dist/index.js

@@ -868,6 +868,15 @@ function aiGenerateInputFromSimplified(prompt, content) {
     ]
   };
 }
+function isAllowedReviewableExecuteTool(tool) {
+  return REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST.includes(tool);
+}
+function isReviewableMcpSendTool(tool) {
+  return tool.length > REVIEWABLE_MCP_SEND_TOOL_SUFFIX.length && tool.endsWith(REVIEWABLE_MCP_SEND_TOOL_SUFFIX);
+}
+function isReviewableExecuteTool(tool) {
+  return isAllowedReviewableExecuteTool(tool) || isReviewableMcpSendTool(tool);
+}
 function isInteractiveChannel(channel) {
   if (!channel) return true;
   return !NON_INTERACTIVE_CHANNELS.includes(channel);
@@ -883,6 +892,85 @@ function transformChatHistoryContentParts(parts) {
   const content = [];
   for (const rawPart of parts ?? []) {
     const part = rawPart;
+    if (part?.type === "reasoning") {
+      const detailsText = Array.isArray(part.details) ? part.details.filter((d) => d?.type === "text" && typeof d.text === "string").map((d) => d.text).join("") : "";
+      const reasoningText = [
+        part.reasoning,
+        detailsText,
+        part.text
+      ].find((v) => typeof v === "string" && v.trim().length > 0) ?? "";
+      if (reasoningText) content.push({
+        type: "reasoning",
+        text: reasoningText
+      });
+      continue;
+    }
+    if (part?.type === "tool-invocation") {
+      const inv = part.toolInvocation;
+      if (typeof inv?.toolName === "string" && inv.toolName.length > 0) {
+        content.push({
+          type: "tool",
+          toolName: inv.toolName,
+          toolCallId: inv.toolCallId,
+          input: inv.args,
+          output: inv.result,
+          toolState: inv.state
+        });
+      }
+      continue;
+    }
+    if (part?.type === "source") {
+      const src = part.source;
+      if (src?.sourceType === "document") {
+        content.push({
+          type: "source-document",
+          sourceId: src.id,
+          mediaType: src.mediaType,
+          title: src.title,
+          filename: src.filename,
+          providerMetadata: src.providerMetadata
+        });
+      } else if (typeof src?.url === "string" && src.url.length > 0) {
+        content.push({
+          type: "source-url",
+          sourceId: src.id,
+          url: src.url,
+          title: src.title,
+          providerMetadata: src.providerMetadata
+        });
+      }
+      continue;
+    }
+    if (part?.type === "source-url") {
+      if (typeof part.url === "string" && part.url.length > 0) {
+        content.push({
+          type: "source-url",
+          sourceId: part.sourceId,
+          url: part.url,
+          title: part.title,
+          providerMetadata: part.providerMetadata
+        });
+      }
+      continue;
+    }
+    if (part?.type === "source-document") {
+      content.push({
+        type: "source-document",
+        sourceId: part.sourceId,
+        mediaType: part.mediaType,
+        title: part.title,
+        filename: part.filename,
+        providerMetadata: part.providerMetadata
+      });
+      continue;
+    }
+    if (typeof part?.type === "string" && part.type.startsWith("data-lua-")) {
+      content.push({
+        type: part.type,
+        payload: rawPart.data
+      });
+      continue;
+    }
     if (part?.type !== "text" && part?.type !== "file") continue;
     if (part.type === "text" && typeof part.text === "string") {
       const rawText = part.text || "";
@@ -940,10 +1028,92 @@ function transformChatHistoryContentParts(parts) {
   }
   return content;
 }
+function isSyntheticSideRow(id) {
+  return id.startsWith(SCREENSHOT_MESSAGE_ID_PREFIX) || id.startsWith(RICH_PARTS_MESSAGE_ID_PREFIX);
+}
+function mergeRichPartMirrorMessages(messages, sameTurnGroup) {
+  const merged = [];
+  for (const message of messages) {
+    if (message.role === "assistant" && message.id.startsWith(RICH_PARTS_MESSAGE_ID_PREFIX)) {
+      let folded = false;
+      for (let i = merged.length - 1; i >= 0; i--) {
+        const target = merged[i];
+        if (sameTurnGroup && !sameTurnGroup(target, message)) continue;
+        if (isSyntheticSideRow(target.id)) continue;
+        if (target.role !== "assistant") break;
+        const seen = /* @__PURE__ */ new Set();
+        for (const part of target.content) {
+          for (const key of citationDedupeKeys(part)) seen.add(key);
+        }
+        const incoming = [];
+        for (const part of message.content) {
+          const keys = citationDedupeKeys(part);
+          if (keys.length > 0 && keys.some((k) => seen.has(k))) continue;
+          for (const key of keys) seen.add(key);
+          incoming.push(part);
+        }
+        merged[i] = {
+          ...target,
+          content: [
+            ...target.content,
+            ...incoming
+          ]
+        };
+        folded = true;
+        break;
+      }
+      if (folded) continue;
+    }
+    merged.push(message);
+  }
+  return merged;
+}
+function citationDedupeKeys(part) {
+  if (part.type !== "source-url" && part.type !== "source-document") return [];
+  const keys = [];
+  if (typeof part.sourceId === "string" && part.sourceId.length > 0) keys.push(`id:${part.sourceId}`);
+  if (typeof part.url === "string" && part.url.length > 0) keys.push(`url:${part.url}`);
+  return keys;
+}
+function foldRichPartsIntoMessages(messages, records, makeMessage, sameTurnGroup) {
+  if (messages.length === 0 || records.length === 0) return messages;
+  const messageTime = /* @__PURE__ */ __name2((m) => m.createdAt ? new Date(m.createdAt).getTime() : Number.NEGATIVE_INFINITY, "messageTime");
+  const finiteTimes = messages.map(messageTime).filter(Number.isFinite);
+  const oldest = finiteTimes.length > 0 ? Math.min(...finiteTimes) : Number.NEGATIVE_INFINITY;
+  const synthetic = [];
+  for (const record of records) {
+    const time = new Date(record.createdAt).getTime();
+    if (!Number.isFinite(time) || time < oldest) continue;
+    const content = transformChatHistoryContentParts(record.parts);
+    if (content.length === 0) continue;
+    synthetic.push({
+      time,
+      message: makeMessage({
+        id: `${RICH_PARTS_MESSAGE_ID_PREFIX}${record.threadId}:${record.messageId}`,
+        role: "assistant",
+        createdAt: new Date(time).toISOString(),
+        content
+      }, record)
+    });
+  }
+  if (synthetic.length === 0) return messages;
+  synthetic.sort((a, b) => a.time - b.time);
+  const combined = [];
+  let next = 0;
+  for (const message of messages) {
+    const time = messageTime(message);
+    while (next < synthetic.length && synthetic[next].time < time) {
+      combined.push(synthetic[next++].message);
+    }
+    combined.push(message);
+  }
+  while (next < synthetic.length) combined.push(synthetic[next++].message);
+  return mergeRichPartMirrorMessages(combined, sameTurnGroup);
+}
 function buildDefaultPersona(agentName) {
   return DEFAULT_PERSONA_GUIDE.replace(AGENT_NAME_TOKEN, () => agentName || "My Agent");
 }
-var __defProp2, __name2, NON_INTERACTIVE_CHANNELS, AGENT_NAME_TOKEN, DEFAULT_PERSONA_GUIDE, AGENT_LOG_SOURCES, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema;
+var __defProp2, __name2, REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST, REVIEWABLE_MCP_SEND_TOOL_SUFFIX, NON_INTERACTIVE_CHANNELS, RICH_PARTS_MESSAGE_ID_PREFIX, SCREENSHOT_MESSAGE_ID_PREFIX, BROWSER_COMMANDS, BROWSER_COMMAND_NAMES, REASONING_EFFORT_VALUES, AGENT_NAME_TOKEN, DEFAULT_PERSONA_GUIDE, AGENT_LOG_SOURCES, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema;
 var init_dist = __esm({
   "../shared-types/dist/index.mjs"() {
     "use strict";
@@ -961,6 +1131,24 @@ var init_dist = __esm({
     __name2(personaToLiteral, "personaToLiteral");
     __name(aiGenerateInputFromSimplified, "aiGenerateInputFromSimplified");
     __name2(aiGenerateInputFromSimplified, "aiGenerateInputFromSimplified");
+    REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST = [
+      "sendChannelMessage",
+      "sendWhatsappTemplate",
+      "sendEmail",
+      "sendWhatsappMessage",
+      "sendSms",
+      "sendWebchatMessage",
+      "sendTeamsMessage",
+      "sendInstagramMessage",
+      "sendMessengerMessage"
+    ];
+    __name(isAllowedReviewableExecuteTool, "isAllowedReviewableExecuteTool");
+    __name2(isAllowedReviewableExecuteTool, "isAllowedReviewableExecuteTool");
+    REVIEWABLE_MCP_SEND_TOOL_SUFFIX = "_create_messaging_message";
+    __name(isReviewableMcpSendTool, "isReviewableMcpSendTool");
+    __name2(isReviewableMcpSendTool, "isReviewableMcpSendTool");
+    __name(isReviewableExecuteTool, "isReviewableExecuteTool");
+    __name2(isReviewableExecuteTool, "isReviewableExecuteTool");
     NON_INTERACTIVE_CHANNELS = [
       "trigger",
       "agent-invocation"
@@ -973,6 +1161,231 @@ var init_dist = __esm({
     __name2(removeNavigateBlock, "removeNavigateBlock");
     __name(transformChatHistoryContentParts, "transformChatHistoryContentParts");
     __name2(transformChatHistoryContentParts, "transformChatHistoryContentParts");
+    RICH_PARTS_MESSAGE_ID_PREFIX = "rich-parts:";
+    SCREENSHOT_MESSAGE_ID_PREFIX = "screenshot:";
+    __name(isSyntheticSideRow, "isSyntheticSideRow");
+    __name2(isSyntheticSideRow, "isSyntheticSideRow");
+    __name(mergeRichPartMirrorMessages, "mergeRichPartMirrorMessages");
+    __name2(mergeRichPartMirrorMessages, "mergeRichPartMirrorMessages");
+    __name(citationDedupeKeys, "citationDedupeKeys");
+    __name2(citationDedupeKeys, "citationDedupeKeys");
+    __name(foldRichPartsIntoMessages, "foldRichPartsIntoMessages");
+    __name2(foldRichPartsIntoMessages, "foldRichPartsIntoMessages");
+    BROWSER_COMMANDS = [
+      // health + lifecycle / navigation
+      {
+        name: "health",
+        description: "Check the local browser engine is installed and responsive."
+      },
+      {
+        name: "session_open",
+        description: "Open/attach a browser session (its own cookies/auth). Args: url?, headed?, profile?, confirmActions?."
+      },
+      {
+        name: "navigate",
+        description: "Navigate the session to a URL. Args: url, waitUntil?."
+      },
+      {
+        name: "back",
+        description: "Go back in history."
+      },
+      {
+        name: "forward",
+        description: "Go forward in history."
+      },
+      {
+        name: "reload",
+        description: "Reload the current page."
+      },
+      {
+        name: "pushstate",
+        description: "SPA client-side navigation. Args: url."
+      },
+      {
+        name: "close",
+        description: "Close the session\u2019s browser."
+      },
+      // perception
+      {
+        name: "snapshot",
+        description: "Accessibility-tree snapshot with element refs (@e1\u2026) \u2014 see what to click/fill. Args: interactiveOnly?, selector?, urls?, compact?, depth?."
+      },
+      {
+        name: "get",
+        description: "Read from the page. Args: what(text|html|value|attr|title|url|count|box|styles), selector?, attr?."
+      },
+      {
+        name: "is",
+        description: "Check element state. Args: check(visible|enabled|checked), selector."
+      },
+      // interaction
+      {
+        name: "click",
+        description: "Click an element. Args: selector(@eN or CSS), newTab?."
+      },
+      {
+        name: "dblclick",
+        description: "Double-click an element. Args: selector."
+      },
+      {
+        name: "fill",
+        description: "Clear and fill a field. Args: selector, text."
+      },
+      {
+        name: "type",
+        description: "Type into an element. Args: selector, text."
+      },
+      {
+        name: "press",
+        description: "Press a key/chord (Enter, Control+a). Args: key."
+      },
+      {
+        name: "hover",
+        description: "Hover an element. Args: selector."
+      },
+      {
+        name: "focus",
+        description: "Focus an element. Args: selector."
+      },
+      {
+        name: "select",
+        description: "Select a dropdown option. Args: selector, value."
+      },
+      {
+        name: "check",
+        description: "Check a checkbox. Args: selector."
+      },
+      {
+        name: "uncheck",
+        description: "Uncheck a checkbox. Args: selector."
+      },
+      {
+        name: "scroll",
+        description: "Scroll. Args: direction(up|down|left|right), px?, selector?."
+      },
+      {
+        name: "scrollintoview",
+        description: "Scroll an element into view. Args: selector."
+      },
+      {
+        name: "drag",
+        description: "Drag and drop. Args: source, target."
+      },
+      {
+        name: "upload",
+        description: "Upload local file(s) to a file input. Args: selector, files[]."
+      },
+      {
+        name: "find",
+        description: "Act by semantic locator. Args: by(role|text|label|placeholder|alt|title|testid), query, action(click|fill|type|hover|focus|check|uncheck|text), value?, name?, exact?."
+      },
+      // AI fallbacks
+      {
+        name: "act",
+        description: "Act on the page: ref+action (deterministic) or natural-language instruction (engine AI). Args: ref?, action?, value?, instruction?."
+      },
+      {
+        name: "extract",
+        description: "Extract data by natural-language instruction (engine AI). Args: instruction."
+      },
+      // wait
+      {
+        name: "wait",
+        description: "Wait for a condition. Provide one of: selector(+state), ms, text, url, load, fn."
+      },
+      // tabs / frames
+      {
+        name: "tab",
+        description: "Manage tabs. Args: action(list|new|switch|close), target?, url?, label?."
+      },
+      {
+        name: "window_new",
+        description: "Open a new browser window. Args: url?."
+      },
+      {
+        name: "frame",
+        description: 'Switch frame context. Args: target(@eN | CSS | "main").'
+      },
+      // capture
+      {
+        name: "screenshot",
+        description: "Screenshot the page. Args: fullPage?, path?."
+      },
+      {
+        name: "pdf",
+        description: "Save the page as PDF. Args: path."
+      },
+      // state
+      {
+        name: "cookies",
+        description: "Manage cookies. Args: action(get|set|clear), name?, value?."
+      },
+      {
+        name: "storage",
+        description: "Manage web storage. Args: area(local|session), action(get|set|clear), key?, value?."
+      },
+      {
+        name: "set",
+        description: "Configure the browser. Args: setting(viewport|device|geo|headers|credentials|media), args[]."
+      },
+      // files / clipboard
+      {
+        name: "download",
+        description: "Download a file (click a selector to trigger, or wait for one). Args: selector?, path?."
+      },
+      {
+        name: "clipboard",
+        description: "Clipboard. Args: action(read|write|copy|paste), text?."
+      },
+      // auth (use-only)
+      {
+        name: "auth",
+        description: "Use a saved login profile. Args: action(login|list|show), name?. (Credentials are saved via the desktop, never the agent.)"
+      },
+      // confirmation gate
+      {
+        name: "confirm",
+        description: "Approve a pending confirmation_required action. Args: id."
+      },
+      {
+        name: "deny",
+        description: "Reject a pending confirmation_required action. Args: id."
+      },
+      // network / debug / input / state-files
+      {
+        name: "network",
+        description: "Inspect/control network. Args: action(route|unroute|requests|har) + relevant fields."
+      },
+      {
+        name: "console",
+        description: "View browser console messages. Args: clear?."
+      },
+      {
+        name: "errors",
+        description: "View uncaught page JS errors. Args: clear?."
+      },
+      {
+        name: "mouse",
+        description: "Low-level mouse. Args: action(move|down|up|wheel), x?, y?, button?, dy?, dx?."
+      },
+      {
+        name: "keyboard",
+        description: "Low-level keyboard at focus. Args: action(type|inserttext|keydown|keyup), text?, key?."
+      },
+      {
+        name: "state",
+        description: "Persist/restore storage+auth state to a file. Args: action(save|load|list|clear), path?."
+      }
+    ];
+    BROWSER_COMMAND_NAMES = BROWSER_COMMANDS.map((c) => c.name);
+    REASONING_EFFORT_VALUES = [
+      "off",
+      "minimal",
+      "low",
+      "medium",
+      "high",
+      "max"
+    ];
     AGENT_NAME_TOKEN = "[Your Agent Name]";
     DEFAULT_PERSONA_GUIDE = `# ${AGENT_NAME_TOKEN} - Persona
 
@@ -2542,7 +2955,8 @@ var init_skill_handler = __esm({
         const response = await api.publishSkillVersion(entityId, version);
         return {
           success: response.success,
-          error: response.error?.message
+          error: response.error?.message,
+          agentVersion: response.data?.agentVersion
         };
       }
       prepareForPush(manifest, name, projectPath = process.cwd(), bundleAccumulator) {
@@ -6896,6 +7310,18 @@ var init_skill_plugin = __esm({
 
 // src/compiler/plugins/agent.plugin.ts
 import { Node as Node13 } from "ts-morph";
+function shapeReasoningSetting(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const raw = value;
+  const result = {};
+  if (typeof raw.effort === "string" && REASONING_EFFORT_VALUES.includes(raw.effort)) {
+    result.effort = raw.effort;
+  }
+  if (typeof raw.show === "boolean") {
+    result.show = raw.show;
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
 function shapeModelSettings(raw) {
   const KNOWN_KEYS = [
     "temperature",
@@ -6905,7 +7331,8 @@ function shapeModelSettings(raw) {
     "presencePenalty",
     "frequencyPenalty",
     "stopSequences",
-    "seed"
+    "seed",
+    "reasoning"
   ];
   const result = {};
   for (const key of KNOWN_KEYS) {
@@ -6915,6 +7342,9 @@ function shapeModelSettings(raw) {
       if (Array.isArray(value) && value.every((v) => typeof v === "string")) {
         result[key] = value;
       }
+    } else if (key === "reasoning") {
+      const shaped = shapeReasoningSetting(value);
+      if (shaped) result[key] = shaped;
     } else if (typeof value === "number" && Number.isFinite(value)) {
       result[key] = value;
     }
@@ -6954,7 +7384,8 @@ var init_agent_plugin = __esm({
           "description",
           "persona",
           "model",
-          "modelSettings"
+          "modelSettings",
+          "browser"
         ]
       };
       supportsClassDefinition = true;
@@ -7011,6 +7442,8 @@ var init_agent_plugin = __esm({
         const governanceHit = findClassMember(classDecl, "governance", "property");
         const governanceObj = governanceHit && Node13.isPropertyDeclaration(governanceHit.node) ? evaluateNodeAsObject(governanceHit.node.getInitializer()) : void 0;
         const governance = governanceObj && typeof governanceObj.mode === "string" ? governanceObj : void 0;
+        const browserHit = findClassMember(classDecl, "browser", "property");
+        const browser = browserHit && Node13.isPropertyDeclaration(browserHit.node) ? this.shapeBrowserNode(browserHit.node.getInitializer()) : void 0;
         const modelSettingsHit = findClassMember(classDecl, "modelSettings", "property");
         const modelSettingsObj = modelSettingsHit && Node13.isPropertyDeclaration(modelSettingsHit.node) ? evaluateNodeAsObject(modelSettingsHit.node.getInitializer()) : void 0;
         const modelSettings = modelSettingsObj ? shapeModelSettings(modelSettingsObj) : void 0;
@@ -7030,7 +7463,8 @@ var init_agent_plugin = __esm({
             hasModelResolver,
             modelSettings,
             batching,
-            governance
+            governance,
+            browser
           }
         };
       }
@@ -7061,6 +7495,7 @@ var init_agent_plugin = __esm({
         const modelSettings = this.extractModelSettings(config);
         const batching = this.extractBatchingInfo(config);
         const governance = this.extractGovernanceInfo(config);
+        const browser = this.extractBrowserInfo(config);
         const { voiceRefNames, voiceRefSourcePaths } = this.extractVoiceRefs(config);
         return {
           kind: this.kind,
@@ -7078,12 +7513,34 @@ var init_agent_plugin = __esm({
             modelSettings,
             batching,
             governance,
+            browser,
             voiceRefNames,
             voiceRefSourcePaths
           }
         };
       }
       /**
+      * Extract the `browser` switch (LuaBrowser). `true` → true; an object → its
+      * evaluated shape; `false`/absent → undefined (off by default).
+      */
+      extractBrowserInfo(config) {
+        const prop = config.getProperty("browser");
+        if (!prop || !Node13.isPropertyAssignment(prop)) return void 0;
+        return this.shapeBrowserNode(prop.getInitializer());
+      }
+      /**
+      * Normalize a `browser` initializer (config-literal or class-member) to the
+      * switch value: `true` → true; `false`/absent → undefined; an object → its
+      * evaluated shape. A resolution failure leaves the switch OFF (undefined) —
+      * mirroring `governance`, never silently "enabled with default policy".
+      */
+      shapeBrowserNode(init) {
+        if (!init) return void 0;
+        const obj = evaluateNodeAsObject(init);
+        if (obj) return obj;
+        return evaluateNodeAsBoolean(init) === true ? true : void 0;
+      }
+      /**
       * Read the `voices` array property and return both the identifiers and
       * the resolver-discovered source file for each.
       *
@@ -7241,6 +7698,7 @@ var init_agent_plugin = __esm({
           modelSettings: agentMeta.modelSettings,
           batching: agentMeta.batching,
           governance: agentMeta.governance,
+          browser: agentMeta.browser,
           voiceRefs
         };
       }
@@ -7300,6 +7758,7 @@ var init_agent_plugin = __esm({
         return rest;
       }
     };
+    __name(shapeReasoningSetting, "shapeReasoningSetting");
     __name(shapeModelSettings, "shapeModelSettings");
     agentPlugin = new AgentPlugin();
   }
@@ -12384,6 +12843,9 @@ var init_agents_api_service = __esm({
           } : {},
           ...body.webhookPayload !== void 0 ? {
             webhookPayload: body.webhookPayload
+          } : {},
+          ...body.clientContext !== void 0 ? {
+            clientContext: body.clientContext
           } : {}
         };
       }
@@ -12835,6 +13297,12 @@ var init_channels_send_api_service = __esm({
           Authorization: `Bearer ${this.apiKey}`
         });
       }
+      /** POST /developer/agents/:agentId/channels/whatsapp/reaction */
+      async sendWhatsAppReaction(input) {
+        return this.httpPost(`/developer/agents/${this.agentId}/channels/whatsapp/reaction`, input, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+      }
       /** POST /developer/agents/:agentId/channels/email/send */
       async sendEmail(input) {
         return this.httpPost(`/developer/agents/${this.agentId}/channels/email/send`, input, {
@@ -12866,6 +13334,17 @@ var init_channels_send_api_service = __esm({
         }
         return result.data;
       }
+      /** Sandbox helper for WhatsApp reaction sends. */
+      async sendWhatsAppReactionForSandbox(input) {
+        const result = await this.sendWhatsAppReaction(input);
+        if (!result.success) {
+          throw new Error(result.error?.message || "WhatsApp reaction send failed");
+        }
+        if (!result.data) {
+          throw new Error("WhatsApp reaction send failed: empty response");
+        }
+        return result.data;
+      }
       /** Sandbox helper for email sends. */
       async sendEmailForSandbox(input) {
         const result = await this.sendEmail(input);
@@ -12881,6 +13360,44 @@ var init_channels_send_api_service = __esm({
   }
 });
 
+// src/api/directory.api.service.ts
+var DirectoryApiService;
+var init_directory_api_service = __esm({
+  "src/api/directory.api.service.ts"() {
+    "use strict";
+    init_http_client();
+    DirectoryApiService = class extends HttpClient {
+      static {
+        __name(this, "DirectoryApiService");
+      }
+      apiKey;
+      agentId;
+      constructor(baseUrl, apiKey, agentId) {
+        super(baseUrl), this.apiKey = apiKey, this.agentId = agentId;
+      }
+      /** POST /developer/agents/:agentId/directory/resolve */
+      async resolve(name) {
+        return this.httpPost(`/developer/agents/${this.agentId}/directory/resolve`, {
+          name
+        }, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+      }
+      /** Sandbox helper: throws on non-success, returns unwrapped result. */
+      async resolveForSandbox(name) {
+        const result = await this.resolve(name);
+        if (!result.success) {
+          throw new Error(result.error?.message || "Directory resolve failed");
+        }
+        if (!result.data) {
+          throw new Error("Directory resolve failed: empty response");
+        }
+        return result.data;
+      }
+    };
+  }
+});
+
 // src/api/device.api.service.ts
 var device_api_service_exports = {};
 __export(device_api_service_exports, {
@@ -12977,6 +13494,7 @@ __export(lazy_instances_exports, {
   getDataInstance: () => getDataInstance,
   getDeveloperInstance: () => getDeveloperInstance,
   getDeviceInstance: () => getDeviceInstance,
+  getDirectoryInstance: () => getDirectoryInstance,
   getJobInstance: () => getJobInstance,
   getOrderInstance: () => getOrderInstance,
   getProductsInstance: () => getProductsInstance,
@@ -13091,6 +13609,13 @@ async function getChannelsSendInstance() {
   }
   return _channelsSendInstance;
 }
+async function getDirectoryInstance() {
+  if (!_directoryInstance) {
+    const creds = await getCredentials();
+    _directoryInstance = new DirectoryApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+  }
+  return _directoryInstance;
+}
 function clearAllInstances() {
   _userInstance = null;
   _dataInstance = null;
@@ -13106,8 +13631,9 @@ function clearAllInstances() {
   _developerInstance = null;
   _voiceInstance = null;
   _channelsSendInstance = null;
+  _directoryInstance = null;
 }
-var _userInstance, _dataInstance, _productsInstance, _basketsInstance, _orderInstance, _webhookInstance, _jobInstance, _aiInstance, _agentsInstance, _whatsAppTemplatesInstance, _cdnInstance, _developerInstance, _voiceInstance, _channelsSendInstance, _deviceInstance;
+var _userInstance, _dataInstance, _productsInstance, _basketsInstance, _orderInstance, _webhookInstance, _jobInstance, _aiInstance, _agentsInstance, _whatsAppTemplatesInstance, _cdnInstance, _developerInstance, _voiceInstance, _channelsSendInstance, _directoryInstance, _deviceInstance;
 var init_lazy_instances = __esm({
   "src/api/lazy-instances.ts"() {
     "use strict";
@@ -13127,6 +13653,7 @@ var init_lazy_instances = __esm({
     init_developer_api_service();
     init_voice_api_service();
     init_channels_send_api_service();
+    init_directory_api_service();
     _userInstance = null;
     _dataInstance = null;
     _productsInstance = null;
@@ -13141,6 +13668,7 @@ var init_lazy_instances = __esm({
     _developerInstance = null;
     _voiceInstance = null;
     _channelsSendInstance = null;
+    _directoryInstance = null;
     __name(getUserInstance, "getUserInstance");
     __name(getDataInstance, "getDataInstance");
     __name(getProductsInstance, "getProductsInstance");
@@ -13157,6 +13685,7 @@ var init_lazy_instances = __esm({
     __name(getDeveloperInstance, "getDeveloperInstance");
     __name(getVoiceInstance, "getVoiceInstance");
     __name(getChannelsSendInstance, "getChannelsSendInstance");
+    __name(getDirectoryInstance, "getDirectoryInstance");
     __name(clearAllInstances, "clearAllInstances");
   }
 });
@@ -16216,6 +16745,28 @@ var AgentHandler = class {
         success: false
       };
     }
+    const browser = agent?.browser ?? null;
+    writeProgress("\n\u{1F310} Pushing browser switch...");
+    try {
+      const success2 = await this.pushBrowser({
+        apiKey,
+        agentId
+      }, browser);
+      result.browser = {
+        success: success2
+      };
+      if (success2) {
+        writeSuccess(browser ? "  \u2705 Browser switch pushed" : "  \u2705 Browser switch off (default)");
+      } else {
+        console.error("  \u274C Failed to push browser switch");
+      }
+    } catch (error) {
+      if (AuthenticationError.isAuthenticationError(error)) throw error;
+      console.error(`  \u274C Failed to push browser switch: ${error.message}`);
+      result.browser = {
+        success: false
+      };
+    }
     const voiceRefNames = agent?.voiceRefs?.map((v) => v.name) ?? [];
     let voicesLinkPayload = [];
     let skipVoicesPush = false;
@@ -16337,6 +16888,13 @@ var AgentHandler = class {
     });
     return result.success;
   }
+  async pushBrowser(ctx, browser) {
+    const agentApi = new AgentApi(BASE_URLS.API, ctx.apiKey);
+    const result = await agentApi.updateAgent(ctx.agentId, {
+      browser
+    });
+    return result.success;
+  }
   async pushVoices(ctx, voices) {
     const agentApi = new AgentApi(BASE_URLS.API, ctx.apiKey);
     const result = await agentApi.updateAgent(ctx.agentId, {
@@ -18403,7 +18961,8 @@ var WebhookHandler = class extends BaseVersionedHandler {
     const response = await api.publishWebhookVersion(entityId, version);
     return {
       success: response.success,
-      error: response.error?.message
+      error: response.error?.message,
+      agentVersion: response.data?.agentVersion
     };
   }
   /**
@@ -18613,7 +19172,8 @@ var TriggerHandler = class extends BaseVersionedHandler {
     const response = await api.publishTriggerVersion(entityId, version);
     return {
       success: response.success,
-      error: response.error?.message
+      error: response.error?.message,
+      agentVersion: response.data?.agentVersion
     };
   }
   /** Include the trigger's body schema (from the SDK inputSchema) in push data. */
@@ -18723,7 +19283,8 @@ var JobHandler = class extends BaseVersionedHandler {
     const response = await api.publishJobVersion(entityId, version);
     return {
       success: response.success,
-      error: response.error?.message
+      error: response.error?.message,
+      agentVersion: response.data?.agentVersion
     };
   }
   /**
@@ -18798,7 +19359,8 @@ var PreprocessorHandler = class extends BaseVersionedHandler {
     const response = await api.publishPreProcessorVersion(entityId, version);
     return {
       success: response.success,
-      error: response.error?.message
+      error: response.error?.message,
+      agentVersion: response.data?.agentVersion
     };
   }
   /**
@@ -18874,7 +19436,8 @@ var PostprocessorHandler = class extends BaseVersionedHandler {
     const response = await api.publishPostProcessorVersion(entityId, version);
     return {
       success: response.success,
-      error: response.error?.message
+      error: response.error?.message,
+      agentVersion: response.data?.agentVersion
     };
   }
   /**
@@ -20730,7 +21293,12 @@ function createSandbox(options) {
           const { getChannelsSendInstance: getChannelsSendInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
           const channels = await getChannelsSendInstance2();
           return channels.sendWhatsAppTemplateForSandbox(input);
-        }, "sendTemplate")
+        }, "sendTemplate"),
+        sendReaction: /* @__PURE__ */ __name(async (input) => {
+          const { getChannelsSendInstance: getChannelsSendInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+          const channels = await getChannelsSendInstance2();
+          return channels.sendWhatsAppReactionForSandbox(input);
+        }, "sendReaction")
       },
       email: {
         send: /* @__PURE__ */ __name(async (input) => {
@@ -20739,6 +21307,17 @@ function createSandbox(options) {
           return channels.sendEmailForSandbox(input);
         }, "send")
       }
+    },
+    // Workspace directory. Resolve a teammate by name within the agent's org and
+    // get the channel handles they opted to share — feed the result straight into
+    // `Channels.send`. Proxied via the lua-cli developer endpoint (Bearer auth),
+    // byte-equivalent to the lua-core production VM.
+    Team: {
+      findMember: /* @__PURE__ */ __name(async (name) => {
+        const { getDirectoryInstance: getDirectoryInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+        const directory = await getDirectoryInstance2();
+        return directory.resolveForSandbox(name);
+      }, "findMember")
     }
   };
   return createBaseSandboxContext({
@@ -24398,6 +24977,9 @@ Until the backup catches up, \`lua init\` for this agent will restore an older s
     }
   }
   writeSuccess("\n\u2705 Push All Complete!\n");
+  if (options.autoDeployNoopWarned) {
+    writeInfo("\u26A0\uFE0F  --auto-deploy was ignored (agent versioning is on). To deploy, run `lua version create` then `lua version promote <version>`.\n");
+  }
   const byKind = /* @__PURE__ */ new Map();
   for (const r of allResults) {
     const kind = r.handler.displayNamePlural;
@@ -24560,6 +25142,14 @@ async function confirmDeployment() {
   return confirmed;
 }
 __name(confirmDeployment, "confirmDeployment");
+function formatDeploySuccess(params) {
+  const { label, name, version, agentVersion } = params;
+  if (agentVersion != null) {
+    return `\u2714 deployed ${name}@${version} \u2014 agent version ${agentVersion} promoted`;
+  }
+  return `\u2705 ${label} "${name}" v${version} deployed successfully`;
+}
+__name(formatDeploySuccess, "formatDeploySuccess");
 
 // src/commands/deploy.ts
 init_constants();
@@ -24723,7 +25313,7 @@ async function deployCommand(type, cmdObj) {
       selectedType = answer.type;
     }
     const apiKey = await requireAuthOrExit();
-    writeInfo("\u26A0\uFE0F  `lua deploy` is deprecated when agent versioning is on. Use `lua version promote <version>` for instant, atomic promotion.");
+    writeInfo("\u2139\uFE0F  For agents under versioning, `lua deploy` creates and promotes a new agent version scoped to this primitive; otherwise it goes live directly. For multi-primitive releases, `lua version promote <version>` remains the recommended flow.");
     let personaDeployed = false;
     let versionedOutcome = null;
     if (selectedType === "persona") {
@@ -24737,7 +25327,7 @@ async function deployCommand(type, cmdObj) {
       force_mode: options.force || false,
       entity_selected_by_name: !!options.name,
       version_selected_by_flag: !!options.version,
-      granular_deprecation_warned: true
+      scoped_promote_notice: true
     });
     const deployed = selectedType === "persona" ? personaDeployed : versionedOutcome?.deployed ?? false;
     const hintPrintedAlready = selectedType !== "persona" && !!versionedOutcome?.hintPrinted;
@@ -24877,9 +25467,14 @@ Available ${deployConfig.label}s:`);
   writeProgress("\u{1F504} Publishing version...");
   const result = await deployConfig.handler.publishVersion(apiKey, agentId, entityId, selectedVersion);
   if (!result.success) {
-    throw new Error(`Failed to deploy: ${result.error || "Unknown error"}`);
+    throw new Error(result.error || "Failed to deploy");
   }
-  writeSuccess(`\u2705 ${deployConfig.label} "${selectedEntity.name}" v${selectedVersion} deployed successfully`);
+  writeSuccess(formatDeploySuccess({
+    label: deployConfig.label,
+    name: selectedEntity.name,
+    version: selectedVersion,
+    agentVersion: result.agentVersion
+  }));
   if (selectedVersion !== selectedEntity.version) {
     writeInfo(`\u{1F4DD} Updating YAML with deployed version: ${selectedVersion}`);
     deployConfig.handler.updateVersionInYaml(selectedEntity.name, selectedVersion);
@@ -24979,6 +25574,7 @@ async function deployAllCommand(_options) {
   validateSkillConfig(config);
   const apiKey = await requireAuthOrExit();
   const agentId = config.agent.agentId;
+  writeInfo("\u2139\uFE0F  For agents under versioning, each deploy below creates and promotes an agent version scoped to that primitive. To switch everything atomically in one version instead, use `lua version create` + `lua version promote`.");
   let deployedCount = 0;
   let failedCount = 0;
   const failedItems = [];
@@ -25000,7 +25596,12 @@ async function deployAllCommand(_options) {
         const latestVersion = sortVersionsByDate(versions)[0].version;
         const result = await deployConfig.handler.publishVersion(apiKey, agentId, entityId, latestVersion);
         if (result.success) {
-          writeSuccess(`  \u2705 ${deployConfig.label} "${entity.name}" v${latestVersion} deployed`);
+          writeSuccess(`  ${formatDeploySuccess({
+            label: deployConfig.label,
+            name: entity.name,
+            version: latestVersion,
+            agentVersion: result.agentVersion
+          })}`);
           if (latestVersion !== entity.version) {
             deployConfig.handler.updateVersionInYaml(entity.name, latestVersion);
           }
@@ -26414,6 +27015,10 @@ function stopTypingIndicator(interval) {
   process.stdout.write("\r\x1B[K");
 }
 __name(stopTypingIndicator, "stopTypingIndicator");
+function getClientTimeZone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+}
+__name(getClientTimeZone, "getClientTimeZone");
 async function sendSandboxMessageStream(chatEnv, messages, callbacks) {
   if (!chatEnv.yamlConfig) {
     throw new Error("Sandbox environment not properly initialized.");
@@ -26424,7 +27029,10 @@ async function sendSandboxMessageStream(chatEnv, messages, callbacks) {
     navigate: true,
     skillOverride: allSkillOverrides,
     preprocessorOverride: chatEnv.preprocessorOverrides || [],
-    postprocessorOverride: chatEnv.postprocessorOverrides || []
+    postprocessorOverride: chatEnv.postprocessorOverrides || [],
+    clientContext: {
+      timezone: getClientTimeZone()
+    }
   };
   if (chatEnv.persona) {
     chatRequest.personaOverride = chatEnv.persona;
@@ -26445,7 +27053,10 @@ async function sendProductionMessageStream(chatEnv, messages, callbacks) {
     navigate: true,
     skillOverride: [],
     preprocessorOverride: [],
-    postprocessorOverride: []
+    postprocessorOverride: [],
+    clientContext: {
+      timezone: getClientTimeZone()
+    }
   };
   if (chatEnv.threadId) {
     chatRequest.threadId = chatEnv.threadId;
@@ -43416,6 +44027,7 @@ init_cli();
 init_command_utils();
 init_analytics();
 init_files();
+init_semver();
 init_constants();
 
 // src/utils/parse-version.ts
@@ -43471,6 +44083,11 @@ async function versionCreateCommand(options = {}) {
       commitHash: options.commitHash
     });
     if (!result.success || !result.data) {
+      const errCode = result.error?.code;
+      if (errCode === "NO_STAGED_CHANGES") {
+        writeInfo("\u2139\uFE0F  No changes since the latest version, so there is nothing to snapshot. Make and push your changes (`lua push`), then run `lua version create`.");
+        return;
+      }
       throw new Error(result.error?.message ?? "Failed to create version");
     }
     writeInfo(`\u2713 Created v${result.data.version} (staged). Run \`lua version promote v${result.data.version}\` to deploy.`);
@@ -43692,6 +44309,7 @@ async function versionDiffCommand(fromArg, toArg, options = {}) {
         console.log(`Persona: ${diff.persona.from} \u2192 ${diff.persona.to}`);
       }
       console.log(`Model: ${diff.model ? `${diff.model.from} \u2192 ${diff.model.to}` : "(unchanged)"}`);
+      console.log(`Voice: ${diff.voice ? `${diff.voice.from ?? "(none)"} \u2192 ${diff.voice.to ?? "(none)"}` : "(unchanged)"}`);
     }
     trackEvent("cli_version_diff_completed", {
       from_to_distance: Math.abs(to - from)
@@ -43790,6 +44408,202 @@ async function versionDeleteCommand(versionArg, options = {}) {
   }, "version delete");
 }
 __name(versionDeleteCommand, "versionDeleteCommand");
+function buildVersionStatusRows(inputs) {
+  const rows = [];
+  for (const { type, localItems, pinned } of inputs) {
+    for (const item of localItems) {
+      const match = (item.id ? pinned.find((p) => p.id === item.id) : void 0) ?? pinned.find((p) => p.name != null && p.name === item.name);
+      const pinnedVersion = match ? match.version : null;
+      const mismatch = pinnedVersion == null || pinnedVersion !== item.version;
+      const localBehind = pinnedVersion != null && mismatch && compareVersions(item.version, pinnedVersion) < 0;
+      rows.push({
+        type,
+        name: item.name,
+        pinnedVersion,
+        localVersion: item.version,
+        mismatch,
+        localBehind
+      });
+    }
+  }
+  return rows;
+}
+__name(buildVersionStatusRows, "buildVersionStatusRows");
+function formatVersionStatusTable(rows) {
+  const header = {
+    flag: " ",
+    type: "TYPE",
+    name: "NAME",
+    active: "ACTIVE VERSION",
+    local: "LOCAL"
+  };
+  const display = rows.map((r) => ({
+    flag: r.mismatch ? "\u26A0" : " ",
+    type: r.type,
+    name: r.name,
+    active: r.pinnedVersion != null ? `v${r.pinnedVersion}` : "\u2014 not in active version",
+    local: `v${r.localVersion}`
+  }));
+  const cols = [
+    "flag",
+    "type",
+    "name",
+    "active",
+    "local"
+  ];
+  const widths = {};
+  for (const c of cols) {
+    widths[c] = Math.max(header[c].length, ...display.map((r) => r[c].length));
+  }
+  const fmt = /* @__PURE__ */ __name((r) => cols.map((c) => r[c].padEnd(widths[c])).join("  ").trimEnd(), "fmt");
+  return [
+    fmt(header),
+    ...display.map(fmt)
+  ];
+}
+__name(formatVersionStatusTable, "formatVersionStatusTable");
+async function versionStatusCommand() {
+  return withErrorHandling(async () => {
+    const { apiKey, agentId } = await initializeCommand();
+    const config = readYamlConfig();
+    const api = new AgentVersionApi(BASE_URLS.API, apiKey, agentId);
+    const listResponse = await api.listVersions({
+      all: true
+    });
+    if (!listResponse.success || !listResponse.data) {
+      throw new Error(listResponse.error?.message ?? "Failed to fetch versions");
+    }
+    const versions = listResponse.data;
+    if (versions.length === 0) {
+      writeInfo("This agent has no versions. Per-primitive deploys (`lua deploy`) go live immediately for agents that are not under versioning.");
+      trackEvent("cli_version_status_completed", {
+        has_versions: false,
+        has_active: false,
+        mismatches: 0
+      });
+      return;
+    }
+    const active = versions.find((v) => v.status === "active");
+    if (!active) {
+      writeInfo("This agent has versions but none is active yet. Run `lua version promote <version>` to make one live.");
+      trackEvent("cli_version_status_completed", {
+        has_versions: true,
+        has_active: false,
+        mismatches: 0
+      });
+      return;
+    }
+    const versionResponse = await api.getVersion(active.version);
+    if (!versionResponse.success || !versionResponse.data) {
+      throw new Error(versionResponse.error?.message ?? `Failed to fetch v${active.version}`);
+    }
+    const snapshot = versionResponse.data.snapshot;
+    const inputs = [
+      {
+        type: "skill",
+        localItems: skillHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.skillId
+        })),
+        pinned: snapshot.skills.map((p) => ({
+          id: p.skillId,
+          version: p.version,
+          name: p.name
+        }))
+      },
+      {
+        type: "webhook",
+        localItems: webhookHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.webhookId
+        })),
+        pinned: snapshot.webhooks.map((p) => ({
+          id: p.webhookId,
+          version: p.version,
+          name: p.name
+        }))
+      },
+      {
+        type: "job",
+        localItems: jobHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.jobId
+        })),
+        pinned: snapshot.jobs.map((p) => ({
+          id: p.jobId,
+          version: p.version,
+          name: p.name
+        }))
+      },
+      {
+        type: "preprocessor",
+        localItems: preprocessorHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.preprocessorId
+        })),
+        pinned: snapshot.preprocessors.map((p) => ({
+          id: p.id,
+          version: p.version,
+          name: p.name
+        }))
+      },
+      {
+        type: "postprocessor",
+        localItems: postprocessorHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.postprocessorId
+        })),
+        pinned: snapshot.postprocessors.map((p) => ({
+          id: p.id,
+          version: p.version,
+          name: p.name
+        }))
+      },
+      {
+        type: "trigger",
+        localItems: triggerHandler.getFromYaml(config).map((i) => ({
+          name: i.name,
+          version: i.version,
+          id: i.triggerId
+        })),
+        pinned: (snapshot.triggers ?? []).map((p) => ({
+          id: p.triggerId,
+          version: p.version,
+          name: p.name
+        }))
+      }
+    ];
+    const rows = buildVersionStatusRows(inputs);
+    const mismatches = rows.filter((r) => r.mismatch).length;
+    console.log(`Active agent version: v${active.version}`);
+    if (rows.length === 0) {
+      writeInfo("(no local primitives found in lua.skill.yaml)");
+    } else {
+      for (const line of formatVersionStatusTable(rows)) {
+        console.log(line);
+      }
+      const behind = rows.filter((r) => r.localBehind).length;
+      const ahead = mismatches - behind;
+      if (ahead > 0) {
+        writeInfo(`\u26A0  ${ahead} primitive(s) are ahead of the active version (see rows marked above). Run \`lua version create\` then \`lua version promote\` to make them live, or \`lua deploy <type>\` for a single primitive.`);
+      }
+      if (behind > 0) {
+        writeInfo(`\u26A0  ${behind} primitive(s) have a local version OLDER than what's live \u2014 deploying them would roll production back. Run \`lua sync\` to update your local files instead.`);
+      }
+    }
+    trackEvent("cli_version_status_completed", {
+      has_versions: true,
+      has_active: true,
+      mismatches
+    });
+  }, "version status");
+}
+__name(versionStatusCommand, "versionStatusCommand");
 
 // src/commands/git.ts
 init_cli();
@@ -44773,6 +45587,10 @@ Examples:
   $ lua version promote 3     Promote v3 to the active version
   $ lua version promote v3    Same (v-prefix accepted)
 `).action((version) => versionPromoteCommand(version));
+  versionGroup.command("status").description("Compare local primitives against the active agent version (what is pushed vs. live)").addHelpText("after", `
+Examples:
+  $ lua version status    Show which local primitives differ from the active version
+`).action(() => versionStatusCommand());
   versionGroup.command("delete <version>").description("Soft-delete a version").option("--force", "Skip confirmation prompt").addHelpText("after", `
 Examples:
   $ lua version delete 3          Delete v3 (confirms first)