skedyul 0.1.36 → 0.1.38

package/dist/.build-stamp

@@ -1 +1 @@
-1768203723348
+1768437850820

package/dist/config.d.ts

@@ -23,11 +23,37 @@ export interface AppModelDefinition {
     /** Description of what this model represents */
     description?: string;
 }
+/**
+ * Context passed to the install handler when a user installs the app.
+ */
+export interface InstallHandlerContext {
+    /** Environment variables from preInstall.env filled by the user */
+    env: Record<string, string>;
+    /** Workplace information */
+    workplace: {
+        id: string;
+        subdomain: string;
+    };
+}
+/**
+ * Result returned by the install handler.
+ */
+export interface InstallHandlerResult {
+    /** Additional environment variables to add to the installation */
+    env?: Record<string, string>;
+    /** Optional OAuth redirect URL - if provided, user is redirected before install completes */
+    redirect?: string;
+}
+/**
+ * Install handler function type.
+ */
+export type InstallHandler = (ctx: InstallHandlerContext) => Promise<InstallHandlerResult>;
 export interface InstallConfig {
     /**
      * Per-install environment variables.
      * These are configured by the user when installing the app.
      * Values are stored per-installation and can differ between installs.
+     * @deprecated Use preInstall.env and postInstall.env instead
      */
     env?: EnvSchema;
     /**
@@ -35,6 +61,35 @@ export interface InstallConfig {
      * Users will map these to their CRM models during installation.
      */
     appModels?: AppModelDefinition[];
+    /**
+     * Install handler - called when user clicks install.
+     * Use dynamic import: handler: import('./src/install')
+     */
+    handler?: Promise<{
+        default: InstallHandler;
+    }>;
+}
+/**
+ * Pre-install configuration.
+ * Variables collected BEFORE the app is installed (e.g., API keys, credentials).
+ */
+export interface PreInstallConfig {
+    /**
+     * Environment variables required before installation.
+     * User must provide these values during the install flow.
+     */
+    env?: EnvSchema;
+}
+/**
+ * Post-install configuration.
+ * Variables that can be configured AFTER the app is installed.
+ */
+export interface PostInstallConfig {
+    /**
+     * Environment variables configurable after installation.
+     * These appear in the Settings page of the installed app.
+     */
+    env?: EnvSchema;
 }
 export interface AppFieldVisibility {
     /** Show in data/detail view */
@@ -70,6 +125,71 @@ export interface ChannelToolBindings {
     /** Tool name for sending messages on this channel */
     send_message: string;
 }
+/** Scope of a model: INTERNAL (app-owned) or SHARED (user-mapped) */
+export type ResourceScope = 'INTERNAL' | 'SHARED';
+/** Model dependency reference */
+export interface ModelDependency {
+    /** Handle of the model being depended upon */
+    model: string;
+    /** Specific fields required (undefined = all fields) */
+    fields?: string[];
+}
+/** Channel dependency reference */
+export interface ChannelDependency {
+    /** Handle of the channel being depended upon */
+    channel: string;
+}
+/** Workflow dependency reference */
+export interface WorkflowDependency {
+    /** Handle of the workflow being depended upon */
+    workflow: string;
+}
+/** Union of all resource dependency types */
+export type ResourceDependency = ModelDependency | ChannelDependency | WorkflowDependency;
+/** Field definition for unified models (works for INTERNAL and SHARED) */
+export interface ModelFieldDefinition {
+    /** Field handle (unique within model) */
+    handle: string;
+    /** Display label */
+    label: string;
+    /** Data type (required for INTERNAL, optional for SHARED) */
+    type?: InternalFieldDataType;
+    /** Field definition handle for SHARED fields */
+    definitionHandle?: string;
+    /** Whether field is required */
+    required?: boolean;
+    /** Whether field must be unique */
+    unique?: boolean;
+    /** Whether this is a system field */
+    system?: boolean;
+    /** Whether field holds a list of values */
+    isList?: boolean;
+    /** Default value */
+    defaultValue?: {
+        value: unknown;
+    };
+    /** Field description */
+    description?: string;
+    /** Visibility settings (for SHARED fields) */
+    visibility?: AppFieldVisibility;
+}
+/** Unified model definition (supports both INTERNAL and SHARED) */
+export interface ModelDefinition {
+    /** Model handle (unique within app) */
+    handle: string;
+    /** Display name */
+    name: string;
+    /** Plural display name */
+    namePlural?: string;
+    /** Resource scope: INTERNAL (app creates) or SHARED (user maps) */
+    scope: ResourceScope;
+    /** Label template for display (required for INTERNAL) */
+    labelTemplate?: string;
+    /** Model description */
+    description?: string;
+    /** Field definitions */
+    fields: ModelFieldDefinition[];
+}
 export type ChannelIdentifierType = 'DEDICATED_PHONE' | 'TEXT' | 'EMAIL';
 export interface ChannelIdentifierValue {
     /** Type of identifier */
@@ -87,12 +207,16 @@ export interface CommunicationChannelDefinition {
     /** Tool bindings for this channel */
     tools: ChannelToolBindings;
     /** How the channel identifier is configured */
-    identifierValue: ChannelIdentifierValue;
+    identifierValue?: ChannelIdentifierValue;
     /** Fields to add to contacts when using this channel */
     appFields?: AppFieldDefinition[];
     /** Additional settings UI */
     settings?: unknown[];
+    /** Typed dependencies - models, fields this channel requires */
+    requires?: ResourceDependency[];
 }
+/** Alias for channel definition (new naming) */
+export type ChannelDefinition = CommunicationChannelDefinition;
 export interface WorkflowActionInput {
     /** Input key */
     key: string;
@@ -125,6 +249,8 @@ export interface WorkflowDefinition {
     label?: string;
     /** Workflow handle/key (optional when path is provided, inferred from YAML) */
     handle?: string;
+    /** Typed dependencies - channels, models this workflow requires */
+    requires?: ResourceDependency[];
     /** Actions in this workflow */
     actions: WorkflowAction[];
 }
@@ -228,39 +354,69 @@ export interface SkedyulConfig {
     /**
      * Install-time configuration.
      * Defines what users need to configure when installing the app.
+     * @deprecated Use preInstall and postInstall instead
      */
     install?: InstallConfig;
     /**
-     * Communication channels this app provides.
-     * Defines how the app can send/receive messages.
+     * Pre-install configuration.
+     * Environment variables collected BEFORE the app is installed.
+     * User must provide these values (e.g., API keys) during the install flow.
      */
-    communicationChannels?: CommunicationChannelDefinition[];
+    preInstall?: PreInstallConfig;
     /**
-     * Workflows this app provides.
-     * Can reference channels via channelHandle.
+     * Post-install configuration.
+     * Environment variables that can be configured AFTER the app is installed.
+     * These appear in the Settings page of the installed app.
      */
-    workflows?: WorkflowDefinition[];
+    postInstall?: PostInstallConfig;
     /**
-     * Internal models owned by this app.
-     * These models are created and managed by the app, not by users.
-     * Data is stored in the standard Model/Field/Instance tables but
-     * linked to the AppVersion for ownership tracking.
+     * Unified model definitions (INTERNAL + SHARED).
+     * INTERNAL models are created and managed by the app.
+     * SHARED models map to user's existing models.
      *
      * @example
      * ```typescript
-     * internalModels: [
+     * models: [
      *   {
-     *     handle: 'dedicated_phone_number',
-     *     name: 'Dedicated Phone Number',
-     *     namePlural: 'Dedicated Phone Numbers',
+     *     handle: 'phone_number',
+     *     name: 'Phone Number',
+     *     scope: 'INTERNAL',
      *     labelTemplate: '{{phone}}',
      *     fields: [
-     *       { handle: 'phone', label: 'Phone Number', type: 'TEXT', required: true, unique: true },
+     *       { handle: 'phone', label: 'Phone Number', type: 'STRING', required: true },
+     *     ],
+     *   },
+     *   {
+     *     handle: 'contact',
+     *     name: 'Contact',
+     *     scope: 'SHARED',
+     *     fields: [
+     *       { handle: 'phone', label: 'Phone', definitionHandle: 'phone', required: true },
      *     ],
      *   },
      * ]
      * ```
      */
+    models?: ModelDefinition[];
+    /**
+     * Communication channels this app provides (new syntax).
+     * Uses typed `requires` for dependencies.
+     */
+    channels?: ChannelDefinition[];
+    /**
+     * Communication channels this app provides (legacy syntax).
+     * @deprecated Use `channels` instead
+     */
+    communicationChannels?: CommunicationChannelDefinition[];
+    /**
+     * Workflows this app provides.
+     * Can reference channels via `requires: [{ channel: 'sms' }]`.
+     */
+    workflows?: WorkflowDefinition[];
+    /**
+     * Internal models owned by this app.
+     * @deprecated Use `models` with `scope: 'INTERNAL'` instead
+     */
     internalModels?: InternalModelDefinition[];
 }
 /**
@@ -288,13 +444,21 @@ export interface SerializableSkedyulConfig {
     workflowsPath?: string;
     /** Global/version-level environment variable schema */
     env?: EnvSchema;
-    /** Install-time configuration */
+    /** Install-time configuration @deprecated Use preInstall and postInstall */
     install?: InstallConfig;
-    /** Communication channels this app provides */
+    /** Pre-install configuration (env vars required before install) */
+    preInstall?: PreInstallConfig;
+    /** Post-install configuration (env vars configurable after install) */
+    postInstall?: PostInstallConfig;
+    /** Unified model definitions (INTERNAL + SHARED) */
+    models?: ModelDefinition[];
+    /** Communication channels (new syntax) */
+    channels?: ChannelDefinition[];
+    /** Communication channels (legacy) @deprecated */
     communicationChannels?: CommunicationChannelDefinition[];
     /** Workflows this app provides */
     workflows?: WorkflowDefinition[];
-    /** Internal models owned by this app */
+    /** Internal models @deprecated Use models with scope: INTERNAL */
     internalModels?: InternalModelDefinition[];
 }
 /**
@@ -339,12 +503,19 @@ export declare function validateConfig(config: SkedyulConfig): {
 };
 /**
  * Get all required install env keys from a config
+ * @deprecated Use getRequiredPreInstallEnvKeys instead
  */
 export declare function getRequiredInstallEnvKeys(config: SkedyulConfig): string[];
+/**
+ * Get all required pre-install env keys from a config
+ */
+export declare function getRequiredPreInstallEnvKeys(config: SkedyulConfig): string[];
 /**
  * Get all env keys (both global and install) from a config
  */
 export declare function getAllEnvKeys(config: SkedyulConfig): {
     global: string[];
     install: string[];
+    preInstall: string[];
+    postInstall: string[];
 };

package/dist/config.js

@@ -38,6 +38,7 @@ exports.defineConfig = defineConfig;
 exports.loadConfig = loadConfig;
 exports.validateConfig = validateConfig;
 exports.getRequiredInstallEnvKeys = getRequiredInstallEnvKeys;
+exports.getRequiredPreInstallEnvKeys = getRequiredPreInstallEnvKeys;
 exports.getAllEnvKeys = getAllEnvKeys;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -184,7 +185,7 @@ function validateConfig(config) {
             }
         }
     }
-    // Validate install.env schema
+    // Validate install.env schema (deprecated)
     if (config.install?.env) {
         for (const [key, def] of Object.entries(config.install.env)) {
             if (!def.label) {
@@ -195,6 +196,28 @@ function validateConfig(config) {
             }
         }
     }
+    // Validate preInstall.env schema
+    if (config.preInstall?.env) {
+        for (const [key, def] of Object.entries(config.preInstall.env)) {
+            if (!def.label) {
+                errors.push(`preInstall.env.${key}: Missing required field 'label'`);
+            }
+            if (def.visibility && !['visible', 'encrypted'].includes(def.visibility)) {
+                errors.push(`preInstall.env.${key}: Invalid visibility '${def.visibility}'`);
+            }
+        }
+    }
+    // Validate postInstall.env schema
+    if (config.postInstall?.env) {
+        for (const [key, def] of Object.entries(config.postInstall.env)) {
+            if (!def.label) {
+                errors.push(`postInstall.env.${key}: Missing required field 'label'`);
+            }
+            if (def.visibility && !['visible', 'encrypted'].includes(def.visibility)) {
+                errors.push(`postInstall.env.${key}: Invalid visibility '${def.visibility}'`);
+            }
+        }
+    }
     // Validate appModels
     if (config.install?.appModels) {
         for (let i = 0; i < config.install.appModels.length; i++) {
@@ -293,6 +316,7 @@ function validateConfig(config) {
 }
 /**
  * Get all required install env keys from a config
+ * @deprecated Use getRequiredPreInstallEnvKeys instead
  */
 function getRequiredInstallEnvKeys(config) {
     if (!config.install?.env)
@@ -301,6 +325,16 @@ function getRequiredInstallEnvKeys(config) {
         .filter(([, def]) => def.required)
         .map(([key]) => key);
 }
+/**
+ * Get all required pre-install env keys from a config
+ */
+function getRequiredPreInstallEnvKeys(config) {
+    if (!config.preInstall?.env)
+        return [];
+    return Object.entries(config.preInstall.env)
+        .filter(([, def]) => def.required)
+        .map(([key]) => key);
+}
 /**
  * Get all env keys (both global and install) from a config
  */
@@ -308,5 +342,7 @@ function getAllEnvKeys(config) {
     return {
         global: config.env ? Object.keys(config.env) : [],
         install: config.install?.env ? Object.keys(config.install.env) : [],
+        preInstall: config.preInstall?.env ? Object.keys(config.preInstall.env) : [],
+        postInstall: config.postInstall?.env ? Object.keys(config.postInstall.env) : [],
     };
 }

package/dist/index.d.ts

@@ -3,4 +3,4 @@ export * from './schemas';
 export { server } from './server';
 export { workplace, communicationChannel, configure, getConfig } from './core/client';
 export { defineConfig, loadConfig, validateConfig, getRequiredInstallEnvKeys, getAllEnvKeys, CONFIG_FILE_NAMES, } from './config';
-export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, InstallConfig, AppModelDefinition, ComputeLayerType, AppFieldVisibility, AppFieldDefinition, ChannelToolBindings, ChannelIdentifierType, ChannelIdentifierValue, CommunicationChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, } from './config';
+export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, InstallConfig, AppModelDefinition, ComputeLayerType, InstallHandlerContext, InstallHandlerResult, InstallHandler, PreInstallConfig, PostInstallConfig, AppFieldVisibility, AppFieldDefinition, ChannelToolBindings, ChannelIdentifierType, ChannelIdentifierValue, CommunicationChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, } from './config';

package/dist/schemas.d.ts

@@ -116,6 +116,49 @@ export declare const ChannelIdentifierValueSchema: z.ZodObject<{
     }>;
     definitionHandle: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Schema for resource scope.
+ * INTERNAL: App owns this resource, auto-created when feature is provisioned
+ * SHARED: Maps to user's existing resource, requires user selection
+ */
+export declare const ResourceScopeSchema: z.ZodEnum<{
+    INTERNAL: "INTERNAL";
+    SHARED: "SHARED";
+}>;
+/**
+ * Schema for a model dependency reference.
+ * Used in `requires` arrays to specify model dependencies.
+ */
+export declare const ModelDependencySchema: z.ZodObject<{
+    model: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for a channel dependency reference.
+ * Used in `requires` arrays to specify channel dependencies.
+ */
+export declare const ChannelDependencySchema: z.ZodObject<{
+    channel: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for a workflow dependency reference.
+ * Used in `requires` arrays to specify workflow dependencies.
+ */
+export declare const WorkflowDependencySchema: z.ZodObject<{
+    workflow: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Union schema for all resource dependency types.
+ * Used in `requires` arrays on channels, workflows, etc.
+ */
+export declare const ResourceDependencySchema: z.ZodUnion<readonly [z.ZodObject<{
+    model: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    channel: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    workflow: z.ZodString;
+}, z.core.$strip>]>;
 /**
  * Schema for communication channel definition.
  */
@@ -126,14 +169,59 @@ export declare const CommunicationChannelDefinitionSchema: z.ZodObject<{
     tools: z.ZodObject<{
         send_message: z.ZodString;
     }, z.core.$strip>;
-    identifierValue: z.ZodObject<{
+    identifierValue: z.ZodOptional<z.ZodObject<{
         type: z.ZodEnum<{
             DEDICATED_PHONE: "DEDICATED_PHONE";
             TEXT: "TEXT";
             EMAIL: "EMAIL";
         }>;
         definitionHandle: z.ZodString;
+    }, z.core.$strip>>;
+    appFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        fieldHandle: z.ZodString;
+        entityHandle: z.ZodString;
+        definitionHandle: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        system: z.ZodOptional<z.ZodBoolean>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodObject<{
+            value: z.ZodUnknown;
+        }, z.core.$strip>>;
+        visibility: z.ZodOptional<z.ZodObject<{
+            data: z.ZodOptional<z.ZodBoolean>;
+            list: z.ZodOptional<z.ZodBoolean>;
+            filters: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    settings: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        channel: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        workflow: z.ZodString;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>;
+/**
+ * Shorter alias for channel definition (used in new config syntax).
+ */
+export declare const ChannelDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    tools: z.ZodObject<{
+        send_message: z.ZodString;
     }, z.core.$strip>;
+    identifierValue: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            DEDICATED_PHONE: "DEDICATED_PHONE";
+            TEXT: "TEXT";
+            EMAIL: "EMAIL";
+        }>;
+        definitionHandle: z.ZodString;
+    }, z.core.$strip>>;
     appFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         fieldHandle: z.ZodString;
@@ -152,6 +240,14 @@ export declare const CommunicationChannelDefinitionSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
     settings: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        channel: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        workflow: z.ZodString;
+    }, z.core.$strip>]>>>;
 }, z.core.$strip>;
 /**
  * Schema for workflow action input.
@@ -191,6 +287,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     handle: z.ZodOptional<z.ZodString>;
     channelHandle: z.ZodOptional<z.ZodString>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        channel: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        workflow: z.ZodString;
+    }, z.core.$strip>]>>>;
     actions: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         handle: z.ZodString;
@@ -215,9 +319,106 @@ export declare const ComputeLayerTypeSchema: z.ZodEnum<{
     serverless: "serverless";
 }>;
 /**
- * Schema for internal field data types.
+ * Schema for field data types.
  * Matches the DataType enum in the database.
  */
+export declare const FieldDataTypeSchema: z.ZodEnum<{
+    LONG_STRING: "LONG_STRING";
+    STRING: "STRING";
+    NUMBER: "NUMBER";
+    BOOLEAN: "BOOLEAN";
+    DATE: "DATE";
+    DATE_TIME: "DATE_TIME";
+    TIME: "TIME";
+    FILE: "FILE";
+    IMAGE: "IMAGE";
+    RELATION: "RELATION";
+    OBJECT: "OBJECT";
+}>;
+/**
+ * Schema for a field within a model.
+ * Works for both INTERNAL and SHARED models.
+ */
+export declare const ModelFieldDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        LONG_STRING: "LONG_STRING";
+        STRING: "STRING";
+        NUMBER: "NUMBER";
+        BOOLEAN: "BOOLEAN";
+        DATE: "DATE";
+        DATE_TIME: "DATE_TIME";
+        TIME: "TIME";
+        FILE: "FILE";
+        IMAGE: "IMAGE";
+        RELATION: "RELATION";
+        OBJECT: "OBJECT";
+    }>>;
+    definitionHandle: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    unique: z.ZodOptional<z.ZodBoolean>;
+    system: z.ZodOptional<z.ZodBoolean>;
+    isList: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodObject<{
+        value: z.ZodUnknown;
+    }, z.core.$strip>>;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodObject<{
+        data: z.ZodOptional<z.ZodBoolean>;
+        list: z.ZodOptional<z.ZodBoolean>;
+        filters: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for a unified model definition.
+ * Supports both INTERNAL (app-owned) and SHARED (user-mapped) models.
+ */
+export declare const ModelDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    namePlural: z.ZodOptional<z.ZodString>;
+    scope: z.ZodEnum<{
+        INTERNAL: "INTERNAL";
+        SHARED: "SHARED";
+    }>;
+    labelTemplate: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            LONG_STRING: "LONG_STRING";
+            STRING: "STRING";
+            NUMBER: "NUMBER";
+            BOOLEAN: "BOOLEAN";
+            DATE: "DATE";
+            DATE_TIME: "DATE_TIME";
+            TIME: "TIME";
+            FILE: "FILE";
+            IMAGE: "IMAGE";
+            RELATION: "RELATION";
+            OBJECT: "OBJECT";
+        }>>;
+        definitionHandle: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        system: z.ZodOptional<z.ZodBoolean>;
+        isList: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodObject<{
+            value: z.ZodUnknown;
+        }, z.core.$strip>>;
+        description: z.ZodOptional<z.ZodString>;
+        visibility: z.ZodOptional<z.ZodObject<{
+            data: z.ZodOptional<z.ZodBoolean>;
+            list: z.ZodOptional<z.ZodBoolean>;
+            filters: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * @deprecated Use FieldDataTypeSchema instead
+ */
 export declare const InternalFieldDataTypeSchema: z.ZodEnum<{
     LONG_STRING: "LONG_STRING";
     STRING: "STRING";
@@ -232,7 +433,7 @@ export declare const InternalFieldDataTypeSchema: z.ZodEnum<{
     OBJECT: "OBJECT";
 }>;
 /**
- * Schema for a field within an internal model.
+ * @deprecated Use ModelFieldDefinitionSchema instead
  */
 export declare const InternalFieldDefinitionSchema: z.ZodObject<{
     handle: z.ZodString;
@@ -261,7 +462,7 @@ export declare const InternalFieldDefinitionSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Schema for an internal model definition.
+ * @deprecated Use ModelDefinitionSchema instead
  */
 export declare const InternalModelDefinitionSchema: z.ZodObject<{
     handle: z.ZodString;
@@ -326,6 +527,19 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         placeholder: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    preInstall: z.ZodOptional<z.ZodObject<{
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            visibility: z.ZodOptional<z.ZodEnum<{
+                visible: "visible";
+                encrypted: "encrypted";
+            }>>;
+            default: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            placeholder: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
     install: z.ZodOptional<z.ZodObject<{
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             label: z.ZodString;
@@ -344,21 +558,118 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
-    communicationChannels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    postInstall: z.ZodOptional<z.ZodObject<{
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            visibility: z.ZodOptional<z.ZodEnum<{
+                visible: "visible";
+                encrypted: "encrypted";
+            }>>;
+            default: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            placeholder: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        namePlural: z.ZodOptional<z.ZodString>;
+        scope: z.ZodEnum<{
+            INTERNAL: "INTERNAL";
+            SHARED: "SHARED";
+        }>;
+        labelTemplate: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                LONG_STRING: "LONG_STRING";
+                STRING: "STRING";
+                NUMBER: "NUMBER";
+                BOOLEAN: "BOOLEAN";
+                DATE: "DATE";
+                DATE_TIME: "DATE_TIME";
+                TIME: "TIME";
+                FILE: "FILE";
+                IMAGE: "IMAGE";
+                RELATION: "RELATION";
+                OBJECT: "OBJECT";
+            }>>;
+            definitionHandle: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            unique: z.ZodOptional<z.ZodBoolean>;
+            system: z.ZodOptional<z.ZodBoolean>;
+            isList: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodObject<{
+                value: z.ZodUnknown;
+            }, z.core.$strip>>;
+            description: z.ZodOptional<z.ZodString>;
+            visibility: z.ZodOptional<z.ZodObject<{
+                data: z.ZodOptional<z.ZodBoolean>;
+                list: z.ZodOptional<z.ZodBoolean>;
+                filters: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
         name: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
         tools: z.ZodObject<{
             send_message: z.ZodString;
         }, z.core.$strip>;
-        identifierValue: z.ZodObject<{
+        identifierValue: z.ZodOptional<z.ZodObject<{
             type: z.ZodEnum<{
                 DEDICATED_PHONE: "DEDICATED_PHONE";
                 TEXT: "TEXT";
                 EMAIL: "EMAIL";
             }>;
             definitionHandle: z.ZodString;
+        }, z.core.$strip>>;
+        appFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            fieldHandle: z.ZodString;
+            entityHandle: z.ZodString;
+            definitionHandle: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            system: z.ZodOptional<z.ZodBoolean>;
+            unique: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodObject<{
+                value: z.ZodUnknown;
+            }, z.core.$strip>>;
+            visibility: z.ZodOptional<z.ZodObject<{
+                data: z.ZodOptional<z.ZodBoolean>;
+                list: z.ZodOptional<z.ZodBoolean>;
+                filters: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        settings: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            channel: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            workflow: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>>;
+    communicationChannels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        tools: z.ZodObject<{
+            send_message: z.ZodString;
         }, z.core.$strip>;
+        identifierValue: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                DEDICATED_PHONE: "DEDICATED_PHONE";
+                TEXT: "TEXT";
+                EMAIL: "EMAIL";
+            }>;
+            definitionHandle: z.ZodString;
+        }, z.core.$strip>>;
         appFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
             fieldHandle: z.ZodString;
@@ -377,12 +688,28 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
         settings: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            channel: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            workflow: z.ZodString;
+        }, z.core.$strip>]>>>;
     }, z.core.$strip>>>;
     workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         handle: z.ZodOptional<z.ZodString>;
         channelHandle: z.ZodOptional<z.ZodString>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            channel: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            workflow: z.ZodString;
+        }, z.core.$strip>]>>>;
         actions: z.ZodArray<z.ZodObject<{
             label: z.ZodString;
             handle: z.ZodString;
@@ -441,3 +768,27 @@ export type ParsedSkedyulConfig = z.infer<typeof SkedyulConfigSchema>;
  * Safely parse a skedyul config, returning null if invalid.
  */
 export declare function safeParseConfig(data: unknown): ParsedSkedyulConfig | null;
+/** Resource scope type */
+export type ResourceScope = z.infer<typeof ResourceScopeSchema>;
+/** Model dependency reference */
+export type ModelDependency = z.infer<typeof ModelDependencySchema>;
+/** Channel dependency reference */
+export type ChannelDependency = z.infer<typeof ChannelDependencySchema>;
+/** Workflow dependency reference */
+export type WorkflowDependency = z.infer<typeof WorkflowDependencySchema>;
+/** Union of all resource dependencies */
+export type ResourceDependency = z.infer<typeof ResourceDependencySchema>;
+/** Model field definition */
+export type ModelFieldDefinition = z.infer<typeof ModelFieldDefinitionSchema>;
+/** Unified model definition (INTERNAL or SHARED) */
+export type ModelDefinition = z.infer<typeof ModelDefinitionSchema>;
+/** Channel definition */
+export type ChannelDefinition = z.infer<typeof ChannelDefinitionSchema>;
+/** Workflow definition */
+export type WorkflowDefinition = z.infer<typeof WorkflowDefinitionSchema>;
+/** Check if a dependency is a model dependency */
+export declare function isModelDependency(dep: ResourceDependency): dep is ModelDependency;
+/** Check if a dependency is a channel dependency */
+export declare function isChannelDependency(dep: ResourceDependency): dep is ChannelDependency;
+/** Check if a dependency is a workflow dependency */
+export declare function isWorkflowDependency(dep: ResourceDependency): dep is WorkflowDependency;

package/dist/schemas.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.CommunicationChannelDefinitionSchema = 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.FieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = 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;
+exports.isWorkflowDependency = isWorkflowDependency;
 const zod_1 = require("zod");
 // ─────────────────────────────────────────────────────────────────────────────
 // Zod Schemas for SkedyulConfig
@@ -85,6 +88,52 @@ exports.ChannelIdentifierValueSchema = zod_1.z.object({
     type: exports.ChannelIdentifierTypeSchema,
     definitionHandle: zod_1.z.string(),
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// Resource Scope and Dependency Schemas
+// Unified system for tracking app resources and their dependencies.
+// Must be defined before channel/workflow schemas that use them.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Schema for resource scope.
+ * INTERNAL: App owns this resource, auto-created when feature is provisioned
+ * SHARED: Maps to user's existing resource, requires user selection
+ */
+exports.ResourceScopeSchema = zod_1.z.enum(['INTERNAL', 'SHARED']);
+/**
+ * Schema for a model dependency reference.
+ * Used in `requires` arrays to specify model dependencies.
+ */
+exports.ModelDependencySchema = zod_1.z.object({
+    /** Handle of the model being depended upon */
+    model: zod_1.z.string(),
+    /** Specific fields required (undefined = all fields) */
+    fields: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * Schema for a channel dependency reference.
+ * Used in `requires` arrays to specify channel dependencies.
+ */
+exports.ChannelDependencySchema = zod_1.z.object({
+    /** Handle of the channel being depended upon */
+    channel: zod_1.z.string(),
+});
+/**
+ * Schema for a workflow dependency reference.
+ * Used in `requires` arrays to specify workflow dependencies.
+ */
+exports.WorkflowDependencySchema = zod_1.z.object({
+    /** Handle of the workflow being depended upon */
+    workflow: zod_1.z.string(),
+});
+/**
+ * Union schema for all resource dependency types.
+ * Used in `requires` arrays on channels, workflows, etc.
+ */
+exports.ResourceDependencySchema = zod_1.z.union([
+    exports.ModelDependencySchema,
+    exports.ChannelDependencySchema,
+    exports.WorkflowDependencySchema,
+]);
 /**
  * Schema for communication channel definition.
  */
@@ -93,10 +142,16 @@ exports.CommunicationChannelDefinitionSchema = zod_1.z.object({
     name: zod_1.z.string(),
     icon: zod_1.z.string().optional(),
     tools: exports.ChannelToolBindingsSchema,
-    identifierValue: exports.ChannelIdentifierValueSchema,
+    identifierValue: exports.ChannelIdentifierValueSchema.optional(),
     appFields: zod_1.z.array(exports.AppFieldDefinitionSchema).optional(),
     settings: zod_1.z.array(zod_1.z.unknown()).optional(),
+    /** Typed dependencies - models, fields, etc. this channel requires */
+    requires: zod_1.z.array(exports.ResourceDependencySchema).optional(),
 });
+/**
+ * Shorter alias for channel definition (used in new config syntax).
+ */
+exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema;
 /**
  * Schema for workflow action input.
  */
@@ -131,8 +186,10 @@ exports.WorkflowDefinitionSchema = zod_1.z.object({
     label: zod_1.z.string().optional(),
     /** Workflow handle/key (optional when path is provided, inferred from YAML) */
     handle: zod_1.z.string().optional(),
-    /** Channel handle (optional) */
+    /** Channel handle (optional, deprecated - use requires instead) */
     channelHandle: zod_1.z.string().optional(),
+    /** Typed dependencies - channels, models, etc. this workflow requires */
+    requires: zod_1.z.array(exports.ResourceDependencySchema).optional(),
     /** Actions in this workflow */
     actions: zod_1.z.array(exports.WorkflowActionSchema),
 });
@@ -141,13 +198,13 @@ exports.WorkflowDefinitionSchema = zod_1.z.object({
  */
 exports.ComputeLayerTypeSchema = zod_1.z.enum(['serverless', 'dedicated']);
 // ─────────────────────────────────────────────────────────────────────────────
-// Internal Model Schemas (App-owned models)
+// Model Schemas (Unified INTERNAL + SHARED)
 // ─────────────────────────────────────────────────────────────────────────────
 /**
- * Schema for internal field data types.
+ * Schema for field data types.
  * Matches the DataType enum in the database.
  */
-exports.InternalFieldDataTypeSchema = zod_1.z.enum([
+exports.FieldDataTypeSchema = zod_1.z.enum([
     'LONG_STRING',
     'STRING',
     'NUMBER',
@@ -161,7 +218,62 @@ exports.InternalFieldDataTypeSchema = zod_1.z.enum([
     'OBJECT',
 ]);
 /**
- * Schema for a field within an internal model.
+ * Schema for a field within a model.
+ * Works for both INTERNAL and SHARED models.
+ */
+exports.ModelFieldDefinitionSchema = zod_1.z.object({
+    /** Field handle (unique within model) */
+    handle: zod_1.z.string(),
+    /** Display label */
+    label: zod_1.z.string(),
+    /** Data type (required for INTERNAL, optional for SHARED) */
+    type: exports.FieldDataTypeSchema.optional(),
+    /** Field definition handle for SHARED fields */
+    definitionHandle: zod_1.z.string().optional(),
+    /** Whether field is required */
+    required: zod_1.z.boolean().optional(),
+    /** Whether field must be unique */
+    unique: zod_1.z.boolean().optional(),
+    /** Whether this is a system field */
+    system: zod_1.z.boolean().optional(),
+    /** Whether field holds a list of values */
+    isList: zod_1.z.boolean().optional(),
+    /** Default value */
+    defaultValue: zod_1.z.object({ value: zod_1.z.unknown() }).optional(),
+    /** Field description */
+    description: zod_1.z.string().optional(),
+    /** Visibility settings for SHARED fields */
+    visibility: exports.AppFieldVisibilitySchema.optional(),
+});
+/**
+ * Schema for a unified model definition.
+ * Supports both INTERNAL (app-owned) and SHARED (user-mapped) models.
+ */
+exports.ModelDefinitionSchema = zod_1.z.object({
+    /** Model handle (unique within app) */
+    handle: zod_1.z.string(),
+    /** Display name */
+    name: zod_1.z.string(),
+    /** Plural display name */
+    namePlural: zod_1.z.string().optional(),
+    /** Resource scope: INTERNAL (app creates) or SHARED (user maps) */
+    scope: exports.ResourceScopeSchema,
+    /** Label template for display (required for INTERNAL) */
+    labelTemplate: zod_1.z.string().optional(),
+    /** Model description */
+    description: zod_1.z.string().optional(),
+    /** Field definitions */
+    fields: zod_1.z.array(exports.ModelFieldDefinitionSchema),
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Legacy Internal Model Schemas (deprecated - use ModelDefinitionSchema)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * @deprecated Use FieldDataTypeSchema instead
+ */
+exports.InternalFieldDataTypeSchema = exports.FieldDataTypeSchema;
+/**
+ * @deprecated Use ModelFieldDefinitionSchema instead
  */
 exports.InternalFieldDefinitionSchema = zod_1.z.object({
     handle: zod_1.z.string(),
@@ -176,7 +288,7 @@ exports.InternalFieldDefinitionSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
 });
 /**
- * Schema for an internal model definition.
+ * @deprecated Use ModelDefinitionSchema instead
  */
 exports.InternalModelDefinitionSchema = zod_1.z.object({
     handle: zod_1.z.string(),
@@ -204,9 +316,25 @@ exports.SkedyulConfigSchema = zod_1.z.object({
     webhooks: zod_1.z.unknown().optional(),
     workflowsPath: zod_1.z.string().optional(),
     env: exports.EnvSchemaSchema.optional(),
+    preInstall: zod_1.z
+        .object({
+        env: exports.EnvSchemaSchema.optional(),
+    })
+        .optional(),
     install: exports.InstallConfigSchema.optional(),
+    postInstall: zod_1.z
+        .object({
+        env: exports.EnvSchemaSchema.optional(),
+    })
+        .optional(),
+    // New unified model definitions (INTERNAL + SHARED)
+    models: zod_1.z.array(exports.ModelDefinitionSchema).optional(),
+    // New channel syntax (alias for communicationChannels)
+    channels: zod_1.z.array(exports.ChannelDefinitionSchema).optional(),
+    // Legacy: communication channels (deprecated - use channels)
     communicationChannels: zod_1.z.array(exports.CommunicationChannelDefinitionSchema).optional(),
     workflows: zod_1.z.array(exports.WorkflowDefinitionSchema).optional(),
+    // Legacy: internal models only (deprecated - use models with scope: INTERNAL)
     internalModels: zod_1.z.array(exports.InternalModelDefinitionSchema).optional(),
 });
 /**
@@ -216,3 +344,18 @@ function safeParseConfig(data) {
     const result = exports.SkedyulConfigSchema.safeParse(data);
     return result.success ? result.data : null;
 }
+// ─────────────────────────────────────────────────────────────────────────────
+// Dependency Type Guards
+// ─────────────────────────────────────────────────────────────────────────────
+/** Check if a dependency is a model dependency */
+function isModelDependency(dep) {
+    return 'model' in dep;
+}
+/** Check if a dependency is a channel dependency */
+function isChannelDependency(dep) {
+    return 'channel' in dep;
+}
+/** Check if a dependency is a workflow dependency */
+function isWorkflowDependency(dep) {
+    return 'workflow' in dep;
+}

package/package.json

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