skedyul 1.7.0 → 1.7.1

package/dist/cli/index.js

@@ -3870,6 +3870,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)) {
@@ -4261,6 +4327,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) {
@@ -4622,6 +4696,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/config/app-config.d.ts

@@ -6,7 +6,7 @@
 import type { ToolRegistry, WebhookRegistry, ToolMetadata, WebhookMetadata } from '../types';
 import type { ServerHooks } from '../types/handlers';
 import type { CoreApiConfig } from '../core/types';
-import type { EnvSchema, ComputeLayer, ModelDefinition, EntityDefinition, RelationshipDefinition, ChannelDefinition, WorkflowDefinition, PageDefinition, NavigationConfig, AgentDefinition, SignalDefinition } from './types';
+import type { EnvSchema, ComputeLayer, ModelDefinition, EntityDefinition, RelationshipDefinition, ChannelDefinition, WorkflowDefinition, PageDefinition, NavigationConfig, AgentDefinition, SignalDefinition, SetupStepDefinition } from './types';
 import type { AppEventDefinition } from './types/app-event';
 import type { QueueRegistry, SerializableQueueConfig } from './queue-config';
 import type { SequencerRegistry, SerializableSequencerConfig } from './sequencer-config';
@@ -50,6 +50,11 @@ export interface ProvisionConfig {
     pages?: PageDefinition[];
     /** App signal definitions (event bus subscriptions created on install) */
     signals?: SignalDefinition[];
+    /**
+     * Install setup checklist steps (opt-in).
+     * Seeded as AppInstallSetupStep rows; exposed via setup.* Core API.
+     */
+    setup?: SetupStepDefinition[];
 }
 /**
  * Build configuration - controls how the integration is bundled.

package/dist/config/define.d.ts

@@ -23,6 +23,7 @@ import type { WorkflowDefinition } from './types/workflow';
 import type { AgentDefinition } from './types/agent';
 import type { EnvSchema } from './types/env';
 import type { NavigationConfig } from './types/navigation';
+import type { SetupStepDefinition } from './types/setup';
 /**
  * Define a model with full type safety.
  *
@@ -150,3 +151,18 @@ export declare function defineEnv(env: EnvSchema): EnvSchema;
  * })
  */
 export declare function defineNavigation(navigation: NavigationConfig): NavigationConfig;
+/**
+ * Define an install setup step with full type safety.
+ *
+ * @example
+ * export default defineSetupStep({
+ *   handle: 'crm_members_bookings_events',
+ *   label: 'Setup Members, Bookings and Events',
+ *   kind: 'crm',
+ *   requires: ['access_granted'],
+ *   entities: ['member', 'booking', 'event'],
+ *   listenToCrm: true,
+ *   capabilities: ['crm.member', 'crm.booking', 'crm.event'],
+ * })
+ */
+export declare function defineSetupStep(step: SetupStepDefinition): SetupStepDefinition;

package/dist/config/index.d.ts

@@ -11,7 +11,7 @@
 export * from './types';
 export type { InstallConfig, ProvisionConfig, BuildConfig, CorsOptions, SkedyulConfig, SerializableSkedyulConfig, QueueScope, QueueConfig, SerializableQueueConfig, QueueRegistry, SequencerScope, SerializableSequencerConfig, SequencerRegistry, } from './app-config';
 export { defineConfig } from './app-config';
-export { defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, } from './define';
+export { defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, defineSetupStep, } from './define';
 export { SCHEMA_FILE_EXTENSIONS, loadSchema, saveSchema, serializeSchemaToJson, serializeSchemaToTypeScript, transformToBackendSchema, transformFromBackendSchema, type LoadSchemaOptions, type LoadSchemaResult, type SerializeSchemaOptions, type BackendModelDefinition, type BackendFieldDefinition, type BackendRelationshipDefinition, type BackendDesiredSchema, } from './schema-loader';
 export { loadAndResolveConfig, serializeResolvedConfig, type ResolvedConfig } from './resolver';
 export { getAllEnvKeys, getRequiredInstallEnvKeys } from './utils';

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

@@ -18,7 +18,15 @@ export interface EntityFieldDefinition {
     description?: string;
     /** Data type hint for the install mapper UI */
     type?: 'string' | 'long_string' | 'number' | 'boolean' | 'date' | 'datetime' | 'object';
-    /** Whether this field is a candidate for upsert match */
+    /**
+     * Whether this field uniquely identifies a record and can be used as an
+     * upsert match key (e.g. external id, email, phone).
+     */
+    isUnique?: boolean;
+    /**
+     * @deprecated Prefer `isUnique`. Kept for backward compatibility —
+     * treated the same as `isUnique` by the CRM map editor.
+     */
     matchCandidate?: boolean;
     /** Whether this field should be mapped for a complete configuration */
     required?: boolean;

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

@@ -352,15 +352,7 @@ export interface ListBlock {
     /** Message when no items */
     emptyMessage?: string;
 }
-/**
- * Model mapper block definition - for mapping SHARED models to workspace models.
- */
-export interface ModelMapperBlock {
-    type: 'model_mapper';
-    /** The SHARED model handle from provision config */
-    model: string;
-}
 /**
  * Union of all block types.
  */
-export type BlockDefinition = CardBlock | ListBlock | ModelMapperBlock;
+export type BlockDefinition = CardBlock | ListBlock;

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * App install setup step definition for provision config.
+ *
+ * Declared steps are seeded onto each AppInstallation as AppInstallSetupStep
+ * rows. Apps and the platform UI read/update status via the setup.* Core API.
+ */
+export type SetupStepKind = 'app' | 'crm' | 'realtime' | 'env';
+export interface SetupStepDefinition {
+    /** Stable step handle (unique within the app) */
+    handle: string;
+    /** UI label */
+    label: string;
+    /** Optional longer description */
+    description?: string;
+    /** Step kind — drives default CTAs and listeners */
+    kind: SetupStepKind;
+    /** Prerequisite step handles that must be READY */
+    requires?: string[];
+    /** CRM entity handles this step covers (kind: crm) */
+    entities?: string[];
+    /** Bundled workflow handles this step wires (kind: realtime) */
+    workflowHandles?: string[];
+    /** Env keys this step depends on (kind: env) */
+    envKeys?: string[];
+    /**
+     * When true, platform emits install.setup.crm_changed after CRM migrations
+     * and invokes hooks.setup.revalidate so the app can complete/invalidate.
+     */
+    listenToCrm?: boolean;
+    /**
+     * When true, platform emits install.setup.env_changed when matching env
+     * keys are removed/cleared and invokes hooks.setup.revalidate.
+     */
+    listenToEnv?: boolean;
+    /** Capability keys unlocked when this step is READY */
+    capabilities?: string[];
+}

package/dist/core/client.d.ts

@@ -1241,4 +1241,43 @@ export declare const report: {
      */
     get(handle: string): Promise<ReportDefinition | null>;
 };
+export type SetupStepStatus = 'PENDING' | 'READY' | 'SKIPPED' | 'INVALIDATED' | 'BLOCKED';
+export type SetupStepKindApi = 'APP' | 'CRM' | 'REALTIME' | 'ENV';
+export type SetupStepView = {
+    id: string;
+    handle: string;
+    kind: SetupStepKindApi;
+    status: SetupStepStatus;
+    sortOrder: number;
+    label: string;
+    description: string | null;
+    requires: string[];
+    config: {
+        entities?: string[];
+        workflowHandles?: string[];
+        envKeys?: string[];
+        listenToCrm?: boolean;
+        listenToEnv?: boolean;
+        capabilities?: string[];
+    };
+    completedAt: string | null;
+    skippedAt: string | null;
+    invalidatedAt: string | null;
+    metadata: Record<string, unknown> | null;
+};
+export type SetupListResult = {
+    steps: SetupStepView[];
+    capabilities: Record<string, boolean>;
+};
+/**
+ * Install setup checklist API (requires sk_wkp_ token).
+ */
+export declare const setup: {
+    list(): Promise<SetupListResult>;
+    get(handle: string): Promise<SetupStepView | null>;
+    complete(handle: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
+    skip(handle: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
+    invalidate(handle: string, reason?: string, metadata?: Record<string, unknown>): Promise<SetupStepView>;
+    capabilities(): Promise<Record<string, boolean>>;
+};
 export {};

package/dist/dedicated/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/esm/index.mjs

@@ -1303,6 +1303,8 @@ var EntityFieldDefinitionSchema = z8.object({
     "datetime",
     "object"
   ]).optional(),
+  isUnique: z8.boolean().optional(),
+  /** @deprecated Prefer isUnique */
   matchCandidate: z8.boolean().optional(),
   required: z8.boolean().optional(),
   options: z8.array(
@@ -1743,16 +1745,10 @@ var ListBlockDefinitionSchema = z8.object({
   icon: z8.string().optional(),
   emptyMessage: z8.string().optional()
 });
-var ModelMapperBlockDefinitionSchema = z8.object({
-  type: z8.literal("model_mapper"),
-  /** The SHARED model handle from install config (e.g., "client", "patient") */
-  model: z8.string()
-});
 var PageBlockDefinitionSchema = z8.union([
   CardBlockDefinitionSchema,
   LegacyFormBlockDefinitionSchema,
-  ListBlockDefinitionSchema,
-  ModelMapperBlockDefinitionSchema
+  ListBlockDefinitionSchema
 ]);
 var PageContextModeSchema = z8.enum(["first", "many", "count", "all"]).transform((val) => val === "all" ? "many" : val);
 var PageContextFiltersSchema = z8.record(
@@ -1891,6 +1887,20 @@ var InstallConfigSchema = z8.object({
   /** Relationship definitions between SHARED models */
   relationships: z8.array(RelationshipDefinitionSchema).optional()
 });
+var SetupStepKindSchema = z8.enum(["app", "crm", "realtime", "env"]);
+var SetupStepDefinitionSchema = z8.object({
+  handle: z8.string(),
+  label: z8.string(),
+  description: z8.string().optional(),
+  kind: SetupStepKindSchema,
+  requires: z8.array(z8.string()).optional(),
+  entities: z8.array(z8.string()).optional(),
+  workflowHandles: z8.array(z8.string()).optional(),
+  envKeys: z8.array(z8.string()).optional(),
+  listenToCrm: z8.boolean().optional(),
+  listenToEnv: z8.boolean().optional(),
+  capabilities: z8.array(z8.string()).optional()
+});
 var ProvisionConfigSchema = z8.object({
   env: EnvSchemaSchema.optional(),
   /** INTERNAL model definitions (app-owned, not visible to users) */
@@ -1903,7 +1913,9 @@ var ProvisionConfigSchema = z8.object({
   workflows: z8.array(WorkflowDefinitionSchema).optional(),
   /** Base navigation configuration for all pages (can be overridden per page) */
   navigation: NavigationConfigSchema.optional(),
-  pages: z8.array(PageDefinitionSchema).optional()
+  pages: z8.array(PageDefinitionSchema).optional(),
+  /** Install setup checklist steps (opt-in) */
+  setup: z8.array(SetupStepDefinitionSchema).optional()
 });
 var SkedyulConfigSchema = z8.object({
   name: z8.string(),
@@ -3552,6 +3564,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
 import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
@@ -4586,6 +4639,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)) {
@@ -4972,6 +5091,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) {
@@ -5333,6 +5460,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);
     }
@@ -5808,6 +5938,9 @@ function defineEnv(env) {
 function defineNavigation(navigation) {
   return navigation;
 }
+function defineSetupStep(step) {
+  return step;
+}
 
 // src/config/schema-loader.ts
 import * as fs4 from "fs";
@@ -8345,7 +8478,6 @@ export {
   ModelDefinitionSchema,
   ModelDependencySchema,
   ModelFieldDefinitionSchema,
-  ModelMapperBlockDefinitionSchema,
   MoneyMinorRangeSchema,
   NavigationBreadcrumbSchema,
   NavigationConfigSchema,
@@ -8396,6 +8528,8 @@ export {
   SequencerContextError,
   SequencerLockError,
   SequencerNotFoundError,
+  SetupStepDefinitionSchema,
+  SetupStepKindSchema,
   SkedyulConfigSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
@@ -8491,6 +8625,7 @@ export {
   defineNavigation,
   definePage,
   defineSchema,
+  defineSetupStep,
   defineSkill,
   defineWorkflow,
   defineWorkflowYAML,
@@ -8552,6 +8687,7 @@ export {
   allow as sequencerAllow,
   release as sequencerRelease,
   server,
+  setup,
   toGsm7,
   token,
   validateCRMSchema,

package/dist/index.d.ts

@@ -8,15 +8,15 @@ export { DEFAULT_DOCKERFILE } from './dockerfile';
 export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidConfigurationError, ConnectionError, AppAuthInvalidError, } from './errors';
 export type { InstallErrorCode } from './errors';
 export { z };
-export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, call, report, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
-export type { InstanceClient, InstanceContext, InstanceData, InstanceEnv, InstanceWriteOptions, InstanceGetOptions, InstanceCreateManyItem, InstanceUpdateManyItem, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CallStartParams, CallStartResult, CallAppendTranscriptParams, CallEndParams, CallSummarizeResult, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, } from './core/client';
+export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, call, report, setup, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
+export type { InstanceClient, InstanceContext, InstanceData, InstanceEnv, InstanceWriteOptions, InstanceGetOptions, InstanceCreateManyItem, InstanceUpdateManyItem, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CallStartParams, CallStartResult, CallAppendTranscriptParams, CallEndParams, CallSummarizeResult, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, SetupStepStatus, SetupStepKindApi, SetupStepView, SetupListResult, } from './core/client';
 export { createContextLogger } from './server/logger';
 export type { ContextLogger } from './server/logger';
 declare const _default: {
     z: typeof z;
 };
 export default _default;
-export { defineConfig, defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
+export { defineConfig, defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, defineSetupStep, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
 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 { sequencer, allow as sequencerAllow, acquire as sequencerAcquire, release as sequencerRelease, resolveSequencer, createSequencerHandle, registerSequencerConfig, clearRegisteredSequencerConfig, getSequencerConfig, getSequencerDefinitions, resetSequencerBackendForTests, memorySequencerBackend, platformSequencerBackend, SequencerContextError, SequencerNotFoundError, SequencerBackendError, SequencerLockError, } from './sequencer';
@@ -35,7 +35,7 @@ export type { CRMContext, SenderContext, ThreadContextItem, ThreadInfo, SandboxC
 export { MemoryEntryTypeSchema, MemoryEntrySchema, WorkingMemoryConfigSchema, SemanticMemoryConfigSchema, ExternalMemoryConfigSchema, MemoryConfigSchema, MemoryScopeSchema, MemoryQueryOptionsSchema, ConversationSummarySchema, AgentObservationSchema, ExternalDataCacheSchema, MemoryService, InMemoryStore, createInMemoryService, } from './memory';
 export type { MemoryEntryType, MemoryEntry, WorkingMemoryConfig as MemoryWorkingConfig, SemanticMemoryConfig as MemorySemanticConfig, ExternalMemoryConfig as MemoryExternalConfig, MemoryConfig, MemoryScope, MemoryQueryOptions, ConversationSummary, AgentObservation, ExternalDataCache, MemoryStore, } from './memory';
 export type { CRMFieldType, CRMFieldRequirement, CRMFieldOption, CRMFieldDefinition, CRMFieldSchema, CRMModelSchema, CRMCardinality, CRMOnDelete, CRMRelationshipLink, CRMRelationshipSchema, CRMSchema, CRMSchemaValidationResult, } from './schemas';
-export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelBatchCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, FormActionDefinition, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, ModelMapperBlock, BlockDefinition, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';
+export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelBatchCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, FormActionDefinition, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, BlockDefinition, SetupStepDefinition, SetupStepKind, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';
 export { compileAgent, compileWorkflow } from './compiler';
 export type { ValidationError, ValidationWarning, ResolvedPersona, ResolvedTool, EventConfig as CompilerEventConfig, IRMemoryConfig, PolicyConfig, IRRuntimeConfig, AgentIR, WorkflowStepIR, WorkflowIR, CompilationResult, } from './compiler';
 export { TimeStampSchema, DayOfWeekSchema, TimeWindowSlotSchema, WaitUnitSchema, WaitInputRelativeSchema, WaitInputAbsoluteSchema, WaitInputSchema, } from './scheduling/types';