skedyul 1.7.29 → 1.7.30

package/dist/esm/index.mjs

@@ -321,9 +321,235 @@ function isRuntimeWebhookContext(ctx) {
 // src/schemas.ts
 import { z as z8 } from "zod/v4";
 
-// src/schemas/crm-schema.ts
+// src/skills/types.ts
 import { z as z3 } from "zod/v4";
-var CRMFieldTypeSchema = z3.enum([
+var SKILL_SCHEMA_VERSION = "https://skedyul.com/schemas/skill/v1";
+var SKILL_SCHEMA_VERSION_V2 = "https://skedyul.com/schemas/skill/v2";
+var SkillSourceSchema = z3.enum(["BUILTIN", "S3", "APP", "EXTERNAL"]);
+var SkillToolRequirementSchema = z3.object({
+  requires: z3.array(z3.string()).optional(),
+  provides: z3.array(z3.string()).optional()
+});
+var SkillToolSandboxSchema = z3.object({
+  mock: z3.unknown().optional()
+});
+var ToolConstraintsSchema = z3.object({
+  maxCallsPerRun: z3.number().optional(),
+  idempotent: z3.boolean().optional(),
+  restricted: z3.boolean().optional(),
+  tags: z3.array(z3.string()).optional()
+});
+var SkillToolDefinitionSchema = z3.object({
+  tool: z3.string(),
+  description: z3.string().optional(),
+  overrides: z3.record(z3.string(), z3.unknown()).optional(),
+  sandbox: SkillToolSandboxSchema.optional(),
+  requiresApproval: z3.boolean().optional(),
+  constraints: ToolConstraintsSchema.optional()
+});
+var SkillToolsSchema = z3.union([
+  SkillToolRequirementSchema,
+  z3.array(SkillToolDefinitionSchema)
+]);
+var SkillExampleSchema = z3.object({
+  context: z3.string().optional(),
+  input: z3.string(),
+  reasoning: z3.string().optional(),
+  output: z3.string(),
+  tool_call: z3.string().optional()
+});
+var CRMModelFieldRequirementsSchema = z3.object({
+  required: z3.array(z3.string()).optional(),
+  recommended: z3.array(z3.string()).optional()
+});
+var CRMContextSchema = z3.object({
+  models: z3.record(z3.string(), CRMModelFieldRequirementsSchema)
+});
+var EntityOperationSchema = z3.enum(["get", "list", "update", "create", "delete"]);
+var EntityPoliciesSchema = z3.record(
+  z3.string(),
+  // entity handle (e.g., "member", "booking")
+  z3.array(EntityOperationSchema)
+  // allowed operations
+);
+var EvaluatorPreconditionsSchema = z3.object({
+  toolSucceeded: z3.boolean().optional(),
+  anyWrittenFields: z3.array(z3.string()).optional(),
+  noneOfWrittenFields: z3.array(z3.string()).optional(),
+  crm: z3.array(
+    z3.object({
+      field: z3.string(),
+      op: z3.enum(["eq", "in", "empty", "notEmpty"]),
+      value: z3.unknown().optional()
+    })
+  ).optional(),
+  skillsLoaded: z3.array(z3.string()).optional(),
+  skillsNotLoaded: z3.array(z3.string()).optional()
+});
+var SkillEvaluatorSchema = z3.object({
+  name: z3.string(),
+  description: z3.string().optional(),
+  target: z3.enum(["message", "tool", "entity"]),
+  selector: z3.string().optional(),
+  criteria: z3.string(),
+  passThreshold: z3.number().optional(),
+  checks: z3.object({
+    requiredArgs: z3.array(z3.string()).optional(),
+    forbiddenArgValues: z3.record(z3.string(), z3.array(z3.unknown())).optional()
+  }).optional(),
+  preconditions: EvaluatorPreconditionsSchema.optional()
+});
+var SkillYAMLSchema = z3.object({
+  // Schema version
+  $schema: z3.string().optional(),
+  // Identity
+  handle: z3.string(),
+  name: z3.string(),
+  version: z3.string().optional(),
+  description: z3.string().optional(),
+  // Instructions injected into agent system prompt
+  instructions: z3.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: z3.array(z3.string()).optional(),
+  // Quality evaluators owned by this skill
+  evaluators: z3.array(SkillEvaluatorSchema).optional(),
+  // Few-shot examples
+  examples: z3.array(SkillExampleSchema).optional()
+});
+var SkillYAMLV2Schema = z3.object({
+  $schema: z3.literal(SKILL_SCHEMA_VERSION_V2).optional(),
+  handle: z3.string(),
+  name: z3.string(),
+  version: z3.string().optional(),
+  description: z3.string().optional(),
+  instructions: z3.string(),
+  entityPolicies: EntityPoliciesSchema.optional(),
+  tools: z3.array(SkillToolDefinitionSchema).optional(),
+  crmContext: CRMContextSchema.optional(),
+  ownedFields: z3.array(z3.string()).optional(),
+  evaluators: z3.array(SkillEvaluatorSchema).optional(),
+  examples: z3.array(SkillExampleSchema).optional()
+});
+var SkillVersionWeightSchema = z3.object({
+  version: z3.number(),
+  weight: z3.number()
+});
+var SkillRefSchema = z3.union([
+  z3.string(),
+  // Just handle - uses latest published version
+  z3.object({
+    skill: z3.string(),
+    description: z3.string().optional(),
+    // For AI SDK Agent Skills discovery
+    /**
+     * @deprecated Ignored. The agent must call system:skill:load each turn.
+     * Kept so existing agent YAML still validates.
+     */
+    alwaysLoad: z3.boolean().optional(),
+    // Version selection (pick one):
+    version: z3.number().optional(),
+    // Pin to specific version number
+    versions: z3.array(SkillVersionWeightSchema).optional(),
+    // A/B testing weights
+    // Legacy support:
+    instructions: z3.string().optional(),
+    // Inline instructions (deprecated)
+    enabled: z3.boolean().optional()
+  })
+]);
+var SkillMetadataSchema = z3.object({
+  id: z3.string(),
+  handle: z3.string(),
+  name: z3.string(),
+  version: z3.string().optional(),
+  description: z3.string().optional(),
+  source: SkillSourceSchema,
+  s3Key: z3.string().optional(),
+  appVersionId: z3.string().optional(),
+  workplaceId: z3.string().optional(),
+  createdAt: z3.string().datetime().optional(),
+  updatedAt: z3.string().datetime().optional()
+});
+var ResolvedSkillSchema = z3.object({
+  handle: z3.string(),
+  name: z3.string(),
+  instructions: z3.string().optional(),
+  description: z3.string().optional(),
+  tools: z3.array(z3.string()).optional(),
+  examples: z3.array(SkillExampleSchema).optional()
+});
+var LoadedSkillSchema = z3.object({
+  handle: z3.string(),
+  name: z3.string(),
+  instructions: z3.string().optional(),
+  description: z3.string().optional(),
+  entityPolicies: EntityPoliciesSchema.optional(),
+  tools: z3.array(SkillToolDefinitionSchema).optional(),
+  examples: z3.array(SkillExampleSchema).optional()
+});
+function isV2SkillTools(tools) {
+  if (!tools) return false;
+  return Array.isArray(tools);
+}
+function getSkillToolNames(tools) {
+  if (!tools) return [];
+  if (isV2SkillTools(tools)) {
+    return tools.map((t) => t.tool);
+  }
+  return tools.requires || [];
+}
+function defineSkill(skill) {
+  return SkillYAMLSchema.parse(skill);
+}
+function validateSkillYAML(skill) {
+  const result = SkillYAMLSchema.safeParse(skill);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, error: result.error };
+}
+function formatSkillInstructions(skills) {
+  if (skills.length === 0) return "";
+  const sections = skills.map((skill) => {
+    if (!skill.instructions) {
+      return `## ${skill.name}
+
+${skill.description || "No description available."}`;
+    }
+    let section = `## ${skill.name}
+
+${skill.instructions}`;
+    if (skill.examples && skill.examples.length > 0) {
+      section += "\n\n### Examples\n";
+      for (const example of skill.examples) {
+        section += `
+**Input:** ${example.input}
+`;
+        if (example.reasoning) {
+          section += `**Reasoning:** ${example.reasoning}
+`;
+        }
+        section += `**Output:** ${example.output}
+`;
+      }
+    }
+    return section;
+  });
+  return `# Skills
+
+${sections.join("\n\n---\n\n")}`;
+}
+
+// src/schemas/crm-schema.ts
+import { z as z4 } from "zod/v4";
+var CRMFieldTypeSchema = z4.enum([
   "string",
   "long_string",
   "number",
@@ -335,51 +561,51 @@ var CRMFieldTypeSchema = z3.enum([
   "image",
   "object"
 ]);
-var CRMFieldRequirementSchema = z3.enum([
+var CRMFieldRequirementSchema = z4.enum([
   "optional",
   "on_create",
   "required"
 ]);
-var CRMFieldOptionSchema = z3.object({
-  label: z3.string(),
-  value: z3.string(),
-  color: z3.string().optional()
-});
-var CRMFieldDefinitionObjectSchema = z3.object({
-  options: z3.array(CRMFieldOptionSchema).optional(),
-  limitChoices: z3.number().optional(),
-  minLength: z3.number().optional(),
-  maxLength: z3.number().optional(),
-  min: z3.number().optional(),
-  max: z3.number().optional(),
-  pattern: z3.string().optional()
-});
-var CRMFieldDefinitionSchema = z3.union([
-  z3.string(),
+var CRMFieldOptionSchema = z4.object({
+  label: z4.string(),
+  value: z4.string(),
+  color: z4.string().optional()
+});
+var CRMFieldDefinitionObjectSchema = z4.object({
+  options: z4.array(CRMFieldOptionSchema).optional(),
+  limitChoices: z4.number().optional(),
+  minLength: z4.number().optional(),
+  maxLength: z4.number().optional(),
+  min: z4.number().optional(),
+  max: z4.number().optional(),
+  pattern: z4.string().optional()
+});
+var CRMFieldDefinitionSchema = z4.union([
+  z4.string(),
   CRMFieldDefinitionObjectSchema
 ]);
-var CRMFieldAppearanceSchemaZ = z3.object({
-  leftIcon: z3.string().optional(),
-  rightIcon: z3.string().optional(),
-  placeholder: z3.string().optional(),
-  helpText: z3.string().optional()
-});
-var CRMFieldAiMetaSchemaZ = z3.object({
-  description: z3.string().optional(),
-  mutability: z3.enum(["always", "restricted", "create_only", "immutable"]).optional()
-});
-var CRMFieldSchemaZ = z3.object({
-  handle: z3.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
-  label: z3.string().min(1, "Label is required"),
+var CRMFieldAppearanceSchemaZ = z4.object({
+  leftIcon: z4.string().optional(),
+  rightIcon: z4.string().optional(),
+  placeholder: z4.string().optional(),
+  helpText: z4.string().optional()
+});
+var CRMFieldAiMetaSchemaZ = z4.object({
+  description: z4.string().optional(),
+  mutability: z4.enum(["always", "restricted", "create_only", "immutable"]).optional()
+});
+var CRMFieldSchemaZ = z4.object({
+  handle: z4.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
+  label: z4.string().min(1, "Label is required"),
   type: CRMFieldTypeSchema,
   /** Field description - explains what the field is for (metadata, not UI) */
-  description: z3.string().optional(),
+  description: z4.string().optional(),
   /** Field appearance - UI presentation settings */
   appearance: CRMFieldAppearanceSchemaZ.optional(),
   requirement: CRMFieldRequirementSchema.optional(),
-  unique: z3.boolean().optional(),
-  list: z3.boolean().optional(),
-  default: z3.unknown().optional(),
+  unique: z4.boolean().optional(),
+  list: z4.boolean().optional(),
+  default: z4.unknown().optional(),
   definition: CRMFieldDefinitionSchema.optional(),
   /** AI metadata - description and mutability hints for agents */
   aiMeta: CRMFieldAiMetaSchemaZ.optional(),
@@ -387,96 +613,96 @@ var CRMFieldSchemaZ = z3.object({
    * Workplace-scoped field section handle (visualization helper).
    * Find-or-create on apply; display name is derived from the handle on create.
    */
-  section: z3.string().regex(/^[a-z][a-z0-9_-]*$/, "Section handle must be lowercase alphanumeric with underscores/hyphens, starting with a letter").optional()
-});
-var CRMModelSchemaZ = z3.object({
-  handle: z3.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
-  name: z3.string().min(1, "Name is required"),
-  namePlural: z3.string().optional(),
-  labelTemplate: z3.string().optional(),
-  description: z3.string().optional(),
-  icon: z3.string().optional(),
-  fields: z3.array(CRMFieldSchemaZ)
-});
-var CRMCardinalitySchema = z3.enum([
+  section: z4.string().regex(/^[a-z][a-z0-9_-]*$/, "Section handle must be lowercase alphanumeric with underscores/hyphens, starting with a letter").optional()
+});
+var CRMModelSchemaZ = z4.object({
+  handle: z4.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
+  name: z4.string().min(1, "Name is required"),
+  namePlural: z4.string().optional(),
+  labelTemplate: z4.string().optional(),
+  description: z4.string().optional(),
+  icon: z4.string().optional(),
+  fields: z4.array(CRMFieldSchemaZ)
+});
+var CRMCardinalitySchema = z4.enum([
   "one_to_one",
   "one_to_many",
   "many_to_one",
   "many_to_many"
 ]);
-var CRMOnDeleteSchema = z3.enum([
+var CRMOnDeleteSchema = z4.enum([
   "none",
   "cascade",
   "restrict",
   "set_null"
 ]);
-var CRMRelationshipLinkSchema = z3.object({
-  model: z3.string(),
-  field: z3.string(),
-  label: z3.string()
+var CRMRelationshipLinkSchema = z4.object({
+  model: z4.string(),
+  field: z4.string(),
+  label: z4.string()
 });
-var CRMRelationshipSchemaZ = z3.object({
+var CRMRelationshipSchemaZ = z4.object({
   source: CRMRelationshipLinkSchema,
   target: CRMRelationshipLinkSchema,
   cardinality: CRMCardinalitySchema,
   onDelete: CRMOnDeleteSchema.optional()
 });
-var CRMBlockTypeSchema = z3.enum([
+var CRMBlockTypeSchema = z4.enum([
   "spreadsheet",
   "form",
   "card",
   "metric",
   "kanban"
 ]);
-var CRMBlockSchemaZ = z3.object({
+var CRMBlockSchemaZ = z4.object({
   type: CRMBlockTypeSchema,
-  title: z3.string().optional(),
-  config: z3.unknown().optional(),
-  default: z3.boolean().optional()
+  title: z4.string().optional(),
+  config: z4.unknown().optional(),
+  default: z4.boolean().optional()
 });
-var CRMPageTypeSchema = z3.enum(["list", "instance"]);
-var CRMPageSchemaZ = z3.object({
-  path: z3.string(),
+var CRMPageTypeSchema = z4.enum(["list", "instance"]);
+var CRMPageSchemaZ = z4.object({
+  path: z4.string(),
   type: CRMPageTypeSchema,
-  title: z3.string(),
-  icon: z3.string().optional(),
-  modelHandle: z3.string(),
-  parentPath: z3.string().optional(),
-  isDefault: z3.boolean().optional(),
-  visibility: z3.enum(["team", "private"]).optional(),
-  baseQuery: z3.unknown().optional(),
-  blocks: z3.array(CRMBlockSchemaZ).optional()
-});
-var CRMNavigationNodeBaseSchemaZ = z3.object({
-  label: z3.string(),
-  icon: z3.string().optional(),
-  path: z3.string().optional(),
-  kind: z3.enum(["section", "group"]).optional(),
-  sortIndex: z3.number().optional()
-});
-var CRMNavigationItemSchemaZ = z3.lazy(
+  title: z4.string(),
+  icon: z4.string().optional(),
+  modelHandle: z4.string(),
+  parentPath: z4.string().optional(),
+  isDefault: z4.boolean().optional(),
+  visibility: z4.enum(["team", "private"]).optional(),
+  baseQuery: z4.unknown().optional(),
+  blocks: z4.array(CRMBlockSchemaZ).optional()
+});
+var CRMNavigationNodeBaseSchemaZ = z4.object({
+  label: z4.string(),
+  icon: z4.string().optional(),
+  path: z4.string().optional(),
+  kind: z4.enum(["section", "group"]).optional(),
+  sortIndex: z4.number().optional()
+});
+var CRMNavigationItemSchemaZ = z4.lazy(
   () => CRMNavigationNodeBaseSchemaZ.extend({
-    children: z3.array(CRMNavigationItemSchemaZ).optional()
+    children: z4.array(CRMNavigationItemSchemaZ).optional()
   })
 );
-var CRMNavigationSchemaZ = z3.object({
-  sidebar: z3.array(CRMNavigationItemSchemaZ).optional()
+var CRMNavigationSchemaZ = z4.object({
+  sidebar: z4.array(CRMNavigationItemSchemaZ).optional()
 });
-var CRMSchemaZ = z3.object({
+var CRMSchemaZ = z4.object({
   /** Schema format version for future compatibility */
-  $schema: z3.literal("https://skedyul.com/schemas/crm/v1").optional(),
+  $schema: z4.literal("https://skedyul.com/schemas/crm/v1").optional(),
   /** Schema name for identification */
-  name: z3.string().min(1, "Name is required"),
+  name: z4.string().min(1, "Name is required"),
   /** Optional description */
-  description: z3.string().optional(),
+  description: z4.string().optional(),
   /** Schema version (semver) */
-  version: z3.string().optional(),
+  version: z4.string().optional(),
   /** Model definitions */
-  models: z3.array(CRMModelSchemaZ),
+  models: z4.array(CRMModelSchemaZ),
   /** Relationship definitions */
-  relationships: z3.array(CRMRelationshipSchemaZ).optional(),
+  relationships: z4.array(CRMRelationshipSchemaZ).optional(),
   /** Page definitions */
-  pages: z3.array(CRMPageSchemaZ).optional(),
+  pages: z4.array(CRMPageSchemaZ).optional(),
   /** Navigation definitions */
   navigation: CRMNavigationSchemaZ.optional()
 });
@@ -506,8 +732,8 @@ function safeParseCRMSchema(data) {
 import { z as z7 } from "zod/v4";
 
 // src/events/types.ts
-import { z as z4 } from "zod/v4";
-var ThreadEventTypeSchema = z4.enum([
+import { z as z5 } from "zod/v4";
+var ThreadEventTypeSchema = z5.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
@@ -530,73 +756,73 @@ var ThreadEventTypeSchema = z4.enum([
   // Signal events
   "thread.signal.created"
 ]);
-var CustomEventTypeSchema = z4.string().regex(/^custom\.[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/, {
+var CustomEventTypeSchema = z5.string().regex(/^custom\.[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/, {
   message: "Custom event type must match pattern: custom.{namespace}.{event}"
 });
-var EventTypeSchema = z4.union([ThreadEventTypeSchema, CustomEventTypeSchema]);
-var ParticipantKindSchema = z4.enum(["CONTACT", "MEMBER", "AGENT", "WORKFLOW"]);
-var BaseEventPayloadSchema = z4.object({
-  threadId: z4.string(),
-  workplaceId: z4.string(),
-  timestamp: z4.string().datetime().optional()
+var EventTypeSchema = z5.union([ThreadEventTypeSchema, CustomEventTypeSchema]);
+var ParticipantKindSchema = z5.enum(["CONTACT", "MEMBER", "AGENT", "WORKFLOW"]);
+var BaseEventPayloadSchema = z5.object({
+  threadId: z5.string(),
+  workplaceId: z5.string(),
+  timestamp: z5.string().datetime().optional()
 });
 var MessageEventPayloadSchema = BaseEventPayloadSchema.extend({
-  message: z4.object({
-    id: z4.string(),
-    content: z4.string(),
-    senderId: z4.string().optional()
+  message: z5.object({
+    id: z5.string(),
+    content: z5.string(),
+    senderId: z5.string().optional()
   }),
-  participant: z4.object({
-    id: z4.string(),
+  participant: z5.object({
+    id: z5.string(),
     kind: ParticipantKindSchema,
-    displayName: z4.string().optional()
+    displayName: z5.string().optional()
   }).optional(),
-  isFirstMessage: z4.boolean().optional(),
-  messageCount: z4.number().optional()
+  isFirstMessage: z5.boolean().optional(),
+  messageCount: z5.number().optional()
 });
 var ParticipantEventPayloadSchema = BaseEventPayloadSchema.extend({
-  participant: z4.object({
-    id: z4.string(),
+  participant: z5.object({
+    id: z5.string(),
     kind: ParticipantKindSchema,
-    displayName: z4.string().optional(),
-    contactId: z4.string().optional(),
-    memberId: z4.string().optional(),
-    agentId: z4.string().optional(),
-    workflowId: z4.string().optional()
+    displayName: z5.string().optional(),
+    contactId: z5.string().optional(),
+    memberId: z5.string().optional(),
+    agentId: z5.string().optional(),
+    workflowId: z5.string().optional()
   })
 });
 var ContextChangedPayloadSchema = BaseEventPayloadSchema.extend({
-  context: z4.object({
-    handle: z4.string(),
-    model: z4.string(),
-    instanceId: z4.string()
+  context: z5.object({
+    handle: z5.string(),
+    model: z5.string(),
+    instanceId: z5.string()
   }),
-  change: z4.object({
-    field: z4.string().optional(),
-    oldValue: z4.unknown().optional(),
-    newValue: z4.unknown().optional()
+  change: z5.object({
+    field: z5.string().optional(),
+    oldValue: z5.unknown().optional(),
+    newValue: z5.unknown().optional()
   }).optional()
 });
 var StatusChangedPayloadSchema = BaseEventPayloadSchema.extend({
-  oldStatus: z4.string(),
-  newStatus: z4.string()
+  oldStatus: z5.string(),
+  newStatus: z5.string()
 });
 var ScheduledEventPayloadSchema = BaseEventPayloadSchema.extend({
-  scheduledEventId: z4.string(),
-  reason: z4.string().optional(),
-  context: z4.record(z4.string(), z4.unknown()).optional()
+  scheduledEventId: z5.string(),
+  reason: z5.string().optional(),
+  context: z5.record(z5.string(), z5.unknown()).optional()
 });
 var AgentWorkflowEventPayloadSchema = BaseEventPayloadSchema.extend({
-  agentId: z4.string().optional(),
-  workflowId: z4.string().optional(),
-  workflowRunId: z4.string().optional(),
-  outputs: z4.record(z4.string(), z4.unknown()).optional(),
-  error: z4.string().optional()
+  agentId: z5.string().optional(),
+  workflowId: z5.string().optional(),
+  workflowRunId: z5.string().optional(),
+  outputs: z5.record(z5.string(), z5.unknown()).optional(),
+  error: z5.string().optional()
 });
 var CustomEventPayloadSchema = BaseEventPayloadSchema.extend({
-  data: z4.record(z4.string(), z4.unknown()).optional()
+  data: z5.record(z5.string(), z5.unknown()).optional()
 });
-var ThreadEventPayloadSchema = z4.union([
+var ThreadEventPayloadSchema = z5.union([
   MessageEventPayloadSchema,
   ParticipantEventPayloadSchema,
   ContextChangedPayloadSchema,
@@ -605,218 +831,40 @@ var ThreadEventPayloadSchema = z4.union([
   AgentWorkflowEventPayloadSchema,
   CustomEventPayloadSchema
 ]);
-var ThreadEventSchema = z4.object({
-  id: z4.string(),
-  threadId: z4.string(),
+var ThreadEventSchema = z5.object({
+  id: z5.string(),
+  threadId: z5.string(),
   type: EventTypeSchema,
   payload: ThreadEventPayloadSchema,
-  emittedBy: z4.string().optional(),
-  createdAt: z4.string().datetime()
+  emittedBy: z5.string().optional(),
+  createdAt: z5.string().datetime()
 });
-var CreateThreadEventInputSchema = z4.object({
-  threadId: z4.string(),
+var CreateThreadEventInputSchema = z5.object({
+  threadId: z5.string(),
   type: EventTypeSchema,
-  payload: z4.record(z4.string(), z4.unknown()),
-  emittedBy: z4.string().optional()
+  payload: z5.record(z5.string(), z5.unknown()),
+  emittedBy: z5.string().optional()
 });
-var EventSubscriptionSchema = z4.object({
-  subscribes: z4.array(EventTypeSchema),
-  condition: z4.string().optional(),
-  cancels: z4.array(EventTypeSchema).optional(),
-  cancelCondition: z4.string().optional()
+var EventSubscriptionSchema = z5.object({
+  subscribes: z5.array(EventTypeSchema),
+  condition: z5.string().optional(),
+  cancels: z5.array(EventTypeSchema).optional(),
+  cancelCondition: z5.string().optional()
 });
-var EventWaitSchema = z4.object({
+var EventWaitSchema = z5.object({
   event: EventTypeSchema,
-  timeout: z4.string().optional(),
-  onTimeout: z4.string().optional()
+  timeout: z5.string().optional(),
+  onTimeout: z5.string().optional()
 });
-var EventsConfigSchema = z4.object({
-  subscribes: z4.array(EventTypeSchema).optional(),
-  condition: z4.string().optional(),
-  emits: z4.array(EventTypeSchema).optional(),
-  waits: z4.array(EventWaitSchema).optional(),
-  cancels: z4.array(EventTypeSchema).optional(),
-  cancelCondition: z4.string().optional()
+var EventsConfigSchema = z5.object({
+  subscribes: z5.array(EventTypeSchema).optional(),
+  condition: z5.string().optional(),
+  emits: z5.array(EventTypeSchema).optional(),
+  waits: z5.array(EventWaitSchema).optional(),
+  cancels: z5.array(EventTypeSchema).optional(),
+  cancelCondition: z5.string().optional()
 });
 
-// src/skills/types.ts
-import { z as z5 } from "zod/v4";
-var SKILL_SCHEMA_VERSION = "https://skedyul.com/schemas/skill/v1";
-var SKILL_SCHEMA_VERSION_V2 = "https://skedyul.com/schemas/skill/v2";
-var SkillSourceSchema = z5.enum(["BUILTIN", "S3", "APP", "EXTERNAL"]);
-var SkillToolRequirementSchema = z5.object({
-  requires: z5.array(z5.string()).optional(),
-  provides: z5.array(z5.string()).optional()
-});
-var SkillToolSandboxSchema = z5.object({
-  mock: z5.unknown().optional()
-});
-var ToolConstraintsSchema = z5.object({
-  maxCallsPerRun: z5.number().optional(),
-  idempotent: z5.boolean().optional(),
-  restricted: z5.boolean().optional(),
-  tags: z5.array(z5.string()).optional()
-});
-var SkillToolDefinitionSchema = z5.object({
-  tool: z5.string(),
-  description: z5.string().optional(),
-  overrides: z5.record(z5.string(), z5.unknown()).optional(),
-  sandbox: SkillToolSandboxSchema.optional(),
-  requiresApproval: z5.boolean().optional(),
-  constraints: ToolConstraintsSchema.optional()
-});
-var SkillToolsSchema = z5.union([
-  SkillToolRequirementSchema,
-  z5.array(SkillToolDefinitionSchema)
-]);
-var SkillExampleSchema = z5.object({
-  context: z5.string().optional(),
-  input: z5.string(),
-  reasoning: z5.string().optional(),
-  output: z5.string(),
-  tool_call: z5.string().optional()
-});
-var CRMModelFieldRequirementsSchema = z5.object({
-  required: z5.array(z5.string()).optional(),
-  recommended: z5.array(z5.string()).optional()
-});
-var CRMContextSchema = z5.object({
-  models: z5.record(z5.string(), CRMModelFieldRequirementsSchema)
-});
-var SkillYAMLSchema = z5.object({
-  // Schema version
-  $schema: z5.string().optional(),
-  // Identity
-  handle: z5.string(),
-  name: z5.string(),
-  version: z5.string().optional(),
-  description: z5.string().optional(),
-  // Instructions injected into agent system prompt
-  instructions: z5.string(),
-  // Tool configuration - supports both v1 and v2 formats
-  tools: SkillToolsSchema.optional(),
-  // CRM context - specifies which models/fields to include in schema
-  crmContext: CRMContextSchema.optional(),
-  // Few-shot examples
-  examples: z5.array(SkillExampleSchema).optional()
-});
-var SkillYAMLV2Schema = z5.object({
-  $schema: z5.literal(SKILL_SCHEMA_VERSION_V2).optional(),
-  handle: z5.string(),
-  name: z5.string(),
-  version: z5.string().optional(),
-  description: z5.string().optional(),
-  instructions: z5.string(),
-  tools: z5.array(SkillToolDefinitionSchema).optional(),
-  crmContext: CRMContextSchema.optional(),
-  examples: z5.array(SkillExampleSchema).optional()
-});
-var SkillVersionWeightSchema = z5.object({
-  version: z5.number(),
-  weight: z5.number()
-});
-var SkillRefSchema = z5.union([
-  z5.string(),
-  // Just handle - uses latest published version
-  z5.object({
-    skill: z5.string(),
-    description: z5.string().optional(),
-    // For AI SDK Agent Skills discovery
-    /** Auto-inject this skill's instructions and tools on every agent turn */
-    alwaysLoad: z5.boolean().optional(),
-    // Version selection (pick one):
-    version: z5.number().optional(),
-    // Pin to specific version number
-    versions: z5.array(SkillVersionWeightSchema).optional(),
-    // A/B testing weights
-    // Legacy support:
-    instructions: z5.string().optional(),
-    // Inline instructions (deprecated)
-    enabled: z5.boolean().optional()
-  })
-]);
-var SkillMetadataSchema = z5.object({
-  id: z5.string(),
-  handle: z5.string(),
-  name: z5.string(),
-  version: z5.string().optional(),
-  description: z5.string().optional(),
-  source: SkillSourceSchema,
-  s3Key: z5.string().optional(),
-  appVersionId: z5.string().optional(),
-  workplaceId: z5.string().optional(),
-  createdAt: z5.string().datetime().optional(),
-  updatedAt: z5.string().datetime().optional()
-});
-var ResolvedSkillSchema = z5.object({
-  handle: z5.string(),
-  name: z5.string(),
-  instructions: z5.string().optional(),
-  description: z5.string().optional(),
-  tools: z5.array(z5.string()).optional(),
-  examples: z5.array(SkillExampleSchema).optional()
-});
-var LoadedSkillSchema = z5.object({
-  handle: z5.string(),
-  name: z5.string(),
-  instructions: z5.string().optional(),
-  description: z5.string().optional(),
-  tools: z5.array(SkillToolDefinitionSchema).optional(),
-  examples: z5.array(SkillExampleSchema).optional()
-});
-function isV2SkillTools(tools) {
-  if (!tools) return false;
-  return Array.isArray(tools);
-}
-function getSkillToolNames(tools) {
-  if (!tools) return [];
-  if (isV2SkillTools(tools)) {
-    return tools.map((t) => t.tool);
-  }
-  return tools.requires || [];
-}
-function defineSkill(skill) {
-  return SkillYAMLSchema.parse(skill);
-}
-function validateSkillYAML(skill) {
-  const result = SkillYAMLSchema.safeParse(skill);
-  if (result.success) {
-    return { success: true, data: result.data };
-  }
-  return { success: false, error: result.error };
-}
-function formatSkillInstructions(skills) {
-  if (skills.length === 0) return "";
-  const sections = skills.map((skill) => {
-    if (!skill.instructions) {
-      return `## ${skill.name}
-
-${skill.description || "No description available."}`;
-    }
-    let section = `## ${skill.name}
-
-${skill.instructions}`;
-    if (skill.examples && skill.examples.length > 0) {
-      section += "\n\n### Examples\n";
-      for (const example of skill.examples) {
-        section += `
-**Input:** ${example.input}
-`;
-        if (example.reasoning) {
-          section += `**Reasoning:** ${example.reasoning}
-`;
-        }
-        section += `**Output:** ${example.output}
-`;
-      }
-    }
-    return section;
-  });
-  return `# Skills
-
-${sections.join("\n\n---\n\n")}`;
-}
-
 // src/context/types.ts
 import { z as z6 } from "zod/v4";
 var CRMContextSchema2 = z6.object({
@@ -1063,6 +1111,13 @@ var ResponsesBehaviorConfigSchema = z7.object({
    * @default false
    */
   allowSchedule: z7.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: z7.boolean().optional(),
   /**
    * Message splitting configuration.
    * Controls whether and how the agent splits responses into multiple messages.
@@ -1369,6 +1424,22 @@ var EntityCrmMapDefaultsSchema = z8.object({
 var EntityRuntimeToolsSchema = z8.object({
   calendarWindowPull: z8.string().min(1).optional()
 });
+var EntitySaveInteractionSchema = z8.object({
+  handle: z8.string(),
+  when: z8.object({
+    onCreate: z8.boolean().optional(),
+    onUpdate: z8.boolean().optional(),
+    fieldsChanged: z8.array(z8.string()).optional(),
+    relationshipsChanged: z8.array(z8.string()).optional()
+  }),
+  dialog: z8.object({
+    title: z8.string(),
+    message: z8.string(),
+    severity: z8.enum(["warning", "info"]).optional(),
+    fields: z8.array(z8.string()),
+    defaults: z8.record(z8.string(), z8.string()).optional()
+  })
+});
 var EntityDefinitionSchema = z8.object({
   handle: z8.string(),
   label: z8.string(),
@@ -1378,7 +1449,8 @@ var EntityDefinitionSchema = z8.object({
   contextFields: z8.array(EntityFieldDefinitionSchema).optional(),
   relationships: z8.array(EntityRelationshipDefinitionSchema).optional(),
   crmMapDefaults: EntityCrmMapDefaultsSchema.optional(),
-  tools: EntityRuntimeToolsSchema.optional()
+  tools: EntityRuntimeToolsSchema.optional(),
+  saveInteractions: z8.array(EntitySaveInteractionSchema).optional()
 });
 var RelationshipCardinalitySchema = z8.enum([
   "ONE_TO_ONE",
@@ -1995,6 +2067,26 @@ var BatchOperationDefinitionSchema = z8.object({
   pageSize: z8.number().int().positive().optional(),
   icon: z8.string().optional()
 });
+var ProvisionSkillDefinitionSchema = z8.object({
+  /** Unique identifier for the skill */
+  handle: z8.string(),
+  /** Display name */
+  name: z8.string(),
+  /** Short description for skill discovery */
+  description: z8.string().optional(),
+  /** Full instructions injected into agent context when skill is loaded */
+  instructions: z8.string(),
+  /** Entity policies - declares which entity operations this skill needs */
+  entityPolicies: EntityPoliciesSchema.optional(),
+  /** Additional tools (MCP, system) not covered by entity policies */
+  tools: z8.array(SkillToolDefinitionSchema).optional(),
+  /** CRM context - specifies which model fields to include in schema */
+  crmContext: z8.object({
+    models: z8.record(z8.string(), CRMModelFieldRequirementsSchema)
+  }).optional(),
+  /** Few-shot examples for the skill */
+  examples: z8.array(SkillExampleSchema).optional()
+});
 var ProvisionConfigSchema = z8.object({
   env: EnvSchemaSchema.optional(),
   /** INTERNAL model definitions for data shared across installs */
@@ -2011,7 +2103,9 @@ var ProvisionConfigSchema = z8.object({
   /** Install setup checklist steps (opt-in) */
   setup: z8.array(SetupStepDefinitionSchema).optional(),
   /** Batch operations for imports, syncs, and long-running tasks */
-  batchOperations: z8.array(BatchOperationDefinitionSchema).optional()
+  batchOperations: z8.array(BatchOperationDefinitionSchema).optional(),
+  /** Skills provided by this app */
+  skills: z8.array(ProvisionSkillDefinitionSchema).optional()
 });
 var SkedyulConfigSchema = z8.object({
   name: z8.string(),
@@ -8963,8 +9057,11 @@ export {
   EntityCrmMapDefaultsSchema,
   EntityDefinitionSchema,
   EntityFieldDefinitionSchema,
+  EntityOperationSchema,
+  EntityPoliciesSchema,
   EntityRelationshipDefinitionSchema,
   EntityRuntimeToolsSchema,
+  EntitySaveInteractionSchema,
   EnvSchemaSchema,
   EnvVariableDefinitionSchema,
   EnvVisibilitySchema,
@@ -9063,6 +9160,7 @@ export {
   ParticipantEventPayloadSchema,
   ParticipantKindSchema,
   ProvisionConfigSchema,
+  ProvisionSkillDefinitionSchema,
   QueueContextError,
   QueueNotFoundError,
   QueuedFetchExhaustedError,
@@ -9089,6 +9187,7 @@ export {
   SetupStepDefinitionSchema,
   SetupStepKindSchema,
   SkedyulConfigSchema,
+  SkillEvaluatorSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
   SkillRefSchema,