skedyul 1.2.44 → 1.2.50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/dist/cli/commands/event.d.ts +1 -0
  2. package/dist/cli/commands/workflows.d.ts +1 -0
  3. package/dist/cli/index.js +3928 -9110
  4. package/dist/cli/utils/auth.d.ts +4 -1
  5. package/dist/cli/utils/auth.js +32 -8
  6. package/dist/cli/utils/config.d.ts +23 -0
  7. package/dist/cli/utils/env-sync.d.ts +46 -0
  8. package/dist/cli/utils/mcp-http-client.d.ts +74 -0
  9. package/dist/cli/utils/migration-approval.d.ts +39 -0
  10. package/dist/cli/utils/mock-context.d.ts +19 -9
  11. package/dist/cli/utils/sse.d.ts +33 -0
  12. package/dist/cli/utils.d.ts +5 -1
  13. package/dist/compiler/types.d.ts +11 -9
  14. package/dist/config/app-config.d.ts +3 -1
  15. package/dist/config/schema-loader.d.ts +15 -2
  16. package/dist/config/types/index.d.ts +1 -0
  17. package/dist/config/types/model.d.ts +2 -0
  18. package/dist/config/types/page.d.ts +9 -0
  19. package/dist/config/types/signal.d.ts +20 -0
  20. package/dist/context/index.d.ts +2 -2
  21. package/dist/context/resolver.d.ts +29 -28
  22. package/dist/context/types.d.ts +195 -37
  23. package/dist/core/client.d.ts +211 -233
  24. package/dist/dedicated/server.js +252 -163
  25. package/dist/dockerfile.d.ts +1 -1
  26. package/dist/esm/index.mjs +1207 -7684
  27. package/dist/index.d.ts +11 -6
  28. package/dist/index.js +1253 -7682
  29. package/dist/scheduling/calculateWaitTime.d.ts +16 -0
  30. package/dist/scheduling/index.d.ts +11 -0
  31. package/dist/scheduling/index.js +334 -0
  32. package/dist/scheduling/index.mjs +305 -0
  33. package/dist/scheduling/isTimeInWindow.d.ts +15 -0
  34. package/dist/scheduling/types-workflow.d.ts +54 -0
  35. package/dist/scheduling/types.d.ts +166 -0
  36. package/dist/schemas/agent-schema-v3.d.ts +416 -60
  37. package/dist/schemas/agent-schema-v3.js +262 -74
  38. package/dist/schemas/agent-schema-v3.mjs +248 -72
  39. package/dist/schemas/agent-schema.js +3 -7295
  40. package/dist/schemas/agent-schema.mjs +3 -7323
  41. package/dist/schemas/crm-schema.d.ts +53 -19
  42. package/dist/schemas/index.d.ts +1 -1
  43. package/dist/schemas.d.ts +128 -40
  44. package/dist/server/route-handlers/handlers.d.ts +7 -0
  45. package/dist/server/utils/env.d.ts +9 -0
  46. package/dist/server/utils/index.d.ts +1 -0
  47. package/dist/server/utils/mcp-response.d.ts +11 -0
  48. package/dist/server.js +252 -163
  49. package/dist/serverless/server.mjs +252 -163
  50. package/dist/skills/index.d.ts +1 -1
  51. package/dist/skills/types.d.ts +35 -23
  52. package/dist/skills/types.js +10 -17
  53. package/dist/skills/types.mjs +9 -16
  54. package/dist/types/index.d.ts +3 -3
  55. package/dist/types/server.d.ts +1 -0
  56. package/dist/types/tool-context.d.ts +31 -4
  57. package/dist/types/tool-response.d.ts +2 -0
  58. package/dist/types/tool.d.ts +33 -1
  59. package/package.json +9 -2
@@ -69,8 +69,8 @@ export declare const ToolSandboxConfigSchema: z.ZodObject<{
69
69
  export type ToolSandboxConfig = z.infer<typeof ToolSandboxConfigSchema>;
70
70
  /**
71
71
  * Tool reference with optional approval and sandbox configuration
72
- * @deprecated Root-level tools on agents are deprecated. Use skills to own tools.
73
- * For always-available system tools, use bootstrapTools instead.
72
+ * @deprecated This schema is deprecated and kept only for backward compatibility.
73
+ * Use skills to own tools instead.
74
74
  */
75
75
  export declare const ToolRefV3Schema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
76
76
  tool: z.ZodString;
@@ -86,16 +86,28 @@ export declare const ToolRefV3Schema: z.ZodUnion<readonly [z.ZodString, z.ZodObj
86
86
  }, z.core.$strip>]>;
87
87
  export type ToolRefV3 = z.infer<typeof ToolRefV3Schema>;
88
88
  /**
89
- * Bootstrap tool reference - minimal config for always-available system tools
89
+ * Agent tool reference - minimal config for always-available tools
90
90
  * These tools are available before any skill is loaded (e.g., system:skill:load)
91
91
  */
92
+ export declare const AgentToolRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
93
+ tool: z.ZodString;
94
+ description: z.ZodOptional<z.ZodString>;
95
+ }, z.core.$strip>]>;
96
+ export type AgentToolRef = z.infer<typeof AgentToolRefSchema>;
97
+ /**
98
+ * @deprecated Use AgentToolRefSchema instead. This is kept for backward compatibility.
99
+ */
92
100
  export declare const BootstrapToolRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
93
101
  tool: z.ZodString;
94
102
  description: z.ZodOptional<z.ZodString>;
95
103
  }, z.core.$strip>]>;
96
- export type BootstrapToolRef = z.infer<typeof BootstrapToolRefSchema>;
104
+ /**
105
+ * @deprecated Use AgentToolRef instead. This is kept for backward compatibility.
106
+ */
107
+ export type BootstrapToolRef = AgentToolRef;
97
108
  /**
98
109
  * Memory configuration for working memory
110
+ * @deprecated Not yet implemented - this is a planned feature. Fields are accepted but not used at runtime.
99
111
  */
100
112
  export declare const WorkingMemoryConfigSchema: z.ZodObject<{
101
113
  strategy: z.ZodOptional<z.ZodEnum<{
@@ -109,6 +121,7 @@ export declare const WorkingMemoryConfigSchema: z.ZodObject<{
109
121
  export type WorkingMemoryConfig = z.infer<typeof WorkingMemoryConfigSchema>;
110
122
  /**
111
123
  * Memory configuration for external data
124
+ * @deprecated Not yet implemented - this is a planned feature. Fields are accepted but not used at runtime.
112
125
  */
113
126
  export declare const ExternalMemoryConfigSchema: z.ZodObject<{
114
127
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -117,6 +130,7 @@ export declare const ExternalMemoryConfigSchema: z.ZodObject<{
117
130
  export type ExternalMemoryConfig = z.infer<typeof ExternalMemoryConfigSchema>;
118
131
  /**
119
132
  * Memory configuration for semantic search
133
+ * @deprecated Not yet implemented - this is a planned feature. Fields are accepted but not used at runtime.
120
134
  */
121
135
  export declare const SemanticMemoryConfigSchema: z.ZodObject<{
122
136
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -130,6 +144,7 @@ export declare const SemanticMemoryConfigSchema: z.ZodObject<{
130
144
  export type SemanticMemoryConfig = z.infer<typeof SemanticMemoryConfigSchema>;
131
145
  /**
132
146
  * Full memory configuration
147
+ * @deprecated Not yet implemented - this is a planned feature. Fields are accepted but not used at runtime.
133
148
  */
134
149
  export declare const MemoryConfigV3Schema: z.ZodObject<{
135
150
  working: z.ZodOptional<z.ZodObject<{
@@ -160,55 +175,308 @@ export declare const MemoryConfigV3Schema: z.ZodObject<{
160
175
  }, z.core.$strip>;
161
176
  export type MemoryConfigV3 = z.infer<typeof MemoryConfigV3Schema>;
162
177
  /**
163
- * Policy configuration for response approval
164
- */
165
- export declare const ResponsePolicySchema: z.ZodObject<{
166
- requiresApproval: z.ZodOptional<z.ZodBoolean>;
167
- requiresApprovalIf: z.ZodOptional<z.ZodArray<z.ZodString>>;
168
- }, z.core.$strip>;
169
- export type ResponsePolicy = z.infer<typeof ResponsePolicySchema>;
170
- /**
171
- * Full policies configuration
178
+ * Policies configuration.
179
+ * Business constraints belong in `prompts.system`. Message/tool approval
180
+ * flags are enforced by the thread agent workflow after each run.
172
181
  */
173
182
  export declare const PoliciesConfigV3Schema: z.ZodObject<{
174
- response: z.ZodOptional<z.ZodObject<{
175
- requiresApproval: z.ZodOptional<z.ZodBoolean>;
176
- requiresApprovalIf: z.ZodOptional<z.ZodArray<z.ZodString>>;
183
+ messages: z.ZodOptional<z.ZodObject<{
184
+ send: z.ZodOptional<z.ZodObject<{
185
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
186
+ }, z.core.$strip>>;
187
+ schedule: z.ZodOptional<z.ZodObject<{
188
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
189
+ }, z.core.$strip>>;
190
+ }, z.core.$strip>>;
191
+ tools: z.ZodOptional<z.ZodObject<{
192
+ externalRequiresApproval: z.ZodOptional<z.ZodBoolean>;
193
+ systemRequiresApproval: z.ZodOptional<z.ZodBoolean>;
177
194
  }, z.core.$strip>>;
178
- rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
179
195
  }, z.core.$strip>;
180
196
  export type PoliciesConfigV3 = z.infer<typeof PoliciesConfigV3Schema>;
181
197
  /**
182
198
  * Runtime configuration
199
+ * `model` selects the main reasoning LLM; `personaModel` selects the model
200
+ * used to apply persona voice/style to outbound messages.
183
201
  */
184
202
  export declare const RuntimeConfigV3Schema: z.ZodObject<{
185
203
  model: z.ZodOptional<z.ZodString>;
186
- timeout: z.ZodOptional<z.ZodString>;
187
- timezone: z.ZodOptional<z.ZodString>;
188
- retry: z.ZodOptional<z.ZodObject<{
189
- attempts: z.ZodOptional<z.ZodNumber>;
190
- backoff: z.ZodOptional<z.ZodEnum<{
191
- linear: "linear";
192
- exponential: "exponential";
204
+ personaModel: z.ZodOptional<z.ZodString>;
205
+ }, z.core.$strip>;
206
+ export type RuntimeConfigV3 = z.infer<typeof RuntimeConfigV3Schema>;
207
+ /**
208
+ * Time stamp for window definitions.
209
+ * Can be a simple hour (0-23) or an object with hour/minute.
210
+ */
211
+ export declare const TimeWindowTimeStampSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
212
+ hour: z.ZodNumber;
213
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
214
+ }, z.core.$strip>]>;
215
+ export type TimeWindowTimeStamp = z.infer<typeof TimeWindowTimeStampSchema>;
216
+ /**
217
+ * Day of week for window definitions.
218
+ */
219
+ export declare const TimeWindowDayOfWeekSchema: z.ZodEnum<{
220
+ monday: "monday";
221
+ tuesday: "tuesday";
222
+ wednesday: "wednesday";
223
+ thursday: "thursday";
224
+ friday: "friday";
225
+ saturday: "saturday";
226
+ sunday: "sunday";
227
+ }>;
228
+ export type TimeWindowDayOfWeek = z.infer<typeof TimeWindowDayOfWeekSchema>;
229
+ /**
230
+ * A time window slot definition (e.g., 9am-5pm Monday-Friday).
231
+ */
232
+ export declare const TimeWindowSlotAgentSchema: z.ZodObject<{
233
+ startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
234
+ hour: z.ZodNumber;
235
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
236
+ }, z.core.$strip>]>;
237
+ endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
238
+ hour: z.ZodNumber;
239
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
240
+ }, z.core.$strip>]>;
241
+ days: z.ZodArray<z.ZodEnum<{
242
+ monday: "monday";
243
+ tuesday: "tuesday";
244
+ wednesday: "wednesday";
245
+ thursday: "thursday";
246
+ friday: "friday";
247
+ saturday: "saturday";
248
+ sunday: "sunday";
249
+ }>>;
250
+ }, z.core.$strip>;
251
+ export type TimeWindowSlotAgent = z.infer<typeof TimeWindowSlotAgentSchema>;
252
+ /**
253
+ * Response mode for time window behavior.
254
+ * - immediate: Normal immediate response
255
+ * - ack_and_schedule: Brief ack now + schedule full response for later
256
+ * - schedule_only: No immediate response, schedule everything for later
257
+ */
258
+ export declare const ResponseModeSchema: z.ZodEnum<{
259
+ immediate: "immediate";
260
+ ack_and_schedule: "ack_and_schedule";
261
+ schedule_only: "schedule_only";
262
+ }>;
263
+ export type ResponseMode = z.infer<typeof ResponseModeSchema>;
264
+ /**
265
+ * Behavior configuration for a time window.
266
+ * Controls how the agent responds when a message arrives during this window.
267
+ */
268
+ export declare const TimeWindowBehaviorSchema: z.ZodObject<{
269
+ responseMode: z.ZodEnum<{
270
+ immediate: "immediate";
271
+ ack_and_schedule: "ack_and_schedule";
272
+ schedule_only: "schedule_only";
273
+ }>;
274
+ prompt: z.ZodOptional<z.ZodString>;
275
+ scheduleFor: z.ZodOptional<z.ZodString>;
276
+ }, z.core.$strip>;
277
+ export type TimeWindowBehavior = z.infer<typeof TimeWindowBehaviorSchema>;
278
+ /**
279
+ * A named time window policy.
280
+ * Defines when the window is active and how the agent behaves during it.
281
+ */
282
+ export declare const TimeWindowPolicySchema: z.ZodObject<{
283
+ timezone: z.ZodString;
284
+ windows: z.ZodArray<z.ZodObject<{
285
+ startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
286
+ hour: z.ZodNumber;
287
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
288
+ }, z.core.$strip>]>;
289
+ endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
290
+ hour: z.ZodNumber;
291
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
292
+ }, z.core.$strip>]>;
293
+ days: z.ZodArray<z.ZodEnum<{
294
+ monday: "monday";
295
+ tuesday: "tuesday";
296
+ wednesday: "wednesday";
297
+ thursday: "thursday";
298
+ friday: "friday";
299
+ saturday: "saturday";
300
+ sunday: "sunday";
193
301
  }>>;
194
302
  }, z.core.$strip>>;
303
+ behavior: z.ZodOptional<z.ZodObject<{
304
+ responseMode: z.ZodEnum<{
305
+ immediate: "immediate";
306
+ ack_and_schedule: "ack_and_schedule";
307
+ schedule_only: "schedule_only";
308
+ }>;
309
+ prompt: z.ZodOptional<z.ZodString>;
310
+ scheduleFor: z.ZodOptional<z.ZodString>;
311
+ }, z.core.$strip>>;
195
312
  }, z.core.$strip>;
196
- export type RuntimeConfigV3 = z.infer<typeof RuntimeConfigV3Schema>;
313
+ export type TimeWindowPolicy = z.infer<typeof TimeWindowPolicySchema>;
314
+ /**
315
+ * Collection of named time window policies.
316
+ * Keys are policy names (e.g., "business_hours", "after_work").
317
+ */
318
+ export declare const TimeWindowPoliciesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
319
+ timezone: z.ZodString;
320
+ windows: z.ZodArray<z.ZodObject<{
321
+ startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
322
+ hour: z.ZodNumber;
323
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
324
+ }, z.core.$strip>]>;
325
+ endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
326
+ hour: z.ZodNumber;
327
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
328
+ }, z.core.$strip>]>;
329
+ days: z.ZodArray<z.ZodEnum<{
330
+ monday: "monday";
331
+ tuesday: "tuesday";
332
+ wednesday: "wednesday";
333
+ thursday: "thursday";
334
+ friday: "friday";
335
+ saturday: "saturday";
336
+ sunday: "sunday";
337
+ }>>;
338
+ }, z.core.$strip>>;
339
+ behavior: z.ZodOptional<z.ZodObject<{
340
+ responseMode: z.ZodEnum<{
341
+ immediate: "immediate";
342
+ ack_and_schedule: "ack_and_schedule";
343
+ schedule_only: "schedule_only";
344
+ }>;
345
+ prompt: z.ZodOptional<z.ZodString>;
346
+ scheduleFor: z.ZodOptional<z.ZodString>;
347
+ }, z.core.$strip>>;
348
+ }, z.core.$strip>>;
349
+ export type TimeWindowPolicies = z.infer<typeof TimeWindowPoliciesSchema>;
350
+ /**
351
+ * Default time window behavior.
352
+ * Applied when no defined window matches the current time.
353
+ */
354
+ export declare const TimeWindowDefaultSchema: z.ZodObject<{
355
+ responseMode: z.ZodEnum<{
356
+ immediate: "immediate";
357
+ ack_and_schedule: "ack_and_schedule";
358
+ schedule_only: "schedule_only";
359
+ }>;
360
+ prompt: z.ZodOptional<z.ZodString>;
361
+ scheduleFor: z.ZodOptional<z.ZodString>;
362
+ }, z.core.$strip>;
363
+ export type TimeWindowDefault = z.infer<typeof TimeWindowDefaultSchema>;
364
+ /**
365
+ * Response behavior configuration
366
+ *
367
+ * Controls how agents send messages via explicit tool calls.
368
+ * - Intermediate messages: Progress updates ("Checking the calendar...")
369
+ * - Final message: Completes the user's request (always reserved)
370
+ * - Scheduled messages: Future follow-ups
371
+ */
372
+ export declare const ResponsesBehaviorConfigSchema: z.ZodObject<{
373
+ maxImmediate: z.ZodOptional<z.ZodNumber>;
374
+ maxScheduled: z.ZodOptional<z.ZodNumber>;
375
+ maxIntermediate: z.ZodOptional<z.ZodNumber>;
376
+ requireFinal: z.ZodOptional<z.ZodBoolean>;
377
+ allowSchedule: z.ZodOptional<z.ZodBoolean>;
378
+ messageSplitting: z.ZodOptional<z.ZodObject<{
379
+ enabled: z.ZodBoolean;
380
+ prompt: z.ZodOptional<z.ZodString>;
381
+ }, z.core.$strip>>;
382
+ }, z.core.$strip>;
383
+ export type ResponsesBehaviorConfig = z.infer<typeof ResponsesBehaviorConfigSchema>;
384
+ /**
385
+ * Structured default delay for scheduling patterns.
386
+ * Matches the sendAt format used in message tools.
387
+ */
388
+ export declare const SchedulingDelaySchema: z.ZodObject<{
389
+ amount: z.ZodNumber;
390
+ unit: z.ZodString;
391
+ timeWindow: z.ZodOptional<z.ZodString>;
392
+ }, z.core.$strip>;
393
+ export type SchedulingDelay = z.infer<typeof SchedulingDelaySchema>;
394
+ /**
395
+ * Scheduling pattern configuration.
396
+ * Defines when the agent should schedule follow-up messages.
397
+ */
398
+ export declare const SchedulingPatternSchema: z.ZodObject<{
399
+ trigger: z.ZodString;
400
+ description: z.ZodOptional<z.ZodString>;
401
+ examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
402
+ defaultDelay: z.ZodOptional<z.ZodObject<{
403
+ amount: z.ZodNumber;
404
+ unit: z.ZodString;
405
+ timeWindow: z.ZodOptional<z.ZodString>;
406
+ }, z.core.$strip>>;
407
+ }, z.core.$strip>;
408
+ export type SchedulingPattern = z.infer<typeof SchedulingPatternSchema>;
409
+ /**
410
+ * Scheduling behavior configuration.
411
+ * Controls when and how the agent schedules follow-up messages.
412
+ */
413
+ export declare const SchedulingBehaviorConfigSchema: z.ZodObject<{
414
+ patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
415
+ trigger: z.ZodString;
416
+ description: z.ZodOptional<z.ZodString>;
417
+ examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
418
+ defaultDelay: z.ZodOptional<z.ZodObject<{
419
+ amount: z.ZodNumber;
420
+ unit: z.ZodString;
421
+ timeWindow: z.ZodOptional<z.ZodString>;
422
+ }, z.core.$strip>>;
423
+ }, z.core.$strip>>>;
424
+ defaults: z.ZodOptional<z.ZodObject<{
425
+ cancelOnActivity: z.ZodOptional<z.ZodBoolean>;
426
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
427
+ timeWindow: z.ZodOptional<z.ZodString>;
428
+ }, z.core.$strip>>;
429
+ }, z.core.$strip>;
430
+ export type SchedulingBehaviorConfig = z.infer<typeof SchedulingBehaviorConfigSchema>;
431
+ /**
432
+ * Behavior configuration for agent runtime behavior.
433
+ * These settings control how the agent operates and responds.
434
+ */
435
+ export declare const BehaviorConfigV3Schema: z.ZodObject<{
436
+ responses: z.ZodOptional<z.ZodObject<{
437
+ maxImmediate: z.ZodOptional<z.ZodNumber>;
438
+ maxScheduled: z.ZodOptional<z.ZodNumber>;
439
+ maxIntermediate: z.ZodOptional<z.ZodNumber>;
440
+ requireFinal: z.ZodOptional<z.ZodBoolean>;
441
+ allowSchedule: z.ZodOptional<z.ZodBoolean>;
442
+ messageSplitting: z.ZodOptional<z.ZodObject<{
443
+ enabled: z.ZodBoolean;
444
+ prompt: z.ZodOptional<z.ZodString>;
445
+ }, z.core.$strip>>;
446
+ }, z.core.$strip>>;
447
+ scheduling: z.ZodOptional<z.ZodObject<{
448
+ patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
449
+ trigger: z.ZodString;
450
+ description: z.ZodOptional<z.ZodString>;
451
+ examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
452
+ defaultDelay: z.ZodOptional<z.ZodObject<{
453
+ amount: z.ZodNumber;
454
+ unit: z.ZodString;
455
+ timeWindow: z.ZodOptional<z.ZodString>;
456
+ }, z.core.$strip>>;
457
+ }, z.core.$strip>>>;
458
+ defaults: z.ZodOptional<z.ZodObject<{
459
+ cancelOnActivity: z.ZodOptional<z.ZodBoolean>;
460
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
461
+ timeWindow: z.ZodOptional<z.ZodString>;
462
+ }, z.core.$strip>>;
463
+ }, z.core.$strip>>;
464
+ }, z.core.$strip>;
465
+ export type BehaviorConfigV3 = z.infer<typeof BehaviorConfigV3Schema>;
197
466
  /**
198
467
  * Prompts configuration for agent-specific prompt injections.
199
468
  * These prompts are injected during specific runtime phases.
200
469
  */
201
470
  export declare const PromptsConfigV3Schema: z.ZodObject<{
471
+ system: z.ZodOptional<z.ZodString>;
202
472
  recovery: z.ZodOptional<z.ZodString>;
203
473
  followUp: z.ZodOptional<z.ZodString>;
204
- skillDiscoveryWorkflow: z.ZodOptional<z.ZodString>;
474
+ titleEnrichment: z.ZodOptional<z.ZodObject<{
475
+ system: z.ZodOptional<z.ZodString>;
476
+ user: z.ZodOptional<z.ZodString>;
477
+ }, z.core.$strip>>;
205
478
  }, z.core.$strip>;
206
479
  export type PromptsConfigV3 = z.infer<typeof PromptsConfigV3Schema>;
207
- /**
208
- * Agent configuration (business-specific settings)
209
- */
210
- export declare const AgentConfigV3Schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
211
- export type AgentConfigV3 = z.infer<typeof AgentConfigV3Schema>;
212
480
  /**
213
481
  * Full Agent YAML v3 Schema
214
482
  *
@@ -218,8 +486,7 @@ export type AgentConfigV3 = z.infer<typeof AgentConfigV3Schema>;
218
486
  * Tool Ownership Model:
219
487
  * - Skills own their tools (defined in skill files with full config)
220
488
  * - Agents reference skills, not individual tools
221
- * - bootstrapTools: Always-available system tools (e.g., system:skill:load)
222
- * - tools: DEPRECATED - kept for backward compatibility only
489
+ * - tools: Always-available tools before any skill loads (e.g., system:settings:business_information:get)
223
490
  */
224
491
  export declare const AgentYAMLV3Schema: z.ZodObject<{
225
492
  $schema: z.ZodOptional<z.ZodString>;
@@ -244,6 +511,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
244
511
  skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
245
512
  skill: z.ZodString;
246
513
  description: z.ZodOptional<z.ZodString>;
514
+ alwaysLoad: z.ZodOptional<z.ZodBoolean>;
247
515
  version: z.ZodOptional<z.ZodNumber>;
248
516
  versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
249
517
  version: z.ZodNumber;
@@ -252,21 +520,9 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
252
520
  instructions: z.ZodOptional<z.ZodString>;
253
521
  enabled: z.ZodOptional<z.ZodBoolean>;
254
522
  }, z.core.$strip>]>>>;
255
- bootstrapTools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
256
- tool: z.ZodString;
257
- description: z.ZodOptional<z.ZodString>;
258
- }, z.core.$strip>]>>>;
259
523
  tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
260
524
  tool: z.ZodString;
261
525
  description: z.ZodOptional<z.ZodString>;
262
- approval: z.ZodOptional<z.ZodObject<{
263
- required: z.ZodOptional<z.ZodBoolean>;
264
- requiredIf: z.ZodOptional<z.ZodArray<z.ZodString>>;
265
- }, z.core.$strip>>;
266
- sandbox: z.ZodOptional<z.ZodObject<{
267
- mock: z.ZodOptional<z.ZodUnknown>;
268
- }, z.core.$strip>>;
269
- overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
270
526
  }, z.core.$strip>]>>>;
271
527
  events: z.ZodOptional<z.ZodObject<{
272
528
  subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
@@ -364,30 +620,102 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
364
620
  }, z.core.$strip>>;
365
621
  }, z.core.$strip>>;
366
622
  policies: z.ZodOptional<z.ZodObject<{
367
- response: z.ZodOptional<z.ZodObject<{
368
- requiresApproval: z.ZodOptional<z.ZodBoolean>;
369
- requiresApprovalIf: z.ZodOptional<z.ZodArray<z.ZodString>>;
623
+ messages: z.ZodOptional<z.ZodObject<{
624
+ send: z.ZodOptional<z.ZodObject<{
625
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
626
+ }, z.core.$strip>>;
627
+ schedule: z.ZodOptional<z.ZodObject<{
628
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
629
+ }, z.core.$strip>>;
630
+ }, z.core.$strip>>;
631
+ tools: z.ZodOptional<z.ZodObject<{
632
+ externalRequiresApproval: z.ZodOptional<z.ZodBoolean>;
633
+ systemRequiresApproval: z.ZodOptional<z.ZodBoolean>;
370
634
  }, z.core.$strip>>;
371
- rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
372
635
  }, z.core.$strip>>;
373
636
  runtime: z.ZodOptional<z.ZodObject<{
374
637
  model: z.ZodOptional<z.ZodString>;
375
- timeout: z.ZodOptional<z.ZodString>;
376
- timezone: z.ZodOptional<z.ZodString>;
377
- retry: z.ZodOptional<z.ZodObject<{
378
- attempts: z.ZodOptional<z.ZodNumber>;
379
- backoff: z.ZodOptional<z.ZodEnum<{
380
- linear: "linear";
381
- exponential: "exponential";
382
- }>>;
383
- }, z.core.$strip>>;
638
+ personaModel: z.ZodOptional<z.ZodString>;
384
639
  }, z.core.$strip>>;
385
640
  prompts: z.ZodOptional<z.ZodObject<{
641
+ system: z.ZodOptional<z.ZodString>;
386
642
  recovery: z.ZodOptional<z.ZodString>;
387
643
  followUp: z.ZodOptional<z.ZodString>;
388
- skillDiscoveryWorkflow: z.ZodOptional<z.ZodString>;
644
+ titleEnrichment: z.ZodOptional<z.ZodObject<{
645
+ system: z.ZodOptional<z.ZodString>;
646
+ user: z.ZodOptional<z.ZodString>;
647
+ }, z.core.$strip>>;
648
+ }, z.core.$strip>>;
649
+ behavior: z.ZodOptional<z.ZodObject<{
650
+ responses: z.ZodOptional<z.ZodObject<{
651
+ maxImmediate: z.ZodOptional<z.ZodNumber>;
652
+ maxScheduled: z.ZodOptional<z.ZodNumber>;
653
+ maxIntermediate: z.ZodOptional<z.ZodNumber>;
654
+ requireFinal: z.ZodOptional<z.ZodBoolean>;
655
+ allowSchedule: z.ZodOptional<z.ZodBoolean>;
656
+ messageSplitting: z.ZodOptional<z.ZodObject<{
657
+ enabled: z.ZodBoolean;
658
+ prompt: z.ZodOptional<z.ZodString>;
659
+ }, z.core.$strip>>;
660
+ }, z.core.$strip>>;
661
+ scheduling: z.ZodOptional<z.ZodObject<{
662
+ patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
663
+ trigger: z.ZodString;
664
+ description: z.ZodOptional<z.ZodString>;
665
+ examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
666
+ defaultDelay: z.ZodOptional<z.ZodObject<{
667
+ amount: z.ZodNumber;
668
+ unit: z.ZodString;
669
+ timeWindow: z.ZodOptional<z.ZodString>;
670
+ }, z.core.$strip>>;
671
+ }, z.core.$strip>>>;
672
+ defaults: z.ZodOptional<z.ZodObject<{
673
+ cancelOnActivity: z.ZodOptional<z.ZodBoolean>;
674
+ requiresApproval: z.ZodOptional<z.ZodBoolean>;
675
+ timeWindow: z.ZodOptional<z.ZodString>;
676
+ }, z.core.$strip>>;
677
+ }, z.core.$strip>>;
678
+ }, z.core.$strip>>;
679
+ timeWindows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
680
+ timezone: z.ZodString;
681
+ windows: z.ZodArray<z.ZodObject<{
682
+ startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
683
+ hour: z.ZodNumber;
684
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
685
+ }, z.core.$strip>]>;
686
+ endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
687
+ hour: z.ZodNumber;
688
+ minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
689
+ }, z.core.$strip>]>;
690
+ days: z.ZodArray<z.ZodEnum<{
691
+ monday: "monday";
692
+ tuesday: "tuesday";
693
+ wednesday: "wednesday";
694
+ thursday: "thursday";
695
+ friday: "friday";
696
+ saturday: "saturday";
697
+ sunday: "sunday";
698
+ }>>;
699
+ }, z.core.$strip>>;
700
+ behavior: z.ZodOptional<z.ZodObject<{
701
+ responseMode: z.ZodEnum<{
702
+ immediate: "immediate";
703
+ ack_and_schedule: "ack_and_schedule";
704
+ schedule_only: "schedule_only";
705
+ }>;
706
+ prompt: z.ZodOptional<z.ZodString>;
707
+ scheduleFor: z.ZodOptional<z.ZodString>;
708
+ }, z.core.$strip>>;
709
+ }, z.core.$strip>>>;
710
+ timeWindowDefault: z.ZodOptional<z.ZodObject<{
711
+ responseMode: z.ZodEnum<{
712
+ immediate: "immediate";
713
+ ack_and_schedule: "ack_and_schedule";
714
+ schedule_only: "schedule_only";
715
+ }>;
716
+ prompt: z.ZodOptional<z.ZodString>;
717
+ scheduleFor: z.ZodOptional<z.ZodString>;
389
718
  }, z.core.$strip>>;
390
- config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
391
719
  sandbox: z.ZodOptional<z.ZodObject<{
392
720
  enabled: z.ZodOptional<z.ZodBoolean>;
393
721
  mockContext: z.ZodOptional<z.ZodObject<{
@@ -418,6 +746,34 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
418
746
  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
419
747
  }, z.core.$strip>>>;
420
748
  }, z.core.$strip>>;
749
+ context: z.ZodOptional<z.ZodObject<{
750
+ sender: z.ZodObject<{
751
+ kind: z.ZodEnum<{
752
+ contact: "contact";
753
+ member: "member";
754
+ }>;
755
+ displayName: z.ZodOptional<z.ZodString>;
756
+ role: z.ZodOptional<z.ZodString>;
757
+ permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
758
+ contact: z.ZodOptional<z.ZodObject<{
759
+ id: z.ZodOptional<z.ZodString>;
760
+ name: z.ZodOptional<z.ZodString>;
761
+ subscription: z.ZodOptional<z.ZodObject<{
762
+ identifierValue: z.ZodString;
763
+ channelHandle: z.ZodOptional<z.ZodString>;
764
+ }, z.core.$strip>>;
765
+ associations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
766
+ id: z.ZodOptional<z.ZodString>;
767
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
768
+ }, z.core.$strip>>>;
769
+ }, z.core.$strip>>;
770
+ }, z.core.$strip>;
771
+ contexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
772
+ handle: z.ZodString;
773
+ model: z.ZodString;
774
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
775
+ }, z.core.$strip>>>;
776
+ }, z.core.$strip>>;
421
777
  }, z.core.$strip>>;
422
778
  }, z.core.$strip>;
423
779
  export type AgentYAMLV3 = z.infer<typeof AgentYAMLV3Schema>;