@fleettools/events 0.1.1 → 0.2.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.
@@ -0,0 +1,1005 @@
1
+ /**
2
+ * FleetTools Agent Coordination System
3
+ *
4
+ * Comprehensive agent coordination layer that transforms FleetTools from
5
+ * passive coordination to active multi-agent platform with ai-eng-system integration.
6
+ */
7
+ import { z } from 'zod';
8
+ /**
9
+ * Agent Types from ai-eng-system integration
10
+ */
11
+ export declare const AgentTypeSchema: z.ZodEnum<["architect-advisor", "backend-architect", "infrastructure-builder", "full-stack-developer", "frontend-reviewer", "api-builder-advanced", "code-reviewer", "test-generator", "security-scanner", "deployment-engineer", "monitoring-expert", "accessibility-pro", "ux-optimizer", "compliance-expert", "performance-engineer", "database-expert"]>;
12
+ export type AgentType = z.infer<typeof AgentTypeSchema>;
13
+ /**
14
+ * Agent Capability Definition
15
+ */
16
+ export declare const AgentCapabilitySchema: z.ZodObject<{
17
+ id: z.ZodString;
18
+ name: z.ZodString;
19
+ description: z.ZodString;
20
+ trigger_words: z.ZodArray<z.ZodString, "many">;
21
+ max_concurrent_tasks: z.ZodDefault<z.ZodNumber>;
22
+ estimated_duration_ms: z.ZodOptional<z.ZodNumber>;
23
+ dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
24
+ resource_requirements: z.ZodOptional<z.ZodObject<{
25
+ memory_mb: z.ZodOptional<z.ZodNumber>;
26
+ cpu_units: z.ZodOptional<z.ZodNumber>;
27
+ special_permissions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
28
+ }, "strip", z.ZodTypeAny, {
29
+ memory_mb?: number | undefined;
30
+ cpu_units?: number | undefined;
31
+ special_permissions?: string[] | undefined;
32
+ }, {
33
+ memory_mb?: number | undefined;
34
+ cpu_units?: number | undefined;
35
+ special_permissions?: string[] | undefined;
36
+ }>>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ id: string;
39
+ description: string;
40
+ name: string;
41
+ trigger_words: string[];
42
+ max_concurrent_tasks: number;
43
+ estimated_duration_ms?: number | undefined;
44
+ dependencies?: string[] | undefined;
45
+ resource_requirements?: {
46
+ memory_mb?: number | undefined;
47
+ cpu_units?: number | undefined;
48
+ special_permissions?: string[] | undefined;
49
+ } | undefined;
50
+ }, {
51
+ id: string;
52
+ description: string;
53
+ name: string;
54
+ trigger_words: string[];
55
+ max_concurrent_tasks?: number | undefined;
56
+ estimated_duration_ms?: number | undefined;
57
+ dependencies?: string[] | undefined;
58
+ resource_requirements?: {
59
+ memory_mb?: number | undefined;
60
+ cpu_units?: number | undefined;
61
+ special_permissions?: string[] | undefined;
62
+ } | undefined;
63
+ }>;
64
+ /**
65
+ * Agent Registry Entry
66
+ */
67
+ export declare const AgentRegistrySchema: z.ZodObject<{
68
+ id: z.ZodString;
69
+ agent_type: z.ZodEnum<["architect-advisor", "backend-architect", "infrastructure-builder", "full-stack-developer", "frontend-reviewer", "api-builder-advanced", "code-reviewer", "test-generator", "security-scanner", "deployment-engineer", "monitoring-expert", "accessibility-pro", "ux-optimizer", "compliance-expert", "performance-engineer", "database-expert"]>;
70
+ callsign: z.ZodString;
71
+ status: z.ZodEnum<["idle", "busy", "offline", "error"]>;
72
+ capabilities: z.ZodArray<z.ZodObject<{
73
+ id: z.ZodString;
74
+ name: z.ZodString;
75
+ description: z.ZodString;
76
+ trigger_words: z.ZodArray<z.ZodString, "many">;
77
+ max_concurrent_tasks: z.ZodDefault<z.ZodNumber>;
78
+ estimated_duration_ms: z.ZodOptional<z.ZodNumber>;
79
+ dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
80
+ resource_requirements: z.ZodOptional<z.ZodObject<{
81
+ memory_mb: z.ZodOptional<z.ZodNumber>;
82
+ cpu_units: z.ZodOptional<z.ZodNumber>;
83
+ special_permissions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
84
+ }, "strip", z.ZodTypeAny, {
85
+ memory_mb?: number | undefined;
86
+ cpu_units?: number | undefined;
87
+ special_permissions?: string[] | undefined;
88
+ }, {
89
+ memory_mb?: number | undefined;
90
+ cpu_units?: number | undefined;
91
+ special_permissions?: string[] | undefined;
92
+ }>>;
93
+ }, "strip", z.ZodTypeAny, {
94
+ id: string;
95
+ description: string;
96
+ name: string;
97
+ trigger_words: string[];
98
+ max_concurrent_tasks: number;
99
+ estimated_duration_ms?: number | undefined;
100
+ dependencies?: string[] | undefined;
101
+ resource_requirements?: {
102
+ memory_mb?: number | undefined;
103
+ cpu_units?: number | undefined;
104
+ special_permissions?: string[] | undefined;
105
+ } | undefined;
106
+ }, {
107
+ id: string;
108
+ description: string;
109
+ name: string;
110
+ trigger_words: string[];
111
+ max_concurrent_tasks?: number | undefined;
112
+ estimated_duration_ms?: number | undefined;
113
+ dependencies?: string[] | undefined;
114
+ resource_requirements?: {
115
+ memory_mb?: number | undefined;
116
+ cpu_units?: number | undefined;
117
+ special_permissions?: string[] | undefined;
118
+ } | undefined;
119
+ }>, "many">;
120
+ current_workload: z.ZodDefault<z.ZodNumber>;
121
+ max_workload: z.ZodDefault<z.ZodNumber>;
122
+ last_heartbeat: z.ZodString;
123
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
124
+ created_at: z.ZodString;
125
+ updated_at: z.ZodString;
126
+ }, "strip", z.ZodTypeAny, {
127
+ id: string;
128
+ status: "idle" | "busy" | "error" | "offline";
129
+ callsign: string;
130
+ updated_at: string;
131
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
132
+ capabilities: {
133
+ id: string;
134
+ description: string;
135
+ name: string;
136
+ trigger_words: string[];
137
+ max_concurrent_tasks: number;
138
+ estimated_duration_ms?: number | undefined;
139
+ dependencies?: string[] | undefined;
140
+ resource_requirements?: {
141
+ memory_mb?: number | undefined;
142
+ cpu_units?: number | undefined;
143
+ special_permissions?: string[] | undefined;
144
+ } | undefined;
145
+ }[];
146
+ current_workload: number;
147
+ max_workload: number;
148
+ last_heartbeat: string;
149
+ created_at: string;
150
+ metadata?: Record<string, unknown> | undefined;
151
+ }, {
152
+ id: string;
153
+ status: "idle" | "busy" | "error" | "offline";
154
+ callsign: string;
155
+ updated_at: string;
156
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
157
+ capabilities: {
158
+ id: string;
159
+ description: string;
160
+ name: string;
161
+ trigger_words: string[];
162
+ max_concurrent_tasks?: number | undefined;
163
+ estimated_duration_ms?: number | undefined;
164
+ dependencies?: string[] | undefined;
165
+ resource_requirements?: {
166
+ memory_mb?: number | undefined;
167
+ cpu_units?: number | undefined;
168
+ special_permissions?: string[] | undefined;
169
+ } | undefined;
170
+ }[];
171
+ last_heartbeat: string;
172
+ created_at: string;
173
+ current_workload?: number | undefined;
174
+ max_workload?: number | undefined;
175
+ metadata?: Record<string, unknown> | undefined;
176
+ }>;
177
+ /**
178
+ * Work Assignment Priority
179
+ */
180
+ export declare const WorkPrioritySchema: z.ZodEnum<["low", "medium", "high", "critical", "emergency"]>;
181
+ /**
182
+ * Task Assignment Algorithm Configuration
183
+ */
184
+ export declare const AssignmentConfigSchema: z.ZodObject<{
185
+ algorithm: z.ZodDefault<z.ZodEnum<["round_robin", "capability_match", "workload_balance", "priority_first"]>>;
186
+ capability_weight: z.ZodDefault<z.ZodNumber>;
187
+ workload_weight: z.ZodDefault<z.ZodNumber>;
188
+ priority_weight: z.ZodDefault<z.ZodNumber>;
189
+ max_assignment_attempts: z.ZodDefault<z.ZodNumber>;
190
+ assignment_timeout_ms: z.ZodDefault<z.ZodNumber>;
191
+ }, "strip", z.ZodTypeAny, {
192
+ algorithm: "round_robin" | "capability_match" | "workload_balance" | "priority_first";
193
+ capability_weight: number;
194
+ workload_weight: number;
195
+ priority_weight: number;
196
+ max_assignment_attempts: number;
197
+ assignment_timeout_ms: number;
198
+ }, {
199
+ algorithm?: "round_robin" | "capability_match" | "workload_balance" | "priority_first" | undefined;
200
+ capability_weight?: number | undefined;
201
+ workload_weight?: number | undefined;
202
+ priority_weight?: number | undefined;
203
+ max_assignment_attempts?: number | undefined;
204
+ assignment_timeout_ms?: number | undefined;
205
+ }>;
206
+ /**
207
+ * Agent Work Assignment
208
+ */
209
+ export declare const AgentAssignmentSchema: z.ZodObject<{
210
+ id: z.ZodString;
211
+ agent_id: z.ZodString;
212
+ agent_callsign: z.ZodString;
213
+ work_order_id: z.ZodString;
214
+ work_type: z.ZodString;
215
+ priority: z.ZodEnum<["low", "medium", "high", "critical", "emergency"]>;
216
+ assigned_at: z.ZodString;
217
+ status: z.ZodEnum<["assigned", "accepted", "in_progress", "completed", "failed", "cancelled"]>;
218
+ started_at: z.ZodOptional<z.ZodString>;
219
+ completed_at: z.ZodOptional<z.ZodString>;
220
+ estimated_completion: z.ZodOptional<z.ZodString>;
221
+ progress_percent: z.ZodDefault<z.ZodNumber>;
222
+ context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
223
+ error_details: z.ZodOptional<z.ZodObject<{
224
+ message: z.ZodString;
225
+ retry_count: z.ZodDefault<z.ZodNumber>;
226
+ last_retry_at: z.ZodOptional<z.ZodString>;
227
+ }, "strip", z.ZodTypeAny, {
228
+ message: string;
229
+ retry_count: number;
230
+ last_retry_at?: string | undefined;
231
+ }, {
232
+ message: string;
233
+ retry_count?: number | undefined;
234
+ last_retry_at?: string | undefined;
235
+ }>>;
236
+ }, "strip", z.ZodTypeAny, {
237
+ id: string;
238
+ status: "completed" | "failed" | "assigned" | "accepted" | "in_progress" | "cancelled";
239
+ priority: "low" | "high" | "critical" | "medium" | "emergency";
240
+ progress_percent: number;
241
+ agent_id: string;
242
+ agent_callsign: string;
243
+ work_order_id: string;
244
+ work_type: string;
245
+ assigned_at: string;
246
+ started_at?: string | undefined;
247
+ completed_at?: string | undefined;
248
+ context?: Record<string, unknown> | undefined;
249
+ estimated_completion?: string | undefined;
250
+ error_details?: {
251
+ message: string;
252
+ retry_count: number;
253
+ last_retry_at?: string | undefined;
254
+ } | undefined;
255
+ }, {
256
+ id: string;
257
+ status: "completed" | "failed" | "assigned" | "accepted" | "in_progress" | "cancelled";
258
+ priority: "low" | "high" | "critical" | "medium" | "emergency";
259
+ agent_id: string;
260
+ agent_callsign: string;
261
+ work_order_id: string;
262
+ work_type: string;
263
+ assigned_at: string;
264
+ started_at?: string | undefined;
265
+ completed_at?: string | undefined;
266
+ progress_percent?: number | undefined;
267
+ context?: Record<string, unknown> | undefined;
268
+ estimated_completion?: string | undefined;
269
+ error_details?: {
270
+ message: string;
271
+ retry_count?: number | undefined;
272
+ last_retry_at?: string | undefined;
273
+ } | undefined;
274
+ }>;
275
+ /**
276
+ * Agent Communication Message Types
277
+ */
278
+ export declare const AgentMessageTypeSchema: z.ZodEnum<["task_assignment", "task_acceptance", "task_progress", "task_completion", "task_failure", "coordination_request", "coordination_response", "resource_request", "resource_release", "handoff_request", "handoff_acceptance", "status_update", "error_report"]>;
279
+ /**
280
+ * Inter-Agent Communication
281
+ */
282
+ export declare const AgentMessageSchema: z.ZodObject<{
283
+ id: z.ZodString;
284
+ project_key: z.ZodString;
285
+ timestamp: z.ZodString;
286
+ sequence: z.ZodNumber;
287
+ } & {
288
+ type: z.ZodLiteral<"agent_message">;
289
+ data: z.ZodObject<{
290
+ message_id: z.ZodString;
291
+ from_agent: z.ZodString;
292
+ to_agent: z.ZodOptional<z.ZodString>;
293
+ message_type: z.ZodEnum<["task_assignment", "task_acceptance", "task_progress", "task_completion", "task_failure", "coordination_request", "coordination_response", "resource_request", "resource_release", "handoff_request", "handoff_acceptance", "status_update", "error_report"]>;
294
+ subject: z.ZodString;
295
+ content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
296
+ priority: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical", "emergency"]>>;
297
+ correlation_id: z.ZodOptional<z.ZodString>;
298
+ requires_response: z.ZodDefault<z.ZodBoolean>;
299
+ response_timeout_ms: z.ZodOptional<z.ZodNumber>;
300
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
301
+ }, "strip", z.ZodTypeAny, {
302
+ subject: string;
303
+ message_id: string;
304
+ priority: "low" | "high" | "critical" | "medium" | "emergency";
305
+ from_agent: string;
306
+ message_type: "task_assignment" | "task_acceptance" | "task_progress" | "task_completion" | "task_failure" | "coordination_request" | "coordination_response" | "resource_request" | "resource_release" | "handoff_request" | "handoff_acceptance" | "status_update" | "error_report";
307
+ content: Record<string, unknown>;
308
+ requires_response: boolean;
309
+ metadata?: Record<string, unknown> | undefined;
310
+ to_agent?: string | undefined;
311
+ correlation_id?: string | undefined;
312
+ response_timeout_ms?: number | undefined;
313
+ }, {
314
+ subject: string;
315
+ message_id: string;
316
+ from_agent: string;
317
+ message_type: "task_assignment" | "task_acceptance" | "task_progress" | "task_completion" | "task_failure" | "coordination_request" | "coordination_response" | "resource_request" | "resource_release" | "handoff_request" | "handoff_acceptance" | "status_update" | "error_report";
318
+ content: Record<string, unknown>;
319
+ priority?: "low" | "high" | "critical" | "medium" | "emergency" | undefined;
320
+ metadata?: Record<string, unknown> | undefined;
321
+ to_agent?: string | undefined;
322
+ correlation_id?: string | undefined;
323
+ requires_response?: boolean | undefined;
324
+ response_timeout_ms?: number | undefined;
325
+ }>;
326
+ }, "strip", z.ZodTypeAny, {
327
+ id: string;
328
+ type: "agent_message";
329
+ project_key: string;
330
+ timestamp: string;
331
+ sequence: number;
332
+ data: {
333
+ subject: string;
334
+ message_id: string;
335
+ priority: "low" | "high" | "critical" | "medium" | "emergency";
336
+ from_agent: string;
337
+ message_type: "task_assignment" | "task_acceptance" | "task_progress" | "task_completion" | "task_failure" | "coordination_request" | "coordination_response" | "resource_request" | "resource_release" | "handoff_request" | "handoff_acceptance" | "status_update" | "error_report";
338
+ content: Record<string, unknown>;
339
+ requires_response: boolean;
340
+ metadata?: Record<string, unknown> | undefined;
341
+ to_agent?: string | undefined;
342
+ correlation_id?: string | undefined;
343
+ response_timeout_ms?: number | undefined;
344
+ };
345
+ }, {
346
+ id: string;
347
+ type: "agent_message";
348
+ project_key: string;
349
+ timestamp: string;
350
+ sequence: number;
351
+ data: {
352
+ subject: string;
353
+ message_id: string;
354
+ from_agent: string;
355
+ message_type: "task_assignment" | "task_acceptance" | "task_progress" | "task_completion" | "task_failure" | "coordination_request" | "coordination_response" | "resource_request" | "resource_release" | "handoff_request" | "handoff_acceptance" | "status_update" | "error_report";
356
+ content: Record<string, unknown>;
357
+ priority?: "low" | "high" | "critical" | "medium" | "emergency" | undefined;
358
+ metadata?: Record<string, unknown> | undefined;
359
+ to_agent?: string | undefined;
360
+ correlation_id?: string | undefined;
361
+ requires_response?: boolean | undefined;
362
+ response_timeout_ms?: number | undefined;
363
+ };
364
+ }>;
365
+ /**
366
+ * Agent Lifecycle Events
367
+ */
368
+ export declare const AgentSpawnedSchema: z.ZodObject<{
369
+ id: z.ZodString;
370
+ project_key: z.ZodString;
371
+ timestamp: z.ZodString;
372
+ sequence: z.ZodNumber;
373
+ } & {
374
+ type: z.ZodLiteral<"agent_spawned">;
375
+ data: z.ZodObject<{
376
+ agent_id: z.ZodString;
377
+ agent_type: z.ZodEnum<["architect-advisor", "backend-architect", "infrastructure-builder", "full-stack-developer", "frontend-reviewer", "api-builder-advanced", "code-reviewer", "test-generator", "security-scanner", "deployment-engineer", "monitoring-expert", "accessibility-pro", "ux-optimizer", "compliance-expert", "performance-engineer", "database-expert"]>;
378
+ callsign: z.ZodString;
379
+ spawned_by: z.ZodString;
380
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
381
+ capabilities: z.ZodArray<z.ZodObject<{
382
+ id: z.ZodString;
383
+ name: z.ZodString;
384
+ description: z.ZodString;
385
+ trigger_words: z.ZodArray<z.ZodString, "many">;
386
+ max_concurrent_tasks: z.ZodDefault<z.ZodNumber>;
387
+ estimated_duration_ms: z.ZodOptional<z.ZodNumber>;
388
+ dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
389
+ resource_requirements: z.ZodOptional<z.ZodObject<{
390
+ memory_mb: z.ZodOptional<z.ZodNumber>;
391
+ cpu_units: z.ZodOptional<z.ZodNumber>;
392
+ special_permissions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
393
+ }, "strip", z.ZodTypeAny, {
394
+ memory_mb?: number | undefined;
395
+ cpu_units?: number | undefined;
396
+ special_permissions?: string[] | undefined;
397
+ }, {
398
+ memory_mb?: number | undefined;
399
+ cpu_units?: number | undefined;
400
+ special_permissions?: string[] | undefined;
401
+ }>>;
402
+ }, "strip", z.ZodTypeAny, {
403
+ id: string;
404
+ description: string;
405
+ name: string;
406
+ trigger_words: string[];
407
+ max_concurrent_tasks: number;
408
+ estimated_duration_ms?: number | undefined;
409
+ dependencies?: string[] | undefined;
410
+ resource_requirements?: {
411
+ memory_mb?: number | undefined;
412
+ cpu_units?: number | undefined;
413
+ special_permissions?: string[] | undefined;
414
+ } | undefined;
415
+ }, {
416
+ id: string;
417
+ description: string;
418
+ name: string;
419
+ trigger_words: string[];
420
+ max_concurrent_tasks?: number | undefined;
421
+ estimated_duration_ms?: number | undefined;
422
+ dependencies?: string[] | undefined;
423
+ resource_requirements?: {
424
+ memory_mb?: number | undefined;
425
+ cpu_units?: number | undefined;
426
+ special_permissions?: string[] | undefined;
427
+ } | undefined;
428
+ }>, "many">;
429
+ }, "strip", z.ZodTypeAny, {
430
+ callsign: string;
431
+ spawned_by: string;
432
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
433
+ capabilities: {
434
+ id: string;
435
+ description: string;
436
+ name: string;
437
+ trigger_words: string[];
438
+ max_concurrent_tasks: number;
439
+ estimated_duration_ms?: number | undefined;
440
+ dependencies?: string[] | undefined;
441
+ resource_requirements?: {
442
+ memory_mb?: number | undefined;
443
+ cpu_units?: number | undefined;
444
+ special_permissions?: string[] | undefined;
445
+ } | undefined;
446
+ }[];
447
+ agent_id: string;
448
+ config?: Record<string, unknown> | undefined;
449
+ }, {
450
+ callsign: string;
451
+ spawned_by: string;
452
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
453
+ capabilities: {
454
+ id: string;
455
+ description: string;
456
+ name: string;
457
+ trigger_words: string[];
458
+ max_concurrent_tasks?: number | undefined;
459
+ estimated_duration_ms?: number | undefined;
460
+ dependencies?: string[] | undefined;
461
+ resource_requirements?: {
462
+ memory_mb?: number | undefined;
463
+ cpu_units?: number | undefined;
464
+ special_permissions?: string[] | undefined;
465
+ } | undefined;
466
+ }[];
467
+ agent_id: string;
468
+ config?: Record<string, unknown> | undefined;
469
+ }>;
470
+ }, "strip", z.ZodTypeAny, {
471
+ id: string;
472
+ type: "agent_spawned";
473
+ project_key: string;
474
+ timestamp: string;
475
+ sequence: number;
476
+ data: {
477
+ callsign: string;
478
+ spawned_by: string;
479
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
480
+ capabilities: {
481
+ id: string;
482
+ description: string;
483
+ name: string;
484
+ trigger_words: string[];
485
+ max_concurrent_tasks: number;
486
+ estimated_duration_ms?: number | undefined;
487
+ dependencies?: string[] | undefined;
488
+ resource_requirements?: {
489
+ memory_mb?: number | undefined;
490
+ cpu_units?: number | undefined;
491
+ special_permissions?: string[] | undefined;
492
+ } | undefined;
493
+ }[];
494
+ agent_id: string;
495
+ config?: Record<string, unknown> | undefined;
496
+ };
497
+ }, {
498
+ id: string;
499
+ type: "agent_spawned";
500
+ project_key: string;
501
+ timestamp: string;
502
+ sequence: number;
503
+ data: {
504
+ callsign: string;
505
+ spawned_by: string;
506
+ agent_type: "architect-advisor" | "backend-architect" | "infrastructure-builder" | "full-stack-developer" | "frontend-reviewer" | "api-builder-advanced" | "code-reviewer" | "test-generator" | "security-scanner" | "deployment-engineer" | "monitoring-expert" | "accessibility-pro" | "ux-optimizer" | "compliance-expert" | "performance-engineer" | "database-expert";
507
+ capabilities: {
508
+ id: string;
509
+ description: string;
510
+ name: string;
511
+ trigger_words: string[];
512
+ max_concurrent_tasks?: number | undefined;
513
+ estimated_duration_ms?: number | undefined;
514
+ dependencies?: string[] | undefined;
515
+ resource_requirements?: {
516
+ memory_mb?: number | undefined;
517
+ cpu_units?: number | undefined;
518
+ special_permissions?: string[] | undefined;
519
+ } | undefined;
520
+ }[];
521
+ agent_id: string;
522
+ config?: Record<string, unknown> | undefined;
523
+ };
524
+ }>;
525
+ export declare const AgentTerminatedSchema: z.ZodObject<{
526
+ id: z.ZodString;
527
+ project_key: z.ZodString;
528
+ timestamp: z.ZodString;
529
+ sequence: z.ZodNumber;
530
+ } & {
531
+ type: z.ZodLiteral<"agent_terminated">;
532
+ data: z.ZodObject<{
533
+ agent_id: z.ZodString;
534
+ callsign: z.ZodString;
535
+ terminated_by: z.ZodString;
536
+ reason: z.ZodEnum<["completed", "error", "timeout", "manual", "resource_limit", "escalation"]>;
537
+ exit_code: z.ZodOptional<z.ZodNumber>;
538
+ final_state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
539
+ active_assignments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
540
+ }, "strip", z.ZodTypeAny, {
541
+ callsign: string;
542
+ reason: "completed" | "error" | "timeout" | "manual" | "resource_limit" | "escalation";
543
+ terminated_by: string;
544
+ agent_id: string;
545
+ exit_code?: number | undefined;
546
+ final_state?: Record<string, unknown> | undefined;
547
+ active_assignments?: string[] | undefined;
548
+ }, {
549
+ callsign: string;
550
+ reason: "completed" | "error" | "timeout" | "manual" | "resource_limit" | "escalation";
551
+ terminated_by: string;
552
+ agent_id: string;
553
+ exit_code?: number | undefined;
554
+ final_state?: Record<string, unknown> | undefined;
555
+ active_assignments?: string[] | undefined;
556
+ }>;
557
+ }, "strip", z.ZodTypeAny, {
558
+ id: string;
559
+ type: "agent_terminated";
560
+ project_key: string;
561
+ timestamp: string;
562
+ sequence: number;
563
+ data: {
564
+ callsign: string;
565
+ reason: "completed" | "error" | "timeout" | "manual" | "resource_limit" | "escalation";
566
+ terminated_by: string;
567
+ agent_id: string;
568
+ exit_code?: number | undefined;
569
+ final_state?: Record<string, unknown> | undefined;
570
+ active_assignments?: string[] | undefined;
571
+ };
572
+ }, {
573
+ id: string;
574
+ type: "agent_terminated";
575
+ project_key: string;
576
+ timestamp: string;
577
+ sequence: number;
578
+ data: {
579
+ callsign: string;
580
+ reason: "completed" | "error" | "timeout" | "manual" | "resource_limit" | "escalation";
581
+ terminated_by: string;
582
+ agent_id: string;
583
+ exit_code?: number | undefined;
584
+ final_state?: Record<string, unknown> | undefined;
585
+ active_assignments?: string[] | undefined;
586
+ };
587
+ }>;
588
+ /**
589
+ * Agent Coordination Events
590
+ */
591
+ export declare const AgentCoordinationSchema: z.ZodObject<{
592
+ id: z.ZodString;
593
+ project_key: z.ZodString;
594
+ timestamp: z.ZodString;
595
+ sequence: z.ZodNumber;
596
+ } & {
597
+ type: z.ZodLiteral<"agent_coordination">;
598
+ data: z.ZodObject<{
599
+ coordination_id: z.ZodString;
600
+ coordinator_agent: z.ZodString;
601
+ participating_agents: z.ZodArray<z.ZodString, "many">;
602
+ coordination_type: z.ZodEnum<["sequential", "parallel", "hierarchical", "peer_review"]>;
603
+ context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
604
+ status: z.ZodEnum<["initiated", "in_progress", "completed", "failed"]>;
605
+ started_at: z.ZodString;
606
+ completed_at: z.ZodOptional<z.ZodString>;
607
+ }, "strip", z.ZodTypeAny, {
608
+ status: "completed" | "failed" | "in_progress" | "initiated";
609
+ started_at: string;
610
+ context: Record<string, unknown>;
611
+ coordination_id: string;
612
+ coordinator_agent: string;
613
+ participating_agents: string[];
614
+ coordination_type: "sequential" | "parallel" | "hierarchical" | "peer_review";
615
+ completed_at?: string | undefined;
616
+ }, {
617
+ status: "completed" | "failed" | "in_progress" | "initiated";
618
+ started_at: string;
619
+ context: Record<string, unknown>;
620
+ coordination_id: string;
621
+ coordinator_agent: string;
622
+ participating_agents: string[];
623
+ coordination_type: "sequential" | "parallel" | "hierarchical" | "peer_review";
624
+ completed_at?: string | undefined;
625
+ }>;
626
+ }, "strip", z.ZodTypeAny, {
627
+ id: string;
628
+ type: "agent_coordination";
629
+ project_key: string;
630
+ timestamp: string;
631
+ sequence: number;
632
+ data: {
633
+ status: "completed" | "failed" | "in_progress" | "initiated";
634
+ started_at: string;
635
+ context: Record<string, unknown>;
636
+ coordination_id: string;
637
+ coordinator_agent: string;
638
+ participating_agents: string[];
639
+ coordination_type: "sequential" | "parallel" | "hierarchical" | "peer_review";
640
+ completed_at?: string | undefined;
641
+ };
642
+ }, {
643
+ id: string;
644
+ type: "agent_coordination";
645
+ project_key: string;
646
+ timestamp: string;
647
+ sequence: number;
648
+ data: {
649
+ status: "completed" | "failed" | "in_progress" | "initiated";
650
+ started_at: string;
651
+ context: Record<string, unknown>;
652
+ coordination_id: string;
653
+ coordinator_agent: string;
654
+ participating_agents: string[];
655
+ coordination_type: "sequential" | "parallel" | "hierarchical" | "peer_review";
656
+ completed_at?: string | undefined;
657
+ };
658
+ }>;
659
+ /**
660
+ * File Coordination for Agent Handoffs
661
+ */
662
+ export declare const AgentFileHandoffSchema: z.ZodObject<{
663
+ id: z.ZodString;
664
+ project_key: z.ZodString;
665
+ timestamp: z.ZodString;
666
+ sequence: z.ZodNumber;
667
+ } & {
668
+ type: z.ZodLiteral<"agent_file_handoff">;
669
+ data: z.ZodObject<{
670
+ handoff_id: z.ZodString;
671
+ file_path: z.ZodString;
672
+ from_agent: z.ZodString;
673
+ to_agent: z.ZodString;
674
+ handoff_type: z.ZodEnum<["edit_continuation", "review", "testing", "deployment"]>;
675
+ context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
676
+ ctk_lock_id: z.ZodOptional<z.ZodString>;
677
+ handoff_status: z.ZodEnum<["requested", "accepted", "in_progress", "completed", "failed"]>;
678
+ requested_at: z.ZodString;
679
+ completed_at: z.ZodOptional<z.ZodString>;
680
+ }, "strip", z.ZodTypeAny, {
681
+ from_agent: string;
682
+ to_agent: string;
683
+ handoff_id: string;
684
+ file_path: string;
685
+ handoff_type: "edit_continuation" | "review" | "testing" | "deployment";
686
+ handoff_status: "completed" | "failed" | "accepted" | "in_progress" | "requested";
687
+ requested_at: string;
688
+ completed_at?: string | undefined;
689
+ context?: Record<string, unknown> | undefined;
690
+ ctk_lock_id?: string | undefined;
691
+ }, {
692
+ from_agent: string;
693
+ to_agent: string;
694
+ handoff_id: string;
695
+ file_path: string;
696
+ handoff_type: "edit_continuation" | "review" | "testing" | "deployment";
697
+ handoff_status: "completed" | "failed" | "accepted" | "in_progress" | "requested";
698
+ requested_at: string;
699
+ completed_at?: string | undefined;
700
+ context?: Record<string, unknown> | undefined;
701
+ ctk_lock_id?: string | undefined;
702
+ }>;
703
+ }, "strip", z.ZodTypeAny, {
704
+ id: string;
705
+ type: "agent_file_handoff";
706
+ project_key: string;
707
+ timestamp: string;
708
+ sequence: number;
709
+ data: {
710
+ from_agent: string;
711
+ to_agent: string;
712
+ handoff_id: string;
713
+ file_path: string;
714
+ handoff_type: "edit_continuation" | "review" | "testing" | "deployment";
715
+ handoff_status: "completed" | "failed" | "accepted" | "in_progress" | "requested";
716
+ requested_at: string;
717
+ completed_at?: string | undefined;
718
+ context?: Record<string, unknown> | undefined;
719
+ ctk_lock_id?: string | undefined;
720
+ };
721
+ }, {
722
+ id: string;
723
+ type: "agent_file_handoff";
724
+ project_key: string;
725
+ timestamp: string;
726
+ sequence: number;
727
+ data: {
728
+ from_agent: string;
729
+ to_agent: string;
730
+ handoff_id: string;
731
+ file_path: string;
732
+ handoff_type: "edit_continuation" | "review" | "testing" | "deployment";
733
+ handoff_status: "completed" | "failed" | "accepted" | "in_progress" | "requested";
734
+ requested_at: string;
735
+ completed_at?: string | undefined;
736
+ context?: Record<string, unknown> | undefined;
737
+ ctk_lock_id?: string | undefined;
738
+ };
739
+ }>;
740
+ /**
741
+ * Agent Performance Metrics
742
+ */
743
+ export declare const AgentMetricsSchema: z.ZodObject<{
744
+ agent_id: z.ZodString;
745
+ timestamp: z.ZodString;
746
+ metrics: z.ZodObject<{
747
+ tasks_completed: z.ZodNumber;
748
+ tasks_failed: z.ZodNumber;
749
+ average_task_duration_ms: z.ZodNumber;
750
+ success_rate: z.ZodNumber;
751
+ current_workload: z.ZodNumber;
752
+ resource_usage: z.ZodObject<{
753
+ memory_mb: z.ZodNumber;
754
+ cpu_percent: z.ZodNumber;
755
+ active_connections: z.ZodNumber;
756
+ }, "strip", z.ZodTypeAny, {
757
+ memory_mb: number;
758
+ cpu_percent: number;
759
+ active_connections: number;
760
+ }, {
761
+ memory_mb: number;
762
+ cpu_percent: number;
763
+ active_connections: number;
764
+ }>;
765
+ communication_metrics: z.ZodObject<{
766
+ messages_sent: z.ZodNumber;
767
+ messages_received: z.ZodNumber;
768
+ average_response_time_ms: z.ZodNumber;
769
+ }, "strip", z.ZodTypeAny, {
770
+ messages_sent: number;
771
+ messages_received: number;
772
+ average_response_time_ms: number;
773
+ }, {
774
+ messages_sent: number;
775
+ messages_received: number;
776
+ average_response_time_ms: number;
777
+ }>;
778
+ }, "strip", z.ZodTypeAny, {
779
+ current_workload: number;
780
+ tasks_completed: number;
781
+ tasks_failed: number;
782
+ average_task_duration_ms: number;
783
+ success_rate: number;
784
+ resource_usage: {
785
+ memory_mb: number;
786
+ cpu_percent: number;
787
+ active_connections: number;
788
+ };
789
+ communication_metrics: {
790
+ messages_sent: number;
791
+ messages_received: number;
792
+ average_response_time_ms: number;
793
+ };
794
+ }, {
795
+ current_workload: number;
796
+ tasks_completed: number;
797
+ tasks_failed: number;
798
+ average_task_duration_ms: number;
799
+ success_rate: number;
800
+ resource_usage: {
801
+ memory_mb: number;
802
+ cpu_percent: number;
803
+ active_connections: number;
804
+ };
805
+ communication_metrics: {
806
+ messages_sent: number;
807
+ messages_received: number;
808
+ average_response_time_ms: number;
809
+ };
810
+ }>;
811
+ }, "strip", z.ZodTypeAny, {
812
+ timestamp: string;
813
+ metrics: {
814
+ current_workload: number;
815
+ tasks_completed: number;
816
+ tasks_failed: number;
817
+ average_task_duration_ms: number;
818
+ success_rate: number;
819
+ resource_usage: {
820
+ memory_mb: number;
821
+ cpu_percent: number;
822
+ active_connections: number;
823
+ };
824
+ communication_metrics: {
825
+ messages_sent: number;
826
+ messages_received: number;
827
+ average_response_time_ms: number;
828
+ };
829
+ };
830
+ agent_id: string;
831
+ }, {
832
+ timestamp: string;
833
+ metrics: {
834
+ current_workload: number;
835
+ tasks_completed: number;
836
+ tasks_failed: number;
837
+ average_task_duration_ms: number;
838
+ success_rate: number;
839
+ resource_usage: {
840
+ memory_mb: number;
841
+ cpu_percent: number;
842
+ active_connections: number;
843
+ };
844
+ communication_metrics: {
845
+ messages_sent: number;
846
+ messages_received: number;
847
+ average_response_time_ms: number;
848
+ };
849
+ };
850
+ agent_id: string;
851
+ }>;
852
+ /**
853
+ * Agent Task Dependencies
854
+ */
855
+ export declare const TaskDependencySchema: z.ZodObject<{
856
+ dependency_id: z.ZodString;
857
+ task_id: z.ZodString;
858
+ depends_on_task: z.ZodString;
859
+ dependency_type: z.ZodEnum<["completion", "success", "data", "resource"]>;
860
+ required_agent: z.ZodOptional<z.ZodString>;
861
+ }, "strip", z.ZodTypeAny, {
862
+ dependency_id: string;
863
+ task_id: string;
864
+ depends_on_task: string;
865
+ dependency_type: "data" | "success" | "completion" | "resource";
866
+ required_agent?: string | undefined;
867
+ }, {
868
+ dependency_id: string;
869
+ task_id: string;
870
+ depends_on_task: string;
871
+ dependency_type: "data" | "success" | "completion" | "resource";
872
+ required_agent?: string | undefined;
873
+ }>;
874
+ /**
875
+ * Agent Health Status
876
+ */
877
+ export declare const AgentHealthSchema: z.ZodObject<{
878
+ agent_id: z.ZodString;
879
+ status: z.ZodEnum<["healthy", "degraded", "unhealthy", "offline"]>;
880
+ last_check: z.ZodString;
881
+ checks: z.ZodObject<{
882
+ heartbeat: z.ZodBoolean;
883
+ memory_usage: z.ZodBoolean;
884
+ cpu_usage: z.ZodBoolean;
885
+ communication: z.ZodBoolean;
886
+ task_processing: z.ZodBoolean;
887
+ }, "strip", z.ZodTypeAny, {
888
+ heartbeat: boolean;
889
+ memory_usage: boolean;
890
+ cpu_usage: boolean;
891
+ communication: boolean;
892
+ task_processing: boolean;
893
+ }, {
894
+ heartbeat: boolean;
895
+ memory_usage: boolean;
896
+ cpu_usage: boolean;
897
+ communication: boolean;
898
+ task_processing: boolean;
899
+ }>;
900
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
901
+ type: z.ZodString;
902
+ severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
903
+ message: z.ZodString;
904
+ detected_at: z.ZodString;
905
+ }, "strip", z.ZodTypeAny, {
906
+ type: string;
907
+ message: string;
908
+ severity: "error" | "critical" | "info" | "warning";
909
+ detected_at: string;
910
+ }, {
911
+ type: string;
912
+ message: string;
913
+ severity: "error" | "critical" | "info" | "warning";
914
+ detected_at: string;
915
+ }>, "many">>;
916
+ }, "strip", z.ZodTypeAny, {
917
+ status: "offline" | "healthy" | "degraded" | "unhealthy";
918
+ agent_id: string;
919
+ last_check: string;
920
+ checks: {
921
+ heartbeat: boolean;
922
+ memory_usage: boolean;
923
+ cpu_usage: boolean;
924
+ communication: boolean;
925
+ task_processing: boolean;
926
+ };
927
+ issues?: {
928
+ type: string;
929
+ message: string;
930
+ severity: "error" | "critical" | "info" | "warning";
931
+ detected_at: string;
932
+ }[] | undefined;
933
+ }, {
934
+ status: "offline" | "healthy" | "degraded" | "unhealthy";
935
+ agent_id: string;
936
+ last_check: string;
937
+ checks: {
938
+ heartbeat: boolean;
939
+ memory_usage: boolean;
940
+ cpu_usage: boolean;
941
+ communication: boolean;
942
+ task_processing: boolean;
943
+ };
944
+ issues?: {
945
+ type: string;
946
+ message: string;
947
+ severity: "error" | "critical" | "info" | "warning";
948
+ detected_at: string;
949
+ }[] | undefined;
950
+ }>;
951
+ /**
952
+ * Type Exports
953
+ */
954
+ export type AgentCapability = z.infer<typeof AgentCapabilitySchema>;
955
+ export type AgentRegistry = z.infer<typeof AgentRegistrySchema>;
956
+ export type AgentAssignment = z.infer<typeof AgentAssignmentSchema>;
957
+ export type AgentMessage = z.infer<typeof AgentMessageSchema>;
958
+ export type WorkPriority = z.infer<typeof WorkPrioritySchema>;
959
+ export type AssignmentConfig = z.infer<typeof AssignmentConfigSchema>;
960
+ export type AgentSpawnedEvent = z.infer<typeof AgentSpawnedSchema>;
961
+ export type AgentTerminatedEvent = z.infer<typeof AgentTerminatedSchema>;
962
+ export type AgentCoordinationEvent = z.infer<typeof AgentCoordinationSchema>;
963
+ export type AgentFileHandoffEvent = z.infer<typeof AgentFileHandoffSchema>;
964
+ export type AgentMetrics = z.infer<typeof AgentMetricsSchema>;
965
+ export type TaskDependency = z.infer<typeof TaskDependencySchema>;
966
+ export type AgentHealth = z.infer<typeof AgentHealthSchema>;
967
+ /**
968
+ * Agent Coordination System Configuration
969
+ */
970
+ export declare const AgentCoordinationConfigSchema: z.ZodObject<{
971
+ max_concurrent_agents: z.ZodDefault<z.ZodNumber>;
972
+ default_assignment_timeout_ms: z.ZodDefault<z.ZodNumber>;
973
+ heartbeat_interval_ms: z.ZodDefault<z.ZodNumber>;
974
+ agent_timeout_ms: z.ZodDefault<z.ZodNumber>;
975
+ task_retry_limit: z.ZodDefault<z.ZodNumber>;
976
+ escalation_threshold: z.ZodDefault<z.ZodNumber>;
977
+ communication_timeout_ms: z.ZodDefault<z.ZodNumber>;
978
+ enable_auto_scaling: z.ZodDefault<z.ZodBoolean>;
979
+ enable_load_balancing: z.ZodDefault<z.ZodBoolean>;
980
+ enable_priority_routing: z.ZodDefault<z.ZodBoolean>;
981
+ }, "strip", z.ZodTypeAny, {
982
+ max_concurrent_agents: number;
983
+ default_assignment_timeout_ms: number;
984
+ heartbeat_interval_ms: number;
985
+ agent_timeout_ms: number;
986
+ task_retry_limit: number;
987
+ escalation_threshold: number;
988
+ communication_timeout_ms: number;
989
+ enable_auto_scaling: boolean;
990
+ enable_load_balancing: boolean;
991
+ enable_priority_routing: boolean;
992
+ }, {
993
+ max_concurrent_agents?: number | undefined;
994
+ default_assignment_timeout_ms?: number | undefined;
995
+ heartbeat_interval_ms?: number | undefined;
996
+ agent_timeout_ms?: number | undefined;
997
+ task_retry_limit?: number | undefined;
998
+ escalation_threshold?: number | undefined;
999
+ communication_timeout_ms?: number | undefined;
1000
+ enable_auto_scaling?: boolean | undefined;
1001
+ enable_load_balancing?: boolean | undefined;
1002
+ enable_priority_routing?: boolean | undefined;
1003
+ }>;
1004
+ export type AgentCoordinationConfig = z.infer<typeof AgentCoordinationConfigSchema>;
1005
+ //# sourceMappingURL=agents.d.ts.map