firmwareloop 0.5.0__tar.gz → 0.6.0__tar.gz

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.5.0
+Version: 0.6.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -59,6 +59,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -381,7 +382,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +392,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -399,6 +400,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/README.md

@@ -31,6 +31,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -353,7 +354,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -363,7 +364,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -371,6 +372,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.5.0
+Version: 0.6.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -59,6 +59,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -381,7 +382,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +392,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -399,6 +400,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/firmwareloop.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ tools/logic_decode.ps1
 tools/ndtdbg_bridge.ps1
 tools/ndtdbg_cli.py
 tools/reset.ps1
+tools/serial_cli.py
 tools/setup-agent-mcp.ps1
 tools/sigrok_csv_to_fwloop.py
 tools/test-backends.ps1
@@ -30,4 +31,5 @@ tools/common/fw.psm1
 tools/common/uart_probe.py
 tools/lib/__init__.py
 tools/lib/instruments.py
-tools/lib/ndtdbg.py
+tools/lib/ndtdbg.py
+tools/lib/serial_assistant.py

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.5.0"
+version = "0.6.0"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/tools/__init__.py

@@ -2,4 +2,4 @@
 FirmwareLoop - AI Agent Firmware Development and Lab Automation Platform.
 """
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{firmwareloop-0.5.0 → firmwareloop-0.6.0}/tools/fw_mcp_server.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.5.0).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.6.0).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, Cursor) via the Model Context
@@ -22,6 +22,13 @@ Tools provided:
   - fw_ndtdbg_stream_start/status/stop: job mode for long stream captures (immediate job_id, CSV-tail polling, graceful stop)
   - fw_ndtdbg_flash: NdtBox IIC firmware flash (.bin/.nfw, full-chip erase, double-gated) (ndtdbg_cli.py)
   - fw_ndtdbg_stream: NdtBox high-rate register stream capture to CSV via one long-lived USB session (read-only) (ndtdbg_cli.py)
+  - fw_serial_status: Serial assistant session probe (serve liveness, port, RX/TX counters, log path) (serial_cli.py)
+  - fw_serial_open: Serial assistant - open (or reuse) the persistent COM session (HEX/ASCII duplex, session log) (serial_cli.py)
+  - fw_serial_send: Serial assistant - send HEX/UTF-8 text or a scripted frame sequence (delay/repeat), confirm-gated (serial_cli.py)
+  - fw_serial_read: Serial assistant - drain received bytes or wait-for-pattern (expect, not sleep) (serial_cli.py)
+  - fw_serial_parse: Serial assistant - frame parsing (delimiter / fixed-length / checksum / field extraction) (serial_cli.py)
+  - fw_serial_capture: Serial assistant - synchronous window capture to CSV with timestamps (serial_cli.py)
+  - fw_serial_close: Serial assistant - close the session and reclaim the serve process (serial_cli.py)
   - fw_logic_capture: Logic analyzer protocol capture (logic_capture.ps1)
   - fw_logic_decode: Logic analyzer protocol decoding & assertion (logic_decode.ps1)
   - fw_get_evidence: Read structured audit run evidence (artifacts/runs/)
@@ -1127,6 +1134,108 @@ def handle_fw_scan_hardware(args: Dict[str, Any]) -> Dict[str, Any]:
     }
 
 
+# ---------------------------------------------------------------------------
+# Serial assistant (fw_serial_*) - persistent COM session via serial_cli.py
+# ---------------------------------------------------------------------------
+
+SERIAL_CLI = os.path.join(REPO_ROOT, "tools", "serial_cli.py")
+
+
+def _serial_run(cmd: List[str], timeout: int) -> Dict[str, Any]:
+    """serial CLI 子进程用 MCP server 进程当前 CWD 运行 (同 _ndtdbg_run 语义:
+    IDE 以用户工程根为 CWD, lab.yaml 的 CWD 查找链依赖它)。"""
+    return run_process(cmd, timeout=timeout, cwd=os.getcwd())
+
+
+def handle_fw_serial_status(args: Dict[str, Any]) -> Dict[str, Any]:
+    res = _serial_run([PYTHON_EXE, SERIAL_CLI, "status"], 30)
+    return res.get("data") or res
+
+
+def handle_fw_serial_open(args: Dict[str, Any]) -> Dict[str, Any]:
+    cmd = [PYTHON_EXE, SERIAL_CLI, "open"]
+    if args.get("port"):
+        cmd.extend(["--port", str(args["port"])])
+    if args.get("baud"):
+        cmd.extend(["--baud", str(args["baud"])])
+    if args.get("backend"):
+        cmd.extend(["--backend", str(args["backend"])])
+    if args.get("data_bits"):
+        cmd.extend(["--data-bits", str(args["data_bits"])])
+    if args.get("parity"):
+        cmd.extend(["--parity", str(args["parity"])])
+    if args.get("stop_bits"):
+        cmd.extend(["--stop-bits", str(args["stop_bits"])])
+    if args.get("lab_config"):
+        cmd.extend(["--lab-config", str(args["lab_config"])])
+    res = _serial_run(cmd, 60)
+    return res.get("data") or res
+
+
+def handle_fw_serial_send(args: Dict[str, Any]) -> Dict[str, Any]:
+    cmd = [PYTHON_EXE, SERIAL_CLI, "send", "--confirm"]  # MCP confirm 默认 true, 网关透传
+    if args.get("hex"):
+        cmd.extend(["--hex", str(args["hex"])])
+    if args.get("text") is not None:
+        cmd.extend(["--text", str(args["text"])])
+    if args.get("frames"):
+        cmd.extend(["--frames", json.dumps(args["frames"], ensure_ascii=False)])
+    if args.get("lab_config"):
+        cmd.extend(["--lab-config", str(args["lab_config"])])
+    res = _serial_run(cmd, 150)  # frames 序列 delay 预算上限 90s + 裕量
+    return res.get("data") or res
+
+
+def handle_fw_serial_read(args: Dict[str, Any]) -> Dict[str, Any]:
+    cmd = [PYTHON_EXE, SERIAL_CLI, "read", "--format", str(args.get("format", "both"))]
+    if args.get("max_bytes"):
+        cmd.extend(["--max-bytes", str(args["max_bytes"])])
+    timeout_ms = int(args.get("timeout_ms", 2000))
+    if args.get("expect"):
+        cmd.extend(["--expect", str(args["expect"]), "--timeout-ms", str(timeout_ms)])
+        if args.get("expect_hex"):
+            cmd.append("--expect-hex")
+    res = _serial_run(cmd, max(30, timeout_ms // 1000 + 30))
+    return res.get("data") or res
+
+
+def handle_fw_serial_parse(args: Dict[str, Any]) -> Dict[str, Any]:
+    cmd = [PYTHON_EXE, SERIAL_CLI, "parse"]
+    if args.get("source"):
+        cmd.extend(["--source", str(args["source"])])
+    if args.get("mode"):
+        cmd.extend(["--mode", str(args["mode"])])
+    if args.get("delimiter"):
+        cmd.extend(["--delimiter", str(args["delimiter"])])
+    if args.get("fixed_length"):
+        cmd.extend(["--fixed-length", str(args["fixed_length"])])
+    if args.get("checksum"):
+        cmd.extend(["--checksum", str(args["checksum"])])
+    if args.get("fields"):
+        cmd.extend(["--fields-json", json.dumps(args["fields"], ensure_ascii=False)])
+    if args.get("lab_config"):
+        cmd.extend(["--lab-config", str(args["lab_config"])])
+    res = _serial_run(cmd, 60)
+    return res.get("data") or res
+
+
+def handle_fw_serial_capture(args: Dict[str, Any]) -> Dict[str, Any]:
+    duration_ms = int(args.get("duration_ms", 3000))
+    cmd = [PYTHON_EXE, SERIAL_CLI, "capture", "--duration-ms", str(duration_ms)]
+    if args.get("out"):
+        cmd.extend(["--out", str(args["out"])])
+    if args.get("lab_config"):
+        cmd.extend(["--lab-config", str(args["lab_config"])])
+    res = _serial_run(cmd, duration_ms // 1000 + 60)
+    return res.get("data") or res
+
+
+def handle_fw_serial_close(args: Dict[str, Any]) -> Dict[str, Any]:
+    res = _serial_run([PYTHON_EXE, SERIAL_CLI, "close"], 30)
+    return res.get("data") or res
+
+
+
 # ===========================================================================
 # Tool Definitions & Schemas
 # ===========================================================================
@@ -1792,6 +1901,150 @@ TOOLS_REGISTRY = {
         },
         "handler": handle_fw_init_project,
     },
+    "fw_serial_status": {
+        "description": "Serial assistant: probe the persistent serial session state (serve process liveness, port/baud, RX/TX counters, buffer watermark, session log path). Run this first to check an existing session.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_status,
+    },
+    "fw_serial_open": {
+        "description": "Serial assistant: open (or reuse) the persistent COM session backed by a long-lived serve process (RX never drops DUT-pushed data). Session log (JSONL, timestamped RX/TX) is written automatically. Same port/baud reuses the session; a different target returns UART_BUSY (close first, single-session in M1). backend=simulator runs an in-process mock DUT for offline tests (results carry simulated: true).",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "port": {
+                    "type": "string",
+                    "description": "COM port (e.g. COM5); defaults to lab.yaml serial.port. Required unless configured or backend=simulator",
+                },
+                "baud": {
+                    "type": "integer",
+                    "description": "Baud rate (default 115200)",
+                    "default": 115200,
+                },
+                "backend": {
+                    "type": "string",
+                    "enum": ["real", "simulator"],
+                    "description": "real=pyserial COM (default) / simulator=mock DUT (offline, simulated results)",
+                    "default": "real",
+                },
+                "data_bits": {"type": "integer", "enum": [5, 6, 7, 8], "default": 8},
+                "parity": {"type": "string", "enum": ["N", "E", "O", "M", "S"], "default": "N"},
+                "stop_bits": {"type": "number", "enum": [1, 1.5, 2], "default": 1},
+                "lab_config": {"type": "string", "description": "Explicit lab.yaml path override"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_open,
+    },
+    "fw_serial_send": {
+        "description": "Serial assistant: send data to the DUT over the open session - HEX ('A1 04 C9 EF', whitespace/0x tolerant) or UTF-8 text, or a scripted frame sequence (frames: [{hex|text, delay_ms, repeat}]) replicating the 'send list packet' workflow. uart_tx is a gated operation: confirm=true (default) required. Total sequence budget <= 90s.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "hex": {
+                    "type": "string",
+                    "description": "HEX payload, e.g. 'A1 04 C9 EF' (mutually exclusive with text; one of hex/text required)",
+                },
+                "text": {
+                    "type": "string",
+                    "description": "UTF-8 text payload (mutually exclusive with hex; one of hex/text required)",
+                },
+                "frames": {
+                    "type": "array",
+                    "description": "Frame sequence (send-list packet): [{hex: 'A1 04', delay_ms: 1000}, {text: '33113', delay_ms: 100, repeat: 3}]; overrides hex/text",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "hex": {"type": "string"},
+                            "text": {"type": "string"},
+                            "delay_ms": {"type": "integer", "description": "Wait after sending this frame (default 0)"},
+                            "repeat": {"type": "integer", "description": "Repeat count (default 1)"},
+                        },
+                    },
+                },
+                "confirm": {
+                    "type": "boolean",
+                    "description": "Confirmation for uart_tx (gated operation)",
+                    "default": True,
+                },
+                "lab_config": {"type": "string", "description": "Explicit lab.yaml path override"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_send,
+    },
+    "fw_serial_read": {
+        "description": "Serial assistant: drain bytes received since last read (hex + ascii both returned), or wait for a pattern in the receive stream (expect, not sleep - aligned with boot_expect semantics). Unread data is preserved: buffer (1 MiB ring) + timestamped JSONL session log, so DUT-pushed data is never lost between calls.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "max_bytes": {"type": "integer", "description": "Max bytes to drain (default 65536)", "default": 65536},
+                "expect": {
+                    "type": "string",
+                    "description": "Wait until this pattern appears in the stream (text; use expect_hex for byte patterns)",
+                },
+                "expect_hex": {"type": "boolean", "description": "Parse expect as HEX", "default": False},
+                "timeout_ms": {"type": "integer", "description": "expect timeout (default 2000)", "default": 2000},
+                "format": {"type": "string", "enum": ["hex", "text", "both"], "default": "both"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_read,
+    },
+    "fw_serial_parse": {
+        "description": "Serial assistant: frame parsing (super-message simplified) - split the session buffer or a session log file into frames (delimiter e.g. '0D 0A', or fixed-length), verify frame checksums (sum8 / crc16-modbus) and extract typed fields (u8/i8/u16le/u32le/f32le/hex/text). Rules default to lab.yaml serial.parser; pass explicit args to override.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "source": {
+                    "type": "string",
+                    "description": "'session' (drain current buffer) or path to a JSONL session log",
+                    "default": "session",
+                },
+                "mode": {"type": "string", "enum": ["none", "delimiter", "fixed_length"]},
+                "delimiter": {"type": "string", "description": "HEX delimiter, e.g. '0D 0A' (default)"},
+                "fixed_length": {"type": "integer", "description": "Frame length for fixed_length mode"},
+                "checksum": {"type": "string", "enum": ["none", "sum8", "crc16-modbus"], "description": "Frame-trailer checksum algorithm"},
+                "fields": {
+                    "type": "array",
+                    "description": "Field extraction: [{name, offset, type: u8|i8|u16le|u16be|i16le|i16be|u32le|u32be|i32le|i32be|f32le|f32be|hex|text, len?}]",
+                    "items": {"type": "object"},
+                },
+                "lab_config": {"type": "string", "description": "Explicit lab.yaml path override"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_parse,
+    },
+    "fw_serial_capture": {
+        "description": "Serial assistant: synchronous window capture - record the RX stream for duration_ms into a timestamped CSV (t_rel_ms, dir, hex, printable) for offline analysis/plotting (real-time-curve equivalent; plotting happens in your tools/Agent from the CSV). duration_ms <= 90000; long background captures (job mode) are a planned follow-up.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "duration_ms": {
+                    "type": "integer",
+                    "description": "Capture window length in ms (1..90000)",
+                    "default": 3000,
+                },
+                "out": {"type": "string", "description": "CSV output path (defaults to a temp-dir file)"},
+                "lab_config": {"type": "string", "description": "Explicit lab.yaml path override"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_capture,
+    },
+    "fw_serial_close": {
+        "description": "Serial assistant: close the session, stop the serve process and release the COM port. Returns final RX/TX stats.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_serial_close,
+    },
 }
 
 
@@ -1828,7 +2081,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.5.0"
+                    "version": "0.6.0"
                 }
             }
         }
@@ -1963,7 +2216,7 @@ def _settle_stashed_entrypoints(stashed) -> None:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.5.0)")
+    print("  FirmwareLoop Auto-Updater (v0.6.0)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -2356,7 +2609,7 @@ def set_ndtdbg_dlldir(dll_path: str) -> str:
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, Qoder IDE, and CodeBuddy IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.5.0)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.6.0)")
     print("============================================================")
     print("")
 
@@ -2481,7 +2734,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.5.0)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.6.0)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -2502,7 +2755,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.5.0)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.6.0)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -2545,7 +2798,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.5.0")
+            print("FirmwareLoop v0.6.0")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()