skedyul 1.2.43 → 1.2.48

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

@@ -21,8 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var agent_schema_v3_exports = {};
 __export(agent_schema_v3_exports, {
   AGENT_SCHEMA_VERSION_V3: () => AGENT_SCHEMA_VERSION_V3,
-  AgentConfigV3Schema: () => AgentConfigV3Schema,
+  AgentToolRefSchema: () => AgentToolRefSchema,
   AgentYAMLV3Schema: () => AgentYAMLV3Schema,
+  BehaviorConfigV3Schema: () => BehaviorConfigV3Schema,
   BootstrapToolRefSchema: () => BootstrapToolRefSchema,
   ExternalMemoryConfigSchema: () => ExternalMemoryConfigSchema,
   MemoryConfigV3Schema: () => MemoryConfigV3Schema,
@@ -31,9 +32,20 @@ __export(agent_schema_v3_exports, {
   PersonaVoiceV3Schema: () => PersonaVoiceV3Schema,
   PoliciesConfigV3Schema: () => PoliciesConfigV3Schema,
   PromptsConfigV3Schema: () => PromptsConfigV3Schema,
-  ResponsePolicySchema: () => ResponsePolicySchema,
+  ResponseModeSchema: () => ResponseModeSchema,
+  ResponsesBehaviorConfigSchema: () => ResponsesBehaviorConfigSchema,
   RuntimeConfigV3Schema: () => RuntimeConfigV3Schema,
+  SchedulingBehaviorConfigSchema: () => SchedulingBehaviorConfigSchema,
+  SchedulingDelaySchema: () => SchedulingDelaySchema,
+  SchedulingPatternSchema: () => SchedulingPatternSchema,
   SemanticMemoryConfigSchema: () => SemanticMemoryConfigSchema,
+  TimeWindowBehaviorSchema: () => TimeWindowBehaviorSchema,
+  TimeWindowDayOfWeekSchema: () => TimeWindowDayOfWeekSchema,
+  TimeWindowDefaultSchema: () => TimeWindowDefaultSchema,
+  TimeWindowPoliciesSchema: () => TimeWindowPoliciesSchema,
+  TimeWindowPolicySchema: () => TimeWindowPolicySchema,
+  TimeWindowSlotAgentSchema: () => TimeWindowSlotAgentSchema,
+  TimeWindowTimeStampSchema: () => TimeWindowTimeStampSchema,
   ToolApprovalConfigSchema: () => ToolApprovalConfigSchema,
   ToolRefV3Schema: () => ToolRefV3Schema,
   ToolSandboxConfigSchema: () => ToolSandboxConfigSchema,
@@ -211,14 +223,12 @@ var SkillExampleSchema = import_v42.z.object({
   output: import_v42.z.string(),
   tool_call: import_v42.z.string().optional()
 });
-var SkillEvaluationMetricSchema = import_v42.z.object({
-  metric: import_v42.z.string(),
-  description: import_v42.z.string().optional(),
-  threshold: import_v42.z.number().optional()
+var CRMModelFieldRequirementsSchema = import_v42.z.object({
+  required: import_v42.z.array(import_v42.z.string()).optional(),
+  recommended: import_v42.z.array(import_v42.z.string()).optional()
 });
 var CRMContextSchema = import_v42.z.object({
-  models: import_v42.z.record(import_v42.z.string(), import_v42.z.array(import_v42.z.string()))
-  // { modelHandle: [fieldHandles] }
+  models: import_v42.z.record(import_v42.z.string(), CRMModelFieldRequirementsSchema)
 });
 var SkillYAMLSchema = import_v42.z.object({
   // Schema version
@@ -235,11 +245,7 @@ var SkillYAMLSchema = import_v42.z.object({
   // CRM context - specifies which models/fields to include in schema
   crmContext: CRMContextSchema.optional(),
   // Few-shot examples
-  examples: import_v42.z.array(SkillExampleSchema).optional(),
-  // Evaluation criteria
-  evaluation: import_v42.z.array(SkillEvaluationMetricSchema).optional(),
-  // Tags for discovery
-  tags: import_v42.z.array(import_v42.z.string()).optional()
+  examples: import_v42.z.array(SkillExampleSchema).optional()
 });
 var SkillYAMLV2Schema = import_v42.z.object({
   $schema: import_v42.z.literal(SKILL_SCHEMA_VERSION_V2).optional(),
@@ -250,9 +256,7 @@ var SkillYAMLV2Schema = import_v42.z.object({
   instructions: import_v42.z.string(),
   tools: import_v42.z.array(SkillToolDefinitionSchema).optional(),
   crmContext: CRMContextSchema.optional(),
-  examples: import_v42.z.array(SkillExampleSchema).optional(),
-  evaluation: import_v42.z.array(SkillEvaluationMetricSchema).optional(),
-  tags: import_v42.z.array(import_v42.z.string()).optional()
+  examples: import_v42.z.array(SkillExampleSchema).optional()
 });
 var SkillVersionWeightSchema = import_v42.z.object({
   version: import_v42.z.number(),
@@ -286,7 +290,6 @@ var SkillMetadataSchema = import_v42.z.object({
   s3Key: import_v42.z.string().optional(),
   appVersionId: import_v42.z.string().optional(),
   workplaceId: import_v42.z.string().optional(),
-  tags: import_v42.z.array(import_v42.z.string()).optional(),
   createdAt: import_v42.z.string().datetime().optional(),
   updatedAt: import_v42.z.string().datetime().optional()
 });
@@ -334,52 +337,61 @@ var ThreadInfoSchema = import_v43.z.object({
   status: import_v43.z.string().optional(),
   kind: import_v43.z.string().optional()
 });
-var AgentContextSchema = import_v43.z.object({
-  // Who sent the message
-  sender: SenderContextSchema,
-  // Thread contexts (linked CRM instances)
-  contexts: import_v43.z.array(ThreadContextItemSchema).optional(),
-  // Thread info
-  thread: ThreadInfoSchema,
-  // Workplace info
-  workplace: import_v43.z.object({
-    id: import_v43.z.string(),
-    name: import_v43.z.string().optional()
-  }).optional()
-});
-var MockSubscriptionSchema = import_v43.z.object({
+var SubscriptionSchema = import_v43.z.object({
   identifierValue: import_v43.z.string(),
   channelHandle: import_v43.z.string().optional()
 });
-var MockAssociationSchema = import_v43.z.object({
+var AssociationSchema = import_v43.z.object({
   id: import_v43.z.string().optional(),
   data: import_v43.z.record(import_v43.z.string(), import_v43.z.unknown())
 });
-var MockContactSchema = import_v43.z.object({
+var ContactSchema = import_v43.z.object({
   id: import_v43.z.string().optional(),
   name: import_v43.z.string().optional(),
-  subscription: MockSubscriptionSchema.optional(),
-  associations: import_v43.z.record(import_v43.z.string(), MockAssociationSchema).optional()
+  subscription: SubscriptionSchema.optional(),
+  associations: import_v43.z.record(import_v43.z.string(), AssociationSchema).optional()
 });
-var MockSenderContextSchema = import_v43.z.object({
+var AgentSenderContextSchema = import_v43.z.object({
   kind: import_v43.z.enum(["contact", "member"]),
   displayName: import_v43.z.string().optional(),
   role: import_v43.z.string().optional(),
   permissions: import_v43.z.array(import_v43.z.string()).optional(),
-  contact: MockContactSchema.optional()
+  contact: ContactSchema.optional()
 });
-var MockThreadContextSchema = import_v43.z.object({
+var AgentThreadContextSchema = import_v43.z.object({
   handle: import_v43.z.string(),
   model: import_v43.z.string(),
   data: import_v43.z.record(import_v43.z.string(), import_v43.z.unknown())
 });
-var MockContextSchema = import_v43.z.object({
-  sender: MockSenderContextSchema,
-  contexts: import_v43.z.array(MockThreadContextSchema).optional()
+var AgentContextSchema = import_v43.z.object({
+  sender: AgentSenderContextSchema,
+  contexts: import_v43.z.array(AgentThreadContextSchema).optional()
+});
+var ContextIssueSeveritySchema = import_v43.z.enum(["ERROR", "WARNING"]);
+var ContextIssueTypeSchema = import_v43.z.enum([
+  "MISSING_ROUTING_PARTICIPANT",
+  "MISSING_ASSOCIATION",
+  "MISSING_REQUIRED_FIELD",
+  "MISSING_RECOMMENDED_FIELD"
+]);
+var ContextIssueSchema = import_v43.z.object({
+  type: ContextIssueTypeSchema,
+  severity: ContextIssueSeveritySchema,
+  model: import_v43.z.string().optional(),
+  field: import_v43.z.string().optional(),
+  message: import_v43.z.string(),
+  suggestion: import_v43.z.string().optional()
+});
+var ContextValidationResultSchema = import_v43.z.object({
+  valid: import_v43.z.boolean(),
+  degraded: import_v43.z.boolean(),
+  issues: import_v43.z.array(ContextIssueSchema)
 });
 var SandboxConfigSchema = import_v43.z.object({
   enabled: import_v43.z.boolean().optional(),
-  mockContext: MockContextSchema.optional()
+  /** @deprecated Use 'context' instead of 'mockContext' */
+  mockContext: AgentContextSchema.optional(),
+  context: AgentContextSchema.optional()
 });
 
 // src/schemas/agent-schema-v3.ts
@@ -417,13 +429,14 @@ var ToolRefV3Schema = import_v44.z.union([
     overrides: import_v44.z.record(import_v44.z.string(), import_v44.z.unknown()).optional()
   })
 ]);
-var BootstrapToolRefSchema = import_v44.z.union([
+var AgentToolRefSchema = import_v44.z.union([
   import_v44.z.string(),
   import_v44.z.object({
     tool: import_v44.z.string(),
     description: import_v44.z.string().optional()
   })
 ]);
+var BootstrapToolRefSchema = AgentToolRefSchema;
 var WorkingMemoryConfigSchema = import_v44.z.object({
   strategy: import_v44.z.enum(["full", "rolling_summary", "sliding_window"]).optional(),
   maxTokens: import_v44.z.number().optional(),
@@ -446,29 +459,169 @@ var MemoryConfigV3Schema = import_v44.z.object({
   external: ExternalMemoryConfigSchema.optional(),
   semantic: SemanticMemoryConfigSchema.optional()
 });
-var ResponsePolicySchema = import_v44.z.object({
-  requiresApproval: import_v44.z.boolean().optional(),
-  requiresApprovalIf: import_v44.z.array(import_v44.z.string()).optional()
+var RequiresApprovalPolicySchema = import_v44.z.object({
+  requiresApproval: import_v44.z.boolean().optional()
 });
 var PoliciesConfigV3Schema = import_v44.z.object({
-  response: ResponsePolicySchema.optional(),
-  rules: import_v44.z.array(import_v44.z.string()).optional()
+  messages: import_v44.z.object({
+    send: RequiresApprovalPolicySchema.optional(),
+    schedule: RequiresApprovalPolicySchema.optional()
+  }).optional(),
+  tools: import_v44.z.object({
+    externalRequiresApproval: import_v44.z.boolean().optional(),
+    systemRequiresApproval: import_v44.z.boolean().optional()
+  }).optional()
 });
 var RuntimeConfigV3Schema = import_v44.z.object({
-  model: import_v44.z.string().optional(),
-  timeout: import_v44.z.string().optional(),
-  timezone: import_v44.z.string().optional(),
-  retry: import_v44.z.object({
-    attempts: import_v44.z.number().optional(),
-    backoff: import_v44.z.enum(["linear", "exponential"]).optional()
+  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
+  model: import_v44.z.string().optional()
+});
+var TimeWindowTimeStampSchema = import_v44.z.union([
+  import_v44.z.number().describe("Hour of day (0-23)"),
+  import_v44.z.object({
+    hour: import_v44.z.number(),
+    minute: import_v44.z.number().optional().default(0)
+  })
+]);
+var TimeWindowDayOfWeekSchema = import_v44.z.enum([
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday",
+  "sunday"
+]);
+var TimeWindowSlotAgentSchema = import_v44.z.object({
+  startTime: TimeWindowTimeStampSchema,
+  endTime: TimeWindowTimeStampSchema,
+  days: import_v44.z.array(TimeWindowDayOfWeekSchema)
+});
+var ResponseModeSchema = import_v44.z.enum([
+  "immediate",
+  "ack_and_schedule",
+  "schedule_only"
+]);
+var TimeWindowBehaviorSchema = import_v44.z.object({
+  /** How to handle responses in this window */
+  responseMode: ResponseModeSchema,
+  /** Prompt injection for this time context */
+  prompt: import_v44.z.string().optional().describe("Prompt injection for this time context"),
+  /** Window to schedule responses for (when responseMode is ack_and_schedule or schedule_only) */
+  scheduleFor: import_v44.z.string().optional().describe("Window name to schedule responses for")
+});
+var TimeWindowPolicySchema = import_v44.z.object({
+  /** IANA timezone for the window (e.g., "Australia/Sydney") */
+  timezone: import_v44.z.string().describe('IANA timezone, e.g., "Australia/Sydney"'),
+  /** Time slots when this window is active */
+  windows: import_v44.z.array(TimeWindowSlotAgentSchema),
+  /** Behavior for this window (optional - defaults to immediate response) */
+  behavior: TimeWindowBehaviorSchema.optional()
+});
+var TimeWindowPoliciesSchema = import_v44.z.record(import_v44.z.string(), TimeWindowPolicySchema);
+var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
+  "Fallback behavior when no time window matches"
+);
+var ResponsesBehaviorConfigSchema = import_v44.z.object({
+  /**
+   * Maximum intermediate messages per agent run.
+   * Intermediate = progress updates, acknowledgments before task completion.
+   * The final message slot is always reserved separately.
+   * @default 2
+   */
+  maxIntermediate: import_v44.z.number().optional(),
+  /**
+   * Whether a final message is required before the run completes.
+   * If true and no final message is sent, the run fails.
+   * @default true
+   */
+  requireFinal: import_v44.z.boolean().optional(),
+  /**
+   * Whether the agent can schedule messages for future delivery.
+   * Scheduled messages typically require approval.
+   * @default false
+   */
+  allowSchedule: import_v44.z.boolean().optional(),
+  /**
+   * Message splitting configuration.
+   * Controls whether and how the agent splits responses into multiple messages.
+   */
+  messageSplitting: import_v44.z.object({
+    /**
+     * Whether to allow natural message splitting.
+     * When true, the agent may split responses into multiple messages
+     * when it improves conversational flow.
+     */
+    enabled: import_v44.z.boolean(),
+    /**
+     * Custom prompt to override the default message splitting guidance.
+     * If not provided, uses sensible defaults for when to split vs. keep together.
+     */
+    prompt: import_v44.z.string().optional()
   }).optional()
 });
+var SchedulingDelaySchema = import_v44.z.object({
+  /** Time unit amount */
+  amount: import_v44.z.number(),
+  /** Time unit (e.g., "week", "weeks", "day", "days", "month", "months") */
+  unit: import_v44.z.string(),
+  /** Optional time window to constrain the delay */
+  timeWindow: import_v44.z.string().optional()
+});
+var SchedulingPatternSchema = import_v44.z.object({
+  /** Trigger name for this pattern */
+  trigger: import_v44.z.string(),
+  /** Human-readable description of when this pattern applies */
+  description: import_v44.z.string().optional(),
+  /** Example user phrases that match this pattern */
+  examples: import_v44.z.array(import_v44.z.string()).optional(),
+  /** Default delay for this pattern */
+  defaultDelay: SchedulingDelaySchema.optional()
+});
+var SchedulingBehaviorConfigSchema = import_v44.z.object({
+  /**
+   * Patterns that trigger scheduling suggestions.
+   * The agent uses these to know when to add sendAt to messages.
+   */
+  patterns: import_v44.z.array(SchedulingPatternSchema).optional(),
+  /**
+   * Default settings for scheduled messages.
+   */
+  defaults: import_v44.z.object({
+    /** Cancel scheduled message if user replies before send time (default: true) */
+    cancelOnActivity: import_v44.z.boolean().optional(),
+    /** Whether scheduled messages require approval (default: true) */
+    requiresApproval: import_v44.z.boolean().optional(),
+    /** Default time window policy to constrain all scheduled messages */
+    timeWindow: import_v44.z.string().optional().describe("Time window policy name for scheduled messages")
+  }).optional()
+});
+var BehaviorConfigV3Schema = import_v44.z.object({
+  /**
+   * Response behavior - controls message sending via tool calls.
+   * When configured, agents must explicitly call system:message:send
+   * instead of producing implicit final output.
+   */
+  responses: ResponsesBehaviorConfigSchema.optional(),
+  /**
+   * Scheduling behavior - controls when the agent schedules follow-up messages.
+   * Patterns define triggers like "user indicates they'll return later".
+   */
+  scheduling: SchedulingBehaviorConfigSchema.optional()
+});
 var PromptsConfigV3Schema = import_v44.z.object({
+  /** Main system prompt with workflow instructions */
+  system: import_v44.z.string().optional(),
+  /** Injected during second pass when skills were loaded but tools not used */
   recovery: import_v44.z.string().optional(),
+  /** Injected during follow-up passes when context needs updating */
   followUp: import_v44.z.string().optional(),
-  skillDiscoveryWorkflow: import_v44.z.string().optional()
+  /** Thread list title generation (system + user template with {{var}} placeholders) */
+  titleEnrichment: import_v44.z.object({
+    system: import_v44.z.string().optional(),
+    user: import_v44.z.string().optional()
+  }).optional()
 });
-var AgentConfigV3Schema = import_v44.z.record(import_v44.z.string(), import_v44.z.unknown());
 var AgentYAMLV3Schema = import_v44.z.object({
   $schema: import_v44.z.string().optional(),
   handle: import_v44.z.string(),
@@ -479,28 +632,36 @@ var AgentYAMLV3Schema = import_v44.z.object({
   persona: PersonaV3Schema.optional(),
   // Skills - What the agent knows how to do (skills own their tools)
   skills: import_v44.z.array(SkillRefSchema).optional(),
-  // Bootstrap tools - Always-available system tools before any skill loads
-  // Examples: system:skill:load, system:message:send
-  bootstrapTools: import_v44.z.array(BootstrapToolRefSchema).optional(),
-  // Tools - DEPRECATED: Use skills to own tools instead
-  // Kept for backward compatibility during migration
-  // @deprecated Will be removed in a future version
-  tools: import_v44.z.array(ToolRefV3Schema).optional(),
-  // Events - When the agent activates
+  // Tools - Always-available tools before any skill loads
+  // Examples: system:settings:business_information:get
+  tools: import_v44.z.array(AgentToolRefSchema).optional(),
+  /**
+   * Events - When the agent activates
+   * @deprecated Not yet implemented - this is a planned feature for event-driven agents.
+   * Fields are accepted but not used at runtime.
+   */
   events: EventsConfigSchema.optional(),
-  // Memory - How the agent remembers
+  /**
+   * Memory - How the agent remembers
+   * @deprecated Not yet implemented - this is a planned feature.
+   * Fields are accepted but not used at runtime.
+   */
   memory: MemoryConfigV3Schema.optional(),
-  // Policies - Constraints and approvals
+  // Policies - Business rules for the agent
   policies: PoliciesConfigV3Schema.optional(),
-  // Runtime - Execution configuration
+  // Runtime - Execution configuration (only model is used)
   runtime: RuntimeConfigV3Schema.optional(),
-  // Prompts - Agent-specific prompt injections for runtime phases
-  // recovery: Injected during second pass when skills were loaded but tools not used
-  // followUp: Injected during follow-up passes when context needs updating
-  // skillDiscoveryWorkflow: Custom workflow instructions for skill discovery
+  // Prompts - Agent-specific prompt injections
   prompts: PromptsConfigV3Schema.optional(),
-  // Config - Business-specific settings
-  config: AgentConfigV3Schema.optional(),
+  // Behavior - Agent runtime behavior configuration
+  // responses: Controls message sending via explicit tool calls
+  behavior: BehaviorConfigV3Schema.optional(),
+  // Time Windows - Named time window policies for scheduling constraints
+  // Windows must be mutually exclusive (non-overlapping)
+  // Each window can define its own behavior (response mode, prompt, etc.)
+  timeWindows: TimeWindowPoliciesSchema.optional(),
+  // Time Window Default - Fallback behavior when no window matches
+  timeWindowDefault: TimeWindowDefaultSchema.optional(),
   // Sandbox - Testing configuration
   sandbox: SandboxConfigSchema.optional()
 });
@@ -517,8 +678,9 @@ function validateAgentYAMLV3(agent) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_SCHEMA_VERSION_V3,
-  AgentConfigV3Schema,
+  AgentToolRefSchema,
   AgentYAMLV3Schema,
+  BehaviorConfigV3Schema,
   BootstrapToolRefSchema,
   ExternalMemoryConfigSchema,
   MemoryConfigV3Schema,
@@ -527,9 +689,20 @@ function validateAgentYAMLV3(agent) {
   PersonaVoiceV3Schema,
   PoliciesConfigV3Schema,
   PromptsConfigV3Schema,
-  ResponsePolicySchema,
+  ResponseModeSchema,
+  ResponsesBehaviorConfigSchema,
   RuntimeConfigV3Schema,
+  SchedulingBehaviorConfigSchema,
+  SchedulingDelaySchema,
+  SchedulingPatternSchema,
   SemanticMemoryConfigSchema,
+  TimeWindowBehaviorSchema,
+  TimeWindowDayOfWeekSchema,
+  TimeWindowDefaultSchema,
+  TimeWindowPoliciesSchema,
+  TimeWindowPolicySchema,
+  TimeWindowSlotAgentSchema,
+  TimeWindowTimeStampSchema,
   ToolApprovalConfigSchema,
   ToolRefV3Schema,
   ToolSandboxConfigSchema,