@ken-jo/agent-connector 0.4.67 → 0.4.79

package/dist/doctor-UNF7FCF4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/doctor.ts","../src/runtime/probe.ts"],"sourcesContent":["/**\n * cli/commands/doctor — health-check every detected platform.\n *\n * For each detected host (or the explicit --targets list) we load its adapter,\n * build a uniform InstallContext, and run adapter.doctor(ctx). Results are\n * printed as pass/warn/fail with any suggested fix. Exit code is non-zero when\n * any check fails (warns alone do not fail the command).\n *\n * The connector context comes from the local config when present; otherwise a\n * minimal id-only connector is used so path-only checks still run.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport type {\n  DiagnosticResult,\n  InstallScope,\n  PlatformId,\n  ResolvedConnector,\n} from \"../../core/types.js\";\nimport type { InstallContext } from \"../../adapters/spi.js\";\nimport { detectInstalledPlatforms } from \"../../adapters/detect.js\";\nimport { loadAdapter, REGISTERED_PLATFORM_IDS } from \"../../adapters/registry.js\";\nimport {\n  findConnectorConfig,\n  listRegisteredConnectors,\n  loadConnectorFromPath,\n  readRegisteredMeta,\n} from \"../../core/load-connector.js\";\nimport { syncConnector } from \"../../core/installer.js\";\nimport { marketplaceDoctorChecks } from \"../../core/marketplace.js\";\nimport { readMarketplaceInstalls } from \"../../core/marketplace-state.js\";\nimport { dataRoot, homeBinPath } from \"../../core/paths.js\";\nimport { probeStdioServer } from \"../../runtime/probe.js\";\nimport { explainHooks } from \"../../sdk/test-harness.js\";\nimport type { HookEventVerdict } from \"../../sdk/test-harness.js\";\nimport { fail, parseScope, parseTargets, print } from \"../app.js\";\n\nconst STATUS_GLYPH: Record<DiagnosticResult[\"status\"], string> = {\n  pass: \"[pass]\",\n  warn: \"[warn]\",\n  fail: \"[FAIL]\",\n};\n\n/** A resolved connector together with the path to its source module. */\ninterface ConnectorEntry {\n  connector: ResolvedConnector;\n  /** Absolute path to the connector source (JSON or JS/TS). Used by syncConnector. */\n  modulePath: string;\n}\n\n/**\n * Resolve which connector(s) doctor should health-check, in precedence order:\n *   1. An explicit --connector path, or a local agent-connector.config.* file.\n *   2. Every connector registered under the data-root (what is actually\n *      installed). This is the common case — `doctor` from anywhere reports on\n *      the real installs, not a guess from the working directory.\n *   3. A minimal id-only placeholder so path-only checks still run.\n */\nasync function resolveDoctorConnectors(\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<ConnectorEntry[] | { error: string }> {\n  // When the user explicitly passed --connector <path>, any load failure is an\n  // error they need to see — silently falling through to registered connectors\n  // would report on a completely different set of installs with no indication\n  // that the requested connector was never loaded.\n  if (connectorPath !== undefined) {\n    const { connector, modulePath } = await loadConnectorFromPath(connectorPath);\n    return [{ connector, modulePath }];\n  }\n\n  const configPath = findConnectorConfig(projectDir);\n  if (configPath) {\n    try {\n      const { connector, modulePath } = await loadConnectorFromPath(configPath);\n      return [{ connector, modulePath }];\n    } catch {\n      /* fall through — implicit discovery failure is a convenience, not an error */\n    }\n  }\n\n  const registered = listRegisteredConnectors();\n  if (registered.length > 0) {\n    return registered.map((connector) => {\n      const meta = readRegisteredMeta(connector.id);\n      return { connector, modulePath: meta?.modulePath ?? \"\" };\n    });\n  }\n\n  const fallback: ResolvedConnector = {\n    id: \"agent-connector\",\n    displayName: \"agent-connector\",\n    version: \"0.0.0\",\n    hooks: {},\n    hookEvents: [],\n    telemetry: {\n      enabled: true,\n      modelFamilyHint: \"auto\",\n      measureToolDefs: true,\n      hostNativeUsage: false,\n      store: \"ndjson\",\n      calibration: { anthropicCountTokens: false },\n    },\n    commands: [],\n    skills: [],\n    subagents: [],\n    memory: [],\n    actions: [],\n    platforms: {},\n    targets: \"auto\",\n  };\n  return [{ connector: fallback, modulePath: \"\" }];\n}\n\nfunction buildContext(\n  connector: ResolvedConnector,\n  id: PlatformId,\n  scope: InstallScope,\n  projectDir: string,\n): InstallContext {\n  return {\n    connector,\n    scope: connector.platforms[id]?.scope ?? scope,\n    projectDir,\n    homeBinPath: homeBinPath(),\n    dataRoot: dataRoot(),\n    dryRun: true,\n  };\n}\n\n/** Collected diagnostics tagged with the connector entry they came from. */\ninterface TaggedResult {\n  result: DiagnosticResult;\n  /** Index into the entries array — used to group by connector for heal. */\n  entryIndex: number;\n}\n\n/**\n * Run all diagnostic checks for the given entries/ids and return tagged results\n * plus the flat byPlatform buckets for display.\n */\nasync function collectDiagnostics(\n  entries: ConnectorEntry[],\n  ids: PlatformId[],\n  scope: InstallScope,\n  projectDir: string,\n): Promise<{\n  byPlatform: { platform: PlatformId; results: DiagnosticResult[] }[];\n  tagged: TaggedResult[];\n  anyFail: boolean;\n}> {\n  const multi = entries.length > 1;\n  const byPlatform: { platform: PlatformId; results: DiagnosticResult[] }[] = [];\n  const tagged: TaggedResult[] = [];\n  let anyFail = false;\n\n  for (const id of ids) {\n    const adapter = await loadAdapter(id);\n    if (!adapter) {\n      const r: DiagnosticResult = {\n        check: `${id}: adapter`,\n        status: \"fail\",\n        message: `no adapter registered for ${id}`,\n      };\n      byPlatform.push({ platform: id, results: [r] });\n      anyFail = true;\n      continue;\n    }\n    const results: DiagnosticResult[] = [];\n    for (let i = 0; i < entries.length; i++) {\n      const { connector } = entries[i]!;\n      // A connector with an explicit target list is only checked on those hosts.\n      if (connector.targets !== \"auto\" && !connector.targets.includes(id)) continue;\n\n      // MARKETPLACE-installed on this host: its surfaces are delivered via the\n      // host's plugin (in the plugin cache), NOT the direct-config locations the\n      // adapter's doctor() inspects — so the direct checks would falsely FAIL\n      // (mcp_servers/command/skill \"not found\"). Skip them; the marketplace-method\n      // checks below cover this install's real health.\n      if (readMarketplaceInstalls(connector.id)[id]) {\n        const note: DiagnosticResult = {\n          check: `${connector.id}: ${id} delivery`,\n          status: \"pass\",\n          message: \"surfaces delivered via the marketplace plugin — see marketplace checks\",\n        };\n        const tagged_note = multi ? { ...note, check: `(${connector.id}) ${note.check}` } : note;\n        results.push(tagged_note);\n        tagged.push({ result: tagged_note, entryIndex: i });\n        continue;\n      }\n\n      const ctx = buildContext(connector, id, scope, projectDir);\n      let r: DiagnosticResult[];\n      try {\n        r = adapter.doctor(ctx);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        r = [{ check: `${adapter.name}: doctor`, status: \"fail\", message }];\n      }\n      // When checking multiple connectors, tag each check with the connector id.\n      const tagged_r = multi ? r.map((d) => ({ ...d, check: `(${connector.id}) ${d.check}` })) : r;\n      results.push(...tagged_r);\n      for (const tr of tagged_r) tagged.push({ result: tr, entryIndex: i });\n    }\n    if (results.some((d) => d.status === \"fail\")) anyFail = true;\n    byPlatform.push({ platform: id, results });\n  }\n\n  // ── Marketplace-method checks ─────────────────────────────────────────────\n  for (let i = 0; i < entries.length; i++) {\n    const { connector } = entries[i]!;\n    const groups = await marketplaceDoctorChecks(connector, scope, projectDir);\n    for (const group of groups) {\n      const tagged_g = multi\n        ? group.results.map((d) => ({ ...d, check: `(${connector.id}) ${d.check}` }))\n        : group.results;\n      if (tagged_g.some((d) => d.status === \"fail\")) anyFail = true;\n      for (const tg of tagged_g) tagged.push({ result: tg, entryIndex: i });\n      const bucket = byPlatform.find((b) => b.platform === group.platform);\n      if (bucket) bucket.results.push(...tagged_g);\n      else byPlatform.push({ platform: group.platform, results: tagged_g });\n    }\n  }\n\n  return { byPlatform, tagged, anyFail };\n}\n\nconst VERDICT_GLYPH: Record<HookEventVerdict[\"verdict\"], string> = {\n  honored: \"[honored]\",\n  degraded: \"[degraded]\",\n  dropped: \"[dropped]\",\n};\n\n/**\n * Resolve which hosts `--explain` reports a connector against: an explicit\n * --targets list (intersected with the registry), else the connector's declared\n * targets, else (targets:\"auto\") every registered host. Detection-independent —\n * the per-event honor verdict is a static/offline property a dev wants BEFORE\n * installing, not gated on what happens to be installed.\n */\nfunction explainHostsFor(\n  connector: ResolvedConnector,\n  explicit: PlatformId[] | undefined,\n): PlatformId[] {\n  if (explicit && explicit.length > 0) {\n    return explicit.filter((id) => REGISTERED_PLATFORM_IDS.has(id));\n  }\n  if (connector.targets !== \"auto\") {\n    return (connector.targets as PlatformId[]).filter((id) =>\n      REGISTERED_PLATFORM_IDS.has(id),\n    );\n  }\n  return [...REGISTERED_PLATFORM_IDS].sort();\n}\n\n/**\n * The exit rule for a single connector's per-event matrix. The principle: a\n * non-zero exit means \"something is wrong with YOUR connector\", NOT \"some host\n * cannot do hooks as designed\". So:\n *   • `dropped` (mcp-only host / no native equivalent) is EXPECTED and NEVER\n *     fails — it mirrors install's `skip` (= exit 0) for the very same\n *     no-equivalent case the never-silent-skip work ships;\n *   • `degraded` (the host FIRES the event but silently won't honor the reply,\n *     e.g. a deny that fails open) is genuine silent misbehavior — but only a\n *     finding worth FAILING on when the dev EXPLICITLY targeted that host\n *     (`--targets`, or the connector's own `targets:[...]`). Under `targets:\"auto\"`\n *     the matrix spans the whole fleet, where such gaps are expected, so it stays\n *     informational (exit 0) — matching plain-doctor's scope-aware non-failure.\n */\nfunction explainConnectorFails(\n  rows: HookEventVerdict[],\n  scoped: boolean,\n): boolean {\n  if (!scoped) return false;\n  return rows.some((row) => row.verdict === \"degraded\");\n}\n\n/**\n * The `doctor --explain` body: for each resolved connector, the per-(host,\n * event) honor matrix from {@link explainHooks} (honored / degraded / dropped\n * with the simulate()-grade reason). ALL rows are always printed (visibility is\n * never gated on the exit rule). The exit code follows {@link explainConnectorFails}:\n * only a `degraded` cell on an EXPLICITLY-targeted host fails the command — a\n * `dropped` cell (a host that architecturally cannot fire hooks) never does.\n */\nasync function runExplain(\n  entries: ConnectorEntry[],\n  explicit: PlatformId[] | undefined,\n  json: boolean,\n): Promise<number> {\n  const report: {\n    connector: string;\n    rows: HookEventVerdict[];\n    scoped: boolean;\n  }[] = [];\n  for (const { connector } of entries) {\n    // \"scoped\" = the dev narrowed the host set deliberately (an explicit\n    // --targets list, or the connector's own targets:[...]). Under targets:\"auto\"\n    // the matrix is fleet-wide and degraded cells stay informational.\n    const scoped =\n      (explicit != null && explicit.length > 0) || connector.targets !== \"auto\";\n    if (connector.hookEvents.length === 0) {\n      report.push({ connector: connector.id, rows: [], scoped });\n      continue;\n    }\n    const hosts = explainHostsFor(connector, explicit);\n    const rows = await explainHooks(connector, hosts);\n    report.push({ connector: connector.id, rows, scoped });\n  }\n\n  const anyFail = report.some((r) => explainConnectorFails(r.rows, r.scoped));\n\n  if (json) {\n    print(JSON.stringify(report.map(({ connector, rows }) => ({ connector, rows })), null, 2));\n    return anyFail ? 1 : 0;\n  }\n\n  for (const { connector, rows } of report) {\n    print(`${connector} — per-event hook honor:`);\n    if (rows.length === 0) {\n      print(\"  (connector declares no hooks)\");\n      print(\"\");\n      continue;\n    }\n    for (const row of rows) {\n      print(`  ${VERDICT_GLYPH[row.verdict]} ${row.host} / ${row.event} — ${row.reason}`);\n    }\n    print(\"\");\n  }\n  // Footer states the verdict AND the exit rule, so a `dropped`-only run that\n  // exits 0 (the common default-targets case) is not surprising.\n  if (anyFail) {\n    print(\n      \"doctor --explain: a declared hook event is DEGRADED on an explicitly-targeted host (the host fires it but silently won't honor the reply).\",\n    );\n  } else if (report.some((r) => r.rows.some((row) => row.verdict !== \"honored\"))) {\n    print(\n      \"doctor --explain: some hosts drop or degrade declared events (expected for mcp-only / fleet-wide gaps) — informational, exit 0.\",\n    );\n  } else {\n    print(\"doctor --explain: every declared hook event is honored on its target hosts.\");\n  }\n  return anyFail ? 1 : 0;\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n      probe: { type: \"boolean\", default: false },\n      heal: { type: \"boolean\", default: false },\n      explain: { type: \"boolean\", default: false },\n      \"dry-run\": { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const resolved = await resolveDoctorConnectors(values.connector, projectDir).catch(\n    (err: unknown) => ({\n      error: `cannot load connector \"${values.connector}\": ${err instanceof Error ? err.message : String(err)}`,\n    }),\n  );\n  if (\"error\" in resolved) return fail(resolved.error);\n  const entries = resolved;\n  const connectors = entries.map((e) => e.connector);\n\n  // ── Per-event explain path (--explain) ───────────────────────────────────\n  // Additive, OFFLINE detail layer: the trustworthy per-(host, event) honor\n  // matrix (honored / degraded / dropped) the coarse \"any hook present = OK\"\n  // doctor cannot give. Resolves hosts from the connector's OWN targets (or\n  // --targets), NOT from detection — a dev wants this BEFORE installing.\n  if (values.explain) {\n    return runExplain(entries, parseTargets(values.targets), values.json ?? false);\n  }\n\n  // Target set: explicit --targets (intersected with the registry), else the\n  // same chain install uses — connector-declared targets ∩ detected platforms\n  // (\"auto\" = everything detected). Without this, doctor red-flags every\n  // detected host the connector never targeted (found dogfooding context-mode:\n  // targets:[5 ids] installed clean, doctor FAILed the other 9 detected hosts).\n  const explicit = parseTargets(values.targets);\n  let ids: PlatformId[];\n  if (explicit && explicit.length > 0) {\n    ids = explicit.filter((id) => REGISTERED_PLATFORM_IDS.has(id));\n  } else {\n    const detected = await detectInstalledPlatforms(projectDir);\n    ids = detected.map((p) => p.id);\n    const anyAuto = connectors.some((c) => c.targets === \"auto\");\n    if (!anyAuto) {\n      const targeted = new Set(connectors.flatMap((c) => c.targets as PlatformId[]));\n      ids = ids.filter((id) => targeted.has(id));\n    }\n  }\n\n  if (ids.length === 0 && !values.probe) {\n    print(\"doctor: no target platforms (none detected; pass --targets to force).\");\n    return 0;\n  }\n\n  // ── Heal path ─────────────────────────────────────────────────────────────\n  if (values.heal) {\n    const { tagged, anyFail: preFail } = await collectDiagnostics(\n      entries,\n      ids,\n      scope,\n      projectDir,\n    );\n\n    // Partition: fixable vs deferred (non-pass, not fixable)\n    const fixableByEntry = new Map<number, DiagnosticResult[]>();\n    const deferredByEntry = new Map<number, DiagnosticResult[]>();\n    for (const { result, entryIndex } of tagged) {\n      if (result.status === \"pass\") continue;\n      // A finding is only HEALABLE if it is fixable AND its connector has a\n      // module path we can re-sync from. A placeholder/unregistered connector\n      // (empty modulePath) must NEVER be synced — doing so would fabricate a\n      // bogus registry record via registerConnector(connector, \"\"). Route its\n      // fixable findings to deferred instead.\n      const canSync = !!entries[entryIndex]!.modulePath;\n      if (result.fixable && canSync) {\n        if (!fixableByEntry.has(entryIndex)) fixableByEntry.set(entryIndex, []);\n        fixableByEntry.get(entryIndex)!.push(result);\n      } else {\n        if (!deferredByEntry.has(entryIndex)) deferredByEntry.set(entryIndex, []);\n        deferredByEntry.get(entryIndex)!.push(result);\n      }\n    }\n\n    if (values[\"dry-run\"]) {\n      // Dry-run: print what would happen, write nothing.\n      for (const [idx, fixable] of fixableByEntry) {\n        const { connector } = entries[idx]!;\n        print(\n          `would heal via sync (${connector.id}): ${fixable.map((r) => r.check).join(\", \")}`,\n        );\n      }\n      for (const [idx, deferred] of deferredByEntry) {\n        const { connector } = entries[idx]!;\n        for (const r of deferred) {\n          print(\n            `would defer (${connector.id}): ${r.check} — ${r.fix ?? \"no auto-fix available\"}`,\n          );\n        }\n      }\n      if (fixableByEntry.size === 0 && deferredByEntry.size === 0) {\n        print(\"doctor --heal --dry-run: nothing to heal.\");\n      }\n      return 0;\n    }\n\n    // Real heal: sync each connector that has fixable findings.\n    for (const [idx] of fixableByEntry) {\n      const { connector, modulePath } = entries[idx]!;\n      await syncConnector({\n        connector,\n        modulePath,\n        scope,\n        projectDir,\n        targets: ids,\n        dryRun: false,\n      });\n    }\n\n    // Re-run diagnostics to compute what changed.\n    const { tagged: postTagged, anyFail: postFail } = await collectDiagnostics(\n      entries,\n      ids,\n      scope,\n      projectDir,\n    );\n\n    // Classify post-heal results.\n    const preNonPass = new Set(\n      tagged\n        .filter((t) => t.result.status !== \"pass\")\n        .map((t) => t.result.check),\n    );\n    const postNonPass = new Set(\n      postTagged\n        .filter((t) => t.result.status !== \"pass\")\n        .map((t) => t.result.check),\n    );\n\n    const healed: string[] = [];\n    const stillFailing: DiagnosticResult[] = [];\n    const deferred: DiagnosticResult[] = [];\n\n    // Healed = was non-pass before, now pass\n    for (const check of preNonPass) {\n      if (!postNonPass.has(check)) healed.push(check);\n    }\n    // Post-heal non-pass findings. Classify consistently with the pre-heal\n    // partition: a fixable finding we could not sync (no modulePath) is deferred,\n    // not \"still failing after sync\" — we never attempted a sync for it.\n    for (const { result, entryIndex } of postTagged) {\n      if (result.status === \"pass\") continue;\n      const canSync = !!entries[entryIndex]!.modulePath;\n      if (result.fixable && canSync) {\n        stillFailing.push(result);\n      } else {\n        deferred.push(result);\n      }\n    }\n\n    if (values.json) {\n      print(JSON.stringify({ healed, deferred, stillFailing }, null, 2));\n      return postFail ? 1 : 0;\n    }\n\n    if (healed.length > 0) {\n      print(`healed (${healed.length}):`);\n      for (const c of healed) print(`  [pass] ${c}`);\n      print(\"\");\n    }\n    if (stillFailing.length > 0) {\n      print(`still failing after sync (${stillFailing.length}):`);\n      for (const r of stillFailing) {\n        print(`  ${STATUS_GLYPH[r.status]} ${r.check} — ${r.message}`);\n        if (r.fix) print(`         fix: ${r.fix}`);\n      }\n      print(\"\");\n    }\n    if (deferred.length > 0) {\n      print(`deferred — requires manual action (${deferred.length}):`);\n      for (const r of deferred) {\n        print(`  ${STATUS_GLYPH[r.status]} ${r.check} — ${r.message}`);\n        if (r.fix) print(`         fix: ${r.fix}`);\n      }\n      print(\"\");\n    }\n    if (healed.length === 0 && stillFailing.length === 0 && deferred.length === 0 && !preFail) {\n      print(\"doctor --heal: nothing to heal, all checks passed.\");\n    } else if (stillFailing.length === 0 && deferred.length === 0) {\n      print(\"doctor --heal: all fixable findings resolved.\");\n    }\n    return postFail ? 1 : 0;\n  }\n\n  // ── Normal diagnose path (no --heal) ─────────────────────────────────────\n  const { byPlatform, anyFail } = await collectDiagnostics(entries, ids, scope, projectDir);\n\n  // ── Live MCP probe (--probe): connector-scoped, not platform-scoped ──────\n  // Spawns each connector's REAL stdio server and runs initialize → ping →\n  // tools/list. Probe FAILs fold into the doctor exit code.\n  const probes: { connector: string; results: DiagnosticResult[] }[] = [];\n  if (values.probe) {\n    for (const { connector } of entries) {\n      const s = connector.server;\n      if (!s || s.transport !== \"stdio\" || !s.command) {\n        probes.push({\n          connector: connector.id,\n          results: [\n            {\n              check: `${connector.id}: MCP probe`,\n              status: \"warn\",\n              message: s\n                ? `transport \"${s.transport}\" is not stdio — live probe skipped`\n                : \"no server to probe\",\n            },\n          ],\n        });\n        continue;\n      }\n      const results = await probeStdioServer(s.command, s.args ?? [], {\n        label: connector.id,\n        ...(s.env ? { env: s.env } : {}),\n      });\n      probes.push({ connector: connector.id, results });\n    }\n  }\n\n  const probesFail = probes.some((p) => p.results.some((r) => r.status === \"fail\"));\n\n  if (values.json) {\n    print(JSON.stringify(values.probe ? { platforms: byPlatform, probes } : byPlatform, null, 2));\n    return anyFail || probesFail ? 1 : 0;\n  }\n\n  for (const { platform, results } of byPlatform) {\n    print(`${platform}:`);\n    for (const r of results) {\n      print(`  ${STATUS_GLYPH[r.status]} ${r.check} — ${r.message}`);\n      if (r.fix) print(`         fix: ${r.fix}`);\n    }\n    print(\"\");\n  }\n  for (const { connector, results } of probes) {\n    print(`probe ${connector}:`);\n    for (const r of results) {\n      print(`  ${STATUS_GLYPH[r.status]} ${r.check} — ${r.message}`);\n      if (r.fix) print(`         fix: ${r.fix}`);\n    }\n    print(\"\");\n  }\n  print(anyFail || probesFail ? \"doctor: one or more checks FAILED.\" : \"doctor: all checks passed.\");\n  return anyFail || probesFail ? 1 : 0;\n}\n","/**\n * runtime/probe — a live MCP connection-lifecycle probe for `doctor --probe`.\n *\n * Where `doctor` checks files on disk, this spawns the connector's REAL stdio\n * server and speaks the MCP wire protocol to it: initialize → (read negotiated\n * protocolVersion + capabilities + serverInfo) → notifications/initialized →\n * ping (liveness) → tools/list (gated on the tools capability). It reuses the\n * SAME newline-delimited JSON-RPC framing + id-correlation as the telemetry\n * proxy (telemetry/jsonrpc), so the probe and the serve path read the wire\n * identically. Each step becomes a DiagnosticResult so doctor renders/aggregates\n * it uniformly; a dead/unlaunchable server FAILs (non-zero doctor exit).\n *\n * Negotiation rule: we OFFER {@link MCP_PROTOCOL_VERSION} but ACCEPT whatever\n * version the server returns (we only report it), per the spec — never a\n * hardcoded equality. There is no MCP shutdown message; we close stdin then\n * SIGTERM/SIGKILL.\n */\n\nimport type { DiagnosticResult } from \"../core/types.js\";\nimport { MCP_PROTOCOL_VERSION } from \"../core/mcp-standard.js\";\nimport { spawnChild } from \"../core/spawn-child.js\";\nimport { type JsonRpcMessage, LineBuffer, idKey, isObject } from \"../telemetry/jsonrpc.js\";\n\nconst DEFAULT_TIMEOUT_MS = 5000;\n\nexport interface ProbeOptions {\n  /** Per-step timeout in ms (default 5000). */\n  timeoutMs?: number;\n  /** Prefix for each DiagnosticResult.check (e.g. the connector id). */\n  label?: string;\n  /** Env merged over process.env for the spawned server (${env:VAR} resolved). */\n  env?: Record<string, string>;\n  /** Protocol version offered in initialize. Default {@link MCP_PROTOCOL_VERSION}. */\n  protocolVersion?: string;\n}\n\nfunction diag(\n  status: DiagnosticResult[\"status\"],\n  check: string,\n  message: string,\n  fix?: string,\n): DiagnosticResult {\n  return { check, status, message, ...(fix ? { fix } : {}) };\n}\n\nfunction errMsg(e: unknown): string {\n  return e instanceof Error ? e.message : String(e);\n}\n\n/** Resolve `${env:VAR}` references in env values against the current process env. */\nfunction resolveEnv(env: Record<string, string> | undefined): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [k, v] of Object.entries(env ?? {})) {\n    out[k] = v.replace(/\\$\\{env:([A-Za-z_][A-Za-z0-9_]*)\\}/g, (_m, name) => process.env[name] ?? \"\");\n  }\n  return out;\n}\n\n/**\n * Spawn the stdio MCP server `command args` and run a real lifecycle probe.\n * Always resolves (never rejects) with one DiagnosticResult per step.\n */\nexport async function probeStdioServer(\n  command: string,\n  args: string[],\n  opts: ProbeOptions = {},\n): Promise<DiagnosticResult[]> {\n  const label = opts.label ? `${opts.label}: ` : \"\";\n  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const protocolVersion = opts.protocolVersion ?? MCP_PROTOCOL_VERSION;\n  const results: DiagnosticResult[] = [];\n\n  // spawnChild resolves a bare Windows package runner (npx/uvx → .cmd/.exe) so\n  // the probe agrees with the live serve path; no-op on macOS/Linux.\n  const child = spawnChild(command, args, {\n    stdio: [\"pipe\", \"pipe\", \"inherit\"],\n    env: { ...process.env, ...resolveEnv(opts.env) },\n  });\n\n  interface Pending {\n    resolve: (m: JsonRpcMessage) => void;\n    reject: (e: Error) => void;\n  }\n  const pending = new Map<string, Pending>();\n  let spawnErr: Error | null = null;\n  let exitCode: number | null = null;\n\n  const rejectAll = (e: Error): void => {\n    for (const p of pending.values()) p.reject(e);\n    pending.clear();\n  };\n  child.on(\"error\", (e) => {\n    spawnErr = e;\n    rejectAll(e);\n  });\n  child.on(\"exit\", (code) => {\n    exitCode = code ?? 0;\n    rejectAll(new Error(`server exited (code ${exitCode}) before responding`));\n  });\n\n  const lines = new LineBuffer((line) => {\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line);\n    } catch {\n      return; // non-JSON stdout noise — ignore\n    }\n    if (!isObject(parsed)) return;\n    const k = idKey((parsed as JsonRpcMessage).id);\n    if (k && pending.has(k)) {\n      const p = pending.get(k)!;\n      pending.delete(k);\n      p.resolve(parsed as JsonRpcMessage);\n    }\n  });\n  child.stdout?.on(\"data\", (c: Buffer) => lines.push(c));\n\n  const send = (m: JsonRpcMessage): void => {\n    if (child.stdin && child.stdin.writable) child.stdin.write(`${JSON.stringify(m)}\\n`);\n  };\n  const request = (id: number | string, method: string, params?: unknown): Promise<JsonRpcMessage> => {\n    const key = idKey(id)!;\n    return new Promise<JsonRpcMessage>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        pending.delete(key);\n        reject(new Error(`no response within ${timeoutMs}ms`));\n      }, timeoutMs);\n      if (typeof timer.unref === \"function\") timer.unref();\n      pending.set(key, {\n        resolve: (m) => {\n          clearTimeout(timer);\n          resolve(m);\n        },\n        reject: (e) => {\n          clearTimeout(timer);\n          reject(e);\n        },\n      });\n      send({ jsonrpc: \"2.0\", id, method, ...(params !== undefined ? { params } : {}) });\n    });\n  };\n\n  const cleanup = (): DiagnosticResult[] => {\n    try {\n      if (child.stdin && child.stdin.writable) child.stdin.end();\n    } catch {\n      /* ignore */\n    }\n    try {\n      child.kill(\"SIGTERM\");\n    } catch {\n      /* ignore */\n    }\n    const killTimer = setTimeout(() => {\n      try {\n        child.kill(\"SIGKILL\");\n      } catch {\n        /* ignore */\n      }\n    }, 500);\n    if (typeof killTimer.unref === \"function\") killTimer.unref();\n    return results;\n  };\n\n  // 1. initialize\n  let initResult: Record<string, unknown>;\n  try {\n    const res = await request(1, \"initialize\", {\n      protocolVersion,\n      capabilities: {},\n      clientInfo: { name: \"agent-connector-probe\", version: \"1\" },\n    });\n    if (isObject(res.error)) {\n      results.push(\n        diag(\"fail\", `${label}MCP initialize`, `server returned error: ${JSON.stringify(res.error)}`),\n      );\n      return cleanup();\n    }\n    initResult = isObject(res.result) ? res.result : {};\n  } catch (e) {\n    if (spawnErr) {\n      results.push(\n        diag(\n          \"fail\",\n          `${label}MCP initialize`,\n          `server not launchable: ${errMsg(spawnErr)}`,\n          `check that \"${command}\" is installed and on PATH`,\n        ),\n      );\n    } else if (exitCode !== null) {\n      // On Windows an unresolvable command surfaces as an early non-zero exit\n      // (cmd.exe \"command not found\") rather than a spawn 'error' event, so fold\n      // the not-launchable hint in here too — useful whether the command is\n      // missing or the server genuinely crashed before initialize.\n      results.push(\n        diag(\n          \"fail\",\n          `${label}MCP initialize`,\n          `server not launchable, or it exited (code ${exitCode}) before initialize`,\n          `check that \"${command}\" is installed and on PATH`,\n        ),\n      );\n    } else {\n      results.push(diag(\"fail\", `${label}MCP initialize`, errMsg(e)));\n    }\n    return cleanup();\n  }\n\n  const serverInfo = isObject(initResult.serverInfo) ? initResult.serverInfo : {};\n  const sName = typeof serverInfo.name === \"string\" ? serverInfo.name : \"unknown\";\n  const sVer = typeof serverInfo.version === \"string\" ? serverInfo.version : \"?\";\n  const negotiated =\n    typeof initResult.protocolVersion === \"string\" ? initResult.protocolVersion : \"(none)\";\n  results.push(diag(\"pass\", `${label}MCP initialize`, `serverInfo ${sName}@${sVer}, protocol ${negotiated}`));\n\n  // capabilities (presence = feature offered)\n  const caps = isObject(initResult.capabilities) ? initResult.capabilities : {};\n  const capNames = [\"tools\", \"resources\", \"prompts\", \"logging\", \"completions\"].filter((c) => c in caps);\n  results.push(\n    diag(\"pass\", `${label}capabilities`, capNames.length > 0 ? capNames.join(\", \") : \"(none advertised)\"),\n  );\n\n  // 2. initialized notification (required before normal requests)\n  send({ jsonrpc: \"2.0\", method: \"notifications/initialized\" });\n\n  // 3. ping — liveness confirm (warn, not fail, on timeout)\n  try {\n    await request(\"probe-ping\", \"ping\");\n    results.push(diag(\"pass\", `${label}ping`, \"alive\"));\n  } catch (e) {\n    results.push(diag(\"warn\", `${label}ping`, `no ping response (${errMsg(e)})`));\n  }\n\n  // 4. tools/list — only if the server advertised a tools capability\n  if (\"tools\" in caps) {\n    try {\n      const res = await request(2, \"tools/list\", {});\n      const r = isObject(res.result) ? res.result : {};\n      const tools = Array.isArray(r.tools) ? r.tools : [];\n      results.push(diag(\"pass\", `${label}tools/list`, `${tools.length} tool(s)`));\n    } catch (e) {\n      results.push(diag(\"fail\", `${label}tools/list`, `no tools/list response (${errMsg(e)})`));\n    }\n  } else {\n    results.push(\n      diag(\"warn\", `${label}tools/list`, \"skipped — server advertised no tools capability\"),\n    );\n  }\n\n  return cleanup();\n}\n"],"mappings":"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","names":["deferred"]}

package/dist/{droid-ETNOUIPJ.js → droid-PTCH2K7Y.js}

@@ -4,17 +4,17 @@ import {
 } from "./chunk-H53QZQJI.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderCommandMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/droid/index.ts
 import { existsSync } from "fs";
@@ -649,4 +649,4 @@ export {
   adapter,
   droid_default as default
 };
-//# sourceMappingURL=droid-ETNOUIPJ.js.map
+//# sourceMappingURL=droid-PTCH2K7Y.js.map

package/dist/{gemini-cli-P7XJXWVH.js → gemini-cli-QGLN2UMS.js}

@@ -7,12 +7,12 @@ import {
 } from "./chunk-H53QZQJI.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderSkillMd,
   renderSubagentMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   buildUsageEventCommand,
@@ -20,9 +20,9 @@ import {
   isHomeBinHookCommand,
   isHostNativeUsageEnabled,
   isUsageEventCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/gemini-cli/index.ts
 import { existsSync } from "fs";
@@ -770,4 +770,4 @@ export {
   adapter,
   gemini_cli_default as default
 };
-//# sourceMappingURL=gemini-cli-P7XJXWVH.js.map
+//# sourceMappingURL=gemini-cli-QGLN2UMS.js.map

package/dist/{goose-UZVA6MQC.js → goose-DQ6GSZ5O.js}

@@ -2,7 +2,7 @@
 import {
   readYaml,
   yamlObjectMapCodec
-} from "./chunk-IU42THN7.js";
+} from "./chunk-4NSU3KWX.js";
 import {
   roamingAppData
 } from "./chunk-UM5S7DKK.js";
@@ -11,19 +11,19 @@ import {
 } from "./chunk-H53QZQJI.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   removeFromObjectMap,
   renderSkillMd,
   upsertInObjectMap
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/goose/index.ts
 import { existsSync } from "fs";
@@ -603,4 +603,4 @@ export {
   adapter,
   goose_default as default
 };
-//# sourceMappingURL=goose-UZVA6MQC.js.map
+//# sourceMappingURL=goose-DQ6GSZ5O.js.map

package/dist/{hermes-IC6R4CII.js → hermes-E47IG63A.js}

@@ -3,24 +3,24 @@ import {
   readYaml,
   writeYaml,
   yamlObjectMapCodec
-} from "./chunk-IU42THN7.js";
+} from "./chunk-4NSU3KWX.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   removeFromObjectMap,
   renderSkillMd,
   upsertInObjectMap
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   buildWrappedStdio,
   isHomeBinActionCommand,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/hermes/index.ts
 import { existsSync, statSync } from "fs";
@@ -836,4 +836,4 @@ export {
   adapter,
   hermes_default as default
 };
-//# sourceMappingURL=hermes-IC6R4CII.js.map
+//# sourceMappingURL=hermes-E47IG63A.js.map

package/dist/{hook-7IUPIHCZ.js → hook-GM2IDA3C.js}

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
 import {
   fail
-} from "./chunk-NXR4HM5N.js";
-import "./chunk-CSRBMJLU.js";
+} from "./chunk-VKRGQLY4.js";
+import "./chunk-LKAVD4HP.js";
 import "./chunk-OP4KBXUO.js";
-import "./chunk-7QRUZAUG.js";
-import "./chunk-GCRRX4MO.js";
+import "./chunk-LN76OGNR.js";
+import "./chunk-S4E6QQEM.js";
 import {
   isNativeHookDeclared,
   runHook,
   runNativeHook
-} from "./chunk-E45SUUD7.js";
-import "./chunk-D6ZJS4ND.js";
+} from "./chunk-ZXX5DVSE.js";
+import "./chunk-4FWETID5.js";
 import "./chunk-KHO5WNTP.js";
-import "./chunk-RQCBBLTA.js";
-import "./chunk-UVBAH263.js";
-import "./chunk-LS65GL2P.js";
-import "./chunk-7CZKXXBD.js";
-import "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+import "./chunk-7NXEHZAK.js";
+import "./chunk-PZHB5TVA.js";
+import "./chunk-X457NOFE.js";
+import "./chunk-56R2ER7K.js";
+import "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/cli/commands/hook.ts
 import { parseArgs } from "util";
@@ -93,4 +93,4 @@ export {
   HOOK_EVENTS,
   run
 };
-//# sourceMappingURL=hook-7IUPIHCZ.js.map
+//# sourceMappingURL=hook-GM2IDA3C.js.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ActionDef, C as CommandDef, c as ConfigPatchDef, d as ConnectorConfig, R as ResolvedConnector, e as HookEventName, H as HookDefinition, M as MemoryDef, N as NativeHookDef, w as SkillDef, y as StatuslineDef, B as SubagentDef } from './types-ChUrvw0j.js';
-export { a as ActionResult, b as AuthSpec, V as ChangeRecord, W as DetectedPlatform, X as DiagnosticResult, E as EventPayloadMap, f as HookParadigm, g as HookResponse, h as HooksConfig, i as HostCtx, Y as InstallResult, I as InstallScope, j as NativeHookEvent, k as NotificationEvent, l as PermissionRequestEvent, m as PlatformCapabilities, P as PlatformId, n as PlatformMemoryOverride, o as PlatformOverride, p as PostToolUseEvent, q as PostToolUseFailureEvent, r as PreCompactEvent, s as PreToolUseEvent, S as ServerDef, u as SessionEndEvent, v as SessionStartEvent, x as StatuslineContext, z as StopEvent, D as SubagentStartEvent, F as SubagentStopEvent, T as TelemetryAccessor, K as TelemetryConfig, L as TelemetryUsageSummary, O as ToolFilter, Q as Transport, U as UserPromptSubmitEvent } from './types-ChUrvw0j.js';
+import { A as ActionDef, C as CommandDef, c as ConfigPatchDef, d as ConnectorConfig, R as ResolvedConnector, e as HookEventName, H as HookDefinition, M as MemoryDef, N as NativeHookDef, w as SkillDef, y as StatuslineDef, B as SubagentDef } from './types-D6RWGXm1.js';
+export { a as ActionResult, b as AuthSpec, V as ChangeRecord, W as DetectedPlatform, X as DiagnosticResult, E as EventPayloadMap, f as HookParadigm, g as HookResponse, h as HooksConfig, i as HostCtx, Y as InstallResult, I as InstallScope, j as NativeHookEvent, k as NotificationEvent, l as PermissionRequestEvent, m as PlatformCapabilities, P as PlatformId, n as PlatformMemoryOverride, o as PlatformOverride, p as PostToolUseEvent, q as PostToolUseFailureEvent, r as PreCompactEvent, s as PreToolUseEvent, S as ServerDef, u as SessionEndEvent, v as SessionStartEvent, x as StatuslineContext, z as StopEvent, D as SubagentStartEvent, F as SubagentStopEvent, T as TelemetryAccessor, K as TelemetryConfig, L as TelemetryUsageSummary, O as ToolFilter, Q as Transport, U as UserPromptSubmitEvent } from './types-D6RWGXm1.js';
 
 /**
  * core/define-connector — the public write-once entry point.

package/dist/index.js

@@ -11,11 +11,11 @@ import {
   defineSkill,
   defineStatusline,
   defineSubagent
-} from "./chunk-UVBAH263.js";
-import "./chunk-LS65GL2P.js";
-import "./chunk-7CZKXXBD.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-PZHB5TVA.js";
+import "./chunk-X457NOFE.js";
+import "./chunk-56R2ER7K.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 export {
   ConnectorConfigError,
   defineAction,

package/dist/{install-EP6GPQ65.js → install-7O4XWH7T.js}

@@ -3,35 +3,35 @@ import {
   installConnector,
   installViaMarketplace,
   parseInstallMethod
-} from "./chunk-IZ4XQ23W.js";
-import "./chunk-ZEFUDBTY.js";
-import "./chunk-AXAHW2KU.js";
-import "./chunk-ZSMGHEB5.js";
+} from "./chunk-VD4EG6SG.js";
+import "./chunk-UYZ53KWS.js";
+import "./chunk-QKLJU4JX.js";
+import "./chunk-NBUEL74R.js";
 import {
   fail,
   parseScope,
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-NXR4HM5N.js";
-import "./chunk-7QRUZAUG.js";
-import "./chunk-GCRRX4MO.js";
+} from "./chunk-VKRGQLY4.js";
+import "./chunk-LN76OGNR.js";
+import "./chunk-S4E6QQEM.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-RQCBBLTA.js";
-import "./chunk-UVBAH263.js";
-import "./chunk-LS65GL2P.js";
-import "./chunk-7CZKXXBD.js";
+} from "./chunk-7NXEHZAK.js";
+import "./chunk-PZHB5TVA.js";
+import "./chunk-X457NOFE.js";
+import "./chunk-56R2ER7K.js";
 import "./chunk-OPXAP3AC.js";
 import "./chunk-UM5S7DKK.js";
 import "./chunk-H53QZQJI.js";
-import "./chunk-DBQMX75U.js";
-import "./chunk-RHML2NOB.js";
-import "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+import "./chunk-BEFVJ2OE.js";
+import "./chunk-VVFDU4IX.js";
+import "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/cli/commands/install.ts
 import { parseArgs } from "util";
@@ -93,4 +93,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=install-EP6GPQ65.js.map
+//# sourceMappingURL=install-7O4XWH7T.js.map

package/dist/{introspect-BFcXpfUp.d.ts → introspect-5o5ick0_.d.ts}

@@ -1,4 +1,4 @@
-import { m as PlatformCapabilities, P as PlatformId } from './types-ChUrvw0j.js';
+import { m as PlatformCapabilities, P as PlatformId } from './types-D6RWGXm1.js';
 
 /**
  * sdk/introspect — host-capability introspection over the adapter registry.
@@ -27,9 +27,14 @@ type SurfaceName = "server" | "hooks" | "commands" | "skills" | "subagents" | "m
  * (the supportsCommands precedent in core/types), so a host that simply leaves
  * a flag unset reports the surface as unsupported (the installer skip-warns it).
  *
- * `hooks` is satisfied by ANY normalized hook event (i.e. the host has at least
- * one event it can dispatch); the per-event flags map 1:1 onto the
- * {@link import("../core/types.js").HookEventName} union.
+ * `hooks` here is the COARSE host-capability predicate: `true` when the host can
+ * fire AT LEAST ONE normalized event (it derives from {@link hostCanFireEvent},
+ * the per-event source of truth, so the two never drift). It is the right answer
+ * for the connector-less queries ({@link hostsSupporting} / {@link surfaceSupport}:
+ * "which hosts have a hook runtime at all?"). It is deliberately NOT used by
+ * {@link explain}, which must judge the hooks surface against the connector's
+ * SPECIFIC declared events — a Stop-only connector on a PreToolUse-only host is
+ * NOT honored even though the host has a hook runtime (see {@link explain}).
  */
 declare const SURFACE_PREDICATES: Record<SurfaceName, (c: PlatformCapabilities) => boolean>;
 /**

package/dist/{jetbrains-copilot-MZO2RQGJ.js → jetbrains-copilot-4IOT3I2Y.js}

@@ -5,13 +5,13 @@ import {
 import {
   BaseAdapter,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/jetbrains-copilot/index.ts
 import { existsSync } from "fs";
@@ -688,4 +688,4 @@ export {
   adapter,
   jetbrains_copilot_default as default
 };
-//# sourceMappingURL=jetbrains-copilot-MZO2RQGJ.js.map
+//# sourceMappingURL=jetbrains-copilot-4IOT3I2Y.js.map

package/dist/{kilo-CCB34CQQ.js → kilo-TAHOPT2Q.js}

@@ -7,17 +7,17 @@ import {
 } from "./chunk-UM5S7DKK.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderOpenCodeSubagentMd,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildWrappedStdio
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/kilo/index.ts
 import { existsSync } from "fs";
@@ -842,4 +842,4 @@ export {
   adapter,
   kilo_default as default
 };
-//# sourceMappingURL=kilo-CCB34CQQ.js.map
+//# sourceMappingURL=kilo-TAHOPT2Q.js.map

package/dist/{kilo-cli-EOMN3WC7.js → kilo-cli-X4NPJWGX.js}

@@ -7,17 +7,17 @@ import {
 } from "./chunk-UM5S7DKK.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderCommandMd,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildWrappedStdio
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/kilo-cli/index.ts
 import { existsSync } from "fs";
@@ -795,4 +795,4 @@ export {
   adapter,
   kilo_cli_default as default
 };
-//# sourceMappingURL=kilo-cli-EOMN3WC7.js.map
+//# sourceMappingURL=kilo-cli-X4NPJWGX.js.map

package/dist/{kimi-GUSJME55.js → kimi-Z7L2LEEI.js}

@@ -4,20 +4,20 @@ import {
 } from "./chunk-H53QZQJI.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
 import {
   ensureDir
-} from "./chunk-2HCJV6UO.js";
+} from "./chunk-IXOQDZWC.js";
 
 // src/adapters/kimi/index.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -680,4 +680,4 @@ export {
   adapter,
   kimi_default as default
 };
-//# sourceMappingURL=kimi-GUSJME55.js.map
+//# sourceMappingURL=kimi-Z7L2LEEI.js.map

package/dist/{kiro-6OHZ5RGV.js → kiro-YZ4TTZGD.js}

@@ -4,18 +4,18 @@ import {
 } from "./chunk-H53QZQJI.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/kiro/index.ts
 import { existsSync } from "fs";
@@ -518,4 +518,4 @@ export {
   adapter,
   kiro_default as default
 };
-//# sourceMappingURL=kiro-6OHZ5RGV.js.map
+//# sourceMappingURL=kiro-YZ4TTZGD.js.map

package/dist/{leaderboard-6I2E5XZK.js → leaderboard-DVW4WYJ6.js}

@@ -10,14 +10,14 @@ import {
   hostNativeTurns,
   isScopeFilter,
   mcpLeaderboard
-} from "./chunk-TZ5KGCE2.js";
+} from "./chunk-AY3RGRTT.js";
 import "./chunk-XD7MY6HB.js";
 import {
   fail,
   print
-} from "./chunk-NXR4HM5N.js";
-import "./chunk-D6ZJS4ND.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-VKRGQLY4.js";
+import "./chunk-4FWETID5.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/cli/commands/leaderboard.ts
 import { parseArgs } from "util";
@@ -134,4 +134,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=leaderboard-6I2E5XZK.js.map
+//# sourceMappingURL=leaderboard-DVW4WYJ6.js.map

package/dist/{mimo-code-ZPJJ6IIW.js → mimo-code-G2CBZ4M6.js}

@@ -4,17 +4,17 @@ import {
 } from "./chunk-FBJQGRET.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderOpenCodeSubagentMd,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildWrappedStdio
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/mimo-code/index.ts
 import { existsSync } from "fs";
@@ -716,4 +716,4 @@ export {
   adapter,
   mimo_code_default as default
 };
-//# sourceMappingURL=mimo-code-ZPJJ6IIW.js.map
+//# sourceMappingURL=mimo-code-G2CBZ4M6.js.map