skedyul 1.7.15 → 1.7.17

package/dist/.build-stamp

@@ -1 +1 @@
-1786107275036
+1786320274767

package/dist/cli/index.js

@@ -1206,7 +1206,7 @@ function parseInstallConfigFromSource(content) {
   return parseEnvConfigFromSource(content);
 }
 var INSTALL_HANDLER_PATHS = [
-  // Standard integration layout (used by bft, petbooqz, phone, etc.)
+  // Standard integration layout (used by public/private integration apps)
   "src/server/hooks/install.ts",
   "src/server/hooks/install.js",
   "dist/server/hooks/install.js",
@@ -6403,7 +6403,12 @@ var CRMFieldSchemaZ = import_v42.z.object({
   unique: import_v42.z.boolean().optional(),
   list: import_v42.z.boolean().optional(),
   default: import_v42.z.unknown().optional(),
-  definition: CRMFieldDefinitionSchema.optional()
+  definition: CRMFieldDefinitionSchema.optional(),
+  /**
+   * Workplace-scoped field section handle (visualization helper).
+   * Find-or-create on apply; display name is derived from the handle on create.
+   */
+  section: import_v42.z.string().regex(/^[a-z][a-z0-9_-]*$/, "Section handle must be lowercase alphanumeric with underscores/hyphens, starting with a letter").optional()
 });
 var CRMModelSchemaZ = import_v42.z.object({
   handle: import_v42.z.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),

package/dist/config/define.d.ts

@@ -45,14 +45,14 @@ export declare function defineModel(model: ModelDefinition): ModelDefinition;
  *
  * Entities describe external payload shapes that workplaces map to CRM at
  * install time. They are not shared models — workflows apply maps via Liquid
- * filters named after the app handle (e.g. `| bft: "format", "member"`).
+ * filters named after the app handle (e.g. `| acme: "format", "member"`).
  *
  * @example
  * export default defineEntity({
  *   handle: 'member',
- *   label: 'Glofox Member',
+ *   label: 'Member',
  *   fields: [
- *     { handle: 'glofox_id', label: 'Glofox ID', matchCandidate: true, required: true },
+ *     { handle: 'external_id', label: 'External ID', matchCandidate: true, required: true },
  *     { handle: 'first_name', label: 'First Name' },
  *   ],
  *   contextFields: [
@@ -120,8 +120,8 @@ export declare function defineAgent(agent: AgentDefinition): AgentDefinition;
  *
  * @example
  * export default defineEnv({
- *   TWILIO_ACCOUNT_SID: {
- *     label: 'Twilio Account SID',
+ *   ACME_API_KEY: {
+ *     label: 'Acme API Key',
  *     scope: 'provision',
  *     required: true,
  *     visibility: 'encrypted'
@@ -179,12 +179,12 @@ export declare function defineSetupStep(step: SetupStepDefinition): SetupStepDef
  *   label: 'Import Members',
  *   entity: 'member',
  *   setup: async (ctx) => {
- *     const count = await glofox.getMemberCount()
+ *     const count = await acmeApi.getMemberCount()
  *     return { total: count }
  *   },
  *   iterate: async (ctx) => {
- *     const apiKey = ctx.env.GLOFOX_API_KEY
- *     const { data, pagination } = await glofox.getMembers({
+ *     const apiKey = ctx.env.ACME_API_KEY
+ *     const { data, pagination } = await acmeApi.getMembers({
  *       apiKey,
  *       limit: ctx.limit,
  *       offset: ctx.cursor ?? 0,

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

@@ -2,7 +2,7 @@
  * 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).
+ * `app.{appHandle}.{name}` (e.g. app.acme.member.updated).
  */
 export interface AppEventDefinition {
     /** Event suffix after app handle, e.g. member.created */
@@ -16,7 +16,7 @@ export interface AppEventDefinition {
     /** Optional Lucide icon name for pickers */
     icon?: string;
     /**
-     * Example flat domain payload for liquid context reference (e.g. glofox_id, phone, …).
+     * Example flat domain payload for liquid context reference (e.g. external_id, phone, …).
      * Not the full emit payload — studio/branch metadata is added at emit time.
      */
     examplePayload?: Record<string, unknown>;
@@ -26,7 +26,7 @@ export interface AppEventDefinition {
      */
     contextFields?: AppEventContextField[];
     /**
-     * Workflow input type for app-event payloads, e.g. @app/bft/member/updated.
+     * Workflow input type for app-event payloads, e.g. @app/acme/member/updated.
      * Workflows declare this on inputs.data and subscribe with {{ data }}.
      */
     workflowInputType?: string;

package/dist/config/types/batch-operation.d.ts

@@ -157,12 +157,12 @@ export type BatchOperationIterateFn = (ctx: BatchOperationContext & {
  *   label: 'Import Members',
  *   entity: 'member',
  *   setup: async (ctx) => {
- *     const count = await glofox.getMemberCount()
+ *     const count = await acmeApi.getMemberCount()
  *     return { total: count }
  *   },
  *   iterate: async (ctx) => {
- *     const apiKey = ctx.env.GLOFOX_API_KEY
- *     const { data, pagination } = await glofox.getMembers({
+ *     const apiKey = ctx.env.ACME_API_KEY
+ *     const { data, pagination } = await acmeApi.getMembers({
  *       apiKey,
  *       limit: ctx.limit,
  *       offset: ctx.cursor ?? 0,

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

@@ -1,11 +1,32 @@
 /**
  * App entity definition types.
  *
- * Entities describe external/logical payload shapes (e.g. Glofox member) that
- * workplaces map to CRM via install-time CRM maps. They are NOT shared models —
- * the app does not own CRM writes; workflows/agents apply maps.
+ * Entities describe external/logical payload shapes that workplaces map to CRM
+ * via install-time CRM maps. They are NOT shared models — the app does not own
+ * CRM writes; workflows/agents apply maps.
  */
 import type { BaseDefinition, FieldOption } from './base';
+/**
+ * Suggested CRM map defaults for an entity when a workplace has matching models.
+ * Declared by the app (industry-specific); consumed generically by core install UI.
+ */
+export interface EntityCrmMapDefaults {
+    /** Workplace model handle to prefer */
+    modelHandle: string;
+    /** Prefer this field as match when present on the model */
+    matchFieldHandle?: string;
+    /** Ordered entity paths for match fallbacks (maps to same-named CRM fields) */
+    matchRuleEntityPaths?: string[];
+    /** entityPath → workplace field handle */
+    fieldHandles: Record<string, string>;
+    /** entity relationship handle → workplace field handle */
+    relationshipHandles?: Record<string, string>;
+    /**
+     * Optional enum remaps per entity path when suggesting valueMaps
+     * (e.g. membership_status: { trial_member: 'visiting_member' }).
+     */
+    valueAliases?: Record<string, Record<string, string>>;
+}
 /**
  * Field on an app entity contract (maps to a path on tool/event payloads).
  */
@@ -64,4 +85,9 @@ export interface EntityDefinition extends BaseDefinition {
     contextFields?: EntityFieldDefinition[];
     /** Relationship handles that can be mapped to CRM relationship fields */
     relationships?: EntityRelationshipDefinition[];
+    /**
+     * Optional suggested CRM map when the workplace has a matching model schema.
+     * Used by install suggest/analyze — not applied automatically.
+     */
+    crmMapDefaults?: EntityCrmMapDefaults;
 }

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

@@ -139,6 +139,11 @@ export interface FieldDefinition {
     owner?: FieldOwner;
     /** AI-specific metadata for agent interactions */
     aiMeta?: FieldAIMeta;
+    /**
+     * Workplace-scoped field section handle (visualization helper).
+     * Find-or-create on provision/schema apply.
+     */
+    section?: string;
 }
 /**
  * Model definition.

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

@@ -34,4 +34,16 @@ export interface SetupStepDefinition {
     listenToEnv?: boolean;
     /** Capability keys unlocked when this step is READY */
     capabilities?: string[];
+    /**
+     * Optional tool handle for an APP-step CTA (invoked as page_action with no form).
+     * Declared by the app — platform UI must not hardcode app/tool names.
+     */
+    actionTool?: string;
+    /** Optional label for the APP-step CTA button */
+    actionLabel?: string;
+    /**
+     * Optional install-relative path for post-setup navigation
+     * (e.g. `/leads`). Prefer entity pages over industry-specific defaults.
+     */
+    href?: string;
 }

package/dist/core/client.d.ts

@@ -98,7 +98,7 @@ export interface ReceiveMessageInput {
     message: CreateMessageType;
     /** Optional contact metadata to associate the message */
     contact?: ReceiveMessageContact;
-    /** Optional remote/external message ID (e.g., Twilio MessageSid) */
+    /** Optional remote/external message ID (provider message id) */
     remoteId?: string;
 }
 /**
@@ -176,7 +176,7 @@ export declare const communicationChannel: {
      * Receive an inbound message on a communication channel.
      *
      * This is typically called from webhook handlers to process incoming messages
-     * (e.g., SMS from Twilio, emails, WhatsApp messages).
+     * (e.g., SMS, email, or messaging-channel providers).
      *
      * @example
      * ```ts
@@ -185,7 +185,7 @@ export declare const communicationChannel: {
      *   communicationChannelId: channel.id,
      *   from: '+1234567890',
      *   message: 'Hello!',
-     *   remoteId: 'twilio-message-sid-123',
+     *   remoteId: 'provider-message-id-123',
      * });
      * ```
      */
@@ -617,14 +617,14 @@ export declare const webhook: {
      *
      * @example
      * ```ts
-     * // Create a webhook for Twilio compliance callbacks
+     * // Create a webhook for provider compliance callbacks
      * const { url, id } = await webhook.create('compliance_status', {
      *   bundleSid: bundle.sid,
      *   complianceRecordId: record.id,
      * })
      *
-     * // Pass the URL to Twilio
-     * await twilioClient.bundles(bundle.sid).update({
+     * // Pass the URL to the upstream provider
+     * await providerClient.updateBundle(bundle.sid, {
      *   statusCallback: url,
      * })
      * ```
@@ -1022,18 +1022,18 @@ export declare const ai: {
     generateObject<S extends z.ZodTypeAny>(options: GenerateObjectOptions<S>): Promise<z.infer<S>>;
 };
 export interface CallStartParams {
-    /** Communication channel (the Twilio number) this call belongs to */
+    /** Communication channel (voice number) this call belongs to */
     communicationChannelId: string;
     /** Caller number in E.164 */
     fromNumber: string;
-    /** The dialed number (our Twilio number) in E.164 */
+    /** The dialed number (our channel number) in E.164 */
     toNumber: string;
     /** Number the call is forwarded/dialed to (the human agent leg) */
     forwardedToNumber?: string | null;
     direction?: 'INBOUND' | 'OUTBOUND';
-    /** Provider call id (Twilio CallSid) */
+    /** Provider call id (opaque) */
     externalId?: string | null;
-    /** Raw provider status string (e.g. Twilio "ringing") */
+    /** Raw provider status string (opaque; not interpreted by the platform) */
     externalStatus?: string | null;
     /** Transcription provider/engine name (e.g. "deepgram", "google") */
     transcriptionEngine?: string | null;
@@ -1075,10 +1075,10 @@ export interface CallSummarizeResult {
 /**
  * Call client - manage a voice call session and its real-time transcript.
  *
- * Designed for the phone integration's Twilio Real-Time Transcription webhooks:
+ * Typical phone-integration flow:
  * - `start` when the inbound call arrives (creates the CallSession + thread + CALL block)
- * - `appendTranscript` for each `transcription-content` event (stored as a tagged ThreadMessage)
- * - `end` on call completion / `transcription-stopped`
+ * - `appendTranscript` for each transcription event (stored as a tagged ThreadMessage)
+ * - `end` on call completion (pass an explicit platform `status`)
  * - `summarize` to generate and persist an end-of-call summary
  *
  * **Requires sk_wkp_ or sk_app_ token.**

package/dist/esm/index.mjs

@@ -376,7 +376,12 @@ var CRMFieldSchemaZ = z3.object({
   unique: z3.boolean().optional(),
   list: z3.boolean().optional(),
   default: z3.unknown().optional(),
-  definition: CRMFieldDefinitionSchema.optional()
+  definition: CRMFieldDefinitionSchema.optional(),
+  /**
+   * Workplace-scoped field section handle (visualization helper).
+   * Find-or-create on apply; display name is derived from the handle on create.
+   */
+  section: z3.string().regex(/^[a-z][a-z0-9_-]*$/, "Section handle must be lowercase alphanumeric with underscores/hyphens, starting with a letter").optional()
 });
 var CRMModelSchemaZ = z3.object({
   handle: z3.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
@@ -1335,6 +1340,14 @@ var EntityRelationshipDefinitionSchema = z8.object({
   targetEntity: z8.string().optional(),
   description: z8.string().optional()
 });
+var EntityCrmMapDefaultsSchema = z8.object({
+  modelHandle: z8.string(),
+  matchFieldHandle: z8.string().optional(),
+  matchRuleEntityPaths: z8.array(z8.string()).optional(),
+  fieldHandles: z8.record(z8.string(), z8.string()),
+  relationshipHandles: z8.record(z8.string(), z8.string()).optional(),
+  valueAliases: z8.record(z8.string(), z8.record(z8.string(), z8.string())).optional()
+});
 var EntityDefinitionSchema = z8.object({
   handle: z8.string(),
   label: z8.string(),
@@ -1342,7 +1355,8 @@ var EntityDefinitionSchema = z8.object({
   description: z8.string().optional(),
   fields: z8.array(EntityFieldDefinitionSchema),
   contextFields: z8.array(EntityFieldDefinitionSchema).optional(),
-  relationships: z8.array(EntityRelationshipDefinitionSchema).optional()
+  relationships: z8.array(EntityRelationshipDefinitionSchema).optional(),
+  crmMapDefaults: EntityCrmMapDefaultsSchema.optional()
 });
 var RelationshipCardinalitySchema = z8.enum([
   "ONE_TO_ONE",
@@ -1655,7 +1669,7 @@ var EventWiringPanelComponentDefinitionSchema = FormV2StylePropsSchema.extend({
       z8.object({
         type: z8.string(),
         label: z8.string(),
-        glofoxType: z8.string().optional(),
+        sourceType: z8.string().optional(),
         description: z8.string().optional(),
         icon: z8.string().optional()
       })
@@ -1914,7 +1928,10 @@ var SetupStepDefinitionSchema = z8.object({
   envKeys: z8.array(z8.string()).optional(),
   listenToCrm: z8.boolean().optional(),
   listenToEnv: z8.boolean().optional(),
-  capabilities: z8.array(z8.string()).optional()
+  capabilities: z8.array(z8.string()).optional(),
+  actionTool: z8.string().optional(),
+  actionLabel: z8.string().optional(),
+  href: z8.string().optional()
 });
 var BatchPaginationSchema = z8.object({
   hasMore: z8.boolean(),
@@ -2574,7 +2591,7 @@ var communicationChannel = {
    * Receive an inbound message on a communication channel.
    *
    * This is typically called from webhook handlers to process incoming messages
-   * (e.g., SMS from Twilio, emails, WhatsApp messages).
+   * (e.g., SMS, email, or messaging-channel providers).
    *
    * @example
    * ```ts
@@ -2583,7 +2600,7 @@ var communicationChannel = {
    *   communicationChannelId: channel.id,
    *   from: '+1234567890',
    *   message: 'Hello!',
-   *   remoteId: 'twilio-message-sid-123',
+   *   remoteId: 'provider-message-id-123',
    * });
    * ```
    */
@@ -3238,14 +3255,14 @@ var webhook = {
    *
    * @example
    * ```ts
-   * // Create a webhook for Twilio compliance callbacks
+   * // Create a webhook for provider compliance callbacks
    * const { url, id } = await webhook.create('compliance_status', {
    *   bundleSid: bundle.sid,
    *   complianceRecordId: record.id,
    * })
    *
-   * // Pass the URL to Twilio
-   * await twilioClient.bundles(bundle.sid).update({
+   * // Pass the URL to the upstream provider
+   * await providerClient.updateBundle(bundle.sid, {
    *   statusCallback: url,
    * })
    * ```
@@ -8829,6 +8846,7 @@ export {
   DatePickerComponentDefinitionSchema,
   DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema,
+  EntityCrmMapDefaultsSchema,
   EntityDefinitionSchema,
   EntityFieldDefinitionSchema,
   EntityRelationshipDefinitionSchema,

package/dist/index.js

@@ -88,6 +88,7 @@ __export(index_exports, {
   DatePickerComponentDefinitionSchema: () => DatePickerComponentDefinitionSchema,
   DayOfWeekSchema: () => DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema: () => EmptyFormComponentDefinitionSchema,
+  EntityCrmMapDefaultsSchema: () => EntityCrmMapDefaultsSchema,
   EntityDefinitionSchema: () => EntityDefinitionSchema,
   EntityFieldDefinitionSchema: () => EntityFieldDefinitionSchema,
   EntityRelationshipDefinitionSchema: () => EntityRelationshipDefinitionSchema,
@@ -764,7 +765,12 @@ var CRMFieldSchemaZ = import_v43.z.object({
   unique: import_v43.z.boolean().optional(),
   list: import_v43.z.boolean().optional(),
   default: import_v43.z.unknown().optional(),
-  definition: CRMFieldDefinitionSchema.optional()
+  definition: CRMFieldDefinitionSchema.optional(),
+  /**
+   * Workplace-scoped field section handle (visualization helper).
+   * Find-or-create on apply; display name is derived from the handle on create.
+   */
+  section: import_v43.z.string().regex(/^[a-z][a-z0-9_-]*$/, "Section handle must be lowercase alphanumeric with underscores/hyphens, starting with a letter").optional()
 });
 var CRMModelSchemaZ = import_v43.z.object({
   handle: import_v43.z.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
@@ -1723,6 +1729,14 @@ var EntityRelationshipDefinitionSchema = import_v48.z.object({
   targetEntity: import_v48.z.string().optional(),
   description: import_v48.z.string().optional()
 });
+var EntityCrmMapDefaultsSchema = import_v48.z.object({
+  modelHandle: import_v48.z.string(),
+  matchFieldHandle: import_v48.z.string().optional(),
+  matchRuleEntityPaths: import_v48.z.array(import_v48.z.string()).optional(),
+  fieldHandles: import_v48.z.record(import_v48.z.string(), import_v48.z.string()),
+  relationshipHandles: import_v48.z.record(import_v48.z.string(), import_v48.z.string()).optional(),
+  valueAliases: import_v48.z.record(import_v48.z.string(), import_v48.z.record(import_v48.z.string(), import_v48.z.string())).optional()
+});
 var EntityDefinitionSchema = import_v48.z.object({
   handle: import_v48.z.string(),
   label: import_v48.z.string(),
@@ -1730,7 +1744,8 @@ var EntityDefinitionSchema = import_v48.z.object({
   description: import_v48.z.string().optional(),
   fields: import_v48.z.array(EntityFieldDefinitionSchema),
   contextFields: import_v48.z.array(EntityFieldDefinitionSchema).optional(),
-  relationships: import_v48.z.array(EntityRelationshipDefinitionSchema).optional()
+  relationships: import_v48.z.array(EntityRelationshipDefinitionSchema).optional(),
+  crmMapDefaults: EntityCrmMapDefaultsSchema.optional()
 });
 var RelationshipCardinalitySchema = import_v48.z.enum([
   "ONE_TO_ONE",
@@ -2043,7 +2058,7 @@ var EventWiringPanelComponentDefinitionSchema = FormV2StylePropsSchema.extend({
       import_v48.z.object({
         type: import_v48.z.string(),
         label: import_v48.z.string(),
-        glofoxType: import_v48.z.string().optional(),
+        sourceType: import_v48.z.string().optional(),
         description: import_v48.z.string().optional(),
         icon: import_v48.z.string().optional()
       })
@@ -2302,7 +2317,10 @@ var SetupStepDefinitionSchema = import_v48.z.object({
   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()
+  capabilities: import_v48.z.array(import_v48.z.string()).optional(),
+  actionTool: import_v48.z.string().optional(),
+  actionLabel: import_v48.z.string().optional(),
+  href: import_v48.z.string().optional()
 });
 var BatchPaginationSchema = import_v48.z.object({
   hasMore: import_v48.z.boolean(),
@@ -2962,7 +2980,7 @@ var communicationChannel = {
    * Receive an inbound message on a communication channel.
    *
    * This is typically called from webhook handlers to process incoming messages
-   * (e.g., SMS from Twilio, emails, WhatsApp messages).
+   * (e.g., SMS, email, or messaging-channel providers).
    *
    * @example
    * ```ts
@@ -2971,7 +2989,7 @@ var communicationChannel = {
    *   communicationChannelId: channel.id,
    *   from: '+1234567890',
    *   message: 'Hello!',
-   *   remoteId: 'twilio-message-sid-123',
+   *   remoteId: 'provider-message-id-123',
    * });
    * ```
    */
@@ -3626,14 +3644,14 @@ var webhook = {
    *
    * @example
    * ```ts
-   * // Create a webhook for Twilio compliance callbacks
+   * // Create a webhook for provider compliance callbacks
    * const { url, id } = await webhook.create('compliance_status', {
    *   bundleSid: bundle.sid,
    *   complianceRecordId: record.id,
    * })
    *
-   * // Pass the URL to Twilio
-   * await twilioClient.bundles(bundle.sid).update({
+   * // Pass the URL to the upstream provider
+   * await providerClient.updateBundle(bundle.sid, {
    *   statusCallback: url,
    * })
    * ```
@@ -9218,6 +9236,7 @@ var index_default = { z: import_v414.z };
   DatePickerComponentDefinitionSchema,
   DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema,
+  EntityCrmMapDefaultsSchema,
   EntityDefinitionSchema,
   EntityFieldDefinitionSchema,
   EntityRelationshipDefinitionSchema,

package/dist/schemas/crm-schema.d.ts

@@ -123,6 +123,7 @@ export declare const CRMFieldSchemaZ: z.ZodObject<{
         max: z.ZodOptional<z.ZodNumber>;
         pattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>]>>;
+    section: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CRMFieldSchema = z.infer<typeof CRMFieldSchemaZ>;
 /**
@@ -178,6 +179,7 @@ export declare const CRMModelSchemaZ: z.ZodObject<{
             max: z.ZodOptional<z.ZodNumber>;
             pattern: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>]>>;
+        section: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CRMModelSchema = z.infer<typeof CRMModelSchemaZ>;
@@ -378,6 +380,7 @@ export declare const CRMSchemaZ: z.ZodObject<{
                 max: z.ZodOptional<z.ZodNumber>;
                 pattern: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>]>>;
+            section: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/schemas.d.ts

@@ -394,6 +394,15 @@ export declare const EntityRelationshipDefinitionSchema: z.ZodObject<{
     targetEntity: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Suggested CRM map defaults declared on an entity (consumed generically by core). */
+export declare const EntityCrmMapDefaultsSchema: z.ZodObject<{
+    modelHandle: z.ZodString;
+    matchFieldHandle: z.ZodOptional<z.ZodString>;
+    matchRuleEntityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fieldHandles: z.ZodRecord<z.ZodString, z.ZodString>;
+    relationshipHandles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    valueAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strip>;
 export declare const EntityDefinitionSchema: z.ZodObject<{
     handle: z.ZodString;
     label: z.ZodString;
@@ -447,6 +456,14 @@ export declare const EntityDefinitionSchema: z.ZodObject<{
         targetEntity: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    crmMapDefaults: z.ZodOptional<z.ZodObject<{
+        modelHandle: z.ZodString;
+        matchFieldHandle: z.ZodOptional<z.ZodString>;
+        matchRuleEntityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fieldHandles: z.ZodRecord<z.ZodString, z.ZodString>;
+        relationshipHandles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        valueAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const RelationshipCardinalitySchema: z.ZodEnum<{
     ONE_TO_ONE: "ONE_TO_ONE";
@@ -1054,7 +1071,7 @@ export declare const EventWiringPanelComponentDefinitionSchema: z.ZodObject<{
         eventTypes: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
             label: z.ZodString;
-            glofoxType: z.ZodOptional<z.ZodString>;
+            sourceType: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             icon: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -1419,7 +1436,7 @@ export declare const FormV2ComponentDefinitionSchema: z.ZodDiscriminatedUnion<[z
         eventTypes: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
             label: z.ZodString;
-            glofoxType: z.ZodOptional<z.ZodString>;
+            sourceType: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             icon: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -1718,7 +1735,7 @@ export declare const FormV2PropsDefinitionSchema: z.ZodObject<{
             eventTypes: z.ZodArray<z.ZodObject<{
                 type: z.ZodString;
                 label: z.ZodString;
-                glofoxType: z.ZodOptional<z.ZodString>;
+                sourceType: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
                 icon: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
@@ -2058,7 +2075,7 @@ export declare const CardBlockDefinitionSchema: z.ZodObject<{
                 eventTypes: z.ZodArray<z.ZodObject<{
                     type: z.ZodString;
                     label: z.ZodString;
-                    glofoxType: z.ZodOptional<z.ZodString>;
+                    sourceType: z.ZodOptional<z.ZodString>;
                     description: z.ZodOptional<z.ZodString>;
                     icon: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
@@ -2497,7 +2514,7 @@ export declare const PageBlockDefinitionSchema: z.ZodUnion<readonly [z.ZodObject
                 eventTypes: z.ZodArray<z.ZodObject<{
                     type: z.ZodString;
                     label: z.ZodString;
-                    glofoxType: z.ZodOptional<z.ZodString>;
+                    sourceType: z.ZodOptional<z.ZodString>;
                     description: z.ZodOptional<z.ZodString>;
                     icon: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
@@ -3044,7 +3061,7 @@ export declare const PageDefinitionSchema: z.ZodObject<{
                     eventTypes: z.ZodArray<z.ZodObject<{
                         type: z.ZodString;
                         label: z.ZodString;
-                        glofoxType: z.ZodOptional<z.ZodString>;
+                        sourceType: z.ZodOptional<z.ZodString>;
                         description: z.ZodOptional<z.ZodString>;
                         icon: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
@@ -3400,6 +3417,9 @@ export declare const SetupStepDefinitionSchema: z.ZodObject<{
     listenToCrm: z.ZodOptional<z.ZodBoolean>;
     listenToEnv: z.ZodOptional<z.ZodBoolean>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    actionTool: z.ZodOptional<z.ZodString>;
+    actionLabel: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const BatchPaginationSchema: z.ZodObject<{
     hasMore: z.ZodBoolean;
@@ -3632,6 +3652,14 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
             targetEntity: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+        crmMapDefaults: z.ZodOptional<z.ZodObject<{
+            modelHandle: z.ZodString;
+            matchFieldHandle: z.ZodOptional<z.ZodString>;
+            matchRuleEntityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fieldHandles: z.ZodRecord<z.ZodString, z.ZodString>;
+            relationshipHandles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            valueAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
         source: z.ZodObject<{
@@ -4121,7 +4149,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                         eventTypes: z.ZodArray<z.ZodObject<{
                             type: z.ZodString;
                             label: z.ZodString;
-                            glofoxType: z.ZodOptional<z.ZodString>;
+                            sourceType: z.ZodOptional<z.ZodString>;
                             description: z.ZodOptional<z.ZodString>;
                             icon: z.ZodOptional<z.ZodString>;
                         }, z.core.$strip>>;
@@ -4270,6 +4298,9 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
         listenToCrm: z.ZodOptional<z.ZodBoolean>;
         listenToEnv: z.ZodOptional<z.ZodBoolean>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        actionTool: z.ZodOptional<z.ZodString>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     batchOperations: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
@@ -4481,6 +4512,14 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 targetEntity: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
+            crmMapDefaults: z.ZodOptional<z.ZodObject<{
+                modelHandle: z.ZodString;
+                matchFieldHandle: z.ZodOptional<z.ZodString>;
+                matchRuleEntityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fieldHandles: z.ZodRecord<z.ZodString, z.ZodString>;
+                relationshipHandles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                valueAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
             source: z.ZodObject<{
@@ -4970,7 +5009,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                             eventTypes: z.ZodArray<z.ZodObject<{
                                 type: z.ZodString;
                                 label: z.ZodString;
-                                glofoxType: z.ZodOptional<z.ZodString>;
+                                sourceType: z.ZodOptional<z.ZodString>;
                                 description: z.ZodOptional<z.ZodString>;
                                 icon: z.ZodOptional<z.ZodString>;
                             }, z.core.$strip>>;
@@ -5119,6 +5158,9 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             listenToCrm: z.ZodOptional<z.ZodBoolean>;
             listenToEnv: z.ZodOptional<z.ZodBoolean>;
             capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            actionTool: z.ZodOptional<z.ZodString>;
+            actionLabel: z.ZodOptional<z.ZodString>;
+            href: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         batchOperations: z.ZodOptional<z.ZodArray<z.ZodObject<{
             handle: z.ZodString;
@@ -5188,6 +5230,7 @@ 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 EntityCrmMapDefaults = z.infer<typeof EntityCrmMapDefaultsSchema>;
 export type EntityDefinition = z.infer<typeof EntityDefinitionSchema>;
 export type ChannelCapabilityType = z.infer<typeof ChannelCapabilityTypeSchema>;
 export type ChannelCapability = z.infer<typeof ChannelCapabilitySchema>;

package/dist/types/data-blocks.d.ts

@@ -7,6 +7,8 @@
  * Link structure for navigating to CRM views or external URLs.
  */
 export interface DataBlockLink {
+    /** App CRM entity handle (e.g. "class", "booking") for UI map gating */
+    entityHandle?: string;
     modelHandle?: string;
     modelHandlePlural?: string;
     modelLabel?: string;
@@ -49,6 +51,8 @@ export interface ProfileAvatar {
 export interface ProfileField {
     label: string;
     value: string;
+    /** Optional CRM navigation for this field value */
+    link?: DataBlockLink;
 }
 /**
  * Profile block - entity card with key fields.

package/dist/types/webhook.d.ts

@@ -78,7 +78,7 @@ export interface CommunicationChannelLifecycleContext extends WebhookLifecycleCo
     };
 }
 export interface WebhookLifecycleResult {
-    /** External ID from the provider (e.g., Twilio phone number SID) */
+    /** External ID from the provider (e.g., phone number SID) */
     externalId: string;
     /** Optional message describing what was configured */
     message?: string;
@@ -93,7 +93,7 @@ export type WebhookLifecycleHook<TContext = WebhookLifecycleContext> = (context:
 /**
  * Webhook invocation mode - determines how responses are handled.
  * - WEBHOOK: Fire-and-forget. Returns 200 immediately, processes asynchronously.
- * - CALLBACK: Waits for handler response and returns it to the caller (e.g., Twilio TwiML).
+ * - CALLBACK: Waits for handler response and returns it to the caller (e.g., voice XML).
  */
 export type WebhookInvocationMode = 'WEBHOOK' | 'CALLBACK';
 /**
@@ -107,7 +107,7 @@ export interface WebhookDefinition {
     methods?: ('GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH')[];
     /**
      * Invocation mode. Defaults to 'WEBHOOK' (fire-and-forget).
-     * Use 'CALLBACK' when the caller expects the handler's response (e.g., Twilio TwiML).
+     * Use 'CALLBACK' when the caller expects the handler's response (e.g., voice XML).
      */
     type?: WebhookInvocationMode;
     handler: WebhookHandler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.7.15",
+  "version": "1.7.17",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",