@ken-jo/agent-connector 0.4.97 → 0.4.99

package/dist/chunk-3FINQ2ZF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/jsonc.ts","../src/core/object-map.ts","../src/adapters/claude-code/render.ts","../src/adapters/base.ts","../src/core/hook-array.ts"],"sourcesContent":["/**\r\n * core/jsonc — tolerant JSONC / JSON5-lite parsing.\r\n *\r\n * Many hosts document their config file as JSONC (or JSON5): // line comments,\r\n * /* *\\/ block comments, and trailing commas are all legal. A strict JSON.parse\r\n * false-fails such a perfectly valid file → null → and a careless `?? {}` then\r\n * OVERWRITES the user's entire config with just our entry (data loss). To avoid\r\n * that, every JSON/JSONC adapter parses through `parseJsonc`, which strips\r\n * comments + trailing commas in ONE string-aware pass before JSON.parse.\r\n *\r\n * The single pass is deliberately string-literal aware: a // or /* inside a\r\n * quoted value (e.g. \"http://x//y\") is NOT a comment, and a comma inside a\r\n * string (e.g. \"a,]\") is NOT a trailing comma — both must survive verbatim.\r\n */\r\n\r\n/**\r\n * Strip // line comments, /* *\\/ block comments, and trailing commas from JSONC\r\n * text in a SINGLE string-aware pass.\r\n *\r\n * Rules:\r\n *   - While inside a string literal, every character (including //, /*, and ,)\r\n *     is copied verbatim; backslash escapes the next character.\r\n *   - Outside a string, // … runs to end-of-line and /* … *\\/ to its close.\r\n *   - A comma is dropped ONLY when the next non-whitespace, non-comment token is\r\n *     a closing `}` or `]` (a trailing comma). A comma followed by another value\r\n *     or by end-of-input is preserved (the latter lets JSON.parse report the\r\n *     real syntax error instead of us masking it).\r\n */\r\nexport function stripJsonc(text: string): string {\r\n  const n = text.length;\r\n  let out = \"\";\r\n  let i = 0;\r\n  let inString = false;\r\n  let quote = \"\";\r\n\r\n  while (i < n) {\r\n    const ch = text[i] as string;\r\n\r\n    if (inString) {\r\n      out += ch;\r\n      if (ch === \"\\\\\") {\r\n        // Copy the escaped character verbatim (covers \\\" \\\\ \\/ etc.).\r\n        if (i + 1 < n) {\r\n          out += text[i + 1] as string;\r\n          i += 2;\r\n          continue;\r\n        }\r\n      } else if (ch === quote) {\r\n        inString = false;\r\n      }\r\n      i += 1;\r\n      continue;\r\n    }\r\n\r\n    const next = i + 1 < n ? (text[i + 1] as string) : \"\";\r\n\r\n    // Enter a string literal.\r\n    if (ch === '\"' || ch === \"'\") {\r\n      inString = true;\r\n      quote = ch;\r\n      out += ch;\r\n      i += 1;\r\n      continue;\r\n    }\r\n\r\n    // Line comment — skip to end of line (keep the newline for line tracking).\r\n    if (ch === \"/\" && next === \"/\") {\r\n      i += 2;\r\n      while (i < n && text[i] !== \"\\n\") i += 1;\r\n      continue;\r\n    }\r\n\r\n    // Block comment — skip to the closing */.\r\n    if (ch === \"/\" && next === \"*\") {\r\n      i += 2;\r\n      while (i < n && !(text[i] === \"*\" && text[i + 1] === \"/\")) i += 1;\r\n      i += 2; // consume the closing */\r\n      continue;\r\n    }\r\n\r\n    // Trailing comma — drop it only when the next significant token (skipping\r\n    // whitespace AND comments) is a closing } or ]. This stays string-aware\r\n    // because we only reach here outside a string.\r\n    if (ch === \",\") {\r\n      const closer = nextSignificant(text, i + 1);\r\n      if (closer === \"}\" || closer === \"]\") {\r\n        i += 1; // drop the trailing comma\r\n        continue;\r\n      }\r\n    }\r\n\r\n    out += ch;\r\n    i += 1;\r\n  }\r\n\r\n  return out;\r\n}\r\n\r\n/**\r\n * Peek the next significant (non-whitespace, non-comment) character at/after\r\n * `from`, returning \"\" at end-of-input. Used only outside string literals.\r\n */\r\nfunction nextSignificant(text: string, from: number): string {\r\n  const n = text.length;\r\n  let i = from;\r\n  while (i < n) {\r\n    const ch = text[i] as string;\r\n    if (ch === \" \" || ch === \"\\t\" || ch === \"\\r\" || ch === \"\\n\") {\r\n      i += 1;\r\n      continue;\r\n    }\r\n    const next = i + 1 < n ? (text[i + 1] as string) : \"\";\r\n    if (ch === \"/\" && next === \"/\") {\r\n      i += 2;\r\n      while (i < n && text[i] !== \"\\n\") i += 1;\r\n      continue;\r\n    }\r\n    if (ch === \"/\" && next === \"*\") {\r\n      i += 2;\r\n      while (i < n && !(text[i] === \"*\" && text[i + 1] === \"/\")) i += 1;\r\n      i += 2;\r\n      continue;\r\n    }\r\n    return ch;\r\n  }\r\n  return \"\";\r\n}\r\n\r\n/**\r\n * Parse JSONC text tolerantly: strip comments + trailing commas, then JSON.parse.\r\n * Throws (like JSON.parse) on genuinely malformed input — callers that want a\r\n * fail-soft null should wrap in try/catch (BaseAdapter.readJson does).\r\n */\r\nexport function parseJsonc<T = unknown>(text: string): T {\r\n  return JSON.parse(stripJsonc(text)) as T;\r\n}\r\n","import type { ChangeRecord } from \"./types.js\";\r\n\r\n/**\r\n * Format-agnostic upsert/remove for a config that stores entries in an object\r\n * map at config[rootKey][entryId]. Extracted from BaseAdapter.upsertServerInJson\r\n * / removeServerFromJson so JSON today (and other formats via a Codec later)\r\n * share ONE create/skip/update + overwrite/malformed-guard orchestration. The\r\n * JSON binding in BaseAdapter is a byte-identical wrapper over this.\r\n */\r\n\r\n/** The only format-specific surface: parse a config file to a record and\r\n * serialize it back. parse() fail-softs to null (absent or unparseable). */\r\nexport interface ObjectMapCodec {\r\n  parse(path: string): Record<string, unknown> | null;\r\n  serialize(path: string, data: Record<string, unknown>, dryRun: boolean): void;\r\n  /** Detection half of the overwrite guard: present, non-empty, still unparseable. */\r\n  isPresentButUnparseable(path: string): boolean;\r\n}\r\n\r\n/** What to do when config[rootKey] is present but the wrong type (hand-edited to\r\n * an array / primitive). \"warn-skip\" leaves the user's value untouched (the JSON\r\n * server/hook policy); \"coerce\" replaces it with a fresh {} and proceeds (the\r\n * TOML/YAML host policy, used by a later follow-up). */\r\nexport type MalformedRootPolicy = \"warn-skip\" | \"coerce\";\r\n\r\n/** True when a PRESENT value is not a plain object map (array / primitive).\r\n * null/undefined is NOT malformed — that is the well-formed \"absent\" case the\r\n * engine creates fresh. */\r\nexport function isMalformedRootValue(value: unknown): boolean {\r\n  return value != null && (typeof value !== \"object\" || Array.isArray(value));\r\n}\r\n\r\nexport interface ObjectMapUpsertOptions {\r\n  codec: ObjectMapCodec;\r\n  rootKey: string;\r\n  platform: string;\r\n  configPath: string;\r\n  entryId: string;\r\n  entry: unknown;\r\n  dryRun?: boolean;\r\n  policy?: MalformedRootPolicy;\r\n}\r\n\r\nexport interface ObjectMapRemoveOptions {\r\n  codec: ObjectMapCodec;\r\n  rootKey: string;\r\n  platform: string;\r\n  configPath: string;\r\n  entryId: string;\r\n  dryRun?: boolean;\r\n  policy?: MalformedRootPolicy;\r\n}\r\n\r\nfunction unparseableWarn(platform: string, configPath: string): ChangeRecord {\r\n  return {\r\n    platform: platform as ChangeRecord[\"platform\"],\r\n    action: \"warn\",\r\n    path: configPath,\r\n    detail: `existing ${configPath} is not parseable; left untouched (back it up / fix it, then re-run)`,\r\n  };\r\n}\r\n\r\nfunction malformedWarn(platform: string, rootKey: string, configPath: string): ChangeRecord {\r\n  return {\r\n    platform: platform as ChangeRecord[\"platform\"],\r\n    action: \"warn\",\r\n    path: configPath,\r\n    detail: `existing \"${rootKey}\" in ${configPath} is not an object map; left untouched (fix it, then re-run)`,\r\n  };\r\n}\r\n\r\nexport function upsertInObjectMap(o: ObjectMapUpsertOptions): ChangeRecord {\r\n  const policy = o.policy ?? \"warn-skip\";\r\n  if (o.codec.isPresentButUnparseable(o.configPath)) {\r\n    return unparseableWarn(o.platform, o.configPath);\r\n  }\r\n  const cfg = o.codec.parse(o.configPath) ?? {};\r\n  if (isMalformedRootValue(cfg[o.rootKey])) {\r\n    if (policy === \"warn-skip\") return malformedWarn(o.platform, o.rootKey, o.configPath);\r\n    cfg[o.rootKey] = {}; // coerce\r\n  }\r\n  const bucket = (cfg[o.rootKey] ?? (cfg[o.rootKey] = {})) as Record<string, unknown>;\r\n  const before = JSON.stringify(bucket[o.entryId]);\r\n  const after = JSON.stringify(o.entry);\r\n  let action: ChangeRecord[\"action\"];\r\n  if (before === undefined) action = \"create\";\r\n  else if (before === after) action = \"skip\";\r\n  else action = \"update\";\r\n  if (action !== \"skip\") {\r\n    bucket[o.entryId] = o.entry;\r\n    o.codec.serialize(o.configPath, cfg, o.dryRun ?? false);\r\n  }\r\n  return {\r\n    platform: o.platform as ChangeRecord[\"platform\"],\r\n    action,\r\n    path: o.configPath,\r\n    detail: `${o.rootKey}.${o.entryId}`,\r\n  };\r\n}\r\n\r\nexport function removeFromObjectMap(o: ObjectMapRemoveOptions): ChangeRecord {\r\n  const policy = o.policy ?? \"warn-skip\";\r\n  if (o.codec.isPresentButUnparseable(o.configPath)) {\r\n    return unparseableWarn(o.platform, o.configPath);\r\n  }\r\n  const cfg = o.codec.parse(o.configPath);\r\n  if (cfg && isMalformedRootValue(cfg[o.rootKey])) {\r\n    if (policy === \"warn-skip\") return malformedWarn(o.platform, o.rootKey, o.configPath);\r\n    // coerce: a malformed root holds nothing of ours to remove → absent skip\r\n    return {\r\n      platform: o.platform as ChangeRecord[\"platform\"],\r\n      action: \"skip\",\r\n      path: o.configPath,\r\n      detail: `${o.rootKey}.${o.entryId} absent`,\r\n    };\r\n  }\r\n  const bucket = cfg?.[o.rootKey] as Record<string, unknown> | undefined;\r\n  if (!cfg || !bucket || !(o.entryId in bucket)) {\r\n    return {\r\n      platform: o.platform as ChangeRecord[\"platform\"],\r\n      action: \"skip\",\r\n      path: o.configPath,\r\n      detail: `${o.rootKey}.${o.entryId} absent`,\r\n    };\r\n  }\r\n  delete bucket[o.entryId];\r\n  o.codec.serialize(o.configPath, cfg, o.dryRun ?? false);\r\n  return {\r\n    platform: o.platform as ChangeRecord[\"platform\"],\r\n    action: \"remove\",\r\n    path: o.configPath,\r\n    detail: `${o.rootKey}.${o.entryId}`,\r\n  };\r\n}\r\n","/**\r\n * adapters/claude-code/render — shared content-surface renderers.\r\n *\r\n * The single source of truth for how a connector's commands / skills / subagents\r\n * are serialized into Claude Code's native `md + YAML-frontmatter` documents.\r\n * BOTH the live claude-code adapter (which writes into ~/.claude or .claude when\r\n * installing) AND `core/package` (which emits a marketplace-installable plugin\r\n * bundle) import these so the two paths produce BYTE-IDENTICAL output — there is\r\n * no second, subtly-different copy to drift.\r\n *\r\n * The frontmatter serializer reuses the `yaml` package (the same serializer\r\n * core/yaml and BaseAdapter.renderFrontmatterMd use): a `---` fence, the YAML\r\n * block, a closing `---`, a blank line, then the markdown body and a trailing\r\n * newline.\r\n */\r\n\r\nimport { stringify as stringifyYaml } from \"yaml\";\r\n\r\nimport type { CommandDef, SkillDef, SubagentDef } from \"../../core/types.js\";\r\n\r\n/**\r\n * Render a YAML-frontmatter + markdown body document:\r\n *   \"---\\n\" + <yaml> + \"---\\n\\n\" + <body> + \"\\n\".\r\n * Identical to BaseAdapter.renderFrontmatterMd (which now delegates here).\r\n */\r\nexport function renderFrontmatterMd(\r\n  frontmatter: Record<string, unknown>,\r\n  body: string,\r\n): string {\r\n  return `---\\n${stringifyYaml(frontmatter)}---\\n\\n${body}\\n`;\r\n}\r\n\r\n/**\r\n * Render a command to md+frontmatter\r\n * (description, argument-hint, allowed-tools, model + verbatim extra).\r\n *\r\n * `opts.includeToolsAndModel` (default `true`) controls the allowed-tools and\r\n * model insertions. Hosts whose command frontmatter is only\r\n * (description, argument-hint + verbatim extra) — i.e. they have no native\r\n * allowed-tools/model keys — pass `{ includeToolsAndModel: false }` to suppress\r\n * both; the default reproduces the full shape byte-for-byte.\r\n */\r\nexport function renderCommandMd(\r\n  cmd: CommandDef,\r\n  opts: { includeToolsAndModel?: boolean } = {},\r\n): string {\r\n  const { includeToolsAndModel = true } = opts;\r\n  const frontmatter: Record<string, unknown> = {};\r\n  if (cmd.description !== undefined) frontmatter.description = cmd.description;\r\n  if (cmd.argumentHint !== undefined) frontmatter[\"argument-hint\"] = cmd.argumentHint;\r\n  if (includeToolsAndModel) {\r\n    const allow = cmd.tools?.allow;\r\n    if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\r\n    if (cmd.model !== undefined) frontmatter.model = cmd.model;\r\n  }\r\n  if (cmd.extra) Object.assign(frontmatter, cmd.extra);\r\n  return renderFrontmatterMd(frontmatter, cmd.prompt);\r\n}\r\n\r\n/**\r\n * Render a skill's SKILL.md: frontmatter (name, description + optional model,\r\n * allowed-tools, disable-model-invocation, verbatim extra) + body.\r\n */\r\nexport function renderSkillMd(skill: SkillDef): string {\r\n  const frontmatter: Record<string, unknown> = {\r\n    name: skill.name,\r\n    description: skill.description,\r\n  };\r\n  if (skill.model !== undefined) frontmatter.model = skill.model;\r\n  const allow = skill.tools?.allow;\r\n  if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\r\n  if (skill.disableModelInvocation !== undefined) {\r\n    frontmatter[\"disable-model-invocation\"] = skill.disableModelInvocation;\r\n  }\r\n  if (skill.extra) Object.assign(frontmatter, skill.extra);\r\n  return renderFrontmatterMd(frontmatter, skill.body);\r\n}\r\n\r\n/** Render a subagent to md+frontmatter (name, description, tools, model) + prompt body. */\r\nexport function renderSubagentMd(agent: SubagentDef): string {\r\n  const frontmatter: Record<string, unknown> = {\r\n    name: agent.name,\r\n    description: agent.description,\r\n  };\r\n  const allow = agent.tools?.allow;\r\n  if (allow && allow.length > 0) frontmatter.tools = allow.join(\", \");\r\n  if (agent.model !== undefined) frontmatter.model = agent.model;\r\n  if (agent.extra) Object.assign(frontmatter, agent.extra);\r\n  return renderFrontmatterMd(frontmatter, agent.prompt);\r\n}\r\n\r\n/**\r\n * Render a subagent in OpenCode's shape (shared by opencode/kilo/mimo-code):\r\n * frontmatter (description, mode:\"subagent\", model?, permission? + verbatim\r\n * extra) with the system prompt as the body. `name` is NOT a frontmatter\r\n * field — it comes from the filename. `permission` is derived from the coarse\r\n * `readonly` knob: a readonly agent gets a per-tool deny map (edit/bash) so it\r\n * cannot mutate the workspace.\r\n */\r\nexport function renderOpenCodeSubagentMd(agent: SubagentDef): string {\r\n  const frontmatter: Record<string, unknown> = {\r\n    description: agent.description,\r\n    mode: \"subagent\",\r\n  };\r\n  if (agent.model !== undefined) frontmatter.model = agent.model;\r\n  if (agent.readonly === true) {\r\n    // Per-tool permission map: deny mutating tools for a readonly subagent.\r\n    frontmatter.permission = { edit: \"deny\", bash: \"deny\" };\r\n  }\r\n  if (agent.extra) Object.assign(frontmatter, agent.extra);\r\n  return renderFrontmatterMd(frontmatter, agent.prompt);\r\n}\r\n","/**\r\n * adapters/base — shared adapter foundation.\r\n *\r\n * Provides JSON config IO, settings backup, and a default doctor. Per-platform\r\n * specifics (paths, capabilities, native render format, runtime parse/format)\r\n * are abstract and implemented by each adapter. TOML/YAML adapters override the\r\n * JSON helpers entirely.\r\n */\r\n\r\nimport {\r\n  chmodSync,\r\n  copyFileSync,\r\n  existsSync,\r\n  readdirSync,\r\n  readFileSync,\r\n  rmSync,\r\n  statSync,\r\n  writeFileSync,\r\n} from \"node:fs\";\r\nimport type { Dirent } from \"node:fs\";\r\nimport { homedir } from \"node:os\";\r\nimport { basename, dirname, isAbsolute, join, relative, resolve, sep } from \"node:path\";\r\n\r\nimport type {\r\n  ChangeRecord,\r\n  DetectedPlatform,\r\n  DiagnosticResult,\r\n  HealthCheck,\r\n  HookParadigm,\r\n  PlatformCapabilities,\r\n  PlatformId,\r\n  PlatformMemoryOverride,\r\n} from \"../core/types.js\";\r\nimport { backupsDir, ensureDir, firstSymlinkInPath } from \"../core/paths.js\";\r\nimport { parseJsonc } from \"../core/jsonc.js\";\r\nimport {\r\n  isMalformedRootValue as isMalformedRootValueFn,\r\n  removeFromObjectMap,\r\n  upsertInObjectMap,\r\n  type ObjectMapCodec,\r\n} from \"../core/object-map.js\";\r\nimport { removeFromArray, upsertInArray } from \"../core/hook-array.js\";\r\nimport { buildHomeBinActionCommand, buildHomeBinHookCommand } from \"../core/spawn.js\";\r\nimport {\r\n  MEMORY_CONTENT_SOFT_BUDGET_BYTES,\r\n  listManagedBlocks,\r\n  loadMemoryLedger,\r\n  recordMemoryTarget,\r\n  removeManagedBlocksFile,\r\n  saveMemoryLedger,\r\n  upsertManagedBlockFile,\r\n} from \"../core/managed-block.js\";\r\nimport { renderFrontmatterMd } from \"./claude-code/render.js\";\r\nimport type { Adapter, InstallContext, MemoryTarget } from \"./spi.js\";\r\n\r\n/** Content-surface kinds with BaseAdapter default install/uninstall handling. */\r\ntype ContentSurface =\r\n  | \"commands\"\r\n  | \"skills\"\r\n  | \"subagents\"\r\n  | \"memory\"\r\n  | \"statusline\"\r\n  | \"actions\";\r\n\r\n/**\r\n * Per-host policy + observables for the shared object-map hook-array merge\r\n * engine ({@link BaseAdapter.upsertHookEntries} / {@link BaseAdapter.removeHookEntries}).\r\n * `E` is the host's per-event array element type (e.g. claude-code's\r\n * `{ matcher, hooks: [...] }`). EVERY observable string + ownership predicate\r\n * is carried here so the engine body hardcodes none of them and per-host\r\n * wording never drifts; a future host needing divergent details overrides only\r\n * its descriptor, not the engine.\r\n */\r\nexport interface HookMergeDescriptor<E> {\r\n  /**\r\n   * How to handle a present-but-malformed `hooks` root (an array / primitive\r\n   * instead of an object map) on install:\r\n   *  - \"warn-skip\" (DEFAULT): route through {@link BaseAdapter.malformedHookRootSkip}\r\n   *    — surface a `warn`, write nothing, leave the user's value untouched. This\r\n   *    is byte-identical to the pre-axis engine, so existing hosts that omit the\r\n   *    field are unchanged.\r\n   *  - \"coerce\": replace a malformed root (and any non-array event bucket) with a\r\n   *    fresh object map / array, then proceed — matching the container hosts\r\n   *    (codex, goose) whose server path already coerces a malformed root.\r\n   */\r\n  malformedPolicy?: \"warn-skip\" | \"coerce\";\r\n  /**\r\n   * Canonical → host event name. `undefined` = the host has no equivalent for\r\n   * this event → the engine emits a warn (via unmappedWarnDetail) and skips it.\r\n   * Omit the field entirely for identity hosts (claude-code) — no warn path.\r\n   */\r\n  mapEvent?(event: string): string | undefined;\r\n  /** Warn detail for an event mapEvent returns undefined for. Required iff mapEvent can return undefined. */\r\n  unmappedWarnDetail?(event: string): string;\r\n  /**\r\n   * Severity of the record emitted for an event mapEvent returns undefined for.\r\n   * DEFAULT `\"warn\"` (trips a non-zero install exit) — byte-identical to every\r\n   * host that omits this. A host may return `\"skip\"` for an event whose drop\r\n   * predates the never-silent convention (codex's SessionEnd / Notification), so\r\n   * the degradation is reported VISIBLY without flipping that legacy event's\r\n   * historical exit-0. Either way the event is NEVER silently dropped.\r\n   */\r\n  unmappedAction?(event: string): \"warn\" | \"skip\";\r\n  /** Render one host entry from the event name, declared matcher, and home-bin command. */\r\n  renderEntry(event: string, matcher: string, command: string): E;\r\n  /** Upsert find: does `entry` already carry THIS specific command (idempotency check)? */\r\n  entryOwnsCommand(entry: E, command: string): boolean;\r\n  /**\r\n   * Uninstall whole-entry predicate (FLAT hosts): does `entry` belong to us?\r\n   * NESTED hosts supplying {@link stripInner} may return a never-true predicate —\r\n   * the engine then only ever invokes `stripInner`. Bound to `ctx` because\r\n   * ownership is connector-generic (ANY of our commands), wider than the\r\n   * install-time specific-command check. The `event` param lets EVENT-SPECIFIC\r\n   * hosts (codex, whose ownership is per-event by construction) match the\r\n   * canonical event being stripped; hosts whose ownership is event-independent\r\n   * (claude-code/droid/cursor/qwen) ignore it — a `(ctx) => …` arrow is assignable\r\n   * to this 2-param type (fewer params is fine in TS), so they need no change.\r\n   */\r\n  ownsEntryForRemove(ctx: InstallContext, event: string): (entry: E) => boolean;\r\n  /**\r\n   * Uninstall inner-strip (NESTED hosts): strip our owned inner commands from\r\n   * `entry`, returning the rebuilt entry (`null` when fully emptied) and the\r\n   * count of inner commands removed. Omit for FLAT hosts.\r\n   */\r\n  stripInner?(ctx: InstallContext): (entry: E) => { next: E | null; removed: number };\r\n  /** Idempotent-reinstall skip detail, e.g. `hooks.<event> already registered`. */\r\n  skipDetail(event: string): string;\r\n  /** Uninstall remove detail, e.g. `hooks.<event> (<n>)`. */\r\n  removeDetail(event: string, removed: number): string;\r\n  /** Uninstall skip detail when no hooks section is present at all. */\r\n  absentDetail: string;\r\n  /** Uninstall skip detail when a hooks section exists but nothing matched. */\r\n  noMatchDetail: string;\r\n  /**\r\n   * Uninstall: the exact event keys to scan, in order. Omit (default) to scan\r\n   * every key actually present (`Object.keys(hooks)`). EVENT-SPECIFIC hosts whose\r\n   * ownership predicate rebuilds a per-event command (codex) MUST pin their fixed\r\n   * event set here so a home-bin command hand-placed under a foreign event key is\r\n   * left untouched — byte-identical to a fixed-event-list uninstall loop.\r\n   */\r\n  removeEventKeys?: readonly string[];\r\n  /** Optional post-mutation hook on the whole parsed file, before the single write. */\r\n  onMutate?(file: Record<string, unknown>): void;\r\n  /**\r\n   * Native-pass ownership find (EXACT command match, vs the normalized\r\n   * entryOwnsCommand). Set only when a `native` list is passed.\r\n   */\r\n  nativeOwnsCommand?(entry: E, command: string): boolean;\r\n  /** Native-pass skip detail, e.g. `hooks.<event> (native) already registered`. */\r\n  nativeSkipDetail?(event: string): string;\r\n  /** Native-pass create/update detail, e.g. `hooks.<event> (native)`. */\r\n  nativeMutateDetail?(event: string): string;\r\n}\r\n\r\n/**\r\n * One resolved action trigger for an EMITTER adapter: the host-native trigger\r\n * the adapter writes runs `command`, which re-enters the home binary at the\r\n * `action` verb. `label`/`description` fall back to the action id when the\r\n * connector declared none. Produced by {@link BaseAdapter.actionTriggers}.\r\n */\r\nexport interface ActionTrigger {\r\n  /** The action id — also the per-action file/key name on most hosts. */\r\n  id: string;\r\n  /** Display label (action.description ?? action.id). */\r\n  label: string;\r\n  /** One-line description (action.description ?? action.id). */\r\n  description: string;\r\n  /** `<homeBin> action <host> <id> --connector <connectorId>` (the verb the host runs). */\r\n  command: string;\r\n}\r\n\r\n/**\r\n * Documented USER-scope AGENTS.md locations, per host (the AGENTS.md-first\r\n * research matrix). Only hosts with a REAL user/global AGENTS.md file are\r\n * listed. Hosts whose documented user-scope memory lives in a DIFFERENT file\r\n * (qwen-code ~/.qwen/QWEN.md, goose .goosehints, kilo/roo/kiro rules dirs,\r\n * copilot-cli copilot-instructions.md) override memoryTargets in-adapter;\r\n * hosts whose user rules are app/UI/cloud-managed (warp Drive, trae,\r\n * jetbrains/cursor settings UI) deliberately have no row — user-scope memory\r\n * there reports the standard skip-warn (the JetBrains-MCP precedent), never a\r\n * write into a file the host ignores.\r\n */\r\nconst AGENTS_MD_USER_PATHS: Partial<Record<PlatformId, () => MemoryTarget>> = {\r\n  // codex resolves its own user path in-adapter ($CODEX_HOME with ~ expansion\r\n  // + the AGENTS.override.md shadow probe) — deliberately no row here.\r\n  zed: () => ({\r\n    path:\r\n      process.platform === \"win32\" && process.env.APPDATA\r\n        ? join(process.env.APPDATA, \"Zed\", \"AGENTS.md\")\r\n        : join(homedir(), \".config\", \"zed\", \"AGENTS.md\"),\r\n    reason: \"zed personal instructions file\",\r\n  }),\r\n  amp: () => ({\r\n    path: join(homedir(), \".config\", \"amp\", \"AGENTS.md\"),\r\n    reason: \"amp user-scope AGENTS.md\",\r\n  }),\r\n  mux: () => ({\r\n    path: join(homedir(), \".mux\", \"AGENTS.md\"),\r\n    reason: \"mux global AGENTS.md\",\r\n  }),\r\n  pi: () => ({\r\n    path: join(homedir(), \".pi\", \"agent\", \"AGENTS.md\"),\r\n    reason: \"pi global AGENTS.md\",\r\n  }),\r\n  droid: () => ({\r\n    path: join(homedir(), \".factory\", \"AGENTS.md\"),\r\n    reason: \"droid (Factory) personal AGENTS.md\",\r\n  }),\r\n  opencode: () => ({\r\n    path: join(homedir(), \".config\", \"opencode\", \"AGENTS.md\"),\r\n    reason: \"opencode global AGENTS.md\",\r\n  }),\r\n  antigravity: () => ({\r\n    path: join(homedir(), \".gemini\", \"AGENTS.md\"),\r\n    reason: \"antigravity global rules (~/.gemini/AGENTS.md, shared tree)\",\r\n  }),\r\n  \"antigravity-cli\": () => ({\r\n    path: join(homedir(), \".gemini\", \"AGENTS.md\"),\r\n    reason: \"agy shares the IDE's ~/.gemini tree (idempotent upsert dedupes)\",\r\n  }),\r\n  omp: () => ({\r\n    path: join(homedir(), \".omp\", \"agent\", \"AGENTS.md\"),\r\n    reason: \"omp global AGENTS.md (pi-parity; verify for your version)\",\r\n  }),\r\n};\r\n\r\nexport abstract class BaseAdapter implements Adapter {\r\n  abstract readonly id: PlatformId;\r\n  abstract readonly name: string;\r\n  abstract readonly paradigm: HookParadigm;\r\n  abstract readonly capabilities: PlatformCapabilities;\r\n\r\n  abstract detectInstalled(projectDir: string): DetectedPlatform;\r\n  abstract getConfigDir(ctx: InstallContext): string;\r\n  abstract getServerConfigPath(ctx: InstallContext): string;\r\n  abstract getHookConfigPath(ctx: InstallContext): string;\r\n  abstract installServer(ctx: InstallContext): ChangeRecord[];\r\n  abstract uninstallServer(ctx: InstallContext): ChangeRecord[];\r\n  abstract installHooks(ctx: InstallContext): ChangeRecord[];\r\n  abstract uninstallHooks(ctx: InstallContext): ChangeRecord[];\r\n\r\n  // ── Content surfaces (commands / skills / subagents) ─────────────────────\r\n  // CONCRETE (overridable) defaults so every adapter inherits all six methods\r\n  // and the installer can call them without optional-chaining. Each returns a\r\n  // single skip when the connector declares no entries of that surface, else a\r\n  // single \"warn\" — mirroring the mcp-only hook handling. Supporting adapters\r\n  // override only the surfaces they honor.\r\n\r\n  installCommands(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"commands\", ctx.connector.commands.length);\r\n  }\r\n  uninstallCommands(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"commands\", ctx.connector.commands.length);\r\n  }\r\n  installSkills(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"skills\", ctx.connector.skills.length);\r\n  }\r\n  uninstallSkills(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"skills\", ctx.connector.skills.length);\r\n  }\r\n  installSubagents(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"subagents\", ctx.connector.subagents.length);\r\n  }\r\n  uninstallSubagents(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"subagents\", ctx.connector.subagents.length);\r\n  }\r\n\r\n  // ── Memory surface (managed marker blocks; AGENTS.md-first) ───────────────\r\n  // ONE generic implementation for every supporting host: the per-adapter\r\n  // `memoryTargets()` hook resolves WHERE to write (AGENTS.md defaults below;\r\n  // claude-code → CLAUDE.md and gemini-cli → GEMINI.md override it), and the\r\n  // core/managed-block engine performs the surgical, hash-stamped block edit.\r\n  // Unlike commands/skills/subagents these files are SHARED and user-authored —\r\n  // bytes outside this connector's own marker pair are never touched.\r\n\r\n  /**\r\n   * Resolve the memory/rules file(s) this host actually reads at ctx.scope.\r\n   * Base default (AGENTS.md-first, owner mandate):\r\n   *   - an explicit `platforms[<id>].memory.path` override wins;\r\n   *   - project scope → `<projectDir>/AGENTS.md` (the agents.md standard);\r\n   *   - user scope → the host's documented user-scope AGENTS.md, when one\r\n   *     exists ({@link AGENTS_MD_USER_PATHS}); otherwise [] → skip-warn.\r\n   * Exception hosts (claude-code, gemini-cli) override this hook.\r\n   */\r\n  protected memoryTargets(ctx: InstallContext): MemoryTarget[] {\r\n    const override = this.memoryOverride(ctx);\r\n    if (override?.path) {\r\n      const base = ctx.scope === \"project\" ? ctx.projectDir : homedir();\r\n      return [\r\n        {\r\n          path: isAbsolute(override.path) ? override.path : join(base, override.path),\r\n          reason: `platforms.${this.id}.memory.path override`,\r\n        },\r\n      ];\r\n    }\r\n    if (ctx.scope === \"project\") {\r\n      return [\r\n        { path: join(ctx.projectDir, \"AGENTS.md\"), reason: \"AGENTS.md standard (project root)\" },\r\n      ];\r\n    }\r\n    if (ctx.scope === \"user\") {\r\n      const user = AGENTS_MD_USER_PATHS[this.id]?.();\r\n      return user ? [user] : [];\r\n    }\r\n    return [];\r\n  }\r\n\r\n  /** The per-platform memory override object, when one is declared. */\r\n  protected memoryOverride(ctx: InstallContext): PlatformMemoryOverride | undefined {\r\n    const o = ctx.connector.platforms[this.id]?.memory;\r\n    return o && typeof o === \"object\" ? o : undefined;\r\n  }\r\n\r\n  installMemory(ctx: InstallContext): ChangeRecord[] {\r\n    const { connector } = ctx;\r\n    // `?? []` tolerates pre-resolved connectors from versions before the\r\n    // memory surface existed (the installer applies the same guard).\r\n    const entries = connector.memory ?? [];\r\n    if (connector.platforms[this.id]?.memory === false) {\r\n      return [{ platform: this.id, action: \"skip\", detail: `memory disabled for ${this.id}` }];\r\n    }\r\n    if (entries.length === 0) {\r\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no memory\" }];\r\n    }\r\n    if (!(this.capabilities.supportsMemory ?? false)) {\r\n      return this.unsupportedSurface(ctx, \"memory\", entries.length);\r\n    }\r\n\r\n    const changes: ChangeRecord[] = [];\r\n    const override = this.memoryOverride(ctx);\r\n    if (override?.mode && this.id !== \"claude-code\") {\r\n      changes.push({\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        detail: `memory.mode is claude-code-only; ignored on ${this.id}`,\r\n      });\r\n    }\r\n    if (ctx.scope !== \"project\" && ctx.scope !== \"user\") {\r\n      // system/profile/managed memory files are admin-owned — out of scope (v1).\r\n      changes.push({\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        detail:\r\n          `memory not supported at ${ctx.scope} scope on ${this.id} ` +\r\n          `(managed/admin memory files are out of scope); ${entries.length} skipped`,\r\n      });\r\n      return changes;\r\n    }\r\n    const targets = this.memoryTargets(ctx);\r\n    if (targets.length === 0) {\r\n      changes.push({\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        detail:\r\n          `no ${ctx.scope}-scope memory file on ${this.id} ` +\r\n          `(user rules are app/UI-managed or undocumented); ${entries.length} skipped`,\r\n      });\r\n      return changes;\r\n    }\r\n    changes.push(...this.writeMemoryBlocks(ctx, targets));\r\n    return changes;\r\n  }\r\n\r\n  /**\r\n   * Upsert every declared memory entry's block into every resolved target and\r\n   * record the ownership ledger rows (`connectorDir(id)/memory-state.json`).\r\n   * Shared by the base implementation and the exception-host overrides.\r\n   */\r\n  protected writeMemoryBlocks(ctx: InstallContext, targets: MemoryTarget[]): ChangeRecord[] {\r\n    const changes: ChangeRecord[] = [];\r\n    const ledger = loadMemoryLedger(ctx.connector.id);\r\n    let ledgerMutated = false;\r\n\r\n    for (const target of targets) {\r\n      const symlink = this.symlinkPathWarning(target.path);\r\n      if (symlink) {\r\n        changes.push(symlink);\r\n        continue;\r\n      }\r\n\r\n      for (const entry of ctx.connector.memory ?? []) {\r\n        const blockId = `${ctx.connector.id}/${entry.name ?? \"memory\"}`;\r\n        const res = upsertManagedBlockFile(target.path, {\r\n          blockId,\r\n          connectorId: ctx.connector.id,\r\n          content: entry.content,\r\n          ...(target.commentStyle ? { commentStyle: target.commentStyle } : {}),\r\n          force: ctx.force ?? false,\r\n          dryRun: ctx.dryRun,\r\n        });\r\n        changes.push({\r\n          platform: this.id,\r\n          action: res.action,\r\n          path: target.path,\r\n          detail: `memory: ${res.detail} — ${target.reason}`,\r\n        });\r\n        if (res.backupPath) {\r\n          changes.push({\r\n            platform: this.id,\r\n            action: \"create\",\r\n            path: res.backupPath,\r\n            detail: \"backed up memory file before destructive change\",\r\n          });\r\n        }\r\n        const bytes = Buffer.byteLength(entry.content, \"utf8\");\r\n        if (bytes > MEMORY_CONTENT_SOFT_BUDGET_BYTES) {\r\n          changes.push({\r\n            platform: this.id,\r\n            action: \"warn\",\r\n            path: target.path,\r\n            detail:\r\n              `memory entry \"${entry.name ?? \"memory\"}\" is ${bytes} bytes ` +\r\n              `(soft budget ${MEMORY_CONTENT_SOFT_BUDGET_BYTES}); this file is injected into ` +\r\n              `every prompt — keep guidance terse`,\r\n          });\r\n        }\r\n        if (res.action !== \"warn\") {\r\n          recordMemoryTarget(ledger, {\r\n            platform: this.id,\r\n            scope: ctx.scope,\r\n            path: target.path,\r\n            blockId,\r\n            createdFile: res.createdFile,\r\n            hash: res.hash,\r\n          });\r\n          ledgerMutated = true;\r\n        }\r\n      }\r\n      // Per-FILE budget (e.g. codex caps combined project docs at 32 KiB —\r\n      // budgetBytes ≈ 28 KiB leaves headroom): warn when the whole target file\r\n      // (user content + every block) outgrows what the host will actually load.\r\n      if (target.budgetBytes !== undefined && !ctx.dryRun && existsSync(target.path)) {\r\n        const fileBytes = statSync(target.path).size;\r\n        if (fileBytes > target.budgetBytes) {\r\n          changes.push({\r\n            platform: this.id,\r\n            action: \"warn\",\r\n            path: target.path,\r\n            detail:\r\n              `memory file is ${fileBytes} bytes — over this host's ~${target.budgetBytes}-byte ` +\r\n              `budget; the host may truncate or drop it`,\r\n          });\r\n        }\r\n      }\r\n    }\r\n\r\n    if (ledgerMutated && !ctx.dryRun) saveMemoryLedger(ctx.connector.id, ledger);\r\n    return changes;\r\n  }\r\n\r\n  uninstallMemory(ctx: InstallContext): ChangeRecord[] {\r\n    const { connector } = ctx;\r\n    if (!(this.capabilities.supportsMemory ?? false)) {\r\n      // Nothing could ever have been written by a non-supporting adapter.\r\n      return this.unsupportedSurface(ctx, \"memory\", (connector.memory ?? []).length);\r\n    }\r\n\r\n    // Candidate files = union of (a) memoryTargets recomputed NOW (probe re-run\r\n    // — catches teammate machines with no ledger; the markers in the committed\r\n    // file are the source of truth) and (b) ledger rows for this platform from\r\n    // EVERY scope (catches a scope flag that differs from install time).\r\n    const ledger = loadMemoryLedger(connector.id);\r\n    const mine = ledger.targets.filter((t) => t.platform === this.id);\r\n    const candidates = new Map<string, { createdFile: boolean }>();\r\n    if (ctx.scope === \"project\" || ctx.scope === \"user\") {\r\n      for (const t of this.memoryTargets(ctx)) {\r\n        candidates.set(t.path, { createdFile: false });\r\n      }\r\n    }\r\n    for (const row of mine) {\r\n      const existing = candidates.get(row.path);\r\n      candidates.set(row.path, { createdFile: (existing?.createdFile ?? false) || row.createdFile });\r\n    }\r\n    if (candidates.size === 0) {\r\n      return [\r\n        { platform: this.id, action: \"skip\", detail: `no memory targets to clean on ${this.id}` },\r\n      ];\r\n    }\r\n\r\n    // Prefix scan (`<connectorId>/`), NOT the declared entry list: renamed or\r\n    // removed entries and stale blocks from older versions are reclaimed too.\r\n    const changes: ChangeRecord[] = [];\r\n    let sawSymlink = false;\r\n    for (const [path, { createdFile }] of candidates) {\r\n      const symlink = this.symlinkPathWarning(path);\r\n      if (symlink) {\r\n        changes.push(symlink);\r\n        sawSymlink = true;\r\n        continue;\r\n      }\r\n\r\n      const results = removeManagedBlocksFile(\r\n        path,\r\n        { blockIdPrefix: `${connector.id}/` },\r\n        { dryRun: ctx.dryRun, deleteFileIfCreated: createdFile },\r\n      );\r\n      for (const r of results) {\r\n        changes.push({\r\n          platform: this.id,\r\n          action: r.action,\r\n          path: r.path,\r\n          detail: `memory: ${r.detail}`,\r\n        });\r\n        if (r.backupPath) {\r\n          changes.push({\r\n            platform: this.id,\r\n            action: \"create\",\r\n            path: r.backupPath,\r\n            detail: \"backed up memory file before block removal\",\r\n          });\r\n        }\r\n      }\r\n    }\r\n\r\n    // Prune this connector's ledger rows for this platform (the file itself is\r\n    // deleted when no rows remain). Markers stay the uninstall source of truth.\r\n    if (!ctx.dryRun && mine.length > 0 && !sawSymlink) {\r\n      ledger.targets = ledger.targets.filter((t) => t.platform !== this.id);\r\n      saveMemoryLedger(connector.id, ledger);\r\n    }\r\n    return changes;\r\n  }\r\n\r\n  /**\r\n   * Doctor: per-ledger-row memory state for this platform — file present,\r\n   * block present, and recorded-vs-actual inner hash (drift → warn, the\r\n   * user edited inside our block; sync reports the same drift and never\r\n   * clobbers it without --force).\r\n   */\r\n  protected memoryDiagnostics(ctx: InstallContext): DiagnosticResult[] {\r\n    const results: DiagnosticResult[] = [];\r\n    const rows = loadMemoryLedger(ctx.connector.id).targets.filter(\r\n      (t) => t.platform === this.id,\r\n    );\r\n    for (const row of rows) {\r\n      const check = `${this.name}: memory block ${row.blockId}`;\r\n      if (!existsSync(row.path)) {\r\n        results.push({\r\n          check,\r\n          status: \"warn\",\r\n          message: `memory file missing: ${row.path}`,\r\n          fix: \"agent-connector install (sync) will re-create the block\",\r\n          fixable: true,\r\n        });\r\n        continue;\r\n      }\r\n      let raw: string;\r\n      try {\r\n        raw = readFileSync(row.path, \"utf8\");\r\n      } catch {\r\n        results.push({ check, status: \"warn\", message: `cannot read ${row.path}` });\r\n        continue;\r\n      }\r\n      const block = listManagedBlocks(raw).find((b) => b.blockId === row.blockId);\r\n      if (!block) {\r\n        results.push({\r\n          check,\r\n          status: \"warn\",\r\n          message: `managed block not found in ${row.path}`,\r\n          fix: \"agent-connector install (sync) will re-append it\",\r\n          fixable: true,\r\n        });\r\n      } else if (block.drifted) {\r\n        results.push({\r\n          check,\r\n          status: \"warn\",\r\n          message:\r\n            `user-edited: inner content hash ${block.actualHash} differs from recorded ` +\r\n            `${block.recordedHash} in ${row.path}; sync leaves it intact (use --force to overwrite)`,\r\n        });\r\n      } else {\r\n        results.push({ check, status: \"pass\", message: `intact in ${row.path}` });\r\n      }\r\n      // Shadow-flip probe: re-run memoryTargets NOW for the row's scope — if\r\n      // the host's resolution moved (a WARP.md / AGENTS.override.md / .rules /\r\n      // .hermes.md appeared, gemini context.fileName changed), the written\r\n      // block sits in a file the host no longer reads. The #1 wrong-file\r\n      // risk; doctor is the detection layer.\r\n      // (`_shared/` bridge rows deliberately live OUTSIDE memoryTargets —\r\n      // e.g. claude-code's @AGENTS.md import in CLAUDE.md — skip those.)\r\n      if (\r\n        !row.blockId.startsWith(\"_shared/\") &&\r\n        row.scope === ctx.scope &&\r\n        (ctx.scope === \"project\" || ctx.scope === \"user\")\r\n      ) {\r\n        const current = this.memoryTargets(ctx);\r\n        if (current.length > 0 && !current.some((t) => t.path === row.path)) {\r\n          results.push({\r\n            check,\r\n            status: \"warn\",\r\n            message:\r\n              `${this.id} now resolves its ${row.scope}-scope memory file to ` +\r\n              `${current[0]!.path} (${current[0]!.reason}) — the block in ${row.path} ` +\r\n              `may no longer be read`,\r\n            fix: \"agent-connector install (sync) re-probes and writes the file the host reads now\",\r\n            fixable: true,\r\n          });\r\n        }\r\n      }\r\n    }\r\n    return results;\r\n  }\r\n\r\n  // ── Declarative host-config key patches (configPatch) ─────────────────────\r\n  // CONCRETE (overridable) defaults, mirroring the content surfaces above: the\r\n  // installer additionally guards these behind capabilities.supportsConfigPatch\r\n  // (the nativeHooks precedent), so these defaults only fire if a capability-\r\n  // flagged adapter forgot to override them — still skip-warn, never silent.\r\n\r\n  installConfigPatches(ctx: InstallContext): ChangeRecord[] {\r\n    const count = (ctx.connector.platforms[this.id]?.configPatch ?? []).length;\r\n    if (count === 0) {\r\n      return [\r\n        { platform: this.id, action: \"skip\", detail: \"connector declares no configPatch entries\" },\r\n      ];\r\n    }\r\n    return [\r\n      {\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        detail: `configPatch not supported on ${this.id}; ${count} skipped`,\r\n      },\r\n    ];\r\n  }\r\n\r\n  uninstallConfigPatches(_ctx: InstallContext): ChangeRecord[] {\r\n    // Nothing was ever applied by a non-supporting adapter → nothing to release.\r\n    return [];\r\n  }\r\n\r\n  // ── Statusline surface (a HUD/status line) ────────────────────────────────\r\n  // CONCRETE (overridable) defaults, mirroring the content surfaces: the\r\n  // installer calls these unconditionally (BaseAdapter defines them), and they\r\n  // self-skip when the connector declares no statusline, else skip-warn on a\r\n  // non-supporting host. Only claude-code overrides them today.\r\n\r\n  installStatusline(ctx: InstallContext): ChangeRecord[] {\r\n    if (ctx.connector.statusline == null) {\r\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no statusline\" }];\r\n    }\r\n    if (ctx.connector.platforms[this.id]?.statusline === false) {\r\n      return [{ platform: this.id, action: \"skip\", detail: `statusline disabled for ${this.id}` }];\r\n    }\r\n    if (!(this.capabilities.supportsStatusline ?? false)) {\r\n      return this.unsupportedSurface(ctx, \"statusline\", 1);\r\n    }\r\n    // A supporting adapter must override this; the default is the same skip-warn\r\n    // safety net the configPatch defaults provide (never silent).\r\n    return this.unsupportedSurface(ctx, \"statusline\", 1);\r\n  }\r\n\r\n  uninstallStatusline(ctx: InstallContext): ChangeRecord[] {\r\n    if (ctx.connector.statusline == null) {\r\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no statusline\" }];\r\n    }\r\n    if (!(this.capabilities.supportsStatusline ?? false)) {\r\n      // Nothing could ever have been written by a non-supporting adapter.\r\n      return this.unsupportedSurface(ctx, \"statusline\", 1);\r\n    }\r\n    return this.unsupportedSurface(ctx, \"statusline\", 1);\r\n  }\r\n\r\n  // ── Action surface (a user-invokable action) ──────────────────────────────\r\n  // CONCRETE (overridable) defaults, mirroring the statusline pair. v1 ships\r\n  // ONLY the dispatch backbone: there is no verifiable host affordance to emit,\r\n  // so EVERY host honestly skip-warns and NO adapter overrides these. (`?? []`\r\n  // tolerates pre-resolved connectors from versions before the action surface\r\n  // existed, exactly like installMemory.)\r\n\r\n  installActions(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"actions\", (ctx.connector.actions ?? []).length);\r\n  }\r\n  uninstallActions(ctx: InstallContext): ChangeRecord[] {\r\n    return this.unsupportedSurface(ctx, \"actions\", (ctx.connector.actions ?? []).length);\r\n  }\r\n\r\n  /**\r\n   * Shared, surface-agnostic helper for the action EMITTERS: yield one\r\n   * {@link ActionTrigger} per declared action, each carrying the home-bin verb\r\n   * command the host trigger must run\r\n   * (`<homeBin> action <host> <actionId> --connector <id>`, via\r\n   * {@link buildHomeBinActionCommand}) plus a `label`/`description` that fall\r\n   * back to the action id. Each supporting adapter iterates this and writes its\r\n   * host-native trigger (hermes quick_commands / warp workflow / droid exec\r\n   * file) — the per-host file shape is NOT this helper's concern, only the\r\n   * common (id, label, description, command) tuple. Callers own the standard\r\n   * guards (platforms[id].actions === false / empty actions).\r\n   */\r\n  protected actionTriggers(ctx: InstallContext): ActionTrigger[] {\r\n    return (ctx.connector.actions ?? []).map((action) => ({\r\n      id: action.id,\r\n      label: action.description ?? action.id,\r\n      description: action.description ?? action.id,\r\n      command: buildHomeBinActionCommand(\r\n        ctx.homeBinPath,\r\n        this.id,\r\n        action.id,\r\n        ctx.connector.id,\r\n      ),\r\n    }));\r\n  }\r\n\r\n  /**\r\n   * Default response for a content surface this platform cannot honor: a single\r\n   * skip when the connector declares none of that surface, else a single \"warn\"\r\n   * ChangeRecord noting how many were skipped. Mirrors mcp-only hook handling.\r\n   */\r\n  protected unsupportedSurface(\r\n    _ctx: InstallContext,\r\n    surface: ContentSurface,\r\n    count: number,\r\n  ): ChangeRecord[] {\r\n    if (count === 0) {\r\n      return [{ platform: this.id, action: \"skip\", detail: `connector declares no ${surface}` }];\r\n    }\r\n    return [\r\n      {\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        detail: `${surface} not supported on ${this.id}; ${count} skipped`,\r\n      },\r\n    ];\r\n  }\r\n\r\n  // ── Content-file helpers (used by surface-supporting adapters) ────────────\r\n\r\n  protected symlinkPathWarning(path: string): ChangeRecord | null {\r\n    const symlink = firstSymlinkInPath(path);\r\n    if (symlink === null) return null;\r\n    return {\r\n      platform: this.id,\r\n      action: \"warn\",\r\n      path,\r\n      detail: `${basename(path)} skipped: symbolic link in path (${symlink})`,\r\n    };\r\n  }\r\n\r\n  protected writeManagedFile(\r\n    path: string,\r\n    contents: string,\r\n    dryRun: boolean,\r\n    detail = basename(path),\r\n    executable?: boolean,\r\n  ): ChangeRecord {\r\n    const symlink = this.symlinkPathWarning(path);\r\n    if (symlink) return symlink;\r\n\r\n    let action: ChangeRecord[\"action\"];\r\n    if (!existsSync(path)) {\r\n      action = \"create\";\r\n    } else {\r\n      let current: string | null = null;\r\n      try {\r\n        current = readFileSync(path, \"utf8\");\r\n      } catch {\r\n        current = null;\r\n      }\r\n      action = current === contents ? \"skip\" : \"update\";\r\n    }\r\n    if (action !== \"skip\" && !dryRun) {\r\n      ensureDir(dirname(path));\r\n      writeFileSync(path, contents, \"utf8\");\r\n      if (executable !== undefined) chmodSync(path, executable ? 0o755 : 0o644);\r\n    }\r\n    return { platform: this.id, action, path, detail };\r\n  }\r\n\r\n  protected removeManagedFile(\r\n    path: string,\r\n    dryRun: boolean,\r\n    detail = basename(path),\r\n    absentDetail = `${detail} absent`,\r\n  ): ChangeRecord {\r\n    const symlink = this.symlinkPathWarning(path);\r\n    if (symlink) return symlink;\r\n\r\n    if (!existsSync(path)) {\r\n      return { platform: this.id, action: \"skip\", path, detail: absentDetail };\r\n    }\r\n    if (!dryRun) {\r\n      rmSync(path, { recursive: true, force: true });\r\n    }\r\n    return { platform: this.id, action: \"remove\", path, detail };\r\n  }\r\n\r\n  /**\r\n   * Write a content file idempotently: \"skip\" when the existing bytes are\r\n   * already identical, else \"create\"/\"update\". Creates parent dirs (mkdir -p).\r\n   * Honors dryRun (computes the action but writes nothing).\r\n   */\r\n  protected writeContentFile(path: string, contents: string, dryRun: boolean): ChangeRecord {\r\n    return this.writeManagedFile(path, contents, dryRun);\r\n  }\r\n\r\n  /**\r\n   * Remove a content file we wrote; \"skip\" when already absent. Honors dryRun.\r\n   * Uses rmSync with `force` to also tolerate a path that is a directory tree\r\n   * (e.g. a skill folder removed by the supporting adapter).\r\n   */\r\n  protected removeContentFile(path: string, dryRun: boolean): ChangeRecord {\r\n    return this.removeManagedFile(path, dryRun);\r\n  }\r\n\r\n  /**\r\n   * Defense-in-depth path containment: resolve `rel` against `baseDir` and\r\n   * return the absolute path ONLY when it stays inside `baseDir`. Returns null\r\n   * when `rel` escapes (absolute path, `..` traversal, etc.) so a caller can\r\n   * skip-and-warn rather than write/delete outside the surface dir. This is the\r\n   * runtime backstop behind the config-time validation in normalizeSkills.\r\n   */\r\n  protected resolveWithin(baseDir: string, rel: string): string | null {\r\n    const base = resolve(baseDir);\r\n    const target = resolve(base, rel);\r\n    if (target === base) return null; // rel resolved to the dir itself (e.g. \"\" / \".\")\r\n    const rind = relative(base, target);\r\n    // Outside when the relative path climbs out (`..`) or is itself absolute.\r\n    if (rind === \"\" || rind.startsWith(\"..\") || resolve(base, rind) !== target) {\r\n      return null;\r\n    }\r\n    if (rind === \"..\" || rind.startsWith(`..${sep}`)) return null;\r\n    return target;\r\n  }\r\n\r\n  /**\r\n   * Recursively report whether a directory tree contains any regular FILE (vs\r\n   * only empty/nested-empty subdirectories). Symlinks count as files (we never\r\n   * recurse through them). Used by removeDirIfEmpty to decide if a tree is safe\r\n   * to drop. An unreadable entry is treated as \"a file is present\" (conservative).\r\n   */\r\n  private dirTreeHasFile(dir: string): boolean {\r\n    let entries: Dirent[];\r\n    try {\r\n      entries = readdirSync(dir, { withFileTypes: true });\r\n    } catch {\r\n      return true; // unreadable → assume it holds data; do not remove\r\n    }\r\n    for (const e of entries) {\r\n      if (e.isDirectory()) {\r\n        if (this.dirTreeHasFile(join(dir, e.name))) return true;\r\n      } else {\r\n        return true; // a file / symlink / special → the tree is not \"empty\"\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Remove a directory ONLY when its tree holds NO regular files — i.e. it is\r\n   * empty or contains only (nested) empty directories, such as the intermediate\r\n   * dirs our own nested skill resources created. Replaces the unconditional\r\n   * `rm -rf <dir>` that uninstallSkills used to call, which destroyed user-added\r\n   * files / sibling-tool files / shared skill dirs the connector never wrote.\r\n   * When ANY file remains (at any depth) the whole tree is left in place and the\r\n   * skip is noted. Honors dryRun (computes the action but removes nothing). A\r\n   * missing dir is a no-op \"skip\".\r\n   */\r\n  protected removeDirIfEmpty(dir: string, dryRun: boolean): ChangeRecord {\r\n    const symlink = this.symlinkPathWarning(dir);\r\n    if (symlink) return symlink;\r\n\r\n    if (!existsSync(dir)) {\r\n      return { platform: this.id, action: \"skip\", path: dir, detail: `${basename(dir)} absent` };\r\n    }\r\n    let stat: ReturnType<typeof statSync>;\r\n    try {\r\n      stat = statSync(dir);\r\n    } catch {\r\n      return {\r\n        platform: this.id,\r\n        action: \"skip\",\r\n        path: dir,\r\n        detail: `${basename(dir)} unreadable; left in place`,\r\n      };\r\n    }\r\n    if (!stat.isDirectory()) {\r\n      return {\r\n        platform: this.id,\r\n        action: \"skip\",\r\n        path: dir,\r\n        detail: `${basename(dir)} not a directory; left in place`,\r\n      };\r\n    }\r\n    if (this.dirTreeHasFile(dir)) {\r\n      return {\r\n        platform: this.id,\r\n        action: \"skip\",\r\n        path: dir,\r\n        detail: `${basename(dir)} still holds files we did not write; left in place`,\r\n      };\r\n    }\r\n    if (!dryRun) {\r\n      try {\r\n        // The tree is files-free: only (possibly nested) empty dirs remain, which\r\n        // are ours / inert. A recursive remove drops them without touching data.\r\n        rmSync(dir, { recursive: true, force: true });\r\n      } catch {\r\n        // Lost a race or perms — non-fatal; report as a skip.\r\n        return {\r\n          platform: this.id,\r\n          action: \"skip\",\r\n          path: dir,\r\n          detail: `${basename(dir)} could not be removed; left in place`,\r\n        };\r\n      }\r\n    }\r\n    return { platform: this.id, action: \"remove\", path: dir, detail: basename(dir) };\r\n  }\r\n\r\n  /**\r\n   * Render a YAML-frontmatter + markdown body document:\r\n   *   \"---\\n\" + <yaml> + \"---\\n\\n\" + <body> + \"\\n\".\r\n   * Delegates to the shared renderer (adapters/claude-code/render) so every\r\n   * content-file path — adapters AND the plugin packager — emits identical bytes.\r\n   */\r\n  protected renderFrontmatterMd(\r\n    frontmatter: Record<string, unknown>,\r\n    body: string,\r\n  ): string {\r\n    return renderFrontmatterMd(frontmatter, body);\r\n  }\r\n\r\n  // ── JSON config helpers (used by JSON-format adapters) ───────────────────\r\n\r\n  /**\r\n   * Read + parse a JSON/JSONC config file, returning null when it is absent OR\r\n   * unparseable. Parses TOLERANTLY via parseJsonc (strips // and /* *\\/ comments\r\n   * and trailing commas) so a perfectly valid JSONC file never false-fails to\r\n   * null — that null is what `?? {}` would otherwise turn into a clobbering\r\n   * overwrite of the user's whole config.\r\n   */\r\n  protected readJson<T = Record<string, unknown>>(path: string): T | null {\r\n    if (!existsSync(path)) return null;\r\n    try {\r\n      return parseJsonc<T>(readFileSync(path, \"utf8\"));\r\n    } catch {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * True when `path` exists and holds non-whitespace content but readJson cannot\r\n   * parse it (even after JSONC stripping). The overwrite guard: writing a\r\n   * `{}`-based config over a present-but-broken settings file would silently\r\n   * destroy the user's data, so callers warn-and-skip instead.\r\n   */\r\n  protected isPresentButUnparseable(path: string): boolean {\r\n    if (!existsSync(path)) return false;\r\n    let raw: string;\r\n    try {\r\n      if (statSync(path).size === 0) return false;\r\n      raw = readFileSync(path, \"utf8\");\r\n    } catch {\r\n      return false;\r\n    }\r\n    if (raw.trim() === \"\") return false;\r\n    return this.readJson(path) === null;\r\n  }\r\n\r\n  protected writeJson(path: string, data: unknown, dryRun = false): void {\r\n    if (dryRun) return;\r\n    const symlink = firstSymlinkInPath(path);\r\n    if (symlink !== null) {\r\n      throw new Error(`${basename(path)} skipped: symbolic link in path (${symlink})`);\r\n    }\r\n    ensureDir(dirname(path));\r\n    writeFileSync(path, `${JSON.stringify(data, null, 2)}\\n`, \"utf8\");\r\n  }\r\n\r\n  /**\r\n   * True when a PRESENT rootKey value is not a plain object map (the user\r\n   * hand-edited it to an array / string / number / boolean). Assigning a server\r\n   * entry into such a value would corrupt the file silently (a named property on\r\n   * an Array is dropped by JSON.stringify) or throw under strict mode (a property\r\n   * write / `in` operator against a primitive), so callers warn-and-skip. A\r\n   * `null`/`undefined` value is NOT malformed — it is the well-formed \"absent\"\r\n   * case the helpers create fresh.\r\n   */\r\n  protected isMalformedRootValue(value: unknown): boolean {\r\n    return isMalformedRootValueFn(value);\r\n  }\r\n\r\n  /**\r\n   * Warn-skip ChangeRecord when an existing JSON `hooks` config is present-but-\r\n   * malformed (root hand-edited to an array/primitive, or an existing event\r\n   * bucket is a non-array) — installing a hook into it would silently drop the\r\n   * entry (a named property on an Array is dropped by JSON.stringify) or throw\r\n   * under strict mode (a `.push`/property write against a primitive or non-array\r\n   * bucket). Returns null when the hooks config is well-formed, including the\r\n   * absent case the installers create fresh (proceed normally). Mirrors the\r\n   * server-root guard (isMalformedRootValue). All targeted hosts use the Claude-\r\n   * style `{ Event: Matcher[] }` shape, so every present event bucket must be an\r\n   * array; a non-array bucket is the same malformed class as a wrong-typed root.\r\n   */\r\n  protected malformedHookRootSkip(configPath: string, hooksRoot: unknown): ChangeRecord | null {\r\n    if (hooksRoot == null) return null; // absent → installer creates fresh\r\n    if (this.isMalformedRootValue(hooksRoot)) {\r\n      // array / primitive root\r\n      return {\r\n        platform: this.id,\r\n        action: \"warn\",\r\n        path: configPath,\r\n        detail: `existing \"hooks\" in ${configPath} is not an object map; left untouched (fix it, then re-run)`,\r\n      };\r\n    }\r\n    for (const v of Object.values(hooksRoot as Record<string, unknown>)) {\r\n      if (v !== undefined && !Array.isArray(v)) {\r\n        // an existing event bucket is a non-array\r\n        return {\r\n          platform: this.id,\r\n          action: \"warn\",\r\n          path: configPath,\r\n          detail: `existing \"hooks\" in ${configPath} has a non-array event bucket; left untouched (fix it, then re-run)`,\r\n        };\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n\r\n  // ── Shared object-map hook-array merge engine ────────────────────────────\r\n  // installHooks/uninstallHooks for every json-stdio host that stores hooks as\r\n  // `{ <event>: HookEntry[] }` share ONE create/update/skip + strip/remove\r\n  // orchestration. The host supplies a {@link HookMergeDescriptor} carrying\r\n  // EVERY observable string and ownership predicate — the engine body hardcodes\r\n  // none of them, so per-host wording (skip/remove/absent/no-match details) and\r\n  // FLAT-vs-NESTED removal stay host-controlled and never drift to a lowest-\r\n  // common-denominator phrasing the suites (which assert by action) would miss.\r\n  // The write-gate is the `mutated` bool, matching the migrated host exactly.\r\n\r\n  /**\r\n   * Install: upsert each `{ event, matcher }` in `pending` into the object-map\r\n   * `hooks` root at `configPath`. Reproduces the canonical host's loop: read\r\n   * `?? {}`, warn-skip on a malformed `hooks` root, then per pending item render\r\n   * the entry, find the owned slot, and create/update/skip. Writes once at the\r\n   * end iff anything mutated.\r\n   *\r\n   * Hosts that fold their `nativeHooks` surface into `pending` (claude-code) pass\r\n   * no `native` arg. Hosts that keep the native surface SEPARATE — verbatim\r\n   * event keys, EXACT-command ownership, a distinct `(native)` detail — pass it\r\n   * as the optional `native` list (cursor); that pass runs after the normalized\r\n   * loop and before the single write. Omitting it is byte-identical to before.\r\n   */\r\n  /**\r\n   * Resolve the per-event hook bucket. With \"coerce\" policy a present-but-non-\r\n   * array bucket (hand-edited) is replaced by a fresh array; otherwise `??=` is\r\n   * used (the warn-skip path already rejected any non-array bucket via\r\n   * malformedHookRootSkip, so `??=` only ever fills the absent case).\r\n   */\r\n  private coerceHookBucket<E>(\r\n    hooks: Record<string, E[]>,\r\n    event: string,\r\n    coerce: boolean,\r\n  ): E[] {\r\n    if (coerce) {\r\n      return Array.isArray(hooks[event]) ? hooks[event] : (hooks[event] = []);\r\n    }\r\n    return (hooks[event] ??= []);\r\n  }\r\n\r\n  protected upsertHookEntries<E>(\r\n    ctx: InstallContext,\r\n    configPath: string,\r\n    pending: ReadonlyArray<{ event: string; matcher: string }>,\r\n    descriptor: HookMergeDescriptor<E>,\r\n    native?: ReadonlyArray<{ event: string; matcher: string }>,\r\n  ): ChangeRecord[] {\r\n    const symlink = this.symlinkPathWarning(configPath);\r\n    if (symlink) return [symlink];\r\n\r\n    const file = this.readJson<Record<string, unknown>>(configPath) ?? {};\r\n    const coerce = descriptor.malformedPolicy === \"coerce\";\r\n    let hooks: Record<string, E[]>;\r\n    if (coerce) {\r\n      // COERCE policy: a present-but-malformed `hooks` root (array / primitive,\r\n      // hand-edited) is replaced by a fresh object map; a well-formed object map\r\n      // is kept as-is. Never warn, never throw — matches the container hosts'\r\n      // server-path policy.\r\n      const existing = file.hooks;\r\n      hooks =\r\n        existing && typeof existing === \"object\" && !Array.isArray(existing)\r\n          ? (existing as Record<string, E[]>)\r\n          : ((file.hooks = {}) as Record<string, E[]>);\r\n    } else {\r\n      const skip = this.malformedHookRootSkip(configPath, file.hooks);\r\n      if (skip) return [skip];\r\n      hooks = (file.hooks ??= {}) as Record<string, E[]>;\r\n    }\r\n\r\n    const changes: ChangeRecord[] = [];\r\n    let mutated = false;\r\n\r\n    for (const { event, matcher } of pending) {\r\n      const hostEvent = descriptor.mapEvent ? descriptor.mapEvent(event) : event;\r\n      if (hostEvent === undefined) {\r\n        changes.push({\r\n          platform: this.id,\r\n          action: descriptor.unmappedAction ? descriptor.unmappedAction(event) : \"warn\",\r\n          path: configPath,\r\n          detail: descriptor.unmappedWarnDetail!(event),\r\n        });\r\n        continue;\r\n      }\r\n      // Command is built from the CANONICAL `event` (NOT hostEvent) — the home\r\n      // binary dispatches on the canonical name; only the host's bucket key,\r\n      // detail, and skipDetail use the mapped `hostEvent`.\r\n      const command = buildHomeBinHookCommand(\r\n        ctx.homeBinPath,\r\n        this.id,\r\n        event,\r\n        ctx.connector.id,\r\n      );\r\n      const entry = descriptor.renderEntry(hostEvent, matcher, command);\r\n      const bucket = this.coerceHookBucket(hooks, hostEvent, coerce);\r\n      const r = upsertInArray(bucket, entry, (e) =>\r\n        descriptor.entryOwnsCommand(e, command),\r\n      );\r\n\r\n      if (r.action !== \"skip\") {\r\n        hooks[hostEvent] = r.array;\r\n        mutated = true;\r\n      }\r\n      changes.push({\r\n        platform: this.id,\r\n        action: r.action,\r\n        path: configPath,\r\n        detail:\r\n          r.action === \"skip\"\r\n            ? descriptor.skipDetail(hostEvent)\r\n            : `hooks.${hostEvent}`,\r\n      });\r\n    }\r\n\r\n    // Native pass (json-stdio hosts with a verbatim `nativeHooks` surface):\r\n    // native event-name keys are NOT mapEvent-mapped, are found by EXACT command\r\n    // (so a native key coinciding with a normalized event's mapped key adds a\r\n    // SECOND distinct command rather than clobbering it), and carry the `(native)`\r\n    // detail. Hosts passing no `native` list skip this loop entirely → the\r\n    // normalized-only behavior is byte-identical.\r\n    for (const { event, matcher } of native ?? []) {\r\n      const command = buildHomeBinHookCommand(\r\n        ctx.homeBinPath,\r\n        this.id,\r\n        event,\r\n        ctx.connector.id,\r\n      );\r\n      const entry = descriptor.renderEntry(event, matcher, command);\r\n      const bucket = this.coerceHookBucket(hooks, event, coerce);\r\n      const r = upsertInArray(bucket, entry, (e) =>\r\n        descriptor.nativeOwnsCommand!(e, command),\r\n      );\r\n      if (r.action !== \"skip\") {\r\n        hooks[event] = r.array;\r\n        mutated = true;\r\n      }\r\n      changes.push({\r\n        platform: this.id,\r\n        action: r.action,\r\n        path: configPath,\r\n        detail:\r\n          r.action === \"skip\"\r\n            ? descriptor.nativeSkipDetail!(event)\r\n            : descriptor.nativeMutateDetail!(event),\r\n      });\r\n    }\r\n\r\n    if (mutated) {\r\n      descriptor.onMutate?.(file);\r\n      this.writeJson(configPath, file, ctx.dryRun);\r\n    }\r\n    return changes;\r\n  }\r\n\r\n  /**\r\n   * Uninstall: strip owned content from every event bucket in the object-map\r\n   * `hooks` root at `configPath`. NESTED hosts pass `descriptor.stripInner`\r\n   * (strip owned inner commands, drop emptied entries; `removed` = inner\r\n   * commands); FLAT hosts omit it (drop whole owned entries). Reproduces the\r\n   * canonical host: read (NO `?? {}`), `[skip]` (absentDetail) when no hooks\r\n   * section, per-event remove → delete-or-replace bucket, write once iff\r\n   * mutated, and a single `[skip]` (noMatchDetail) when nothing matched.\r\n   */\r\n  protected removeHookEntries<E>(\r\n    ctx: InstallContext,\r\n    configPath: string,\r\n    descriptor: HookMergeDescriptor<E>,\r\n  ): ChangeRecord[] {\r\n    const symlink = this.symlinkPathWarning(configPath);\r\n    if (symlink) return [symlink];\r\n\r\n    const file = this.readJson<Record<string, unknown>>(configPath);\r\n    const hooks = file?.hooks as Record<string, E[]> | undefined;\r\n    if (!file || !hooks) {\r\n      return [\r\n        {\r\n          platform: this.id,\r\n          action: \"skip\",\r\n          path: configPath,\r\n          detail: descriptor.absentDetail,\r\n        },\r\n      ];\r\n    }\r\n\r\n    const changes: ChangeRecord[] = [];\r\n    let mutated = false;\r\n    // stripInner is event-independent for current hosts → computed once. The\r\n    // whole-entry ownership predicate is rebuilt PER EVENT so EVENT-SPECIFIC\r\n    // hosts (codex) can match the canonical event being stripped; event-agnostic\r\n    // hosts simply ignore the param.\r\n    const stripInner = descriptor.stripInner?.(ctx);\r\n\r\n    // Default: scan every present key. EVENT-SPECIFIC hosts pin a fixed event set\r\n    // (descriptor.removeEventKeys) so a foreign-key bucket is never inspected —\r\n    // matching their original fixed-event-list uninstall loop byte-for-byte.\r\n    for (const event of descriptor.removeEventKeys ?? Object.keys(hooks)) {\r\n      const bucket = hooks[event];\r\n      if (!Array.isArray(bucket)) continue;\r\n\r\n      const ownsEntry = descriptor.ownsEntryForRemove(ctx, event);\r\n      const r = removeFromArray(bucket, ownsEntry, stripInner);\r\n      if (r.removed > 0) {\r\n        if (r.array.length > 0) hooks[event] = r.array;\r\n        else delete hooks[event];\r\n        changes.push({\r\n          platform: this.id,\r\n          action: \"remove\",\r\n          path: configPath,\r\n          detail: descriptor.removeDetail(event, r.removed),\r\n        });\r\n        mutated = true;\r\n      }\r\n    }\r\n\r\n    if (mutated) this.writeJson(configPath, file, ctx.dryRun);\r\n    if (changes.length === 0) {\r\n      changes.push({\r\n        platform: this.id,\r\n        action: \"skip\",\r\n        path: configPath,\r\n        detail: descriptor.noMatchDetail,\r\n      });\r\n    }\r\n    return changes;\r\n  }\r\n\r\n  /** Bind BaseAdapter's JSON leaf IO (readJson/writeJson + the unparseable\r\n   * overwrite guard) as a Codec for the object-map engine. */\r\n  private jsonObjectMapCodec(): ObjectMapCodec {\r\n    return {\r\n      parse: (path) => this.readJson<Record<string, unknown>>(path),\r\n      serialize: (path, data, dryRun) => this.writeJson(path, data, dryRun),\r\n      isPresentButUnparseable: (path) => this.isPresentButUnparseable(path),\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Upsert `entry` at `config[rootKey][serverId]` in a JSON file, creating the\r\n   * file/object as needed. Returns a ChangeRecord describing create/update/skip.\r\n   * Idempotent: an identical entry yields \"skip\".\r\n   */\r\n  protected upsertServerInJson(\r\n    configPath: string,\r\n    rootKey: string,\r\n    serverId: string,\r\n    entry: unknown,\r\n    dryRun = false,\r\n  ): ChangeRecord {\r\n    const symlink = this.symlinkPathWarning(configPath);\r\n    if (symlink) return symlink;\r\n\r\n    return upsertInObjectMap({\r\n      codec: this.jsonObjectMapCodec(),\r\n      rootKey,\r\n      platform: this.id,\r\n      configPath,\r\n      entryId: serverId,\r\n      entry,\r\n      dryRun,\r\n    });\r\n  }\r\n\r\n  /** Remove `config[rootKey][serverId]` from a JSON file. */\r\n  protected removeServerFromJson(\r\n    configPath: string,\r\n    rootKey: string,\r\n    serverId: string,\r\n    dryRun = false,\r\n  ): ChangeRecord {\r\n    const symlink = this.symlinkPathWarning(configPath);\r\n    if (symlink) return symlink;\r\n\r\n    return removeFromObjectMap({\r\n      codec: this.jsonObjectMapCodec(),\r\n      rootKey,\r\n      platform: this.id,\r\n      configPath,\r\n      entryId: serverId,\r\n      dryRun,\r\n    });\r\n  }\r\n\r\n  // ── Backup ───────────────────────────────────────────────────────────────\r\n\r\n  backupSettings(ctx: InstallContext): string | null {\r\n    const files = [...new Set([this.getServerConfigPath(ctx), this.getHookConfigPath(ctx)])].filter(\r\n      (f) => {\r\n        if (!existsSync(f)) return false;\r\n        try {\r\n          return statSync(f).isFile();\r\n        } catch {\r\n          return false;\r\n        }\r\n      },\r\n    );\r\n    if (files.length === 0) return null;\r\n    if (ctx.dryRun) return null;\r\n    ensureDir(backupsDir());\r\n    const stamp = new Date().toISOString().replace(/[:.]/g, \"-\");\r\n    let last: string | null = null;\r\n    for (const f of files) {\r\n      const dest = join(backupsDir(), `${this.id}-${stamp}-${basename(f)}`);\r\n      copyFileSync(f, dest);\r\n      last = dest;\r\n    }\r\n    return last;\r\n  }\r\n\r\n  // ── Diagnostics ─────────────────────────────────────────────────────────\r\n\r\n  getHealthChecks?(ctx: InstallContext): readonly HealthCheck[];\r\n\r\n  doctor(ctx: InstallContext): DiagnosticResult[] {\r\n    const results: DiagnosticResult[] = [];\r\n    const cfg = this.getServerConfigPath(ctx);\r\n    results.push(\r\n      existsSync(cfg)\r\n        ? { check: `${this.name}: config present`, status: \"pass\", message: cfg }\r\n        : {\r\n            check: `${this.name}: config present`,\r\n            status: \"warn\",\r\n            message: `not found: ${cfg}`,\r\n            fix: `agent-connector install --targets ${this.id}`,\r\n            // Only sync-recoverable when the connector actually declares a\r\n            // server — a re-sync writes the config file only then. For a\r\n            // serverless (memory/configPatch-only) connector the file is never\r\n            // created, so marking it fixable would loop it into \"still failing\".\r\n            fixable: !!ctx.connector.server,\r\n          },\r\n    );\r\n    for (const hc of this.getHealthChecks?.(ctx) ?? []) {\r\n      const r = hc.check();\r\n      results.push({\r\n        check: hc.name,\r\n        status: r.status === \"OK\" ? \"pass\" : \"fail\",\r\n        message: r.detail ?? r.status,\r\n      });\r\n    }\r\n    // Memory-surface checks are ledger-driven: no installed memory → no rows →\r\n    // no noise. Shared by every adapter (the overrides call super.doctor()).\r\n    results.push(...this.memoryDiagnostics(ctx));\r\n    return results;\r\n  }\r\n}\r\n","/** Decision for one inner-array upsert. */\r\nexport type ArrayUpsertAction = \"create\" | \"update\" | \"skip\";\r\n\r\nexport interface ArrayUpsertResult<E> {\r\n  array: E[];\r\n  action: ArrayUpsertAction;\r\n}\r\n\r\n/**\r\n * Upsert one rendered `candidate` into a per-event hook array.\r\n *  - find the FIRST entry the caller OWNS via `ownsEntry`;\r\n *  - hit + JSON-equal  → skip   (array returned unchanged);\r\n *  - hit + differs     → update (replace that slot);\r\n *  - miss              → create (push).\r\n */\r\nexport function upsertInArray<E>(\r\n  array: E[],\r\n  candidate: E,\r\n  ownsEntry: (entry: E) => boolean,\r\n): ArrayUpsertResult<E> {\r\n  const idx = array.findIndex(ownsEntry);\r\n  if (idx >= 0) {\r\n    if (JSON.stringify(array[idx]) === JSON.stringify(candidate)) {\r\n      return { array, action: \"skip\" };\r\n    }\r\n    const next = array.slice();\r\n    next[idx] = candidate;\r\n    return { array: next, action: \"update\" };\r\n  }\r\n  return { array: [...array, candidate], action: \"create\" };\r\n}\r\n\r\nexport interface ArrayRemoveResult<E> {\r\n  array: E[];\r\n  removed: number;\r\n}\r\n\r\n/**\r\n * Remove owned content from a per-event hook array.\r\n *  - FLAT hosts: omit `stripInner` → drop whole entries matching `ownsEntry`;\r\n *    `removed` = whole entries dropped.\r\n *  - NESTED hosts: pass `stripInner` → strip owned inner commands and rebuild,\r\n *    dropping entries left empty; `removed` = inner commands removed.\r\n */\r\nexport function removeFromArray<E>(\r\n  array: E[],\r\n  ownsEntry: (entry: E) => boolean,\r\n  stripInner?: (entry: E) => { next: E | null; removed: number },\r\n): ArrayRemoveResult<E> {\r\n  if (!stripInner) {\r\n    const kept = array.filter((e) => !ownsEntry(e));\r\n    return { array: kept, removed: array.length - kept.length };\r\n  }\r\n  const kept: E[] = [];\r\n  let removed = 0;\r\n  for (const e of array) {\r\n    const r = stripInner(e);\r\n    removed += r.removed;\r\n    if (r.next !== null) kept.push(r.next);\r\n  }\r\n  return { array: kept, removed };\r\n}\r\n"],"mappings":"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","names":["kept"]}

package/dist/chunk-4GH2KA7V.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/logger.ts"],"sourcesContent":["/**\r\n * core/logger — minimal leveled logger. Writes human output to stderr so stdout\r\n * stays clean for machine-readable payloads (hook replies, --json output).\r\n */\r\n\r\nexport type LogLevel = \"silent\" | \"error\" | \"warn\" | \"info\" | \"debug\";\r\n\r\nconst ORDER: Record<LogLevel, number> = {\r\n  silent: 0,\r\n  error: 1,\r\n  warn: 2,\r\n  info: 3,\r\n  debug: 4,\r\n};\r\n\r\nfunction currentLevel(): LogLevel {\r\n  const env = (process.env.AGENT_CONNECTOR_LOG ?? \"info\").toLowerCase();\r\n  return (env in ORDER ? env : \"info\") as LogLevel;\r\n}\r\n\r\nfunction emit(level: Exclude<LogLevel, \"silent\">, args: unknown[]): void {\r\n  if (ORDER[currentLevel()] < ORDER[level]) return;\r\n  const prefix = { error: \"✗\", warn: \"!\", info: \"›\", debug: \"·\" }[level];\r\n  // eslint-disable-next-line no-console\r\n  console.error(prefix, ...args);\r\n}\r\n\r\nexport const log = {\r\n  error: (...args: unknown[]) => emit(\"error\", args),\r\n  warn: (...args: unknown[]) => emit(\"warn\", args),\r\n  info: (...args: unknown[]) => emit(\"info\", args),\r\n  debug: (...args: unknown[]) => emit(\"debug\", args),\r\n};\r\n"],"mappings":";;;AAOA,IAAM,QAAkC;AAAA,EACtC,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAEA,SAAS,eAAyB;AAChC,QAAM,OAAO,QAAQ,IAAI,uBAAuB,QAAQ,YAAY;AACpE,SAAQ,OAAO,QAAQ,MAAM;AAC/B;AAEA,SAAS,KAAK,OAAoC,MAAuB;AACvE,MAAI,MAAM,aAAa,CAAC,IAAI,MAAM,KAAK,EAAG;AAC1C,QAAM,SAAS,EAAE,OAAO,UAAK,MAAM,KAAK,MAAM,UAAK,OAAO,OAAI,EAAE,KAAK;AAErE,UAAQ,MAAM,QAAQ,GAAG,IAAI;AAC/B;AAEO,IAAM,MAAM;AAAA,EACjB,OAAO,IAAI,SAAoB,KAAK,SAAS,IAAI;AAAA,EACjD,MAAM,IAAI,SAAoB,KAAK,QAAQ,IAAI;AAAA,EAC/C,MAAM,IAAI,SAAoB,KAAK,QAAQ,IAAI;AAAA,EAC/C,OAAO,IAAI,SAAoB,KAAK,SAAS,IAAI;AACnD;","names":[]}

package/dist/chunk-7C2IPIIB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/marketplace-state.ts"],"sourcesContent":["/**\r\n * core/marketplace-state — pure read/write helpers for MARKETPLACE-method\r\n * install state. A LEAF module (fs + paths only, no adapters, no spawning) so\r\n * the installer, the marketplace orchestration, doctor, and status can all\r\n * import it without cycles.\r\n *\r\n * Two kinds of state live here:\r\n *\r\n *   1. The per-connector state record `connectorDir(id)/marketplace-installs.json`\r\n *      — one entry per platform a connector was marketplace-installed on\r\n *      ({ format, bundleDir, marketplace, scope, version, contentHash,\r\n *      installedAt }). It drives `uninstall --method auto`, upgrade staleness\r\n *      warnings, doctor, and the double-install guard.\r\n *\r\n *   2. Read-only fs EVIDENCE probes of the hosts' own plugin state (e.g.\r\n *      Claude Code's `$CLAUDE_CONFIG_DIR/plugins/installed_plugins.json`).\r\n *      These catch installs the user performed manually from `package`'s\r\n *      printed instructions, which the state record alone would miss. Probes\r\n *      read undocumented host internals, so every reader degrades to null/false\r\n *      on absence or parse failure — the guard convention is \"refuse only on\r\n *      positive evidence\" (docs: design risk 4).\r\n */\r\n\r\nimport { createHash } from \"node:crypto\";\r\nimport {\r\n  existsSync,\r\n  readdirSync,\r\n  readFileSync,\r\n  realpathSync,\r\n  rmSync,\r\n  statSync,\r\n  writeFileSync,\r\n} from \"node:fs\";\r\nimport { homedir } from \"node:os\";\r\nimport { dirname, join, relative, resolve } from \"node:path\";\r\nimport { fileURLToPath } from \"node:url\";\r\n\r\nimport TOML from \"@iarna/toml\";\r\n\r\nimport type { InstallScope, PlatformId } from \"./types.js\";\r\nimport type { PackageFormat } from \"./package.js\";\r\nimport {\r\n  assertNoSymlinkInPath,\r\n  connectorDir,\r\n  connectorsDir,\r\n  dataRoot,\r\n  ensureDir,\r\n} from \"./paths.js\";\r\nimport { codexConfigHome, xdgConfigHome } from \"./host-paths.js\";\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// State record: connectorDir(id)/marketplace-installs.json\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** The catalog name every staged local marketplace is registered under. */\r\nexport const MARKETPLACE_NAME = \"agent-connector\";\r\n\r\n/** One marketplace install of one connector on one platform. */\r\nexport interface MarketplaceInstallRecord {\r\n  /** Bundle format that was staged + installed (e.g. \"claude-plugin\"). */\r\n  format: PackageFormat;\r\n  /** Absolute path of the staged plugin dir the host references/copied. */\r\n  bundleDir: string;\r\n  /** Marketplace/catalog name the install is keyed under ({@link MARKETPLACE_NAME}). */\r\n  marketplace: string;\r\n  /** Install scope (v1: always \"user\"). */\r\n  scope: InstallScope;\r\n  /** connector.version at install time (staleness warnings key off this). */\r\n  version: string;\r\n  /** sha256 over the staged plugin dir at install time (drift detection). */\r\n  contentHash: string;\r\n  /** ISO timestamp of the recorded install. */\r\n  installedAt: string;\r\n}\r\n\r\n/** platform → record map persisted per connector. */\r\nexport type MarketplaceInstalls = Partial<\r\n  Record<PlatformId, MarketplaceInstallRecord>\r\n>;\r\n\r\n/** Path of the per-connector marketplace state record. */\r\nexport function marketplaceInstallsPath(connectorId: string): string {\r\n  return join(connectorDir(connectorId), \"marketplace-installs.json\");\r\n}\r\n\r\n/** Read the state record ({} on absence/parse failure — never throws). */\r\nexport function readMarketplaceInstalls(connectorId: string): MarketplaceInstalls {\r\n  try {\r\n    const raw = readFileSync(marketplaceInstallsPath(connectorId), \"utf8\");\r\n    const parsed = JSON.parse(raw) as unknown;\r\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\r\n      return parsed as MarketplaceInstalls;\r\n    }\r\n  } catch {\r\n    /* absent / unreadable → empty */\r\n  }\r\n  return {};\r\n}\r\n\r\n/** Write the state record; an empty map DELETES the file (uninstall leaves no husk). */\r\nexport function writeMarketplaceInstalls(\r\n  connectorId: string,\r\n  installs: MarketplaceInstalls,\r\n): void {\r\n  const path = marketplaceInstallsPath(connectorId);\r\n  assertNoSymlinkInPath(path);\r\n  if (Object.keys(installs).length === 0) {\r\n    rmSync(path, { force: true });\r\n    return;\r\n  }\r\n  ensureDir(dirname(path));\r\n  writeFileSync(path, `${JSON.stringify(installs, null, 2)}\\n`, \"utf8\");\r\n}\r\n\r\n/** True when THIS connector has any recorded marketplace install. */\r\nexport function connectorHasMarketplaceRecords(connectorId: string): boolean {\r\n  return Object.keys(readMarketplaceInstalls(connectorId)).length > 0;\r\n}\r\n\r\n/**\r\n * True when ANY registered connector (optionally excluding one) still records a\r\n * marketplace install. Guards home-bin removal on purge: an installed plugin's\r\n * hooks exec the home-bin OUTSIDE any adapter-managed config, so removing the\r\n * launcher while a marketplace install survives would silently kill its hooks.\r\n */\r\nexport function anyMarketplaceRecordsRemain(excludeConnectorId?: string): boolean {\r\n  const dir = connectorsDir();\r\n  if (!existsSync(dir)) return false;\r\n  let entries: string[];\r\n  try {\r\n    entries = readdirSync(dir);\r\n  } catch {\r\n    return false;\r\n  }\r\n  return entries.some(\r\n    (id) => id !== excludeConnectorId && connectorHasMarketplaceRecords(id),\r\n  );\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Staging roots — bundles staged by-reference must survive cwd changes and\r\n// `rm -rf dist-plugin`, so they live under the data-root, one shared root per\r\n// host family, holding every marketplace-installed connector's bundle plus ONE\r\n// regenerated catalog named \"agent-connector\" listing them all.\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Root for every marketplace staging tree: <dataRoot>/marketplace. */\r\nexport function marketplaceRoot(): string {\r\n  return join(dataRoot(), \"marketplace\");\r\n}\r\n\r\n/** Shared Claude-family staging root: <dataRoot>/marketplace/claude. */\r\nexport function claudeStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"claude\");\r\n}\r\n\r\n/** Shared Codex-family staging root: <dataRoot>/marketplace/codex. */\r\nexport function codexStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"codex\");\r\n}\r\n\r\n/** Shared GitHub Copilot CLI staging root: <dataRoot>/marketplace/copilot. */\r\nexport function copilotStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"copilot\");\r\n}\r\n\r\n/** Shared agy (Antigravity) staging root: <dataRoot>/marketplace/agy. */\r\nexport function agyStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"agy\");\r\n}\r\n\r\n/** Shared Gemini-CLI staging root: <dataRoot>/marketplace/gemini. */\r\nexport function geminiStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"gemini\");\r\n}\r\n\r\n/** Shared Qwen-Code staging root: <dataRoot>/marketplace/qwen. */\r\nexport function qwenStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"qwen\");\r\n}\r\n\r\n/** Shared droid (Factory) staging root: <dataRoot>/marketplace/droid. */\r\nexport function droidStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"droid\");\r\n}\r\n\r\n/**\r\n * Shared npm-local staging root: <dataRoot>/marketplace/npm. Every npm-plugin\r\n * host (opencode / kilo / kilo-cli) stages here; the host config's `plugin`\r\n * array references the bundle by `file://<this>/<id>`, so it MUST live under the\r\n * stable data-root (it survives cwd changes and `rm -rf dist-plugin`).\r\n */\r\nexport function npmStagingRoot(): string {\r\n  return join(marketplaceRoot(), \"npm\");\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Claude Code host-state readers ($CLAUDE_CONFIG_DIR || ~/.claude)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Claude Code's config dir, honoring the CLAUDE_CONFIG_DIR override. */\r\nexport function claudeConfigDir(): string {\r\n  const override = process.env.CLAUDE_CONFIG_DIR;\r\n  if (override && override.trim() !== \"\") return resolve(override);\r\n  return join(homedir(), \".claude\");\r\n}\r\n\r\n/** The installed_plugins.json key our marketplace install creates for `id`. */\r\nexport function claudePluginKey(connectorId: string): string {\r\n  return `${connectorId}@${MARKETPLACE_NAME}`;\r\n}\r\n\r\nfunction readJsonFile(path: string): Record<string, unknown> | null {\r\n  try {\r\n    const parsed = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\r\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\r\n      return parsed as Record<string, unknown>;\r\n    }\r\n  } catch {\r\n    /* absent / unreadable → null */\r\n  }\r\n  return null;\r\n}\r\n\r\n/** The `plugins` map from Claude's installed_plugins.json (null when unreadable). */\r\nexport function readClaudeInstalledPlugins(): Record<string, unknown> | null {\r\n  const file = join(claudeConfigDir(), \"plugins\", \"installed_plugins.json\");\r\n  const parsed = readJsonFile(file);\r\n  const plugins = parsed?.plugins;\r\n  if (plugins && typeof plugins === \"object\" && !Array.isArray(plugins)) {\r\n    return plugins as Record<string, unknown>;\r\n  }\r\n  return null;\r\n}\r\n\r\n/** True when Claude's own state lists `<id>@agent-connector` as installed. */\r\nexport function claudePluginInstalled(connectorId: string): boolean {\r\n  const plugins = readClaudeInstalledPlugins();\r\n  if (!plugins) return false;\r\n  const entry = plugins[claudePluginKey(connectorId)];\r\n  return Array.isArray(entry) ? entry.length > 0 : entry != null;\r\n}\r\n\r\n/** True when ANY `*@agent-connector` plugin remains in Claude's state. */\r\nexport function anyClaudeAgentConnectorPlugins(): boolean {\r\n  const plugins = readClaudeInstalledPlugins();\r\n  if (!plugins) return false;\r\n  return Object.entries(plugins).some(\r\n    ([key, entry]) =>\r\n      key.endsWith(`@${MARKETPLACE_NAME}`) &&\r\n      (Array.isArray(entry) ? entry.length > 0 : entry != null),\r\n  );\r\n}\r\n\r\n/**\r\n * The directory Claude's known_marketplaces.json records for `name`, or null\r\n * when not registered / unreadable. Used both as a presence probe and as the\r\n * NAME-COLLISION check: a registration pointing somewhere other than our\r\n * staging root belongs to the user and must never be touched.\r\n */\r\nexport function claudeKnownMarketplacePath(name: string): string | null {\r\n  const file = join(claudeConfigDir(), \"plugins\", \"known_marketplaces.json\");\r\n  const parsed = readJsonFile(file);\r\n  const entry = parsed?.[name];\r\n  if (!entry || typeof entry !== \"object\") return null;\r\n  const e = entry as { installLocation?: unknown; source?: { path?: unknown } };\r\n  if (typeof e.installLocation === \"string\") return e.installLocation;\r\n  const sourcePath = e.source?.path;\r\n  return typeof sourcePath === \"string\" ? sourcePath : null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Codex host-state readers ($CODEX_HOME || ~/.codex → config.toml)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** The config.toml key our marketplace install creates for `id` (== claude's). */\r\nexport function codexPluginKey(connectorId: string): string {\r\n  return `${connectorId}@${MARKETPLACE_NAME}`;\r\n}\r\n\r\n/** Parse <CODEX_HOME>/config.toml ({} on absence/parse failure — never throws). */\r\nfunction readCodexConfig(): Record<string, unknown> {\r\n  const file = join(codexConfigHome(), \"config.toml\");\r\n  try {\r\n    return TOML.parse(readFileSync(file, \"utf8\")) as Record<string, unknown>;\r\n  } catch {\r\n    return {};\r\n  }\r\n}\r\n\r\n/**\r\n * True when Codex's config.toml carries the `[plugins.\"<id>@agent-connector\"]`\r\n * table. The DEFINITIVE install probe — empty `plugins/cache/...` dirs linger\r\n * after uninstall, so the cache dir must NOT be used (docs: codex quirk).\r\n */\r\nexport function codexPluginInstalled(connectorId: string): boolean {\r\n  const cfg = readCodexConfig();\r\n  const plugins = cfg[\"plugins\"];\r\n  if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) return false;\r\n  return codexPluginKey(connectorId) in (plugins as Record<string, unknown>);\r\n}\r\n\r\n/** True when ANY `*@agent-connector` plugin remains in Codex's config.toml. */\r\nexport function anyCodexAgentConnectorPlugins(): boolean {\r\n  const cfg = readCodexConfig();\r\n  const plugins = cfg[\"plugins\"];\r\n  if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) return false;\r\n  return Object.keys(plugins as Record<string, unknown>).some((k) =>\r\n    k.endsWith(`@${MARKETPLACE_NAME}`),\r\n  );\r\n}\r\n\r\n/**\r\n * The directory config.toml records as `[marketplaces.agent-connector].source`,\r\n * or null when not registered / unreadable. Both a presence probe and the\r\n * NAME-COLLISION check: a registration pointing somewhere other than our\r\n * staging root belongs to the user and must never be touched.\r\n */\r\nexport function codexMarketplaceSource(name: string): string | null {\r\n  const cfg = readCodexConfig();\r\n  const marketplaces = cfg[\"marketplaces\"];\r\n  if (!marketplaces || typeof marketplaces !== \"object\" || Array.isArray(marketplaces)) {\r\n    return null;\r\n  }\r\n  const entry = (marketplaces as Record<string, unknown>)[name];\r\n  if (!entry || typeof entry !== \"object\") return null;\r\n  const source = (entry as { source?: unknown }).source;\r\n  return typeof source === \"string\" ? source : null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// GitHub Copilot CLI host-state readers (~/.copilot, NO env — HOME isolation)\r\n//\r\n// LIVE-VERIFIED against GitHub Copilot CLI 1.0.63:\r\n//   • ~/.copilot/config.json — JSONC (leading `// …` comment header, \"managed\r\n//     automatically\") carrying `installedPlugins: [{ name, marketplace,\r\n//     version, installed_at, enabled, cache_path }]`. The DEFINITIVE install\r\n//     probe (an uninstall empties this array). Parsed JSONC-tolerantly so the\r\n//     comment header does not break JSON.parse.\r\n//   • ~/.copilot/settings.json — `extraKnownMarketplaces[\"<name>\"].source.path`\r\n//     records the registered local marketplace dir (a `{source:\"directory\",\r\n//     path}` object); `enabledPlugins[\"<id>@agent-connector\"]: true`. The\r\n//     `.source.path` is both the presence probe and the NAME-COLLISION check.\r\n// Both readers degrade to false/null on absence/parse failure (refuse only on\r\n// positive evidence).\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Copilot CLI's config dir: ~/.copilot (NO dedicated env — HOME isolation). */\r\nexport function copilotConfigDir(): string {\r\n  return join(homedir(), \".copilot\");\r\n}\r\n\r\n/** The state key our marketplace install creates for `id` (== claude/codex). */\r\nexport function copilotPluginKey(connectorId: string): string {\r\n  return `${connectorId}@${MARKETPLACE_NAME}`;\r\n}\r\n\r\n/** The `installedPlugins` array from Copilot's config.json (JSONC; [] when unreadable). */\r\nfunction readCopilotInstalledPlugins(): Array<Record<string, unknown>> {\r\n  let raw: string;\r\n  try {\r\n    raw = readFileSync(join(copilotConfigDir(), \"config.json\"), \"utf8\");\r\n  } catch {\r\n    return [];\r\n  }\r\n  const parsed = parseJsonc(raw);\r\n  const plugins = parsed?.[\"installedPlugins\"];\r\n  if (!Array.isArray(plugins)) return [];\r\n  return plugins.filter(\r\n    (e): e is Record<string, unknown> =>\r\n      e != null && typeof e === \"object\" && !Array.isArray(e),\r\n  );\r\n}\r\n\r\n/**\r\n * True when Copilot's config.json lists `id` installed from our marketplace\r\n * (`installedPlugins[]` carries an entry with `name === id`, `marketplace ===\r\n * agent-connector`, and not `enabled: false`). The DEFINITIVE probe — an\r\n * uninstall empties this array (live-verified on CLI 1.0.63).\r\n */\r\nexport function copilotPluginInstalled(connectorId: string): boolean {\r\n  return readCopilotInstalledPlugins().some(\r\n    (e) =>\r\n      e[\"name\"] === connectorId &&\r\n      e[\"marketplace\"] === MARKETPLACE_NAME &&\r\n      e[\"enabled\"] !== false,\r\n  );\r\n}\r\n\r\n/** True when ANY plugin from our marketplace remains in Copilot's config.json. */\r\nexport function anyCopilotAgentConnectorPlugins(): boolean {\r\n  return readCopilotInstalledPlugins().some(\r\n    (e) => e[\"marketplace\"] === MARKETPLACE_NAME && e[\"enabled\"] !== false,\r\n  );\r\n}\r\n\r\n/**\r\n * The directory settings.json records as `extraKnownMarketplaces[\"<name>\"]\r\n * .source.path`, or null when not registered / unreadable. Both a presence probe\r\n * and the NAME-COLLISION check (a registration pointing somewhere other than our\r\n * staging root belongs to the user and must never be touched). `source` is a\r\n * `{ source: \"directory\", path }` object on CLI 1.0.63; a bare string source is\r\n * accepted defensively.\r\n */\r\nexport function copilotMarketplaceSource(name: string): string | null {\r\n  const parsed = readJsonFile(join(copilotConfigDir(), \"settings.json\"));\r\n  const known = parsed?.[\"extraKnownMarketplaces\"];\r\n  if (!known || typeof known !== \"object\" || Array.isArray(known)) return null;\r\n  const entry = (known as Record<string, unknown>)[name];\r\n  if (entry == null) return null;\r\n  const source = (entry as { source?: unknown }).source;\r\n  if (typeof source === \"string\") return source;\r\n  if (source && typeof source === \"object\" && !Array.isArray(source)) {\r\n    const path = (source as { path?: unknown }).path;\r\n    if (typeof path === \"string\") return path;\r\n  }\r\n  return null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// droid (Factory) host-state readers (~/.factory/settings.json, JSON, NO env)\r\n//\r\n// DOCS-ONLY: no droid binary is present on this box. The settings.json key\r\n// shapes below (`enabledPlugins[\"<id>@agent-connector\"] === true` +\r\n// `extraKnownMarketplaces[\"agent-connector\"].source`) follow the documented\r\n// factory plugin model — confirm the exact JSON shapes live when a droid binary\r\n// is available. Both readers read defensively (refuse only on positive evidence).\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Factory's settings file: ~/.factory/settings.json (NO dedicated env). */\r\nexport function factorySettingsPath(): string {\r\n  return join(homedir(), \".factory\", \"settings.json\");\r\n}\r\n\r\n/** The settings.json key our marketplace install creates for `id` (== codex's). */\r\nexport function droidPluginKey(connectorId: string): string {\r\n  return `${connectorId}@${MARKETPLACE_NAME}`;\r\n}\r\n\r\n/** The `enabledPlugins` map from droid's settings.json (null when unreadable). */\r\nfunction readDroidEnabledPlugins(): Record<string, unknown> | null {\r\n  const parsed = readJsonFile(factorySettingsPath());\r\n  const plugins = parsed?.enabledPlugins;\r\n  if (plugins && typeof plugins === \"object\" && !Array.isArray(plugins)) {\r\n    return plugins as Record<string, unknown>;\r\n  }\r\n  return null;\r\n}\r\n\r\n/**\r\n * True when droid's settings.json carries\r\n * `enabledPlugins[\"<id>@agent-connector\"] === true`. DOCS-only: the strict\r\n * `=== true` value shape is unverified live (a future droid may store an object).\r\n */\r\nexport function droidPluginInstalled(connectorId: string): boolean {\r\n  const plugins = readDroidEnabledPlugins();\r\n  if (!plugins) return false;\r\n  return plugins[droidPluginKey(connectorId)] === true;\r\n}\r\n\r\n/** True when ANY `*@agent-connector` plugin remains enabled in droid's settings. */\r\nexport function anyDroidAgentConnectorPlugins(): boolean {\r\n  const plugins = readDroidEnabledPlugins();\r\n  if (!plugins) return false;\r\n  return Object.entries(plugins).some(\r\n    ([key, value]) => key.endsWith(`@${MARKETPLACE_NAME}`) && value === true,\r\n  );\r\n}\r\n\r\n/**\r\n * The directory droid's settings.json records as\r\n * `extraKnownMarketplaces[\"<name>\"].source`, or null when not registered /\r\n * unreadable. Both a presence probe and the NAME-COLLISION check (a registration\r\n * pointing somewhere other than our staging root belongs to the user). DOCS-only:\r\n * the local-path `source` field shape is undocumented, so this reads defensively\r\n * — accepts either a bare string source or an object carrying a `path`/`source`\r\n * string, and NORMALIZES to a single string for the samePath compare.\r\n */\r\nexport function droidMarketplaceSource(name: string): string | null {\r\n  const parsed = readJsonFile(factorySettingsPath());\r\n  const known = parsed?.extraKnownMarketplaces;\r\n  if (!known || typeof known !== \"object\" || Array.isArray(known)) return null;\r\n  const entry = (known as Record<string, unknown>)[name];\r\n  if (entry == null) return null;\r\n  if (typeof entry === \"string\") return entry;\r\n  if (typeof entry === \"object\" && !Array.isArray(entry)) {\r\n    const e = entry as { source?: unknown; path?: unknown };\r\n    if (typeof e.source === \"string\") return e.source;\r\n    if (typeof e.path === \"string\") return e.path;\r\n  }\r\n  return null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// agy (Antigravity) host-state readers (~/.gemini/config/plugins, NO env)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** agy's config dir: ~/.gemini/config (NO dedicated env — HOME isolation). */\r\nexport function agyConfigDir(): string {\r\n  return join(homedir(), \".gemini\", \"config\");\r\n}\r\n\r\n/** agy's plugins dir: ~/.gemini/config/plugins. */\r\nexport function agyPluginsDir(): string {\r\n  return join(agyConfigDir(), \"plugins\");\r\n}\r\n\r\n/**\r\n * Candidate `import_manifest.json` locations. agy 1.0.7 records the manifest at\r\n * `<config>/plugins/import_manifest.json` on POSIX but at\r\n * `<config>/import_manifest.json` on Windows (live-confirmed on the my-window\r\n * box) — both are probed, then the copied plugin dir is the final fallback.\r\n */\r\nexport function agyImportManifestPaths(): string[] {\r\n  return [\r\n    join(agyConfigDir(), \"import_manifest.json\"), // win32 location\r\n    join(agyPluginsDir(), \"import_manifest.json\"), // posix location\r\n  ];\r\n}\r\n\r\n/** @deprecated single-location accessor — prefer {@link agyImportManifestPaths}. */\r\nexport function agyImportManifestPath(): string {\r\n  return join(agyPluginsDir(), \"import_manifest.json\");\r\n}\r\n\r\n/**\r\n * True when `id` is installed per agy's import manifest (`imports[].name`),\r\n * checking BOTH the win32 and posix manifest locations, with a fallback probe of\r\n * the copied plugin dir's plugin.json. agy's uninstall removes the plugin dir\r\n * and clears the manifest entry (live-verified on Windows: install → dir +\r\n * manifest present, uninstall → both gone, re-install idempotent).\r\n */\r\nexport function agyPluginInstalled(connectorId: string): boolean {\r\n  for (const manifest of agyImportManifestPaths()) {\r\n    try {\r\n      const parsed = JSON.parse(readFileSync(manifest, \"utf8\")) as {\r\n        imports?: unknown;\r\n      };\r\n      const imports = parsed.imports;\r\n      if (\r\n        Array.isArray(imports) &&\r\n        imports.some(\r\n          (e) =>\r\n            e != null &&\r\n            typeof e === \"object\" &&\r\n            (e as { name?: unknown }).name === connectorId,\r\n        )\r\n      ) {\r\n        return true;\r\n      }\r\n    } catch {\r\n      /* absent / unreadable manifest → try the next candidate */\r\n    }\r\n  }\r\n  return existsSync(join(agyPluginsDir(), connectorId, \"plugin.json\"));\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Gemini CLI host-state readers (~/.gemini/extensions, NO env — HOME isolation)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Gemini CLI's config dir: ~/.gemini (NO dedicated config-dir env — isolation is\r\n * via HOME, live-confirmed on gemini 0.36.0). DISTINCT from agy's ~/.gemini/config\r\n * tree: gemini extensions land under ~/.gemini/extensions/<id>/.\r\n */\r\nexport function geminiConfigDir(): string {\r\n  return join(homedir(), \".gemini\");\r\n}\r\n\r\n/**\r\n * True when `id` is installed per Gemini's own extension store: the marker file\r\n * ~/.gemini/extensions/<id>/gemini-extension.json exists. Gemini exits 0 even on\r\n * a logical failure, so this fs probe — not the exit code — is the source of\r\n * truth (the driver re-probes after every spawn).\r\n */\r\nexport function geminiExtensionInstalled(connectorId: string): boolean {\r\n  return existsSync(\r\n    join(geminiConfigDir(), \"extensions\", connectorId, \"gemini-extension.json\"),\r\n  );\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Qwen Code host-state readers (~/.qwen/extensions, NO env — HOME isolation)\r\n//\r\n// DOCS-ONLY: no qwen binary is present on this box. qwen-code is a gemini-cli\r\n// fork, so the extension store SHAPE (~/.qwen/extensions/<id>/qwen-extension.json)\r\n// mirrors gemini's — confirm the marker filename live when a qwen binary lands.\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Qwen Code's config dir: ~/.qwen (NO dedicated config-dir env — isolation is\r\n * via HOME, like its gemini-cli parent). DOCS-only: confirm live when a qwen\r\n * binary is available. DISTINCT from ~/.gemini (the gemini-cli store).\r\n */\r\nexport function qwenConfigDir(): string {\r\n  return join(homedir(), \".qwen\");\r\n}\r\n\r\n/**\r\n * True when `id` is installed per Qwen's own extension store: the marker file\r\n * ~/.qwen/extensions/<id>/qwen-extension.json exists. Mirrors gemini's fs probe\r\n * (qwen is a gemini fork); the driver re-probes after every spawn. DOCS-only:\r\n * the marker filename (`qwen-extension.json`) is unverified live.\r\n */\r\nexport function qwenExtensionInstalled(connectorId: string): boolean {\r\n  return existsSync(\r\n    join(qwenConfigDir(), \"extensions\", connectorId, \"qwen-extension.json\"),\r\n  );\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// npm-local host-state readers (opencode / kilo / kilo-cli — XDG_CONFIG_HOME)\r\n//\r\n// These hosts have NO uninstall verb; installs are recorded as `file://<dir>`\r\n// entries in a `plugin` array inside an opencode-style config file, which the\r\n// driver EDITS to remove. This module is a spawn/shared-free LEAF, so a tiny\r\n// posix-resolve path comparison is inlined here rather than importing\r\n// shared.ts's samePath (and samePath does not strip the `file://` scheme).\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** opencode's config dir: $XDG_CONFIG_HOME/opencode (or ~/.config/opencode). */\r\nexport function opencodeConfigDir(): string {\r\n  return join(xdgConfigHome(), \"opencode\");\r\n}\r\n\r\n/** kilo / kilo-cli's config dir: $XDG_CONFIG_HOME/kilo (or ~/.config/kilo). */\r\nexport function kiloConfigDir(): string {\r\n  return join(xdgConfigHome(), \"kilo\");\r\n}\r\n\r\n/**\r\n * Candidate config filenames per npm-local host, most-preferred first. opencode\r\n * accepts opencode.jsonc / opencode.json / config.json (JSONC — comments\r\n * tolerated); kilo / kilo-cli use opencode.json (plain JSON).\r\n */\r\nfunction npmConfigCandidates(platform: PlatformId): string[] {\r\n  return platform === \"opencode\"\r\n    ? [\"opencode.jsonc\", \"opencode.json\", \"config.json\"]\r\n    : [\"opencode.json\"];\r\n}\r\n\r\n/** The config DIR for an npm-local host (opencode vs kilo/kilo-cli). */\r\nfunction npmConfigDir(platform: PlatformId): string {\r\n  return platform === \"opencode\" ? opencodeConfigDir() : kiloConfigDir();\r\n}\r\n\r\n/**\r\n * The config FILE path for `platform`: the first existing candidate, else the\r\n * most-preferred candidate (the path a fresh install would write). Never throws.\r\n */\r\nexport function npmConfigFilePath(platform: PlatformId): string {\r\n  const dir = npmConfigDir(platform);\r\n  const candidates = npmConfigCandidates(platform);\r\n  for (const name of candidates) {\r\n    if (existsSync(join(dir, name))) return join(dir, name);\r\n  }\r\n  return join(dir, candidates[0]!);\r\n}\r\n\r\n/** Strip a single leading `file://` (and `file://localhost/`) scheme prefix. */\r\nexport function stripFileScheme(entry: string): string {\r\n  let s = entry;\r\n  if (s.startsWith(\"file://localhost/\")) s = s.slice(\"file://localhost\".length);\r\n  else if (s.startsWith(\"file://\")) s = s.slice(\"file://\".length);\r\n  return s;\r\n}\r\n\r\n/**\r\n * Strip `//` line and `/* *​/` block comments from JSONC, STRING-AWARE: a `//`\r\n * or `/*` inside a JSON string literal (e.g. the `file://` in a plugin entry) is\r\n * left intact. Scans char-by-char tracking string + escape state — a naive\r\n * regex would corrupt `\"file:///dir\"` by eating from the embedded `//`.\r\n */\r\nfunction stripJsoncComments(text: string): string {\r\n  let out = \"\";\r\n  let inString = false;\r\n  let inLine = false;\r\n  let inBlock = false;\r\n  for (let i = 0; i < text.length; i++) {\r\n    const c = text[i]!;\r\n    const next = i + 1 < text.length ? text[i + 1]! : \"\";\r\n    if (inLine) {\r\n      if (c === \"\\n\") {\r\n        inLine = false;\r\n        out += c;\r\n      }\r\n      continue;\r\n    }\r\n    if (inBlock) {\r\n      if (c === \"*\" && next === \"/\") {\r\n        inBlock = false;\r\n        i++;\r\n      }\r\n      continue;\r\n    }\r\n    if (inString) {\r\n      out += c;\r\n      if (c === \"\\\\\") {\r\n        // Copy the escaped char verbatim (covers \\\" and \\\\).\r\n        if (next !== \"\") {\r\n          out += next;\r\n          i++;\r\n        }\r\n      } else if (c === '\"') {\r\n        inString = false;\r\n      }\r\n      continue;\r\n    }\r\n    if (c === '\"') {\r\n      inString = true;\r\n      out += c;\r\n      continue;\r\n    }\r\n    if (c === \"/\" && next === \"/\") {\r\n      inLine = true;\r\n      i++;\r\n      continue;\r\n    }\r\n    if (c === \"/\" && next === \"*\") {\r\n      inBlock = true;\r\n      i++;\r\n      continue;\r\n    }\r\n    out += c;\r\n  }\r\n  return out;\r\n}\r\n\r\n/** Tolerant JSONC → object: strip // line and block comments, then JSON.parse. */\r\nfunction parseJsonc(text: string): Record<string, unknown> | null {\r\n  // A parse failure degrades to null (the \"refuse only on positive evidence\"\r\n  // convention) rather than throwing.\r\n  try {\r\n    const parsed = JSON.parse(stripJsoncComments(text)) as unknown;\r\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\r\n      return parsed as Record<string, unknown>;\r\n    }\r\n  } catch {\r\n    /* unreadable / not JSONC → null */\r\n  }\r\n  return null;\r\n}\r\n\r\n/** Read + parse an npm-local host's config file ({}-shaped or null). Never throws. */\r\nexport function readNpmConfig(platform: PlatformId): Record<string, unknown> | null {\r\n  const file = npmConfigFilePath(platform);\r\n  try {\r\n    return parseJsonc(readFileSync(file, \"utf8\"));\r\n  } catch {\r\n    return null;\r\n  }\r\n}\r\n\r\n/**\r\n * Convert an npm `plugin`-array entry to a native absolute path. opencode/kilo\r\n * record a proper `file://` URL — on Windows that is `file:///C:/Users/…` (drive\r\n * letter + forward slashes), which a textual `file://`-strip leaves as the broken\r\n * `/C:/Users/…`. `fileURLToPath` does the correct cross-platform decode\r\n * (`file:///C:/x`→`C:\\x`, `file:///tmp/x`→`/tmp/x`). Bare-path entries (also\r\n * accepted by the hosts) and any malformed URL fall back to a textual strip.\r\n */\r\nfunction npmEntryToPath(entry: string): string {\r\n  if (/^file:\\/\\//i.test(entry)) {\r\n    try {\r\n      return fileURLToPath(entry);\r\n    } catch {\r\n      /* malformed file URL (e.g. backslashes) → manual strip below */\r\n    }\r\n  }\r\n  return stripFileScheme(entry);\r\n}\r\n\r\n/**\r\n * Path equality for the npm probe. Resolve symlinks with `realpathSync.native`\r\n * when the path exists (catches macOS `/var/folders`→`/private/var/folders` and\r\n * win32 8.3 short paths — the host records the realpath, we hold the symlink),\r\n * else lexical `resolve()`; case-fold on win32. Inlined here (leaf module)\r\n * rather than importing shared.ts's samePath, which pulls in the spawn layer.\r\n */\r\nfunction npmPathEquals(a: string, b: string): boolean {\r\n  const norm = (p: string): string => {\r\n    let s: string;\r\n    try {\r\n      s = realpathSync.native(p);\r\n    } catch {\r\n      s = resolve(p);\r\n    }\r\n    return process.platform === \"win32\" ? s.toLowerCase() : s;\r\n  };\r\n  return norm(a) === norm(b);\r\n}\r\n\r\n/**\r\n * The `plugin`-array ENTRY (the raw string, including any `file://`) whose value\r\n * — after stripping a leading `file://` — path-equals `id`'s staged bundle dir,\r\n * or null when no entry references it. Used both as the install probe and to\r\n * locate the exact entry the uninstall edit must drop.\r\n */\r\nexport function npmPluginArrayEntry(\r\n  platform: PlatformId,\r\n  connectorId: string,\r\n): string | null {\r\n  const cfg = readNpmConfig(platform);\r\n  if (!cfg) return null;\r\n  const arr = cfg[\"plugin\"];\r\n  if (!Array.isArray(arr)) return null;\r\n  const target = join(npmStagingRoot(), connectorId);\r\n  for (const raw of arr) {\r\n    if (typeof raw !== \"string\") continue;\r\n    if (npmPathEquals(npmEntryToPath(raw), target)) return raw;\r\n  }\r\n  return null;\r\n}\r\n\r\n/** True when `platform`'s config `plugin` array references `id`'s staged bundle. */\r\nexport function npmPluginInstalled(platform: PlatformId, connectorId: string): boolean {\r\n  return npmPluginArrayEntry(platform, connectorId) != null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Cross-host marketplace-install EVIDENCE (the double-install guard's probe)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Read-only evidence that `connectorId` is marketplace/plugin-installed on\r\n * `platform`: the state record first, then a cheap fs probe of the host's own\r\n * plugin state (catches manual installs from `package`'s printed instructions).\r\n * Returns a human-readable description of the evidence, or null when none.\r\n */\r\nexport function marketplaceEvidence(\r\n  connectorId: string,\r\n  platform: PlatformId,\r\n): string | null {\r\n  if (readMarketplaceInstalls(connectorId)[platform]) {\r\n    return \"recorded in marketplace-installs.json\";\r\n  }\r\n  switch (platform) {\r\n    case \"claude-code\":\r\n      if (claudePluginInstalled(connectorId)) {\r\n        return `${claudePluginKey(connectorId)} listed in Claude's installed_plugins.json`;\r\n      }\r\n      return null;\r\n    case \"gemini-cli\":\r\n      return geminiExtensionInstalled(connectorId)\r\n        ? `extension ${connectorId} listed in Gemini's extensions store`\r\n        : null;\r\n    case \"qwen-code\":\r\n      return qwenExtensionInstalled(connectorId)\r\n        ? `extension ${connectorId} listed in Qwen's extensions store`\r\n        : null;\r\n    case \"droid\":\r\n      return droidPluginInstalled(connectorId)\r\n        ? `${droidPluginKey(connectorId)} enabled in droid's settings.json`\r\n        : null;\r\n    case \"antigravity\":\r\n    case \"antigravity-cli\": {\r\n      const dir = join(homedir(), \".gemini\", \"config\", \"plugins\", connectorId);\r\n      return existsSync(dir) ? `plugin dir ${dir} exists` : null;\r\n    }\r\n    case \"opencode\":\r\n    case \"kilo\":\r\n    case \"kilo-cli\":\r\n      return npmPluginInstalled(platform, connectorId)\r\n        ? `${connectorId} listed in ${platform}'s config plugin array`\r\n        : null;\r\n    case \"codex\": {\r\n      const dir = join(\r\n        codexConfigHome(),\r\n        \"plugins\",\r\n        \"cache\",\r\n        MARKETPLACE_NAME,\r\n        connectorId,\r\n      );\r\n      return existsSync(dir) ? `codex plugin cache ${dir} exists` : null;\r\n    }\r\n    case \"copilot-cli\":\r\n      return copilotPluginInstalled(connectorId)\r\n        ? `${copilotPluginKey(connectorId)} listed in Copilot's config.json`\r\n        : null;\r\n    default:\r\n      return null;\r\n  }\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Content hashing — staged-bundle drift detection\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Deterministic sha256 over every file under `dir` (sorted relative paths +\r\n * bytes). Empty string when the dir is missing/unreadable. Used to record the\r\n * staged bundle's content at install time and detect drift later (claude caches\r\n * a versioned COPY, so an edited connector goes silently stale without this).\r\n */\r\nexport function hashDirectory(dir: string): string {\r\n  if (!existsSync(dir)) return \"\";\r\n  const files: string[] = [];\r\n  const walk = (d: string): void => {\r\n    let entries: string[];\r\n    try {\r\n      entries = readdirSync(d);\r\n    } catch {\r\n      return;\r\n    }\r\n    for (const name of entries.sort()) {\r\n      const full = join(d, name);\r\n      let st;\r\n      try {\r\n        st = statSync(full);\r\n      } catch {\r\n        continue;\r\n      }\r\n      if (st.isDirectory()) walk(full);\r\n      else if (st.isFile()) files.push(full);\r\n    }\r\n  };\r\n  walk(dir);\r\n  const hash = createHash(\"sha256\");\r\n  for (const file of files.sort()) {\r\n    hash.update(relative(dir, file).split(\"\\\\\").join(\"/\"));\r\n    hash.update(\"\\0\");\r\n    try {\r\n      hash.update(readFileSync(file));\r\n    } catch {\r\n      /* unreadable file contributes only its path */\r\n    }\r\n    hash.update(\"\\0\");\r\n  }\r\n  return hash.digest(\"hex\");\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/chunk-7HHW23AC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/usage/registry.ts","../src/usage/scan.ts","../src/usage/leaderboard.ts"],"sourcesContent":["/**\r\n * usage/registry — the single source of truth for HOST usage readers.\r\n *\r\n * Mirrors adapters/registry.ts: each platform is ONE entry with a lazy `load()`\r\n * thunk resolving the reader module's default export. Adding a platform is a\r\n * single new entry here plus one `readers/<id>.ts` file — `getUsageReader` /\r\n * `allUsageReaders` and the scan orchestrator all derive from this list.\r\n *\r\n * `format` and `kind` are declared on the factory so the scan layer can describe\r\n * a reader (e.g. note a \"synced\" reader as skipped) without importing it.\r\n */\r\n\r\nimport type { PlatformId } from \"../core/types.js\";\r\nimport type { UsageReader, UsageReaderFactory } from \"./types.js\";\r\n\r\n/**\r\n * Authoritative list of usage readers. To add a platform: drop\r\n * `src/usage/readers/<id>.ts` (default-exporting a {@link UsageReader}) and add\r\n * one entry below.\r\n */\r\nexport const USAGE_READER_REGISTRY: readonly UsageReaderFactory[] = [\r\n  // U1 — JSONL readers\r\n  {\r\n    platformId: \"claude-code\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/claude-code.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"codex\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/codex.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"gemini-cli\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/gemini-cli.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"qwen-code\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/qwen-code.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"copilot-cli\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/copilot-cli.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"pi\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/pi.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"kimi\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/kimi.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"openclaw\",\r\n    format: \"jsonl\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/openclaw.js\").then((m) => m.default),\r\n  },\r\n  // U2 — JSON readers\r\n  {\r\n    platformId: \"amp\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/amp.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"droid\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/droid.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"codebuff\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/codebuff.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"mux\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/mux.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"roo-code\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/roo-code.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"kilo\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/kilo.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"kiro\",\r\n    format: \"json\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/kiro.js\").then((m) => m.default),\r\n  },\r\n  // U3 — SQLite readers (via sql.js wasm)\r\n  {\r\n    platformId: \"opencode\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/opencode.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"goose\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/goose.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"hermes\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/hermes.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"kilo-cli\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/kilo-cli.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"synthetic\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/synthetic.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"crush\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/crush.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"zed\",\r\n    format: \"sqlite\",\r\n    kind: \"local\",\r\n    load: () => import(\"./readers/zed.js\").then((m) => m.default),\r\n  },\r\n  // U4 — synced/cloud readers (read tokscale local cache if present, else skip)\r\n  {\r\n    platformId: \"cursor\",\r\n    format: \"synced-cache\",\r\n    kind: \"synced\",\r\n    load: () => import(\"./readers/cursor.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    // Antigravity IDE: the native `~/.gemini/antigravity/conversations/<uuid>.pb`\r\n    // store is PROTOBUF with no public schema (CONFIRMED by install) → not\r\n    // parseable. So this is a SYNCED reader: it reads the tokscale synced-cache\r\n    // if present, else [] (\"requires sync\"). The native dir is detection-only.\r\n    platformId: \"antigravity\",\r\n    format: \"synced-cache\",\r\n    kind: \"synced\",\r\n    load: () => import(\"./readers/antigravity.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    // Antigravity CLI (`agy`): SHARES the IDE's protobuf (.pb) store (no separate\r\n    // dir, no public schema) → not parseable. SYNCED reader: tokscale cache if\r\n    // present, else [] (\"requires sync\").\r\n    platformId: \"antigravity-cli\",\r\n    format: \"synced-cache\",\r\n    kind: \"synced\",\r\n    load: () => import(\"./readers/antigravity-cli.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"trae\",\r\n    format: \"synced-cache\",\r\n    kind: \"synced\",\r\n    load: () => import(\"./readers/trae.js\").then((m) => m.default),\r\n  },\r\n  {\r\n    platformId: \"warp\",\r\n    format: \"synced-cache\",\r\n    kind: \"synced\",\r\n    load: () => import(\"./readers/warp.js\").then((m) => m.default),\r\n  },\r\n];\r\n\r\n/** O(1) lookup index, built once at module-load time. */\r\nconst REGISTRY_BY_ID: ReadonlyMap<PlatformId, UsageReaderFactory> = new Map(\r\n  USAGE_READER_REGISTRY.map((factory) => [factory.platformId, factory] as const),\r\n);\r\n\r\n/** Look up the lazy factory for a platform id, or undefined when unregistered. */\r\nexport function getUsageReaderFactory(id: PlatformId | string): UsageReaderFactory | undefined {\r\n  return REGISTRY_BY_ID.get(id as PlatformId);\r\n}\r\n\r\n/** Resolve a platform id to its reader singleton, or undefined when unregistered. */\r\nexport async function getUsageReader(id: PlatformId | string): Promise<UsageReader | undefined> {\r\n  const factory = getUsageReaderFactory(id);\r\n  return factory ? factory.load() : undefined;\r\n}\r\n\r\n/** Load every registered reader (imports run in parallel; preserves order). */\r\nexport async function allUsageReaders(): Promise<UsageReader[]> {\r\n  return Promise.all(USAGE_READER_REGISTRY.map((factory) => factory.load()));\r\n}\r\n","/**\r\n * usage/scan — orchestrate every registered reader into one deduped record set.\r\n *\r\n * Iterates USAGE_READER_REGISTRY (optionally filtered by platform), loads and\r\n * runs each reader, and folds the results together. Per-reader robustness:\r\n *   • a reader that throws (it shouldn't — readers are fail-open) is CAUGHT and\r\n *     recorded as skipped, never aborting the whole scan;\r\n *   • a \"synced\" reader that returns no rows is noted as skipped(\"requires sync\")\r\n *     so the report can honestly explain why a cloud platform shows nothing;\r\n *   • a reader that simply has no local data returns [] silently (no root).\r\n *\r\n * After collection: global cross-source dedupe, then a final sinceMs filter\r\n * (readers also honor sinceMs, but the scan re-filters as a backstop).\r\n */\r\n\r\nimport type { PlatformId } from \"../core/types.js\";\r\nimport type { UsageReader, UsageReaderFactory, UsageRecord } from \"./types.js\";\r\nimport { dedupe } from \"./aggregate.js\";\r\nimport { USAGE_READER_REGISTRY } from \"./registry.js\";\r\n\r\n/** A platform the scan could not (fully) read, with a human reason. */\r\nexport interface SkippedPlatform {\r\n  platformId: PlatformId;\r\n  reason: string;\r\n}\r\n\r\n/** Options controlling a scan. */\r\nexport interface ScanOptions {\r\n  /** Lower-bound epoch ms; records older than this are dropped. */\r\n  sinceMs?: number;\r\n  /** Restrict to these platforms; omit/empty to scan every registered reader. */\r\n  platforms?: PlatformId[];\r\n}\r\n\r\n/** The result of a scan: deduped records + notes on anything skipped. */\r\nexport interface ScanResult {\r\n  records: UsageRecord[];\r\n  skipped: SkippedPlatform[];\r\n}\r\n\r\n/**\r\n * Scan host usage across the selected readers. Returns deduped, since-filtered\r\n * records plus a `skipped` list (load/read failures and synced-but-uncached\r\n * platforms). Never throws — a single bad reader is isolated.\r\n */\r\nexport async function scanUsage(opts: ScanOptions = {}): Promise<ScanResult> {\r\n  const { sinceMs, platforms } = opts;\r\n  const wanted = platforms && platforms.length > 0 ? new Set(platforms) : undefined;\r\n\r\n  const factories = USAGE_READER_REGISTRY.filter(\r\n    (f) => wanted === undefined || wanted.has(f.platformId),\r\n  );\r\n\r\n  const collected: UsageRecord[] = [];\r\n  const skipped: SkippedPlatform[] = [];\r\n\r\n  // Run readers concurrently; each result is independent.\r\n  const results = await Promise.all(\r\n    factories.map(async (factory) => readOne(factory, sinceMs)),\r\n  );\r\n\r\n  for (const r of results) {\r\n    if (r.skipped) skipped.push(r.skipped);\r\n    // Loop-push, never push(...spread): a reader over a large host history can\r\n    // return hundreds of thousands of records, and spreading them as call\r\n    // arguments overflows the stack (RangeError) — hit on a real machine the\r\n    // first time the claude-code reader saw a multi-week log directory.\r\n    for (const rec of r.records) collected.push(rec);\r\n  }\r\n\r\n  const deduped = dedupe(collected);\r\n  const filtered =\r\n    sinceMs === undefined ? deduped : deduped.filter((rec) => rec.ts >= sinceMs);\r\n\r\n  return { records: filtered, skipped };\r\n}\r\n\r\n/** Load + run a single reader, isolating any failure into a skip note. */\r\nasync function readOne(\r\n  factory: UsageReaderFactory,\r\n  sinceMs: number | undefined,\r\n): Promise<{ records: UsageRecord[]; skipped?: SkippedPlatform }> {\r\n  let reader: UsageReader;\r\n  try {\r\n    reader = await factory.load();\r\n  } catch (err) {\r\n    return {\r\n      records: [],\r\n      skipped: { platformId: factory.platformId, reason: `failed to load reader: ${errMsg(err)}` },\r\n    };\r\n  }\r\n\r\n  let records: UsageRecord[];\r\n  try {\r\n    records = await reader.read(sinceMs === undefined ? {} : { sinceMs });\r\n  } catch (err) {\r\n    return {\r\n      records: [],\r\n      skipped: { platformId: factory.platformId, reason: `read error: ${errMsg(err)}` },\r\n    };\r\n  }\r\n\r\n  if (records.length === 0 && factory.kind === \"synced\") {\r\n    return {\r\n      records: [],\r\n      skipped: {\r\n        platformId: factory.platformId,\r\n        reason: \"requires sync (no local cache found)\",\r\n      },\r\n    };\r\n  }\r\n\r\n  return { records };\r\n}\r\n\r\nfunction errMsg(err: unknown): string {\r\n  return err instanceof Error ? err.message : String(err);\r\n}\r\n","/**\r\n * usage/leaderboard — the USER / HOST leaderboard, derived from the host usage\r\n * readers (src/usage/*).\r\n *\r\n * Where {@link import(\"../telemetry/leaderboard.js\")} answers \"which MCP server\r\n * costs the most\" from the bytes WE wrap, this answers \"which CLI / host spent\r\n * the most\" from each agent's OWN native session logs. Origin is always\r\n * `host-native`; it is NEVER summed with the serve-proxy MCP leaderboard (they\r\n * measure different things: server bytes vs whole-conversation usage).\r\n *\r\n * Thin wrapper over {@link scanUsage} + {@link aggregateBy}: the ranking is just\r\n * the platform (or model) group-by, which `aggregateBy` already sorts by total\r\n * tokens desc. A dedicated formatter notes synced / host-estimated platforms.\r\n */\r\n\r\nimport type { SkippedPlatform } from \"./scan.js\";\r\nimport type { PlatformId } from \"../core/types.js\";\r\nimport type { UsageRecord, UsageSummary } from \"./types.js\";\r\nimport { aggregateBy } from \"./aggregate.js\";\r\nimport { scanUsage } from \"./scan.js\";\r\n\r\n/** Options for the host leaderboard queries. */\r\nexport interface HostLeaderboardOptions {\r\n  /** Lower-bound epoch ms (inclusive); forwarded to {@link scanUsage}. */\r\n  sinceMs?: number;\r\n  /** Restrict to these platforms; omit/empty to scan every registered reader. */\r\n  platforms?: PlatformId[];\r\n  /** Rank dimension. \"platform\" (default) is the headline host leaderboard. */\r\n  by?: \"platform\" | \"model\";\r\n}\r\n\r\n/** The host leaderboard result: ranked rows plus any honest skip notes. */\r\nexport interface HostLeaderboardResult {\r\n  /** The ranking dimension actually used. */\r\n  by: \"platform\" | \"model\";\r\n  /** Ranked summary rows (sorted by total tokens desc by aggregateBy). */\r\n  rows: UsageSummary[];\r\n  /** Platforms the scan could not (fully) read (synced-but-uncached, errors). */\r\n  skipped: SkippedPlatform[];\r\n}\r\n\r\n/**\r\n * The USER / HOST leaderboard: scan every host reader, then rank by platform\r\n * (the default — \"which CLI/host spent the most\") or by model. Returns the\r\n * ranked rows and the scan's skip notes so the formatter can stay honest about\r\n * cloud platforms that require a sync we do not perform.\r\n */\r\nexport async function hostLeaderboard(\r\n  opts: HostLeaderboardOptions = {},\r\n): Promise<HostLeaderboardResult> {\r\n  const by = opts.by ?? \"platform\";\r\n  const scanOpts: { sinceMs?: number; platforms?: PlatformId[] } = {};\r\n  if (opts.sinceMs !== undefined) scanOpts.sinceMs = opts.sinceMs;\r\n  if (opts.platforms !== undefined && opts.platforms.length > 0) {\r\n    scanOpts.platforms = opts.platforms;\r\n  }\r\n  const { records, skipped } = await scanUsage(scanOpts);\r\n  const rows = aggregateBy(records, by);\r\n  return { by, rows, skipped };\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Formatting (mirrors usage/report.ts style: aligned table + honesty legend)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Compact integer formatting with thousands separators. */\r\nfunction fmtInt(n: number): string {\r\n  return n.toLocaleString(\"en-US\");\r\n}\r\n\r\n/** Right-pad (left-aligned columns). */\r\nfunction padRight(s: string, width: number): string {\r\n  return s.length >= width ? s : s + \" \".repeat(width - s.length);\r\n}\r\n\r\n/** Left-pad (right-aligned numeric columns). */\r\nfunction padLeft(s: string, width: number): string {\r\n  return s.length >= width ? s : \" \".repeat(width - s.length) + s;\r\n}\r\n\r\n/**\r\n * Format the host leaderboard as an aligned, ranked table:\r\n *   RANK | PLATFORM|MODEL | IN | OUT | CACHE_R | CACHE_W | REASON | TOTAL | SESS | CONF\r\n * with a TOTAL footer (worst confidence across rows), an estimate legend, and\r\n * skip notes for synced-but-uncached platforms.\r\n */\r\nexport function formatHostLeaderboard(\r\n  result: HostLeaderboardResult,\r\n): string {\r\n  const keyHeader = result.by === \"model\" ? \"MODEL\" : \"PLATFORM\";\r\n  const headers = [\r\n    \"RANK\",\r\n    keyHeader,\r\n    \"IN\",\r\n    \"OUT\",\r\n    \"CACHE_R\",\r\n    \"CACHE_W\",\r\n    \"REASON\",\r\n    \"TOTAL\",\r\n    \"SESS\",\r\n    \"CONF\",\r\n  ];\r\n\r\n  // aggregateBy already sorts by total desc; re-sort defensively for stability.\r\n  const sorted = [...result.rows].sort(\r\n    (a, b) => b.total - a.total || b.lastTs - a.lastTs,\r\n  );\r\n\r\n  const dataRows = sorted.map((r, i) => [\r\n    `${i + 1}`,\r\n    r.key,\r\n    fmtInt(r.tokens.input),\r\n    fmtInt(r.tokens.output),\r\n    fmtInt(r.tokens.cacheRead),\r\n    fmtInt(r.tokens.cacheWrite),\r\n    fmtInt(r.tokens.reasoning),\r\n    fmtInt(r.total),\r\n    fmtInt(r.sessions),\r\n    r.confidence,\r\n  ]);\r\n\r\n  const totals = sorted.reduce(\r\n    (acc, r) => {\r\n      acc.input += r.tokens.input;\r\n      acc.output += r.tokens.output;\r\n      acc.cacheRead += r.tokens.cacheRead;\r\n      acc.cacheWrite += r.tokens.cacheWrite;\r\n      acc.reasoning += r.tokens.reasoning;\r\n      acc.total += r.total;\r\n      acc.sessions += r.sessions;\r\n      return acc;\r\n    },\r\n    { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0, sessions: 0 },\r\n  );\r\n  const totalRow = [\r\n    \"\",\r\n    \"TOTAL\",\r\n    fmtInt(totals.input),\r\n    fmtInt(totals.output),\r\n    fmtInt(totals.cacheRead),\r\n    fmtInt(totals.cacheWrite),\r\n    fmtInt(totals.reasoning),\r\n    fmtInt(totals.total),\r\n    fmtInt(totals.sessions),\r\n    \"\",\r\n  ];\r\n\r\n  const widths = headers.map((h, col) => {\r\n    let w = h.length;\r\n    for (const row of dataRows) w = Math.max(w, (row[col] ?? \"\").length);\r\n    w = Math.max(w, (totalRow[col] ?? \"\").length);\r\n    return w;\r\n  });\r\n\r\n  // Left-align RANK (0), the KEY column (1), and CONF (9); numbers right.\r\n  const leftCols = new Set<number>([0, 1, 9]);\r\n  const renderRow = (cells: string[]): string =>\r\n    cells\r\n      .map((c, col) =>\r\n        leftCols.has(col) ? padRight(c, widths[col] ?? 0) : padLeft(c, widths[col] ?? 0),\r\n      )\r\n      .join(\"  \")\r\n      .trimEnd();\r\n\r\n  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);\r\n  const rule = \"-\".repeat(ruleWidth);\r\n\r\n  const lines: string[] = [];\r\n  lines.push(renderRow(headers));\r\n  lines.push(rule);\r\n  if (dataRows.length === 0) {\r\n    lines.push(\"(no host usage found)\");\r\n  } else {\r\n    for (const row of dataRows) lines.push(renderRow(row));\r\n  }\r\n  lines.push(rule);\r\n  lines.push(renderRow(totalRow));\r\n\r\n  // Honesty legend — estimated rows and skipped synced platforms.\r\n  if (sorted.some((r) => r.confidence === \"host-estimated\")) {\r\n    lines.push(\"\");\r\n    lines.push(\r\n      \"note: host-estimated rows are derived (e.g. char/4 or cost-only), \" +\r\n        \"not exact host-reported token counts.\",\r\n    );\r\n  }\r\n  if (result.skipped.length > 0) {\r\n    lines.push(\"\");\r\n    lines.push(\"skipped (synced/host-estimated platforms):\");\r\n    for (const s of result.skipped) lines.push(`  - ${s.platformId}: ${s.reason}`);\r\n  }\r\n\r\n  return lines.join(\"\\n\");\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/chunk-7PSNXUFK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/usage/normalize.ts","../src/usage/aggregate.ts"],"sourcesContent":["/**\r\n * usage/normalize — model/provider/workspace normalization.\r\n *\r\n * `normalizeModelForGrouping` and `inferProvider` are FAITHFUL ports of\r\n * tokscale's order-dependent logic (tokscale-core/src/lib.rs\r\n * normalize_model_for_grouping + provider_identity.rs inferred_provider_from_model).\r\n * The matching order is load-bearing — keep the steps in sequence.\r\n *\r\n * `normalizeWorkspaceKey` / `workspaceLabelFromKey` port tokscale\r\n * sessions/mod.rs (same slash-collapsing + UNC-prefix handling) so a cwd string\r\n * from a host log maps to the same stable project key tokscale would produce.\r\n */\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Model normalization (port of lib.rs normalize_model_for_grouping)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\nconst REASONING_TIERS: ReadonlySet<string> = new Set([\r\n  \"minimal\",\r\n  \"low\",\r\n  \"medium\",\r\n  \"high\",\r\n  \"xhigh\",\r\n  \"auto\",\r\n  \"none\",\r\n]);\r\n\r\n/**\r\n * Strip a `(level)` reasoning-effort suffix, returning the base model — or null\r\n * when the suffix is not one of the recognized tiers. Port of\r\n * strip_parenthesized_reasoning_tier: the base must be non-empty and already\r\n * trimmed (no surrounding whitespace).\r\n */\r\nfunction stripParenthesizedReasoningTier(modelId: string): string | null {\r\n  if (!modelId.endsWith(\")\")) return null;\r\n  const withoutClosing = modelId.slice(0, -1);\r\n  const open = withoutClosing.lastIndexOf(\"(\");\r\n  if (open < 0) return null;\r\n  const base = withoutClosing.slice(0, open);\r\n  const tier = withoutClosing.slice(open + 1);\r\n  if (base === \"\" || base.trim() !== base) return null;\r\n  if (!REASONING_TIERS.has(tier)) return null;\r\n  return base;\r\n}\r\n\r\n/**\r\n * Map an `anthropic/claude-<major>-<minor>-<family>` id to the canonical\r\n * `claude-<family>-<major>-<minor>` form. Returns null when the shape does not\r\n * match exactly (too many parts, unknown family). Port of\r\n * normalize_anthropic_prefixed_claude_model.\r\n */\r\nfunction normalizeAnthropicPrefixedClaudeModel(modelId: string): string | null {\r\n  const prefix = \"anthropic/claude-\";\r\n  if (!modelId.startsWith(prefix)) return null;\r\n  const rest = modelId.slice(prefix.length);\r\n  const parts = rest.split(\"-\");\r\n  const major = parts[0];\r\n  const minor = parts[1];\r\n  const family = parts[2];\r\n  if (major === undefined || minor === undefined || family === undefined) return null;\r\n  if (parts.length > 3) return null; // too many parts\r\n  if (family !== \"opus\" && family !== \"sonnet\" && family !== \"haiku\") return null;\r\n  return `claude-${family}-${major}-${minor}`;\r\n}\r\n\r\n/**\r\n * Normalize a raw model id to a stable grouping key. ORDER MATTERS — this is the\r\n * exact tokscale sequence:\r\n *   1. lowercase;\r\n *   2. strip a recognized `(tier)` reasoning suffix;\r\n *   3. strip a trailing `-YYYYMMDD` 8-digit date (only when len > 9 and the\r\n *      9th-from-end char is '-');\r\n *   4. for claude ids, replace dots between two digits with dashes\r\n *      (e.g. \"claude-3.5-sonnet\" → \"claude-3-5-sonnet\");\r\n *   5. canonicalize an `anthropic/claude-*` prefix.\r\n */\r\nexport function normalizeModelForGrouping(modelId: string): string {\r\n  let name = modelId.toLowerCase();\r\n\r\n  const base = stripParenthesizedReasoningTier(name);\r\n  if (base !== null) name = base;\r\n\r\n  if (name.length > 9) {\r\n    const potentialDate = name.slice(name.length - 8);\r\n    const allDigits = /^[0-9]{8}$/.test(potentialDate);\r\n    if (allDigits && name.charCodeAt(name.length - 9) === 0x2d /* '-' */) {\r\n      name = name.slice(0, name.length - 9);\r\n    }\r\n  }\r\n\r\n  if (name.includes(\"claude\")) {\r\n    const chars = [...name];\r\n    let result = \"\";\r\n    for (let i = 0; i < chars.length; i++) {\r\n      const c = chars[i] as string;\r\n      const prev = chars[i - 1];\r\n      const next = chars[i + 1];\r\n      if (\r\n        c === \".\" &&\r\n        i > 0 &&\r\n        i < chars.length - 1 &&\r\n        prev !== undefined &&\r\n        next !== undefined &&\r\n        isAsciiDigit(prev) &&\r\n        isAsciiDigit(next)\r\n      ) {\r\n        result += \"-\";\r\n      } else {\r\n        result += c;\r\n      }\r\n    }\r\n    name = result;\r\n  }\r\n\r\n  const canonical = normalizeAnthropicPrefixedClaudeModel(name);\r\n  if (canonical !== null) name = canonical;\r\n\r\n  return name;\r\n}\r\n\r\nfunction isAsciiDigit(c: string): boolean {\r\n  return c >= \"0\" && c <= \"9\";\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Provider inference (port of provider_identity.rs inferred_provider_from_model)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Whether `needle` occurs in `haystack` not flanked by alphanumerics on either\r\n * side (so \"o1\" matches \"o1-preview\" but not \"protocol1\"). Port of\r\n * contains_delimited.\r\n */\r\nfunction containsDelimited(haystack: string, needle: string): boolean {\r\n  let from = 0;\r\n  for (;;) {\r\n    const pos = haystack.indexOf(needle, from);\r\n    if (pos < 0) return false;\r\n    const beforeOk = pos === 0 || !isAlphaNum(haystack.charCodeAt(pos - 1));\r\n    const afterPos = pos + needle.length;\r\n    const afterOk = afterPos === haystack.length || !isAlphaNum(haystack.charCodeAt(afterPos));\r\n    if (beforeOk && afterOk) return true;\r\n    from = pos + 1;\r\n  }\r\n}\r\n\r\nfunction isAlphaNum(code: number): boolean {\r\n  return (\r\n    (code >= 0x30 && code <= 0x39) || // 0-9\r\n    (code >= 0x41 && code <= 0x5a) || // A-Z\r\n    (code >= 0x61 && code <= 0x7a) // a-z\r\n  );\r\n}\r\n\r\n/**\r\n * Infer a canonical provider id from a model id. ORDER MATTERS — first match\r\n * wins, exactly as tokscale's inferred_provider_from_model. Returns null when no\r\n * family matches (caller supplies a platform default).\r\n */\r\nexport function inferProvider(model: string): string | null {\r\n  const lower = model.toLowerCase();\r\n\r\n  if (\r\n    lower.includes(\"claude\") ||\r\n    lower.includes(\"anthropic\") ||\r\n    containsDelimited(lower, \"opus\") ||\r\n    containsDelimited(lower, \"sonnet\") ||\r\n    containsDelimited(lower, \"haiku\")\r\n  ) {\r\n    return \"anthropic\";\r\n  }\r\n  if (\r\n    lower.includes(\"gpt\") ||\r\n    lower.includes(\"openai\") ||\r\n    containsDelimited(lower, \"o1\") ||\r\n    containsDelimited(lower, \"o3\") ||\r\n    containsDelimited(lower, \"o4\")\r\n  ) {\r\n    return \"openai\";\r\n  }\r\n  if (lower.includes(\"gemini\") || lower.includes(\"google\")) return \"google\";\r\n  if (lower.includes(\"grok\")) return \"xai\";\r\n  if (lower.includes(\"deepseek\")) return \"deepseek\";\r\n  if (lower.includes(\"minimax\")) return \"minimax\";\r\n  if (lower.includes(\"mistral\") || lower.includes(\"mixtral\")) return \"mistral\";\r\n  if (lower.includes(\"llama\") || containsDelimited(lower, \"meta\")) return \"meta\";\r\n  if (lower.includes(\"qwen\")) return \"qwen\";\r\n  return null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Agent-name normalization (port of sessions/mod.rs normalize_agent_name +\r\n// normalize_opencode_agent_name). The opencode reader MUST normalize the agent\r\n// before its dedup fingerprint, or fork-copied history (which differs only in a\r\n// raw agent string) escapes dedup and double-counts.\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n// U+200B ZWSP, U+200C ZWNJ, U+200D ZWJ, U+FEFF BOM/ZWNBSP.\r\nconst ZERO_WIDTH_RE = /[​‌‍]/g;\r\n\r\n/** Strip zero-width chars oh-my-openagent uses as invisible sort prefixes. */\r\nfunction stripZeroWidthChars(s: string): string {\r\n  ZERO_WIDTH_RE.lastIndex = 0;\r\n  return ZERO_WIDTH_RE.test(s) ? s.replace(ZERO_WIDTH_RE, \"\") : s;\r\n}\r\n\r\nconst AGENT_PREFIXES = [\"astrape:\", \"oh-my-claudecode:\", \"oh-my-codex:\"] as const;\r\n\r\n/** Strip a known namespace prefix (case-insensitive), else return as-is. */\r\nfunction stripAgentPrefix(name: string): string {\r\n  for (const prefix of AGENT_PREFIXES) {\r\n    if (name.length >= prefix.length && name.slice(0, prefix.length).toLowerCase() === prefix) {\r\n      return name.slice(prefix.length);\r\n    }\r\n  }\r\n  return name;\r\n}\r\n\r\n/** Collapse internal whitespace runs to single spaces (port of canonicalize_agent_name). */\r\nfunction canonicalizeAgentName(name: string): string {\r\n  return name.split(/\\s+/).filter((w) => w !== \"\").join(\" \");\r\n}\r\n\r\n/** Titlecase one word, with UI/UX/API kept uppercase (port of titlecase_word). */\r\nfunction titlecaseWord(word: string): string {\r\n  const lower = word.toLowerCase();\r\n  if (lower === \"ui\") return \"UI\";\r\n  if (lower === \"ux\") return \"UX\";\r\n  if (lower === \"api\") return \"API\";\r\n  if (word === \"\") return \"\";\r\n  const chars = [...word];\r\n  const first = chars[0] as string;\r\n  return first.toUpperCase() + chars.slice(1).join(\"\");\r\n}\r\n\r\n/** Titlecase an agent name across '-' and whitespace boundaries (port of titlecase_agent). */\r\nfunction titlecaseAgent(name: string): string {\r\n  if (name === \"\") return \"\";\r\n  return name\r\n    .split(\"-\")\r\n    .flatMap((part) => part.split(/\\s+/))\r\n    .filter((w) => w !== \"\")\r\n    .map(titlecaseWord)\r\n    .join(\" \");\r\n}\r\n\r\n/** Port of normalize_agent_name. */\r\nexport function normalizeAgentName(agent: string): string {\r\n  const cleaned = stripZeroWidthChars(agent);\r\n  const trimmed = cleaned.trim();\r\n  const stripped = stripAgentPrefix(trimmed);\r\n  const canonical = canonicalizeAgentName(stripped);\r\n  const agentLower = canonical.toLowerCase();\r\n\r\n  if (agentLower.includes(\"plan\")) {\r\n    if (agentLower.includes(\"omo\") || agentLower.includes(\"sisyphus\")) {\r\n      return \"Planner-Sisyphus\";\r\n    }\r\n    return titlecaseAgent(canonical);\r\n  }\r\n  if (agentLower === \"omo\" || agentLower === \"sisyphus\") return \"Sisyphus\";\r\n  if (agentLower === \"orchestrator-sisyphus\") return \"Atlas\";\r\n  return titlecaseAgent(canonical);\r\n}\r\n\r\n/** Port of normalize_oh_my_opencode_agent_name (returns undefined when no match). */\r\nfunction normalizeOhMyOpencodeAgentName(agentLower: string): string | undefined {\r\n  switch (agentLower) {\r\n    case \"sisyphus (ultraworker)\":\r\n    case \"sisyphus - ultraworker\":\r\n    case \"sisyphus ultraworker\":\r\n    case \"sisyphus\":\r\n      return \"Sisyphus\";\r\n    case \"hephaestus (deep agent)\":\r\n    case \"hephaestus - deep agent\":\r\n    case \"hephaestus deep agent\":\r\n    case \"hephaestus\":\r\n      return \"Hephaestus\";\r\n    case \"prometheus (plan builder)\":\r\n    case \"prometheus - plan builder\":\r\n    case \"prometheus plan builder\":\r\n    case \"prometheus (planner)\":\r\n    case \"prometheus\":\r\n      return \"Prometheus\";\r\n    case \"atlas (plan executor)\":\r\n    case \"atlas - plan executor\":\r\n    case \"atlas plan executor\":\r\n    case \"atlas\":\r\n      return \"Atlas\";\r\n    case \"metis (plan consultant)\":\r\n    case \"metis - plan consultant\":\r\n    case \"metis plan consultant\":\r\n    case \"metis\":\r\n      return \"Metis\";\r\n    case \"momus (plan critic)\":\r\n    case \"momus - plan critic\":\r\n    case \"momus plan critic\":\r\n    case \"momus (plan reviewer)\":\r\n    case \"momus\":\r\n      return \"Momus\";\r\n    case \"orchestrator-sisyphus\":\r\n      return \"Atlas\";\r\n    case \"sisyphus-junior\":\r\n      return \"Sisyphus-Junior\";\r\n    case \"planner-sisyphus\":\r\n      return \"Planner-Sisyphus\";\r\n    default:\r\n      return undefined;\r\n  }\r\n}\r\n\r\n/**\r\n * Port of normalize_opencode_agent_name (sessions/mod.rs:88-154). Applies the\r\n * shared cleaning pipeline, then the oh-my-opencode agent table, then falls back\r\n * to normalizeAgentName. Used by the opencode reader BEFORE its dedup fingerprint\r\n * so fork copies collapse (matching opencode.rs:272).\r\n */\r\nexport function normalizeOpencodeAgentName(agent: string): string {\r\n  const cleaned = stripZeroWidthChars(agent);\r\n  const trimmed = cleaned.trim();\r\n  const stripped = stripAgentPrefix(trimmed);\r\n  const canonical = canonicalizeAgentName(stripped);\r\n  const agentLower = canonical.toLowerCase();\r\n\r\n  const ohMy = normalizeOhMyOpencodeAgentName(agentLower);\r\n  if (ohMy !== undefined) return ohMy;\r\n\r\n  return normalizeAgentName(canonical);\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Workspace key / label (port of sessions/mod.rs)\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Normalize an arbitrary cwd/dir string to a stable workspace key. Port of\r\n * normalize_workspace_key: backslashes → forward slashes, collapse repeated\r\n * slashes, strip a trailing slash (preserving a leading `//` UNC prefix).\r\n * Returns undefined for an empty input.\r\n */\r\nexport function normalizeWorkspaceKey(raw: string): string | undefined {\r\n  const trimmed = raw.trim();\r\n  if (trimmed === \"\") return undefined;\r\n\r\n  const preserveUnc = trimmed.startsWith(\"\\\\\\\\\") || trimmed.startsWith(\"//\");\r\n  let normalized = trimmed.replace(/\\\\/g, \"/\");\r\n\r\n  if (preserveUnc) {\r\n    let body = normalized.replace(/^\\/+/, \"\");\r\n    while (body.includes(\"//\")) body = body.replace(/\\/\\//g, \"/\");\r\n    normalized = `//${body}`;\r\n  } else {\r\n    while (normalized.includes(\"//\")) normalized = normalized.replace(/\\/\\//g, \"/\");\r\n  }\r\n\r\n  const minLen = preserveUnc ? 2 : 1;\r\n  if (normalized.length > minLen) {\r\n    normalized = normalized.replace(/\\/+$/, \"\");\r\n  }\r\n\r\n  return normalized === \"\" ? undefined : normalized;\r\n}\r\n\r\n/**\r\n * Human-readable label from a workspace key: the last non-empty path segment.\r\n * Port of workspace_label_from_key. Returns undefined when no segment remains.\r\n */\r\nexport function workspaceLabelFromKey(key: string): string | undefined {\r\n  const segments = key.split(\"/\");\r\n  for (let i = segments.length - 1; i >= 0; i--) {\r\n    const seg = segments[i];\r\n    if (seg !== undefined && seg !== \"\") return seg;\r\n  }\r\n  return undefined;\r\n}\r\n\r\n/**\r\n * Convert a cwd/dir string to both its normalized key and label in one call.\r\n * Both fields are undefined when the input does not yield a usable key.\r\n */\r\nexport function workspaceFromPath(raw: string): {\r\n  projectKey?: string;\r\n  projectLabel?: string;\r\n} {\r\n  const key = normalizeWorkspaceKey(raw);\r\n  if (key === undefined) return {};\r\n  const label = workspaceLabelFromKey(key);\r\n  return label === undefined ? { projectKey: key } : { projectKey: key, projectLabel: label };\r\n}\r\n","/**\r\n * usage/aggregate — token math, cross-source de-dup, and group-by rollups.\r\n *\r\n * Ports tokscale's shared aggregation model (docs/research/usage-shared-model.md\r\n * §4–5): a TokenBreakdown total is the sum of all five dimensions; dedup keeps\r\n * the FIRST occurrence per dedupKey in insertion order (un-keyed records always\r\n * pass through); group-by folds records into UsageSummary rows summing tokens /\r\n * cost / messages, counting distinct sessions, tracking the worst confidence and\r\n * the latest timestamp, sorted by total desc.\r\n */\r\n\r\nimport type {\r\n  TokenBreakdown,\r\n  UsageConfidence,\r\n  UsageGroupBy,\r\n  UsageRecord,\r\n  UsageSummary,\r\n} from \"./types.js\";\r\nimport { normalizeModelForGrouping } from \"./normalize.js\";\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Token helpers\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** A fresh all-zero TokenBreakdown. */\r\nexport function emptyTokens(): TokenBreakdown {\r\n  return { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 };\r\n}\r\n\r\n/** Element-wise sum of two breakdowns into a NEW object (operands untouched). */\r\nexport function addTokens(a: TokenBreakdown, b: TokenBreakdown): TokenBreakdown {\r\n  return {\r\n    input: a.input + b.input,\r\n    output: a.output + b.output,\r\n    cacheRead: a.cacheRead + b.cacheRead,\r\n    cacheWrite: a.cacheWrite + b.cacheWrite,\r\n    reasoning: a.reasoning + b.reasoning,\r\n  };\r\n}\r\n\r\n/** Scalar total across all five token dimensions. */\r\nexport function sumTokens(t: TokenBreakdown): number {\r\n  return t.input + t.output + t.cacheRead + t.cacheWrite + t.reasoning;\r\n}\r\n\r\n/** Accumulate `b` into `a` in place (used inside the rollup fold). */\r\nfunction addTokensInPlace(a: TokenBreakdown, b: TokenBreakdown): void {\r\n  a.input += b.input;\r\n  a.output += b.output;\r\n  a.cacheRead += b.cacheRead;\r\n  a.cacheWrite += b.cacheWrite;\r\n  a.reasoning += b.reasoning;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Confidence\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Least-trustworthy (0) → most-trustworthy. host-estimated is the weaker. */\r\nconst CONFIDENCE_RANK: Record<UsageConfidence, number> = {\r\n  \"host-estimated\": 0,\r\n  \"host-reported\": 1,\r\n};\r\n\r\n/** The worse (least-confident) of two provenance labels. */\r\nexport function worstConfidence(a: UsageConfidence, b: UsageConfidence): UsageConfidence {\r\n  return CONFIDENCE_RANK[b] < CONFIDENCE_RANK[a] ? b : a;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// De-duplication\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Cross-source de-dup. Keep the FIRST record seen per `dedupKey` in insertion\r\n * order; records without a dedupKey always pass through (the per-reader dedup is\r\n * the real safeguard — this is the global backstop, per shared-model §5 and\r\n * design §6). Deterministic: same input order → same output.\r\n */\r\nexport function dedupe(records: UsageRecord[]): UsageRecord[] {\r\n  const seen = new Set<string>();\r\n  const out: UsageRecord[] = [];\r\n  for (const rec of records) {\r\n    const key = rec.dedupKey;\r\n    if (key === undefined || key === \"\") {\r\n      out.push(rec); // un-keyed → always include\r\n      continue;\r\n    }\r\n    if (!seen.has(key)) {\r\n      seen.add(key);\r\n      out.push(rec);\r\n    }\r\n    // duplicate key → drop (keep-first)\r\n  }\r\n  return out;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────\r\n// Group-by aggregation\r\n// ─────────────────────────────────────────────────────────────────────────\r\n\r\n/** Local YYYY-MM-DD for an epoch-ms timestamp (matches tokscale's local-tz date). */\r\nfunction localDay(ts: number): string {\r\n  const d = new Date(ts);\r\n  const y = d.getFullYear();\r\n  const m = `${d.getMonth() + 1}`.padStart(2, \"0\");\r\n  const day = `${d.getDate()}`.padStart(2, \"0\");\r\n  return `${y}-${m}-${day}`;\r\n}\r\n\r\n/** The grouping key value for a record under the requested dimension. */\r\nfunction groupKey(rec: UsageRecord, by: UsageGroupBy): string {\r\n  switch (by) {\r\n    case \"platform\":\r\n      return rec.platformId;\r\n    case \"project\":\r\n      return rec.projectLabel ?? rec.projectKey ?? \"(no project)\";\r\n    case \"session\":\r\n      return rec.sessionId;\r\n    case \"model\":\r\n      return normalizeModelForGrouping(rec.modelId);\r\n    case \"day\":\r\n      return localDay(rec.ts);\r\n  }\r\n}\r\n\r\ninterface MutableSummary extends UsageSummary {\r\n  /** Distinct session ids folded into this group (counted at finalization). */\r\n  _sessions: Set<string>;\r\n}\r\n\r\n/**\r\n * Roll records up into {@link UsageSummary} rows by the chosen dimension. Tokens,\r\n * cost, and message counts sum; `sessions` counts distinct session ids; the row\r\n * carries the worst confidence and the latest timestamp seen. Sorted by total\r\n * tokens descending (ties broken by recency).\r\n */\r\nexport function aggregateBy(records: UsageRecord[], by: UsageGroupBy): UsageSummary[] {\r\n  const groups = new Map<string, MutableSummary>();\r\n\r\n  for (const rec of records) {\r\n    const key = groupKey(rec, by);\r\n    let g = groups.get(key);\r\n    if (g === undefined) {\r\n      g = {\r\n        key,\r\n        tokens: emptyTokens(),\r\n        total: 0,\r\n        sessions: 0,\r\n        messages: 0,\r\n        confidence: rec.confidence,\r\n        lastTs: rec.ts,\r\n        _sessions: new Set<string>(),\r\n      };\r\n      groups.set(key, g);\r\n    }\r\n\r\n    addTokensInPlace(g.tokens, rec.tokens);\r\n    g.messages += rec.messageCount;\r\n    g._sessions.add(rec.sessionId);\r\n    g.confidence = worstConfidence(g.confidence, rec.confidence);\r\n    if (rec.ts > g.lastTs) g.lastTs = rec.ts;\r\n    if (rec.cost !== undefined) g.cost = (g.cost ?? 0) + rec.cost;\r\n  }\r\n\r\n  const rows: UsageSummary[] = [];\r\n  for (const g of groups.values()) {\r\n    const { _sessions, ...summary } = g;\r\n    summary.total = sumTokens(summary.tokens);\r\n    summary.sessions = _sessions.size;\r\n    rows.push(summary);\r\n  }\r\n\r\n  rows.sort((a, b) => b.total - a.total || b.lastTs - a.lastTs);\r\n  return rows;\r\n}\r\n"],"mappings":";;;AAiBA,IAAM,kBAAuC,oBAAI,IAAI;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQD,SAAS,gCAAgC,SAAgC;AACvE,MAAI,CAAC,QAAQ,SAAS,GAAG,EAAG,QAAO;AACnC,QAAM,iBAAiB,QAAQ,MAAM,GAAG,EAAE;AAC1C,QAAM,OAAO,eAAe,YAAY,GAAG;AAC3C,MAAI,OAAO,EAAG,QAAO;AACrB,QAAM,OAAO,eAAe,MAAM,GAAG,IAAI;AACzC,QAAM,OAAO,eAAe,MAAM,OAAO,CAAC;AAC1C,MAAI,SAAS,MAAM,KAAK,KAAK,MAAM,KAAM,QAAO;AAChD,MAAI,CAAC,gBAAgB,IAAI,IAAI,EAAG,QAAO;AACvC,SAAO;AACT;AAQA,SAAS,sCAAsC,SAAgC;AAC7E,QAAM,SAAS;AACf,MAAI,CAAC,QAAQ,WAAW,MAAM,EAAG,QAAO;AACxC,QAAM,OAAO,QAAQ,MAAM,OAAO,MAAM;AACxC,QAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,QAAM,QAAQ,MAAM,CAAC;AACrB,QAAM,QAAQ,MAAM,CAAC;AACrB,QAAM,SAAS,MAAM,CAAC;AACtB,MAAI,UAAU,UAAa,UAAU,UAAa,WAAW,OAAW,QAAO;AAC/E,MAAI,MAAM,SAAS,EAAG,QAAO;AAC7B,MAAI,WAAW,UAAU,WAAW,YAAY,WAAW,QAAS,QAAO;AAC3E,SAAO,UAAU,MAAM,IAAI,KAAK,IAAI,KAAK;AAC3C;AAaO,SAAS,0BAA0B,SAAyB;AACjE,MAAI,OAAO,QAAQ,YAAY;AAE/B,QAAM,OAAO,gCAAgC,IAAI;AACjD,MAAI,SAAS,KAAM,QAAO;AAE1B,MAAI,KAAK,SAAS,GAAG;AACnB,UAAM,gBAAgB,KAAK,MAAM,KAAK,SAAS,CAAC;AAChD,UAAM,YAAY,aAAa,KAAK,aAAa;AACjD,QAAI,aAAa,KAAK,WAAW,KAAK,SAAS,CAAC,MAAM,IAAgB;AACpE,aAAO,KAAK,MAAM,GAAG,KAAK,SAAS,CAAC;AAAA,IACtC;AAAA,EACF;AAEA,MAAI,KAAK,SAAS,QAAQ,GAAG;AAC3B,UAAM,QAAQ,CAAC,GAAG,IAAI;AACtB,QAAI,SAAS;AACb,aAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,YAAM,IAAI,MAAM,CAAC;AACjB,YAAM,OAAO,MAAM,IAAI,CAAC;AACxB,YAAM,OAAO,MAAM,IAAI,CAAC;AACxB,UACE,MAAM,OACN,IAAI,KACJ,IAAI,MAAM,SAAS,KACnB,SAAS,UACT,SAAS,UACT,aAAa,IAAI,KACjB,aAAa,IAAI,GACjB;AACA,kBAAU;AAAA,MACZ,OAAO;AACL,kBAAU;AAAA,MACZ;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,sCAAsC,IAAI;AAC5D,MAAI,cAAc,KAAM,QAAO;AAE/B,SAAO;AACT;AAEA,SAAS,aAAa,GAAoB;AACxC,SAAO,KAAK,OAAO,KAAK;AAC1B;AAWA,SAAS,kBAAkB,UAAkB,QAAyB;AACpE,MAAI,OAAO;AACX,aAAS;AACP,UAAM,MAAM,SAAS,QAAQ,QAAQ,IAAI;AACzC,QAAI,MAAM,EAAG,QAAO;AACpB,UAAM,WAAW,QAAQ,KAAK,CAAC,WAAW,SAAS,WAAW,MAAM,CAAC,CAAC;AACtE,UAAM,WAAW,MAAM,OAAO;AAC9B,UAAM,UAAU,aAAa,SAAS,UAAU,CAAC,WAAW,SAAS,WAAW,QAAQ,CAAC;AACzF,QAAI,YAAY,QAAS,QAAO;AAChC,WAAO,MAAM;AAAA,EACf;AACF;AAEA,SAAS,WAAW,MAAuB;AACzC,SACG,QAAQ,MAAQ,QAAQ;AAAA,EACxB,QAAQ,MAAQ,QAAQ;AAAA,EACxB,QAAQ,MAAQ,QAAQ;AAE7B;AAOO,SAAS,cAAc,OAA8B;AAC1D,QAAM,QAAQ,MAAM,YAAY;AAEhC,MACE,MAAM,SAAS,QAAQ,KACvB,MAAM,SAAS,WAAW,KAC1B,kBAAkB,OAAO,MAAM,KAC/B,kBAAkB,OAAO,QAAQ,KACjC,kBAAkB,OAAO,OAAO,GAChC;AACA,WAAO;AAAA,EACT;AACA,MACE,MAAM,SAAS,KAAK,KACpB,MAAM,SAAS,QAAQ,KACvB,kBAAkB,OAAO,IAAI,KAC7B,kBAAkB,OAAO,IAAI,KAC7B,kBAAkB,OAAO,IAAI,GAC7B;AACA,WAAO;AAAA,EACT;AACA,MAAI,MAAM,SAAS,QAAQ,KAAK,MAAM,SAAS,QAAQ,EAAG,QAAO;AACjE,MAAI,MAAM,SAAS,MAAM,EAAG,QAAO;AACnC,MAAI,MAAM,SAAS,UAAU,EAAG,QAAO;AACvC,MAAI,MAAM,SAAS,SAAS,EAAG,QAAO;AACtC,MAAI,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS,SAAS,EAAG,QAAO;AACnE,MAAI,MAAM,SAAS,OAAO,KAAK,kBAAkB,OAAO,MAAM,EAAG,QAAO;AACxE,MAAI,MAAM,SAAS,MAAM,EAAG,QAAO;AACnC,SAAO;AACT;AAUA,IAAM,gBAAgB;AAGtB,SAAS,oBAAoB,GAAmB;AAC9C,gBAAc,YAAY;AAC1B,SAAO,cAAc,KAAK,CAAC,IAAI,EAAE,QAAQ,eAAe,EAAE,IAAI;AAChE;AAEA,IAAM,iBAAiB,CAAC,YAAY,qBAAqB,cAAc;AAGvE,SAAS,iBAAiB,MAAsB;AAC9C,aAAW,UAAU,gBAAgB;AACnC,QAAI,KAAK,UAAU,OAAO,UAAU,KAAK,MAAM,GAAG,OAAO,MAAM,EAAE,YAAY,MAAM,QAAQ;AACzF,aAAO,KAAK,MAAM,OAAO,MAAM;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,sBAAsB,MAAsB;AACnD,SAAO,KAAK,MAAM,KAAK,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE,EAAE,KAAK,GAAG;AAC3D;AAGA,SAAS,cAAc,MAAsB;AAC3C,QAAM,QAAQ,KAAK,YAAY;AAC/B,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,MAAO,QAAO;AAC5B,MAAI,SAAS,GAAI,QAAO;AACxB,QAAM,QAAQ,CAAC,GAAG,IAAI;AACtB,QAAM,QAAQ,MAAM,CAAC;AACrB,SAAO,MAAM,YAAY,IAAI,MAAM,MAAM,CAAC,EAAE,KAAK,EAAE;AACrD;AAGA,SAAS,eAAe,MAAsB;AAC5C,MAAI,SAAS,GAAI,QAAO;AACxB,SAAO,KACJ,MAAM,GAAG,EACT,QAAQ,CAAC,SAAS,KAAK,MAAM,KAAK,CAAC,EACnC,OAAO,CAAC,MAAM,MAAM,EAAE,EACtB,IAAI,aAAa,EACjB,KAAK,GAAG;AACb;AAGO,SAAS,mBAAmB,OAAuB;AACxD,QAAM,UAAU,oBAAoB,KAAK;AACzC,QAAM,UAAU,QAAQ,KAAK;AAC7B,QAAM,WAAW,iBAAiB,OAAO;AACzC,QAAM,YAAY,sBAAsB,QAAQ;AAChD,QAAM,aAAa,UAAU,YAAY;AAEzC,MAAI,WAAW,SAAS,MAAM,GAAG;AAC/B,QAAI,WAAW,SAAS,KAAK,KAAK,WAAW,SAAS,UAAU,GAAG;AACjE,aAAO;AAAA,IACT;AACA,WAAO,eAAe,SAAS;AAAA,EACjC;AACA,MAAI,eAAe,SAAS,eAAe,WAAY,QAAO;AAC9D,MAAI,eAAe,wBAAyB,QAAO;AACnD,SAAO,eAAe,SAAS;AACjC;AAGA,SAAS,+BAA+B,YAAwC;AAC9E,UAAQ,YAAY;AAAA,IAClB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAQO,SAAS,2BAA2B,OAAuB;AAChE,QAAM,UAAU,oBAAoB,KAAK;AACzC,QAAM,UAAU,QAAQ,KAAK;AAC7B,QAAM,WAAW,iBAAiB,OAAO;AACzC,QAAM,YAAY,sBAAsB,QAAQ;AAChD,QAAM,aAAa,UAAU,YAAY;AAEzC,QAAM,OAAO,+BAA+B,UAAU;AACtD,MAAI,SAAS,OAAW,QAAO;AAE/B,SAAO,mBAAmB,SAAS;AACrC;AAYO,SAAS,sBAAsB,KAAiC;AACrE,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,YAAY,GAAI,QAAO;AAE3B,QAAM,cAAc,QAAQ,WAAW,MAAM,KAAK,QAAQ,WAAW,IAAI;AACzE,MAAI,aAAa,QAAQ,QAAQ,OAAO,GAAG;AAE3C,MAAI,aAAa;AACf,QAAI,OAAO,WAAW,QAAQ,QAAQ,EAAE;AACxC,WAAO,KAAK,SAAS,IAAI,EAAG,QAAO,KAAK,QAAQ,SAAS,GAAG;AAC5D,iBAAa,KAAK,IAAI;AAAA,EACxB,OAAO;AACL,WAAO,WAAW,SAAS,IAAI,EAAG,cAAa,WAAW,QAAQ,SAAS,GAAG;AAAA,EAChF;AAEA,QAAM,SAAS,cAAc,IAAI;AACjC,MAAI,WAAW,SAAS,QAAQ;AAC9B,iBAAa,WAAW,QAAQ,QAAQ,EAAE;AAAA,EAC5C;AAEA,SAAO,eAAe,KAAK,SAAY;AACzC;AAMO,SAAS,sBAAsB,KAAiC;AACrE,QAAM,WAAW,IAAI,MAAM,GAAG;AAC9B,WAAS,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;AAC7C,UAAM,MAAM,SAAS,CAAC;AACtB,QAAI,QAAQ,UAAa,QAAQ,GAAI,QAAO;AAAA,EAC9C;AACA,SAAO;AACT;AAMO,SAAS,kBAAkB,KAGhC;AACA,QAAM,MAAM,sBAAsB,GAAG;AACrC,MAAI,QAAQ,OAAW,QAAO,CAAC;AAC/B,QAAM,QAAQ,sBAAsB,GAAG;AACvC,SAAO,UAAU,SAAY,EAAE,YAAY,IAAI,IAAI,EAAE,YAAY,KAAK,cAAc,MAAM;AAC5F;;;AC3WO,SAAS,cAA8B;AAC5C,SAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,EAAE;AAC1E;AAcO,SAAS,UAAU,GAA2B;AACnD,SAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE;AAC7D;AAGA,SAAS,iBAAiB,GAAmB,GAAyB;AACpE,IAAE,SAAS,EAAE;AACb,IAAE,UAAU,EAAE;AACd,IAAE,aAAa,EAAE;AACjB,IAAE,cAAc,EAAE;AAClB,IAAE,aAAa,EAAE;AACnB;AAOA,IAAM,kBAAmD;AAAA,EACvD,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAGO,SAAS,gBAAgB,GAAoB,GAAqC;AACvF,SAAO,gBAAgB,CAAC,IAAI,gBAAgB,CAAC,IAAI,IAAI;AACvD;AAYO,SAAS,OAAO,SAAuC;AAC5D,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,MAAqB,CAAC;AAC5B,aAAW,OAAO,SAAS;AACzB,UAAM,MAAM,IAAI;AAChB,QAAI,QAAQ,UAAa,QAAQ,IAAI;AACnC,UAAI,KAAK,GAAG;AACZ;AAAA,IACF;AACA,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,GAAG;AACZ,UAAI,KAAK,GAAG;AAAA,IACd;AAAA,EAEF;AACA,SAAO;AACT;AAOA,SAAS,SAAS,IAAoB;AACpC,QAAM,IAAI,IAAI,KAAK,EAAE;AACrB,QAAM,IAAI,EAAE,YAAY;AACxB,QAAM,IAAI,GAAG,EAAE,SAAS,IAAI,CAAC,GAAG,SAAS,GAAG,GAAG;AAC/C,QAAM,MAAM,GAAG,EAAE,QAAQ,CAAC,GAAG,SAAS,GAAG,GAAG;AAC5C,SAAO,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG;AACzB;AAGA,SAAS,SAAS,KAAkB,IAA0B;AAC5D,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,IAAI,gBAAgB,IAAI,cAAc;AAAA,IAC/C,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,0BAA0B,IAAI,OAAO;AAAA,IAC9C,KAAK;AACH,aAAO,SAAS,IAAI,EAAE;AAAA,EAC1B;AACF;AAaO,SAAS,YAAY,SAAwB,IAAkC;AACpF,QAAM,SAAS,oBAAI,IAA4B;AAE/C,aAAW,OAAO,SAAS;AACzB,UAAM,MAAM,SAAS,KAAK,EAAE;AAC5B,QAAI,IAAI,OAAO,IAAI,GAAG;AACtB,QAAI,MAAM,QAAW;AACnB,UAAI;AAAA,QACF;AAAA,QACA,QAAQ,YAAY;AAAA,QACpB,OAAO;AAAA,QACP,UAAU;AAAA,QACV,UAAU;AAAA,QACV,YAAY,IAAI;AAAA,QAChB,QAAQ,IAAI;AAAA,QACZ,WAAW,oBAAI,IAAY;AAAA,MAC7B;AACA,aAAO,IAAI,KAAK,CAAC;AAAA,IACnB;AAEA,qBAAiB,EAAE,QAAQ,IAAI,MAAM;AACrC,MAAE,YAAY,IAAI;AAClB,MAAE,UAAU,IAAI,IAAI,SAAS;AAC7B,MAAE,aAAa,gBAAgB,EAAE,YAAY,IAAI,UAAU;AAC3D,QAAI,IAAI,KAAK,EAAE,OAAQ,GAAE,SAAS,IAAI;AACtC,QAAI,IAAI,SAAS,OAAW,GAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI;AAAA,EAC3D;AAEA,QAAM,OAAuB,CAAC;AAC9B,aAAW,KAAK,OAAO,OAAO,GAAG;AAC/B,UAAM,EAAE,WAAW,GAAG,QAAQ,IAAI;AAClC,YAAQ,QAAQ,UAAU,QAAQ,MAAM;AACxC,YAAQ,WAAW,UAAU;AAC7B,SAAK,KAAK,OAAO;AAAA,EACnB;AAEA,OAAK,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;AAC5D,SAAO;AACT;","names":[]}