@x-otto/orchestrator 0.0.1-alpha.3 → 0.0.1-alpha.5

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.
package/README.md CHANGED
@@ -8,11 +8,11 @@ Manages the creation, scheduling, retry, and lifecycle of multi-agent tasks. Pro
8
8
 
9
9
  | Module | Function |
10
10
  | ----------------- | -------------------------------------------------------------- |
11
- | TaskStore | Task CRUD + status tracking (pending/running/completed/failed) |
11
+ | TaskStore | Task CRUD + status tracking (pending/running/completed/failed) + event history (RFC-398 M2) |
12
12
  | TaskExecutor | Mixed sync/background scheduling + concurrency limiting |
13
- | RetryPolicy | Exponential backoff + jitter retry strategy |
14
- | CircuitBreaker | Circuit breaker (CLOSED/OPEN/HALF_OPEN) |
15
- | Orchestrator | Business-level API (dispatchTask/callAgent/getTask/updateTask) |
13
+ | RetryPolicy | Exponential backoff retry (implements RetryStrategy interface, RFC-398 M5) |
14
+ | CircuitBreaker | Circuit breaker (CLOSED/OPEN, auto-reset after timeout) |
15
+ | Orchestrator | Business-level API (dispatchTask/callAgent/getTask/updateTask) + dumpConfig (RFC-398 M4) |
16
16
  | BackgroundManager | Background async task lifecycle |
17
17
 
18
18
  ## Installation
@@ -24,34 +24,50 @@ pnpm add @x-otto/orchestrator
24
24
  ## Quick Start
25
25
 
26
26
  ```ts
27
- import { Orchestrator, createTaskStore } from '@x-otto/orchestrator'
28
-
29
- const store = createTaskStore({ kind: 'in-memory' })
30
- const orchestrator = new Orchestrator({ store, maxConcurrency: 5 })
27
+ import { Orchestrator, TaskStore } from '@x-otto/orchestrator'
28
+ import { createHookRegistry } from '@x-otto/hooks'
29
+
30
+ const orchestrator = new Orchestrator({
31
+ hookRegistry: createHookRegistry(),
32
+ runSession: async ({ agentName, prompt }) => ({
33
+ text: await runSubAgent(agentName, prompt),
34
+ sessionId: 's1',
35
+ durationMs: 100,
36
+ }),
37
+ })
31
38
 
32
- const taskId = await orchestrator.dispatchTask({
33
- agent: 'explore',
39
+ // sync mode
40
+ const result = await orchestrator.dispatchTask({
34
41
  prompt: 'Search for all unused imports in src/',
42
+ subagent: 'explore',
43
+ mode: 'sync',
35
44
  })
45
+ // result: { ok: true, value: { id, status, output } }
36
46
 
37
- // Background mode
38
- await orchestrator.dispatchTask({ ...opts, mode: 'background' })
39
- const result = await orchestrator.waitFor(taskId)
47
+ // background mode
48
+ const bgResult = await orchestrator.dispatchTask({
49
+ prompt: 'Analyze architecture',
50
+ subagent: 'explore',
51
+ mode: 'background',
52
+ })
53
+ // bgResult: { ok: true, value: { id, status: 'pending', output } }
54
+ const task = await orchestrator.getTask(bgResult.ok ? bgResult.value.id : '')
40
55
  ```
41
56
 
42
57
  ## Directory Overview
43
58
 
44
59
  ```
45
60
  src/
46
- types.ts # core types
47
- task-store.ts # task storage
48
- task-executor.ts # execution engine
49
- retry-policy.ts # retry policy
50
- circuit-breaker.ts # circuit breaker
51
- orchestrator.ts # top-level coordinator
61
+ types.ts # core types (TaskInputBase / TaskInput / SwarmMemberTaskInput / AnyTaskInput)
62
+ task-store.ts # task storage (TaskStore + event history)
63
+ executor.ts # execution engine (TaskExecutor)
64
+ retry.ts # RetryStrategy interface + RetryPolicy + CircuitBreaker
65
+ orchestrator.ts # top-level coordinator (+ dumpConfig)
52
66
  background-manager.ts # background management
67
+ semaphore.ts # concurrency semaphore
68
+ swarm/ # swarm execution (swarm / concurrent / strategy + withStep / strategies / router / handoff / errors)
53
69
  index.ts
54
- tests/ # 7 test files
70
+ tests/ # 13 test files / 153 tests
55
71
  ```
56
72
 
57
73
  ## Development Commands
package/dist/index.d.ts CHANGED
@@ -2,7 +2,6 @@ import { CallAgent, CancelBackground, GetBackgroundOutput, GetTask, ListTasks, M
2
2
  import { AgentError } from "@x-otto/shared";
3
3
  import * as _$_x_otto_hooks0 from "@x-otto/hooks";
4
4
  import { HookRegistry } from "@x-otto/hooks";
5
- import { Model, ThinkingLevel } from "@x-otto/ai";
6
5
  import { AgentMessage } from "@x-otto/hook-contracts";
7
6
  import { AgentTool } from "@x-otto/interchange";
8
7
 
@@ -13,10 +12,26 @@ interface RetryConfig {
13
12
  backoffMs: number;
14
13
  backoffMultiplier: number;
15
14
  }
16
- declare class RetryPolicy {
15
+ /**
16
+ * RFC-398 M5:重试策略 seam(最小接口)。
17
+ *
18
+ * orchestrator 不再依赖具体类 RetryPolicy,而是依赖此接口。
19
+ * 默认实现是 RetryPolicy(指数退避);宿主可注入自定义实现(如按任务类型差异化重试)。
20
+ *
21
+ * **如实标注**:当前全仓无「换 RetryPolicy 实现」的真实消费方——此 seam 为终局形态收口
22
+ * (RetryPolicy 是唯一用具体类注入的治理组件,与 CircuitBreakerRegistry 的 factory seam 不对称)。
23
+ * 价值是「为未来差异化重试策略预留 seam」,不是当前有需求。
24
+ */
25
+ interface RetryStrategy {
26
+ shouldRetry(attempt: number): boolean;
27
+ getBackoff(attempt: number): number;
28
+ readonly maxAttempts: number;
29
+ }
30
+ declare class RetryPolicy implements RetryStrategy {
17
31
  private readonly config;
18
32
  constructor(config?: Partial<RetryConfig>);
19
33
  shouldRetry(attempt: number): boolean;
34
+ get maxAttempts(): number;
20
35
  getBackoff(attempt: number): number;
21
36
  static fromWorkflowOptions(wf?: WorkflowOptions$1): RetryPolicy;
22
37
  }
@@ -29,9 +44,10 @@ declare class CircuitBreaker {
29
44
  private readonly enabled;
30
45
  private readonly failureThreshold;
31
46
  private readonly resetTimeoutMs;
47
+ private readonly clock;
32
48
  private consecutiveFailures;
33
49
  private openedAt;
34
- constructor(config?: Partial<CircuitBreakerConfig>);
50
+ constructor(config?: Partial<CircuitBreakerConfig>, clock?: Clock);
35
51
  isOpen(): boolean;
36
52
  success(): void;
37
53
  failure(): void;
@@ -39,21 +55,56 @@ declare class CircuitBreaker {
39
55
  }
40
56
  //#endregion
41
57
  //#region src/task-store.d.ts
58
+ /**
59
+ * RFC-398 M2:TaskStore 事件流(append-only)。
60
+ * Map 仍为唯一事实源;事件数组只作**状态机历史快照**(测试断言用),不参与状态重建。
61
+ * 事件 cap 跟随 Map 容量驱逐(evicted 事件本身是驱逐信号)——避免「任务被驱逐但事件还在」的投影/日志矛盾。
62
+ * 不暴露 onEvent 订阅:顶层可观测性已由 executor 的 hookRegistry.emit('task.*') 提供,本数组唯一不可替代价值是测试断言。
63
+ */
64
+ type TaskStoreEvent = {
65
+ type: 'task.created';
66
+ taskId: string;
67
+ at: number;
68
+ } | {
69
+ type: 'task.status-changed';
70
+ taskId: string;
71
+ from: TaskStatus;
72
+ to: TaskStatus;
73
+ at: number;
74
+ } | {
75
+ type: 'task.output-written';
76
+ taskId: string;
77
+ at: number;
78
+ } | {
79
+ type: 'task.evicted';
80
+ taskId: string;
81
+ at: number;
82
+ };
42
83
  declare class TaskStore {
43
84
  private readonly tasks;
85
+ private readonly events;
44
86
  private nextId;
45
87
  /**
46
88
  * 容量上限(默认 1000)。store 只收 task_delegate 落库的真任务,但终态任务只增不减——
47
89
  * 故加「终态优先 LRU 驱逐」兜底治裸 Map 无界增长(确定性、无时钟依赖,区别于 TTL)。
48
90
  */
49
- private readonly maxStoredTasks;
50
- constructor(maxStoredTasks?: number);
91
+ private readonly _maxStoredTasks;
92
+ private readonly clock;
93
+ constructor(maxStoredTasks?: number, clock?: Clock);
94
+ /** 容量上限(dumpConfig 用)。 */
95
+ get maxStoredTasks(): number;
96
+ /** 只读事件历史快照(测试断言用)。 */
97
+ get eventHistory(): readonly TaskStoreEvent[];
98
+ private recordEvent;
51
99
  private generateId;
52
- create(input: TaskInput): Promise<Task>;
100
+ create(input: AnyTaskInput, maxAttempts?: number): Promise<Task>;
101
+ /** 清空全部任务档案(dispose 用)。单线程内存语义下同步清空,API 仍保持 async 形态。 */
102
+ clear(): Promise<void>;
53
103
  /**
54
104
  * 容量回收:新建前若已达上限,按「终态优先 + 最旧先弃」驱逐至腾出一席。
55
105
  * 驱逐优先级:仅终态(completed/failed/cancelled),按 completedAt ?? createdAt 升序(最旧先弃)。
56
106
  * pending/running 在飞任务绝不驱逐——若只剩在飞仍超上限,则越界保活 + warn(绝不丢在飞的活儿)。
107
+ * 事件流同步驱逐:被驱逐的 task 对应事件从数组中移除,并发 task.evicted 事件。
57
108
  */
58
109
  private evictForCapacity;
59
110
  get(id: string): Promise<Task | undefined>;
@@ -105,8 +156,7 @@ interface RunSessionOptions {
105
156
  };
106
157
  systemPrompt?: string;
107
158
  tools?: AgentToolDef[];
108
- extraTools?: AgentToolDef[];
109
- thinkingLevel?: ThinkingLevel$1;
159
+ thinkingLevel?: ThinkingLevel;
110
160
  maxTokens?: number;
111
161
  temperature?: number;
112
162
  maxToolTurns?: number;
@@ -131,6 +181,14 @@ interface RunSessionResult {
131
181
  }
132
182
  //#endregion
133
183
  //#region src/types.d.ts
184
+ /**
185
+ * 时钟端口(D13:引擎核心禁裸 Date.now,经注入时钟取时间戳)。
186
+ * 形状与 `@x-otto/agent` 的 `ClockPort` 结构兼容(`{ now(): number }`),
187
+ * 便于宿主把同一时钟注入 agent 与 orchestrator 两套确定性重放端口。
188
+ */
189
+ interface Clock {
190
+ now(): number;
191
+ }
134
192
  /** 工具定义(本地 minimal type,避免 orchestrator 核心依赖 @x-otto/interchange)。 */
135
193
  interface AgentToolDef {
136
194
  name: string;
@@ -162,24 +220,24 @@ interface CoreToolDescriptor {
162
220
  };
163
221
  }
164
222
  /** 思考深度(本地 minimal type,避免 orchestrator 核心依赖 @x-otto/ai)。 */
165
- type ThinkingLevel$1 = 'low' | 'medium' | 'high';
223
+ type ThinkingLevel = 'low' | 'medium' | 'high';
166
224
  /** swarm member turn 入参(B+ 门禁①:经 TaskExecutor 治理)。 */
167
225
  interface AgentTurnInput {
168
226
  agentId: string;
169
227
  prompt: string;
170
228
  systemPrompt?: string;
171
229
  tools?: AgentToolDef[];
230
+ /** RFC-332 M1:core 工具纯数据描述符——leaf 的受限 core resolver 据此构造真实工具。 */
231
+ coreTools?: CoreToolDescriptor[];
172
232
  /**
173
- * @deprecated RFC-332:额外工具的元数据投影无法承载执行闭包(leaf 曾以 throw stub 补洞)。
174
- * core 工具(handoff)改走 `coreTools` 描述符 + leaf 受限 resolver;本字段在 M2 策略
175
- * 切换后删除。leaf 对该字段 fail closed(忽略并诊断),不再生成 stub。
233
+ * RFC-332 D3:废弃的旧工具元数据通道(AgentToolDef 投影,无法承载执行闭包)。
234
+ * 保留类型仅为运行期 fail-closed 诊断——旧调用方仍传时 leaf warn + 忽略;
235
+ * 合法工具来源是 coreTools。新代码禁止使用。
176
236
  */
177
237
  extraTools?: AgentToolDef[];
178
- /** RFC-332 M1:core 工具纯数据描述符——leaf 的受限 core resolver 据此构造真实工具。 */
179
- coreTools?: CoreToolDescriptor[];
180
238
  model?: string;
181
239
  maxToolTurns?: number;
182
- thinkingLevel?: ThinkingLevel$1;
240
+ thinkingLevel?: ThinkingLevel;
183
241
  maxTokens?: number;
184
242
  temperature?: number;
185
243
  signal?: AbortSignal;
@@ -212,10 +270,8 @@ interface AgentTurnResult {
212
270
  };
213
271
  durationMs: number;
214
272
  }
215
- interface TaskInput {
216
- /** 任务类别判别字段:'task' 走标准 Session 创建,'swarm_member' 走轻量 Agent 创建。
217
- * 缺省等价于 'task'(向后兼容 task_delegate/agent_call 路径)。 */
218
- kind?: 'task' | 'swarm_member';
273
+ /** 任务输入基类——公共字段(task_delegate / agent_call / swarm_member 共享)。 */
274
+ interface TaskInputBase {
219
275
  /** 发给 subagent 的提示 */
220
276
  prompt: string;
221
277
  /** 指定 agent 名称 — 对齐 task_delegate.subagent / agent_call.agent */
@@ -240,18 +296,27 @@ interface TaskInput {
240
296
  * 供 orchestrator 在任务终态时释放该 parent 的活跃计数。
241
297
  */
242
298
  parentTaskId?: string;
299
+ }
300
+ /** 标准任务输入(task_delegate / agent_call 路径)。kind 缺省等价 'task'。 */
301
+ interface TaskInput {
302
+ /** 任务类别判别字段。缺省等价 'task'(向后兼容 task_delegate/agent_call 路径)。 */
303
+ kind?: 'task';
304
+ }
305
+ /** swarm member turn 任务输入(swarm 路径)。 */
306
+ interface SwarmMemberTaskInput extends TaskInputBase {
307
+ /** 任务类别判别字段:'swarm_member' 走轻量 Agent 创建。 */
308
+ kind: 'swarm_member';
243
309
  /** swarm 成员自定义 system prompt(覆盖默认)。 */
244
310
  systemPrompt?: string;
245
311
  tools?: AgentToolDef[];
246
- /** 本轮额外工具(如 handoff 工具)。@deprecated RFC-332:见 AgentTurnInput.extraTools。 */
247
- extraTools?: AgentToolDef[];
248
312
  /** RFC-332 M1:core 工具纯数据描述符(swarm_member 专用)。 */
249
313
  coreTools?: CoreToolDescriptor[];
250
- thinkingLevel?: ThinkingLevel$1;
314
+ thinkingLevel?: ThinkingLevel;
251
315
  maxTokens?: number;
252
316
  temperature?: number;
253
317
  maxToolTurns?: number;
254
318
  }
319
+ interface TaskInput extends TaskInputBase {}
255
320
  interface TaskOutput {
256
321
  text: string;
257
322
  summary?: string;
@@ -275,6 +340,8 @@ interface TaskError {
275
340
  message: string;
276
341
  retriable: boolean;
277
342
  }
343
+ /** 判别联合——Task.input / TaskUnit.input 用此类型。 */
344
+ type AnyTaskInput = TaskInput | SwarmMemberTaskInput;
278
345
  interface Task {
279
346
  id: string;
280
347
  status: TaskStatus$1;
@@ -282,14 +349,14 @@ interface Task {
282
349
  sessionId?: string;
283
350
  attempts: number;
284
351
  maxAttempts: number;
285
- input: TaskInput;
352
+ input: AnyTaskInput;
286
353
  output?: TaskOutput;
287
354
  error?: TaskError;
288
355
  createdAt: number;
289
356
  completedAt?: number;
290
357
  }
291
358
  interface TaskUnit {
292
- input: TaskInput;
359
+ input: AnyTaskInput;
293
360
  }
294
361
  interface TaskResult {
295
362
  taskId: string;
@@ -322,6 +389,8 @@ interface OrchestratorOptions {
322
389
  maxFanOutPerParent?: number;
323
390
  /** 委托深度上限(默认 1)。root(0)→child1 放行;depth1→child2>1 拒。swarm 深层可经此放宽。 */
324
391
  maxDelegationDepth?: number;
392
+ /** 时钟端口(D13)。缺省 systemClock,透传至 TaskStore/Executor/CircuitBreaker/BackgroundManager。 */
393
+ clock?: Clock;
325
394
  }
326
395
  //#endregion
327
396
  //#region src/orchestrator.d.ts
@@ -334,6 +403,8 @@ declare class Orchestrator {
334
403
  private readonly delegationGate;
335
404
  private readonly runSession;
336
405
  private readonly maxDelegationDepth;
406
+ /** 外部 abort 回调(dispose 清退在飞任务用;与 BackgroundManager 共用同一回调)。 */
407
+ private readonly abortTask?;
337
408
  /**
338
409
  * RFC-371 S3:per-parent 活跃扇出计数。key=parentTaskId,value=该 parent 当前在跑的子任务数。
339
410
  *
@@ -350,8 +421,27 @@ declare class Orchestrator {
350
421
  */
351
422
  private readonly fanOutCounts;
352
423
  private readonly maxFanOutPerParent;
424
+ /**
425
+ * RFC-371 修复(元评审 2026-08-13):background 任务的「扇出槽位仍被持有」集合。
426
+ * key=taskId。释放有两条竞争路径——①任务自然到达终态(startTask 返回的 completion
427
+ * settle)②cancelBackground 显式取消。两条路径都会尝试释放;用 Set.delete 的返回值
428
+ * 做一次性令牌,保证同一任务的槽位恰好释放一次(否则 cancel 后 completion settle
429
+ * 会二次递减,把其他在跑任务的计数也吃掉)。
430
+ */
431
+ private readonly heldBackgroundSlots;
353
432
  constructor(options: OrchestratorOptions);
433
+ /**
434
+ * RFC-398 M4:dumpConfig 调试出口——打印当前生效的治理参数。
435
+ * 用于排查「用户配了不生效」类问题。
436
+ */
437
+ dumpConfig(): Record<string, unknown>;
354
438
  dispatchTask: TaskDispatch;
439
+ /**
440
+ * 派发单元内核(sync/background 单源):fan-out 闸 + executor 建档/执行。
441
+ * dispatchTask(工具入口)与 updateTask('retry') 共用——retry 需要把 TaskInput 全字段
442
+ * (parentTaskId/kind/swarm 字段)原样透传,不能经 TaskDispatch 的收窄入参重建。
443
+ */
444
+ private dispatchUnit;
355
445
  /**
356
446
  * agent 直调——**旁路任务内核**:不建档、不进 store、不重试,
357
447
  * 直连宿主 runSession 的轻量探询语义(agent_call)。**但仍受治理**:
@@ -369,12 +459,31 @@ declare class Orchestrator {
369
459
  updateTask: UpdateTask;
370
460
  getBackgroundOutput: GetBackgroundOutput;
371
461
  cancelBackground: CancelBackground;
372
- dispose(): void;
462
+ dispose(): Promise<void>;
463
+ /**
464
+ * RFC-371 S3(S-1 TOCTOU 修复):check+increment 合并在同一同步段完成,返回是否拿到槽位。
465
+ * 本方法内无 await,读-改-写原子(Node 单线程),消除「顶部 check 与 acquire 之间隔 await」
466
+ * 的 TOCTOU。undefined parentTaskId = root 层,恒返回 true(不受 per-parent 限制)。
467
+ */
373
468
  private acquireFanOutSlot;
374
469
  private releaseFanOutSlot;
470
+ /**
471
+ * background 任务槽位的一次性释放(元评审 2026-08-13):completion settle 与
472
+ * cancelBackground 两条路径竞争,Set.delete 返回 false = 已被另一路径释放过,跳过。
473
+ */
474
+ private releaseBackgroundSlot;
375
475
  }
376
476
  //#endregion
377
477
  //#region src/swarm/types.d.ts
478
+ /**
479
+ * 本地 minimal Model 类型(替代 `@x-otto/ai` 的 `Model`)。
480
+ * swarm 层唯一消费是 `member.model?.id`(swarm.ts:199),不访问 name 之外字段。
481
+ * 声明 `name?` 保持结构兼容(coding 侧构造的 `Model` 含 name)。
482
+ */
483
+ interface SwarmModel {
484
+ id: string;
485
+ name?: string;
486
+ }
378
487
  type SwarmAgentId = string;
379
488
  interface SwarmMemberCommon {
380
489
  /** 唯一标识 */
@@ -390,7 +499,7 @@ interface SwarmAgentMember extends SwarmMemberCommon {
390
499
  kind: 'agent';
391
500
  systemPrompt: string;
392
501
  /** 模型配置(缺省时继承 Swarm 默认模型) */
393
- model?: Model;
502
+ model?: SwarmModel;
394
503
  /**
395
504
  * 成员声明的工具**元数据**(RFC-332 M3:从 `AgentTool[]` 收窄为纯数据 `AgentToolDef[]`)。
396
505
  *
@@ -445,8 +554,6 @@ interface RouteRule {
445
554
  }
446
555
  interface RouterConfig {
447
556
  strategy: RoutingStrategy;
448
- /** LLM 路由时使用的模型 */
449
- routerModel?: Model;
450
557
  /** 规则路由 */
451
558
  rules?: RouteRule[];
452
559
  /** 自定义路由函数 */
@@ -482,12 +589,16 @@ interface SwarmConfig {
482
589
  name: string;
483
590
  /** 参与的 Agent 定义列表 */
484
591
  agents: SwarmAgentDef[];
485
- /** 默认 LLM 模型 */
486
- defaultModel: Model;
487
592
  /** 编排模式 */
488
593
  pattern: OrchestrationPattern;
489
594
  /** Swarm 成员所处的委托深度;传 Agent 构造器闭合递归护栏。 */
490
595
  depth?: number;
596
+ /**
597
+ * RFC-371 M-A(元评审 2026-08-13 补接线):本 swarm 运行所属的父任务锚点。
598
+ * 透传至每个成员 turn 的 AgentTurnInput.parentTaskId → TaskInput.parentTaskId,
599
+ * 使 team 成员在 turn 内再委派(task_delegate)时计入同一 parent 的扇出治理。
600
+ */
601
+ parentTaskId?: string;
491
602
  /** 路由器配置(pattern='router' 或 'handoff' 时使用) */
492
603
  router?: RouterConfig;
493
604
  /** 流水线顺序(pattern='sequential' 时使用) */
@@ -520,6 +631,8 @@ interface SwarmConfig {
520
631
  * 未设置时仅走 onSwarmEvent 私有回调(行为不变)。
521
632
  */
522
633
  hookRegistry?: _$_x_otto_hooks0.HookRegistry;
634
+ /** 时钟端口(D13):emitEvent 合成的 TaskHookInfo.createdAt 用。缺省 systemClock。 */
635
+ clock?: Clock;
523
636
  }
524
637
  type SwarmEvent = {
525
638
  type: 'swarm.start';
@@ -588,6 +701,8 @@ interface StrategyContext {
588
701
  router?: Router;
589
702
  /** AbortSignal。 */
590
703
  signal: AbortSignal;
704
+ /** 时钟端口(D13:策略内禁裸 Date.now,一律经此取时间戳)。 */
705
+ clock: Clock;
591
706
  /** 配置快照。 */
592
707
  config: StrategyConfig;
593
708
  }
@@ -617,7 +732,9 @@ interface StrategyResult {
617
732
  }
618
733
  declare class StrategyRegistry {
619
734
  private readonly strategies;
620
- register(strategy: OrchestrationStrategy): void;
735
+ register(strategy: OrchestrationStrategy): () => void;
736
+ /** 删除已注册策略(disposer 的等价直接调用)。 */
737
+ unregister(name: string): boolean;
621
738
  get(name: string): OrchestrationStrategy | undefined;
622
739
  has(name: string): boolean;
623
740
  names(): string[];
@@ -642,11 +759,12 @@ declare class Swarm {
642
759
  private readonly agents;
643
760
  private readonly router;
644
761
  private readonly registry;
762
+ private readonly clock;
645
763
  constructor(config: SwarmConfig);
646
764
  getAgents(): SwarmAgentDef[];
647
765
  getAgent(id: SwarmAgentId): SwarmAgentDef | undefined;
648
- /** 注册/替换策略(§4-12:host 可追加新模式,不碰核心)。 */
649
- registerStrategy(strategy: OrchestrationStrategy): void;
766
+ /** 注册/替换策略(§4-12:host 可追加新模式,不碰核心)。返回 disposer 用于注销。 */
767
+ registerStrategy(strategy: OrchestrationStrategy): () => void;
650
768
  /** 获取已注册策略名列表。 */
651
769
  getStrategyNames(): string[];
652
770
  private emitEvent;
@@ -786,5 +904,5 @@ declare class SwarmConfigError extends AgentError {
786
904
  constructor(message: string);
787
905
  }
788
906
  //#endregion
789
- export { AgentNotFoundError, type AgentToolDef, type AgentTurnInput, type AgentTurnResult, CircuitBreaker, type CircuitBreakerConfig, type ConcurrentOptions, type CoreToolDescriptor, HANDOFF_STRATEGY, HIERARCHICAL_STRATEGY, HandoffDepthError, type HandoffRequest, type HandoffTargetInfo, type HierarchicalTask, type OrchestrationPattern, type OrchestrationStrategy, Orchestrator, type OrchestratorOptions, PARALLEL_STRATEGY, ROUTER_STRATEGY, type RetryConfig, RetryPolicy, type RouteRule, type RouterConfig, type RoutingDecision, RoutingError, type RoutingStrategy, type RunSessionOptions, type RunSessionResult, SEQUENTIAL_STRATEGY, type StepResult, type StrategyConfig, type StrategyContext, StrategyRegistry, type StrategyResult, Swarm, type SwarmAgentDef, type SwarmAgentId, type SwarmAgentMember, type SwarmConfig, SwarmConfigError, type SwarmEvent, type SwarmEventHandler, SwarmRouter, type SwarmRunResult, type SwarmTeamMember, type SwarmTurnResult, type Task, type TaskError, type TaskInput, type TaskOutput, TaskRejectedError, type TaskResult, type TaskStatus, TaskStore, type TaskUnit, type WorkflowOptions, createDefaultStrategyRegistry, createHandoffTool, createSwarm, runConcurrent, validateHandoff };
907
+ export { AgentNotFoundError, type AgentToolDef, type AgentTurnInput, type AgentTurnResult, type AnyTaskInput, CircuitBreaker, type CircuitBreakerConfig, type ConcurrentOptions, type CoreToolDescriptor, HANDOFF_STRATEGY, HIERARCHICAL_STRATEGY, HandoffDepthError, type HandoffRequest, type HandoffTargetInfo, type HierarchicalTask, type OrchestrationPattern, type OrchestrationStrategy, Orchestrator, type OrchestratorOptions, PARALLEL_STRATEGY, ROUTER_STRATEGY, type RetryConfig, RetryPolicy, type RetryStrategy, type RouteRule, type RouterConfig, type RoutingDecision, RoutingError, type RoutingStrategy, type RunSessionOptions, type RunSessionResult, SEQUENTIAL_STRATEGY, type StepResult, type StrategyConfig, type StrategyContext, StrategyRegistry, type StrategyResult, Swarm, type SwarmAgentDef, type SwarmAgentId, type SwarmAgentMember, type SwarmConfig, SwarmConfigError, type SwarmEvent, type SwarmEventHandler, type SwarmMemberTaskInput, SwarmRouter, type SwarmRunResult, type SwarmTeamMember, type SwarmTurnResult, type Task, type TaskError, type TaskInput, type TaskOutput, TaskRejectedError, type TaskResult, type TaskStatus, TaskStore, type TaskStoreEvent, type TaskUnit, type WorkflowOptions, createDefaultStrategyRegistry, createHandoffTool, createSwarm, runConcurrent, validateHandoff };
790
908
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/retry.ts","../src/task-store.ts","../src/executor.ts","../src/types.ts","../src/orchestrator.ts","../src/swarm/types.ts","../src/swarm/strategy.ts","../src/swarm/swarm.ts","../src/swarm/concurrent.ts","../src/swarm/strategies/handoff.ts","../src/swarm/strategies/sequential.ts","../src/swarm/strategies/parallel.ts","../src/swarm/strategies/hierarchical.ts","../src/swarm/strategies/router.ts","../src/swarm/strategies/index.ts","../src/swarm/router.ts","../src/swarm/handoff.ts","../src/swarm/errors.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/retry.ts","../src/task-store.ts","../src/executor.ts","../src/types.ts","../src/orchestrator.ts","../src/swarm/types.ts","../src/swarm/strategy.ts","../src/swarm/swarm.ts","../src/swarm/concurrent.ts","../src/swarm/strategies/handoff.ts","../src/swarm/strategies/sequential.ts","../src/swarm/strategies/parallel.ts","../src/swarm/strategies/hierarchical.ts","../src/swarm/strategies/router.ts","../src/swarm/strategies/index.ts","../src/swarm/router.ts","../src/swarm/handoff.ts","../src/swarm/errors.ts"],"mappings":"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"}