skedyul 1.6.0 → 1.7.1

package/dist/schemas.d.ts

@@ -339,6 +339,87 @@ export declare const ModelDefinitionSchema: z.ZodObject<{
         placeholder: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+export declare const EntityFieldDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        long_string: "long_string";
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    isUnique: z.ZodOptional<z.ZodBoolean>;
+    matchCandidate: z.ZodOptional<z.ZodBoolean>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>;
+export declare const EntityRelationshipDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    targetEntity: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const EntityDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    labelPlural: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            long_string: "long_string";
+            date: "date";
+            datetime: "datetime";
+        }>>;
+        isUnique: z.ZodOptional<z.ZodBoolean>;
+        matchCandidate: z.ZodOptional<z.ZodBoolean>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
+    contextFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            long_string: "long_string";
+            date: "date";
+            datetime: "datetime";
+        }>>;
+        isUnique: z.ZodOptional<z.ZodBoolean>;
+        matchCandidate: z.ZodOptional<z.ZodBoolean>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>>;
+    relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        targetEntity: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export declare const RelationshipCardinalitySchema: z.ZodEnum<{
     ONE_TO_ONE: "ONE_TO_ONE";
     ONE_TO_MANY: "ONE_TO_MANY";
@@ -2088,11 +2169,6 @@ export declare const ListBlockDefinitionSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
     emptyMessage: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/** Model mapper block definition - for mapping SHARED models to workspace models */
-export declare const ModelMapperBlockDefinitionSchema: z.ZodObject<{
-    type: z.ZodLiteral<"model_mapper">;
-    model: z.ZodString;
-}, z.core.$strip>;
 /** Union of all block types */
 export declare const PageBlockDefinitionSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"card">;
@@ -2491,9 +2567,6 @@ export declare const PageBlockDefinitionSchema: z.ZodUnion<readonly [z.ZodObject
     descriptionField: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
     emptyMessage: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"model_mapper">;
-    model: z.ZodString;
 }, z.core.$strip>]>;
 /** Mode for context data fetching */
 export declare const PageContextModeSchema: z.ZodPipe<z.ZodEnum<{
@@ -3041,9 +3114,6 @@ export declare const PageDefinitionSchema: z.ZodObject<{
         descriptionField: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         emptyMessage: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"model_mapper">;
-        model: z.ZodString;
     }, z.core.$strip>]>>;
     actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
@@ -3263,6 +3333,30 @@ export declare const InstallConfigSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+export declare const SetupStepKindSchema: z.ZodEnum<{
+    crm: "crm";
+    env: "env";
+    app: "app";
+    realtime: "realtime";
+}>;
+export declare const SetupStepDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        crm: "crm";
+        env: "env";
+        app: "app";
+        realtime: "realtime";
+    }>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    entities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    workflowHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    envKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    listenToCrm: z.ZodOptional<z.ZodBoolean>;
+    listenToEnv: z.ZodOptional<z.ZodBoolean>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 export declare const ProvisionConfigSchema: z.ZodObject<{
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         label: z.ZodString;
@@ -3375,6 +3469,60 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
             placeholder: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
+    entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        labelPlural: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                long_string: "long_string";
+                date: "date";
+                datetime: "datetime";
+            }>>;
+            isUnique: z.ZodOptional<z.ZodBoolean>;
+            matchCandidate: z.ZodOptional<z.ZodBoolean>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>]>>>;
+        }, z.core.$strip>>;
+        contextFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                long_string: "long_string";
+                date: "date";
+                datetime: "datetime";
+            }>>;
+            isUnique: z.ZodOptional<z.ZodBoolean>;
+            matchCandidate: z.ZodOptional<z.ZodBoolean>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>]>>>;
+        }, z.core.$strip>>>;
+        relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            targetEntity: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
     relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
         source: z.ZodObject<{
             model: z.ZodString;
@@ -3961,9 +4109,6 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
             descriptionField: z.ZodOptional<z.ZodString>;
             icon: z.ZodOptional<z.ZodString>;
             emptyMessage: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"model_mapper">;
-            model: z.ZodString;
         }, z.core.$strip>]>>;
         actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             handle: z.ZodString;
@@ -3998,6 +4143,24 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
             where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    setup: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            crm: "crm";
+            env: "env";
+            app: "app";
+            realtime: "realtime";
+        }>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        entities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        workflowHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        envKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        listenToCrm: z.ZodOptional<z.ZodBoolean>;
+        listenToEnv: z.ZodOptional<z.ZodBoolean>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const SkedyulConfigSchema: z.ZodObject<{
     name: z.ZodString;
@@ -4121,6 +4284,60 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 placeholder: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
         }, z.core.$strip>>>;
+        entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            labelPlural: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodObject<{
+                handle: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    object: "object";
+                    long_string: "long_string";
+                    date: "date";
+                    datetime: "datetime";
+                }>>;
+                isUnique: z.ZodOptional<z.ZodBoolean>;
+                matchCandidate: z.ZodOptional<z.ZodBoolean>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>]>>>;
+            }, z.core.$strip>>;
+            contextFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                handle: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    object: "object";
+                    long_string: "long_string";
+                    date: "date";
+                    datetime: "datetime";
+                }>>;
+                isUnique: z.ZodOptional<z.ZodBoolean>;
+                matchCandidate: z.ZodOptional<z.ZodBoolean>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>]>>>;
+            }, z.core.$strip>>>;
+            relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                handle: z.ZodString;
+                label: z.ZodString;
+                targetEntity: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
         relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
             source: z.ZodObject<{
                 model: z.ZodString;
@@ -4707,9 +4924,6 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 descriptionField: z.ZodOptional<z.ZodString>;
                 icon: z.ZodOptional<z.ZodString>;
                 emptyMessage: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"model_mapper">;
-                model: z.ZodString;
             }, z.core.$strip>]>>;
             actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 handle: z.ZodString;
@@ -4744,6 +4958,24 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        setup: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            kind: z.ZodEnum<{
+                crm: "crm";
+                env: "env";
+                app: "app";
+                realtime: "realtime";
+            }>;
+            requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            entities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            workflowHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            envKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            listenToCrm: z.ZodOptional<z.ZodBoolean>;
+            listenToEnv: z.ZodOptional<z.ZodBoolean>;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodUnknown]>>;
     agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
@@ -4792,6 +5024,9 @@ export type WorkflowDependency = z.infer<typeof WorkflowDependencySchema>;
 export type ResourceDependency = z.infer<typeof ResourceDependencySchema>;
 export type ModelFieldDefinition = z.infer<typeof ModelFieldDefinitionSchema>;
 export type ModelDefinition = z.infer<typeof ModelDefinitionSchema>;
+export type EntityFieldDefinition = z.infer<typeof EntityFieldDefinitionSchema>;
+export type EntityRelationshipDefinition = z.infer<typeof EntityRelationshipDefinitionSchema>;
+export type EntityDefinition = z.infer<typeof EntityDefinitionSchema>;
 export type ChannelCapabilityType = z.infer<typeof ChannelCapabilityTypeSchema>;
 export type ChannelCapability = z.infer<typeof ChannelCapabilitySchema>;
 export type ChannelFieldDefinition = z.infer<typeof ChannelFieldDefinitionSchema>;
@@ -4802,6 +5037,8 @@ export type WebhookHandlerDefinition = z.infer<typeof WebhookHandlerDefinitionSc
 export type Webhooks = z.infer<typeof WebhooksSchema>;
 export type InstallConfig = z.infer<typeof InstallConfigSchema>;
 export type ProvisionConfig = z.infer<typeof ProvisionConfigSchema>;
+export type SetupStepKind = z.infer<typeof SetupStepKindSchema>;
+export type SetupStepDefinition = z.infer<typeof SetupStepDefinitionSchema>;
 export type FormV2StyleProps = z.infer<typeof FormV2StylePropsSchema>;
 export type FieldSettingButtonProps = z.infer<typeof FieldSettingButtonPropsSchema>;
 export type RelationshipExtension = z.infer<typeof RelationshipExtensionSchema>;
@@ -4814,7 +5051,6 @@ export type CardBlockHeader = z.infer<typeof CardBlockHeaderSchema>;
 export type CardBlockDefinition = z.infer<typeof CardBlockDefinitionSchema>;
 export type LegacyFormBlockDefinition = z.infer<typeof LegacyFormBlockDefinitionSchema>;
 export type ListBlockDefinition = z.infer<typeof ListBlockDefinitionSchema>;
-export type ModelMapperBlockDefinition = z.infer<typeof ModelMapperBlockDefinitionSchema>;
 export declare const MessageSendChannelSchema: z.ZodObject<{
     id: z.ZodString;
     handle: z.ZodString;

package/dist/server/handlers/index.d.ts

@@ -8,5 +8,6 @@ export * from './types';
 export { handleInstall } from './install-handler';
 export { handleUninstall } from './uninstall-handler';
 export { handleProvision } from './provision-handler';
+export { handleSetupRevalidate } from './setup-revalidate-handler';
 export { handleOAuthCallback } from './oauth-callback-handler';
 export { parseWebhookRequest, executeWebhookHandler, isMethodAllowed, type ParsedWebhookData, } from './webhook-handler';

package/dist/server/handlers/setup-revalidate-handler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Setup revalidate handler - shared implementation for serverless and dedicated servers.
+ */
+import type { ServerHooks } from '../../types';
+import type { HandlerResult, SetupRevalidateRequestBody } from './types';
+/**
+ * Handle setup revalidate request (CRM/env change notification).
+ */
+export declare function handleSetupRevalidate(body: SetupRevalidateRequestBody, hooks: ServerHooks | undefined): Promise<HandlerResult>;

package/dist/server/handlers/types.d.ts

@@ -99,3 +99,37 @@ export interface ProvisionRequestBody {
         };
     };
 }
+/**
+ * Setup revalidate request body format.
+ */
+export interface SetupRevalidateRequestBody {
+    env?: Record<string, string>;
+    invocation?: InvocationContext;
+    reason: 'crm_changed' | 'env_changed';
+    steps: string[];
+    crm?: {
+        migrationId?: string;
+        deletedModelIds?: string[];
+        deletedFieldIds?: string[];
+        createdModelIds?: string[];
+        updatedModelIds?: string[];
+        createdFieldIds?: string[];
+        updatedFieldIds?: string[];
+    };
+    envChange?: {
+        keys: string[];
+    };
+    context?: {
+        app: {
+            id: string;
+            versionId: string;
+            handle: string;
+            versionHandle: string;
+        };
+        appInstallationId: string;
+        workplace: {
+            id: string;
+            subdomain: string;
+        };
+    };
+}

package/dist/server/route-handlers/handlers.d.ts

@@ -37,6 +37,10 @@ export declare function handleUninstallRoute(req: UnifiedRequest, ctx: RouteCont
  * Handle POST /provision
  */
 export declare function handleProvisionRoute(req: UnifiedRequest, ctx: RouteContext): Promise<UnifiedResponse>;
+/**
+ * Handle POST /setup/revalidate
+ */
+export declare function handleSetupRevalidateRoute(req: UnifiedRequest, ctx: RouteContext): Promise<UnifiedResponse>;
 /**
  * Handle POST /oauth_callback
  */

package/dist/server/route-handlers/index.d.ts

@@ -6,5 +6,5 @@
  */
 export type { UnifiedRequest, UnifiedResponse, RouteContext, CallToolFn, ParsedJsonRpcBody, SkedyulToolCallArgs, ParseResult, } from './types';
 export { fromLambdaEvent, toLambdaResponse, parseJsonBody, parseJsonRpcBody, getHeader, getContentType, parseBodyByContentType, } from './adapters';
-export { handleHealthRoute, handleConfigRoute, handleCoreRoute, handleCoreWebhookRoute, handleEstimateRoute, handleInstallRoute, handleUninstallRoute, handleProvisionRoute, handleOAuthCallbackRoute, handleWebhookRoute, handleMcpRoute, createNotFoundResponse, createOptionsResponse, createErrorResponse, } from './handlers';
+export { handleHealthRoute, handleConfigRoute, handleCoreRoute, handleCoreWebhookRoute, handleEstimateRoute, handleInstallRoute, handleUninstallRoute, handleProvisionRoute, handleSetupRevalidateRoute, handleOAuthCallbackRoute, handleWebhookRoute, handleMcpRoute, createNotFoundResponse, createOptionsResponse, createErrorResponse, } from './handlers';
 export { routeRequest } from './router';

package/dist/server.js

@@ -1200,6 +1200,72 @@ async function handleProvision(body, hooks) {
   }
 }
 
+// src/server/handlers/setup-revalidate-handler.ts
+async function handleSetupRevalidate(body, hooks) {
+  const revalidateHook = hooks?.setup?.revalidate;
+  if (!revalidateHook) {
+    return {
+      status: 404,
+      body: { error: "Setup revalidate handler not configured" }
+    };
+  }
+  if (!body.context?.appInstallationId || !body.context?.workplace || !body.context?.app || !body.reason || !Array.isArray(body.steps)) {
+    return {
+      status: 400,
+      body: {
+        error: {
+          code: -32602,
+          message: "Missing context (appInstallationId, workplace, app, reason, and steps required)"
+        }
+      }
+    };
+  }
+  const ctx = {
+    env: body.env ?? {},
+    workplace: body.context.workplace,
+    appInstallationId: body.context.appInstallationId,
+    app: body.context.app,
+    reason: body.reason,
+    steps: body.steps,
+    crm: body.crm,
+    envChange: body.envChange,
+    invocation: body.invocation,
+    log: createContextLogger()
+  };
+  const requestConfig = {
+    baseUrl: body.env?.SKEDYUL_API_URL ?? process.env.SKEDYUL_API_URL ?? "",
+    apiToken: body.env?.SKEDYUL_API_TOKEN ?? process.env.SKEDYUL_API_TOKEN ?? ""
+  };
+  try {
+    const handler = typeof revalidateHook === "function" ? revalidateHook : revalidateHook.handler;
+    const result = await runWithLogContext(
+      { invocation: body.invocation },
+      async () => {
+        return await runWithConfig(requestConfig, async () => {
+          return await handler(ctx);
+        });
+      }
+    );
+    return {
+      status: 200,
+      body: {
+        completed: result?.completed ?? [],
+        invalidated: result?.invalidated ?? []
+      }
+    };
+  } catch (err) {
+    return {
+      status: 500,
+      body: {
+        error: {
+          code: -32603,
+          message: err instanceof Error ? err.message : String(err ?? "")
+        }
+      }
+    };
+  }
+}
+
 // src/server/handler-helpers.ts
 function parseHandlerEnvelope(parsedBody) {
   if (typeof parsedBody !== "object" || parsedBody === null || Array.isArray(parsedBody) || !("env" in parsedBody) || !("request" in parsedBody)) {
@@ -1591,6 +1657,14 @@ async function handleProvisionRoute(req, ctx) {
   const result = await handleProvision(parseResult.data, ctx.config.hooks);
   return { status: result.status, body: result.body };
 }
+async function handleSetupRevalidateRoute(req, ctx) {
+  const parseResult = parseJsonBody(req);
+  if (!parseResult.success) {
+    return parseResult.error;
+  }
+  const result = await handleSetupRevalidate(parseResult.data, ctx.config.hooks);
+  return { status: result.status, body: result.body };
+}
 async function handleOAuthCallbackRoute(req, ctx) {
   const parseResult = parseJsonBody(req);
   if (!parseResult.success) {
@@ -1952,6 +2026,9 @@ async function routeRequest(req, ctx) {
     if (req.path === "/provision" && req.method === "POST") {
       return handleProvisionRoute(req, ctx);
     }
+    if (req.path === "/setup/revalidate" && req.method === "POST") {
+      return handleSetupRevalidateRoute(req, ctx);
+    }
     if (req.path === "/oauth_callback" && req.method === "POST") {
       return handleOAuthCallbackRoute(req, ctx);
     }

package/dist/serverless/server.mjs

@@ -1161,6 +1161,72 @@ async function handleProvision(body, hooks) {
   }
 }
 
+// src/server/handlers/setup-revalidate-handler.ts
+async function handleSetupRevalidate(body, hooks) {
+  const revalidateHook = hooks?.setup?.revalidate;
+  if (!revalidateHook) {
+    return {
+      status: 404,
+      body: { error: "Setup revalidate handler not configured" }
+    };
+  }
+  if (!body.context?.appInstallationId || !body.context?.workplace || !body.context?.app || !body.reason || !Array.isArray(body.steps)) {
+    return {
+      status: 400,
+      body: {
+        error: {
+          code: -32602,
+          message: "Missing context (appInstallationId, workplace, app, reason, and steps required)"
+        }
+      }
+    };
+  }
+  const ctx = {
+    env: body.env ?? {},
+    workplace: body.context.workplace,
+    appInstallationId: body.context.appInstallationId,
+    app: body.context.app,
+    reason: body.reason,
+    steps: body.steps,
+    crm: body.crm,
+    envChange: body.envChange,
+    invocation: body.invocation,
+    log: createContextLogger()
+  };
+  const requestConfig = {
+    baseUrl: body.env?.SKEDYUL_API_URL ?? process.env.SKEDYUL_API_URL ?? "",
+    apiToken: body.env?.SKEDYUL_API_TOKEN ?? process.env.SKEDYUL_API_TOKEN ?? ""
+  };
+  try {
+    const handler = typeof revalidateHook === "function" ? revalidateHook : revalidateHook.handler;
+    const result = await runWithLogContext(
+      { invocation: body.invocation },
+      async () => {
+        return await runWithConfig(requestConfig, async () => {
+          return await handler(ctx);
+        });
+      }
+    );
+    return {
+      status: 200,
+      body: {
+        completed: result?.completed ?? [],
+        invalidated: result?.invalidated ?? []
+      }
+    };
+  } catch (err) {
+    return {
+      status: 500,
+      body: {
+        error: {
+          code: -32603,
+          message: err instanceof Error ? err.message : String(err ?? "")
+        }
+      }
+    };
+  }
+}
+
 // src/server/handler-helpers.ts
 function parseHandlerEnvelope(parsedBody) {
   if (typeof parsedBody !== "object" || parsedBody === null || Array.isArray(parsedBody) || !("env" in parsedBody) || !("request" in parsedBody)) {
@@ -1552,6 +1618,14 @@ async function handleProvisionRoute(req, ctx) {
   const result = await handleProvision(parseResult.data, ctx.config.hooks);
   return { status: result.status, body: result.body };
 }
+async function handleSetupRevalidateRoute(req, ctx) {
+  const parseResult = parseJsonBody(req);
+  if (!parseResult.success) {
+    return parseResult.error;
+  }
+  const result = await handleSetupRevalidate(parseResult.data, ctx.config.hooks);
+  return { status: result.status, body: result.body };
+}
 async function handleOAuthCallbackRoute(req, ctx) {
   const parseResult = parseJsonBody(req);
   if (!parseResult.success) {
@@ -1913,6 +1987,9 @@ async function routeRequest(req, ctx) {
     if (req.path === "/provision" && req.method === "POST") {
       return handleProvisionRoute(req, ctx);
     }
+    if (req.path === "/setup/revalidate" && req.method === "POST") {
+      return handleSetupRevalidateRoute(req, ctx);
+    }
     if (req.path === "/oauth_callback" && req.method === "POST") {
       return handleOAuthCallbackRoute(req, ctx);
     }