skedyul 0.1.40 → 0.1.42

package/dist/.build-stamp

@@ -1 +1 @@
-1768537680901
+1768780968695

package/dist/config.d.ts

@@ -266,6 +266,93 @@ export interface RelationshipDefinition {
     /** Target side of the relationship */
     target: RelationshipLink;
 }
+/** Page type: INSTANCE shows single record, LIST shows multiple records */
+export type PageType = 'INSTANCE' | 'LIST';
+/** Block types available for pages */
+export type PageBlockType = 'form' | 'spreadsheet' | 'kanban' | 'calendar' | 'link';
+/** Supported field datatypes for page fields */
+export type PageFieldType = 'STRING' | 'FILE' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SELECT';
+/** Data source for prepopulating a page field from a model */
+export interface PageFieldSource {
+    /** Model handle to pull data from */
+    model: string;
+    /** Field handle on that model */
+    field: string;
+}
+/** Self-contained field definition for page blocks */
+export interface PageFieldDefinition {
+    /** Unique handle for this field */
+    handle: string;
+    /** Field datatype - determines UI component */
+    type: PageFieldType;
+    /** Display label */
+    label: string;
+    /** Optional description/help text */
+    description?: string;
+    /** Whether field is required */
+    required?: boolean;
+    /** Tool name from registry to call on value change */
+    handler?: string;
+    /** Data source for prepopulating field value */
+    source?: PageFieldSource;
+    /** For SELECT type: available options */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** For FILE type: accepted file extensions */
+    accept?: string;
+}
+/** Action button definition for pages */
+export interface PageActionDefinition {
+    /** Unique handle for this action */
+    handle: string;
+    /** Button label */
+    label: string;
+    /** Tool name from registry to invoke */
+    handler: string;
+    /** Optional icon (lucide icon name) */
+    icon?: string;
+    /** Button variant */
+    variant?: 'primary' | 'secondary' | 'destructive';
+}
+/** Block definition within a page */
+export interface PageBlockDefinition {
+    /** Block type determines the UI component */
+    type: PageBlockType;
+    /** Block title displayed in UI */
+    title?: string;
+    /** Self-contained field definitions */
+    fields?: PageFieldDefinition[];
+    /** Whether the block is read-only (no editing) */
+    readonly?: boolean;
+}
+/** Filter for selecting which instance(s) to display on a page */
+export interface PageInstanceFilter {
+    /** Model to query instances from */
+    model: string;
+    /** Filter criteria - supports variable substitution like $appInstallationId */
+    where?: Record<string, unknown>;
+}
+/** Page definition for app UI */
+export interface PageDefinition {
+    /** Unique handle for the page */
+    handle: string;
+    /** Page type: INSTANCE (single record) or LIST (multiple records) */
+    type: PageType;
+    /** Page title displayed in UI */
+    title: string;
+    /** Optional custom path for navigation */
+    path?: string;
+    /** Whether to show this page in sidebar navigation (default: true) */
+    navigation?: boolean;
+    /** Blocks that compose this page */
+    blocks: PageBlockDefinition[];
+    /** Page-level action buttons */
+    actions?: PageActionDefinition[];
+    /** Filter to select instance(s) for prepopulating field values */
+    filter?: PageInstanceFilter;
+}
 export type ChannelIdentifierType = 'DEDICATED_PHONE' | 'TEXT' | 'EMAIL';
 export interface ChannelIdentifierValue {
     /** Type of identifier */
@@ -502,6 +589,36 @@ export interface SkedyulConfig {
      * ```
      */
     relationships?: RelationshipDefinition[];
+    /**
+     * Pages for internal models.
+     * Defines how internal models are displayed in the post-install UI.
+     * Each page references a model by handle and can have multiple pages per model.
+     *
+     * @example
+     * ```typescript
+     * pages: [
+     *   {
+     *     handle: 'compliance_submission',
+     *     model: 'compliance_record',
+     *     type: 'INSTANCE',
+     *     title: 'Submit Compliance Record',
+     *     blocks: [
+     *       { type: 'form', title: 'Business Registration', fields: ['file'] },
+     *     ],
+     *   },
+     *   {
+     *     handle: 'phone_numbers_list',
+     *     model: 'phone_number',
+     *     type: 'LIST',
+     *     title: 'Phone Numbers',
+     *     blocks: [
+     *       { type: 'spreadsheet', fields: ['phone', 'forwarding_phone_number'] },
+     *     ],
+     *   },
+     * ]
+     * ```
+     */
+    pages?: PageDefinition[];
     /**
      * Communication channels this app provides (new syntax).
      * Uses typed `requires` for dependencies.
@@ -556,6 +673,8 @@ export interface SerializableSkedyulConfig {
     postInstall?: PostInstallConfig;
     /** Unified model definitions (INTERNAL + SHARED) */
     models?: ModelDefinition[];
+    /** Pages for internal model display */
+    pages?: PageDefinition[];
     /** Communication channels (new syntax) */
     channels?: ChannelDefinition[];
     /** Communication channels (legacy) @deprecated */

package/dist/schemas.d.ts

@@ -333,8 +333,8 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
  * Schema for compute layer type.
  */
 export declare const ComputeLayerTypeSchema: z.ZodEnum<{
-    dedicated: "dedicated";
     serverless: "serverless";
+    dedicated: "dedicated";
 }>;
 /**
  * Schema for field data types.
@@ -436,6 +436,185 @@ export declare const RelationshipDefinitionSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * Schema for page type.
+ * INSTANCE: Shows a single record (form-like)
+ * LIST: Shows multiple records (spreadsheet/table)
+ */
+export declare const PageTypeSchema: z.ZodEnum<{
+    INSTANCE: "INSTANCE";
+    LIST: "LIST";
+}>;
+/**
+ * Schema for block type in a page.
+ * Matches existing block types in the system.
+ */
+export declare const PageBlockTypeSchema: z.ZodEnum<{
+    form: "form";
+    spreadsheet: "spreadsheet";
+    kanban: "kanban";
+    calendar: "calendar";
+    link: "link";
+}>;
+/** Supported field datatypes for page fields */
+export declare const PageFieldTypeSchema: z.ZodEnum<{
+    STRING: "STRING";
+    NUMBER: "NUMBER";
+    BOOLEAN: "BOOLEAN";
+    DATE: "DATE";
+    FILE: "FILE";
+    SELECT: "SELECT";
+}>;
+/** Data source for prepopulating a page field from a model */
+export declare const PageFieldSourceSchema: z.ZodObject<{
+    model: z.ZodString;
+    field: z.ZodString;
+}, z.core.$strip>;
+/** Self-contained field definition for page blocks */
+export declare const PageFieldDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    type: z.ZodEnum<{
+        STRING: "STRING";
+        NUMBER: "NUMBER";
+        BOOLEAN: "BOOLEAN";
+        DATE: "DATE";
+        FILE: "FILE";
+        SELECT: "SELECT";
+    }>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    handler: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        field: z.ZodString;
+    }, z.core.$strip>>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    accept: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Action button definition for pages */
+export declare const PageActionDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    handler: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+        destructive: "destructive";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for a block definition within a page.
+ * Blocks define the UI components that render model data.
+ */
+export declare const PageBlockDefinitionSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        form: "form";
+        spreadsheet: "spreadsheet";
+        kanban: "kanban";
+        calendar: "calendar";
+        link: "link";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        type: z.ZodEnum<{
+            STRING: "STRING";
+            NUMBER: "NUMBER";
+            BOOLEAN: "BOOLEAN";
+            DATE: "DATE";
+            FILE: "FILE";
+            SELECT: "SELECT";
+        }>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        handler: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            field: z.ZodString;
+        }, z.core.$strip>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        accept: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Filter for selecting which instance(s) to display on a page */
+export declare const PageInstanceFilterSchema: z.ZodObject<{
+    model: z.ZodString;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Schema for a page definition.
+ * Pages define how internal models are displayed in the post-install UI.
+ */
+export declare const PageDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    type: z.ZodEnum<{
+        INSTANCE: "INSTANCE";
+        LIST: "LIST";
+    }>;
+    title: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    navigation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    blocks: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            form: "form";
+            spreadsheet: "spreadsheet";
+            kanban: "kanban";
+            calendar: "calendar";
+            link: "link";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            type: z.ZodEnum<{
+                STRING: "STRING";
+                NUMBER: "NUMBER";
+                BOOLEAN: "BOOLEAN";
+                DATE: "DATE";
+                FILE: "FILE";
+                SELECT: "SELECT";
+            }>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            handler: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodObject<{
+                model: z.ZodString;
+                field: z.ZodString;
+            }, z.core.$strip>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            accept: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        readonly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        handler: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+            destructive: "destructive";
+        }>>;
+    }, z.core.$strip>>>;
+    filter: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Schema for inline field definition (constraints, options, etc.)
  * This allows defining field behavior without referencing a metafield definition.
@@ -673,8 +852,8 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
     version: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     computeLayer: z.ZodOptional<z.ZodEnum<{
-        dedicated: "dedicated";
         serverless: "serverless";
+        dedicated: "dedicated";
     }>>;
     tools: z.ZodOptional<z.ZodUnknown>;
     webhooks: z.ZodOptional<z.ZodUnknown>;
@@ -837,6 +1016,66 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>;
     }, z.core.$strip>>>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        type: z.ZodEnum<{
+            INSTANCE: "INSTANCE";
+            LIST: "LIST";
+        }>;
+        title: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        navigation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        blocks: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                form: "form";
+                spreadsheet: "spreadsheet";
+                kanban: "kanban";
+                calendar: "calendar";
+                link: "link";
+            }>;
+            title: z.ZodOptional<z.ZodString>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                handle: z.ZodString;
+                type: z.ZodEnum<{
+                    STRING: "STRING";
+                    NUMBER: "NUMBER";
+                    BOOLEAN: "BOOLEAN";
+                    DATE: "DATE";
+                    FILE: "FILE";
+                    SELECT: "SELECT";
+                }>;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                handler: z.ZodOptional<z.ZodString>;
+                source: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodString;
+                    field: z.ZodString;
+                }, z.core.$strip>>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>>>;
+                accept: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            readonly: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            handler: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            variant: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+                destructive: "destructive";
+            }>>;
+        }, z.core.$strip>>>;
+        filter: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
         name: z.ZodString;
@@ -1013,6 +1252,24 @@ export type OnDeleteBehavior = z.infer<typeof OnDeleteBehaviorSchema>;
 export type RelationshipLink = z.infer<typeof RelationshipLinkSchema>;
 /** Relationship definition */
 export type RelationshipDefinition = z.infer<typeof RelationshipDefinitionSchema>;
+/** Page type */
+export type PageType = z.infer<typeof PageTypeSchema>;
+/** Page block type */
+export type PageBlockType = z.infer<typeof PageBlockTypeSchema>;
+/** Page field type */
+export type PageFieldType = z.infer<typeof PageFieldTypeSchema>;
+/** Page field source for data binding */
+export type PageFieldSource = z.infer<typeof PageFieldSourceSchema>;
+/** Page field definition */
+export type PageFieldDefinition = z.infer<typeof PageFieldDefinitionSchema>;
+/** Page action definition */
+export type PageActionDefinition = z.infer<typeof PageActionDefinitionSchema>;
+/** Page block definition */
+export type PageBlockDefinition = z.infer<typeof PageBlockDefinitionSchema>;
+/** Page instance filter */
+export type PageInstanceFilter = z.infer<typeof PageInstanceFilterSchema>;
+/** Page definition */
+export type PageDefinition = z.infer<typeof PageDefinitionSchema>;
 /** Model dependency reference */
 export type ModelDependency = z.infer<typeof ModelDependencySchema>;
 /** Channel dependency reference */

package/dist/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.InlineFieldDefinitionSchema = exports.RelationshipDefinitionSchema = exports.RelationshipLinkSchema = exports.OnDeleteBehaviorSchema = exports.RelationshipCardinalitySchema = exports.FieldOptionSchema = exports.FieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.StructuredFilterSchema = exports.FieldOwnerSchema = exports.ResourceScopeSchema = exports.ChannelIdentifierValueSchema = exports.ChannelIdentifierTypeSchema = exports.ChannelToolBindingsSchema = exports.AppFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InstallConfigSchema = exports.AppModelDefinitionSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
+exports.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.InlineFieldDefinitionSchema = exports.PageDefinitionSchema = exports.PageInstanceFilterSchema = exports.PageBlockDefinitionSchema = exports.PageActionDefinitionSchema = exports.PageFieldDefinitionSchema = exports.PageFieldSourceSchema = exports.PageFieldTypeSchema = exports.PageBlockTypeSchema = exports.PageTypeSchema = exports.RelationshipDefinitionSchema = exports.RelationshipLinkSchema = exports.OnDeleteBehaviorSchema = exports.RelationshipCardinalitySchema = exports.FieldOptionSchema = exports.FieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.StructuredFilterSchema = exports.FieldOwnerSchema = exports.ResourceScopeSchema = exports.ChannelIdentifierValueSchema = exports.ChannelIdentifierTypeSchema = exports.ChannelToolBindingsSchema = exports.AppFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InstallConfigSchema = exports.AppModelDefinitionSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
 exports.safeParseConfig = safeParseConfig;
 exports.isModelDependency = isModelDependency;
 exports.isChannelDependency = isChannelDependency;
@@ -288,6 +288,119 @@ exports.RelationshipDefinitionSchema = zod_1.z.object({
     /** Target side of the relationship */
     target: exports.RelationshipLinkSchema,
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Page and Block Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Schema for page type.
+ * INSTANCE: Shows a single record (form-like)
+ * LIST: Shows multiple records (spreadsheet/table)
+ */
+exports.PageTypeSchema = zod_1.z.enum(['INSTANCE', 'LIST']);
+/**
+ * Schema for block type in a page.
+ * Matches existing block types in the system.
+ */
+exports.PageBlockTypeSchema = zod_1.z.enum([
+    'form',
+    'spreadsheet',
+    'kanban',
+    'calendar',
+    'link',
+]);
+/** Supported field datatypes for page fields */
+exports.PageFieldTypeSchema = zod_1.z.enum([
+    'STRING',
+    'FILE',
+    'NUMBER',
+    'DATE',
+    'BOOLEAN',
+    'SELECT',
+]);
+/** Data source for prepopulating a page field from a model */
+exports.PageFieldSourceSchema = zod_1.z.object({
+    /** Model handle to pull data from */
+    model: zod_1.z.string(),
+    /** Field handle on that model */
+    field: zod_1.z.string(),
+});
+/** Self-contained field definition for page blocks */
+exports.PageFieldDefinitionSchema = zod_1.z.object({
+    /** Unique handle for this field */
+    handle: zod_1.z.string(),
+    /** Field datatype - determines UI component */
+    type: exports.PageFieldTypeSchema,
+    /** Display label */
+    label: zod_1.z.string(),
+    /** Optional description/help text */
+    description: zod_1.z.string().optional(),
+    /** Whether field is required */
+    required: zod_1.z.boolean().optional(),
+    /** Tool name from registry to call on value change */
+    handler: zod_1.z.string().optional(),
+    /** Data source for prepopulating field value */
+    source: exports.PageFieldSourceSchema.optional(),
+    /** For SELECT type: available options */
+    options: zod_1.z.array(zod_1.z.object({ value: zod_1.z.string(), label: zod_1.z.string() })).optional(),
+    /** For FILE type: accepted file extensions */
+    accept: zod_1.z.string().optional(),
+});
+/** Action button definition for pages */
+exports.PageActionDefinitionSchema = zod_1.z.object({
+    /** Unique handle for this action */
+    handle: zod_1.z.string(),
+    /** Button label */
+    label: zod_1.z.string(),
+    /** Tool name from registry to invoke */
+    handler: zod_1.z.string(),
+    /** Optional icon (lucide icon name) */
+    icon: zod_1.z.string().optional(),
+    /** Button variant */
+    variant: zod_1.z.enum(['primary', 'secondary', 'destructive']).optional(),
+});
+/**
+ * Schema for a block definition within a page.
+ * Blocks define the UI components that render model data.
+ */
+exports.PageBlockDefinitionSchema = zod_1.z.object({
+    /** Block type determines the UI component */
+    type: exports.PageBlockTypeSchema,
+    /** Block title displayed in UI */
+    title: zod_1.z.string().optional(),
+    /** Self-contained field definitions */
+    fields: zod_1.z.array(exports.PageFieldDefinitionSchema).optional(),
+    /** Whether the block is read-only (no editing) */
+    readonly: zod_1.z.boolean().optional(),
+});
+/** Filter for selecting which instance(s) to display on a page */
+exports.PageInstanceFilterSchema = zod_1.z.object({
+    /** Model to query instances from */
+    model: zod_1.z.string(),
+    /** Filter criteria - supports variable substitution like $appInstallationId */
+    where: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+/**
+ * Schema for a page definition.
+ * Pages define how internal models are displayed in the post-install UI.
+ */
+exports.PageDefinitionSchema = zod_1.z.object({
+    /** Unique handle for the page */
+    handle: zod_1.z.string(),
+    /** Page type: INSTANCE (single record) or LIST (multiple records) */
+    type: exports.PageTypeSchema,
+    /** Page title displayed in UI */
+    title: zod_1.z.string(),
+    /** Optional custom path for navigation */
+    path: zod_1.z.string().optional(),
+    /** Whether to show this page in sidebar navigation (default: true) */
+    navigation: zod_1.z.boolean().optional().default(true),
+    /** Blocks that compose this page */
+    blocks: zod_1.z.array(exports.PageBlockDefinitionSchema),
+    /** Page-level action buttons */
+    actions: zod_1.z.array(exports.PageActionDefinitionSchema).optional(),
+    /** Filter to select instance(s) for prepopulating field values */
+    filter: exports.PageInstanceFilterSchema.optional(),
+});
 /**
  * Schema for inline field definition (constraints, options, etc.)
  * This allows defining field behavior without referencing a metafield definition.
@@ -428,6 +541,8 @@ exports.SkedyulConfigSchema = zod_1.z.object({
     models: zod_1.z.array(exports.ModelDefinitionSchema).optional(),
     // Relationships between models
     relationships: zod_1.z.array(exports.RelationshipDefinitionSchema).optional(),
+    // Pages for internal models (displayed in post-install UI)
+    pages: zod_1.z.array(exports.PageDefinitionSchema).optional(),
     // New channel syntax (alias for communicationChannels)
     channels: zod_1.z.array(exports.ChannelDefinitionSchema).optional(),
     // Legacy: communication channels (deprecated - use channels)

package/dist/server.js

@@ -45,17 +45,6 @@ const z = __importStar(require("zod"));
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 const service_1 = require("./core/service");
 const zodToJsonSchemaLoose = zod_to_json_schema_1.zodToJsonSchema;
-let toJsonSchemaCompatFn = null;
-try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
-    const compat = require('@modelcontextprotocol/sdk/server/zod-json-schema-compat.js');
-    if (compat?.toJsonSchemaCompat) {
-        toJsonSchemaCompatFn = compat.toJsonSchemaCompat;
-    }
-}
-catch {
-    toJsonSchemaCompatFn = null;
-}
 function normalizeBilling(billing) {
     if (!billing || typeof billing.credits !== 'number') {
         return { credits: 0 };
@@ -66,12 +55,14 @@ function toJsonSchema(schema) {
     if (!schema)
         return undefined;
     try {
-        if (toJsonSchemaCompatFn) {
-            return toJsonSchemaCompatFn(schema, {
-                target: 'jsonSchema7',
-                pipeStrategy: 'input',
+        // Zod v4 has native JSON Schema support via z.toJSONSchema()
+        // This is preferred over external libraries for Zod v4 compatibility
+        if (typeof z.toJSONSchema === 'function') {
+            return z.toJSONSchema(schema, {
+                unrepresentable: 'any', // Handle z.date(), z.bigint() etc gracefully
             });
         }
+        // Fallback to zod-to-json-schema for older Zod versions
         return zodToJsonSchemaLoose(schema, {
             target: 'jsonSchema7',
             $refStrategy: 'none',

package/dist/types.d.ts

@@ -1,9 +1,54 @@
 import type { CoreApiConfig } from './core/types';
 import type { z } from 'zod';
+import type { PageFieldType } from './schemas';
 export interface ToolContext {
     env: Record<string, string | undefined>;
     mode?: 'execute' | 'estimate';
 }
+/** Context passed to field change handlers */
+export interface FieldChangeContext extends ToolContext {
+    /** Field handle from page definition */
+    fieldHandle: string;
+    /** Field datatype */
+    fieldType: PageFieldType;
+    /** Page handle */
+    pageHandle: string;
+    /** App installation ID */
+    appInstallationId: string;
+    /** Workplace info */
+    workplace: {
+        id: string;
+        subdomain: string;
+    };
+}
+/** Parameters for field change handlers */
+export interface FieldChangeParams<T = unknown> {
+    /** The new value */
+    value: T;
+    /** Previous value if available */
+    previousValue?: T;
+    /** Handler context */
+    context: FieldChangeContext;
+}
+/** Context passed to page action handlers */
+export interface PageActionContext extends ToolContext {
+    /** Page handle */
+    pageHandle: string;
+    /** App installation ID */
+    appInstallationId: string;
+    /** Workplace info */
+    workplace: {
+        id: string;
+        subdomain: string;
+    };
+    /** All current field values on the page */
+    fieldValues: Record<string, unknown>;
+}
+/** Parameters for page action handlers */
+export interface PageActionParams {
+    /** Handler context */
+    context: PageActionContext;
+}
 export interface ToolParams<Input, Output> {
     input: Input;
     context: ToolContext;

package/package.json

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