skedyul 1.2.48 → 1.2.51

package/dist/cli/commands/event.d.ts

@@ -0,0 +1 @@
+export declare function eventCommand(args: string[]): Promise<void>;

package/dist/cli/index.js

@@ -1735,6 +1735,23 @@ var file = {
     return data;
   }
 };
+var event = {
+  async create(name, payload, options) {
+    const { trigger, correlationId, app, context: extraContext } = options ?? {};
+    const context = {
+      ...extraContext ?? {},
+      ...trigger ? { trigger } : {},
+      ...correlationId ? { correlationId } : {}
+    };
+    const { data } = await callCore("event.create", {
+      name,
+      payload,
+      ...Object.keys(context).length > 0 ? { context } : {},
+      ...app ? { app } : {}
+    });
+    return data;
+  }
+};
 
 // src/cli/commands/invoke.ts
 function getMimeType(filePath) {
@@ -3196,22 +3213,22 @@ function printStartupLog(config, tools, port) {
 }
 
 // src/server/route-handlers/adapters.ts
-function fromLambdaEvent(event) {
-  const path23 = event.path || event.rawPath || "/";
-  const method = event.httpMethod || event.requestContext?.http?.method || "POST";
-  const forwardedProto = event.headers?.["x-forwarded-proto"] ?? event.headers?.["X-Forwarded-Proto"];
+function fromLambdaEvent(event2) {
+  const path23 = event2.path || event2.rawPath || "/";
+  const method = event2.httpMethod || event2.requestContext?.http?.method || "POST";
+  const forwardedProto = event2.headers?.["x-forwarded-proto"] ?? event2.headers?.["X-Forwarded-Proto"];
   const protocol = forwardedProto ?? "https";
-  const host = event.headers?.host ?? event.headers?.Host ?? "localhost";
-  const queryString = event.queryStringParameters ? "?" + new URLSearchParams(
-    event.queryStringParameters
+  const host = event2.headers?.host ?? event2.headers?.Host ?? "localhost";
+  const queryString = event2.queryStringParameters ? "?" + new URLSearchParams(
+    event2.queryStringParameters
   ).toString() : "";
   const url = `${protocol}://${host}${path23}${queryString}`;
   return {
     path: path23,
     method,
-    headers: event.headers,
-    query: event.queryStringParameters ?? {},
-    body: event.body,
+    headers: event2.headers,
+    query: event2.queryStringParameters ?? {},
+    body: event2.body,
     url
   };
 }
@@ -4574,12 +4591,12 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer) {
     defaultHeaders
   };
   return {
-    async handler(event) {
+    async handler(event2) {
       if (!hasLoggedStartup) {
         printStartupLog(config, tools);
         hasLoggedStartup = true;
       }
-      const req = fromLambdaEvent(event);
+      const req = fromLambdaEvent(event2);
       const response = await routeRequest(req, ctx);
       return toLambdaResponse(response, defaultHeaders);
     },
@@ -9762,6 +9779,8 @@ var SkillRefSchema = import_v45.z.union([
     skill: import_v45.z.string(),
     description: import_v45.z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: import_v45.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v45.z.number().optional(),
     // Pin to specific version number
@@ -9971,8 +9990,10 @@ var PoliciesConfigV3Schema = import_v47.z.object({
   }).optional()
 });
 var RuntimeConfigV3Schema = import_v47.z.object({
-  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
-  model: import_v47.z.string().optional()
+  /** LLM model identifier for reasoning (e.g., "google/gemini-3.1-flash-lite") */
+  model: import_v47.z.string().optional(),
+  /** LLM model for persona transformation (e.g., "openai/gpt-5-nano") */
+  personaModel: import_v47.z.string().optional()
 });
 var TimeWindowTimeStampSchema = import_v47.z.union([
   import_v47.z.number().describe("Hour of day (0-23)"),
@@ -10021,10 +10042,21 @@ var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
   "Fallback behavior when no time window matches"
 );
 var ResponsesBehaviorConfigSchema = import_v47.z.object({
+  /**
+   * Maximum immediate messages per agent run (acks, progress updates).
+   * @default 1
+   */
+  maxImmediate: import_v47.z.number().optional(),
+  /**
+   * Maximum scheduled messages per agent run (follow-ups via sendAt).
+   * @default 2
+   */
+  maxScheduled: import_v47.z.number().optional(),
   /**
    * Maximum intermediate messages per agent run.
    * Intermediate = progress updates, acknowledgments before task completion.
    * The final message slot is always reserved separately.
+   * @deprecated Use maxImmediate instead
    * @default 2
    */
   maxIntermediate: import_v47.z.number().optional(),
@@ -10147,7 +10179,7 @@ var AgentYAMLV3Schema = import_v47.z.object({
   memory: MemoryConfigV3Schema.optional(),
   // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration (only model is used)
+  // Runtime - Execution configuration (model + personaModel)
   runtime: RuntimeConfigV3Schema.optional(),
   // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),
@@ -11730,89 +11762,89 @@ Error: ${input.name} is required`);
       const turnToolCalls = [];
       const turnSkillLoads = [];
       const turnThoughts = [];
-      for await (const event of eventStream) {
+      for await (const event2 of eventStream) {
         const now = Date.now();
         const sinceLastEvent = now - lastEventTime;
         lastEventTime = now;
-        if (event.agentName) {
-          currentAgentName = event.agentName;
+        if (event2.agentName) {
+          currentAgentName = event2.agentName;
         }
-        if (event.isChildAgent !== void 0) {
-          currentIsChildAgent = event.isChildAgent;
+        if (event2.isChildAgent !== void 0) {
+          currentIsChildAgent = event2.isChildAgent;
         }
-        if (event.agentName && event.isChildAgent && event.agentName !== lastDisplayedAgentName && !messageStarted) {
+        if (event2.agentName && event2.isChildAgent && event2.agentName !== lastDisplayedAgentName && !messageStarted) {
           if (currentThought) {
             clearLine();
             currentThought = "";
           }
-          console.log(`\x1B[2m    [${event.agentName}]\x1B[0m`);
-          lastDisplayedAgentName = event.agentName;
+          console.log(`\x1B[2m    [${event2.agentName}]\x1B[0m`);
+          lastDisplayedAgentName = event2.agentName;
         }
-        if (event.initial && event.threadId) {
-          threadId = event.threadId;
+        if (event2.initial && event2.threadId) {
+          threadId = event2.threadId;
         }
-        if (event.context && event.context.length > 0 && !messageStarted) {
-          for (const ctx of event.context) {
+        if (event2.context && event2.context.length > 0 && !messageStarted) {
+          for (const ctx of event2.context) {
             if (currentThought) {
               clearLine();
               currentThought = "";
             }
             const contextType = ctx.hint || ctx.model || "";
-            const durationStr = event.durationMs ? ` (${event.durationMs}ms)` : "";
-            const indent = event.isChildAgent ? "      " : "  ";
+            const durationStr = event2.durationMs ? ` (${event2.durationMs}ms)` : "";
+            const indent = event2.isChildAgent ? "      " : "  ";
             console.log(
               `\x1B[2m${indent}[Context] ${contextType ? contextType.toLowerCase() + ": " : ""}${ctx.label}${durationStr}\x1B[0m`
             );
           }
         }
-        if (event.thought !== void 0 && !messageStarted) {
-          if (event.durationMs !== void 0) {
+        if (event2.thought !== void 0 && !messageStarted) {
+          if (event2.durationMs !== void 0) {
             clearLine();
-            console.log(formatThought(event.thought, event.isChildAgent) + `\x1B[2m (${event.durationMs}ms)\x1B[0m`);
-            turnThoughts.push({ content: event.thought, durationMs: event.durationMs });
+            console.log(formatThought(event2.thought, event2.isChildAgent) + `\x1B[2m (${event2.durationMs}ms)\x1B[0m`);
+            turnThoughts.push({ content: event2.thought, durationMs: event2.durationMs });
             currentThought = "";
             thoughtStartTime = null;
-          } else if (!event.thoughtComplete) {
-            if (currentThought !== event.thought) {
+          } else if (!event2.thoughtComplete) {
+            if (currentThought !== event2.thought) {
               if (thoughtStartTime === null) {
                 thoughtStartTime = now;
               }
               clearLine();
-              process.stdout.write(formatThought(event.thought, event.isChildAgent));
-              currentThought = event.thought;
+              process.stdout.write(formatThought(event2.thought, event2.isChildAgent));
+              currentThought = event2.thought;
             }
           } else {
             clearLine();
             const thoughtDuration = thoughtStartTime ? now - thoughtStartTime : 0;
-            console.log(formatThought(event.thought, event.isChildAgent) + `\x1B[2m (${thoughtDuration}ms)\x1B[0m`);
-            turnThoughts.push({ content: event.thought, durationMs: thoughtDuration || void 0 });
+            console.log(formatThought(event2.thought, event2.isChildAgent) + `\x1B[2m (${thoughtDuration}ms)\x1B[0m`);
+            turnThoughts.push({ content: event2.thought, durationMs: thoughtDuration || void 0 });
             currentThought = "";
             thoughtStartTime = null;
           }
         }
-        if (event.agentOutput !== void 0 && !messageStarted) {
+        if (event2.agentOutput !== void 0 && !messageStarted) {
           if (currentThought) {
             clearLine();
             currentThought = "";
             thoughtStartTime = null;
           }
-          const indent = event.isChildAgent ? "      " : "  ";
-          const durationStr = event.durationMs ? ` (${event.durationMs}ms)` : "";
+          const indent = event2.isChildAgent ? "      " : "  ";
+          const durationStr = event2.durationMs ? ` (${event2.durationMs}ms)` : "";
           console.log(`\x1B[33m${indent}[Output]${durationStr}\x1B[0m`);
-          const lines = event.agentOutput.split("\n");
+          const lines = event2.agentOutput.split("\n");
           for (const line of lines) {
             console.log(`\x1B[33m${indent}  ${line}\x1B[0m`);
           }
         }
-        if (event.toolCall) {
-          debug("Tool call event received:", event.toolCall.name, event.toolCall.status, "messageStarted:", messageStarted);
+        if (event2.toolCall) {
+          debug("Tool call event received:", event2.toolCall.name, event2.toolCall.status, "messageStarted:", messageStarted);
           if (!messageStarted) {
             if (currentThought) {
               clearLine();
               currentThought = "";
               thoughtStartTime = null;
             }
-            const tc = event.toolCall;
+            const tc = event2.toolCall;
             const isSkillLoad = tc.name === "system:skill:load" || tc.name === "load_skill";
             const getToolKey = (name, args3) => {
               if ((name === "system:skill:load" || name === "load_skill") && args3?.name) {
@@ -11891,14 +11923,14 @@ Error: ${input.name} is required`);
             debug("Skipping tool call display because messageStarted is true");
           }
         }
-        if (event.pendingApproval && !messageStarted) {
+        if (event2.pendingApproval && !messageStarted) {
           if (currentThought) {
             clearLine();
             currentThought = "";
             thoughtStartTime = null;
           }
-          const approval = event.pendingApproval;
-          const indent = event.isChildAgent ? "      " : "  ";
+          const approval = event2.pendingApproval;
+          const indent = event2.isChildAgent ? "      " : "  ";
           console.log(`
 \x1B[33m${indent}[Approval Required] ${approval.displayName}\x1B[0m`);
           if (approval.args && Object.keys(approval.args).length > 0) {
@@ -11912,12 +11944,12 @@ Error: ${input.name} is required`);
           }
           console.log(`\x1B[33m${indent}  (Approval flow not yet implemented for non-sandbox mode)\x1B[0m`);
         }
-        if (event.data && event.data.length > 0 && !messageStarted) {
+        if (event2.data && event2.data.length > 0 && !messageStarted) {
           if (currentThought) {
             clearLine();
             currentThought = "";
           }
-          for (const block of event.data) {
+          for (const block of event2.data) {
             if (block.type === "tool_result") {
               const toolName = block.toolName || "tool";
               const summary = block.summary;
@@ -11925,14 +11957,14 @@ Error: ${input.name} is required`);
             }
           }
         }
-        if (event.sentMessage) {
+        if (event2.sentMessage) {
           if (currentThought) {
             clearLine();
             currentThought = "";
             thoughtStartTime = null;
           }
-          const msg = event.sentMessage;
-          const indent = event.isChildAgent ? "      " : "  ";
+          const msg = event2.sentMessage;
+          const indent = event2.isChildAgent ? "      " : "  ";
           const displayName = currentAgentName || "Agent";
           if (msg.type === "intermediate") {
             console.log(`
@@ -11954,26 +11986,26 @@ Error: ${input.name} is required`);
             messageStarted = true;
           }
         }
-        if (event.message !== void 0 && event.message !== lastMessage) {
-          const isUserEcho = event.message.toLowerCase() === userInput.toLowerCase();
+        if (event2.message !== void 0 && event2.message !== lastMessage) {
+          const isUserEcho = event2.message.toLowerCase() === userInput.toLowerCase();
           if (isUserEcho) {
-            debug("Skipping user input echo:", JSON.stringify(event.message));
-            lastMessage = event.message;
+            debug("Skipping user input echo:", JSON.stringify(event2.message));
+            lastMessage = event2.message;
             continue;
           }
-          debug("Message event - last:", JSON.stringify(lastMessage), "new:", JSON.stringify(event.message));
-          lastMessage = event.message;
+          debug("Message event - last:", JSON.stringify(lastMessage), "new:", JSON.stringify(event2.message));
+          lastMessage = event2.message;
         }
-        if (event.done) {
+        if (event2.done) {
           const totalTime = Date.now() - requestStartTime;
-          debug("Final event received:", JSON.stringify(event).slice(0, 500));
+          debug("Final event received:", JSON.stringify(event2).slice(0, 500));
           if (currentThought) {
             clearLine();
             currentThought = "";
           }
           const displayName = currentAgentName || "Agent";
-          const sentMessages = event.sentMessages;
-          const eventSchedulingDefaults = event.schedulingDefaults;
+          const sentMessages = event2.sentMessages;
+          const eventSchedulingDefaults = event2.schedulingDefaults;
           if (sandbox && eventSchedulingDefaults) {
             schedulingDefaults = {
               cancelOnActivity: eventSchedulingDefaults.cancelOnActivity ?? true,
@@ -12026,8 +12058,8 @@ Error: ${input.name} is required`);
             console.log(`
 \x1B[1m${displayName}:\x1B[0m ${lastMessage}`);
           }
-          if (event.thoughts && Array.isArray(event.thoughts)) {
-            for (const t of event.thoughts) {
+          if (event2.thoughts && Array.isArray(event2.thoughts)) {
+            for (const t of event2.thoughts) {
               if (!turnThoughts.some((existing) => existing.content === t.content)) {
                 turnThoughts.push({ content: t.content, durationMs: t.durationMs });
               }
@@ -12038,21 +12070,21 @@ Error: ${input.name} is required`);
             printNestedTrace(allToolCalls, turnThoughts);
           }
           console.log(`\x1B[2m  Total: ${totalTime}ms\x1B[0m`);
-          if (sandbox && event.updatedMockContext) {
+          if (sandbox && event2.updatedMockContext) {
             const oldGoals = getProspectData(mockContext)?.goals;
-            mockContext = event.updatedMockContext;
+            mockContext = event2.updatedMockContext;
             const newGoals = getProspectData(mockContext)?.goals;
             debug("Mock context updated from server. Old goals:", JSON.stringify(oldGoals), "New goals:", JSON.stringify(newGoals));
           } else if (sandbox) {
-            debug("No updatedMockContext in event. Event keys:", Object.keys(event));
+            debug("No updatedMockContext in event. Event keys:", Object.keys(event2));
           }
           if (sandbox && lastMessage) {
             chatHistory.push({ role: "user", content: trimmed });
             chatHistory.push({ role: "assistant", content: lastMessage });
             debug("Chat history updated, now", chatHistory.length, "messages");
           }
-          if (sandbox && event.toolCalls && event.toolCalls.length > 0) {
-            const newToolCalls = event.toolCalls.map((tc) => ({
+          if (sandbox && event2.toolCalls && event2.toolCalls.length > 0) {
+            const newToolCalls = event2.toolCalls.map((tc) => ({
               toolCallId: tc.toolCallId,
               toolName: tc.toolName,
               args: tc.args,
@@ -12067,9 +12099,9 @@ Error: ${input.name} is required`);
           }
           break;
         }
-        if (event.error) {
+        if (event2.error) {
           console.error(`
-\x1B[31mError: ${event.error}\x1B[0m`);
+\x1B[31mError: ${event2.error}\x1B[0m`);
           break;
         }
       }
@@ -13498,6 +13530,184 @@ async function workflowsCommand(args2) {
   }
 }
 
+// src/cli/commands/event.ts
+init_utils();
+function printHelp23() {
+  console.log(`
+skedyul event - Emit test app events to the event bus
+
+Usage:
+  skedyul event create <name> [data] [options]
+
+Required:
+  <name>                    Event name (e.g. customer.sync)
+  --workplace, -w           Workplace subdomain
+
+Options:
+  --data, -d                JSON payload (default: {})
+  --app, -a                 App handle namespace (default: cli)
+                            Event type becomes app.{app}.{name}
+  --context, -c             JSON context metadata (optional)
+  --json                    Output full JSON response
+  --help, -h                Show this help message
+
+Examples:
+  # Emit with inline JSON payload
+  skedyul event create customer.sync '{"customers":[{"id":1}]}' -w demo-clinic
+
+  # Emit with --data flag
+  skedyul event create order.created -w demo-clinic \\
+    --data '{"order":{"id":123,"email":"test@example.com"}}'
+
+  # Use a specific app namespace (matches production event types)
+  skedyul event create customer.sync '{"customers":[]}' -w demo-clinic --app shopify
+
+  # Empty payload
+  skedyul event create ping -w demo-clinic
+
+Notes:
+  - Uses your CLI login + workplace membership (no app install required)
+  - Event type: app.{app}.{name} (app defaults to "cli")
+  - Passthrough when no EventSubscription exists: emitted=false, eventId=null
+  - Create EventSubscription rows in the UI to test workflow dispatch
+`);
+}
+async function getWorkplaceToken8(workplaceSubdomain, serverUrl, cliToken) {
+  return callCliApi(
+    { serverUrl, token: cliToken },
+    "/workplace-token",
+    { workplaceSubdomain }
+  );
+}
+function parseJsonObject(value, label) {
+  if (!value || value.trim() === "") {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error(`${label} must be a JSON object`);
+    }
+    return parsed;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid ${label} JSON: ${message}`);
+  }
+}
+async function eventCommand(args2) {
+  const { positional, flags } = parseArgs(args2);
+  if (flags.help || flags.h || positional.length === 0) {
+    printHelp23();
+    return;
+  }
+  const subcommand = positional[0];
+  if (subcommand !== "create") {
+    console.error(`Error: Unknown subcommand: ${subcommand}`);
+    printHelp23();
+    process.exit(1);
+  }
+  const eventName = positional[1];
+  const inlineData = positional[2];
+  if (!eventName) {
+    console.error("Error: Event name is required");
+    console.error(
+      "Usage: skedyul event create <name> [data] --workplace <subdomain>"
+    );
+    process.exit(1);
+  }
+  const workplaceSubdomain = flags.workplace || flags.w;
+  if (!workplaceSubdomain) {
+    console.error("Error: --workplace (-w) is required");
+    console.error(
+      "Example: skedyul event create customer.sync '{}' --workplace demo-clinic"
+    );
+    process.exit(1);
+  }
+  const credentials = getCredentials();
+  if (!credentials) {
+    console.error("Error: Not logged in.");
+    console.error("Run 'skedyul auth login' to authenticate first.");
+    process.exit(1);
+  }
+  const serverUrl = getServerUrl();
+  let workplaceToken;
+  try {
+    workplaceToken = await getWorkplaceToken8(
+      workplaceSubdomain,
+      serverUrl,
+      credentials.token
+    );
+  } catch (error) {
+    console.error(
+      `Error: Failed to get workplace token: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+  const dataSource = flags.data ?? flags.d ?? inlineData;
+  let payload;
+  try {
+    payload = parseJsonObject(dataSource, "payload");
+  } catch (error) {
+    console.error(
+      `Error: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+  const appHandle = flags.app || flags.a;
+  let extraContext;
+  const contextSource = flags.context || flags.c;
+  if (contextSource) {
+    try {
+      extraContext = parseJsonObject(contextSource, "context");
+    } catch (error) {
+      console.error(
+        `Error: ${error instanceof Error ? error.message : String(error)}`
+      );
+      process.exit(1);
+    }
+  }
+  const clientConfig = {
+    baseUrl: serverUrl,
+    apiToken: workplaceToken.token
+  };
+  configure(clientConfig);
+  try {
+    const result = await runWithConfig(
+      clientConfig,
+      () => event.create(eventName, payload, {
+        trigger: "cli",
+        app: appHandle,
+        context: extraContext
+      })
+    );
+    const eventType = result.eventType ?? `app.${appHandle ?? "cli"}.${eventName}`;
+    if (flags.json) {
+      console.log(
+        formatJson({
+          ...result,
+          eventType,
+          workplace: workplaceToken.workplaceSubdomain
+        })
+      );
+      return;
+    }
+    if (result.emitted) {
+      console.log(`Event emitted: ${eventType}`);
+      console.log(`Event ID: ${result.eventId}`);
+    } else {
+      console.log(`Passthrough (no subscription): ${eventType}`);
+      console.log(
+        `No Event row created. Add an EventSubscription for "${eventType}" to test dispatch.`
+      );
+    }
+  } catch (error) {
+    console.error(
+      `Error: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+}
+
 // src/cli/index.ts
 var args = process.argv.slice(2);
 function printUsage2() {
@@ -13529,6 +13739,7 @@ COMMANDS
   agents     Manage agents (list, get, push)
   skills     Manage skills (list, get, deploy, publish, versions, delete)
   workflows  Manage workflows (list, get, deploy, run, publish, pull)
+  event        Emit test app events to the event bus (CLI testing)
   dev        Development tools for building and testing apps locally
 
 GETTING STARTED
@@ -13561,6 +13772,12 @@ CRM INSTANCES
   $ skedyul instances update <model> <id> --data '{}' --workplace <subdomain>
   $ skedyul instances delete <model> <id> --workplace <subdomain>
 
+SIGNALS (CLI testing)
+  Emit app events without an app installation:
+
+  $ skedyul event create customer.sync '{"customers":[]}' --workplace <subdomain>
+  $ skedyul event create ping --workplace <subdomain> --app shopify
+
 CONFIGURATION
   Global credentials:     ~/.skedyul/credentials.json
   Global config:          ~/.skedyul/config.json
@@ -13736,6 +13953,10 @@ async function main() {
     await workflowsCommand(args.slice(1));
     return;
   }
+  if (command === "event") {
+    await eventCommand(args.slice(1));
+    return;
+  }
   if (command === "build") {
     await buildCommand(args.slice(1));
     return;

package/dist/config/app-config.d.ts

@@ -6,7 +6,7 @@
 import type { ToolRegistry, WebhookRegistry, ToolMetadata, WebhookMetadata } from '../types';
 import type { ServerHooks } from '../types/handlers';
 import type { CoreApiConfig } from '../core/types';
-import type { EnvSchema, ComputeLayer, ModelDefinition, RelationshipDefinition, ChannelDefinition, WorkflowDefinition, PageDefinition, NavigationConfig, AgentDefinition } from './types';
+import type { EnvSchema, ComputeLayer, ModelDefinition, RelationshipDefinition, ChannelDefinition, WorkflowDefinition, PageDefinition, NavigationConfig, AgentDefinition, SignalDefinition } from './types';
 /**
  * Install configuration - defines per-install env vars and SHARED models.
  * This is configured by users during app installation.
@@ -38,6 +38,8 @@ export interface ProvisionConfig {
     navigation?: NavigationConfig;
     /** Page definitions for app UI */
     pages?: PageDefinition[];
+    /** App signal definitions (event bus subscriptions created on install) */
+    signals?: SignalDefinition[];
 }
 /**
  * Build configuration - controls how the integration is bundled.

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

@@ -11,6 +11,7 @@ export * from './channel';
 export * from './workflow';
 export * from './agent';
 export * from './webhook';
+export * from './signal';
 export * from './navigation';
 export * from './context';
 export * from './form';

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

@@ -0,0 +1,20 @@
+/**
+ * App signal definition for provision config.
+ *
+ * Signals are UI-facing names for event types: signal.{appHandle}.{name}
+ * Install-time provisioning creates EventSubscription + EVENT trigger rows.
+ */
+export interface SignalDefinition {
+    /** Short signal name, e.g. "customer.sync" → signal.shopify.customer.sync */
+    name: string;
+    /** UI display name */
+    label?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Bundled workflow handle, e.g. "sync-customers" or "@shopify/sync-customers" */
+    workflowHandle: string;
+    /** Default Liquid input mappings for the subscribed workflow */
+    inputMappings?: Record<string, string>;
+    /** Optional EventSubscription condition filter */
+    condition?: string;
+}

package/dist/core/client.d.ts

@@ -765,6 +765,28 @@ export declare const cron: {
         subscriptions: CronSubscriptionItem[];
     }>;
 };
+export interface EventCreateResult {
+    /** false when no EventSubscription matches (passthrough) */
+    emitted: boolean;
+    eventId: string | null;
+    /** Present when server returns resolved event type */
+    eventType?: string;
+}
+export interface EventCreateOptions {
+    /** Context trigger source, e.g. tool_call, webhook, cli */
+    trigger?: string;
+    correlationId?: string;
+    /** App handle namespace for event type (CLI default: cli) */
+    app?: string;
+    /** Additional context fields merged into event payload context */
+    context?: Record<string, unknown>;
+}
+/**
+ * event.create - Emit an app event to the platform event bus.
+ */
+export declare const event: {
+    create(name: string, payload: Record<string, unknown>, options?: EventCreateOptions): Promise<EventCreateResult>;
+};
 /**
  * Parameters for resource.link
  */

package/dist/dockerfile.d.ts

@@ -13,4 +13,4 @@
  *   - BUILD_EXTERNAL: comma-separated list of external dependencies (e.g., 'twilio,stripe')
  *   - MCP_ENV_JSON: JSON string of environment variables to bake into the image
  */
-export declare const DEFAULT_DOCKERFILE = "# =============================================================================\n# BUILDER STAGE - Common build for all targets\n# =============================================================================\nFROM public.ecr.aws/docker/library/node:22-alpine AS builder\n\nARG COMPUTE_LAYER=serverless\nARG BUILD_EXTERNAL=\"\"\nWORKDIR /app\n\n# Install pnpm\nRUN corepack enable && corepack prepare pnpm@latest --activate\n\n# Copy all project files (excluding node_modules via .dockerignore)\n# This includes: package.json, tsconfig.json, skedyul.config.ts, provision.ts, env.ts\n# And directories: src/, crm/, channels/, pages/, workflows/, agents/, etc.\nCOPY . .\n\n# Install dependencies (including dev deps for build), compile, export config, smoke test, then prune\n# Note: Using --no-frozen-lockfile since lockfile may not exist\n# skedyul build reads computeLayer from skedyul.config.ts\n# skedyul config:export resolves all dynamic imports and writes .skedyul/config.json\n# We use tsx to run config:export since it needs to import TypeScript files\n# Smoke test runs before pruning since skedyul CLI is a dev dependency\nRUN pnpm install --no-frozen-lockfile && \\\n    pnpm run build && \\\n    pnpm exec tsx node_modules/skedyul/dist/cli/index.js config:export && \\\n    pnpm exec skedyul smoke-test && \\\n    pnpm prune --prod && \\\n    pnpm store prune && \\\n    rm -rf /tmp/* /var/cache/apk/* ~/.npm\n\n# =============================================================================\n# DEDICATED STAGE - For local Docker and ECS deployments (HTTP server)\n# =============================================================================\nFROM public.ecr.aws/docker/library/node:22-alpine AS dedicated\n\nWORKDIR /app\n\n# Copy built artifacts\nCOPY --from=builder /app/node_modules ./node_modules\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package.json ./package.json\nCOPY --from=builder /app/.skedyul ./.skedyul\n\n# Allow overriding the baked-in MCP env at runtime\nARG MCP_ENV_JSON=\"{}\"\nENV MCP_ENV_JSON=${MCP_ENV_JSON}\n\n# Expose the HTTP port\nEXPOSE 3000\n\n# Run as HTTP server (dedicated mode auto-detected by absence of AWS_LAMBDA_FUNCTION_NAME)\n# Support both .js (dedicated builds) and .mjs (serverless builds) extensions\nCMD [\"sh\", \"-c\", \"node dist/server/mcp_server.mjs 2>/dev/null || node dist/server/mcp_server.js\"]\n\n# =============================================================================\n# SERVERLESS STAGE - For AWS Lambda deployments\n# =============================================================================\nFROM public.ecr.aws/lambda/nodejs:22 AS serverless\n\nWORKDIR ${LAMBDA_TASK_ROOT}\n\nCOPY --from=builder /app/node_modules ./node_modules\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package.json ./package.json\nCOPY --from=builder /app/.skedyul ./.skedyul\n\n# Allow overriding the baked-in MCP env at runtime\nARG MCP_ENV_JSON=\"{}\"\nENV MCP_ENV_JSON=${MCP_ENV_JSON}\n\n# Lambda handler format\nCMD [\"dist/server/mcp_server.handler\"]\n\n# =============================================================================\n# DEFAULT - Use dedicated for local development, override with --target for production\n# =============================================================================\nFROM dedicated\n";
+export declare const DEFAULT_DOCKERFILE = "# =============================================================================\n# BUILDER STAGE - Common build for all targets\n# =============================================================================\nFROM public.ecr.aws/docker/library/node:22-alpine AS builder\n\nARG COMPUTE_LAYER=serverless\nARG BUILD_EXTERNAL=\"\"\nWORKDIR /app\n\n# Install pnpm (pinned \u2014 avoid pnpm@latest drift breaking esbuild postinstall approval)\nRUN corepack enable && corepack prepare pnpm@10.13.1 --activate\n\n# Copy all project files (excluding node_modules via .dockerignore)\n# This includes: package.json, tsconfig.json, skedyul.config.ts, provision.ts, env.ts\n# And directories: src/, crm/, channels/, pages/, workflows/, agents/, etc.\nCOPY . .\n\nENV CI=true\n\n# esbuild postinstall is required for tsup; pnpm 10+ blocks unapproved lifecycle scripts\nRUN printf '%s\\n' \\\n    'packages:' \\\n    '  - \".\"' \\\n    'onlyBuiltDependencies:' \\\n    '  - esbuild' \\\n    'allowBuilds:' \\\n    '  esbuild: true' \\\n    > pnpm-workspace.yaml\n\n# Install dependencies (including dev deps for build), compile, export config, smoke test, then prune\n# Note: Using --no-frozen-lockfile since lockfile may not exist\n# skedyul build reads computeLayer from skedyul.config.ts\n# skedyul config:export resolves all dynamic imports and writes .skedyul/config.json\n# We use tsx to run config:export since it needs to import TypeScript files\n# Smoke test runs before pruning since skedyul CLI is a dev dependency\nRUN pnpm install --no-frozen-lockfile && \\\n    pnpm run build && \\\n    pnpm exec tsx node_modules/skedyul/dist/cli/index.js config:export && \\\n    pnpm exec skedyul smoke-test && \\\n    pnpm prune --prod && \\\n    pnpm store prune && \\\n    rm -rf /tmp/* /var/cache/apk/* ~/.npm\n\n# =============================================================================\n# DEDICATED STAGE - For local Docker and ECS deployments (HTTP server)\n# =============================================================================\nFROM public.ecr.aws/docker/library/node:22-alpine AS dedicated\n\nWORKDIR /app\n\n# Copy built artifacts\nCOPY --from=builder /app/node_modules ./node_modules\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package.json ./package.json\nCOPY --from=builder /app/.skedyul ./.skedyul\n\n# Allow overriding the baked-in MCP env at runtime\nARG MCP_ENV_JSON=\"{}\"\nENV MCP_ENV_JSON=${MCP_ENV_JSON}\n\n# Expose the HTTP port\nEXPOSE 3000\n\n# Run as HTTP server (dedicated mode auto-detected by absence of AWS_LAMBDA_FUNCTION_NAME)\n# Support both .js (dedicated builds) and .mjs (serverless builds) extensions\nCMD [\"sh\", \"-c\", \"node dist/server/mcp_server.mjs 2>/dev/null || node dist/server/mcp_server.js\"]\n\n# =============================================================================\n# SERVERLESS STAGE - For AWS Lambda deployments\n# =============================================================================\nFROM public.ecr.aws/lambda/nodejs:22 AS serverless\n\nWORKDIR ${LAMBDA_TASK_ROOT}\n\nCOPY --from=builder /app/node_modules ./node_modules\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package.json ./package.json\nCOPY --from=builder /app/.skedyul ./.skedyul\n\n# Allow overriding the baked-in MCP env at runtime\nARG MCP_ENV_JSON=\"{}\"\nENV MCP_ENV_JSON=${MCP_ENV_JSON}\n\n# Lambda handler format\nCMD [\"dist/server/mcp_server.handler\"]\n\n# =============================================================================\n# DEFAULT - Use dedicated for local development, override with --target for production\n# =============================================================================\nFROM dedicated\n";

package/dist/esm/index.mjs

@@ -585,6 +585,8 @@ var SkillRefSchema = z4.union([
     skill: z4.string(),
     description: z4.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: z4.boolean().optional(),
     // Version selection (pick one):
     version: z4.number().optional(),
     // Pin to specific version number
@@ -842,8 +844,10 @@ var PoliciesConfigV3Schema = z6.object({
   }).optional()
 });
 var RuntimeConfigV3Schema = z6.object({
-  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
-  model: z6.string().optional()
+  /** LLM model identifier for reasoning (e.g., "google/gemini-3.1-flash-lite") */
+  model: z6.string().optional(),
+  /** LLM model for persona transformation (e.g., "openai/gpt-5-nano") */
+  personaModel: z6.string().optional()
 });
 var TimeWindowTimeStampSchema = z6.union([
   z6.number().describe("Hour of day (0-23)"),
@@ -892,10 +896,21 @@ var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
   "Fallback behavior when no time window matches"
 );
 var ResponsesBehaviorConfigSchema = z6.object({
+  /**
+   * Maximum immediate messages per agent run (acks, progress updates).
+   * @default 1
+   */
+  maxImmediate: z6.number().optional(),
+  /**
+   * Maximum scheduled messages per agent run (follow-ups via sendAt).
+   * @default 2
+   */
+  maxScheduled: z6.number().optional(),
   /**
    * Maximum intermediate messages per agent run.
    * Intermediate = progress updates, acknowledgments before task completion.
    * The final message slot is always reserved separately.
+   * @deprecated Use maxImmediate instead
    * @default 2
    */
   maxIntermediate: z6.number().optional(),
@@ -1018,7 +1033,7 @@ var AgentYAMLV3Schema = z6.object({
   memory: MemoryConfigV3Schema.optional(),
   // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration (only model is used)
+  // Runtime - Execution configuration (model + personaModel)
   runtime: RuntimeConfigV3Schema.optional(),
   // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),
@@ -2938,6 +2953,23 @@ var cron = {
     return { subscriptions: data };
   }
 };
+var event = {
+  async create(name, payload, options) {
+    const { trigger, correlationId, app, context: extraContext } = options ?? {};
+    const context = {
+      ...extraContext ?? {},
+      ...trigger ? { trigger } : {},
+      ...correlationId ? { correlationId } : {}
+    };
+    const { data } = await callCore("event.create", {
+      name,
+      payload,
+      ...Object.keys(context).length > 0 ? { context } : {},
+      ...app ? { app } : {}
+    });
+    return data;
+  }
+};
 var resource = {
   /**
    * Link a SHARED app resource (model) to a user's resource.
@@ -3547,22 +3579,22 @@ function printStartupLog(config, tools, port) {
 }
 
 // src/server/route-handlers/adapters.ts
-function fromLambdaEvent(event) {
-  const path5 = event.path || event.rawPath || "/";
-  const method = event.httpMethod || event.requestContext?.http?.method || "POST";
-  const forwardedProto = event.headers?.["x-forwarded-proto"] ?? event.headers?.["X-Forwarded-Proto"];
+function fromLambdaEvent(event2) {
+  const path5 = event2.path || event2.rawPath || "/";
+  const method = event2.httpMethod || event2.requestContext?.http?.method || "POST";
+  const forwardedProto = event2.headers?.["x-forwarded-proto"] ?? event2.headers?.["X-Forwarded-Proto"];
   const protocol = forwardedProto ?? "https";
-  const host = event.headers?.host ?? event.headers?.Host ?? "localhost";
-  const queryString = event.queryStringParameters ? "?" + new URLSearchParams(
-    event.queryStringParameters
+  const host = event2.headers?.host ?? event2.headers?.Host ?? "localhost";
+  const queryString = event2.queryStringParameters ? "?" + new URLSearchParams(
+    event2.queryStringParameters
   ).toString() : "";
   const url = `${protocol}://${host}${path5}${queryString}`;
   return {
     path: path5,
     method,
-    headers: event.headers,
-    query: event.queryStringParameters ?? {},
-    body: event.body,
+    headers: event2.headers,
+    query: event2.queryStringParameters ?? {},
+    body: event2.body,
     url
   };
 }
@@ -4925,12 +4957,12 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer) {
     defaultHeaders
   };
   return {
-    async handler(event) {
+    async handler(event2) {
       if (!hasLoggedStartup) {
         printStartupLog(config, tools);
         hasLoggedStartup = true;
       }
-      const req = fromLambdaEvent(event);
+      const req = fromLambdaEvent(event2);
       const response = await routeRequest(req, ctx);
       return toLambdaResponse(response, defaultHeaders);
     },
@@ -5098,14 +5130,26 @@ ARG COMPUTE_LAYER=serverless
 ARG BUILD_EXTERNAL=""
 WORKDIR /app
 
-# Install pnpm
-RUN corepack enable && corepack prepare pnpm@latest --activate
+# Install pnpm (pinned \u2014 avoid pnpm@latest drift breaking esbuild postinstall approval)
+RUN corepack enable && corepack prepare pnpm@10.13.1 --activate
 
 # Copy all project files (excluding node_modules via .dockerignore)
 # This includes: package.json, tsconfig.json, skedyul.config.ts, provision.ts, env.ts
 # And directories: src/, crm/, channels/, pages/, workflows/, agents/, etc.
 COPY . .
 
+ENV CI=true
+
+# esbuild postinstall is required for tsup; pnpm 10+ blocks unapproved lifecycle scripts
+RUN printf '%s\\n' \\
+    'packages:' \\
+    '  - "."' \\
+    'onlyBuiltDependencies:' \\
+    '  - esbuild' \\
+    'allowBuilds:' \\
+    '  esbuild: true' \\
+    > pnpm-workspace.yaml
+
 # Install dependencies (including dev deps for build), compile, export config, smoke test, then prune
 # Note: Using --no-frozen-lockfile since lockfile may not exist
 # skedyul build reads computeLayer from skedyul.config.ts
@@ -6914,6 +6958,7 @@ export {
   defineWorkflowYAML,
   evaluateCondition,
   evaluateTemplate,
+  event,
   file,
   formatContextForPrompt,
   formatSkillInstructions,

package/dist/index.d.ts

@@ -6,8 +6,8 @@ export { DEFAULT_DOCKERFILE } from './dockerfile';
 export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidConfigurationError, ConnectionError, AppAuthInvalidError, } from './errors';
 export type { InstallErrorCode } from './errors';
 export { z };
-export { workplace, communicationChannel, instance, token, file, webhook, cron, resource, ai, report, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
-export type { InstanceClient, InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, } from './core/client';
+export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, report, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
+export type { InstanceClient, InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, } from './core/client';
 export { createContextLogger } from './server/logger';
 export type { ContextLogger } from './server/logger';
 declare const _default: {

package/dist/index.js

@@ -273,6 +273,7 @@ __export(index_exports, {
   defineWorkflowYAML: () => defineWorkflowYAML,
   evaluateCondition: () => evaluateCondition,
   evaluateTemplate: () => evaluateTemplate,
+  event: () => event,
   file: () => file,
   formatContextForPrompt: () => formatContextForPrompt,
   formatSkillInstructions: () => formatSkillInstructions,
@@ -895,6 +896,8 @@ var SkillRefSchema = import_v44.z.union([
     skill: import_v44.z.string(),
     description: import_v44.z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: import_v44.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v44.z.number().optional(),
     // Pin to specific version number
@@ -1152,8 +1155,10 @@ var PoliciesConfigV3Schema = import_v46.z.object({
   }).optional()
 });
 var RuntimeConfigV3Schema = import_v46.z.object({
-  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
-  model: import_v46.z.string().optional()
+  /** LLM model identifier for reasoning (e.g., "google/gemini-3.1-flash-lite") */
+  model: import_v46.z.string().optional(),
+  /** LLM model for persona transformation (e.g., "openai/gpt-5-nano") */
+  personaModel: import_v46.z.string().optional()
 });
 var TimeWindowTimeStampSchema = import_v46.z.union([
   import_v46.z.number().describe("Hour of day (0-23)"),
@@ -1202,10 +1207,21 @@ var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
   "Fallback behavior when no time window matches"
 );
 var ResponsesBehaviorConfigSchema = import_v46.z.object({
+  /**
+   * Maximum immediate messages per agent run (acks, progress updates).
+   * @default 1
+   */
+  maxImmediate: import_v46.z.number().optional(),
+  /**
+   * Maximum scheduled messages per agent run (follow-ups via sendAt).
+   * @default 2
+   */
+  maxScheduled: import_v46.z.number().optional(),
   /**
    * Maximum intermediate messages per agent run.
    * Intermediate = progress updates, acknowledgments before task completion.
    * The final message slot is always reserved separately.
+   * @deprecated Use maxImmediate instead
    * @default 2
    */
   maxIntermediate: import_v46.z.number().optional(),
@@ -1328,7 +1344,7 @@ var AgentYAMLV3Schema = import_v46.z.object({
   memory: MemoryConfigV3Schema.optional(),
   // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration (only model is used)
+  // Runtime - Execution configuration (model + personaModel)
   runtime: RuntimeConfigV3Schema.optional(),
   // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),
@@ -3248,6 +3264,23 @@ var cron = {
     return { subscriptions: data };
   }
 };
+var event = {
+  async create(name, payload, options) {
+    const { trigger, correlationId, app, context: extraContext } = options ?? {};
+    const context = {
+      ...extraContext ?? {},
+      ...trigger ? { trigger } : {},
+      ...correlationId ? { correlationId } : {}
+    };
+    const { data } = await callCore("event.create", {
+      name,
+      payload,
+      ...Object.keys(context).length > 0 ? { context } : {},
+      ...app ? { app } : {}
+    });
+    return data;
+  }
+};
 var resource = {
   /**
    * Link a SHARED app resource (model) to a user's resource.
@@ -3857,22 +3890,22 @@ function printStartupLog(config, tools, port) {
 }
 
 // src/server/route-handlers/adapters.ts
-function fromLambdaEvent(event) {
-  const path5 = event.path || event.rawPath || "/";
-  const method = event.httpMethod || event.requestContext?.http?.method || "POST";
-  const forwardedProto = event.headers?.["x-forwarded-proto"] ?? event.headers?.["X-Forwarded-Proto"];
+function fromLambdaEvent(event2) {
+  const path5 = event2.path || event2.rawPath || "/";
+  const method = event2.httpMethod || event2.requestContext?.http?.method || "POST";
+  const forwardedProto = event2.headers?.["x-forwarded-proto"] ?? event2.headers?.["X-Forwarded-Proto"];
   const protocol = forwardedProto ?? "https";
-  const host = event.headers?.host ?? event.headers?.Host ?? "localhost";
-  const queryString = event.queryStringParameters ? "?" + new URLSearchParams(
-    event.queryStringParameters
+  const host = event2.headers?.host ?? event2.headers?.Host ?? "localhost";
+  const queryString = event2.queryStringParameters ? "?" + new URLSearchParams(
+    event2.queryStringParameters
   ).toString() : "";
   const url = `${protocol}://${host}${path5}${queryString}`;
   return {
     path: path5,
     method,
-    headers: event.headers,
-    query: event.queryStringParameters ?? {},
-    body: event.body,
+    headers: event2.headers,
+    query: event2.queryStringParameters ?? {},
+    body: event2.body,
     url
   };
 }
@@ -5235,12 +5268,12 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer) {
     defaultHeaders
   };
   return {
-    async handler(event) {
+    async handler(event2) {
       if (!hasLoggedStartup) {
         printStartupLog(config, tools);
         hasLoggedStartup = true;
       }
-      const req = fromLambdaEvent(event);
+      const req = fromLambdaEvent(event2);
       const response = await routeRequest(req, ctx);
       return toLambdaResponse(response, defaultHeaders);
     },
@@ -5408,14 +5441,26 @@ ARG COMPUTE_LAYER=serverless
 ARG BUILD_EXTERNAL=""
 WORKDIR /app
 
-# Install pnpm
-RUN corepack enable && corepack prepare pnpm@latest --activate
+# Install pnpm (pinned \u2014 avoid pnpm@latest drift breaking esbuild postinstall approval)
+RUN corepack enable && corepack prepare pnpm@10.13.1 --activate
 
 # Copy all project files (excluding node_modules via .dockerignore)
 # This includes: package.json, tsconfig.json, skedyul.config.ts, provision.ts, env.ts
 # And directories: src/, crm/, channels/, pages/, workflows/, agents/, etc.
 COPY . .
 
+ENV CI=true
+
+# esbuild postinstall is required for tsup; pnpm 10+ blocks unapproved lifecycle scripts
+RUN printf '%s\\n' \\
+    'packages:' \\
+    '  - "."' \\
+    'onlyBuiltDependencies:' \\
+    '  - esbuild' \\
+    'allowBuilds:' \\
+    '  esbuild: true' \\
+    > pnpm-workspace.yaml
+
 # Install dependencies (including dev deps for build), compile, export config, smoke test, then prune
 # Note: Using --no-frozen-lockfile since lockfile may not exist
 # skedyul build reads computeLayer from skedyul.config.ts
@@ -7224,6 +7269,7 @@ var index_default = { z: import_v413.z };
   defineWorkflowYAML,
   evaluateCondition,
   evaluateTemplate,
+  event,
   file,
   formatContextForPrompt,
   formatSkillInstructions,

package/dist/schemas/agent-schema-v3.d.ts

@@ -196,10 +196,12 @@ export declare const PoliciesConfigV3Schema: z.ZodObject<{
 export type PoliciesConfigV3 = z.infer<typeof PoliciesConfigV3Schema>;
 /**
  * Runtime configuration
- * Only `model` is actively used for LLM model selection.
+ * `model` selects the main reasoning LLM; `personaModel` selects the model
+ * used to apply persona voice/style to outbound messages.
  */
 export declare const RuntimeConfigV3Schema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
+    personaModel: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type RuntimeConfigV3 = z.infer<typeof RuntimeConfigV3Schema>;
 /**
@@ -368,6 +370,8 @@ export type TimeWindowDefault = z.infer<typeof TimeWindowDefaultSchema>;
  * - Scheduled messages: Future follow-ups
  */
 export declare const ResponsesBehaviorConfigSchema: z.ZodObject<{
+    maxImmediate: z.ZodOptional<z.ZodNumber>;
+    maxScheduled: z.ZodOptional<z.ZodNumber>;
     maxIntermediate: z.ZodOptional<z.ZodNumber>;
     requireFinal: z.ZodOptional<z.ZodBoolean>;
     allowSchedule: z.ZodOptional<z.ZodBoolean>;
@@ -430,6 +434,8 @@ export type SchedulingBehaviorConfig = z.infer<typeof SchedulingBehaviorConfigSc
  */
 export declare const BehaviorConfigV3Schema: z.ZodObject<{
     responses: z.ZodOptional<z.ZodObject<{
+        maxImmediate: z.ZodOptional<z.ZodNumber>;
+        maxScheduled: z.ZodOptional<z.ZodNumber>;
         maxIntermediate: z.ZodOptional<z.ZodNumber>;
         requireFinal: z.ZodOptional<z.ZodBoolean>;
         allowSchedule: z.ZodOptional<z.ZodBoolean>;
@@ -505,6 +511,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
     skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         skill: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
         version: z.ZodOptional<z.ZodNumber>;
         versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             version: z.ZodNumber;
@@ -628,6 +635,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
     }, z.core.$strip>>;
     runtime: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
+        personaModel: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     prompts: z.ZodOptional<z.ZodObject<{
         system: z.ZodOptional<z.ZodString>;
@@ -640,6 +648,8 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
     }, z.core.$strip>>;
     behavior: z.ZodOptional<z.ZodObject<{
         responses: z.ZodOptional<z.ZodObject<{
+            maxImmediate: z.ZodOptional<z.ZodNumber>;
+            maxScheduled: z.ZodOptional<z.ZodNumber>;
             maxIntermediate: z.ZodOptional<z.ZodNumber>;
             requireFinal: z.ZodOptional<z.ZodBoolean>;
             allowSchedule: z.ZodOptional<z.ZodBoolean>;

package/dist/schemas/agent-schema-v3.js

@@ -269,6 +269,8 @@ var SkillRefSchema = import_v42.z.union([
     skill: import_v42.z.string(),
     description: import_v42.z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: import_v42.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v42.z.number().optional(),
     // Pin to specific version number
@@ -473,8 +475,10 @@ var PoliciesConfigV3Schema = import_v44.z.object({
   }).optional()
 });
 var RuntimeConfigV3Schema = import_v44.z.object({
-  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
-  model: import_v44.z.string().optional()
+  /** LLM model identifier for reasoning (e.g., "google/gemini-3.1-flash-lite") */
+  model: import_v44.z.string().optional(),
+  /** LLM model for persona transformation (e.g., "openai/gpt-5-nano") */
+  personaModel: import_v44.z.string().optional()
 });
 var TimeWindowTimeStampSchema = import_v44.z.union([
   import_v44.z.number().describe("Hour of day (0-23)"),
@@ -523,10 +527,21 @@ var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
   "Fallback behavior when no time window matches"
 );
 var ResponsesBehaviorConfigSchema = import_v44.z.object({
+  /**
+   * Maximum immediate messages per agent run (acks, progress updates).
+   * @default 1
+   */
+  maxImmediate: import_v44.z.number().optional(),
+  /**
+   * Maximum scheduled messages per agent run (follow-ups via sendAt).
+   * @default 2
+   */
+  maxScheduled: import_v44.z.number().optional(),
   /**
    * Maximum intermediate messages per agent run.
    * Intermediate = progress updates, acknowledgments before task completion.
    * The final message slot is always reserved separately.
+   * @deprecated Use maxImmediate instead
    * @default 2
    */
   maxIntermediate: import_v44.z.number().optional(),
@@ -649,7 +664,7 @@ var AgentYAMLV3Schema = import_v44.z.object({
   memory: MemoryConfigV3Schema.optional(),
   // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration (only model is used)
+  // Runtime - Execution configuration (model + personaModel)
   runtime: RuntimeConfigV3Schema.optional(),
   // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),

package/dist/schemas/agent-schema-v3.mjs

@@ -216,6 +216,8 @@ var SkillRefSchema = z2.union([
     skill: z2.string(),
     description: z2.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: z2.boolean().optional(),
     // Version selection (pick one):
     version: z2.number().optional(),
     // Pin to specific version number
@@ -420,8 +422,10 @@ var PoliciesConfigV3Schema = z4.object({
   }).optional()
 });
 var RuntimeConfigV3Schema = z4.object({
-  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
-  model: z4.string().optional()
+  /** LLM model identifier for reasoning (e.g., "google/gemini-3.1-flash-lite") */
+  model: z4.string().optional(),
+  /** LLM model for persona transformation (e.g., "openai/gpt-5-nano") */
+  personaModel: z4.string().optional()
 });
 var TimeWindowTimeStampSchema = z4.union([
   z4.number().describe("Hour of day (0-23)"),
@@ -470,10 +474,21 @@ var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
   "Fallback behavior when no time window matches"
 );
 var ResponsesBehaviorConfigSchema = z4.object({
+  /**
+   * Maximum immediate messages per agent run (acks, progress updates).
+   * @default 1
+   */
+  maxImmediate: z4.number().optional(),
+  /**
+   * Maximum scheduled messages per agent run (follow-ups via sendAt).
+   * @default 2
+   */
+  maxScheduled: z4.number().optional(),
   /**
    * Maximum intermediate messages per agent run.
    * Intermediate = progress updates, acknowledgments before task completion.
    * The final message slot is always reserved separately.
+   * @deprecated Use maxImmediate instead
    * @default 2
    */
   maxIntermediate: z4.number().optional(),
@@ -596,7 +611,7 @@ var AgentYAMLV3Schema = z4.object({
   memory: MemoryConfigV3Schema.optional(),
   // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration (only model is used)
+  // Runtime - Execution configuration (model + personaModel)
   runtime: RuntimeConfigV3Schema.optional(),
   // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),

package/dist/skills/types.d.ts

@@ -230,6 +230,7 @@ export type SkillVersionWeight = z.infer<typeof SkillVersionWeightSchema>;
 export declare const SkillRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     skill: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    alwaysLoad: z.ZodOptional<z.ZodBoolean>;
     version: z.ZodOptional<z.ZodNumber>;
     versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         version: z.ZodNumber;

package/dist/skills/types.js

@@ -129,6 +129,8 @@ var SkillRefSchema = import_v4.z.union([
     skill: import_v4.z.string(),
     description: import_v4.z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: import_v4.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v4.z.number().optional(),
     // Pin to specific version number

package/dist/skills/types.mjs

@@ -83,6 +83,8 @@ var SkillRefSchema = z.union([
     skill: z.string(),
     description: z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: z.boolean().optional(),
     // Version selection (pick one):
     version: z.number().optional(),
     // Pin to specific version number

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.2.48",
+  "version": "1.2.51",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -64,7 +64,7 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && tsup",
     "db:generate": "echo 'No database generation needed for this package'",
     "dev": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
-    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js"
+    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/agent-schema-v3.test.js"
   },
   "keywords": [
     "mcp",