@elqnt/agents 2.1.0 → 3.0.0

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 (50) hide show
  1. package/dist/agent-models-BdtFKjV3.d.mts +2398 -0
  2. package/dist/agent-models-BdtFKjV3.d.ts +2398 -0
  3. package/dist/api/index.d.mts +60 -2
  4. package/dist/api/index.d.ts +60 -2
  5. package/dist/api/index.js +38 -2
  6. package/dist/api/index.js.map +1 -1
  7. package/dist/api/index.mjs +37 -1
  8. package/dist/api/server.d.mts +146 -0
  9. package/dist/api/server.d.ts +146 -0
  10. package/dist/api/server.js +226 -0
  11. package/dist/api/server.js.map +1 -0
  12. package/dist/api/server.mjs +226 -0
  13. package/dist/api/server.mjs.map +1 -0
  14. package/dist/chunk-44A5L2IY.js +491 -0
  15. package/dist/chunk-44A5L2IY.js.map +1 -0
  16. package/dist/{chunk-YYXYKVF4.js → chunk-ADOBVUUS.js} +104 -2
  17. package/dist/chunk-ADOBVUUS.js.map +1 -0
  18. package/dist/{chunk-IDBBO3QJ.mjs → chunk-EUELXX27.mjs} +136 -2
  19. package/dist/chunk-EUELXX27.mjs.map +1 -0
  20. package/dist/{chunk-LRVOTC2M.mjs → chunk-O3FM26FT.mjs} +104 -2
  21. package/dist/chunk-O3FM26FT.mjs.map +1 -0
  22. package/dist/chunk-RTUQ7WKT.mjs +434 -0
  23. package/dist/chunk-RTUQ7WKT.mjs.map +1 -0
  24. package/dist/chunk-VVYOTEM2.js +434 -0
  25. package/dist/chunk-VVYOTEM2.js.map +1 -0
  26. package/dist/hooks/index.d.mts +134 -5
  27. package/dist/hooks/index.d.ts +134 -5
  28. package/dist/hooks/index.js +15 -3
  29. package/dist/hooks/index.js.map +1 -1
  30. package/dist/hooks/index.mjs +16 -4
  31. package/dist/index.d.mts +4 -3
  32. package/dist/index.d.ts +4 -3
  33. package/dist/index.js +180 -4
  34. package/dist/index.js.map +1 -1
  35. package/dist/index.mjs +181 -5
  36. package/dist/models/index.d.mts +713 -1995
  37. package/dist/models/index.d.ts +713 -1995
  38. package/dist/models/index.js +130 -2
  39. package/dist/models/index.js.map +1 -1
  40. package/dist/models/index.mjs +129 -1
  41. package/package.json +11 -6
  42. package/dist/chunk-EQBMH6T6.mjs +0 -398
  43. package/dist/chunk-EQBMH6T6.mjs.map +0 -1
  44. package/dist/chunk-IDBBO3QJ.mjs.map +0 -1
  45. package/dist/chunk-LRVOTC2M.mjs.map +0 -1
  46. package/dist/chunk-O77IWBPZ.js +0 -357
  47. package/dist/chunk-O77IWBPZ.js.map +0 -1
  48. package/dist/chunk-WL5S56WV.js +0 -398
  49. package/dist/chunk-WL5S56WV.js.map +0 -1
  50. package/dist/chunk-YYXYKVF4.js.map +0 -1
@@ -0,0 +1,2398 @@
1
+ import { JSONSchema, ProductNameTS, ResponseMetadata } from '@elqnt/types';
2
+
3
+ /**
4
+ * AgentContext accumulates meaningful state from agentic tool executions.
5
+ * It provides a structured, schema-driven view of what happened during a chat
6
+ * and what meaningful data was extracted.
7
+ * Stored in: agent_contexts_org_{orgId} with key: {agentId}:{chatKey}
8
+ */
9
+ interface AgentContext {
10
+ /**
11
+ * Identity - used for storage key and cross-references
12
+ */
13
+ orgId: string;
14
+ agentId: string;
15
+ chatKey: string;
16
+ /**
17
+ * Schema defines the shape of accumulated variables
18
+ * Tools contribute to this schema as they execute
19
+ */
20
+ schema: any;
21
+ /**
22
+ * Variables is the merged view of all important outputs
23
+ * This is what gets displayed in the "Agent Context" panel
24
+ */
25
+ variables: {
26
+ [key: string]: any;
27
+ };
28
+ /**
29
+ * Executions tracks each tool call with full input/output
30
+ * Similar to NodeStates in workflow engine
31
+ */
32
+ executions: AgentExecution[];
33
+ /**
34
+ * PendingPlan holds an execution plan awaiting user approval
35
+ * Part of the Plan → Approve → Execute flow
36
+ */
37
+ pendingPlan?: ExecutionPlan;
38
+ /**
39
+ * CompletedPlans holds historical plans (for reference/audit)
40
+ */
41
+ completedPlans?: ExecutionPlan[];
42
+ /**
43
+ * Tracking
44
+ */
45
+ createdAt: number;
46
+ lastUpdated: number;
47
+ /**
48
+ * Size management
49
+ */
50
+ archivedExecutionCount?: number;
51
+ }
52
+ /**
53
+ * AgentExecution represents one tool call during the agentic loop.
54
+ * Similar to NodeState in the workflow engine.
55
+ */
56
+ interface AgentExecution {
57
+ /**
58
+ * Identity
59
+ */
60
+ id: string;
61
+ toolName: string;
62
+ toolId?: string;
63
+ /**
64
+ * Display
65
+ */
66
+ title: string;
67
+ type: string;
68
+ icon?: string;
69
+ /**
70
+ * Status
71
+ */
72
+ status: ExecutionStatusTS;
73
+ error?: string;
74
+ /**
75
+ * Schema-driven Input/Output (like NodeInput/NodeOutput)
76
+ */
77
+ inputSchema?: any;
78
+ input: {
79
+ [key: string]: any;
80
+ };
81
+ outputSchema?: any;
82
+ output?: {
83
+ [key: string]: any;
84
+ };
85
+ /**
86
+ * Merge Configuration - how this execution's output merges into Variables
87
+ */
88
+ mergeConfig?: MergeConfig;
89
+ /**
90
+ * Timing
91
+ */
92
+ startedAt: number;
93
+ completedAt?: number;
94
+ duration?: number;
95
+ }
96
+ /**
97
+ * ExecutionStatus represents the status of a tool execution
98
+ */
99
+ type ExecutionStatus = string;
100
+ declare const ExecutionStatusPending: ExecutionStatus;
101
+ declare const ExecutionStatusRunning: ExecutionStatus;
102
+ declare const ExecutionStatusCompleted: ExecutionStatus;
103
+ declare const ExecutionStatusFailed: ExecutionStatus;
104
+ declare const ExecutionStatusSkipped: ExecutionStatus;
105
+ type ExecutionStatusTS = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
106
+ /**
107
+ * MergeConfig defines how tool output gets merged into AgentContext.Variables
108
+ */
109
+ interface MergeConfig {
110
+ /**
111
+ * Keys to extract from output and merge into variables
112
+ */
113
+ mergeKeys?: string[];
114
+ /**
115
+ * Target path in variables
116
+ * Examples: "shipperName" (direct), "documents[]" (append to array)
117
+ */
118
+ targetPath?: string;
119
+ /**
120
+ * Strategy: "replace" | "merge" | "append"
121
+ * - replace: overwrite the target path
122
+ * - merge: deep merge objects
123
+ * - append: append to array (use with "path[]" syntax)
124
+ */
125
+ strategy?: MergeStrategy;
126
+ }
127
+ /**
128
+ * MergeStrategy defines how values are merged into variables
129
+ */
130
+ type MergeStrategy = string;
131
+ declare const MergeStrategyReplace: MergeStrategy;
132
+ declare const MergeStrategyMerge: MergeStrategy;
133
+ declare const MergeStrategyAppend: MergeStrategy;
134
+ type MergeStrategyTS = 'replace' | 'merge' | 'append';
135
+ /**
136
+ * AgentContextConfig is defined on the Agent to configure how context is managed
137
+ */
138
+ interface AgentContextConfig {
139
+ /**
140
+ * Base schema - defines the expected shape of accumulated context
141
+ */
142
+ schema: any;
143
+ /**
144
+ * Default/initial values when context is created
145
+ */
146
+ defaultVariables?: {
147
+ [key: string]: any;
148
+ };
149
+ /**
150
+ * Whether to extend schema at runtime when new keys appear
151
+ */
152
+ allowSchemaExtension: boolean;
153
+ }
154
+ /**
155
+ * Constants for size management
156
+ */
157
+ declare const MaxExecutions = 100;
158
+ /**
159
+ * Constants for size management
160
+ */
161
+ declare const ExecutionTTLHours = 72;
162
+ /**
163
+ * ExecutionPlan represents a planned sequence of tool executions
164
+ * that requires user approval before execution.
165
+ */
166
+ interface ExecutionPlan {
167
+ /**
168
+ * Identity
169
+ */
170
+ id: string;
171
+ chatKey: string;
172
+ agentId: string;
173
+ orgId: string;
174
+ /**
175
+ * Plan metadata
176
+ */
177
+ title: string;
178
+ description: string;
179
+ createdAt: number;
180
+ /**
181
+ * Planned steps
182
+ */
183
+ steps: PlannedStep[];
184
+ /**
185
+ * Status tracking
186
+ */
187
+ status: PlanStatusTS;
188
+ approvedAt?: number;
189
+ approvedBy?: string;
190
+ rejectedAt?: number;
191
+ rejectionReason?: string;
192
+ /**
193
+ * Execution tracking (populated after approval)
194
+ */
195
+ executionStartedAt?: number;
196
+ executionCompletedAt?: number;
197
+ currentStepIndex: number;
198
+ }
199
+ /**
200
+ * PlanStatus represents the status of an execution plan
201
+ */
202
+ type PlanStatus = string;
203
+ declare const PlanStatusPendingApproval: PlanStatus;
204
+ declare const PlanStatusApproved: PlanStatus;
205
+ declare const PlanStatusExecuting: PlanStatus;
206
+ declare const PlanStatusCompleted: PlanStatus;
207
+ declare const PlanStatusRejected: PlanStatus;
208
+ declare const PlanStatusCancelled: PlanStatus;
209
+ type PlanStatusTS = 'pending_approval' | 'approved' | 'executing' | 'completed' | 'rejected' | 'cancelled';
210
+ /**
211
+ * PlannedStep represents a single step in an execution plan
212
+ */
213
+ interface PlannedStep {
214
+ /**
215
+ * Step number (1-based: 1, 2, 3, ...)
216
+ * This is the primary identifier for steps - used by LLM and all internal code
217
+ */
218
+ stepNumber: number;
219
+ /**
220
+ * Tool information
221
+ */
222
+ toolName: string;
223
+ toolId?: string;
224
+ title: string;
225
+ description: string;
226
+ icon?: string;
227
+ /**
228
+ * Planned input (may reference outputs from previous steps)
229
+ */
230
+ plannedInput: {
231
+ [key: string]: any;
232
+ };
233
+ /**
234
+ * Dependencies (step numbers that must complete before this one)
235
+ */
236
+ dependsOn?: number[];
237
+ /**
238
+ * Optional: user can toggle individual steps
239
+ */
240
+ enabled: boolean;
241
+ /**
242
+ * After execution (populated during/after execution)
243
+ */
244
+ status: ExecutionStatusTS;
245
+ output?: {
246
+ [key: string]: any;
247
+ };
248
+ error?: string;
249
+ startedAt?: number;
250
+ completedAt?: number;
251
+ }
252
+ /**
253
+ * PlanApprovalConfig configures when an agent requires plan approval
254
+ */
255
+ interface PlanApprovalConfig {
256
+ /**
257
+ * Always require approval for any multi-tool operation
258
+ */
259
+ alwaysRequire: boolean;
260
+ /**
261
+ * Require approval only for these tool names
262
+ */
263
+ requireForTools?: string[];
264
+ /**
265
+ * Require approval when estimated execution time exceeds threshold (seconds)
266
+ */
267
+ timeThresholdSeconds?: number;
268
+ /**
269
+ * Require approval when number of steps exceeds threshold
270
+ */
271
+ stepCountThreshold?: number;
272
+ /**
273
+ * Auto-approve if user has previously approved similar plans
274
+ */
275
+ allowAutoApprove: boolean;
276
+ }
277
+ /**
278
+ * CreateToolDefinitionRequest represents a request to create a tool definition
279
+ */
280
+ interface CreateToolDefinitionRequest {
281
+ orgId: string;
282
+ toolDefinition?: ToolDefinition;
283
+ }
284
+ /**
285
+ * UpdateToolDefinitionRequest represents a request to update a tool definition
286
+ */
287
+ interface UpdateToolDefinitionRequest {
288
+ orgId: string;
289
+ toolDefinition?: ToolDefinition;
290
+ }
291
+ /**
292
+ * GetToolDefinitionRequest represents a request to get a tool definition
293
+ */
294
+ interface GetToolDefinitionRequest {
295
+ orgId: string;
296
+ toolDefinitionId: string;
297
+ }
298
+ /**
299
+ * DeleteToolDefinitionRequest represents a request to delete a tool definition
300
+ */
301
+ interface DeleteToolDefinitionRequest {
302
+ orgId: string;
303
+ toolDefinitionId: string;
304
+ }
305
+ /**
306
+ * ListToolDefinitionsRequest represents a request to list tool definitions
307
+ */
308
+ interface ListToolDefinitionsRequest {
309
+ orgId: string;
310
+ onlySystem?: boolean;
311
+ enabled?: boolean;
312
+ limit?: number;
313
+ offset?: number;
314
+ }
315
+ /**
316
+ * ToolDefinitionResponse represents a response containing a tool definition
317
+ */
318
+ interface ToolDefinitionResponse {
319
+ toolDefinition?: ToolDefinition;
320
+ metadata: any;
321
+ }
322
+ /**
323
+ * ToolDefinitionsListResponse represents a response containing multiple tool definitions
324
+ */
325
+ interface ToolDefinitionsListResponse {
326
+ toolDefinitions: ToolDefinition[];
327
+ total: number;
328
+ metadata: any;
329
+ }
330
+ /**
331
+ * CreateSubAgentRequest represents a request to create a sub-agent
332
+ */
333
+ interface CreateSubAgentRequest {
334
+ orgId: string;
335
+ subAgent?: SubAgent;
336
+ }
337
+ /**
338
+ * UpdateSubAgentRequest represents a request to update a sub-agent
339
+ */
340
+ interface UpdateSubAgentRequest {
341
+ orgId: string;
342
+ subAgent?: SubAgent;
343
+ }
344
+ /**
345
+ * GetSubAgentRequest represents a request to get a sub-agent
346
+ */
347
+ interface GetSubAgentRequest {
348
+ orgId: string;
349
+ subAgentId: string;
350
+ }
351
+ /**
352
+ * DeleteSubAgentRequest represents a request to delete a sub-agent
353
+ */
354
+ interface DeleteSubAgentRequest {
355
+ orgId: string;
356
+ subAgentId: string;
357
+ }
358
+ /**
359
+ * ListSubAgentsRequest represents a request to list sub-agents
360
+ */
361
+ interface ListSubAgentsRequest {
362
+ orgId: string;
363
+ onlySystem?: boolean;
364
+ enabled?: boolean;
365
+ limit?: number;
366
+ offset?: number;
367
+ }
368
+ /**
369
+ * SubAgentResponse represents a response containing a sub-agent
370
+ */
371
+ interface SubAgentResponse {
372
+ subAgent?: SubAgent;
373
+ metadata: any;
374
+ }
375
+ /**
376
+ * SubAgentsListResponse represents a response containing multiple sub-agents
377
+ */
378
+ interface SubAgentsListResponse {
379
+ subAgents: SubAgent[];
380
+ total: number;
381
+ metadata: any;
382
+ }
383
+ /**
384
+ * GetToolDefinitionsByIDsRequest represents a request to get multiple tool definitions by IDs
385
+ */
386
+ interface GetToolDefinitionsByIDsRequest {
387
+ orgId: string;
388
+ toolDefinitionIds: string[];
389
+ }
390
+ /**
391
+ * GetToolDefinitionsByIDsResponse represents a response containing multiple tool definitions
392
+ */
393
+ interface GetToolDefinitionsByIDsResponse {
394
+ toolDefinitions: ToolDefinition[];
395
+ metadata: any;
396
+ }
397
+ /**
398
+ * GetSubAgentsByIDsRequest represents a request to get multiple sub-agents by IDs
399
+ */
400
+ interface GetSubAgentsByIDsRequest {
401
+ orgId: string;
402
+ subAgentIds: string[];
403
+ }
404
+ /**
405
+ * GetSubAgentsByIDsResponse represents a response containing multiple sub-agents
406
+ */
407
+ interface GetSubAgentsByIDsResponse {
408
+ subAgents: SubAgent[];
409
+ metadata: any;
410
+ }
411
+ interface ExecuteToolRequest {
412
+ orgId: string;
413
+ agentId?: string;
414
+ tool?: AgentTool;
415
+ input: {
416
+ [key: string]: any;
417
+ };
418
+ metadata?: {
419
+ [key: string]: any;
420
+ };
421
+ context?: {
422
+ [key: string]: any;
423
+ };
424
+ chatKey?: string;
425
+ }
426
+ interface ExecuteToolResponse {
427
+ result: {
428
+ [key: string]: any;
429
+ };
430
+ metadata: any;
431
+ }
432
+ /**
433
+ * CreateSkillRequest represents a request to create a skill
434
+ */
435
+ interface CreateSkillRequest {
436
+ orgId: string;
437
+ skill?: Skill;
438
+ }
439
+ /**
440
+ * UpdateSkillRequest represents a request to update a skill
441
+ */
442
+ interface UpdateSkillRequest {
443
+ orgId: string;
444
+ skill?: Skill;
445
+ }
446
+ /**
447
+ * GetSkillRequest represents a request to get a skill
448
+ */
449
+ interface GetSkillRequest {
450
+ orgId: string;
451
+ skillId: string;
452
+ }
453
+ /**
454
+ * DeleteSkillRequest represents a request to delete a skill
455
+ */
456
+ interface DeleteSkillRequest {
457
+ orgId: string;
458
+ skillId: string;
459
+ }
460
+ /**
461
+ * ListSkillsRequest represents a request to list skills
462
+ */
463
+ interface ListSkillsRequest {
464
+ orgId: string;
465
+ category?: SkillCategory;
466
+ onlySystem?: boolean;
467
+ enabled?: boolean;
468
+ limit?: number;
469
+ offset?: number;
470
+ }
471
+ /**
472
+ * SkillResponse represents a response containing a skill
473
+ */
474
+ interface SkillResponse {
475
+ skill?: Skill;
476
+ metadata: any;
477
+ }
478
+ /**
479
+ * SkillsListResponse represents a response containing multiple skills
480
+ */
481
+ interface SkillsListResponse {
482
+ skills: Skill[];
483
+ total: number;
484
+ metadata: any;
485
+ }
486
+ /**
487
+ * GetSkillsByIDsRequest represents a request to get multiple skills by IDs
488
+ */
489
+ interface GetSkillsByIDsRequest {
490
+ orgId: string;
491
+ skillIds: string[];
492
+ }
493
+ /**
494
+ * GetSkillsByIDsResponse represents a response containing multiple skills
495
+ */
496
+ interface GetSkillsByIDsResponse {
497
+ skills: Skill[];
498
+ metadata: any;
499
+ }
500
+ /**
501
+ * UpdateSkillOrgConfigRequest updates org-level config for a skill
502
+ */
503
+ interface UpdateSkillOrgConfigRequest {
504
+ orgId: string;
505
+ skillId: string;
506
+ orgConfig: {
507
+ [key: string]: any;
508
+ };
509
+ }
510
+ /**
511
+ * UpdateAgentSkillConfigRequest updates agent-level config for a skill
512
+ */
513
+ interface UpdateAgentSkillConfigRequest {
514
+ orgId: string;
515
+ agentId: string;
516
+ skillId: string;
517
+ config: {
518
+ [key: string]: any;
519
+ };
520
+ }
521
+ /**
522
+ * GetAgentSkillConfigRequest gets agent-level config for a skill
523
+ */
524
+ interface GetAgentSkillConfigRequest {
525
+ orgId: string;
526
+ agentId: string;
527
+ skillId: string;
528
+ }
529
+ /**
530
+ * AgentSkillConfigResponse contains agent skill config
531
+ */
532
+ interface AgentSkillConfigResponse {
533
+ agentSkill?: AgentSkill;
534
+ metadata: any;
535
+ }
536
+ /**
537
+ * GetSkillUserConfigRequest gets user-level config for a skill
538
+ */
539
+ interface GetSkillUserConfigRequest {
540
+ orgId: string;
541
+ userId: string;
542
+ skillId: string;
543
+ agentId?: string;
544
+ }
545
+ /**
546
+ * UpdateSkillUserConfigRequest updates user-level config for a skill
547
+ */
548
+ interface UpdateSkillUserConfigRequest {
549
+ orgId: string;
550
+ userId: string;
551
+ skillId: string;
552
+ agentId?: string;
553
+ enabled?: boolean;
554
+ displayOrder?: number;
555
+ config?: {
556
+ [key: string]: any;
557
+ };
558
+ }
559
+ /**
560
+ * DeleteSkillUserConfigRequest deletes user-level config for a skill
561
+ */
562
+ interface DeleteSkillUserConfigRequest {
563
+ orgId: string;
564
+ userId: string;
565
+ skillId: string;
566
+ agentId?: string;
567
+ }
568
+ /**
569
+ * ListSkillUserConfigRequest lists user configs for skills
570
+ */
571
+ interface ListSkillUserConfigRequest {
572
+ orgId: string;
573
+ userId: string;
574
+ agentId?: string;
575
+ limit?: number;
576
+ offset?: number;
577
+ }
578
+ /**
579
+ * SkillUserConfigResponse contains a user's skill config
580
+ */
581
+ interface SkillUserConfigResponse {
582
+ userConfig?: SkillUserConfig;
583
+ metadata: any;
584
+ }
585
+ /**
586
+ * SkillUserConfigListResponse contains multiple user skill configs
587
+ */
588
+ interface SkillUserConfigListResponse {
589
+ userConfigs: SkillUserConfig[];
590
+ total: number;
591
+ metadata: any;
592
+ }
593
+ /**
594
+ * ResolveSkillConfigRequest resolves merged config for a skill (org + agent + user)
595
+ */
596
+ interface ResolveSkillConfigRequest {
597
+ orgId: string;
598
+ userId: string;
599
+ agentId: string;
600
+ skillId: string;
601
+ }
602
+ /**
603
+ * ResolveSkillConfigResponse contains the merged skill config
604
+ */
605
+ interface ResolveSkillConfigResponse {
606
+ skillId: string;
607
+ skillName: string;
608
+ resolvedConfig: {
609
+ [key: string]: any;
610
+ };
611
+ /**
612
+ * Source indicates which level each config key came from
613
+ */
614
+ configSources?: {
615
+ [key: string]: string;
616
+ };
617
+ metadata: any;
618
+ }
619
+ /**
620
+ * CreateAgentJobRequest represents a request to create an agent job
621
+ */
622
+ interface CreateAgentJobRequest {
623
+ orgId: string;
624
+ job?: AgentJob;
625
+ }
626
+ /**
627
+ * UpdateAgentJobRequest represents a request to update an agent job
628
+ */
629
+ interface UpdateAgentJobRequest {
630
+ orgId: string;
631
+ job?: AgentJob;
632
+ }
633
+ /**
634
+ * AgentJobIDRequest represents a request that only needs org + job ID
635
+ * Used for: Get, Delete, Pause, Resume operations
636
+ */
637
+ interface AgentJobIDRequest {
638
+ orgId: string;
639
+ jobId: string;
640
+ }
641
+ /**
642
+ * ListAgentJobsRequest represents a request to list agent jobs
643
+ */
644
+ interface ListAgentJobsRequest {
645
+ orgId: string;
646
+ agentId?: string;
647
+ ownerId?: string;
648
+ scope?: JobScope;
649
+ status?: JobStatus;
650
+ frequency?: JobFrequency;
651
+ limit?: number;
652
+ offset?: number;
653
+ }
654
+ /**
655
+ * AgentJobResponse represents a response containing an agent job
656
+ */
657
+ interface AgentJobResponse {
658
+ job?: AgentJob;
659
+ metadata: any;
660
+ }
661
+ /**
662
+ * AgentJobsListResponse represents a response containing multiple agent jobs
663
+ */
664
+ interface AgentJobsListResponse {
665
+ jobs: AgentJob[];
666
+ total: number;
667
+ metadata: any;
668
+ }
669
+ /**
670
+ * AgentJobTriggerRequest represents a request from scheduler service to trigger jobs
671
+ * The trigger processes ALL orgs automatically by fetching them via admin.orgs.list
672
+ */
673
+ interface AgentJobTriggerRequest {
674
+ timestamp: string;
675
+ }
676
+ /**
677
+ * AgentJobTriggerResponse represents the response for job trigger processing
678
+ */
679
+ interface AgentJobTriggerResponse {
680
+ results: JobExecutionResult[];
681
+ total: number;
682
+ executed: number;
683
+ skipped: number;
684
+ errors: number;
685
+ metadata: any;
686
+ }
687
+ /**
688
+ * ListExecutionsByJobRequest represents a request to list executions for a job
689
+ */
690
+ interface ListExecutionsByJobRequest {
691
+ orgId: string;
692
+ jobId: string;
693
+ limit?: number;
694
+ offset?: number;
695
+ }
696
+ /**
697
+ * ListExecutionsByAgentRequest represents a request to list executions for an agent
698
+ */
699
+ interface ListExecutionsByAgentRequest {
700
+ orgId: string;
701
+ agentId: string;
702
+ limit?: number;
703
+ offset?: number;
704
+ }
705
+ /**
706
+ * ListExecutionsResponse represents the response with executions list
707
+ */
708
+ interface ListExecutionsResponse {
709
+ executions: JobExecution[];
710
+ total: number;
711
+ metadata: any;
712
+ }
713
+ /**
714
+ * GetExecutionRequest represents a request to get an execution
715
+ */
716
+ interface GetExecutionRequest {
717
+ orgId: string;
718
+ executionId: string;
719
+ }
720
+ /**
721
+ * ExecutionResponse represents the response with a single execution
722
+ */
723
+ interface ExecutionResponse {
724
+ execution?: JobExecution;
725
+ metadata: any;
726
+ }
727
+ /**
728
+ * TTLCleanupRequest represents a request to run TTL cleanup
729
+ */
730
+ interface TTLCleanupRequest {
731
+ retentionDays?: number;
732
+ }
733
+ /**
734
+ * TTLCleanupResponse represents the response from TTL cleanup
735
+ */
736
+ interface TTLCleanupResponse {
737
+ totalDeleted: number;
738
+ orgResults?: {
739
+ [key: string]: number;
740
+ };
741
+ duration: string;
742
+ metadata: any;
743
+ }
744
+ type AgentTypeTS = 'chat' | 'react';
745
+ type AgentSubTypeTS = 'chat' | 'react' | 'workflow' | 'document';
746
+ type AgentStatusTS = 'draft' | 'active' | 'inactive' | 'archived';
747
+ type AgentScopeTS = 'org' | 'team' | 'user';
748
+ /**
749
+ * AgentScope defines the visibility scope of an agent
750
+ */
751
+ type AgentScope = string;
752
+ declare const AgentScopeOrg: AgentScope;
753
+ declare const AgentScopeTeam: AgentScope;
754
+ declare const AgentScopeUser: AgentScope;
755
+ type SkillCategoryTS = 'productivity' | 'creative' | 'integration' | 'analysis' | 'communication' | 'custom';
756
+ type SkillCategory = string;
757
+ declare const SkillCategoryProductivity: SkillCategory;
758
+ declare const SkillCategoryCreative: SkillCategory;
759
+ declare const SkillCategoryIntegration: SkillCategory;
760
+ declare const SkillCategoryAnalysis: SkillCategory;
761
+ declare const SkillCategoryCommunication: SkillCategory;
762
+ declare const SkillCategoryCustom: SkillCategory;
763
+ /**
764
+ * IntegrationRequirement specifies an OAuth integration needed for a skill to function
765
+ * Skills with integration requirements are only available to users who have connected the required provider
766
+ */
767
+ interface IntegrationRequirement {
768
+ provider: string;
769
+ type: string;
770
+ }
771
+ /**
772
+ * Skill represents a bundled set of tools with a prompt extension
773
+ * Skills can be activated at runtime to extend agent capabilities
774
+ */
775
+ interface Skill {
776
+ id: string;
777
+ orgId?: string;
778
+ name: string;
779
+ title: string;
780
+ description?: string;
781
+ longDescription?: string;
782
+ category: SkillCategoryTS;
783
+ slashCommand?: string;
784
+ tags?: string[];
785
+ tools?: AgentTool[];
786
+ systemPromptExtension?: string;
787
+ iconName?: string;
788
+ configSchema?: JSONSchema;
789
+ config?: {
790
+ [key: string]: any;
791
+ };
792
+ requiredIntegrations?: IntegrationRequirement[];
793
+ /**
794
+ * Config schemas for each level (JSON Schema definitions)
795
+ */
796
+ orgConfigSchema?: JSONSchema;
797
+ agentConfigSchema?: JSONSchema;
798
+ userConfigSchema?: JSONSchema;
799
+ orgConfig?: {
800
+ [key: string]: any;
801
+ };
802
+ enabled: boolean;
803
+ isSystem?: boolean;
804
+ featured?: boolean;
805
+ persisted?: boolean;
806
+ displayOrder?: number;
807
+ createdAt?: string;
808
+ updatedAt?: string;
809
+ }
810
+ /**
811
+ * AgentSkill represents an agent's configuration for a specific skill
812
+ */
813
+ interface AgentSkill {
814
+ skillId: string;
815
+ skillName?: string;
816
+ enabled: boolean;
817
+ order: number;
818
+ config?: {
819
+ [key: string]: any;
820
+ };
821
+ }
822
+ /**
823
+ * SkillUserConfig stores user-level preferences and OAuth tokens for a skill
824
+ */
825
+ interface SkillUserConfig {
826
+ id: string;
827
+ userId: string;
828
+ skillId: string;
829
+ agentId?: string;
830
+ enabled: boolean;
831
+ displayOrder?: number;
832
+ config?: {
833
+ [key: string]: any;
834
+ };
835
+ createdAt: string;
836
+ updatedAt: string;
837
+ }
838
+ type AgentType = string;
839
+ declare const AgentTypeChat: AgentType;
840
+ declare const AgentTypeReact: AgentType;
841
+ type AgentSubType = string;
842
+ /**
843
+ * Agent SubTypes
844
+ */
845
+ declare const AgentSubTypeChat: AgentSubType;
846
+ /**
847
+ * Agent SubTypes
848
+ */
849
+ declare const AgentSubTypeReact: AgentSubType;
850
+ /**
851
+ * Agent SubTypes
852
+ */
853
+ declare const AgentSubTypeWorkflow: AgentSubType;
854
+ /**
855
+ * Agent SubTypes
856
+ */
857
+ declare const AgentSubTypeDocument: AgentSubType;
858
+ type AgentStatus = string;
859
+ declare const AgentStatusDraft: AgentStatus;
860
+ declare const AgentStatusActive: AgentStatus;
861
+ declare const AgentStatusInactive: AgentStatus;
862
+ declare const AgentStatusArchived: AgentStatus;
863
+ interface DefaultDefinitions {
864
+ agents: Agent[];
865
+ toolDefinitions: ToolDefinition[];
866
+ subAgents: SubAgent[];
867
+ skills?: Skill[];
868
+ }
869
+ /**
870
+ * AgentTool represents an agent's configuration for a specific tool
871
+ * Includes denormalized tool information to avoid joins at runtime
872
+ */
873
+ interface AgentTool {
874
+ toolId: string;
875
+ toolName: string;
876
+ title?: string;
877
+ description?: string;
878
+ type?: string;
879
+ inputSchema?: JSONSchema;
880
+ outputSchema?: JSONSchema;
881
+ configSchema?: JSONSchema;
882
+ config?: {
883
+ [key: string]: any;
884
+ };
885
+ mergeConfig?: MergeConfig;
886
+ enabled: boolean;
887
+ isSystem?: boolean;
888
+ createdAt?: string;
889
+ updatedAt?: string;
890
+ order?: number;
891
+ }
892
+ /**
893
+ * Core agent entity - shared by both types
894
+ */
895
+ interface Agent {
896
+ id?: string;
897
+ orgId: string;
898
+ product: ProductNameTS;
899
+ type: AgentTypeTS;
900
+ subType: AgentSubTypeTS;
901
+ name: string;
902
+ title: string;
903
+ description?: string;
904
+ status: AgentStatusTS;
905
+ version: string;
906
+ /**
907
+ * === LLM CONFIG ===
908
+ */
909
+ provider: string;
910
+ model: string;
911
+ temperature: number;
912
+ maxTokens: number;
913
+ systemPrompt: string;
914
+ goal?: string;
915
+ /**
916
+ * Shared metadata
917
+ */
918
+ tags?: string[];
919
+ isDefault: boolean;
920
+ isPublic: boolean;
921
+ /**
922
+ * === Tool and SubAgent References ===
923
+ */
924
+ tools?: AgentTool[];
925
+ subAgentIds?: string[];
926
+ /**
927
+ * === Skills Configuration ===
928
+ */
929
+ skills?: AgentSkill[];
930
+ /**
931
+ * === Essential Configs ===
932
+ */
933
+ csatConfig: CSATConfig;
934
+ handoffConfig: HandoffConfig;
935
+ /**
936
+ * === Widget Embed Config ===
937
+ */
938
+ widgetConfig?: WidgetConfig;
939
+ /**
940
+ * === TYPE-SPECIFIC CORE CONFIG ===
941
+ */
942
+ reactConfig?: ReactAgentConfig;
943
+ /**
944
+ * === CROSS-CUTTING FEATURES (can be used by any agent type) ===
945
+ */
946
+ userSuggestedActionsConfig?: UserSuggestedActionsConfig;
947
+ /**
948
+ * === AGENT CONTEXT CONFIG ===
949
+ * Defines how AgentContext is initialized and managed for this agent
950
+ */
951
+ contextConfig?: AgentContextConfig;
952
+ /**
953
+ * === SCHEMA-DRIVEN AGENT CONFIG ===
954
+ * Use ConfigSchema to auto-generate UI and validate values in Config
955
+ */
956
+ configSchema: JSONSchema;
957
+ config?: {
958
+ [key: string]: any;
959
+ };
960
+ /**
961
+ * === UI DISPLAY CONFIG ===
962
+ */
963
+ iconName?: string;
964
+ capabilities?: string[];
965
+ samplePrompts?: string[];
966
+ /**
967
+ * === SHARED BEHAVIOR CONFIG ===
968
+ */
969
+ responseStyle?: string;
970
+ personalityTraits?: string[];
971
+ fallbackMessage?: string;
972
+ /**
973
+ * === SHARED PERFORMANCE CONFIG ===
974
+ */
975
+ responseDelay?: number;
976
+ maxConcurrency?: number;
977
+ sessionTimeout?: number;
978
+ /**
979
+ * === TEMPLATE & SCOPE FIELDS ===
980
+ */
981
+ sourceTemplateId?: string;
982
+ sourceTemplateVersion?: string;
983
+ scope: AgentScopeTS;
984
+ scopeId?: string;
985
+ isFavorite: boolean;
986
+ lastUsedAt?: string;
987
+ usageCount: number;
988
+ /**
989
+ * Audit fields
990
+ */
991
+ createdAt: string;
992
+ updatedAt: string;
993
+ createdBy: string;
994
+ updatedBy: string;
995
+ metadata?: {
996
+ [key: string]: any;
997
+ };
998
+ }
999
+ /**
1000
+ * Handoff Configuration
1001
+ */
1002
+ interface HandoffConfig {
1003
+ enabled: boolean;
1004
+ triggerKeywords: string[];
1005
+ queueId?: string;
1006
+ handoffMessage: string;
1007
+ }
1008
+ /**
1009
+ * WidgetConfig defines the configuration for an embeddable chat widget
1010
+ */
1011
+ interface WidgetConfig {
1012
+ enabled: boolean;
1013
+ widgetId: string;
1014
+ appearance: WidgetAppearance;
1015
+ behavior: WidgetBehavior;
1016
+ security: WidgetSecurity;
1017
+ }
1018
+ /**
1019
+ * WidgetAppearance defines the visual customization of the widget
1020
+ */
1021
+ interface WidgetAppearance {
1022
+ position: string;
1023
+ primaryColor: string;
1024
+ backgroundColor: string;
1025
+ textColor: string;
1026
+ borderRadius: number;
1027
+ bubbleSize: number;
1028
+ bubbleIconUrl?: string;
1029
+ }
1030
+ /**
1031
+ * WidgetBehavior defines the behavioral settings of the widget
1032
+ */
1033
+ interface WidgetBehavior {
1034
+ welcomeMessage: string;
1035
+ suggestedPrompts?: string[];
1036
+ autoOpenDelay: number;
1037
+ showPoweredBy: boolean;
1038
+ }
1039
+ /**
1040
+ * WidgetSecurity defines the security settings for the widget
1041
+ */
1042
+ interface WidgetSecurity {
1043
+ allowedDomains: string[];
1044
+ }
1045
+ /**
1046
+ * AgentFilters for filtering agents in list operations
1047
+ */
1048
+ interface AgentFilters {
1049
+ product?: ProductNameTS;
1050
+ type?: AgentType;
1051
+ subType?: AgentSubType;
1052
+ status?: AgentStatus;
1053
+ isDefault?: boolean;
1054
+ isPublic?: boolean;
1055
+ tags?: string[];
1056
+ limit?: number;
1057
+ offset?: number;
1058
+ }
1059
+ /**
1060
+ * AgentSummary is a lightweight representation of an agent for list views
1061
+ * Contains essential display fields plus metadata needed for chat initialization
1062
+ */
1063
+ interface AgentSummary {
1064
+ id: string;
1065
+ name: string;
1066
+ title: string;
1067
+ description?: string;
1068
+ iconName?: string;
1069
+ type: AgentTypeTS;
1070
+ status: AgentStatusTS;
1071
+ isDefault: boolean;
1072
+ isPublic: boolean;
1073
+ capabilities?: string[];
1074
+ samplePrompts?: string[];
1075
+ skills?: AgentSkill[];
1076
+ metadata?: {
1077
+ [key: string]: any;
1078
+ };
1079
+ }
1080
+ /**
1081
+ * ToolDefinition represents an abstract/generic tool definition that can be customized per agent
1082
+ * This is the "template" that agents use to create their AgentTool configurations
1083
+ */
1084
+ interface ToolDefinition {
1085
+ id: string;
1086
+ name: string;
1087
+ title: string;
1088
+ description: string;
1089
+ type?: string;
1090
+ inputSchema: JSONSchema;
1091
+ outputSchema?: JSONSchema;
1092
+ configSchema: JSONSchema;
1093
+ config?: {
1094
+ [key: string]: any;
1095
+ };
1096
+ mergeConfig?: MergeConfig;
1097
+ enabled: boolean;
1098
+ isSystem: boolean;
1099
+ metadata?: {
1100
+ [key: string]: any;
1101
+ };
1102
+ createdAt: string;
1103
+ updatedAt: string;
1104
+ }
1105
+ /**
1106
+ * ToolExecution represents the execution context for a tool
1107
+ */
1108
+ interface ToolExecution {
1109
+ id: string;
1110
+ title: string;
1111
+ toolId: string;
1112
+ toolName: string;
1113
+ status: ToolExecutionStatusTS;
1114
+ input: {
1115
+ [key: string]: any;
1116
+ };
1117
+ result?: {
1118
+ [key: string]: any;
1119
+ };
1120
+ error?: string;
1121
+ context?: {
1122
+ [key: string]: any;
1123
+ };
1124
+ startedAt: number;
1125
+ completedAt?: number;
1126
+ retryCount: number;
1127
+ progress?: ToolExecutionProgress[];
1128
+ }
1129
+ interface ToolExecutionProgress {
1130
+ status: ToolExecutionStatusTS;
1131
+ timestamp: number;
1132
+ message?: string;
1133
+ error?: string;
1134
+ metadata?: {
1135
+ [key: string]: any;
1136
+ };
1137
+ }
1138
+ /**
1139
+ * ToolExecutionStatus represents the status of a tool execution
1140
+ */
1141
+ type ToolExecutionStatus = string;
1142
+ declare const ToolExecutionStatusStarted: ToolExecutionStatus;
1143
+ declare const ToolExecutionStatusExecuting: ToolExecutionStatus;
1144
+ declare const ToolExecutionStatusCompleted: ToolExecutionStatus;
1145
+ declare const ToolExecutionStatusFailed: ToolExecutionStatus;
1146
+ declare const ToolExecutionStatusTimeout: ToolExecutionStatus;
1147
+ declare const ToolExecutionStatusSkipped: ToolExecutionStatus;
1148
+ /**
1149
+ * SubAgent represents a sub-agent composed of tools
1150
+ */
1151
+ interface SubAgent {
1152
+ id: string;
1153
+ orgId: string;
1154
+ name: string;
1155
+ title: string;
1156
+ description: string;
1157
+ prompt: string;
1158
+ toolIds: string[];
1159
+ inputSchema: JSONSchema;
1160
+ outputSchema: JSONSchema;
1161
+ configSchema: JSONSchema;
1162
+ config?: {
1163
+ [key: string]: any;
1164
+ };
1165
+ version: string;
1166
+ enabled: boolean;
1167
+ isSystem: boolean;
1168
+ createdAt: string;
1169
+ updatedAt: string;
1170
+ createdBy: string;
1171
+ updatedBy: string;
1172
+ }
1173
+ /**
1174
+ * AgentToolConfiguration represents how an agent uses tools
1175
+ */
1176
+ interface AgentToolConfiguration {
1177
+ enabledTools: string[];
1178
+ enabledSubAgents: string[];
1179
+ toolConfigs: {
1180
+ [key: string]: ToolConfig;
1181
+ };
1182
+ executionPolicy: ToolExecutionPolicy;
1183
+ maxParallelCalls: number;
1184
+ requireApproval: boolean;
1185
+ }
1186
+ /**
1187
+ * ToolExecutionPolicy defines how tools are executed
1188
+ */
1189
+ interface ToolExecutionPolicy {
1190
+ mode: ExecutionModeTS;
1191
+ maxIterations: number;
1192
+ stopOnError: boolean;
1193
+ retryOnFailure: boolean;
1194
+ timeoutSeconds: number;
1195
+ }
1196
+ /**
1197
+ * ExecutionMode defines how tools are executed
1198
+ */
1199
+ type ExecutionMode = string;
1200
+ declare const ExecutionModeSync: ExecutionMode;
1201
+ declare const ExecutionModeAsync: ExecutionMode;
1202
+ declare const ExecutionModeAsyncClient: ExecutionMode;
1203
+ /**
1204
+ * CreateExecutionPlanRequest represents a request to create an execution plan
1205
+ */
1206
+ interface CreateExecutionPlanRequest {
1207
+ agentInstanceId: string;
1208
+ orgId: string;
1209
+ input: string;
1210
+ context?: {
1211
+ [key: string]: any;
1212
+ };
1213
+ availableTools: ToolDefinition[];
1214
+ }
1215
+ /**
1216
+ * CreateExecutionPlanResponse represents the response with an execution plan
1217
+ */
1218
+ interface CreateExecutionPlanResponse {
1219
+ agentInstanceId: string;
1220
+ executionPlan: ToolExecution[];
1221
+ estimatedTime?: any;
1222
+ }
1223
+ /**
1224
+ * ExecutePlanRequest represents a request to execute the plan
1225
+ */
1226
+ interface ExecutePlanRequest {
1227
+ agentInstanceId: string;
1228
+ orgId: string;
1229
+ approveAll?: boolean;
1230
+ }
1231
+ /**
1232
+ * ExecutePlanResponse represents the response after executing the plan
1233
+ */
1234
+ interface ExecutePlanResponse {
1235
+ stateId: string;
1236
+ status: ToolExecutionStatusTS;
1237
+ executedTools: ToolExecution[];
1238
+ finalResult?: any;
1239
+ errors?: string[];
1240
+ }
1241
+ type ToolExecutionStatusTS = 'pending' | 'executing' | 'completed' | 'failed' | 'timeout' | 'skipped';
1242
+ type ExecutionModeTS = 'sync' | 'async' | 'asyncClient';
1243
+ /**
1244
+ * GetWidgetConfigRequest represents a request to get widget config for an agent
1245
+ */
1246
+ interface GetWidgetConfigRequest {
1247
+ orgId: string;
1248
+ agentId: string;
1249
+ }
1250
+ /**
1251
+ * GetWidgetConfigResponse represents the response with widget config
1252
+ */
1253
+ interface GetWidgetConfigResponse {
1254
+ config?: WidgetConfig;
1255
+ metadata: any;
1256
+ }
1257
+ /**
1258
+ * SaveWidgetConfigRequest represents a request to save widget config for an agent
1259
+ */
1260
+ interface SaveWidgetConfigRequest {
1261
+ orgId: string;
1262
+ agentId: string;
1263
+ config?: WidgetConfig;
1264
+ }
1265
+ /**
1266
+ * SaveWidgetConfigResponse represents the response after saving widget config
1267
+ */
1268
+ interface SaveWidgetConfigResponse {
1269
+ config?: WidgetConfig;
1270
+ metadata: any;
1271
+ }
1272
+ type JobScopeTS = 'private' | 'team' | 'org';
1273
+ type JobStatusTS = 'active' | 'executing' | 'paused' | 'disabled';
1274
+ type JobFrequencyTS = 'one-time' | 'schedule';
1275
+ type JobExecutionStatusTS = 'running' | 'success' | 'failed' | 'timed_out';
1276
+ /**
1277
+ * JobScope defines who can see and use the job
1278
+ */
1279
+ type JobScope = string;
1280
+ declare const JobScopePrivate: JobScope;
1281
+ declare const JobScopeTeam: JobScope;
1282
+ declare const JobScopeOrg: JobScope;
1283
+ /**
1284
+ * JobStatus defines the current state of a job
1285
+ */
1286
+ type JobStatus = string;
1287
+ declare const JobStatusActive: JobStatus;
1288
+ declare const JobStatusExecuting: JobStatus;
1289
+ declare const JobStatusPaused: JobStatus;
1290
+ declare const JobStatusDisabled: JobStatus;
1291
+ /**
1292
+ * JobFrequency defines whether a job runs once or on a schedule
1293
+ */
1294
+ type JobFrequency = string;
1295
+ declare const JobFrequencyOneTime: JobFrequency;
1296
+ declare const JobFrequencySchedule: JobFrequency;
1297
+ /**
1298
+ * AgentJob represents a scheduled or one-time execution configuration for an agent
1299
+ */
1300
+ interface AgentJob {
1301
+ id: string;
1302
+ agentId: string;
1303
+ ownerId: string;
1304
+ ownerEmail?: string;
1305
+ teamId?: string;
1306
+ /**
1307
+ * Job identity
1308
+ */
1309
+ name: string;
1310
+ description?: string;
1311
+ /**
1312
+ * Scope determines who can see/manage and execution context
1313
+ */
1314
+ scope: JobScopeTS;
1315
+ /**
1316
+ * Job configuration
1317
+ */
1318
+ frequency: JobFrequencyTS;
1319
+ cron?: string;
1320
+ timezone?: string;
1321
+ prompt: string;
1322
+ /**
1323
+ * Status
1324
+ */
1325
+ status: JobStatusTS;
1326
+ /**
1327
+ * Tracking fields (managed by system)
1328
+ */
1329
+ lastRunAt?: string;
1330
+ nextRunAt?: string;
1331
+ runCount: number;
1332
+ lastError?: string;
1333
+ /**
1334
+ * Circuit breaker fields
1335
+ */
1336
+ consecutiveFailures: number;
1337
+ disabledUntil?: string;
1338
+ /**
1339
+ * Execution tracking (updated by Runtime Service)
1340
+ */
1341
+ lastExecutionId?: string;
1342
+ lastExecutionStatus?: string;
1343
+ lastExecutedAt?: string;
1344
+ /**
1345
+ * Audit fields
1346
+ */
1347
+ createdAt: string;
1348
+ updatedAt: string;
1349
+ }
1350
+ /**
1351
+ * JobExecutionStatus defines the status of a job execution
1352
+ */
1353
+ type JobExecutionStatus = string;
1354
+ declare const JobExecutionStatusRunning: JobExecutionStatus;
1355
+ declare const JobExecutionStatusSuccess: JobExecutionStatus;
1356
+ declare const JobExecutionStatusFailed: JobExecutionStatus;
1357
+ declare const JobExecutionStatusTimedOut: JobExecutionStatus;
1358
+ /**
1359
+ * ArtifactRef represents a reference to an artifact produced during execution
1360
+ * Actual files are stored by tools; this just tracks references
1361
+ */
1362
+ interface ArtifactRef {
1363
+ type: string;
1364
+ name: string;
1365
+ path?: string;
1366
+ size?: number;
1367
+ content?: string;
1368
+ }
1369
+ /**
1370
+ * JobExecution represents a single execution of an agent job
1371
+ */
1372
+ interface JobExecution {
1373
+ id: string;
1374
+ jobId: string;
1375
+ agentId: string;
1376
+ /**
1377
+ * Execution status
1378
+ */
1379
+ status: JobExecutionStatusTS;
1380
+ startedAt: string;
1381
+ completedAt?: string;
1382
+ /**
1383
+ * Execution metrics
1384
+ */
1385
+ roundsExecuted: number;
1386
+ totalTokens: number;
1387
+ /**
1388
+ * Results
1389
+ */
1390
+ result?: any;
1391
+ error?: string;
1392
+ artifacts?: ArtifactRef[];
1393
+ metadata?: any;
1394
+ /**
1395
+ * Audit
1396
+ */
1397
+ createdAt: string;
1398
+ }
1399
+ /**
1400
+ * JobExecutionResult represents the result of processing a single agent job
1401
+ */
1402
+ interface JobExecutionResult {
1403
+ jobId: string;
1404
+ agentId: string;
1405
+ jobName: string;
1406
+ executed: boolean;
1407
+ error?: string;
1408
+ }
1409
+ /**
1410
+ * ProcessJobTriggerResult represents the result of processing all agent jobs
1411
+ */
1412
+ interface ProcessJobTriggerResult {
1413
+ results: JobExecutionResult[];
1414
+ total: number;
1415
+ executed: number;
1416
+ skipped: number;
1417
+ errors: number;
1418
+ }
1419
+ /**
1420
+ * ExecuteJobRequest is sent to Runtime Service to execute a job
1421
+ */
1422
+ interface ExecuteJobRequest {
1423
+ /**
1424
+ * Execution identification (created by Agents Service before dispatch)
1425
+ */
1426
+ executionId: string;
1427
+ /**
1428
+ * Job identification
1429
+ */
1430
+ jobId: string;
1431
+ agentId: string;
1432
+ orgId: string;
1433
+ /**
1434
+ * Execution context
1435
+ */
1436
+ prompt: string;
1437
+ scope: JobScopeTS;
1438
+ ownerId: string;
1439
+ ownerEmail?: string;
1440
+ /**
1441
+ * Agent configuration (denormalized for Runtime)
1442
+ */
1443
+ agent: Agent;
1444
+ /**
1445
+ * Execution settings
1446
+ */
1447
+ timeoutMinutes?: number;
1448
+ metadata?: {
1449
+ [key: string]: any;
1450
+ };
1451
+ }
1452
+ /**
1453
+ * ExecutionCompletedEvent is received from Runtime Service when execution completes
1454
+ */
1455
+ interface ExecutionCompletedEvent {
1456
+ /**
1457
+ * Identification
1458
+ */
1459
+ executionId: string;
1460
+ jobId: string;
1461
+ orgId: string;
1462
+ /**
1463
+ * Status: "success", "failed", "timed_out"
1464
+ */
1465
+ status: string;
1466
+ /**
1467
+ * Results (present on success)
1468
+ */
1469
+ result?: any;
1470
+ artifacts?: ArtifactRef[];
1471
+ /**
1472
+ * Error info (present on failure)
1473
+ */
1474
+ error?: string;
1475
+ /**
1476
+ * Metrics
1477
+ */
1478
+ roundsExecuted: number;
1479
+ totalTokens: number;
1480
+ /**
1481
+ * Timing
1482
+ */
1483
+ completedAt: string;
1484
+ /**
1485
+ * Additional context
1486
+ */
1487
+ metadata?: {
1488
+ [key: string]: any;
1489
+ };
1490
+ }
1491
+ /**
1492
+ * CSAT Configuration
1493
+ */
1494
+ interface CSATConfig {
1495
+ enabled: boolean;
1496
+ survey?: CSATSurvey;
1497
+ }
1498
+ interface CSATQuestion {
1499
+ question: {
1500
+ [key: string]: string;
1501
+ };
1502
+ showRating: boolean;
1503
+ showComment: boolean;
1504
+ }
1505
+ interface CSATSurvey {
1506
+ questions: CSATQuestion[];
1507
+ timeThreshold: number;
1508
+ closeOnResponse: boolean;
1509
+ }
1510
+ interface CSATAnswer {
1511
+ question: string;
1512
+ lang?: string;
1513
+ rating?: number;
1514
+ comment?: string;
1515
+ }
1516
+ interface CSATResponse {
1517
+ answers: CSATAnswer[];
1518
+ submittedAt: number;
1519
+ overallRating: number;
1520
+ }
1521
+ /**
1522
+ * ReAct Agent Configuration
1523
+ */
1524
+ interface ReactAgentConfig {
1525
+ /**
1526
+ * Core ReAct Configuration
1527
+ */
1528
+ maxIterations: number;
1529
+ reasoningPrompt: string;
1530
+ stopConditions: string[];
1531
+ availableTools: string[];
1532
+ requireConfirmation: boolean;
1533
+ /**
1534
+ * LLM Configuration
1535
+ */
1536
+ model: string;
1537
+ temperature: number;
1538
+ maxTokens: number;
1539
+ provider: string;
1540
+ /**
1541
+ * Context Management
1542
+ */
1543
+ maxContextLength: number;
1544
+ memoryRetention: number;
1545
+ compressionStrategy: string;
1546
+ /**
1547
+ * Tool Configuration
1548
+ */
1549
+ toolConfigs?: {
1550
+ [key: string]: ToolConfig;
1551
+ };
1552
+ mcpServers?: MCPServerConfig[];
1553
+ /**
1554
+ * Execution Configuration
1555
+ */
1556
+ timeoutMinutes: number;
1557
+ retryAttempts: number;
1558
+ parallelExecution: boolean;
1559
+ /**
1560
+ * Safety Configuration
1561
+ */
1562
+ dangerousOperations?: string[];
1563
+ allowedFileTypes?: string[];
1564
+ restrictedPaths?: string[];
1565
+ }
1566
+ interface ToolConfig {
1567
+ enabled: boolean;
1568
+ timeoutSeconds: number;
1569
+ retryPolicy: RetryPolicy;
1570
+ configuration?: {
1571
+ [key: string]: any;
1572
+ };
1573
+ }
1574
+ interface RetryPolicy {
1575
+ maxAttempts: number;
1576
+ backoffStrategy: string;
1577
+ backoffDelay: any;
1578
+ }
1579
+ interface MCPServerConfig {
1580
+ name: string;
1581
+ endpoint: string;
1582
+ trusted: boolean;
1583
+ timeout: number;
1584
+ credentials?: {
1585
+ [key: string]: string;
1586
+ };
1587
+ }
1588
+ interface CreateAgentRequest {
1589
+ agent?: Agent;
1590
+ orgId: string;
1591
+ }
1592
+ interface AgentResponse {
1593
+ agent?: Agent;
1594
+ metadata: any;
1595
+ }
1596
+ interface GetAgentRequest {
1597
+ id?: string;
1598
+ name?: string;
1599
+ orgId: string;
1600
+ }
1601
+ interface UpdateAgentRequest {
1602
+ agent: Agent;
1603
+ orgId: string;
1604
+ }
1605
+ interface DeleteAgentRequest {
1606
+ id: string;
1607
+ orgId: string;
1608
+ }
1609
+ interface ListAgentsRequest {
1610
+ orgId: string;
1611
+ filters?: AgentFilters;
1612
+ }
1613
+ interface ListAgentsResponse {
1614
+ agents: Agent[];
1615
+ metadata: any;
1616
+ }
1617
+ /**
1618
+ * ListAgentsSummaryRequest requests a lightweight list of agents
1619
+ */
1620
+ interface ListAgentsSummaryRequest {
1621
+ orgId: string;
1622
+ filters?: AgentFilters;
1623
+ }
1624
+ /**
1625
+ * ListAgentsSummaryResponse returns lightweight agent summaries for list views
1626
+ */
1627
+ interface ListAgentsSummaryResponse {
1628
+ agents: AgentSummary[];
1629
+ metadata: any;
1630
+ }
1631
+ interface GetDefaultAgentRequest {
1632
+ orgId: string;
1633
+ agentType: AgentType;
1634
+ }
1635
+ interface UpdateOrgAgentsRequest {
1636
+ orgId: string;
1637
+ defaultDefinitions?: DefaultDefinitions;
1638
+ }
1639
+ interface UpdateOrgAgentsResponse {
1640
+ toolsCreated: number;
1641
+ subAgentsCreated: number;
1642
+ agentsCreated: number;
1643
+ skillsCreated: number;
1644
+ metadata: ResponseMetadata;
1645
+ }
1646
+ /**
1647
+ * Core Agent Operations
1648
+ */
1649
+ declare const AgentCreateSubject = "agent.create";
1650
+ /**
1651
+ * Core Agent Operations
1652
+ */
1653
+ declare const AgentCreatedSubject = "agent.created";
1654
+ /**
1655
+ * Core Agent Operations
1656
+ */
1657
+ declare const AgentGetSubject = "agent.get";
1658
+ /**
1659
+ * Core Agent Operations
1660
+ */
1661
+ declare const AgentUpdateSubject = "agent.update";
1662
+ /**
1663
+ * Core Agent Operations
1664
+ */
1665
+ declare const AgentUpdatedSubject = "agent.updated";
1666
+ /**
1667
+ * Core Agent Operations
1668
+ */
1669
+ declare const AgentDeleteSubject = "agent.delete";
1670
+ /**
1671
+ * Core Agent Operations
1672
+ */
1673
+ declare const AgentDeletedSubject = "agent.deleted";
1674
+ /**
1675
+ * Core Agent Operations
1676
+ */
1677
+ declare const AgentListSubject = "agent.list";
1678
+ /**
1679
+ * Core Agent Operations
1680
+ */
1681
+ declare const AgentListSummarySubject = "agent.list.summary";
1682
+ /**
1683
+ * Core Agent Operations
1684
+ */
1685
+ declare const AgentSearchSubject = "agent.search";
1686
+ /**
1687
+ * Agent Type Specific Operations
1688
+ */
1689
+ declare const AgentChatCreateSubject = "agent.chat.create";
1690
+ /**
1691
+ * Agent Type Specific Operations
1692
+ */
1693
+ declare const AgentChatUpdateSubject = "agent.chat.update";
1694
+ /**
1695
+ * Agent Type Specific Operations
1696
+ */
1697
+ declare const AgentChatGetSubject = "agent.chat.get";
1698
+ /**
1699
+ * Agent Type Specific Operations
1700
+ */
1701
+ declare const AgentChatValidateSubject = "agent.chat.validate";
1702
+ /**
1703
+ * Agent Type Specific Operations
1704
+ */
1705
+ declare const AgentReactCreateSubject = "agent.react.create";
1706
+ /**
1707
+ * Agent Type Specific Operations
1708
+ */
1709
+ declare const AgentReactUpdateSubject = "agent.react.update";
1710
+ /**
1711
+ * Agent Type Specific Operations
1712
+ */
1713
+ declare const AgentReactGetSubject = "agent.react.get";
1714
+ /**
1715
+ * Agent Type Specific Operations
1716
+ */
1717
+ declare const AgentReactValidateSubject = "agent.react.validate";
1718
+ /**
1719
+ * Execution Coordination
1720
+ */
1721
+ declare const AgentExecuteSubject = "agent.execute";
1722
+ /**
1723
+ * Execution Coordination
1724
+ */
1725
+ declare const AgentExecuteStatusSubject = "agent.execute.status";
1726
+ /**
1727
+ * Execution Coordination
1728
+ */
1729
+ declare const AgentExecuteStopSubject = "agent.execute.stop";
1730
+ /**
1731
+ * Version Management
1732
+ */
1733
+ declare const AgentVersionCreateSubject = "agent.version.create";
1734
+ /**
1735
+ * Version Management
1736
+ */
1737
+ declare const AgentVersionCreatedSubject = "agent.version.created";
1738
+ /**
1739
+ * Version Management
1740
+ */
1741
+ declare const AgentVersionGetSubject = "agent.version.get";
1742
+ /**
1743
+ * Version Management
1744
+ */
1745
+ declare const AgentVersionListSubject = "agent.version.list";
1746
+ /**
1747
+ * Version Management
1748
+ */
1749
+ declare const AgentVersionActivateSubject = "agent.version.activate";
1750
+ /**
1751
+ * Version Management
1752
+ */
1753
+ declare const AgentVersionActivatedSubject = "agent.version.activated";
1754
+ /**
1755
+ * Default Agent Management
1756
+ */
1757
+ declare const AgentEnsureDefaultSubject = "agent.ensure-default";
1758
+ /**
1759
+ * Default Agent Management
1760
+ */
1761
+ declare const AgentGetDefaultSubject = "agent.get-default";
1762
+ /**
1763
+ * Organization Management
1764
+ */
1765
+ declare const AgentGetByOrgSubject = "agent.get-by-org";
1766
+ /**
1767
+ * Organization Management
1768
+ */
1769
+ declare const AgentCloneSubject = "agent.clone";
1770
+ /**
1771
+ * Organization Management
1772
+ */
1773
+ declare const AgentExportSubject = "agent.export";
1774
+ /**
1775
+ * Organization Management
1776
+ */
1777
+ declare const AgentImportSubject = "agent.import";
1778
+ /**
1779
+ * Organization Management
1780
+ */
1781
+ declare const AgentUpdateOrgSubject = "agent.update-org-agents";
1782
+ /**
1783
+ * Configuration Templates
1784
+ */
1785
+ declare const AgentTemplateListSubject = "agent.template.list";
1786
+ /**
1787
+ * Configuration Templates
1788
+ */
1789
+ declare const AgentTemplateGetSubject = "agent.template.get";
1790
+ /**
1791
+ * Configuration Templates
1792
+ */
1793
+ declare const AgentFromTemplateSubject = "agent.from-template";
1794
+ /**
1795
+ * Chat Service Integration
1796
+ */
1797
+ declare const ChatAgentExecuteSubject = "chat.agent.execute";
1798
+ /**
1799
+ * Execution Service Integration
1800
+ */
1801
+ declare const ChatAgentStatusSubject = "chat.agent.status";
1802
+ /**
1803
+ * ReAct Service Integration
1804
+ */
1805
+ declare const ReactAgentExecuteSubject = "react.agent.execute";
1806
+ /**
1807
+ * Execution Service Integration
1808
+ */
1809
+ declare const ReactAgentStatusSubject = "react.agent.status";
1810
+ /**
1811
+ * Execution Service Integration
1812
+ */
1813
+ declare const ReactAgentStopSubject = "react.agent.stop";
1814
+ /**
1815
+ * Workflow Service Integration
1816
+ */
1817
+ declare const WorkflowAgentGetSubject = "workflow.agent.get";
1818
+ /**
1819
+ * Execution Service Integration
1820
+ */
1821
+ declare const WorkflowAgentUpdateSubject = "workflow.agent.update";
1822
+ /**
1823
+ * ToolDefinitions Management
1824
+ */
1825
+ declare const ToolDefinitionsCreateSubject = "agents.tool-definitions.create";
1826
+ /**
1827
+ * ToolDefinitions Management
1828
+ */
1829
+ declare const ToolDefinitionsCreatedSubject = "agents.tool-definitions.created";
1830
+ /**
1831
+ * ToolDefinitions Management
1832
+ */
1833
+ declare const ToolDefinitionsGetSubject = "agents.tool-definitions.get";
1834
+ /**
1835
+ * ToolDefinitions Management
1836
+ */
1837
+ declare const ToolDefinitionsUpdateSubject = "agents.tool-definitions.update";
1838
+ /**
1839
+ * ToolDefinitions Management
1840
+ */
1841
+ declare const ToolDefinitionsUpdatedSubject = "agents.tool-definitions.updated";
1842
+ /**
1843
+ * ToolDefinitions Management
1844
+ */
1845
+ declare const ToolDefinitionsDeleteSubject = "agents.tool-definitions.delete";
1846
+ /**
1847
+ * ToolDefinitions Management
1848
+ */
1849
+ declare const ToolDefinitionsDeletedSubject = "agents.tool-definitions.deleted";
1850
+ /**
1851
+ * ToolDefinitions Management
1852
+ */
1853
+ declare const ToolDefinitionsListSubject = "agents.tool-definitions.list";
1854
+ /**
1855
+ * ToolDefinitions Management
1856
+ */
1857
+ declare const ToolDefinitionsGetByIDsSubject = "agents.tool-definitions.get-by-ids";
1858
+ /**
1859
+ * ToolDefinitions Management
1860
+ */
1861
+ declare const ToolDefinitionsExecuteSubject = "agents.tool-definitions.execute";
1862
+ /**
1863
+ * ToolDefinitions Management
1864
+ */
1865
+ declare const ToolDefinitionsValidateSubject = "agents.tool-definitions.validate";
1866
+ /**
1867
+ * SubAgents Management
1868
+ */
1869
+ declare const SubAgentsCreateSubject = "agents.subagents.create";
1870
+ /**
1871
+ * SubAgents Management
1872
+ */
1873
+ declare const SubAgentsCreatedSubject = "agents.subagents.created";
1874
+ /**
1875
+ * SubAgents Management
1876
+ */
1877
+ declare const SubAgentsGetSubject = "agents.subagents.get";
1878
+ /**
1879
+ * SubAgents Management
1880
+ */
1881
+ declare const SubAgentsUpdateSubject = "agents.subagents.update";
1882
+ /**
1883
+ * SubAgents Management
1884
+ */
1885
+ declare const SubAgentsUpdatedSubject = "agents.subagents.updated";
1886
+ /**
1887
+ * SubAgents Management
1888
+ */
1889
+ declare const SubAgentsDeleteSubject = "agents.subagents.delete";
1890
+ /**
1891
+ * SubAgents Management
1892
+ */
1893
+ declare const SubAgentsDeletedSubject = "agents.subagents.deleted";
1894
+ /**
1895
+ * SubAgents Management
1896
+ */
1897
+ declare const SubAgentsListSubject = "agents.subagents.list";
1898
+ /**
1899
+ * SubAgents Management
1900
+ */
1901
+ declare const SubAgentsGetByIDsSubject = "agents.subagents.get-by-ids";
1902
+ /**
1903
+ * SubAgents Management
1904
+ */
1905
+ declare const SubAgentsExecuteSubject = "agents.subagents.execute";
1906
+ /**
1907
+ * SubAgents Management
1908
+ */
1909
+ declare const SubAgentsValidateSubject = "agents.subagents.validate";
1910
+ /**
1911
+ * Skills Management
1912
+ */
1913
+ declare const SkillsCreateSubject = "agents.skills.create";
1914
+ /**
1915
+ * Skills Management
1916
+ */
1917
+ declare const SkillsCreatedSubject = "agents.skills.created";
1918
+ /**
1919
+ * Skills Management
1920
+ */
1921
+ declare const SkillsGetSubject = "agents.skills.get";
1922
+ /**
1923
+ * Skills Management
1924
+ */
1925
+ declare const SkillsUpdateSubject = "agents.skills.update";
1926
+ /**
1927
+ * Skills Management
1928
+ */
1929
+ declare const SkillsUpdatedSubject = "agents.skills.updated";
1930
+ /**
1931
+ * Skills Management
1932
+ */
1933
+ declare const SkillsDeleteSubject = "agents.skills.delete";
1934
+ /**
1935
+ * Skills Management
1936
+ */
1937
+ declare const SkillsDeletedSubject = "agents.skills.deleted";
1938
+ /**
1939
+ * Skills Management
1940
+ */
1941
+ declare const SkillsListSubject = "agents.skills.list";
1942
+ /**
1943
+ * Skills Management
1944
+ */
1945
+ declare const SkillsGetByIDsSubject = "agents.skills.get-by-ids";
1946
+ /**
1947
+ * Skill Org Config
1948
+ */
1949
+ declare const SkillsUpdateOrgConfigSubject = "agents.skills.update-org-config";
1950
+ /**
1951
+ * Agent Skill Config
1952
+ */
1953
+ declare const AgentSkillUpdateConfigSubject = "agents.skills.agent.update-config";
1954
+ /**
1955
+ * Skills Management
1956
+ */
1957
+ declare const AgentSkillGetConfigSubject = "agents.skills.agent.get-config";
1958
+ /**
1959
+ * Skill User Config Management
1960
+ */
1961
+ declare const SkillUserConfigGetSubject = "agents.skills.user-config.get";
1962
+ /**
1963
+ * Skill User Config Management
1964
+ */
1965
+ declare const SkillUserConfigUpdateSubject = "agents.skills.user-config.update";
1966
+ /**
1967
+ * Skill User Config Management
1968
+ */
1969
+ declare const SkillUserConfigDeleteSubject = "agents.skills.user-config.delete";
1970
+ /**
1971
+ * Skill User Config Management
1972
+ */
1973
+ declare const SkillUserConfigListSubject = "agents.skills.user-config.list";
1974
+ /**
1975
+ * Config Resolution (merges org + agent + user config)
1976
+ */
1977
+ declare const SkillResolveConfigSubject = "agents.skills.resolve-config";
1978
+ /**
1979
+ * Widget Config Management
1980
+ */
1981
+ declare const WidgetConfigGetByAgentSubject = "widgets.config.get.by.agent";
1982
+ /**
1983
+ * Widget Config Management
1984
+ */
1985
+ declare const WidgetConfigSaveSubject = "widgets.config.save";
1986
+ /**
1987
+ * Job CRUD Operations
1988
+ */
1989
+ declare const AgentJobCreateSubject = "agents.jobs.create";
1990
+ /**
1991
+ * Agent Job Management
1992
+ */
1993
+ declare const AgentJobGetSubject = "agents.jobs.get";
1994
+ /**
1995
+ * Agent Job Management
1996
+ */
1997
+ declare const AgentJobUpdateSubject = "agents.jobs.update";
1998
+ /**
1999
+ * Agent Job Management
2000
+ */
2001
+ declare const AgentJobDeleteSubject = "agents.jobs.delete";
2002
+ /**
2003
+ * Agent Job Management
2004
+ */
2005
+ declare const AgentJobListSubject = "agents.jobs.list";
2006
+ /**
2007
+ * Job Actions
2008
+ */
2009
+ declare const AgentJobPauseSubject = "agents.jobs.pause";
2010
+ /**
2011
+ * Agent Job Management
2012
+ */
2013
+ declare const AgentJobResumeSubject = "agents.jobs.resume";
2014
+ /**
2015
+ * Job Trigger (from Scheduler Service)
2016
+ */
2017
+ declare const AgentJobTriggerSubject = "agents.job.trigger";
2018
+ /**
2019
+ * Execution Query Operations
2020
+ */
2021
+ declare const JobExecutionGetSubject = "agents.executions.get";
2022
+ /**
2023
+ * Job Execution Management
2024
+ */
2025
+ declare const JobExecutionListSubject = "agents.executions.list";
2026
+ /**
2027
+ * Runtime Service Communication
2028
+ */
2029
+ declare const RuntimeJobExecuteSubject = "runtime.job.execute";
2030
+ /**
2031
+ * Job Execution Management
2032
+ */
2033
+ declare const RuntimeJobCompletedSubject = "runtime.job.completed";
2034
+ /**
2035
+ * TTL Cleanup (triggered by Scheduler)
2036
+ */
2037
+ declare const ExecutionsTTLCleanupSubject = "maintenance.executions.cleanup";
2038
+ /**
2039
+ * Agent Instance Management
2040
+ */
2041
+ declare const AgentInstanceCreateSubject = "agents.instance.create";
2042
+ /**
2043
+ * Agent Instance Management
2044
+ */
2045
+ declare const AgentInstanceCreatedSubject = "agents.instance.created";
2046
+ /**
2047
+ * Agent Instance Management
2048
+ */
2049
+ declare const AgentInstanceGetSubject = "agents.instance.get";
2050
+ /**
2051
+ * Agent Instance Management
2052
+ */
2053
+ declare const AgentInstanceUpdateSubject = "agents.instance.update";
2054
+ /**
2055
+ * Agent Instance Management
2056
+ */
2057
+ declare const AgentInstanceUpdatedSubject = "agents.instance.updated";
2058
+ /**
2059
+ * Agent Instance Management
2060
+ */
2061
+ declare const AgentInstanceListSubject = "agents.instance.list";
2062
+ /**
2063
+ * Agent Instance Management
2064
+ */
2065
+ declare const AgentInstanceDeleteSubject = "agents.instance.delete";
2066
+ /**
2067
+ * Agent Instance Management
2068
+ */
2069
+ declare const AgentInstanceDeletedSubject = "agents.instance.deleted";
2070
+ /**
2071
+ * Execution Plan Operations
2072
+ */
2073
+ declare const AgentInstanceCreatePlanSubject = "agents.instance.create-plan";
2074
+ /**
2075
+ * Agent Instance Management
2076
+ */
2077
+ declare const AgentInstanceExecutePlanSubject = "agents.instance.execute-plan";
2078
+ /**
2079
+ * Agent Instance Management
2080
+ */
2081
+ declare const AgentInstancePausePlanSubject = "agents.instance.pause-plan";
2082
+ /**
2083
+ * Agent Instance Management
2084
+ */
2085
+ declare const AgentInstanceResumePlanSubject = "agents.instance.resume-plan";
2086
+ /**
2087
+ * Agent Instance Management
2088
+ */
2089
+ declare const AgentInstanceCancelPlanSubject = "agents.instance.cancel-plan";
2090
+ /**
2091
+ * Execution History
2092
+ */
2093
+ declare const AgentInstanceGetHistorySubject = "agents.instance.get-history";
2094
+ /**
2095
+ * Agent Instance Management
2096
+ */
2097
+ declare const AgentInstanceClearHistorySubject = "agents.instance.clear-history";
2098
+ type AgentCategoryTS = 'support' | 'sales' | 'research' | 'writing' | 'productivity' | 'development' | 'marketing' | 'hr' | 'finance' | 'general';
2099
+ type TemplateStatusTS = 'published' | 'draft';
2100
+ type PublisherTypeTS = 'eloquent' | 'partner';
2101
+ /**
2102
+ * AgentCategory defines the category of an agent template
2103
+ */
2104
+ type AgentCategory = string;
2105
+ declare const AgentCategorySupport: AgentCategory;
2106
+ declare const AgentCategorySales: AgentCategory;
2107
+ declare const AgentCategoryResearch: AgentCategory;
2108
+ declare const AgentCategoryWriting: AgentCategory;
2109
+ declare const AgentCategoryProductivity: AgentCategory;
2110
+ declare const AgentCategoryDevelopment: AgentCategory;
2111
+ declare const AgentCategoryMarketing: AgentCategory;
2112
+ declare const AgentCategoryHR: AgentCategory;
2113
+ declare const AgentCategoryFinance: AgentCategory;
2114
+ declare const AgentCategoryGeneral: AgentCategory;
2115
+ /**
2116
+ * TemplateStatus defines the publication status of a template
2117
+ */
2118
+ type TemplateStatus = string;
2119
+ declare const TemplateStatusPublished: TemplateStatus;
2120
+ declare const TemplateStatusDraft: TemplateStatus;
2121
+ /**
2122
+ * PublisherType defines who published the template
2123
+ */
2124
+ type PublisherType = string;
2125
+ declare const PublisherTypeEloquent: PublisherType;
2126
+ declare const PublisherTypePartner: PublisherType;
2127
+ /**
2128
+ * CustomizableField defines a field that users can customize when adding an agent from a template
2129
+ */
2130
+ interface CustomizableField {
2131
+ field: string;
2132
+ label: string;
2133
+ description: string;
2134
+ type: string;
2135
+ required: boolean;
2136
+ }
2137
+ /**
2138
+ * AgentTemplate represents a pre-built agent in the marketplace
2139
+ */
2140
+ interface AgentTemplate {
2141
+ id: string;
2142
+ /**
2143
+ * Identity
2144
+ */
2145
+ name: string;
2146
+ title: string;
2147
+ description: string;
2148
+ longDescription?: string;
2149
+ /**
2150
+ * Categorization
2151
+ */
2152
+ category: AgentCategoryTS;
2153
+ tags?: string[];
2154
+ industry?: string[];
2155
+ useCase?: string[];
2156
+ /**
2157
+ * Discovery
2158
+ */
2159
+ featured: boolean;
2160
+ popularityScore: number;
2161
+ installCount: number;
2162
+ /**
2163
+ * Visual
2164
+ */
2165
+ iconName?: string;
2166
+ coverImageUrl?: string;
2167
+ /**
2168
+ * The actual agent configuration (copied when user adds)
2169
+ */
2170
+ agentConfig: Agent;
2171
+ /**
2172
+ * What's included
2173
+ */
2174
+ includedSkillNames?: string[];
2175
+ includedToolNames?: string[];
2176
+ /**
2177
+ * Requirements
2178
+ */
2179
+ requiredIntegrations?: IntegrationRequirement[];
2180
+ /**
2181
+ * Publisher
2182
+ */
2183
+ publisherName?: string;
2184
+ publisherType: PublisherTypeTS;
2185
+ /**
2186
+ * Customization hints
2187
+ */
2188
+ customizableFields?: CustomizableField[];
2189
+ /**
2190
+ * Status
2191
+ */
2192
+ status: TemplateStatusTS;
2193
+ version: string;
2194
+ /**
2195
+ * Audit
2196
+ */
2197
+ createdAt: string;
2198
+ updatedAt: string;
2199
+ }
2200
+ /**
2201
+ * TemplateCategoryCount represents a template category with its count
2202
+ */
2203
+ interface TemplateCategoryCount {
2204
+ name: string;
2205
+ count: number;
2206
+ }
2207
+ /**
2208
+ * TemplateFilters for filtering templates in list operations
2209
+ */
2210
+ interface TemplateFilters {
2211
+ category?: AgentCategoryTS;
2212
+ industry?: string;
2213
+ useCase?: string;
2214
+ featured?: boolean;
2215
+ status?: TemplateStatusTS;
2216
+ query?: string;
2217
+ sort?: string;
2218
+ limit?: number;
2219
+ offset?: number;
2220
+ }
2221
+ /**
2222
+ * Config and request models for product service integration
2223
+ */
2224
+ interface UserSuggestedActionsConfig {
2225
+ enabled: boolean;
2226
+ actionTypes: string[];
2227
+ maxActions: number;
2228
+ cooldownSeconds: number;
2229
+ }
2230
+ interface UserSuggestedAction {
2231
+ title: string;
2232
+ actionType: string;
2233
+ input?: string;
2234
+ priority?: number;
2235
+ metadata?: {
2236
+ [key: string]: any;
2237
+ };
2238
+ }
2239
+ interface UserSuggestedActionsRequest {
2240
+ orgId: string;
2241
+ chatKey: string;
2242
+ config: UserSuggestedActionsConfig;
2243
+ metadata?: {
2244
+ [key: string]: any;
2245
+ };
2246
+ }
2247
+ interface UserSuggestedActionsResponse {
2248
+ actions: UserSuggestedAction[];
2249
+ metadata: any;
2250
+ }
2251
+ /**
2252
+ * ValidationError represents a validation error with field and message
2253
+ */
2254
+ interface ValidationError {
2255
+ field: string;
2256
+ message: string;
2257
+ }
2258
+ /**
2259
+ * ValidationErrors represents a collection of validation errors
2260
+ */
2261
+ type ValidationErrors = ValidationError[];
2262
+ /**
2263
+ * AgentWidget represents a widget configuration for an agent
2264
+ */
2265
+ interface AgentWidget {
2266
+ id: string;
2267
+ agentId: string;
2268
+ orgId: string;
2269
+ widgetId: string;
2270
+ name: string;
2271
+ title: string;
2272
+ description?: string;
2273
+ enabled: boolean;
2274
+ isDefault: boolean;
2275
+ appearance: WidgetAppearance;
2276
+ behavior: WidgetBehavior;
2277
+ security: WidgetSecurity;
2278
+ createdAt: string;
2279
+ updatedAt: string;
2280
+ createdBy?: string;
2281
+ }
2282
+ /**
2283
+ * AgentWidget NATS Subjects
2284
+ */
2285
+ declare const AgentWidgetsCreateSubject = "agents.widgets.create";
2286
+ /**
2287
+ * AgentWidget NATS Subjects
2288
+ */
2289
+ declare const AgentWidgetsGetSubject = "agents.widgets.get";
2290
+ /**
2291
+ * AgentWidget NATS Subjects
2292
+ */
2293
+ declare const AgentWidgetsGetByWidgetID = "agents.widgets.get-by-widget-id";
2294
+ /**
2295
+ * AgentWidget NATS Subjects
2296
+ */
2297
+ declare const AgentWidgetsUpdateSubject = "agents.widgets.update";
2298
+ /**
2299
+ * AgentWidget NATS Subjects
2300
+ */
2301
+ declare const AgentWidgetsDeleteSubject = "agents.widgets.delete";
2302
+ /**
2303
+ * AgentWidget NATS Subjects
2304
+ */
2305
+ declare const AgentWidgetsListSubject = "agents.widgets.list";
2306
+ /**
2307
+ * AgentWidget NATS Subjects
2308
+ */
2309
+ declare const AgentWidgetsSetDefaultSubject = "agents.widgets.set-default";
2310
+ /**
2311
+ * AgentWidget NATS Subjects
2312
+ */
2313
+ declare const AgentWidgetsGetDefaultSubject = "agents.widgets.get-default";
2314
+ /**
2315
+ * CreateAgentWidgetRequest is the request to create a new widget
2316
+ */
2317
+ interface CreateAgentWidgetRequest {
2318
+ orgId: string;
2319
+ agentId: string;
2320
+ widget: AgentWidget;
2321
+ }
2322
+ /**
2323
+ * AgentWidgetResponse is the response for single widget operations
2324
+ */
2325
+ interface AgentWidgetResponse {
2326
+ widget?: AgentWidget;
2327
+ metadata: any;
2328
+ }
2329
+ /**
2330
+ * GetAgentWidgetRequest is the request to get a widget by ID
2331
+ */
2332
+ interface GetAgentWidgetRequest {
2333
+ orgId: string;
2334
+ widgetId: string;
2335
+ }
2336
+ /**
2337
+ * GetWidgetByWidgetIDRequest is the request to get a widget by its embed widget_id
2338
+ */
2339
+ interface GetWidgetByWidgetIDRequest {
2340
+ widgetId: string;
2341
+ }
2342
+ /**
2343
+ * UpdateAgentWidgetRequest is the request to update a widget
2344
+ */
2345
+ interface UpdateAgentWidgetRequest {
2346
+ orgId: string;
2347
+ widget: AgentWidget;
2348
+ }
2349
+ /**
2350
+ * DeleteAgentWidgetRequest is the request to delete a widget
2351
+ */
2352
+ interface DeleteAgentWidgetRequest {
2353
+ orgId: string;
2354
+ widgetId: string;
2355
+ }
2356
+ /**
2357
+ * ListAgentWidgetsRequest is the request to list widgets for an agent
2358
+ */
2359
+ interface ListAgentWidgetsRequest {
2360
+ orgId: string;
2361
+ agentId: string;
2362
+ }
2363
+ /**
2364
+ * ListAgentWidgetsResponse is the response for listing widgets
2365
+ */
2366
+ interface ListAgentWidgetsResponse {
2367
+ widgets: AgentWidget[];
2368
+ metadata: any;
2369
+ }
2370
+ /**
2371
+ * SetDefaultWidgetRequest is the request to set a widget as default
2372
+ */
2373
+ interface SetDefaultWidgetRequest {
2374
+ orgId: string;
2375
+ agentId: string;
2376
+ widgetId: string;
2377
+ }
2378
+ /**
2379
+ * GetDefaultWidgetRequest is the request to get the default widget for an agent
2380
+ */
2381
+ interface GetDefaultWidgetRequest {
2382
+ orgId: string;
2383
+ agentId: string;
2384
+ }
2385
+ /**
2386
+ * PublicWidgetConfig is the config exposed to the widget client (no sensitive data)
2387
+ */
2388
+ interface PublicWidgetConfig {
2389
+ widgetId: string;
2390
+ agentId: string;
2391
+ orgId: string;
2392
+ name: string;
2393
+ title: string;
2394
+ appearance: WidgetAppearance;
2395
+ behavior: WidgetBehavior;
2396
+ }
2397
+
2398
+ export { type ListSkillsRequest as $, type AgentContext as A, type CreateSubAgentRequest as B, type CreateToolDefinitionRequest as C, type DeleteToolDefinitionRequest as D, type ExecutionStatus as E, type UpdateSubAgentRequest as F, type GetToolDefinitionRequest as G, type GetSubAgentRequest as H, type DeleteSubAgentRequest as I, type ListSubAgentsRequest as J, type SubAgentsListResponse as K, type ListToolDefinitionsRequest as L, type MergeConfig as M, type GetToolDefinitionsByIDsRequest as N, type GetToolDefinitionsByIDsResponse as O, type PlanStatus as P, type GetSubAgentsByIDsRequest as Q, type GetSubAgentsByIDsResponse as R, type SubAgentResponse as S, type ToolDefinitionResponse as T, type UpdateToolDefinitionRequest as U, type ExecuteToolRequest as V, type ExecuteToolResponse as W, type CreateSkillRequest as X, type UpdateSkillRequest as Y, type GetSkillRequest as Z, type DeleteSkillRequest as _, type AgentExecution as a, AgentStatusArchived as a$, type SkillResponse as a0, type SkillsListResponse as a1, type GetSkillsByIDsRequest as a2, type GetSkillsByIDsResponse as a3, type UpdateSkillOrgConfigRequest as a4, type UpdateAgentSkillConfigRequest as a5, type GetAgentSkillConfigRequest as a6, type AgentSkillConfigResponse as a7, type GetSkillUserConfigRequest as a8, type UpdateSkillUserConfigRequest as a9, AgentScopeOrg as aA, AgentScopeTeam as aB, AgentScopeUser as aC, type SkillCategoryTS as aD, type SkillCategory as aE, SkillCategoryProductivity as aF, SkillCategoryCreative as aG, SkillCategoryIntegration as aH, SkillCategoryAnalysis as aI, SkillCategoryCommunication as aJ, SkillCategoryCustom as aK, type IntegrationRequirement as aL, type Skill as aM, type AgentSkill as aN, type SkillUserConfig as aO, type AgentType as aP, AgentTypeChat as aQ, AgentTypeReact as aR, type AgentSubType as aS, AgentSubTypeChat as aT, AgentSubTypeReact as aU, AgentSubTypeWorkflow as aV, AgentSubTypeDocument as aW, type AgentStatus as aX, AgentStatusDraft as aY, AgentStatusActive as aZ, AgentStatusInactive as a_, type DeleteSkillUserConfigRequest as aa, type ListSkillUserConfigRequest as ab, type SkillUserConfigResponse as ac, type SkillUserConfigListResponse as ad, type ResolveSkillConfigRequest as ae, type ResolveSkillConfigResponse as af, type CreateAgentJobRequest as ag, type UpdateAgentJobRequest as ah, type AgentJobIDRequest as ai, type ListAgentJobsRequest as aj, type AgentJobResponse as ak, type AgentJobsListResponse as al, type AgentJobTriggerRequest as am, type AgentJobTriggerResponse as an, type ListExecutionsByJobRequest as ao, type ListExecutionsByAgentRequest as ap, type ListExecutionsResponse as aq, type GetExecutionRequest as ar, type ExecutionResponse as as, type TTLCleanupRequest as at, type TTLCleanupResponse as au, type AgentTypeTS as av, type AgentSubTypeTS as aw, type AgentStatusTS as ax, type AgentScopeTS as ay, type AgentScope as az, ExecutionStatusPending as b, type ExecuteJobRequest as b$, type DefaultDefinitions as b0, type AgentTool as b1, type Agent as b2, type HandoffConfig as b3, type WidgetConfig as b4, type WidgetAppearance as b5, type WidgetBehavior as b6, type WidgetSecurity as b7, type AgentFilters as b8, type AgentSummary as b9, type SaveWidgetConfigResponse as bA, type JobScopeTS as bB, type JobStatusTS as bC, type JobFrequencyTS as bD, type JobExecutionStatusTS as bE, type JobScope as bF, JobScopePrivate as bG, JobScopeTeam as bH, JobScopeOrg as bI, type JobStatus as bJ, JobStatusActive as bK, JobStatusExecuting as bL, JobStatusPaused as bM, JobStatusDisabled as bN, type JobFrequency as bO, JobFrequencyOneTime as bP, JobFrequencySchedule as bQ, type AgentJob as bR, type JobExecutionStatus as bS, JobExecutionStatusRunning as bT, JobExecutionStatusSuccess as bU, JobExecutionStatusFailed as bV, JobExecutionStatusTimedOut as bW, type ArtifactRef as bX, type JobExecution as bY, type JobExecutionResult as bZ, type ProcessJobTriggerResult as b_, type ToolDefinition as ba, type ToolExecution as bb, type ToolExecutionProgress as bc, type ToolExecutionStatus as bd, ToolExecutionStatusStarted as be, ToolExecutionStatusExecuting as bf, ToolExecutionStatusCompleted as bg, ToolExecutionStatusFailed as bh, ToolExecutionStatusTimeout as bi, ToolExecutionStatusSkipped as bj, type SubAgent as bk, type AgentToolConfiguration as bl, type ToolExecutionPolicy as bm, type ExecutionMode as bn, ExecutionModeSync as bo, ExecutionModeAsync as bp, ExecutionModeAsyncClient as bq, type CreateExecutionPlanRequest as br, type CreateExecutionPlanResponse as bs, type ExecutePlanRequest as bt, type ExecutePlanResponse as bu, type ToolExecutionStatusTS as bv, type ExecutionModeTS as bw, type GetWidgetConfigRequest as bx, type GetWidgetConfigResponse as by, type SaveWidgetConfigRequest as bz, ExecutionStatusRunning as c, ReactAgentStopSubject as c$, type ExecutionCompletedEvent as c0, type CSATConfig as c1, type CSATQuestion as c2, type CSATSurvey as c3, type CSATAnswer as c4, type CSATResponse as c5, type ReactAgentConfig as c6, type ToolConfig as c7, type RetryPolicy as c8, type MCPServerConfig as c9, AgentReactCreateSubject as cA, AgentReactUpdateSubject as cB, AgentReactGetSubject as cC, AgentReactValidateSubject as cD, AgentExecuteSubject as cE, AgentExecuteStatusSubject as cF, AgentExecuteStopSubject as cG, AgentVersionCreateSubject as cH, AgentVersionCreatedSubject as cI, AgentVersionGetSubject as cJ, AgentVersionListSubject as cK, AgentVersionActivateSubject as cL, AgentVersionActivatedSubject as cM, AgentEnsureDefaultSubject as cN, AgentGetDefaultSubject as cO, AgentGetByOrgSubject as cP, AgentCloneSubject as cQ, AgentExportSubject as cR, AgentImportSubject as cS, AgentUpdateOrgSubject as cT, AgentTemplateListSubject as cU, AgentTemplateGetSubject as cV, AgentFromTemplateSubject as cW, ChatAgentExecuteSubject as cX, ChatAgentStatusSubject as cY, ReactAgentExecuteSubject as cZ, ReactAgentStatusSubject as c_, type CreateAgentRequest as ca, type AgentResponse as cb, type GetAgentRequest as cc, type UpdateAgentRequest as cd, type DeleteAgentRequest as ce, type ListAgentsRequest as cf, type ListAgentsResponse as cg, type ListAgentsSummaryRequest as ch, type ListAgentsSummaryResponse as ci, type GetDefaultAgentRequest as cj, type UpdateOrgAgentsRequest as ck, type UpdateOrgAgentsResponse as cl, AgentCreateSubject as cm, AgentCreatedSubject as cn, AgentGetSubject as co, AgentUpdateSubject as cp, AgentUpdatedSubject as cq, AgentDeleteSubject as cr, AgentDeletedSubject as cs, AgentListSubject as ct, AgentListSummarySubject as cu, AgentSearchSubject as cv, AgentChatCreateSubject as cw, AgentChatUpdateSubject as cx, AgentChatGetSubject as cy, AgentChatValidateSubject as cz, ExecutionStatusCompleted as d, AgentInstanceDeleteSubject as d$, WorkflowAgentGetSubject as d0, WorkflowAgentUpdateSubject as d1, ToolDefinitionsCreateSubject as d2, ToolDefinitionsCreatedSubject as d3, ToolDefinitionsGetSubject as d4, ToolDefinitionsUpdateSubject as d5, ToolDefinitionsUpdatedSubject as d6, ToolDefinitionsDeleteSubject as d7, ToolDefinitionsDeletedSubject as d8, ToolDefinitionsListSubject as d9, AgentSkillGetConfigSubject as dA, SkillUserConfigGetSubject as dB, SkillUserConfigUpdateSubject as dC, SkillUserConfigDeleteSubject as dD, SkillUserConfigListSubject as dE, SkillResolveConfigSubject as dF, WidgetConfigGetByAgentSubject as dG, WidgetConfigSaveSubject as dH, AgentJobCreateSubject as dI, AgentJobGetSubject as dJ, AgentJobUpdateSubject as dK, AgentJobDeleteSubject as dL, AgentJobListSubject as dM, AgentJobPauseSubject as dN, AgentJobResumeSubject as dO, AgentJobTriggerSubject as dP, JobExecutionGetSubject as dQ, JobExecutionListSubject as dR, RuntimeJobExecuteSubject as dS, RuntimeJobCompletedSubject as dT, ExecutionsTTLCleanupSubject as dU, AgentInstanceCreateSubject as dV, AgentInstanceCreatedSubject as dW, AgentInstanceGetSubject as dX, AgentInstanceUpdateSubject as dY, AgentInstanceUpdatedSubject as dZ, AgentInstanceListSubject as d_, ToolDefinitionsGetByIDsSubject as da, ToolDefinitionsExecuteSubject as db, ToolDefinitionsValidateSubject as dc, SubAgentsCreateSubject as dd, SubAgentsCreatedSubject as de, SubAgentsGetSubject as df, SubAgentsUpdateSubject as dg, SubAgentsUpdatedSubject as dh, SubAgentsDeleteSubject as di, SubAgentsDeletedSubject as dj, SubAgentsListSubject as dk, SubAgentsGetByIDsSubject as dl, SubAgentsExecuteSubject as dm, SubAgentsValidateSubject as dn, SkillsCreateSubject as dp, SkillsCreatedSubject as dq, SkillsGetSubject as dr, SkillsUpdateSubject as ds, SkillsUpdatedSubject as dt, SkillsDeleteSubject as du, SkillsDeletedSubject as dv, SkillsListSubject as dw, SkillsGetByIDsSubject as dx, SkillsUpdateOrgConfigSubject as dy, AgentSkillUpdateConfigSubject as dz, ExecutionStatusFailed as e, AgentInstanceDeletedSubject as e0, AgentInstanceCreatePlanSubject as e1, AgentInstanceExecutePlanSubject as e2, AgentInstancePausePlanSubject as e3, AgentInstanceResumePlanSubject as e4, AgentInstanceCancelPlanSubject as e5, AgentInstanceGetHistorySubject as e6, AgentInstanceClearHistorySubject as e7, type AgentCategoryTS as e8, type TemplateStatusTS as e9, type ValidationError as eA, type ValidationErrors as eB, type AgentWidget as eC, AgentWidgetsCreateSubject as eD, AgentWidgetsGetSubject as eE, AgentWidgetsGetByWidgetID as eF, AgentWidgetsUpdateSubject as eG, AgentWidgetsDeleteSubject as eH, AgentWidgetsListSubject as eI, AgentWidgetsSetDefaultSubject as eJ, AgentWidgetsGetDefaultSubject as eK, type CreateAgentWidgetRequest as eL, type AgentWidgetResponse as eM, type GetAgentWidgetRequest as eN, type GetWidgetByWidgetIDRequest as eO, type UpdateAgentWidgetRequest as eP, type DeleteAgentWidgetRequest as eQ, type ListAgentWidgetsRequest as eR, type ListAgentWidgetsResponse as eS, type SetDefaultWidgetRequest as eT, type GetDefaultWidgetRequest as eU, type PublicWidgetConfig as eV, type PublisherTypeTS as ea, type AgentCategory as eb, AgentCategorySupport as ec, AgentCategorySales as ed, AgentCategoryResearch as ee, AgentCategoryWriting as ef, AgentCategoryProductivity as eg, AgentCategoryDevelopment as eh, AgentCategoryMarketing as ei, AgentCategoryHR as ej, AgentCategoryFinance as ek, AgentCategoryGeneral as el, type TemplateStatus as em, TemplateStatusPublished as en, TemplateStatusDraft as eo, type PublisherType as ep, PublisherTypeEloquent as eq, PublisherTypePartner as er, type CustomizableField as es, type AgentTemplate as et, type TemplateCategoryCount as eu, type TemplateFilters as ev, type UserSuggestedActionsConfig as ew, type UserSuggestedAction as ex, type UserSuggestedActionsRequest as ey, type UserSuggestedActionsResponse as ez, ExecutionStatusSkipped as f, type ExecutionStatusTS as g, type MergeStrategy as h, MergeStrategyReplace as i, MergeStrategyMerge as j, MergeStrategyAppend as k, type MergeStrategyTS as l, type AgentContextConfig as m, MaxExecutions as n, ExecutionTTLHours as o, type ExecutionPlan as p, PlanStatusPendingApproval as q, PlanStatusApproved as r, PlanStatusExecuting as s, PlanStatusCompleted as t, PlanStatusRejected as u, PlanStatusCancelled as v, type PlanStatusTS as w, type PlannedStep as x, type PlanApprovalConfig as y, type ToolDefinitionsListResponse as z };