skedyul 1.7.14 → 1.7.16

package/dist/.build-stamp

@@ -1 +1 @@
-1786097937910
+1786319639134

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"),
@@ -1655,7 +1660,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()
       })
@@ -2574,7 +2579,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 +2588,7 @@ var communicationChannel = {
    *   communicationChannelId: channel.id,
    *   from: '+1234567890',
    *   message: 'Hello!',
-   *   remoteId: 'twilio-message-sid-123',
+   *   remoteId: 'provider-message-id-123',
    * });
    * ```
    */
@@ -3238,14 +3243,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,
    * })
    * ```
@@ -6317,6 +6322,37 @@ function resolveInstallPhase(def) {
 function isPreInstallEnvVar(def) {
   return resolveInstallPhase(def) === "pre_install";
 }
+function isPostInstallEnvVar(def) {
+  return resolveInstallPhase(def) === "post_install";
+}
+function filterEnvSchemaByInstallPhase(env, phase) {
+  if (!env) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(env).filter(([, def]) => resolveInstallPhase(def) === phase)
+  );
+}
+function splitProvisionEnvSchema(env) {
+  const global = {};
+  const preInstall = {};
+  const postInstall = {};
+  if (!env) {
+    return { global, preInstall, postInstall };
+  }
+  for (const [key, def] of Object.entries(env)) {
+    if (def.scope === "install") {
+      if (isPostInstallEnvVar(def)) {
+        postInstall[key] = def;
+      } else {
+        preInstall[key] = def;
+      }
+      continue;
+    }
+    global[key] = def;
+  }
+  return { global, preInstall, postInstall };
+}
 
 // src/config/utils.ts
 function getAllEnvKeys(config) {
@@ -8794,6 +8830,7 @@ export {
   CustomEventPayloadSchema,
   CustomEventTypeSchema,
   DEFAULT_DOCKERFILE,
+  DEFAULT_INSTALL_PHASE,
   DatePickerComponentDefinitionSchema,
   DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema,
@@ -9029,6 +9066,7 @@ export {
   evaluateTemplate,
   event,
   file,
+  filterEnvSchemaByInstallPhase,
   formatContextForPrompt,
   formatMoneyMinorEstimate,
   formatMoneyMinorRange,
@@ -9049,6 +9087,8 @@ export {
   isDeveloperContext,
   isFailure,
   isModelDependency,
+  isPostInstallEnvVar,
+  isPreInstallEnvVar,
   isProvisionContext,
   isRetryable,
   isRuntimeContext,
@@ -9070,6 +9110,7 @@ export {
   requeue,
   resetSequencerBackendForTests,
   resolveInputMappings,
+  resolveInstallPhase,
   resolveQueue,
   resolveSequencer,
   resource,
@@ -9083,6 +9124,7 @@ export {
   release as sequencerRelease,
   server,
   setup,
+  splitProvisionEnvSchema,
   toGsm7,
   token,
   validateCRMSchema,

package/dist/index.d.ts

@@ -16,7 +16,7 @@ declare const _default: {
     z: typeof z;
 };
 export default _default;
-export { defineConfig, defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, defineSetupStep, defineBatchOperation, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
+export { defineConfig, defineModel, defineEntity, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, defineSetupStep, defineBatchOperation, getAllEnvKeys, getRequiredInstallEnvKeys, DEFAULT_INSTALL_PHASE, resolveInstallPhase, isPreInstallEnvVar, isPostInstallEnvVar, filterEnvSchemaByInstallPhase, splitProvisionEnvSchema, } 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, BlockDefinition, SetupStepDefinition, SetupStepKind, BatchCascadePhase, BatchOperationDefinition, BatchOperationContext, BatchOperationIterateResult, BatchOperationSetupResult, 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, InstallPhase, 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, BatchCascadePhase, BatchOperationDefinition, BatchOperationContext, BatchOperationIterateResult, BatchOperationSetupResult, 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';

package/dist/index.js

@@ -84,6 +84,7 @@ __export(index_exports, {
   CustomEventPayloadSchema: () => CustomEventPayloadSchema,
   CustomEventTypeSchema: () => CustomEventTypeSchema,
   DEFAULT_DOCKERFILE: () => DEFAULT_DOCKERFILE,
+  DEFAULT_INSTALL_PHASE: () => DEFAULT_INSTALL_PHASE,
   DatePickerComponentDefinitionSchema: () => DatePickerComponentDefinitionSchema,
   DayOfWeekSchema: () => DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema: () => EmptyFormComponentDefinitionSchema,
@@ -319,6 +320,7 @@ __export(index_exports, {
   evaluateTemplate: () => evaluateTemplate,
   event: () => event,
   file: () => file,
+  filterEnvSchemaByInstallPhase: () => filterEnvSchemaByInstallPhase,
   formatContextForPrompt: () => formatContextForPrompt,
   formatMoneyMinorEstimate: () => formatMoneyMinorEstimate,
   formatMoneyMinorRange: () => formatMoneyMinorRange,
@@ -339,6 +341,8 @@ __export(index_exports, {
   isDeveloperContext: () => isDeveloperContext,
   isFailure: () => isFailure,
   isModelDependency: () => isModelDependency,
+  isPostInstallEnvVar: () => isPostInstallEnvVar,
+  isPreInstallEnvVar: () => isPreInstallEnvVar,
   isProvisionContext: () => isProvisionContext,
   isRetryable: () => isRetryable,
   isRuntimeContext: () => isRuntimeContext,
@@ -360,6 +364,7 @@ __export(index_exports, {
   requeue: () => requeue,
   resetSequencerBackendForTests: () => resetSequencerBackendForTests,
   resolveInputMappings: () => resolveInputMappings,
+  resolveInstallPhase: () => resolveInstallPhase,
   resolveQueue: () => resolveQueue,
   resolveSequencer: () => resolveSequencer,
   resource: () => resource,
@@ -373,6 +378,7 @@ __export(index_exports, {
   sequencerRelease: () => release,
   server: () => server,
   setup: () => setup,
+  splitProvisionEnvSchema: () => splitProvisionEnvSchema,
   toGsm7: () => toGsm7,
   token: () => token,
   validateCRMSchema: () => validateCRMSchema,
@@ -758,7 +764,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"),
@@ -2037,7 +2048,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()
       })
@@ -2956,7 +2967,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
@@ -2965,7 +2976,7 @@ var communicationChannel = {
    *   communicationChannelId: channel.id,
    *   from: '+1234567890',
    *   message: 'Hello!',
-   *   remoteId: 'twilio-message-sid-123',
+   *   remoteId: 'provider-message-id-123',
    * });
    * ```
    */
@@ -3620,14 +3631,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,
    * })
    * ```
@@ -6699,6 +6710,37 @@ function resolveInstallPhase(def) {
 function isPreInstallEnvVar(def) {
   return resolveInstallPhase(def) === "pre_install";
 }
+function isPostInstallEnvVar(def) {
+  return resolveInstallPhase(def) === "post_install";
+}
+function filterEnvSchemaByInstallPhase(env, phase) {
+  if (!env) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(env).filter(([, def]) => resolveInstallPhase(def) === phase)
+  );
+}
+function splitProvisionEnvSchema(env) {
+  const global = {};
+  const preInstall = {};
+  const postInstall = {};
+  if (!env) {
+    return { global, preInstall, postInstall };
+  }
+  for (const [key, def] of Object.entries(env)) {
+    if (def.scope === "install") {
+      if (isPostInstallEnvVar(def)) {
+        postInstall[key] = def;
+      } else {
+        preInstall[key] = def;
+      }
+      continue;
+    }
+    global[key] = def;
+  }
+  return { global, preInstall, postInstall };
+}
 
 // src/config/utils.ts
 function getAllEnvKeys(config) {
@@ -9177,6 +9219,7 @@ var index_default = { z: import_v414.z };
   CustomEventPayloadSchema,
   CustomEventTypeSchema,
   DEFAULT_DOCKERFILE,
+  DEFAULT_INSTALL_PHASE,
   DatePickerComponentDefinitionSchema,
   DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema,
@@ -9411,6 +9454,7 @@ var index_default = { z: import_v414.z };
   evaluateTemplate,
   event,
   file,
+  filterEnvSchemaByInstallPhase,
   formatContextForPrompt,
   formatMoneyMinorEstimate,
   formatMoneyMinorRange,
@@ -9431,6 +9475,8 @@ var index_default = { z: import_v414.z };
   isDeveloperContext,
   isFailure,
   isModelDependency,
+  isPostInstallEnvVar,
+  isPreInstallEnvVar,
   isProvisionContext,
   isRetryable,
   isRuntimeContext,
@@ -9452,6 +9498,7 @@ var index_default = { z: import_v414.z };
   requeue,
   resetSequencerBackendForTests,
   resolveInputMappings,
+  resolveInstallPhase,
   resolveQueue,
   resolveSequencer,
   resource,
@@ -9465,6 +9512,7 @@ var index_default = { z: import_v414.z };
   sequencerRelease,
   server,
   setup,
+  splitProvisionEnvSchema,
   toGsm7,
   token,
   validateCRMSchema,

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

@@ -1054,7 +1054,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 +1419,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 +1718,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 +2058,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 +2497,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 +3044,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>>;
@@ -4121,7 +4121,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>>;
@@ -4970,7 +4970,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>>;

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.14",
+  "version": "1.7.16",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",