silentlake 2026.3.24

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Peter Steinberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,248 @@
+# 🌊 SilentLake — 多 Agent 协作平台
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SlientLake/SlientLakeAgent/main/assets/silentlake-banner.png" alt="SilentLake" width="560">
+</p>
+
+<p align="center">
+  <strong>9 Agent · 多级组织 · 实时协作 · 本地优先</strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/基于-OpenClaw-ff6b35?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyeiIvPjwvc3ZnPg==" alt="Based on OpenClaw">
+  <img src="https://img.shields.io/badge/版本-v2.0-4fc3f7?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/npm-silentlake-cb3837?style=for-the-badge&logo=npm&logoColor=white" alt="npm silentlake">
+  <img src="https://img.shields.io/badge/Node-22%2B-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node 22+">
+  <img src="https://img.shields.io/badge/Python-3.10%2B-3776ab?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="MIT License">
+</p>
+
+---
+
+**SilentLake** 是基于 [OpenClaw](https://github.com/openclaw/openclaw) 的多 Agent 协作平台二开版本。
+
+在 OpenClaw 单助手能力的基础上，SilentLake 构建了一套 **9 Agent 多级组织架构**：总指挥统筹全局，各职能 Agent 分工协作，通过实时 A2A 消息通道、拓扑可视化和知识库共享，形成一个完整的 AI 团队。
+
+> 如果说 OpenClaw 是"你的个人 AI 助手"，SilentLake 就是"你的 AI 团队"。
+
+---
+
+## 组织架构
+
+```
+总指挥 (Commander)
+├── 首席执行官 (CEO)
+│   ├── 产品经理 (PM)
+│   ├── 工程师 (Engineer)
+│   └── 设计师 (Designer)
+├── 首席运营官 (COO)
+│   ├── 运营专员 (Operations)
+│   └── 数据分析师 (Analyst)
+└── 首席内容官 (CCO)
+    └── 内容创作者 (Creator)
+```
+
+每个 Agent 可独立配置模型、Coding Skill、工作优先级，并通过 A2A 通道互相汇报和协作。
+
+---
+
+## 相对上游新增功能
+
+### 🖥️ UI 前端
+
+| 功能                   | 说明                                                         |
+| ---------------------- | ------------------------------------------------------------ |
+| **聊天室**             | 飞书风格多房间聊天，支持 @mention Agent、实时 WebSocket 推送 |
+| **组织拓扑图**         | SVG 力导向图，可视化 9 Agent 层级与协作关系，可拖拽节点      |
+| **MCP 管理**           | 查看已注册 MCP Server，按 category 分组，一键启用/禁用       |
+| **知识库管理**         | 创建/删除知识库，支持 vector/doc/graph 多种类型              |
+| **per-Agent 模型配置** | 每个 Agent 独立选择主模型和 fallback 模型                    |
+| **zh-CN 完整翻译**     | 全 UI 中英双语，默认中文，语言选择器随时切换                 |
+
+### ⌨️ CLI 命令
+
+```bash
+# 查看组织拓扑（表格 / Mermaid / JSON）
+silentlake topology
+silentlake topology --mermaid
+silentlake topology --json
+
+# 查看 Agent 汇报记录
+silentlake report list
+silentlake report list <agent-id> --limit 20
+
+# 知识库管理
+silentlake kb list
+silentlake kb create --id my-kb --name "研发知识库" --type vector
+silentlake kb delete <id>
+
+# Coding Skill 管理（per-Agent）
+silentlake skills coding list
+silentlake skills coding set claude-code
+```
+
+### 🔗 平台集成
+
+| 模块                     | 说明                                                            |
+| ------------------------ | --------------------------------------------------------------- |
+| **A2A 消息通道**         | `A2AChannel` 类，REST + WebSocket 持久化 Agent 间通信           |
+| **心跳注册**             | Gateway 启动时自动注册到 Python 平台，每 60 秒心跳              |
+| **Python 平台 REST API** | 新增 MCP/KB/心跳/A2A 路由，aiohttp 实现                         |
+| **CLI 中文化**           | `OPENCLAW_LANG=zh-CN` 启用中文终端输出，banner 显示中文 tagline |
+
+### 🧩 Skills 占位
+
+| Skill            | 状态 | 说明                                |
+| ---------------- | ---- | ----------------------------------- |
+| `kimi-code` 🌙   | 占位 | 月之暗面 Kimi Code CLI 发布后激活   |
+| `doubao-code` 🫘 | 占位 | 字节跳动 Doubao Code CLI 发布后激活 |
+
+---
+
+## 安装
+
+### npm 安装（推荐）
+
+```bash
+npm install -g silentlake
+# 或
+pnpm add -g silentlake
+```
+
+安装后运行引导向导：
+
+```bash
+silentlake onboard --install-daemon
+```
+
+---
+
+## 快速开始
+
+### 环境要求
+
+- Node.js 22+
+- Python 3.10+
+- pnpm 8+
+
+### 1. 启动 Python 平台
+
+```bash
+cd platform
+pip install -e .
+
+# 启动 Dashboard（http://localhost:18800）
+oc-platform platform start
+```
+
+### 2. 构建并启动 SilentLake
+
+```bash
+cd SlientLake
+
+# 安装依赖
+pnpm install
+
+# 构建 UI
+cd ui && pnpm build && cd ..
+
+# 构建 CLI
+pnpm build
+
+# 启动 Gateway（自动注册到 Python 平台）
+silentlake gateway --port 18789
+```
+
+### 3. 打开控制台
+
+浏览器访问 `http://localhost:18789` 即可看到 SilentLake 控制台，包含聊天室、拓扑图、MCP 管理、知识库等所有新功能。
+
+---
+
+## 前端开发
+
+```bash
+cd SlientLake/ui
+
+# 热重载开发
+pnpm dev
+
+# 构建
+pnpm build
+
+# 类型检查
+pnpm tsgo
+```
+
+---
+
+## 目录结构（二开关键路径）
+
+```
+silentlake/                        ← 仓库根目录
+├── platform/                      ← Python 平台（oc-platform）
+│   ├── api/                       #   REST API（Dashboard、MCP、KB、A2A、心跳）
+│   ├── core/                      #   核心调度逻辑
+│   ├── services/                  #   MCP / A2A / KB 服务
+│   ├── knowledge/                 #   知识库管理
+│   ├── main.py                    #   平台入口
+│   └── requirements.txt
+├── src/
+│   ├── cli/
+│   │   ├── topology-cli.ts        # openclaw topology 命令
+│   │   ├── report-cli.ts          # openclaw report 命令
+│   │   ├── kb-cli.ts              # openclaw kb 命令
+│   │   └── skills-cli.ts          # openclaw skills coding 命令（扩展）
+│   ├── platform/
+│   │   ├── register.ts            # Gateway 心跳注册
+│   │   └── a2a-channel.ts         # A2A Agent 间消息通道
+│   └── terminal/
+│       └── locale.ts              # CLI 中文化（tt() / getTerminalLocale()）
+├── ui/src/ui/
+│   ├── views/
+│   │   ├── chatroom.ts            # 聊天室 UI
+│   │   ├── topology.ts            # 拓扑图 UI
+│   │   ├── mcp-manager.ts         # MCP 管理 UI
+│   │   └── kb-manager.ts          # 知识库管理 UI
+│   └── navigation.ts              # 导航 tab 注册
+├── skills/
+│   ├── kimi-code/SKILL.md         # Kimi Code 占位 skill
+│   └── doubao-code/SKILL.md       # Doubao Code 占位 skill
+└── SILENTLAKE.md                  # 本文件
+```
+
+---
+
+## 配置 CLI 中文
+
+```bash
+# 临时
+OPENCLAW_LANG=zh-CN openclaw topology
+
+# 永久（写入 ~/.profile 或 ~/.bashrc）
+export OPENCLAW_LANG=zh-CN
+```
+
+---
+
+## 二开计划文档
+
+详细任务说明和完成记录见：
+
+```
+二开v1版本/04_二开承接指引手册_v1.0.md
+```
+
+---
+
+## 上游项目
+
+SilentLake 基于 [OpenClaw](https://github.com/openclaw/openclaw) 构建，保留全部上游能力（多渠道消息、插件体系、模型切换等）。
+
+上游文档：[docs.openclaw.ai](https://docs.openclaw.ai)
+
+---
+
+<p align="center">
+  🌊 SilentLake · 多 Agent 协作，静水流深
+</p>

package/assets/avatar-placeholder.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Anonymous">
+  <rect width="48" height="48" rx="6" fill="#1f2937"/>
+  <g fill="#f97316">
+    <circle cx="24" cy="26" r="9"/>
+    <circle cx="24" cy="15" r="6"/>
+    <circle cx="14" cy="18" r="3"/>
+    <circle cx="34" cy="18" r="3"/>
+  </g>
+  <g stroke="#f97316" stroke-width="2" stroke-linecap="round">
+    <path d="M10 10c4 1 7 3 9 6"/>
+    <path d="M38 10c-4 1-7 3-9 6"/>
+    <path d="M13 34c2 2 5 4 11 4"/>
+    <path d="M35 34c-2 2-5 4-11 4"/>
+  </g>
+  <g fill="#111827">
+    <circle cx="22" cy="14" r="1"/>
+    <circle cx="26" cy="14" r="1"/>
+  </g>
+</svg>

package/dist/APEv2Parser-BZv_dP9t.js

@@ -0,0 +1,269 @@
+import { o as __toESM, t as require_src } from "./src-CmXHIz5f.js";
+import { A as textEncode, C as UINT32_LE, D as Uint8ArrayType, _ as StringType, i as InternalParserError, k as textDecode, r as FieldDecodingError, s as makeUnexpectedFileContentError, t as BasicParser, y as UINT16_LE } from "./BasicParser-DhmXREDo.js";
+import { r as fromBuffer } from "./lib-CERS7N4b.js";
+import { i as findZero, t as a2hex } from "./Util-D_zGsr97.js";
+//#region node_modules/music-metadata/lib/common/FourCC.js
+const validFourCC = /^[\x21-\x7e©][\x20-\x7e\x00()]{3}/;
+/**
+* Token for read FourCC
+* Ref: https://en.wikipedia.org/wiki/FourCC
+*/
+const FourCcToken = {
+	len: 4,
+	get: (buf, off) => {
+		const id = textDecode(buf.subarray(off, off + FourCcToken.len), "latin1");
+		if (!id.match(validFourCC)) throw new FieldDecodingError(`FourCC contains invalid characters: ${a2hex(id)} "${id}"`);
+		return id;
+	},
+	put: (buffer, offset, id) => {
+		const str = textEncode(id, "latin1");
+		if (str.length !== 4) throw new InternalParserError("Invalid length");
+		buffer.set(str, offset);
+		return offset + 4;
+	}
+};
+//#endregion
+//#region node_modules/music-metadata/lib/apev2/APEv2Token.js
+const DataType = {
+	text_utf8: 0,
+	binary: 1,
+	external_info: 2,
+	reserved: 3
+};
+/**
+* APE_DESCRIPTOR: defines the sizes (and offsets) of all the pieces, as well as the MD5 checksum
+*/
+const DescriptorParser = {
+	len: 52,
+	get: (buf, off) => {
+		return {
+			ID: FourCcToken.get(buf, off),
+			version: UINT32_LE.get(buf, off + 4) / 1e3,
+			descriptorBytes: UINT32_LE.get(buf, off + 8),
+			headerBytes: UINT32_LE.get(buf, off + 12),
+			seekTableBytes: UINT32_LE.get(buf, off + 16),
+			headerDataBytes: UINT32_LE.get(buf, off + 20),
+			apeFrameDataBytes: UINT32_LE.get(buf, off + 24),
+			apeFrameDataBytesHigh: UINT32_LE.get(buf, off + 28),
+			terminatingDataBytes: UINT32_LE.get(buf, off + 32),
+			fileMD5: new Uint8ArrayType(16).get(buf, off + 36)
+		};
+	}
+};
+/**
+* APE_HEADER: describes all of the necessary information about the APE file
+*/
+const Header = {
+	len: 24,
+	get: (buf, off) => {
+		return {
+			compressionLevel: UINT16_LE.get(buf, off),
+			formatFlags: UINT16_LE.get(buf, off + 2),
+			blocksPerFrame: UINT32_LE.get(buf, off + 4),
+			finalFrameBlocks: UINT32_LE.get(buf, off + 8),
+			totalFrames: UINT32_LE.get(buf, off + 12),
+			bitsPerSample: UINT16_LE.get(buf, off + 16),
+			channel: UINT16_LE.get(buf, off + 18),
+			sampleRate: UINT32_LE.get(buf, off + 20)
+		};
+	}
+};
+/**
+* APE Tag Header/Footer Version 2.0
+* TAG: describes all the properties of the file [optional]
+*/
+const TagFooter = {
+	len: 32,
+	get: (buf, off) => {
+		return {
+			ID: new StringType(8, "ascii").get(buf, off),
+			version: UINT32_LE.get(buf, off + 8),
+			size: UINT32_LE.get(buf, off + 12),
+			fields: UINT32_LE.get(buf, off + 16),
+			flags: parseTagFlags(UINT32_LE.get(buf, off + 20))
+		};
+	}
+};
+/**
+* APE Tag v2.0 Item Header
+*/
+const TagItemHeader = {
+	len: 8,
+	get: (buf, off) => {
+		return {
+			size: UINT32_LE.get(buf, off),
+			flags: parseTagFlags(UINT32_LE.get(buf, off + 4))
+		};
+	}
+};
+function parseTagFlags(flags) {
+	return {
+		containsHeader: isBitSet(flags, 31),
+		containsFooter: isBitSet(flags, 30),
+		isHeader: isBitSet(flags, 29),
+		readOnly: isBitSet(flags, 0),
+		dataType: (flags & 6) >> 1
+	};
+}
+/**
+* @param num {number}
+* @param bit 0 is least significant bit (LSB)
+* @return {boolean} true if bit is 1; otherwise false
+*/
+function isBitSet(num, bit) {
+	return (num & 1 << bit) !== 0;
+}
+const debug = (0, (/* @__PURE__ */ __toESM(require_src(), 1)).default)("music-metadata:parser:APEv2");
+const tagFormat = "APEv2";
+const preamble = "APETAGEX";
+var ApeContentError = class extends makeUnexpectedFileContentError("APEv2") {};
+function tryParseApeHeader(metadata, tokenizer, options) {
+	return new APEv2Parser(metadata, tokenizer, options).tryParseApeHeader();
+}
+var APEv2Parser = class APEv2Parser extends BasicParser {
+	constructor() {
+		super(...arguments);
+		this.ape = {};
+	}
+	/**
+	* Calculate the media file duration
+	* @param ah ApeHeader
+	* @return {number} duration in seconds
+	*/
+	static calculateDuration(ah) {
+		let duration = ah.totalFrames > 1 ? ah.blocksPerFrame * (ah.totalFrames - 1) : 0;
+		duration += ah.finalFrameBlocks;
+		return duration / ah.sampleRate;
+	}
+	/**
+	* Calculates the APEv1 / APEv2 first field offset
+	* @param tokenizer
+	* @param offset
+	*/
+	static async findApeFooterOffset(tokenizer, offset) {
+		const apeBuf = new Uint8Array(TagFooter.len);
+		const position = tokenizer.position;
+		if (offset <= TagFooter.len) {
+			debug(`Offset is too small to read APE footer: offset=${offset}`);
+			return;
+		}
+		if (offset > TagFooter.len) {
+			await tokenizer.readBuffer(apeBuf, { position: offset - TagFooter.len });
+			tokenizer.setPosition(position);
+			const tagFooter = TagFooter.get(apeBuf, 0);
+			if (tagFooter.ID === "APETAGEX") {
+				if (tagFooter.flags.isHeader) debug(`APE Header found at offset=${offset - TagFooter.len}`);
+				else {
+					debug(`APE Footer found at offset=${offset - TagFooter.len}`);
+					offset -= tagFooter.size;
+				}
+				return {
+					footer: tagFooter,
+					offset
+				};
+			}
+		}
+	}
+	static parseTagFooter(metadata, buffer, options) {
+		const footer = TagFooter.get(buffer, buffer.length - TagFooter.len);
+		if (footer.ID !== preamble) throw new ApeContentError("Unexpected APEv2 Footer ID preamble value");
+		fromBuffer(buffer);
+		return new APEv2Parser(metadata, fromBuffer(buffer), options).parseTags(footer);
+	}
+	/**
+	* Parse APEv1 / APEv2 header if header signature found
+	*/
+	async tryParseApeHeader() {
+		if (this.tokenizer.fileInfo.size && this.tokenizer.fileInfo.size - this.tokenizer.position < TagFooter.len) {
+			debug("No APEv2 header found, end-of-file reached");
+			return;
+		}
+		const footer = await this.tokenizer.peekToken(TagFooter);
+		if (footer.ID === preamble) {
+			await this.tokenizer.ignore(TagFooter.len);
+			return this.parseTags(footer);
+		}
+		debug(`APEv2 header not found at offset=${this.tokenizer.position}`);
+		if (this.tokenizer.fileInfo.size) {
+			const remaining = this.tokenizer.fileInfo.size - this.tokenizer.position;
+			const buffer = new Uint8Array(remaining);
+			await this.tokenizer.readBuffer(buffer);
+			return APEv2Parser.parseTagFooter(this.metadata, buffer, this.options);
+		}
+	}
+	async parse() {
+		const descriptor = await this.tokenizer.readToken(DescriptorParser);
+		if (descriptor.ID !== "MAC ") throw new ApeContentError("Unexpected descriptor ID");
+		this.ape.descriptor = descriptor;
+		const lenExp = descriptor.descriptorBytes - DescriptorParser.len;
+		const header = await (lenExp > 0 ? this.parseDescriptorExpansion(lenExp) : this.parseHeader());
+		this.metadata.setAudioOnly();
+		await this.tokenizer.ignore(header.forwardBytes);
+		return this.tryParseApeHeader();
+	}
+	async parseTags(footer) {
+		const keyBuffer = new Uint8Array(256);
+		let bytesRemaining = footer.size - TagFooter.len;
+		debug(`Parse APE tags at offset=${this.tokenizer.position}, size=${bytesRemaining}`);
+		for (let i = 0; i < footer.fields; i++) {
+			if (bytesRemaining < TagItemHeader.len) {
+				this.metadata.addWarning(`APEv2 Tag-header: ${footer.fields - i} items remaining, but no more tag data to read.`);
+				break;
+			}
+			const tagItemHeader = await this.tokenizer.readToken(TagItemHeader);
+			bytesRemaining -= TagItemHeader.len + tagItemHeader.size;
+			await this.tokenizer.peekBuffer(keyBuffer, { length: Math.min(keyBuffer.length, bytesRemaining) });
+			let zero = findZero(keyBuffer);
+			const key = await this.tokenizer.readToken(new StringType(zero, "ascii"));
+			await this.tokenizer.ignore(1);
+			bytesRemaining -= key.length + 1;
+			switch (tagItemHeader.flags.dataType) {
+				case DataType.text_utf8: {
+					const values = (await this.tokenizer.readToken(new StringType(tagItemHeader.size, "utf8"))).split(/\x00/g);
+					await Promise.all(values.map((val) => this.metadata.addTag(tagFormat, key, val)));
+					break;
+				}
+				case DataType.binary:
+					if (this.options.skipCovers) await this.tokenizer.ignore(tagItemHeader.size);
+					else {
+						const picData = new Uint8Array(tagItemHeader.size);
+						await this.tokenizer.readBuffer(picData);
+						zero = findZero(picData);
+						const description = textDecode(picData.subarray(0, zero), "utf-8");
+						const data = picData.subarray(zero + 1);
+						await this.metadata.addTag(tagFormat, key, {
+							description,
+							data
+						});
+					}
+					break;
+				case DataType.external_info:
+					debug(`Ignore external info ${key}`);
+					await this.tokenizer.ignore(tagItemHeader.size);
+					break;
+				case DataType.reserved:
+					debug(`Ignore external info ${key}`);
+					this.metadata.addWarning(`APEv2 header declares a reserved datatype for "${key}"`);
+					await this.tokenizer.ignore(tagItemHeader.size);
+					break;
+			}
+		}
+	}
+	async parseDescriptorExpansion(lenExp) {
+		await this.tokenizer.ignore(lenExp);
+		return this.parseHeader();
+	}
+	async parseHeader() {
+		const header = await this.tokenizer.readToken(Header);
+		this.metadata.setFormat("lossless", true);
+		this.metadata.setFormat("container", "Monkey's Audio");
+		this.metadata.setFormat("bitsPerSample", header.bitsPerSample);
+		this.metadata.setFormat("sampleRate", header.sampleRate);
+		this.metadata.setFormat("numberOfChannels", header.channel);
+		this.metadata.setFormat("duration", APEv2Parser.calculateDuration(header));
+		if (!this.ape.descriptor) throw new ApeContentError("Missing APE descriptor");
+		return { forwardBytes: this.ape.descriptor.seekTableBytes + this.ape.descriptor.headerDataBytes + this.ape.descriptor.apeFrameDataBytes + this.ape.descriptor.terminatingDataBytes };
+	}
+};
+//#endregion
+export { FourCcToken as i, ApeContentError as n, tryParseApeHeader as r, APEv2Parser as t };

package/dist/APEv2Parser-CPzxFNBB.js

@@ -0,0 +1,5 @@
+import "./src-CmXHIz5f.js";
+import "./BasicParser-DhmXREDo.js";
+import "./lib-CERS7N4b.js";
+import { t as APEv2Parser } from "./APEv2Parser-BZv_dP9t.js";
+export { APEv2Parser };

package/dist/AbstractID3Parser-mvDFcjYV.js

@@ -0,0 +1,47 @@
+import { o as __toESM, t as require_src } from "./src-CmXHIz5f.js";
+import { t as BasicParser } from "./BasicParser-DhmXREDo.js";
+import { i as EndOfStreamError } from "./lib-CERS7N4b.js";
+import { r as ID3v2Header } from "./ID3v2Token-DeJf4tYQ.js";
+import { n as ID3v1Parser } from "./ID3v1Parser-BICWWVDG.js";
+import { t as ID3v2Parser } from "./ID3v2Parser-BmZHSUqs.js";
+const debug = (0, (/* @__PURE__ */ __toESM(require_src(), 1)).default)("music-metadata:parser:ID3");
+/**
+* Abstract parser which tries take ID3v2 and ID3v1 headers.
+*/
+var AbstractID3Parser = class extends BasicParser {
+	constructor() {
+		super(...arguments);
+		this.id3parser = new ID3v2Parser();
+	}
+	static async startsWithID3v2Header(tokenizer) {
+		return (await tokenizer.peekToken(ID3v2Header)).fileIdentifier === "ID3";
+	}
+	async parse() {
+		try {
+			await this.parseID3v2();
+		} catch (err) {
+			if (err instanceof EndOfStreamError) debug("End-of-stream");
+			else throw err;
+		}
+	}
+	finalize() {}
+	async parseID3v2() {
+		await this.tryReadId3v2Headers();
+		debug("End of ID3v2 header, go to MPEG-parser: pos=%s", this.tokenizer.position);
+		await this.postId3v2Parse();
+		if (this.options.skipPostHeaders && this.metadata.hasAny()) this.finalize();
+		else {
+			await new ID3v1Parser(this.metadata, this.tokenizer, this.options).parse();
+			this.finalize();
+		}
+	}
+	async tryReadId3v2Headers() {
+		if ((await this.tokenizer.peekToken(ID3v2Header)).fileIdentifier === "ID3") {
+			debug("Found ID3v2 header, pos=%s", this.tokenizer.position);
+			await this.id3parser.parse(this.metadata, this.tokenizer, this.options);
+			return this.tryReadId3v2Headers();
+		}
+	}
+};
+//#endregion
+export { AbstractID3Parser as t };