skedyul 1.2.15 → 1.2.18

package/dist/cli/index.js

@@ -2951,8 +2951,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook) => ({
+    name: webhook.name,
+    description: webhook.description,
+    methods: webhook.methods ?? ["POST"],
+    type: webhook.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = import_http2.default.createServer(
     async (req, res) => {
@@ -2969,6 +3027,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -4056,6 +4123,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path14 === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path14 === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path14 === "/mcp" && method === "POST") {
           let body;
           try {
@@ -4429,6 +4504,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }

package/dist/config/index.d.ts

@@ -13,4 +13,5 @@ export type { InstallConfig, ProvisionConfig, BuildConfig, SkedyulConfig, Serial
 export { defineConfig } from './app-config';
 export { defineModel, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, } from './define';
 export { CONFIG_FILE_NAMES, loadConfig, validateConfig } from './loader';
+export { resolveConfig, createMinimalConfig } from './resolve';
 export { getAllEnvKeys, getRequiredInstallEnvKeys } from './utils';

package/dist/config/resolve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Config resolution utilities.
+ *
+ * This module provides functions to resolve dynamic imports in SkedyulConfig
+ * and convert it to a serializable format for the /config endpoint.
+ */
+import type { SkedyulConfig, SerializableSkedyulConfig } from './app-config';
+import type { ToolRegistry, WebhookRegistry } from '../types';
+/**
+ * Resolves all dynamic imports in a SkedyulConfig and returns a serializable version.
+ *
+ * This function:
+ * 1. Resolves dynamic imports for tools, webhooks, provision, and install
+ * 2. Serializes tool and webhook registries to metadata arrays
+ * 3. Returns a plain object suitable for JSON serialization
+ *
+ * @param config - The original SkedyulConfig (may contain dynamic imports)
+ * @param registry - The resolved tool registry (already loaded by mcp_server.ts)
+ * @param webhookRegistry - The resolved webhook registry (if any)
+ * @returns A fully resolved and serializable config
+ */
+export declare function resolveConfig(config: SkedyulConfig, registry: ToolRegistry, webhookRegistry?: WebhookRegistry): Promise<SerializableSkedyulConfig>;
+/**
+ * Creates a minimal SkedyulConfig from server metadata.
+ * Used as a fallback when appConfig is not provided.
+ */
+export declare function createMinimalConfig(name: string, version?: string): SkedyulConfig;

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

@@ -30,6 +30,13 @@ export type FieldType = 'string' | 'long_string' | 'text' | 'number' | 'boolean'
  * - 'restrict': Prevent deletion if references exist
  */
 export type OnDelete = 'none' | 'cascade' | 'restrict';
+/**
+ * Field requirement types.
+ * - 'optional': Field is never required
+ * - 'on_create': Field is required only when creating new records
+ * - 'required': Field is always required (create and update)
+ */
+export type FieldRequirementType = 'optional' | 'on_create' | 'required';
 /**
  * Inline field definition for options and validation constraints.
  */
@@ -79,7 +86,17 @@ export interface FieldDefinition {
      * - Omitted: Auto-creates workplace definition as <subdomain>/<model>/<field>
      */
     definition?: InlineFieldDefinition | string;
-    /** Whether this field is required */
+    /**
+     * Field requirement type.
+     * - 'optional': Field is never required (default)
+     * - 'on_create': Field is required only when creating new records
+     * - 'required': Field is always required (create and update)
+     */
+    requirement?: FieldRequirementType;
+    /**
+     * Whether this field is required.
+     * @deprecated Use `requirement` instead. Maps to 'required' if true, 'optional' if false.
+     */
     required?: boolean;
     /** Whether this field must be unique across all records */
     unique?: boolean;

package/dist/dedicated/server.js

@@ -769,8 +769,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook) => ({
+    name: webhook.name,
+    description: webhook.description,
+    methods: webhook.methods ?? ["POST"],
+    type: webhook.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = import_http2.default.createServer(
     async (req, res) => {
@@ -787,6 +845,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -1874,6 +1941,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path === "/mcp" && method === "POST") {
           let body;
           try {
@@ -2247,6 +2322,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }

package/dist/esm/index.mjs

@@ -163,11 +163,15 @@ var AppFieldVisibilitySchema = z2.object({
   list: z2.boolean().optional(),
   filters: z2.boolean().optional()
 });
+var FieldRequirementTypeSchema = z2.enum(["optional", "on_create", "required"]);
 var ModelFieldDefinitionSchema = z2.object({
   handle: z2.string(),
   label: z2.string(),
   type: FieldDataTypeSchema.optional(),
   definition: z2.union([InlineFieldDefinitionSchema, z2.string()]).optional(),
+  /** Field requirement type: 'optional', 'on_create', or 'required' */
+  requirement: FieldRequirementTypeSchema.optional(),
+  /** @deprecated Use `requirement` instead */
   required: z2.boolean().optional(),
   unique: z2.boolean().optional(),
   system: z2.boolean().optional(),
@@ -2451,8 +2455,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook2) => ({
+    name: webhook2.name,
+    description: webhook2.description,
+    methods: webhook2.methods ?? ["POST"],
+    type: webhook2.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = http.createServer(
     async (req, res) => {
@@ -2469,6 +2531,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -3556,6 +3627,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path2 === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path2 === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path2 === "/mcp" && method === "POST") {
           let body;
           try {
@@ -3929,6 +4008,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }
@@ -4175,6 +4255,7 @@ export {
   FieldDataTypeSchema,
   FieldOptionSchema,
   FieldOwnerSchema,
+  FieldRequirementTypeSchema,
   FieldSettingButtonPropsSchema,
   FieldSettingComponentDefinitionSchema,
   FileSettingComponentDefinitionSchema,
@@ -4253,6 +4334,7 @@ export {
   communicationChannel,
   configure,
   createContextLogger,
+  createMinimalConfig,
   createServerHookContext,
   createToolCallContext,
   createWebhookContext,
@@ -4279,6 +4361,7 @@ export {
   isWorkflowDependency,
   loadConfig,
   report,
+  resolveConfig,
   resource,
   runWithConfig,
   safeParseConfig,

package/dist/index.d.ts

@@ -15,5 +15,5 @@ declare const _default: {
     z: typeof z;
 };
 export default _default;
-export { defineConfig, defineModel, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, loadConfig, validateConfig, CONFIG_FILE_NAMES, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
+export { defineConfig, defineModel, defineChannel, definePage, defineWorkflow, defineAgent, defineEnv, defineNavigation, loadConfig, validateConfig, resolveConfig, createMinimalConfig, CONFIG_FILE_NAMES, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
 export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, ModelMapperBlock, BlockDefinition, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';

package/dist/index.js

@@ -57,6 +57,7 @@ __export(index_exports, {
   FieldDataTypeSchema: () => FieldDataTypeSchema,
   FieldOptionSchema: () => FieldOptionSchema,
   FieldOwnerSchema: () => FieldOwnerSchema,
+  FieldRequirementTypeSchema: () => FieldRequirementTypeSchema,
   FieldSettingButtonPropsSchema: () => FieldSettingButtonPropsSchema,
   FieldSettingComponentDefinitionSchema: () => FieldSettingComponentDefinitionSchema,
   FileSettingComponentDefinitionSchema: () => FileSettingComponentDefinitionSchema,
@@ -135,6 +136,7 @@ __export(index_exports, {
   communicationChannel: () => communicationChannel,
   configure: () => configure,
   createContextLogger: () => createContextLogger,
+  createMinimalConfig: () => createMinimalConfig,
   createServerHookContext: () => createServerHookContext,
   createToolCallContext: () => createToolCallContext,
   createWebhookContext: () => createWebhookContext,
@@ -161,6 +163,7 @@ __export(index_exports, {
   isWorkflowDependency: () => isWorkflowDependency,
   loadConfig: () => loadConfig,
   report: () => report,
+  resolveConfig: () => resolveConfig,
   resource: () => resource,
   runWithConfig: () => runWithConfig,
   safeParseConfig: () => safeParseConfig,
@@ -328,11 +331,15 @@ var AppFieldVisibilitySchema = import_v42.z.object({
   list: import_v42.z.boolean().optional(),
   filters: import_v42.z.boolean().optional()
 });
+var FieldRequirementTypeSchema = import_v42.z.enum(["optional", "on_create", "required"]);
 var ModelFieldDefinitionSchema = import_v42.z.object({
   handle: import_v42.z.string(),
   label: import_v42.z.string(),
   type: FieldDataTypeSchema.optional(),
   definition: import_v42.z.union([InlineFieldDefinitionSchema, import_v42.z.string()]).optional(),
+  /** Field requirement type: 'optional', 'on_create', or 'required' */
+  requirement: FieldRequirementTypeSchema.optional(),
+  /** @deprecated Use `requirement` instead */
   required: import_v42.z.boolean().optional(),
   unique: import_v42.z.boolean().optional(),
   system: import_v42.z.boolean().optional(),
@@ -2616,8 +2623,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook2) => ({
+    name: webhook2.name,
+    description: webhook2.description,
+    methods: webhook2.methods ?? ["POST"],
+    type: webhook2.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = import_http2.default.createServer(
     async (req, res) => {
@@ -2634,6 +2699,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -3721,6 +3795,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path2 === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path2 === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path2 === "/mcp" && method === "POST") {
           let body;
           try {
@@ -4094,6 +4176,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }
@@ -4341,6 +4424,7 @@ var index_default = { z: import_v44.z };
   FieldDataTypeSchema,
   FieldOptionSchema,
   FieldOwnerSchema,
+  FieldRequirementTypeSchema,
   FieldSettingButtonPropsSchema,
   FieldSettingComponentDefinitionSchema,
   FileSettingComponentDefinitionSchema,
@@ -4419,6 +4503,7 @@ var index_default = { z: import_v44.z };
   communicationChannel,
   configure,
   createContextLogger,
+  createMinimalConfig,
   createServerHookContext,
   createToolCallContext,
   createWebhookContext,
@@ -4444,6 +4529,7 @@ var index_default = { z: import_v44.z };
   isWorkflowDependency,
   loadConfig,
   report,
+  resolveConfig,
   resource,
   runWithConfig,
   safeParseConfig,

package/dist/schemas.d.ts

@@ -181,6 +181,11 @@ export declare const AppFieldVisibilitySchema: z.ZodObject<{
     list: z.ZodOptional<z.ZodBoolean>;
     filters: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+export declare const FieldRequirementTypeSchema: z.ZodEnum<{
+    required: "required";
+    optional: "optional";
+    on_create: "on_create";
+}>;
 export declare const ModelFieldDefinitionSchema: z.ZodObject<{
     handle: z.ZodString;
     label: z.ZodString;
@@ -211,6 +216,11 @@ export declare const ModelFieldDefinitionSchema: z.ZodObject<{
         relatedModel: z.ZodOptional<z.ZodString>;
         pattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodString]>>;
+    requirement: z.ZodOptional<z.ZodEnum<{
+        required: "required";
+        optional: "optional";
+        on_create: "on_create";
+    }>>;
     required: z.ZodOptional<z.ZodBoolean>;
     unique: z.ZodOptional<z.ZodBoolean>;
     system: z.ZodOptional<z.ZodBoolean>;
@@ -265,6 +275,11 @@ export declare const ModelDefinitionSchema: z.ZodObject<{
             relatedModel: z.ZodOptional<z.ZodString>;
             pattern: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodString]>>;
+        requirement: z.ZodOptional<z.ZodEnum<{
+            required: "required";
+            optional: "optional";
+            on_create: "on_create";
+        }>>;
         required: z.ZodOptional<z.ZodBoolean>;
         unique: z.ZodOptional<z.ZodBoolean>;
         system: z.ZodOptional<z.ZodBoolean>;
@@ -2973,6 +2988,11 @@ export declare const InstallConfigSchema: z.ZodObject<{
                 relatedModel: z.ZodOptional<z.ZodString>;
                 pattern: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodString]>>;
+            requirement: z.ZodOptional<z.ZodEnum<{
+                required: "required";
+                optional: "optional";
+                on_create: "on_create";
+            }>>;
             required: z.ZodOptional<z.ZodBoolean>;
             unique: z.ZodOptional<z.ZodBoolean>;
             system: z.ZodOptional<z.ZodBoolean>;
@@ -3090,6 +3110,11 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                 relatedModel: z.ZodOptional<z.ZodString>;
                 pattern: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodString]>>;
+            requirement: z.ZodOptional<z.ZodEnum<{
+                required: "required";
+                optional: "optional";
+                on_create: "on_create";
+            }>>;
             required: z.ZodOptional<z.ZodBoolean>;
             unique: z.ZodOptional<z.ZodBoolean>;
             system: z.ZodOptional<z.ZodBoolean>;
@@ -3770,6 +3795,11 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                     relatedModel: z.ZodOptional<z.ZodString>;
                     pattern: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>, z.ZodString]>>;
+                requirement: z.ZodOptional<z.ZodEnum<{
+                    required: "required";
+                    optional: "optional";
+                    on_create: "on_create";
+                }>>;
                 required: z.ZodOptional<z.ZodBoolean>;
                 unique: z.ZodOptional<z.ZodBoolean>;
                 system: z.ZodOptional<z.ZodBoolean>;
@@ -4405,6 +4435,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
 export type ParsedSkedyulConfig = z.infer<typeof SkedyulConfigSchema>;
 export declare function safeParseConfig(data: unknown): ParsedSkedyulConfig | null;
 export type FieldOwner = z.infer<typeof FieldOwnerSchema>;
+export type FieldRequirementType = z.infer<typeof FieldRequirementTypeSchema>;
 export type FieldOption = z.infer<typeof FieldOptionSchema>;
 export type InlineFieldDefinition = z.infer<typeof InlineFieldDefinitionSchema>;
 export type RelationshipCardinality = z.infer<typeof RelationshipCardinalitySchema>;

package/dist/server/dedicated.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { SkedyulServerConfig, SkedyulServerInstance, ToolCallResponse, ToolMetadata, WebhookRegistry } from '../types';
+import type { SkedyulServerConfig, SkedyulServerInstance, ToolCallResponse, ToolMetadata, ToolRegistry, WebhookRegistry } from '../types';
 import type { RequestState } from './types';
 /**
  * Creates a dedicated (long-running HTTP) server instance
  */
-export declare function createDedicatedServerInstance(config: SkedyulServerConfig, tools: ToolMetadata[], callTool: (nameRaw: unknown, argsRaw: unknown) => Promise<ToolCallResponse>, state: RequestState, mcpServer: McpServer, webhookRegistry?: WebhookRegistry): SkedyulServerInstance;
+export declare function createDedicatedServerInstance(config: SkedyulServerConfig, tools: ToolMetadata[], callTool: (nameRaw: unknown, argsRaw: unknown) => Promise<ToolCallResponse>, state: RequestState, mcpServer: McpServer, registry: ToolRegistry, webhookRegistry?: WebhookRegistry): SkedyulServerInstance;

package/dist/server.js

@@ -769,8 +769,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook) => ({
+    name: webhook.name,
+    description: webhook.description,
+    methods: webhook.methods ?? ["POST"],
+    type: webhook.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = import_http2.default.createServer(
     async (req, res) => {
@@ -787,6 +845,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -1874,6 +1941,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path === "/mcp" && method === "POST") {
           let body;
           try {
@@ -2247,6 +2322,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }

package/dist/serverless/server.mjs

@@ -708,8 +708,66 @@ function printStartupLog(config, tools, webhookRegistry, port) {
   console.log("");
 }
 
+// src/config/resolve.ts
+async function resolveDynamicImport(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (value instanceof Promise) {
+    const resolved = await value;
+    if (resolved && typeof resolved === "object" && "default" in resolved) {
+      return resolved.default;
+    }
+    return resolved;
+  }
+  return value;
+}
+function serializeTools(registry) {
+  return Object.entries(registry).map(([key, tool]) => ({
+    name: tool.name || key,
+    displayName: tool.label,
+    description: tool.description,
+    timeout: tool.timeout,
+    retries: tool.retries
+  }));
+}
+function serializeWebhooks(registry) {
+  return Object.values(registry).map((webhook) => ({
+    name: webhook.name,
+    description: webhook.description,
+    methods: webhook.methods ?? ["POST"],
+    type: webhook.type ?? "WEBHOOK"
+  }));
+}
+async function resolveConfig(config, registry, webhookRegistry) {
+  const provision = await resolveDynamicImport(
+    config.provision
+  );
+  const install = await resolveDynamicImport(
+    config.install
+  );
+  const tools = serializeTools(registry);
+  const webhooks = webhookRegistry ? serializeWebhooks(webhookRegistry) : [];
+  return {
+    name: config.name,
+    version: config.version,
+    description: config.description,
+    computeLayer: config.computeLayer,
+    tools,
+    webhooks,
+    provision,
+    agents: config.agents
+  };
+}
+function createMinimalConfig(name, version) {
+  return {
+    name,
+    version
+  };
+}
+
 // src/server/dedicated.ts
-function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, webhookRegistry) {
+function createDedicatedServerInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
   const port = getListeningPort(config);
   const httpServer = http.createServer(
     async (req, res) => {
@@ -726,6 +784,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
           sendJSON(res, 200, state.getHealthStatus());
           return;
         }
+        if (pathname === "/config" && req.method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          sendJSON(res, 200, serializedConfig);
+          return;
+        }
         if (pathname.startsWith("/webhooks/") && webhookRegistry) {
           const handle = pathname.slice("/webhooks/".length);
           const webhookDef = webhookRegistry[handle];
@@ -1813,6 +1880,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
         if (path === "/health" && method === "GET") {
           return createResponse(200, state.getHealthStatus(), headers);
         }
+        if (path === "/config" && method === "GET") {
+          const appConfig = config.appConfig ?? createMinimalConfig(
+            config.metadata.name,
+            config.metadata.version
+          );
+          const serializedConfig = await resolveConfig(appConfig, registry, webhookRegistry);
+          return createResponse(200, serializedConfig, headers);
+        }
         if (path === "/mcp" && method === "POST") {
           let body;
           try {
@@ -2186,6 +2261,7 @@ function createSkedyulServer(config, registry, webhookRegistry) {
       callTool,
       state,
       mcpServer,
+      registry,
       webhookRegistry
     );
   }

package/dist/types/server.d.ts

@@ -2,6 +2,7 @@ import type { CoreApiConfig } from '../core/types';
 import type { ServerHooks } from './handlers';
 import type { APIGatewayProxyEvent, APIGatewayProxyResult } from './aws';
 import type { ComputeLayer } from '../config/types/compute';
+import type { SkedyulConfig } from '../config/app-config';
 export interface HealthStatus {
     status: 'running';
     requests: number;
@@ -32,6 +33,8 @@ export interface SkedyulServerConfig {
     coreApi?: CoreApiConfig;
     /** Lifecycle hooks for install and provision handlers */
     hooks?: ServerHooks;
+    /** Original app config from skedyul.config.ts for /config endpoint serialization */
+    appConfig?: SkedyulConfig;
 }
 export interface DedicatedServerInstance {
     listen(port?: number): Promise<void>;

package/package.json

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