skedyul 1.4.8 → 1.4.11

package/dist/cli/index.js

@@ -2882,6 +2882,7 @@ function buildToolCallErrorOutput(result) {
 var import_async_hooks2 = require("async_hooks");
 var executionContextStorage = new import_async_hooks2.AsyncLocalStorage();
 var activeOperationStorage = new import_async_hooks2.AsyncLocalStorage();
+var activeOperationStackStorage = new import_async_hooks2.AsyncLocalStorage();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -2984,6 +2985,26 @@ function installContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -3116,7 +3137,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {
@@ -5859,18 +5881,6 @@ var CONFIG_FILE_NAMES = [
   "skedyul.config.mjs",
   "skedyul.config.cjs"
 ];
-function loadTypeScriptConfigModule(absolutePath) {
-  try {
-    require("tsx/cjs");
-    delete require.cache[absolutePath];
-    const module2 = require(absolutePath);
-    return module2.default ?? module2;
-  } catch (error) {
-    throw new Error(
-      `Cannot load TypeScript config: ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-}
 async function transpileTypeScript(filePath) {
   const content = fs10.readFileSync(filePath, "utf-8");
   const configDir = path10.dirname(path10.resolve(filePath));
@@ -5902,15 +5912,6 @@ async function loadConfig(configPath) {
   try {
     if (isTypeScript) {
       try {
-        const config2 = loadTypeScriptConfigModule(absolutePath);
-        if (!config2 || typeof config2 !== "object") {
-          throw new Error("Config file must export a configuration object");
-        }
-        if (!config2.name || typeof config2.name !== "string") {
-          throw new Error('Config must have a "name" property');
-        }
-        return config2;
-      } catch (tsxError) {
         const transpiled = await transpileTypeScript(absolutePath);
         const tempFile = path10.join(os2.tmpdir(), `skedyul-config-${Date.now()}.cjs`);
         fs10.writeFileSync(tempFile, transpiled);
@@ -5930,6 +5931,10 @@ async function loadConfig(configPath) {
           } catch {
           }
         }
+      } catch (transpileError) {
+        throw new Error(
+          `Cannot load TypeScript config metadata from ${absolutePath}: ${transpileError instanceof Error ? transpileError.message : String(transpileError)}`
+        );
       }
     }
     const module2 = await import(
@@ -6424,7 +6429,8 @@ function serializeResolvedConfig(config) {
       description: tool.description,
       // Read timeout/retries from top-level first, then fallback to config
       timeout: tool.timeout ?? tool.config?.timeout,
-      retries: tool.retries ?? tool.config?.retries
+      retries: tool.retries ?? tool.config?.retries,
+      queueTouchPoints: tool.queueTouchPoints ?? tool.config?.queueTouchPoints
     })) : [],
     webhooks: config.webhooks ? Object.values(config.webhooks).map((w) => ({
       name: w.name,

package/dist/dedicated/server.js

@@ -285,6 +285,7 @@ function runWithConfig(config, fn) {
 var import_async_hooks2 = require("async_hooks");
 var executionContextStorage = new import_async_hooks2.AsyncLocalStorage();
 var activeOperationStorage = new import_async_hooks2.AsyncLocalStorage();
+var activeOperationStackStorage = new import_async_hooks2.AsyncLocalStorage();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -407,6 +408,26 @@ function createContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -539,7 +560,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/dist/esm/index.mjs

@@ -3293,6 +3293,7 @@ var report = {
 import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 var executionContextStorage = new AsyncLocalStorage2();
 var activeOperationStorage = new AsyncLocalStorage2();
+var activeOperationStackStorage = new AsyncLocalStorage2();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -3300,11 +3301,24 @@ function getRateLimitExecutionContext() {
   return executionContextStorage.getStore();
 }
 function runWithActiveQueuedOperation(operation, fn) {
-  return activeOperationStorage.run(operation, fn);
+  const parentStack = activeOperationStackStorage.getStore() ?? [];
+  const stack = [...parentStack, operation];
+  return activeOperationStorage.run(
+    operation,
+    () => activeOperationStackStorage.run(stack, fn)
+  );
 }
 function getActiveQueuedOperation() {
   return activeOperationStorage.getStore();
 }
+function getActiveQueuedOperationStack() {
+  return activeOperationStackStorage.getStore() ?? [];
+}
+function isInsidePetbooqzCalendarBookingMutex() {
+  return getActiveQueuedOperationStack().some(
+    (operation) => operation.resolved.name === "petbooqz_calendar_booking" && operation.lease !== null
+  );
+}
 function setActiveQueuedOperationLease(lease) {
   const op = activeOperationStorage.getStore();
   if (op) {
@@ -3512,6 +3526,26 @@ function createContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -3644,7 +3678,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {
@@ -5484,18 +5519,6 @@ var CONFIG_FILE_NAMES = [
   "skedyul.config.mjs",
   "skedyul.config.cjs"
 ];
-function loadTypeScriptConfigModule(absolutePath) {
-  try {
-    __require("tsx/cjs");
-    delete __require.cache[absolutePath];
-    const module = __require(absolutePath);
-    return module.default ?? module;
-  } catch (error) {
-    throw new Error(
-      `Cannot load TypeScript config: ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-}
 async function transpileTypeScript(filePath) {
   const content = fs3.readFileSync(filePath, "utf-8");
   const configDir = path3.dirname(path3.resolve(filePath));
@@ -5527,15 +5550,6 @@ async function loadConfig(configPath) {
   try {
     if (isTypeScript) {
       try {
-        const config2 = loadTypeScriptConfigModule(absolutePath);
-        if (!config2 || typeof config2 !== "object") {
-          throw new Error("Config file must export a configuration object");
-        }
-        if (!config2.name || typeof config2.name !== "string") {
-          throw new Error('Config must have a "name" property');
-        }
-        return config2;
-      } catch (tsxError) {
         const transpiled = await transpileTypeScript(absolutePath);
         const tempFile = path3.join(os.tmpdir(), `skedyul-config-${Date.now()}.cjs`);
         fs3.writeFileSync(tempFile, transpiled);
@@ -5555,6 +5569,10 @@ async function loadConfig(configPath) {
           } catch {
           }
         }
+      } catch (transpileError) {
+        throw new Error(
+          `Cannot load TypeScript config metadata from ${absolutePath}: ${transpileError instanceof Error ? transpileError.message : String(transpileError)}`
+        );
       }
     }
     const module = await import(
@@ -5723,11 +5741,12 @@ async function callRateLimitApi(path6, body) {
   return payload.data;
 }
 var PlatformRateLimitBackend = class {
-  async acquire(queueKey, limits, timeoutMs) {
+  async acquire(queueKey, limits, timeoutMs, executionHoldMs) {
     const data = await callRateLimitApi("acquire", {
       queueKey,
       limits,
-      timeoutMs
+      timeoutMs,
+      executionHoldMs
     });
     return {
       leaseId: data.leaseId,
@@ -5737,7 +5756,8 @@ var PlatformRateLimitBackend = class {
   }
   async release(lease) {
     await callRateLimitApi("release", {
-      leaseId: lease.leaseId
+      leaseId: lease.leaseId,
+      queueKey: lease.queueKey
     });
   }
 };
@@ -6048,17 +6068,52 @@ async function queuedFetch(queueInput, fnOrPromise) {
     () => executeWithRetries(operation, maxRetries)
   );
 }
+function findPreAcquiredLease(queueKey, ctx) {
+  return ctx?.preAcquiredLeases?.find((lease) => lease.queueKey === queueKey);
+}
+function shouldRethrowRateLimitCause(maxRetries, error, attempt, shouldRetryFn) {
+  if (maxRetries !== 0 || !shouldRetryFn(error, attempt)) {
+    return false;
+  }
+  return error instanceof RateLimitExceededError || error instanceof RateLimitBackendError;
+}
 async function executeWithRetries(operation, maxRetries) {
   const backend = getRateLimitBackend();
   const timeoutMs = operation.resolved.config.timeout ?? 12e4;
+  const executionHoldMs = operation.resolved.config.timeout ?? timeoutMs;
   const retryDelayMs = operation.resolved.config.retryDelayMs ?? 1e3;
   const shouldRetryFn = getQueueConfigWithRetry(operation.resolved.name)?.shouldRetry ?? defaultShouldRetry;
+  const rateLimitCtx = getRateLimitExecutionContext();
+  const preAcquired = findPreAcquiredLease(
+    operation.resolved.queueKey,
+    rateLimitCtx
+  );
+  if (operation.resolved.name === "petbooqz_api" && isInsidePetbooqzCalendarBookingMutex()) {
+    return operation.fn();
+  }
+  if (preAcquired) {
+    try {
+      return await operation.fn();
+    } catch (error) {
+      if (shouldRethrowRateLimitCause(maxRetries, error, operation.attempt, shouldRetryFn)) {
+        throw error;
+      }
+      if (shouldRetryFn(error, operation.attempt) && operation.attempt < maxRetries) {
+        await sleep(retryDelayMs);
+        operation.attempt += 1;
+        updateActiveQueuedOperationAttempt(operation.attempt);
+        return executeWithRetries(operation, maxRetries);
+      }
+      throw error;
+    }
+  }
   let lease;
   try {
     lease = await backend.acquire(
       operation.resolved.queueKey,
       operation.resolved.limits,
-      timeoutMs
+      timeoutMs,
+      executionHoldMs
     );
   } catch (acquireError) {
     if (acquireError instanceof RateLimitBackendError && acquireError.statusCode === 408) {
@@ -6085,6 +6140,9 @@ async function executeWithRetries(operation, maxRetries) {
     await backend.release(lease);
     operation.lease = null;
     setActiveQueuedOperationLease(null);
+    if (shouldRethrowRateLimitCause(maxRetries, error, operation.attempt, shouldRetryFn)) {
+      throw error;
+    }
     if (shouldRetryFn(error, operation.attempt) && operation.attempt < maxRetries) {
       await sleep(retryDelayMs);
       operation.attempt += 1;

package/dist/index.js

@@ -3621,6 +3621,7 @@ var report = {
 var import_async_hooks2 = require("async_hooks");
 var executionContextStorage = new import_async_hooks2.AsyncLocalStorage();
 var activeOperationStorage = new import_async_hooks2.AsyncLocalStorage();
+var activeOperationStackStorage = new import_async_hooks2.AsyncLocalStorage();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -3628,11 +3629,24 @@ function getRateLimitExecutionContext() {
   return executionContextStorage.getStore();
 }
 function runWithActiveQueuedOperation(operation, fn) {
-  return activeOperationStorage.run(operation, fn);
+  const parentStack = activeOperationStackStorage.getStore() ?? [];
+  const stack = [...parentStack, operation];
+  return activeOperationStorage.run(
+    operation,
+    () => activeOperationStackStorage.run(stack, fn)
+  );
 }
 function getActiveQueuedOperation() {
   return activeOperationStorage.getStore();
 }
+function getActiveQueuedOperationStack() {
+  return activeOperationStackStorage.getStore() ?? [];
+}
+function isInsidePetbooqzCalendarBookingMutex() {
+  return getActiveQueuedOperationStack().some(
+    (operation) => operation.resolved.name === "petbooqz_calendar_booking" && operation.lease !== null
+  );
+}
 function setActiveQueuedOperationLease(lease) {
   const op = activeOperationStorage.getStore();
   if (op) {
@@ -3840,6 +3854,26 @@ function createContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -3972,7 +4006,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {
@@ -5812,18 +5847,6 @@ var CONFIG_FILE_NAMES = [
   "skedyul.config.mjs",
   "skedyul.config.cjs"
 ];
-function loadTypeScriptConfigModule(absolutePath) {
-  try {
-    require("tsx/cjs");
-    delete require.cache[absolutePath];
-    const module2 = require(absolutePath);
-    return module2.default ?? module2;
-  } catch (error) {
-    throw new Error(
-      `Cannot load TypeScript config: ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-}
 async function transpileTypeScript(filePath) {
   const content = fs3.readFileSync(filePath, "utf-8");
   const configDir = path3.dirname(path3.resolve(filePath));
@@ -5855,15 +5878,6 @@ async function loadConfig(configPath) {
   try {
     if (isTypeScript) {
       try {
-        const config2 = loadTypeScriptConfigModule(absolutePath);
-        if (!config2 || typeof config2 !== "object") {
-          throw new Error("Config file must export a configuration object");
-        }
-        if (!config2.name || typeof config2.name !== "string") {
-          throw new Error('Config must have a "name" property');
-        }
-        return config2;
-      } catch (tsxError) {
         const transpiled = await transpileTypeScript(absolutePath);
         const tempFile = path3.join(os.tmpdir(), `skedyul-config-${Date.now()}.cjs`);
         fs3.writeFileSync(tempFile, transpiled);
@@ -5883,6 +5897,10 @@ async function loadConfig(configPath) {
           } catch {
           }
         }
+      } catch (transpileError) {
+        throw new Error(
+          `Cannot load TypeScript config metadata from ${absolutePath}: ${transpileError instanceof Error ? transpileError.message : String(transpileError)}`
+        );
       }
     }
     const module2 = await import(
@@ -6051,11 +6069,12 @@ async function callRateLimitApi(path6, body) {
   return payload.data;
 }
 var PlatformRateLimitBackend = class {
-  async acquire(queueKey, limits, timeoutMs) {
+  async acquire(queueKey, limits, timeoutMs, executionHoldMs) {
     const data = await callRateLimitApi("acquire", {
       queueKey,
       limits,
-      timeoutMs
+      timeoutMs,
+      executionHoldMs
     });
     return {
       leaseId: data.leaseId,
@@ -6065,7 +6084,8 @@ var PlatformRateLimitBackend = class {
   }
   async release(lease) {
     await callRateLimitApi("release", {
-      leaseId: lease.leaseId
+      leaseId: lease.leaseId,
+      queueKey: lease.queueKey
     });
   }
 };
@@ -6376,17 +6396,52 @@ async function queuedFetch(queueInput, fnOrPromise) {
     () => executeWithRetries(operation, maxRetries)
   );
 }
+function findPreAcquiredLease(queueKey, ctx) {
+  return ctx?.preAcquiredLeases?.find((lease) => lease.queueKey === queueKey);
+}
+function shouldRethrowRateLimitCause(maxRetries, error, attempt, shouldRetryFn) {
+  if (maxRetries !== 0 || !shouldRetryFn(error, attempt)) {
+    return false;
+  }
+  return error instanceof RateLimitExceededError || error instanceof RateLimitBackendError;
+}
 async function executeWithRetries(operation, maxRetries) {
   const backend = getRateLimitBackend();
   const timeoutMs = operation.resolved.config.timeout ?? 12e4;
+  const executionHoldMs = operation.resolved.config.timeout ?? timeoutMs;
   const retryDelayMs = operation.resolved.config.retryDelayMs ?? 1e3;
   const shouldRetryFn = getQueueConfigWithRetry(operation.resolved.name)?.shouldRetry ?? defaultShouldRetry;
+  const rateLimitCtx = getRateLimitExecutionContext();
+  const preAcquired = findPreAcquiredLease(
+    operation.resolved.queueKey,
+    rateLimitCtx
+  );
+  if (operation.resolved.name === "petbooqz_api" && isInsidePetbooqzCalendarBookingMutex()) {
+    return operation.fn();
+  }
+  if (preAcquired) {
+    try {
+      return await operation.fn();
+    } catch (error) {
+      if (shouldRethrowRateLimitCause(maxRetries, error, operation.attempt, shouldRetryFn)) {
+        throw error;
+      }
+      if (shouldRetryFn(error, operation.attempt) && operation.attempt < maxRetries) {
+        await sleep(retryDelayMs);
+        operation.attempt += 1;
+        updateActiveQueuedOperationAttempt(operation.attempt);
+        return executeWithRetries(operation, maxRetries);
+      }
+      throw error;
+    }
+  }
   let lease;
   try {
     lease = await backend.acquire(
       operation.resolved.queueKey,
       operation.resolved.limits,
-      timeoutMs
+      timeoutMs,
+      executionHoldMs
     );
   } catch (acquireError) {
     if (acquireError instanceof RateLimitBackendError && acquireError.statusCode === 408) {
@@ -6413,6 +6468,9 @@ async function executeWithRetries(operation, maxRetries) {
     await backend.release(lease);
     operation.lease = null;
     setActiveQueuedOperationLease(null);
+    if (shouldRethrowRateLimitCause(maxRetries, error, operation.attempt, shouldRetryFn)) {
+      throw error;
+    }
     if (shouldRetryFn(error, operation.attempt) && operation.attempt < maxRetries) {
       await sleep(retryDelayMs);
       operation.attempt += 1;

package/dist/ratelimit/backends/platform.d.ts

@@ -3,7 +3,7 @@ import type { RateLimitBackend, Lease, QueueLimits } from '../types';
  * HTTP backend that delegates acquire/release to the Skedyul platform proxy.
  */
 export declare class PlatformRateLimitBackend implements RateLimitBackend {
-    acquire(queueKey: string, limits: QueueLimits, timeoutMs?: number): Promise<Lease>;
+    acquire(queueKey: string, limits: QueueLimits, timeoutMs?: number, executionHoldMs?: number): Promise<Lease>;
     release(lease: Lease): Promise<void>;
 }
 export declare const platformRateLimitBackend: PlatformRateLimitBackend;

package/dist/ratelimit/context.d.ts

@@ -3,5 +3,8 @@ export declare function runWithRateLimitExecutionContext<T>(ctx: RateLimitExecut
 export declare function getRateLimitExecutionContext(): RateLimitExecutionContext | undefined;
 export declare function runWithActiveQueuedOperation<T>(operation: ActiveQueuedOperation<T>, fn: () => Promise<T>): Promise<T>;
 export declare function getActiveQueuedOperation<T>(): ActiveQueuedOperation<T> | undefined;
+export declare function getActiveQueuedOperationStack(): ActiveQueuedOperation<unknown>[];
+/** True when petbooqz_calendar_booking holds a lease in an outer queuedFetch. */
+export declare function isInsidePetbooqzCalendarBookingMutex(): boolean;
 export declare function setActiveQueuedOperationLease(lease: ActiveQueuedOperation<unknown>['lease']): void;
 export declare function updateActiveQueuedOperationAttempt(attempt: number): void;

package/dist/ratelimit/types.d.ts

@@ -6,6 +6,11 @@ export interface RateLimitExecutionContext {
     appInstallationId?: string;
     invocation?: InvocationContext;
     isProvisionContext?: boolean;
+    /** Leases acquired by workflow orchestration — queuedFetch skips acquire/release for matching keys */
+    preAcquiredLeases?: Array<{
+        queueKey: string;
+        leaseId: string;
+    }>;
 }
 export interface QueueSelector {
     queue: string;
@@ -31,7 +36,7 @@ export interface ResolvedQueue {
     limits: QueueLimits;
 }
 export interface RateLimitBackend {
-    acquire(queueKey: string, limits: QueueLimits, timeoutMs?: number): Promise<Lease>;
+    acquire(queueKey: string, limits: QueueLimits, timeoutMs?: number, executionHoldMs?: number): Promise<Lease>;
     release(lease: Lease): Promise<void>;
 }
 export interface ActiveQueuedOperation<T> {

package/dist/server/tool-handler.d.ts

@@ -1,5 +1,9 @@
 import type { ToolCallResponse, ToolMetadata, ToolRegistry } from '../types';
 import type { RequestState } from './types';
+export declare function parsePreAcquiredLeases(raw: string | undefined): Array<{
+    queueKey: string;
+    leaseId: string;
+}> | undefined;
 /**
  * Builds tool metadata array from a tool registry
  */

package/dist/server.js

@@ -285,6 +285,7 @@ function runWithConfig(config, fn) {
 var import_async_hooks2 = require("async_hooks");
 var executionContextStorage = new import_async_hooks2.AsyncLocalStorage();
 var activeOperationStorage = new import_async_hooks2.AsyncLocalStorage();
+var activeOperationStackStorage = new import_async_hooks2.AsyncLocalStorage();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -407,6 +408,26 @@ function createContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -539,7 +560,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/dist/serverless/server.mjs

@@ -246,6 +246,7 @@ function runWithConfig(config, fn) {
 import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 var executionContextStorage = new AsyncLocalStorage2();
 var activeOperationStorage = new AsyncLocalStorage2();
+var activeOperationStackStorage = new AsyncLocalStorage2();
 function runWithRateLimitExecutionContext(ctx, fn) {
   return executionContextStorage.run(ctx, fn);
 }
@@ -368,6 +369,26 @@ function createContextLogger() {
 }
 
 // src/server/tool-handler.ts
+function parsePreAcquiredLeases(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const leases = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.leaseId === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      leaseId: item.leaseId
+    }));
+    return leases.length > 0 ? leases : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -500,7 +521,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         app,
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
-        isProvisionContext: trigger === "provision"
+        isProvisionContext: trigger === "provision",
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.4.8",
+  "version": "1.4.11",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",