skedyul 0.1.56 → 0.1.58

package/dist/.build-stamp

@@ -1 +1 @@
-1768803609286
+1769031652921

package/dist/config.d.ts

@@ -271,7 +271,7 @@ 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';
+export type PageFieldType = 'STRING' | 'FILE' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SELECT' | 'FORM';
 /** Data source for prepopulating a page field from a model */
 export interface PageFieldSource {
     /** Model handle to pull data from */
@@ -279,6 +279,13 @@ export interface PageFieldSource {
     /** Field handle on that model */
     field: string;
 }
+/** Header configuration for FORM type fields */
+export interface PageFormHeader {
+    /** Modal title */
+    title: string;
+    /** Optional description shown below title */
+    description?: string;
+}
 /** Self-contained field definition for page blocks */
 export interface PageFieldDefinition {
     /** Unique handle for this field */
@@ -291,7 +298,7 @@ export interface PageFieldDefinition {
     description?: string;
     /** Whether field is required */
     required?: boolean;
-    /** Tool name from registry to call on value change */
+    /** Tool name from registry to call on value change or form submit */
     handler?: string;
     /** Data source for prepopulating field value */
     source?: PageFieldSource;
@@ -302,6 +309,12 @@ export interface PageFieldDefinition {
     }>;
     /** For FILE type: accepted file extensions */
     accept?: string;
+    /** For FORM type: header configuration for the modal */
+    header?: PageFormHeader;
+    /** For FORM type: nested fields rendered inside the modal form */
+    fields?: PageFieldDefinition[];
+    /** For FORM type: action buttons in the modal footer */
+    actions?: PageActionDefinition[];
 }
 /** Action button definition for pages */
 export interface PageActionDefinition {

package/dist/core/client.d.ts

@@ -170,26 +170,40 @@ export interface InstanceListResult {
 export interface InstanceListArgs {
     page?: number;
     limit?: number;
-    filters?: Record<string, unknown>;
+    /** Filter conditions. Simple format { field: value } or structured { field: { eq: value } } */
+    filter?: Record<string, unknown>;
 }
 export declare const instance: {
     /**
-     * List instances of an internal model scoped by appInstallationId.
+     * List instances of an internal model.
+     *
+     * **Behavior based on context:**
+     * - With ctx (appInstallationId): scoped to that installation
+     * - Without ctx + sk_app_ token: searches across ALL installations for the app
      *
      * @example
      * ```ts
+     * // Scoped to a specific installation (in tool handlers)
      * const ctx = {
-     *   appInstallationId: fieldContext.appInstallationId,
-     *   workplace: fieldContext.workplace,
+     *   appInstallationId: context.appInstallationId,
+     *   workplace: context.workplace,
      * }
-     *
-     * const { data: records, pagination } = await instance.list('compliance_record', ctx, {
+     * const { data, pagination } = await instance.list('compliance_record', ctx, {
      *   page: 1,
      *   limit: 10,
      * })
+     *
+     * // Cross-installation search (in webhooks with sk_app_ token)
+     * const { data } = await instance.list('phone_number', undefined, {
+     *   filter: { phone: '+1234567890' },
+     * })
+     * if (data.length > 0) {
+     *   const { appInstallationId } = data[0]
+     *   const { token: scopedToken } = await token.exchange(appInstallationId)
+     * }
      * ```
      */
-    list(modelHandle: string, ctx: InstanceContext, args?: InstanceListArgs): Promise<InstanceListResult>;
+    list(modelHandle: string, ctx?: InstanceContext, args?: InstanceListArgs): Promise<InstanceListResult>;
     /**
      * Get a single instance by ID.
      *
@@ -224,4 +238,29 @@ export declare const instance: {
      */
     update(id: string, data: Record<string, unknown>, ctx: InstanceContext): Promise<InstanceData>;
 };
+export declare const token: {
+    /**
+     * Exchange an sk_app_ token for an installation-scoped sk_wkp_ JWT.
+     *
+     * **Requires sk_app_ token** - only works with app-level tokens.
+     * Used after identifying the target installation (e.g., via instance.search).
+     *
+     * The returned JWT is short-lived (1 hour) and scoped to the specific installation.
+     *
+     * @example
+     * ```ts
+     * // After finding the installation via instance.search
+     * const { token: scopedToken } = await token.exchange(appInstallationId)
+     *
+     * // Use the scoped token for subsequent operations
+     * runWithConfig({ apiToken: scopedToken, baseUrl: config.baseUrl }, async () => {
+     *   const channels = await communicationChannel.list({ filter: { identifierValue: phoneNumber } })
+     *   // ...
+     * })
+     * ```
+     */
+    exchange(appInstallationId: string): Promise<{
+        token: string;
+    }>;
+};
 export {};

package/dist/core/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.instance = exports.communicationChannel = exports.workplace = void 0;
+exports.token = exports.instance = exports.communicationChannel = exports.workplace = void 0;
 exports.runWithConfig = runWithConfig;
 exports.configure = configure;
 exports.getConfig = getConfig;
@@ -81,7 +81,8 @@ function getConfig() {
 // Core API Client
 // ─────────────────────────────────────────────────────────────────────────────
 async function callCore(method, params) {
-    const { baseUrl, apiToken } = getEffectiveConfig();
+    const effectiveConfig = getEffectiveConfig();
+    const { baseUrl, apiToken } = effectiveConfig;
     if (!baseUrl) {
         throw new Error('Skedyul client not configured: missing baseUrl. Set SKEDYUL_API_URL environment variable or call configure().');
     }
@@ -92,11 +93,19 @@ async function callCore(method, params) {
         'Content-Type': 'application/json',
         Authorization: `Bearer ${apiToken}`,
     };
-    const response = await fetch(`${baseUrl}/core`, {
+    const fetchUrl = `${baseUrl}/core`;
+    const response = await fetch(fetchUrl, {
         method: 'POST',
         headers,
         body: JSON.stringify({ method, params }),
     });
+    // Check content-type before parsing
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!contentType.includes('application/json')) {
+        const text = await response.text();
+        console.error(`[skedyul-node] Core API error: ${response.status} - ${text.slice(0, 200)}`);
+        throw new Error(`Core API returned non-JSON response (${response.status}): ${text.slice(0, 100)}`);
+    }
     const payload = (await response.json());
     if (!response.ok) {
         throw new Error(payload?.error?.message ?? `Core API error (${response.status})`);
@@ -170,29 +179,42 @@ exports.communicationChannel = {
 };
 exports.instance = {
     /**
-     * List instances of an internal model scoped by appInstallationId.
+     * List instances of an internal model.
+     *
+     * **Behavior based on context:**
+     * - With ctx (appInstallationId): scoped to that installation
+     * - Without ctx + sk_app_ token: searches across ALL installations for the app
      *
      * @example
      * ```ts
+     * // Scoped to a specific installation (in tool handlers)
      * const ctx = {
-     *   appInstallationId: fieldContext.appInstallationId,
-     *   workplace: fieldContext.workplace,
+     *   appInstallationId: context.appInstallationId,
+     *   workplace: context.workplace,
      * }
-     *
-     * const { data: records, pagination } = await instance.list('compliance_record', ctx, {
+     * const { data, pagination } = await instance.list('compliance_record', ctx, {
      *   page: 1,
      *   limit: 10,
      * })
+     *
+     * // Cross-installation search (in webhooks with sk_app_ token)
+     * const { data } = await instance.list('phone_number', undefined, {
+     *   filter: { phone: '+1234567890' },
+     * })
+     * if (data.length > 0) {
+     *   const { appInstallationId } = data[0]
+     *   const { token: scopedToken } = await token.exchange(appInstallationId)
+     * }
      * ```
      */
     async list(modelHandle, ctx, args) {
         const payload = (await callCore('instance.list', {
             modelHandle,
-            appInstallationId: ctx.appInstallationId,
-            workplaceId: ctx.workplace.id,
+            ...(ctx?.appInstallationId ? { appInstallationId: ctx.appInstallationId } : {}),
+            ...(ctx?.workplace?.id ? { workplaceId: ctx.workplace.id } : {}),
             ...(args?.page !== undefined ? { page: args.page } : {}),
             ...(args?.limit !== undefined ? { limit: args.limit } : {}),
-            ...(args?.filters ? { filters: args.filters } : {}),
+            ...(args?.filter ? { filter: args.filter } : {}),
         }));
         return payload;
     },
@@ -253,3 +275,34 @@ exports.instance = {
         return payload.instance;
     },
 };
+// ─────────────────────────────────────────────────────────────────────────────
+// Token Client
+// ─────────────────────────────────────────────────────────────────────────────
+exports.token = {
+    /**
+     * Exchange an sk_app_ token for an installation-scoped sk_wkp_ JWT.
+     *
+     * **Requires sk_app_ token** - only works with app-level tokens.
+     * Used after identifying the target installation (e.g., via instance.search).
+     *
+     * The returned JWT is short-lived (1 hour) and scoped to the specific installation.
+     *
+     * @example
+     * ```ts
+     * // After finding the installation via instance.search
+     * const { token: scopedToken } = await token.exchange(appInstallationId)
+     *
+     * // Use the scoped token for subsequent operations
+     * runWithConfig({ apiToken: scopedToken, baseUrl: config.baseUrl }, async () => {
+     *   const channels = await communicationChannel.list({ filter: { identifierValue: phoneNumber } })
+     *   // ...
+     * })
+     * ```
+     */
+    async exchange(appInstallationId) {
+        const payload = (await callCore('token.exchange', {
+            appInstallationId,
+        }));
+        return payload;
+    },
+};

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export * from './types';
 export * from './schemas';
 export { server } from './server';
 export { z };
-export { workplace, communicationChannel, instance, configure, getConfig, runWithConfig, } from './core/client';
+export { workplace, communicationChannel, instance, token, configure, getConfig, runWithConfig, } from './core/client';
 export type { InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, } from './core/client';
 declare const _default: {
     z: typeof z;

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_FILE_NAMES = exports.getAllEnvKeys = exports.getRequiredInstallEnvKeys = exports.validateConfig = exports.loadConfig = exports.defineConfig = exports.runWithConfig = exports.getConfig = exports.configure = exports.instance = exports.communicationChannel = exports.workplace = exports.z = exports.server = void 0;
+exports.CONFIG_FILE_NAMES = exports.getAllEnvKeys = exports.getRequiredInstallEnvKeys = exports.validateConfig = exports.loadConfig = exports.defineConfig = exports.runWithConfig = exports.getConfig = exports.configure = exports.token = exports.instance = exports.communicationChannel = exports.workplace = exports.z = exports.server = void 0;
 const zod_1 = require("zod");
 Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
 __exportStar(require("./types"), exports);
@@ -25,6 +25,7 @@ var client_1 = require("./core/client");
 Object.defineProperty(exports, "workplace", { enumerable: true, get: function () { return client_1.workplace; } });
 Object.defineProperty(exports, "communicationChannel", { enumerable: true, get: function () { return client_1.communicationChannel; } });
 Object.defineProperty(exports, "instance", { enumerable: true, get: function () { return client_1.instance; } });
+Object.defineProperty(exports, "token", { enumerable: true, get: function () { return client_1.token; } });
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return client_1.configure; } });
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return client_1.getConfig; } });
 Object.defineProperty(exports, "runWithConfig", { enumerable: true, get: function () { return client_1.runWithConfig; } });

package/dist/schemas.d.ts

@@ -464,14 +464,20 @@ export declare const PageFieldTypeSchema: z.ZodEnum<{
     DATE: "DATE";
     FILE: "FILE";
     SELECT: "SELECT";
+    FORM: "FORM";
 }>;
 /** 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<{
+/** Header configuration for FORM type fields */
+export declare const PageFormHeaderSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Base field definition (without nested fields to avoid circular reference) */
+declare const PageFieldDefinitionBaseSchema: z.ZodObject<{
     handle: z.ZodString;
     type: z.ZodEnum<{
         STRING: "STRING";
@@ -480,6 +486,7 @@ export declare const PageFieldDefinitionSchema: z.ZodObject<{
         DATE: "DATE";
         FILE: "FILE";
         SELECT: "SELECT";
+        FORM: "FORM";
     }>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -495,6 +502,14 @@ export declare const PageFieldDefinitionSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     accept: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Self-contained field definition for page blocks */
+export declare const PageFieldDefinitionSchema: z.ZodType<PageFieldDefinition>;
+/** Page field definition type */
+export type PageFieldDefinition = z.infer<typeof PageFieldDefinitionBaseSchema> & {
+    header?: z.infer<typeof PageFormHeaderSchema>;
+    fields?: PageFieldDefinition[];
+    actions?: PageActionDefinition[];
+};
 /** Action button definition for pages */
 export declare const PageActionDefinitionSchema: z.ZodObject<{
     handle: z.ZodString;
@@ -520,30 +535,7 @@ export declare const PageBlockDefinitionSchema: z.ZodObject<{
         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>>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodType<PageFieldDefinition, unknown, z.core.$ZodTypeInternals<PageFieldDefinition, unknown>>>>;
     readonly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /** Filter for selecting which instance(s) to display on a page */
@@ -573,30 +565,7 @@ export declare const PageDefinitionSchema: z.ZodObject<{
             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>>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodType<PageFieldDefinition, unknown, z.core.$ZodTypeInternals<PageFieldDefinition, unknown>>>>;
         readonly: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1034,30 +1003,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 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>>>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodType<PageFieldDefinition, unknown, z.core.$ZodTypeInternals<PageFieldDefinition, unknown>>>>;
             readonly: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1292,3 +1238,4 @@ export declare function isModelDependency(dep: ResourceDependency): dep is Model
 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;
+export {};

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.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.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.InlineFieldDefinitionSchema = exports.PageDefinitionSchema = exports.PageInstanceFilterSchema = exports.PageBlockDefinitionSchema = exports.PageActionDefinitionSchema = exports.PageFieldDefinitionSchema = exports.PageFormHeaderSchema = 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;
@@ -316,6 +316,7 @@ exports.PageFieldTypeSchema = zod_1.z.enum([
     'DATE',
     'BOOLEAN',
     'SELECT',
+    'FORM', // Nested form that opens in a modal
 ]);
 /** Data source for prepopulating a page field from a model */
 exports.PageFieldSourceSchema = zod_1.z.object({
@@ -324,8 +325,15 @@ exports.PageFieldSourceSchema = zod_1.z.object({
     /** Field handle on that model */
     field: zod_1.z.string(),
 });
-/** Self-contained field definition for page blocks */
-exports.PageFieldDefinitionSchema = zod_1.z.object({
+/** Header configuration for FORM type fields */
+exports.PageFormHeaderSchema = zod_1.z.object({
+    /** Modal title */
+    title: zod_1.z.string(),
+    /** Optional description shown below title */
+    description: zod_1.z.string().optional(),
+});
+/** Base field definition (without nested fields to avoid circular reference) */
+const PageFieldDefinitionBaseSchema = zod_1.z.object({
     /** Unique handle for this field */
     handle: zod_1.z.string(),
     /** Field datatype - determines UI component */
@@ -336,7 +344,7 @@ exports.PageFieldDefinitionSchema = zod_1.z.object({
     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 */
+    /** Tool name from registry to call on value change or form submit */
     handler: zod_1.z.string().optional(),
     /** Data source for prepopulating field value */
     source: exports.PageFieldSourceSchema.optional(),
@@ -345,6 +353,15 @@ exports.PageFieldDefinitionSchema = zod_1.z.object({
     /** For FILE type: accepted file extensions */
     accept: zod_1.z.string().optional(),
 });
+/** Self-contained field definition for page blocks */
+exports.PageFieldDefinitionSchema = PageFieldDefinitionBaseSchema.extend({
+    /** For FORM type: header configuration for the modal */
+    header: exports.PageFormHeaderSchema.optional(),
+    /** For FORM type: nested fields rendered inside the modal form */
+    fields: zod_1.z.lazy(() => zod_1.z.array(exports.PageFieldDefinitionSchema)).optional(),
+    /** For FORM type: action buttons in the modal footer */
+    actions: zod_1.z.lazy(() => zod_1.z.array(exports.PageActionDefinitionSchema)).optional(),
+});
 /** Action button definition for pages */
 exports.PageActionDefinitionSchema = zod_1.z.object({
     /** Unique handle for this action */

package/dist/types.d.ts

@@ -57,7 +57,7 @@ export interface ToolParams<Input, Output> {
     context: ToolContext;
 }
 /** Trigger types for tool execution */
-export type ToolTrigger = 'field_change' | 'page_action' | 'agent' | 'workflow';
+export type ToolTrigger = 'field_change' | 'page_action' | 'agent' | 'workflow' | 'form_submit';
 /** Field info when tool is triggered by a field change */
 export interface ToolFieldContext {
     /** Field handle from page definition */

package/package.json

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