@cogitator-ai/swarms 0.1.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 (99) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +90 -0
  3. package/dist/communication/blackboard.d.ts +24 -0
  4. package/dist/communication/blackboard.d.ts.map +1 -0
  5. package/dist/communication/blackboard.js +135 -0
  6. package/dist/communication/blackboard.js.map +1 -0
  7. package/dist/communication/event-emitter.d.ts +20 -0
  8. package/dist/communication/event-emitter.d.ts.map +1 -0
  9. package/dist/communication/event-emitter.js +87 -0
  10. package/dist/communication/event-emitter.js.map +1 -0
  11. package/dist/communication/index.d.ts +7 -0
  12. package/dist/communication/index.d.ts.map +1 -0
  13. package/dist/communication/index.js +7 -0
  14. package/dist/communication/index.js.map +1 -0
  15. package/dist/communication/message-bus.d.ts +23 -0
  16. package/dist/communication/message-bus.d.ts.map +1 -0
  17. package/dist/communication/message-bus.js +128 -0
  18. package/dist/communication/message-bus.js.map +1 -0
  19. package/dist/coordinator.d.ts +44 -0
  20. package/dist/coordinator.d.ts.map +1 -0
  21. package/dist/coordinator.js +283 -0
  22. package/dist/coordinator.js.map +1 -0
  23. package/dist/index.d.ts +13 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +12 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/resources/circuit-breaker.d.ts +29 -0
  28. package/dist/resources/circuit-breaker.d.ts.map +1 -0
  29. package/dist/resources/circuit-breaker.js +82 -0
  30. package/dist/resources/circuit-breaker.js.map +1 -0
  31. package/dist/resources/index.d.ts +7 -0
  32. package/dist/resources/index.d.ts.map +1 -0
  33. package/dist/resources/index.js +6 -0
  34. package/dist/resources/index.js.map +1 -0
  35. package/dist/resources/tracker.d.ts +30 -0
  36. package/dist/resources/tracker.d.ts.map +1 -0
  37. package/dist/resources/tracker.js +84 -0
  38. package/dist/resources/tracker.js.map +1 -0
  39. package/dist/strategies/auction.d.ts +17 -0
  40. package/dist/strategies/auction.d.ts.map +1 -0
  41. package/dist/strategies/auction.js +204 -0
  42. package/dist/strategies/auction.js.map +1 -0
  43. package/dist/strategies/base.d.ts +34 -0
  44. package/dist/strategies/base.d.ts.map +1 -0
  45. package/dist/strategies/base.js +74 -0
  46. package/dist/strategies/base.js.map +1 -0
  47. package/dist/strategies/consensus.d.ts +20 -0
  48. package/dist/strategies/consensus.d.ts.map +1 -0
  49. package/dist/strategies/consensus.js +328 -0
  50. package/dist/strategies/consensus.js.map +1 -0
  51. package/dist/strategies/debate.d.ts +15 -0
  52. package/dist/strategies/debate.d.ts.map +1 -0
  53. package/dist/strategies/debate.js +171 -0
  54. package/dist/strategies/debate.js.map +1 -0
  55. package/dist/strategies/hierarchical.d.ts +13 -0
  56. package/dist/strategies/hierarchical.d.ts.map +1 -0
  57. package/dist/strategies/hierarchical.js +86 -0
  58. package/dist/strategies/hierarchical.js.map +1 -0
  59. package/dist/strategies/index.d.ts +28 -0
  60. package/dist/strategies/index.d.ts.map +1 -0
  61. package/dist/strategies/index.js +106 -0
  62. package/dist/strategies/index.js.map +1 -0
  63. package/dist/strategies/pipeline.d.ts +16 -0
  64. package/dist/strategies/pipeline.d.ts.map +1 -0
  65. package/dist/strategies/pipeline.js +180 -0
  66. package/dist/strategies/pipeline.js.map +1 -0
  67. package/dist/strategies/round-robin.d.ts +27 -0
  68. package/dist/strategies/round-robin.d.ts.map +1 -0
  69. package/dist/strategies/round-robin.js +98 -0
  70. package/dist/strategies/round-robin.js.map +1 -0
  71. package/dist/swarm.d.ts +113 -0
  72. package/dist/swarm.d.ts.map +1 -0
  73. package/dist/swarm.js +280 -0
  74. package/dist/swarm.js.map +1 -0
  75. package/dist/tools/blackboard.d.ts +71 -0
  76. package/dist/tools/blackboard.d.ts.map +1 -0
  77. package/dist/tools/blackboard.js +149 -0
  78. package/dist/tools/blackboard.js.map +1 -0
  79. package/dist/tools/delegation.d.ts +120 -0
  80. package/dist/tools/delegation.d.ts.map +1 -0
  81. package/dist/tools/delegation.js +257 -0
  82. package/dist/tools/delegation.js.map +1 -0
  83. package/dist/tools/index.d.ts +26 -0
  84. package/dist/tools/index.d.ts.map +1 -0
  85. package/dist/tools/index.js +65 -0
  86. package/dist/tools/index.js.map +1 -0
  87. package/dist/tools/messaging.d.ts +73 -0
  88. package/dist/tools/messaging.d.ts.map +1 -0
  89. package/dist/tools/messaging.js +146 -0
  90. package/dist/tools/messaging.js.map +1 -0
  91. package/dist/tools/voting.d.ts +110 -0
  92. package/dist/tools/voting.d.ts.map +1 -0
  93. package/dist/tools/voting.js +201 -0
  94. package/dist/tools/voting.js.map +1 -0
  95. package/dist/workflow/swarm-node.d.ts +43 -0
  96. package/dist/workflow/swarm-node.d.ts.map +1 -0
  97. package/dist/workflow/swarm-node.js +111 -0
  98. package/dist/workflow/swarm-node.js.map +1 -0
  99. package/package.json +45 -0
@@ -0,0 +1,257 @@
1
+ /**
2
+ * Swarm delegation tools for hierarchical task management
3
+ */
4
+ import { z } from 'zod';
5
+ import { tool } from '@cogitator-ai/core';
6
+ /**
7
+ * Create delegation tools for supervisor agents
8
+ */
9
+ export function createDelegationTools(coordinator, blackboard, currentAgent) {
10
+ const delegateTask = tool({
11
+ name: 'delegate_task',
12
+ description: 'Delegate a task to a worker agent',
13
+ parameters: z.object({
14
+ worker: z.string().describe('Name of the worker agent to delegate to'),
15
+ task: z.string().describe('The task description to delegate'),
16
+ context: z.record(z.unknown()).optional().describe('Additional context for the worker'),
17
+ priority: z.enum(['high', 'normal', 'low']).optional().describe('Task priority'),
18
+ waitForCompletion: z.boolean().optional().describe('Wait for worker to complete (default: true)'),
19
+ }),
20
+ execute: async ({ worker, task, context, priority = 'normal', waitForCompletion = true }) => {
21
+ const workerAgent = coordinator.getAgent(worker);
22
+ if (!workerAgent) {
23
+ return {
24
+ success: false,
25
+ error: `Worker agent '${worker}' not found`,
26
+ availableWorkers: coordinator.getAgentsByRole('worker').map(a => a.agent.name),
27
+ };
28
+ }
29
+ const tasks = blackboard.read('tasks') ?? [];
30
+ const taskId = `task_${Date.now()}_${worker}`;
31
+ tasks.push({
32
+ id: taskId,
33
+ worker,
34
+ task,
35
+ status: 'delegated',
36
+ delegatedBy: currentAgent,
37
+ timestamp: Date.now(),
38
+ });
39
+ blackboard.write('tasks', tasks, currentAgent);
40
+ if (!waitForCompletion) {
41
+ coordinator.runAgent(worker, task, {
42
+ ...context,
43
+ delegationContext: {
44
+ delegatedBy: currentAgent,
45
+ taskId,
46
+ priority,
47
+ },
48
+ }).then(result => {
49
+ const currentTasks = blackboard.read('tasks') ?? [];
50
+ const taskIndex = currentTasks.findIndex(t => t.id === taskId);
51
+ if (taskIndex >= 0) {
52
+ currentTasks[taskIndex].status = 'completed';
53
+ }
54
+ blackboard.write('tasks', currentTasks, worker);
55
+ const workerResults = blackboard.read('workerResults') ?? {};
56
+ workerResults[taskId] = result.output;
57
+ blackboard.write('workerResults', workerResults, worker);
58
+ }).catch(() => {
59
+ const currentTasks = blackboard.read('tasks') ?? [];
60
+ const taskIndex = currentTasks.findIndex(t => t.id === taskId);
61
+ if (taskIndex >= 0) {
62
+ currentTasks[taskIndex].status = 'failed';
63
+ }
64
+ blackboard.write('tasks', currentTasks, worker);
65
+ });
66
+ return {
67
+ success: true,
68
+ taskId,
69
+ worker,
70
+ async: true,
71
+ message: `Task delegated to ${worker}, running in background`,
72
+ };
73
+ }
74
+ try {
75
+ const result = await coordinator.runAgent(worker, task, {
76
+ ...context,
77
+ delegationContext: {
78
+ delegatedBy: currentAgent,
79
+ taskId,
80
+ priority,
81
+ },
82
+ });
83
+ const currentTasks = blackboard.read('tasks') ?? [];
84
+ const taskIndex = currentTasks.findIndex(t => t.id === taskId);
85
+ if (taskIndex >= 0) {
86
+ currentTasks[taskIndex].status = 'completed';
87
+ }
88
+ blackboard.write('tasks', currentTasks, worker);
89
+ const workerResults = blackboard.read('workerResults') ?? {};
90
+ workerResults[taskId] = result.output;
91
+ blackboard.write('workerResults', workerResults, worker);
92
+ return {
93
+ success: true,
94
+ taskId,
95
+ worker,
96
+ output: result.output,
97
+ usage: {
98
+ tokens: result.usage.totalTokens,
99
+ cost: result.usage.cost,
100
+ duration: result.usage.duration,
101
+ },
102
+ };
103
+ }
104
+ catch (error) {
105
+ const currentTasks = blackboard.read('tasks') ?? [];
106
+ const taskIndex = currentTasks.findIndex(t => t.id === taskId);
107
+ if (taskIndex >= 0) {
108
+ currentTasks[taskIndex].status = 'failed';
109
+ }
110
+ blackboard.write('tasks', currentTasks, worker);
111
+ return {
112
+ success: false,
113
+ taskId,
114
+ worker,
115
+ error: error instanceof Error ? error.message : 'Worker failed',
116
+ };
117
+ }
118
+ },
119
+ });
120
+ const checkProgress = tool({
121
+ name: 'check_progress',
122
+ description: 'Check the progress and state of a worker agent',
123
+ parameters: z.object({
124
+ worker: z.string().describe('Name of the worker agent to check'),
125
+ }),
126
+ execute: async ({ worker }) => {
127
+ const workerAgent = coordinator.getAgent(worker);
128
+ if (!workerAgent) {
129
+ return {
130
+ found: false,
131
+ error: `Worker agent '${worker}' not found`,
132
+ };
133
+ }
134
+ const tasks = blackboard.read('tasks') ?? [];
135
+ const workerTasks = tasks.filter(t => t.worker === worker);
136
+ const lastTask = workerTasks[workerTasks.length - 1];
137
+ const workerResults = blackboard.read('workerResults') ?? {};
138
+ const lastResult = lastTask ? workerResults[lastTask.id] : undefined;
139
+ return {
140
+ found: true,
141
+ worker,
142
+ state: workerAgent.state,
143
+ tokenCount: workerAgent.tokenCount,
144
+ tasks: {
145
+ total: workerTasks.length,
146
+ completed: workerTasks.filter(t => t.status === 'completed').length,
147
+ pending: workerTasks.filter(t => t.status === 'delegated').length,
148
+ failed: workerTasks.filter(t => t.status === 'failed').length,
149
+ },
150
+ lastTask: lastTask ? {
151
+ id: lastTask.id,
152
+ task: lastTask.task.slice(0, 200),
153
+ status: lastTask.status,
154
+ result: typeof lastResult === 'string' ? lastResult.slice(0, 500) : lastResult,
155
+ } : null,
156
+ };
157
+ },
158
+ });
159
+ const requestRevision = tool({
160
+ name: 'request_revision',
161
+ description: 'Ask a worker to revise their previous work',
162
+ parameters: z.object({
163
+ worker: z.string().describe('Name of the worker agent'),
164
+ feedback: z.string().describe('Feedback on what needs to be revised'),
165
+ taskId: z.string().optional().describe('Specific task ID to revise (uses last task if omitted)'),
166
+ }),
167
+ execute: async ({ worker, feedback, taskId }) => {
168
+ const workerAgent = coordinator.getAgent(worker);
169
+ if (!workerAgent) {
170
+ return {
171
+ success: false,
172
+ error: `Worker agent '${worker}' not found`,
173
+ };
174
+ }
175
+ const tasks = blackboard.read('tasks') ?? [];
176
+ const workerTasks = tasks.filter(t => t.worker === worker);
177
+ const targetTask = taskId
178
+ ? workerTasks.find(t => t.id === taskId)
179
+ : workerTasks[workerTasks.length - 1];
180
+ if (!targetTask) {
181
+ return {
182
+ success: false,
183
+ error: taskId ? `Task '${taskId}' not found` : 'No previous task found for this worker',
184
+ };
185
+ }
186
+ const workerResults = blackboard.read('workerResults') ?? {};
187
+ const previousResult = workerResults[targetTask.id];
188
+ const revisionInput = `
189
+ REVISION REQUEST
190
+
191
+ Your previous work on this task needs revision.
192
+
193
+ Original task:
194
+ ${targetTask.task}
195
+
196
+ Your previous output:
197
+ ${typeof previousResult === 'string' ? previousResult : JSON.stringify(previousResult)}
198
+
199
+ Feedback:
200
+ ${feedback}
201
+
202
+ Please provide a revised response addressing the feedback.
203
+ `.trim();
204
+ const result = await coordinator.runAgent(worker, revisionInput, {
205
+ delegationContext: {
206
+ delegatedBy: currentAgent,
207
+ taskId: targetTask.id,
208
+ isRevision: true,
209
+ originalTask: targetTask.task,
210
+ },
211
+ });
212
+ workerResults[targetTask.id] = result.output;
213
+ blackboard.write('workerResults', workerResults, worker);
214
+ const updatedTasks = blackboard.read('tasks') ?? [];
215
+ const taskIndex = updatedTasks.findIndex(t => t.id === targetTask.id);
216
+ if (taskIndex >= 0) {
217
+ updatedTasks[taskIndex].status = 'revised';
218
+ }
219
+ blackboard.write('tasks', updatedTasks, worker);
220
+ return {
221
+ success: true,
222
+ taskId: targetTask.id,
223
+ worker,
224
+ revisedOutput: result.output,
225
+ };
226
+ },
227
+ });
228
+ const listWorkers = tool({
229
+ name: 'list_workers',
230
+ description: 'List all available worker agents and their status',
231
+ parameters: z.object({
232
+ includeMetadata: z.boolean().optional().describe('Include worker metadata like expertise'),
233
+ }),
234
+ execute: async ({ includeMetadata }) => {
235
+ const workers = coordinator.getAgentsByRole('worker');
236
+ return {
237
+ count: workers.length,
238
+ workers: workers.map(w => ({
239
+ name: w.agent.name,
240
+ state: w.state,
241
+ tokenCount: w.tokenCount,
242
+ ...(includeMetadata ? {
243
+ expertise: w.metadata.expertise ?? [],
244
+ priority: w.metadata.priority ?? 0,
245
+ } : {}),
246
+ })),
247
+ };
248
+ },
249
+ });
250
+ return {
251
+ delegateTask,
252
+ checkProgress,
253
+ requestRevision,
254
+ listWorkers,
255
+ };
256
+ }
257
+ //# sourceMappingURL=delegation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delegation.js","sourceRoot":"","sources":["../../src/tools/delegation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAsC,EACtC,UAAsB,EACtB,YAAoB;IAEpB,MAAM,YAAY,GAAG,IAAI,CAAC;QACxB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,mCAAmC;QAChD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACvF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAChF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAClG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAAE,EAAE,EAAE;YAC1F,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,iBAAiB,MAAM,aAAa;oBAC3C,gBAAgB,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;iBAC/E,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAOxB,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpB,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,MAAM;gBACV,MAAM;gBACN,IAAI;gBACJ,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,YAAY;gBACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YACH,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YAE/C,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE;oBACjC,GAAG,OAAO;oBACV,iBAAiB,EAAE;wBACjB,WAAW,EAAE,YAAY;wBACzB,MAAM;wBACN,QAAQ;qBACT;iBACF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBACf,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAe,OAAO,CAAC,IAAI,EAAE,CAAC;oBAClE,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;oBAC/D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;wBACnB,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC;oBAC/C,CAAC;oBACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;oBAEhD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAA0B,eAAe,CAAC,IAAI,EAAE,CAAC;oBACtF,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;oBACtC,UAAU,CAAC,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;gBAC3D,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACZ,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAe,OAAO,CAAC,IAAI,EAAE,CAAC;oBAClE,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;oBAC/D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;wBACnB,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC;oBAC5C,CAAC;oBACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;gBAClD,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM;oBACN,MAAM;oBACN,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,qBAAqB,MAAM,yBAAyB;iBAC9D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE;oBACtD,GAAG,OAAO;oBACV,iBAAiB,EAAE;wBACjB,WAAW,EAAE,YAAY;wBACzB,MAAM;wBACN,QAAQ;qBACT;iBACF,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAe,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;gBAC/D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC;gBAC/C,CAAC;gBACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;gBAEhD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAA0B,eAAe,CAAC,IAAI,EAAE,CAAC;gBACtF,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;gBACtC,UAAU,CAAC,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;gBAEzD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM;oBACN,MAAM;oBACN,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,KAAK,EAAE;wBACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;wBAChC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;wBACvB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;qBAChC;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAe,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;gBAC/D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC;gBAC5C,CAAC;gBACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;gBAEhD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,MAAM;oBACN,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;iBAChE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,CAAC;QACzB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gDAAgD;QAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACjE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YAC5B,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,iBAAiB,MAAM,aAAa;iBAC5C,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAMxB,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAErD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAA0B,eAAe,CAAC,IAAI,EAAE,CAAC;YACtF,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAErE,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM;gBACN,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,KAAK,EAAE;oBACL,KAAK,EAAE,WAAW,CAAC,MAAM;oBACzB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;oBACnE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;oBACjE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;iBAC9D;gBACD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU;iBAC/E,CAAC,CAAC,CAAC,IAAI;aACT,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,CAAC;QAC3B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,4CAA4C;QACzD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SACjG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;YAC9C,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,iBAAiB,MAAM,aAAa;iBAC5C,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAKxB,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC3D,MAAM,UAAU,GAAG,MAAM;gBACvB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC;gBACxC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,aAAa,CAAC,CAAC,CAAC,wCAAwC;iBACxF,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAA0B,eAAe,CAAC,IAAI,EAAE,CAAC;YACtF,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAEpD,MAAM,aAAa,GAAG;;;;;;EAM1B,UAAU,CAAC,IAAI;;;EAGf,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;EAGpF,QAAQ;;;CAGT,CAAC,IAAI,EAAE,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE;gBAC/D,iBAAiB,EAAE;oBACjB,WAAW,EAAE,YAAY;oBACzB,MAAM,EAAE,UAAU,CAAC,EAAE;oBACrB,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,UAAU,CAAC,IAAI;iBAC9B;aACF,CAAC,CAAC;YAEH,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7C,UAAU,CAAC,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;YAEzD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAe,OAAO,CAAC,IAAI,EAAE,CAAC;YAClE,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;YACtE,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC;YAC7C,CAAC;YACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,UAAU,CAAC,EAAE;gBACrB,MAAM;gBACN,aAAa,EAAE,MAAM,CAAC,MAAM;aAC7B,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC3F,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEtD,OAAO;gBACL,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;oBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;wBACpB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE;wBACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC;qBACnC,CAAC,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,YAAY;QACZ,aAAa;QACb,eAAe;QACf,WAAW;KACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Swarm tools exports
3
+ */
4
+ export { createMessagingTools, type MessagingTools } from './messaging';
5
+ export { createBlackboardTools, type BlackboardTools } from './blackboard';
6
+ export { createDelegationTools, type DelegationTools } from './delegation';
7
+ export { createVotingTools, type VotingTools } from './voting';
8
+ import type { Tool } from '@cogitator-ai/types';
9
+ import type { SwarmCoordinatorInterface, Blackboard, MessageBus, SwarmEventEmitter } from '@cogitator-ai/types';
10
+ export interface SwarmToolContext {
11
+ coordinator: SwarmCoordinatorInterface;
12
+ blackboard: Blackboard;
13
+ messageBus: MessageBus;
14
+ events: SwarmEventEmitter;
15
+ agentName: string;
16
+ agentWeight?: number;
17
+ }
18
+ /**
19
+ * Create all swarm tools for an agent
20
+ */
21
+ export declare function createSwarmTools(context: SwarmToolContext): Tool<unknown, unknown>[];
22
+ /**
23
+ * Create tools for a specific strategy
24
+ */
25
+ export declare function createStrategyTools(strategy: 'hierarchical' | 'consensus' | 'debate' | 'auction' | 'pipeline' | 'round-robin', context: SwarmToolContext): Tool<unknown, unknown>[];
26
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMhH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,yBAAyB,CAAC;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAkCpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,EAC1F,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAiC1B"}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Swarm tools exports
3
+ */
4
+ export { createMessagingTools } from './messaging';
5
+ export { createBlackboardTools } from './blackboard';
6
+ export { createDelegationTools } from './delegation';
7
+ export { createVotingTools } from './voting';
8
+ import { createMessagingTools } from './messaging';
9
+ import { createBlackboardTools } from './blackboard';
10
+ import { createDelegationTools } from './delegation';
11
+ import { createVotingTools } from './voting';
12
+ /**
13
+ * Create all swarm tools for an agent
14
+ */
15
+ export function createSwarmTools(context) {
16
+ const messagingTools = createMessagingTools(context.messageBus, context.agentName);
17
+ const blackboardTools = createBlackboardTools(context.blackboard, context.agentName);
18
+ const delegationTools = createDelegationTools(context.coordinator, context.blackboard, context.agentName);
19
+ const votingTools = createVotingTools(context.blackboard, context.events, context.agentName, context.agentWeight);
20
+ return [
21
+ messagingTools.sendMessage,
22
+ messagingTools.readMessages,
23
+ messagingTools.broadcastMessage,
24
+ messagingTools.replyToMessage,
25
+ blackboardTools.readBlackboard,
26
+ blackboardTools.writeBlackboard,
27
+ blackboardTools.appendBlackboard,
28
+ blackboardTools.listBlackboardSections,
29
+ blackboardTools.getBlackboardHistory,
30
+ delegationTools.delegateTask,
31
+ delegationTools.checkProgress,
32
+ delegationTools.requestRevision,
33
+ delegationTools.listWorkers,
34
+ votingTools.castVote,
35
+ votingTools.getVotes,
36
+ votingTools.changeVote,
37
+ votingTools.getConsensusStatus,
38
+ ];
39
+ }
40
+ /**
41
+ * Create tools for a specific strategy
42
+ */
43
+ export function createStrategyTools(strategy, context) {
44
+ const baseTools = [
45
+ ...Object.values(createMessagingTools(context.messageBus, context.agentName)),
46
+ ...Object.values(createBlackboardTools(context.blackboard, context.agentName)),
47
+ ];
48
+ switch (strategy) {
49
+ case 'hierarchical': {
50
+ const delegationTools = createDelegationTools(context.coordinator, context.blackboard, context.agentName);
51
+ return [...baseTools, ...Object.values(delegationTools)];
52
+ }
53
+ case 'consensus':
54
+ case 'debate': {
55
+ const votingTools = createVotingTools(context.blackboard, context.events, context.agentName, context.agentWeight);
56
+ return [...baseTools, ...Object.values(votingTools)];
57
+ }
58
+ case 'auction':
59
+ case 'pipeline':
60
+ case 'round-robin':
61
+ default:
62
+ return baseTools;
63
+ }
64
+ }
65
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Swarm messaging tools for agent-to-agent communication
3
+ */
4
+ import type { MessageBus } from '@cogitator-ai/types';
5
+ /**
6
+ * Create messaging tools bound to a message bus
7
+ */
8
+ export declare function createMessagingTools(messageBus: MessageBus, currentAgent: string): {
9
+ sendMessage: import("@cogitator-ai/types").Tool<{
10
+ to: string;
11
+ message: string;
12
+ channel?: string | undefined;
13
+ waitForReply?: boolean | undefined;
14
+ }, {
15
+ sent: boolean;
16
+ messageId: string;
17
+ reply: string;
18
+ replyId: string;
19
+ timeout?: undefined;
20
+ } | {
21
+ sent: boolean;
22
+ messageId: string;
23
+ reply: null;
24
+ timeout: boolean;
25
+ replyId?: undefined;
26
+ } | {
27
+ sent: boolean;
28
+ messageId: string;
29
+ reply?: undefined;
30
+ replyId?: undefined;
31
+ timeout?: undefined;
32
+ }>;
33
+ readMessages: import("@cogitator-ai/types").Tool<{
34
+ from?: string | undefined;
35
+ channel?: string | undefined;
36
+ limit?: number | undefined;
37
+ unreadOnly?: boolean | undefined;
38
+ }, {
39
+ count: number;
40
+ messages: {
41
+ id: string;
42
+ from: string;
43
+ content: string;
44
+ channel: string | undefined;
45
+ timestamp: number;
46
+ type: import("@cogitator-ai/types").SwarmMessageType;
47
+ }[];
48
+ }>;
49
+ broadcastMessage: import("@cogitator-ai/types").Tool<{
50
+ message: string;
51
+ channel?: string | undefined;
52
+ }, {
53
+ broadcasted: boolean;
54
+ from: string;
55
+ channel: string;
56
+ }>;
57
+ replyToMessage: import("@cogitator-ai/types").Tool<{
58
+ message: string;
59
+ originalMessageId: string;
60
+ }, {
61
+ success: boolean;
62
+ error: string;
63
+ replyId?: undefined;
64
+ to?: undefined;
65
+ } | {
66
+ success: boolean;
67
+ replyId: string;
68
+ to: string;
69
+ error?: undefined;
70
+ }>;
71
+ };
72
+ export type MessagingTools = ReturnType<typeof createMessagingTools>;
73
+ //# sourceMappingURL=messaging.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/tools/messaging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2JhF;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
@@ -0,0 +1,146 @@
1
+ /**
2
+ * Swarm messaging tools for agent-to-agent communication
3
+ */
4
+ import { z } from 'zod';
5
+ import { tool } from '@cogitator-ai/core';
6
+ /**
7
+ * Create messaging tools bound to a message bus
8
+ */
9
+ export function createMessagingTools(messageBus, currentAgent) {
10
+ const sendMessage = tool({
11
+ name: 'send_message',
12
+ description: 'Send a message to another agent in the swarm',
13
+ parameters: z.object({
14
+ to: z.string().describe('Name of the recipient agent'),
15
+ message: z.string().describe('The message content to send'),
16
+ channel: z.string().optional().describe('Optional channel for message categorization'),
17
+ waitForReply: z.boolean().optional().describe('Whether to wait for a response (default: false)'),
18
+ }),
19
+ execute: async ({ to, message, channel, waitForReply }) => {
20
+ const msg = await messageBus.send({
21
+ swarmId: '',
22
+ from: currentAgent,
23
+ to,
24
+ type: 'request',
25
+ content: message,
26
+ channel,
27
+ });
28
+ if (waitForReply) {
29
+ const maxWait = 30000;
30
+ const pollInterval = 500;
31
+ let waited = 0;
32
+ while (waited < maxWait) {
33
+ const messages = messageBus.getMessages(currentAgent);
34
+ const reply = messages.find(m => m.from === to &&
35
+ m.type === 'response' &&
36
+ m.metadata?.correlationId === msg.id);
37
+ if (reply) {
38
+ return {
39
+ sent: true,
40
+ messageId: msg.id,
41
+ reply: reply.content,
42
+ replyId: reply.id,
43
+ };
44
+ }
45
+ await new Promise(r => setTimeout(r, pollInterval));
46
+ waited += pollInterval;
47
+ }
48
+ return {
49
+ sent: true,
50
+ messageId: msg.id,
51
+ reply: null,
52
+ timeout: true,
53
+ };
54
+ }
55
+ return {
56
+ sent: true,
57
+ messageId: msg.id,
58
+ };
59
+ },
60
+ });
61
+ const readMessages = tool({
62
+ name: 'read_messages',
63
+ description: 'Read messages sent to you from other agents',
64
+ parameters: z.object({
65
+ limit: z.number().optional().describe('Maximum number of messages to return (default: 10)'),
66
+ from: z.string().optional().describe('Filter by sender agent name'),
67
+ channel: z.string().optional().describe('Filter by channel'),
68
+ unreadOnly: z.boolean().optional().describe('Only return unread messages'),
69
+ }),
70
+ execute: async ({ limit = 10, from, channel }) => {
71
+ let messages = messageBus.getMessages(currentAgent);
72
+ if (from) {
73
+ messages = messages.filter(m => m.from === from);
74
+ }
75
+ if (channel) {
76
+ messages = messages.filter(m => m.channel === channel);
77
+ }
78
+ messages = messages.slice(0, limit);
79
+ return {
80
+ count: messages.length,
81
+ messages: messages.map(m => ({
82
+ id: m.id,
83
+ from: m.from,
84
+ content: m.content,
85
+ channel: m.channel,
86
+ timestamp: m.timestamp,
87
+ type: m.type,
88
+ })),
89
+ };
90
+ },
91
+ });
92
+ const broadcastMessage = tool({
93
+ name: 'broadcast_message',
94
+ description: 'Broadcast a message to all agents in the swarm',
95
+ parameters: z.object({
96
+ message: z.string().describe('The message content to broadcast'),
97
+ channel: z.string().optional().describe('Optional channel for message categorization'),
98
+ }),
99
+ execute: async ({ message, channel }) => {
100
+ await messageBus.broadcast(currentAgent, message, channel);
101
+ return {
102
+ broadcasted: true,
103
+ from: currentAgent,
104
+ channel: channel ?? 'default',
105
+ };
106
+ },
107
+ });
108
+ const replyToMessage = tool({
109
+ name: 'reply_to_message',
110
+ description: 'Reply to a specific message',
111
+ parameters: z.object({
112
+ originalMessageId: z.string().describe('ID of the message to reply to'),
113
+ message: z.string().describe('The reply content'),
114
+ }),
115
+ execute: async ({ originalMessageId, message }) => {
116
+ const allMessages = messageBus.getMessages(currentAgent);
117
+ const original = allMessages.find(m => m.id === originalMessageId);
118
+ if (!original) {
119
+ return {
120
+ success: false,
121
+ error: 'Original message not found',
122
+ };
123
+ }
124
+ const reply = await messageBus.send({
125
+ swarmId: '',
126
+ from: currentAgent,
127
+ to: original.from,
128
+ type: 'response',
129
+ content: message,
130
+ metadata: { correlationId: originalMessageId },
131
+ });
132
+ return {
133
+ success: true,
134
+ replyId: reply.id,
135
+ to: original.from,
136
+ };
137
+ },
138
+ });
139
+ return {
140
+ sendMessage,
141
+ readMessages,
142
+ broadcastMessage,
143
+ replyToMessage,
144
+ };
145
+ }
146
+ //# sourceMappingURL=messaging.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../src/tools/messaging.ts"],"names":[],"mappings":"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"}