@ken-jo/agent-connector 0.4.7 → 0.4.8

package/dist/chunk-H53QZQJI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/claude-code/wire.ts"],"sourcesContent":["/**\n * adapters/claude-code/wire — Claude Code hook wire protocol.\n *\n * Claude Code pipes a JSON object to a hook command on stdin and reads a JSON\n * object (or empty) from stdout, interpreting the exit code as well. This module\n * captures the exact stdin shape and the canonical reply shape so the adapter's\n * parse/format methods are a single source of truth.\n *\n * Stdin (documented Claude Code hook input):\n *   {\n *     session_id, transcript_path, cwd, hook_event_name,\n *     tool_name, tool_input, tool_response,            // tool events\n *     permission_suggestions,                          // PermissionRequest\n *     tool_use_id, error, is_interrupt, duration_ms,   // PostToolUseFailure\n *     agent_id, agent_type,                            // SubagentStart/Stop\n *     agent_transcript_path, last_assistant_message,   // SubagentStop\n *     source,                                          // SessionStart\n *     reason,                                          // SessionEnd\n *     prompt,                                          // UserPromptSubmit\n *     trigger,                                         // PreCompact\n *     stop_hook_active,                                // Stop / SubagentStop\n *     message                                          // Notification\n *   }\n *\n * Stdout (canonical reply): a `hookSpecificOutput` object keyed by\n * `hookEventName`, carrying `permissionDecision` (allow|deny|ask) +\n * `permissionDecisionReason`, `additionalContext`, and (PreToolUse)\n * `updatedInput`; PermissionRequest instead takes a nested\n * `decision: { behavior: \"allow\"|\"deny\", ... }`; Stop-class blocks\n * (Stop / SubagentStop / UserPromptSubmit / PostToolUse) take the TOP-LEVEL\n * `{\"decision\":\"block\",\"reason\"}`. Exit 0 = proceed; the JSON refines the\n * decision.\n */\n\nimport type { SessionStartEvent } from \"../../core/types.js\";\n\n/** Canonical Claude Code hook event names (the values of `hook_event_name`). */\nexport const CLAUDE_HOOK_EVENTS = [\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"PreCompact\",\n  \"SessionStart\",\n  \"SessionEnd\",\n  \"UserPromptSubmit\",\n  \"Stop\",\n  \"Notification\",\n  \"PermissionRequest\",\n  \"PostToolUseFailure\",\n  \"SubagentStart\",\n  \"SubagentStop\",\n] as const;\n\nexport type ClaudeHookEvent = (typeof CLAUDE_HOOK_EVENTS)[number];\n\n/**\n * Raw Claude Code hook stdin payload. Every field is optional — a given event\n * only populates the subset relevant to it. `connector` is NOT a Claude field;\n * it is threaded in by the universal entrypoint so parseEvent can recover the\n * connector id (the home binary passes `--connector <id>` and may inject it).\n */\nexport interface ClaudeWireInput {\n  session_id?: string;\n  transcript_path?: string;\n  cwd?: string;\n  hook_event_name?: string;\n\n  // tool events\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  /** PostToolUse result payload (string or structured). */\n  tool_response?: unknown;\n\n  // PermissionRequest — permission-update entries the dialog would offer.\n  // NOTE: the docs explicitly state PermissionRequest has NO tool_use_id.\n  permission_suggestions?: unknown[];\n\n  // PostToolUseFailure\n  tool_use_id?: string;\n  error?: string;\n  is_interrupt?: boolean;\n  duration_ms?: number;\n\n  // SubagentStart / SubagentStop — agent_type is unreliable on SubagentStop\n  // (the SDK may not populate it); treat both as optional everywhere.\n  agent_id?: string;\n  agent_type?: string;\n  // SubagentStop — the subagent's OWN transcript (transcript_path stays the\n  // parent session's) + the text of its final response.\n  agent_transcript_path?: string;\n  last_assistant_message?: string;\n\n  // SessionStart\n  source?: string;\n  // SessionEnd\n  reason?: string;\n  // UserPromptSubmit\n  prompt?: string;\n  // PreCompact\n  trigger?: string;\n  // Stop / SubagentStop\n  stop_hook_active?: boolean;\n  // Notification\n  message?: string;\n\n  /** Injected by the entrypoint so the runtime knows which connector to dispatch. */\n  connector?: string;\n}\n\n/**\n * Extract a stable session id from a Claude wire payload.\n * Priority mirrors the proven adapter: transcript UUID > session_id > \"\".\n * (The framework's normalized event uses \"\" when no id is available, per\n * core/types BaseEvent.sessionId docstring — no ppid fabrication here.)\n */\nexport function extractSessionId(input: ClaudeWireInput): string {\n  if (typeof input.transcript_path === \"string\") {\n    const m = input.transcript_path.match(/([a-f0-9-]{36})\\.jsonl$/);\n    if (m && m[1]) return m[1];\n  }\n  if (typeof input.session_id === \"string\" && input.session_id !== \"\") {\n    return input.session_id;\n  }\n  return \"\";\n}\n\n/** Coerce a Claude PostToolUse `tool_response` into a string for the normalized event. */\nexport function toolResponseToString(value: unknown): string | undefined {\n  if (value == null) return undefined;\n  if (typeof value === \"string\") return value;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Map a host's raw session-start \"source\" to the canonical SessionStart source. */\nexport function normalizeSessionSource(source: string | undefined): SessionStartEvent[\"source\"] {\n  switch (source) {\n    case \"compact\":\n      return \"compact\";\n    case \"resume\":\n      return \"resume\";\n    case \"clear\":\n      return \"clear\";\n    default:\n      return \"startup\";\n  }\n}\n"],"mappings":";;;AAkHO,SAAS,iBAAiB,OAAgC;AAC/D,MAAI,OAAO,MAAM,oBAAoB,UAAU;AAC7C,UAAM,IAAI,MAAM,gBAAgB,MAAM,yBAAyB;AAC/D,QAAI,KAAK,EAAE,CAAC,EAAG,QAAO,EAAE,CAAC;AAAA,EAC3B;AACA,MAAI,OAAO,MAAM,eAAe,YAAY,MAAM,eAAe,IAAI;AACnE,WAAO,MAAM;AAAA,EACf;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,OAAoC;AACvE,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAGO,SAAS,uBAAuB,QAAyD;AAC9F,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/{chunk-MDNX7HTN.js → chunk-HOE2MN36.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   REGISTERED_PLATFORM_IDS
-} from "./chunk-2F5QH3D4.js";
+} from "./chunk-XQUUNAGC.js";
 import {
   CONFIG_PATCH_SEGMENT_RE,
   configPatchNamespaceViolation,
@@ -495,4 +495,4 @@ export {
   defineConfigPatch,
   defineNativeHook
 };
-//# sourceMappingURL=chunk-MDNX7HTN.js.map
+//# sourceMappingURL=chunk-HOE2MN36.js.map

package/dist/{chunk-7L6ITC4T.js → chunk-IEGR4TP3.js}

@@ -9,13 +9,16 @@ ${stringifyYaml(frontmatter)}---
 ${body}
 `;
 }
-function renderCommandMd(cmd) {
+function renderCommandMd(cmd, opts = {}) {
+  const { includeToolsAndModel = true } = opts;
   const frontmatter = {};
   if (cmd.description !== void 0) frontmatter.description = cmd.description;
   if (cmd.argumentHint !== void 0) frontmatter["argument-hint"] = cmd.argumentHint;
-  const allow = cmd.tools?.allow;
-  if (allow && allow.length > 0) frontmatter["allowed-tools"] = allow.join(", ");
-  if (cmd.model !== void 0) frontmatter.model = cmd.model;
+  if (includeToolsAndModel) {
+    const allow = cmd.tools?.allow;
+    if (allow && allow.length > 0) frontmatter["allowed-tools"] = allow.join(", ");
+    if (cmd.model !== void 0) frontmatter.model = cmd.model;
+  }
   if (cmd.extra) Object.assign(frontmatter, cmd.extra);
   return renderFrontmatterMd(frontmatter, cmd.prompt);
 }
@@ -44,11 +47,24 @@ function renderSubagentMd(agent) {
   if (agent.extra) Object.assign(frontmatter, agent.extra);
   return renderFrontmatterMd(frontmatter, agent.prompt);
 }
+function renderOpenCodeSubagentMd(agent) {
+  const frontmatter = {
+    description: agent.description,
+    mode: "subagent"
+  };
+  if (agent.model !== void 0) frontmatter.model = agent.model;
+  if (agent.readonly === true) {
+    frontmatter.permission = { edit: "deny", bash: "deny" };
+  }
+  if (agent.extra) Object.assign(frontmatter, agent.extra);
+  return renderFrontmatterMd(frontmatter, agent.prompt);
+}
 
 export {
   renderFrontmatterMd,
   renderCommandMd,
   renderSkillMd,
-  renderSubagentMd
+  renderSubagentMd,
+  renderOpenCodeSubagentMd
 };
-//# sourceMappingURL=chunk-7L6ITC4T.js.map
+//# sourceMappingURL=chunk-IEGR4TP3.js.map

package/dist/chunk-IEGR4TP3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/claude-code/render.ts"],"sourcesContent":["/**\n * adapters/claude-code/render — shared content-surface renderers.\n *\n * The single source of truth for how a connector's commands / skills / subagents\n * are serialized into Claude Code's native `md + YAML-frontmatter` documents.\n * BOTH the live claude-code adapter (which writes into ~/.claude or .claude when\n * installing) AND `core/package` (which emits a marketplace-installable plugin\n * bundle) import these so the two paths produce BYTE-IDENTICAL output — there is\n * no second, subtly-different copy to drift.\n *\n * The frontmatter serializer reuses the `yaml` package (the same serializer\n * core/yaml and BaseAdapter.renderFrontmatterMd use): a `---` fence, the YAML\n * block, a closing `---`, a blank line, then the markdown body and a trailing\n * newline.\n */\n\nimport { stringify as stringifyYaml } from \"yaml\";\n\nimport type { CommandDef, SkillDef, SubagentDef } from \"../../core/types.js\";\n\n/**\n * Render a YAML-frontmatter + markdown body document:\n *   \"---\\n\" + <yaml> + \"---\\n\\n\" + <body> + \"\\n\".\n * Identical to BaseAdapter.renderFrontmatterMd (which now delegates here).\n */\nexport function renderFrontmatterMd(\n  frontmatter: Record<string, unknown>,\n  body: string,\n): string {\n  return `---\\n${stringifyYaml(frontmatter)}---\\n\\n${body}\\n`;\n}\n\n/**\n * Render a command to md+frontmatter\n * (description, argument-hint, allowed-tools, model + verbatim extra).\n *\n * `opts.includeToolsAndModel` (default `true`) controls the allowed-tools and\n * model insertions. Hosts whose command frontmatter is only\n * (description, argument-hint + verbatim extra) — i.e. they have no native\n * allowed-tools/model keys — pass `{ includeToolsAndModel: false }` to suppress\n * both; the default reproduces the full shape byte-for-byte.\n */\nexport function renderCommandMd(\n  cmd: CommandDef,\n  opts: { includeToolsAndModel?: boolean } = {},\n): string {\n  const { includeToolsAndModel = true } = opts;\n  const frontmatter: Record<string, unknown> = {};\n  if (cmd.description !== undefined) frontmatter.description = cmd.description;\n  if (cmd.argumentHint !== undefined) frontmatter[\"argument-hint\"] = cmd.argumentHint;\n  if (includeToolsAndModel) {\n    const allow = cmd.tools?.allow;\n    if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\n    if (cmd.model !== undefined) frontmatter.model = cmd.model;\n  }\n  if (cmd.extra) Object.assign(frontmatter, cmd.extra);\n  return renderFrontmatterMd(frontmatter, cmd.prompt);\n}\n\n/**\n * Render a skill's SKILL.md: frontmatter (name, description + optional model,\n * allowed-tools, disable-model-invocation, verbatim extra) + body.\n */\nexport function renderSkillMd(skill: SkillDef): string {\n  const frontmatter: Record<string, unknown> = {\n    name: skill.name,\n    description: skill.description,\n  };\n  if (skill.model !== undefined) frontmatter.model = skill.model;\n  const allow = skill.tools?.allow;\n  if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\n  if (skill.disableModelInvocation !== undefined) {\n    frontmatter[\"disable-model-invocation\"] = skill.disableModelInvocation;\n  }\n  if (skill.extra) Object.assign(frontmatter, skill.extra);\n  return renderFrontmatterMd(frontmatter, skill.body);\n}\n\n/** Render a subagent to md+frontmatter (name, description, tools, model) + prompt body. */\nexport function renderSubagentMd(agent: SubagentDef): string {\n  const frontmatter: Record<string, unknown> = {\n    name: agent.name,\n    description: agent.description,\n  };\n  const allow = agent.tools?.allow;\n  if (allow && allow.length > 0) frontmatter.tools = allow.join(\", \");\n  if (agent.model !== undefined) frontmatter.model = agent.model;\n  if (agent.extra) Object.assign(frontmatter, agent.extra);\n  return renderFrontmatterMd(frontmatter, agent.prompt);\n}\n\n/**\n * Render a subagent in OpenCode's shape (shared by opencode/kilo/mimo-code):\n * frontmatter (description, mode:\"subagent\", model?, permission? + verbatim\n * extra) with the system prompt as the body. `name` is NOT a frontmatter\n * field — it comes from the filename. `permission` is derived from the coarse\n * `readonly` knob: a readonly agent gets a per-tool deny map (edit/bash) so it\n * cannot mutate the workspace.\n */\nexport function renderOpenCodeSubagentMd(agent: SubagentDef): string {\n  const frontmatter: Record<string, unknown> = {\n    description: agent.description,\n    mode: \"subagent\",\n  };\n  if (agent.model !== undefined) frontmatter.model = agent.model;\n  if (agent.readonly === true) {\n    // Per-tool permission map: deny mutating tools for a readonly subagent.\n    frontmatter.permission = { edit: \"deny\", bash: \"deny\" };\n  }\n  if (agent.extra) Object.assign(frontmatter, agent.extra);\n  return renderFrontmatterMd(frontmatter, agent.prompt);\n}\n"],"mappings":";;;AAgBA,SAAS,aAAa,qBAAqB;AASpC,SAAS,oBACd,aACA,MACQ;AACR,SAAO;AAAA,EAAQ,cAAc,WAAW,CAAC;AAAA;AAAA,EAAU,IAAI;AAAA;AACzD;AAYO,SAAS,gBACd,KACA,OAA2C,CAAC,GACpC;AACR,QAAM,EAAE,uBAAuB,KAAK,IAAI;AACxC,QAAM,cAAuC,CAAC;AAC9C,MAAI,IAAI,gBAAgB,OAAW,aAAY,cAAc,IAAI;AACjE,MAAI,IAAI,iBAAiB,OAAW,aAAY,eAAe,IAAI,IAAI;AACvE,MAAI,sBAAsB;AACxB,UAAM,QAAQ,IAAI,OAAO;AACzB,QAAI,SAAS,MAAM,SAAS,EAAG,aAAY,eAAe,IAAI,MAAM,KAAK,IAAI;AAC7E,QAAI,IAAI,UAAU,OAAW,aAAY,QAAQ,IAAI;AAAA,EACvD;AACA,MAAI,IAAI,MAAO,QAAO,OAAO,aAAa,IAAI,KAAK;AACnD,SAAO,oBAAoB,aAAa,IAAI,MAAM;AACpD;AAMO,SAAS,cAAc,OAAyB;AACrD,QAAM,cAAuC;AAAA,IAC3C,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,EACrB;AACA,MAAI,MAAM,UAAU,OAAW,aAAY,QAAQ,MAAM;AACzD,QAAM,QAAQ,MAAM,OAAO;AAC3B,MAAI,SAAS,MAAM,SAAS,EAAG,aAAY,eAAe,IAAI,MAAM,KAAK,IAAI;AAC7E,MAAI,MAAM,2BAA2B,QAAW;AAC9C,gBAAY,0BAA0B,IAAI,MAAM;AAAA,EAClD;AACA,MAAI,MAAM,MAAO,QAAO,OAAO,aAAa,MAAM,KAAK;AACvD,SAAO,oBAAoB,aAAa,MAAM,IAAI;AACpD;AAGO,SAAS,iBAAiB,OAA4B;AAC3D,QAAM,cAAuC;AAAA,IAC3C,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,EACrB;AACA,QAAM,QAAQ,MAAM,OAAO;AAC3B,MAAI,SAAS,MAAM,SAAS,EAAG,aAAY,QAAQ,MAAM,KAAK,IAAI;AAClE,MAAI,MAAM,UAAU,OAAW,aAAY,QAAQ,MAAM;AACzD,MAAI,MAAM,MAAO,QAAO,OAAO,aAAa,MAAM,KAAK;AACvD,SAAO,oBAAoB,aAAa,MAAM,MAAM;AACtD;AAUO,SAAS,yBAAyB,OAA4B;AACnE,QAAM,cAAuC;AAAA,IAC3C,aAAa,MAAM;AAAA,IACnB,MAAM;AAAA,EACR;AACA,MAAI,MAAM,UAAU,OAAW,aAAY,QAAQ,MAAM;AACzD,MAAI,MAAM,aAAa,MAAM;AAE3B,gBAAY,aAAa,EAAE,MAAM,QAAQ,MAAM,OAAO;AAAA,EACxD;AACA,MAAI,MAAM,MAAO,QAAO,OAAO,aAAa,MAAM,KAAK;AACvD,SAAO,oBAAoB,aAAa,MAAM,MAAM;AACtD;","names":[]}

package/dist/{chunk-PFDUGDOA.js → chunk-KG6T3YNJ.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   renderFrontmatterMd
-} from "./chunk-7L6ITC4T.js";
+} from "./chunk-IEGR4TP3.js";
 import {
   buildHomeBinActionCommand,
   buildHomeBinHookCommand
-} from "./chunk-I5MLE6S7.js";
+} from "./chunk-TO57WYBB.js";
 import {
   MEMORY_CONTENT_SOFT_BUDGET_BYTES,
   listManagedBlocks,
@@ -1148,4 +1148,4 @@ export {
   removeFromObjectMap,
   BaseAdapter
 };
-//# sourceMappingURL=chunk-PFDUGDOA.js.map
+//# sourceMappingURL=chunk-KG6T3YNJ.js.map

package/dist/{chunk-YQLQJZ7S.js → chunk-MOW2RKHX.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   defineConnector
-} from "./chunk-MDNX7HTN.js";
+} from "./chunk-HOE2MN36.js";
 import {
   connectorDir,
   connectorsDir,
@@ -174,4 +174,4 @@ export {
   connectorFromMeta,
   listRegisteredConnectors
 };
-//# sourceMappingURL=chunk-YQLQJZ7S.js.map
+//# sourceMappingURL=chunk-MOW2RKHX.js.map

package/dist/{chunk-SDPIT4HW.js → chunk-NYR55UT7.js}

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

package/dist/{chunk-WFXWJITA.js → chunk-OZ5EXXQV.js}

@@ -2,7 +2,7 @@
 import {
   allAdapters,
   loadAdapter
-} from "./chunk-2F5QH3D4.js";
+} from "./chunk-XQUUNAGC.js";
 
 // src/sdk/introspect.ts
 var SURFACE_PREDICATES = {
@@ -41,4 +41,4 @@ export {
   hostsSupporting,
   surfaceSupport
 };
-//# sourceMappingURL=chunk-WFXWJITA.js.map
+//# sourceMappingURL=chunk-OZ5EXXQV.js.map

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

@@ -79,6 +79,19 @@ function buildServeWrapperCommand(homeBinPath, connectorId, realCommand, realArg
     args: [...flags, "--", realCommand, ...realArgs]
   };
 }
+function buildWrappedStdio(ctx, server, platformId, command, args) {
+  if (!shouldWrapForTelemetry(server, ctx.connector.telemetry)) {
+    return { command, args };
+  }
+  return buildServeWrapperCommand(
+    ctx.homeBinPath,
+    ctx.connector.id,
+    command,
+    args,
+    ctx.scope,
+    platformId
+  );
+}
 function resolveSpawnCommand(command, deps = {}) {
   const platform = deps.platform ?? process.platform;
   if (platform !== "win32") return { file: command, needsShell: false };
@@ -135,7 +148,8 @@ export {
   isHostNativeUsageEnabled,
   shouldWrapForTelemetry,
   buildServeWrapperCommand,
+  buildWrappedStdio,
   resolveSpawnCommand,
   detectLaunchMethod
 };
-//# sourceMappingURL=chunk-I5MLE6S7.js.map
+//# sourceMappingURL=chunk-TO57WYBB.js.map

package/dist/chunk-TO57WYBB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/spawn.ts"],"sourcesContent":["/**\n * core/spawn — cross-platform command construction.\n *\n * Borrowed from context-mode (issues #369/#372/#548/#738): bare `node` is\n * unreliable on Windows Git Bash (MSYS) and MSYS rewrites absolute paths on\n * non-C: drives. Always use the resolved runtime path, forward slashes, and\n * double-quoting. No-ops on macOS/Linux.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport type { InstallScope, PlatformId, ServerDef } from \"./types.js\";\nimport type { InstallContext } from \"../adapters/spi.js\";\nimport type {\n  LaunchMethod,\n  TelemetryInstallScope,\n} from \"../telemetry/types.js\";\n\n/**\n * Narrow the framework's 5-value {@link InstallScope} down to the two telemetry\n * slicing buckets: only a `project`-local install is `project`; everything else\n * (system/user/profile/managed) is global and reads as `user`.\n */\nexport function narrowInstallScope(scope: InstallScope): TelemetryInstallScope {\n  return scope === \"project\" ? \"project\" : \"user\";\n}\n\n/** Build `\"<nodePath>\" \"<scriptPath>\"`. */\nexport function buildNodeCommand(\n  scriptPath: string,\n  opts?: { nodePath?: string },\n): string {\n  const nodePath = (opts?.nodePath ?? process.execPath).replace(/\\\\/g, \"/\");\n  const safe = scriptPath.replace(/\\\\/g, \"/\");\n  return `\"${nodePath}\" \"${safe}\"`;\n}\n\n/**\n * Strict inverse of buildNodeCommand. Returns the two quoted tokens, or null if\n * `cmd` was not produced by buildNodeCommand (no fragile last-whitespace tail\n * grabbing — that was the #548 doubled-path bug when paths contained spaces).\n */\nexport function parseNodeCommand(\n  cmd: string,\n): { nodePath: string; scriptPath: string } | null {\n  if (typeof cmd !== \"string\" || cmd.length === 0) return null;\n  const m = cmd.match(/^\"([^\"]+)\"\\s+\"([^\"]+)\"\\s*$/);\n  if (!m || !m[1] || !m[2]) return null;\n  return { nodePath: m[1], scriptPath: m[2] };\n}\n\n/** Quote a single argument for inclusion in a host hook command string. */\nexport function quoteArg(arg: string): string {\n  return `\"${arg.replace(/\\\\/g, \"/\")}\"`;\n}\n\n/**\n * True when `hay` (slash-normalized) has the quoted home-bin path IMMEDIATELY\n * followed by `verb` — i.e. the verb sits in its command SLOT (right after the\n * home binary), not merely somewhere in the argument list. This distinguishes\n * `\"<bin>\" statusline …` from `\"<bin>\" action … statusline …`: the action verb\n * takes a free-form `actionId` positional that can legitimately equal another\n * verb's name (`statusline` / `usage-event` / `hook`), and only the SLOT\n * position identifies the real verb. `homeBinNorm` is the slash-normalized\n * home-bin path the caller already derived.\n */\nfunction hasVerbSlot(hay: string, homeBinNorm: string, verb: string): boolean {\n  return hay.includes(`\"${homeBinNorm}\" ${verb} `);\n}\n\n/**\n * Build the universal hook command a host config points at:\n *   \"<homeBin>\" hook <platformId> <event> --connector <id>\n * Pointing every host at the one stable home binary is how a single update\n * propagates everywhere (docs/ARCHITECTURE.md §3 R1).\n */\nexport function buildHomeBinHookCommand(\n  homeBinPath: string,\n  platformId: string,\n  event: string,\n  connectorId: string,\n): string {\n  return `${quoteArg(homeBinPath)} hook ${platformId} ${event} --connector ${connectorId}`;\n}\n\n/**\n * True when `command` is a home-bin hook command for exactly `connectorId`.\n *\n * Critical: the connector id is the LAST token of the hook command\n * (`... --connector <id>`), so a naive `command.includes(\"--connector \" + id)`\n * collides on shared-prefix ids — `--connector acme-db` contains\n * `--connector acme`, which would let uninstalling `acme` strip `acme-db`'s\n * hooks. We anchor the id token: the character after it must be end-of-string,\n * whitespace, or a closing double-quote (the JSON-embedded case). Connector ids\n * are kebab-case (ID_RE) so they never contain whitespace or quotes themselves.\n */\nexport function isHomeBinHookCommand(\n  command: string | undefined,\n  homeBinPath: string,\n  connectorId: string,\n): boolean {\n  if (!command) return false;\n  // The stored command was forward-slashed by quoteArg(); homeBinPath() yields\n  // NATIVE (back)slashes on Windows (node:path join). Normalize BOTH sides so the\n  // ownership substring test holds on win32 (without this, detection always\n  // returns false there → duplicate hooks on re-install + orphans on uninstall).\n  // No-op on POSIX.\n  const hay = command.replace(/\\\\/g, \"/\");\n  if (!hay.includes(homeBinPath.replace(/\\\\/g, \"/\"))) return false;\n  const token = `--connector ${connectorId}`;\n  let from = 0;\n  for (;;) {\n    const idx = hay.indexOf(token, from);\n    if (idx < 0) return false;\n    const after = hay.charAt(idx + token.length);\n    if (after === \"\" || after === '\"' || /\\s/.test(after)) return true;\n    from = idx + token.length;\n  }\n}\n\n/**\n * Build the OPT-IN host-native usage-event command an AfterModel / PostInvocation\n * hook points at:\n *   \"<homeBin>\" usage-event <platformId> --connector <id>\n * Mirrors {@link buildHomeBinHookCommand} (same anchoring rules apply) but routes\n * to the hidden `usage-event` entrypoint, which records a DISTINCT `model_turn`\n * row instead of dispatching a connector handler.\n */\nexport function buildUsageEventCommand(\n  homeBinPath: string,\n  platformId: string,\n  connectorId: string,\n): string {\n  return `${quoteArg(homeBinPath)} usage-event ${platformId} --connector ${connectorId}`;\n}\n\n/**\n * True when `command` is OUR host-native usage-event command for exactly\n * `connectorId`. Same end-of-token anchoring as {@link isHomeBinHookCommand} so a\n * shared-prefix id can't collide; additionally requires the ` usage-event ` verb\n * so it is never confused with a plain `hook` command during uninstall.\n */\nexport function isUsageEventCommand(\n  command: string | undefined,\n  homeBinPath: string,\n  connectorId: string,\n): boolean {\n  if (!command) return false;\n  // Normalize separators like isHomeBinHookCommand (win32 ownership detection).\n  const hay = command.replace(/\\\\/g, \"/\");\n  const homeBinNorm = homeBinPath.replace(/\\\\/g, \"/\");\n  if (!hay.includes(homeBinNorm)) return false;\n  if (!hasVerbSlot(hay, homeBinNorm, \"usage-event\")) return false;\n  return isHomeBinHookCommand(command, homeBinPath, connectorId);\n}\n\n/**\n * Build the home-bin statusline command a host's status line config points at:\n *   \"<homeBin>\" statusline <platformId> --connector <id>\n * Mirrors {@link buildHomeBinHookCommand} / {@link buildUsageEventCommand} (the\n * same single-home-binary indirection) but routes to the `statusline`\n * entrypoint, which renders the connector's HUD line for the host.\n */\nexport function buildHomeBinStatuslineCommand(\n  homeBinPath: string,\n  platformId: string,\n  connectorId: string,\n): string {\n  return `${quoteArg(homeBinPath)} statusline ${platformId} --connector ${connectorId}`;\n}\n\n/**\n * True when `command` is OUR home-bin statusline command for exactly\n * `connectorId`. Same end-of-token anchoring as {@link isHomeBinHookCommand} so a\n * shared-prefix id can't collide; additionally requires the ` statusline ` verb\n * so it is never confused with a plain `hook` / `usage-event` command.\n */\nexport function isHomeBinStatuslineCommand(\n  command: string | undefined,\n  homeBinPath: string,\n  connectorId: string,\n): boolean {\n  if (!command) return false;\n  // Normalize separators like isHomeBinHookCommand (win32 ownership detection).\n  const hay = command.replace(/\\\\/g, \"/\");\n  const homeBinNorm = homeBinPath.replace(/\\\\/g, \"/\");\n  if (!hay.includes(homeBinNorm)) return false;\n  if (!hasVerbSlot(hay, homeBinNorm, \"statusline\")) return false;\n  return isHomeBinHookCommand(command, homeBinPath, connectorId);\n}\n\n/**\n * Build the home-bin action command a future host affordance (slash command /\n * keybinding) points at:\n *   \"<homeBin>\" action <platformId> <actionId> --connector <id>\n * Mirrors {@link buildHomeBinStatuslineCommand} (the same single-home-binary\n * indirection) but routes to the `action` entrypoint, which re-imports the\n * connector and runs the named action's run(ctx). v1 ships only this command\n * builder + the runtime verb; no adapter EMITS the affordance yet.\n */\nexport function buildHomeBinActionCommand(\n  homeBinPath: string,\n  platformId: string,\n  actionId: string,\n  connectorId: string,\n): string {\n  return `${quoteArg(homeBinPath)} action ${platformId} ${actionId} --connector ${connectorId}`;\n}\n\n/**\n * True when `command` is OUR home-bin action command for exactly `connectorId`.\n * Same end-of-token anchoring as {@link isHomeBinHookCommand} so a shared-prefix\n * id can't collide; additionally requires the ` action ` verb so it is never\n * confused with a plain `hook` / `usage-event` / `statusline` command.\n */\nexport function isHomeBinActionCommand(\n  command: string | undefined,\n  homeBinPath: string,\n  connectorId: string,\n): boolean {\n  if (!command) return false;\n  // Normalize separators like isHomeBinHookCommand (win32 ownership detection).\n  const hay = command.replace(/\\\\/g, \"/\");\n  const homeBinNorm = homeBinPath.replace(/\\\\/g, \"/\");\n  if (!hay.includes(homeBinNorm)) return false;\n  if (!hasVerbSlot(hay, homeBinNorm, \"action\")) return false;\n  return isHomeBinHookCommand(command, homeBinPath, connectorId);\n}\n\n/**\n * Single source of truth for \"is OPT-IN host-native turn-usage capture enabled\n * for this connector?\" — read by the Gemini / Antigravity adapters at install\n * time to decide whether to ALSO write the AfterModel / PostInvocation usage hook.\n * Enabled when the connector opts in via telemetry.hostNativeUsage OR when the\n * install-time env switch AGENT_CONNECTOR_HOST_NATIVE=1 forces it on. Off by\n * default (privacy: host-native capture is never installed silently).\n */\nexport function isHostNativeUsageEnabled(\n  telemetry: { enabled: boolean; hostNativeUsage?: boolean },\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  if (telemetry.enabled !== true) return false;\n  if (env.AGENT_CONNECTOR_HOST_NATIVE === \"1\") return true;\n  return telemetry.hostNativeUsage === true;\n}\n\n/**\n * Single source of truth for \"should this server be wrapped by `serve` for\n * telemetry?\" — so every adapter behaves identically even for a server that\n * skipped normalizeServer (e.g. a per-platform override). On by default for an\n * stdio server with a command, unless explicitly disabled or telemetry is off.\n */\nexport function shouldWrapForTelemetry(\n  server: ServerDef,\n  telemetry: { enabled: boolean },\n): boolean {\n  return (\n    server.wrapForTelemetry !== false &&\n    telemetry.enabled === true &&\n    server.transport === \"stdio\" &&\n    typeof server.command === \"string\" &&\n    server.command !== \"\"\n  );\n}\n\n/**\n * Build the telemetry-wrapping server command:\n *   \"<homeBin>\" serve --connector <id> --scope <scope> --host <platformId> -- <realCommand> <realArgs...>\n * Used when a stdio server opts into transparent telemetry capture.\n *\n * `scope` records the install dimension (global user vs project-local) on every\n * telemetry row so usage can be sliced by it later. It is OPTIONAL for backward\n * compatibility: when omitted, the `--scope` flag is not emitted and the runtime\n * treats the scope as \"unknown\".\n *\n * `platformId` bakes the install TARGET platform into the wrapper so the proxy\n * stamps `hostPlatform` correctly even under a headless spawn where runtime env\n * markers are absent (detectRuntimeHost only knows claude-code/cursor/codex and\n * otherwise mis-attributes). Emitted as `--host <platformId>` in the FLAG\n * section (before `--`). It is OPTIONAL + backward-compatible: when omitted the\n * `--host` flag is not emitted and the runtime falls back to env detection.\n */\nexport function buildServeWrapperCommand(\n  homeBinPath: string,\n  connectorId: string,\n  realCommand: string,\n  realArgs: string[],\n  scope?: InstallScope,\n  platformId?: PlatformId,\n): { command: string; args: string[] } {\n  const flags = [\"serve\", \"--connector\", connectorId];\n  if (scope !== undefined) flags.push(\"--scope\", narrowInstallScope(scope));\n  if (platformId !== undefined) flags.push(\"--host\", platformId);\n  return {\n    command: homeBinPath,\n    args: [...flags, \"--\", realCommand, ...realArgs],\n  };\n}\n\n/**\n * Telemetry serve-wrap for a stdio command: when the connector opts in, route\n * `command`/`args` through `<homeBin> serve --connector <id> -- …`; otherwise\n * return them unchanged. Consolidates the per-host wrap snippet — the caller\n * keeps its own command/args seeding + downstream env-resolution + entry shaping.\n */\nexport function buildWrappedStdio(\n  ctx: Pick<InstallContext, \"homeBinPath\" | \"connector\" | \"scope\">,\n  server: ServerDef,\n  platformId: PlatformId,\n  command: string,\n  args: string[],\n): { command: string; args: string[] } {\n  if (!shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n    return { command, args };\n  }\n  return buildServeWrapperCommand(\n    ctx.homeBinPath,\n    ctx.connector.id,\n    command,\n    args,\n    ctx.scope,\n    platformId,\n  );\n}\n\n/** Injectable deps for {@link resolveSpawnCommand} (so the win32 branch is unit-testable on POSIX). */\nexport interface SpawnResolveDeps {\n  platform?: NodeJS.Platform;\n  /** PATH value (`;`-separated on Windows). */\n  pathEnv?: string;\n  /** PATHEXT value (`;`-separated). */\n  pathExt?: string;\n  /** File-existence probe (defaults to fs.existsSync). */\n  exists?: (p: string) => boolean;\n}\n\n/** How a child command should be handed to spawn() on this platform. */\nexport interface SpawnResolution {\n  /** The command to pass to spawn() (an absolute path on win32 when resolved). */\n  file: string;\n  /**\n   * Whether spawn() MUST use `shell: true`. On native Windows a `.cmd`/`.bat`\n   * shim (npx.cmd, pnpm.cmd, the agent-connector.cmd launcher) cannot be run by\n   * raw CreateProcess — Node throws EINVAL since the 2024 security fix unless a\n   * shell is used. `.exe` resolves directly with no shell.\n   */\n  needsShell: boolean;\n}\n\n/**\n * Resolve a child command for spawn() across platforms. NO-OP on macOS/Linux\n * (returns the command unchanged, no shell). On native Windows it fixes the two\n * spawn failure modes for bare package runners:\n *   1. raw CreateProcess ignores PATHEXT, so spawn(\"npx\") → ENOENT even though\n *      `npx.cmd` is on PATH. We search PATH × PATHEXT and return the resolved\n *      absolute path.\n *   2. a resolved `.cmd`/`.bat` still cannot be launched without a shell, so we\n *      flag `needsShell` for those (and `.exe`/`.com` run directly).\n * A bare name that PATH search misses falls back to `{ file: command,\n * needsShell: true }` so cmd.exe's own PATHEXT lookup still finds it.\n */\nexport function resolveSpawnCommand(\n  command: string,\n  deps: SpawnResolveDeps = {},\n): SpawnResolution {\n  const platform = deps.platform ?? process.platform;\n  if (platform !== \"win32\") return { file: command, needsShell: false };\n\n  const isBatch = (s: string): boolean => /\\.(cmd|bat)$/i.test(s);\n\n  // Already a path or already has an extension → don't search; only decide shell.\n  if (/[\\\\/]/.test(command) || /\\.[a-z0-9]+$/i.test(command)) {\n    return { file: command, needsShell: isBatch(command) };\n  }\n\n  const exists = deps.exists ?? existsSync;\n  const pathEnv = deps.pathEnv ?? process.env.PATH ?? process.env.Path ?? \"\";\n  const pathExt = deps.pathExt ?? process.env.PATHEXT ?? \".COM;.EXE;.BAT;.CMD\";\n  const dirs = pathEnv.split(\";\").filter((d) => d !== \"\");\n  const exts = pathExt.split(\";\").filter((e) => e !== \"\");\n  for (const dir of dirs) {\n    for (const ext of exts) {\n      const candidate = join(dir, command + ext);\n      if (exists(candidate)) return { file: candidate, needsShell: isBatch(ext) };\n    }\n  }\n  // Not found on PATH — let cmd.exe resolve it (handles shim dirs we may miss).\n  return { file: command, needsShell: true };\n}\n\n/** Basenames (case-insensitive, sans common extensions) of the ephemeral package runners. */\nconst PACKAGE_RUNNERS: Record<string, Extract<LaunchMethod, \"npx\" | \"bunx\" | \"uvx\">> = {\n  npx: \"npx\",\n  bunx: \"bunx\",\n  uvx: \"uvx\",\n};\n\n/** Basenames of language interpreters that launch a local script. */\nconst INTERPRETERS: ReadonlySet<string> = new Set([\"node\", \"bun\", \"deno\"]);\n\n/**\n * Strip a directory prefix and a trailing executable extension to get the bare\n * program name. Tolerates both POSIX and Windows separators (the wrapped command\n * may be an absolute Windows path) and lowercases for case-insensitive matching.\n */\nfunction commandBasename(realCommand: string): string {\n  const noDir = realCommand.replace(/\\\\/g, \"/\").split(\"/\").pop() ?? realCommand;\n  return noDir.replace(/\\.(exe|cmd|bat|com)$/i, \"\").toLowerCase();\n}\n\n/**\n * Classify how the real MCP server is launched, for the \"launch-method\" slicing\n * dimension. Package runners (npx/bunx/uvx) and interpreters (node/bun/deno) are\n * detected by the command basename. A remote (http) server is not launched\n * locally, so the caller — which alone knows the transport — passes\n * `isRemote: true` to force \"http\". Anything else resolves to \"binary\".\n */\nexport function detectLaunchMethod(\n  realCommand: string,\n  realArgs: string[],\n  opts?: { isRemote?: boolean },\n): LaunchMethod {\n  void realArgs; // reserved: args may later refine node-vs-script heuristics\n  if (opts?.isRemote === true) return \"http\";\n  if (typeof realCommand !== \"string\" || realCommand.trim() === \"\") {\n    return \"unknown\";\n  }\n  const base = commandBasename(realCommand);\n  if (base === \"\") return \"unknown\";\n  const runner = PACKAGE_RUNNERS[base];\n  if (runner !== undefined) return runner;\n  if (INTERPRETERS.has(base)) return \"node\";\n  return \"binary\";\n}\n"],"mappings":";;;AASA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAcd,SAAS,mBAAmB,OAA4C;AAC7E,SAAO,UAAU,YAAY,YAAY;AAC3C;AA2BO,SAAS,SAAS,KAAqB;AAC5C,SAAO,IAAI,IAAI,QAAQ,OAAO,GAAG,CAAC;AACpC;AAYA,SAAS,YAAY,KAAa,aAAqB,MAAuB;AAC5E,SAAO,IAAI,SAAS,IAAI,WAAW,KAAK,IAAI,GAAG;AACjD;AAQO,SAAS,wBACd,aACA,YACA,OACA,aACQ;AACR,SAAO,GAAG,SAAS,WAAW,CAAC,SAAS,UAAU,IAAI,KAAK,gBAAgB,WAAW;AACxF;AAaO,SAAS,qBACd,SACA,aACA,aACS;AACT,MAAI,CAAC,QAAS,QAAO;AAMrB,QAAM,MAAM,QAAQ,QAAQ,OAAO,GAAG;AACtC,MAAI,CAAC,IAAI,SAAS,YAAY,QAAQ,OAAO,GAAG,CAAC,EAAG,QAAO;AAC3D,QAAM,QAAQ,eAAe,WAAW;AACxC,MAAI,OAAO;AACX,aAAS;AACP,UAAM,MAAM,IAAI,QAAQ,OAAO,IAAI;AACnC,QAAI,MAAM,EAAG,QAAO;AACpB,UAAM,QAAQ,IAAI,OAAO,MAAM,MAAM,MAAM;AAC3C,QAAI,UAAU,MAAM,UAAU,OAAO,KAAK,KAAK,KAAK,EAAG,QAAO;AAC9D,WAAO,MAAM,MAAM;AAAA,EACrB;AACF;AAUO,SAAS,uBACd,aACA,YACA,aACQ;AACR,SAAO,GAAG,SAAS,WAAW,CAAC,gBAAgB,UAAU,gBAAgB,WAAW;AACtF;AAQO,SAAS,oBACd,SACA,aACA,aACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,MAAM,QAAQ,QAAQ,OAAO,GAAG;AACtC,QAAM,cAAc,YAAY,QAAQ,OAAO,GAAG;AAClD,MAAI,CAAC,IAAI,SAAS,WAAW,EAAG,QAAO;AACvC,MAAI,CAAC,YAAY,KAAK,aAAa,aAAa,EAAG,QAAO;AAC1D,SAAO,qBAAqB,SAAS,aAAa,WAAW;AAC/D;AASO,SAAS,8BACd,aACA,YACA,aACQ;AACR,SAAO,GAAG,SAAS,WAAW,CAAC,eAAe,UAAU,gBAAgB,WAAW;AACrF;AAQO,SAAS,2BACd,SACA,aACA,aACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,MAAM,QAAQ,QAAQ,OAAO,GAAG;AACtC,QAAM,cAAc,YAAY,QAAQ,OAAO,GAAG;AAClD,MAAI,CAAC,IAAI,SAAS,WAAW,EAAG,QAAO;AACvC,MAAI,CAAC,YAAY,KAAK,aAAa,YAAY,EAAG,QAAO;AACzD,SAAO,qBAAqB,SAAS,aAAa,WAAW;AAC/D;AAWO,SAAS,0BACd,aACA,YACA,UACA,aACQ;AACR,SAAO,GAAG,SAAS,WAAW,CAAC,WAAW,UAAU,IAAI,QAAQ,gBAAgB,WAAW;AAC7F;AAQO,SAAS,uBACd,SACA,aACA,aACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,MAAM,QAAQ,QAAQ,OAAO,GAAG;AACtC,QAAM,cAAc,YAAY,QAAQ,OAAO,GAAG;AAClD,MAAI,CAAC,IAAI,SAAS,WAAW,EAAG,QAAO;AACvC,MAAI,CAAC,YAAY,KAAK,aAAa,QAAQ,EAAG,QAAO;AACrD,SAAO,qBAAqB,SAAS,aAAa,WAAW;AAC/D;AAUO,SAAS,yBACd,WACA,MAAyB,QAAQ,KACxB;AACT,MAAI,UAAU,YAAY,KAAM,QAAO;AACvC,MAAI,IAAI,gCAAgC,IAAK,QAAO;AACpD,SAAO,UAAU,oBAAoB;AACvC;AAQO,SAAS,uBACd,QACA,WACS;AACT,SACE,OAAO,qBAAqB,SAC5B,UAAU,YAAY,QACtB,OAAO,cAAc,WACrB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY;AAEvB;AAmBO,SAAS,yBACd,aACA,aACA,aACA,UACA,OACA,YACqC;AACrC,QAAM,QAAQ,CAAC,SAAS,eAAe,WAAW;AAClD,MAAI,UAAU,OAAW,OAAM,KAAK,WAAW,mBAAmB,KAAK,CAAC;AACxE,MAAI,eAAe,OAAW,OAAM,KAAK,UAAU,UAAU;AAC7D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,CAAC,GAAG,OAAO,MAAM,aAAa,GAAG,QAAQ;AAAA,EACjD;AACF;AAQO,SAAS,kBACd,KACA,QACA,YACA,SACA,MACqC;AACrC,MAAI,CAAC,uBAAuB,QAAQ,IAAI,UAAU,SAAS,GAAG;AAC5D,WAAO,EAAE,SAAS,KAAK;AAAA,EACzB;AACA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,IAAI,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA,IAAI;AAAA,IACJ;AAAA,EACF;AACF;AAsCO,SAAS,oBACd,SACA,OAAyB,CAAC,GACT;AACjB,QAAM,WAAW,KAAK,YAAY,QAAQ;AAC1C,MAAI,aAAa,QAAS,QAAO,EAAE,MAAM,SAAS,YAAY,MAAM;AAEpE,QAAM,UAAU,CAAC,MAAuB,gBAAgB,KAAK,CAAC;AAG9D,MAAI,QAAQ,KAAK,OAAO,KAAK,gBAAgB,KAAK,OAAO,GAAG;AAC1D,WAAO,EAAE,MAAM,SAAS,YAAY,QAAQ,OAAO,EAAE;AAAA,EACvD;AAEA,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,KAAK,WAAW,QAAQ,IAAI,QAAQ,QAAQ,IAAI,QAAQ;AACxE,QAAM,UAAU,KAAK,WAAW,QAAQ,IAAI,WAAW;AACvD,QAAM,OAAO,QAAQ,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AACtD,QAAM,OAAO,QAAQ,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AACtD,aAAW,OAAO,MAAM;AACtB,eAAW,OAAO,MAAM;AACtB,YAAM,YAAY,KAAK,KAAK,UAAU,GAAG;AACzC,UAAI,OAAO,SAAS,EAAG,QAAO,EAAE,MAAM,WAAW,YAAY,QAAQ,GAAG,EAAE;AAAA,IAC5E;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,SAAS,YAAY,KAAK;AAC3C;AAGA,IAAM,kBAAiF;AAAA,EACrF,KAAK;AAAA,EACL,MAAM;AAAA,EACN,KAAK;AACP;AAGA,IAAM,eAAoC,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;AAOzE,SAAS,gBAAgB,aAA6B;AACpD,QAAM,QAAQ,YAAY,QAAQ,OAAO,GAAG,EAAE,MAAM,GAAG,EAAE,IAAI,KAAK;AAClE,SAAO,MAAM,QAAQ,yBAAyB,EAAE,EAAE,YAAY;AAChE;AASO,SAAS,mBACd,aACA,UACA,MACc;AACd,OAAK;AACL,MAAI,MAAM,aAAa,KAAM,QAAO;AACpC,MAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK,MAAM,IAAI;AAChE,WAAO;AAAA,EACT;AACA,QAAM,OAAO,gBAAgB,WAAW;AACxC,MAAI,SAAS,GAAI,QAAO;AACxB,QAAM,SAAS,gBAAgB,IAAI;AACnC,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI,aAAa,IAAI,IAAI,EAAG,QAAO;AACnC,SAAO;AACT;","names":[]}

package/dist/chunk-UM5S7DKK.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+// src/core/host-paths.ts
+import { homedir } from "os";
+import { join, resolve } from "path";
+function xdgConfigHome() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  return xdg && xdg.trim() !== "" ? resolve(xdg) : join(homedir(), ".config");
+}
+function roamingAppData() {
+  const appData = process.env.APPDATA;
+  return appData && appData.trim() !== "" ? resolve(appData) : join(homedir(), "AppData", "Roaming");
+}
+function localAppData() {
+  const local = process.env.LOCALAPPDATA;
+  return local && local.trim() !== "" ? resolve(local) : join(homedir(), "AppData", "Local");
+}
+function codexConfigHome() {
+  const env = process.env.CODEX_HOME;
+  if (env && env.trim() !== "") {
+    if (env.startsWith("~")) return join(homedir(), env.replace(/^~[/\\]?/, ""));
+    return resolve(env);
+  }
+  return join(homedir(), ".codex");
+}
+
+export {
+  xdgConfigHome,
+  roamingAppData,
+  localAppData,
+  codexConfigHome
+};
+//# sourceMappingURL=chunk-UM5S7DKK.js.map

package/dist/chunk-UM5S7DKK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/host-paths.ts"],"sourcesContent":["// ─────────────────────────────────────────────────────────────────────────\n// host-paths.ts — shared OS user-config-dir base resolvers\n//\n// Several adapters resolve the SAME per-OS \"user config base\" directory with\n// the same logic (XDG on posix; %APPDATA%/%LOCALAPPDATA% on Windows, each with\n// a ~/AppData fallback). These helpers consolidate that resolution so the\n// per-host adapters only carry their host-specific SUFFIX. The result is\n// byte-identical for absolute/clean config-dir inputs (the realistic case);\n// a non-canonical env value (relative, trailing slash, `..`) is normalized via\n// `resolve()` rather than passed through bare — a safe canonicalization.\n//\n// Scope note: these are the USER-CONFIG-DIR bases (where a host keeps its\n// settings/config files). The agent-connector *data-root* paths (our own\n// per-project state) live in core/paths.ts — do NOT conflate the two.\n//\n// Host-specific config-home resolvers that are SHARED across modules (e.g.\n// `codexConfigHome`, used by BOTH the codex adapter and marketplace detection)\n// DO live here, so the writer and the probe can never disagree on the dir.\n// Single-caller host envs (PI_CODING_AGENT_DIR, OPENCLAW_*) stay in their own\n// adapter.\n// ─────────────────────────────────────────────────────────────────────────\n\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\n\n/** $XDG_CONFIG_HOME when set & non-empty, else ~/.config. */\nexport function xdgConfigHome(): string {\n  const xdg = process.env.XDG_CONFIG_HOME;\n  return xdg && xdg.trim() !== \"\" ? resolve(xdg) : join(homedir(), \".config\");\n}\n\n/** %APPDATA% (Roaming) when set & non-empty, else ~/AppData/Roaming. */\nexport function roamingAppData(): string {\n  const appData = process.env.APPDATA;\n  return appData && appData.trim() !== \"\"\n    ? resolve(appData)\n    : join(homedir(), \"AppData\", \"Roaming\");\n}\n\n/** %LOCALAPPDATA% when set & non-empty, else ~/AppData/Local. */\nexport function localAppData(): string {\n  const local = process.env.LOCALAPPDATA;\n  return local && local.trim() !== \"\"\n    ? resolve(local)\n    : join(homedir(), \"AppData\", \"Local\");\n}\n\n/** Codex's config home: $CODEX_HOME (tilde-expanded, then resolved) when set\n *  & non-empty, else ~/.codex. Shared by the codex adapter (writer) and the\n *  marketplace detection probe so they never disagree on the config dir. */\nexport function codexConfigHome(): string {\n  const env = process.env.CODEX_HOME;\n  if (env && env.trim() !== \"\") {\n    if (env.startsWith(\"~\")) return join(homedir(), env.replace(/^~[/\\\\]?/, \"\"));\n    return resolve(env);\n  }\n  return join(homedir(), \".codex\");\n}\n"],"mappings":";;;AAsBA,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAGvB,SAAS,gBAAwB;AACtC,QAAM,MAAM,QAAQ,IAAI;AACxB,SAAO,OAAO,IAAI,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI,KAAK,QAAQ,GAAG,SAAS;AAC5E;AAGO,SAAS,iBAAyB;AACvC,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,WAAW,QAAQ,KAAK,MAAM,KACjC,QAAQ,OAAO,IACf,KAAK,QAAQ,GAAG,WAAW,SAAS;AAC1C;AAGO,SAAS,eAAuB;AACrC,QAAM,QAAQ,QAAQ,IAAI;AAC1B,SAAO,SAAS,MAAM,KAAK,MAAM,KAC7B,QAAQ,KAAK,IACb,KAAK,QAAQ,GAAG,WAAW,OAAO;AACxC;AAKO,SAAS,kBAA0B;AACxC,QAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,OAAO,IAAI,KAAK,MAAM,IAAI;AAC5B,QAAI,IAAI,WAAW,GAAG,EAAG,QAAO,KAAK,QAAQ,GAAG,IAAI,QAAQ,YAAY,EAAE,CAAC;AAC3E,WAAO,QAAQ,GAAG;AAAA,EACpB;AACA,SAAO,KAAK,QAAQ,GAAG,QAAQ;AACjC;","names":[]}

package/dist/{chunk-6RYPUR6O.js → chunk-VRKTVCYJ.js}

@@ -2,7 +2,7 @@
 import {
   installInstructions,
   packageConnector
-} from "./chunk-7ECYDK5T.js";
+} from "./chunk-CDVOBKSG.js";
 import {
   MARKETPLACE_NAME,
   agyPluginInstalled,
@@ -38,13 +38,13 @@ import {
   readMarketplaceInstalls,
   readNpmConfig,
   writeMarketplaceInstalls
-} from "./chunk-G5CQHVQG.js";
+} from "./chunk-7TVBFRVI.js";
 import {
   spawnChild
-} from "./chunk-F5RX62T7.js";
+} from "./chunk-7QRUZAUG.js";
 import {
   detectInstalledPlatforms
-} from "./chunk-SDPIT4HW.js";
+} from "./chunk-NYR55UT7.js";
 import {
   log
 } from "./chunk-KHO5WNTP.js";
@@ -52,11 +52,11 @@ import {
   deregisterConnector,
   loadRegisteredConnector,
   registerConnector
-} from "./chunk-YQLQJZ7S.js";
+} from "./chunk-MOW2RKHX.js";
 import {
   REGISTERED_PLATFORM_IDS,
   loadAdapter
-} from "./chunk-2F5QH3D4.js";
+} from "./chunk-XQUUNAGC.js";
 import {
   configPatchManualEdit
 } from "./chunk-FAHIMJRU.js";
@@ -3032,4 +3032,4 @@ export {
   upgradeViaMarketplace,
   marketplaceDoctorChecks
 };
-//# sourceMappingURL=chunk-6RYPUR6O.js.map
+//# sourceMappingURL=chunk-VRKTVCYJ.js.map

package/dist/{chunk-HAIMYUEY.js → chunk-WI6YSXOC.js}

@@ -12,11 +12,11 @@ import {
 import {
   loadRegisteredConnector,
   readRegisteredMeta
-} from "./chunk-YQLQJZ7S.js";
+} from "./chunk-MOW2RKHX.js";
 import {
   REGISTERED_PLATFORM_IDS,
   loadAdapter
-} from "./chunk-2F5QH3D4.js";
+} from "./chunk-XQUUNAGC.js";
 import {
   projectIdentity
 } from "./chunk-TRQKHP7D.js";
@@ -348,4 +348,4 @@ export {
   isNativeHookDeclared,
   runNativeHook
 };
-//# sourceMappingURL=chunk-HAIMYUEY.js.map
+//# sourceMappingURL=chunk-WI6YSXOC.js.map

package/dist/{chunk-2F5QH3D4.js → chunk-XQUUNAGC.js}

@@ -4,39 +4,39 @@
 var ADAPTER_REGISTRY = [
   {
     id: "claude-code",
-    load: () => import("./claude-code-ROSIILTM.js").then((m) => m.default)
+    load: () => import("./claude-code-64X6RR2S.js").then((m) => m.default)
   },
   {
     id: "codex",
-    load: () => import("./codex-YBBTIDD4.js").then((m) => m.default)
+    load: () => import("./codex-EEVN43C2.js").then((m) => m.default)
   },
   {
     id: "cursor",
-    load: () => import("./cursor-JBS4B3Q4.js").then((m) => m.default)
+    load: () => import("./cursor-GJBSMXI6.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-6EOZDLXC.js").then((m) => m.default)
+    load: () => import("./vscode-copilot-B2QBBHJW.js").then((m) => m.default)
   },
   {
     id: "copilot-cli",
-    load: () => import("./copilot-cli-Y74SOP5G.js").then((m) => m.default)
+    load: () => import("./copilot-cli-A7G5WB4N.js").then((m) => m.default)
   },
   {
     id: "gemini-cli",
-    load: () => import("./gemini-cli-RAONGZRG.js").then((m) => m.default)
+    load: () => import("./gemini-cli-CFPFEJEA.js").then((m) => m.default)
   },
   {
     id: "warp",
-    load: () => import("./warp-N5YYN5BF.js").then((m) => m.default)
+    load: () => import("./warp-5R54ST3N.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-QKZ5EIYU.js").then((m) => m.default)
+    load: () => import("./opencode-ZFSUYJXI.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
@@ -45,7 +45,7 @@ var ADAPTER_REGISTRY = [
   // constraint vs opencode (no shared config file to disambiguate).
   {
     id: "mimo-code",
-    load: () => import("./mimo-code-RFLQ727H.js").then((m) => m.default)
+    load: () => import("./mimo-code-BEE622P2.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;
@@ -54,23 +54,23 @@ var ADAPTER_REGISTRY = [
   // the "kilo" extension so there is no fork-ordering constraint between them.
   {
     id: "kilo-cli",
-    load: () => import("./kilo-cli-TDCONH5G.js").then((m) => m.default)
+    load: () => import("./kilo-cli-6UVWCXQD.js").then((m) => m.default)
   },
   // Wave 1 — mcp-only adapters (no lifecycle hooks; MCP registration only).
   {
     id: "droid",
-    load: () => import("./droid-TJMTNCQE.js").then((m) => m.default)
+    load: () => import("./droid-RBWCFKL3.js").then((m) => m.default)
   },
   {
     id: "roo-code",
-    load: () => import("./roo-code-AGGJ473T.js").then((m) => m.default)
+    load: () => import("./roo-code-XH4GCYIS.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-FERJ3X46.js").then((m) => m.default)
+    load: () => import("./kilo-BKZJ26RM.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.
@@ -81,11 +81,11 @@ var ADAPTER_REGISTRY = [
   // is NO fork-before-parent ordering constraint here; it simply sits beside them.
   {
     id: "cline",
-    load: () => import("./cline-JUTO4V27.js").then((m) => m.default)
+    load: () => import("./cline-T7ZDJYZQ.js").then((m) => m.default)
   },
   {
     id: "trae",
-    load: () => import("./trae-6L226ZDU.js").then((m) => m.default)
+    load: () => import("./trae-RVNRSV7X.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
@@ -93,69 +93,69 @@ var ADAPTER_REGISTRY = [
   // before the IDE/parent during host detection.
   {
     id: "antigravity-cli",
-    load: () => import("./antigravity-cli-D4PCCUG2.js").then((m) => m.default)
+    load: () => import("./antigravity-cli-VTQ6DNWL.js").then((m) => m.default)
   },
   {
     id: "antigravity",
-    load: () => import("./antigravity-VK2Y3FGV.js").then((m) => m.default)
+    load: () => import("./antigravity-DWW35HZO.js").then((m) => m.default)
   },
   {
     id: "zed",
-    load: () => import("./zed-6P2UFWXU.js").then((m) => m.default)
+    load: () => import("./zed-FDJHJZKD.js").then((m) => m.default)
   },
   {
     id: "amp",
-    load: () => import("./amp-JPBQJJVM.js").then((m) => m.default)
+    load: () => import("./amp-PU4LFSY6.js").then((m) => m.default)
   },
   {
     id: "codebuff",
-    load: () => import("./codebuff-2QUHL6HO.js").then((m) => m.default)
+    load: () => import("./codebuff-PPPY3SJV.js").then((m) => m.default)
   },
   {
     id: "mux",
-    load: () => import("./mux-D77HBSBU.js").then((m) => m.default)
+    load: () => import("./mux-5HTNKK4K.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-YGBXYWY5.js").then((m) => m.default)
+    load: () => import("./pi-H2KBBDDJ.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-DNXSLQE5.js").then((m) => m.default)
+    load: () => import("./jetbrains-copilot-K26KMA3U.js").then((m) => m.default)
   },
   {
     id: "qwen-code",
-    load: () => import("./qwen-code-E2MSEZK6.js").then((m) => m.default)
+    load: () => import("./qwen-code-5LE34FNE.js").then((m) => m.default)
   },
   {
     id: "kiro",
-    load: () => import("./kiro-X7JVLAN7.js").then((m) => m.default)
+    load: () => import("./kiro-J5J42I5Z.js").then((m) => m.default)
   },
   {
     id: "kimi",
-    load: () => import("./kimi-RIRD4J5J.js").then((m) => m.default)
+    load: () => import("./kimi-QALYPSRR.js").then((m) => m.default)
   },
   {
     id: "crush",
-    load: () => import("./crush-GMEWLXK5.js").then((m) => m.default)
+    load: () => import("./crush-AH24GDDB.js").then((m) => m.default)
   },
   // Wave 3 — json-stdio adapters with YAML config (MCP in YAML; hooks per host).
   {
     id: "goose",
-    load: () => import("./goose-G4KKM6YU.js").then((m) => m.default)
+    load: () => import("./goose-UBJVQFUE.js").then((m) => m.default)
   },
   {
     id: "hermes",
-    load: () => import("./hermes-PJDTJE6F.js").then((m) => m.default)
+    load: () => import("./hermes-6FXGXLNL.js").then((m) => m.default)
   },
   // Wave 4 — ts-plugin adapters (generate a bridge module to the universal entrypoint).
   {
     id: "omp",
-    load: () => import("./omp-CO7IXURG.js").then((m) => m.default)
+    load: () => import("./omp-I3UTRBNP.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
@@ -168,11 +168,11 @@ var ADAPTER_REGISTRY = [
   // lands in the wrapped openclaw.json.
   {
     id: "nemoclaw",
-    load: () => import("./nemoclaw-LXUTMR56.js").then((m) => m.default)
+    load: () => import("./nemoclaw-DNFIZFDF.js").then((m) => m.default)
   },
   {
     id: "openclaw",
-    load: () => import("./openclaw-XWJLEW35.js").then((m) => m.default)
+    load: () => import("./openclaw-QE2LMWIF.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
@@ -182,7 +182,7 @@ var ADAPTER_REGISTRY = [
   // adapter installs MCP entries + the .amazonq/rules memory surface.
   {
     id: "amazon-q",
-    load: () => import("./amazon-q-W574ZX35.js").then((m) => m.default)
+    load: () => import("./amazon-q-5LJOB5L3.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
@@ -194,7 +194,7 @@ var ADAPTER_REGISTRY = [
   // fork-ordering constraint vs any sibling.
   {
     id: "continue",
-    load: () => import("./continue-W4TU4JSB.js").then((m) => m.default)
+    load: () => import("./continue-VLLZO4PM.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
@@ -208,7 +208,7 @@ var ADAPTER_REGISTRY = [
   // memory surface. Distinct ~/.codeium marker — no fork-ordering constraint.
   {
     id: "windsurf",
-    load: () => import("./windsurf-4TGSJIVV.js").then((m) => m.default)
+    load: () => import("./windsurf-L32UEOLY.js").then((m) => m.default)
   }
 ];
 var REGISTRY_BY_ID = new Map(
@@ -234,4 +234,4 @@ export {
   loadAdapter,
   allAdapters
 };
-//# sourceMappingURL=chunk-2F5QH3D4.js.map
+//# sourceMappingURL=chunk-XQUUNAGC.js.map