skedyul 0.2.134 → 0.2.136

package/dist/.build-stamp

@@ -1 +1 @@
-1770160446171
+1770176002055

package/dist/config.d.ts

@@ -636,7 +636,7 @@ export interface WebhookHandlerDefinition {
     handler: WebhookHandlerFn;
 }
 export type Webhooks = Record<string, WebhookHandlerDefinition>;
-export type { InstallHandlerContext, InstallHandlerResult, InstallHandler, ProvisionHandlerContext, ProvisionHandlerResult, ProvisionHandler, } from './types';
+export type { InstallHandlerContext, InstallHandlerResult, InstallHandler, ProvisionHandlerContext, ProvisionHandlerResult, ProvisionHandler, ServerHooks, } from './types';
 /**
  * Install configuration - defines per-install env vars and lifecycle hooks.
  * Tool names reference tools in the tool registry, enabling agent-invocation.
@@ -649,6 +649,35 @@ export interface InstallConfig {
     /** Tool name to invoke when app is uninstalled (for cleanup) */
     onUninstall?: string;
 }
+/**
+ * Definition for an app-provided agent.
+ * Agents are created globally during provisioning and become available
+ * to workplaces that install the app.
+ */
+export interface AgentDefinition {
+    /** Unique identifier within the app (used for upserts) */
+    handle: string;
+    /** Display name */
+    name: string;
+    /** Description of what the agent does */
+    description: string;
+    /** System prompt (static, no templating) */
+    system: string;
+    /** Tool names to bind (must exist in this app's tools) */
+    tools: string[];
+    /** Optional LLM model override (defaults to workspace default) */
+    llmModelId?: string;
+    /**
+     * Parent agent that can call this agent.
+     * Creates an AGENT-type tool and binds it to the parent.
+     *
+     * Values:
+     * - 'composer' - Bind to the workspace's Composer agent
+     * - '<handle>' - Bind to another agent in this app (by handle)
+     * - undefined  - Standalone agent (not callable by other agents)
+     */
+    parentAgent?: string;
+}
 /** Provision-level configuration - auto-synced when app version is deployed */
 export interface ProvisionConfig {
     /** Global environment variables (developer-level, shared across all installs) */
@@ -691,6 +720,8 @@ export interface SkedyulConfig {
     install?: InstallConfig | Promise<{
         default: InstallConfig;
     }>;
+    /** Agent definitions - multi-tenant agents with tool bindings */
+    agents?: AgentDefinition[];
 }
 export interface SerializableSkedyulConfig {
     name: string;
@@ -703,6 +734,8 @@ export interface SerializableSkedyulConfig {
     webhooks?: WebhookMetadata[];
     /** Provision config (fully resolved) */
     provision?: ProvisionConfig;
+    /** Agent definitions (stored as-is) */
+    agents?: AgentDefinition[];
 }
 export interface WebhookHandlerMetadata {
     name: string;

package/dist/index.d.ts

@@ -11,4 +11,4 @@ declare const _default: {
 };
 export default _default;
 export { defineConfig, loadConfig, validateConfig, CONFIG_FILE_NAMES, getAllEnvKeys, getRequiredInstallEnvKeys, } from './config';
-export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, ComputeLayerType, InstallHandlerContext, InstallHandlerResult, InstallHandler, ProvisionHandlerContext, ProvisionHandlerResult, ProvisionHandler, InstallConfig, ModelDefinition, ModelFieldDefinition, ResourceScope, FieldOwner, InternalFieldDataType, FieldOption, InlineFieldDefinition, AppFieldVisibility, RelationshipDefinition, RelationshipLink, RelationshipCardinality, OnDeleteBehavior, ChannelDefinition, ChannelCapability, ChannelCapabilityType, ChannelFieldDefinition, WorkflowDefinition, WorkflowAction, WorkflowActionInput, PageDefinition, PageBlockDefinition, PageFieldDefinition, PageActionDefinition, PageType, PageBlockType, PageFieldType, PageFieldSource, PageFormHeader, PageContextMode, PageContextItemDefinition, PageContextDefinition, PageInstanceFilter, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, WebhookHttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ProvisionConfig, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, StructuredFilter, } from './config';
+export type { SkedyulConfig, SerializableSkedyulConfig, EnvVariableDefinition, EnvSchema, EnvVisibility, ComputeLayerType, InstallHandlerContext, InstallHandlerResult, InstallHandler, ProvisionHandlerContext, ProvisionHandlerResult, ProvisionHandler, ServerHooks, InstallConfig, ModelDefinition, ModelFieldDefinition, ResourceScope, FieldOwner, InternalFieldDataType, FieldOption, InlineFieldDefinition, AppFieldVisibility, RelationshipDefinition, RelationshipLink, RelationshipCardinality, OnDeleteBehavior, ChannelDefinition, ChannelCapability, ChannelCapabilityType, ChannelFieldDefinition, WorkflowDefinition, WorkflowAction, WorkflowActionInput, PageDefinition, PageBlockDefinition, PageFieldDefinition, PageActionDefinition, PageType, PageBlockType, PageFieldType, PageFieldSource, PageFormHeader, PageContextMode, PageContextItemDefinition, PageContextDefinition, PageInstanceFilter, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, WebhookHttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ProvisionConfig, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, StructuredFilter, } from './config';

package/dist/schemas.d.ts

@@ -2788,6 +2788,16 @@ export declare const WebhooksSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     }>>;
     handler: z.ZodUnknown;
 }, z.core.$strip>>;
+export declare const AgentDefinitionSchema: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    system: z.ZodString;
+    tools: z.ZodArray<z.ZodString>;
+    llmModelId: z.ZodOptional<z.ZodString>;
+    parentAgent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentDefinition = z.infer<typeof AgentDefinitionSchema>;
 export declare const ProvisionConfigSchema: z.ZodObject<{
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         label: z.ZodString;
@@ -4058,6 +4068,15 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodUnknown]>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        system: z.ZodString;
+        tools: z.ZodArray<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        parentAgent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type ParsedSkedyulConfig = z.infer<typeof SkedyulConfigSchema>;
 export declare function safeParseConfig(data: unknown): ParsedSkedyulConfig | null;

package/dist/schemas.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListItemTemplateSchema = exports.FileSettingComponentDefinitionSchema = exports.ImageSettingComponentDefinitionSchema = exports.TimePickerComponentDefinitionSchema = exports.DatePickerComponentDefinitionSchema = exports.CheckboxComponentDefinitionSchema = exports.ComboboxComponentDefinitionSchema = exports.SelectComponentDefinitionSchema = exports.TextareaComponentDefinitionSchema = exports.InputComponentDefinitionSchema = exports.FormLayoutConfigDefinitionSchema = exports.FormLayoutRowDefinitionSchema = exports.FormLayoutColumnDefinitionSchema = exports.RelationshipExtensionSchema = exports.FieldSettingButtonPropsSchema = exports.FormV2StylePropsSchema = exports.PageActionDefinitionSchema = exports.PageFormHeaderSchema = exports.PageFieldSourceSchema = exports.PageFieldTypeSchema = exports.PageBlockTypeSchema = exports.PageTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.ChannelFieldDefinitionSchema = exports.ChannelCapabilitySchema = exports.ChannelCapabilityTypeSchema = exports.RelationshipDefinitionSchema = exports.RelationshipLinkSchema = exports.OnDeleteBehaviorSchema = exports.RelationshipCardinalitySchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InlineFieldDefinitionSchema = exports.FieldOptionSchema = exports.FieldDataTypeSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.StructuredFilterSchema = exports.FieldOwnerSchema = exports.ResourceScopeSchema = exports.ComputeLayerTypeSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
-exports.MessageSendOutputSchema = exports.MessageSendInputSchema = exports.MessageSendMessageSchema = exports.MessageSendContactSchema = exports.MessageSendSubscriptionSchema = exports.MessageSendChannelSchema = exports.SkedyulConfigSchema = exports.ProvisionConfigSchema = exports.WebhooksSchema = exports.WebhookHandlerDefinitionSchema = exports.WebhookTypeSchema = exports.WebhookHttpMethodSchema = exports.PageDefinitionSchema = exports.NavigationConfigSchema = exports.NavigationBreadcrumbSchema = exports.BreadcrumbItemSchema = exports.NavigationSidebarSchema = exports.NavigationSectionSchema = exports.NavigationItemSchema = exports.PageInstanceFilterSchema = exports.PageContextDefinitionSchema = exports.PageContextItemDefinitionSchema = exports.PageContextFiltersSchema = exports.PageContextModeSchema = exports.PageBlockDefinitionSchema = exports.ModelMapperBlockDefinitionSchema = exports.ListBlockDefinitionSchema = exports.LegacyFormBlockDefinitionSchema = exports.PageFieldDefinitionSchema = exports.CardBlockDefinitionSchema = exports.CardBlockHeaderSchema = exports.FormV2PropsDefinitionSchema = exports.FormV2ComponentDefinitionSchema = exports.FieldSettingComponentDefinitionSchema = exports.ModalFormDefinitionSchema = exports.AlertComponentDefinitionSchema = exports.EmptyFormComponentDefinitionSchema = exports.ListComponentDefinitionSchema = void 0;
+exports.MessageSendOutputSchema = exports.MessageSendInputSchema = exports.MessageSendMessageSchema = exports.MessageSendContactSchema = exports.MessageSendSubscriptionSchema = exports.MessageSendChannelSchema = exports.SkedyulConfigSchema = exports.ProvisionConfigSchema = exports.AgentDefinitionSchema = exports.WebhooksSchema = exports.WebhookHandlerDefinitionSchema = exports.WebhookTypeSchema = exports.WebhookHttpMethodSchema = exports.PageDefinitionSchema = exports.NavigationConfigSchema = exports.NavigationBreadcrumbSchema = exports.BreadcrumbItemSchema = exports.NavigationSidebarSchema = exports.NavigationSectionSchema = exports.NavigationItemSchema = exports.PageInstanceFilterSchema = exports.PageContextDefinitionSchema = exports.PageContextItemDefinitionSchema = exports.PageContextFiltersSchema = exports.PageContextModeSchema = exports.PageBlockDefinitionSchema = exports.ModelMapperBlockDefinitionSchema = exports.ListBlockDefinitionSchema = exports.LegacyFormBlockDefinitionSchema = exports.PageFieldDefinitionSchema = exports.CardBlockDefinitionSchema = exports.CardBlockHeaderSchema = exports.FormV2PropsDefinitionSchema = exports.FormV2ComponentDefinitionSchema = exports.FieldSettingComponentDefinitionSchema = exports.ModalFormDefinitionSchema = exports.AlertComponentDefinitionSchema = exports.EmptyFormComponentDefinitionSchema = exports.ListComponentDefinitionSchema = void 0;
 exports.safeParseConfig = safeParseConfig;
 exports.isModelDependency = isModelDependency;
 exports.isChannelDependency = isChannelDependency;
@@ -668,6 +668,25 @@ exports.WebhooksSchema = zod_1.z.record(zod_1.z.string(), exports.WebhookHandler
 // ─────────────────────────────────────────────────────────────────────────────
 // Provision Config Schema
 // ─────────────────────────────────────────────────────────────────────────────
+// Agent Definition Schema
+// ─────────────────────────────────────────────────────────────────────────────
+exports.AgentDefinitionSchema = zod_1.z.object({
+    /** Unique identifier within the app (used for upserts) */
+    handle: zod_1.z.string().regex(/^[a-z0-9_-]+$/, 'Handle must be lowercase alphanumeric with dashes/underscores'),
+    /** Display name */
+    name: zod_1.z.string().min(1),
+    /** Description of what the agent does */
+    description: zod_1.z.string(),
+    /** System prompt (static, no templating) */
+    system: zod_1.z.string(),
+    /** Tool names to bind (can be empty for orchestrator agents) */
+    tools: zod_1.z.array(zod_1.z.string()),
+    /** Optional LLM model override */
+    llmModelId: zod_1.z.string().optional(),
+    /** Parent agent that can call this agent ('composer' or another agent handle) */
+    parentAgent: zod_1.z.string().optional(),
+});
+// ─────────────────────────────────────────────────────────────────────────────
 exports.ProvisionConfigSchema = zod_1.z.object({
     env: exports.EnvSchemaSchema.optional(),
     models: zod_1.z.array(exports.ModelDefinitionSchema).optional(),
@@ -689,6 +708,7 @@ exports.SkedyulConfigSchema = zod_1.z.object({
     tools: zod_1.z.unknown().optional(),
     webhooks: zod_1.z.unknown().optional(),
     provision: zod_1.z.union([exports.ProvisionConfigSchema, zod_1.z.unknown()]).optional(),
+    agents: zod_1.z.array(exports.AgentDefinitionSchema).optional(),
 });
 function safeParseConfig(data) {
     const result = exports.SkedyulConfigSchema.safeParse(data);

package/dist/server.js

@@ -860,7 +860,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
             }
             // Handle /install endpoint for install handlers
             if (pathname === '/install' && req.method === 'POST') {
-                if (!config.installHandler) {
+                if (!config.hooks?.install) {
                     sendJSON(res, 404, { error: 'Install handler not configured' });
                     return;
                 }
@@ -887,13 +887,18 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                     app: installBody.context.app,
                 };
                 // Build request-scoped config for SDK access
+                // Use env from request body (contains generated token from workflow)
                 const installRequestConfig = {
-                    baseUrl: process.env.SKEDYUL_API_URL ?? '',
-                    apiToken: process.env.SKEDYUL_API_TOKEN ?? '',
+                    baseUrl: installBody.env?.SKEDYUL_API_URL ??
+                        process.env.SKEDYUL_API_URL ??
+                        '',
+                    apiToken: installBody.env?.SKEDYUL_API_TOKEN ??
+                        process.env.SKEDYUL_API_TOKEN ??
+                        '',
                 };
                 try {
                     const result = await (0, client_1.runWithConfig)(installRequestConfig, async () => {
-                        return await config.installHandler(installContext);
+                        return await config.hooks.install(installContext);
                     });
                     sendJSON(res, 200, {
                         env: result.env ?? {},
@@ -912,7 +917,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
             }
             // Handle /provision endpoint for provision handlers
             if (pathname === '/provision' && req.method === 'POST') {
-                if (!config.provisionHandler) {
+                if (!config.hooks?.provision) {
                     sendJSON(res, 404, { error: 'Provision handler not configured' });
                     return;
                 }
@@ -945,7 +950,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                 };
                 try {
                     const result = await (0, client_1.runWithConfig)(provisionRequestConfig, async () => {
-                        return await config.provisionHandler(provisionContext);
+                        return await config.hooks.provision(provisionContext);
                     });
                     sendJSON(res, 200, result);
                 }
@@ -1382,7 +1387,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                 }
                 // Handle /install endpoint for install handlers
                 if (path === '/install' && method === 'POST') {
-                    if (!config.installHandler) {
+                    if (!config.hooks?.install) {
                         return createResponse(404, { error: 'Install handler not configured' }, headers);
                     }
                     let installBody;
@@ -1401,8 +1406,20 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                         appInstallationId: installBody.context.appInstallationId,
                         app: installBody.context.app,
                     };
+                    // Build request-scoped config for SDK access
+                    // Use env from request body (contains generated token from workflow)
+                    const installRequestConfig = {
+                        baseUrl: installBody.env?.SKEDYUL_API_URL ??
+                            process.env.SKEDYUL_API_URL ??
+                            '',
+                        apiToken: installBody.env?.SKEDYUL_API_TOKEN ??
+                            process.env.SKEDYUL_API_TOKEN ??
+                            '',
+                    };
                     try {
-                        const result = await config.installHandler(installContext);
+                        const result = await (0, client_1.runWithConfig)(installRequestConfig, async () => {
+                            return await config.hooks.install(installContext);
+                        });
                         return createResponse(200, { env: result.env ?? {}, redirect: result.redirect }, headers);
                     }
                     catch (err) {

package/dist/types.d.ts

@@ -157,6 +157,16 @@ export interface CorsOptions {
     allowMethods?: string;
     allowHeaders?: string;
 }
+/**
+ * Lifecycle hooks for the Skedyul server.
+ * These handlers are called during app installation and provisioning.
+ */
+export interface ServerHooks {
+    /** Called during app installation to validate/normalize env and perform setup */
+    install?: InstallHandler;
+    /** Called after app version provisioning to set up version-level resources */
+    provision?: ProvisionHandler;
+}
 export interface SkedyulServerConfig {
     computeLayer: ComputeLayer;
     metadata: ServerMetadata;
@@ -165,10 +175,8 @@ export interface SkedyulServerConfig {
     ttlExtendSeconds?: number;
     cors?: CorsOptions;
     coreApi?: CoreApiConfig;
-    /** Optional install handler for the /install endpoint */
-    installHandler?: InstallHandler;
-    /** Optional provision handler for the /provision endpoint */
-    provisionHandler?: ProvisionHandler;
+    /** Lifecycle hooks for install and provision handlers */
+    hooks?: ServerHooks;
 }
 export interface InstallHandlerContext {
     env: Record<string, string>;

package/package.json

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