skedyul 1.7.28 → 1.7.30

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", {
@@ -2861,6 +2889,17 @@ async function invokeTool(ctx, input) {
     timeout: input.timeout
   });
 }
+async function getDeployment(ctx, input) {
+  return callCliApi(cliApi(ctx), "/app-deploy", void 0, {
+    method: "GET",
+    query: {
+      deploymentId: input.deploymentId,
+      tail: input.tail != null ? String(input.tail) : void 0,
+      logs: input.includeLogs === false ? "false" : "true",
+      errorsOnly: input.errorsOnly ? "true" : void 0
+    }
+  });
+}
 
 // src/cli/commands/invoke-remote.ts
 function getMimeType2(filePath) {
@@ -10218,6 +10257,22 @@ var ToolBindingZ = import_v46.z.union([
     executionMode: import_v46.z.enum(["ALLOW_ALL", "REQUIRE_APPROVAL"]).optional(),
     /** Approval timeout in ms (default: 86400000 = 1 day) */
     approvalTimeoutMs: import_v46.z.number().optional()
+  }),
+  import_v46.z.object({
+    kind: import_v46.z.literal("APP_ENTITY"),
+    /** App handle (e.g., 'bft') */
+    appHandle: import_v46.z.string(),
+    /** Entity handle (e.g., 'member', 'booking') */
+    entity: import_v46.z.string(),
+    /** Operation: get, list, update, create, delete */
+    operation: import_v46.z.enum(["get", "list", "update", "create", "delete"]),
+    handle: import_v46.z.string().optional(),
+    displayName: import_v46.z.string().optional(),
+    description: import_v46.z.string().optional(),
+    /** Execution mode: ALLOW_ALL (default) or REQUIRE_APPROVAL */
+    executionMode: import_v46.z.enum(["ALLOW_ALL", "REQUIRE_APPROVAL"]).optional(),
+    /** Approval timeout in ms (default: 86400000 = 1 day) */
+    approvalTimeoutMs: import_v46.z.number().optional()
   })
 ]);
 var StageBaseZ = import_v46.z.object({
@@ -10525,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(),
@@ -10535,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()
 });
@@ -10549,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({
@@ -10564,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(),
@@ -10603,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()
 });
@@ -10857,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.
@@ -11004,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)
@@ -11043,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
@@ -11067,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) {
@@ -11719,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") {
@@ -11754,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.");
@@ -14195,6 +14454,137 @@ async function eventCommand(args2) {
   }
 }
 
+// src/cli/commands/apps.ts
+init_utils();
+function printHelp24() {
+  console.log(`
+skedyul apps - Inspect app installations and deployments
+
+Usage:
+  skedyul apps deployment --id <deploymentId> [options]
+
+Required:
+  --id, -i                  Deployment ID (dpl_...)
+
+Options:
+  --tail, -n                Newest log lines (default: 100, max: 500)
+  --errors-only             Only print error/warn lines
+  --no-logs                 Skip the log tail (FAILED still returns errors)
+  --json                    Output the full JSON response
+  --help, -h                Show this help message
+
+Examples:
+  skedyul apps deployment --id dpl_abc123
+  skedyul apps deployment --id dpl_abc123 --errors-only
+  skedyul apps deployment --id dpl_abc123 --tail 200 --json
+
+MCP equivalent: apps_get_deployment
+`);
+}
+function formatLogLine(entry) {
+  const time = entry.timestamp ?? "";
+  const level = (entry.level ?? "info").toUpperCase().padEnd(5);
+  const message = entry.message ?? "";
+  return [time, level, message].filter(Boolean).join("  ");
+}
+async function appsCommand(args2) {
+  const { flags, positional } = parseArgs(args2);
+  if (flags.help || flags.h) {
+    printHelp24();
+    return;
+  }
+  const subcommand = positional[0];
+  if (subcommand !== "deployment") {
+    printHelp24();
+    process.exit(subcommand ? 1 : 0);
+  }
+  const deploymentId = String(flags.id ?? flags.i ?? positional[1] ?? "");
+  if (!deploymentId) {
+    console.error("Error: --id <deploymentId> is required");
+    printHelp24();
+    process.exit(1);
+  }
+  const credentials = getCredentials();
+  if (!credentials?.token) {
+    console.error("Not logged in. Run 'skedyul auth login' first.");
+    process.exit(1);
+  }
+  const ctx = {
+    token: credentials.token,
+    serverUrl: credentials.serverUrl || getServerUrl()
+  };
+  const tailFlag = flags.tail ?? flags.n;
+  const tail = typeof tailFlag === "string" && tailFlag.length > 0 ? Number(tailFlag) : void 0;
+  const result = await getDeployment(ctx, {
+    deploymentId,
+    tail: Number.isFinite(tail) ? tail : void 0,
+    includeLogs: flags["no-logs"] ? false : true,
+    errorsOnly: Boolean(flags["errors-only"])
+  });
+  if (flags.json) {
+    console.log(formatJson(result));
+    if (result.error && !result.deploymentId) {
+      process.exit(1);
+    }
+    return;
+  }
+  if (result.error && !result.deploymentId) {
+    console.error(result.error);
+    process.exit(1);
+  }
+  console.log(`Deployment  ${result.deploymentId ?? deploymentId}`);
+  console.log(`Status      ${result.status ?? "unknown"}`);
+  if (result.appHandle) {
+    console.log(`App         ${result.appHandle}`);
+  }
+  if (result.readyToInvoke != null) {
+    console.log(`Ready       ${result.readyToInvoke ? "yes" : "no"}`);
+  }
+  if (result.invokeEndpoint) {
+    console.log(`Endpoint    ${result.invokeEndpoint}`);
+  }
+  if (result.provision?.status) {
+    console.log(
+      `Provision   ${result.provision.status}${result.provision.currentStep ? ` (${result.provision.currentStep})` : ""}`
+    );
+  }
+  if (result.provision?.errorMessage) {
+    console.error(`Provision error: ${result.provision.errorMessage}`);
+  }
+  if (result.pendingMigration) {
+    console.error(
+      "Pending CRM migration \u2014 approve it in Skedyul or via crm.approveMigration before the deploy can finish."
+    );
+  }
+  if (result.lastError) {
+    console.error(`Queue error: ${result.lastError}`);
+  }
+  if (result.hint) {
+    console.error(result.hint);
+  }
+  if (result.logsError) {
+    console.error(`Log fetch: ${result.logsError}`);
+  }
+  const errors = result.errors ?? [];
+  if (errors.length > 0) {
+    console.log("");
+    console.log(`Errors (${errors.length})`);
+    for (const entry of errors) {
+      console.error(formatLogLine(entry));
+    }
+  }
+  const logs = result.logs ?? [];
+  if (logs.length > 0 && !flags["errors-only"]) {
+    const total = result.logsTotal ?? logs.length;
+    const label = result.logsTruncated ? `Logs (newest ${logs.length} of ${total})` : `Logs (${logs.length})`;
+    console.log("");
+    console.log(label);
+    for (const entry of logs) {
+      console.log(formatLogLine(entry));
+    }
+  }
+}
+
 // src/cli/index.ts
 var args = process.argv.slice(2);
 function printUsage2() {
@@ -14223,10 +14613,11 @@ 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)
+  apps       Inspect app deployments and build logs
   dev        Development tools for building and testing apps locally
 
 GETTING STARTED
@@ -14286,6 +14677,7 @@ MORE HELP
   $ skedyul agents --help     Show agent management commands
   $ skedyul skills --help     Show skill management commands
   $ skedyul workflows --help  Show workflow management commands
+  $ skedyul apps --help       Show app deployment log commands
   $ skedyul chat --help       Show chat command options
   $ skedyul dev --help        Show development commands
   $ skedyul <cmd> --help      Show help for specific command
@@ -14444,6 +14836,10 @@ async function main() {
     await eventCommand(args.slice(1));
     return;
   }
+  if (command === "apps") {
+    await appsCommand(args.slice(1));
+    return;
+  }
   if (command === "build") {
     await buildCommand(args.slice(1));
     return;

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

@@ -99,4 +99,45 @@ export interface EntityDefinition extends BaseDefinition {
      * Used by install suggest/analyze — not applied automatically.
      */
     crmMapDefaults?: EntityCrmMapDefaults;
+    /**
+     * Platform situations this entity participates in, and the short MCP tool
+     * name to invoke for each. Omit a key to skip that situation.
+     * Core builds a typed payload (see CalendarWindowPullInput) — same pattern
+     * 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
+ * the app's tool handle (not `app:{handle}:…`).
+ */
+export interface EntityRuntimeTools {
+    /**
+     * CRM LIST calendar views, before reading instances.
+     * Invoked with CalendarWindowPullInput.
+     */
+    calendarWindowPull?: string;
 }