skedyul 1.7.0 → 1.7.1

package/dist/index.js

@@ -155,7 +155,6 @@ __export(index_exports, {
   ModelDefinitionSchema: () => ModelDefinitionSchema,
   ModelDependencySchema: () => ModelDependencySchema,
   ModelFieldDefinitionSchema: () => ModelFieldDefinitionSchema,
-  ModelMapperBlockDefinitionSchema: () => ModelMapperBlockDefinitionSchema,
   MoneyMinorRangeSchema: () => MoneyMinorRangeSchema,
   NavigationBreadcrumbSchema: () => NavigationBreadcrumbSchema,
   NavigationConfigSchema: () => NavigationConfigSchema,
@@ -206,6 +205,8 @@ __export(index_exports, {
   SequencerContextError: () => SequencerContextError,
   SequencerLockError: () => SequencerLockError,
   SequencerNotFoundError: () => SequencerNotFoundError,
+  SetupStepDefinitionSchema: () => SetupStepDefinitionSchema,
+  SetupStepKindSchema: () => SetupStepKindSchema,
   SkedyulConfigSchema: () => SkedyulConfigSchema,
   SkillExampleSchema: () => SkillExampleSchema,
   SkillMetadataSchema: () => SkillMetadataSchema,
@@ -301,6 +302,7 @@ __export(index_exports, {
   defineNavigation: () => defineNavigation,
   definePage: () => definePage,
   defineSchema: () => defineSchema,
+  defineSetupStep: () => defineSetupStep,
   defineSkill: () => defineSkill,
   defineWorkflow: () => defineWorkflow,
   defineWorkflowYAML: () => defineWorkflowYAML,
@@ -362,6 +364,7 @@ __export(index_exports, {
   sequencerAllow: () => allow,
   sequencerRelease: () => release,
   server: () => server,
+  setup: () => setup,
   toGsm7: () => toGsm7,
   token: () => token,
   validateCRMSchema: () => validateCRMSchema,
@@ -1674,6 +1677,8 @@ var EntityFieldDefinitionSchema = import_v48.z.object({
     "datetime",
     "object"
   ]).optional(),
+  isUnique: import_v48.z.boolean().optional(),
+  /** @deprecated Prefer isUnique */
   matchCandidate: import_v48.z.boolean().optional(),
   required: import_v48.z.boolean().optional(),
   options: import_v48.z.array(
@@ -2114,16 +2119,10 @@ var ListBlockDefinitionSchema = import_v48.z.object({
   icon: import_v48.z.string().optional(),
   emptyMessage: import_v48.z.string().optional()
 });
-var ModelMapperBlockDefinitionSchema = import_v48.z.object({
-  type: import_v48.z.literal("model_mapper"),
-  /** The SHARED model handle from install config (e.g., "client", "patient") */
-  model: import_v48.z.string()
-});
 var PageBlockDefinitionSchema = import_v48.z.union([
   CardBlockDefinitionSchema,
   LegacyFormBlockDefinitionSchema,
-  ListBlockDefinitionSchema,
-  ModelMapperBlockDefinitionSchema
+  ListBlockDefinitionSchema
 ]);
 var PageContextModeSchema = import_v48.z.enum(["first", "many", "count", "all"]).transform((val) => val === "all" ? "many" : val);
 var PageContextFiltersSchema = import_v48.z.record(
@@ -2262,6 +2261,20 @@ var InstallConfigSchema = import_v48.z.object({
   /** Relationship definitions between SHARED models */
   relationships: import_v48.z.array(RelationshipDefinitionSchema).optional()
 });
+var SetupStepKindSchema = import_v48.z.enum(["app", "crm", "realtime", "env"]);
+var SetupStepDefinitionSchema = import_v48.z.object({
+  handle: import_v48.z.string(),
+  label: import_v48.z.string(),
+  description: import_v48.z.string().optional(),
+  kind: SetupStepKindSchema,
+  requires: import_v48.z.array(import_v48.z.string()).optional(),
+  entities: import_v48.z.array(import_v48.z.string()).optional(),
+  workflowHandles: import_v48.z.array(import_v48.z.string()).optional(),
+  envKeys: import_v48.z.array(import_v48.z.string()).optional(),
+  listenToCrm: import_v48.z.boolean().optional(),
+  listenToEnv: import_v48.z.boolean().optional(),
+  capabilities: import_v48.z.array(import_v48.z.string()).optional()
+});
 var ProvisionConfigSchema = import_v48.z.object({
   env: EnvSchemaSchema.optional(),
   /** INTERNAL model definitions (app-owned, not visible to users) */
@@ -2274,7 +2287,9 @@ var ProvisionConfigSchema = import_v48.z.object({
   workflows: import_v48.z.array(WorkflowDefinitionSchema).optional(),
   /** Base navigation configuration for all pages (can be overridden per page) */
   navigation: NavigationConfigSchema.optional(),
-  pages: import_v48.z.array(PageDefinitionSchema).optional()
+  pages: import_v48.z.array(PageDefinitionSchema).optional(),
+  /** Install setup checklist steps (opt-in) */
+  setup: import_v48.z.array(SetupStepDefinitionSchema).optional()
 });
 var SkedyulConfigSchema = import_v48.z.object({
   name: import_v48.z.string(),
@@ -3923,6 +3938,47 @@ var report = {
     return data;
   }
 };
+var setup = {
+  async list() {
+    const { data } = await callCore("setup.list", {});
+    return data;
+  },
+  async get(handle) {
+    const { data } = await callCore("setup.get", {
+      handle
+    });
+    return data;
+  },
+  async complete(handle, metadata) {
+    const { data } = await callCore("setup.complete", {
+      handle,
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async skip(handle, metadata) {
+    const { data } = await callCore("setup.skip", {
+      handle,
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async invalidate(handle, reason, metadata) {
+    const { data } = await callCore("setup.invalidate", {
+      handle,
+      ...reason ? { reason } : {},
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async capabilities() {
+    const { data } = await callCore(
+      "setup.capabilities",
+      {}
+    );
+    return data.capabilities;
+  }
+};
 
 // src/ratelimit/context.ts
 var import_async_hooks2 = require("async_hooks");
@@ -4957,6 +5013,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)) {
@@ -5343,6 +5465,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) {
@@ -5704,6 +5834,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);
     }
@@ -6179,6 +6312,9 @@ function defineEnv(env) {
 function defineNavigation(navigation) {
   return navigation;
 }
+function defineSetupStep(step) {
+  return step;
+}
 
 // src/config/schema-loader.ts
 var fs4 = __toESM(require("fs"));
@@ -8717,7 +8853,6 @@ var index_default = { z: import_v414.z };
   ModelDefinitionSchema,
   ModelDependencySchema,
   ModelFieldDefinitionSchema,
-  ModelMapperBlockDefinitionSchema,
   MoneyMinorRangeSchema,
   NavigationBreadcrumbSchema,
   NavigationConfigSchema,
@@ -8768,6 +8903,8 @@ var index_default = { z: import_v414.z };
   SequencerContextError,
   SequencerLockError,
   SequencerNotFoundError,
+  SetupStepDefinitionSchema,
+  SetupStepKindSchema,
   SkedyulConfigSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
@@ -8862,6 +8999,7 @@ var index_default = { z: import_v414.z };
   defineNavigation,
   definePage,
   defineSchema,
+  defineSetupStep,
   defineSkill,
   defineWorkflow,
   defineWorkflowYAML,
@@ -8923,6 +9061,7 @@ var index_default = { z: import_v414.z };
   sequencerAllow,
   sequencerRelease,
   server,
+  setup,
   toGsm7,
   token,
   validateCRMSchema,

package/dist/schemas.d.ts

@@ -352,6 +352,7 @@ export declare const EntityFieldDefinitionSchema: z.ZodObject<{
         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<{
@@ -383,6 +384,7 @@ export declare const EntityDefinitionSchema: z.ZodObject<{
             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<{
@@ -403,6 +405,7 @@ export declare const EntityDefinitionSchema: z.ZodObject<{
             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<{
@@ -2166,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">;
@@ -2569,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<{
@@ -3119,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;
@@ -3341,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;
@@ -3471,6 +3487,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                 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<{
@@ -3491,6 +3508,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                 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<{
@@ -4091,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;
@@ -4128,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;
@@ -4269,6 +4302,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                     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<{
@@ -4289,6 +4323,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                     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<{
@@ -4889,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;
@@ -4926,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;
@@ -4987,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>;
@@ -4999,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);
     }