skedyul 1.7.2 → 1.7.5

package/dist/.build-stamp

@@ -0,0 +1 @@
+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/config/types/navigation.d.ts

@@ -49,10 +49,22 @@ export interface NavigationBreadcrumb {
     /** Breadcrumb items from left to right */
     items: BreadcrumbItem[];
 }
+/**
+ * Optional Liquid context for base navigation (model lookups).
+ * Setup capabilities are always injected by the platform as `capabilities`.
+ */
+export type NavigationContextDefinition = Record<string, {
+    model: string;
+    mode?: 'first' | 'list' | 'count';
+    filters?: Record<string, Record<string, unknown>>;
+    limit?: number;
+}>;
 /**
  * Full navigation configuration.
  */
 export interface NavigationConfig {
+    /** Optional model context for Liquid in sidebar items (e.g. studio) */
+    context?: NavigationContextDefinition;
     /** Sidebar navigation */
     sidebar?: NavigationSidebar;
     /** Breadcrumb navigation */

package/dist/core/client.d.ts

@@ -1269,6 +1269,9 @@ export type SetupListResult = {
     steps: SetupStepView[];
     capabilities: Record<string, boolean>;
 };
+export type SetupReconcileResult = {
+    completed: number;
+};
 /**
  * Install setup checklist API (requires sk_wkp_ token).
  */
@@ -1278,6 +1281,7 @@ export declare const setup: {
     complete(handle: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
     skip(handle: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
     invalidate(handle: string, reason?: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
+    reconcile(): Promise<SetupReconcileResult>;
     capabilities(): Promise<Record<string, boolean>>;
 };
 export {};

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

@@ -3597,6 +3597,13 @@ var setup = {
     });
     return data;
   },
+  async reconcile() {
+    const { data } = await callCore(
+      "setup.reconcile",
+      {}
+    );
+    return data;
+  },
   async capabilities() {
     const { data } = await callCore(
       "setup.capabilities",
@@ -3642,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) {
@@ -3880,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 ?? {};
@@ -4017,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 () => {
@@ -6409,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;
@@ -6426,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.d.ts

@@ -9,7 +9,7 @@ export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidCo
 export type { InstallErrorCode } from './errors';
 export { z };
 export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, call, report, setup, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
-export type { InstanceClient, InstanceContext, InstanceData, InstanceEnv, InstanceWriteOptions, InstanceGetOptions, InstanceCreateManyItem, InstanceUpdateManyItem, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CallStartParams, CallStartResult, CallAppendTranscriptParams, CallEndParams, CallSummarizeResult, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, SetupStepStatus, SetupStepKindApi, SetupStepView, SetupListResult, } from './core/client';
+export type { InstanceClient, InstanceContext, InstanceData, InstanceEnv, InstanceWriteOptions, InstanceGetOptions, InstanceCreateManyItem, InstanceUpdateManyItem, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CallStartParams, CallStartResult, CallAppendTranscriptParams, CallEndParams, CallSummarizeResult, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, SetupStepStatus, SetupStepKindApi, SetupStepView, SetupListResult, SetupReconcileResult, } from './core/client';
 export { createContextLogger } from './server/logger';
 export type { ContextLogger } from './server/logger';
 declare const _default: {

package/dist/index.js

@@ -3971,6 +3971,13 @@ var setup = {
     });
     return data;
   },
+  async reconcile() {
+    const { data } = await callCore(
+      "setup.reconcile",
+      {}
+    );
+    return data;
+  },
   async capabilities() {
     const { data } = await callCore(
       "setup.capabilities",
@@ -4016,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) {
@@ -4254,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 ?? {};
@@ -4391,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 () => {
@@ -6783,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;
@@ -6800,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.2",
+  "version": "1.7.5",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -73,9 +73,9 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && pnpm exec tsup-node",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && pnpm exec tsup-node && node -e \"require('fs').mkdirSync('dist',{recursive:true}); require('fs').writeFileSync('dist/.build-stamp', String(Date.now()))\"",
     "db:generate": "echo 'No database generation needed for this package'",
-    "dev": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
+    "dev:watch": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
     "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/agent-schema-v3.test.js dist-tests/tests/ratelimit.test.js dist-tests/tests/sequencer.test.js dist-tests/tests/config-loader.test.js dist-tests/tests/gsm7.test.js"
   },
   "keywords": [