lua-cli 3.22.0 → 3.23.0

package/dist/api-exports.d.ts

@@ -1,6 +1,7 @@
 import { CallWarning } from 'ai';
 import { FinishReason } from 'ai';
 import { LanguageModelUsage } from 'ai';
+import { ModelMessage } from 'ai';
 import { ReasoningOutput } from 'ai';
 import { UserContent } from 'ai';
 import { z } from 'zod';
@@ -62,6 +63,11 @@ declare interface AgentInvocationInput {
     /** Per-call timeout in ms. Absent ⇒ the client default (120s). Set by scheduled agent jobs
      *  to 180s so the cloud tier cuts off at the same point the desktop's local runner does. */
     timeoutMs?: number;
+    /** Per-request model override ("provider/model" code). Unknown codes fall back per
+     *  approved-models policy server-side. */
+    model?: string;
+    /** Task 14 (tasks-redesign) — per-task connector + skill scoping. See `AgentToolScope`. */
+    toolScope?: AgentToolScope;
 }
 
 /**
@@ -175,6 +181,23 @@ export declare interface AgentsApi {
     invoke(targetAgentId: string, input: AgentInvocationInput): Promise<AgentInvocationOutput>;
 }
 
+/**
+ * Task 14 (tasks-redesign) — per-task connector + skill scoping for a scheduled
+ * agent run. Non-empty `connectionIds` restricts the turn's MCP servers to the
+ * listed agent connections; non-empty `skillIds` restricts the turn's skills.
+ * Absent field or empty array ⇒ no filtering (the agent's full toolset).
+ *
+ * SECURITY: only honored on internally-authenticated invocations (the
+ * `X-Internal-Auth` agent-invoke path used by the server-side job runner) —
+ * lua-core drops it from any client-authenticated `/chat/*` request.
+ */
+declare interface AgentToolScope {
+    /** Allowlisted agent connection ids (UnifiedTo `unifiedId`s). */
+    connectionIds?: string[];
+    /** Allowlisted skill ids (from the agent's `subAgent.skills`). */
+    skillIds?: string[];
+}
+
 export declare const AI: AiApi;
 
 /**
@@ -219,13 +242,13 @@ export declare interface AiApi {
 /**
  * Wire-format input for sandbox `AI.generate` / `POST .../generate` (JSON-serializable).
  * Serializable subset of AI SDK `generateText` parameters.
- * `messages` is untyped over HTTP; callers typically send AI SDK `ModelMessage[]`.
  */
 export declare interface AiGenerateInput {
     model?: string;
     system?: string;
     prompt?: string;
-    messages?: unknown[];
+    /** AI SDK `ModelMessage[]`. Server-validated; malformed messages are rejected with 400. */
+    messages?: ModelMessage[];
     temperature?: number;
     maxOutputTokens?: number;
     /**
@@ -1081,6 +1104,12 @@ declare interface CustomDataAPI {
      * @returns Promise resolving to update response
      */
     update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
+    /** Atomically sets and removes top-level entry fields and optionally changes search text. */
+    patch(collectionName: string, entryId: string, mutation: {
+        set?: Record<string, any>;
+        unset?: string[];
+        searchText?: string | null;
+    }): Promise<UpdateCustomDataResponse>;
     /**
      * Performs vector search on a collection.
      * @param collectionName - Collection name
@@ -1211,6 +1240,12 @@ export declare class DataEntryInstance {
      * @throws Error if the update fails
      */
     update(data: Record<string, any>, searchText?: string): Promise<Record<string, any>>;
+    patch(mutation: {
+        set?: Record<string, any>;
+        unset?: string[];
+        searchText?: string | null;
+    }): Promise<Record<string, any>>;
+    unset(...fields: string[]): Promise<Record<string, any>>;
     /**
      * Deletes the custom data entry
      * @returns Promise resolving to true if deletion was successful
@@ -2546,7 +2581,7 @@ export declare class LuaJob {
      * @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)
@@ -2603,7 +2638,7 @@ export declare interface LuaJobConfig {
      * Receives metadata as parameter for accessing job configuration.
      */
     execute: (job: JobInstance) => Promise<any>;
-    /** Optional timeout in seconds (default: 300) */
+    /** Optional timeout in seconds (default: 300, supported range: 1-600) */
     timeout?: number;
     /** Optional retry configuration */
     retry?: {
@@ -5402,6 +5437,11 @@ declare interface UserDataAPI {
      * @returns Promise resolving to updated user data
      */
     update(data: Record<string, any>): Promise<any>;
+    /** Atomically sets and removes top-level user data fields. */
+    patch(mutation: {
+        set?: Record<string, any>;
+        unset?: string[];
+    }): Promise<any>;
     /**
      * Clears user data.
      * @returns Promise resolving when data is cleared
@@ -5452,6 +5492,11 @@ export declare class UserDataInstance {
      * @throws Error if the update fails
      */
     update(data: Record<string, any>): Promise<any>;
+    patch(mutation: {
+        set?: Record<string, any>;
+        unset?: string[];
+    }): Promise<any>;
+    unset(...fields: string[]): Promise<any>;
     /**
      * Clears all user data for the current user
      * @returns Promise resolving to true if clearing was successful

package/dist/api-exports.js

@@ -84,6 +84,27 @@ 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 sibling = `${tool.split("_")[0]}${REVIEWABLE_MCP_SEND_TOOL_SUFFIX}`;
+  for (const id of availableToolIds) if (id === sibling) return sibling;
+  return void 0;
+}
 function isReviewableExecuteTool(tool) {
   return isAllowedReviewableExecuteTool(tool) || isReviewableMcpSendTool(tool);
 }
@@ -323,7 +344,23 @@ function foldRichPartsIntoMessages(messages, records, makeMessage, sameTurnGroup
 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, 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 +403,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 +455,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",
@@ -898,6 +955,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 +3862,8 @@ var init_user_instance = __esm({
               "data",
               "userAPI",
               "update",
+              "patch",
+              "unset",
               "clear",
               "toJSON",
               "_luaProfile"
@@ -3876,9 +3942,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 +3971,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 +3989,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 +4005,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 +4015,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 +4032,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 +4072,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 +4082,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 +4094,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 +4116,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 +4125,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 +4255,8 @@ var init_data_entry_instance = __esm({
               "score",
               "customDataAPI",
               "update",
+              "patch",
+              "unset",
               "delete",
               "toJSON"
             ];
@@ -4236,9 +4348,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 +4385,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 +4401,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 +4514,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 +5537,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 +5549,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 +6096,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 +6211,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 +6223,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;