skedyul 1.7.29 → 1.7.30

package/dist/.build-stamp

@@ -1 +1 @@
-1788412919726
+1789421195637

package/dist/cli/api/index.d.ts

@@ -6,6 +6,9 @@ export { listModels, pullSchema, diffSchema, pushSchema, approveMigration, } fro
 export { workflows } from './workflows';
 export type { WorkflowRecord, WorkflowVersion, DeployWorkflowResult, ValidateWorkflowResult, RunWorkflowResult, WorkflowRunStatus, WorkflowSchema, PublishWorkflowResult, PullWorkflowResult, DeployWorkflowOptions, } from './workflows';
 export { listWorkflows, getWorkflow, listWorkflowVersions, validateWorkflow, validateWorkflowContent, deployWorkflow, publishWorkflow, pullWorkflow, getWorkflowSchema, runWorkflow, getWorkflowRun, } from './workflows';
+export { playground } from './playground';
+export type { PlaygroundSendResult, PlaygroundInspectResult, PlaygroundCreateResult, PlaygroundTurnInput, PlaygroundScheduledMessage, PlaygroundSchedulingCheck, } from './playground';
+export { sendPlaygroundTurn, inspectPlaygroundSession, createPlaygroundSession, } from './playground';
 export { apps } from './apps';
 export type { LinkAppInput, LinkAppResult, InvokeToolInput, InvokeToolResult, SyncResourcesResult, PlatformTool, GetDeploymentInput, GetDeploymentResult, DeploymentLogEntry, } from './apps';
 export { linkApp, registerEndpoint, unregisterEndpoint, heartbeat, installApp, uninstallApp, getInstallation, syncResources, listTools, invokeTool, getDeployment, } from './apps';

package/dist/cli/api/index.js

@@ -32,6 +32,7 @@ var api_exports = {};
 __export(api_exports, {
   approveMigration: () => approveMigration,
   apps: () => apps,
+  createPlaygroundSession: () => createPlaygroundSession,
   crm: () => crm,
   deployWorkflow: () => deployWorkflow,
   diffSchema: () => diffSchema,
@@ -42,6 +43,7 @@ __export(api_exports, {
   getWorkflowSchema: () => getWorkflowSchema,
   getWorkplaceToken: () => getWorkplaceToken,
   heartbeat: () => heartbeat,
+  inspectPlaygroundSession: () => inspectPlaygroundSession,
   installApp: () => installApp,
   invokeTool: () => invokeTool,
   linkApp: () => linkApp,
@@ -50,12 +52,14 @@ __export(api_exports, {
   listWorkflowVersions: () => listWorkflowVersions,
   listWorkflows: () => listWorkflows,
   listWorkplaces: () => listWorkplaces,
+  playground: () => playground,
   publishWorkflow: () => publishWorkflow,
   pullSchema: () => pullSchema,
   pullWorkflow: () => pullWorkflow,
   pushSchema: () => pushSchema,
   registerEndpoint: () => registerEndpoint,
   runWorkflow: () => runWorkflow,
+  sendPlaygroundTurn: () => sendPlaygroundTurn,
   syncResources: () => syncResources,
   uninstallApp: () => uninstallApp,
   unregisterEndpoint: () => unregisterEndpoint,
@@ -686,6 +690,47 @@ var workflows = {
   getRun: getWorkflowRun
 };
 
+// src/cli/api/playground.ts
+async function sendPlaygroundTurn(ctx, workplace, input) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", {
+    workplaceId: workplaceToken.workplaceId,
+    action: "send",
+    handle: input.handle,
+    agentId: input.agentId,
+    threadId: input.threadId,
+    content: input.message,
+    currentTime: input.currentTime,
+    contactId: input.contactId,
+    appInstallationId: input.appInstallationId,
+    title: input.title,
+    sandbox: input.sandbox
+  });
+}
+async function inspectPlaygroundSession(ctx, workplace, threadId) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", void 0, {
+    method: "GET",
+    query: {
+      workplaceId: workplaceToken.workplaceId,
+      threadId
+    }
+  });
+}
+async function createPlaygroundSession(ctx, workplace, input) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", {
+    workplaceId: workplaceToken.workplaceId,
+    action: "create",
+    ...input
+  });
+}
+var playground = {
+  send: sendPlaygroundTurn,
+  get: inspectPlaygroundSession,
+  create: createPlaygroundSession
+};
+
 // src/cli/api/apps.ts
 async function linkApp(ctx, input) {
   return callCliApi(cliApi(ctx), "/link", {
@@ -782,6 +827,7 @@ var apps = {
 0 && (module.exports = {
   approveMigration,
   apps,
+  createPlaygroundSession,
   crm,
   deployWorkflow,
   diffSchema,
@@ -792,6 +838,7 @@ var apps = {
   getWorkflowSchema,
   getWorkplaceToken,
   heartbeat,
+  inspectPlaygroundSession,
   installApp,
   invokeTool,
   linkApp,
@@ -800,12 +847,14 @@ var apps = {
   listWorkflowVersions,
   listWorkflows,
   listWorkplaces,
+  playground,
   publishWorkflow,
   pullSchema,
   pullWorkflow,
   pushSchema,
   registerEndpoint,
   runWorkflow,
+  sendPlaygroundTurn,
   syncResources,
   uninstallApp,
   unregisterEndpoint,

package/dist/cli/api/playground.d.ts

@@ -0,0 +1,92 @@
+import { type CliContext } from './context';
+export interface PlaygroundScheduledMessage {
+    id: string;
+    status: string;
+    scheduledAt: string;
+    content: string;
+    requiresApproval?: boolean;
+    cancelOnActivity?: boolean;
+}
+export interface PlaygroundSchedulingCheck {
+    applicable: boolean;
+    passed: boolean;
+    reason: string;
+    namedDelay: boolean;
+    verbalFollowUp: boolean;
+    scheduledSend: boolean;
+}
+export interface PlaygroundSendResult {
+    success: boolean;
+    threadId: string;
+    userMessageId?: string;
+    agentMessageId?: string;
+    agentResponse: string;
+    agentRunId?: string;
+    status: string;
+    currentTime?: string;
+    scheduledMessageIds?: string[];
+    scheduledMessages: PlaygroundScheduledMessage[];
+    schedulingCheck?: PlaygroundSchedulingCheck;
+    session?: {
+        threadId: string;
+        agentId: string;
+        agentHandle: string | null;
+        agentName: string;
+    } | null;
+    error?: string;
+}
+export interface PlaygroundInspectResult {
+    success: boolean;
+    threadId: string;
+    title: string | null;
+    agentId?: string;
+    agentHandle?: string | null;
+    agentName?: string;
+    messages: Array<{
+        id: string;
+        role: 'user' | 'assistant';
+        content: string;
+        createdAt: string;
+    }>;
+    scheduledMessages: PlaygroundScheduledMessage[];
+    sendCalls: Array<{
+        toolName: string;
+        content: string | null;
+        sendAt: unknown;
+    }>;
+    schedulingCheck?: PlaygroundSchedulingCheck;
+    error?: string;
+}
+export interface PlaygroundCreateResult {
+    success: boolean;
+    threadId: string;
+    agentId: string;
+    agentHandle: string | null;
+    agentName: string;
+    error?: string;
+}
+export interface PlaygroundTurnInput {
+    handle?: string;
+    agentId?: string;
+    threadId?: string;
+    message: string;
+    currentTime?: string;
+    contactId?: string;
+    appInstallationId?: string;
+    title?: string;
+    sandbox?: boolean;
+}
+export declare function sendPlaygroundTurn(ctx: CliContext, workplace: string, input: PlaygroundTurnInput): Promise<PlaygroundSendResult>;
+export declare function inspectPlaygroundSession(ctx: CliContext, workplace: string, threadId: string): Promise<PlaygroundInspectResult>;
+export declare function createPlaygroundSession(ctx: CliContext, workplace: string, input: {
+    handle?: string;
+    agentId?: string;
+    title?: string;
+    contactId?: string;
+    appInstallationId?: string;
+}): Promise<PlaygroundCreateResult>;
+export declare const playground: {
+    send: typeof sendPlaygroundTurn;
+    get: typeof inspectPlaygroundSession;
+    create: typeof createPlaygroundSession;
+};

package/dist/cli/index.js

@@ -2811,6 +2811,34 @@ async function getWorkflowRun(ctx, workplace, workflowRunId) {
   });
 }
 
+// src/cli/api/playground.ts
+async function sendPlaygroundTurn(ctx, workplace, input) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", {
+    workplaceId: workplaceToken.workplaceId,
+    action: "send",
+    handle: input.handle,
+    agentId: input.agentId,
+    threadId: input.threadId,
+    content: input.message,
+    currentTime: input.currentTime,
+    contactId: input.contactId,
+    appInstallationId: input.appInstallationId,
+    title: input.title,
+    sandbox: input.sandbox
+  });
+}
+async function inspectPlaygroundSession(ctx, workplace, threadId) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", void 0, {
+    method: "GET",
+    query: {
+      workplaceId: workplaceToken.workplaceId,
+      threadId
+    }
+  });
+}
+
 // src/cli/api/apps.ts
 async function linkApp(ctx, input) {
   return callCliApi(cliApi(ctx), "/link", {
@@ -10552,6 +10580,40 @@ var CRMModelFieldRequirementsSchema = import_v47.z.object({
 var CRMContextSchema = import_v47.z.object({
   models: import_v47.z.record(import_v47.z.string(), CRMModelFieldRequirementsSchema)
 });
+var EntityOperationSchema = import_v47.z.enum(["get", "list", "update", "create", "delete"]);
+var EntityPoliciesSchema = import_v47.z.record(
+  import_v47.z.string(),
+  // entity handle (e.g., "member", "booking")
+  import_v47.z.array(EntityOperationSchema)
+  // allowed operations
+);
+var EvaluatorPreconditionsSchema = import_v47.z.object({
+  toolSucceeded: import_v47.z.boolean().optional(),
+  anyWrittenFields: import_v47.z.array(import_v47.z.string()).optional(),
+  noneOfWrittenFields: import_v47.z.array(import_v47.z.string()).optional(),
+  crm: import_v47.z.array(
+    import_v47.z.object({
+      field: import_v47.z.string(),
+      op: import_v47.z.enum(["eq", "in", "empty", "notEmpty"]),
+      value: import_v47.z.unknown().optional()
+    })
+  ).optional(),
+  skillsLoaded: import_v47.z.array(import_v47.z.string()).optional(),
+  skillsNotLoaded: import_v47.z.array(import_v47.z.string()).optional()
+});
+var SkillEvaluatorSchema = import_v47.z.object({
+  name: import_v47.z.string(),
+  description: import_v47.z.string().optional(),
+  target: import_v47.z.enum(["message", "tool", "entity"]),
+  selector: import_v47.z.string().optional(),
+  criteria: import_v47.z.string(),
+  passThreshold: import_v47.z.number().optional(),
+  checks: import_v47.z.object({
+    requiredArgs: import_v47.z.array(import_v47.z.string()).optional(),
+    forbiddenArgValues: import_v47.z.record(import_v47.z.string(), import_v47.z.array(import_v47.z.unknown())).optional()
+  }).optional(),
+  preconditions: EvaluatorPreconditionsSchema.optional()
+});
 var SkillYAMLSchema = import_v47.z.object({
   // Schema version
   $schema: import_v47.z.string().optional(),
@@ -10562,10 +10624,17 @@ var SkillYAMLSchema = import_v47.z.object({
   description: import_v47.z.string().optional(),
   // Instructions injected into agent system prompt
   instructions: import_v47.z.string(),
+  // Entity policies - declares which entity operations this skill needs
+  // At runtime, these are resolved to CRM tools via AppCrmMap
+  entityPolicies: EntityPoliciesSchema.optional(),
   // Tool configuration - supports both v1 and v2 formats
+  // Use for non-entity tools (MCP tools, system tools)
   tools: SkillToolsSchema.optional(),
   // CRM context - specifies which models/fields to include in schema
   crmContext: CRMContextSchema.optional(),
+  ownedFields: import_v47.z.array(import_v47.z.string()).optional(),
+  // Quality evaluators owned by this skill
+  evaluators: import_v47.z.array(SkillEvaluatorSchema).optional(),
   // Few-shot examples
   examples: import_v47.z.array(SkillExampleSchema).optional()
 });
@@ -10576,8 +10645,11 @@ var SkillYAMLV2Schema = import_v47.z.object({
   version: import_v47.z.string().optional(),
   description: import_v47.z.string().optional(),
   instructions: import_v47.z.string(),
+  entityPolicies: EntityPoliciesSchema.optional(),
   tools: import_v47.z.array(SkillToolDefinitionSchema).optional(),
   crmContext: CRMContextSchema.optional(),
+  ownedFields: import_v47.z.array(import_v47.z.string()).optional(),
+  evaluators: import_v47.z.array(SkillEvaluatorSchema).optional(),
   examples: import_v47.z.array(SkillExampleSchema).optional()
 });
 var SkillVersionWeightSchema = import_v47.z.object({
@@ -10591,7 +10663,10 @@ var SkillRefSchema = import_v47.z.union([
     skill: import_v47.z.string(),
     description: import_v47.z.string().optional(),
     // For AI SDK Agent Skills discovery
-    /** Auto-inject this skill's instructions and tools on every agent turn */
+    /**
+     * @deprecated Ignored. The agent must call system:skill:load each turn.
+     * Kept so existing agent YAML still validates.
+     */
     alwaysLoad: import_v47.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v47.z.number().optional(),
@@ -10630,6 +10705,7 @@ var LoadedSkillSchema = import_v47.z.object({
   name: import_v47.z.string(),
   instructions: import_v47.z.string().optional(),
   description: import_v47.z.string().optional(),
+  entityPolicies: EntityPoliciesSchema.optional(),
   tools: import_v47.z.array(SkillToolDefinitionSchema).optional(),
   examples: import_v47.z.array(SkillExampleSchema).optional()
 });
@@ -10884,6 +10960,13 @@ var ResponsesBehaviorConfigSchema = import_v49.z.object({
    * @default false
    */
   allowSchedule: import_v49.z.boolean().optional(),
+  /**
+   * Whether the agent may skip sending when no reply is warranted.
+   * Platform injects silence rules and exposes system:message:skip.
+   * An explicit skip satisfies requireFinal. Off by default.
+   * @default false
+   */
+  allowSilent: import_v49.z.boolean().optional(),
   /**
    * Message splitting configuration.
    * Controls whether and how the agent splits responses into multiple messages.
@@ -11031,6 +11114,7 @@ Commands:
   versions          List versions of an agent
   ab                Set A/B testing traffic weights
   rollback          Rollback to a previous version
+  test              Run a playground turn (same path as the web playground)
 
 List Options:
   --workplace, -w   Workplace subdomain (required)
@@ -11070,6 +11154,16 @@ Rollback Options:
   --to              Version number to rollback to
   --json            Output as JSON
 
+Test Options:
+  --workplace, -w   Workplace subdomain (required)
+  --agent, -a       Agent handle (required to start a session)
+  --thread, -t      Continue an existing playground thread
+  --message, -m     User turn to send (omit to inspect the thread)
+  --now             ISO clock the agent should treat as now
+  --contact         Contact ID to impersonate
+  --installation    App installation ID (APP agents)
+  --json            Output as JSON
+
 Examples:
   # List all agents in a workplace
   skedyul agents list --workplace gym-demo
@@ -11094,6 +11188,15 @@ Examples:
 
   # Rollback to previous version
   skedyul agents rollback sales-agent --workplace gym-demo --to 1
+
+  # Playground turn (TESTING thread + runThreadAgentWorkflow)
+  skedyul agents test --agent sales-agent --workplace gym-demo --message "Hey"
+
+  # Continue the thread and pin studio now
+  skedyul agents test --thread th_xxx --workplace gym-demo --message "I'm sick" --now 2026-09-11T22:00:00+10:00
+
+  # Inspect scheduled messages
+  skedyul agents test --thread th_xxx --workplace gym-demo
 `);
 }
 async function getWorkplaceToken4(workplaceSubdomain, serverUrl, cliToken) {
@@ -11746,6 +11849,132 @@ async function handleRollback(args2) {
     process.exit(1);
   }
 }
+async function handleTest(args2) {
+  const { flags } = parseArgs(args2);
+  const workplace = flags.workplace || flags.w;
+  const handle = flags.agent || flags.a;
+  const threadId = flags.thread || flags.t;
+  const message = flags.message || flags.m;
+  const currentTime = flags.now;
+  const contactId = flags.contact;
+  const appInstallationId = flags.installation;
+  const jsonOutput = Boolean(flags.json);
+  if (!workplace) {
+    console.error("Error: --workplace (-w) is required");
+    console.error(
+      'Usage: skedyul agents test --workplace gym-demo --agent sales-agent --message "Hey"'
+    );
+    process.exit(1);
+  }
+  if (!threadId && !handle) {
+    console.error("Error: --agent (-a) is required when starting a session");
+    console.error(
+      'Usage: skedyul agents test --workplace gym-demo --agent sales-agent --message "Hey"'
+    );
+    process.exit(1);
+  }
+  if (!message && !threadId) {
+    console.error("Error: --message (-m) is required when starting a session");
+    process.exit(1);
+  }
+  const { token, serverUrl } = ensureAuth3();
+  const ctx = { token, serverUrl };
+  try {
+    if (!message) {
+      const result2 = await inspectPlaygroundSession(ctx, workplace, threadId);
+      if (!result2.success) {
+        throw new Error(result2.error || "Failed to inspect playground session");
+      }
+      if (jsonOutput) {
+        console.log(JSON.stringify(result2, null, 2));
+        return;
+      }
+      console.log("");
+      console.log(`Playground ${result2.threadId}`);
+      if (result2.agentHandle || result2.agentName) {
+        console.log(`Agent     ${result2.agentHandle ?? result2.agentName}`);
+      }
+      console.log("");
+      for (const row of result2.messages) {
+        const who = row.role === "user" ? "USER " : "AGENT";
+        console.log(`${who}  ${row.content}`);
+      }
+      if (result2.scheduledMessages.length === 0) {
+        console.log("");
+        console.log("SCHED  (none)");
+      } else {
+        console.log("");
+        for (const row of result2.scheduledMessages) {
+          console.log(`SCHED  ${row.status} ${row.scheduledAt} ${row.content}`);
+        }
+      }
+      for (const row of result2.sendCalls) {
+        if (row.sendAt != null) {
+          console.log(`SENDAT ${String(row.sendAt)} ${row.content ?? ""}`);
+        }
+      }
+      if (result2.schedulingCheck) {
+        console.log(
+          `CHECK  ${result2.schedulingCheck.passed ? "pass" : "fail"} ${result2.schedulingCheck.reason}`
+        );
+      }
+      console.log("");
+      return;
+    }
+    const result = await sendPlaygroundTurn(ctx, workplace, {
+      handle,
+      threadId,
+      message,
+      currentTime,
+      contactId,
+      appInstallationId
+    });
+    if (!result.success) {
+      throw new Error(result.error || "Failed to run playground turn");
+    }
+    if (jsonOutput) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log("");
+    console.log(`THREAD ${result.threadId}`);
+    console.log(`STATUS ${result.status}`);
+    if (result.currentTime) {
+      console.log(`NOW    ${result.currentTime}`);
+    }
+    if (result.agentResponse) {
+      console.log(`AGENT  ${result.agentResponse}`);
+    } else {
+      console.log("AGENT  (no immediate SMS)");
+    }
+    if (result.scheduledMessages.length === 0) {
+      console.log("SCHED  (none)");
+    } else {
+      for (const row of result.scheduledMessages) {
+        console.log(`SCHED  ${row.status} ${row.scheduledAt} ${row.content}`);
+      }
+    }
+    if (result.schedulingCheck) {
+      console.log(
+        `CHECK  ${result.schedulingCheck.passed ? "pass" : "fail"} ${result.schedulingCheck.reason}`
+      );
+    }
+    console.log("");
+  } catch (error) {
+    if (jsonOutput) {
+      console.log(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : String(error)
+        })
+      );
+    } else {
+      console.error(
+        `Error: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    process.exit(1);
+  }
+}
 async function agentsCommand(args2) {
   const subcommand = args2[0];
   if (!subcommand || subcommand === "--help" || subcommand === "-h") {
@@ -11781,6 +12010,9 @@ async function agentsCommand(args2) {
     case "rollback":
       await handleRollback(subArgs);
       break;
+    case "test":
+      await handleTest(subArgs);
+      break;
     default:
       console.error(`Error: Unknown subcommand: ${subcommand}`);
       console.error("Run 'skedyul agents --help' for usage information.");
@@ -14381,7 +14613,7 @@ COMMANDS
   invoke     Invoke a tool on a hosted app version
   instances  Manage CRM instances (list, get, create, update, delete)
   crm        Manage CRM schemas (push, pull, diff, models)
-  agents     Manage agents (list, get, push)
+  agents     Manage agents (list, get, deploy, test)
   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)

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

@@ -106,6 +106,29 @@ export interface EntityDefinition extends BaseDefinition {
      * as channel `capabilities.messaging.send` + MessageSendInput.
      */
     tools?: EntityRuntimeTools;
+    /**
+     * Generic pre-save dialogs. Core/web render configured fields; the app
+     * declares copy, options, and when to show. Answers go on the CRM event
+     * envelope under the app handle (not into CRM scalar fields).
+     */
+    saveInteractions?: EntitySaveInteractionDefinition[];
+}
+export interface EntitySaveInteractionDefinition {
+    handle: string;
+    when: {
+        onCreate?: boolean;
+        onUpdate?: boolean;
+        fieldsChanged?: string[];
+        relationshipsChanged?: string[];
+    };
+    dialog: {
+        title: string;
+        message: string;
+        severity?: 'warning' | 'info';
+        /** Entity / contextField handles to render (type + options come from the entity). */
+        fields: string[];
+        defaults?: Record<string, string>;
+    };
 }
 /**
  * Situation → short MCP tool name. Keys are platform contracts; values are