@ken-jo/agent-connector 0.1.0

package/dist/usage-6ER6EMEY.js

@@ -0,0 +1,324 @@
+#!/usr/bin/env node
+import {
+  formatHostLeaderboard,
+  hostLeaderboard,
+  scanUsage
+} from "./chunk-WV63X7IK.js";
+import {
+  aggregateBy,
+  sumTokens
+} from "./chunk-XD7MY6HB.js";
+import {
+  fail,
+  print
+} from "./chunk-54EMKTTX.js";
+
+// src/cli/commands/usage.ts
+import { writeFileSync } from "fs";
+import { parseArgs } from "util";
+
+// src/usage/report.ts
+var KEY_HEADER = {
+  platform: "PLATFORM",
+  project: "PROJECT",
+  session: "SESSION",
+  model: "MODEL",
+  day: "DAY"
+};
+function fmtInt(n) {
+  return n.toLocaleString("en-US");
+}
+function padRight(s, width) {
+  return s.length >= width ? s : s + " ".repeat(width - s.length);
+}
+function padLeft(s, width) {
+  return s.length >= width ? s : " ".repeat(width - s.length) + s;
+}
+function formatUsageReport(rows, by, skipped = []) {
+  const keyHeader = KEY_HEADER[by];
+  const headers = [
+    keyHeader,
+    "IN",
+    "OUT",
+    "CACHE_R",
+    "CACHE_W",
+    "REASON",
+    "TOTAL",
+    "SESS",
+    "CONF"
+  ];
+  const sorted = [...rows].sort((a, b) => b.total - a.total || b.lastTs - a.lastTs);
+  const dataRows = sorted.map((r) => [
+    r.key,
+    fmtInt(r.tokens.input),
+    fmtInt(r.tokens.output),
+    fmtInt(r.tokens.cacheRead),
+    fmtInt(r.tokens.cacheWrite),
+    fmtInt(r.tokens.reasoning),
+    fmtInt(r.total),
+    fmtInt(r.sessions),
+    r.confidence
+  ]);
+  const totals = sorted.reduce(
+    (acc, r) => {
+      acc.input += r.tokens.input;
+      acc.output += r.tokens.output;
+      acc.cacheRead += r.tokens.cacheRead;
+      acc.cacheWrite += r.tokens.cacheWrite;
+      acc.reasoning += r.tokens.reasoning;
+      acc.total += r.total;
+      acc.sessions += r.sessions;
+      return acc;
+    },
+    { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, total: 0, sessions: 0 }
+  );
+  const totalRow = [
+    "TOTAL",
+    fmtInt(totals.input),
+    fmtInt(totals.output),
+    fmtInt(totals.cacheRead),
+    fmtInt(totals.cacheWrite),
+    fmtInt(totals.reasoning),
+    fmtInt(totals.total),
+    fmtInt(totals.sessions),
+    ""
+  ];
+  const widths = headers.map((h, col) => {
+    let w = h.length;
+    for (const row of dataRows) w = Math.max(w, (row[col] ?? "").length);
+    w = Math.max(w, (totalRow[col] ?? "").length);
+    return w;
+  });
+  const renderRow = (cells) => cells.map((c, col) => col === 0 ? padRight(c, widths[col] ?? 0) : padLeft(c, widths[col] ?? 0)).join("  ").trimEnd();
+  const ruleWidth = widths.reduce((a, b) => a + b, 0) + 2 * (widths.length - 1);
+  const rule = "-".repeat(ruleWidth);
+  const lines = [];
+  lines.push(renderRow(headers));
+  lines.push(rule);
+  if (dataRows.length === 0) {
+    lines.push("(no host usage found)");
+  } else {
+    for (const row of dataRows) lines.push(renderRow(row));
+  }
+  lines.push(rule);
+  lines.push(renderRow(totalRow));
+  const hasEstimate = sorted.some((r) => r.confidence === "host-estimated");
+  if (hasEstimate) {
+    lines.push("");
+    lines.push(
+      "note: host-estimated rows are derived (e.g. char/4 or cost-only), not exact host-reported token counts."
+    );
+  }
+  if (skipped.length > 0) {
+    lines.push("");
+    lines.push("skipped:");
+    for (const s of skipped) lines.push(`  - ${s.platformId}: ${s.reason}`);
+  }
+  return lines.join("\n");
+}
+var CSV_COLUMNS = [
+  "platformId",
+  "modelId",
+  "providerId",
+  "sessionId",
+  "projectKey",
+  "projectLabel",
+  "input",
+  "output",
+  "cacheRead",
+  "cacheWrite",
+  "reasoning",
+  "total",
+  "cost",
+  "ts",
+  "messageCount",
+  "confidence",
+  "agent"
+];
+function csvCell(value) {
+  if (value === void 0 || value === null) return "";
+  const s = String(value);
+  if (/[",\n\r]/.test(s)) return `"${s.replace(/"/g, '""')}"`;
+  return s;
+}
+function recordRow(r) {
+  return [
+    r.platformId,
+    r.modelId,
+    r.providerId,
+    r.sessionId,
+    r.projectKey,
+    r.projectLabel,
+    r.tokens.input,
+    r.tokens.output,
+    r.tokens.cacheRead,
+    r.tokens.cacheWrite,
+    r.tokens.reasoning,
+    sumTokens(r.tokens),
+    r.cost,
+    r.ts,
+    r.messageCount,
+    r.confidence,
+    r.agent
+  ];
+}
+function usageToCSV(records) {
+  const lines = [];
+  lines.push(CSV_COLUMNS.join(","));
+  for (const r of records) {
+    lines.push(recordRow(r).map(csvCell).join(","));
+  }
+  return lines.join("\r\n");
+}
+function usageToJSON(records) {
+  return JSON.stringify(records, null, 2);
+}
+
+// src/cli/commands/usage.ts
+function parseSince(since) {
+  if (since == null || since.trim() === "") return void 0;
+  const m = since.trim().match(/^(\d+)\s*([smhd])$/i);
+  if (!m || !m[1] || !m[2]) return null;
+  const n = Number(m[1]);
+  const unitMs = {
+    s: 1e3,
+    m: 6e4,
+    h: 36e5,
+    d: 864e5
+  };
+  const factor = unitMs[m[2].toLowerCase()];
+  if (factor == null) return null;
+  return Date.now() - n * factor;
+}
+var GROUP_BY_VALUES = /* @__PURE__ */ new Set([
+  "platform",
+  "project",
+  "session",
+  "model",
+  "day"
+]);
+function buildScanOpts(since, platform) {
+  const sinceMs = parseSince(since);
+  if (sinceMs === null) return null;
+  const opts = {};
+  if (sinceMs !== void 0) opts.sinceMs = sinceMs;
+  if (platform && platform.trim() !== "") opts.platforms = [platform.trim()];
+  return opts;
+}
+async function runReport(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      by: { type: "string", default: "platform" },
+      since: { type: "string" },
+      platform: { type: "string" },
+      json: { type: "boolean", default: false }
+    },
+    allowPositionals: false
+  });
+  const by = values.by;
+  if (!GROUP_BY_VALUES.has(by ?? "")) {
+    return fail(`invalid --by "${by}" (use platform|project|session|model|day)`);
+  }
+  const dimension = by;
+  const scanOpts = buildScanOpts(values.since, values.platform);
+  if (scanOpts === null) {
+    return fail(`invalid --since "${values.since}" (use forms like 30s, 15m, 24h, 7d)`);
+  }
+  const { records, skipped } = await scanUsage(scanOpts);
+  const rows = aggregateBy(records, dimension);
+  if (values.json) {
+    print(JSON.stringify({ by: dimension, rows, skipped }, null, 2));
+  } else {
+    print(formatUsageReport(rows, dimension, skipped));
+  }
+  return 0;
+}
+async function runExport(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      format: { type: "string", default: "json" },
+      out: { type: "string" },
+      since: { type: "string" },
+      platform: { type: "string" }
+    },
+    allowPositionals: false
+  });
+  const format = values.format;
+  if (format !== "csv" && format !== "json") {
+    return fail(`invalid --format "${format}" (use csv|json)`);
+  }
+  const scanOpts = buildScanOpts(values.since, values.platform);
+  if (scanOpts === null) {
+    return fail(`invalid --since "${values.since}" (use forms like 30s, 15m, 24h, 7d)`);
+  }
+  const { records } = await scanUsage(scanOpts);
+  const serialized = format === "csv" ? usageToCSV(records) : usageToJSON(records);
+  if (values.out && values.out.trim() !== "") {
+    writeFileSync(values.out, serialized, "utf8");
+    print(`wrote ${format.toUpperCase()} export \u2192 ${values.out}`);
+  } else {
+    print(serialized);
+  }
+  return 0;
+}
+async function runLeaderboard(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      by: { type: "string", default: "platform" },
+      since: { type: "string" },
+      platform: { type: "string" },
+      json: { type: "boolean", default: false }
+    },
+    allowPositionals: false
+  });
+  const by = values.by;
+  if (by !== "platform" && by !== "model") {
+    return fail(`invalid --by "${by}" (use platform|model)`);
+  }
+  const scanOpts = buildScanOpts(values.since, values.platform);
+  if (scanOpts === null) {
+    return fail(`invalid --since "${values.since}" (use forms like 30s, 15m, 24h, 7d)`);
+  }
+  const lbOpts = {
+    by
+  };
+  if (scanOpts.sinceMs !== void 0) lbOpts.sinceMs = scanOpts.sinceMs;
+  if (scanOpts.platforms !== void 0) lbOpts.platforms = scanOpts.platforms;
+  const result = await hostLeaderboard(lbOpts);
+  if (values.json) {
+    print(JSON.stringify({ by: result.by, rows: result.rows, skipped: result.skipped }, null, 2));
+  } else {
+    print(formatHostLeaderboard(result));
+  }
+  return 0;
+}
+async function run(argv) {
+  const sub = argv[0];
+  const rest = argv.slice(1);
+  switch (sub) {
+    case "report":
+      return runReport(rest);
+    case "export":
+      return runExport(rest);
+    case "leaderboard":
+      return runLeaderboard(rest);
+    case void 0:
+    case "--help":
+    case "-h":
+      print("usage: agent-connector usage <report|export|leaderboard> [flags]");
+      print("  report       --by platform|project|session|model|day  --since 7d  --platform <id>  --json");
+      print("  export       --format csv|json  --out <file>  --since 7d  --platform <id>");
+      print("  leaderboard  --by platform|model  --since 7d  --platform <id>  --json");
+      return sub === void 0 ? 1 : 0;
+    default:
+      return fail(`unknown usage subcommand "${sub}" (use report|export|leaderboard)`);
+  }
+}
+export {
+  parseSince,
+  run
+};
+//# sourceMappingURL=usage-6ER6EMEY.js.map

package/dist/usage-6ER6EMEY.js.map

@@ -0,0 +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":[]}

package/dist/usage-event-JKBI6XCF.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import {
+  runUsageEvent
+} from "./chunk-YNZU6PAV.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-WCETQWWK.js";
+import "./chunk-XUCWLJY5.js";
+import "./chunk-LTT56GI3.js";
+import "./chunk-XNAM7F35.js";
+import "./chunk-MEH7GC7R.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/usage-event.ts
+import { parseArgs } from "util";
+async function readAll(stream) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function run(argv) {
+  let platformId = "";
+  let connectorId = "";
+  try {
+    const { values, positionals } = parseArgs({
+      args: argv,
+      options: { connector: { type: "string" } },
+      allowPositionals: true,
+      strict: false
+    });
+    platformId = positionals[0] ?? "";
+    connectorId = typeof values.connector === "string" ? values.connector : "";
+  } catch {
+    return 0;
+  }
+  const stdin = await readAll(process.stdin).catch(() => "");
+  if (platformId === "" || connectorId === "") {
+    return 0;
+  }
+  const result = await runUsageEvent({ platformId, connectorId, stdin });
+  return result.exitCode;
+}
+export {
+  run
+};
+//# sourceMappingURL=usage-event-JKBI6XCF.js.map

package/dist/usage-event-JKBI6XCF.js.map

@@ -0,0 +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":[]}