@ken-jo/agent-connector 0.4.0 → 0.4.1

package/dist/chunk-DCKFYWGM.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+// src/adapters/registry.ts
+var ADAPTER_REGISTRY = [
+  {
+    id: "claude-code",
+    load: () => import("./claude-code-W4PUFZL5.js").then((m) => m.default)
+  },
+  {
+    id: "codex",
+    load: () => import("./codex-DDHIV767.js").then((m) => m.default)
+  },
+  {
+    id: "cursor",
+    load: () => import("./cursor-TMBXDYR4.js").then((m) => m.default)
+  },
+  // vscode-copilot after cursor: cursor is a VS Code fork, so the fork's runtime
+  // markers must be checked first during host detection.
+  {
+    id: "vscode-copilot",
+    load: () => import("./vscode-copilot-MF2CDNMT.js").then((m) => m.default)
+  },
+  {
+    id: "copilot-cli",
+    load: () => import("./copilot-cli-Q3SSPT4V.js").then((m) => m.default)
+  },
+  {
+    id: "gemini-cli",
+    load: () => import("./gemini-cli-ILR7M5X3.js").then((m) => m.default)
+  },
+  {
+    id: "warp",
+    load: () => import("./warp-VKG55TAT.js").then((m) => m.default)
+  },
+  // ts-plugin paradigm: OpenCode loads a generated plugin module that bridges
+  // its in-process events to the universal hook entrypoint.
+  {
+    id: "opencode",
+    load: () => import("./opencode-WNXYJR4X.js").then((m) => m.default)
+  },
+  // mimo-code is Xiaomi's MiMoCode (@mimo-ai/cli, bin `mimo`) — an OpenCode FORK
+  // (ts-plugin, MCP root key "mcp", ~/.config/mimocode/mimocode.json). Grouped
+  // beside the OpenCode family whose config dialect + plugin contract it shares;
+  // detected via the DISTINCT ~/.config/mimocode dir, so there is no fork-ordering
+  // constraint vs opencode (no shared config file to disambiguate).
+  {
+    id: "mimo-code",
+    load: () => import("./mimo-code-FTMGSKMQ.js").then((m) => m.default)
+  },
+  // kilo-cli is the SQLite-backed OpenCode FORK command-line product (ts-plugin,
+  // loads @kilocode/plugin modules registered in kilo.jsonc's "plugin" array;
+  // MCP root key "mcp", ~/.config/kilo/kilo.jsonc). Grouped beside the OpenCode
+  // family whose plugin contract + config dialect it shares; distinct host from
+  // the "kilo" extension so there is no fork-ordering constraint between them.
+  {
+    id: "kilo-cli",
+    load: () => import("./kilo-cli-UZ7R5UOP.js").then((m) => m.default)
+  },
+  // Wave 1 — mcp-only adapters (no lifecycle hooks; MCP registration only).
+  {
+    id: "droid",
+    load: () => import("./droid-JC2NT6S4.js").then((m) => m.default)
+  },
+  {
+    id: "roo-code",
+    load: () => import("./roo-code-67TYJIQR.js").then((m) => m.default)
+  },
+  // kilo is the Kilo Code VS Code extension (kilocode.kilo-code) — a Roo/Cline
+  // fork, so it sits beside roo-code (mcp-only, root key "mcpServers", VS Code
+  // globalStorage / .kilocode project scope). Distinct host from "kilo-cli".
+  {
+    id: "kilo",
+    load: () => import("./kilo-5NWOXVSD.js").then((m) => m.default)
+  },
+  // cline is the Cline VS Code extension (saoudrizwan.claude-dev) — the most-
+  // installed AI coding extension and the PARENT that roo-code and kilo forked.
+  // mcp-only (no hook layer); MCP at the globalStorage cline_mcp_settings.json
+  // ("mcpServers"); content lives in the .clinerules tree + ~/Documents/Cline.
+  // NO runtime-marker collision with roo-code (rooveterinaryinc.roo-cline / .roo)
+  // or kilo (kilocode.kilo-code / .kilo) — distinct ext ids + dotdirs — so there
+  // is NO fork-before-parent ordering constraint here; it simply sits beside them.
+  {
+    id: "cline",
+    load: () => import("./cline-WRYMNS7Z.js").then((m) => m.default)
+  },
+  {
+    id: "trae",
+    load: () => import("./trae-7CZZGOGI.js").then((m) => m.default)
+  },
+  // antigravity-cli BEFORE antigravity: the `agy` CLI is a fork of the IDE
+  // adapter with its own runtime markers (the universal hook command tags the
+  // host as "antigravity-cli"), so the more-specific CLI marker must be checked
+  // before the IDE/parent during host detection.
+  {
+    id: "antigravity-cli",
+    load: () => import("./antigravity-cli-XERXEH5W.js").then((m) => m.default)
+  },
+  {
+    id: "antigravity",
+    load: () => import("./antigravity-AMKKKHS4.js").then((m) => m.default)
+  },
+  {
+    id: "zed",
+    load: () => import("./zed-SFUHL3GS.js").then((m) => m.default)
+  },
+  {
+    id: "amp",
+    load: () => import("./amp-4U33CU7E.js").then((m) => m.default)
+  },
+  {
+    id: "codebuff",
+    load: () => import("./codebuff-DH5Y7GAT.js").then((m) => m.default)
+  },
+  {
+    id: "mux",
+    load: () => import("./mux-5XZFB44C.js").then((m) => m.default)
+  },
+  // Pi — mcp-only host with no writable MCP config; drives the Agent Skills
+  // surface only (writes <piDir>/skills/<name>/SKILL.md).
+  {
+    id: "pi",
+    load: () => import("./pi-PVVPVWKG.js").then((m) => m.default)
+  },
+  // Wave 2 — json-stdio adapters (full hook dispatch via the universal entrypoint).
+  // jetbrains-copilot before vscode-copilot is unnecessary (distinct hosts); grouped here.
+  {
+    id: "jetbrains-copilot",
+    load: () => import("./jetbrains-copilot-NRZHI5PC.js").then((m) => m.default)
+  },
+  {
+    id: "qwen-code",
+    load: () => import("./qwen-code-G4CXKUHR.js").then((m) => m.default)
+  },
+  {
+    id: "kiro",
+    load: () => import("./kiro-YL6AWUYG.js").then((m) => m.default)
+  },
+  {
+    id: "kimi",
+    load: () => import("./kimi-2YFK2GBA.js").then((m) => m.default)
+  },
+  {
+    id: "crush",
+    load: () => import("./crush-MBEH2R3I.js").then((m) => m.default)
+  },
+  // Wave 3 — json-stdio adapters with YAML config (MCP in YAML; hooks per host).
+  {
+    id: "goose",
+    load: () => import("./goose-SFO5BBGW.js").then((m) => m.default)
+  },
+  {
+    id: "hermes",
+    load: () => import("./hermes-3N7WN4WS.js").then((m) => m.default)
+  },
+  // Wave 4 — ts-plugin adapters (generate a bridge module to the universal entrypoint).
+  {
+    id: "omp",
+    load: () => import("./omp-2QMEY6HD.js").then((m) => m.default)
+  },
+  // nemoclaw BEFORE openclaw (fork-before-parent convention). NVIDIA NemoClaw
+  // wraps OpenClaw and DRIVES the SAME ~/.openclaw/openclaw.json, so a NemoClaw
+  // box carries BOTH the ~/.nemoclaw/ and ~/.openclaw/ markers. Exclusivity is
+  // enforced at the SOURCE: OpenClawAdapter.detectInstalled BOWS OUT when
+  // ~/.nemoclaw/ is present, so the shared config is never double-targeted as two
+  // platforms. This ordering is the deterministic tie-break (matching the
+  // antigravity-cli/antigravity precedent). nemoclaw extends OpenClawAdapter
+  // (id/name/detection overridden), so inherited server/hook registration still
+  // lands in the wrapped openclaw.json.
+  {
+    id: "nemoclaw",
+    load: () => import("./nemoclaw-W5KEJ3WX.js").then((m) => m.default)
+  },
+  {
+    id: "openclaw",
+    load: () => import("./openclaw-EXJEFNZI.js").then((m) => m.default)
+  },
+  // Wave 5 — mcp-only: Amazon Q Developer CLI. JSON MCP config under ~/.aws/amazonq/
+  // (user) and .amazonq/ (project); root key "mcpServers"; bare stdio entry
+  // { command, args, env, timeout? } or remote entry { type: "http", url } (no
+  // headers) for http. The agent-format hooks layer (cli-agents/*.json) +
+  // agents/prompts content surfaces are separate, not-yet-wired surfaces; this
+  // adapter installs MCP entries + the .amazonq/rules memory surface.
+  {
+    id: "amazon-q",
+    load: () => import("./amazon-q-COAL3764.js").then((m) => m.default)
+  },
+  // Continue (the `cn` terminal agent / Continue.dev, npm @continuedev/cli) —
+  // json-stdio (Claude-compatible hooks). MCP config is YAML at ~/.continue/config.yaml (user) and
+  // <projectDir>/.continue/config.yaml (project); root key "mcpServers" is a
+  // YAML ARRAY of { name, command, type?, args?, env?, cwd?, url } entries (NOT a
+  // keyed map). Hooks: a Claude-compatible json-stdio layer in settings.json
+  // (~/.continue/settings.json — separate from the MCP config.yaml; PR #11029) +
+  // nativeHooks for the host-specific events. Distinct ~/.continue marker — no
+  // fork-ordering constraint vs any sibling.
+  {
+    id: "continue",
+    load: () => import("./continue-K43SUHLQ.js").then((m) => m.default)
+  },
+  // Windsurf (Codeium / Cognition's Cascade agent) — mcp-only. USER/GLOBAL scope
+  // ONLY: MCP config is JSON at ~/.codeium/windsurf/mcp_config.json (the docs
+  // document no project/workspace path), root key "mcpServers" is a Claude-
+  // Desktop-style OBJECT map keyed by server name (like cursor). stdio entry
+  // { command, args?, env? }; remote entry { serverUrl, headers? } (NOT `url`;
+  // no type/disabled). No user-installable hook/plugin layer (GUI editor), so it
+  // stays mcp-only paradigm — but content surfaces ARE wired: workflows
+  // (.windsurf/workflows + ~/.codeium/windsurf/global_workflows), skills
+  // (.windsurf/skills + ~/.codeium/windsurf/skills), and the .windsurf/rules
+  // memory surface. Distinct ~/.codeium marker — no fork-ordering constraint.
+  {
+    id: "windsurf",
+    load: () => import("./windsurf-FU5G4SHF.js").then((m) => m.default)
+  }
+];
+var REGISTRY_BY_ID = new Map(
+  ADAPTER_REGISTRY.map((factory) => [factory.id, factory])
+);
+var REGISTERED_PLATFORM_IDS = new Set(
+  ADAPTER_REGISTRY.map((factory) => factory.id)
+);
+function getFactory(id) {
+  return REGISTRY_BY_ID.get(id);
+}
+async function loadAdapter(id) {
+  const factory = getFactory(id);
+  return factory ? factory.load() : void 0;
+}
+async function allAdapters() {
+  return Promise.all(ADAPTER_REGISTRY.map((factory) => factory.load()));
+}
+
+export {
+  ADAPTER_REGISTRY,
+  REGISTERED_PLATFORM_IDS,
+  loadAdapter,
+  allAdapters
+};
+//# sourceMappingURL=chunk-DCKFYWGM.js.map

package/dist/chunk-DCKFYWGM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/registry.ts"],"sourcesContent":["/**\n * adapters/registry — single source of truth for the platforms agent-connector\n * targets. Generalized from context-mode's `ADAPTER_REGISTRY` pattern, adapted\n * to our `Adapter` / `AdapterFactory` contract (adapters/spi.ts).\n *\n * In context-mode the same platform set was redeclared in four places (env-var\n * detection, session-dir lookup, the lazy adapter loader, and per-adapter base\n * constructors); adding a platform meant editing all of them and missing one\n * was silent. Here the list lives ONCE below: each platform is one entry with a\n * lazy `load()` thunk that resolves the adapter singleton. Adding a platform is\n * a single new entry — `getFactory` / `loadAdapter` / `allAdapters` and the\n * detection cascade in detect.ts all derive from this list.\n *\n * `load()` returns the module's default export, which every adapter file is\n * required to provide as its singleton (`export default adapter;`). It is a\n * function (not an eager import) so module loading stays lazy: an adapter is\n * only imported when it is actually needed, keeping startup cheap.\n *\n * Order is load-bearing for runtime host detection (detect.ts iterates env\n * markers in registry order): forks MUST precede their parent so a session\n * running inside a derived shell is not misclassified as the parent. For the\n * three Phase-1 adapters this is moot, but the ordering convention is fixed now\n * so later additions (cursor is a VS Code fork, etc.) slot in correctly.\n */\n\nimport type { PlatformId } from \"../core/types.js\";\nimport type { Adapter, AdapterFactory } from \"./spi.js\";\n\n/**\n * Authoritative list of installable platforms. One entry per platform; the\n * `load` thunk lazily imports the adapter module and returns its default-export\n * singleton. To add a platform: drop its `src/adapters/<id>/index.ts` in place\n * (default-exporting an `Adapter`) and add one entry here.\n */\nexport const ADAPTER_REGISTRY: readonly AdapterFactory[] = [\n  {\n    id: \"claude-code\",\n    load: () => import(\"./claude-code/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"codex\",\n    load: () => import(\"./codex/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"cursor\",\n    load: () => import(\"./cursor/index.js\").then((m) => m.default),\n  },\n  // vscode-copilot after cursor: cursor is a VS Code fork, so the fork's runtime\n  // markers must be checked first during host detection.\n  {\n    id: \"vscode-copilot\",\n    load: () => import(\"./vscode-copilot/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"copilot-cli\",\n    load: () => import(\"./copilot-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"gemini-cli\",\n    load: () => import(\"./gemini-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"warp\",\n    load: () => import(\"./warp/index.js\").then((m) => m.default),\n  },\n  // ts-plugin paradigm: OpenCode loads a generated plugin module that bridges\n  // its in-process events to the universal hook entrypoint.\n  {\n    id: \"opencode\",\n    load: () => import(\"./opencode/index.js\").then((m) => m.default),\n  },\n  // mimo-code is Xiaomi's MiMoCode (@mimo-ai/cli, bin `mimo`) — an OpenCode FORK\n  // (ts-plugin, MCP root key \"mcp\", ~/.config/mimocode/mimocode.json). Grouped\n  // beside the OpenCode family whose config dialect + plugin contract it shares;\n  // detected via the DISTINCT ~/.config/mimocode dir, so there is no fork-ordering\n  // constraint vs opencode (no shared config file to disambiguate).\n  {\n    id: \"mimo-code\",\n    load: () => import(\"./mimo-code/index.js\").then((m) => m.default),\n  },\n  // kilo-cli is the SQLite-backed OpenCode FORK command-line product (ts-plugin,\n  // loads @kilocode/plugin modules registered in kilo.jsonc's \"plugin\" array;\n  // MCP root key \"mcp\", ~/.config/kilo/kilo.jsonc). Grouped beside the OpenCode\n  // family whose plugin contract + config dialect it shares; distinct host from\n  // the \"kilo\" extension so there is no fork-ordering constraint between them.\n  {\n    id: \"kilo-cli\",\n    load: () => import(\"./kilo-cli/index.js\").then((m) => m.default),\n  },\n  // Wave 1 — mcp-only adapters (no lifecycle hooks; MCP registration only).\n  {\n    id: \"droid\",\n    load: () => import(\"./droid/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"roo-code\",\n    load: () => import(\"./roo-code/index.js\").then((m) => m.default),\n  },\n  // kilo is the Kilo Code VS Code extension (kilocode.kilo-code) — a Roo/Cline\n  // fork, so it sits beside roo-code (mcp-only, root key \"mcpServers\", VS Code\n  // globalStorage / .kilocode project scope). Distinct host from \"kilo-cli\".\n  {\n    id: \"kilo\",\n    load: () => import(\"./kilo/index.js\").then((m) => m.default),\n  },\n  // cline is the Cline VS Code extension (saoudrizwan.claude-dev) — the most-\n  // installed AI coding extension and the PARENT that roo-code and kilo forked.\n  // mcp-only (no hook layer); MCP at the globalStorage cline_mcp_settings.json\n  // (\"mcpServers\"); content lives in the .clinerules tree + ~/Documents/Cline.\n  // NO runtime-marker collision with roo-code (rooveterinaryinc.roo-cline / .roo)\n  // or kilo (kilocode.kilo-code / .kilo) — distinct ext ids + dotdirs — so there\n  // is NO fork-before-parent ordering constraint here; it simply sits beside them.\n  {\n    id: \"cline\",\n    load: () => import(\"./cline/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"trae\",\n    load: () => import(\"./trae/index.js\").then((m) => m.default),\n  },\n  // antigravity-cli BEFORE antigravity: the `agy` CLI is a fork of the IDE\n  // adapter with its own runtime markers (the universal hook command tags the\n  // host as \"antigravity-cli\"), so the more-specific CLI marker must be checked\n  // before the IDE/parent during host detection.\n  {\n    id: \"antigravity-cli\",\n    load: () => import(\"./antigravity-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"antigravity\",\n    load: () => import(\"./antigravity/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"zed\",\n    load: () => import(\"./zed/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"amp\",\n    load: () => import(\"./amp/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"codebuff\",\n    load: () => import(\"./codebuff/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"mux\",\n    load: () => import(\"./mux/index.js\").then((m) => m.default),\n  },\n  // Pi — mcp-only host with no writable MCP config; drives the Agent Skills\n  // surface only (writes <piDir>/skills/<name>/SKILL.md).\n  {\n    id: \"pi\",\n    load: () => import(\"./pi/index.js\").then((m) => m.default),\n  },\n  // Wave 2 — json-stdio adapters (full hook dispatch via the universal entrypoint).\n  // jetbrains-copilot before vscode-copilot is unnecessary (distinct hosts); grouped here.\n  {\n    id: \"jetbrains-copilot\",\n    load: () => import(\"./jetbrains-copilot/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"qwen-code\",\n    load: () => import(\"./qwen-code/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"kiro\",\n    load: () => import(\"./kiro/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"kimi\",\n    load: () => import(\"./kimi/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"crush\",\n    load: () => import(\"./crush/index.js\").then((m) => m.default),\n  },\n  // Wave 3 — json-stdio adapters with YAML config (MCP in YAML; hooks per host).\n  {\n    id: \"goose\",\n    load: () => import(\"./goose/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"hermes\",\n    load: () => import(\"./hermes/index.js\").then((m) => m.default),\n  },\n  // Wave 4 — ts-plugin adapters (generate a bridge module to the universal entrypoint).\n  {\n    id: \"omp\",\n    load: () => import(\"./omp/index.js\").then((m) => m.default),\n  },\n  // nemoclaw BEFORE openclaw (fork-before-parent convention). NVIDIA NemoClaw\n  // wraps OpenClaw and DRIVES the SAME ~/.openclaw/openclaw.json, so a NemoClaw\n  // box carries BOTH the ~/.nemoclaw/ and ~/.openclaw/ markers. Exclusivity is\n  // enforced at the SOURCE: OpenClawAdapter.detectInstalled BOWS OUT when\n  // ~/.nemoclaw/ is present, so the shared config is never double-targeted as two\n  // platforms. This ordering is the deterministic tie-break (matching the\n  // antigravity-cli/antigravity precedent). nemoclaw extends OpenClawAdapter\n  // (id/name/detection overridden), so inherited server/hook registration still\n  // lands in the wrapped openclaw.json.\n  {\n    id: \"nemoclaw\",\n    load: () => import(\"./nemoclaw/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"openclaw\",\n    load: () => import(\"./openclaw/index.js\").then((m) => m.default),\n  },\n  // Wave 5 — mcp-only: Amazon Q Developer CLI. JSON MCP config under ~/.aws/amazonq/\n  // (user) and .amazonq/ (project); root key \"mcpServers\"; bare stdio entry\n  // { command, args, env, timeout? } or remote entry { type: \"http\", url } (no\n  // headers) for http. The agent-format hooks layer (cli-agents/*.json) +\n  // agents/prompts content surfaces are separate, not-yet-wired surfaces; this\n  // adapter installs MCP entries + the .amazonq/rules memory surface.\n  {\n    id: \"amazon-q\",\n    load: () => import(\"./amazon-q/index.js\").then((m) => m.default),\n  },\n  // Continue (the `cn` terminal agent / Continue.dev, npm @continuedev/cli) —\n  // json-stdio (Claude-compatible hooks). MCP config is YAML at ~/.continue/config.yaml (user) and\n  // <projectDir>/.continue/config.yaml (project); root key \"mcpServers\" is a\n  // YAML ARRAY of { name, command, type?, args?, env?, cwd?, url } entries (NOT a\n  // keyed map). Hooks: a Claude-compatible json-stdio layer in settings.json\n  // (~/.continue/settings.json — separate from the MCP config.yaml; PR #11029) +\n  // nativeHooks for the host-specific events. Distinct ~/.continue marker — no\n  // fork-ordering constraint vs any sibling.\n  {\n    id: \"continue\",\n    load: () => import(\"./continue/index.js\").then((m) => m.default),\n  },\n  // Windsurf (Codeium / Cognition's Cascade agent) — mcp-only. USER/GLOBAL scope\n  // ONLY: MCP config is JSON at ~/.codeium/windsurf/mcp_config.json (the docs\n  // document no project/workspace path), root key \"mcpServers\" is a Claude-\n  // Desktop-style OBJECT map keyed by server name (like cursor). stdio entry\n  // { command, args?, env? }; remote entry { serverUrl, headers? } (NOT `url`;\n  // no type/disabled). No user-installable hook/plugin layer (GUI editor), so it\n  // stays mcp-only paradigm — but content surfaces ARE wired: workflows\n  // (.windsurf/workflows + ~/.codeium/windsurf/global_workflows), skills\n  // (.windsurf/skills + ~/.codeium/windsurf/skills), and the .windsurf/rules\n  // memory surface. Distinct ~/.codeium marker — no fork-ordering constraint.\n  {\n    id: \"windsurf\",\n    load: () => import(\"./windsurf/index.js\").then((m) => m.default),\n  },\n];\n\n/** O(1) lookup index, built once at module-load time. */\nconst REGISTRY_BY_ID: ReadonlyMap<PlatformId, AdapterFactory> = new Map(\n  ADAPTER_REGISTRY.map((factory) => [factory.id, factory] as const),\n);\n\n/** Every platform id present in the registry (useful for matrix tests). */\nexport const REGISTERED_PLATFORM_IDS: ReadonlySet<PlatformId> = new Set(\n  ADAPTER_REGISTRY.map((factory) => factory.id),\n);\n\n/**\n * Look up the lazy factory for a platform id. Returns `undefined` for ids that\n * are not registered (including `\"unknown\"` and typos) so callers can fall back\n * deliberately rather than crash.\n */\nexport function getFactory(id: PlatformId | string): AdapterFactory | undefined {\n  return REGISTRY_BY_ID.get(id as PlatformId);\n}\n\n/**\n * Resolve a platform id to its adapter singleton. Returns `undefined` when the\n * id is not registered — callers decide whether to skip or fall back.\n */\nexport async function loadAdapter(id: PlatformId | string): Promise<Adapter | undefined> {\n  const factory = getFactory(id);\n  return factory ? factory.load() : undefined;\n}\n\n/**\n * Load every registered adapter. Imports run in parallel; the result preserves\n * registry order so downstream detection/install logic sees forks before\n * parents.\n */\nexport async function allAdapters(): Promise<Adapter[]> {\n  return Promise.all(ADAPTER_REGISTRY.map((factory) => factory.load()));\n}\n"],"mappings":";;;AAkCO,IAAM,mBAA8C;AAAA,EACzD;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACpE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,qBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC9D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,sBAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC/D;AAAA;AAAA;AAAA,EAGA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,8BAA2B,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACvE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACpE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,0BAAuB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACnE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC7D;AAAA;AAAA;AAAA,EAGA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,yBAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA,EAEA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,qBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC9D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA,EAIA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,qBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC9D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,+BAA4B,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACxE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACpE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,mBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC5D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,mBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC5D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,mBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC5D;AAAA;AAAA;AAAA,EAGA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,kBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC3D;AAAA;AAAA;AAAA,EAGA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,iCAA8B,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC1E;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,yBAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAClE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC7D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC7D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,qBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC9D;AAAA;AAAA,EAEA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,qBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC9D;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,sBAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC/D;AAAA;AAAA,EAEA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,mBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EACjE;AACF;AAGA,IAAM,iBAA0D,IAAI;AAAA,EAClE,iBAAiB,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,OAAO,CAAU;AAClE;AAGO,IAAM,0BAAmD,IAAI;AAAA,EAClE,iBAAiB,IAAI,CAAC,YAAY,QAAQ,EAAE;AAC9C;AAOO,SAAS,WAAW,IAAqD;AAC9E,SAAO,eAAe,IAAI,EAAgB;AAC5C;AAMA,eAAsB,YAAY,IAAuD;AACvF,QAAM,UAAU,WAAW,EAAE;AAC7B,SAAO,UAAU,QAAQ,KAAK,IAAI;AACpC;AAOA,eAAsB,cAAkC;AACtD,SAAO,QAAQ,IAAI,iBAAiB,IAAI,CAAC,YAAY,QAAQ,KAAK,CAAC,CAAC;AACtE;","names":[]}

package/dist/{chunk-J3D5W5T2.js → chunk-EGCBZ2DC.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ADAPTER_REGISTRY
-} from "./chunk-3PFFTFCU.js";
+} from "./chunk-DCKFYWGM.js";
 
 // src/adapters/detect.ts
 async function detectInstalledPlatforms(projectDir) {
@@ -80,4 +80,4 @@ export {
   detectInstalledPlatforms,
   detectRuntimeHost
 };
-//# sourceMappingURL=chunk-J3D5W5T2.js.map
+//# sourceMappingURL=chunk-EGCBZ2DC.js.map

package/dist/{chunk-22Y24V7O.js → chunk-F5RX62T7.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveSpawnCommand
-} from "./chunk-BXGFUENQ.js";
+} from "./chunk-I5MLE6S7.js";
 
 // src/core/spawn-child.ts
 import { spawn } from "child_process";
@@ -18,4 +18,4 @@ function spawnChild(command, args, options) {
 export {
   spawnChild
 };
-//# sourceMappingURL=chunk-22Y24V7O.js.map
+//# sourceMappingURL=chunk-F5RX62T7.js.map

package/dist/chunk-FAHIMJRU.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import {
+  ensureDir
+} from "./chunk-TRQKHP7D.js";
+
+// src/core/config-patch-ledger.ts
+import { createHash, randomBytes } from "crypto";
+import {
+  existsSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { dirname, join } from "path";
+var CONFIG_PATCH_SEGMENT_RE = /^[A-Za-z0-9_-]+$/;
+function isValidConfigPatchKey(key) {
+  if (typeof key !== "string" || key.length === 0) return false;
+  return key.split(".").every((seg) => CONFIG_PATCH_SEGMENT_RE.test(seg));
+}
+function isJsonValue(value) {
+  if (value === null) return true;
+  switch (typeof value) {
+    case "string":
+    case "boolean":
+      return true;
+    case "number":
+      return Number.isFinite(value);
+    case "object":
+      break;
+    default:
+      return false;
+  }
+  if (Array.isArray(value)) return value.every((v) => isJsonValue(v));
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== Object.prototype && proto !== null) return false;
+  return Object.values(value).every((v) => isJsonValue(v));
+}
+function configPatchNamespaceViolation(key) {
+  const head = key.split(".")[0] ?? "";
+  if (head === "hooks") {
+    return `"${key}" targets the hooks config agent-connector already models; declare it via \`hooks\` (normalized) or \`platforms.<id>.nativeHooks\` instead`;
+  }
+  if (head === "mcpServers" || head === "enableAllProjectMcpServers" || head === "enabledMcpjsonServers" || head === "disabledMcpjsonServers") {
+    return `"${key}" targets MCP server registration agent-connector already models; declare it via \`server\` / \`platforms.<id>.server\` / \`extra\` instead`;
+  }
+  if (head === "statusLine") {
+    return `"${key}" is modeled by the statusline surface; declare it via \`statusline: { render }\` instead`;
+  }
+  return null;
+}
+function configPatchManualEdit(patch) {
+  const docs = patch.docsUrl ? ` \u2014 see ${patch.docsUrl}` : "";
+  return `manual edit if wanted: set ${patch.key} = ${describeJsonValue(patch.value)} (${patch.reason})${docs}`;
+}
+function describeJsonValue(value) {
+  if (value === void 0) return "<absent>";
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function canonicalJson(value) {
+  if (value === void 0) return "undefined";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) {
+    return `[${value.map((v) => canonicalJson(v)).join(",")}]`;
+  }
+  const keys = Object.keys(value).sort();
+  const parts = keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(value[k])}`);
+  return `{${parts.join(",")}}`;
+}
+function hashJsonValue(value) {
+  return createHash("sha256").update(canonicalJson(value)).digest("hex");
+}
+function jsonDeepEquals(a, b) {
+  return canonicalJson(a) === canonicalJson(b);
+}
+function configPatchLedgerPath(dataRoot) {
+  return join(dataRoot, "state", "config-patches.json");
+}
+function loadConfigPatchLedger(dataRoot) {
+  const path = configPatchLedgerPath(dataRoot);
+  if (!existsSync(path)) return { version: 1, entries: [] };
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (!parsed || !Array.isArray(parsed.entries)) return { version: 1, entries: [] };
+    return { version: 1, entries: parsed.entries.filter(isPlausibleEntry) };
+  } catch {
+    return { version: 1, entries: [] };
+  }
+}
+function isPlausibleEntry(e) {
+  if (e == null || typeof e !== "object") return false;
+  const entry = e;
+  return typeof entry.platform === "string" && typeof entry.file === "string" && typeof entry.key === "string" && Array.isArray(entry.owners);
+}
+function saveConfigPatchLedger(dataRoot, ledger) {
+  const path = configPatchLedgerPath(dataRoot);
+  ensureDir(dirname(path));
+  const tmpFile = `${path}.${process.pid}-${randomBytes(4).toString("hex")}.tmp`;
+  try {
+    writeFileSync(tmpFile, `${JSON.stringify(ledger, null, 2)}
+`, "utf8");
+    renameSync(tmpFile, path);
+  } catch (err) {
+    rmSync(tmpFile, { force: true });
+    throw err;
+  }
+}
+function findLedgerEntry(ledger, platform, file, key) {
+  return ledger.entries.find(
+    (e) => e.platform === platform && e.file === file && e.key === key
+  );
+}
+function ledgerEntriesOwnedBy(ledger, platform, connectorId) {
+  return ledger.entries.filter(
+    (e) => e.platform === platform && e.owners.some((o) => o.connectorId === connectorId)
+  );
+}
+function createLedgerEntry(ledger, init) {
+  const entry = {
+    platform: init.platform,
+    file: init.file,
+    key: init.key,
+    writtenValue: init.value,
+    writtenValueHash: hashJsonValue(init.value),
+    prior: { present: false },
+    owners: [
+      {
+        connectorId: init.connectorId,
+        connectorVersion: init.connectorVersion,
+        installedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    ]
+  };
+  ledger.entries.push(entry);
+  return entry;
+}
+function addLedgerOwner(entry, connectorId, connectorVersion) {
+  if (entry.owners.some((o) => o.connectorId === connectorId)) return false;
+  entry.owners.push({
+    connectorId,
+    connectorVersion,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  return true;
+}
+function removeLedgerOwner(entry, connectorId) {
+  const before = entry.owners.length;
+  entry.owners = entry.owners.filter((o) => o.connectorId !== connectorId);
+  return { removed: entry.owners.length < before, lastOwner: entry.owners.length === 0 };
+}
+function dropLedgerEntry(ledger, entry) {
+  ledger.entries = ledger.entries.filter((e) => e !== entry);
+}
+
+export {
+  CONFIG_PATCH_SEGMENT_RE,
+  isValidConfigPatchKey,
+  isJsonValue,
+  configPatchNamespaceViolation,
+  configPatchManualEdit,
+  describeJsonValue,
+  hashJsonValue,
+  jsonDeepEquals,
+  loadConfigPatchLedger,
+  saveConfigPatchLedger,
+  findLedgerEntry,
+  ledgerEntriesOwnedBy,
+  createLedgerEntry,
+  addLedgerOwner,
+  removeLedgerOwner,
+  dropLedgerEntry
+};
+//# sourceMappingURL=chunk-FAHIMJRU.js.map

package/dist/chunk-FAHIMJRU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config-patch-ledger.ts"],"sourcesContent":["/**\n * core/config-patch-ledger — the persisted, refcounted ownership ledger behind\n * the declarative `configPatch` surface, plus the shared configPatch helpers\n * (leaf-path grammar, JSON-value checks, the agent-connector namespace guard,\n * canonical hashing, and the manual-edit hint every skip-warn prints).\n *\n * WHY A LEDGER (and not the hooks-style recompute ownership): hook entries\n * embed the connector id in their command string, so uninstall can identify\n * \"mine\" by inspection. configPatch writes bare host keys (`true` is `true`) —\n * not attributable by inspection — and the same key may be needed by SEVERAL\n * connectors (a shared host feature flag). Without a persisted refcount,\n * connector A uninstalling would delete a key connector B still relies on.\n *\n * Contract (docs/ARCHITECTURE.md §4 \"configPatch\"):\n *   • One global file at `<dataRoot>/state/config-patches.json`, written\n *     ATOMICALLY (temp + rename) — shared across connectors because\n *     refcounting requires a global view; survives a connector's record purge.\n *   • Primary key per entry: (platform, file, key). `prior` is ALWAYS\n *     `{ present: false }` — ownership only ever attaches to keys\n *     agent-connector itself created (set-if-absent), so the blind\n *     \"restore prior value\" footgun is structurally impossible.\n *   • Uninstall removes a key ONLY when the releasing connector is the LAST\n *     owner AND the current value still deep-equals `writtenValue` AND prior\n *     was absent; any mismatch → skip-warn and leave the key in place.\n *   • The ledger is advisory FOR DELETION ONLY: the worst desync outcome is a\n *     skip-warn and a leftover key, never data loss.\n */\n\nimport { createHash, randomBytes } from \"node:crypto\";\nimport {\n  existsSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nimport type { ConfigPatchDef, JsonValue, PlatformId } from \"./types.js\";\nimport { ensureDir } from \"./paths.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Shared configPatch helpers (grammar / values / namespace guard / hints)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Grammar for ONE dotted-path segment: no dots-in-key, no array indices. */\nexport const CONFIG_PATCH_SEGMENT_RE = /^[A-Za-z0-9_-]+$/;\n\n/**\n * True when `key` is a valid dotted LEAF path: 1+ segments joined by \".\",\n * every segment matching {@link CONFIG_PATCH_SEGMENT_RE}.\n */\nexport function isValidConfigPatchKey(key: unknown): key is string {\n  if (typeof key !== \"string\" || key.length === 0) return false;\n  return key.split(\".\").every((seg) => CONFIG_PATCH_SEGMENT_RE.test(seg));\n}\n\n/**\n * True when `value` is JSON-serializable data (string / finite number /\n * boolean / null / arrays / plain objects thereof). Rejects undefined,\n * functions, symbols, bigints, NaN/Infinity (JSON.stringify silently corrupts\n * those), and class instances other than plain objects/arrays.\n */\nexport function isJsonValue(value: unknown): value is JsonValue {\n  if (value === null) return true;\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"object\":\n      break;\n    default:\n      return false;\n  }\n  if (Array.isArray(value)) return value.every((v) => isJsonValue(v));\n  const proto = Object.getPrototypeOf(value);\n  if (proto !== Object.prototype && proto !== null) return false;\n  return Object.values(value as Record<string, unknown>).every((v) => isJsonValue(v));\n}\n\n/**\n * GUARDED NAMESPACE: keys agent-connector already models are NOT patchable —\n * the proper surface must be used instead (otherwise a connector could smuggle\n * hooks past the nativeHooks modeling/reporting, or fight the server install).\n * Returns a human-readable violation pointing at the proper surface, or null.\n * Checked at defineConnector (statically knowable) AND re-enforced in the\n * adapter (meta-loaded connectors must not bypass it).\n */\nexport function configPatchNamespaceViolation(key: string): string | null {\n  const head = key.split(\".\")[0] ?? \"\";\n  if (head === \"hooks\") {\n    return `\"${key}\" targets the hooks config agent-connector already models; declare it via \\`hooks\\` (normalized) or \\`platforms.<id>.nativeHooks\\` instead`;\n  }\n  if (\n    head === \"mcpServers\" ||\n    head === \"enableAllProjectMcpServers\" ||\n    head === \"enabledMcpjsonServers\" ||\n    head === \"disabledMcpjsonServers\"\n  ) {\n    return `\"${key}\" targets MCP server registration agent-connector already models; declare it via \\`server\\` / \\`platforms.<id>.server\\` / \\`extra\\` instead`;\n  }\n  if (head === \"statusLine\") {\n    return `\"${key}\" is modeled by the statusline surface; declare it via \\`statusline: { render }\\` instead`;\n  }\n  return null;\n}\n\n/**\n * The exact manual edit a user can perform when a patch is skipped (conflict,\n * drift, unsupported host, denylist…). Printed in every skip-warn so a single\n * declaration doubles as its own documented manual step.\n */\nexport function configPatchManualEdit(patch: ConfigPatchDef): string {\n  const docs = patch.docsUrl ? ` — see ${patch.docsUrl}` : \"\";\n  return (\n    `manual edit if wanted: set ${patch.key} = ${describeJsonValue(patch.value)} ` +\n    `(${patch.reason})${docs}`\n  );\n}\n\n/** Compact single-line JSON rendering for diffs/warnings (\"<absent>\" for undefined). */\nexport function describeJsonValue(value: JsonValue | undefined): string {\n  if (value === undefined) return \"<absent>\";\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Canonical JSON / deep equality\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Canonical (sorted-keys) JSON of a value — the hash/equality basis. */\nexport function canonicalJson(value: JsonValue | undefined): string {\n  if (value === undefined) return \"undefined\";\n  if (value === null || typeof value !== \"object\") return JSON.stringify(value);\n  if (Array.isArray(value)) {\n    return `[${value.map((v) => canonicalJson(v)).join(\",\")}]`;\n  }\n  const keys = Object.keys(value).sort();\n  const parts = keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(value[k])}`);\n  return `{${parts.join(\",\")}}`;\n}\n\n/** sha256 of the canonical JSON — the fast path; deep-equal is the authority. */\nexport function hashJsonValue(value: JsonValue): string {\n  return createHash(\"sha256\").update(canonicalJson(value)).digest(\"hex\");\n}\n\n/** Order-insensitive (object keys) deep equality over JSON data. */\nexport function jsonDeepEquals(\n  a: JsonValue | undefined,\n  b: JsonValue | undefined,\n): boolean {\n  return canonicalJson(a) === canonicalJson(b);\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Ledger shape + persistence\n// ─────────────────────────────────────────────────────────────────────────\n\n/** One connector's registration on a ledger entry. */\nexport interface ConfigPatchOwner {\n  connectorId: string;\n  connectorVersion: string;\n  installedAt: string;\n}\n\n/** Refcounted ownership record for one (platform, file, key). */\nexport interface ConfigPatchLedgerEntry {\n  platform: PlatformId;\n  /** Absolute path of the file actually written (scope-resolved at install time). */\n  file: string;\n  /** Dotted leaf path — (platform, file, key) is the primary key. */\n  key: string;\n  writtenValue: JsonValue;\n  /** sha256 of canonical (sorted-keys) JSON of writtenValue (fast path only). */\n  writtenValueHash: string;\n  /** Always { present: false } — ownership ONLY attaches to keys we created. */\n  prior: { present: false };\n  owners: ConfigPatchOwner[];\n}\n\nexport interface ConfigPatchLedger {\n  version: 1;\n  entries: ConfigPatchLedgerEntry[];\n}\n\n/** Ledger file path under the framework data-root. */\nexport function configPatchLedgerPath(dataRoot: string): string {\n  return join(dataRoot, \"state\", \"config-patches.json\");\n}\n\n/**\n * Load the ledger; a missing or corrupt file degrades to an empty ledger\n * (advisory-for-deletion-only: a lost ledger can never cause data loss, only\n * retained keys + skip-warns).\n */\nexport function loadConfigPatchLedger(dataRoot: string): ConfigPatchLedger {\n  const path = configPatchLedgerPath(dataRoot);\n  if (!existsSync(path)) return { version: 1, entries: [] };\n  try {\n    const parsed = JSON.parse(readFileSync(path, \"utf8\")) as ConfigPatchLedger;\n    if (!parsed || !Array.isArray(parsed.entries)) return { version: 1, entries: [] };\n    return { version: 1, entries: parsed.entries.filter(isPlausibleEntry) };\n  } catch {\n    return { version: 1, entries: [] };\n  }\n}\n\n/** Minimal shape sanity for a persisted entry (corrupt rows are dropped). */\nfunction isPlausibleEntry(e: unknown): e is ConfigPatchLedgerEntry {\n  if (e == null || typeof e !== \"object\") return false;\n  const entry = e as Partial<ConfigPatchLedgerEntry>;\n  return (\n    typeof entry.platform === \"string\" &&\n    typeof entry.file === \"string\" &&\n    typeof entry.key === \"string\" &&\n    Array.isArray(entry.owners)\n  );\n}\n\n/**\n * Persist the ledger ATOMICALLY: write to a temp file in the same directory,\n * then rename over the target (rename is atomic on the same filesystem).\n */\nexport function saveConfigPatchLedger(dataRoot: string, ledger: ConfigPatchLedger): void {\n  const path = configPatchLedgerPath(dataRoot);\n  ensureDir(dirname(path));\n  const tmpFile = `${path}.${process.pid}-${randomBytes(4).toString(\"hex\")}.tmp`;\n  try {\n    writeFileSync(tmpFile, `${JSON.stringify(ledger, null, 2)}\\n`, \"utf8\");\n    renameSync(tmpFile, path);\n  } catch (err) {\n    rmSync(tmpFile, { force: true });\n    throw err;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Ledger operations (pure in-memory; callers load → mutate → save)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Find the entry for (platform, file, key), or undefined. */\nexport function findLedgerEntry(\n  ledger: ConfigPatchLedger,\n  platform: PlatformId,\n  file: string,\n  key: string,\n): ConfigPatchLedgerEntry | undefined {\n  return ledger.entries.find(\n    (e) => e.platform === platform && e.file === file && e.key === key,\n  );\n}\n\n/** Every entry on `platform` owned (at least in part) by `connectorId`. */\nexport function ledgerEntriesOwnedBy(\n  ledger: ConfigPatchLedger,\n  platform: PlatformId,\n  connectorId: string,\n): ConfigPatchLedgerEntry[] {\n  return ledger.entries.filter(\n    (e) => e.platform === platform && e.owners.some((o) => o.connectorId === connectorId),\n  );\n}\n\n/** Create a fresh entry (prior is absent BY CONSTRUCTION) and append it. */\nexport function createLedgerEntry(\n  ledger: ConfigPatchLedger,\n  init: {\n    platform: PlatformId;\n    file: string;\n    key: string;\n    value: JsonValue;\n    connectorId: string;\n    connectorVersion: string;\n  },\n): ConfigPatchLedgerEntry {\n  const entry: ConfigPatchLedgerEntry = {\n    platform: init.platform,\n    file: init.file,\n    key: init.key,\n    writtenValue: init.value,\n    writtenValueHash: hashJsonValue(init.value),\n    prior: { present: false },\n    owners: [\n      {\n        connectorId: init.connectorId,\n        connectorVersion: init.connectorVersion,\n        installedAt: new Date().toISOString(),\n      },\n    ],\n  };\n  ledger.entries.push(entry);\n  return entry;\n}\n\n/**\n * Register `connectorId` as a (co-)owner. Returns true when added, false when\n * it was already an owner (idempotent re-install → no ledger mutation).\n */\nexport function addLedgerOwner(\n  entry: ConfigPatchLedgerEntry,\n  connectorId: string,\n  connectorVersion: string,\n): boolean {\n  if (entry.owners.some((o) => o.connectorId === connectorId)) return false;\n  entry.owners.push({\n    connectorId,\n    connectorVersion,\n    installedAt: new Date().toISOString(),\n  });\n  return true;\n}\n\n/**\n * Remove `connectorId` from the owners. Returns whether an owner was removed\n * and whether the entry is now ownerless (last owner out).\n */\nexport function removeLedgerOwner(\n  entry: ConfigPatchLedgerEntry,\n  connectorId: string,\n): { removed: boolean; lastOwner: boolean } {\n  const before = entry.owners.length;\n  entry.owners = entry.owners.filter((o) => o.connectorId !== connectorId);\n  return { removed: entry.owners.length < before, lastOwner: entry.owners.length === 0 };\n}\n\n/** Drop an entry from the ledger (identity match). */\nexport function dropLedgerEntry(\n  ledger: ConfigPatchLedger,\n  entry: ConfigPatchLedgerEntry,\n): void {\n  ledger.entries = ledger.entries.filter((e) => e !== entry);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-BXGFUENQ.js → chunk-I5MLE6S7.js}

@@ -51,6 +51,17 @@ function isHomeBinStatuslineCommand(command, homeBinPath, connectorId) {
   if (!hasVerbSlot(hay, homeBinNorm, "statusline")) return false;
   return isHomeBinHookCommand(command, homeBinPath, connectorId);
 }
+function buildHomeBinActionCommand(homeBinPath, platformId, actionId, connectorId) {
+  return `${quoteArg(homeBinPath)} action ${platformId} ${actionId} --connector ${connectorId}`;
+}
+function isHomeBinActionCommand(command, homeBinPath, connectorId) {
+  if (!command) return false;
+  const hay = command.replace(/\\/g, "/");
+  const homeBinNorm = homeBinPath.replace(/\\/g, "/");
+  if (!hay.includes(homeBinNorm)) return false;
+  if (!hasVerbSlot(hay, homeBinNorm, "action")) return false;
+  return isHomeBinHookCommand(command, homeBinPath, connectorId);
+}
 function isHostNativeUsageEnabled(telemetry, env = process.env) {
   if (telemetry.enabled !== true) return false;
   if (env.AGENT_CONNECTOR_HOST_NATIVE === "1") return true;
@@ -119,10 +130,12 @@ export {
   isUsageEventCommand,
   buildHomeBinStatuslineCommand,
   isHomeBinStatuslineCommand,
+  buildHomeBinActionCommand,
+  isHomeBinActionCommand,
   isHostNativeUsageEnabled,
   shouldWrapForTelemetry,
   buildServeWrapperCommand,
   resolveSpawnCommand,
   detectLaunchMethod
 };
-//# sourceMappingURL=chunk-BXGFUENQ.js.map
+//# sourceMappingURL=chunk-I5MLE6S7.js.map