skedyul 1.7.3 → 1.7.5

package/dist/.build-stamp

@@ -1 +1 @@
-1785796289915
+1785810690937

package/dist/cli/index.js

@@ -3111,6 +3111,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -3248,7 +3268,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/dist/dedicated/server.js

@@ -441,6 +441,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -578,7 +598,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/dist/esm/index.mjs

@@ -3649,6 +3649,14 @@ function getActiveMutexQueueNames() {
       names.add(operation.resolved.name);
     }
   }
+  const held = getRateLimitExecutionContext()?.heldMutexQueueKeys;
+  if (held?.length) {
+    for (const entry of held) {
+      if (entry.queueName) {
+        names.add(entry.queueName);
+      }
+    }
+  }
   return [...names];
 }
 function shouldSkipNestedAcquire(queueName) {
@@ -3887,6 +3895,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -4024,7 +4052,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {
@@ -6416,6 +6447,11 @@ async function queuedFetch(queueInput, fnOrPromise) {
 function findPreAcquiredLease(queueKey, ctx) {
   return ctx?.preAcquiredLeases?.find((lease) => lease.queueKey === queueKey);
 }
+function isHeldMutexQueueKey(queueKey, ctx) {
+  return Boolean(
+    ctx?.heldMutexQueueKeys?.some((entry) => entry.queueKey === queueKey)
+  );
+}
 function shouldRethrowRateLimitCause(maxRetries, error, attempt, shouldRetryFn) {
   if (maxRetries !== 0 || !shouldRetryFn(error, attempt)) {
     return false;
@@ -6433,10 +6469,14 @@ async function executeWithRetries(operation, maxRetries) {
     operation.resolved.queueKey,
     rateLimitCtx
   );
+  const heldByPlatform = isHeldMutexQueueKey(
+    operation.resolved.queueKey,
+    rateLimitCtx
+  );
   if (shouldSkipNestedAcquire(operation.resolved.name)) {
     return operation.fn();
   }
-  if (preAcquired) {
+  if (preAcquired || heldByPlatform) {
     try {
       return await operation.fn();
     } catch (error) {

package/dist/index.js

@@ -4023,6 +4023,14 @@ function getActiveMutexQueueNames() {
       names.add(operation.resolved.name);
     }
   }
+  const held = getRateLimitExecutionContext()?.heldMutexQueueKeys;
+  if (held?.length) {
+    for (const entry of held) {
+      if (entry.queueName) {
+        names.add(entry.queueName);
+      }
+    }
+  }
   return [...names];
 }
 function shouldSkipNestedAcquire(queueName) {
@@ -4261,6 +4269,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -4398,7 +4426,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {
@@ -6790,6 +6821,11 @@ async function queuedFetch(queueInput, fnOrPromise) {
 function findPreAcquiredLease(queueKey, ctx) {
   return ctx?.preAcquiredLeases?.find((lease) => lease.queueKey === queueKey);
 }
+function isHeldMutexQueueKey(queueKey, ctx) {
+  return Boolean(
+    ctx?.heldMutexQueueKeys?.some((entry) => entry.queueKey === queueKey)
+  );
+}
 function shouldRethrowRateLimitCause(maxRetries, error, attempt, shouldRetryFn) {
   if (maxRetries !== 0 || !shouldRetryFn(error, attempt)) {
     return false;
@@ -6807,10 +6843,14 @@ async function executeWithRetries(operation, maxRetries) {
     operation.resolved.queueKey,
     rateLimitCtx
   );
+  const heldByPlatform = isHeldMutexQueueKey(
+    operation.resolved.queueKey,
+    rateLimitCtx
+  );
   if (shouldSkipNestedAcquire(operation.resolved.name)) {
     return operation.fn();
   }
-  if (preAcquired) {
+  if (preAcquired || heldByPlatform) {
     try {
       return await operation.fn();
     } catch (error) {

package/dist/ratelimit/context.d.ts

@@ -4,7 +4,7 @@ export declare function getRateLimitExecutionContext(): RateLimitExecutionContex
 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>[];
-/** Active mutex queue names holding a lease in an outer queuedFetch. */
+/** Active mutex queue names holding a lease in an outer queuedFetch or platform-held. */
 export declare function getActiveMutexQueueNames(): string[];
 /** True when an active mutex queue suppresses acquire for the target queue name. */
 export declare function shouldSkipNestedAcquire(queueName: string): boolean;

package/dist/ratelimit/types.d.ts

@@ -1,6 +1,10 @@
 import type { SerializableQueueConfig } from '../config/queue-config';
 import type { AppInfo } from '../types/shared';
 import type { InvocationContext } from '../types/invocation';
+export interface HeldMutexQueueKey {
+    queueKey: string;
+    queueName: string;
+}
 export interface RateLimitExecutionContext {
     app: AppInfo;
     appInstallationId?: string;
@@ -11,6 +15,12 @@ export interface RateLimitExecutionContext {
         queueKey: string;
         leaseId: string;
     }>;
+    /**
+     * Mutex queue keys held by platform Temporal orchestration for this tool call.
+     * queuedFetch skips acquire/release for matching keys; queue names count as active mutexes
+     * for suppressesQueues.
+     */
+    heldMutexQueueKeys?: HeldMutexQueueKey[];
 }
 export interface QueueSelector {
     queue: string;

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

@@ -4,6 +4,10 @@ export declare function parsePreAcquiredLeases(raw: string | undefined): Array<{
     queueKey: string;
     leaseId: string;
 }> | undefined;
+export declare function parseHeldMutexQueueKeys(raw: string | undefined): Array<{
+    queueKey: string;
+    queueName: string;
+}> | undefined;
 /**
  * Builds tool metadata array from a tool registry
  */

package/dist/server.js

@@ -441,6 +441,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -578,7 +598,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/dist/serverless/server.mjs

@@ -402,6 +402,26 @@ function parsePreAcquiredLeases(raw) {
     return void 0;
   }
 }
+function parseHeldMutexQueueKeys(raw) {
+  if (!raw) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    const keys = parsed.filter(
+      (item) => item != null && typeof item === "object" && typeof item.queueKey === "string" && typeof item.queueName === "string"
+    ).map((item) => ({
+      queueKey: item.queueKey,
+      queueName: item.queueName
+    }));
+    return keys.length > 0 ? keys : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function buildToolMetadata(registry) {
   return Object.values(registry).map((tool) => {
     const toolConfig = tool.config ?? {};
@@ -539,7 +559,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         appInstallationId: trigger === "provision" ? void 0 : rawContext.appInstallationId,
         invocation,
         isProvisionContext: trigger === "provision",
-        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES)
+        preAcquiredLeases: parsePreAcquiredLeases(toolEnv.SKEDYUL_RATE_LIMIT_LEASES),
+        heldMutexQueueKeys: parseHeldMutexQueueKeys(
+          toolEnv.SKEDYUL_HELD_MUTEX_QUEUE_KEYS
+        )
       };
       const functionResult = await runWithConfig(requestConfig, async () => {
         return await runWithRateLimitExecutionContext(rateLimitContext, async () => {

package/package.json

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