dsh-multigameassistant 0.0.0-stage → 2.0.0

package/lib/analyzer.js

@@ -0,0 +1,765 @@
+import { createRequire as __adgCreateRequire } from 'node:module'; import { dirname as __adgDirname } from 'node:path'; import { fileURLToPath as __adgFileURLToPath } from 'node:url'; const require = __adgCreateRequire(import.meta.url); const __filename = __adgFileURLToPath(import.meta.url); const __dirname = __adgDirname(__filename);
+import {
+  probeProject
+} from "./chunk-KIAOFNCB.js";
+import {
+  MANIFEST_FILE,
+  SKILL_FILE,
+  parseManifest,
+  require_dist
+} from "./chunk-7XMNAHZ2.js";
+import {
+  PACKS_CAPABILITY,
+  ScriptId,
+  external_exports
+} from "./chunk-BL6OSR2I.js";
+import {
+  __toESM
+} from "./chunk-2UFLGPDY.js";
+
+// packages/analyzer/lib/index.js
+import { execFile } from "node:child_process";
+import { readFile as readFile4 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+import { TextDecoder } from "node:util";
+import { Service } from "@deepseek-ai/cordis";
+
+// packages/analyzer/lib/analyze.js
+import { readdir, readFile as readFile2, stat } from "node:fs/promises";
+import { extname, join as join2, relative } from "node:path";
+
+// packages/analyzer/lib/jsonc.js
+function stripJsonc(source) {
+  let out = "";
+  let i = 0;
+  let inString = false;
+  while (i < source.length) {
+    const c = source[i];
+    const next = source[i + 1];
+    if (inString) {
+      out += c;
+      if (c === "\\" && next !== void 0) {
+        out += next;
+        i += 2;
+        continue;
+      }
+      if (c === '"')
+        inString = false;
+      i += 1;
+      continue;
+    }
+    if (c === '"') {
+      inString = true;
+      out += c;
+      i += 1;
+      continue;
+    }
+    if (c === "/" && next === "/") {
+      while (i < source.length && source[i] !== "\n")
+        i += 1;
+      continue;
+    }
+    if (c === "/" && next === "*") {
+      const end = source.indexOf("*/", i + 2);
+      i = end < 0 ? source.length : end + 2;
+      continue;
+    }
+    out += c;
+    i += 1;
+  }
+  return removeTrailingCommas(out);
+}
+function removeTrailingCommas(text) {
+  let out = "";
+  let inString = false;
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    if (inString) {
+      out += c;
+      if (c === "\\")
+        out += text[++i] ?? "";
+      else if (c === '"')
+        inString = false;
+      continue;
+    }
+    if (c === '"')
+      inString = true;
+    if (c === ",") {
+      let j = i + 1;
+      while (j < text.length && /\s/.test(text[j]))
+        j++;
+      if (text[j] === "}" || text[j] === "]")
+        continue;
+    }
+    out += c;
+  }
+  return out;
+}
+function parseJsonc(source) {
+  return JSON.parse(stripJsonc(source.replace(/^/, "")));
+}
+
+// packages/analyzer/lib/maafw.js
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+async function readInterface(file) {
+  const root = dirname(file);
+  const problems = [];
+  const load = async (path) => {
+    try {
+      return parseJsonc(await readFile(path, "utf8"));
+    } catch (error) {
+      problems.push(`${path}: ${error instanceof Error ? error.message : String(error)}`);
+      return void 0;
+    }
+  };
+  const main = await load(file);
+  if (main === void 0)
+    return { controllers: [], tasks: [], problems };
+  const rawTasks = [];
+  const options = {};
+  const collect = (doc) => {
+    for (const task of asArray(doc["task"]))
+      if (isObject(task))
+        rawTasks.push(task);
+    if (isObject(doc["option"]))
+      Object.assign(options, doc["option"]);
+  };
+  collect(main);
+  for (const rel of asArray(main["import"]).filter((v) => typeof v === "string")) {
+    const doc = await load(join(root, rel));
+    if (doc !== void 0)
+      collect(doc);
+  }
+  const locale = await localeOf(main, root);
+  const text = (value) => {
+    if (typeof value !== "string")
+      return void 0;
+    if (!value.startsWith("$"))
+      return value;
+    const resolved = locale?.[value.slice(1)];
+    return typeof resolved === "string" ? resolved : void 0;
+  };
+  const controllers = asArray(main["controller"]).filter(isObject).map((c) => {
+    const win32 = isObject(c["win32"]) ? c["win32"] : {};
+    const label = text(c["label"]);
+    return {
+      name: String(c["name"] ?? ""),
+      type: String(c["type"] ?? ""),
+      ...label === void 0 ? {} : { label },
+      ...typeof win32["mouse"] === "string" ? { mouse: win32["mouse"] } : {},
+      ...typeof win32["keyboard"] === "string" ? { keyboard: win32["keyboard"] } : {}
+    };
+  });
+  const tasks = rawTasks.map((t) => {
+    const label = text(t["label"]);
+    const description = text(t["description"]);
+    return {
+      name: String(t["name"] ?? ""),
+      ...label === void 0 ? {} : { label },
+      ...description === void 0 ? {} : { description: description.slice(0, 300) },
+      ...typeof t["entry"] === "string" ? { entry: t["entry"] } : {},
+      ...Array.isArray(t["controller"]) ? { controllers: t["controller"].map(String) } : {},
+      options: asArray(t["option"]).filter((o) => typeof o === "string").map((name) => {
+        const spec = options[name] ?? {};
+        const optionLabel = text(spec["label"]);
+        const cases = asArray(spec["cases"]).filter(isObject).map((c) => String(c["name"] ?? ""));
+        return { name, ...optionLabel === void 0 ? {} : { label: optionLabel }, ...typeof spec["type"] === "string" ? { type: spec["type"] } : {}, ...cases.length === 0 ? {} : { cases } };
+      })
+    };
+  });
+  return {
+    ...typeof main["name"] === "string" ? { name: main["name"] } : {},
+    ...typeof main["version"] === "string" ? { version: main["version"] } : {},
+    controllers,
+    tasks,
+    problems
+  };
+}
+async function localeOf(main, root) {
+  const languages = isObject(main["languages"]) ? main["languages"] : {};
+  const rel = languages["zh_cn"] ?? languages["zh-CN"] ?? languages["zh_CN"];
+  if (typeof rel !== "string")
+    return void 0;
+  try {
+    return flatten(parseJsonc(await readFile(join(root, rel), "utf8")));
+  } catch {
+    return void 0;
+  }
+}
+function flatten(value, prefix = "", out = {}) {
+  if (isObject(value)) {
+    for (const [k, v] of Object.entries(value)) {
+      const key = prefix === "" ? k : `${prefix}.${k}`;
+      if (isObject(v))
+        flatten(v, key, out);
+      out[key] = v;
+    }
+  }
+  return out;
+}
+var asArray = (v) => Array.isArray(v) ? v : [];
+var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+
+// packages/analyzer/lib/analyze.js
+var README = /^readme(\.zh(-cn)?|_zh|\.cn)?\.(md|txt)$/i;
+var CONFIG_EXT = /* @__PURE__ */ new Set([".json", ".jsonc", ".yaml", ".yml", ".toml", ".ini", ".cfg", ".conf"]);
+var LOG_EXT = /* @__PURE__ */ new Set([".log", ".txt"]);
+var SKIP = /^(node_modules|\.git|__pycache__|site-packages|lib|libs|runtime|python|3rdparty|res|resource|assets|locales|_internal)$/i;
+var MAX_TREE = 160;
+var MAX_README = 12e3;
+var DOC_EXT = /* @__PURE__ */ new Set([".md", ".markdown", ".txt", ".html", ".htm", ".pdf", ".rst", ".adoc"]);
+var DOC_DIRS = /^(docs?|documents?|documentation|manuals?|help|wiki|guides?|文档|说明|使用说明|帮助|教程)$/i;
+var DOC_NAME = /readme|changelog|changes|release|history|更新|说明|使用|教程|帮助|指南|manual|guide|usage|faq|help|howto|tutorial|wiki/i;
+var MAX_DOCS = 40;
+var MAX_LINKS = 12;
+var DOC_LINK = /^https?:\/\/(?:\S*\b(?:docs?|wiki|readthedocs|gitbook|manual|guide|faq)\b|[^/\s]*\.(?:github|gitee)\.io\b|github\.com\/[\w.-]+\/[\w.-]+\/?$|github\.com\/[\w.-]+\/[\w.-]+\/blob\/\S*\.md$)/i;
+async function analyzeDir(dir) {
+  const notes = [];
+  const probe = await probeProject(dir);
+  const tree = await listTree(dir);
+  const top = await readdir(dir).catch(() => []);
+  const readmeFile = top.find((n) => /^readme\.zh/i.test(n)) ?? top.find((n) => README.test(n));
+  let readme;
+  if (readmeFile !== void 0) {
+    const text = await readFile2(join2(dir, readmeFile), "utf8").catch(() => "");
+    readme = { file: readmeFile, text: text.slice(0, MAX_README), truncated: text.length > MAX_README };
+  } else
+    notes.push("\u6CA1\u6709 README\uFF1B\u53D1\u5E03\u5305\u91CC\u901A\u5E38\u6CA1\u6709\uFF0C\u53EF\u4EE5\u67E5\u770B\u9879\u76EE\u4E3B\u9875\u6216\u6E90\u7801\u4ED3\u5E93\u7684\u8BF4\u660E");
+  const docs = await findDocs(dir);
+  if (docs.length === 0 && readme === void 0)
+    notes.push("\u76EE\u5F55\u91CC\u6CA1\u6709\u6587\u6863\uFF1A\u5148\u53BB\u9879\u76EE\u4E3B\u9875\u3001GitHub \u4ED3\u5E93\u7684 README / Wiki / \u6587\u6863\u7AD9\u627E\uFF0C\u627E\u4E0D\u5230\u518D\u770B\u4EE3\u7801");
+  let iface;
+  for (const candidate of ["interface.json", "assets/interface.json"]) {
+    if (await isFile(join2(dir, candidate))) {
+      iface = { ...await readInterface(join2(dir, candidate)), file: candidate };
+      break;
+    }
+  }
+  const configFiles = [];
+  const logFiles = [];
+  for (const sub of ["", "config", "configs", "setting", "settings", "user", "data"]) {
+    const base = join2(dir, sub);
+    for (const name of await readdir(base).catch(() => [])) {
+      const path = join2(base, name);
+      const info = await stat(path).catch(() => void 0);
+      if (info === void 0 || !info.isFile())
+        continue;
+      const rel = relative(dir, path).replace(/\\/g, "/");
+      const ext = extname(name).toLowerCase();
+      if (CONFIG_EXT.has(ext) && info.size < 2e6 && rel !== "interface.json" && !/(deps|runtimeconfig|package-lock|manifest)\.json$/i.test(name)) {
+        let topKeys;
+        if (ext === ".json" || ext === ".jsonc") {
+          try {
+            const value = parseJsonc(await readFile2(path, "utf8"));
+            if (value !== null && typeof value === "object" && !Array.isArray(value))
+              topKeys = Object.keys(value).slice(0, 30);
+          } catch {
+          }
+        }
+        configFiles.push({ file: rel, size: info.size, ...topKeys === void 0 ? {} : { topKeys } });
+      }
+    }
+  }
+  for (const sub of ["debug", "log", "logs", ""]) {
+    const base = join2(dir, sub);
+    for (const name of await readdir(base).catch(() => [])) {
+      if (!LOG_EXT.has(extname(name).toLowerCase()) || sub === "" && !/log/i.test(name))
+        continue;
+      const path = join2(base, name);
+      const info = await stat(path).catch(() => void 0);
+      if (info === void 0 || !info.isFile())
+        continue;
+      const tail = (await readTail(path, 4096)).split(/\r?\n/).filter(Boolean).slice(-8);
+      logFiles.push({ file: relative(dir, path).replace(/\\/g, "/"), size: info.size, tail });
+    }
+  }
+  if (logFiles.length === 0)
+    notes.push("\u8FD8\u6CA1\u6709\u65E5\u5FD7\u6587\u4EF6\uFF1B\u53EF\u80FD\u8981\u5148\u8FD0\u884C\u4E00\u6B21\u811A\u672C\u624D\u4F1A\u751F\u6210\uFF0C\u65E5\u5FD7\u89C4\u5219\u53EF\u4EE5\u5148\u6839\u636E\u6587\u6863\u5199\uFF0C\u8FD0\u884C\u540E\u518D\u6821\u51C6");
+  const docLinks = linksIn([readme?.text ?? "", iface === void 0 ? "" : JSON.stringify(iface)].join("\n"));
+  const suggestedFamily = iface !== void 0 ? "maafw-pi" : probe.markers.includes("main.py") || probe.markers.includes("pyproject.toml") ? "cli" : configFiles.length > 0 && probe.executables.length > 0 ? "gui-config" : probe.executables.length > 0 ? "generic-process" : "visual";
+  return {
+    dir,
+    probe,
+    tree,
+    docs,
+    docLinks,
+    configFiles,
+    logFiles,
+    suggestedFamily,
+    notes,
+    ...readme === void 0 ? {} : { readme },
+    ...iface === void 0 ? {} : { interface: iface }
+  };
+}
+async function findDocs(dir) {
+  const found = /* @__PURE__ */ new Map();
+  const visit = async (rel, depth, inDocs) => {
+    for (const entry of await readdir(join2(dir, rel), { withFileTypes: true }).catch(() => [])) {
+      if (found.size >= MAX_DOCS * 3)
+        return;
+      const path = rel === "" ? entry.name : `${rel}/${entry.name}`;
+      if (entry.isDirectory()) {
+        if (SKIP.test(entry.name) && !DOC_DIRS.test(entry.name))
+          continue;
+        const docsDir = inDocs || DOC_DIRS.test(entry.name);
+        if (depth < (docsDir ? 3 : 1))
+          await visit(path, depth + 1, docsDir);
+        continue;
+      }
+      if (!entry.isFile() || !DOC_EXT.has(extname(entry.name).toLowerCase()))
+        continue;
+      if (!inDocs && !DOC_NAME.test(entry.name))
+        continue;
+      if (/log/i.test(entry.name) && !/changelog/i.test(entry.name))
+        continue;
+      const info = await stat(join2(dir, path)).catch(() => void 0);
+      if (info !== void 0)
+        found.set(path, info.size);
+    }
+  };
+  await visit("", 0, false);
+  const weight = (file) => /changelog|changes|release|更新/i.test(file) ? 0 : /readme/i.test(file) ? 1 : 2;
+  return [...found].map(([file, size]) => ({ file, size })).sort((a, b) => weight(a.file) - weight(b.file) || b.size - a.size).slice(0, MAX_DOCS);
+}
+function linksIn(text) {
+  const links = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(/https?:\/\/[^\s)"'<>\]]+/g)) {
+    const url = match[0].replace(/[.,;:!?。，；]+$/, "");
+    if (DOC_LINK.test(url) && !/\.(png|jpe?g|gif|svg|webp|zip|7z|exe)(\?|$)/i.test(url) && !/shields\.io|badge/i.test(url))
+      links.add(url);
+    if (links.size >= MAX_LINKS)
+      break;
+  }
+  return [...links];
+}
+async function listTree(dir) {
+  const out = [];
+  for (const entry of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+    if (out.length >= MAX_TREE)
+      break;
+    out.push(entry.isDirectory() ? `${entry.name}/` : entry.name);
+    if (!entry.isDirectory() || SKIP.test(entry.name))
+      continue;
+    for (const inner of (await readdir(join2(dir, entry.name), { withFileTypes: true }).catch(() => [])).slice(0, 25)) {
+      if (out.length >= MAX_TREE)
+        break;
+      out.push(`${entry.name}/${inner.name}${inner.isDirectory() ? "/" : ""}`);
+    }
+  }
+  return out;
+}
+async function readTail(path, bytes) {
+  const buffer = await readFile2(path).catch(() => Buffer.alloc(0));
+  return buffer.subarray(Math.max(0, buffer.length - bytes)).toString("utf8");
+}
+async function isFile(path) {
+  return stat(path).then((s) => s.isFile(), () => false);
+}
+
+// packages/analyzer/lib/drafts.js
+import { cp, mkdir, readdir as readdir2, readFile as readFile3, rename, rm, writeFile } from "node:fs/promises";
+import { join as join3 } from "node:path";
+var DraftStore = class {
+  #root;
+  #packs;
+  #history;
+  constructor(dataDir) {
+    this.#root = join3(dataDir, "pack-drafts");
+    this.#packs = join3(dataDir, "packs");
+    this.#history = join3(dataDir, "pack-history");
+  }
+  /**
+   * Validate and store a draft (replacing an earlier draft for the same pack).
+   * @throws PackError naming every problem, so the agent can fix and retry.
+   */
+  async propose(meta, manifest, skill) {
+    const parsed = parseManifest(manifest, `\u8349\u7A3F ${meta.packId}/${MANIFEST_FILE}`);
+    if (parsed.id !== meta.packId)
+      throw new Error(`\u811A\u672C\u5305\u7684 id\uFF08${parsed.id}\uFF09\u5FC5\u987B\u7B49\u4E8E pack_id\uFF08${meta.packId}\uFF09`);
+    if (!/^---\s*\n[\s\S]*?\bname:\s*\S+[\s\S]*?\bdescription:\s*\S[\s\S]*?\n---/.test(skill)) {
+      throw new Error("SKILL.md \u9700\u8981\u4EE5 YAML frontmatter \u5F00\u5934\uFF0C\u81F3\u5C11\u5305\u542B name \u548C description");
+    }
+    const dir = join3(this.#root, meta.packId);
+    await rm(dir, { recursive: true, force: true });
+    await mkdir(dir, { recursive: true });
+    await writeFile(join3(dir, MANIFEST_FILE), manifest.endsWith("\n") ? manifest : `${manifest}
+`);
+    await writeFile(join3(dir, SKILL_FILE), skill.endsWith("\n") ? skill : `${skill}
+`);
+    await writeFile(join3(dir, "draft.json"), `${JSON.stringify(meta, null, 2)}
+`);
+    return { tasks: parsed.tasks.map((t) => ({ id: t.id, title: t.title })) };
+  }
+  async list() {
+    const out = [];
+    for (const id of await readdir2(this.#root).catch(() => [])) {
+      const draft = await this.get(id).catch(() => void 0);
+      if (draft !== void 0)
+        out.push(draft);
+    }
+    return out.sort((a, b) => b.proposedAt - a.proposedAt);
+  }
+  async get(packId) {
+    const dir = join3(this.#root, packId);
+    const meta = JSON.parse(await readFile3(join3(dir, "draft.json"), "utf8"));
+    return { ...meta, manifest: await readFile3(join3(dir, MANIFEST_FILE), "utf8"), skill: await readFile3(join3(dir, SKILL_FILE), "utf8").catch(() => "") };
+  }
+  /** Install the draft as the user's pack. @returns the pack directory. */
+  async accept(packId, now = Date.now()) {
+    const draft = await this.get(packId);
+    parseManifest(draft.manifest);
+    const target = join3(this.#packs, packId);
+    const previous = await readdir2(target).then(() => true, () => false);
+    if (previous) {
+      const aside = join3(this.#history, packId, new Date(now).toISOString().replace(/[:.]/g, "-"));
+      await mkdir(join3(this.#history, packId), { recursive: true });
+      await cp(target, aside, { recursive: true });
+      await rm(target, { recursive: true, force: true });
+    }
+    await mkdir(this.#packs, { recursive: true });
+    await rename(join3(this.#root, packId), target);
+    await rm(join3(target, "draft.json"), { force: true });
+    return { dir: target, meta: draft };
+  }
+  async reject(packId) {
+    await rm(join3(this.#root, packId), { recursive: true, force: true });
+  }
+};
+
+// packages/analyzer/lib/skills.js
+var import_yaml = __toESM(require_dist(), 1);
+var SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function parseSkill(text, fallbackName) {
+  const match = /^?---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
+  if (match === null)
+    return void 0;
+  let meta;
+  try {
+    meta = (0, import_yaml.parse)(match[1]) ?? {};
+  } catch {
+    return void 0;
+  }
+  const description = typeof meta["description"] === "string" ? meta["description"].trim() : "";
+  if (description === "")
+    return void 0;
+  const raw = typeof meta["name"] === "string" ? meta["name"] : fallbackName;
+  const name = toSkillName(raw) ?? toSkillName(fallbackName);
+  if (name === void 0)
+    return void 0;
+  return { name, description, content: match[2].trim() };
+}
+function toSkillName(value) {
+  const name = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return SKILL_NAME.test(name) ? name : void 0;
+}
+
+// packages/analyzer/lib/index.js
+var GUIDE = new URL("../skills/script-analysis.md", import.meta.url);
+var AdgAnalyzer = class extends Service {
+  static inject = ["adgScripts"];
+  drafts;
+  constructor(ctx) {
+    super(ctx, "adgAnalyzer");
+    const log = ctx.logger("adg-analyzer");
+    const scripts = ctx.adgScripts;
+    const library = scripts.library;
+    this.drafts = new DraftStore(library.dataDir);
+    const drafts = this.drafts;
+    const changed = (packId) => ctx.get("adgGateway")?.broadcast("packs/changed", packId === void 0 ? {} : { packId });
+    ctx.inject(["skills", "adgGateway"], (scoped) => {
+      let disposers = [];
+      const register = async () => {
+        await scripts.ready;
+        for (const dispose of disposers.splice(0))
+          dispose();
+        const guide = parseSkill(await readFile4(GUIDE, "utf8"), "script-analysis");
+        if (guide !== void 0)
+          disposers.push(scoped.adgGateway.generalSkill({ ...guide, source: "bundled" }, () => scoped.skills.register({ ...guide, source: "bundled" })));
+        const { scripts: inLibrary } = library.list();
+        for (const pack of library.packs()) {
+          if (pack.skill === void 0)
+            continue;
+          const skill = parseSkill(pack.skill, pack.manifest.id);
+          if (skill === void 0) {
+            log.warn(`pack ${pack.manifest.id}: SKILL.md has no usable frontmatter; not registered as a skill`);
+            continue;
+          }
+          const owner = {
+            scripts: [pack.manifest.id, ...inLibrary.filter((s) => s.packId === pack.manifest.id).map((s) => s.id)],
+            ...pack.manifest.game?.name === void 0 ? {} : { games: [pack.manifest.game.name] }
+          };
+          try {
+            disposers.push(scoped.adgGateway.skillScope.register({ ...skill, source: pack.builtin ? "bundled" : "custom", path: join4(pack.dir, SKILL_FILE), resourceBase: { kind: "directory", path: pack.dir }, owner }));
+          } catch (error) {
+            log.warn(`pack ${pack.manifest.id}: skill not registered: ${error instanceof Error ? error.message : String(error)}`);
+          }
+        }
+      };
+      void register();
+      scoped.effect(() => library.onPacksChanged(() => void register()), "adg-analyzer pack skills");
+      scoped.effect(() => () => {
+        for (const dispose of disposers.splice(0))
+          dispose();
+      }, "adg-analyzer skills");
+    });
+    const approve = async (exec, reason) => {
+      const approval = ctx.get("approval");
+      if (approval === void 0 || exec.agent === void 0)
+        throw new Error("\u8FD9\u4E2A\u64CD\u4F5C\u9700\u8981\u7528\u6237\u6279\u51C6\uFF0C\u4F46\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u7684\u5BA1\u6279\u6E20\u9053");
+      const outcome = await approval.request({ agent: exec.agent, toolName: exec.name, callId: exec.callId, reason, signal: exec.signal });
+      if (outcome !== "allowed-once")
+        throw new Error(outcome === "rejected" ? "\u7528\u6237\u62D2\u7EDD\u4E86\u8FD9\u4E2A\u64CD\u4F5C" : `\u6CA1\u6709\u5F97\u5230\u7528\u6237\u6279\u51C6\uFF08${outcome}\uFF09`);
+    };
+    ctx.inject(["adgGateway"], (gateway) => gateway.adgGateway.agentPart("adg-analyzer tools", (agent) => {
+      const registered = [];
+      for (const tool of analyzerTools({ library, drafts, approve, ready: scripts.ready, changed }))
+        registered.push(agent.tools.register({ ...tool, execute: async (args, exec) => {
+          await ctx.get("adgGateway")?.guardTool(exec);
+          return tool.execute(args, exec);
+        } }));
+      return () => {
+        for (const dispose of registered)
+          dispose();
+      };
+    }));
+    ctx.inject(["adgGateway"], (scoped) => {
+      scoped.adgGateway.register({
+        id: PACKS_CAPABILITY,
+        version: 1,
+        methods: {
+          "packs/drafts": async (params) => {
+            await scripts.ready;
+            const p = params;
+            const items = (await drafts.list()).filter((d) => p.scriptId === void 0 || d.scriptId === p.scriptId);
+            return { items: await Promise.all(items.map((d) => describe(d))) };
+          },
+          "packs/accept": async (params) => {
+            await scripts.ready;
+            const { packId } = params;
+            const { dir, meta } = await drafts.accept(packId);
+            await library.reloadPacks();
+            try {
+              await library.attachPack(meta.scriptId, packId);
+            } catch (error) {
+              log.warn(`accepted pack ${packId} but could not attach it to ${meta.scriptId}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            changed(packId);
+            return { packId, dir };
+          },
+          "packs/reject": async (params) => {
+            const { packId } = params;
+            await drafts.reject(packId);
+            changed(packId);
+            return {};
+          }
+        }
+      });
+    });
+    const describe = async (draft) => {
+      const current = library.pack(draft.packId);
+      let tasks = [];
+      try {
+        tasks = parseManifest(draft.manifest).tasks.map((t) => ({ id: t.id, title: t.title }));
+      } catch {
+      }
+      const currentManifest = current === void 0 ? void 0 : await readFile4(join4(current.dir, MANIFEST_FILE), "utf8").catch(() => void 0);
+      return {
+        packId: draft.packId,
+        scriptId: draft.scriptId,
+        proposedAt: draft.proposedAt,
+        summary: draft.summary,
+        ...draft.docs === void 0 ? {} : { docs: draft.docs.map((d) => ({ ...d })) },
+        ...draft.noDocs === void 0 ? {} : { noDocs: draft.noDocs },
+        manifest: draft.manifest,
+        skill: draft.skill,
+        tasks,
+        ...draft.sessionId === void 0 ? {} : { sessionId: draft.sessionId },
+        ...current === void 0 || currentManifest === void 0 ? {} : { current: { manifest: currentManifest, builtin: current.builtin, ...current.skill === void 0 ? {} : { skill: current.skill } } }
+      };
+    };
+  }
+};
+function analyzerTools(deps) {
+  const json = (value) => JSON.parse(JSON.stringify(value ?? null));
+  const parse = (schema, args) => {
+    const parsed = schema.safeParse(args);
+    if (!parsed.success)
+      throw new Error(`\u53C2\u6570\u65E0\u6548\uFF1A${parsed.error.issues.map((i) => `${i.path.join(".") || "(root)"} ${i.message}`).join("; ")}`);
+    return parsed.data;
+  };
+  const tool = (spec) => ({
+    name: spec.name,
+    description: spec.description,
+    parameters: { type: "object", properties: spec.properties, required: spec.required, additionalProperties: false },
+    output: { schema: {}, render: (_a, value) => [{ type: "text", text: JSON.stringify(value, null, 1) }] },
+    timeoutMs: spec.timeoutMs ?? 12e4,
+    isConcurrencySafe: () => spec.kind === "read",
+    execute: async (args, exec) => {
+      await deps.ready;
+      return json(await spec.execute(args, exec));
+    },
+    presentCall: (args) => ({ card: "generic", title: spec.title(args ?? {}), kind: spec.kind })
+  });
+  const id = { type: "string", description: "\u811A\u672C\u5E93\u91CC\u7684\u811A\u672C id\u3002" };
+  return [
+    tool({
+      name: "script_analyze",
+      description: "\u5206\u6790\u811A\u672C\u5E93\u91CC\u7684\u4E00\u4E2A\u811A\u672C\u76EE\u5F55\uFF08\u53EA\u8BFB\uFF09\uFF1A\u76EE\u5F55\u7ED3\u6784\u3001\u9879\u76EE\u81EA\u5E26\u7684\u6587\u6863\uFF08docs\uFF1AREADME\u3001\u4F7F\u7528\u8BF4\u660E\u3001\u66F4\u65B0\u65E5\u5FD7\u3001\u5E2E\u52A9\uFF09\u548C\u6587\u6863\u7F51\u5740\uFF08docLinks\uFF1A\u4ED3\u5E93\u3001Wiki\u3001\u6587\u6863\u7AD9\uFF09\u3001MaaFramework \u7684 interface.json\u3001\u914D\u7F6E\u6587\u4EF6\u3001\u65E5\u5FD7\u6837\u672C\u3001\u5EFA\u8BAE\u7684\u9002\u914D\u5BB6\u65CF\uFF0C\u4EE5\u53CA\u5B83\u73B0\u6709\u7684\u811A\u672C\u5305\u3002\u5199\u811A\u672C\u5305\u524D\u5148\u8C03\u7528\uFF1B\u6309 script-analysis \u6280\u80FD\u7684\u6B65\u9AA4\u8FDB\u884C\uFF1A\u5148\u8BFB\u6587\u6863\uFF0C\u518D\u770B\u4EE3\u7801\u3002",
+      properties: { id },
+      required: ["id"],
+      kind: "read",
+      title: (a) => `\u5206\u6790\u811A\u672C\uFF1A${String(a["id"] ?? "")}`,
+      execute: async (args) => {
+        const a = parse(external_exports.object({ id: ScriptId }), args);
+        const script = deps.library.get(a.id);
+        if (script.dir === void 0)
+          throw new Error(`${script.name} \u8FD8\u6CA1\u6709\u5B89\u88C5`);
+        const report = await analyzeDir(script.dir);
+        const pack = deps.library.packOf(a.id);
+        const manifest = pack === void 0 ? void 0 : await readFile4(join4(pack.dir, MANIFEST_FILE), "utf8").catch(() => void 0);
+        const repo = script.channels.github?.repo;
+        const online = [...repo === void 0 ? [] : [`https://github.com/${repo}`, `https://github.com/${repo}/wiki`], ...report.docLinks];
+        return {
+          script: { id: script.id, name: script.name, source: script.source, family: script.family },
+          ...report,
+          docLinks: [...new Set(online)],
+          readFirst: "\u5148\u8BFB\u6587\u6863\uFF08docs \u91CC\u7684\u6587\u4EF6\u3001readme\u3001docLinks \u91CC\u7684\u7F51\u9875\uFF09\uFF0C\u518D\u7ED3\u5408\u4EE3\u7801\u548C\u914D\u7F6E\u6838\u5BF9\u3001\u8865\u5168\uFF1B\u53EA\u6709\u5B8C\u5168\u627E\u4E0D\u5230\u6587\u6863\u65F6\u624D\u76F4\u63A5\u4ECE\u4EE3\u7801\u5206\u6790\u3002",
+          currentPack: pack === void 0 ? null : { id: pack.manifest.id, builtin: pack.builtin, manifest, skill: pack.skill }
+        };
+      }
+    }),
+    tool({
+      name: "script_help",
+      description: "\u8FD0\u884C\u811A\u672C\u7A0B\u5E8F\u7684\u5E2E\u52A9\u53C2\u6570\uFF08\u9ED8\u8BA4 --help\uFF09\uFF0C\u62FF\u5230\u5B83\u81EA\u5DF1\u8BF4\u660E\u7684\u547D\u4EE4\u548C\u4EFB\u52A1\u3002\u6700\u591A\u8FD0\u884C 20 \u79D2\u540E\u7ED3\u675F\u3002\u6CA1\u6709\u5185\u7F6E\u811A\u672C\u5305\u7684\u811A\u672C\u4F1A\u5148\u8BF7\u7528\u6237\u786E\u8BA4\uFF0C\u56E0\u4E3A\u8FD9\u4F1A\u542F\u52A8\u5B83\u7684\u7A0B\u5E8F\u3002",
+      properties: {
+        id,
+        exe: { type: "string", description: "\u8981\u8FD0\u884C\u7684\u7A0B\u5E8F\uFF08\u76F8\u5BF9\u811A\u672C\u76EE\u5F55\uFF09\uFF1B\u7701\u7565\u65F6\u7528\u811A\u672C\u5305\u7684\u542F\u52A8\u7A0B\u5E8F\u6216\u627E\u5230\u7684\u7B2C\u4E00\u4E2A\u53EF\u6267\u884C\u6587\u4EF6\u3002" },
+        args: { type: "array", items: { type: "string" }, description: '\u53C2\u6570\uFF0C\u9ED8\u8BA4 ["--help"]\uFF1B\u4E5F\u53EF\u4EE5\u662F ["-h"]\u3001["-l"]\u3001["--list-workflows"]\u3002' }
+      },
+      required: ["id"],
+      kind: "execute",
+      timeoutMs: 6e4,
+      title: (a) => `\u67E5\u770B\u5E2E\u52A9\uFF1A${String(a["id"] ?? "")} ${Array.isArray(a["args"]) ? a["args"].join(" ") : "--help"}`,
+      execute: async (args, exec) => {
+        const a = parse(external_exports.object({ id: ScriptId, exe: external_exports.string().min(1).max(300).nullish(), args: external_exports.array(external_exports.string().max(100)).max(8).nullish() }), args);
+        const script = deps.library.get(a.id);
+        if (script.dir === void 0)
+          throw new Error(`${script.name} \u8FD8\u6CA1\u6709\u5B89\u88C5`);
+        const pack = deps.library.packOf(a.id);
+        const exe = a.exe ?? pack?.manifest.launch?.exe ?? script.probe?.executables[0];
+        if (exe === void 0)
+          throw new Error("\u6CA1\u6709\u627E\u5230\u53EF\u6267\u884C\u6587\u4EF6\uFF0C\u8BF7\u7528 exe \u53C2\u6570\u6307\u5B9A");
+        if (exe.split(/[\\/]/).includes("..") || /^([A-Za-z]:|[\\/])/.test(exe))
+          throw new Error("exe \u5FC5\u987B\u662F\u811A\u672C\u76EE\u5F55\u91CC\u7684\u76F8\u5BF9\u8DEF\u5F84");
+        const helpArgs = a.args ?? ["--help"];
+        if (pack?.builtin !== true)
+          await deps.approve(exec, `\u4E3A\u4E86\u5206\u6790 ${script.name}\uFF0C\u8FD0\u884C ${exe} ${helpArgs.join(" ")}\uFF08\u6700\u591A 20 \u79D2\uFF0C\u53EA\u770B\u5B83\u7684\u5E2E\u52A9\u8F93\u51FA\uFF09`);
+        return runHelp(join4(script.dir, exe), helpArgs, script.dir);
+      }
+    }),
+    tool({
+      name: "script_changelog",
+      description: "\u8BFB\u4E00\u4E2A\u811A\u672C\u8FD9\u51E0\u4E2A\u7248\u672C\u7684\u66F4\u65B0\u65E5\u5FD7\uFF1AGitHub \u4E0A\u6BCF\u4E2A\u53D1\u5E03\u7248\u7684\u8BF4\u660E\u3001Mirror\u9171 \u6700\u65B0\u7248\u7684\u8BF4\u660E\uFF0C\u4EE5\u53CA\u811A\u672C\u76EE\u5F55\u91CC\u7684 CHANGELOG / \u66F4\u65B0\u65E5\u5FD7\u6587\u4EF6\u3002\u811A\u672C\u66F4\u65B0\u540E\u68C0\u67E5\u811A\u672C\u5305\u65F6\u5148\u8C03\u7528\uFF1Bfrom \u9ED8\u8BA4\u662F\u811A\u672C\u5305\u5199\u6210\u65F6\u7684\u7248\u672C\uFF0Cto \u9ED8\u8BA4\u662F\u73B0\u5728\u7684\u7248\u672C\u3002",
+      properties: {
+        id,
+        from: { type: "string", description: "\u4ECE\u54EA\u4E2A\u7248\u672C\u4E4B\u540E\uFF08\u4E0D\u542B\uFF09\uFF1B\u7701\u7565\u4E3A\u811A\u672C\u5305\u5199\u6210\u65F6\u7684\u7248\u672C\u3002" },
+        to: { type: "string", description: "\u5230\u54EA\u4E2A\u7248\u672C\uFF08\u542B\uFF09\uFF1B\u7701\u7565\u4E3A\u73B0\u5728\u7684\u7248\u672C\u3002" }
+      },
+      required: ["id"],
+      kind: "read",
+      title: (a) => `\u8BFB\u66F4\u65B0\u65E5\u5FD7\uFF1A${String(a["id"] ?? "")}`,
+      execute: async (args, exec) => {
+        const a = parse(external_exports.object({ id: ScriptId, from: external_exports.string().max(60).nullish(), to: external_exports.string().max(60).nullish() }), args);
+        return deps.library.changelog(a.id, { from: a.from ?? void 0, to: a.to ?? void 0, signal: exec.signal });
+      }
+    }),
+    tool({
+      name: "pack_reviewed",
+      description: "\u811A\u672C\u66F4\u65B0\u540E\u68C0\u67E5\u8FC7\u811A\u672C\u5305\u3001\u786E\u8BA4\u4E0D\u7528\u6539\u65F6\u8C03\u7528\uFF1A\u8BB0\u4E0B\u811A\u672C\u5305\u5DF2\u7ECF\u5BF9\u7167\u73B0\u5728\u7684\u7248\u672C\u68C0\u67E5\u8FC7\uFF0C\u4E0D\u518D\u63D0\u9192\u3002\u8981\u6539\u5C31\u7528 pack_propose \u63D0\u4EA4\uFF0C\u7528\u6237\u63A5\u53D7\u540E\u4F1A\u81EA\u52A8\u8BB0\u4E0B\uFF0C\u4E0D\u7528\u8C03\u7528\u8FD9\u4E2A\u3002",
+      properties: {
+        id,
+        reason: { type: "string", description: "\u4E3A\u4EC0\u4E48\u4E0D\u7528\u6539\uFF08\u4F1A\u544A\u8BC9\u7528\u6237\uFF09\uFF0C\u4F8B\u5982\u300C\u8FD9\u51E0\u4E2A\u7248\u672C\u53EA\u4FEE\u4E86\u8BC6\u522B\u95EE\u9898\uFF0C\u4EFB\u52A1\u3001\u914D\u7F6E\u548C\u65E5\u5FD7\u90FD\u6CA1\u53D8\u300D\u3002" }
+      },
+      required: ["id", "reason"],
+      kind: "edit",
+      title: (a) => `\u811A\u672C\u5305\u4E0D\u7528\u6539\uFF1A${String(a["id"] ?? "")}`,
+      execute: async (args) => {
+        const a = parse(external_exports.object({ id: ScriptId, reason: external_exports.string().min(4).max(1e3) }), args);
+        const info = await deps.library.packReviewed(a.id);
+        return { ok: true, version: info.localVersion?.version ?? info.current, reason: a.reason };
+      }
+    }),
+    tool({
+      name: "pack_propose",
+      description: "\u63D0\u4EA4\u811A\u672C\u5305\u8349\u7A3F\uFF08adg.script.yaml \u548C SKILL.md\uFF09\u3002\u4F1A\u6309 schema \u6821\u9A8C\uFF0C\u5931\u8D25\u65F6\u8FD4\u56DE\u5177\u4F53\u5B57\u6BB5\u4EE5\u4FBF\u4FEE\u6B63\u540E\u91CD\u65B0\u63D0\u4EA4\uFF1B\u901A\u8FC7\u540E\u4FDD\u5B58\u4E3A\u8349\u7A3F\uFF0C\u7528\u6237\u5728\u300C\u811A\u672C\u300D\u9875\u786E\u8BA4\u540E\u751F\u6548\u3002\u4E0D\u4F1A\u4FEE\u6539\u811A\u672C\u672C\u8EAB\u3002",
+      properties: {
+        pack_id: { type: "string", description: "\u811A\u672C\u5305 id\uFF08\u4E0E manifest \u91CC\u7684 id \u76F8\u540C\uFF1B\u6539\u8FDB\u5DF2\u6709\u811A\u672C\u5305\u65F6\u7528\u539F id\uFF09\u3002" },
+        script_id: { type: "string", description: "\u8FD9\u4E2A\u5305\u63CF\u8FF0\u7684\u811A\u672C\u5E93\u91CC\u7684\u811A\u672C id\u3002" },
+        manifest: { type: "string", description: "adg.script.yaml \u7684\u5B8C\u6574\u5185\u5BB9\u3002" },
+        skill: { type: "string", description: "SKILL.md \u7684\u5B8C\u6574\u5185\u5BB9\uFF08\u4EE5 name / description frontmatter \u5F00\u5934\uFF09\u3002" },
+        summary: { type: "string", description: "\u7ED9\u7528\u6237\u770B\u7684\u4E00\u6BB5\u8BDD\uFF1A\u505A\u4E86\u4EC0\u4E48\u3001\u4F9D\u636E\u662F\u4EC0\u4E48\u3001\u54EA\u4E9B\u8FD8\u5F85\u786E\u8BA4\u3002" },
+        docs: {
+          type: "array",
+          description: "\u5199\u8FD9\u4EFD\u811A\u672C\u5305\u8BFB\u8FC7\u7684\u9879\u76EE\u6587\u6863\uFF08\u5148\u8BFB\u6587\u6863\u518D\u770B\u4EE3\u7801\uFF09\uFF1A\u6BCF\u9879\u5199\u51FA\u5904\uFF08\u811A\u672C\u76EE\u5F55\u91CC\u7684\u76F8\u5BF9\u8DEF\u5F84\u6216\u7F51\u5740\uFF09\u548C\u4ECE\u4E2D\u5F97\u5230\u4E86\u4EC0\u4E48\u3002",
+          items: { type: "object", properties: { source: { type: "string" }, used: { type: "string" } }, required: ["source", "used"], additionalProperties: false }
+        },
+        no_docs: { type: "string", description: "\u786E\u5B9E\u627E\u4E0D\u5230\u4EFB\u4F55\u6587\u6863\uFF08\u76EE\u5F55\u3001\u4ED3\u5E93\u3001Wiki\u3001\u6587\u6863\u7AD9\u90FD\u6CA1\u6709\uFF09\u624D\u586B\uFF1A\u8BF4\u660E\u627E\u8FC7\u54EA\u4E9B\u5730\u65B9\u3002\u586B\u4E86\u5B83 docs \u53EF\u4EE5\u4E3A\u7A7A\u3002" }
+      },
+      required: ["pack_id", "script_id", "manifest", "skill", "summary", "docs"],
+      kind: "edit",
+      title: (a) => `\u63D0\u4EA4\u811A\u672C\u5305\u8349\u7A3F\uFF1A${String(a["pack_id"] ?? "")}`,
+      execute: async (args, exec) => {
+        const a = parse(external_exports.object({
+          pack_id: ScriptId,
+          script_id: ScriptId,
+          manifest: external_exports.string().min(10).max(2e5),
+          skill: external_exports.string().min(10).max(2e5),
+          summary: external_exports.string().min(1).max(4e3),
+          docs: external_exports.array(external_exports.object({ source: external_exports.string().min(1).max(500), used: external_exports.string().min(1).max(1e3) })).max(40).nullish(),
+          no_docs: external_exports.string().max(1e3).nullish()
+        }), args);
+        const docs = a.docs ?? [];
+        if (docs.length === 0 && (a.no_docs ?? "").trim().length < 10) {
+          throw new Error("\u5148\u8BFB\u9879\u76EE\u7684\u6587\u6863\u518D\u5199\u811A\u672C\u5305\uFF1Adocs \u91CC\u5199\u51FA\u8BFB\u8FC7\u7684\u6587\u6863\uFF08\u51FA\u5904\u548C\u5F97\u5230\u4E86\u4EC0\u4E48\uFF09\uFF1B\u786E\u5B9E\u627E\u4E0D\u5230\u6587\u6863\u65F6\u7528 no_docs \u8BF4\u660E\u627E\u8FC7\u54EA\u4E9B\u5730\u65B9\uFF08\u811A\u672C\u76EE\u5F55\u3001\u4ED3\u5E93 README\u3001Wiki\u3001\u6587\u6863\u7AD9\uFF09");
+        }
+        deps.library.get(a.script_id);
+        const result = await deps.drafts.propose({
+          packId: a.pack_id,
+          scriptId: a.script_id,
+          proposedAt: Date.now(),
+          summary: a.summary,
+          ...docs.length === 0 ? {} : { docs },
+          ...docs.length > 0 || a.no_docs == null ? {} : { noDocs: a.no_docs.trim() },
+          ...exec.agent === void 0 ? {} : { sessionId: exec.agent.session.id }
+        }, a.manifest, a.skill);
+        deps.changed(a.pack_id);
+        return { ok: true, pack_id: a.pack_id, tasks: result.tasks, next: "\u8349\u7A3F\u5DF2\u4FDD\u5B58\u3002\u8BF7\u544A\u8BC9\u7528\u6237\u5230\u300C\u811A\u672C\u300D\u9875\u67E5\u770B\u8FD9\u4E2A\u811A\u672C\u7684\u300C\u811A\u672C\u5305\u8349\u7A3F\u300D\u5E76\u786E\u8BA4\u3002" };
+      }
+    })
+  ];
+}
+function runHelp(file, args, cwd) {
+  return new Promise((resolve) => {
+    execFile(file, [...args], { cwd, windowsHide: true, timeout: 2e4, maxBuffer: 4 * 1024 * 1024, encoding: "buffer" }, (error, stdout, stderr) => {
+      const raw = Buffer.concat([stdout, stderr]);
+      let output = new TextDecoder("utf-8").decode(raw);
+      if ((output.match(/�/g)?.length ?? 0) > 5)
+        output = new TextDecoder("gbk").decode(raw);
+      const timedOut = error?.killed === true;
+      const code = error === null ? 0 : typeof error.code === "number" ? error.code : null;
+      resolve({ exitCode: code, output: output.slice(0, 12e3), timedOut });
+    });
+  });
+}
+var lib_default = AdgAnalyzer;
+export {
+  AdgAnalyzer,
+  DraftStore,
+  analyzeDir,
+  lib_default as default,
+  parseJsonc,
+  parseSkill,
+  readInterface,
+  stripJsonc
+};