lua-cli 3.22.0 → 3.23.1

package/dist/api-exports.js

@@ -84,6 +84,31 @@ function isAllowedReviewableExecuteTool(tool) {
 function isReviewableMcpSendTool(tool) {
   return tool.length > REVIEWABLE_MCP_SEND_TOOL_SUFFIX.length && tool.endsWith(REVIEWABLE_MCP_SEND_TOOL_SUFFIX);
 }
+function mcpActionTokens(action) {
+  return action.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+}
+function isReviewableMcpDraftTool(tool) {
+  const sep = tool.indexOf("_");
+  if (sep <= 0 || sep >= tool.length - 1) return false;
+  const action = tool.slice(sep + 1);
+  const tokens = mcpActionTokens(action);
+  if (!tokens.includes("draft") && !tokens.includes("drafts")) return false;
+  return !MCP_TOOL_READ_VERB_RE.test(action);
+}
+function isMcpDraftCreateTool(tool) {
+  if (!isReviewableMcpDraftTool(tool)) return false;
+  const tokens = mcpActionTokens(tool.slice(tool.indexOf("_") + 1));
+  return tokens[0] === "draft" || tokens.some((t) => MCP_DRAFT_CREATE_VERBS.has(t));
+}
+function mcpSendSiblingForDraftTool(tool, availableToolIds) {
+  const candidates = [
+    ...availableToolIds
+  ].filter((id) => id.endsWith(REVIEWABLE_MCP_SEND_TOOL_SUFFIX)).map((id) => ({
+    id,
+    serverName: id.slice(0, -REVIEWABLE_MCP_SEND_TOOL_SUFFIX.length)
+  })).filter(({ serverName }) => tool.startsWith(`${serverName}_`)).sort((a, b) => b.serverName.length - a.serverName.length);
+  return candidates[0]?.id;
+}
 function isReviewableExecuteTool(tool) {
   return isAllowedReviewableExecuteTool(tool) || isReviewableMcpSendTool(tool);
 }
@@ -320,10 +345,40 @@ function foldRichPartsIntoMessages(messages, records, makeMessage, sameTurnGroup
   while (next < synthetic.length) combined.push(synthetic[next++].message);
   return mergeRichPartMirrorMessages(combined, sameTurnGroup);
 }
+function isDesktopFileCommandName(value) {
+  return typeof value === "string" && DESKTOP_FILE_COMMAND_SET.has(value);
+}
+function isDesktopFileSessionId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+function resolveRequireToolApproval(rules) {
+  const raw = rules?.requireToolApproval ?? rules?.requireApproval;
+  if (raw === void 0 || raw === null) return void 0;
+  const list = Array.isArray(raw) ? raw : [
+    raw
+  ];
+  return list.filter((t) => typeof t === "string");
+}
 function buildDefaultPersona(agentName) {
   return DEFAULT_PERSONA_GUIDE.replace(AGENT_NAME_TOKEN, () => agentName || "My Agent");
 }
-var __defProp2, __name2, CHANNEL_SEND_CHANNELS, 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, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema;
+function resolveLuaJobTimeoutSeconds(timeout) {
+  const resolved = timeout ?? LUA_JOB_DEFAULT_TIMEOUT_SECONDS;
+  if (!Number.isInteger(resolved)) {
+    throw new TypeError("LuaJob `timeout` must be an integer number of seconds.");
+  }
+  if (resolved < LUA_JOB_MIN_TIMEOUT_SECONDS || resolved > LUA_JOB_MAX_TIMEOUT_SECONDS) {
+    throw new RangeError(`LuaJob \`timeout\` must be between ${LUA_JOB_MIN_TIMEOUT_SECONDS} and ${LUA_JOB_MAX_TIMEOUT_SECONDS} seconds.`);
+  }
+  return resolved;
+}
+function normalizeLuaJobExecutionTimeoutSeconds(timeout) {
+  if (typeof timeout !== "number" || !Number.isFinite(timeout)) {
+    return LUA_JOB_DEFAULT_TIMEOUT_SECONDS;
+  }
+  return Math.min(Math.max(timeout, LUA_JOB_MIN_TIMEOUT_SECONDS), LUA_JOB_MAX_TIMEOUT_SECONDS);
+}
+var __defProp2, __name2, CHANNEL_SEND_CHANNELS, REVIEWABLE_ACTION_EXECUTE_TOOL_ALLOWLIST, REVIEWABLE_MCP_SEND_TOOL_SUFFIX, MCP_TOOL_READ_VERB_RE, MCP_DRAFT_CREATE_VERBS, NON_INTERACTIVE_CHANNELS, RICH_PARTS_MESSAGE_ID_PREFIX, SCREENSHOT_MESSAGE_ID_PREFIX, BROWSER_COMMANDS, BROWSER_COMMAND_NAMES, DESKTOP_FILE_COMMANDS, DESKTOP_FILE_COMMAND_SET, REASONING_EFFORT_VALUES, AGENT_NAME_TOKEN, DEFAULT_PERSONA_GUIDE, VoiceNameSchema, PluginProviderSchema, RealtimeProviderSchema, PluginClassSchema, ModelDescriptorSchema, InferenceModelSchema, PluginModelSchema, RealtimeModelSchema, LuaVoiceModelSchema, TurnDetectionSchema, InterruptionSchema, BuiltinAudioClipSchema, AudioConfigSchema, BackgroundAudioEntrySchema, BackgroundAudioSchema, LuaVoiceConfigInnerSchema, LuaVoiceConfigSchema, LuaVoiceRefSchema, LUA_JOB_DEFAULT_TIMEOUT_SECONDS, LUA_JOB_MIN_TIMEOUT_SECONDS, LUA_JOB_MAX_TIMEOUT_SECONDS;
 var init_dist = __esm({
   "../shared-types/dist/index.mjs"() {
     "use strict";
@@ -366,6 +421,26 @@ var init_dist = __esm({
     REVIEWABLE_MCP_SEND_TOOL_SUFFIX = "_create_messaging_message";
     __name(isReviewableMcpSendTool, "isReviewableMcpSendTool");
     __name2(isReviewableMcpSendTool, "isReviewableMcpSendTool");
+    MCP_TOOL_READ_VERB_RE = /(?:^|_)(list|get|search|read|fetch|find|query|describe|count|retrieve|lookup|show|view)(_|[A-Z0-9]|$)/;
+    __name(mcpActionTokens, "mcpActionTokens");
+    __name2(mcpActionTokens, "mcpActionTokens");
+    __name(isReviewableMcpDraftTool, "isReviewableMcpDraftTool");
+    __name2(isReviewableMcpDraftTool, "isReviewableMcpDraftTool");
+    MCP_DRAFT_CREATE_VERBS = /* @__PURE__ */ new Set([
+      "create",
+      "compose",
+      "make",
+      "new",
+      "save",
+      "add",
+      "write",
+      "stage",
+      "prepare"
+    ]);
+    __name(isMcpDraftCreateTool, "isMcpDraftCreateTool");
+    __name2(isMcpDraftCreateTool, "isMcpDraftCreateTool");
+    __name(mcpSendSiblingForDraftTool, "mcpSendSiblingForDraftTool");
+    __name2(mcpSendSiblingForDraftTool, "mcpSendSiblingForDraftTool");
     __name(isReviewableExecuteTool, "isReviewableExecuteTool");
     __name2(isReviewableExecuteTool, "isReviewableExecuteTool");
     NON_INTERACTIVE_CHANNELS = [
@@ -398,11 +473,11 @@ var init_dist = __esm({
       },
       {
         name: "session_open",
-        description: "Open/attach a browser session (its own cookies/auth). Args: url?, headed?, profile?, confirmActions?."
+        description: "Open/attach a browser session (its own cookies/auth). Args: url?, headed?, profile?, confirmActions?. Only use the browser when the user explicitly asked for it, or said yes when you asked. For reading a page's content use fetchUrl first."
       },
       {
         name: "navigate",
-        description: "Navigate the session to a URL. Args: url, waitUntil?."
+        description: "Navigate the session to a URL. Args: url, waitUntil?. Only use the browser when the user explicitly asked for it, or said yes when you asked. For reading a page's content use fetchUrl first."
       },
       {
         name: "back",
@@ -597,6 +672,27 @@ var init_dist = __esm({
       }
     ];
     BROWSER_COMMAND_NAMES = BROWSER_COMMANDS.map((c) => c.name);
+    DESKTOP_FILE_COMMANDS = [
+      "files_roots",
+      "files_stat",
+      "files_list",
+      "files_read",
+      "files_search",
+      "files_write",
+      "files_mkdir",
+      "files_move",
+      "files_delete",
+      "files_undo",
+      "files_transfer_prepare",
+      "files_transfer_upload",
+      "files_watch_start",
+      "files_watch_cancel"
+    ];
+    DESKTOP_FILE_COMMAND_SET = new Set(DESKTOP_FILE_COMMANDS);
+    __name(isDesktopFileCommandName, "isDesktopFileCommandName");
+    __name2(isDesktopFileCommandName, "isDesktopFileCommandName");
+    __name(isDesktopFileSessionId, "isDesktopFileSessionId");
+    __name2(isDesktopFileSessionId, "isDesktopFileSessionId");
     REASONING_EFFORT_VALUES = [
       "off",
       "minimal",
@@ -605,6 +701,8 @@ var init_dist = __esm({
       "high",
       "max"
     ];
+    __name(resolveRequireToolApproval, "resolveRequireToolApproval");
+    __name2(resolveRequireToolApproval, "resolveRequireToolApproval");
     AGENT_NAME_TOKEN = "[Your Agent Name]";
     DEFAULT_PERSONA_GUIDE = `# ${AGENT_NAME_TOKEN} - Persona
 
@@ -898,6 +996,13 @@ Feel free to add, remove, or rename sections. Your persona can be a single parag
       voiceId: z.string().min(1),
       version: z.string().optional()
     });
+    LUA_JOB_DEFAULT_TIMEOUT_SECONDS = 300;
+    LUA_JOB_MIN_TIMEOUT_SECONDS = 1;
+    LUA_JOB_MAX_TIMEOUT_SECONDS = 600;
+    __name(resolveLuaJobTimeoutSeconds, "resolveLuaJobTimeoutSeconds");
+    __name2(resolveLuaJobTimeoutSeconds, "resolveLuaJobTimeoutSeconds");
+    __name(normalizeLuaJobExecutionTimeoutSeconds, "normalizeLuaJobExecutionTimeoutSeconds");
+    __name2(normalizeLuaJobExecutionTimeoutSeconds, "normalizeLuaJobExecutionTimeoutSeconds");
   }
 });
 
@@ -3798,6 +3903,8 @@ var init_user_instance = __esm({
               "data",
               "userAPI",
               "update",
+              "patch",
+              "unset",
               "clear",
               "toJSON",
               "_luaProfile"
@@ -3876,9 +3983,27 @@ var init_user_instance = __esm({
           this.data = response;
           return this.data;
         } catch (error) {
-          throw new Error("Failed to update user data");
+          throw new Error("Failed to update user data", {
+            cause: error
+          });
         }
       }
+      async patch(mutation) {
+        try {
+          const response = await this.userAPI.patch(mutation);
+          this.data = response;
+          return this.data;
+        } catch (error) {
+          throw new Error("Failed to patch user data", {
+            cause: error
+          });
+        }
+      }
+      async unset(...fields) {
+        return this.patch({
+          unset: fields
+        });
+      }
       /**
       * Clears all user data for the current user
       * @returns Promise resolving to true if clearing was successful
@@ -3887,9 +4012,12 @@ var init_user_instance = __esm({
       async clear() {
         try {
           await this.userAPI.clear();
+          this.data = {};
           return true;
         } catch (error) {
-          throw new Error("Failed to clear user data");
+          throw new Error("Failed to clear user data", {
+            cause: error
+          });
         }
       }
       /**
@@ -3902,7 +4030,9 @@ var init_user_instance = __esm({
           await this.userAPI.update(this.data);
           return true;
         } catch (error) {
-          throw new Error("Failed to save user data");
+          throw new Error("Failed to save user data", {
+            cause: error
+          });
         }
       }
       /**
@@ -3916,7 +4046,9 @@ var init_user_instance = __esm({
           await this.userAPI.sendMessage(messages);
           return true;
         } catch (error) {
-          throw new Error("Failed to send message");
+          throw new Error("Failed to send message", {
+            cause: error
+          });
         }
       }
       //get chat history
@@ -3924,7 +4056,9 @@ var init_user_instance = __esm({
         try {
           return await this.userAPI.getChatHistory();
         } catch (error) {
-          throw new Error("Failed to get chat history");
+          throw new Error("Failed to get chat history", {
+            cause: error
+          });
         }
       }
     };
@@ -3939,22 +4073,28 @@ var init_user_data_api_service = __esm({
     init_http_client();
     init_user_instance();
     init_lazy_instances();
-    UserDataApi = class extends HttpClient {
+    UserDataApi = class _UserDataApi extends HttpClient {
       static {
         __name(this, "UserDataApi");
       }
       apiKey;
       agentId;
+      targetUserId;
       /**
       * Creates an instance of UserDataApi
       * @param baseUrl - The base URL for the API
       * @param apiKey - The API key for authentication
       * @param agentId - The unique identifier of the agent
       */
-      constructor(baseUrl, apiKey, agentId) {
+      constructor(baseUrl, apiKey, agentId, targetUserId) {
         super(baseUrl);
         this.apiKey = apiKey;
         this.agentId = agentId;
+        this.targetUserId = targetUserId;
+      }
+      get dataPath() {
+        const base = `/developer/user/data/agent/${this.agentId}`;
+        return this.targetUserId ? `${base}/user/${encodeURIComponent(this.targetUserId)}` : base;
       }
       /**
       * Retrieves user data by userId, email, or phone.
@@ -3973,7 +4113,7 @@ var init_user_data_api_service = __esm({
         }
         let url = `/developer/user/data/agent/${this.agentId}`;
         if (userId) {
-          url += `/user/${userId}`;
+          url += `/user/${encodeURIComponent(userId)}`;
         }
         const response = await this.httpGet(url, {
           Authorization: `Bearer ${this.apiKey}`
@@ -3983,7 +4123,8 @@ var init_user_data_api_service = __esm({
         }
         const profile = response.data?._luaProfile;
         const { _luaProfile, ...data } = response.data || {};
-        return new UserDataInstance(this, data, profile);
+        const scopedApi = userId ? new _UserDataApi(this.baseUrl, this.apiKey, this.agentId, userId) : this;
+        return new UserDataInstance(scopedApi, data, profile);
       }
       /**
       * Resolves email or phone to user profile via DeveloperApi
@@ -3994,11 +4135,11 @@ var init_user_data_api_service = __esm({
         try {
           const developerApi = await getDeveloperInstance();
           if (options.email) {
-            const response = await developerApi.getUserProfileByEmail(options.email);
+            const response = await developerApi.getUserProfileByEmail(options.email, this.agentId);
             return response.success ? response.data ?? null : null;
           }
           if (options.phone) {
-            const response = await developerApi.getUserProfileByPhone(options.phone);
+            const response = await developerApi.getUserProfileByPhone(options.phone, this.agentId);
             return response.success ? response.data ?? null : null;
           }
         } catch (error) {
@@ -4016,7 +4157,7 @@ var init_user_data_api_service = __esm({
       * @throws Error if the update fails or the request is unsuccessful
       */
       async update(data) {
-        const response = await this.httpPut(`/developer/user/data/agent/${this.agentId}`, data, {
+        const response = await this.httpPut(this.dataPath, data, {
           Authorization: `Bearer ${this.apiKey}`
         });
         if (!response.success) {
@@ -4025,13 +4166,23 @@ var init_user_data_api_service = __esm({
         const { _luaProfile, ...cleanData } = response.data || {};
         return cleanData;
       }
+      async patch(mutation) {
+        const response = await this.httpPatch(this.dataPath, mutation, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+        if (!response.success) {
+          throw new Error(response.error?.message || "Failed to patch user data");
+        }
+        const { _luaProfile, ...cleanData } = response.data || {};
+        return cleanData;
+      }
       /**
       * Clears all user data for the current user and specific agent
       * @returns Promise resolving to an empty object upon successful deletion
       * @throws Error if the clear operation fails or the request is unsuccessful
       */
       async clear() {
-        const response = await this.httpDelete(`/developer/user/data/agent/${this.agentId}`, {
+        const response = await this.httpDelete(this.dataPath, {
           Authorization: `Bearer ${this.apiKey}`
         });
         if (!response.success) {
@@ -4145,6 +4296,8 @@ var init_data_entry_instance = __esm({
               "score",
               "customDataAPI",
               "update",
+              "patch",
+              "unset",
               "delete",
               "toJSON"
             ];
@@ -4236,9 +4389,33 @@ var init_data_entry_instance = __esm({
           };
           return this.data;
         } catch (error) {
-          throw new Error("Failed to update custom data entry");
+          throw new Error("Failed to update custom data entry", {
+            cause: error
+          });
+        }
+      }
+      async patch(mutation) {
+        try {
+          await this.customDataAPI.patch(this.collectionName, this.id, mutation);
+          this.data = {
+            ...this.data,
+            ...mutation.set ?? {}
+          };
+          for (const field of mutation.unset ?? []) {
+            delete this.data[field];
+          }
+          return this.data;
+        } catch (error) {
+          throw new Error("Failed to patch custom data entry", {
+            cause: error
+          });
         }
       }
+      async unset(...fields) {
+        return this.patch({
+          unset: fields
+        });
+      }
       /**
       * Deletes the custom data entry
       * @returns Promise resolving to true if deletion was successful
@@ -4249,7 +4426,9 @@ var init_data_entry_instance = __esm({
           await this.customDataAPI.delete(this.collectionName, this.id);
           return true;
         } catch (error) {
-          throw new Error("Failed to delete custom data entry");
+          throw new Error("Failed to delete custom data entry", {
+            cause: error
+          });
         }
       }
       /**
@@ -4263,7 +4442,9 @@ var init_data_entry_instance = __esm({
           await this.customDataAPI.update(this.collectionName, this.id, this.data, searchText);
           return true;
         } catch (error) {
-          throw new Error("Failed to save data entry");
+          throw new Error("Failed to save data entry", {
+            cause: error
+          });
         }
       }
     };
@@ -4374,6 +4555,15 @@ var init_custom_data_api_service = __esm({
         }
         throw new Error(response.error?.message || "Failed to update custom data entry");
       }
+      async patch(collectionName, entryId, mutation) {
+        const response = await this.httpPatch(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, mutation, {
+          Authorization: `Bearer ${this.apiKey}`
+        });
+        if (response.success && response.data) {
+          return response.data;
+        }
+        throw new Error(response.error?.message || "Failed to patch custom data entry");
+      }
       /**
       * Performs semantic search on custom data entries using text similarity
       * @param collectionName - The name of the collection to search within
@@ -5388,8 +5578,10 @@ var init_developer_api_service = __esm({
       * @param email - The email address to look up
       * @returns Promise resolving to an ApiResponse containing the profile, or null if not found
       */
-      async getUserProfileByEmail(email) {
-        return this.httpGet(`/developer/user/profile/email/${encodeURIComponent(email)}`, {
+      async getUserProfileByEmail(email, agentId) {
+        const path3 = `/developer/user/profile/email/${encodeURIComponent(email)}`;
+        const scopedPath = agentId ? `${path3}?agentId=${encodeURIComponent(agentId)}` : path3;
+        return this.httpGet(scopedPath, {
           Authorization: `Bearer ${this.apiKey}`
         });
       }
@@ -5398,9 +5590,11 @@ var init_developer_api_service = __esm({
       * @param phone - The phone number to look up (with or without + prefix)
       * @returns Promise resolving to an ApiResponse containing the profile, or null if not found
       */
-      async getUserProfileByPhone(phone) {
+      async getUserProfileByPhone(phone, agentId) {
         const normalizedPhone = phone.replace(/^\+/, "");
-        return this.httpGet(`/developer/user/profile/phone/${normalizedPhone}`, {
+        const path3 = `/developer/user/profile/phone/${normalizedPhone}`;
+        const scopedPath = agentId ? `${path3}?agentId=${encodeURIComponent(agentId)}` : path3;
+        return this.httpGet(scopedPath, {
           Authorization: `Bearer ${this.apiKey}`
         });
       }
@@ -5943,6 +6137,7 @@ __name(assertValidToolName, "assertValidToolName");
 
 // src/types/skill.ts
 init_dist();
+init_dist();
 var env = /* @__PURE__ */ __name((key) => {
   if (process.env[key]) {
     return process.env[key];
@@ -6057,7 +6252,7 @@ var LuaJob = class {
   * @param config.name - Job name (required; non-empty string)
   * @param config.description - Short description of what the job does (1-2 sentences)
   * @param config.schedule - Schedule configuration (cron, once, or interval)
-  * @param config.timeout - Optional timeout in seconds (default: 300)
+  * @param config.timeout - Optional timeout in seconds (default: 300, supported range: 1-600)
   * @param config.retry - Optional retry configuration
   * @param config.metadata - Optional metadata for the job
   * @param config.execute - Function that processes the job (receives job instance as parameter)
@@ -6069,7 +6264,7 @@ var LuaJob = class {
     this.name = config.name;
     this.description = config.description;
     this.schedule = config.schedule;
-    this.timeout = config.timeout || 300;
+    this.timeout = resolveLuaJobTimeoutSeconds(config.timeout);
     this.retry = config.retry;
     this.metadata = config.metadata;
     this.executeFunction = config.execute;