@specpow/framework 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.
- package/CHANGELOG.md +307 -0
- package/LICENSE +21 -0
- package/README.md +557 -0
- package/agents/controller/sdd-controller.md +55 -0
- package/agents/execution/java-codegen-agent.md +39 -0
- package/agents/execution/ui-codegen-agent.md +32 -0
- package/agents/ops/deploy-agent.md +181 -0
- package/agents/planning/db-designer-agent.md +30 -0
- package/agents/planning/prd-agent.md +31 -0
- package/agents/quality/review-agent.md +36 -0
- package/agents/quality/test-agent.md +33 -0
- package/bin/specpow.js +10 -0
- package/dist/cli/index.d.ts +7 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +444 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/commands/apply.d.ts +14 -0
- package/dist/commands/apply.d.ts.map +1 -0
- package/dist/commands/apply.js +195 -0
- package/dist/commands/apply.js.map +1 -0
- package/dist/commands/archive.d.ts +30 -0
- package/dist/commands/archive.d.ts.map +1 -0
- package/dist/commands/archive.js +141 -0
- package/dist/commands/archive.js.map +1 -0
- package/dist/commands/channel.d.ts +61 -0
- package/dist/commands/channel.d.ts.map +1 -0
- package/dist/commands/channel.js +613 -0
- package/dist/commands/channel.js.map +1 -0
- package/dist/commands/config.d.ts +40 -0
- package/dist/commands/config.d.ts.map +1 -0
- package/dist/commands/config.js +130 -0
- package/dist/commands/config.js.map +1 -0
- package/dist/commands/debug.d.ts +45 -0
- package/dist/commands/debug.d.ts.map +1 -0
- package/dist/commands/debug.js +167 -0
- package/dist/commands/debug.js.map +1 -0
- package/dist/commands/doctor.d.ts +20 -0
- package/dist/commands/doctor.d.ts.map +1 -0
- package/dist/commands/doctor.js +121 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/execute.d.ts +25 -0
- package/dist/commands/execute.d.ts.map +1 -0
- package/dist/commands/execute.js +120 -0
- package/dist/commands/execute.js.map +1 -0
- package/dist/commands/explore.d.ts +71 -0
- package/dist/commands/explore.d.ts.map +1 -0
- package/dist/commands/explore.js +481 -0
- package/dist/commands/explore.js.map +1 -0
- package/dist/commands/init.d.ts +20 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +146 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/memory.d.ts +32 -0
- package/dist/commands/memory.d.ts.map +1 -0
- package/dist/commands/memory.js +455 -0
- package/dist/commands/memory.js.map +1 -0
- package/dist/commands/propose.d.ts +13 -0
- package/dist/commands/propose.d.ts.map +1 -0
- package/dist/commands/propose.js +193 -0
- package/dist/commands/propose.js.map +1 -0
- package/dist/commands/review.d.ts +50 -0
- package/dist/commands/review.d.ts.map +1 -0
- package/dist/commands/review.js +198 -0
- package/dist/commands/review.js.map +1 -0
- package/dist/commands/schema.d.ts +22 -0
- package/dist/commands/schema.d.ts.map +1 -0
- package/dist/commands/schema.js +79 -0
- package/dist/commands/schema.js.map +1 -0
- package/dist/commands/status.d.ts +11 -0
- package/dist/commands/status.d.ts.map +1 -0
- package/dist/commands/status.js +130 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/commands/store.d.ts +31 -0
- package/dist/commands/store.d.ts.map +1 -0
- package/dist/commands/store.js +109 -0
- package/dist/commands/store.js.map +1 -0
- package/dist/commands/update.d.ts +42 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +239 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/commands/verify.d.ts +39 -0
- package/dist/commands/verify.d.ts.map +1 -0
- package/dist/commands/verify.js +386 -0
- package/dist/commands/verify.js.map +1 -0
- package/dist/commands/workflow/index.d.ts +12 -0
- package/dist/commands/workflow/index.d.ts.map +1 -0
- package/dist/commands/workflow/index.js +435 -0
- package/dist/commands/workflow/index.js.map +1 -0
- package/dist/core/agent-contract.d.ts +133 -0
- package/dist/core/agent-contract.d.ts.map +1 -0
- package/dist/core/agent-contract.js +71 -0
- package/dist/core/agent-contract.js.map +1 -0
- package/dist/core/archive/delta-merger.d.ts +101 -0
- package/dist/core/archive/delta-merger.d.ts.map +1 -0
- package/dist/core/archive/delta-merger.js +398 -0
- package/dist/core/archive/delta-merger.js.map +1 -0
- package/dist/core/archive/delta-parser.d.ts +48 -0
- package/dist/core/archive/delta-parser.d.ts.map +1 -0
- package/dist/core/archive/delta-parser.js +193 -0
- package/dist/core/archive/delta-parser.js.map +1 -0
- package/dist/core/archive/engine.d.ts +136 -0
- package/dist/core/archive/engine.d.ts.map +1 -0
- package/dist/core/archive/engine.js +506 -0
- package/dist/core/archive/engine.js.map +1 -0
- package/dist/core/archive/index.d.ts +11 -0
- package/dist/core/archive/index.d.ts.map +1 -0
- package/dist/core/archive/index.js +9 -0
- package/dist/core/archive/index.js.map +1 -0
- package/dist/core/artifact-graph/graph.d.ts +48 -0
- package/dist/core/artifact-graph/graph.d.ts.map +1 -0
- package/dist/core/artifact-graph/graph.js +170 -0
- package/dist/core/artifact-graph/graph.js.map +1 -0
- package/dist/core/artifact-graph/index.d.ts +13 -0
- package/dist/core/artifact-graph/index.d.ts.map +1 -0
- package/dist/core/artifact-graph/index.js +12 -0
- package/dist/core/artifact-graph/index.js.map +1 -0
- package/dist/core/artifact-graph/instruction-loader.d.ts +60 -0
- package/dist/core/artifact-graph/instruction-loader.d.ts.map +1 -0
- package/dist/core/artifact-graph/instruction-loader.js +166 -0
- package/dist/core/artifact-graph/instruction-loader.js.map +1 -0
- package/dist/core/artifact-graph/outputs.d.ts +17 -0
- package/dist/core/artifact-graph/outputs.d.ts.map +1 -0
- package/dist/core/artifact-graph/outputs.js +27 -0
- package/dist/core/artifact-graph/outputs.js.map +1 -0
- package/dist/core/artifact-graph/resolver.d.ts +34 -0
- package/dist/core/artifact-graph/resolver.d.ts.map +1 -0
- package/dist/core/artifact-graph/resolver.js +99 -0
- package/dist/core/artifact-graph/resolver.js.map +1 -0
- package/dist/core/artifact-graph/state.d.ts +54 -0
- package/dist/core/artifact-graph/state.d.ts.map +1 -0
- package/dist/core/artifact-graph/state.js +149 -0
- package/dist/core/artifact-graph/state.js.map +1 -0
- package/dist/core/artifact-graph/types.d.ts +151 -0
- package/dist/core/artifact-graph/types.d.ts.map +1 -0
- package/dist/core/artifact-graph/types.js +44 -0
- package/dist/core/artifact-graph/types.js.map +1 -0
- package/dist/core/channel/channel-event-log.d.ts +81 -0
- package/dist/core/channel/channel-event-log.d.ts.map +1 -0
- package/dist/core/channel/channel-event-log.js +177 -0
- package/dist/core/channel/channel-event-log.js.map +1 -0
- package/dist/core/channel/channel-inbox.d.ts +70 -0
- package/dist/core/channel/channel-inbox.d.ts.map +1 -0
- package/dist/core/channel/channel-inbox.js +122 -0
- package/dist/core/channel/channel-inbox.js.map +1 -0
- package/dist/core/channel/channel-runtime.d.ts +81 -0
- package/dist/core/channel/channel-runtime.d.ts.map +1 -0
- package/dist/core/channel/channel-runtime.js +291 -0
- package/dist/core/channel/channel-runtime.js.map +1 -0
- package/dist/core/channel/channel-supervisor.d.ts +72 -0
- package/dist/core/channel/channel-supervisor.d.ts.map +1 -0
- package/dist/core/channel/channel-supervisor.js +189 -0
- package/dist/core/channel/channel-supervisor.js.map +1 -0
- package/dist/core/channel/channel-types.d.ts +169 -0
- package/dist/core/channel/channel-types.d.ts.map +1 -0
- package/dist/core/channel/channel-types.js +26 -0
- package/dist/core/channel/channel-types.js.map +1 -0
- package/dist/core/channel/index.d.ts +21 -0
- package/dist/core/channel/index.d.ts.map +1 -0
- package/dist/core/channel/index.js +23 -0
- package/dist/core/channel/index.js.map +1 -0
- package/dist/core/command-generation/index.d.ts +225 -0
- package/dist/core/command-generation/index.d.ts.map +1 -0
- package/dist/core/command-generation/index.js +462 -0
- package/dist/core/command-generation/index.js.map +1 -0
- package/dist/core/config/config-schema.d.ts +745 -0
- package/dist/core/config/config-schema.d.ts.map +1 -0
- package/dist/core/config/config-schema.js +108 -0
- package/dist/core/config/config-schema.js.map +1 -0
- package/dist/core/config/global-config.d.ts +73 -0
- package/dist/core/config/global-config.d.ts.map +1 -0
- package/dist/core/config/global-config.js +225 -0
- package/dist/core/config/global-config.js.map +1 -0
- package/dist/core/config/index.d.ts +8 -0
- package/dist/core/config/index.d.ts.map +1 -0
- package/dist/core/config/index.js +8 -0
- package/dist/core/config/index.js.map +1 -0
- package/dist/core/hooks/hook-registry.d.ts +55 -0
- package/dist/core/hooks/hook-registry.d.ts.map +1 -0
- package/dist/core/hooks/hook-registry.js +172 -0
- package/dist/core/hooks/hook-registry.js.map +1 -0
- package/dist/core/hooks/hook-types.d.ts +87 -0
- package/dist/core/hooks/hook-types.d.ts.map +1 -0
- package/dist/core/hooks/hook-types.js +11 -0
- package/dist/core/hooks/hook-types.js.map +1 -0
- package/dist/core/hooks/index.d.ts +28 -0
- package/dist/core/hooks/index.d.ts.map +1 -0
- package/dist/core/hooks/index.js +28 -0
- package/dist/core/hooks/index.js.map +1 -0
- package/dist/core/hooks/post-tool-call-hook.d.ts +21 -0
- package/dist/core/hooks/post-tool-call-hook.d.ts.map +1 -0
- package/dist/core/hooks/post-tool-call-hook.js +191 -0
- package/dist/core/hooks/post-tool-call-hook.js.map +1 -0
- package/dist/core/hooks/pre-tool-call-hook.d.ts +31 -0
- package/dist/core/hooks/pre-tool-call-hook.d.ts.map +1 -0
- package/dist/core/hooks/pre-tool-call-hook.js +122 -0
- package/dist/core/hooks/pre-tool-call-hook.js.map +1 -0
- package/dist/core/hooks/session-start-hook.d.ts +25 -0
- package/dist/core/hooks/session-start-hook.d.ts.map +1 -0
- package/dist/core/hooks/session-start-hook.js +226 -0
- package/dist/core/hooks/session-start-hook.js.map +1 -0
- package/dist/core/hooks/workflow-state-hook.d.ts +18 -0
- package/dist/core/hooks/workflow-state-hook.d.ts.map +1 -0
- package/dist/core/hooks/workflow-state-hook.js +181 -0
- package/dist/core/hooks/workflow-state-hook.js.map +1 -0
- package/dist/core/init/engine.d.ts +69 -0
- package/dist/core/init/engine.d.ts.map +1 -0
- package/dist/core/init/engine.js +211 -0
- package/dist/core/init/engine.js.map +1 -0
- package/dist/core/init/template-hash.d.ts +86 -0
- package/dist/core/init/template-hash.d.ts.map +1 -0
- package/dist/core/init/template-hash.js +228 -0
- package/dist/core/init/template-hash.js.map +1 -0
- package/dist/core/memory/adapters/json-adapter.d.ts +50 -0
- package/dist/core/memory/adapters/json-adapter.d.ts.map +1 -0
- package/dist/core/memory/adapters/json-adapter.js +273 -0
- package/dist/core/memory/adapters/json-adapter.js.map +1 -0
- package/dist/core/memory/adapters/sqlite-adapter.d.ts +26 -0
- package/dist/core/memory/adapters/sqlite-adapter.d.ts.map +1 -0
- package/dist/core/memory/adapters/sqlite-adapter.js +230 -0
- package/dist/core/memory/adapters/sqlite-adapter.js.map +1 -0
- package/dist/core/memory/index.d.ts +38 -0
- package/dist/core/memory/index.d.ts.map +1 -0
- package/dist/core/memory/index.js +40 -0
- package/dist/core/memory/index.js.map +1 -0
- package/dist/core/memory/memory-indexer.d.ts +39 -0
- package/dist/core/memory/memory-indexer.d.ts.map +1 -0
- package/dist/core/memory/memory-indexer.js +213 -0
- package/dist/core/memory/memory-indexer.js.map +1 -0
- package/dist/core/memory/memory-manager.d.ts +59 -0
- package/dist/core/memory/memory-manager.d.ts.map +1 -0
- package/dist/core/memory/memory-manager.js +194 -0
- package/dist/core/memory/memory-manager.js.map +1 -0
- package/dist/core/memory/memory-store.d.ts +31 -0
- package/dist/core/memory/memory-store.d.ts.map +1 -0
- package/dist/core/memory/memory-store.js +148 -0
- package/dist/core/memory/memory-store.js.map +1 -0
- package/dist/core/memory/memory-types.d.ts +154 -0
- package/dist/core/memory/memory-types.d.ts.map +1 -0
- package/dist/core/memory/memory-types.js +13 -0
- package/dist/core/memory/memory-types.js.map +1 -0
- package/dist/core/migration/index.d.ts +80 -0
- package/dist/core/migration/index.d.ts.map +1 -0
- package/dist/core/migration/index.js +361 -0
- package/dist/core/migration/index.js.map +1 -0
- package/dist/core/parsers/index.d.ts +95 -0
- package/dist/core/parsers/index.d.ts.map +1 -0
- package/dist/core/parsers/index.js +367 -0
- package/dist/core/parsers/index.js.map +1 -0
- package/dist/core/sdd-engine/ai-caller.d.ts +118 -0
- package/dist/core/sdd-engine/ai-caller.d.ts.map +1 -0
- package/dist/core/sdd-engine/ai-caller.js +624 -0
- package/dist/core/sdd-engine/ai-caller.js.map +1 -0
- package/dist/core/sdd-engine/controller.d.ts +107 -0
- package/dist/core/sdd-engine/controller.d.ts.map +1 -0
- package/dist/core/sdd-engine/controller.js +357 -0
- package/dist/core/sdd-engine/controller.js.map +1 -0
- package/dist/core/sdd-engine/dispatcher.d.ts +69 -0
- package/dist/core/sdd-engine/dispatcher.d.ts.map +1 -0
- package/dist/core/sdd-engine/dispatcher.js +146 -0
- package/dist/core/sdd-engine/dispatcher.js.map +1 -0
- package/dist/core/sdd-engine/git-ops.d.ts +73 -0
- package/dist/core/sdd-engine/git-ops.d.ts.map +1 -0
- package/dist/core/sdd-engine/git-ops.js +326 -0
- package/dist/core/sdd-engine/git-ops.js.map +1 -0
- package/dist/core/sdd-engine/index.d.ts +17 -0
- package/dist/core/sdd-engine/index.d.ts.map +1 -0
- package/dist/core/sdd-engine/index.js +15 -0
- package/dist/core/sdd-engine/index.js.map +1 -0
- package/dist/core/sdd-engine/ledger.d.ts +92 -0
- package/dist/core/sdd-engine/ledger.d.ts.map +1 -0
- package/dist/core/sdd-engine/ledger.js +273 -0
- package/dist/core/sdd-engine/ledger.js.map +1 -0
- package/dist/core/sdd-engine/model-selector.d.ts +49 -0
- package/dist/core/sdd-engine/model-selector.d.ts.map +1 -0
- package/dist/core/sdd-engine/model-selector.js +76 -0
- package/dist/core/sdd-engine/model-selector.js.map +1 -0
- package/dist/core/sdd-engine/parallel-dispatcher.d.ts +99 -0
- package/dist/core/sdd-engine/parallel-dispatcher.d.ts.map +1 -0
- package/dist/core/sdd-engine/parallel-dispatcher.js +350 -0
- package/dist/core/sdd-engine/parallel-dispatcher.js.map +1 -0
- package/dist/core/sdd-engine/review-loop.d.ts +61 -0
- package/dist/core/sdd-engine/review-loop.d.ts.map +1 -0
- package/dist/core/sdd-engine/review-loop.js +139 -0
- package/dist/core/sdd-engine/review-loop.js.map +1 -0
- package/dist/core/sdd-engine/types.d.ts +104 -0
- package/dist/core/sdd-engine/types.d.ts.map +1 -0
- package/dist/core/sdd-engine/types.js +7 -0
- package/dist/core/sdd-engine/types.js.map +1 -0
- package/dist/core/store/index.d.ts +78 -0
- package/dist/core/store/index.d.ts.map +1 -0
- package/dist/core/store/index.js +182 -0
- package/dist/core/store/index.js.map +1 -0
- package/dist/core/templates/index.d.ts +58 -0
- package/dist/core/templates/index.d.ts.map +1 -0
- package/dist/core/templates/index.js +158 -0
- package/dist/core/templates/index.js.map +1 -0
- package/dist/core/validation/index.d.ts +34 -0
- package/dist/core/validation/index.d.ts.map +1 -0
- package/dist/core/validation/index.js +153 -0
- package/dist/core/validation/index.js.map +1 -0
- package/dist/core/workflow-state.d.ts +96 -0
- package/dist/core/workflow-state.d.ts.map +1 -0
- package/dist/core/workflow-state.js +284 -0
- package/dist/core/workflow-state.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +21 -0
- package/dist/index.js.map +1 -0
- package/dist/utils/index.d.ts +48 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +119 -0
- package/dist/utils/index.js.map +1 -0
- package/hooks/hooks.json +30 -0
- package/hooks/run-hook.cmd +19 -0
- package/hooks/session-start +62 -0
- package/hooks/workflow-state +150 -0
- package/package.json +122 -0
- package/schemas/bug-fix/schema.yaml +64 -0
- package/schemas/bug-fix/templates/analysis.md +43 -0
- package/schemas/bug-fix/templates/fix-plan.md +19 -0
- package/schemas/bug-fix/templates/proposal.md +30 -0
- package/schemas/crud-module/schema.yaml +65 -0
- package/schemas/crud-module/templates/design.md +36 -0
- package/schemas/crud-module/templates/proposal.md +30 -0
- package/schemas/crud-module/templates/spec.md +33 -0
- package/schemas/crud-module/templates/tasks.md +57 -0
- package/schemas/spec-driven/schema.yaml +87 -0
- package/schemas/spec-driven/templates/design.md +54 -0
- package/schemas/spec-driven/templates/proposal.md +31 -0
- package/schemas/spec-driven/templates/spec.md +44 -0
- package/schemas/spec-driven/templates/tasks.md +98 -0
- package/skills/business-code-review/SKILL.md +78 -0
- package/skills/business-db-design/SKILL.md +74 -0
- package/skills/business-deploy-check/SKILL.md +72 -0
- package/skills/business-doc-sync/SKILL.md +72 -0
- package/skills/business-java-codegen/SKILL.md +97 -0
- package/skills/business-menu-register/SKILL.md +63 -0
- package/skills/business-prd-writer/SKILL.md +80 -0
- package/skills/business-test-gen/SKILL.md +82 -0
- package/skills/business-ui-codegen/SKILL.md +104 -0
- package/skills/execution-finish-branch/SKILL.md +58 -0
- package/skills/execution-git-worktrees/SKILL.md +48 -0
- package/skills/execution-parallel-agents/SKILL.md +51 -0
- package/skills/execution-receiving-review/SKILL.md +47 -0
- package/skills/execution-requesting-review/SKILL.md +51 -0
- package/skills/execution-subagent-driven-dev/SKILL.md +148 -0
- package/skills/execution-systematic-debugging/SKILL.md +95 -0
- package/skills/execution-tdd/SKILL.md +74 -0
- package/skills/execution-verification-before-completion/SKILL.md +75 -0
- package/skills/meta-create-skill/SKILL.md +374 -0
- package/skills/meta-using-skills/SKILL.md +97 -0
- package/skills/meta-writing-skills/SKILL.md +66 -0
- package/skills/planning-apply-change/SKILL.md +199 -0
- package/skills/planning-archive-change/SKILL.md +43 -0
- package/skills/planning-explore/SKILL.md +108 -0
- package/skills/planning-onboard/SKILL.md +60 -0
- package/skills/planning-propose/SKILL.md +145 -0
- package/skills/planning-update-change/SKILL.md +45 -0
- package/skills/planning-verify-change/SKILL.md +58 -0
- package/skills/planning-write-design/SKILL.md +59 -0
- package/skills/planning-write-plans/SKILL.md +55 -0
- package/skills/planning-write-specs/SKILL.md +73 -0
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Channel Supervisor 模式
|
|
3
|
+
*
|
|
4
|
+
* P2-13: 监督者模式实现
|
|
5
|
+
*
|
|
6
|
+
* 功能:
|
|
7
|
+
* - 任务分配策略(轮询、最少忙碌、优先级)
|
|
8
|
+
* - 超时检查
|
|
9
|
+
* - 负载均衡
|
|
10
|
+
*/
|
|
11
|
+
import { DEFAULT_SUPERVISOR_CONFIG } from './channel-types.js';
|
|
12
|
+
// ─── Supervisor 实现 ─────────────────────────────────────────
|
|
13
|
+
export class Supervisor {
|
|
14
|
+
config;
|
|
15
|
+
runtime;
|
|
16
|
+
workers = [];
|
|
17
|
+
roundRobinIndex = 0;
|
|
18
|
+
timeoutCheckInterval;
|
|
19
|
+
constructor(runtime, config = {}) {
|
|
20
|
+
this.config = { ...DEFAULT_SUPERVISOR_CONFIG, ...config };
|
|
21
|
+
this.runtime = runtime;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* 启动 Supervisor
|
|
25
|
+
*/
|
|
26
|
+
async start() {
|
|
27
|
+
// 启动超时检查
|
|
28
|
+
if (this.config.timeoutCheckInterval > 0) {
|
|
29
|
+
this.timeoutCheckInterval = setInterval(() => this.checkTimeouts(), this.config.timeoutCheckInterval);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* 停止 Supervisor
|
|
34
|
+
*/
|
|
35
|
+
async stop() {
|
|
36
|
+
if (this.timeoutCheckInterval) {
|
|
37
|
+
clearInterval(this.timeoutCheckInterval);
|
|
38
|
+
this.timeoutCheckInterval = undefined;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* 注册 Worker
|
|
43
|
+
*/
|
|
44
|
+
async registerWorker(worker) {
|
|
45
|
+
if (worker.role !== 'worker') {
|
|
46
|
+
throw new Error(`Agent ${worker.id} is not a worker (role: ${worker.role})`);
|
|
47
|
+
}
|
|
48
|
+
this.workers.push(worker);
|
|
49
|
+
await this.runtime.addAgent(worker);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* 移除 Worker
|
|
53
|
+
*/
|
|
54
|
+
async removeWorker(workerId) {
|
|
55
|
+
const index = this.workers.findIndex(w => w.id === workerId);
|
|
56
|
+
if (index === -1) {
|
|
57
|
+
throw new Error(`Worker ${workerId} not found`);
|
|
58
|
+
}
|
|
59
|
+
this.workers.splice(index, 1);
|
|
60
|
+
await this.runtime.removeAgent(workerId);
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* 分配任务
|
|
64
|
+
*/
|
|
65
|
+
async assignTask(description, content, creator) {
|
|
66
|
+
// 检查并发限制
|
|
67
|
+
const status = await this.runtime.getStatus();
|
|
68
|
+
if (status.activeTasks >= this.config.maxConcurrentTasks) {
|
|
69
|
+
throw new Error(`Maximum concurrent tasks (${this.config.maxConcurrentTasks}) reached`);
|
|
70
|
+
}
|
|
71
|
+
// 选择 Worker
|
|
72
|
+
const worker = await this.selectWorker();
|
|
73
|
+
if (!worker) {
|
|
74
|
+
throw new Error('No available workers');
|
|
75
|
+
}
|
|
76
|
+
// 创建任务
|
|
77
|
+
const taskId = await this.runtime.createTask({
|
|
78
|
+
description,
|
|
79
|
+
assignee: worker.id,
|
|
80
|
+
creator,
|
|
81
|
+
content,
|
|
82
|
+
});
|
|
83
|
+
return taskId;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* 选择 Worker(根据策略)
|
|
87
|
+
*/
|
|
88
|
+
async selectWorker() {
|
|
89
|
+
if (this.workers.length === 0) {
|
|
90
|
+
return null;
|
|
91
|
+
}
|
|
92
|
+
// 过滤空闲 Worker
|
|
93
|
+
const availableWorkers = this.workers.filter(w => w.status === 'idle');
|
|
94
|
+
if (availableWorkers.length === 0) {
|
|
95
|
+
return null;
|
|
96
|
+
}
|
|
97
|
+
switch (this.config.assignmentStrategy) {
|
|
98
|
+
case 'round_robin':
|
|
99
|
+
return this.selectRoundRobin(availableWorkers);
|
|
100
|
+
case 'least_busy':
|
|
101
|
+
return this.selectLeastBusy(availableWorkers);
|
|
102
|
+
case 'priority':
|
|
103
|
+
return this.selectByPriority(availableWorkers);
|
|
104
|
+
default:
|
|
105
|
+
return availableWorkers[0];
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* 轮询策略
|
|
110
|
+
*/
|
|
111
|
+
selectRoundRobin(workers) {
|
|
112
|
+
const worker = workers[this.roundRobinIndex % workers.length];
|
|
113
|
+
this.roundRobinIndex++;
|
|
114
|
+
return worker;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* 最少忙碌策略
|
|
118
|
+
*/
|
|
119
|
+
async selectLeastBusy(workers) {
|
|
120
|
+
// 获取每个 Worker 的任务数
|
|
121
|
+
const workerTasks = await Promise.all(workers.map(async (w) => {
|
|
122
|
+
const events = await this.runtime.getEvents(100);
|
|
123
|
+
const taskCount = events.filter(e => e.type === 'task_created' && e.data?.assignee === w.id).length;
|
|
124
|
+
return { worker: w, taskCount };
|
|
125
|
+
}));
|
|
126
|
+
// 选择任务最少的
|
|
127
|
+
workerTasks.sort((a, b) => a.taskCount - b.taskCount);
|
|
128
|
+
return workerTasks[0].worker;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* 优先级策略(根据 Worker 的最后活跃时间)
|
|
132
|
+
*/
|
|
133
|
+
selectByPriority(workers) {
|
|
134
|
+
// 优先选择最近活跃的 Worker
|
|
135
|
+
const sorted = [...workers].sort((a, b) => b.lastActiveAt - a.lastActiveAt);
|
|
136
|
+
return sorted[0];
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* 检查超时任务
|
|
140
|
+
*/
|
|
141
|
+
async checkTimeouts() {
|
|
142
|
+
const events = await this.runtime.getEvents(100);
|
|
143
|
+
const now = Date.now();
|
|
144
|
+
// 查找进行中的任务
|
|
145
|
+
const inProgressTasks = events.filter(e => e.type === 'task_created' && e.data?.taskId);
|
|
146
|
+
for (const event of inProgressTasks) {
|
|
147
|
+
const taskId = event.data.taskId;
|
|
148
|
+
const taskAge = now - event.timestamp;
|
|
149
|
+
if (taskAge > this.config.taskTimeout) {
|
|
150
|
+
// 任务超时
|
|
151
|
+
console.warn(`Task ${taskId} has timed out (${taskAge}ms > ${this.config.taskTimeout}ms)`);
|
|
152
|
+
// 发送超时通知
|
|
153
|
+
await this.runtime.sendMessage({
|
|
154
|
+
from: this.config.supervisorId,
|
|
155
|
+
to: event.agentId ?? null,
|
|
156
|
+
type: 'status_update',
|
|
157
|
+
content: {
|
|
158
|
+
taskId,
|
|
159
|
+
status: 'timeout',
|
|
160
|
+
message: `Task timed out after ${Math.round(taskAge / 1000)}s`,
|
|
161
|
+
},
|
|
162
|
+
metadata: {
|
|
163
|
+
taskId,
|
|
164
|
+
priority: 'high',
|
|
165
|
+
},
|
|
166
|
+
});
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 获取 Worker 列表
|
|
172
|
+
*/
|
|
173
|
+
getWorkers() {
|
|
174
|
+
return [...this.workers];
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* 获取配置
|
|
178
|
+
*/
|
|
179
|
+
getConfig() {
|
|
180
|
+
return { ...this.config };
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* 创建 Supervisor
|
|
185
|
+
*/
|
|
186
|
+
export function createSupervisor(runtime, config) {
|
|
187
|
+
return new Supervisor(runtime, config);
|
|
188
|
+
}
|
|
189
|
+
//# sourceMappingURL=channel-supervisor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"channel-supervisor.js","sourceRoot":"","sources":["../../../src/core/channel/channel-supervisor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Channel 多代理协作类型定义
|
|
3
|
+
*
|
|
4
|
+
* P2-13: 借鉴 Trellis 的 channel 系统
|
|
5
|
+
*
|
|
6
|
+
* 功能:
|
|
7
|
+
* - 事件源多代理运行时
|
|
8
|
+
* - Worker 生命周期管理
|
|
9
|
+
* - Supervisor 模式
|
|
10
|
+
* - Inbox 策略
|
|
11
|
+
*/
|
|
12
|
+
export interface AgentIdentity {
|
|
13
|
+
/** 代理 ID */
|
|
14
|
+
id: string;
|
|
15
|
+
/** 代理名称 */
|
|
16
|
+
name: string;
|
|
17
|
+
/** 代理角色 */
|
|
18
|
+
role: AgentRole;
|
|
19
|
+
/** 创建时间 */
|
|
20
|
+
createdAt: number;
|
|
21
|
+
/** 最后活跃时间 */
|
|
22
|
+
lastActiveAt: number;
|
|
23
|
+
/** 状态 */
|
|
24
|
+
status: AgentStatus;
|
|
25
|
+
}
|
|
26
|
+
export type AgentRole = 'supervisor' | 'worker' | 'reviewer' | 'specialist';
|
|
27
|
+
export type AgentStatus = 'idle' | 'busy' | 'waiting' | 'stopped';
|
|
28
|
+
export interface ChannelMessage {
|
|
29
|
+
/** 消息 ID */
|
|
30
|
+
id: string;
|
|
31
|
+
/** 时间戳 */
|
|
32
|
+
timestamp: number;
|
|
33
|
+
/** 发送者 ID */
|
|
34
|
+
from: string;
|
|
35
|
+
/** 接收者 ID(null 表示广播) */
|
|
36
|
+
to: string | null;
|
|
37
|
+
/** 消息类型 */
|
|
38
|
+
type: MessageType;
|
|
39
|
+
/** 消息内容 */
|
|
40
|
+
content: any;
|
|
41
|
+
/** 元数据 */
|
|
42
|
+
metadata?: MessageMetadata;
|
|
43
|
+
}
|
|
44
|
+
export type MessageType = 'task_assign' | 'task_complete' | 'task_failed' | 'request_help' | 'provide_help' | 'status_update' | 'broadcast';
|
|
45
|
+
export interface MessageMetadata {
|
|
46
|
+
/** 任务 ID */
|
|
47
|
+
taskId?: string;
|
|
48
|
+
/** 优先级 */
|
|
49
|
+
priority?: 'low' | 'medium' | 'high' | 'urgent';
|
|
50
|
+
/** 超时时间 */
|
|
51
|
+
timeout?: number;
|
|
52
|
+
/** 是否需要确认 */
|
|
53
|
+
requireAck?: boolean;
|
|
54
|
+
}
|
|
55
|
+
export interface ChannelTask {
|
|
56
|
+
/** 任务 ID */
|
|
57
|
+
id: string;
|
|
58
|
+
/** 任务描述 */
|
|
59
|
+
description: string;
|
|
60
|
+
/** 分配给 */
|
|
61
|
+
assignee: string;
|
|
62
|
+
/** 创建者 */
|
|
63
|
+
creator: string;
|
|
64
|
+
/** 创建时间 */
|
|
65
|
+
createdAt: number;
|
|
66
|
+
/** 开始时间 */
|
|
67
|
+
startedAt?: number;
|
|
68
|
+
/** 完成时间 */
|
|
69
|
+
completedAt?: number;
|
|
70
|
+
/** 状态 */
|
|
71
|
+
status: TaskStatus;
|
|
72
|
+
/** 任务内容 */
|
|
73
|
+
content: any;
|
|
74
|
+
/** 结果 */
|
|
75
|
+
result?: any;
|
|
76
|
+
/** 错误信息 */
|
|
77
|
+
error?: string;
|
|
78
|
+
}
|
|
79
|
+
export type TaskStatus = 'pending' | 'assigned' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
|
|
80
|
+
export interface InboxStrategy {
|
|
81
|
+
/** 策略名称 */
|
|
82
|
+
name: string;
|
|
83
|
+
/** 最大消息数 */
|
|
84
|
+
maxMessages: number;
|
|
85
|
+
/** 消息保留时间(毫秒) */
|
|
86
|
+
retentionTime: number;
|
|
87
|
+
/** 优先级排序 */
|
|
88
|
+
sortByPriority: boolean;
|
|
89
|
+
/** 自动确认 */
|
|
90
|
+
autoAck: boolean;
|
|
91
|
+
}
|
|
92
|
+
export declare const DEFAULT_INBOX_STRATEGY: InboxStrategy;
|
|
93
|
+
export interface ChannelConfig {
|
|
94
|
+
/** Channel 名称 */
|
|
95
|
+
name: string;
|
|
96
|
+
/** 最大代理数 */
|
|
97
|
+
maxAgents: number;
|
|
98
|
+
/** 默认 Inbox 策略 */
|
|
99
|
+
inboxStrategy: InboxStrategy;
|
|
100
|
+
/** 启用事件日志 */
|
|
101
|
+
enableEventLog: boolean;
|
|
102
|
+
/** 事件日志路径 */
|
|
103
|
+
eventLogPath?: string;
|
|
104
|
+
}
|
|
105
|
+
export interface ChannelEvent {
|
|
106
|
+
/** 事件 ID */
|
|
107
|
+
id: string;
|
|
108
|
+
/** 时间戳 */
|
|
109
|
+
timestamp: number;
|
|
110
|
+
/** 事件类型 */
|
|
111
|
+
type: ChannelEventType;
|
|
112
|
+
/** 事件数据 */
|
|
113
|
+
data: any;
|
|
114
|
+
/** 代理 ID */
|
|
115
|
+
agentId?: string;
|
|
116
|
+
}
|
|
117
|
+
export type ChannelEventType = 'channel_started' | 'channel_stopped' | 'agent_joined' | 'agent_left' | 'message_sent' | 'message_received' | 'task_created' | 'task_assigned' | 'task_updated' | 'task_completed' | 'task_failed';
|
|
118
|
+
export interface ChannelRuntime {
|
|
119
|
+
/** 启动 Channel */
|
|
120
|
+
start(): Promise<void>;
|
|
121
|
+
/** 停止 Channel */
|
|
122
|
+
stop(): Promise<void>;
|
|
123
|
+
/** 添加代理 */
|
|
124
|
+
addAgent(agent: AgentIdentity): Promise<void>;
|
|
125
|
+
/** 移除代理 */
|
|
126
|
+
removeAgent(agentId: string): Promise<void>;
|
|
127
|
+
/** 发送消息 */
|
|
128
|
+
sendMessage(message: Omit<ChannelMessage, 'id' | 'timestamp'>): Promise<string>;
|
|
129
|
+
/** 接收消息 */
|
|
130
|
+
receiveMessages(agentId: string, limit?: number): Promise<ChannelMessage[]>;
|
|
131
|
+
/** 创建任务 */
|
|
132
|
+
createTask(task: Omit<ChannelTask, 'id' | 'createdAt' | 'status'>): Promise<string>;
|
|
133
|
+
/** 更新任务状态 */
|
|
134
|
+
updateTaskStatus(taskId: string, status: TaskStatus, result?: any, error?: string): Promise<void>;
|
|
135
|
+
/** 获取 Channel 状态 */
|
|
136
|
+
getStatus(): Promise<ChannelStatus>;
|
|
137
|
+
/** 获取事件日志 */
|
|
138
|
+
getEvents(limit?: number): Promise<ChannelEvent[]>;
|
|
139
|
+
}
|
|
140
|
+
export interface ChannelStatus {
|
|
141
|
+
/** Channel 名称 */
|
|
142
|
+
name: string;
|
|
143
|
+
/** 运行状态 */
|
|
144
|
+
running: boolean;
|
|
145
|
+
/** 代理数量 */
|
|
146
|
+
agentCount: number;
|
|
147
|
+
/** 待处理消息数 */
|
|
148
|
+
pendingMessages: number;
|
|
149
|
+
/** 活跃任务数 */
|
|
150
|
+
activeTasks: number;
|
|
151
|
+
/** 已完成任务数 */
|
|
152
|
+
completedTasks: number;
|
|
153
|
+
/** 启动时间 */
|
|
154
|
+
startedAt?: number;
|
|
155
|
+
}
|
|
156
|
+
export interface SupervisorConfig {
|
|
157
|
+
/** 监督者 ID */
|
|
158
|
+
supervisorId: string;
|
|
159
|
+
/** 最大并发任务数 */
|
|
160
|
+
maxConcurrentTasks: number;
|
|
161
|
+
/** 任务分配策略 */
|
|
162
|
+
assignmentStrategy: 'round_robin' | 'least_busy' | 'priority';
|
|
163
|
+
/** 超时检查间隔(毫秒) */
|
|
164
|
+
timeoutCheckInterval: number;
|
|
165
|
+
/** 任务超时时间(毫秒) */
|
|
166
|
+
taskTimeout: number;
|
|
167
|
+
}
|
|
168
|
+
export declare const DEFAULT_SUPERVISOR_CONFIG: SupervisorConfig;
|
|
169
|
+
//# sourceMappingURL=channel-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"channel-types.d.ts","sourceRoot":"","sources":["../../../src/core/channel/channel-types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Channel 多代理协作类型定义
|
|
3
|
+
*
|
|
4
|
+
* P2-13: 借鉴 Trellis 的 channel 系统
|
|
5
|
+
*
|
|
6
|
+
* 功能:
|
|
7
|
+
* - 事件源多代理运行时
|
|
8
|
+
* - Worker 生命周期管理
|
|
9
|
+
* - Supervisor 模式
|
|
10
|
+
* - Inbox 策略
|
|
11
|
+
*/
|
|
12
|
+
export const DEFAULT_INBOX_STRATEGY = {
|
|
13
|
+
name: 'default',
|
|
14
|
+
maxMessages: 100,
|
|
15
|
+
retentionTime: 24 * 60 * 60 * 1000, // 24小时
|
|
16
|
+
sortByPriority: true,
|
|
17
|
+
autoAck: false,
|
|
18
|
+
};
|
|
19
|
+
export const DEFAULT_SUPERVISOR_CONFIG = {
|
|
20
|
+
supervisorId: 'supervisor',
|
|
21
|
+
maxConcurrentTasks: 5,
|
|
22
|
+
assignmentStrategy: 'least_busy',
|
|
23
|
+
timeoutCheckInterval: 30000, // 30秒
|
|
24
|
+
taskTimeout: 5 * 60 * 1000, // 5分钟
|
|
25
|
+
};
|
|
26
|
+
//# sourceMappingURL=channel-types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"channel-types.js","sourceRoot":"","sources":["../../../src/core/channel/channel-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwHH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO;IAC3C,cAAc,EAAE,IAAI;IACpB,OAAO,EAAE,KAAK;CACf,CAAC;AAsGF,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,YAAY,EAAE,YAAY;IAC1B,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,YAAY;IAChC,oBAAoB,EAAE,KAAK,EAAE,MAAM;IACnC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM;CACnC,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Channel 多代理协作模块
|
|
3
|
+
*
|
|
4
|
+
* P2-13: 事件源多代理运行时
|
|
5
|
+
*
|
|
6
|
+
* 功能:
|
|
7
|
+
* - 代理生命周期管理
|
|
8
|
+
* - 消息路由
|
|
9
|
+
* - 任务管理
|
|
10
|
+
* - Supervisor 模式
|
|
11
|
+
* - Inbox 策略
|
|
12
|
+
* - 事件日志
|
|
13
|
+
*/
|
|
14
|
+
export type { AgentIdentity, AgentRole, AgentStatus, ChannelMessage, MessageType, MessageMetadata, ChannelTask, TaskStatus, InboxStrategy, ChannelConfig, ChannelEvent, ChannelEventType, ChannelRuntime, ChannelStatus, SupervisorConfig, } from './channel-types.js';
|
|
15
|
+
export { DEFAULT_INBOX_STRATEGY, DEFAULT_SUPERVISOR_CONFIG, } from './channel-types.js';
|
|
16
|
+
export { AgentInbox, InboxManager, } from './channel-inbox.js';
|
|
17
|
+
export { ChannelRuntimeImpl, createChannelRuntime, } from './channel-runtime.js';
|
|
18
|
+
export { Supervisor, createSupervisor, } from './channel-supervisor.js';
|
|
19
|
+
export { EventLogStore, createEventLogStore, } from './channel-event-log.js';
|
|
20
|
+
export type { EventLogFilter, EventLogStats, } from './channel-event-log.js';
|
|
21
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/channel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Channel 多代理协作模块
|
|
3
|
+
*
|
|
4
|
+
* P2-13: 事件源多代理运行时
|
|
5
|
+
*
|
|
6
|
+
* 功能:
|
|
7
|
+
* - 代理生命周期管理
|
|
8
|
+
* - 消息路由
|
|
9
|
+
* - 任务管理
|
|
10
|
+
* - Supervisor 模式
|
|
11
|
+
* - Inbox 策略
|
|
12
|
+
* - 事件日志
|
|
13
|
+
*/
|
|
14
|
+
export { DEFAULT_INBOX_STRATEGY, DEFAULT_SUPERVISOR_CONFIG, } from './channel-types.js';
|
|
15
|
+
// Inbox 管理
|
|
16
|
+
export { AgentInbox, InboxManager, } from './channel-inbox.js';
|
|
17
|
+
// 运行时
|
|
18
|
+
export { ChannelRuntimeImpl, createChannelRuntime, } from './channel-runtime.js';
|
|
19
|
+
// Supervisor
|
|
20
|
+
export { Supervisor, createSupervisor, } from './channel-supervisor.js';
|
|
21
|
+
// 事件日志
|
|
22
|
+
export { EventLogStore, createEventLogStore, } from './channel-event-log.js';
|
|
23
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/channel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,WAAW;AACX,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,MAAM;AACN,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,aAAa;AACb,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO;AACP,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}
|