skedyul 1.2.43 → 1.2.48

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

@@ -170,14 +170,12 @@ var SkillExampleSchema = z2.object({
   output: z2.string(),
   tool_call: z2.string().optional()
 });
-var SkillEvaluationMetricSchema = z2.object({
-  metric: z2.string(),
-  description: z2.string().optional(),
-  threshold: z2.number().optional()
+var CRMModelFieldRequirementsSchema = z2.object({
+  required: z2.array(z2.string()).optional(),
+  recommended: z2.array(z2.string()).optional()
 });
 var CRMContextSchema = z2.object({
-  models: z2.record(z2.string(), z2.array(z2.string()))
-  // { modelHandle: [fieldHandles] }
+  models: z2.record(z2.string(), CRMModelFieldRequirementsSchema)
 });
 var SkillYAMLSchema = z2.object({
   // Schema version
@@ -194,11 +192,7 @@ var SkillYAMLSchema = z2.object({
   // CRM context - specifies which models/fields to include in schema
   crmContext: CRMContextSchema.optional(),
   // Few-shot examples
-  examples: z2.array(SkillExampleSchema).optional(),
-  // Evaluation criteria
-  evaluation: z2.array(SkillEvaluationMetricSchema).optional(),
-  // Tags for discovery
-  tags: z2.array(z2.string()).optional()
+  examples: z2.array(SkillExampleSchema).optional()
 });
 var SkillYAMLV2Schema = z2.object({
   $schema: z2.literal(SKILL_SCHEMA_VERSION_V2).optional(),
@@ -209,9 +203,7 @@ var SkillYAMLV2Schema = z2.object({
   instructions: z2.string(),
   tools: z2.array(SkillToolDefinitionSchema).optional(),
   crmContext: CRMContextSchema.optional(),
-  examples: z2.array(SkillExampleSchema).optional(),
-  evaluation: z2.array(SkillEvaluationMetricSchema).optional(),
-  tags: z2.array(z2.string()).optional()
+  examples: z2.array(SkillExampleSchema).optional()
 });
 var SkillVersionWeightSchema = z2.object({
   version: z2.number(),
@@ -245,7 +237,6 @@ var SkillMetadataSchema = z2.object({
   s3Key: z2.string().optional(),
   appVersionId: z2.string().optional(),
   workplaceId: z2.string().optional(),
-  tags: z2.array(z2.string()).optional(),
   createdAt: z2.string().datetime().optional(),
   updatedAt: z2.string().datetime().optional()
 });
@@ -293,52 +284,61 @@ var ThreadInfoSchema = z3.object({
   status: z3.string().optional(),
   kind: z3.string().optional()
 });
-var AgentContextSchema = z3.object({
-  // Who sent the message
-  sender: SenderContextSchema,
-  // Thread contexts (linked CRM instances)
-  contexts: z3.array(ThreadContextItemSchema).optional(),
-  // Thread info
-  thread: ThreadInfoSchema,
-  // Workplace info
-  workplace: z3.object({
-    id: z3.string(),
-    name: z3.string().optional()
-  }).optional()
-});
-var MockSubscriptionSchema = z3.object({
+var SubscriptionSchema = z3.object({
   identifierValue: z3.string(),
   channelHandle: z3.string().optional()
 });
-var MockAssociationSchema = z3.object({
+var AssociationSchema = z3.object({
   id: z3.string().optional(),
   data: z3.record(z3.string(), z3.unknown())
 });
-var MockContactSchema = z3.object({
+var ContactSchema = z3.object({
   id: z3.string().optional(),
   name: z3.string().optional(),
-  subscription: MockSubscriptionSchema.optional(),
-  associations: z3.record(z3.string(), MockAssociationSchema).optional()
+  subscription: SubscriptionSchema.optional(),
+  associations: z3.record(z3.string(), AssociationSchema).optional()
 });
-var MockSenderContextSchema = z3.object({
+var AgentSenderContextSchema = z3.object({
   kind: z3.enum(["contact", "member"]),
   displayName: z3.string().optional(),
   role: z3.string().optional(),
   permissions: z3.array(z3.string()).optional(),
-  contact: MockContactSchema.optional()
+  contact: ContactSchema.optional()
 });
-var MockThreadContextSchema = z3.object({
+var AgentThreadContextSchema = z3.object({
   handle: z3.string(),
   model: z3.string(),
   data: z3.record(z3.string(), z3.unknown())
 });
-var MockContextSchema = z3.object({
-  sender: MockSenderContextSchema,
-  contexts: z3.array(MockThreadContextSchema).optional()
+var AgentContextSchema = z3.object({
+  sender: AgentSenderContextSchema,
+  contexts: z3.array(AgentThreadContextSchema).optional()
+});
+var ContextIssueSeveritySchema = z3.enum(["ERROR", "WARNING"]);
+var ContextIssueTypeSchema = z3.enum([
+  "MISSING_ROUTING_PARTICIPANT",
+  "MISSING_ASSOCIATION",
+  "MISSING_REQUIRED_FIELD",
+  "MISSING_RECOMMENDED_FIELD"
+]);
+var ContextIssueSchema = z3.object({
+  type: ContextIssueTypeSchema,
+  severity: ContextIssueSeveritySchema,
+  model: z3.string().optional(),
+  field: z3.string().optional(),
+  message: z3.string(),
+  suggestion: z3.string().optional()
+});
+var ContextValidationResultSchema = z3.object({
+  valid: z3.boolean(),
+  degraded: z3.boolean(),
+  issues: z3.array(ContextIssueSchema)
 });
 var SandboxConfigSchema = z3.object({
   enabled: z3.boolean().optional(),
-  mockContext: MockContextSchema.optional()
+  /** @deprecated Use 'context' instead of 'mockContext' */
+  mockContext: AgentContextSchema.optional(),
+  context: AgentContextSchema.optional()
 });
 
 // src/schemas/agent-schema-v3.ts
@@ -376,13 +376,14 @@ var ToolRefV3Schema = z4.union([
     overrides: z4.record(z4.string(), z4.unknown()).optional()
   })
 ]);
-var BootstrapToolRefSchema = z4.union([
+var AgentToolRefSchema = z4.union([
   z4.string(),
   z4.object({
     tool: z4.string(),
     description: z4.string().optional()
   })
 ]);
+var BootstrapToolRefSchema = AgentToolRefSchema;
 var WorkingMemoryConfigSchema = z4.object({
   strategy: z4.enum(["full", "rolling_summary", "sliding_window"]).optional(),
   maxTokens: z4.number().optional(),
@@ -405,29 +406,169 @@ var MemoryConfigV3Schema = z4.object({
   external: ExternalMemoryConfigSchema.optional(),
   semantic: SemanticMemoryConfigSchema.optional()
 });
-var ResponsePolicySchema = z4.object({
-  requiresApproval: z4.boolean().optional(),
-  requiresApprovalIf: z4.array(z4.string()).optional()
+var RequiresApprovalPolicySchema = z4.object({
+  requiresApproval: z4.boolean().optional()
 });
 var PoliciesConfigV3Schema = z4.object({
-  response: ResponsePolicySchema.optional(),
-  rules: z4.array(z4.string()).optional()
+  messages: z4.object({
+    send: RequiresApprovalPolicySchema.optional(),
+    schedule: RequiresApprovalPolicySchema.optional()
+  }).optional(),
+  tools: z4.object({
+    externalRequiresApproval: z4.boolean().optional(),
+    systemRequiresApproval: z4.boolean().optional()
+  }).optional()
 });
 var RuntimeConfigV3Schema = z4.object({
-  model: z4.string().optional(),
-  timeout: z4.string().optional(),
-  timezone: z4.string().optional(),
-  retry: z4.object({
-    attempts: z4.number().optional(),
-    backoff: z4.enum(["linear", "exponential"]).optional()
+  /** LLM model identifier (e.g., "google/gemini-3.1-flash-lite") */
+  model: z4.string().optional()
+});
+var TimeWindowTimeStampSchema = z4.union([
+  z4.number().describe("Hour of day (0-23)"),
+  z4.object({
+    hour: z4.number(),
+    minute: z4.number().optional().default(0)
+  })
+]);
+var TimeWindowDayOfWeekSchema = z4.enum([
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday",
+  "sunday"
+]);
+var TimeWindowSlotAgentSchema = z4.object({
+  startTime: TimeWindowTimeStampSchema,
+  endTime: TimeWindowTimeStampSchema,
+  days: z4.array(TimeWindowDayOfWeekSchema)
+});
+var ResponseModeSchema = z4.enum([
+  "immediate",
+  "ack_and_schedule",
+  "schedule_only"
+]);
+var TimeWindowBehaviorSchema = z4.object({
+  /** How to handle responses in this window */
+  responseMode: ResponseModeSchema,
+  /** Prompt injection for this time context */
+  prompt: z4.string().optional().describe("Prompt injection for this time context"),
+  /** Window to schedule responses for (when responseMode is ack_and_schedule or schedule_only) */
+  scheduleFor: z4.string().optional().describe("Window name to schedule responses for")
+});
+var TimeWindowPolicySchema = z4.object({
+  /** IANA timezone for the window (e.g., "Australia/Sydney") */
+  timezone: z4.string().describe('IANA timezone, e.g., "Australia/Sydney"'),
+  /** Time slots when this window is active */
+  windows: z4.array(TimeWindowSlotAgentSchema),
+  /** Behavior for this window (optional - defaults to immediate response) */
+  behavior: TimeWindowBehaviorSchema.optional()
+});
+var TimeWindowPoliciesSchema = z4.record(z4.string(), TimeWindowPolicySchema);
+var TimeWindowDefaultSchema = TimeWindowBehaviorSchema.describe(
+  "Fallback behavior when no time window matches"
+);
+var ResponsesBehaviorConfigSchema = z4.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: z4.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: z4.boolean().optional(),
+  /**
+   * Whether the agent can schedule messages for future delivery.
+   * Scheduled messages typically require approval.
+   * @default false
+   */
+  allowSchedule: z4.boolean().optional(),
+  /**
+   * Message splitting configuration.
+   * Controls whether and how the agent splits responses into multiple messages.
+   */
+  messageSplitting: z4.object({
+    /**
+     * Whether to allow natural message splitting.
+     * When true, the agent may split responses into multiple messages
+     * when it improves conversational flow.
+     */
+    enabled: z4.boolean(),
+    /**
+     * Custom prompt to override the default message splitting guidance.
+     * If not provided, uses sensible defaults for when to split vs. keep together.
+     */
+    prompt: z4.string().optional()
   }).optional()
 });
+var SchedulingDelaySchema = z4.object({
+  /** Time unit amount */
+  amount: z4.number(),
+  /** Time unit (e.g., "week", "weeks", "day", "days", "month", "months") */
+  unit: z4.string(),
+  /** Optional time window to constrain the delay */
+  timeWindow: z4.string().optional()
+});
+var SchedulingPatternSchema = z4.object({
+  /** Trigger name for this pattern */
+  trigger: z4.string(),
+  /** Human-readable description of when this pattern applies */
+  description: z4.string().optional(),
+  /** Example user phrases that match this pattern */
+  examples: z4.array(z4.string()).optional(),
+  /** Default delay for this pattern */
+  defaultDelay: SchedulingDelaySchema.optional()
+});
+var SchedulingBehaviorConfigSchema = z4.object({
+  /**
+   * Patterns that trigger scheduling suggestions.
+   * The agent uses these to know when to add sendAt to messages.
+   */
+  patterns: z4.array(SchedulingPatternSchema).optional(),
+  /**
+   * Default settings for scheduled messages.
+   */
+  defaults: z4.object({
+    /** Cancel scheduled message if user replies before send time (default: true) */
+    cancelOnActivity: z4.boolean().optional(),
+    /** Whether scheduled messages require approval (default: true) */
+    requiresApproval: z4.boolean().optional(),
+    /** Default time window policy to constrain all scheduled messages */
+    timeWindow: z4.string().optional().describe("Time window policy name for scheduled messages")
+  }).optional()
+});
+var BehaviorConfigV3Schema = z4.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 = z4.object({
+  /** Main system prompt with workflow instructions */
+  system: z4.string().optional(),
+  /** Injected during second pass when skills were loaded but tools not used */
   recovery: z4.string().optional(),
+  /** Injected during follow-up passes when context needs updating */
   followUp: z4.string().optional(),
-  skillDiscoveryWorkflow: z4.string().optional()
+  /** Thread list title generation (system + user template with {{var}} placeholders) */
+  titleEnrichment: z4.object({
+    system: z4.string().optional(),
+    user: z4.string().optional()
+  }).optional()
 });
-var AgentConfigV3Schema = z4.record(z4.string(), z4.unknown());
 var AgentYAMLV3Schema = z4.object({
   $schema: z4.string().optional(),
   handle: z4.string(),
@@ -438,28 +579,36 @@ var AgentYAMLV3Schema = z4.object({
   persona: PersonaV3Schema.optional(),
   // Skills - What the agent knows how to do (skills own their tools)
   skills: z4.array(SkillRefSchema).optional(),
-  // Bootstrap tools - Always-available system tools before any skill loads
-  // Examples: system:skill:load, system:message:send
-  bootstrapTools: z4.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: z4.array(ToolRefV3Schema).optional(),
-  // Events - When the agent activates
+  // Tools - Always-available tools before any skill loads
+  // Examples: system:settings:business_information:get
+  tools: z4.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()
 });
@@ -475,8 +624,9 @@ function validateAgentYAMLV3(agent) {
 }
 export {
   AGENT_SCHEMA_VERSION_V3,
-  AgentConfigV3Schema,
+  AgentToolRefSchema,
   AgentYAMLV3Schema,
+  BehaviorConfigV3Schema,
   BootstrapToolRefSchema,
   ExternalMemoryConfigSchema,
   MemoryConfigV3Schema,
@@ -485,9 +635,20 @@ export {
   PersonaVoiceV3Schema,
   PoliciesConfigV3Schema,
   PromptsConfigV3Schema,
-  ResponsePolicySchema,
+  ResponseModeSchema,
+  ResponsesBehaviorConfigSchema,
   RuntimeConfigV3Schema,
+  SchedulingBehaviorConfigSchema,
+  SchedulingDelaySchema,
+  SchedulingPatternSchema,
   SemanticMemoryConfigSchema,
+  TimeWindowBehaviorSchema,
+  TimeWindowDayOfWeekSchema,
+  TimeWindowDefaultSchema,
+  TimeWindowPoliciesSchema,
+  TimeWindowPolicySchema,
+  TimeWindowSlotAgentSchema,
+  TimeWindowTimeStampSchema,
   ToolApprovalConfigSchema,
   ToolRefV3Schema,
   ToolSandboxConfigSchema,