deveco-harness 0.1.0

package/dist/index.js

@@ -0,0 +1,758 @@
+// src/agents.ts
+import { readFileSync } from "node:fs";
+import path2 from "node:path";
+
+// src/plugin-root.ts
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function packageRoot(fromUrl = import.meta.url) {
+  let current = path.dirname(fileURLToPath(fromUrl));
+  while (true) {
+    if (existsSync(path.join(current, "package.json")))
+      return current;
+    const parent = path.dirname(current);
+    if (parent === current)
+      return path.dirname(fileURLToPath(fromUrl));
+    current = parent;
+  }
+}
+
+// src/agents.ts
+function readPrompt(name) {
+  return readFileSync(path2.join(packageRoot(), "prompts", name), "utf8");
+}
+var BUILD_PROMPT = readPrompt("build.txt");
+var PLAN_PROMPT = readPrompt("plan.txt");
+var MIGRATED_AGENT_OVERRIDES = {
+  build: {
+    mode: "primary",
+    description: "The default DevEco Code agent. Implements HarmonyOS changes and verifies them with DevEco tools.",
+    prompt: BUILD_PROMPT,
+    permission: {
+      question: "allow",
+      plan_enter: "ask",
+      plan_write: "deny",
+      verify_ui: "ask",
+      save_ui_screenshot: "ask",
+      get_ui_verification_log: "ask",
+      arkts_knowledge_search: "allow",
+      build_project: "allow",
+      check_ets_files: "allow",
+      start_app: "allow",
+      hdc_log: "allow",
+      switch_cwd: "allow"
+    }
+  },
+  plan: {
+    mode: "primary",
+    description: "Plan mode for ArkTS and HarmonyOS work. Disallows edits and execution tools.",
+    prompt: PLAN_PROMPT,
+    permission: {
+      question: "allow",
+      plan_exit: "ask",
+      plan_write: "allow",
+      bash: "deny",
+      build_project: "deny",
+      check_ets_files: "deny",
+      perform_ui_action: "deny",
+      get_app_ui_tree: "deny",
+      start_app: "deny",
+      hdc_log: "deny",
+      switch_cwd: "deny",
+      arkts_knowledge_search: "deny",
+      edit: "deny"
+    }
+  }
+};
+function mergeAgent(base, override) {
+  return {
+    ...base,
+    ...override,
+    permission: {
+      ...base.permission,
+      ...override?.permission
+    }
+  };
+}
+function applyAgentConfig(config, pluginConfig) {
+  const existing = config.agent ?? {};
+  const agents = { ...existing };
+  const overrides = pluginConfig.agents ?? {};
+  for (const [name, agent] of Object.entries(MIGRATED_AGENT_OVERRIDES)) {
+    agents[name] = mergeAgent(agent, overrides[name]);
+  }
+  for (const [name, agent] of Object.entries(overrides)) {
+    if (name in MIGRATED_AGENT_OVERRIDES)
+      continue;
+    agents[name] = agent;
+  }
+  config.agent = agents;
+}
+
+// src/config.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import os from "node:os";
+import path3 from "node:path";
+import { parse } from "jsonc-parser";
+var CONFIG_FILES = ["deveco-harness.jsonc", "deveco-harness.json"];
+function mergeConfig(base, next) {
+  return {
+    ...base,
+    ...next,
+    agents: {
+      ...base.agents,
+      ...next.agents
+    },
+    tools: {
+      ...base.tools,
+      ...next.tools
+    },
+    skills: {
+      ...base.skills,
+      ...next.skills,
+      paths: [...base.skills?.paths ?? [], ...next.skills?.paths ?? []]
+    }
+  };
+}
+function readConfigFile(file) {
+  const errors = [];
+  const value = parse(readFileSync2(file, "utf8"), errors, {
+    allowTrailingComma: true,
+    disallowComments: false
+  });
+  if (errors.length > 0) {
+    console.warn(`[deveco-harness] ignored invalid config ${file}: ${errors[0]?.error}`);
+    return {};
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return {};
+  return value;
+}
+function candidateFiles(directory) {
+  const globalDir = path3.join(os.homedir(), ".config", "opencode");
+  const projectDir = path3.join(directory, ".opencode");
+  return [
+    ...CONFIG_FILES.map((file) => path3.join(globalDir, file)),
+    ...CONFIG_FILES.map((file) => path3.join(directory, file)),
+    ...CONFIG_FILES.map((file) => path3.join(projectDir, file))
+  ];
+}
+function loadDevecoAgentConfig(directory) {
+  let result = {};
+  for (const file of candidateFiles(directory)) {
+    if (!existsSync2(file))
+      continue;
+    result = mergeConfig(result, readConfigFile(file));
+  }
+  return result;
+}
+function resolveConfigPath(input, directory) {
+  if (input.startsWith("~/"))
+    return path3.join(os.homedir(), input.slice(2));
+  if (path3.isAbsolute(input))
+    return input;
+  return path3.resolve(directory, input);
+}
+
+// src/skills.ts
+import { existsSync as existsSync3 } from "node:fs";
+import path4 from "node:path";
+function appendUnique(target, value) {
+  if (!target.includes(value))
+    target.push(value);
+}
+function applySkillConfig(hostConfig, pluginConfig, directory) {
+  if (pluginConfig.skills?.enabled === false)
+    return;
+  const skills = hostConfig.skills ?? {};
+  const paths = [...skills.paths ?? []];
+  const bundled = path4.join(packageRoot(), "skills");
+  if (existsSync3(bundled))
+    appendUnique(paths, bundled);
+  for (const item of pluginConfig.skills?.paths ?? []) {
+    appendUnique(paths, resolveConfigPath(item, directory));
+  }
+  hostConfig.skills = {
+    ...skills,
+    paths
+  };
+}
+
+// src/tool/arkts-check.ts
+import path6 from "node:path";
+import { tool } from "@opencode-ai/plugin";
+
+// src/tool/deveco-home.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import os2 from "node:os";
+import path5 from "node:path";
+function binary(name) {
+  return process.platform === "win32" ? `${name}.exe` : name;
+}
+function candidatesFrom(home) {
+  const normalized = home.trim();
+  if (!normalized)
+    return [];
+  const candidates = [normalized];
+  if (process.platform !== "win32" && path5.basename(normalized) !== "Contents") {
+    candidates.push(path5.join(normalized, "Contents"));
+  }
+  return candidates;
+}
+function defaults() {
+  if (process.platform === "darwin")
+    return ["/Applications/DevEco-Studio.app"];
+  if (process.platform === "linux") {
+    const home2 = os2.homedir();
+    return [path5.join(home2, "devecostudio"), path5.join(home2, "DevEco-Studio")];
+  }
+  const home = process.env.USERPROFILE || os2.homedir();
+  return [
+    "D:\\DevEco Studio",
+    "C:\\Program Files\\Huawei\\DevEco Studio",
+    "C:\\Program Files\\DevEco Studio",
+    "C:\\Program Files (x86)\\DevEco Studio",
+    path5.join(home, "DevEco Studio")
+  ];
+}
+function nodePath(home) {
+  return process.platform === "win32" ? path5.join(home, "tools", "node", "node.exe") : path5.join(home, "tools", "node", "bin", "node");
+}
+function hdcPath(home) {
+  return path5.join(home, "sdk", "default", "openharmony", "toolchains", binary("hdc"));
+}
+function productInfoPath(home) {
+  if (process.platform === "darwin")
+    return path5.join(home, "Resources", "product-info.json");
+  return path5.join(home, "product-info.json");
+}
+function hasDevEcoShape(home) {
+  return existsSync4(nodePath(home)) && existsSync4(productInfoPath(home));
+}
+function savedDevEcoHomeFile() {
+  return path5.join(os2.homedir(), ".local", "state", "opencode", "deveco-home.json");
+}
+function loadSavedDevEcoHome() {
+  try {
+    const data = JSON.parse(readFileSync3(savedDevEcoHomeFile(), "utf8"));
+    return typeof data.deveco_home === "string" ? data.deveco_home : undefined;
+  } catch {
+    return;
+  }
+}
+function findDevEcoHome() {
+  const raw = [
+    process.env.DEVECO_HOME,
+    loadSavedDevEcoHome(),
+    ...defaults()
+  ].filter((item) => typeof item === "string" && item.trim().length > 0);
+  for (const item of raw) {
+    for (const candidate of candidatesFrom(item)) {
+      if (hasDevEcoShape(candidate))
+        return candidate;
+    }
+  }
+}
+
+// src/tool/process.ts
+import { spawn } from "node:child_process";
+
+// src/tool/session-cwd.ts
+var sessionCwd = new Map;
+function setSessionCwd(sessionID, cwd) {
+  const id = sessionID.trim();
+  const dir = cwd.trim();
+  if (!id || !dir)
+    return;
+  sessionCwd.set(id, dir);
+}
+function getSessionCwd(sessionID) {
+  if (!sessionID)
+    return;
+  return sessionCwd.get(sessionID);
+}
+
+// src/tool/process.ts
+function contextDirectory(context) {
+  return getSessionCwd(context.sessionID) ?? context.directory;
+}
+function runCommand(command, args, cwd, signal, env = process.env) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, {
+      cwd,
+      env,
+      windowsHide: true
+    });
+    let stdout = "";
+    let stderr = "";
+    const abort = () => child.kill();
+    if (signal.aborted)
+      abort();
+    signal.addEventListener("abort", abort, { once: true });
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (error) => {
+      signal.removeEventListener("abort", abort);
+      resolve({
+        code: 1,
+        stdout,
+        stderr: `${stderr}${stderr ? `
+` : ""}${error.message}`
+      });
+    });
+    child.on("close", (code) => {
+      signal.removeEventListener("abort", abort);
+      resolve({ code, stdout, stderr });
+    });
+  });
+}
+
+// src/tool/arkts-check.ts
+function createArktsCheckTool() {
+  return tool({
+    description: "Run ArkTS strict-mode static syntax/type check on .ets files. " + "Detects compiler-level violations such as `arkts-no-standalone-this`, `arkts-no-obj-literals-as-types`, and other ArkTS spec issues. " + "Returns structured diagnostics by file, line, column, and rule. " + "Call this after writing or editing any .ets file, before running build_project — catches most ArkTS errors faster than a full build. " + "Do NOT call for non-.ets source files, or when DevEco Studio is not installed locally.",
+    args: {
+      files: tool.schema.array(tool.schema.string()).optional().nullable().describe("Specific .ets files to check (absolute paths or paths relative to project root). " + "If omitted, all .ets files under entry/src/main/ets are checked.")
+    },
+    async execute(args, context) {
+      const projectPath = contextDirectory(context);
+      await context.ask({
+        permission: "arkts_check",
+        patterns: ["arkts_check"],
+        always: [],
+        metadata: { project: projectPath }
+      });
+      const home = findDevEcoHome();
+      if (!home) {
+        throw new Error("DevEco Studio not found. Set the DEVECO_HOME environment variable and retry.");
+      }
+      const node = nodePath(home);
+      const script = path6.join(import.meta.dirname, "arkts-check.cjs");
+      const cmdArgs = ["--project", projectPath];
+      if (args.files?.length) {
+        cmdArgs.push("--files", ...args.files);
+      }
+      const result = await runCommand(node, [script, ...cmdArgs], contextDirectory(context), context.abort);
+      let parsed;
+      try {
+        parsed = JSON.parse(result.stdout);
+      } catch {
+        throw new Error(`arkts-check script returned unexpected output.
+stdout: ${result.stdout}
+stderr: ${result.stderr}`);
+      }
+      if (parsed.error) {
+        throw new Error(`arkts-check: ${parsed.error}`);
+      }
+      const { errors, summary } = parsed;
+      const lines = [
+        `ArkTS check complete: ${summary.errorCount} error(s), ${summary.warnCount} warning(s)`
+      ];
+      if (errors.length > 0) {
+        lines.push("");
+        for (const d of errors) {
+          const loc = `${d.file}:${d.line}:${d.column}`;
+          const rule = d.rule ? ` (${d.rule})` : "";
+          lines.push(`${d.severity.toUpperCase()}  ${loc}  ${d.message}${rule}`);
+        }
+      }
+      return {
+        title: parsed.success ? "ArkTS Check Passed" : `ArkTS Check Failed: ${summary.errorCount} error(s)`,
+        output: lines.join(`
+`),
+        metadata: {
+          errorCount: summary.errorCount,
+          warnCount: summary.warnCount,
+          success: parsed.success
+        }
+      };
+    }
+  });
+}
+
+// src/tool/arkts-knowledge.ts
+import { tool as tool2 } from "@opencode-ai/plugin";
+var BASE_URL = "https://cn.devecostudio.huawei.com/codeGenie/bigSearch";
+var MAX_RESULT_LENGTH = 5 * 1024;
+var KNOWLEDGE_TOOL_ID = "arkts_knowledge_search";
+function getDevEcoAccessToken() {
+  return process.env.DEVECO_OAUTH_TOKEN;
+}
+function createArktsKnowledgeTool() {
+  return tool2({
+    description: "Search the official ArkTS / ArkUI / HarmonyOS / OpenHarmony knowledge base. MUST call this tool before answering questions about .ets code, ArkUI decorators or lifecycle, state refresh issues, HarmonyOS SDK APIs, DevEco/hvigor build errors, @kit.* or @ohos.* APIs, or HarmonyOS documentation URLs. For code snippets or URLs, extract the key symbols, APIs, errors, and observed symptom as the question.",
+    args: {
+      question: tool2.schema.string().describe("A concise ArkTS/ArkUI/HarmonyOS/OpenHarmony question. Include key symbols, APIs, decorators, lifecycle names, build errors, symptoms, or URL-derived keywords.")
+    },
+    async execute(args, context) {
+      await context.ask({
+        permission: KNOWLEDGE_TOOL_ID,
+        patterns: [args.question],
+        always: ["*"],
+        metadata: {}
+      });
+      const accessToken = getDevEcoAccessToken();
+      if (!accessToken) {
+        throw new Error("Authorization fail: Please authorize to proceed.");
+      }
+      const response = await fetch(BASE_URL, {
+        method: "POST",
+        headers: {
+          Authorization: accessToken,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ question: args.question })
+      });
+      const data = await response.json();
+      if ("code" in data && data.code === 200) {
+        if (data.body?.answer?.prompt) {
+          const mark = "【检索信息】：";
+          const prompt = data.body.answer.prompt;
+          const index = prompt.indexOf(mark);
+          if (index != -1) {
+            const result = prompt.substring(index + mark.length);
+            const truncatedResult = result.slice(0, MAX_RESULT_LENGTH);
+            return {
+              title: "HarmonyOS knowledge Search",
+              output: truncatedResult,
+              metadata: {}
+            };
+          }
+        }
+        return {
+          title: "HarmonyOS knowledge Search",
+          output: "No answer found for question",
+          metadata: {}
+        };
+      }
+      if ("error_code" in data) {
+        if (data.error_code === 4016) {
+          throw new Error("Authorization fail: Please authorize to proceed.");
+        }
+        throw new Error(`Service error: ${data.error_msg || "Unknown error"}`);
+      }
+      throw new Error("Unknown response format from knowledge service");
+    }
+  });
+}
+
+// src/tool/harmony-tools.ts
+import { tool as tool3 } from "@opencode-ai/plugin";
+
+// src/tool/harmony-bridge.ts
+import { createRequire } from "node:module";
+import { mkdirSync } from "node:fs";
+import os3 from "node:os";
+import path7 from "node:path";
+var bridge;
+var bound = "";
+var gate = Promise.resolve();
+function loadBridge() {
+  if (bridge)
+    return bridge;
+  try {
+    bridge = createRequire(import.meta.url)("@deveco-codegenie/mcp-bridge");
+    return bridge;
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`@deveco-codegenie/mcp-bridge is not available: ${detail}`);
+  }
+}
+function bridgeLogDir() {
+  const base = process.env.XDG_DATA_HOME || path7.join(os3.homedir(), ".local", "share", "deveco");
+  const dir = path7.join(base, "log", "deveco-mcp");
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+async function ensureInitialized(worktree) {
+  gate = gate.then(async () => {
+    if (bound === worktree)
+      return;
+    const home = findDevEcoHome();
+    if (!home)
+      throw new Error("DevEco Studio not found. Please set DEVECO_HOME to your DevEco installation directory.");
+    await loadBridge().init(bridgeLogDir(), worktree, home, process.env.UI_VERIFY_BASE_URL ?? null, process.env.UI_VERIFY_API_KEY ?? null, process.env.UI_VERIFY_MODEL_NAME ?? null);
+    bound = worktree;
+  });
+  await gate;
+}
+async function callHarmonyTool(worktree, toolName, args) {
+  await ensureInitialized(worktree);
+  const raw = await loadBridge().callTool(toolName, JSON.stringify(args));
+  return JSON.parse(raw);
+}
+
+// src/tool/harmony-tools.ts
+function formatBridgeResult(name, result) {
+  if (typeof result === "string")
+    return result;
+  return JSON.stringify(result, null, 2);
+}
+function harmonyTool(name, definition) {
+  return tool3({
+    description: definition.description,
+    args: definition.args,
+    async execute(args, context) {
+      await context.ask({
+        permission: name,
+        patterns: [name],
+        always: [],
+        metadata: { tool: name }
+      });
+      const result = await callHarmonyTool(contextDirectory(context), name, args);
+      return {
+        title: name,
+        output: formatBridgeResult(name, result),
+        metadata: { tool: name }
+      };
+    }
+  });
+}
+function createHarmonyTools() {
+  return {
+    build_project: harmonyTool("build_project", {
+      description: "执行编译构建导出构建产物。支持构建整个 APP 或特定模块（HAP/HSP/HAR）。当需要重新构建或清理项目缓存时请将 clean 参数设为 true，这将在构建前执行清理clean。",
+      args: {
+        build_mode: tool3.schema.string().optional().nullable().describe("构建模式，值为 build-profile.json5 中 buildModeSet 定义的模式的 name 字段（如内置的 'debug'、'release'，或用户自定义的模式名称）。如果不传，默认为 'debug'。"),
+        clean: tool3.schema.boolean().optional().nullable().describe("是否在构建前执行 clean 清理构建产物（类似 cargo clean或者mvn clean）。如果为 true，则会先执行清理然后再进行构建。"),
+        enable_inspector_source_jump: tool3.schema.boolean().optional().nullable().describe("支持hap包运行后，从获取到UI树json文件中精准对应到源码位置。"),
+        log_path: tool3.schema.string().optional().nullable().describe("构建日志保存路径：若指定，则将所有的构建日志保存到该路径下。日志文件使用后记得清理"),
+        module: tool3.schema.string().optional().nullable().describe("指定的模块及 Target（如 'entry@default'，或省略 @target 构建该模块所有 target）。如果不传，则视为构建整个 APP。"),
+        product: tool3.schema.string().optional().nullable().describe("指定的 Product 名称（仅在构建整个 APP 时有效）")
+      }
+    }),
+    start_app: harmonyTool("start_app", {
+      description: "在模拟器/真机上运行应用（不主动构建）。设备列表包含已连接的真机、模拟器以及已安装但未运行的模拟器。选择未运行的模拟器时会自动启动。",
+      args: {
+        ability: tool3.schema.string().optional().nullable().describe("要启动的 Ability 名称（如 'EntryAbility'）。如果不指定，默认使用 'EntryAbility'。"),
+        hvd: tool3.schema.string().optional().nullable().describe("目标设备的名称或 ID（支持真机或模拟器）。如果不提供，系统将列出所有可用设备供选择。"),
+        module: tool3.schema.string().optional().nullable().describe("要启动的模块名称（如 'entry'）。如果不指定，默认使用 'entry'。"),
+        target: tool3.schema.string().optional().nullable().describe("构建目标（如 'default'）。如果不指定，默认使用 'default'。")
+      }
+    }),
+    verify_ui: harmonyTool("verify_ui", {
+      description: "在提供自然语言描述的功能步骤之后，本工具可以在HarmonyOS设备上运行应用，执行UI操作，验证功能是否可以正确完成。",
+      args: {
+        bundleName: tool3.schema.string().optional().nullable().describe("待测试的应用包名，不填写时自动从项目中获取"),
+        device: tool3.schema.string().optional().nullable().describe("接受设备名称（支持子串匹配）或序列号（例如 127.0.0.1:5555）；仅连接一台设备时自动选中，多设备环境下必须指定。"),
+        freshStart: tool3.schema.boolean().default(false).describe("是否在测试前重新启动应用"),
+        testPlan: tool3.schema.string().describe("自然语言描述的测试用例计划，包括每步的步骤以及预期结果")
+      }
+    }),
+    save_ui_screenshot: harmonyTool("save_ui_screenshot", {
+      description: "根据校验ID保存某次校验的每一步截图，返回截图文件名列表",
+      args: {
+        id: tool3.schema.string().describe("verify_ui 工具返回的校验任务 ID"),
+        dirname: tool3.schema.string().describe("截图保存目录，必须为绝对路径")
+      }
+    }),
+    get_ui_verification_log: harmonyTool("get_ui_verification_log", {
+      description: "根据校验ID获取对应的设备运行日志",
+      args: {
+        id: tool3.schema.string().describe("校验ID"),
+        maxLogSize: tool3.schema.number().int().optional().nullable().describe("可选的日志总字符数限制：默认为5000字符；传-1代表不限制字符数"),
+        searchKeywords: tool3.schema.string().optional().nullable().describe("可选的日志搜索关键词。若需要获取完整日志内容，请传空字符串。")
+      }
+    })
+  };
+}
+
+// src/tool/hdc-log.ts
+import { tool as tool4 } from "@opencode-ai/plugin";
+function pick(input, prefix, lines) {
+  const list = input.split(/\r?\n/).map((item) => item.trim()).filter(Boolean);
+  const filtered = prefix ? list.filter((item) => item.includes(prefix)) : list;
+  return filtered.slice(Math.max(0, filtered.length - lines));
+}
+function target(device) {
+  return device ? ["-t", device] : [];
+}
+async function runHdc(args, context) {
+  const home = findDevEcoHome();
+  if (!home)
+    throw new Error("DevEco Studio path not found. Set DEVECO_HOME and retry.");
+  const hdc = hdcPath(home);
+  const result = await runCommand(hdc, args, contextDirectory(context), context.abort);
+  if (result.code !== 0) {
+    throw new Error(`hdc ${args.join(" ")} failed (code=${result.code}): ${result.stderr || result.stdout}`);
+  }
+  return result.stdout;
+}
+function createHdcLogTool() {
+  return tool4({
+    description: "Collect, clear, or list HarmonyOS device logs via hdc shell hilog.",
+    args: {
+      action: tool4.schema.enum(["collect", "clear", "list_devices"]).describe("Action to perform"),
+      device_id: tool4.schema.string().optional().describe("Optional hdc target id"),
+      log_prefix: tool4.schema.string().default("[VCODER_DEBUG]").describe("Log prefix to filter"),
+      lines: tool4.schema.number().int().min(1).max(5000).default(2000).describe("Number of log lines to collect")
+    },
+    async execute(args, context) {
+      await context.ask({
+        permission: "hdc_log",
+        patterns: [args.action],
+        always: [],
+        metadata: { action: args.action, device: args.device_id }
+      });
+      if (args.action === "list_devices") {
+        const stdout2 = await runHdc(["list", "targets"], context);
+        const devices = stdout2.split(/\r?\n/).map((item) => item.trim()).filter((item) => item && !item.includes("[Empty]"));
+        return {
+          title: devices.length ? "Connected Devices" : "No Devices",
+          output: devices.length ? ["Connected devices:", ...devices.map((item, i) => `${i + 1}. ${item}`)].join(`
+`) : "No connected devices detected.",
+          metadata: { deviceCount: devices.length }
+        };
+      }
+      if (args.action === "clear") {
+        await runHdc([...target(args.device_id), "shell", "hilog", "-r"], context);
+        return {
+          title: "Log Buffer Cleared",
+          output: ["Device log buffer cleared.", `device: ${args.device_id || "default"}`].join(`
+`),
+          metadata: {}
+        };
+      }
+      const stdout = await runHdc([...target(args.device_id), "shell", "hilog", "-x"], context);
+      const logs = pick(stdout, args.log_prefix ?? "", args.lines ?? 2000);
+      if (!logs.length) {
+        return {
+          title: "No Matching Logs",
+          output: [
+            "No matching logs found.",
+            `device: ${args.device_id || "default"}`,
+            `prefix: ${args.log_prefix}`
+          ].join(`
+`),
+          metadata: { lineCount: 0 }
+        };
+      }
+      return {
+        title: "Log Collection Successful",
+        output: [
+          "Log collection successful.",
+          `device: ${args.device_id || "default"}`,
+          `prefix: ${args.log_prefix}`,
+          `count: ${logs.length}`,
+          "",
+          "--- Log Content ---",
+          ...logs
+        ].join(`
+`),
+        metadata: { lineCount: logs.length }
+      };
+    }
+  });
+}
+
+// src/tool/plan-write.ts
+import { mkdir, writeFile } from "node:fs/promises";
+import path8 from "node:path";
+import { tool as tool5 } from "@opencode-ai/plugin";
+function createPlanWriteTool() {
+  return tool5({
+    description: "Write the full plan file content, including YAML frontmatter and markdown body.",
+    args: {
+      content: tool5.schema.string().describe("The full plan file content, including YAML frontmatter and markdown body.")
+    },
+    async execute(args, context) {
+      await context.ask({
+        permission: "plan_write",
+        patterns: [".opencode/plans/*"],
+        always: [],
+        metadata: {}
+      });
+      const planDir = path8.join(context.directory, ".opencode", "plans");
+      const planPath = path8.join(planDir, `${context.sessionID}.md`);
+      await mkdir(planDir, { recursive: true });
+      await writeFile(planPath, args.content, "utf8");
+      return {
+        title: "Plan Written",
+        output: `Plan written to ${planPath}`,
+        metadata: { path: planPath }
+      };
+    }
+  });
+}
+
+// src/tool/switch-cwd.ts
+import { realpathSync, statSync } from "node:fs";
+import path9 from "node:path";
+import { tool as tool6 } from "@opencode-ai/plugin";
+function resolveTarget(projectPath, base) {
+  const trimmed = projectPath.trim();
+  if (!trimmed)
+    throw new Error("project_path must not be empty");
+  if (path9.isAbsolute(trimmed))
+    return path9.normalize(trimmed);
+  return path9.resolve(base, trimmed);
+}
+function createSwitchCwdTool() {
+  return tool6({
+    description: "Switch the active HarmonyOS project context before running build_project or start_app.",
+    args: {
+      project_path: tool6.schema.string().describe("Target project directory path. Relative path is resolved from the current workspace directory.")
+    },
+    async execute(args, context) {
+      const target2 = realpathSync(resolveTarget(args.project_path, context.directory));
+      const stat = statSync(target2);
+      if (!stat.isDirectory())
+        throw new Error(`Not a directory or not found: ${target2}`);
+      await context.ask({
+        permission: "switch_cwd",
+        patterns: [target2],
+        always: [],
+        metadata: { target: target2 }
+      });
+      setSessionCwd(context.sessionID, target2);
+      return {
+        title: "Switch project context",
+        output: `Session directory updated to ${target2}.`,
+        metadata: { project_path: target2 }
+      };
+    }
+  });
+}
+
+// src/tool/index.ts
+function createTools(config) {
+  const tools = {
+    ...createHarmonyTools(),
+    arkts_check: createArktsCheckTool(),
+    hdc_log: createHdcLogTool(),
+    switch_cwd: createSwitchCwdTool(),
+    plan_write: createPlanWriteTool()
+  };
+  if (getDevEcoAccessToken()) {
+    tools.arkts_knowledge_search = createArktsKnowledgeTool();
+  }
+  return tools;
+}
+// src/create-plugin-module.ts
+function createPluginModule() {
+  return {
+    id: "deveco-harness",
+    server: async (input) => {
+      const pluginConfig = loadDevecoAgentConfig(input.directory);
+      return {
+        tool: createTools(pluginConfig),
+        config: async (hostConfig) => {
+          applyAgentConfig(hostConfig, pluginConfig);
+          applySkillConfig(hostConfig, pluginConfig, input.directory);
+        }
+      };
+    }
+  };
+}
+
+// src/index.ts
+var pluginModule = createPluginModule();
+var src_default = pluginModule;
+export {
+  src_default as default
+};