crosspad-mcp-server 9.1.0 → 9.2.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "crosspad",
   "description": "CrossPad development toolkit: the crosspad-mcp server plus two Claude Code skills — `crosspad` (onboarding/help: ecosystem map, install & config, per-role guides, tool cheat-sheet, FAQ — use this first) and `swd-tracer` (real-time SWD variable tracing for CrossPad r20 / STM32G0B1 firmware over ST-Link).",
-  "version": "9.1.0",
+  "version": "9.1.1",
   "author": {
     "name": "Mateusz Czarnecki"
   },

package/dist/config.d.ts

@@ -5,6 +5,13 @@ export declare const CROSSPAD_IDF_ROOT: string;
 export declare const CROSSPAD_STM_ROOT: string;
 export declare const STM_ELF_DEFAULT: string;
 export declare const TRACE_DIR_DEFAULT: string;
+export declare const STM_PROJECT_NAME = "CrossPad_STM32_r20";
+export declare const STM_FLASH_ADDR = "0x08000000";
+export type StmPreset = "Debug" | "Release";
+/** Build directory for a preset: <repo>/build/<preset>. */
+export declare function stmBuildDir(preset: StmPreset): string;
+/** Artifact path for a preset, e.g. build/Debug/CrossPad_STM32_r20.elf. */
+export declare function stmArtifact(preset: StmPreset, ext: "elf" | "bin" | "hex"): string;
 export declare const IDF_PATH: string;
 export declare const VCVARSALL: string;
 export declare const VCPKG_TOOLCHAIN: string;

package/dist/config.js

@@ -23,6 +23,21 @@ export const CROSSPAD_STM_ROOT = process.env.CROSSPAD_STM_ROOT || path.join(GIT_
 // Trace defaults (overridable later via user config at call sites).
 export const STM_ELF_DEFAULT = path.join(CROSSPAD_STM_ROOT, "build", "Debug", "CrossPad_STM32_r20.elf");
 export const TRACE_DIR_DEFAULT = path.join(CROSSPAD_STM_ROOT, "traces");
+// ─── STM32 build / flash ─────────────────────────────────────────────────
+// CMake project name (artifact basename) and the CMakePresets.json preset
+// names. binaryDir is build/<preset> per the preset's `binaryDir` template.
+export const STM_PROJECT_NAME = "CrossPad_STM32_r20";
+// Flash base address — STM32G0 internal flash origin (matches the *.ld linker
+// script ORIGIN and the STM32_Programmer_CLI invocations in CLAUDE.md).
+export const STM_FLASH_ADDR = "0x08000000";
+/** Build directory for a preset: <repo>/build/<preset>. */
+export function stmBuildDir(preset) {
+    return path.join(CROSSPAD_STM_ROOT, "build", preset);
+}
+/** Artifact path for a preset, e.g. build/Debug/CrossPad_STM32_r20.elf. */
+export function stmArtifact(preset, ext) {
+    return path.join(stmBuildDir(preset), `${STM_PROJECT_NAME}.${ext}`);
+}
 // ═══════════════════════════════════════════════════════════════════════
 // ESP-IDF SDK PATH — fallback chain
 // ═══════════════════════════════════════════════════════════════════════

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11,6 +11,8 @@ import { BIN_EXE as _BIN_EXE } from "./config.js";
 import { crosspadLog } from "./tools/log.js";
 import { crosspadIdfBuild } from "./tools/idf-build.js";
 import { crosspadIdfFlash, crosspadIdfOta } from "./tools/idf-flash.js";
+import { crosspadStmBuild } from "./tools/stm-build.js";
+import { crosspadStmFlash } from "./tools/stm-flash.js";
 import { crosspadIdfMonitor } from "./tools/idf-monitor.js";
 import { listDevices } from "./utils/device.js";
 import { crosspadTest } from "./tools/test.js";
@@ -26,10 +28,10 @@ import { crosspadSettingsGet, crosspadSettingsSet } from "./tools/settings.js";
 import { crosspadMidiSend } from "./tools/midi.js";
 import { crosspadAppList, crosspadAppInstall, crosspadAppRemove, crosspadAppUpdate, crosspadAppSync, } from "./tools/app-manager.js";
 import { runDoctor, realProbe } from "./tools/trace-doctor.js";
-import { setConfigValue } from "./utils/userConfig.js";
+import { setConfigValue, resolveConfigValue } from "./utils/userConfig.js";
 import { listSymbols } from "./tools/trace-symbols.js";
 import { getDeviceState } from "./tools/trace-device.js";
-import { TraceSession, getActiveSession, setActiveSession } from "./tools/trace-session.js";
+import { TraceSession, getActiveSession, setActiveSession, traceWrite, traceCall } from "./tools/trace-session.js";
 import { getDashboard, openInBrowser, buildUiUrl } from "./tools/trace-webui.js";
 import { writeCsv } from "./tools/trace-export.js";
 // Server instructions — MCP clients prepend these to the LLM system prompt.
@@ -42,14 +44,15 @@ You have access to the CrossPad MCP server, which exposes purpose-built tools fo
 
 NEW TO A CROSSPAD REPO OR SETTING UP? Use the \`crosspad\` skill first — it maps the ecosystem (repos, MCP tools, roles), walks install/config, and routes to per-role guides + an FAQ. Run \`bash scripts/doctor.sh\` from that skill to check your environment.
 
-TOOL TAGS — a tool description starting with a bracket tag has a hardware/platform precondition: \`[PC sim]\` needs the host simulator built & running (crosspad_build platform=pc → crosspad_run); \`[ESP HW]\` needs a connected ESP32-S3 device; \`[STM HW]\` needs an ST-Link + STM32 board. Untagged tools (code search, repo/git, apps registry) need no hardware.
+TOOL TAGS — a tool description starting with a bracket tag has a platform/hardware precondition. Atomic tokens: \`[PC]\` = the crosspad-pc repo + host toolchain (build/test/inspect — no running sim); \`[PC sim]\` = a RUNNING simulator instance (launch it with crosspad_run first); \`[ESP HW]\` = a connected ESP32-S3 device; \`[STM HW]\` = an ST-Link + STM32 board. Tokens combine: \`+\` = both contexts at once (e.g. \`[PC + ESP]\`); \`|\` = either, depending on a param (e.g. \`[PC | ESP HW]\`). Untagged tools (code search, repo/git, apps registry) need no hardware.
 
 WHEN TO USE THESE TOOLS — in any conversation that touches a CrossPad repo, prefer the crosspad_* tools over raw shell equivalents:
 
 - Inspecting code  → crosspad_search_symbols (NOT \`grep -r\`); crosspad_list_interfaces; crosspad_interface_implementations.
 - Repo state       → crosspad_repo_status (NOT \`git status\` across N repos); crosspad_repo_diff for submodule drift.
 - Building PC sim  → crosspad_check platform=pc → crosspad_build platform=pc (NOT raw cmake/ninja). Then crosspad_run; crosspad_kill when done.
-- Building firmware→ crosspad_build platform=idf (NOT raw \`idf.py build\`); crosspad_flash transport=uart|ota.
+- Building ESP fw  → crosspad_build platform=idf (NOT raw \`idf.py build\`); crosspad_flash target=esp transport=uart|ota.
+- Building STM fw   → crosspad_build platform=stm (NOT raw cmake/STM32_Programmer_CLI for CrossPad_STM32_r20); crosspad_flash target=stm method=swd|dfu.
 - Tests            → crosspad_test_run (NOT raw catch2 binary).
 - Sim interaction  → crosspad_screenshot, crosspad_input, crosspad_midi, crosspad_stats, crosspad_settings_get/set.
 - Apps (registry)  → crosspad_apps_list / install / remove / update / sync (NOT manual submodule git ops).
@@ -212,8 +215,12 @@ const O_BuildCheck = {
 };
 const O_Flash = {
     success: z.boolean(),
-    method: z.enum(["uart", "ota"]),
-    port: z.string(),
+    method: z.enum(["uart", "ota", "swd", "dfu"]),
+    // ESP transports report the serial port; STM methods report the flasher
+    // binary + firmware path instead. Both kept optional so each path validates.
+    port: z.string().optional(),
+    programmer: z.string().optional(),
+    firmware_path: z.string().optional(),
     duration_seconds: z.number(),
     output_tail: z.array(z.string()),
     ...ErrorField,
@@ -386,26 +393,27 @@ const O_AppAction = {
 // BUILD — unified across platforms (pc, idf)
 // `platform` arg disambiguates. Modes are validated per-platform at runtime.
 // ═══════════════════════════════════════════════════════════════════════
-const BuildPlatform = z.enum(["pc", "idf"]).describe("Target platform: 'pc' = host simulator, 'idf' = ESP32-S3 firmware.");
+const BuildPlatform = z.enum(["pc", "idf", "stm"]).describe("Target platform: 'pc' = host simulator, 'idf' = ESP32-S3 firmware, 'stm' = STM32G0 firmware (CrossPad r20).");
 const PlatformPcOnly = z.enum(["pc"]).default("pc").describe("Platform — currently only 'pc' is supported here.");
 server.registerTool("crosspad_build", {
-    description: "[PC + ESP] Build CrossPad for the given platform.\n" +
+    description: "[PC | ESP | STM HW] Build CrossPad for the given platform.\n" +
         "  • platform='pc'  → CMake + Ninja host simulator. PREFER THIS over `cmake --build build` (picks right MSVC env on Windows, parses errors/warnings, streams progress).\n" +
         "  • platform='idf' → idf.py build for ESP32-S3 firmware. PREFER THIS over raw `idf.py build` (sources IDF env, auto-fullcleans when new apps detected, parses errors/warnings).\n" +
+        "  • platform='stm' → CMake + Ninja + arm-none-eabi for STM32G0 firmware (CrossPad r20). Uses CMakePresets (Debug/Release); output is build/<preset>/CrossPad_STM32_r20.elf.\n" +
         "Mode×platform compatibility:\n" +
-        "  • incremental → both (default)\n" +
-        "  • clean       → both (wipes build dir, then builds)\n" +
-        "  • reconfigure → PC only (re-runs cmake without wiping cache)\n" +
+        "  • incremental → all (default)\n" +
+        "  • clean       → all (wipes build dir, then builds)\n" +
+        "  • reconfigure → PC & STM (re-runs cmake without wiping cache)\n" +
         "  • fullclean   → IDF only (runs idf.py fullclean, then builds)",
     inputSchema: {
         platform: BuildPlatform,
         mode: z.enum(["incremental", "clean", "fullclean", "reconfigure"])
             .default("incremental")
-            .describe("Build mode. Compatibility: incremental & clean = both platforms; reconfigure = PC only; fullclean = IDF only. " +
-            "Pick incremental for normal iteration; clean if you suspect stale artifacts; fullclean (IDF) after adding new apps; reconfigure (PC) after editing CMakeLists."),
+            .describe("Build mode. Compatibility: incremental & clean = all platforms; reconfigure = PC & STM; fullclean = IDF only. " +
+            "Pick incremental for normal iteration; clean if you suspect stale artifacts; fullclean (IDF) after adding new apps; reconfigure (PC/STM) after editing CMakeLists/presets."),
         build_type: z.enum(["Debug", "Release", "RelWithDebInfo"])
             .default("Debug")
-            .describe("CMake build type — PC ONLY (ignored for IDF; ESP32 build type comes from sdkconfig). Only honored on mode=clean|reconfigure (incremental keeps existing cache)."),
+            .describe("CMake build type — PC & STM (ignored for IDF; ESP32 build type comes from sdkconfig). STM maps to the Debug/Release preset (RelWithDebInfo→Release). Only honored on mode=clean|reconfigure (incremental keeps existing cache)."),
     },
     outputSchema: O_Build,
     annotations: ANN_DESTRUCTIVE,
@@ -416,15 +424,21 @@ server.registerTool("crosspad_build", {
         const onLine = makeProgressLogger("build-pc", extra);
         return jsonResponse(await crosspadBuild(mode, onLine, build_type, extra.signal));
     }
+    if (platform === "stm") {
+        if (mode === "fullclean")
+            return err("mode='fullclean' is IDF-only. STM supports: incremental, clean, reconfigure.");
+        const onLine = makeProgressLogger("build-stm", extra);
+        return jsonResponse(await crosspadStmBuild(mode, onLine, build_type, extra.signal));
+    }
     // idf
     if (mode === "reconfigure")
-        return err("mode='reconfigure' is PC-only. IDF supports: incremental, clean, fullclean.");
+        return err("mode='reconfigure' is PC/STM-only. IDF supports: incremental, clean, fullclean.");
     const idfMode = mode === "incremental" ? "build" : mode;
     const onLine = makeProgressLogger("build-idf", extra);
     return jsonResponse(await crosspadIdfBuild(idfMode, onLine, extra.signal));
 });
 server.registerTool("crosspad_run", {
-    description: "[PC sim] Launch the built simulator binary in the background. Returns pid + exe_path. Refuses to spawn a duplicate if one is already responding on the TCP control port (use force=true to override). Fails if binary not built — call crosspad_build first. Currently PC-only (IDF firmware doesn't run on the host).",
+    description: "[PC] Launch the built simulator binary in the background. Returns pid + exe_path. Refuses to spawn a duplicate if one is already responding on the TCP control port (use force=true to override). Fails if binary not built — call crosspad_build first. Currently PC-only (IDF firmware doesn't run on the host).",
     inputSchema: {
         platform: PlatformPcOnly,
         force: z.boolean().default(false)
@@ -454,7 +468,7 @@ server.registerTool("crosspad_kill", {
     annotations: ANN_DESTRUCTIVE,
 }, async () => jsonResponse(await crosspadKill()));
 server.registerTool("crosspad_check", {
-    description: "[PC sim] Health check for a build — detects stale exe, new sources missing from build system, dirty submodules. Use before crosspad_build to decide if rebuild needed. Currently PC-only.",
+    description: "[PC] Health check for a build — detects stale exe, new sources missing from build system, dirty submodules. Use before crosspad_build to decide if rebuild needed. Currently PC-only.",
     inputSchema: {
         platform: PlatformPcOnly,
     },
@@ -465,16 +479,45 @@ server.registerTool("crosspad_check", {
 // FLASH — unified UART/OTA into one tool with `transport` axis
 // ═══════════════════════════════════════════════════════════════════════
 server.registerTool("crosspad_flash", {
-    description: "[ESP HW] Flash ESP firmware to a connected CrossPad device. transport='uart' uses idf.py flash (device must be in bootloader mode). transport='ota' uses platform-idf/tools/ota_flash.py over USB CDC (no bootloader mode required). Requires prior crosspad_build platform=idf. Works on both CrossPad generations: rev <2.0 (ESP native USB) and rev 2.0 (port is the STM32 CDC bridge — STM emulates the esptool DTR/RTS auto-reset and forwards the flash to the ESP over LPUART2; rev-2.0 STM must be in passthrough mode, i.e. NOT booted with pad-4 held).",
+    description: "[ESP HW | STM HW] Flash firmware to a connected CrossPad device.\n" +
+        "target='esp' (default) → ESP32-S3 firmware (requires prior crosspad_build platform=idf):\n" +
+        "  • transport='uart' uses idf.py flash (device must be in bootloader mode).\n" +
+        "  • transport='ota' uses platform-idf/tools/ota_flash.py over USB CDC (no bootloader mode required).\n" +
+        "  Works on both CrossPad generations: rev <2.0 (ESP native USB) and rev 2.0 (port is the STM32 CDC bridge — STM emulates the esptool DTR/RTS auto-reset and forwards the flash to the ESP over LPUART2; rev-2.0 STM must be in passthrough mode, i.e. NOT booted with pad-4 held).\n" +
+        "target='stm' → STM32G0 firmware via STM32_Programmer_CLI (requires prior crosspad_build platform=stm):\n" +
+        "  • method='swd' flashes over ST-Link (SWD).\n" +
+        "  • method='dfu' flashes the USB DFU bootloader (board in ST system memory — hold pad 1 at boot or trigger boot_request_dfu).\n" +
+        "  Flasher resolved from config (stm_programmer_cli) → $STM32_PROG → PATH.",
     inputSchema: {
-        transport: z.enum(["uart", "ota"]).describe("'uart' = bootloader-mode flash via idf.py; 'ota' = USB-CDC OTA flash via ota_flash.py."),
+        target: z.enum(["esp", "stm"]).default("esp").describe("'esp' = ESP32-S3 (transport uart/ota); 'stm' = STM32G0 firmware via STM32_Programmer_CLI (method swd/dfu)."),
+        transport: z.enum(["uart", "ota"]).optional().describe("ESP only. 'uart' = bootloader-mode flash via idf.py; 'ota' = USB-CDC OTA flash via ota_flash.py."),
+        method: z.enum(["swd", "dfu"]).optional().describe("STM only. 'swd' = ST-Link/SWD; 'dfu' = USB DFU system bootloader."),
         port: Port.optional(),
+        build_type: z.enum(["Debug", "Release", "RelWithDebInfo"]).optional()
+            .describe("STM only. Selects the build/<preset> dir for the default firmware binary. Defaults to Debug."),
         firmware_path: z.string().optional()
-            .describe("Custom firmware binary path (OTA only). Defaults to <idf-root>/build/CrossPad.bin."),
+            .describe("Custom firmware binary path. ESP: OTA only, defaults to <idf-root>/build/CrossPad.bin. STM: defaults to <stm-root>/build/<preset>/CrossPad_STM32_r20.bin."),
     },
     outputSchema: O_Flash,
     annotations: ANN_DESTRUCTIVE,
-}, async ({ transport, port, firmware_path }, extra) => {
+}, async ({ target, transport, method, port, build_type, firmware_path }, extra) => {
+    if (target === "stm") {
+        if (!method)
+            return err("target='stm' requires 'method' (swd or dfu).");
+        if (transport)
+            return err("Field 'transport' is ESP-only. For STM use 'method' (swd|dfu).");
+        if (port)
+            return err("Field 'port' is ESP-only — STM flash addresses the ST-Link/DFU device, not a serial port.");
+        const onLine = makeProgressLogger(`flash-stm-${method}`, extra);
+        return jsonResponse(await crosspadStmFlash(method, build_type ?? "Debug", firmware_path, onLine, extra.signal));
+    }
+    // esp
+    if (method)
+        return err("Field 'method' is STM-only. For ESP use 'transport' (uart|ota).");
+    if (build_type)
+        return err("Field 'build_type' is STM-only (ESP build type comes from sdkconfig).");
+    if (!transport)
+        return err("target='esp' requires 'transport' (uart or ota).");
     if (transport === "uart") {
         if (firmware_path)
             return err("Field 'firmware_path' is OTA-only — UART flash always uses the active build dir.");
@@ -486,7 +529,7 @@ server.registerTool("crosspad_flash", {
     return jsonResponse(await crosspadIdfOta(port, firmware_path, onLine, extra.signal));
 });
 server.registerTool("crosspad_log", {
-    description: "[PC sim | ESP HW] Capture logs (consolidated; replaces crosspad_log_pc and crosspad_log_idf in v6).\n" +
+    description: "[PC | ESP HW] Capture logs (consolidated; replaces crosspad_log_pc and crosspad_log_idf in v6).\n" +
         "  • target='pc'  → spawn the built sim binary, capture stdout/stderr, then kill it. " +
         "Fields used: timeout_seconds (default 5), max_lines (default 200). `port` and `filter` MUST be omitted.\n" +
         "  • target='idf' → read serial from a connected ESP32-S3 via pyserial (no TTY needed). " +
@@ -537,6 +580,7 @@ export function setTraceBrowserOpener(fn) { traceBrowserOpener = fn; }
 const TraceAction = z.enum([
     "doctor", "config_set", "symbols", "start", "stop",
     "add", "remove", "status", "read", "save", "device_state", "ui",
+    "write", "call",
 ]);
 server.registerTool("crosspad_trace", {
     description: "[STM HW] Real-time SWD tracer for the STM32G0B1 firmware (ST-Link). Non-halting RAM polling of firmware variables resolved from the Debug ELF (like ST-Studio/CubeMonitor). Pick an `action`:\n" +
@@ -555,28 +599,35 @@ server.registerTool("crosspad_trace", {
     inputSchema: {
         action: TraceAction.describe("Required params per action — doctor/stop/status/device_state/ui: (none); " +
             "config_set: key,value; symbols: query?; start: signals[],rate_hz?; " +
-            "add/remove: signals[]; read: window_from?,window_to?,max_points?; save: format?."),
-        signals: z.array(z.string()).optional().describe("start: variable names from `symbols` (e.g. ['s_vbat_mv','s_inputs[0]'])."),
+            "add/remove: signals[]; read: window_from?,window_to?,max_points?; save: format?; " +
+            "write: writes[]; call: func,args?,confirm,ret_type?,timeout?."),
+        signals: z.array(z.string()).optional().describe("start: variable names from `symbols` (e.g. ['s_vbat_mv','s_inputs[0]']). Also accepts raw @address specs that bypass DWARF — '@0x40021000' (u32), '@0x40021000:u16' (u8|u16|u32|i8|i16|i32|f32), '@0x20000000:u8[16]' (16-element block) — for peripheral registers / arbitrary RAM."),
         rate_hz: z.number().int().min(0).max(2000).optional().describe("start: target sample rate (0 = as fast as the probe allows). Actual Fs is reported."),
         swo: z.array(z.string()).optional().describe("start (EXPERIMENTAL): map ITM stimulus ports to signal names, e.g. ['0:phase','1:isr_us']. Requires firmware that emits ITM on the SWO pin (NOT present in current CrossPad firmware — UNTESTED against real ITM). Omit for plain RAM polling. Fails soft: if SWV init fails, polling continues normally."),
         query: z.string().optional().describe("symbols: case-insensitive substring filter."),
-        key: z.string().optional().describe("config_set: one of stm_elf_path|pyocd_python|probe_serial|trace_dir."),
+        key: z.string().optional().describe("config_set: one of stm_elf_path|pyocd_python|probe_serial|trace_dir|ui_open|stm_programmer_cli. stm_programmer_cli = path to STM32_Programmer_CLI for crosspad_flash target=stm. ui_open ∈ vscode(default: reply with the link → user clicks → opens in the VS Code Simple Browser; system-browser fallback after 30s if unopened)|browser(open system browser immediately)|none(never auto-open)."),
         value: z.string().optional().describe("config_set: the value to persist."),
         window_from: z.number().optional().describe("read: start time (s) of the window."),
         window_to: z.number().optional().describe("read: end time (s) of the window."),
         max_points: z.number().int().min(1).max(5000).optional().describe("read: max points per signal (default 200)."),
         format: z.enum(["csv"]).optional().describe("save: export format (csv)."),
+        writes: z.array(z.string()).optional().describe("write: list of 'target=value' specs. target = @0xADDR[:type] (u8|u16|u32|i8|i16|i32|f32, default u32) or a DWARF symbol; value = hex 0x.. or decimal (float for f32). e.g. ['@0x50000414:u16=0xFFFF','s_vbat_mv=4200']. Allowlist: SRAM/peripheral/PPB only — Code/flash region is blocked."),
+        func: z.string().optional().describe("call: firmware function symbol to invoke (AAPCS)."),
+        args: z.array(z.number().int()).max(4).optional().describe("call: up to 4 integer args → r0-r3."),
+        confirm: z.boolean().optional().describe("call: must be true — acknowledges the core is halted for the call."),
+        ret_type: z.enum(["u32", "i32", "u16", "i16", "u8", "i8", "f32"]).optional().describe("call: decode r0 as this type (default u32; raw r0 always returned)."),
+        timeout: z.number().min(0.1).max(30).optional().describe("call: max seconds to wait for the function to return (default 2)."),
     },
     outputSchema: O_Trace,
     annotations: ANN_SIDE_EFFECT,
-}, async ({ action, signals, rate_hz, swo, query, key, value, window_from, window_to, max_points, format }, extra) => {
+}, async ({ action, signals, rate_hz, swo, query, key, value, window_from, window_to, max_points, format, writes, func, args, confirm, ret_type, timeout }, extra) => {
     switch (action) {
         case "doctor": {
             const r = await runDoctor(realProbe());
             return ok({ action, ok: r.ok, issues: r.issues, device_state: r.probe ? "connected" : "no_probe" });
         }
         case "config_set": {
-            const allowed = ["stm_elf_path", "pyocd_python", "probe_serial", "trace_dir"];
+            const allowed = ["stm_elf_path", "pyocd_python", "probe_serial", "trace_dir", "ui_open", "stm_programmer_cli"];
             if (!key || !allowed.includes(key))
                 return err(`config_set requires key in ${allowed.join("|")}`);
             if (value === undefined)
@@ -615,9 +666,32 @@ server.registerTool("crosspad_trace", {
             let uiUrl;
             try {
                 uiUrl = await dashboard.ensureStarted();
-                if (!dashboard.hasClients())
-                    traceBrowserOpener(uiUrl);
                 dashboard.bind(sess);
+                // §12.6 open behavior, by ui_open config (default "vscode"):
+                //   vscode  → DON'T pop anything now. The agent always replies with the
+                //             dashboard link; the user clicks it → it opens in the VS Code
+                //             Simple Browser via their workbench.externalUriOpeners. If
+                //             nobody opens it within the fallback window, fall back to the
+                //             system browser so a first-timer is never left staring at nothing.
+                //   browser → open the system browser immediately.
+                //   none    → never auto-open (rely on an already-open persistent tab).
+                if (uiUrl && !dashboard.hasClients()) {
+                    const mode = resolveConfigValue("ui_open", "CROSSPAD_TRACE_UI_OPEN", process.env.CROSSPAD_TRACE_UI_OPEN, "vscode");
+                    if (mode === "browser") {
+                        traceBrowserOpener(uiUrl);
+                    }
+                    else if (mode === "vscode") {
+                        const ms = Number(process.env.CROSSPAD_TRACE_OPEN_FALLBACK_MS) || 30000;
+                        const url = uiUrl;
+                        setTimeout(() => {
+                            // Only fall back if THIS trace is still the active one and nobody
+                            // ever opened the in-editor link.
+                            if (getActiveSession() === sess && sess.isRunning() && !getDashboard().hasClients()) {
+                                traceBrowserOpener(url);
+                            }
+                        }, ms);
+                    }
+                }
             }
             catch { /* UI optional — never block a trace on the dashboard */ }
             // §11.6: don't lie. Wait for the first real frame and report what the
@@ -733,6 +807,32 @@ server.registerTool("crosspad_trace", {
             const reconciled = action === "add" ? await s.addSignals(signals) : await s.removeSignals(signals);
             return ok({ action, signals: reconciled });
         }
+        case "write": {
+            if (!writes || writes.length === 0)
+                return err("write requires `writes` (['target=value', ...]).");
+            try {
+                const r = await traceWrite(writes);
+                return ok({ action, ok: r.ok, results: r.results, error: r.error });
+            }
+            catch (e) {
+                return err(`write failed: ${String(e)}`, { action });
+            }
+        }
+        case "call": {
+            if (!func)
+                return err("call requires `func` (function symbol).");
+            if (!confirm)
+                return err("call requires confirm:true (the core is halted for the call).");
+            if (args && args.length > 4)
+                return err("call accepts at most 4 args (r0-r3).");
+            try {
+                const r = await traceCall(func, args ?? [], true, ret_type ?? "u32", timeout ?? 2);
+                return ok({ action, ...r });
+            }
+            catch (e) {
+                return err(`call failed: ${String(e)}`, { action });
+            }
+        }
     }
 });
 // ═══════════════════════════════════════════════════════════════════════