skedyul 1.4.5 → 1.4.7

package/dist/index.d.ts

@@ -15,7 +15,7 @@ declare const _default: {
 };
 export default _default;
 export { defineConfig, defineModel, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, loadConfig, validateConfig, CONFIG_FILE_NAMES, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
-export { queuedFetch, requeue, resolveQueue, createQueueHandle, queuedFetchResponse, registerQueueConfig, runWithRateLimitExecutionContext, getRateLimitExecutionContext, defaultShouldRetry, QueueContextError, QueueNotFoundError, QueuedFetchExhaustedError, RequeueOutsideContextError, RateLimitBackendError, } from './ratelimit';
+export { queuedFetch, requeue, resolveQueue, createQueueHandle, queuedFetchResponse, registerQueueConfig, runWithRateLimitExecutionContext, getRateLimitExecutionContext, defaultShouldRetry, QueueContextError, QueueNotFoundError, QueuedFetchExhaustedError, RequeueOutsideContextError, RateLimitBackendError, RateLimitExceededError, } from './ratelimit';
 export type { QueueInput, QueueSelector, Lease, QueueLimits, ResolvedQueue, RateLimitExecutionContext, RateLimitBackend, QueueScope, QueueConfig, SerializableQueueConfig, QueueRegistry, } from './ratelimit';
 export { defineSchema, validateCRMSchema, parseCRMSchema, safeParseCRMSchema, } from './schemas';
 export { ThreadEventTypeSchema, CustomEventTypeSchema, EventTypeSchema, ParticipantKindSchema, BaseEventPayloadSchema, MessageEventPayloadSchema, ParticipantEventPayloadSchema, ContextChangedPayloadSchema, StatusChangedPayloadSchema, ScheduledEventPayloadSchema, AgentWorkflowEventPayloadSchema, CustomEventPayloadSchema, ThreadEventPayloadSchema, ThreadEventSchema, CreateThreadEventInputSchema, EventSubscriptionSchema, EventWaitSchema, EventsConfigSchema, } from './events';

package/dist/index.js

@@ -174,6 +174,7 @@ __export(index_exports, {
   QueueNotFoundError: () => QueueNotFoundError,
   QueuedFetchExhaustedError: () => QueuedFetchExhaustedError,
   RateLimitBackendError: () => RateLimitBackendError,
+  RateLimitExceededError: () => RateLimitExceededError,
   RelationshipCardinalitySchema: () => RelationshipCardinalitySchema,
   RelationshipDefinitionSchema: () => RelationshipDefinitionSchema,
   RelationshipExtensionSchema: () => RelationshipExtensionSchema,
@@ -718,7 +719,9 @@ var ThreadEventTypeSchema = import_v43.z.enum([
   "thread.workflow.completed",
   // Scheduled events
   "thread.follow_up.due",
-  "thread.reminder.due"
+  "thread.reminder.due",
+  // Signal events
+  "thread.signal.created"
 ]);
 var CustomEventTypeSchema = import_v43.z.string().regex(/^custom\.[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/, {
   message: "Custom event type must match pattern: custom.{namespace}.{event}"
@@ -3696,6 +3699,57 @@ var AppAuthInvalidError = class extends Error {
   }
 };
 
+// src/ratelimit/errors.ts
+var QueueContextError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.code = "QUEUE_CONTEXT_ERROR";
+    this.name = "QueueContextError";
+  }
+};
+var QueueNotFoundError = class extends Error {
+  constructor(queueName) {
+    super(`Queue "${queueName}" is not defined in skedyul.config queues`);
+    this.code = "QUEUE_NOT_FOUND";
+    this.name = "QueueNotFoundError";
+  }
+};
+var QueuedFetchExhaustedError = class extends Error {
+  constructor(attempts, maxRetries, causeError) {
+    super(
+      `queuedFetch exhausted retries after ${attempts} attempts (maxRetries=${maxRetries})`
+    );
+    this.code = "QUEUED_FETCH_EXHAUSTED";
+    this.name = "QueuedFetchExhaustedError";
+    this.attempts = attempts;
+    this.maxRetries = maxRetries;
+    this.causeError = causeError;
+  }
+};
+var RequeueOutsideContextError = class extends Error {
+  constructor() {
+    super("requeue() can only be called inside an active queuedFetch operation");
+    this.code = "REQUEUE_OUTSIDE_CONTEXT";
+    this.name = "RequeueOutsideContextError";
+  }
+};
+var RateLimitBackendError = class extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.code = "RATE_LIMIT_BACKEND_ERROR";
+    this.name = "RateLimitBackendError";
+    this.statusCode = statusCode;
+  }
+};
+var RateLimitExceededError = class extends Error {
+  constructor(retryAfterMs, message = "Rate limit exceeded. Please try again later.") {
+    super(message);
+    this.code = "RATE_LIMITED";
+    this.name = "RateLimitExceededError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+
 // src/server/context-logger.ts
 var import_async_hooks3 = require("async_hooks");
 var logContextStorage = new import_async_hooks3.AsyncLocalStorage();
@@ -3793,6 +3847,7 @@ function buildToolMetadata(registry) {
     const rawRetries = tool.retries ?? toolConfig.retries;
     const timeout = typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : 1e4;
     const retries = typeof rawRetries === "number" && rawRetries >= 1 ? rawRetries : 1;
+    const queueTouchPoints = tool.queueTouchPoints ?? toolConfig.queueTouchPoints;
     return {
       name: tool.name,
       displayName: tool.label || tool.name,
@@ -3802,10 +3857,12 @@ function buildToolMetadata(registry) {
       // Include timeout/retries at top-level for tools/list response (used by syncExecutableTools)
       timeout,
       retries,
+      queueTouchPoints,
       config: {
         timeout,
         retries,
-        completionHints: toolConfig.completionHints
+        completionHints: toolConfig.completionHints,
+        queueTouchPoints
       }
     };
   });
@@ -3948,6 +4005,27 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         cursor: functionResult.cursor
       };
     } catch (error) {
+      if (error instanceof RateLimitExceededError) {
+        return {
+          success: false,
+          output: null,
+          billing: { credits: 0 },
+          meta: {
+            success: false,
+            message: error.message,
+            toolName
+          },
+          error: {
+            code: "RATE_LIMITED",
+            message: error.message,
+            category: "external"
+          },
+          retry: {
+            allowed: true,
+            afterMs: error.retryAfterMs
+          }
+        };
+      }
       if (error instanceof AppAuthInvalidError) {
         return {
           output: null,
@@ -4311,7 +4389,8 @@ function serializeConfig(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: webhookRegistry ? Object.values(webhookRegistry).map((w) => ({
       name: w.name,
@@ -5733,17 +5812,37 @@ 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));
   let transpiled = content.replace(/import\s+type\s+\{[^}]+\}\s+from\s+['"][^'"]+['"]\s*;?\n?/g, "").replace(/import\s+\{\s*defineConfig\s*\}\s+from\s+['"]skedyul['"]\s*;?\n?/g, "").replace(/:\s*SkedyulConfig/g, "").replace(/export\s+default\s+/, "module.exports = ").replace(/defineConfig\s*\(\s*\{/, "{").replace(/\}\s*\)\s*;?\s*$/, "}");
   transpiled = transpiled.replace(
     /import\s+(\w+)\s+from\s+['"](\.[^'"]+)['"]\s*(?:with\s*\{[^}]*\})?/g,
-    (match, varName, relativePath) => {
+    (_match, varName, relativePath) => {
       const absolutePath = path3.resolve(configDir, relativePath);
       return `const ${varName} = require('${absolutePath.replace(/\\/g, "/")}')`;
     }
   );
+  transpiled = transpiled.replace(
+    /import\s+\{\s*([^}]+)\s*\}\s+from\s+['"](\.[^'"]+)['"]\s*;?\n?/g,
+    (_match, namedImports, relativePath) => {
+      const absolutePath = path3.resolve(configDir, relativePath);
+      return `const { ${namedImports.trim()} } = require('${absolutePath.replace(/\\/g, "/")}')
+`;
+    }
+  );
   transpiled = transpiled.replace(/import\s*\(\s*['"][^'"]+['"]\s*\)/g, "null");
   return transpiled;
 }
@@ -5754,16 +5853,9 @@ async function loadConfig(configPath) {
   }
   const isTypeScript = absolutePath.endsWith(".ts");
   try {
-    let moduleToLoad = absolutePath;
     if (isTypeScript) {
-      const transpiled = await transpileTypeScript(absolutePath);
-      const tempDir = os.tmpdir();
-      const tempFile = path3.join(tempDir, `skedyul-config-${Date.now()}.cjs`);
-      fs3.writeFileSync(tempFile, transpiled);
-      moduleToLoad = tempFile;
       try {
-        const module3 = require(moduleToLoad);
-        const config2 = module3.default || module3;
+        const config2 = loadTypeScriptConfigModule(absolutePath);
         if (!config2 || typeof config2 !== "object") {
           throw new Error("Config file must export a configuration object");
         }
@@ -5771,16 +5863,31 @@ async function loadConfig(configPath) {
           throw new Error('Config must have a "name" property');
         }
         return config2;
-      } finally {
+      } catch (tsxError) {
+        const transpiled = await transpileTypeScript(absolutePath);
+        const tempFile = path3.join(os.tmpdir(), `skedyul-config-${Date.now()}.cjs`);
+        fs3.writeFileSync(tempFile, transpiled);
         try {
-          fs3.unlinkSync(tempFile);
-        } catch {
+          const module3 = require(tempFile);
+          const config2 = module3.default || module3;
+          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;
+        } finally {
+          try {
+            fs3.unlinkSync(tempFile);
+          } catch {
+          }
         }
       }
     }
     const module2 = await import(
       /* webpackIgnore: true */
-      moduleToLoad
+      absolutePath
     );
     const config = module2.default || module2;
     if (!config || typeof config !== "object") {
@@ -5831,49 +5938,6 @@ function getRequiredInstallEnvKeys(config) {
   return Object.entries(provision.env).filter(([, def]) => def.required).map(([key]) => key);
 }
 
-// src/ratelimit/errors.ts
-var QueueContextError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.code = "QUEUE_CONTEXT_ERROR";
-    this.name = "QueueContextError";
-  }
-};
-var QueueNotFoundError = class extends Error {
-  constructor(queueName) {
-    super(`Queue "${queueName}" is not defined in skedyul.config queues`);
-    this.code = "QUEUE_NOT_FOUND";
-    this.name = "QueueNotFoundError";
-  }
-};
-var QueuedFetchExhaustedError = class extends Error {
-  constructor(attempts, maxRetries, causeError) {
-    super(
-      `queuedFetch exhausted retries after ${attempts} attempts (maxRetries=${maxRetries})`
-    );
-    this.code = "QUEUED_FETCH_EXHAUSTED";
-    this.name = "QueuedFetchExhaustedError";
-    this.attempts = attempts;
-    this.maxRetries = maxRetries;
-    this.causeError = causeError;
-  }
-};
-var RequeueOutsideContextError = class extends Error {
-  constructor() {
-    super("requeue() can only be called inside an active queuedFetch operation");
-    this.code = "REQUEUE_OUTSIDE_CONTEXT";
-    this.name = "RequeueOutsideContextError";
-  }
-};
-var RateLimitBackendError = class extends Error {
-  constructor(message, statusCode) {
-    super(message);
-    this.code = "RATE_LIMIT_BACKEND_ERROR";
-    this.name = "RateLimitBackendError";
-    this.statusCode = statusCode;
-  }
-};
-
 // src/ratelimit/resolve-queue-key.ts
 function resolveEndpointHandle(config, invocation) {
   if (config.endpoint) {
@@ -6317,11 +6381,30 @@ async function executeWithRetries(operation, maxRetries) {
   const timeoutMs = operation.resolved.config.timeout ?? 12e4;
   const retryDelayMs = operation.resolved.config.retryDelayMs ?? 1e3;
   const shouldRetryFn = getQueueConfigWithRetry(operation.resolved.name)?.shouldRetry ?? defaultShouldRetry;
-  const lease = await backend.acquire(
-    operation.resolved.queueKey,
-    operation.resolved.limits,
-    timeoutMs
-  );
+  let lease;
+  try {
+    lease = await backend.acquire(
+      operation.resolved.queueKey,
+      operation.resolved.limits,
+      timeoutMs
+    );
+  } catch (acquireError) {
+    if (acquireError instanceof RateLimitBackendError && acquireError.statusCode === 408) {
+      const retryAfterMs = Math.max(
+        operation.resolved.limits.minTime ?? 1e3,
+        operation.resolved.config.retryDelayMs ?? 1e3
+      );
+      throw new RateLimitExceededError(retryAfterMs);
+    }
+    if (acquireError instanceof Error && acquireError.message.includes("timed out")) {
+      const retryAfterMs = Math.max(
+        operation.resolved.limits.minTime ?? 1e3,
+        operation.resolved.config.retryDelayMs ?? 1e3
+      );
+      throw new RateLimitExceededError(retryAfterMs);
+    }
+    throw acquireError;
+  }
   operation.lease = lease;
   setActiveQueuedOperationLease(lease);
   try {
@@ -7893,6 +7976,7 @@ var index_default = { z: import_v413.z };
   QueueNotFoundError,
   QueuedFetchExhaustedError,
   RateLimitBackendError,
+  RateLimitExceededError,
   RelationshipCardinalitySchema,
   RelationshipDefinitionSchema,
   RelationshipExtensionSchema,

package/dist/ratelimit/errors.d.ts

@@ -25,3 +25,9 @@ export declare class RateLimitBackendError extends Error {
     readonly statusCode?: number;
     constructor(message: string, statusCode?: number);
 }
+/** Thrown when queuedFetch cannot acquire a rate-limit slot within the queue timeout. */
+export declare class RateLimitExceededError extends Error {
+    readonly code = "RATE_LIMITED";
+    readonly retryAfterMs: number;
+    constructor(retryAfterMs: number, message?: string);
+}

package/dist/ratelimit/index.d.ts

@@ -1,6 +1,6 @@
 export { queuedFetch, requeue, resolveQueue, createQueueHandle, queuedFetchResponse, } from './queued-fetch';
 export type { QueueInput, QueueSelector, Lease, QueueLimits, ResolvedQueue, RateLimitExecutionContext, RateLimitBackend, } from './types';
-export { QueueContextError, QueueNotFoundError, QueuedFetchExhaustedError, RequeueOutsideContextError, RateLimitBackendError, } from './errors';
+export { QueueContextError, QueueNotFoundError, QueuedFetchExhaustedError, RequeueOutsideContextError, RateLimitBackendError, RateLimitExceededError, } from './errors';
 export { registerQueueConfig, clearRegisteredQueueConfig, getQueueDefinitions, getQueueConfig, } from './config-loader';
 export { runWithRateLimitExecutionContext, getRateLimitExecutionContext, } from './context';
 export { resolveQueueKey, toQueueLimits } from './resolve-queue-key';

package/dist/schemas/agent-schema-v3.d.ts

@@ -539,6 +539,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
             "thread.workflow.completed": "thread.workflow.completed";
             "thread.follow_up.due": "thread.follow_up.due";
             "thread.reminder.due": "thread.reminder.due";
+            "thread.signal.created": "thread.signal.created";
         }>, z.ZodString]>>>;
         condition: z.ZodOptional<z.ZodString>;
         emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
@@ -555,6 +556,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
             "thread.workflow.completed": "thread.workflow.completed";
             "thread.follow_up.due": "thread.follow_up.due";
             "thread.reminder.due": "thread.reminder.due";
+            "thread.signal.created": "thread.signal.created";
         }>, z.ZodString]>>>;
         waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
             event: z.ZodUnion<readonly [z.ZodEnum<{
@@ -571,6 +573,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
                 "thread.workflow.completed": "thread.workflow.completed";
                 "thread.follow_up.due": "thread.follow_up.due";
                 "thread.reminder.due": "thread.reminder.due";
+                "thread.signal.created": "thread.signal.created";
             }>, z.ZodString]>;
             timeout: z.ZodOptional<z.ZodString>;
             onTimeout: z.ZodOptional<z.ZodString>;
@@ -589,6 +592,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
             "thread.workflow.completed": "thread.workflow.completed";
             "thread.follow_up.due": "thread.follow_up.due";
             "thread.reminder.due": "thread.reminder.due";
+            "thread.signal.created": "thread.signal.created";
         }>, z.ZodString]>>>;
         cancelCondition: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;

package/dist/schemas/agent-schema-v3.js

@@ -76,7 +76,9 @@ var ThreadEventTypeSchema = import_v4.z.enum([
   "thread.workflow.completed",
   // Scheduled events
   "thread.follow_up.due",
-  "thread.reminder.due"
+  "thread.reminder.due",
+  // Signal events
+  "thread.signal.created"
 ]);
 var CustomEventTypeSchema = import_v4.z.string().regex(/^custom\.[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/, {
   message: "Custom event type must match pattern: custom.{namespace}.{event}"

package/dist/schemas/agent-schema-v3.mjs

@@ -23,7 +23,9 @@ var ThreadEventTypeSchema = z.enum([
   "thread.workflow.completed",
   // Scheduled events
   "thread.follow_up.due",
-  "thread.reminder.due"
+  "thread.reminder.due",
+  // Signal events
+  "thread.signal.created"
 ]);
 var CustomEventTypeSchema = z.string().regex(/^custom\.[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/, {
   message: "Custom event type must match pattern: custom.{namespace}.{event}"

package/dist/server.js

@@ -307,6 +307,16 @@ var AppAuthInvalidError = class extends Error {
   }
 };
 
+// src/ratelimit/errors.ts
+var RateLimitExceededError = class extends Error {
+  constructor(retryAfterMs, message = "Rate limit exceeded. Please try again later.") {
+    super(message);
+    this.code = "RATE_LIMITED";
+    this.name = "RateLimitExceededError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+
 // src/server/context-logger.ts
 var import_async_hooks3 = require("async_hooks");
 var logContextStorage = new import_async_hooks3.AsyncLocalStorage();
@@ -404,6 +414,7 @@ function buildToolMetadata(registry) {
     const rawRetries = tool.retries ?? toolConfig.retries;
     const timeout = typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : 1e4;
     const retries = typeof rawRetries === "number" && rawRetries >= 1 ? rawRetries : 1;
+    const queueTouchPoints = tool.queueTouchPoints ?? toolConfig.queueTouchPoints;
     return {
       name: tool.name,
       displayName: tool.label || tool.name,
@@ -413,10 +424,12 @@ function buildToolMetadata(registry) {
       // Include timeout/retries at top-level for tools/list response (used by syncExecutableTools)
       timeout,
       retries,
+      queueTouchPoints,
       config: {
         timeout,
         retries,
-        completionHints: toolConfig.completionHints
+        completionHints: toolConfig.completionHints,
+        queueTouchPoints
       }
     };
   });
@@ -559,6 +572,27 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         cursor: functionResult.cursor
       };
     } catch (error) {
+      if (error instanceof RateLimitExceededError) {
+        return {
+          success: false,
+          output: null,
+          billing: { credits: 0 },
+          meta: {
+            success: false,
+            message: error.message,
+            toolName
+          },
+          error: {
+            code: "RATE_LIMITED",
+            message: error.message,
+            category: "external"
+          },
+          retry: {
+            allowed: true,
+            afterMs: error.retryAfterMs
+          }
+        };
+      }
       if (error instanceof AppAuthInvalidError) {
         return {
           output: null,
@@ -922,7 +956,8 @@ function serializeConfig(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: webhookRegistry ? Object.values(webhookRegistry).map((w) => ({
       name: w.name,

package/dist/serverless/server.mjs

@@ -268,6 +268,16 @@ var AppAuthInvalidError = class extends Error {
   }
 };
 
+// src/ratelimit/errors.ts
+var RateLimitExceededError = class extends Error {
+  constructor(retryAfterMs, message = "Rate limit exceeded. Please try again later.") {
+    super(message);
+    this.code = "RATE_LIMITED";
+    this.name = "RateLimitExceededError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+
 // src/server/context-logger.ts
 import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
 var logContextStorage = new AsyncLocalStorage3();
@@ -365,6 +375,7 @@ function buildToolMetadata(registry) {
     const rawRetries = tool.retries ?? toolConfig.retries;
     const timeout = typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : 1e4;
     const retries = typeof rawRetries === "number" && rawRetries >= 1 ? rawRetries : 1;
+    const queueTouchPoints = tool.queueTouchPoints ?? toolConfig.queueTouchPoints;
     return {
       name: tool.name,
       displayName: tool.label || tool.name,
@@ -374,10 +385,12 @@ function buildToolMetadata(registry) {
       // Include timeout/retries at top-level for tools/list response (used by syncExecutableTools)
       timeout,
       retries,
+      queueTouchPoints,
       config: {
         timeout,
         retries,
-        completionHints: toolConfig.completionHints
+        completionHints: toolConfig.completionHints,
+        queueTouchPoints
       }
     };
   });
@@ -520,6 +533,27 @@ function createCallToolHandler(registry, state, onMaxRequests) {
         cursor: functionResult.cursor
       };
     } catch (error) {
+      if (error instanceof RateLimitExceededError) {
+        return {
+          success: false,
+          output: null,
+          billing: { credits: 0 },
+          meta: {
+            success: false,
+            message: error.message,
+            toolName
+          },
+          error: {
+            code: "RATE_LIMITED",
+            message: error.message,
+            category: "external"
+          },
+          retry: {
+            allowed: true,
+            afterMs: error.retryAfterMs
+          }
+        };
+      }
       if (error instanceof AppAuthInvalidError) {
         return {
           output: null,
@@ -883,7 +917,8 @@ function serializeConfig(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: webhookRegistry ? Object.values(webhookRegistry).map((w) => ({
       name: w.name,

package/dist/triggers/types.d.ts

@@ -73,6 +73,7 @@ export declare const TriggerContextSchema: z.ZodObject<{
             "thread.workflow.completed": "thread.workflow.completed";
             "thread.follow_up.due": "thread.follow_up.due";
             "thread.reminder.due": "thread.reminder.due";
+            "thread.signal.created": "thread.signal.created";
         }>, z.ZodString]>;
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         participant: z.ZodOptional<z.ZodObject<{
@@ -199,6 +200,7 @@ export declare const ResolvedTriggerSchema: z.ZodObject<{
                 "thread.workflow.completed": "thread.workflow.completed";
                 "thread.follow_up.due": "thread.follow_up.due";
                 "thread.reminder.due": "thread.reminder.due";
+                "thread.signal.created": "thread.signal.created";
             }>, z.ZodString]>>>;
             condition: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -220,6 +222,7 @@ export declare const ResolvedTriggerSchema: z.ZodObject<{
                 "thread.workflow.completed": "thread.workflow.completed";
                 "thread.follow_up.due": "thread.follow_up.due";
                 "thread.reminder.due": "thread.reminder.due";
+                "thread.signal.created": "thread.signal.created";
             }>, z.ZodString]>;
             payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             participant: z.ZodOptional<z.ZodObject<{

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ export type { InvocationType, ServerHookHandle, InvocationContext, } from './inv
 export { createToolCallContext, createServerHookContext, createWebhookContext, createWorkflowStepContext, } from './invocation';
 export type { ToolTrigger, ProvisionToolContext, DeveloperPageActionToolContext, DeveloperFormSubmitToolContext, FieldChangeToolContext, PageActionToolContext, FormSubmitToolContext, AgentToolContext, WorkflowToolContext, CronToolContext, CronContext, ToolExecutionContext, } from './tool-context';
 export { isProvisionContext, isRuntimeContext, isCronContext, isDeveloperContext } from './tool-context';
-export type { ToolResult, ToolSuccess, ToolFailure, ErrorCode, ErrorCategory, ToolWarning, ToolPagination, ToolBilling, ToolRetry, ToolTiming, ToolCompletionHints, ToolConfig, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, ExecutionScope, } from './tool';
+export type { ToolResult, ToolSuccess, ToolFailure, ErrorCode, ErrorCategory, ToolWarning, ToolPagination, ToolBilling, ToolRetry, ToolTiming, ToolCompletionHints, ToolConfig, QueueTouchPoint, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, ExecutionScope, } from './tool';
 export { ToolResponseMetaSchema } from './tool';
 export { createSuccessResponse, createListResponse, createErrorResponse, createValidationError, createNotFoundError, createAuthError, createRateLimitError, createExternalError, createTimeoutError, createPermissionError, createConflictError, isSuccess, isFailure, isRetryable, getRetryDelay, } from './tool-response';
 export type { HealthStatus, ComputeLayer, DedicatedServerInstance, ServerlessServerInstance, SkedyulServerInstance, } from './server';

package/dist/types/tool.d.ts

@@ -92,9 +92,18 @@ export interface ToolCompletionHints {
     idempotent?: boolean;
 }
 /**
- * Configuration options for tool execution behavior.
- * Groups timeout, retry, and completion hint settings.
+ * Declares which rate-limit queues a tool may touch (for orchestration probes).
  */
+export interface QueueTouchPoint {
+    /** Queue name from skedyul.config queues (e.g. petbooqz_api) */
+    queue: string;
+    /** Conservative max upstream HTTP calls this handler may make */
+    estimatedCalls: number;
+    /** Arg field used as sub-key for per-resource mutex queues */
+    subKeyFromArg?: string;
+    /** True for correctness mutexes — excluded from rate-limit probe admission */
+    mutexOnly?: boolean;
+}
 export interface ToolConfig {
     /** Timeout in milliseconds. Defaults to 10000 (10 seconds) if not specified. */
     timeout?: number;
@@ -102,6 +111,8 @@ export interface ToolConfig {
     retries?: number;
     /** Hints for controlling tool completion behavior in agent loops */
     completionHints?: ToolCompletionHints;
+    /** Rate-limit queue touch points for orchestration admission probes */
+    queueTouchPoints?: QueueTouchPoint[];
 }
 /**
  * Successful tool execution result.
@@ -179,6 +190,8 @@ export interface ToolExecutionResult<Output = unknown> {
     meta?: ToolResponseMeta;
     effect?: ToolEffect;
     error?: ToolError | null;
+    /** Retry guidance for transient failures (e.g. rate limiting) */
+    retry?: ToolRetry;
     /** Rich data blocks for UI rendering (profiles, spreadsheets, datetime cards) */
     dataBlocks?: import('./data-blocks').DataBlock[];
     /** Cursor state for cron subscriptions - saved and passed to the next run */
@@ -215,6 +228,8 @@ export interface ToolDefinition<Input = unknown, Output = unknown, InputSchema e
     outputSchema?: ToolSchema<OutputSchema>;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /** Rate-limit queue touch points (also accepted at top level for ergonomics) */
+    queueTouchPoints?: QueueTouchPoint[];
     /**
      * Execution scope for this tool.
      * - `installation` (default): Requires appInstallationId, receives sk_wkp_ token.
@@ -233,6 +248,8 @@ export interface ToolRegistryEntry {
     outputSchema?: ToolSchema;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /** Rate-limit queue touch points */
+    queueTouchPoints?: QueueTouchPoint[];
     /** Execution scope for this tool */
     executionScope?: ExecutionScope;
     [key: string]: unknown;
@@ -251,6 +268,8 @@ export interface ToolMetadata {
     retries?: number;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /** Rate-limit queue touch points for orchestration admission probes */
+    queueTouchPoints?: QueueTouchPoint[];
     /** Execution scope for this tool */
     executionScope?: ExecutionScope;
 }