@ken-jo/agent-connector 0.6.3 → 0.6.5

package/dist/{telemetry-YVMUXTDG.js.map → telemetry-AEE4TOFA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/telemetry.ts","../src/telemetry/report.ts"],"sourcesContent":["/**\n * cli/commands/telemetry — inspect the local per-tool token telemetry store.\n *\n * Subcommands:\n *   report  --by tool|session|project (default tool)  --since 7d|24h|… --connector <id> [--json]\n *           → summarize(openStore({}), …) + formatReport (the aligned table).\n *   export  --format csv|json (default json)  --out <file>  [--since/--connector …]\n *           → toCSV / toJSONExport of the raw records.\n *\n * Telemetry rows are aggregate counts only (never raw arguments/results).\n */\n\nimport { writeFileSync } from \"node:fs\";\nimport { parseArgs } from \"node:util\";\n\nimport type { QueryFilter } from \"../../telemetry/types.js\";\nimport type { RollupDimension } from \"../../telemetry/report.js\";\nimport { openStore } from \"../../telemetry/store.js\";\nimport { summarize, toCSV, toJSONExport } from \"../../telemetry/report.js\";\nimport {\n  formatMcpLeaderboard,\n  formatSurfaceLeaderboard,\n  formatToolLeaderboard,\n  isScopeFilter,\n  mcpLeaderboard,\n  SCOPE_FILTER_VALUES,\n  surfaceLeaderboard,\n  toolLeaderboard,\n  type LeaderboardOptions,\n  type ScopeFilter,\n  type SurfaceLeaderboardOptions,\n} from \"../../telemetry/leaderboard.js\";\nimport {\n  connectorFromMeta,\n  listRegisteredConnectors,\n  loadRegisteredConnector,\n  readRegisteredMeta,\n} from \"../../core/load-connector.js\";\nimport type { ResolvedConnector } from \"../../core/types.js\";\nimport { fail, print } from \"../app.js\";\n\n/**\n * Parse a relative duration (`Ns`/`Nm`/`Nh`/`Nd`) to a lower-bound epoch ms.\n * Returns undefined for an empty input and null for a malformed one.\n */\nexport function parseSince(since: string | undefined): number | null | undefined {\n  if (since == null || since.trim() === \"\") return undefined;\n  const m = since.trim().match(/^(\\d+)\\s*([smhd])$/i);\n  if (!m || !m[1] || !m[2]) return null;\n  const n = Number(m[1]);\n  const unitMs: Record<string, number> = {\n    s: 1000,\n    m: 60_000,\n    h: 3_600_000,\n    d: 86_400_000,\n  };\n  const factor = unitMs[m[2].toLowerCase()];\n  if (factor == null) return null;\n  return Date.now() - n * factor;\n}\n\n/** Build a QueryFilter from the shared --since / --connector flags. */\nfunction buildFilter(\n  since: string | undefined,\n  connectorId: string | undefined,\n): QueryFilter | null {\n  const sinceMs = parseSince(since);\n  if (sinceMs === null) return null;\n  const filter: QueryFilter = {};\n  if (sinceMs !== undefined) filter.sinceMs = sinceMs;\n  if (connectorId && connectorId.trim() !== \"\") filter.connectorId = connectorId;\n  return filter;\n}\n\nfunction runReport(argv: string[]): number {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"tool\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"tool\" && by !== \"session\" && by !== \"project\") {\n    return fail(`invalid --by \"${by}\" (use tool|session|project)`);\n  }\n  const dimension: RollupDimension = by;\n\n  const filter = buildFilter(values.since, values.connector);\n  if (filter === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const store = openStore({});\n  try {\n    const { rows, text } = summarize(store, { by: dimension, filter });\n    if (values.json) {\n      print(JSON.stringify(rows, null, 2));\n    } else {\n      print(text);\n    }\n  } finally {\n    store.close();\n  }\n  return 0;\n}\n\nfunction runExport(argv: string[]): number {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      format: { type: \"string\", default: \"json\" },\n      out: { type: \"string\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n    },\n    allowPositionals: false,\n  });\n\n  const format = values.format;\n  if (format !== \"csv\" && format !== \"json\") {\n    return fail(`invalid --format \"${format}\" (use csv|json)`);\n  }\n\n  const filter = buildFilter(values.since, values.connector);\n  if (filter === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const store = openStore({});\n  let serialized: string;\n  try {\n    const records = store.query(filter);\n    serialized = format === \"csv\" ? toCSV(records) : toJSONExport(records);\n  } finally {\n    store.close();\n  }\n\n  if (values.out && values.out.trim() !== \"\") {\n    writeFileSync(values.out, serialized, \"utf8\");\n    print(`wrote ${format.toUpperCase()} export → ${values.out}`);\n  } else {\n    print(serialized);\n  }\n  return 0;\n}\n\n/**\n * `telemetry leaderboard` — rank the per-MCP telemetry by connector (--by mcp,\n * the default and signature \"which MCP server costs the most\" metric), by tool\n * (--by tool), or by developer-axis surface (--by surface — the FIVE surfaces:\n * server + hook runtime rows plus static command/skill/subagent footprints).\n * Honors --since / --connector and the scope slice (--scope).\n */\nasync function runLeaderboard(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"mcp\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n      scope: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"mcp\" && by !== \"tool\" && by !== \"surface\") {\n    return fail(`invalid --by \"${by}\" (use mcp|tool|surface)`);\n  }\n\n  const sinceMs = parseSince(values.since);\n  if (sinceMs === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  let scope: ScopeFilter | undefined;\n  if (values.scope !== undefined && values.scope.trim() !== \"\") {\n    const s = values.scope.trim();\n    if (!isScopeFilter(s)) {\n      return fail(`invalid --scope \"${s}\" (use ${SCOPE_FILTER_VALUES.join(\"|\")})`);\n    }\n    scope = s;\n  }\n\n  const opts: LeaderboardOptions = {};\n  if (sinceMs !== undefined) opts.sinceMs = sinceMs;\n  if (values.connector && values.connector.trim() !== \"\") {\n    opts.connectorId = values.connector.trim();\n  }\n  if (scope !== undefined) opts.scope = scope;\n\n  if (by === \"tool\") {\n    const rows = toolLeaderboard(opts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatToolLeaderboard(rows));\n  } else if (by === \"surface\") {\n    // The per-surface view folds the STATIC command/skill/subagent footprints of\n    // the registered connector(s) into the runtime server/hook rows.\n    const connectorId = values.connector?.trim();\n    const surfaceOpts: SurfaceLeaderboardOptions = {\n      ...opts,\n      connectors: await gatherConnectors(connectorId),\n    };\n    const rows = surfaceLeaderboard(surfaceOpts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatSurfaceLeaderboard(rows));\n  } else {\n    const rows = mcpLeaderboard(opts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatMcpLeaderboard(rows));\n  }\n  return 0;\n}\n\n/**\n * Gather the registered connector(s) whose STATIC command/skill/subagent\n * footprints feed the per-surface view. When `connectorId` is given, prefer the\n * LIVE module (freshest content) and fall back to the persisted meta record;\n * otherwise enumerate every registered connector from its meta. Best-effort: a\n * connector that cannot be loaded is skipped (the surface view still renders the\n * runtime rows it can read from the store).\n */\nasync function gatherConnectors(\n  connectorId: string | undefined,\n): Promise<ResolvedConnector[]> {\n  if (connectorId !== undefined && connectorId !== \"\") {\n    try {\n      return [await loadRegisteredConnector(connectorId)];\n    } catch {\n      const meta = readRegisteredMetaSafe(connectorId);\n      return meta ? [connectorFromMeta(meta)] : [];\n    }\n  }\n  return listRegisteredConnectors();\n}\n\n/** readRegisteredMeta wrapped so a missing/corrupt record never throws here. */\nfunction readRegisteredMetaSafe(id: string): ReturnType<typeof readRegisteredMeta> {\n  try {\n    return readRegisteredMeta(id);\n  } catch {\n    return null;\n  }\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const sub = argv[0];\n  const rest = argv.slice(1);\n\n  switch (sub) {\n    case \"report\":\n      return runReport(rest);\n    case \"export\":\n      return runExport(rest);\n    case \"leaderboard\":\n      return await runLeaderboard(rest);\n    case undefined:\n    case \"--help\":\n    case \"-h\":\n      print(\"usage: agent-connector telemetry <report|export|leaderboard> [flags]\");\n      print(\"  report       --by tool|session|project  --since 7d  --connector <id>  --json\");\n      print(\"  export       --format csv|json  --out <file>  --since 7d  --connector <id>\");\n      print(\"  leaderboard  --by mcp|tool|surface  --since 7d  --connector <id>  --scope <slice>  --json\");\n      return sub === undefined ? 1 : 0;\n    default:\n      return fail(`unknown telemetry subcommand \"${sub}\" (use report|export|leaderboard)`);\n  }\n}\n","/**\n * telemetry/report — CLI-facing formatting for telemetry rollups and exports.\n *\n * Pure functions: take store output (rollup rows / raw records) and render text,\n * CSV, or JSON. No IO except {@link summarize}, which reads through a passed-in\n * {@link TelemetryStore}. Confidence is surfaced verbatim so heuristic/approx\n * numbers are never mistaken for exact host-reported usage.\n */\n\nimport type { TelemetryStore } from \"./types.js\";\nimport type {\n  ConfidenceSource,\n  QueryFilter,\n  RollupRow,\n  ToolEventRecord,\n} from \"./types.js\";\n\n/** Grouping dimension, mirrored from {@link TelemetryStore.rollup}. */\nexport type RollupDimension = \"tool\" | \"session\" | \"project\";\n\n/** Human label for the leading KEY column, per grouping dimension. */\nconst KEY_HEADER: Record<RollupDimension, string> = {\n  tool: \"TOOL\",\n  session: \"SESSION\",\n  project: \"PROJECT\",\n};\n\n/**\n * Sources whose counts are estimates (vs. real / host-reported numbers).\n * `tokenizer-calibrated` is still an estimate — an approximation nudged toward\n * truth by a sampled Anthropic count_tokens factor — so it belongs here too.\n */\nconst ESTIMATE_SOURCES: ReadonlySet<ConfidenceSource> = new Set<ConfidenceSource>([\n  \"heuristic\",\n  \"tokenizer-approx\",\n  \"tokenizer-calibrated\",\n]);\n\n/** Compact, fixed-width integer formatting with thousands separators. */\nfunction fmtInt(n: number): string {\n  return n.toLocaleString(\"en-US\");\n}\n\n/** Pad a cell to a column width (right-pad text, used for left-aligned cols). */\nfunction padRight(s: string, width: number): string {\n  return s.length >= width ? s : s + \" \".repeat(width - s.length);\n}\n\n/** Pad a cell to a column width (left-pad, used for right-aligned numbers). */\nfunction padLeft(s: string, width: number): string {\n  return s.length >= width ? s : \" \".repeat(width - s.length) + s;\n}\n\n/**\n * Render an aligned text table of rollup rows, sorted by total tokens desc, with\n * a TOTAL footer and a short legend noting which confidence labels are estimates.\n */\nexport function formatReport(rows: RollupRow[], by: RollupDimension): string {\n  const keyHeader = KEY_HEADER[by];\n  const headers = [keyHeader, \"CALLS\", \"IN\", \"OUT\", \"TOTAL\", \"CONFIDENCE\"];\n\n  const sorted = [...rows].sort((a, b) => b.totalTokens - a.totalTokens);\n\n  // Build the data matrix (string cells) first so we can measure widths.\n  const dataRows = sorted.map((r) => [\n    r.key,\n    fmtInt(r.calls),\n    fmtInt(r.inputTokens),\n    fmtInt(r.outputTokens),\n    fmtInt(r.totalTokens),\n    r.confidence,\n  ]);\n\n  // Totals footer. Confidence is the worst (least-confident) across all rows.\n  const totals = sorted.reduce(\n    (acc, r) => {\n      acc.calls += r.calls;\n      acc.inputTokens += r.inputTokens;\n      acc.outputTokens += r.outputTokens;\n      acc.totalTokens += r.totalTokens;\n      return acc;\n    },\n    { calls: 0, inputTokens: 0, outputTokens: 0, totalTokens: 0 },\n  );\n  const totalRow = [\n    \"TOTAL\",\n    fmtInt(totals.calls),\n    fmtInt(totals.inputTokens),\n    fmtInt(totals.outputTokens),\n    fmtInt(totals.totalTokens),\n    \"\",\n  ];\n\n  // Column widths: max over header, every data cell, and the totals row.\n  const widths = headers.map((h, col) => {\n    let w = h.length;\n    for (const row of dataRows) w = Math.max(w, (row[col] ?? \"\").length);\n    w = Math.max(w, (totalRow[col] ?? \"\").length);\n    return w;\n  });\n\n  // Column 0 (KEY) is left-aligned; numeric/label columns are right-aligned.\n  const renderRow = (cells: string[]): string =>\n    cells\n      .map((c, col) =>\n        col === 0\n          ? padRight(c, widths[col] ?? 0)\n          : padLeft(c, widths[col] ?? 0),\n      )\n      .join(\"  \")\n      .trimEnd();\n\n  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);\n  const rule = \"-\".repeat(ruleWidth);\n\n  const lines: string[] = [];\n  lines.push(renderRow(headers));\n  lines.push(rule);\n  if (dataRows.length === 0) {\n    lines.push(\"(no telemetry recorded)\");\n  } else {\n    for (const row of dataRows) lines.push(renderRow(row));\n  }\n  lines.push(rule);\n  lines.push(renderRow(totalRow));\n\n  // Legend — honest labeling of which confidence values are estimates.\n  const hasEstimate = sorted.some((r) => ESTIMATE_SOURCES.has(r.confidence));\n  if (hasEstimate) {\n    lines.push(\"\");\n    lines.push(\n      \"note: heuristic and tokenizer-approx token counts are estimates, \" +\n        \"not exact host-reported usage.\",\n    );\n    if (sorted.some((r) => r.confidence === \"tokenizer-calibrated\")) {\n      lines.push(\n        \"note: tokenizer-calibrated = local approx adjusted by a sampled \" +\n          \"Anthropic count_tokens factor (opt-in; content sampled off-box only \" +\n          \"when AGENT_CONNECTOR_CALIBRATE=anthropic).\",\n      );\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/** Ordered columns for {@link toCSV}, matching the {@link ToolEventRecord} shape. */\nconst CSV_COLUMNS = [\n  \"id\",\n  \"ts\",\n  \"connectorId\",\n  \"toolName\",\n  \"scope\",\n  \"hostPlatform\",\n  \"sessionId\",\n  \"projectKey\",\n  \"projectDir\",\n  \"inputTokens\",\n  \"outputTokens\",\n  \"confidenceSource\",\n  \"isError\",\n  // installScope / launchMethod mirror the JSON export so the scope dimension is\n  // not silently dropped from CSV; absent on a record → an empty cell.\n  \"installScope\",\n  \"launchMethod\",\n] as const satisfies ReadonlyArray<keyof ToolEventRecord>;\n\n/** RFC-4180-ish CSV escaping: quote when the cell holds a comma, quote, or newline. */\nfunction csvCell(value: unknown): string {\n  // An absent field (optional column like installScope/launchMethod) renders as\n  // an empty cell rather than the literal \"undefined\" — the JSON export omits\n  // the key entirely, so the CSV should likewise carry no value.\n  if (value === undefined || value === null) return \"\";\n  const s = String(value);\n  if (/[\",\\n\\r]/.test(s)) {\n    return `\"${s.replace(/\"/g, '\"\"')}\"`;\n  }\n  return s;\n}\n\n/** Serialize raw records to CSV (header + one line per record, CRLF-terminated). */\nexport function toCSV(records: ToolEventRecord[]): string {\n  const lines: string[] = [];\n  lines.push(CSV_COLUMNS.join(\",\"));\n  for (const record of records) {\n    lines.push(CSV_COLUMNS.map((col) => csvCell(record[col])).join(\",\"));\n  }\n  return lines.join(\"\\r\\n\");\n}\n\n/** Serialize raw records to a pretty-printed JSON array string. */\nexport function toJSONExport(records: ToolEventRecord[]): string {\n  return JSON.stringify(records, null, 2);\n}\n\n/** Options for {@link summarize}. */\nexport interface SummarizeOptions {\n  /** Grouping dimension. Default \"tool\". */\n  by?: RollupDimension;\n  /** Query filter forwarded to the store. Default: no filter (all records). */\n  filter?: QueryFilter;\n}\n\n/**\n * Roll up a store and render it in one call. Returns the structured rows (for\n * machine use) alongside the formatted text table (for the CLI).\n */\nexport function summarize(\n  store: TelemetryStore,\n  opts?: SummarizeOptions,\n): { rows: RollupRow[]; text: string } {\n  const by = opts?.by ?? \"tool\";\n  const filter = opts?.filter ?? {};\n  const rows = store.rollup(by, filter);\n  return { rows, text: formatReport(rows, by) };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/telemetry.ts","../src/telemetry/report.ts"],"sourcesContent":["/**\n * cli/commands/telemetry — inspect the local per-tool token telemetry store.\n *\n * Subcommands:\n *   report  --by tool|session|project (default tool)  --since 7d|24h|… --connector <id> [--json]\n *           → summarize(openStore({}), …) + formatReport (the aligned table).\n *   export  --format csv|json (default json)  --out <file>  [--since/--connector …]\n *           → toCSV / toJSONExport of the raw records.\n *\n * Telemetry rows are aggregate counts only (never raw arguments/results).\n */\n\nimport { writeFileSync } from \"node:fs\";\nimport { parseArgs } from \"node:util\";\n\nimport type { QueryFilter } from \"../../telemetry/types.js\";\nimport type { RollupDimension } from \"../../telemetry/report.js\";\nimport { openStore } from \"../../telemetry/store.js\";\nimport { summarize, toCSV, toJSONExport } from \"../../telemetry/report.js\";\nimport {\n  formatMcpLeaderboard,\n  formatSurfaceLeaderboard,\n  formatToolLeaderboard,\n  isScopeFilter,\n  mcpLeaderboard,\n  SCOPE_FILTER_VALUES,\n  surfaceLeaderboard,\n  toolLeaderboard,\n  type LeaderboardOptions,\n  type ScopeFilter,\n  type SurfaceLeaderboardOptions,\n} from \"../../telemetry/leaderboard.js\";\nimport {\n  connectorFromMeta,\n  listRegisteredConnectors,\n  loadRegisteredConnector,\n  readRegisteredMeta,\n} from \"../../core/load-connector.js\";\nimport type { ResolvedConnector } from \"../../core/types.js\";\nimport { fail, print } from \"../app.js\";\n\n/**\n * Parse a relative duration (`Ns`/`Nm`/`Nh`/`Nd`) to a lower-bound epoch ms.\n * Returns undefined for an empty input and null for a malformed one.\n */\nexport function parseSince(since: string | undefined): number | null | undefined {\n  if (since == null || since.trim() === \"\") return undefined;\n  const m = since.trim().match(/^(\\d+)\\s*([smhd])$/i);\n  if (!m || !m[1] || !m[2]) return null;\n  const n = Number(m[1]);\n  const unitMs: Record<string, number> = {\n    s: 1000,\n    m: 60_000,\n    h: 3_600_000,\n    d: 86_400_000,\n  };\n  const factor = unitMs[m[2].toLowerCase()];\n  if (factor == null) return null;\n  return Date.now() - n * factor;\n}\n\n/** Build a QueryFilter from the shared --since / --connector flags. */\nfunction buildFilter(\n  since: string | undefined,\n  connectorId: string | undefined,\n): QueryFilter | null {\n  const sinceMs = parseSince(since);\n  if (sinceMs === null) return null;\n  const filter: QueryFilter = {};\n  if (sinceMs !== undefined) filter.sinceMs = sinceMs;\n  if (connectorId && connectorId.trim() !== \"\") filter.connectorId = connectorId;\n  return filter;\n}\n\nfunction runReport(argv: string[]): number {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"tool\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"tool\" && by !== \"session\" && by !== \"project\") {\n    return fail(`invalid --by \"${by}\" (use tool|session|project)`);\n  }\n  const dimension: RollupDimension = by;\n\n  const filter = buildFilter(values.since, values.connector);\n  if (filter === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const store = openStore({});\n  try {\n    const { rows, text } = summarize(store, { by: dimension, filter });\n    if (values.json) {\n      print(JSON.stringify(rows, null, 2));\n    } else {\n      print(text);\n    }\n  } finally {\n    store.close();\n  }\n  return 0;\n}\n\nfunction runExport(argv: string[]): number {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      format: { type: \"string\", default: \"json\" },\n      out: { type: \"string\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n    },\n    allowPositionals: false,\n  });\n\n  const format = values.format;\n  if (format !== \"csv\" && format !== \"json\") {\n    return fail(`invalid --format \"${format}\" (use csv|json)`);\n  }\n\n  const filter = buildFilter(values.since, values.connector);\n  if (filter === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const store = openStore({});\n  let serialized: string;\n  try {\n    const records = store.query(filter);\n    serialized = format === \"csv\" ? toCSV(records) : toJSONExport(records);\n  } finally {\n    store.close();\n  }\n\n  if (values.out && values.out.trim() !== \"\") {\n    writeFileSync(values.out, serialized, \"utf8\");\n    print(`wrote ${format.toUpperCase()} export → ${values.out}`);\n  } else {\n    print(serialized);\n  }\n  return 0;\n}\n\n/**\n * `telemetry leaderboard` — rank the per-MCP telemetry by connector (--by mcp,\n * the default and signature \"which MCP server costs the most\" metric), by tool\n * (--by tool), or by developer-axis surface (--by surface — the FIVE surfaces:\n * server + hook runtime rows plus static command/skill/subagent footprints).\n * Honors --since / --connector and the scope slice (--scope).\n */\nasync function runLeaderboard(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"mcp\" },\n      since: { type: \"string\" },\n      connector: { type: \"string\" },\n      scope: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"mcp\" && by !== \"tool\" && by !== \"surface\") {\n    return fail(`invalid --by \"${by}\" (use mcp|tool|surface)`);\n  }\n\n  const sinceMs = parseSince(values.since);\n  if (sinceMs === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  let scope: ScopeFilter | undefined;\n  if (values.scope !== undefined && values.scope.trim() !== \"\") {\n    const s = values.scope.trim();\n    if (!isScopeFilter(s)) {\n      return fail(`invalid --scope \"${s}\" (use ${SCOPE_FILTER_VALUES.join(\"|\")})`);\n    }\n    scope = s;\n  }\n\n  const opts: LeaderboardOptions = {};\n  if (sinceMs !== undefined) opts.sinceMs = sinceMs;\n  if (values.connector && values.connector.trim() !== \"\") {\n    opts.connectorId = values.connector.trim();\n  }\n  if (scope !== undefined) opts.scope = scope;\n\n  if (by === \"tool\") {\n    const rows = toolLeaderboard(opts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatToolLeaderboard(rows));\n  } else if (by === \"surface\") {\n    // The per-surface view folds the STATIC command/skill/subagent footprints of\n    // the registered connector(s) into the runtime server/hook rows.\n    const connectorId = values.connector?.trim();\n    const surfaceOpts: SurfaceLeaderboardOptions = {\n      ...opts,\n      connectors: await gatherConnectors(connectorId),\n    };\n    const rows = surfaceLeaderboard(surfaceOpts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatSurfaceLeaderboard(rows));\n  } else {\n    const rows = mcpLeaderboard(opts);\n    print(values.json ? JSON.stringify(rows, null, 2) : formatMcpLeaderboard(rows));\n  }\n  return 0;\n}\n\n/**\n * Gather the registered connector(s) whose STATIC command/skill/subagent\n * footprints feed the per-surface view. When `connectorId` is given, prefer the\n * LIVE module (freshest content) and fall back to the persisted meta record;\n * otherwise enumerate every registered connector from its meta. Best-effort: a\n * connector that cannot be loaded is skipped (the surface view still renders the\n * runtime rows it can read from the store).\n */\nasync function gatherConnectors(\n  connectorId: string | undefined,\n): Promise<ResolvedConnector[]> {\n  if (connectorId !== undefined && connectorId !== \"\") {\n    try {\n      return [await loadRegisteredConnector(connectorId)];\n    } catch {\n      const meta = readRegisteredMetaSafe(connectorId);\n      return meta ? [connectorFromMeta(meta)] : [];\n    }\n  }\n  return listRegisteredConnectors();\n}\n\n/** readRegisteredMeta wrapped so a missing/corrupt record never throws here. */\nfunction readRegisteredMetaSafe(id: string): ReturnType<typeof readRegisteredMeta> {\n  try {\n    return readRegisteredMeta(id);\n  } catch {\n    return null;\n  }\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const sub = argv[0];\n  const rest = argv.slice(1);\n\n  switch (sub) {\n    case \"report\":\n      return runReport(rest);\n    case \"export\":\n      return runExport(rest);\n    case \"leaderboard\":\n      return await runLeaderboard(rest);\n    case undefined:\n    case \"--help\":\n    case \"-h\":\n      print(\"usage: agent-connector telemetry <report|export|leaderboard> [flags]\");\n      print(\"  report       --by tool|session|project  --since 7d  --connector <id>  --json\");\n      print(\"  export       --format csv|json  --out <file>  --since 7d  --connector <id>\");\n      print(\"  leaderboard  --by mcp|tool|surface  --since 7d  --connector <id>  --scope <slice>  --json\");\n      return sub === undefined ? 1 : 0;\n    default:\n      return fail(`unknown telemetry subcommand \"${sub}\" (use report|export|leaderboard)`);\n  }\n}\n","/**\n * telemetry/report — CLI-facing formatting for telemetry rollups and exports.\n *\n * Pure functions: take store output (rollup rows / raw records) and render text,\n * CSV, or JSON. No IO except {@link summarize}, which reads through a passed-in\n * {@link TelemetryStore}. Confidence is surfaced verbatim so heuristic/approx\n * numbers are never mistaken for exact host-reported usage.\n */\n\nimport type { TelemetryStore } from \"./types.js\";\nimport type {\n  ConfidenceSource,\n  QueryFilter,\n  RollupRow,\n  ToolEventRecord,\n} from \"./types.js\";\n\n/** Grouping dimension, mirrored from {@link TelemetryStore.rollup}. */\nexport type RollupDimension = \"tool\" | \"session\" | \"project\";\n\n/** Human label for the leading KEY column, per grouping dimension. */\nconst KEY_HEADER: Record<RollupDimension, string> = {\n  tool: \"TOOL\",\n  session: \"SESSION\",\n  project: \"PROJECT\",\n};\n\n/**\n * Sources whose counts are estimates (vs. real / host-reported numbers).\n * `tokenizer-calibrated` is still an estimate — an approximation nudged toward\n * truth by a sampled Anthropic count_tokens factor — so it belongs here too.\n */\nconst ESTIMATE_SOURCES: ReadonlySet<ConfidenceSource> = new Set<ConfidenceSource>([\n  \"heuristic\",\n  \"tokenizer-approx\",\n  \"tokenizer-calibrated\",\n]);\n\n/** Compact, fixed-width integer formatting with thousands separators. */\nfunction fmtInt(n: number): string {\n  return n.toLocaleString(\"en-US\");\n}\n\n/** Pad a cell to a column width (right-pad text, used for left-aligned cols). */\nfunction padRight(s: string, width: number): string {\n  return s.length >= width ? s : s + \" \".repeat(width - s.length);\n}\n\n/** Pad a cell to a column width (left-pad, used for right-aligned numbers). */\nfunction padLeft(s: string, width: number): string {\n  return s.length >= width ? s : \" \".repeat(width - s.length) + s;\n}\n\n/**\n * Render an aligned text table of rollup rows, sorted by total tokens desc, with\n * a TOTAL footer and a short legend noting which confidence labels are estimates.\n */\nexport function formatReport(rows: RollupRow[], by: RollupDimension): string {\n  const keyHeader = KEY_HEADER[by];\n  const headers = [keyHeader, \"CALLS\", \"IN\", \"OUT\", \"TOTAL\", \"CONFIDENCE\"];\n\n  const sorted = [...rows].sort((a, b) => b.totalTokens - a.totalTokens);\n\n  // Build the data matrix (string cells) first so we can measure widths.\n  const dataRows = sorted.map((r) => [\n    r.key,\n    fmtInt(r.calls),\n    fmtInt(r.inputTokens),\n    fmtInt(r.outputTokens),\n    fmtInt(r.totalTokens),\n    r.confidence,\n  ]);\n\n  // Totals footer. Confidence is the worst (least-confident) across all rows.\n  const totals = sorted.reduce(\n    (acc, r) => {\n      acc.calls += r.calls;\n      acc.inputTokens += r.inputTokens;\n      acc.outputTokens += r.outputTokens;\n      acc.totalTokens += r.totalTokens;\n      return acc;\n    },\n    { calls: 0, inputTokens: 0, outputTokens: 0, totalTokens: 0 },\n  );\n  const totalRow = [\n    \"TOTAL\",\n    fmtInt(totals.calls),\n    fmtInt(totals.inputTokens),\n    fmtInt(totals.outputTokens),\n    fmtInt(totals.totalTokens),\n    \"\",\n  ];\n\n  // Column widths: max over header, every data cell, and the totals row.\n  const widths = headers.map((h, col) => {\n    let w = h.length;\n    for (const row of dataRows) w = Math.max(w, (row[col] ?? \"\").length);\n    w = Math.max(w, (totalRow[col] ?? \"\").length);\n    return w;\n  });\n\n  // Column 0 (KEY) is left-aligned; numeric/label columns are right-aligned.\n  const renderRow = (cells: string[]): string =>\n    cells\n      .map((c, col) =>\n        col === 0\n          ? padRight(c, widths[col] ?? 0)\n          : padLeft(c, widths[col] ?? 0),\n      )\n      .join(\"  \")\n      .trimEnd();\n\n  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);\n  const rule = \"-\".repeat(ruleWidth);\n\n  const lines: string[] = [];\n  lines.push(renderRow(headers));\n  lines.push(rule);\n  if (dataRows.length === 0) {\n    lines.push(\"(no telemetry recorded)\");\n  } else {\n    for (const row of dataRows) lines.push(renderRow(row));\n  }\n  lines.push(rule);\n  lines.push(renderRow(totalRow));\n\n  // Legend — honest labeling of which confidence values are estimates.\n  const hasEstimate = sorted.some((r) => ESTIMATE_SOURCES.has(r.confidence));\n  if (hasEstimate) {\n    lines.push(\"\");\n    lines.push(\n      \"note: heuristic and tokenizer-approx token counts are estimates, \" +\n        \"not exact host-reported usage.\",\n    );\n    if (sorted.some((r) => r.confidence === \"tokenizer-calibrated\")) {\n      lines.push(\n        \"note: tokenizer-calibrated = local approx adjusted by a sampled \" +\n          \"Anthropic count_tokens factor (opt-in; content sampled off-box only \" +\n          \"when AGENT_CONNECTOR_CALIBRATE=anthropic).\",\n      );\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/** Ordered columns for {@link toCSV}, matching the {@link ToolEventRecord} shape. */\nconst CSV_COLUMNS = [\n  \"id\",\n  \"ts\",\n  \"connectorId\",\n  \"toolName\",\n  \"scope\",\n  \"hostPlatform\",\n  \"sessionId\",\n  \"projectKey\",\n  \"projectDir\",\n  \"inputTokens\",\n  \"outputTokens\",\n  \"confidenceSource\",\n  \"isError\",\n  // installScope / launchMethod mirror the JSON export so the scope dimension is\n  // not silently dropped from CSV; absent on a record → an empty cell.\n  \"installScope\",\n  \"launchMethod\",\n] as const satisfies ReadonlyArray<keyof ToolEventRecord>;\n\n/** RFC-4180-ish CSV escaping: quote when the cell holds a comma, quote, or newline. */\nfunction csvCell(value: unknown): string {\n  // An absent field (optional column like installScope/launchMethod) renders as\n  // an empty cell rather than the literal \"undefined\" — the JSON export omits\n  // the key entirely, so the CSV should likewise carry no value.\n  if (value === undefined || value === null) return \"\";\n  const s = String(value);\n  if (/[\",\\n\\r]/.test(s)) {\n    return `\"${s.replace(/\"/g, '\"\"')}\"`;\n  }\n  return s;\n}\n\n/** Serialize raw records to CSV (header + one line per record, CRLF-terminated). */\nexport function toCSV(records: ToolEventRecord[]): string {\n  const lines: string[] = [];\n  lines.push(CSV_COLUMNS.join(\",\"));\n  for (const record of records) {\n    lines.push(CSV_COLUMNS.map((col) => csvCell(record[col])).join(\",\"));\n  }\n  return lines.join(\"\\r\\n\");\n}\n\n/** Serialize raw records to a pretty-printed JSON array string. */\nexport function toJSONExport(records: ToolEventRecord[]): string {\n  return JSON.stringify(records, null, 2);\n}\n\n/** Options for {@link summarize}. */\nexport interface SummarizeOptions {\n  /** Grouping dimension. Default \"tool\". */\n  by?: RollupDimension;\n  /** Query filter forwarded to the store. Default: no filter (all records). */\n  filter?: QueryFilter;\n}\n\n/**\n * Roll up a store and render it in one call. Returns the structured rows (for\n * machine use) alongside the formatted text table (for the CLI).\n */\nexport function summarize(\n  store: TelemetryStore,\n  opts?: SummarizeOptions,\n): { rows: RollupRow[]; text: string } {\n  const by = opts?.by ?? \"tool\";\n  const filter = opts?.filter ?? {};\n  const rows = store.rollup(by, filter);\n  return { rows, text: formatReport(rows, by) };\n}\n"],"mappings":"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","names":[]}

package/dist/{types-CAKApZpX.d.ts → types-htm_wrWo.d.ts}

@@ -30,18 +30,19 @@ type PlatformId = "claude-code" | "codebuddy" | "codex" | "cursor" | "vscode-cop
  * Hook I/O paradigm — the deepest cross-platform divergence (report §4).
  * Canonical shipped sets (keep in sync with src/adapters/registry.ts — this
  * comment once drifted and seeded a docs-wide misclassification):
- *   - "json-stdio" (19): host pipes JSON to a command on stdin, reads
+ *   - "json-stdio" (24): host pipes JSON to a command on stdin, reads
  *     JSON/exit-code back — Claude Code, CodeBuddy (Tencent, a Claude Code
  *     fork), Codex, Cursor, VS Code/JetBrains Copilot, Copilot CLI, Gemini CLI,
  *     Qwen, Kiro, Kimi, Crush, Goose, Hermes, Droid (Factory), Antigravity (+
- *     the agy CLI), Continue, Amazon Q. One universal entrypoint binary handles
- *     all of them.
+ *     the agy CLI), Continue, Amazon Q, Grok Build, Grok CLI, Devin, Open
+ *     Interpreter (a Codex fork). One universal entrypoint binary handles all of
+ *     them.
  *   - "ts-plugin" (8): host loads a JS/TS module exporting lifecycle functions
  *     — OpenCode, MiMoCode (an OpenCode fork), Kilo CLI, Kilo, OMP, OpenClaw,
  *     NemoClaw (an OpenClaw wrapper/fork), Amp (.amp/plugins/*.ts). Framework
  *     generates the module.
- *   - "mcp-only" (11): no hook layer at all — Warp, Cline, Trae, Zed, Codebuff,
- *     Mux, Pi, Windsurf, Open Interpreter, Junie, Mistral Vibe. Only the MCP
+ *   - "mcp-only" (10): no hook layer at all — Warp, Cline, Trae, Zed, Freebuff,
+ *     Xum, Pi, Windsurf, Junie, Mistral Vibe. Only the MCP
  *     server (or skills surface) is installed; hooks are reported unavailable.
  */
 type HookParadigm = "json-stdio" | "ts-plugin" | "mcp-only";

package/dist/{uninstall-WZHO4CVL.js → uninstall-EJLQGZRN.js}

@@ -5,8 +5,8 @@ import {
   resolveUninstallTargets,
   uninstallConnector,
   uninstallViaMarketplace
-} from "./chunk-LO6NIZSL.js";
-import "./chunk-STR3CRH3.js";
+} from "./chunk-CG44RWYJ.js";
+import "./chunk-C4NDV6GW.js";
 import {
   marketplaceEvidence,
   readMarketplaceInstalls
@@ -22,16 +22,17 @@ import {
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-TCJN5S4T.js";
+} from "./chunk-PTITNBSS.js";
 import "./chunk-GDIAHWNY.js";
-import "./chunk-OXANBA4I.js";
+import "./chunk-ITVST3SZ.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-BGPVMJOG.js";
-import "./chunk-O7CFTOM5.js";
-import "./chunk-QG26JEJF.js";
+} from "./chunk-ZYB2UFEN.js";
+import "./chunk-D35FMUFZ.js";
+import "./chunk-S2TAC22E.js";
+import "./chunk-7C3COFOD.js";
 import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
@@ -183,4 +184,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=uninstall-WZHO4CVL.js.map
+//# sourceMappingURL=uninstall-EJLQGZRN.js.map

package/dist/{uninstall-WZHO4CVL.js.map → uninstall-EJLQGZRN.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/uninstall.ts"],"sourcesContent":["/**\n * cli/commands/uninstall — strip a connector's registrations, method-aware.\n *\n * The connector id is taken from --connector-id, or inferred from the local\n * connector config (--connector <path> / findConnectorConfig).\n *\n * --method auto (default) reverses WHATEVER is actually there, per target:\n * targets with marketplace evidence (the state record, or the host's own plugin\n * state) get the HOST plugin uninstall; everything else gets the existing\n * direct adapter strip. Install chooses a method (a user decision); uninstall\n * reverses what exists (a state decision) — and since the double-install guard\n * enforces exactly one method per (connector, host, scope), auto is\n * unambiguous. Explicit --method direct|marketplace forces one path for every\n * target. Config removal vs plugin uninstall is therefore method-resolved:\n * never both, never neither.\n *\n * --purge additionally removes the framework-state this connector left behind:\n * its DATA-dir connector record (connectorDir(id)), the empty marketplace\n * staging root, and, when no connectors remain, the shared home-bin launcher.\n * Without --purge those linger so the connector can be re-synced without\n * re-registering.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport {\n  purgeFrameworkState,\n  resolveUninstallTargets,\n  uninstallConnector,\n} from \"../../core/installer.js\";\nimport {\n  marketplaceEvidence,\n  parseUninstallMethod,\n  uninstallViaMarketplace,\n} from \"../../core/marketplace.js\";\nimport { readMarketplaceInstalls } from \"../../core/marketplace-state.js\";\nimport { assertConnectorId } from \"../../core/ids.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport type {\n  ConnectorSummary,\n  InstallResult,\n  PlatformId,\n  ResolvedConnector,\n} from \"../../core/types.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\n/**\n * Resolve the connector id from flags, then from a local config file. When the\n * id was inferred by LOADING a config, the resolved connector is returned too so\n * the caller can build a header summary; an explicit `--connector-id` yields no\n * connector (id-only uninstall), and the renderer degrades to an id-only header.\n */\nasync function resolveConnectorId(\n  explicitId: string | undefined,\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<{ id: string; connector?: ResolvedConnector } | null> {\n  if (explicitId && explicitId.trim() !== \"\") return { id: explicitId };\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (!configPath) return null;\n  const { connector } = await loadConnectorFromPath(configPath);\n  return { id: connector.id, connector };\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"auto\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      \"connector-id\": { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      purge: { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const method = parseUninstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use auto|direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const resolved = await resolveConnectorId(\n    values[\"connector-id\"],\n    values.connector,\n    projectDir,\n  );\n  if (!resolved) {\n    return fail(\n      \"could not determine connector id. Pass --connector-id <id>, \" +\n        \"--connector <path>, or run inside a project with an agent-connector config.\",\n    );\n  }\n  const connectorId = resolved.id;\n  // Header summary when a connector config was actually loaded; id-only\n  // (--connector-id) uninstalls have no connector → the renderer degrades to an\n  // id-only header.\n  const summary: ConnectorSummary | undefined = resolved.connector\n    ? buildConnectorSummary(resolved.connector)\n    : undefined;\n\n  // Single choke-point: validate the id BEFORE any path is built or any delete\n  // runs. Every branch below (explicit --method marketplace, --method auto, and\n  // the direct strip) constructs record / staging-root paths from this id —\n  // including the explicit --targets marketplace path, which reaches\n  // driver.finishUninstall(id) → rmSync(join(stagingRoot, id)) without otherwise\n  // routing the raw id through connectorDir's validation. Failing loud here closes\n  // the `--connector-id ../../x` traversal window for ALL of them at once.\n  try {\n    assertConnectorId(connectorId);\n  } catch (err) {\n    return fail(err instanceof Error ? err.message : String(err));\n  }\n\n  const targets = parseTargets(values.targets);\n  const dryRun = values[\"dry-run\"];\n\n  // ── Explicit --method marketplace: every target goes to the marketplace path\n  // (targets default to the recorded installs); framework purge runs here since\n  // no direct pass follows.\n  if (method === \"marketplace\") {\n    const result = await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    if (values.purge) purgeFrameworkState(connectorId, dryRun, result);\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  // ── --method auto: partition the resolved targets by marketplace evidence.\n  // (--method direct keeps every target on the adapter strip — today's path.)\n  let marketplaceTargets: PlatformId[] = [];\n  let directTargets: PlatformId[] = [];\n  if (method === \"auto\") {\n    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);\n    // With no explicit --targets, recorded marketplace platforms are unioned\n    // in: the state record IS the authority for what we installed, and host\n    // detection can miss a host whose probe-able config dir was relocated.\n    // An explicit --targets list is always respected as-is.\n    const recorded = targets\n      ? []\n      : (Object.keys(readMarketplaceInstalls(connectorId)) as PlatformId[]);\n    const candidates = [...new Set([...resolvedTargets, ...recorded])];\n    marketplaceTargets = candidates.filter(\n      (id) => marketplaceEvidence(connectorId, id) != null,\n    );\n    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));\n  }\n\n  // No marketplace evidence anywhere (or --method direct): exactly today's\n  // single-orchestration path, byte-for-byte — zero behavior change for users\n  // who never touched the marketplace method.\n  if (marketplaceTargets.length === 0) {\n    const result = await uninstallConnector({\n      connectorId,\n      scope,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  const results: InstallResult[] = [\n    await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      targets: marketplaceTargets,\n      dryRun,\n      purge: values.purge,\n    }),\n  ];\n\n  // The direct strip runs only for its partition (never both methods on one\n  // target). When every target was marketplace-routed, --purge still runs the\n  // framework purge (the marketplace records were just cleared, so it can\n  // proceed to the connector record + home-bin).\n  if (directTargets.length > 0) {\n    results.push(\n      await uninstallConnector({\n        connectorId,\n        scope,\n        projectDir,\n        dryRun,\n        purge: values.purge,\n        targets: directTargets,\n      }),\n    );\n  } else if (values.purge) {\n    const purgeResult: InstallResult = {\n      connectorId,\n      dryRun,\n      changes: [],\n      warnings: [],\n    };\n    if (dryRun) {\n      // On a real run the marketplace records are removed BEFORE this purge;\n      // calling purgeFrameworkState now would false-refuse on records that the\n      // marketplace pass only PLANNED to remove. Report the plan instead.\n      purgeResult.changes.push({\n        platform: connectorId as PlatformId,\n        action: \"remove\",\n        detail:\n          \"would purge framework state (connector record; home-bin when no connectors remain)\",\n      });\n    } else {\n      purgeFrameworkState(connectorId, dryRun, purgeResult);\n    }\n    results.push(purgeResult);\n  }\n\n  const merged: InstallResult = {\n    connectorId,\n    dryRun,\n    changes: results.flatMap((r) => r.changes),\n    warnings: results.flatMap((r) => r.warnings),\n    connector: summary,\n  };\n  print(renderInstallResult(merged, \"uninstall\"));\n  return merged.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/uninstall.ts"],"sourcesContent":["/**\n * cli/commands/uninstall — strip a connector's registrations, method-aware.\n *\n * The connector id is taken from --connector-id, or inferred from the local\n * connector config (--connector <path> / findConnectorConfig).\n *\n * --method auto (default) reverses WHATEVER is actually there, per target:\n * targets with marketplace evidence (the state record, or the host's own plugin\n * state) get the HOST plugin uninstall; everything else gets the existing\n * direct adapter strip. Install chooses a method (a user decision); uninstall\n * reverses what exists (a state decision) — and since the double-install guard\n * enforces exactly one method per (connector, host, scope), auto is\n * unambiguous. Explicit --method direct|marketplace forces one path for every\n * target. Config removal vs plugin uninstall is therefore method-resolved:\n * never both, never neither.\n *\n * --purge additionally removes the framework-state this connector left behind:\n * its DATA-dir connector record (connectorDir(id)), the empty marketplace\n * staging root, and, when no connectors remain, the shared home-bin launcher.\n * Without --purge those linger so the connector can be re-synced without\n * re-registering.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport {\n  purgeFrameworkState,\n  resolveUninstallTargets,\n  uninstallConnector,\n} from \"../../core/installer.js\";\nimport {\n  marketplaceEvidence,\n  parseUninstallMethod,\n  uninstallViaMarketplace,\n} from \"../../core/marketplace.js\";\nimport { readMarketplaceInstalls } from \"../../core/marketplace-state.js\";\nimport { assertConnectorId } from \"../../core/ids.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport type {\n  ConnectorSummary,\n  InstallResult,\n  PlatformId,\n  ResolvedConnector,\n} from \"../../core/types.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\n/**\n * Resolve the connector id from flags, then from a local config file. When the\n * id was inferred by LOADING a config, the resolved connector is returned too so\n * the caller can build a header summary; an explicit `--connector-id` yields no\n * connector (id-only uninstall), and the renderer degrades to an id-only header.\n */\nasync function resolveConnectorId(\n  explicitId: string | undefined,\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<{ id: string; connector?: ResolvedConnector } | null> {\n  if (explicitId && explicitId.trim() !== \"\") return { id: explicitId };\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (!configPath) return null;\n  const { connector } = await loadConnectorFromPath(configPath);\n  return { id: connector.id, connector };\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"auto\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      \"connector-id\": { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      purge: { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const method = parseUninstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use auto|direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const resolved = await resolveConnectorId(\n    values[\"connector-id\"],\n    values.connector,\n    projectDir,\n  );\n  if (!resolved) {\n    return fail(\n      \"could not determine connector id. Pass --connector-id <id>, \" +\n        \"--connector <path>, or run inside a project with an agent-connector config.\",\n    );\n  }\n  const connectorId = resolved.id;\n  // Header summary when a connector config was actually loaded; id-only\n  // (--connector-id) uninstalls have no connector → the renderer degrades to an\n  // id-only header.\n  const summary: ConnectorSummary | undefined = resolved.connector\n    ? buildConnectorSummary(resolved.connector)\n    : undefined;\n\n  // Single choke-point: validate the id BEFORE any path is built or any delete\n  // runs. Every branch below (explicit --method marketplace, --method auto, and\n  // the direct strip) constructs record / staging-root paths from this id —\n  // including the explicit --targets marketplace path, which reaches\n  // driver.finishUninstall(id) → rmSync(join(stagingRoot, id)) without otherwise\n  // routing the raw id through connectorDir's validation. Failing loud here closes\n  // the `--connector-id ../../x` traversal window for ALL of them at once.\n  try {\n    assertConnectorId(connectorId);\n  } catch (err) {\n    return fail(err instanceof Error ? err.message : String(err));\n  }\n\n  const targets = parseTargets(values.targets);\n  const dryRun = values[\"dry-run\"];\n\n  // ── Explicit --method marketplace: every target goes to the marketplace path\n  // (targets default to the recorded installs); framework purge runs here since\n  // no direct pass follows.\n  if (method === \"marketplace\") {\n    const result = await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    if (values.purge) purgeFrameworkState(connectorId, dryRun, result);\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  // ── --method auto: partition the resolved targets by marketplace evidence.\n  // (--method direct keeps every target on the adapter strip — today's path.)\n  let marketplaceTargets: PlatformId[] = [];\n  let directTargets: PlatformId[] = [];\n  if (method === \"auto\") {\n    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);\n    // With no explicit --targets, recorded marketplace platforms are unioned\n    // in: the state record IS the authority for what we installed, and host\n    // detection can miss a host whose probe-able config dir was relocated.\n    // An explicit --targets list is always respected as-is.\n    const recorded = targets\n      ? []\n      : (Object.keys(readMarketplaceInstalls(connectorId)) as PlatformId[]);\n    const candidates = [...new Set([...resolvedTargets, ...recorded])];\n    marketplaceTargets = candidates.filter(\n      (id) => marketplaceEvidence(connectorId, id) != null,\n    );\n    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));\n  }\n\n  // No marketplace evidence anywhere (or --method direct): exactly today's\n  // single-orchestration path, byte-for-byte — zero behavior change for users\n  // who never touched the marketplace method.\n  if (marketplaceTargets.length === 0) {\n    const result = await uninstallConnector({\n      connectorId,\n      scope,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  const results: InstallResult[] = [\n    await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      targets: marketplaceTargets,\n      dryRun,\n      purge: values.purge,\n    }),\n  ];\n\n  // The direct strip runs only for its partition (never both methods on one\n  // target). When every target was marketplace-routed, --purge still runs the\n  // framework purge (the marketplace records were just cleared, so it can\n  // proceed to the connector record + home-bin).\n  if (directTargets.length > 0) {\n    results.push(\n      await uninstallConnector({\n        connectorId,\n        scope,\n        projectDir,\n        dryRun,\n        purge: values.purge,\n        targets: directTargets,\n      }),\n    );\n  } else if (values.purge) {\n    const purgeResult: InstallResult = {\n      connectorId,\n      dryRun,\n      changes: [],\n      warnings: [],\n    };\n    if (dryRun) {\n      // On a real run the marketplace records are removed BEFORE this purge;\n      // calling purgeFrameworkState now would false-refuse on records that the\n      // marketplace pass only PLANNED to remove. Report the plan instead.\n      purgeResult.changes.push({\n        platform: connectorId as PlatformId,\n        action: \"remove\",\n        detail:\n          \"would purge framework state (connector record; home-bin when no connectors remain)\",\n      });\n    } else {\n      purgeFrameworkState(connectorId, dryRun, purgeResult);\n    }\n    results.push(purgeResult);\n  }\n\n  const merged: InstallResult = {\n    connectorId,\n    dryRun,\n    changes: results.flatMap((r) => r.changes),\n    warnings: results.flatMap((r) => r.warnings),\n    connector: summary,\n  };\n  print(renderInstallResult(merged, \"uninstall\"));\n  return merged.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{upgrade-DZMEUPF2.js → upgrade-ZPHQELKG.js}

@@ -4,8 +4,8 @@ import {
   resolveCliEntry,
   syncConnector,
   upgradeViaMarketplace
-} from "./chunk-LO6NIZSL.js";
-import "./chunk-STR3CRH3.js";
+} from "./chunk-CG44RWYJ.js";
+import "./chunk-C4NDV6GW.js";
 import "./chunk-CWUPIT72.js";
 import "./chunk-KOFCNA5T.js";
 import "./chunk-WAALPWR4.js";
@@ -18,16 +18,17 @@ import {
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-TCJN5S4T.js";
+} from "./chunk-PTITNBSS.js";
 import "./chunk-GDIAHWNY.js";
-import "./chunk-OXANBA4I.js";
+import "./chunk-ITVST3SZ.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-BGPVMJOG.js";
-import "./chunk-O7CFTOM5.js";
-import "./chunk-QG26JEJF.js";
+} from "./chunk-ZYB2UFEN.js";
+import "./chunk-D35FMUFZ.js";
+import "./chunk-S2TAC22E.js";
+import "./chunk-7C3COFOD.js";
 import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
@@ -133,4 +134,4 @@ Refreshed home binary pointer: ${binPath}`);
 export {
   run
 };
-//# sourceMappingURL=upgrade-DZMEUPF2.js.map
+//# sourceMappingURL=upgrade-ZPHQELKG.js.map

package/dist/{upgrade-DZMEUPF2.js.map → upgrade-ZPHQELKG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/upgrade.ts"],"sourcesContent":["/**\n * cli/commands/upgrade — bring an agent-connector install current.\n *\n * `upgrade` (aliases: `update`, `sync`) consolidates the two former verbs into\n * ONE the way npm/brew pair `install` + `upgrade`, so there is a single verb to\n * learn for \"make everything current\". It:\n *\n *   1. re-renders the connector's config into every target host idempotently\n *      (identical entries report \"skip\"), exactly like the old `sync` — this is\n *      also the self-heal path: run `upgrade` to repair a drifted install; then\n *   2. refreshes the stable home-bin pointer and prints managed (never-silent)\n *      update guidance for the chosen channel, exactly like the old `update`.\n *\n * When no connector config is resolvable it still does step 2, so `upgrade`\n * works as a pure tool-refresh from anywhere. By design agent-connector NEVER\n * silently auto-updates (docs/ARCHITECTURE.md §3 R1).\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { resolveCliEntry, syncConnector } from \"../../core/installer.js\";\nimport { parseInstallMethod, upgradeViaMarketplace } from \"../../core/marketplace.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { ensureHomeBin, homeBinPath } from \"../../core/paths.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\ntype Channel = \"stable\" | \"latest\";\n\n/** Heuristic: does the running CLI live under an npm-style node_modules tree? */\nfunction looksNpmManaged(): boolean {\n  const entry = resolveCliEntry().replace(/\\\\/g, \"/\");\n  return entry.includes(\"/node_modules/\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      channel: { type: \"string\", default: \"stable\" },\n      method: { type: \"string\", default: \"direct\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const channel = values.channel;\n  if (channel !== \"stable\" && channel !== \"latest\") {\n    return fail(`invalid --channel \"${channel}\" (use stable|latest)`);\n  }\n  const ch: Channel = channel;\n\n  const method = parseInstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use direct|marketplace)`);\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n  if (method === \"marketplace\" && scope !== \"user\") {\n    return fail(\n      \"--method marketplace supports --scope user only (project-scope plugin installs are deferred)\",\n    );\n  }\n\n  let hadWarn = false;\n\n  // ── Step 1: bring the connector's deploys current (former `sync`):\n  //   direct      — idempotent re-render into every target host.\n  //   marketplace — re-stage the bundle + catalog in place, then drive the\n  //                 host's update verb (claude `plugin update`, with a recorded\n  //                 uninstall+install fallback); warns when connector.version is\n  //                 unchanged since the recorded install (Claude caches a\n  //                 versioned copy, so a same-version update silently no-ops).\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    const { connector, modulePath } = await loadConnectorFromPath(configPath);\n    const targets = parseTargets(values.targets);\n    const opts = {\n      connector,\n      modulePath,\n      scope,\n      projectDir,\n      dryRun: values[\"dry-run\"],\n      ...(targets ? { targets } : {}),\n    };\n    const result =\n      method === \"marketplace\"\n        ? await upgradeViaMarketplace(opts)\n        : await syncConnector(opts);\n    result.connector = buildConnectorSummary(connector);\n    print(renderInstallResult(result, \"upgrade\"));\n    if (result.changes.some((c) => c.action === \"warn\")) hadWarn = true;\n    print(\"\");\n  } else {\n    print(\"upgrade: no connector config found — refreshing the tool only.\");\n    print(\n      \"(pass --connector <path> or run inside a project to also re-render host config.)\\n\",\n    );\n  }\n\n  // ── Step 2: managed update guidance + home-bin pointer refresh (former `update`). ──\n  print(\"agent-connector uses managed (explicit) updates — never silent\");\n  print(\"auto-update — so one bad release can't break every project at once.\\n\");\n\n  const dist = ch === \"stable\" ? \"latest\" : \"next\";\n  if (looksNpmManaged()) {\n    print(`To update the ${ch} channel, run:`);\n    print(`  npm i -g @ken-jo/agent-connector@${dist}`);\n  } else {\n    print(\n      `This install does not look npm-managed. Update it the way you installed it,`,\n    );\n    print(`then re-run \\`agent-connector upgrade\\` to refresh the home pointer.`);\n    print(`(npm installs would use: npm i -g @ken-jo/agent-connector@${dist})`);\n  }\n\n  // Refresh the stable home-bin pointer so hosts keep execing a working CLI.\n  if (!values[\"dry-run\"]) {\n    try {\n      const binPath = ensureHomeBin(resolveCliEntry());\n      print(`\\nRefreshed home binary pointer: ${binPath}`);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      print(`\\n[warn] could not refresh home binary at ${homeBinPath()}: ${message}`);\n      return 1;\n    }\n  }\n\n  return hadWarn ? 1 : 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/upgrade.ts"],"sourcesContent":["/**\n * cli/commands/upgrade — bring an agent-connector install current.\n *\n * `upgrade` (aliases: `update`, `sync`) consolidates the two former verbs into\n * ONE the way npm/brew pair `install` + `upgrade`, so there is a single verb to\n * learn for \"make everything current\". It:\n *\n *   1. re-renders the connector's config into every target host idempotently\n *      (identical entries report \"skip\"), exactly like the old `sync` — this is\n *      also the self-heal path: run `upgrade` to repair a drifted install; then\n *   2. refreshes the stable home-bin pointer and prints managed (never-silent)\n *      update guidance for the chosen channel, exactly like the old `update`.\n *\n * When no connector config is resolvable it still does step 2, so `upgrade`\n * works as a pure tool-refresh from anywhere. By design agent-connector NEVER\n * silently auto-updates (docs/ARCHITECTURE.md §3 R1).\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { resolveCliEntry, syncConnector } from \"../../core/installer.js\";\nimport { parseInstallMethod, upgradeViaMarketplace } from \"../../core/marketplace.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { ensureHomeBin, homeBinPath } from \"../../core/paths.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\ntype Channel = \"stable\" | \"latest\";\n\n/** Heuristic: does the running CLI live under an npm-style node_modules tree? */\nfunction looksNpmManaged(): boolean {\n  const entry = resolveCliEntry().replace(/\\\\/g, \"/\");\n  return entry.includes(\"/node_modules/\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      channel: { type: \"string\", default: \"stable\" },\n      method: { type: \"string\", default: \"direct\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const channel = values.channel;\n  if (channel !== \"stable\" && channel !== \"latest\") {\n    return fail(`invalid --channel \"${channel}\" (use stable|latest)`);\n  }\n  const ch: Channel = channel;\n\n  const method = parseInstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use direct|marketplace)`);\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n  if (method === \"marketplace\" && scope !== \"user\") {\n    return fail(\n      \"--method marketplace supports --scope user only (project-scope plugin installs are deferred)\",\n    );\n  }\n\n  let hadWarn = false;\n\n  // ── Step 1: bring the connector's deploys current (former `sync`):\n  //   direct      — idempotent re-render into every target host.\n  //   marketplace — re-stage the bundle + catalog in place, then drive the\n  //                 host's update verb (claude `plugin update`, with a recorded\n  //                 uninstall+install fallback); warns when connector.version is\n  //                 unchanged since the recorded install (Claude caches a\n  //                 versioned copy, so a same-version update silently no-ops).\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    const { connector, modulePath } = await loadConnectorFromPath(configPath);\n    const targets = parseTargets(values.targets);\n    const opts = {\n      connector,\n      modulePath,\n      scope,\n      projectDir,\n      dryRun: values[\"dry-run\"],\n      ...(targets ? { targets } : {}),\n    };\n    const result =\n      method === \"marketplace\"\n        ? await upgradeViaMarketplace(opts)\n        : await syncConnector(opts);\n    result.connector = buildConnectorSummary(connector);\n    print(renderInstallResult(result, \"upgrade\"));\n    if (result.changes.some((c) => c.action === \"warn\")) hadWarn = true;\n    print(\"\");\n  } else {\n    print(\"upgrade: no connector config found — refreshing the tool only.\");\n    print(\n      \"(pass --connector <path> or run inside a project to also re-render host config.)\\n\",\n    );\n  }\n\n  // ── Step 2: managed update guidance + home-bin pointer refresh (former `update`). ──\n  print(\"agent-connector uses managed (explicit) updates — never silent\");\n  print(\"auto-update — so one bad release can't break every project at once.\\n\");\n\n  const dist = ch === \"stable\" ? \"latest\" : \"next\";\n  if (looksNpmManaged()) {\n    print(`To update the ${ch} channel, run:`);\n    print(`  npm i -g @ken-jo/agent-connector@${dist}`);\n  } else {\n    print(\n      `This install does not look npm-managed. Update it the way you installed it,`,\n    );\n    print(`then re-run \\`agent-connector upgrade\\` to refresh the home pointer.`);\n    print(`(npm installs would use: npm i -g @ken-jo/agent-connector@${dist})`);\n  }\n\n  // Refresh the stable home-bin pointer so hosts keep execing a working CLI.\n  if (!values[\"dry-run\"]) {\n    try {\n      const binPath = ensureHomeBin(resolveCliEntry());\n      print(`\\nRefreshed home binary pointer: ${binPath}`);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      print(`\\n[warn] could not refresh home binary at ${homeBinPath()}: ${message}`);\n      return 1;\n    }\n  }\n\n  return hadWarn ? 1 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{usage-QSM4PP3E.js → usage-IWPGACHN.js}

@@ -11,7 +11,8 @@ import {
 import {
   fail,
   print
-} from "./chunk-TCJN5S4T.js";
+} from "./chunk-PTITNBSS.js";
+import "./chunk-D35FMUFZ.js";
 
 // src/cli/commands/usage.ts
 import { writeFileSync } from "fs";
@@ -321,4 +322,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=usage-QSM4PP3E.js.map
+//# sourceMappingURL=usage-IWPGACHN.js.map

package/dist/{usage-QSM4PP3E.js.map → usage-IWPGACHN.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/usage.ts","../src/usage/report.ts"],"sourcesContent":["/**\n * cli/commands/usage — inspect HOST-native token usage parsed from each agent\n * CLI's own session logs/DBs (the read-only complement to `telemetry`, which\n * measures the MCP server's own bytes — the two are NOT summed: they measure\n * different things).\n *\n * Subcommands:\n *   report  --by platform|project|session|model|day (default platform)\n *           --since 7d|24h|… --platform <id> [--json]\n *           → scanUsage → aggregateBy → formatUsageReport (prints skip notes).\n *   export  --format csv|json (default json)  --out <file>\n *           --since 7d  --platform <id>\n *           → deduped UsageRecord[] to CSV/JSON.\n *\n * Usage rows are aggregate counts only (never raw prompts/results) and the layer\n * is strictly read-only — it parses host logs, it never writes host config.\n */\n\nimport { writeFileSync } from \"node:fs\";\nimport { parseArgs } from \"node:util\";\n\nimport type { PlatformId } from \"../../core/types.js\";\nimport type { UsageGroupBy } from \"../../usage/types.js\";\nimport { aggregateBy } from \"../../usage/aggregate.js\";\nimport { formatUsageReport, usageToCSV, usageToJSON } from \"../../usage/report.js\";\nimport { formatHostLeaderboard, hostLeaderboard } from \"../../usage/leaderboard.js\";\nimport { scanUsage } from \"../../usage/scan.js\";\nimport { fail, print } from \"../app.js\";\n\n/**\n * Parse a relative duration (`Ns`/`Nm`/`Nh`/`Nd`) to a lower-bound epoch ms.\n * Returns undefined for empty input and null for a malformed one. (Mirrors\n * telemetry.ts parseSince — kept local so the two commands stay decoupled.)\n */\nexport function parseSince(since: string | undefined): number | null | undefined {\n  if (since == null || since.trim() === \"\") return undefined;\n  const m = since.trim().match(/^(\\d+)\\s*([smhd])$/i);\n  if (!m || !m[1] || !m[2]) return null;\n  const n = Number(m[1]);\n  const unitMs: Record<string, number> = {\n    s: 1000,\n    m: 60_000,\n    h: 3_600_000,\n    d: 86_400_000,\n  };\n  const factor = unitMs[m[2].toLowerCase()];\n  if (factor == null) return null;\n  return Date.now() - n * factor;\n}\n\nconst GROUP_BY_VALUES: ReadonlySet<string> = new Set([\n  \"platform\",\n  \"project\",\n  \"session\",\n  \"model\",\n  \"day\",\n]);\n\n/** Build the scan options shared by report/export from --since / --platform. */\nfunction buildScanOpts(\n  since: string | undefined,\n  platform: string | undefined,\n): { sinceMs?: number; platforms?: PlatformId[] } | null {\n  const sinceMs = parseSince(since);\n  if (sinceMs === null) return null;\n  const opts: { sinceMs?: number; platforms?: PlatformId[] } = {};\n  if (sinceMs !== undefined) opts.sinceMs = sinceMs;\n  if (platform && platform.trim() !== \"\") opts.platforms = [platform.trim() as PlatformId];\n  return opts;\n}\n\nasync function runReport(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"platform\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (!GROUP_BY_VALUES.has(by ?? \"\")) {\n    return fail(`invalid --by \"${by}\" (use platform|project|session|model|day)`);\n  }\n  const dimension = by as UsageGroupBy;\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const { records, skipped } = await scanUsage(scanOpts);\n  const rows = aggregateBy(records, dimension);\n\n  if (values.json) {\n    print(JSON.stringify({ by: dimension, rows, skipped }, null, 2));\n  } else {\n    print(formatUsageReport(rows, dimension, skipped));\n  }\n  return 0;\n}\n\nasync function runExport(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      format: { type: \"string\", default: \"json\" },\n      out: { type: \"string\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n    },\n    allowPositionals: false,\n  });\n\n  const format = values.format;\n  if (format !== \"csv\" && format !== \"json\") {\n    return fail(`invalid --format \"${format}\" (use csv|json)`);\n  }\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const { records } = await scanUsage(scanOpts);\n  const serialized = format === \"csv\" ? usageToCSV(records) : usageToJSON(records);\n\n  if (values.out && values.out.trim() !== \"\") {\n    writeFileSync(values.out, serialized, \"utf8\");\n    print(`wrote ${format.toUpperCase()} export → ${values.out}`);\n  } else {\n    print(serialized);\n  }\n  return 0;\n}\n\n/**\n * `usage leaderboard` — the HOST / USER leaderboard: rank host usage by platform\n * (--by platform, the default \"which CLI/host spent the most\") or by model\n * (--by model). Honors --since / --platform; notes synced/host-estimated rows.\n */\nasync function runLeaderboard(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"platform\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"platform\" && by !== \"model\") {\n    return fail(`invalid --by \"${by}\" (use platform|model)`);\n  }\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const lbOpts: { by: \"platform\" | \"model\"; sinceMs?: number; platforms?: PlatformId[] } = {\n    by,\n  };\n  if (scanOpts.sinceMs !== undefined) lbOpts.sinceMs = scanOpts.sinceMs;\n  if (scanOpts.platforms !== undefined) lbOpts.platforms = scanOpts.platforms;\n\n  const result = await hostLeaderboard(lbOpts);\n\n  if (values.json) {\n    print(JSON.stringify({ by: result.by, rows: result.rows, skipped: result.skipped }, null, 2));\n  } else {\n    print(formatHostLeaderboard(result));\n  }\n  return 0;\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const sub = argv[0];\n  const rest = argv.slice(1);\n\n  switch (sub) {\n    case \"report\":\n      return runReport(rest);\n    case \"export\":\n      return runExport(rest);\n    case \"leaderboard\":\n      return runLeaderboard(rest);\n    case undefined:\n    case \"--help\":\n    case \"-h\":\n      print(\"usage: agent-connector usage <report|export|leaderboard> [flags]\");\n      print(\"  report       --by platform|project|session|model|day  --since 7d  --platform <id>  --json\");\n      print(\"  export       --format csv|json  --out <file>  --since 7d  --platform <id>\");\n      print(\"  leaderboard  --by platform|model  --since 7d  --platform <id>  --json\");\n      return sub === undefined ? 1 : 0;\n    default:\n      return fail(`unknown usage subcommand \"${sub}\" (use report|export|leaderboard)`);\n  }\n}\n","/**\n * usage/report — CLI-facing formatting for host usage rollups and exports.\n *\n * Pure functions, mirroring telemetry/report.ts: an aligned text table with a\n * TOTAL footer and an honesty legend, plus CSV/JSON serializers for raw records.\n * Confidence is surfaced verbatim so a host-estimated row is never read as exact\n * host-reported usage; a footer note also explains synced-but-uncached platforms.\n */\n\nimport type {\n  UsageGroupBy,\n  UsageRecord,\n  UsageSummary,\n} from \"./types.js\";\nimport type { SkippedPlatform } from \"./scan.js\";\nimport { sumTokens } from \"./aggregate.js\";\n\n/** Human label for the leading KEY column, per grouping dimension. */\nconst KEY_HEADER: Record<UsageGroupBy, string> = {\n  platform: \"PLATFORM\",\n  project: \"PROJECT\",\n  session: \"SESSION\",\n  model: \"MODEL\",\n  day: \"DAY\",\n};\n\n/** Compact integer formatting with thousands separators. */\nfunction fmtInt(n: number): string {\n  return n.toLocaleString(\"en-US\");\n}\n\n/** Right-pad (left-aligned columns). */\nfunction padRight(s: string, width: number): string {\n  return s.length >= width ? s : s + \" \".repeat(width - s.length);\n}\n\n/** Left-pad (right-aligned numeric columns). */\nfunction padLeft(s: string, width: number): string {\n  return s.length >= width ? s : \" \".repeat(width - s.length) + s;\n}\n\n/**\n * Render an aligned table of usage rows (already aggregated). Columns:\n *   KEY | IN | OUT | CACHE_R | CACHE_W | REASON | TOTAL | SESS | CONF\n * with a TOTAL footer (worst confidence across rows) and an honesty legend.\n * Optionally appends notes for platforms the scan skipped.\n */\nexport function formatUsageReport(\n  rows: UsageSummary[],\n  by: UsageGroupBy,\n  skipped: SkippedPlatform[] = [],\n): string {\n  const keyHeader = KEY_HEADER[by];\n  const headers = [\n    keyHeader,\n    \"IN\",\n    \"OUT\",\n    \"CACHE_R\",\n    \"CACHE_W\",\n    \"REASON\",\n    \"TOTAL\",\n    \"SESS\",\n    \"CONF\",\n  ];\n\n  const sorted = [...rows].sort((a, b) => b.total - a.total || b.lastTs - a.lastTs);\n\n  const dataRows = sorted.map((r) => [\n    r.key,\n    fmtInt(r.tokens.input),\n    fmtInt(r.tokens.output),\n    fmtInt(r.tokens.cacheRead),\n    fmtInt(r.tokens.cacheWrite),\n    fmtInt(r.tokens.reasoning),\n    fmtInt(r.total),\n    fmtInt(r.sessions),\n    r.confidence,\n  ]);\n\n  // Totals + worst confidence across all rows.\n  const totals = sorted.reduce(\n    (acc, r) => {\n      acc.input += r.tokens.input;\n      acc.output += r.tokens.output;\n      acc.cacheRead += r.tokens.cacheRead;\n      acc.cacheWrite += r.tokens.cacheWrite;\n      acc.reasoning += r.tokens.reasoning;\n      acc.total += r.total;\n      acc.sessions += r.sessions;\n      return acc;\n    },\n    { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0, sessions: 0 },\n  );\n  const totalRow = [\n    \"TOTAL\",\n    fmtInt(totals.input),\n    fmtInt(totals.output),\n    fmtInt(totals.cacheRead),\n    fmtInt(totals.cacheWrite),\n    fmtInt(totals.reasoning),\n    fmtInt(totals.total),\n    fmtInt(totals.sessions),\n    \"\",\n  ];\n\n  const widths = headers.map((h, col) => {\n    let w = h.length;\n    for (const row of dataRows) w = Math.max(w, (row[col] ?? \"\").length);\n    w = Math.max(w, (totalRow[col] ?? \"\").length);\n    return w;\n  });\n\n  const renderRow = (cells: string[]): string =>\n    cells\n      .map((c, col) => (col === 0 ? padRight(c, widths[col] ?? 0) : padLeft(c, widths[col] ?? 0)))\n      .join(\"  \")\n      .trimEnd();\n\n  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);\n  const rule = \"-\".repeat(ruleWidth);\n\n  const lines: string[] = [];\n  lines.push(renderRow(headers));\n  lines.push(rule);\n  if (dataRows.length === 0) {\n    lines.push(\"(no host usage found)\");\n  } else {\n    for (const row of dataRows) lines.push(renderRow(row));\n  }\n  lines.push(rule);\n  lines.push(renderRow(totalRow));\n\n  // Honesty legend — estimated rows and skipped synced platforms.\n  const hasEstimate = sorted.some((r) => r.confidence === \"host-estimated\");\n  if (hasEstimate) {\n    lines.push(\"\");\n    lines.push(\n      \"note: host-estimated rows are derived (e.g. char/4 or cost-only), \" +\n        \"not exact host-reported token counts.\",\n    );\n  }\n  if (skipped.length > 0) {\n    lines.push(\"\");\n    lines.push(\"skipped:\");\n    for (const s of skipped) lines.push(`  - ${s.platformId}: ${s.reason}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Exports (raw deduped records)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Ordered CSV columns (flattening the token breakdown into separate fields). */\nconst CSV_COLUMNS = [\n  \"platformId\",\n  \"modelId\",\n  \"providerId\",\n  \"sessionId\",\n  \"projectKey\",\n  \"projectLabel\",\n  \"input\",\n  \"output\",\n  \"cacheRead\",\n  \"cacheWrite\",\n  \"reasoning\",\n  \"total\",\n  \"cost\",\n  \"ts\",\n  \"messageCount\",\n  \"confidence\",\n  \"agent\",\n] as const;\n\n/** RFC-4180-ish escaping: quote a cell holding a comma, quote, or newline. */\nfunction csvCell(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  const s = String(value);\n  if (/[\",\\n\\r]/.test(s)) return `\"${s.replace(/\"/g, '\"\"')}\"`;\n  return s;\n}\n\n/** Flatten one record into the CSV column order. */\nfunction recordRow(r: UsageRecord): unknown[] {\n  return [\n    r.platformId,\n    r.modelId,\n    r.providerId,\n    r.sessionId,\n    r.projectKey,\n    r.projectLabel,\n    r.tokens.input,\n    r.tokens.output,\n    r.tokens.cacheRead,\n    r.tokens.cacheWrite,\n    r.tokens.reasoning,\n    sumTokens(r.tokens),\n    r.cost,\n    r.ts,\n    r.messageCount,\n    r.confidence,\n    r.agent,\n  ];\n}\n\n/** Serialize raw records to CSV (header + one CRLF-terminated line per record). */\nexport function usageToCSV(records: UsageRecord[]): string {\n  const lines: string[] = [];\n  lines.push(CSV_COLUMNS.join(\",\"));\n  for (const r of records) {\n    lines.push(recordRow(r).map(csvCell).join(\",\"));\n  }\n  return lines.join(\"\\r\\n\");\n}\n\n/** Serialize raw records to a pretty-printed JSON array string. */\nexport function usageToJSON(records: UsageRecord[]): string {\n  return JSON.stringify(records, null, 2);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/usage.ts","../src/usage/report.ts"],"sourcesContent":["/**\n * cli/commands/usage — inspect HOST-native token usage parsed from each agent\n * CLI's own session logs/DBs (the read-only complement to `telemetry`, which\n * measures the MCP server's own bytes — the two are NOT summed: they measure\n * different things).\n *\n * Subcommands:\n *   report  --by platform|project|session|model|day (default platform)\n *           --since 7d|24h|… --platform <id> [--json]\n *           → scanUsage → aggregateBy → formatUsageReport (prints skip notes).\n *   export  --format csv|json (default json)  --out <file>\n *           --since 7d  --platform <id>\n *           → deduped UsageRecord[] to CSV/JSON.\n *\n * Usage rows are aggregate counts only (never raw prompts/results) and the layer\n * is strictly read-only — it parses host logs, it never writes host config.\n */\n\nimport { writeFileSync } from \"node:fs\";\nimport { parseArgs } from \"node:util\";\n\nimport type { PlatformId } from \"../../core/types.js\";\nimport type { UsageGroupBy } from \"../../usage/types.js\";\nimport { aggregateBy } from \"../../usage/aggregate.js\";\nimport { formatUsageReport, usageToCSV, usageToJSON } from \"../../usage/report.js\";\nimport { formatHostLeaderboard, hostLeaderboard } from \"../../usage/leaderboard.js\";\nimport { scanUsage } from \"../../usage/scan.js\";\nimport { fail, print } from \"../app.js\";\n\n/**\n * Parse a relative duration (`Ns`/`Nm`/`Nh`/`Nd`) to a lower-bound epoch ms.\n * Returns undefined for empty input and null for a malformed one. (Mirrors\n * telemetry.ts parseSince — kept local so the two commands stay decoupled.)\n */\nexport function parseSince(since: string | undefined): number | null | undefined {\n  if (since == null || since.trim() === \"\") return undefined;\n  const m = since.trim().match(/^(\\d+)\\s*([smhd])$/i);\n  if (!m || !m[1] || !m[2]) return null;\n  const n = Number(m[1]);\n  const unitMs: Record<string, number> = {\n    s: 1000,\n    m: 60_000,\n    h: 3_600_000,\n    d: 86_400_000,\n  };\n  const factor = unitMs[m[2].toLowerCase()];\n  if (factor == null) return null;\n  return Date.now() - n * factor;\n}\n\nconst GROUP_BY_VALUES: ReadonlySet<string> = new Set([\n  \"platform\",\n  \"project\",\n  \"session\",\n  \"model\",\n  \"day\",\n]);\n\n/** Build the scan options shared by report/export from --since / --platform. */\nfunction buildScanOpts(\n  since: string | undefined,\n  platform: string | undefined,\n): { sinceMs?: number; platforms?: PlatformId[] } | null {\n  const sinceMs = parseSince(since);\n  if (sinceMs === null) return null;\n  const opts: { sinceMs?: number; platforms?: PlatformId[] } = {};\n  if (sinceMs !== undefined) opts.sinceMs = sinceMs;\n  if (platform && platform.trim() !== \"\") opts.platforms = [platform.trim() as PlatformId];\n  return opts;\n}\n\nasync function runReport(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"platform\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (!GROUP_BY_VALUES.has(by ?? \"\")) {\n    return fail(`invalid --by \"${by}\" (use platform|project|session|model|day)`);\n  }\n  const dimension = by as UsageGroupBy;\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const { records, skipped } = await scanUsage(scanOpts);\n  const rows = aggregateBy(records, dimension);\n\n  if (values.json) {\n    print(JSON.stringify({ by: dimension, rows, skipped }, null, 2));\n  } else {\n    print(formatUsageReport(rows, dimension, skipped));\n  }\n  return 0;\n}\n\nasync function runExport(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      format: { type: \"string\", default: \"json\" },\n      out: { type: \"string\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n    },\n    allowPositionals: false,\n  });\n\n  const format = values.format;\n  if (format !== \"csv\" && format !== \"json\") {\n    return fail(`invalid --format \"${format}\" (use csv|json)`);\n  }\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const { records } = await scanUsage(scanOpts);\n  const serialized = format === \"csv\" ? usageToCSV(records) : usageToJSON(records);\n\n  if (values.out && values.out.trim() !== \"\") {\n    writeFileSync(values.out, serialized, \"utf8\");\n    print(`wrote ${format.toUpperCase()} export → ${values.out}`);\n  } else {\n    print(serialized);\n  }\n  return 0;\n}\n\n/**\n * `usage leaderboard` — the HOST / USER leaderboard: rank host usage by platform\n * (--by platform, the default \"which CLI/host spent the most\") or by model\n * (--by model). Honors --since / --platform; notes synced/host-estimated rows.\n */\nasync function runLeaderboard(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      by: { type: \"string\", default: \"platform\" },\n      since: { type: \"string\" },\n      platform: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const by = values.by;\n  if (by !== \"platform\" && by !== \"model\") {\n    return fail(`invalid --by \"${by}\" (use platform|model)`);\n  }\n\n  const scanOpts = buildScanOpts(values.since, values.platform);\n  if (scanOpts === null) {\n    return fail(`invalid --since \"${values.since}\" (use forms like 30s, 15m, 24h, 7d)`);\n  }\n\n  const lbOpts: { by: \"platform\" | \"model\"; sinceMs?: number; platforms?: PlatformId[] } = {\n    by,\n  };\n  if (scanOpts.sinceMs !== undefined) lbOpts.sinceMs = scanOpts.sinceMs;\n  if (scanOpts.platforms !== undefined) lbOpts.platforms = scanOpts.platforms;\n\n  const result = await hostLeaderboard(lbOpts);\n\n  if (values.json) {\n    print(JSON.stringify({ by: result.by, rows: result.rows, skipped: result.skipped }, null, 2));\n  } else {\n    print(formatHostLeaderboard(result));\n  }\n  return 0;\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const sub = argv[0];\n  const rest = argv.slice(1);\n\n  switch (sub) {\n    case \"report\":\n      return runReport(rest);\n    case \"export\":\n      return runExport(rest);\n    case \"leaderboard\":\n      return runLeaderboard(rest);\n    case undefined:\n    case \"--help\":\n    case \"-h\":\n      print(\"usage: agent-connector usage <report|export|leaderboard> [flags]\");\n      print(\"  report       --by platform|project|session|model|day  --since 7d  --platform <id>  --json\");\n      print(\"  export       --format csv|json  --out <file>  --since 7d  --platform <id>\");\n      print(\"  leaderboard  --by platform|model  --since 7d  --platform <id>  --json\");\n      return sub === undefined ? 1 : 0;\n    default:\n      return fail(`unknown usage subcommand \"${sub}\" (use report|export|leaderboard)`);\n  }\n}\n","/**\n * usage/report — CLI-facing formatting for host usage rollups and exports.\n *\n * Pure functions, mirroring telemetry/report.ts: an aligned text table with a\n * TOTAL footer and an honesty legend, plus CSV/JSON serializers for raw records.\n * Confidence is surfaced verbatim so a host-estimated row is never read as exact\n * host-reported usage; a footer note also explains synced-but-uncached platforms.\n */\n\nimport type {\n  UsageGroupBy,\n  UsageRecord,\n  UsageSummary,\n} from \"./types.js\";\nimport type { SkippedPlatform } from \"./scan.js\";\nimport { sumTokens } from \"./aggregate.js\";\n\n/** Human label for the leading KEY column, per grouping dimension. */\nconst KEY_HEADER: Record<UsageGroupBy, string> = {\n  platform: \"PLATFORM\",\n  project: \"PROJECT\",\n  session: \"SESSION\",\n  model: \"MODEL\",\n  day: \"DAY\",\n};\n\n/** Compact integer formatting with thousands separators. */\nfunction fmtInt(n: number): string {\n  return n.toLocaleString(\"en-US\");\n}\n\n/** Right-pad (left-aligned columns). */\nfunction padRight(s: string, width: number): string {\n  return s.length >= width ? s : s + \" \".repeat(width - s.length);\n}\n\n/** Left-pad (right-aligned numeric columns). */\nfunction padLeft(s: string, width: number): string {\n  return s.length >= width ? s : \" \".repeat(width - s.length) + s;\n}\n\n/**\n * Render an aligned table of usage rows (already aggregated). Columns:\n *   KEY | IN | OUT | CACHE_R | CACHE_W | REASON | TOTAL | SESS | CONF\n * with a TOTAL footer (worst confidence across rows) and an honesty legend.\n * Optionally appends notes for platforms the scan skipped.\n */\nexport function formatUsageReport(\n  rows: UsageSummary[],\n  by: UsageGroupBy,\n  skipped: SkippedPlatform[] = [],\n): string {\n  const keyHeader = KEY_HEADER[by];\n  const headers = [\n    keyHeader,\n    \"IN\",\n    \"OUT\",\n    \"CACHE_R\",\n    \"CACHE_W\",\n    \"REASON\",\n    \"TOTAL\",\n    \"SESS\",\n    \"CONF\",\n  ];\n\n  const sorted = [...rows].sort((a, b) => b.total - a.total || b.lastTs - a.lastTs);\n\n  const dataRows = sorted.map((r) => [\n    r.key,\n    fmtInt(r.tokens.input),\n    fmtInt(r.tokens.output),\n    fmtInt(r.tokens.cacheRead),\n    fmtInt(r.tokens.cacheWrite),\n    fmtInt(r.tokens.reasoning),\n    fmtInt(r.total),\n    fmtInt(r.sessions),\n    r.confidence,\n  ]);\n\n  // Totals + worst confidence across all rows.\n  const totals = sorted.reduce(\n    (acc, r) => {\n      acc.input += r.tokens.input;\n      acc.output += r.tokens.output;\n      acc.cacheRead += r.tokens.cacheRead;\n      acc.cacheWrite += r.tokens.cacheWrite;\n      acc.reasoning += r.tokens.reasoning;\n      acc.total += r.total;\n      acc.sessions += r.sessions;\n      return acc;\n    },\n    { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0, sessions: 0 },\n  );\n  const totalRow = [\n    \"TOTAL\",\n    fmtInt(totals.input),\n    fmtInt(totals.output),\n    fmtInt(totals.cacheRead),\n    fmtInt(totals.cacheWrite),\n    fmtInt(totals.reasoning),\n    fmtInt(totals.total),\n    fmtInt(totals.sessions),\n    \"\",\n  ];\n\n  const widths = headers.map((h, col) => {\n    let w = h.length;\n    for (const row of dataRows) w = Math.max(w, (row[col] ?? \"\").length);\n    w = Math.max(w, (totalRow[col] ?? \"\").length);\n    return w;\n  });\n\n  const renderRow = (cells: string[]): string =>\n    cells\n      .map((c, col) => (col === 0 ? padRight(c, widths[col] ?? 0) : padLeft(c, widths[col] ?? 0)))\n      .join(\"  \")\n      .trimEnd();\n\n  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);\n  const rule = \"-\".repeat(ruleWidth);\n\n  const lines: string[] = [];\n  lines.push(renderRow(headers));\n  lines.push(rule);\n  if (dataRows.length === 0) {\n    lines.push(\"(no host usage found)\");\n  } else {\n    for (const row of dataRows) lines.push(renderRow(row));\n  }\n  lines.push(rule);\n  lines.push(renderRow(totalRow));\n\n  // Honesty legend — estimated rows and skipped synced platforms.\n  const hasEstimate = sorted.some((r) => r.confidence === \"host-estimated\");\n  if (hasEstimate) {\n    lines.push(\"\");\n    lines.push(\n      \"note: host-estimated rows are derived (e.g. char/4 or cost-only), \" +\n        \"not exact host-reported token counts.\",\n    );\n  }\n  if (skipped.length > 0) {\n    lines.push(\"\");\n    lines.push(\"skipped:\");\n    for (const s of skipped) lines.push(`  - ${s.platformId}: ${s.reason}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Exports (raw deduped records)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Ordered CSV columns (flattening the token breakdown into separate fields). */\nconst CSV_COLUMNS = [\n  \"platformId\",\n  \"modelId\",\n  \"providerId\",\n  \"sessionId\",\n  \"projectKey\",\n  \"projectLabel\",\n  \"input\",\n  \"output\",\n  \"cacheRead\",\n  \"cacheWrite\",\n  \"reasoning\",\n  \"total\",\n  \"cost\",\n  \"ts\",\n  \"messageCount\",\n  \"confidence\",\n  \"agent\",\n] as const;\n\n/** RFC-4180-ish escaping: quote a cell holding a comma, quote, or newline. */\nfunction csvCell(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  const s = String(value);\n  if (/[\",\\n\\r]/.test(s)) return `\"${s.replace(/\"/g, '\"\"')}\"`;\n  return s;\n}\n\n/** Flatten one record into the CSV column order. */\nfunction recordRow(r: UsageRecord): unknown[] {\n  return [\n    r.platformId,\n    r.modelId,\n    r.providerId,\n    r.sessionId,\n    r.projectKey,\n    r.projectLabel,\n    r.tokens.input,\n    r.tokens.output,\n    r.tokens.cacheRead,\n    r.tokens.cacheWrite,\n    r.tokens.reasoning,\n    sumTokens(r.tokens),\n    r.cost,\n    r.ts,\n    r.messageCount,\n    r.confidence,\n    r.agent,\n  ];\n}\n\n/** Serialize raw records to CSV (header + one CRLF-terminated line per record). */\nexport function usageToCSV(records: UsageRecord[]): string {\n  const lines: string[] = [];\n  lines.push(CSV_COLUMNS.join(\",\"));\n  for (const r of records) {\n    lines.push(recordRow(r).map(csvCell).join(\",\"));\n  }\n  return lines.join(\"\\r\\n\");\n}\n\n/** Serialize raw records to a pretty-printed JSON array string. */\nexport function usageToJSON(records: UsageRecord[]): string {\n  return JSON.stringify(records, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB;;;ACD1B,IAAM,aAA2C;AAAA,EAC/C,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AAAA,EACP,KAAK;AACP;AAGA,SAAS,OAAO,GAAmB;AACjC,SAAO,EAAE,eAAe,OAAO;AACjC;AAGA,SAAS,SAAS,GAAW,OAAuB;AAClD,SAAO,EAAE,UAAU,QAAQ,IAAI,IAAI,IAAI,OAAO,QAAQ,EAAE,MAAM;AAChE;AAGA,SAAS,QAAQ,GAAW,OAAuB;AACjD,SAAO,EAAE,UAAU,QAAQ,IAAI,IAAI,OAAO,QAAQ,EAAE,MAAM,IAAI;AAChE;AAQO,SAAS,kBACd,MACA,IACA,UAA6B,CAAC,GACtB;AACR,QAAM,YAAY,WAAW,EAAE;AAC/B,QAAM,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;AAEhF,QAAM,WAAW,OAAO,IAAI,CAAC,MAAM;AAAA,IACjC,EAAE;AAAA,IACF,OAAO,EAAE,OAAO,KAAK;AAAA,IACrB,OAAO,EAAE,OAAO,MAAM;AAAA,IACtB,OAAO,EAAE,OAAO,SAAS;AAAA,IACzB,OAAO,EAAE,OAAO,UAAU;AAAA,IAC1B,OAAO,EAAE,OAAO,SAAS;AAAA,IACzB,OAAO,EAAE,KAAK;AAAA,IACd,OAAO,EAAE,QAAQ;AAAA,IACjB,EAAE;AAAA,EACJ,CAAC;AAGD,QAAM,SAAS,OAAO;AAAA,IACpB,CAAC,KAAK,MAAM;AACV,UAAI,SAAS,EAAE,OAAO;AACtB,UAAI,UAAU,EAAE,OAAO;AACvB,UAAI,aAAa,EAAE,OAAO;AAC1B,UAAI,cAAc,EAAE,OAAO;AAC3B,UAAI,aAAa,EAAE,OAAO;AAC1B,UAAI,SAAS,EAAE;AACf,UAAI,YAAY,EAAE;AAClB,aAAO;AAAA,IACT;AAAA,IACA,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,EAAE;AAAA,EAC1F;AACA,QAAM,WAAW;AAAA,IACf;AAAA,IACA,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,MAAM;AAAA,IACpB,OAAO,OAAO,SAAS;AAAA,IACvB,OAAO,OAAO,UAAU;AAAA,IACxB,OAAO,OAAO,SAAS;AAAA,IACvB,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,QAAQ;AAAA,IACtB;AAAA,EACF;AAEA,QAAM,SAAS,QAAQ,IAAI,CAAC,GAAG,QAAQ;AACrC,QAAI,IAAI,EAAE;AACV,eAAW,OAAO,SAAU,KAAI,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,IAAI,MAAM;AACnE,QAAI,KAAK,IAAI,IAAI,SAAS,GAAG,KAAK,IAAI,MAAM;AAC5C,WAAO;AAAA,EACT,CAAC;AAED,QAAM,YAAY,CAAC,UACjB,MACG,IAAI,CAAC,GAAG,QAAS,QAAQ,IAAI,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC,IAAI,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC,CAAE,EAC1F,KAAK,IAAI,EACT,QAAQ;AAEb,QAAM,YAAY,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,SAAS;AAC3E,QAAM,OAAO,IAAI,OAAO,SAAS;AAEjC,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,UAAU,OAAO,CAAC;AAC7B,QAAM,KAAK,IAAI;AACf,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,KAAK,uBAAuB;AAAA,EACpC,OAAO;AACL,eAAW,OAAO,SAAU,OAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvD;AACA,QAAM,KAAK,IAAI;AACf,QAAM,KAAK,UAAU,QAAQ,CAAC;AAG9B,QAAM,cAAc,OAAO,KAAK,CAAC,MAAM,EAAE,eAAe,gBAAgB;AACxE,MAAI,aAAa;AACf,UAAM,KAAK,EAAE;AACb,UAAM;AAAA,MACJ;AAAA,IAEF;AAAA,EACF;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,UAAU;AACrB,eAAW,KAAK,QAAS,OAAM,KAAK,OAAO,EAAE,UAAU,KAAK,EAAE,MAAM,EAAE;AAAA,EACxE;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAOA,IAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,SAAS,QAAQ,OAAwB;AACvC,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,QAAM,IAAI,OAAO,KAAK;AACtB,MAAI,WAAW,KAAK,CAAC,EAAG,QAAO,IAAI,EAAE,QAAQ,MAAM,IAAI,CAAC;AACxD,SAAO;AACT;AAGA,SAAS,UAAU,GAA2B;AAC5C,SAAO;AAAA,IACL,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,IACT,UAAU,EAAE,MAAM;AAAA,IAClB,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,IACF,EAAE;AAAA,EACJ;AACF;AAGO,SAAS,WAAW,SAAgC;AACzD,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,YAAY,KAAK,GAAG,CAAC;AAChC,aAAW,KAAK,SAAS;AACvB,UAAM,KAAK,UAAU,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,GAAG,CAAC;AAAA,EAChD;AACA,SAAO,MAAM,KAAK,MAAM;AAC1B;AAGO,SAAS,YAAY,SAAgC;AAC1D,SAAO,KAAK,UAAU,SAAS,MAAM,CAAC;AACxC;;;ADzLO,SAAS,WAAW,OAAsD;AAC/E,MAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,QAAM,IAAI,MAAM,KAAK,EAAE,MAAM,qBAAqB;AAClD,MAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAG,QAAO;AACjC,QAAM,IAAI,OAAO,EAAE,CAAC,CAAC;AACrB,QAAM,SAAiC;AAAA,IACrC,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACA,QAAM,SAAS,OAAO,EAAE,CAAC,EAAE,YAAY,CAAC;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,KAAK,IAAI,IAAI,IAAI;AAC1B;AAEA,IAAM,kBAAuC,oBAAI,IAAI;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGD,SAAS,cACP,OACA,UACuD;AACvD,QAAM,UAAU,WAAW,KAAK;AAChC,MAAI,YAAY,KAAM,QAAO;AAC7B,QAAM,OAAuD,CAAC;AAC9D,MAAI,YAAY,OAAW,MAAK,UAAU;AAC1C,MAAI,YAAY,SAAS,KAAK,MAAM,GAAI,MAAK,YAAY,CAAC,SAAS,KAAK,CAAe;AACvF,SAAO;AACT;AAEA,eAAe,UAAU,MAAiC;AACxD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,IAAI,EAAE,MAAM,UAAU,SAAS,WAAW;AAAA,MAC1C,OAAO,EAAE,MAAM,SAAS;AAAA,MACxB,UAAU,EAAE,MAAM,SAAS;AAAA,MAC3B,MAAM,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC1C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,KAAK,OAAO;AAClB,MAAI,CAAC,gBAAgB,IAAI,MAAM,EAAE,GAAG;AAClC,WAAO,KAAK,iBAAiB,EAAE,4CAA4C;AAAA,EAC7E;AACA,QAAM,YAAY;AAElB,QAAM,WAAW,cAAc,OAAO,OAAO,OAAO,QAAQ;AAC5D,MAAI,aAAa,MAAM;AACrB,WAAO,KAAK,oBAAoB,OAAO,KAAK,sCAAsC;AAAA,EACpF;AAEA,QAAM,EAAE,SAAS,QAAQ,IAAI,MAAM,UAAU,QAAQ;AACrD,QAAM,OAAO,YAAY,SAAS,SAAS;AAE3C,MAAI,OAAO,MAAM;AACf,UAAM,KAAK,UAAU,EAAE,IAAI,WAAW,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC;AAAA,EACjE,OAAO;AACL,UAAM,kBAAkB,MAAM,WAAW,OAAO,CAAC;AAAA,EACnD;AACA,SAAO;AACT;AAEA,eAAe,UAAU,MAAiC;AACxD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,QAAQ,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MAC1C,KAAK,EAAE,MAAM,SAAS;AAAA,MACtB,OAAO,EAAE,MAAM,SAAS;AAAA,MACxB,UAAU,EAAE,MAAM,SAAS;AAAA,IAC7B;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,SAAS,OAAO;AACtB,MAAI,WAAW,SAAS,WAAW,QAAQ;AACzC,WAAO,KAAK,qBAAqB,MAAM,kBAAkB;AAAA,EAC3D;AAEA,QAAM,WAAW,cAAc,OAAO,OAAO,OAAO,QAAQ;AAC5D,MAAI,aAAa,MAAM;AACrB,WAAO,KAAK,oBAAoB,OAAO,KAAK,sCAAsC;AAAA,EACpF;AAEA,QAAM,EAAE,QAAQ,IAAI,MAAM,UAAU,QAAQ;AAC5C,QAAM,aAAa,WAAW,QAAQ,WAAW,OAAO,IAAI,YAAY,OAAO;AAE/E,MAAI,OAAO,OAAO,OAAO,IAAI,KAAK,MAAM,IAAI;AAC1C,kBAAc,OAAO,KAAK,YAAY,MAAM;AAC5C,UAAM,SAAS,OAAO,YAAY,CAAC,kBAAa,OAAO,GAAG,EAAE;AAAA,EAC9D,OAAO;AACL,UAAM,UAAU;AAAA,EAClB;AACA,SAAO;AACT;AAOA,eAAe,eAAe,MAAiC;AAC7D,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,IAAI,EAAE,MAAM,UAAU,SAAS,WAAW;AAAA,MAC1C,OAAO,EAAE,MAAM,SAAS;AAAA,MACxB,UAAU,EAAE,MAAM,SAAS;AAAA,MAC3B,MAAM,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC1C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,KAAK,OAAO;AAClB,MAAI,OAAO,cAAc,OAAO,SAAS;AACvC,WAAO,KAAK,iBAAiB,EAAE,wBAAwB;AAAA,EACzD;AAEA,QAAM,WAAW,cAAc,OAAO,OAAO,OAAO,QAAQ;AAC5D,MAAI,aAAa,MAAM;AACrB,WAAO,KAAK,oBAAoB,OAAO,KAAK,sCAAsC;AAAA,EACpF;AAEA,QAAM,SAAmF;AAAA,IACvF;AAAA,EACF;AACA,MAAI,SAAS,YAAY,OAAW,QAAO,UAAU,SAAS;AAC9D,MAAI,SAAS,cAAc,OAAW,QAAO,YAAY,SAAS;AAElE,QAAM,SAAS,MAAM,gBAAgB,MAAM;AAE3C,MAAI,OAAO,MAAM;AACf,UAAM,KAAK,UAAU,EAAE,IAAI,OAAO,IAAI,MAAM,OAAO,MAAM,SAAS,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC;AAAA,EAC9F,OAAO;AACL,UAAM,sBAAsB,MAAM,CAAC;AAAA,EACrC;AACA,SAAO;AACT;AAEA,eAAsB,IAAI,MAAiC;AACzD,QAAM,MAAM,KAAK,CAAC;AAClB,QAAM,OAAO,KAAK,MAAM,CAAC;AAEzB,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,aAAO,UAAU,IAAI;AAAA,IACvB,KAAK;AACH,aAAO,UAAU,IAAI;AAAA,IACvB,KAAK;AACH,aAAO,eAAe,IAAI;AAAA,IAC5B,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,YAAM,kEAAkE;AACxE,YAAM,6FAA6F;AACnG,YAAM,6EAA6E;AACnF,YAAM,yEAAyE;AAC/E,aAAO,QAAQ,SAAY,IAAI;AAAA,IACjC;AACE,aAAO,KAAK,6BAA6B,GAAG,mCAAmC;AAAA,EACnF;AACF;","names":[]}

package/dist/{usage-event-FH3X232T.js → usage-event-W5VLRA3X.js}

@@ -1,17 +1,18 @@
 #!/usr/bin/env node
 import {
   runUsageEvent
-} from "./chunk-K67UJSJI.js";
+} from "./chunk-66TGBYSL.js";
 import "./chunk-OP4KBXUO.js";
 import "./chunk-GDIAHWNY.js";
-import "./chunk-OXANBA4I.js";
-import "./chunk-W4GVN3TJ.js";
+import "./chunk-ITVST3SZ.js";
+import "./chunk-KQBRUI3Y.js";
 import "./chunk-IVAWP6HH.js";
 import "./chunk-KHO5WNTP.js";
 import "./chunk-4NFDNY3C.js";
-import "./chunk-BGPVMJOG.js";
-import "./chunk-O7CFTOM5.js";
-import "./chunk-QG26JEJF.js";
+import "./chunk-ZYB2UFEN.js";
+import "./chunk-D35FMUFZ.js";
+import "./chunk-S2TAC22E.js";
+import "./chunk-7C3COFOD.js";
 import "./chunk-NBYKLUF6.js";
 import "./chunk-QSY74NAP.js";
 import "./chunk-UMQ6NBQR.js";
@@ -51,4 +52,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=usage-event-FH3X232T.js.map
+//# sourceMappingURL=usage-event-W5VLRA3X.js.map

package/dist/{usage-event-FH3X232T.js.map → usage-event-W5VLRA3X.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/usage-event.ts"],"sourcesContent":["/**\n * cli/commands/usage-event — the HIDDEN host-native turn-usage entrypoint (4a).\n *\n *   agent-connector usage-event <platform> --connector <id>\n *\n * An OPT-IN AfterModel / PostInvocation hook (installed by the Gemini / Antigravity\n * adapters only when host-native usage is enabled) points here. It reads the ENTIRE\n * host payload from stdin, hands it to {@link runUsageEvent}, and ALWAYS exits 0 —\n * a host-native usage hook must never block a model turn. Hidden (not in the help\n * text) and intentionally a peer of `hook` so it mirrors the same plumbing.\n *\n * Fail-open is the contract: runUsageEvent never throws; on any parse/store error\n * it records nothing and we still exit 0.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { runUsageEvent } from \"../../runtime/index.js\";\n\n/** Read all of a readable stream to a UTF-8 string. */\nasync function readAll(stream: NodeJS.ReadStream): Promise<string> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  // strict:false so a future flag from a newer install can never make this throw\n  // and surface a non-zero exit into the host's model turn.\n  let platformId = \"\";\n  let connectorId = \"\";\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv,\n      options: { connector: { type: \"string\" } },\n      allowPositionals: true,\n      strict: false,\n    });\n    platformId = positionals[0] ?? \"\";\n    connectorId = typeof values.connector === \"string\" ? values.connector : \"\";\n  } catch {\n    // A malformed invocation must still fail-open (record nothing, exit 0).\n    return 0;\n  }\n\n  // Drain stdin regardless — a host expects the hook command to consume its\n  // payload. A missing platform/connector simply records nothing.\n  const stdin = await readAll(process.stdin).catch(() => \"\");\n\n  if (platformId === \"\" || connectorId === \"\") {\n    return 0;\n  }\n\n  const result = await runUsageEvent({ platformId, connectorId, stdin });\n  return result.exitCode;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAeA,SAAS,iBAAiB;AAK1B,eAAe,QAAQ,QAA4C;AACjE,QAAM,SAAmB,CAAC;AAC1B,mBAAiB,SAAS,QAAQ;AAChC,WAAO,KAAK,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK,IAAI,KAAK;AAAA,EACpE;AACA,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,MAAM;AAC9C;AAEA,eAAsB,IAAI,MAAiC;AAGzD,MAAI,aAAa;AACjB,MAAI,cAAc;AAClB,MAAI;AACF,UAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,MACxC,MAAM;AAAA,MACN,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,EAAE;AAAA,MACzC,kBAAkB;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AACD,iBAAa,YAAY,CAAC,KAAK;AAC/B,kBAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAAA,EAC1E,QAAQ;AAEN,WAAO;AAAA,EACT;AAIA,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,MAAM,EAAE;AAEzD,MAAI,eAAe,MAAM,gBAAgB,IAAI;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,MAAM,cAAc,EAAE,YAAY,aAAa,MAAM,CAAC;AACrE,SAAO,OAAO;AAChB;","names":[]}
+{"version":3,"sources":["../src/cli/commands/usage-event.ts"],"sourcesContent":["/**\n * cli/commands/usage-event — the HIDDEN host-native turn-usage entrypoint (4a).\n *\n *   agent-connector usage-event <platform> --connector <id>\n *\n * An OPT-IN AfterModel / PostInvocation hook (installed by the Gemini / Antigravity\n * adapters only when host-native usage is enabled) points here. It reads the ENTIRE\n * host payload from stdin, hands it to {@link runUsageEvent}, and ALWAYS exits 0 —\n * a host-native usage hook must never block a model turn. Hidden (not in the help\n * text) and intentionally a peer of `hook` so it mirrors the same plumbing.\n *\n * Fail-open is the contract: runUsageEvent never throws; on any parse/store error\n * it records nothing and we still exit 0.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { runUsageEvent } from \"../../runtime/index.js\";\n\n/** Read all of a readable stream to a UTF-8 string. */\nasync function readAll(stream: NodeJS.ReadStream): Promise<string> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  // strict:false so a future flag from a newer install can never make this throw\n  // and surface a non-zero exit into the host's model turn.\n  let platformId = \"\";\n  let connectorId = \"\";\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv,\n      options: { connector: { type: \"string\" } },\n      allowPositionals: true,\n      strict: false,\n    });\n    platformId = positionals[0] ?? \"\";\n    connectorId = typeof values.connector === \"string\" ? values.connector : \"\";\n  } catch {\n    // A malformed invocation must still fail-open (record nothing, exit 0).\n    return 0;\n  }\n\n  // Drain stdin regardless — a host expects the hook command to consume its\n  // payload. A missing platform/connector simply records nothing.\n  const stdin = await readAll(process.stdin).catch(() => \"\");\n\n  if (platformId === \"\" || connectorId === \"\") {\n    return 0;\n  }\n\n  const result = await runUsageEvent({ platformId, connectorId, stdin });\n  return result.exitCode;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAeA,SAAS,iBAAiB;AAK1B,eAAe,QAAQ,QAA4C;AACjE,QAAM,SAAmB,CAAC;AAC1B,mBAAiB,SAAS,QAAQ;AAChC,WAAO,KAAK,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK,IAAI,KAAK;AAAA,EACpE;AACA,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,MAAM;AAC9C;AAEA,eAAsB,IAAI,MAAiC;AAGzD,MAAI,aAAa;AACjB,MAAI,cAAc;AAClB,MAAI;AACF,UAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,MACxC,MAAM;AAAA,MACN,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,EAAE;AAAA,MACzC,kBAAkB;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AACD,iBAAa,YAAY,CAAC,KAAK;AAC/B,kBAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAAA,EAC1E,QAAQ;AAEN,WAAO;AAAA,EACT;AAIA,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,MAAM,EAAE;AAEzD,MAAI,eAAe,MAAM,gBAAgB,IAAI;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,MAAM,cAAc,EAAE,YAAY,aAAa,MAAM,CAAC;AACrE,SAAO,OAAO;AAChB;","names":[]}

package/package.json

@@ -1,21 +1,34 @@
 {
   "name": "@ken-jo/agent-connector",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "type": "module",
-  "description": "SDK/runtime for branded MCP packages: declare your server + hooks once, install across the current AI-agent coverage matrix, and collect local-first token telemetry.",
+  "description": "Deploy one MCP server to every agent host. Declare it once with defineConnector() and ship a branded package that installs itself into Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf, Zed, Kiro, Warp, OpenCode and 42 agent hosts in all — native config, hooks, skills, Agent Plugins bundle, per-tool token telemetry.",
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "mcp-server",
+    "mcp-sdk",
+    "publish-mcp-server",
+    "deploy-mcp-server",
+    "mcp-distribution",
+    "agent-hosts",
+    "agent-plugins",
+    "agent-skills",
+    "agents-md",
     "hooks",
     "claude-code",
     "codex",
     "cursor",
-    "opencode",
-    "copilot",
+    "github-copilot",
     "gemini-cli",
-    "telemetry",
-    "tokens",
-    "multi-platform"
+    "windsurf",
+    "zed",
+    "kiro",
+    "warp",
+    "opencode",
+    "cline",
+    "openclaw",
+    "token-telemetry"
   ],
   "license": "Apache-2.0",
   "author": "KenJo",

package/dist/chunk-BGPVMJOG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/load-connector.ts"],"sourcesContent":["/**\n * core/load-connector — discover, load, and register connector definitions.\n *\n * Responsibilities:\n *   1. Locate the developer's `agent-connector.config.{mjs,js,json}` by walking\n *      upward from a start directory (the project root convention).\n *   2. Load a config from a path into a LIVE ResolvedConnector (with handlers).\n *   3. Register a connector by persisting SERIALIZABLE metadata (no functions)\n *      to `connectorDir(id)/connector.json`, pointing at the source module so\n *      live handlers can be re-imported at runtime from a stable record.\n *\n * Why split live vs. serialized? Hook handlers are functions and cannot survive\n * JSON. The registry stores only what JSON can hold plus an absolute\n * `modulePath`; the runtime re-imports that module to recover the live handlers.\n */\n\nimport { existsSync, readdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport type {\n  CommandDef,\n  HookEventName,\n  InstallScope,\n  MemoryDef,\n  PlatformId,\n  PlatformOverride,\n  ResolvedConnector,\n  ServerDef,\n  SkillDef,\n  SubagentDef,\n} from \"./types.js\";\nimport { defineConnector } from \"./define-connector.js\";\nimport { assertNoSymlinkInPath, connectorDir, connectorsDir, ensureDir } from \"./paths.js\";\nimport {\n  readConnectorPackageMetadataNearFile,\n  withConnectorPackageMetadata,\n} from \"./package-metadata.js\";\n\n/** Candidate config filenames, in resolution-precedence order. */\nconst CONFIG_FILENAMES = [\n  \"agent-connector.config.mjs\",\n  \"agent-connector.config.js\",\n  \"agent-connector.config.json\",\n] as const;\n\n/**\n * The serializable subset of a connector persisted to `connector.json`.\n * Hook handler functions are intentionally absent — only the absolute\n * `modulePath` is stored so the live ResolvedConnector can be re-imported.\n */\nexport interface RegisteredMeta {\n  id: string;\n  displayName: string;\n  version: string;\n  /** Package-derived identity, when available from config or package.json. */\n  mcp?: ResolvedConnector[\"mcp\"];\n  /** Absolute path to the source module that produced this connector. */\n  modulePath: string;\n  telemetry: ResolvedConnector[\"telemetry\"];\n  /** Canonical event names the connector handles (handlers themselves stripped). */\n  hookEvents: HookEventName[];\n  hasServer: boolean;\n  server: ServerDef | null;\n  /**\n   * Content surfaces (commands/skills/subagents). These are JSON-serializable\n   * (no functions) so they persist cleanly and let uninstall locate the files\n   * to remove even when the source module is gone.\n   */\n  commands: CommandDef[];\n  skills: SkillDef[];\n  subagents: SubagentDef[];\n  /**\n   * Memory entries (managed-block content surface). Plain content, persisted\n   * whole so uninstall normally has the full entry list even when the source\n   * module is gone (the marker prefix-scan is the fallback beyond that).\n   */\n  memory: MemoryDef[];\n  targets: ResolvedConnector[\"targets\"];\n  /** Per-platform overrides with any hook handler functions stripped. */\n  platforms: Partial<Record<PlatformId, PlatformOverride>>;\n  /**\n   * The install scope this connector was registered under, persisted so the\n   * runtime entrypoints (hook/statusline/action) can recover it cheaply (sync)\n   * and stamp it onto the HostCtx/event — scope is an install-time property the\n   * runtime otherwise has no access to. OPTIONAL: absent for an ad-hoc register\n   * that passed no scope, or a record written before this field existed.\n   * This is the install's RUN-WIDE DEFAULT scope; it can differ from the\n   * effective per-host scope when a `platforms[host].scope` override is set (the\n   * record is keyed by connector id only and holds no per-host scope map).\n   */\n  scope?: InstallScope;\n}\n\n/**\n * Search `startDir` and each ancestor for a connector config file. Returns the\n * absolute path to the first match (filesystem-root-stopping), or null.\n */\nexport function findConnectorConfig(startDir: string): string | null {\n  let dir = resolve(startDir);\n  // Walk upward until `dirname(dir) === dir` (filesystem root).\n  for (;;) {\n    for (const name of CONFIG_FILENAMES) {\n      const candidate = join(dir, name);\n      if (existsSync(candidate)) return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/** True if a value already looks like a ResolvedConnector (vs. a raw config). */\nfunction isResolvedConnector(value: unknown): value is ResolvedConnector {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    Array.isArray((value as { hookEvents?: unknown }).hookEvents)\n  );\n}\n\n/**\n * Load a connector from an absolute or relative path.\n *   - `.json`           → JSON.parse, then defineConnector().\n *   - `.mjs` / `.js`    → dynamic import (via pathToFileURL, Windows-safe),\n *                         take the default export. If it already looks like a\n *                         ResolvedConnector use it as-is; otherwise treat it as\n *                         a ConnectorConfig and run it through defineConnector().\n * Returns the live connector plus the absolute module path it came from.\n */\nexport async function loadConnectorFromPath(\n  path: string,\n): Promise<{ connector: ResolvedConnector; modulePath: string }> {\n  let modulePath = isAbsolute(path) ? path : resolve(path);\n  // Canonicalize before building the file:// URL for dynamic import. On Windows a\n  // short (8.3) temp path like C:\\Users\\RUNNER~1\\...\\x.mjs round-trips the \"~\" as\n  // %7E and fails to load; realpathSync.native expands it to the real long path.\n  // It also resolves symlinked temp roots (e.g. macOS /var -> /private/var).\n  // If the file does not exist yet, fall through with the resolve()'d path so the\n  // subsequent read/import throws the real not-found error.\n  try {\n    modulePath = realpathSync.native(modulePath);\n  } catch {\n    /* keep the resolve()'d path */\n  }\n\n  if (modulePath.endsWith(\".json\")) {\n    const text = readFileSync(modulePath, \"utf8\");\n    const config = JSON.parse(text) as unknown;\n    const connector = await withConnectorPackageMetadata(\n      readConnectorPackageMetadataNearFile(modulePath),\n      async () => defineConnector(config as Parameters<typeof defineConnector>[0]),\n    );\n    return { connector, modulePath };\n  }\n\n  // .mjs / .js — dynamic ESM import. pathToFileURL keeps Windows paths valid.\n  const moduleUrl = pathToFileURL(modulePath).href;\n  const connector = await withConnectorPackageMetadata(\n    readConnectorPackageMetadataNearFile(modulePath),\n    async () => {\n      const mod = (await import(/* @vite-ignore */ moduleUrl)) as {\n        default?: unknown;\n      };\n      const exported = mod.default;\n      if (exported == null) {\n        throw new Error(\n          `Connector module has no default export: ${modulePath}`,\n        );\n      }\n      return isResolvedConnector(exported)\n        ? exported\n        : defineConnector(exported as Parameters<typeof defineConnector>[0]);\n    },\n  );\n  return { connector, modulePath };\n}\n\n/**\n * Strip any function-valued `hooks` from per-platform overrides so the result\n * is JSON-serializable. A boolean `hooks` override is preserved; an object\n * override is dropped (it can only carry handler functions, which are not\n * serializable). `nativeHooks` declarations are persisted HANDLER-LESS (event\n * name + matcher only) so meta-based inspection (doctor / health checks / the\n * hook CLI) can still see WHICH native events were declared — the live handlers\n * are re-imported from `modulePath` at runtime, exactly like normalized hooks.\n * Everything else on the override is kept verbatim — notably `configPatch`\n * declarations, which are pure JSON (key/value/reason/docsUrl, no functions)\n * and persist WHOLE so uninstall/doctor can reason about them even when the\n * source module is gone.\n */\nfunction serializablePlatforms(\n  platforms: Partial<Record<PlatformId, PlatformOverride>>,\n): Partial<Record<PlatformId, PlatformOverride>> {\n  const out: Partial<Record<PlatformId, PlatformOverride>> = {};\n  for (const [id, override] of Object.entries(platforms) as [\n    PlatformId,\n    PlatformOverride | undefined,\n  ][]) {\n    if (!override) continue;\n    const { hooks, nativeHooks, ...rest } = override;\n    const clean: PlatformOverride = { ...rest };\n    // Keep only a boolean hooks flag; object hooks carry handler functions.\n    if (typeof hooks === \"boolean\") clean.hooks = hooks;\n    if (nativeHooks && typeof nativeHooks === \"object\") {\n      const stripped: Record<string, { matcher?: string }> = {};\n      for (const [event, def] of Object.entries(nativeHooks)) {\n        stripped[event] =\n          typeof def?.matcher === \"string\" ? { matcher: def.matcher } : {};\n      }\n      // Cast: the persisted record deliberately omits the (non-serializable)\n      // handler; consumers of meta-derived connectors never dispatch handlers.\n      clean.nativeHooks = stripped as PlatformOverride[\"nativeHooks\"];\n    }\n    out[id] = clean;\n  }\n  return out;\n}\n\n/**\n * Persist a connector's serializable metadata to `connectorDir(id)/connector.json`.\n * Handlers are NOT serialized — they are re-imported from `modulePath` at runtime.\n * The optional `scope` (the install scope the caller deployed under) is persisted\n * so the runtime entrypoints can recover it and stamp it onto the HostCtx/event.\n * Returns the absolute path of the written record.\n */\nexport function registerConnector(\n  connector: ResolvedConnector,\n  modulePath: string,\n  scope?: InstallScope,\n): string {\n  const meta: RegisteredMeta = {\n    id: connector.id,\n    displayName: connector.displayName,\n    version: connector.version,\n    ...(connector.mcp ? { mcp: connector.mcp } : {}),\n    modulePath: resolve(modulePath),\n    telemetry: connector.telemetry,\n    hookEvents: connector.hookEvents,\n    hasServer: !!connector.server,\n    server: connector.server ?? null,\n    commands: connector.commands,\n    skills: connector.skills,\n    subagents: connector.subagents,\n    memory: connector.memory,\n    targets: connector.targets,\n    platforms: serializablePlatforms(connector.platforms),\n    // Persist the install scope when the caller supplied one (the installer\n    // passes its install scope). Omitted from the record when undefined so an\n    // ad-hoc register stays minimal and round-trips as \"no scope known\".\n    ...(scope !== undefined ? { scope } : {}),\n  };\n\n  const dir = connectorDir(connector.id);\n  const outPath = join(dir, \"connector.json\");\n  assertNoSymlinkInPath(outPath);\n  ensureDir(dir);\n  writeFileSync(outPath, `${JSON.stringify(meta, null, 2)}\\n`, \"utf8\");\n  return outPath;\n}\n\n/**\n * Deregister a connector by removing its DATA-dir record directory\n * (`connectorDir(id)`) recursively. This is the inverse of {@link registerConnector}:\n * registerConnector writes `connectorDir(id)/connector.json`, but per-target\n * uninstall only strips host-native registrations — it never removes this record,\n * leaving an orphan behind. Best-effort + guarded: returns the directory path and\n * whether it existed before removal.\n */\nexport function deregisterConnector(id: string): {\n  removed: boolean;\n  path: string;\n} {\n  const dir = connectorDir(id);\n  assertNoSymlinkInPath(dir);\n  const existed = existsSync(dir);\n  if (existed) rmSync(dir, { recursive: true, force: true });\n  return { removed: existed, path: dir };\n}\n\n/**\n * Read the registered metadata record for `id`, or null if not registered or\n * the record is unreadable/corrupt.\n */\nexport function readRegisteredMeta(id: string): RegisteredMeta | null {\n  const recordPath = join(connectorDir(id), \"connector.json\");\n  if (!existsSync(recordPath)) return null;\n  try {\n    return JSON.parse(readFileSync(recordPath, \"utf8\")) as RegisteredMeta;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Load the LIVE ResolvedConnector (with hook handlers) for a registered id by\n * re-importing its source module. Throws a clear error when the connector is\n * not registered or its source module no longer resolves to it.\n */\nexport async function loadRegisteredConnector(\n  id: string,\n): Promise<ResolvedConnector> {\n  const meta = readRegisteredMeta(id);\n  if (!meta) {\n    throw new Error(\n      `Connector \"${id}\" is not registered (no record at ${join(connectorDir(id), \"connector.json\")}). ` +\n        `Run an install/register step first.`,\n    );\n  }\n  if (!meta.modulePath || !existsSync(meta.modulePath)) {\n    throw new Error(\n      `Connector \"${id}\" record points at a missing module: ${meta.modulePath}`,\n    );\n  }\n  const { connector } = await loadConnectorFromPath(meta.modulePath);\n  return connector;\n}\n\n/**\n * Build a handler-less ResolvedConnector from stored metadata. Suitable for\n * inspection/doctor where live hook handlers are not needed (and where the\n * source module may even be gone). `hooks` is empty; `hookEvents` is preserved.\n */\nexport function connectorFromMeta(meta: RegisteredMeta): ResolvedConnector {\n  return {\n    id: meta.id,\n    displayName: meta.displayName,\n    version: meta.version,\n    ...(meta.mcp ? { mcp: meta.mcp } : {}),\n    ...(meta.server ? { server: meta.server } : {}),\n    hooks: {},\n    hookEvents: meta.hookEvents ?? [],\n    telemetry: meta.telemetry,\n    commands: meta.commands ?? [],\n    skills: meta.skills ?? [],\n    subagents: meta.subagents ?? [],\n    memory: meta.memory ?? [],\n    // Actions carry live `run` handlers, so they are NOT serialized into the\n    // record (like the statusline render). A handler-less meta-derived connector\n    // gets [] — inspection/uninstall never dispatch action handlers, and the\n    // BaseAdapter action default already tolerates an empty list.\n    actions: [],\n    platforms: meta.platforms ?? {},\n    targets: meta.targets,\n  };\n}\n\n/**\n * List every registered connector as a handler-less ResolvedConnector (read\n * from `connectorsDir()`). Used by doctor to health-check what is actually\n * installed, rather than guessing from the local working directory.\n */\nexport function listRegisteredConnectors(): ResolvedConnector[] {\n  const dir = connectorsDir();\n  if (!existsSync(dir)) return [];\n  const out: ResolvedConnector[] = [];\n  for (const entry of readdirSync(dir)) {\n    const meta = readRegisteredMeta(entry);\n    if (meta) out.push(connectorFromMeta(meta));\n  }\n  return out;\n}\n"],"mappings":"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","names":["connector"]}