skedyul 1.4.4 → 1.4.7

package/dist/cli/index.js

@@ -2904,6 +2904,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();
@@ -2981,6 +2991,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,
@@ -2990,10 +3001,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
       }
     };
   });
@@ -3136,6 +3149,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,
@@ -3499,7 +3533,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,
@@ -3509,6 +3544,7 @@ function serializeConfig(config) {
     })) : [],
     provision: isProvisionConfig(config.provision) ? config.provision : void 0,
     agents: config.agents,
+    events: config.events,
     queues: config.queues
   };
 }
@@ -5823,17 +5859,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 = fs10.readFileSync(filePath, "utf-8");
   const configDir = path10.dirname(path10.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 = path10.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 = path10.resolve(configDir, relativePath);
+      return `const { ${namedImports.trim()} } = require('${absolutePath.replace(/\\/g, "/")}')
+`;
+    }
+  );
   transpiled = transpiled.replace(/import\s*\(\s*['"][^'"]+['"]\s*\)/g, "null");
   return transpiled;
 }
@@ -5844,16 +5900,9 @@ async function loadConfig(configPath) {
   }
   const isTypeScript = absolutePath.endsWith(".ts");
   try {
-    let moduleToLoad = absolutePath;
     if (isTypeScript) {
-      const transpiled = await transpileTypeScript(absolutePath);
-      const tempDir = os2.tmpdir();
-      const tempFile = path10.join(tempDir, `skedyul-config-${Date.now()}.cjs`);
-      fs10.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");
         }
@@ -5861,16 +5910,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 = path10.join(os2.tmpdir(), `skedyul-config-${Date.now()}.cjs`);
+        fs10.writeFileSync(tempFile, transpiled);
         try {
-          fs10.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 {
+            fs10.unlinkSync(tempFile);
+          } catch {
+          }
         }
       }
     }
     const module2 = await import(
       /* webpackIgnore: true */
-      moduleToLoad
+      absolutePath
     );
     const config = module2.default || module2;
     if (!config || typeof config !== "object") {
@@ -6370,6 +6434,7 @@ function serializeResolvedConfig(config) {
     })) : [],
     provision: config.provision,
     agents: config.agents,
+    events: config.events,
     queues: config.queues
   };
 }
@@ -9622,7 +9687,9 @@ var ThreadEventTypeSchema = import_v44.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_v44.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/config/app-config.d.ts

@@ -7,6 +7,7 @@ import type { ToolRegistry, WebhookRegistry, ToolMetadata, WebhookMetadata } fro
 import type { ServerHooks } from '../types/handlers';
 import type { CoreApiConfig } from '../core/types';
 import type { EnvSchema, ComputeLayer, ModelDefinition, RelationshipDefinition, ChannelDefinition, WorkflowDefinition, PageDefinition, NavigationConfig, AgentDefinition, SignalDefinition } from './types';
+import type { AppEventDefinition } from './types/app-event';
 import type { QueueRegistry, SerializableQueueConfig } from './queue-config';
 export type { QueueScope, QueueConfig, SerializableQueueConfig, QueueRegistry, } from './queue-config';
 /**
@@ -102,6 +103,8 @@ export interface SkedyulConfig {
     }>;
     /** Agent definitions - multi-tenant agents with tool bindings */
     agents?: AgentDefinition[];
+    /** App events emitted via event.create (catalog for UI + docs) */
+    events?: AppEventDefinition[];
     /** Build configuration for the integration */
     build?: BuildConfig;
     /** Rate-limit queue definitions for queuedFetch */
@@ -124,6 +127,8 @@ export interface SerializableSkedyulConfig {
     provision?: ProvisionConfig;
     /** Agent definitions (stored as-is) */
     agents?: AgentDefinition[];
+    /** App event catalog */
+    events?: AppEventDefinition[];
     /** Rate-limit queue definitions */
     queues?: Record<string, SerializableQueueConfig>;
 }

package/dist/config/types/app-event.d.ts

@@ -0,0 +1,40 @@
+/**
+ * App event definition for integration executable config.
+ *
+ * Events are emitted via event.create and subscribed to as
+ * `app.{appHandle}.{name}` (e.g. app.bft.member.updated).
+ */
+export interface AppEventDefinition {
+    /** Event suffix after app handle, e.g. member.created */
+    name: string;
+    /** UI display label */
+    label: string;
+    /** Optional description for pickers and docs */
+    description?: string;
+    /** Optional grouping label (Members, Bookings, etc.) */
+    group?: string;
+    /** Optional Lucide icon name for pickers */
+    icon?: string;
+    /**
+     * Example flat domain payload for liquid context reference (e.g. glofox_id, phone, …).
+     * Not the full emit payload — studio/branch metadata is added at emit time.
+     */
+    examplePayload?: Record<string, unknown>;
+    /**
+     * Typed context field tree for liquid input path browsing (data.* paths).
+     * When set, subscribers see explicit fields like data.phone.
+     */
+    contextFields?: AppEventContextField[];
+    /**
+     * Workflow input type for app-event payloads, e.g. @app/bft/member/updated.
+     * Workflows declare this on inputs.data and subscribe with {{ data }}.
+     */
+    workflowInputType?: string;
+}
+export interface AppEventContextField {
+    path: string;
+    label: string;
+    type?: string;
+    description?: string;
+    children?: AppEventContextField[];
+}

package/dist/config/types/index.d.ts

@@ -12,6 +12,7 @@ export * from './workflow';
 export * from './agent';
 export * from './webhook';
 export * from './signal';
+export * from './app-event';
 export * from './navigation';
 export * from './context';
 export * from './form';

package/dist/dedicated/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,
@@ -932,6 +967,7 @@ function serializeConfig(config) {
     })) : [],
     provision: isProvisionConfig(config.provision) ? config.provision : void 0,
     agents: config.agents,
+    events: config.events,
     queues: config.queues
   };
 }