@kvell007/embed-labs-cli 0.1.0-alpha.98 → 0.1.0-alpha.99

package/dist/embed-labs-mcp-bridge.mjs

@@ -9,15 +9,38 @@ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const REPO_ROOT = path.resolve(SCRIPT_DIR, "../../../../..");
 const DEFAULT_TEMPLATE_ID = "taishanpi-1m-rk3566";
 const DEFAULT_HOST = "198.19.77.2";
-const DEFAULT_PORTS = "22,15301";
-const DEFAULT_STATUS_PORTS = "22";
-const TOOL_INTEGRITY_RELOGIN_MESSAGE = "工具完整性校验失败，请在当前电脑重新执行 embedlabs auth login --token <key>";
-const MCP_SERVER_VERSION = "0.2.41";
+const DEFAULT_PORTS = "22";
+const MCP_SERVER_VERSION_FALLBACK = "0.0.0";
 const MCP_ICON_FILES = [
   { fileName: "embed-labs-icon-dark.png", theme: "dark" },
   { fileName: "embed-labs-icon-light.png", theme: "light" }
 ];
 
+function mcpServerVersion() {
+  const candidates = [
+    path.join(process.cwd(), "platform_plugins", "codex_plugin", "plugins", "embed-labs", ".codex-plugin", "plugin.json"),
+    path.join(process.cwd(), "platform_plugins", "opencode_plugin", "package.json"),
+    path.join(SCRIPT_DIR, "..", ".codex-plugin", "plugin.json"),
+    path.join(SCRIPT_DIR, "..", "package.json"),
+    path.join(SCRIPT_DIR, "..", "..", "package.json"),
+    path.join(REPO_ROOT, "platform_plugins", "codex_plugin", "plugins", "embed-labs", ".codex-plugin", "plugin.json"),
+    path.join(REPO_ROOT, "platform_plugins", "opencode_plugin", "package.json")
+  ];
+  for (const candidate of candidates) {
+    if (!existsSync(candidate)) continue;
+    try {
+      const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+      if (typeof parsed.version === "string" && parsed.version.trim()) {
+        return parsed.version.trim();
+      }
+    } catch {
+      // Keep server startup resilient when a packaged metadata file is missing
+      // or malformed; validation covers the normal release path.
+    }
+  }
+  return MCP_SERVER_VERSION_FALLBACK;
+}
+
 function iconDataUri(fileName) {
   const candidates = [
     path.join(SCRIPT_DIR, "..", "assets", fileName),
@@ -40,9 +63,9 @@ function mcpServerInfo() {
     .filter(Boolean);
   return {
     name: "embed-labs",
-    title: "Embed Labs",
-    version: MCP_SERVER_VERSION,
-    description: "Embed Labs MCP service for local-first embedded development boards, board knowledge, toolchain metadata, Local Bridge hardware access, and account/device-bound service logging.",
+    title: "EmbedLabs",
+    version: mcpServerVersion(),
+    description: "EmbedLabs local Native Agent compatibility bridge for embedded development boards, BoardPack knowledge, toolchain metadata, Local Bridge hardware access, and redacted installation-identity reporting.",
     websiteUrl: "https://embedboard.com/",
     ...(icons.length > 0 ? { icons } : {})
   };
@@ -50,8 +73,8 @@ function mcpServerInfo() {
 
 const tools = [
   {
-    name: "dbt_auth_status",
-    description: "Check whether the local Embed Labs CLI is signed in and bound to this computer. If not ready, return the exact login command and dashboard URL the user should use before any board/cloud tool call.",
+    name: "dbt_agent_status",
+    description: "Report local EmbedLabs Agent readiness, local model setup, installation identity, local memory, Go Local Bridge access, and redacted public-experience report state. Model provider keys stay on this computer.",
     inputSchema: {
       type: "object",
       properties: {}
@@ -59,7 +82,7 @@ const tools = [
   },
   {
     name: "dbt_current_board_status",
-    description: "Get the latest local Embed Labs Bridge inventory snapshot for supported development boards, without server-side AI planning. Use this MCP tool directly for requests like 当前开发板状态, 开发板状态, board status, USB ECM, and SSH checks; it is not a shell command. Do not report optional control ports or unrelated local serial paths unless the user explicitly asks.",
+    description: "Compatibility-profile board inventory shortcut. Default clients should use embedlabs_action_run with action_id=detect_board, or embedlabs_chat for natural-language status requests. This is not a shell command. Do not report optional control ports or unrelated local serial paths unless the user explicitly asks.",
     inputSchema: {
       type: "object",
       properties: {
@@ -71,9 +94,60 @@ const tools = [
       }
     }
   },
+  {
+    name: "dbt_agent_action_schema",
+    description: "Return the local EmbedLabs Agent high-level action catalog or one action's machine-readable input_schema and safety contract. Use this when parameter, approval, target-selection, or must_not_infer rules are unclear. This discovery tool does not require login.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action_id: {
+          type: "string",
+          description: "Optional high-level Agent action id such as detect_board, manage_board_pack, query_board_knowledge, install_toolchain, build_project, flash_image, deploy_app, debug_board, capture_signal, submit_report, or create_fix_candidate. Omit to list all actions."
+        },
+        action: { type: "string", description: "Alias for action_id." },
+        include_raw: { type: "boolean" }
+      }
+    }
+  },
+  {
+    name: "dbt_agent_action_run",
+    description: "Run one EmbedLabs Agent high-level action through the local CLI Agent orchestration layer. The Agent owns local installation identity checks, memory, Go Local Bridge routing, approval gates, and redacted report creation.",
+    inputSchema: {
+      type: "object",
+      required: ["action_id"],
+      properties: {
+        action_id: {
+          type: "string",
+          description: "High-level Agent action id such as detect_board, manage_board_pack, query_board_knowledge, install_toolchain, build_project, flash_image, deploy_app, debug_board, capture_signal, submit_report, or create_fix_candidate."
+        },
+        action: { type: "string", description: "Alias for action_id." },
+        request: { type: "string", description: "Optional user request. Used as query when query is not provided." },
+        arguments_json: { type: "string", description: "Optional JSON object with action arguments. Keys are converted to CLI flags, for example board_id -> --board-id and approved -> --approve." },
+        include_raw: { type: "boolean" },
+        timeout_ms: { type: "number" }
+      }
+    }
+  },
+  {
+    name: "dbt_agent_chat",
+    description: "Run one natural-language EmbedLabs Native Agent chat turn through the local CLI Agent. IDE/plugin calls default to local-only deterministic Agent execution so the host IDE model is not duplicated by the user's local provider config. Set use_model=true only for explicit owner diagnostics that should invoke the local Native Agent model runtime.",
+    inputSchema: {
+      type: "object",
+      required: ["prompt"],
+      properties: {
+        prompt: { type: "string", description: "User request to pass to embedlabs agent chat." },
+        request: { type: "string", description: "Alias for prompt." },
+        session: { type: "string", description: "Optional local EmbedLabs chat session id to continue." },
+        new_session: { type: "boolean", description: "Create a new local chat session for this turn." },
+        use_model: { type: "boolean", description: "Opt in to the local Native Agent model runtime for this chat turn. Default false for IDE/plugin calls." },
+        include_raw: { type: "boolean" },
+        timeout_ms: { type: "number" }
+      }
+    }
+  },
   {
     name: "dbt_initial_image_flash",
-    description: "Single high-level entrypoint for initialization-image flashing. Use this directly for requests like 刷写初始化镜像, 将泰山派1M RK3566的初始化镜像刷写到开发板, or RP2350/Pico initial firmware. The tool infers or accepts the board, validates installed SDK resources, calls Local Bridge flash plan/run, waits for completion when approved, and returns a compact user-facing result. Do not inspect plugin scripts, do not list tools, do not use dbt_board_debug, and do not print raw CLI help.",
+    description: "Compatibility-profile adapter for initialization-image flashing. Default clients must call embedlabs_action_run with action_id=flash_image and artifact_kind=initial_image or initial_firmware. This adapter maps historical requests to the Agent flash_image action, validates local SDK resources, calls Local Bridge flash plan/run, and returns a compact result.",
     inputSchema: {
       type: "object",
       properties: {
@@ -93,7 +167,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_monitor_status",
-    description: "Read RP2350-Monitor status through Embed Labs Local Bridge on 18083, including board status, logic-analyzer caps, probe caps, pins, channels, and the browser UI URL. RP2350 Monitor supports USB serial and LAN IP/TCP connection modes. Report ui_url/browser_url for the web interface; bridge_url/monitor_bridge_url is the internal upstream and must not be opened as /rp2350-monitor/.",
+    description: "Read RP2350-Monitor status through EmbedLabs Local Bridge on 18083, including board status, logic-analyzer caps, probe caps, pins, channels, and the browser UI URL. RP2350 Monitor supports USB serial and LAN IP/TCP connection modes. Report ui_url/browser_url for the web interface; bridge_url/monitor_bridge_url is the internal upstream and must not be opened as /rp2350-monitor/.",
     inputSchema: {
       type: "object",
       properties: {
@@ -113,12 +187,12 @@ const tools = [
   },
   {
     name: "dbt_rp2350_capabilities",
-    description: "Return the RP2350/Pico2 monitor capability catalog: supported operations, parameters, defaults, firmware commands, and preferred MCP tools. Call this before using unfamiliar RP2350 hardware protocols.",
+    description: "Full-profile diagnostics catalog for RP2350/Pico2 monitor operations, parameters, defaults, and firmware commands. Default clients should use embedlabs_action_schema/embedlabs_action_run with capture_signal, debug_board, or flash_image; this catalog is for engineering validation and fallback planning.",
     inputSchema: { type: "object", properties: { include_raw: { type: "boolean" } } }
   },
   {
     name: "dbt_rp2350_operation",
-    description: "Run a supported RP2350 Monitor /api/operation action through the shared Local Bridge. Prefer specific tools for GPIO/UART/I2C/SPI/Wi-Fi/probe; use this for advanced catalog actions. Supports USB serial or board LAN IP/TCP transport.",
+    description: "Compatibility-profile engineering fallback for a supported RP2350 Monitor /api/operation action through the shared Local Bridge. Default clients should use embedlabs_action_run with action_id=capture_signal, debug_board, or another high-level Agent action first. Use this only after the high-level action cannot express an advanced catalog operation.",
     inputSchema: {
       type: "object",
       required: ["action"],
@@ -150,7 +224,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_uart_write",
-    description: "Send text or HEX data over a configurable RP2350 UART channel through the already-running RP2350 Monitor hardware bridge. This is a direct hardware-control operation: do not search the workspace, create Pico SDK/CMake projects, or write firmware source for UART test-data requests. Accepts uart_id such as uart1 and data/data_format aliases. For closed-loop capture, prefer dbt_rp2350_logic_capture with a UART stimulus instead of calling this separately. Requires approved=true.",
+    description: "Compatibility-profile direct UART output fallback through the RP2350 Monitor hardware bridge. Default clients should normally call embedlabs_action_run with action_id=capture_signal and provide UART stimulus for closed-loop capture. Do not search the workspace, create Pico SDK/CMake projects, or write firmware source for UART test-data requests. Requires approved=true.",
     inputSchema: { type: "object", properties: { id: { type: "number" }, instance: { type: "number" }, uart_id: { type: "string", description: "Alias such as uart0 or uart1; normalized to instance." }, tx: { type: "number" }, rx: { type: "number" }, baud: { type: "number" }, text: { type: "string" }, hex: { type: "string" }, data: { type: "string", description: "Text or hex payload depending on data_format." }, data_format: { type: "string", description: "hex, text, string, utf8, or ascii." }, data_hex: { type: "string" }, line_ending: { type: "string" }, approved: { type: "boolean" }, approve: { type: "boolean" }, transport: { type: "string" }, local_device_id: { type: "string" }, monitor_bridge_url: { type: "string" }, serial_path: { type: "string" }, tcp: { type: "string" }, tcp_endpoint: { type: "string" }, host: { type: "string" }, port: { type: "number" }, timeout_ms: { type: "number" } } }
   },
   {
@@ -160,7 +234,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_logic_capture",
-    description: "Capture a compact RP2350-Monitor logic-analyzer JSONL file and optionally generate UART/SPI/I2C stimulus in the same operation. This is the required entrypoint for requests like 'use UART1 to send test data and capture it with GP16/GP17': do not search the repo, create Pico SDK/CMake projects, or write firmware source. Requires approved=true because it arms local hardware. For closed-loop validation, do not call uart/spi write separately; pass stimulus here. UART/SPI/I2C/GPIO/logic functions may be combined freely when their GPIO sets do not overlap; only overlapping pins conflict. Example UART loopback: UART1 output GP8/GP9 wired to logic-analyzer inputs GP16/GP17, so call channels=[\"gpio16\",\"gpio17\"] and stimulus={\"action\":\"uart.write\",\"uart_id\":\"uart1\",\"tx\":8,\"rx\":9,...}. GP16/GP17 are analyzer inputs in that example, not UART1 output pins. Supports USB serial or board LAN IP/TCP transport.",
+    description: "Compatibility-profile adapter for RP2350 Monitor logic capture. Default clients should call embedlabs_action_run with action_id=capture_signal and pass analyzer pins plus optional UART/SPI/I2C stimulus. This adapter remains for compact/full engineering profiles. Do not search the repo, create Pico SDK/CMake projects, or write firmware source. Requires approved=true because it arms local hardware. UART/SPI/I2C/GPIO/logic functions may be combined when GPIO sets do not overlap. Example UART loopback: UART1 output GP8/GP9 wired to analyzer inputs GP16/GP17. GP16/GP17 are analyzer inputs in that example, not UART1 output pins.",
     inputSchema: {
       type: "object",
       properties: {
@@ -210,7 +284,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_logic_decode",
-    description: "Decode a local RP2350-Monitor logic JSONL capture without touching hardware. Supported decoders: summary, bursts, edges, uart, spi, and structure/auto/unknown. The result includes summary_for_user, decoded_preview, protocol_data, and analysis so the AI can report actual sampled data; use structure/unknown when the protocol is not known.",
+    description: "Decode a local RP2350-Monitor logic JSONL capture without touching hardware. Supported decoders: summary, bursts, edges, uart, spi, and structure/auto/unknown. The result includes summary_for_user, decoded_preview, protocol_data, and analysis so the AI can report actual sampled data; use structure/unknown when the protocol is not known. A 0-byte UART/SPI decode is a capture/wiring/decoder-parameter result, not firmware corruption; do not reflash, reboot, or enter BOOTSEL unless the user explicitly asks for firmware recovery.",
     inputSchema: {
       type: "object",
       properties: {
@@ -237,7 +311,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_spi_transfer",
-    description: "Send test bytes through a configurable RP2350 SPI channel via Embed Labs Local Bridge. Supports USB serial or board LAN IP/TCP transport. Pin choices must match the firmware pin map for the selected SPI instance; if pins are omitted, the bridge uses the documented SPI0 example SCK GP2, MOSI GP3, MISO GP0, CS GP1. Use this directly for requests like 通过默认SPI接口发送测试数据; mutating bus output requires approve=true.",
+    description: "Compatibility-profile direct SPI output fallback through EmbedLabs Local Bridge. Default clients should normally use embedlabs_action_run with action_id=capture_signal and SPI stimulus for test-data capture. Pin choices must match the firmware pin map; mutating bus output requires approve=true.",
     inputSchema: {
       type: "object",
       properties: {
@@ -280,7 +354,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_monitor_command",
-    description: "Run an allowlisted RP2350-Monitor command through Embed Labs Local Bridge. Supports USB serial or board LAN IP/TCP transport. Mutating commands require approve=true.",
+    description: "Run an allowlisted RP2350-Monitor command through EmbedLabs Local Bridge. Supports USB serial or board LAN IP/TCP transport. Mutating commands require approve=true.",
     inputSchema: {
       type: "object",
       required: ["command"],
@@ -304,19 +378,20 @@ const tools = [
   },
   {
     name: "dbt_cloud_status",
-    description: "Discover Embed Labs Cloud supported boards, knowledge file index, plugin/service metadata, and local toolchain download metadata. Server-side user workspaces, quota/billing tools, and Docker builds are disabled by default.",
+    description: "Compatibility-profile board metadata adapter. It routes through local Agent board actions for supported boards, knowledge, and toolchain metadata. It does not expose model/service catalogs; default clients should use embedlabs_action_schema/embedlabs_action_run with manage_board_pack, query_board_knowledge, or install_toolchain.",
     inputSchema: {
       type: "object",
       properties: {
         template_id: { type: "string" },
         template: { type: "string" },
+        query: { type: "string" },
         include_raw: { type: "boolean" }
       }
     }
   },
   {
     name: "dbt_board_knowledge_search",
-    description: "Search bounded Embed Labs server-side board knowledge snippets for pinout, UART/serial, GPIO, build, flash, SDK, and workflow questions. For supported boards, use this instead of web search; if no snippet matches, report the board-pack gap.",
+    description: "Search bounded EmbedLabs server-side board knowledge snippets for pinout, UART/serial, GPIO, build, flash, SDK, and workflow questions. For supported boards, use this instead of web search; if no snippet matches, report the board-pack gap.",
     inputSchema: {
       type: "object",
       required: ["query"],
@@ -330,66 +405,27 @@ const tools = [
   },
   {
     name: "dbt_supported_boards",
-    description: "List currently supported Embed Labs development boards across Cloud board registry and local toolchain environments. Use this directly for 当前支持哪些开发板 / supported boards questions.",
+    description: "Compatibility-profile supported-board shortcut. Default clients should call embedlabs_action_run with action_id=manage_board_pack and operation=list for supported-board questions. This adapter returns BoardPack catalog summaries and local toolchain status hints.",
     inputSchema: {
       type: "object",
       properties: {}
     }
   },
-  {
-    name: "dbt_task_status",
-    description: "Read an Embed Labs Cloud task status, including output_tail and artifact metadata.",
-    inputSchema: {
-      type: "object",
-      required: ["task_id"],
-      properties: {
-        task_id: { type: "string" }
-      }
-    }
-  },
-  {
-    name: "dbt_task_log_download",
-    description: "Download the first log artifact from a Cloud task.",
-    inputSchema: {
-      type: "object",
-      required: ["task_id"],
-      properties: {
-        task_id: { type: "string" },
-        output_path: { type: "string" }
-      }
-    }
-  },
-  {
-    name: "dbt_artifact_download",
-    description: "Download an Embed Labs Cloud artifact.",
-    inputSchema: {
-      type: "object",
-      required: ["artifact_id", "output_path"],
-      properties: {
-        artifact_id: { type: "string" },
-        output_path: { type: "string" }
-      }
-    }
-  },
   {
     name: "dbt_board_debug",
-    description: "Run managed-model local-board debug/deploy planning through Cloud API plus Local Bridge. Source edits and compilation stay in the user's local environment. Do not use this for initialization image flashing; use dbt_initial_image_flash instead.",
+    description: "High-level local board diagnostics/deploy handoff. Routes through Native Agent debug_board or deploy_app actions; source edits, compilation, and hardware access stay local. Do not use this for initialization image flashing; use embedlabs_action_run with action_id=flash_image and the appropriate artifact_kind instead.",
     inputSchema: {
       type: "object",
-      required: ["prompt"],
       properties: {
-        account_id: { type: "string" },
-        workspace_id: { type: "string" },
         prompt: { type: "string" },
-        provider: { type: "string" },
-        model: { type: "string" },
         host: { type: "string" },
         ports: { type: "string" },
         artifact_path: { type: "string" },
-        artifact_id: { type: "string" },
-        artifact_task_id: { type: "string" },
-        artifact_output: { type: "string" },
         remote_path: { type: "string" },
+        remote_dir: { type: "string" },
+        remote_file: { type: "string" },
+        wrapper_script: { type: "string" },
+        run_script: { type: "string" },
         run_command: { type: "string" },
         approve: { type: "boolean" },
         run: { type: "boolean" }
@@ -398,7 +434,7 @@ const tools = [
   },
   {
     name: "dbt_boot_logo_update",
-    description: "Single high-level local boot-logo action. Use this directly for 启动logo修改/刷写启动Logo/logo替换. Pass only the image path and optional approval; the tool validates the local SDK, converts/resizes the image locally, repacks the local Rockchip resource image, patches the local boot.img, and returns a compact result. Do not call dbt_update_logo and dbt_compose_boot_logo manually unless this tool reports a product gap.",
+    description: "Compatibility-profile adapter for startup-logo work. Default clients must call embedlabs_action_run with action_id=flash_image and artifact_kind=boot_logo. This adapter validates the local SDK, converts/resizes the image locally, repacks the Rockchip resource image, patches boot.img, and returns a compact result.",
     inputSchema: {
       type: "object",
       required: ["logo_path"],
@@ -423,33 +459,9 @@ const tools = [
       }
     }
   },
-  {
-    name: "dbt_update_logo",
-    description: "Ask the server to generate a small free boot-logo package for later local image merge and approved flashing. This does not allocate a paid server workspace.",
-    inputSchema: {
-      type: "object",
-      required: ["logo_path"],
-      properties: {
-        account_id: { type: "string" },
-        account: { type: "string" },
-        project_id: { type: "string" },
-        project: { type: "string" },
-        board_id: { type: "string" },
-        board: { type: "string" },
-        variant_id: { type: "string" },
-        variant: { type: "string" },
-        logo_path: { type: "string" },
-        kernel_logo_path: { type: "string" },
-        output_path: { type: "string" },
-        output: { type: "string" },
-        rotate: { type: "string" },
-        scale: { type: "string" }
-      }
-    }
-  },
   {
     name: "dbt_compose_boot_logo",
-    description: "Compose a downloaded server boot-logo package with a local base image using the cross-platform Embed CLI local composer. The result reports whether it is ready for approved flashing.",
+    description: "Compose a local boot-logo package with a local base image using the cross-platform Embed CLI local composer. The result reports whether it is ready for approved flashing.",
     inputSchema: {
       type: "object",
       required: ["package_path", "base_image_path", "output_path"],
@@ -514,7 +526,7 @@ const tools = [
   },
   {
     name: "dbt_local_toolchain_current",
-    description: "Show the currently selected local development-board environment in the Embed Labs CLI registry.",
+    description: "Show the currently selected local development-board environment in the EmbedLabs CLI registry.",
     inputSchema: {
       type: "object",
       properties: {
@@ -525,7 +537,7 @@ const tools = [
   },
   {
     name: "dbt_local_toolchain_install",
-    description: "Download, install, or repair a local development-board environment, such as TaishanPi LLVM/Qt support or Pico2W/RP2350 Monitor runtime support. If validation reports missing components for the user's requested workflow, call this with the matching board_id and mode to overlay the missing packages.",
+    description: "Compatibility-profile adapter for local SDK/toolchain install, update, or repair. Default clients should call embedlabs_action_run with action_id=install_toolchain and operation=install/update instead of selecting this tool directly.",
     inputSchema: {
       type: "object",
       properties: {
@@ -541,7 +553,8 @@ const tools = [
         install_root: { type: "string" },
         installRoot: { type: "string" },
         mode: { type: "string", enum: ["minimal", "runtime", "compile", "qt", "firmware", "full", "images"] },
-        force: { type: "boolean" }
+        force: { type: "boolean" },
+        include_raw: { type: "boolean" }
       }
     }
   },
@@ -561,7 +574,7 @@ const tools = [
   },
   {
     name: "dbt_local_toolchain_validate",
-    description: "Validate a local development-board environment release, such as TaishanPi LLVM/Qt support or Pico2W/RP2350 Monitor runtime support. The response includes missing_groups, summary_for_user, and repair_command; for TaishanPi Qt development, an ok=false result should be repaired with dbt_local_toolchain_install mode=qt before one-click cross compile or deploy.",
+    description: "Compatibility-profile validator for a local development-board environment release. Default clients should use embedlabs_action_run with action_id=install_toolchain and operation=list/install/update for repair decisions; this tool returns a compact validation summary and high-level repair command.",
     inputSchema: {
       type: "object",
       properties: {
@@ -576,7 +589,7 @@ const tools = [
   },
   {
     name: "dbt_taishanpi_initial_image_flash",
-    description: "Install/repair the TaishanPi 1M-RK3566 images SDK, resolve images/current automatically, plan initialization image flashing through Embed Labs Local Bridge, and optionally run it when approved=true. Use this directly for TaishanPi requests like 烧写初始化镜像, 刷写1M RK3566初始化镜像, Loader/Maskrom 初始化镜像刷写. Do not use dbt_board_debug for this flow and do not ask the user to provide image_dir when the SDK is installed.",
+    description: "Compatibility-profile TaishanPi initial-image adapter. Default clients must call embedlabs_action_run with action_id=flash_image and artifact_kind=initial_image. This adapter installs/repairs the images SDK, resolves images/current automatically, plans flashing through Local Bridge, and optionally runs it when approved=true.",
     inputSchema: {
       type: "object",
       properties: {
@@ -598,7 +611,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_monitor_firmware_flash",
-    description: "Download/install the optional RP2350 Monitor firmware package, locate rp2350_monitor.uf2, plan UF2 flashing through Embed Labs Local Bridge, and optionally flash it when approved=true. Use this only when the user explicitly asks for RP2350 Monitor, logic-analyzer, hardware-control, or Monitor firmware. For 初始化镜像/initial firmware requests use dbt_rp2350_initial_firmware_flash instead. Initialized boards use the Local Bridge inventory and picotool runtime handoff when available.",
+    description: "Download/install the optional RP2350 Monitor firmware package, locate rp2350_monitor.uf2, plan UF2 flashing through EmbedLabs Local Bridge, and optionally flash it when approved=true. Use this only when the user explicitly asks for RP2350 Monitor, logic-analyzer, hardware-control, or Monitor firmware. For 初始化镜像/initial firmware requests use embedlabs_action_run with action_id=flash_image and artifact_kind=initial_firmware instead. Initialized boards use the Local Bridge inventory and picotool runtime handoff when available.",
     inputSchema: {
       type: "object",
       properties: {
@@ -619,7 +632,7 @@ const tools = [
   },
   {
     name: "dbt_rp2350_initial_firmware_flash",
-    description: "Download/install the RP2350 board initialization firmware package, locate the board-specific initial.uf2, plan UF2 flashing through Embed Labs Local Bridge, and optionally flash it when approved=true. Use this directly for user requests like 烧写初始化镜像, 刷初始化镜像, initial firmware, or initialization UF2. Do not ask the user to choose Monitor vs initial firmware for those requests. If Local Bridge inventory already shows an initialized RP2350 runtime, the flash plan should use the picotool runtime handoff after approval.",
+    description: "Compatibility-profile RP2350 initial-firmware adapter. Default clients must call embedlabs_action_run with action_id=flash_image and artifact_kind=initial_firmware. This adapter installs the board initialization firmware package, locates initial.uf2, plans UF2 flashing through Local Bridge, and optionally flashes it when approved=true.",
     inputSchema: {
       type: "object",
       properties: {
@@ -640,7 +653,7 @@ const tools = [
   },
   {
     name: "dbt_plugin_update_check",
-    description: "Check the published Embed Labs Codex/OpenCode/Trae plugin release and report whether the local plugins should be updated.",
+    description: "Check the published EmbedLabs Codex/OpenCode/Trae plugin release and local plugin integrity, including repair_required, local_integrity, cache_stale, and release_package_stale diagnostics for same-version plugin repair.",
     inputSchema: {
       type: "object",
       properties: {
@@ -658,12 +671,12 @@ const tools = [
   },
   {
     name: "dbt_plugin_update",
-    description: "Update the local Embed Labs Codex/OpenCode/Trae plugin installation from the published release. Restart the updated client after this finishes.",
+    description: "Update the local EmbedLabs Codex/OpenCode/Trae plugin installation from the published release. Omit target_plugin to update all retained IDE integrations. Restart the updated client after this finishes.",
     inputSchema: {
       type: "object",
       properties: {
-        target_plugin: { type: "string", enum: ["codex", "opencode", "trae", "all"] },
-        plugin: { type: "string", enum: ["codex", "opencode", "trae", "all"] },
+        target_plugin: { type: "string", enum: ["codex", "opencode", "trae", "all"], description: "Optional target client. Defaults to all, which updates Codex, OpenCode, and Trae together." },
+        plugin: { type: "string", enum: ["codex", "opencode", "trae", "all"], description: "Alias for target_plugin. Defaults to all when omitted." },
         release_url: { type: "string" },
         releaseUrl: { type: "string" },
         target: { type: "string" },
@@ -678,12 +691,11 @@ const tools = [
   },
   {
     name: "dbt_local_compile",
-    description: "Compile a local TaishanPi source file with the local Embed Labs LLVM toolchain. The user must be signed in with an Embed Labs token for account attribution.",
+    description: "Compile a local TaishanPi source file with the local EmbedLabs LLVM toolchain. This runs on the user's computer through local toolchain metadata and the local installation identity.",
     inputSchema: {
       type: "object",
       required: ["source_path", "output_path"],
       properties: {
-        account_id: { type: "string" },
         source_path: { type: "string" },
         output_path: { type: "string" },
         release_root: { type: "string" }
@@ -692,12 +704,11 @@ const tools = [
   },
   {
     name: "dbt_local_qt_smoke",
-    description: "Build a local TaishanPi Qt/CMake application with the local Embed Labs LLVM/Qt toolchain. Defaults to the built-in smoke app, but for real demos pass source_path and target_name. Use official board-pack examples such as taishanpi/examples/modbus-loop-demo instead of ad hoc projects. The user must be signed in with an Embed Labs token for account attribution.",
+    description: "Build a local TaishanPi Qt/CMake application with the local EmbedLabs LLVM/Qt toolchain. Defaults to the built-in smoke app, but for real demos pass source_path and target_name. Use official board-pack examples such as taishanpi/examples/modbus-loop-demo instead of ad hoc projects. This runs on the user's computer.",
     inputSchema: {
       type: "object",
       required: ["build_dir"],
       properties: {
-        account_id: { type: "string" },
         source_path: { type: "string" },
         build_dir: { type: "string" },
         target_name: { type: "string" },
@@ -707,7 +718,7 @@ const tools = [
   },
   {
     name: "dbt_taishanpi_qt_app_workflow",
-    description: "Single high-level TaishanPi Qt application workflow. Use this directly for Qt/QtQuick app development, Modbus/UART demos, cross compilation, deployment, and runtime checks. The tool validates/repairs the Qt SDK, selects a board-pack template when source_path is omitted, builds with the local LLVM/Qt toolchain, and can deploy/run after approval. Do not search scripts, print CLI help, or create ad hoc serial backends.",
+    description: "Compatibility-profile TaishanPi Qt application adapter. Default clients must call embedlabs_action_run with action_id=deploy_app for Qt/QtQuick app development, demos, cross compilation, deployment, and runtime checks. This adapter validates/repairs the Qt SDK, selects a BoardPack template when source_path is omitted, builds with the local LLVM/Qt toolchain, and can deploy/run after approval.",
     inputSchema: {
       type: "object",
       properties: {
@@ -719,6 +730,10 @@ const tools = [
         local_device_id: { type: "string" },
         host: { type: "string" },
         remote_path: { type: "string" },
+        remote_dir: { type: "string" },
+        remote_file: { type: "string" },
+        wrapper_script: { type: "string" },
+        run_script: { type: "string" },
         deploy: { type: "boolean" },
         run: { type: "boolean" },
         approve: { type: "boolean" },
@@ -729,14 +744,14 @@ const tools = [
   },
   {
     name: "dbttool",
-    description: "Generic Embed Labs action router. Use this when a board/protocol-specific action is not visible as a top-level MCP tool. For RP2350/Pico Monitor hardware-control requests such as UART/SPI/I2C/GPIO test output, logic-analyzer capture, Wi-Fi, probe, or firmware flashing, call the matching rp2350-* action directly through this router; do not search the workspace, create Pico SDK/CMake projects, write main.c, scrape the monitor UI, or use shell serial/curl commands. For closed-loop protocol validation, call action=rp2350-logic-capture once with a stimulus object, then action=rp2350-logic-decode. Action groups: catalog discovery (supported-boards, cloud-status, knowledge), generic board control (board-reboot, board-bootloader, image-flash/image-update), local environment (local-toolchain-list/install/uninstall/validate/current, local-compile, local-qt-smoke), RP2350 hardware control (rp2350-capabilities/status/gpio-read/gpio-write/uart-write/i2c-transfer/spi-transfer/logic-capture/logic-decode/wifi-manage/probe-debug/monitor-firmware-flash/initial-firmware-flash), TaishanPi workflows (taishanpi-qt-workflow, boot-logo-update, taishanpi-initial-image-flash), and task/artifact helpers. Server workspace and Docker build actions are disabled in the local-first product model.",
+    description: "Generic EmbedLabs compatibility router for engineering fallback. Default user requests must go through embedlabs_chat or embedlabs_action_run with high-level actions such as detect_board, query_board_knowledge, install_toolchain, build_project, flash_image, deploy_app, debug_board, capture_signal, manage_board_pack, submit_report, and create_fix_candidate. Use board/protocol-specific rp2350-* or taishanpi-* actions only in compact/full engineering profiles after the high-level Agent action cannot express the request or when validating a specific adapter. For closed-loop protocol validation, normally call the high-level capture_signal action; use rp2350-logic-capture/decode only as an engineering fallback. Do not scan the user's project to invent firmware, create Pico SDK/CMake projects, write main.c, scrape the monitor UI, or use shell serial/curl commands.",
     inputSchema: {
       type: "object",
       required: ["action"],
       properties: {
         action: {
           type: "string",
-          description: "Compact action id such as supported-boards, status, cloud-status, board-reboot, board-bootloader, image-flash, rp2350-capabilities, rp2350-spi-transfer, rp2350-logic-capture, boot-logo-update, local-toolchain-install, local-compile, local-qt-smoke, taishanpi-qt-workflow, task-status, or artifact-download."
+          description: "Compact action id such as supported-boards, status, cloud-status, board-reboot, board-bootloader, image-flash, rp2350-capabilities, rp2350-spi-transfer, rp2350-logic-capture, boot-logo-update, local-toolchain-install, local-compile, local-qt-smoke, or taishanpi-qt-workflow."
         },
         request: { type: "string", description: "Optional natural-language request for high-level workflows." },
         arguments_json: { type: "string", description: "Optional JSON object string passed as the selected action arguments." }
@@ -745,12 +760,26 @@ const tools = [
   }
 ];
 
-const DEFAULT_EXPOSED_MCP_TOOL_NAMES = new Set([
-  "dbt_auth_status",
+const AGENT_MCP_TOOL_ALIASES = new Map([
+  ["embedlabs_agent_status", "dbt_agent_status"],
+  ["embedlabs_action_schema", "dbt_agent_action_schema"],
+  ["embedlabs_action_run", "dbt_agent_action_run"],
+  ["embedlabs_chat", "dbt_agent_chat"],
+  ["embedlabs_plugin_update_check", "dbt_plugin_update_check"],
+  ["embedlabs_plugin_update", "dbt_plugin_update"]
+]);
+
+const AGENT_EXPOSED_MCP_TOOL_NAMES = new Set(AGENT_MCP_TOOL_ALIASES.keys());
+
+const COMPACT_EXPOSED_MCP_TOOL_NAMES = new Set([
+  "dbt_agent_status",
   "dbt_current_board_status",
+  "dbt_agent_action_schema",
+  "dbt_agent_action_run",
+  "dbt_agent_chat",
   "dbt_supported_boards",
-  "dbt_cloud_status",
   "dbt_board_knowledge_search",
+  "dbt_cloud_status",
   "dbt_initial_image_flash",
   "dbt_board_debug",
   "dbt_boot_logo_update",
@@ -765,16 +794,123 @@ const DEFAULT_EXPOSED_MCP_TOOL_NAMES = new Set([
   "dbttool"
 ]);
 
+const FULL_EXPOSED_MCP_TOOL_NAMES = new Set([
+  ...COMPACT_EXPOSED_MCP_TOOL_NAMES,
+  "dbt_rp2350_monitor_status",
+  "dbt_rp2350_capabilities",
+  "dbt_rp2350_operation",
+  "dbt_rp2350_gpio_read",
+  "dbt_rp2350_gpio_write",
+  "dbt_rp2350_uart_write",
+  "dbt_rp2350_i2c_transfer",
+  "dbt_rp2350_logic_capture",
+  "dbt_rp2350_logic_decode",
+  "dbt_rp2350_spi_transfer",
+  "dbt_rp2350_wifi_manage",
+  "dbt_rp2350_probe_debug",
+  "dbt_rp2350_monitor_command",
+  "dbt_taishanpi_initial_image_flash",
+  "dbt_rp2350_monitor_firmware_flash",
+  "dbt_rp2350_initial_firmware_flash",
+  "dbt_local_compile",
+  "dbt_local_qt_smoke"
+]);
+
 function mcpToolProfile() {
   const profile = asString(process.env.EMBEDLABS_MCP_TOOL_PROFILE).toLowerCase();
   if (profile) return profile;
   if (["1", "true", "yes", "on"].includes(asString(process.env.EMBEDLABS_MCP_FULL_TOOLS).toLowerCase())) return "full";
-  return "default";
+  return "agent";
 }
 
 function exposedMcpTools() {
-  if (mcpToolProfile() === "full") return tools;
-  return tools.filter((tool) => DEFAULT_EXPOSED_MCP_TOOL_NAMES.has(tool.name));
+  const profile = mcpToolProfile();
+  if (profile === "full") return tools.filter((tool) => FULL_EXPOSED_MCP_TOOL_NAMES.has(tool.name));
+  if (profile === "compact" || profile === "compat") return tools.filter((tool) => COMPACT_EXPOSED_MCP_TOOL_NAMES.has(tool.name));
+  return Array.from(AGENT_MCP_TOOL_ALIASES.entries()).map(([publicName, legacyName]) => {
+    const tool = tools.find((item) => item.name === legacyName);
+    return {
+      ...tool,
+      name: publicName,
+      description: agentProfileToolDescription(tool.description),
+      inputSchema: sanitizeAgentProfileInputSchema(tool.inputSchema)
+    };
+  });
+}
+
+function isMcpToolExposed(name) {
+  return exposedMcpTools().some((tool) => tool.name === name);
+}
+
+function canonicalMcpToolName(name) {
+  return AGENT_MCP_TOOL_ALIASES.get(name) || name;
+}
+
+function agentProfileToolDescription(description) {
+  return asString(description)
+    .replaceAll("dbt_agent_status", "embedlabs_agent_status")
+    .replaceAll("dbt_agent_action_schema", "embedlabs_action_schema")
+    .replaceAll("dbt_agent_action_run", "embedlabs_action_run")
+    .replaceAll("dbt_agent_chat", "embedlabs_chat")
+    .replaceAll("dbt_plugin_update_check", "embedlabs_plugin_update_check")
+    .replaceAll("dbt_plugin_update", "embedlabs_plugin_update")
+    .replaceAll("low-level MCP tools", "implementation-level tools");
+}
+
+function sanitizeAgentProfileInputSchema(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) return schema;
+  const sanitized = { ...schema };
+  if (sanitized.properties && typeof sanitized.properties === "object" && !Array.isArray(sanitized.properties)) {
+    const { include_raw: _includeRaw, ...properties } = sanitized.properties;
+    sanitized.properties = properties;
+  }
+  return sanitized;
+}
+
+function sanitizeAgentProfileArgs(args) {
+  if (!args || typeof args !== "object" || Array.isArray(args)) return {};
+  const { include_raw: _includeRaw, includeRaw: _includeRawCamel, ...rest } = args;
+  return rest;
+}
+
+function sanitizeMcpPublicValue(value, key = "") {
+  if (typeof value === "string") {
+    if (isLocalPathLikePublicKey(key)) return "[local-path]";
+    return summarizePublicText(value);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => sanitizeMcpPublicValue(item, key));
+  }
+  if (!value || typeof value !== "object") return value;
+  return Object.fromEntries(
+    Object.entries(value)
+      .map(([entryKey, entryValue]) => [entryKey, sanitizeMcpPublicValue(entryValue, entryKey)])
+  );
+}
+
+function isLocalPathLikePublicKey(key) {
+  return [
+    "path",
+    "file",
+    "dir",
+    "directory",
+    "target",
+    "target_path",
+    "checked_path",
+    "source_path",
+    "package_path",
+    "marketplace_path",
+    "config_path",
+    "cache_path",
+    "report_path",
+    "reports_dir",
+    "session_path",
+    "memory_path",
+    "output_path",
+    "local_path",
+    "local_file",
+    "log_path"
+  ].includes(asString(key).toLowerCase());
 }
 
 function asString(value) {
@@ -840,13 +976,167 @@ function pushOptional(args, name, value) {
   if (text) args.push(`--${name}`, text);
 }
 
+function toCliFlagName(name) {
+  return asString(name).replace(/[A-Z]/g, (item) => `-${item.toLowerCase()}`).replaceAll("_", "-");
+}
+
+const AGENT_ACTION_CLI_FLAGS = new Set([
+  "board",
+  "board-id",
+  "template",
+  "template-id",
+  "query",
+  "title",
+  "description",
+  "optimization-item-id",
+  "item-id",
+  "branch",
+  "branch-name",
+  "test-scope",
+  "notes",
+  "category",
+  "severity",
+  "component",
+  "device",
+  "device-id",
+  "channel",
+  "metadata-root",
+  "source-url",
+  "source-release-root",
+  "install-root",
+  "operation",
+  "op",
+  "mode",
+  "force",
+  "update",
+  "uninstall",
+  "remove",
+  "list",
+  "source",
+  "output",
+  "artifact",
+  "artifact-path",
+  "image",
+  "image-path",
+  "image-dir",
+  "artifact-kind",
+  "logo",
+  "logo-path",
+  "kernel-logo",
+  "kernel-logo-path",
+  "base-image",
+  "base-image-path",
+  "output-image",
+  "output-image-path",
+  "output-resource",
+  "output-resource-path",
+  "target-volume",
+  "local-device-id",
+  "variant",
+  "hardware-profile",
+  "remote-path",
+  "remote-dir",
+  "remote-file",
+  "wrapper-script",
+  "run-script",
+  "run-command",
+  "run",
+  "timeout",
+  "user",
+  "partition",
+  "partitions",
+  "release-root",
+  "profile",
+  "build-profile",
+  "approve",
+  "host",
+  "port",
+  "serial-path",
+  "monitor-bridge-url",
+  "pin-base",
+  "pin-count",
+  "sample-rate",
+  "sample-rate-hz",
+  "samples",
+  "output-path",
+  "pull",
+  "wait-timeout-ms",
+  "read-timeout-ms",
+  "pre-samples",
+  "post-samples",
+  "search-samples",
+  "trigger-pin",
+  "trigger-mode",
+  "trigger-level",
+  "trigger-mask",
+  "trigger-value",
+  "channel-names",
+  "protocol",
+  "decoder",
+  "stimulus",
+  "stimulus-json",
+  "input-path",
+  "capture-id",
+  "swclk",
+  "swdio",
+  "reset"
+]);
+
+function appendAgentActionFlag(command, name, value) {
+  const flag = toCliFlagName(name === "approved" ? "approve" : name);
+  if (!flag) return;
+  if (!AGENT_ACTION_CLI_FLAGS.has(flag)) return;
+  if (value === undefined || value === null || value === "") return;
+  if (typeof value === "boolean") {
+    if (value) command.push(`--${flag}`);
+    return;
+  }
+  if (Array.isArray(value)) {
+    command.push(`--${flag}`, value.map((item) => asCliValue(item) || JSON.stringify(item)).join(","));
+    return;
+  }
+  if (typeof value === "object") {
+    command.push(`--${flag}`, JSON.stringify(value));
+    return;
+  }
+  const text = asCliValue(value);
+  if (text) command.push(`--${flag}`, text);
+}
+
+function agentActionPayload(args) {
+  const payload = objectValue(args.arguments_json) || {};
+  for (const [key, value] of Object.entries(args || {})) {
+    if (["action_id", "action", "name", "arguments_json", "include_raw", "timeout_ms"].includes(key)) continue;
+    if (payload[key] === undefined) payload[key] = value;
+  }
+  if (asString(args.request) && payload.query === undefined && payload.prompt === undefined) {
+    payload.query = asString(args.request);
+  }
+  return payload;
+}
+
 async function runEmbed(args) {
   const command = resolveEmbedCommand();
   const fullArgs = command.args.concat(ensureJson(args));
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      return await runEmbedOnce(command, fullArgs);
+    } catch (error) {
+      if (attempt === 0 && isTransientEmbedCliPipeError(undefined, error?.message)) {
+        await wait(100);
+        continue;
+      }
+      throw error;
+    }
+  }
+  throw new Error("EmbedLabs CLI failed after retry.");
+}
+
+async function runEmbedOnce(command, fullArgs) {
   return await new Promise((resolve, reject) => {
     const child = spawn(command.file, fullArgs, {
       cwd: process.cwd(),
-      env: process.env,
+      env: embedCliEnv(),
       stdio: ["ignore", "pipe", "pipe"]
     });
     let stdout = "";
@@ -872,6 +1162,21 @@ async function runEmbed(args) {
   });
 }
 
+function isTransientEmbedCliPipeError(stdout, stderr) {
+  return !asString(stdout).trim() && /\bEPIPE\b/.test(asString(stderr));
+}
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function embedCliEnv() {
+  return {
+    ...process.env,
+    EMBEDLABS_ENABLE_INTERNAL_DIRECT_COMMANDS: "1"
+  };
+}
+
 async function runProcess(command, args, options = {}) {
   return await new Promise((resolve) => {
     const child = spawn(command, args, {
@@ -900,19 +1205,19 @@ async function runProcess(command, args, options = {}) {
 
 function parseEmbedJson(output) {
   if (!output) {
-    return { ok: false, error: { code: "empty_cli_output", message: "Embed Labs CLI returned an empty response." } };
+    return { ok: false, error: { code: "empty_cli_output", message: "EmbedLabs CLI returned an empty response." } };
   }
   try {
     return JSON.parse(output);
   } catch {
-    return { ok: false, error: { code: "non_json_cli_output", message: "Embed Labs CLI returned non-JSON output." } };
+    return { ok: false, error: { code: "non_json_cli_output", message: "EmbedLabs CLI returned non-JSON output." } };
   }
 }
 
 function summarizeEmbedFailure(exitCode, parsed, stderr) {
   const body = parsed && typeof parsed === "object" ? parsed : {};
   const error = body.error && typeof body.error === "object" ? body.error : {};
-  const message = asString(error.message) || asString(error.code) || summarizePublicText(stderr) || "Embed Labs CLI command failed.";
+  const message = asString(error.message) || asString(error.code) || summarizePublicText(stderr) || "EmbedLabs CLI command failed.";
   const code = asString(error.code) || "embed_cli_failed";
   const summarizedError = {
     code,
@@ -943,7 +1248,7 @@ function parseThrownEmbedFailure(error) {
     ok: false,
     error: {
       code: "embed_cli_failed",
-      message: summarizePublicText(text) || "Embed Labs CLI command failed."
+      message: summarizePublicText(text) || "EmbedLabs CLI command failed."
     }
   };
 }
@@ -952,7 +1257,7 @@ function toolFailureResult(error, context = {}) {
   const parsed = parseThrownEmbedFailure(error);
   const err = parsed?.error && typeof parsed.error === "object" ? parsed.error : {};
   const code = asString(err.code) || "embed_cli_failed";
-  const message = asString(err.message) || "Embed Labs CLI command failed.";
+  const message = asString(err.message) || "EmbedLabs CLI command failed.";
   const failure = {
     ok: false,
     ...(Number.isFinite(Number(parsed?.exit_code)) ? { exit_code: Number(parsed.exit_code) } : {}),
@@ -982,13 +1287,13 @@ function friendlyToolFailureSummary(code, message, context = {}) {
       return "RP2350 Monitor 没有可用连接通道。支持两种方式：USB 串口连接，或局域网 IP/TCP 连接。请确认 USB 设备未被虚拟机占用，或者提供设备 IP/tcp_endpoint 后重试。";
     }
     if (code === "rp2350_monitor_bridge_handshake_failed") {
-      return "RP2350 Monitor 固件控制通道没有响应。开发板已被识别，但 USB/TCP 命令握手失败；请重新上电或重新刷写 Monitor 固件后再试。";
+      return "RP2350 Monitor 固件控制通道没有响应。开发板已被识别，但 USB/TCP 命令握手失败；请先执行 `embedlabs bridge restart` 后重试。如仍失败，再重新上电或重新刷写 Monitor 固件。";
     }
     if (code === "rp2350_monitor_unavailable") {
       return "RP2350 Monitor 控制通道尚未就绪。请确认设备已刷入 Monitor 固件且未被虚拟机占用；如果使用 Wi-Fi/以太网连接，请提供设备局域网 IP 或 tcp_endpoint。";
     }
     if (/No such file or directory/i.test(text) && /usbmodem|ttyACM|COM\d+/i.test(text)) {
-      return "RP2350 Monitor 的 USB 串口上游连接已经失效。可以重新插拔设备或重启 Embed Labs Local Bridge；如果开发板已联网，也可以提供局域网 IP/tcp_endpoint 走网络连接。";
+      return "RP2350 Monitor 的 USB 串口上游连接已经失效。请先执行 `embedlabs bridge restart`；如果开发板已联网，也可以提供局域网 IP/tcp_endpoint 走网络连接。";
     }
     return `RP2350 Monitor 操作失败：${text}`;
   }
@@ -996,17 +1301,14 @@ function friendlyToolFailureSummary(code, message, context = {}) {
 }
 
 function isAuthSetupError(code) {
-  return code === "auth_token_missing"
-    || code === "auth_token_rejected"
-    || code === "auth_not_ready"
-    || code === "tool_integrity_check_failed"
-    || code === "device_signature_required";
+  return code === "tool_integrity_check_failed"
+    || code === "installation_identity_required";
 }
 
 function authSetupDetails(details) {
   if (!details || typeof details !== "object" || Array.isArray(details)) return undefined;
   const allowed = {};
-  for (const key of ["dashboard_url", "login_command", "env_var", "auth_status_command", "device_status_command", "auth_file"]) {
+  for (const key of ["agent_status_command", "identity_init_command", "identity_status_command", "memory_home"]) {
     const value = details[key];
     if (typeof value === "string" && value.trim()) {
       allowed[key] = value.slice(0, 500);
@@ -1019,9 +1321,17 @@ function summarizePublicText(value) {
   const text = asString(value).trim();
   if (!text) return undefined;
   return text
-    .replace(/(sk-[A-Za-z0-9_-]{8,})/g, "[redacted]")
-    .replace(/(npm_[A-Za-z0-9_-]{8,})/g, "[redacted]")
-    .replace(/(re_[A-Za-z0-9_-]{8,})/g, "[redacted]")
+    .replace(/(sk-[A-Za-z0-9_-]{8,})/g, "[redacted:api_key]")
+    .replace(/(npm_[A-Za-z0-9_-]{8,})/g, "[redacted:api_key]")
+    .replace(/\b(re_[A-Za-z0-9_-]{8,})\b/g, "[redacted:api_key]")
+    .replace(/\b((?:OPENAI|ANTHROPIC|BAI|DASHSCOPE|GEMINI|GOOGLE|AWS|NPM)[A-Z0-9_]*_KEY)\s*[:=]\s*['"]?[^'"\s,;}]+/gi, "$1=[redacted:api_key]")
+    .replace(/\b(password|passwd|pwd|secret|token|api[_-]?key)\s*[:=]\s*['"]?[^'"\s,;}]+/gi, "$1=[redacted:secret]")
+    .replace(/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g, "[redacted:email]")
+    .replace(/\bhttps?:\/\/(?:localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)(?::\d+)?(?:\/[^\s,;)}\]]*)?/gi, "[redacted:local_url]")
+    .replace(/\bfile:\/{2,3}(?:[A-Za-z]:\/|(?:Users|private|tmp|var\/folders|Volumes)\/)[^\s,;)}\]]+/gi, "[redacted:local_path]")
+    .replace(/(?:\/Users|\/private|\/tmp|\/var\/folders|\/Volumes)\/[^\s,;)}\]]+/g, "[redacted:local_path]")
+    .replace(/\b[A-Za-z]:\/Users\/[^\s,;)}\]]+/g, "[redacted:local_path]")
+    .replace(/\b[A-Za-z]:\\[^\s,;)}\]]+/g, "[redacted:local_path]")
     .slice(0, 500);
 }
 
@@ -1031,32 +1341,49 @@ function responseData(response) {
   return body;
 }
 
-async function pluginAuthStatus() {
+async function pluginAgentStatus() {
   let response;
   try {
-    response = await runEmbed(["auth", "status"]);
+    response = await runEmbed(["agent", "status"]);
   } catch (error) {
-    return authNotReadyResult({
-      authenticated: false,
-      source_error: error instanceof Error ? error.message : String(error)
-    });
-  }
-  const status = responseData(response) || {};
-  if (status.authenticated === true && status.device_id && status.device_integrity === "ok") {
     return {
-      ok: true,
-      authenticated: true,
-      device_ready: true,
-      profile: status.profile,
-      source: status.source,
-      account_id: status.account_id,
-      api_key_id: status.api_key_id,
-      device_id: status.device_id,
-      device_integrity: status.device_integrity,
-      message: "Embed Labs token and device binding are ready."
+      ok: false,
+      error: {
+        code: "embedlabs_cli_unavailable",
+        message: "EmbedLabs CLI is not available to this plugin.",
+        remediation: "Install or update the embedlabs CLI, then restart Codex/OpenCode/Trae.",
+        details: {
+          source_error: error instanceof Error ? error.message : String(error)
+        }
+      }
     };
   }
-  return authNotReadyResult(status);
+  const status = responseData(response) || {};
+  const statusNextCommands = Array.isArray(status.next_commands) ? status.next_commands : [];
+  return {
+	    ok: true,
+	    local_agent_ready: status.runtime === "embedlabs-local-agent" || Boolean(status.installation),
+	    identity_scope: "local_installation",
+	    uses_local_installation_identity: true,
+    runtime: status.runtime,
+    client: status.client,
+    installation: status.installation,
+    model: status.model,
+    memory: status.memory,
+    bridge: status.bridge,
+    closed_loop: status.closed_loop,
+    upstream_adapter: status.upstream_adapter,
+    public_experience: status.public_experience,
+    auto_sync: status.auto_sync,
+    message: "Local EmbedLabs Agent status was read from this computer. EmbedLabs uses local model configuration, local installation identity, BoardPack, SDK, Local Bridge, compile, flash, deploy, and debug workflows on this machine.",
+    next_commands: statusNextCommands.length > 0 ? statusNextCommands : [
+      {
+        label: "check_local_agent",
+        command: "embedlabs agent status --json",
+        description: "Check local Agent identity, model config, memory, and Local Bridge status."
+      }
+    ]
+  };
 }
 
 function formatCurrencyCents(value, currency = "USD") {
@@ -1065,45 +1392,6 @@ function formatCurrencyCents(value, currency = "USD") {
   return `${currency || "USD"} ${(amount / 100).toFixed(2)}`;
 }
 
-function authNotReadyResult(status) {
-  const authenticated = status?.authenticated === true;
-  const integrity = asString(status?.device_integrity) || (status?.device_id ? "unknown" : "unbound");
-  const code = !authenticated ? "auth_token_missing" : integrity === "failed" ? "tool_integrity_check_failed" : "auth_not_ready";
-  const message = code === "tool_integrity_check_failed"
-    ? TOOL_INTEGRITY_RELOGIN_MESSAGE
-    : !authenticated
-      ? "Embed Labs API Token is not configured for this plugin."
-      : "Embed Labs API Token 已配置，但还没有完成本机设备绑定。";
-  return {
-    ok: false,
-    error: {
-      code,
-      message,
-      remediation: [
-        "1. Open https://api.embedboard.com/dashboard and sign in or register.",
-        "2. Create or copy your Embed Labs API Token.",
-        "3. Update the local CLI, then run: embedlabs auth login --token <your_token>",
-        "4. Verify device binding with: embedlabs auth device status",
-        "5. Restart Codex/OpenCode/Trae so the plugin picks up the refreshed CLI and auth file."
-      ].join("\n"),
-      details: {
-        dashboard_url: "https://api.embedboard.com/dashboard",
-        login_command: "embedlabs auth login --token <your_token>",
-        auth_status_command: "embedlabs auth status",
-        device_status_command: "embedlabs auth device status",
-        auth_file: ".embed-labs/auth.json",
-        current_status: {
-          authenticated,
-          source: status?.source,
-          profile: status?.profile,
-          device_id: status?.device_id,
-          device_integrity: integrity
-        }
-      }
-    }
-  };
-}
-
 function pickArtifact(response, preferredKind) {
   const data = responseData(response);
   const artifacts = Array.isArray(data?.artifacts) ? data.artifacts : [];
@@ -1120,73 +1408,72 @@ function pickArtifact(response, preferredKind) {
 async function cloudStatus(args) {
   const template = asString(args.template_id || args.template);
   const includeRaw = boolValue(args.include_raw);
-  const [modelDefault, serviceModes] = await Promise.all([
-    runEmbed(["model", "default"]),
-    runEmbed(["service", "modes"])
-  ]);
   if (!template) {
     const boards = await supportedBoards(args);
     return {
-      model_default: modelDefault,
-      service_modes: serviceModes,
       ...boards,
+      compatibility_adapter: "dbt_cloud_status_to_agent_board_metadata",
+      agent_actions: ["install_toolchain", "manage_board_pack"],
       selected_template_id: null,
       board_methods: undefined,
-      note: "No template_id was supplied, so this response lists supported boards only. Board methods are template-specific; call dbt_cloud_status with template_id for one selected board."
+      model_service_catalog_retired: true,
+      note: "No template_id was supplied, so this compatibility response lists supported boards only. Model/service catalogs are retired from the plugin surface. Normal clients should use embedlabs_action_run with action_id=manage_board_pack for supported-board/BoardPack catalog lists and action_id=install_toolchain only for SDK/toolchain install, update, uninstall, or package-status requests."
     };
   }
-  const [board, methods, knowledge] = await Promise.all([
-    runEmbed(["board", "registry", "show", template]),
-    runEmbed(["board", "methods", template]),
-    runEmbed(["board", "knowledge", template])
+  const [boards, knowledge] = await Promise.all([
+    supportedBoards(args),
+    boardKnowledgeSearch({
+      template_id: template,
+      query: asString(args.query) || "board capabilities toolchain install flash deploy debug pinout workflow",
+      include_raw: includeRaw
+    })
   ]);
-  if (includeRaw) {
-    return { model_default: modelDefault, service_modes: serviceModes, board, methods, knowledge };
-  }
-  return compactCloudStatusResult({ template, modelDefault, serviceModes, board, methods, knowledge });
-}
-
-function compactCloudStatusResult({ template, modelDefault, serviceModes, board, methods, knowledge }) {
-  const model = responseData(modelDefault) || {};
-  const service = responseData(serviceModes) || {};
-  const boardData = responseData(board) || {};
-  const methodData = responseData(methods) || {};
-  const knowledgeData = responseData(knowledge) || {};
-  const methodItems = Array.isArray(methodData.methods) ? methodData.methods : [];
-  const knowledgeItems =
-    (Array.isArray(knowledgeData.files) && knowledgeData.files) ||
-    (Array.isArray(knowledgeData.knowledge_files) && knowledgeData.knowledge_files) ||
-    (Array.isArray(knowledgeData.sources) && knowledgeData.sources) ||
-    [];
-  const method_table = methodItems.slice(0, 20).map((item) => compactObject({
-    method_id: item.method_id || item.id,
-    execution_plane: item.execution_plane,
-    tool: item.api?.mvp_tool || item.mvp_tool,
-    summary: summarizePublicText(item.summary || item.description)
-  }));
+  return compactCloudStatusResult({ template, boards, knowledge, includeRaw });
+}
+
+function compactCloudStatusResult({ template, boards, knowledge, includeRaw }) {
+  const table = Array.isArray(boards?.table) ? boards.table : [];
+  const selectedBoard =
+    table.find((item) => item.template_id === template || item.board_id === template) ||
+    table.find((item) => String(item.template_id || "").includes(template)) ||
+    null;
+  const knowledgeData = knowledge?.board_knowledge || knowledge?.execution?.knowledge || {};
+  const method_table = [
+    { method_id: "detect_board", tool: "embedlabs_action_run", summary: "Detect connected local hardware through Go Local Bridge inventory." },
+    { method_id: "query_board_knowledge", tool: "embedlabs_action_run", summary: "Answer pinout, SDK, flash, debug, and board workflow questions from the board pack." },
+    { method_id: "install_toolchain", tool: "embedlabs_action_run", summary: "List, install, update, or uninstall local board toolchain packages." },
+    { method_id: "build_project", tool: "embedlabs_action_run", summary: "Build a local project with the installed local SDK/toolchain." },
+    { method_id: "flash_image", tool: "embedlabs_action_run", summary: "Plan and run approved local flashing through Local Bridge." },
+    { method_id: "deploy_app", tool: "embedlabs_action_run", summary: "Deploy and optionally run a local app on a selected board." },
+    { method_id: "debug_board", tool: "embedlabs_action_run", summary: "Run local diagnostics for the selected connected board." },
+    { method_id: "capture_signal", tool: "embedlabs_action_run", summary: "Capture and decode hardware signals through RP2350 Monitor/Local Bridge." },
+    { method_id: "manage_board_pack", tool: "embedlabs_action_run", summary: "List or inspect BoardPack catalog/package metadata without adding visible MCP tools." }
+  ];
   return compactObject({
-    ok: true,
+    ok: boards?.ok !== false && knowledge?.ok !== false,
+    compatibility_adapter: "dbt_cloud_status_to_agent_board_metadata",
     template_id: template,
-    model_default: compactObject({
-      provider: model.provider,
-      model: model.model,
-      display_name: model.display_name || model.name
-    }),
-    service_modes: compactObject({
-      default_mode: service.default_mode || service.defaultMode,
-      modes: Array.isArray(service.modes) ? service.modes.map((item) => item.id || item.name || item).slice(0, 10) : undefined
-    }),
+    selected_template_id: template,
+    model_service_catalog_retired: true,
+    agent_actions: ["install_toolchain", "query_board_knowledge", "manage_board_pack"],
     board: compactObject({
-      template_id: boardData.template_id || boardData.id || template,
-      display_name: boardData.display_name || boardData.name,
-      board_id: boardData.board_id,
-      variant_id: boardData.variant_id
+      template_id: selectedBoard?.template_id || template,
+      display_name: selectedBoard?.board,
+      category: selectedBoard?.category,
+      install_status: selectedBoard?.install_status,
+      local_version: selectedBoard?.local_version,
+      server_version: selectedBoard?.server_version,
+      modes: selectedBoard?.modes
     }),
-    method_count: methodItems.length,
+    board_table: table,
+    board_methods: method_table,
+    method_count: method_table.length,
     method_table,
-    knowledge_file_count: knowledgeItems.length,
-    guidance: "Use dbt_board_knowledge_search for board facts and use the high-level MCP tool named in method_table. Raw registry, source URLs, and internal paths are omitted by default.",
-    raw_omitted: true
+    board_knowledge: knowledgeData,
+    summary_for_user: knowledge?.summary_for_user || knowledge?.answer || "Board metadata is available through local Agent compatibility actions.",
+    guidance: "This is a compatibility adapter. For normal use, call embedlabs_action_schema and embedlabs_action_run for the listed high-level actions: manage_board_pack for board/BoardPack catalog lists, install_toolchain for SDK/toolchain package status and install/update/uninstall, and query_board_knowledge for factual board questions. Compatibility tools such as dbt_supported_boards and dbt_board_knowledge_search are diagnostics only. Model/provider configuration stays local and is not part of this tool.",
+    raw: includeRaw ? { supported_boards: boards, knowledge } : undefined,
+    raw_omitted: !includeRaw
   });
 }
 
@@ -1196,103 +1483,252 @@ async function boardKnowledgeSearch(args) {
   if (!query) {
     throw new Error("query is required");
   }
-  const command = ["board", "knowledge", "search", template, "--query", query];
-  pushOptional(command, "source", args.source);
-  pushOptional(command, "limit", args.limit);
-  return await runEmbed(command);
+  const routed = await agentActionRun({
+    action_id: "query_board_knowledge",
+    arguments_json: JSON.stringify(compactObject({
+      template_id: template,
+      query,
+      source: asString(args.source),
+      limit: asString(args.limit)
+    })),
+    include_raw: args.include_raw
+  });
+  return {
+    ...routed,
+    compatibility_adapter: "dbt_board_knowledge_search_to_agent_query_board_knowledge",
+    board_knowledge: routed.execution?.knowledge,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    guidance: "This compatibility tool now routes through the local EmbedLabs Agent query_board_knowledge action. Prefer embedlabs_chat for natural-language questions or embedlabs_action_run when the action contract is explicit."
+  };
 }
 
-async function supportedBoards() {
-  const [registrySettled, localSettled] = await Promise.allSettled([
-    runEmbed(["board", "registry", "list"]),
-    runEmbed(["local", "toolchain", "list"])
-  ]);
-  const registry = settledRunValue(registrySettled);
-  const local = settledRunValue(localSettled);
-  const profiles = Array.isArray(responseData(registry)?.profiles) ? responseData(registry).profiles : [];
-  const environments = Array.isArray(responseData(local)?.environments) ? responseData(local).environments : [];
-  const localByBoard = new Map(environments.map((item) => [asString(item.board_id), item]));
-  const supported = profiles.map((profile) => {
-    const localEnv = localByBoard.get(asString(profile.template_id));
-    const methods = Array.isArray(profile.methods) ? profile.methods : [];
-    const runtimes = [...new Set(methods.map((method) => asString(method.runtime)).filter(Boolean))];
-    const category = boardUxCategory(profile, methods);
-    const capabilityGroups = boardCapabilityGroups(profile, methods);
-    return compactObject({
-      template_id: profile.template_id,
-      board_id: profile.board_id,
-      variant_id: profile.variant_id,
-      display_name: normalizeSupportedBoardDisplayName(profile.display_name || profile.variant_id || profile.template_id),
-      category,
-      support_level: profile.support_level,
-      cloud_method_count: methods.length,
-      cloud_method_runtimes: runtimes,
-      capability_groups: capabilityGroups,
-      recommended_next_step: recommendedBoardNextStep(profile, localEnv),
-      local_toolchain_status: localEnv?.status,
-      local_install_modes: Array.isArray(localEnv?.install_modes) ? localEnv.install_modes : undefined,
-      local_installed: localEnv?.installed,
-      local_installed_version: localEnv?.installed?.version,
-      server_latest_version: localEnv?.latest?.version,
-      local_install_command: localEnv?.install_command,
-      local_update_command: localEnv?.update_command,
-      local_uninstall_command: localEnv ? `embedlabs local toolchain uninstall --board ${profile.template_id}` : undefined
+async function supportedBoards(args = {}) {
+  const routed = await agentActionRun({
+    action_id: "manage_board_pack",
+    arguments_json: JSON.stringify({ operation: "list" }),
+    include_raw: args.include_raw
+  });
+  let toolchainRouted;
+  try {
+    toolchainRouted = await agentActionRun({
+      action_id: "install_toolchain",
+      arguments_json: JSON.stringify({ operation: "list" }),
+      include_raw: args.include_raw
+    });
+  } catch (error) {
+    toolchainRouted = {
+      ok: false,
+      error: { code: "toolchain_status_unavailable", message: error instanceof Error ? error.message : String(error) }
+    };
+  }
+  const boardPack = routed.execution?.board_pack || {};
+  const profiles = Array.isArray(boardPack.profiles) ? boardPack.profiles : [];
+  const operation = toolchainRouted?.execution?.toolchain_operation || {};
+  const environments = Array.isArray(operation.environments) ? operation.environments : [];
+  const environmentByBoard = new Map(environments.map((item) => [item.board_id || item.template_id, item]));
+  const table = profiles.map((profile) => {
+    const templateId = profile.template_id || profile.board_id;
+    const item = environmentByBoard.get(templateId) || {};
+    return ({
+    board: profile.display_name || item.display_name || templateId,
+    template_id: templateId,
+    category: boardUxCategory(profile, []),
+    support_level: profile.support_level || "",
+    method_count: profile.method_count ?? "",
+    knowledge_file_count: profile.knowledge_file_count ?? "",
+    main_functions: Array.isArray(item.modes) ? item.modes.join(", ") : "",
+    install_status: item.status || "unknown",
+    local_version: item.local_version || "not installed",
+    server_version: item.server_version || "unknown",
+    modes: Array.isArray(item.modes) ? item.modes.join(",") : "",
+    next_step: item.install_command || `embedlabs agent action run install_toolchain --operation install --board ${templateId} --json`,
+    show: `embedlabs agent action run manage_board_pack --operation show --template-id ${templateId} --json`,
+    install: item.install_command,
+    update: item.update_command,
+    uninstall: item.uninstall_command
     });
   });
-  for (const env of environments) {
-    const boardId = asString(env.board_id);
-    if (!boardId || supported.some((item) => item.template_id === boardId)) continue;
-    supported.push(compactObject({
-      template_id: boardId,
-      board_id: boardId,
-      display_name: normalizeSupportedBoardDisplayName(env.display_name || boardId),
-      category: boardUxCategory({ template_id: boardId, board_id: boardId }, []),
-      support_level: "local_toolchain",
-      cloud_method_count: 0,
-      cloud_method_runtimes: [],
-      capability_groups: localToolchainCapabilityGroups(env),
-      recommended_next_step: recommendedBoardNextStep({ template_id: boardId, board_id: boardId }, env),
-      local_toolchain_status: env.status,
-      local_install_modes: Array.isArray(env.install_modes) ? env.install_modes : undefined,
-      local_installed: env.installed,
-      local_installed_version: env.installed?.version,
-      server_latest_version: env.latest?.version,
-      local_install_command: env.install_command,
-      local_update_command: env.update_command,
-      local_uninstall_command: `embedlabs local toolchain uninstall --board ${boardId}`
-    }));
-  }
-  supported.sort((a, b) => asString(a.display_name).localeCompare(asString(b.display_name)));
-  const table = supported.map((item) => ({
-    board: item.display_name,
-    template_id: item.template_id,
-    category: item.category,
-    main_functions: Array.isArray(item.capability_groups) ? item.capability_groups.join(", ") : "",
-    support_level: item.support_level,
-    install_status: item.local_toolchain_status || "unknown",
-    local_version: item.local_installed_version || "not installed",
-    server_version: item.server_latest_version || "unknown",
-    modes: Array.isArray(item.local_install_modes) ? item.local_install_modes.join(",") : "",
-    next_step: item.recommended_next_step,
-    install: item.local_install_command,
-    update: item.local_update_command,
-    uninstall: item.local_uninstall_command
-  }));
   return {
-    supported_boards: supported,
+    ok: routed.ok,
+    compatibility_adapter: "dbt_supported_boards_to_agent_manage_board_pack_list",
+    agent_action: "manage_board_pack",
+    companion_agent_action: "install_toolchain",
+    supported_boards: profiles,
+    board_packs: profiles,
+    toolchain_environments: environments,
     table,
-    cloud_registry: {
-      available: !!registry,
-      count: profiles.length,
-      error: settledRunError(registrySettled)
+    execution: routed.execution,
+    toolchain_execution: toolchainRouted?.execution,
+    next_commands: [
+      ...(Array.isArray(routed.next_commands) ? routed.next_commands : []),
+      ...(Array.isArray(toolchainRouted?.next_commands) ? toolchainRouted.next_commands : [])
+    ],
+    guidance: "When the user asks which boards are supported, show board, template_id, category, support_level, install_status, local_version, server_version, modes, and next_step as a Markdown table. Use embedlabs_action_run action_id=manage_board_pack with operation=list/show for BoardPack catalog questions, and action_id=install_toolchain with operation=list/install/update/uninstall only for SDK/toolchain package management. Do not call low-level toolchain tools unless the user explicitly asks for raw diagnostics, and never shell rm.",
+    observed_at: new Date().toISOString()
+  };
+}
+
+async function agentActionSchema(args) {
+  const actionId = asString(args.action_id || args.action || args.name);
+  const command = actionId
+    ? ["agent", "action", "schema", actionId]
+    : ["agent", "action", "schema"];
+  const result = await runEmbed(command);
+  const data = responseData(result) || result?.data || {};
+  return {
+    ok: true,
+    schema_source: "embedlabs-agent-action-catalog",
+    action_id: actionId || undefined,
+    response: boolValue(args.include_raw) ? result : undefined,
+    raw_omitted: !boolValue(args.include_raw),
+    action: data.action,
+    actions: data.actions,
+    definition: data.definition,
+    guidance: "Use input_schema and safety.must_not_infer before calling hardware or local-file actions. Do not infer pins, private paths, target boards, or approval from protocol words or previous memory."
+  };
+}
+
+async function agentActionRun(args) {
+  const startedAt = Date.now();
+  const actionId = asString(args.action_id || args.action || args.name);
+  if (!actionId) {
+    throw new Error("action_id is required");
+  }
+  const command = ["agent", "action", "run", actionId];
+  const payload = agentActionPayload(args);
+  const legacyCaptureArgumentIssue = captureSignalLegacyActionArgumentIssue(actionId, payload);
+  if (legacyCaptureArgumentIssue) return legacyCaptureArgumentIssue;
+  for (const [key, value] of Object.entries(payload)) {
+    appendAgentActionFlag(command, key, value);
+  }
+  const result = await runEmbed(command);
+  const data = responseData(result) || result?.data || {};
+  const executionOk = data.execution?.ok;
+  const cliOk = result?.response?.ok !== false;
+  const localDeviceId = localDeviceIdForTool(args) || inferLocalDeviceIdFromToolResponse(data);
+  const summary = data.execution?.summary || data.answer || data.execution?.error?.message || `${actionId} completed.`;
+  const logResult = await recordMcpToolEvent("embedlabs_action_run", {
+    client: mcpClientName(),
+    mode: "ide_plugin",
+    success: cliOk && executionOk !== false,
+    duration_ms: Date.now() - startedAt,
+    local_device_id: localDeviceId,
+    input_summary: `agent_action=${actionId} ${JSON.stringify(payload).slice(0, 180)}`,
+    output_summary: asString(summary).slice(0, 240)
+  });
+  return {
+    ok: cliOk,
+    cli_ok: cliOk,
+    execution_ok: executionOk,
+    schema_hint: "Use embedlabs_action_schema before this tool when arguments are unclear.",
+    action_id: actionId,
+    response: boolValue(args.include_raw) ? result : undefined,
+    raw_omitted: !boolValue(args.include_raw),
+    execution: sanitizeMcpPublicValue(data.execution),
+    report: sanitizeMcpPublicValue(data.report),
+    secondary_reports: sanitizeMcpPublicValue(data.secondary_reports),
+    auto_sync: sanitizeMcpPublicValue(data.auto_sync),
+    next_commands: sanitizeMcpPublicValue(data.next_commands),
+    answer: sanitizeMcpPublicValue(data.answer),
+    public_experience: sanitizeMcpPublicValue(data.public_experience),
+    usage: {
+      mode: "ide_plugin",
+      input_tokens: 0,
+      output_tokens: 0,
+      local_device_id: localDeviceId || undefined,
+      mcp_service_log: logResult
+    }
+  };
+}
+
+function captureSignalLegacyActionArgumentIssue(actionId, payload) {
+  if (actionId !== "capture_signal" || !payload || typeof payload !== "object") return undefined;
+  const normalizedKeys = new Map(Object.keys(payload).map((key) => [toCliFlagName(key), key]));
+  if (normalizedKeys.has("channels") || normalizedKeys.has("channel")) {
+    const originalKey = normalizedKeys.get("channels") || normalizedKeys.get("channel") || "channels";
+    return legacyCaptureArgumentFailure({
+      actionId,
+      key: originalKey,
+      message: "`channels` is a low-level compatibility alias. For the high-level capture_signal action, pass explicit `pin_base` and `pin_count` or `pins`."
+    });
+  }
+  if (normalizedKeys.has("duration-ms")) {
+    const originalKey = normalizedKeys.get("duration-ms") || "duration_ms";
+    return legacyCaptureArgumentFailure({
+      actionId,
+      key: originalKey,
+      message: "`duration_ms` is a low-level compatibility alias. For the high-level capture_signal action, pass explicit `samples`; compute samples = ceil(duration_ms * sample_rate / 1000)."
+    });
+  }
+  return undefined;
+}
+
+function legacyCaptureArgumentFailure({ actionId, key, message }) {
+  return {
+    ok: false,
+    cli_ok: false,
+    execution_ok: false,
+    action_id: actionId,
+    error: {
+      code: "invalid_args",
+      message: `capture_signal received unsupported ${key}: ${message}`
     },
-    local_toolchains: {
-      available: !!local,
-      count: environments.length,
-      error: settledRunError(localSettled)
+    summary_for_user: `capture_signal received unsupported ${key}: ${message}`,
+    schema_hint: "Call embedlabs_action_schema with action_id=capture_signal and use the high-level input schema.",
+    next_commands: [
+      {
+        label: "describe_capture_signal",
+        command: "embedlabs agent action describe capture_signal --json",
+        description: "Review the high-level capture_signal schema before retrying."
+      }
+    ]
+  };
+}
+
+async function agentChat(args) {
+  const startedAt = Date.now();
+  const prompt = asString(args.prompt || args.request || args.message);
+  if (!prompt) {
+    throw new Error("prompt is required");
+  }
+  const command = ["agent", "chat", "--prompt", prompt];
+  if (!boolValue(args.use_model || args.useModel)) {
+    command.push("--local-only");
+  }
+  const session = asString(args.session || args.chat_session_id);
+  if (session) command.push("--session", session);
+  else if (boolValue(args.new_session || args.newSession)) command.push("--new-session");
+  const result = await runEmbed(command);
+  const data = responseData(result) || result?.data || {};
+  const turns = Array.isArray(data.turns) ? data.turns : [];
+  const firstTurn = turns[0] || {};
+  const logResult = await recordMcpToolEvent("embedlabs_chat", {
+    client: mcpClientName(),
+    mode: "ide_plugin",
+    success: result?.response?.ok !== false && !firstTurn.report,
+    duration_ms: Date.now() - startedAt,
+    input_summary: `agent_chat ${prompt.slice(0, 180)}`,
+    output_summary: asString(firstTurn.answer || firstTurn.report?.error?.message || data.answer || "agent chat completed").slice(0, 240)
+  });
+  return {
+    ok: result?.response?.ok !== false,
+    mode: data.mode,
+    answer: sanitizeMcpPublicValue(firstTurn.answer),
+    intent: firstTurn.intent,
+    chat_session: sanitizeMcpPublicValue(data.chat_session),
+    report: sanitizeMcpPublicValue(firstTurn.report),
+    secondary_reports: sanitizeMcpPublicValue(firstTurn.secondary_reports),
+    public_experience: sanitizeMcpPublicValue(firstTurn.public_experience || data.public_experience),
+    auto_sync: sanitizeMcpPublicValue(firstTurn.auto_sync || data.auto_sync),
+    next_commands: sanitizeMcpPublicValue(data.next_commands || firstTurn.next_commands),
+    response: boolValue(args.include_raw) ? result : undefined,
+    usage: {
+      mode: "ide_plugin",
+      input_tokens: 0,
+      output_tokens: 0,
+      mcp_service_log: logResult
     },
-    guidance: "When the user asks which boards are supported, show board, category, main_functions, install_status, local_version, server_version, modes, and next_step as a Markdown table. Use install/update/uninstall through dbt_local_toolchain_install/dbt_local_toolchain_uninstall or dbttool actions rather than shell rm. Ask the user to pick a board/template_id before showing board-specific method details.",
-    observed_at: new Date().toISOString()
+    guidance: "Continue with embedlabs_chat and the returned chat_session.chat_session_id when the user expects context. Use embedlabs_action_schema/embedlabs_action_run only when a specific high-level action contract is required."
   };
 }
 
@@ -1319,14 +1755,14 @@ function redactSensitive(value) {
   return asString(value)
     .replace(/(sk-[A-Za-z0-9_-]{8,})/g, "[redacted]")
     .replace(/(npm_[A-Za-z0-9_-]{8,})/g, "[redacted]")
-    .replace(/(re_[A-Za-z0-9_-]{8,})/g, "[redacted]")
+    .replace(/\b(re_[A-Za-z0-9_-]{8,})\b/g, "[redacted]")
     .slice(0, 500);
 }
 
 function normalizeSupportedBoardDisplayName(value) {
   const text = asString(value);
   if (!text) return "";
-  if (/^TaishanPi 1M RK3566 server build template$/i.test(text)) return "TaishanPi 1M-RK3566";
+  if (/taishanpi/i.test(text) && /rk3566/i.test(text) && /template/i.test(text)) return "TaishanPi 1M RK3566";
   return text;
 }
 
@@ -1381,65 +1817,81 @@ function recommendedBoardNextStep(profile, localEnv) {
 }
 
 async function boardDebug(args) {
-  const prompt = asString(args.prompt || args.request || args.reason) || "验证开发板状态";
-  const command = ["agent", "run", "--prompt", prompt];
-  pushOptional(command, "account", args.account_id || args.account);
-  pushOptional(command, "workspace", args.workspace_id || args.workspace);
-  pushOptional(command, "provider", args.provider);
-  pushOptional(command, "model", args.model);
-  pushOptional(command, "host", args.host || DEFAULT_HOST);
-  pushOptional(command, "ports", args.ports || DEFAULT_PORTS);
-  pushOptional(command, "artifact", args.artifact_path || args.artifact);
-  pushOptional(command, "artifact-id", args.artifact_id);
-  pushOptional(command, "artifact-task", args.artifact_task_id || args.task_id);
-  pushOptional(command, "artifact-output", args.artifact_output);
-  pushOptional(command, "remote-path", args.remote_path);
-  pushOptional(command, "run-command", args.run_command || args.runCommand);
-  if (boolValue(args.approve)) command.push("--approve");
-  if (boolValue(args.run)) command.push("--run");
-  return await runEmbed(command);
+  const artifactPath = asString(args.artifact_path || args.artifact);
+  const approved = boolValue(args.approve) || boolValue(args.approved);
+  if (artifactPath && approved) {
+    const routed = await agentActionRun({
+      action_id: "deploy_app",
+      arguments_json: JSON.stringify(compactObject({
+        board_id: asString(args.board_id || args.board),
+        local_device_id: asString(args.local_device_id || args.device_id || args.device),
+        host: asString(args.host),
+        user: asString(args.user),
+        artifact_path: artifactPath,
+        remote_path: asString(args.remote_path || args.remotePath),
+        remote_dir: asString(args.remote_dir || args.remoteDir),
+        remote_file: asString(args.remote_file || args.remoteFile),
+        wrapper_script: asString(args.wrapper_script || args.run_script || args.wrapperScript || args.runScript),
+        run_command: asString(args.run_command || args.runCommand),
+        run: boolValue(args.run) || undefined,
+        approve: true
+      })),
+      include_raw: args.include_raw,
+      timeout_ms: args.timeout_ms
+    });
+    return {
+      ok: routed.ok,
+      compatibility_adapter: "dbt_board_debug_to_agent_deploy_app",
+      agent_action: "deploy_app",
+      execution: routed.execution,
+      summary_for_user: routed.execution?.summary ?? routed.answer,
+      response: boolValue(args.include_raw) ? routed.response : undefined
+    };
+  }
+  const routed = await agentActionRun({
+    action_id: "debug_board",
+    arguments_json: JSON.stringify(compactObject({
+      board_id: asString(args.board_id || args.board),
+      local_device_id: asString(args.local_device_id || args.device_id || args.device),
+      host: asString(args.host),
+      scope: asString(args.scope)
+    })),
+    include_raw: args.include_raw,
+    timeout_ms: args.timeout_ms
+  });
+  return {
+    ok: routed.ok,
+    compatibility_adapter: "dbt_board_debug_to_agent_debug_board",
+    agent_action: "debug_board",
+    execution: routed.execution,
+    tool_results: routed.execution?.tool_results,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined
+  };
 }
 
-async function currentBoardStatus(args, authStatus = undefined) {
- const startedAt = Date.now();
- const explicitHost = asString(args.host);
- const ports = parsePorts(args.ports || DEFAULT_STATUS_PORTS);
+async function currentBoardStatus(args) {
+  const startedAt = Date.now();
   const includeRaw = boolValue(args.include_raw);
-  const requestedLocalDeviceId = localDeviceIdForTool(args, authStatus);
-  const scan = await runEmbed(["device", "list"]);
-  const taishanHost = taishanStatusHostFromScan(scan);
-  const host = explicitHost || taishanHost;
-  const probe = host
-    ? await runEmbed(["tool", "call", "device.probe", "--input-json", JSON.stringify({ host, ports })])
-    : emptyBoardStatusProbe();
-  const summary = summarizeBoardStatus(scan, probe, ports);
+  const requestedLocalDeviceId = localDeviceIdForTool(args);
+  const detected = await runEmbed(detectBoardAgentCommand(args));
+  const summary = summarizeAgentDetectBoardStatus(detected);
   const localDeviceId = requestedLocalDeviceId || (summary.local_device_ids?.length === 1 ? summary.local_device_ids[0] : "");
-  if (includeRaw && authStatus?.ok) {
-    summary.device_binding = {
-      authenticated: true,
-      account_id: authStatus.account_id,
-      api_key_id: authStatus.api_key_id,
-      device_id: authStatus.device_id,
-      device_integrity: authStatus.device_integrity
-    };
-  }
   if (localDeviceId) {
     summary.local_device_id = localDeviceId;
   }
   const logResult = await recordMcpToolEvent("dbt_current_board_status", {
     client: "codex",
-    mode: "local_ai",
-    server_model_used: false,
+    mode: "ide_plugin",
     success: summary.query_ok === true,
     duration_ms: Date.now() - startedAt,
     local_device_id: localDeviceId,
-    input_summary: host ? `host=${host} ports=${ports.join(",")}` : "inventory_only",
+    input_summary: "agent_action=detect_board inventory_only",
     output_summary: summary.status_text
   });
   if (includeRaw) {
     summary.usage = {
-      mode: "local_ai_mcp_tool",
-      server_model_used: false,
+      mode: "ide_plugin",
       input_tokens: 0,
       output_tokens: 0,
       mcp_service_log: logResult
@@ -1450,6 +1902,64 @@ async function currentBoardStatus(args, authStatus = undefined) {
   return summary;
 }
 
+function detectBoardAgentCommand(args = {}) {
+  const command = ["agent", "action", "run", "detect_board"];
+  pushOptional(command, "board", args.board_id || args.board);
+  pushOptional(command, "device", args.local_device_id || args.device_id || args.device);
+  return command;
+}
+
+function summarizeAgentDetectBoardStatus(actionResult) {
+  const data = responseData(actionResult) || {};
+  const execution = objectValue(data.execution) || data;
+  const bridge = objectValue(execution.bridge) || objectValue(data.bridge) || {};
+  const inventory = objectValue(bridge.inventory) || {};
+  const rawBoards = Array.isArray(execution.boards)
+    ? execution.boards
+    : execution.board
+      ? [execution.board]
+      : Array.isArray(inventory.boards)
+        ? inventory.boards
+        : [];
+  const boards = rawBoards.map((item) => summarizeBoardDevice(item, new Set()));
+  const localDeviceIds = boards
+    .map((item) => asString(item.local_device_id || item.device_id))
+    .filter(Boolean);
+  const statusText = asString(execution.summary)
+    || asString(data.answer)
+    || asString(inventory.summary_for_user)
+    || asString(inventory.status_text)
+    || (boards.length > 0
+      ? boards.map((board) => `${board.display_name || board.board_id || "Board"} is ${board.status || "detected"}.`).join(" ")
+      : "No supported development board is currently detected by Local Bridge.");
+  const result = {
+    board_connected: boards.some((item) => item.connected === true || item.status === "connected"),
+    boards,
+    local_device_ids: localDeviceIds,
+    tcp_ports: [],
+    status_text: statusText,
+    bridge_board_status: compactObject({
+      status_text: statusText,
+      runtime: bridge.runtime,
+      ok: bridge.ok,
+      inventory_seq: inventory.inventory_seq
+    }),
+    agent_action: compactObject({
+      action_id: "detect_board",
+      ok: execution.ok,
+      high_level_action: true
+    }),
+    observed_at: inventory.observed_at || execution.observed_at || data.observed_at,
+    raw_result_omitted: true,
+    model_answer_omitted: true
+  };
+  Object.defineProperty(result, "query_ok", {
+    value: actionResult?.ok === true && actionResult?.response?.ok !== false,
+    enumerable: false
+  });
+  return result;
+}
+
 function taishanStatusHostFromScan(scanResult) {
   const scan = responseData(scanResult) || {};
   const devices = Array.isArray(scan.development_boards) ? scan.development_boards : (Array.isArray(scan.devices) ? scan.devices : []);
@@ -1501,8 +2011,7 @@ async function rp2350MonitorTool(toolName, capabilityId, args) {
     && data?.result?.ok !== false;
   const logResult = await recordMcpToolEvent(toolName, {
     client: "codex",
-    mode: "local_ai",
-    server_model_used: false,
+    mode: "ide_plugin",
     success,
     duration_ms: Date.now() - startedAt,
     local_device_id: localDeviceId,
@@ -1510,7 +2019,7 @@ async function rp2350MonitorTool(toolName, capabilityId, args) {
     output_summary: asString(summary).slice(0, 240)
   });
   if (boolValue(args.include_raw)) {
-    return { ...response, usage: { mode: "local_ai_mcp_tool", server_model_used: false, input_tokens: 0, output_tokens: 0, local_device_id: localDeviceId || undefined, mcp_service_log: logResult } };
+    return { ...response, usage: { mode: "ide_plugin", input_tokens: 0, output_tokens: 0, local_device_id: localDeviceId || undefined, mcp_service_log: logResult } };
   }
   return response;
 }
@@ -1540,8 +2049,7 @@ async function boardControl(args) {
     && data?.result?.ok !== false;
   const logResult = await recordMcpToolEvent("dbttool", {
     client: "codex",
-    mode: "local_ai",
-    server_model_used: false,
+    mode: "ide_plugin",
     success,
     duration_ms: Date.now() - startedAt,
     local_device_id: localDeviceId,
@@ -1549,7 +2057,7 @@ async function boardControl(args) {
     output_summary: asString(summary).slice(0, 240)
   });
   if (boolValue(args.include_raw)) {
-    return { ...response, usage: { mode: "local_ai_mcp_tool", server_model_used: false, input_tokens: 0, output_tokens: 0, local_device_id: localDeviceId || undefined, mcp_service_log: logResult } };
+    return { ...response, usage: { mode: "ide_plugin", input_tokens: 0, output_tokens: 0, local_device_id: localDeviceId || undefined, mcp_service_log: logResult } };
   }
   return response;
 }
@@ -1660,8 +2168,10 @@ function compactRp2350CapabilitiesResult(response) {
   return compactObject({
     ok: response?.ok !== false && response?.response?.ok !== false,
     capability_id: data.capability_id || "rp2350.monitor.capabilities",
-    summary_for_user: result.summary_for_user,
-    preferred_mcp_tools: Array.isArray(result.preferred_mcp_tools) ? result.preferred_mcp_tools : undefined,
+    summary_for_user: "RP2350/Pico2 monitor capabilities are exposed as an engineering capability catalog. Default IDE profiles should use embedlabs_action_schema, embedlabs_action_run, or embedlabs_chat with high-level actions such as capture_signal, debug_board, or flash_image.",
+    preferred_mcp_tools: ["embedlabs_action_schema", "embedlabs_action_run", "embedlabs_chat"],
+    preferred_agent_actions: ["capture_signal", "debug_board", "flash_image"],
+    engineering_fallback_tools: ["dbttool", "dbt_rp2350_* full-profile tools"],
     operation_table,
     transport_contract: result.transport_contract,
     pin_model: compactObject({
@@ -1672,7 +2182,7 @@ function compactRp2350CapabilitiesResult(response) {
     }),
     example_loopback_profiles: Array.isArray(result.example_loopback_profiles) ? result.example_loopback_profiles : undefined,
     unsupported: Array.isArray(result.unsupported) ? result.unsupported : undefined,
-    guidance: "In the default compact MCP profile, call RP2350 actions through dbttool, for example action=rp2350-spi-transfer, rp2350-logic-capture, or rp2350-logic-decode with arguments_json. In full engineering profile these actions may also appear as dbt_rp2350_* tools. For closed-loop capture, put stimulus in the logic-capture action and decode with logic-decode. Do not search the workspace, create Pico SDK/CMake projects, write firmware source, search web pages, or scrape the Monitor UI for RP2350 Monitor hardware-control requests.",
+    guidance: "Normal RP2350/Pico Monitor requests should use embedlabs_action_schema/embedlabs_action_run or embedlabs_chat with the high-level capture_signal, debug_board, or flash_image actions. In compact/full engineering profiles only, dbttool can call rp2350-* actions such as rp2350-spi-transfer, rp2350-logic-capture, or rp2350-logic-decode after the high-level Agent action cannot express the request or when validating a specific adapter. For closed-loop capture, prefer high-level capture_signal; lower-level logic-capture/decode is an engineering fallback. Do not search the workspace, create Pico SDK/CMake projects, write firmware source, search web pages, or scrape the Monitor UI for RP2350 Monitor hardware-control requests.",
     raw_omitted: true
   });
 }
@@ -1698,7 +2208,53 @@ async function rp2350I2cTransfer(args) {
 }
 
 async function rp2350LogicCapture(args) {
-  return await rp2350MonitorTool("dbt_rp2350_logic_capture", "rp2350.monitor.logic.capture", args);
+  const input = normalizeRp2350Input(args);
+  const payload = compactObject({
+    board_id: asString(args.board_id || args.board) || "pico2w-rp2350-monitor",
+    local_device_id: asString(input.local_device_id || input.device_id || args.localDeviceId || args.deviceId || args.device),
+    host: asString(input.host),
+    port: input.port,
+    monitor_bridge_url: asString(input.monitor_bridge_url || args.monitorBridgeUrl),
+    serial_path: asString(input.serial_path || args.serialPath),
+    pin_base: input.pin_base,
+    pin_count: input.pin_count,
+    sample_rate: input.sample_rate,
+    samples: input.samples,
+    output_path: asString(input.output_path || args.outputPath),
+    pull: asString(input.pull),
+    wait_timeout_ms: input.wait_timeout_ms,
+    read_timeout_ms: input.read_timeout_ms,
+    pre_samples: input.pre_samples,
+    post_samples: input.post_samples,
+    search_samples: input.search_samples,
+    trigger_pin: input.trigger_pin,
+    trigger_mode: asString(input.trigger_mode || args.triggerMode),
+    trigger_level: input.trigger_level,
+    trigger_mask: input.trigger_mask,
+    trigger_value: input.trigger_value,
+    channel_names: input.channel_names,
+    protocol: asString(input.protocol),
+    decoder: asString(input.decoder),
+    stimulus: input.stimulus,
+    approve: boolValue(args.approve) || boolValue(args.approved) || undefined
+  });
+  const routed = await agentActionRun({
+    action_id: "capture_signal",
+    arguments_json: JSON.stringify(payload),
+    include_raw: args.include_raw,
+    timeout_ms: args.timeout_ms
+  });
+  return {
+    ok: routed.ok,
+    compatibility_adapter: "dbt_rp2350_logic_capture_to_agent_capture_signal",
+    agent_action: "capture_signal",
+    execution: routed.execution,
+    capture: routed.execution?.tool_results?.[0],
+    decode: routed.execution?.tool_results?.[1],
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined,
+    guidance: "This compatibility tool now routes through the Native Agent capture_signal action. Provide explicit analyzer pins, sample rate, sample count, and approved=true before arming local hardware."
+  };
 }
 
 async function rp2350LogicDecode(args) {
@@ -1736,16 +2292,17 @@ async function recordMcpToolEvent(toolName, details) {
     const command = [
       "mcp", "log",
       "--tool", toolName,
-      "--client", details.client || "codex",
-      "--mode", details.mode || "local_ai",
-      "--server-model-used", details.server_model_used ? "true" : "false",
+      "--client", details.client || mcpClientName(),
+      "--mode", details.mode || "ide_plugin",
       "--success", details.success ? "true" : "false",
       "--request-id", requestId
     ];
     if (Number.isFinite(details.duration_ms)) command.push("--duration-ms", String(Math.max(0, Math.round(details.duration_ms))));
     if (asString(details.local_device_id)) command.push("--local-device-id", asString(details.local_device_id));
-    if (asString(details.input_summary)) command.push("--input-summary", asString(details.input_summary));
-    if (asString(details.output_summary)) command.push("--output-summary", asString(details.output_summary));
+    const inputSummary = summarizePublicText(details.input_summary);
+    const outputSummary = summarizePublicText(details.output_summary);
+    if (inputSummary) command.push("--input-summary", inputSummary);
+    if (outputSummary) command.push("--output-summary", outputSummary);
     const response = await runEmbed(command);
     return { recorded: response?.response?.ok === true, event_id: response?.response?.data?.event_id };
   } catch (error) {
@@ -1753,6 +2310,11 @@ async function recordMcpToolEvent(toolName, details) {
   }
 }
 
+function mcpClientName() {
+  const value = String(process.env.EMBED_MCP_CLIENT || "").trim().toLowerCase();
+  return value || "codex";
+}
+
 function compactMcpLogError(error) {
   const message = error instanceof Error ? error.message : String(error);
   try {
@@ -1936,21 +2498,6 @@ function filteredRp2350Locators(locators) {
   return filtered.length > 0 ? filtered : undefined;
 }
 
-async function updateLogo(args) {
-  const logoPath = asString(args.logo_path || args.logo);
-  if (!logoPath) throw new Error("logo_path is required");
-  const command = ["build", "image", "boot-logo", "--logo", logoPath];
-  pushOptional(command, "account", args.account_id || args.account);
-  pushOptional(command, "project", args.project_id || args.project);
-  pushOptional(command, "board", args.board_id || args.board || "taishanpi");
-  pushOptional(command, "variant", args.variant_id || args.variant);
-  pushOptional(command, "kernel-logo", args.kernel_logo_path || args.kernel_logo);
-  pushOptional(command, "output", args.output_path || args.output);
-  pushOptional(command, "rotate", args.rotate);
-  pushOptional(command, "scale", args.scale);
-  return await runEmbed(command);
-}
-
 async function composeBootLogo(args) {
   const packagePath = asString(args.package_path || args.package);
   const baseImagePath = asString(args.base_image_path || args.base_image);
@@ -2416,75 +2963,15 @@ async function localBootLogoCompose(args, sdk, logoPath, outputDir, outputImageP
 }
 
 async function bootLogoUpdate(args) {
-  const logoPath = asString(args.logo_path || args.logo);
-  if (!logoPath) throw new Error("logo_path is required");
-  if (!existsSync(logoPath)) {
-    return {
-      ok: false,
-      action: "boot_logo_update",
-      error: {
-        code: "logo_not_found",
-        message: `Logo image does not exist: ${logoPath}`
-      }
-    };
-  }
-
-  const boardId = asString(args.board_id || args.board) || "taishanpi-1m-rk3566";
-  const outputDir = defaultActionDir("boot-logo", args.output_dir || args.outputDir);
-  const outputImagePath = asString(args.output_image_path || args.outputImage || args.output)
-    || path.join(outputDir, "boot-logo-boot.img");
-  const manifestPath = asString(args.manifest_path || args.manifest) || path.join(outputDir, "boot-logo-compose-manifest.json");
-  const sdk = await ensureLocalToolchain(args, boardId, "images");
-  if (!sdk.releaseRoot) {
-    return {
-      ok: false,
-      action: "boot_logo_update",
-      error: {
-        code: "local_sdk_missing",
-        message: "本机没有可用的 TaishanPi images SDK，无法本地生成启动 Logo 镜像。"
-      },
-      sdk: compactSdkState(sdk.sdkCheck, sdk.sdkInstall)
-    };
-  }
-  const composeSummary = await localBootLogoCompose(args, sdk, logoPath, outputDir, outputImagePath, manifestPath);
-  if (!composeSummary.ok) {
-    return {
-      ok: false,
-      action: "boot_logo_update",
-      error: composeSummary.error,
-      sdk: compactSdkState(sdk.sdkCheck, sdk.sdkInstall),
-      output_dir: outputDir
-    };
-  }
-  const approved = boolValue(args.approved) || boolValue(args.approve);
-  const readyForFlash = composeSummary.ready_for_flash === true;
-  const result = {
-    ok: readyForFlash,
-    action: "boot_logo_update",
-    board: "TaishanPi 1M RK3566",
-    status: readyForFlash ? (approved ? "composed_ready_for_flash" : "ready_for_approval") : "composed_not_flashable",
-    approved,
-    summary_for_user: readyForFlash
-      ? "启动 Logo 已在本机完成格式转换、resource.img 重打包和 boot.img 镜像生成。需要真实写入开发板时，应继续走受控的本地刷写入口。"
-      : "启动 Logo 本地生成未完成，不能直接作为刷写产物。",
-    sdk: compactSdkState(sdk.sdkCheck, sdk.sdkInstall),
-    artifacts: compactObject({
-      logo_path: logoPath,
-      base_image_path: composeSummary.base_image_path,
-      output_image_path: outputImagePath,
-      output_resource_path: composeSummary.output_resource_path,
-      manifest_path: manifestPath
-    }),
-    compose: composeSummary,
-    next_step: readyForFlash
-      ? "如果用户明确批准写入开发板，后续应由同一高层工具调用 Local Bridge 的受控 boot 分区刷写能力，不能让模型手动拼命令。"
-      : "需要修复本地 SDK 图像转换或 resource 重打包工具后再刷写。",
-    raw_omitted: boolValue(args.include_raw) ? undefined : true
+  const routed = await flashImageCompatibilityAction(args, {
+    artifactKind: "boot_logo",
+    defaultBoardId: "taishanpi-1m-rk3566",
+    compatibilityAdapter: "dbt_boot_logo_update_to_agent_flash_image"
+  });
+  return {
+    ...routed,
+    guidance: "This compatibility tool now routes through the Native Agent flash_image action with artifact_kind=boot_logo. The Agent owns local logo conversion, resource.img repack, boot.img patching, and approved Local Bridge flashing."
   };
-  if (boolValue(args.include_raw)) {
-    result.raw = compactObject({ compose_result: composeSummary });
-  }
-  return result;
 }
 
 function shellQuote(value) {
@@ -2524,6 +3011,42 @@ function qtRuntimeCommand(remotePath) {
   ].join(" && ");
 }
 
+function remotePathBase(remotePath) {
+  const value = asString(remotePath).replace(/\/+$/, "");
+  return value ? path.posix.basename(value) : "";
+}
+
+function resolveTaishanQtDeployPaths(args, artifactPath) {
+  const artifactName = path.basename(artifactPath);
+  const remoteFile = asString(args.remote_file || args.remoteFile);
+  if (remoteFile) {
+    return { remoteFile, expectedRemotePath: remoteFile };
+  }
+  const remoteDir = asString(args.remote_dir || args.remoteDir);
+  if (remoteDir) {
+    return {
+      remoteDir,
+      expectedRemotePath: `${remoteDir.replace(/\/+$/, "")}/${artifactName}`
+    };
+  }
+  const remotePath = asString(args.remote_path || args.remotePath);
+  if (!remotePath) {
+    const defaultRemoteDir = "/userdata/embed-labs/apps";
+    return {
+      remoteDir: defaultRemoteDir,
+      expectedRemotePath: `${defaultRemoteDir}/${artifactName}`
+    };
+  }
+  if (remotePath.endsWith("/") || remotePathBase(remotePath) !== artifactName) {
+    const normalizedDir = remotePath.replace(/\/+$/, "");
+    return {
+      remoteDir: normalizedDir,
+      expectedRemotePath: `${normalizedDir}/${artifactName}`
+    };
+  }
+  return { remoteFile: remotePath, expectedRemotePath: remotePath };
+}
+
 function artifactPathFromBuild(buildResult) {
   const data = responseData(buildResult) || {};
   return asString(data.artifact_path || data.artifactPath || data.output_path || data.executable_path);
@@ -2541,109 +3064,40 @@ function taishanpiHostFromDeviceList(scanResult) {
 }
 
 async function taishanpiQtAppWorkflow(args) {
-  const request = asString(args.request || args.prompt);
-  const boardId = "taishanpi-1m-rk3566";
-  const selected = defaultQtExampleForRequest(request);
-  const outputDir = defaultActionDir("qt-app", args.output_dir || args.outputDir);
-  const explicitSource = asString(args.source_path || args.source);
-  let sourcePath = explicitSource || selected.sourcePath;
-  const projectDir = asString(args.project_dir || args.projectDir);
-  if (!explicitSource && projectDir && selected.sourcePath) {
-    mkdirSync(path.dirname(projectDir), { recursive: true });
-    cpSync(selected.sourcePath, projectDir, { recursive: true, force: true });
-    sourcePath = projectDir;
-  }
-  if (!sourcePath && selected.template !== "qt_smoke") {
-    return {
-      ok: false,
-      action: "taishanpi_qt_app_workflow",
-      error: {
-        code: "qt_template_not_found",
-        message: "未找到匹配需求的官方 Qt 示例模板。",
-        remediation: "请在包含 board-packs 的 Embed Labs 项目目录中运行，或传入 source_path 指向已有 Qt/CMake 工程。"
-      },
-      template: selected.template
-    };
-  }
-  const targetName = asString(args.target_name || args.targetName) || selected.targetName;
-  const buildDir = asString(args.build_dir || args.buildDir) || path.join(outputDir, targetName || "qt-app-build");
-
-  const sdk = await ensureLocalToolchain(args, boardId, "qt");
-  const buildArgs = { build_dir: buildDir, target_name: targetName, release_root: sdk.releaseRoot };
-  if (sourcePath) buildArgs.source_path = sourcePath;
-  const buildResult = await localQtSmoke(buildArgs);
-  const artifactPath = artifactPathFromBuild(buildResult);
-
-  let deployResult;
-  const approved = boolValue(args.approved) || boolValue(args.approve);
-  const shouldDeploy = boolValue(args.deploy) || boolValue(args.run);
-  if (shouldDeploy && approved) {
-    const scan = await runEmbed(["device", "list"]);
-    const host = asString(args.host) || taishanpiHostFromDeviceList(scan);
-    if (!host) {
-      deployResult = {
-        ok: false,
-        error: {
-          code: "runtime_host_not_found",
-          message: "Qt 程序已完成交叉编译，但当前未检测到可通过 SSH 部署的泰山派运行态主机。",
-          remediation: "确认泰山派已启动初始化系统并连接到当前电脑/网络后，再调用同一工具部署。"
-        }
-      };
-    } else if (!artifactPath) {
-      deployResult = {
-        ok: false,
-        error: {
-          code: "artifact_not_found",
-          message: "Qt 构建没有返回可部署的可执行文件路径。"
-        }
-      };
-    } else {
-      const remotePath = asString(args.remote_path || args.remotePath)
-        || `/userdata/embed-labs/apps/${path.basename(artifactPath)}`;
-      const command = ["deploy", "taishanpi", "--host", host, "--artifact", artifactPath, "--remote-path", remotePath, "--approve"];
-      if (boolValue(args.run)) {
-        command.push("--run", "--run-command", qtRuntimeCommand(remotePath));
-      }
-      deployResult = await runEmbed(command);
-    }
-  }
-
-  const buildData = responseData(buildResult) || {};
-  const deployData = responseData(deployResult) || {};
-  const result = {
-    ok: buildResult?.response?.ok === true && (!deployResult || deployResult?.response?.ok === true || deployResult?.ok === false),
-    action: "taishanpi_qt_app_workflow",
-    board: "TaishanPi 1M RK3566",
-    status: deployResult ? (deployResult?.response?.ok === true ? "built_and_deployed" : "built_deploy_pending") : "built",
-    template: selected.template,
-    request: request || undefined,
-    sdk: compactSdkState(sdk.sdkCheck, sdk.sdkInstall),
-    source_path: sourcePath || "built-in Qt smoke source",
-    build: compactObject({
-      build_dir: buildDir,
-      target_name: targetName,
-      artifact_path: artifactPath,
-      artifact_size_bytes: buildData.artifact_size_bytes,
-      artifact_sha256: buildData.artifact_sha256,
-      summary_for_user: buildData.summary_for_user
-    }),
-    deploy: deployResult ? compactObject({
-      ok: deployResult?.response?.ok ?? deployResult?.ok,
-      host: deployData.host,
-      remote_path: deployData.remote_path,
-      ran: deployData.ran,
-      error: deployResult?.error || deployResult?.response?.error
-    }) : undefined,
-    summary_for_user: deployResult?.response?.ok === true
-      ? "Qt 程序已按泰山派 Qt 运行库路径完成构建、部署并启动。"
-      : "Qt 程序已通过本机 LLVM/Qt 工具链完成交叉编译。",
-    next_step: deployResult ? "查看部署/运行结果；如需协议采集，再调用 RP2350 Monitor 的对应高层工具。" : "如需上板运行，用户批准后用同一工具传入 deploy=true、run=true、approved=true。",
-    raw_omitted: boolValue(args.include_raw) ? undefined : true
+  const payload = compactObject({
+    board_id: asString(args.board_id || args.board) || "taishanpi-1m-rk3566",
+    local_device_id: asString(args.local_device_id || args.localDeviceId || args.device_id || args.deviceId || args.device),
+    host: asString(args.host),
+    user: asString(args.user),
+    artifact_path: asString(args.artifact_path || args.artifact || args.output_path || args.output),
+    remote_path: asString(args.remote_path || args.remotePath),
+    remote_dir: asString(args.remote_dir || args.remoteDir),
+    remote_file: asString(args.remote_file || args.remoteFile),
+    wrapper_script: asString(args.wrapper_script || args.run_script || args.wrapperScript || args.runScript),
+    run_script: asString(args.run_script || args.runScript),
+    run_command: asString(args.run_command || args.runCommand),
+    run: boolValue(args.run) || undefined,
+    approve: boolValue(args.approve) || boolValue(args.approved) || undefined,
+    release_root: asString(args.release_root || args.releaseRoot),
+    profile: asString(args.profile || args.build_profile || args.buildProfile),
+    query: asString(args.request || args.prompt || args.description)
+  });
+  const routed = await agentActionRun({
+    action_id: "deploy_app",
+    arguments_json: JSON.stringify(payload),
+    include_raw: args.include_raw,
+    timeout_ms: args.timeout_ms
+  });
+  return {
+    ok: routed.ok,
+    compatibility_adapter: "dbt_taishanpi_qt_app_workflow_to_agent_deploy_app",
+    agent_action: "deploy_app",
+    execution: routed.execution,
+    deploy: routed.execution?.deploy,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined,
+    guidance: "This compatibility tool now routes through the Native Agent deploy_app action. Use build_project first when a local artifact has not been built yet; deploy_app owns target resolution, remote path semantics, wrapper execution, and approved Local Bridge deployment."
   };
-  if (boolValue(args.include_raw)) {
-    result.raw = compactObject({ build_result: buildResult, deploy_result: deployResult });
-  }
-  return result;
 }
 
 async function localToolchainLatest(args) {
@@ -2678,25 +3132,98 @@ async function localToolchainCurrent(args) {
   return await runEmbed(command);
 }
 
+function compactLocalToolchainInstallResult(result) {
+  const data = responseData(result) || {};
+  const source = data.source && typeof data.source === "object" ? data.source : {};
+  const validation = data.validation && typeof data.validation === "object" ? data.validation : {};
+  const packages = Array.isArray(data.packages) ? data.packages : [];
+  const sourceComponents = Array.isArray(source.components) ? source.components : [];
+  return {
+    ok: result?.response?.ok ?? result?.ok ?? true,
+    board_id: data.board_id,
+    version: data.version,
+    channel: data.channel,
+    mode: data.mode,
+    install_root: data.install_root,
+    release_root: data.release_root,
+    source: compactObject({
+      kind: source.kind,
+      mirror_kind: source.mirror_kind,
+      component_count: sourceComponents.length || undefined
+    }),
+    packages: packages.map((item) => compactObject({
+      package_id: item.package_id || item.id,
+      version: item.version,
+      kind: item.kind
+    })).slice(0, 8),
+    installed_paths: Array.isArray(data.installed_paths) ? data.installed_paths.slice(0, 12) : undefined,
+    removed_old_versions: data.removed_old_versions,
+    validation: compactObject({
+      ok: validation.ok,
+      mode: validation.mode,
+      missing_groups: validation.missing_groups,
+      path_leaks: validation.path_leaks?.length ? validation.path_leaks.length : undefined,
+      summary_for_user: validation.summary_for_user
+    }),
+    summary_for_user: validation.summary_for_user || `Local toolchain ${data.board_id || ""} ${data.version || ""} installed.`,
+    raw_omitted: true
+  };
+}
+
 async function localToolchainInstall(args) {
-  const command = ["local", "toolchain", "install"];
-  pushOptional(command, "board", args.board_id || args.board);
-  pushOptional(command, "channel", args.channel);
-  pushOptional(command, "metadata-root", args.metadata_root || args.metadataRoot);
-  pushOptional(command, "source-url", args.source_url || args.sourceUrl);
-  pushOptional(command, "source-release-root", args.source_release_root || args.sourceReleaseRoot);
-  pushOptional(command, "install-root", args.install_root || args.installRoot);
-  pushOptional(command, "mode", args.mode);
-  if (boolValue(args.force)) command.push("--force");
-  return await runEmbed(command);
+  const payload = compactObject({
+    operation: boolValue(args.update) ? "update" : "install",
+    board_id: asString(args.board_id || args.board),
+    channel: asString(args.channel),
+    metadata_root: asString(args.metadata_root || args.metadataRoot),
+    source_url: asString(args.source_url || args.sourceUrl),
+    source_release_root: asString(args.source_release_root || args.sourceReleaseRoot),
+    install_root: asString(args.install_root || args.installRoot),
+    mode: asString(args.mode),
+    force: boolValue(args.force) || undefined
+  });
+  const routed = await agentActionRun({
+    action_id: "install_toolchain",
+    arguments_json: JSON.stringify(payload),
+    include_raw: args.include_raw
+  });
+  return {
+    ok: routed.ok,
+    compatibility_adapter: "dbt_local_toolchain_install_to_agent_install_toolchain",
+    agent_action: "install_toolchain",
+    operation: payload.operation,
+    execution: routed.execution,
+    toolchain: routed.execution?.toolchain,
+    toolchain_operation: routed.execution?.toolchain_operation,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined,
+    guidance: "This compatibility tool now routes through the local EmbedLabs Agent install_toolchain action. Prefer embedlabs_chat for natural-language SDK requests or embedlabs_action_run for explicit action calls."
+  };
 }
 
 async function localToolchainUninstall(args) {
   const boardId = asString(args.board_id || args.board);
   if (!boardId) throw new Error("board_id is required");
-  const command = ["local", "toolchain", "uninstall", "--board", boardId];
-  pushOptional(command, "install-root", args.install_root || args.installRoot);
-  return await runEmbed(command);
+  const routed = await agentActionRun({
+    action_id: "install_toolchain",
+    arguments_json: JSON.stringify(compactObject({
+      operation: "uninstall",
+      board_id: boardId,
+      install_root: asString(args.install_root || args.installRoot)
+    })),
+    include_raw: args.include_raw
+  });
+  return {
+    ok: routed.ok,
+    compatibility_adapter: "dbt_local_toolchain_uninstall_to_agent_install_toolchain",
+    agent_action: "install_toolchain",
+    operation: "uninstall",
+    execution: routed.execution,
+    toolchain_operation: routed.execution?.toolchain_operation,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined,
+    guidance: "This compatibility tool now routes through the local EmbedLabs Agent install_toolchain action with operation=uninstall."
+  };
 }
 
 async function localToolchainValidate(args) {
@@ -2715,21 +3242,33 @@ function compactLocalToolchainValidationResult(result) {
   const missing = Array.isArray(data.missing_paths) ? data.missing_paths : [];
   const pathLeaks = Array.isArray(data.path_leaks) ? data.path_leaks : [];
   const notes = Array.isArray(data.notes) ? data.notes.map(summarizePublicText).filter(Boolean).slice(0, 10) : [];
+  const repairCommand = data.ok === true
+    ? undefined
+    : compactObject({
+        action_id: "install_toolchain",
+        operation: "install",
+        board_id: data.board_id,
+        mode: data.mode,
+        command: `embedlabs agent action run install_toolchain --operation install${data.board_id ? ` --board-id ${data.board_id}` : ""}${data.mode ? ` --mode ${data.mode}` : ""} --json`
+      });
   return compactObject({
     ok: data.ok === true,
     board_id: data.board_id,
     mode: data.mode,
+    release_root: data.release_root,
     host: data.host,
     summary_for_user: data.summary_for_user,
     missing_groups: Array.isArray(data.missing_groups) ? data.missing_groups : undefined,
-    repair_command: data.repair_command,
+    repair_command: repairCommand?.command,
+    repair_agent_action: repairCommand,
+    original_repair_command_omitted: Boolean(data.repair_command),
     checked_count: checked.length,
     missing_count: missing.length,
     path_leaks_count: pathLeaks.length,
     notes,
     guidance: data.ok === true
       ? "Summarize this as ready. Do not print checked_paths or internal registry/source paths unless the user asks for raw diagnostics."
-      : "Read summary_for_user, missing_groups, and repair_command. If the user wants to proceed with this workflow, call dbt_local_toolchain_install with the same board_id and mode.",
+      : "Read summary_for_user and missing_groups, then repair through embedlabs_action_run with action_id=install_toolchain and operation=install/update. dbt_local_toolchain_install is retained only for compact/full engineering validation.",
     raw_omitted: true
   });
 }
@@ -2745,46 +3284,58 @@ function isRp2350InitialTarget(value) {
 }
 
 async function initialImageFlash(args) {
-  const requestedBoard = asString(args.board_id || args.board);
-  if (isRp2350InitialTarget(requestedBoard)) {
-    return await rp2350InitialFirmwareFlash(args);
-  }
-  if (isTaishanpiInitialTarget(requestedBoard)) {
-    return await taishanpiInitialImageFlash(args);
-  }
-
-  const scan = await runEmbed(["device", "list"]);
-  const scanData = responseData(scan) || {};
-  const devices = Array.isArray(scanData.development_boards) ? scanData.development_boards : [];
-  const candidates = devices
-    .filter((item) => item?.board_id === "taishanpi" || isRp2350Device(item))
-    .map((item) => compactObject({
-      local_device_id: item.local_device_id || item.device_id,
-      board_id: item.board_id,
-      variant_id: item.variant_id,
-      display_name: item.display_name || item.name,
-      status: item.status
-    }));
-
-  if (candidates.length === 1) {
-    const candidate = candidates[0];
-    const nextArgs = { ...args, local_device_id: args.local_device_id || candidate.local_device_id };
-    if (candidate.board_id === "taishanpi") return await taishanpiInitialImageFlash(nextArgs);
-    return await rp2350InitialFirmwareFlash({ ...nextArgs, board_id: candidate.variant_id || candidate.board_id });
-  }
+  return await flashImageCompatibilityAction(args, {
+    artifactKind: "initial",
+    compatibilityAdapter: "dbt_initial_image_flash_to_agent_flash_image"
+  });
+}
 
+function flashImageCompatibilityPayload(args, artifactKind, defaultBoardId) {
+  return compactObject({
+    board_id: asString(args.board_id || args.board) || defaultBoardId,
+    local_device_id: asString(args.local_device_id || args.localDeviceId || args.device_id || args.deviceId || args.device),
+    host: asString(args.host),
+    user: asString(args.user),
+    artifact_kind: artifactKind,
+    artifact_path: asString(args.artifact_path || args.artifact),
+    image_dir: asString(args.image_dir || args.imageDir),
+    channel: asString(args.channel),
+    metadata_root: asString(args.metadata_root || args.metadataRoot),
+    source_url: asString(args.source_url || args.sourceUrl),
+    source_release_root: asString(args.source_release_root || args.sourceReleaseRoot),
+    install_root: asString(args.install_root || args.installRoot),
+    logo_path: asString(args.logo_path || args.logo),
+    kernel_logo_path: asString(args.kernel_logo_path || args.kernelLogo),
+    base_image_path: asString(args.base_image_path || args.baseImage),
+    output_image_path: asString(args.output_image_path || args.outputImage || args.output),
+    output_resource_path: asString(args.output_resource_path || args.outputResource),
+    target_volume: asString(args.target_volume || args.targetVolume || args.target_volume_path || args.targetVolumePath),
+    partition: asString(args.partition),
+    partitions: asString(args.partitions),
+    profile: asString(args.profile),
+    force: boolValue(args.force) || undefined,
+    approve: boolValue(args.approve) || boolValue(args.approved) || undefined
+  });
+}
+
+async function flashImageCompatibilityAction(args, options) {
+  const payload = flashImageCompatibilityPayload(args, options.artifactKind, options.defaultBoardId);
+  const routed = await agentActionRun({
+    action_id: "flash_image",
+    arguments_json: JSON.stringify(payload),
+    include_raw: args.include_raw,
+    timeout_ms: args.timeout_ms
+  });
   return {
-    ok: false,
-    error: {
-      code: candidates.length > 1 ? "ambiguous_board" : "target_not_found",
-      message: candidates.length > 1
-        ? "检测到多块可刷写开发板，请指定要刷写的开发板。"
-        : "当前未检测到可刷写初始化镜像的支持开发板。",
-      candidates,
-      remediation: candidates.length > 1
-        ? "重新调用 dbt_initial_image_flash，并传入对应 local_device_id。"
-        : "请连接开发板，或让开发板进入 Loader/Maskrom/BOOTSEL 后重新查询开发板状态。"
-    }
+    ok: routed.ok,
+    compatibility_adapter: options.compatibilityAdapter,
+    agent_action: "flash_image",
+    artifact_kind: payload.artifact_kind,
+    execution: routed.execution,
+    flash: routed.execution?.flash,
+    summary_for_user: routed.execution?.summary ?? routed.answer,
+    response: boolValue(args.include_raw) ? routed.response : undefined,
+    guidance: "This compatibility tool now routes through the Native Agent flash_image action. Review the plan and re-run with approved=true only after explicit user approval."
   };
 }
 
@@ -2906,110 +3457,19 @@ function compactInitialFlashResult({ boardLabel, sdkCheck, sdkInstall, imageDir,
 }
 
 async function taishanpiInitialImageFlash(args) {
-  const sdkBoardId = asString(args.board_id || args.board) || "taishanpi-1m-rk3566";
-  const explicitImageDir = asString(args.image_dir || args.imageDir);
-  let sdkCheck = null;
-  let sdkInstall = null;
-  let releaseRoot = "";
-  if (!explicitImageDir) {
-    sdkCheck = await localToolchainValidate({ board_id: sdkBoardId, mode: "images" });
-    const checkData = responseData(sdkCheck) || {};
-    if (checkData.ok) {
-      releaseRoot = asString(checkData.release_root);
-    } else {
-      const installArgs = {
-        board_id: sdkBoardId,
-        channel: args.channel,
-        metadata_root: args.metadata_root || args.metadataRoot,
-        install_root: args.install_root || args.installRoot,
-        mode: "images",
-        force: args.force
-      };
-      sdkInstall = await localToolchainInstall(installArgs);
-      const installedData = responseData(sdkInstall) || {};
-      releaseRoot = asString(installedData.release_root);
-    }
-  }
-  const imageDir = explicitImageDir || (releaseRoot ? path.join(releaseRoot, "images", "current") : "");
-  const localDeviceId = asString(args.local_device_id || args.localDeviceId || args.device_id || args.deviceId);
-  const planCommand = ["flash", "plan", "--board", "taishanpi"];
-  if (imageDir) pushOptional(planCommand, "image-dir", imageDir);
-  if (localDeviceId) pushOptional(planCommand, "local-device-id", localDeviceId);
-  const plan = await runEmbed(planCommand);
-  const approved = boolValue(args.approved) || boolValue(args.approve);
-  if (!approved) {
-    return compactInitialFlashResult({
-      boardLabel: "TaishanPi 1M RK3566",
-      sdkCheck,
-      sdkInstall,
-      imageDir,
-      plan,
-      approved,
-      includeRaw: boolValue(args.include_raw)
-    });
-  }
-  const runCommand = ["flash", "run", "--board", "taishanpi", "--approve"];
-  if (imageDir) pushOptional(runCommand, "image-dir", imageDir);
-  if (localDeviceId) pushOptional(runCommand, "local-device-id", localDeviceId);
-  const flashed = await runEmbed(runCommand);
-  const wait = args.wait === undefined ? true : boolValue(args.wait);
-  const jobId = localJobIdFromRun(flashed);
-  const finalStatus = wait && jobId ? await waitForLocalJob(jobId, Number(args.timeout_ms) || 180000) : undefined;
-  return compactInitialFlashResult({
-    boardLabel: "TaishanPi 1M RK3566",
-    sdkCheck,
-    sdkInstall,
-    imageDir,
-    plan,
-    runResult: flashed,
-    finalStatus,
-    approved,
-    includeRaw: boolValue(args.include_raw)
+  return await flashImageCompatibilityAction(args, {
+    artifactKind: "initial_image",
+    defaultBoardId: "taishanpi-1m-rk3566",
+    compatibilityAdapter: "dbt_taishanpi_initial_image_flash_to_agent_flash_image"
   });
 }
 
 async function rp2350MonitorFirmwareFlash(args) {
-  const boardId = asString(args.board_id || args.board) || "pico2w-rp2350-monitor";
-  const installArgs = {
-    board_id: boardId,
-    channel: args.channel,
-    metadata_root: args.metadata_root || args.metadataRoot,
-    install_root: args.install_root || args.installRoot,
-    mode: "firmware",
-    force: args.force
-  };
-  const installed = await localToolchainInstall(installArgs);
-  const installedData = responseData(installed) || {};
-  const releaseRoot = asString(installedData.release_root);
-  const artifactPath = asString(args.artifact_path || args.artifact)
-    || (releaseRoot ? path.join(releaseRoot, "toolkit-runtime", "rp2350-monitor", "firmware", "rp2350_monitor.uf2") : "");
-  if (!artifactPath) {
-    throw new Error("RP2350 Monitor firmware UF2 could not be resolved after local toolchain install.");
-  }
-  const plan = await runEmbed(["flash", "plan", "--board", "rp2350", "--artifact", artifactPath]);
-  const approved = boolValue(args.approved) || boolValue(args.approve);
-  if (!approved) {
-    const planData = responseData(plan) || plan;
-    const automaticBootsel = !!planData.automatic_bootsel
-      || (Array.isArray(planData.steps) && planData.steps.some((step) => step && step.kind === "picotool_load_force_usb"));
-    return {
-      ok: true,
-      firmware_install: installed,
-      artifact_path: artifactPath,
-      flash_plan: plan,
-      next_step: automaticBootsel
-        ? "Flash plan is ready. After user approval, call this tool again with approved=true."
-        : "Flash plan needs a visible UF2 target volume before it can run."
-    };
-  }
-  const flashed = await runEmbed(["flash", "run", "--board", "rp2350", "--artifact", artifactPath, "--approve"]);
-  return {
-    ok: true,
-    firmware_install: installed,
-    artifact_path: artifactPath,
-    flash_plan: plan,
-    flash_result: flashed
-  };
+  return await flashImageCompatibilityAction(args, {
+    artifactKind: "monitor_firmware",
+    defaultBoardId: "pico2w-rp2350-monitor",
+    compatibilityAdapter: "dbt_rp2350_monitor_firmware_flash_to_agent_flash_image"
+  });
 }
 
 function rp2350InitialFirmwarePath(boardId, releaseRoot) {
@@ -3019,46 +3479,11 @@ function rp2350InitialFirmwarePath(boardId, releaseRoot) {
 }
 
 async function rp2350InitialFirmwareFlash(args) {
-  const boardId = asString(args.board_id || args.board) || "pico2w-rp2350-monitor";
-  const installArgs = {
-    board_id: boardId,
-    channel: args.channel,
-    metadata_root: args.metadata_root || args.metadataRoot,
-    install_root: args.install_root || args.installRoot,
-    mode: "firmware",
-    force: args.force
-  };
-  const installed = await localToolchainInstall(installArgs);
-  const installedData = responseData(installed) || {};
-  const releaseRoot = asString(installedData.release_root);
-  const artifactPath = asString(args.artifact_path || args.artifact) || rp2350InitialFirmwarePath(boardId, releaseRoot);
-  if (!artifactPath) {
-    throw new Error("RP2350 initialization firmware UF2 could not be resolved after local toolchain install.");
-  }
-  const plan = await runEmbed(["flash", "plan", "--board", "rp2350", "--artifact", artifactPath]);
-  const approved = boolValue(args.approved) || boolValue(args.approve);
-  if (!approved) {
-    const planData = responseData(plan) || plan;
-    const automaticBootsel = !!planData.automatic_bootsel
-      || (Array.isArray(planData.steps) && planData.steps.some((step) => step && step.kind === "picotool_load_force_usb"));
-    return {
-      ok: true,
-      firmware_install: installed,
-      artifact_path: artifactPath,
-      flash_plan: plan,
-      next_step: automaticBootsel
-        ? "Initialization flash plan is ready. After user approval, call this tool again with approved=true."
-        : "Initialization flash plan needs a visible UF2 target volume before it can run."
-    };
-  }
-  const flashed = await runEmbed(["flash", "run", "--board", "rp2350", "--artifact", artifactPath, "--approve"]);
-  return {
-    ok: true,
-    firmware_install: installed,
-    artifact_path: artifactPath,
-    flash_plan: plan,
-    flash_result: flashed
-  };
+  return await flashImageCompatibilityAction(args, {
+    artifactKind: "initial_firmware",
+    defaultBoardId: "pico2w-rp2350-monitor",
+    compatibilityAdapter: "dbt_rp2350_initial_firmware_flash_to_agent_flash_image"
+  });
 }
 
 async function pluginUpdateCheck(args) {
@@ -3068,7 +3493,7 @@ async function pluginUpdateCheck(args) {
   pushOptional(command, "codex-target", args.codex_target || args.codexTarget);
   pushOptional(command, "opencode-target", args.opencode_target || args.opencodeTarget);
   pushOptional(command, "trae-target", args.trae_target || args.traeTarget);
-  return await runEmbed(command);
+  return sanitizeMcpPublicValue(await runEmbed(command));
 }
 
 async function pluginUpdate(args) {
@@ -3082,7 +3507,7 @@ async function pluginUpdate(args) {
   pushOptional(command, "codex-target", args.codex_target || args.codexTarget);
   pushOptional(command, "opencode-target", args.opencode_target || args.opencodeTarget);
   pushOptional(command, "trae-target", args.trae_target || args.traeTarget);
-  return await runEmbed(command);
+  return sanitizeMcpPublicValue(await runEmbed(command));
 }
 
 async function localCompile(args) {
@@ -3091,7 +3516,6 @@ async function localCompile(args) {
   if (!sourcePath) throw new Error("source_path is required");
   if (!outputPath) throw new Error("output_path is required");
   const command = ["local", "compile", "taishanpi", "--source", sourcePath, "--output", outputPath];
-  pushOptional(command, "account", args.account_id || args.account);
   pushOptional(command, "release-root", args.release_root || args.releaseRoot);
   return await runEmbed(command);
 }
@@ -3100,240 +3524,30 @@ async function localQtSmoke(args) {
   const buildDir = asString(args.build_dir || args.buildDir);
   if (!buildDir) throw new Error("build_dir is required");
   const command = ["local", "build", "qt-smoke", "--build-dir", buildDir];
-  pushOptional(command, "account", args.account_id || args.account);
   pushOptional(command, "source", args.source_path || args.source);
   pushOptional(command, "target-name", args.target_name || args.targetName);
   pushOptional(command, "release-root", args.release_root || args.releaseRoot);
   return await runEmbed(command);
 }
 
-function serverWorkspaceDisabledResult() {
-  return {
-    ok: false,
-    error: {
-      code: "server_workspaces_disabled",
-      message: "Embed Labs now uses the user's local SDK/toolchain environment for source edits, builds, and board operation. Server-side user workspaces, Docker builds, and image generation are not exposed by the plugin.",
-      remediation: "Use dbt_local_toolchain_install, dbt_local_toolchain_validate, dbt_local_compile, dbt_local_qt_smoke, and Local Bridge board tools. Cloud API remains available for account login, device binding, board knowledge, plugin releases, MCP service logs, and SDK downloads."
-    }
-  };
-}
-
-function isServerWorkspaceToolName(name) {
-  return [
-    "dbt_workspace_provision",
-    "dbt_application_generate",
-    "dbt_source_list",
-    "dbt_source_get",
-    "dbt_source_search",
-    "dbt_source_put",
-    "dbt_source_patch",
-    "dbt_application_compile",
-    "dbt_image_generate",
-    "dbt_workspace_release"
-  ].includes(name);
-}
-
-function isServerWorkspaceAction(action) {
-  return [
-    "provision",
-    "workspace-provision",
-    "source-list",
-    "list-source",
-    "source-get",
-    "source-read",
-    "read-source",
-    "source-search",
-    "search-source",
-    "source-put",
-    "source-write",
-    "write-source",
-    "source-patch",
-    "patch-source",
-    "app",
-    "application",
-    "application-generate",
-    "build-run",
-    "compile",
-    "application-compile",
-    "image",
-    "image-generate",
-    "release",
-    "workspace-release"
-  ].includes(action);
-}
-
-async function workspaceProvision(args) {
-  const account = asString(args.account_id || args.account);
-  const project = asString(args.project_id || args.project);
-  if (!account) throw new Error("account_id is required");
-  if (!project) throw new Error("project_id is required");
-  const command = [
-    "build",
-    "workspace",
-    "provision",
-    "--account",
-    account,
-    "--project",
-    project,
-    "--template",
-    asString(args.template_id || args.template) || DEFAULT_TEMPLATE_ID,
-    "--copy-mode",
-    asString(args.copy_mode) || "skeleton"
-  ];
-  if (boolValue(args.dry_run)) command.push("--dry-run");
-  return await runEmbed(command);
-}
-
-async function applicationGenerate(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  const prompt = asString(args.prompt || args.request);
-  if (!workspace) throw new Error("workspace_id is required");
-  if (!prompt) throw new Error("prompt is required");
-  const command = ["build", "application", "generate", "--workspace", workspace, "--prompt", prompt];
-  pushOptional(command, "account", args.account_id || args.account);
-  pushOptional(command, "provider", args.provider);
-  pushOptional(command, "model", args.model);
-  pushOptional(command, "target", args.target);
-  const generated = await runEmbed(command);
-  if (!asString(args.download_output)) return generated;
-  const artifact = pickArtifact(generated, "firmware");
-  if (!artifact?.artifact_id) throw new Error("No downloadable application artifact found");
-  const downloaded = await runEmbed(["artifact", "download", artifact.artifact_id, "--output", args.download_output]);
-  return { generated, selected_artifact: artifact, downloaded };
-}
-
-async function sourceList(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  if (!workspace) throw new Error("workspace_id is required");
-  return await runEmbed(["build", "workspace", "source", "list", workspace]);
-}
-
-async function sourceGet(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  const sourcePath = asString(args.source_path || args.path);
-  if (!workspace) throw new Error("workspace_id is required");
-  if (!sourcePath) throw new Error("source_path is required");
-  const command = ["build", "workspace", "source", "get", workspace, "--path", sourcePath];
-  pushOptional(command, "output", args.output_path || args.output);
-  return await runEmbed(command);
-}
-
-async function sourceSearch(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  if (!workspace) throw new Error("workspace_id is required");
-  const command = ["build", "workspace", "source", "search", workspace];
-  pushOptional(command, "query", args.query);
-  pushOptional(command, "glob", args.glob);
-  pushOptional(command, "limit", args.limit);
-  return await runEmbed(command);
-}
-
-async function sourcePut(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  const localPath = asString(args.local_path || args.local);
-  const sourcePath = asString(args.source_path || args.path);
-  if (!workspace) throw new Error("workspace_id is required");
-  if (!localPath) throw new Error("local_path is required");
-  if (!sourcePath) throw new Error("source_path is required");
-  const command = ["build", "workspace", "source", "put", workspace, "--file", `${localPath}:${sourcePath}`];
-  pushOptional(command, "account", args.account_id || args.account);
-  return await runEmbed(command);
-}
-
-async function sourcePatch(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  const patchPath = asString(args.patch_path || args.patch);
-  if (!workspace) throw new Error("workspace_id is required");
-  if (!patchPath) throw new Error("patch_path is required");
-  const command = ["build", "workspace", "source", "patch", workspace, "--patch", patchPath];
-  pushOptional(command, "account", args.account_id || args.account);
-  return await runEmbed(command);
-}
-
-async function applicationCompile(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  if (!workspace) throw new Error("workspace_id is required");
-  const command = ["build", "application", "compile", "--workspace", workspace];
-  pushOptional(command, "account", args.account_id || args.account);
-  pushOptional(command, "source", args.source_path || args.source);
-  pushOptional(command, "output-name", args.output_name);
-  pushOptional(command, "execution-mode", args.execution_mode);
-  pushOptional(command, "compiler", args.compiler);
-  return await runEmbed(command);
-}
-
-async function taskStatus(args) {
-  const task = asString(args.task_id || args.task);
-  if (!task) throw new Error("task_id is required");
-  return await runEmbed(["cloud", "task", "status", task]);
-}
-
-function safeArtifactOutputFileName(name) {
-  return asString(name).replace(/[^A-Za-z0-9._-]+/g, "_") || "task.log";
-}
-
-async function taskLogDownload(args) {
-  const task = asString(args.task_id || args.task);
-  if (!task) throw new Error("task_id is required");
-  const status = await taskStatus({ task_id: task });
-  const data = responseData(status);
-  const artifacts = Array.isArray(data?.artifacts) ? data.artifacts : [];
-  const log = artifacts.find((item) => item.kind === "log" || asString(item.name).endsWith(".log"));
-  if (!log?.artifact_id) throw new Error(`Task ${task} does not expose a log artifact`);
-  const output = asString(args.output_path || args.output) || path.join(".embed-labs", "artifacts", `${task}-${safeArtifactOutputFileName(log.name)}`);
-  const downloaded = await runEmbed(["artifact", "download", log.artifact_id, "--output", output]);
-  return { status, selected_artifact: log, downloaded };
-}
-
-async function imageGenerate(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  const prompt = asString(args.prompt || args.request);
-  if (!workspace) throw new Error("workspace_id is required");
-  if (!prompt) throw new Error("prompt is required");
-  const command = ["build", "image", "generate", "--workspace", workspace, "--prompt", prompt];
-  pushOptional(command, "account", args.account_id || args.account);
-  pushOptional(command, "provider", args.provider);
-  pushOptional(command, "model", args.model);
-  pushOptional(command, "image-profile", args.image_profile);
-  pushOptional(command, "execution-mode", args.execution_mode);
-  pushOptional(command, "worker-pool", args.worker_pool);
-  const generated = await runEmbed(command);
-  if (!asString(args.download_output)) return generated;
-  const artifact = pickArtifact(generated, "image");
-  if (!artifact?.artifact_id) throw new Error("No downloadable image artifact found");
-  const downloaded = await runEmbed(["artifact", "download", artifact.artifact_id, "--output", args.download_output]);
-  return { generated, selected_artifact: artifact, downloaded };
-}
-
-async function artifactDownload(args) {
-  const artifact = asString(args.artifact_id || args.artifact);
-  const output = asString(args.output_path || args.output);
-  if (!artifact) throw new Error("artifact_id is required");
-  if (!output) throw new Error("output_path is required");
-  return await runEmbed(["artifact", "download", artifact, "--output", output]);
-}
-
-async function workspaceRelease(args) {
-  const workspace = asString(args.workspace_id || args.workspace);
-  if (!workspace) throw new Error("workspace_id is required");
-  const command = ["build", "workspace", "release", workspace];
-  if (boolValue(args.dry_run)) command.push("--dry-run");
-  if (boolValue(args.no_settle_storage)) command.push("--no-settle-storage");
-  return await runEmbed(command);
-}
-
 async function callTool(name, args = {}) {
-  if (name === "dbt_auth_status") return await pluginAuthStatus();
+  const requestedName = name;
+  if (mcpToolProfile() === "agent" && AGENT_MCP_TOOL_ALIASES.has(requestedName)) {
+    args = sanitizeAgentProfileArgs(args);
+  }
+  name = canonicalMcpToolName(name);
+  if (name === "dbt_agent_status") return await pluginAgentStatus();
+  if (name === "dbt_agent_action_schema") return await agentActionSchema(args);
+  if (name === "dbt_agent_action_run") return await agentActionRun(args);
+  if (name === "dbt_agent_chat") return await agentChat(args);
   if (name === "dbt_plugin_update_check") return await pluginUpdateCheck(args);
   if (name === "dbt_plugin_update") return await pluginUpdate(args);
+  if (name === "dbt_current_board_status") return await currentBoardStatus(args);
   if (name === "dbt_supported_boards") return await supportedBoards(args);
   if (name === "dbt_local_toolchain_list") return await localToolchainList(args);
   if (name === "dbt_local_toolchain_installed") return await localToolchainInstalled(args);
   if (name === "dbt_local_toolchain_latest") return await localToolchainLatest(args);
   if (name === "dbt_local_toolchain_current") return await localToolchainCurrent(args);
-  const authStatus = await pluginAuthStatus();
-  if (!authStatus.ok) return authStatus;
-  if (name === "dbt_current_board_status" || name === "dbtstatus") return await currentBoardStatus(args, authStatus);
   if (name === "dbt_initial_image_flash") return await initialImageFlash(args);
   if (name === "dbt_rp2350_monitor_status") return await rp2350MonitorStatus(args);
   if (name === "dbt_rp2350_capabilities") return await rp2350Capabilities(args);
@@ -3350,13 +3564,8 @@ async function callTool(name, args = {}) {
   if (name === "dbt_rp2350_monitor_command") return await rp2350MonitorCommand(args);
   if (name === "dbt_cloud_status") return await cloudStatus(args);
   if (name === "dbt_board_knowledge_search") return await boardKnowledgeSearch(args);
-  if (isServerWorkspaceToolName(name)) return serverWorkspaceDisabledResult();
-  if (name === "dbt_task_status") return await taskStatus(args);
-  if (name === "dbt_task_log_download") return await taskLogDownload(args);
-  if (name === "dbt_artifact_download") return await artifactDownload(args);
   if (name === "dbt_board_debug") return await boardDebug(args);
   if (name === "dbt_boot_logo_update") return await bootLogoUpdate(args);
-  if (name === "dbt_update_logo") return await updateLogo(args);
   if (name === "dbt_compose_boot_logo") return await composeBootLogo(args);
   if (name === "dbt_local_toolchain_install") return await localToolchainInstall(args);
   if (name === "dbt_local_toolchain_uninstall") return await localToolchainUninstall(args);
@@ -3374,8 +3583,10 @@ async function callTool(name, args = {}) {
     let payload = {};
     if (asString(args.arguments_json)) payload = JSON.parse(args.arguments_json);
     if (asString(args.request) && !payload.prompt) payload.prompt = asString(args.request);
+    if (["agent-action-schema", "action-schema", "agent-actions", "action-catalog"].includes(action)) return await agentActionSchema(payload);
+    if (["agent-action-run", "action-run", "agent-run-action", "run-action"].includes(action)) return await agentActionRun(payload);
     if (["supported-boards", "boards", "board-list", "registry-list"].includes(action)) return await supportedBoards(payload);
-    if (["board-status", "status"].includes(action)) return await currentBoardStatus(payload, authStatus);
+    if (["board-status", "status"].includes(action)) return await currentBoardStatus(payload);
     if (["board-reboot", "reboot", "restart", "device-reboot", "board-restart"].includes(action)) return await boardControl({ ...payload, operation: "reboot" });
     if (["board-bootloader", "bootloader", "loader", "enter-bootloader", "enter-loader", "bootsel"].includes(action)) return await boardControl({ ...payload, operation: "bootloader" });
     if (["image-flash", "flash-image", "image-update", "update-image", "board-image-flash", "board-image-update"].includes(action)) return await boardControl({ ...payload, operation: "image.flash" });
@@ -3412,10 +3623,6 @@ async function callTool(name, args = {}) {
     if (["local-compile", "compile-local"].includes(action)) return await localCompile(payload);
     if (["local-qt-smoke", "qt-smoke", "local-qt-build"].includes(action)) return await localQtSmoke(payload);
     if (["taishanpi-qt-app", "qt-app", "qt-workflow", "taishanpi-qt-workflow", "qt-develop"].includes(action)) return await taishanpiQtAppWorkflow(payload);
-    if (isServerWorkspaceAction(action)) return serverWorkspaceDisabledResult();
-    if (["task-status", "status-task"].includes(action)) return await taskStatus(payload);
-    if (["task-log", "task-log-download", "log-download"].includes(action)) return await taskLogDownload(payload);
-    if (["download", "artifact-download"].includes(action)) return await artifactDownload(payload);
     return { ok: false, error_code: "unsupported_dbt_action" };
   }
   throw new Error(`Unknown tool: ${name}`);
@@ -3458,7 +3665,17 @@ async function handleRpc(message) {
       let result;
       let toolCallFailed = false;
       try {
-        result = await callTool(message.params?.name, message.params?.arguments || {});
+        const toolName = asString(message.params?.name);
+        if (!isMcpToolExposed(toolName)) {
+          throw new Error(JSON.stringify({
+            error: {
+              code: "mcp_tool_not_exposed",
+              message: `${toolName || "requested tool"} is not exposed in the current EmbedLabs MCP tool profile.`,
+              remediation: "Use embedlabs_action_run/embedlabs_chat in the default Agent profile, or enable EMBEDLABS_MCP_TOOL_PROFILE=compact/full for compatibility testing."
+            }
+          }));
+        }
+        result = await callTool(toolName, message.params?.arguments || {});
         toolCallFailed = result?.ok === false
           || result?.response?.ok === false
           || result?.response?.data?.result?.ok === false