@ken-jo/agent-connector 0.1.0

package/dist/roo-code-ZLKH4A7N.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+import {
+  readJsonFile
+} from "./chunk-RK6VBLXP.js";
+import {
+  expandHome,
+  walkFiles
+} from "./chunk-JWNT5KW7.js";
+import {
+  emptyTokens
+} from "./chunk-XD7MY6HB.js";
+
+// src/usage/readers/roo-code.ts
+import { existsSync, readFileSync } from "fs";
+import { homedir, platform as osPlatform } from "os";
+import { basename, dirname, isAbsolute, join, resolve } from "path";
+var PLATFORM_ID = "roo-code";
+var DEFAULT_MODEL = "unknown";
+var DEFAULT_PROVIDER = "unknown";
+var DEFAULT_SESSION = "unknown";
+var ROO_EXTENSION_ID = "rooveterinaryinc.roo-cline";
+function vscodeUserDir() {
+  const home = homedir();
+  switch (osPlatform()) {
+    case "darwin":
+      return join(home, "Library", "Application Support", "Code", "User");
+    case "win32": {
+      const appData = process.env.APPDATA ?? join(home, "AppData", "Roaming");
+      return join(appData, "Code", "User");
+    }
+    default:
+      return join(home, ".config", "Code", "User");
+  }
+}
+function tasksRoot() {
+  const raw = process.env.AGENT_CONNECTOR_ROO_CODE_DIR;
+  if (raw != null && raw.trim() !== "") {
+    const expanded = expandHome(raw.trim());
+    return isAbsolute(expanded) ? expanded : resolve(expanded);
+  }
+  return join(vscodeUserDir(), "globalStorage", ROO_EXTENSION_ID, "tasks");
+}
+function extractI64(v) {
+  if (typeof v === "number") {
+    if (!Number.isFinite(v)) return void 0;
+    return Math.trunc(v);
+  }
+  if (typeof v === "string") {
+    const trimmed = v.trim();
+    if (!/^[+-]?\d+$/.test(trimmed)) return void 0;
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? Math.trunc(n) : void 0;
+  }
+  return void 0;
+}
+function tokenField(v) {
+  const n = extractI64(v);
+  return n === void 0 ? 0 : Math.max(0, n);
+}
+function extractF64(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : void 0;
+  if (typeof v === "string") {
+    const n = Number(v.trim());
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
+}
+function parseEntryTimestamp(v) {
+  let s;
+  if (typeof v === "string") s = v;
+  else if (typeof v === "number" && Number.isFinite(v)) s = String(Math.trunc(v));
+  else return null;
+  return parseTimestampStr(s);
+}
+function parseTimestampStr(value) {
+  const ms = Date.parse(value);
+  if (!Number.isNaN(ms)) return ms;
+  if (/^[+-]?\d+$/.test(value.trim())) {
+    const numeric = Number(value.trim());
+    if (!Number.isFinite(numeric) || numeric <= 0) return null;
+    return numeric >= 1e12 ? numeric : numeric * 1e3;
+  }
+  return null;
+}
+function extractSessionId(path) {
+  const parent = basename(dirname(path));
+  return parent !== "" ? parent : DEFAULT_SESSION;
+}
+function readTaskMetadata(uiMessagesPath) {
+  const historyPath = join(dirname(uiMessagesPath), "api_conversation_history.json");
+  let content;
+  try {
+    content = readFileSync(historyPath, "utf8");
+  } catch {
+    return { model: DEFAULT_MODEL };
+  }
+  return extractModelAndAgent(content);
+}
+function extractModelAndAgent(content) {
+  const ENV_START = "<environment_details>";
+  const ENV_END = "</environment_details>";
+  let offset = 0;
+  let lastModel;
+  let lastSlug;
+  let lastName;
+  for (; ; ) {
+    const startRel = content.indexOf(ENV_START, offset);
+    if (startRel < 0) break;
+    const startIdx = startRel + ENV_START.length;
+    const endRel = content.indexOf(ENV_END, startIdx);
+    if (endRel < 0) break;
+    const block = content.slice(startIdx, endRel);
+    const model = extractTagValue(block, "model");
+    if (model !== void 0) lastModel = model;
+    const slug = extractTagValue(block, "slug");
+    if (slug !== void 0) lastSlug = slug;
+    const name = extractTagValue(block, "name");
+    if (name !== void 0) lastName = name;
+    offset = endRel + ENV_END.length;
+  }
+  const agent = lastSlug ?? lastName;
+  const result = { model: lastModel ?? DEFAULT_MODEL };
+  if (agent !== void 0) result.agent = agent;
+  return result;
+}
+function extractTagValue(block, tag) {
+  const open = `<${tag}>`;
+  const close = `</${tag}>`;
+  const openIdx = block.indexOf(open);
+  if (openIdx < 0) return void 0;
+  const start = openIdx + open.length;
+  const endRel = block.indexOf(close, start);
+  if (endRel < 0) return void 0;
+  const value = block.slice(start, endRel).trim();
+  return value === "" ? void 0 : value;
+}
+function parseApiReqStartedPayload(text) {
+  let value;
+  try {
+    value = JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+  if (typeof value !== "object" || value === null) return void 0;
+  const obj = value;
+  const cost = Math.max(0, extractF64(obj["cost"]) ?? 0);
+  const apiProtocolRaw = typeof obj["apiProtocol"] === "string" ? obj["apiProtocol"] : void 0;
+  const payload = {
+    cost,
+    tokensIn: tokenField(obj["tokensIn"]),
+    tokensOut: tokenField(obj["tokensOut"]),
+    cacheReads: tokenField(obj["cacheReads"]),
+    cacheWrites: tokenField(obj["cacheWrites"])
+  };
+  if (apiProtocolRaw !== void 0) payload.apiProtocol = apiProtocolRaw;
+  return payload;
+}
+function providerFromApiProtocol(apiProtocol) {
+  if (apiProtocol === void 0) return DEFAULT_PROVIDER;
+  const trimmed = apiProtocol.trim();
+  return trimmed === "" ? DEFAULT_PROVIDER : trimmed;
+}
+function parseRooCodeFile(path) {
+  const data = readJsonFile(path);
+  if (!Array.isArray(data)) return [];
+  const sessionId = extractSessionId(path);
+  const { model, agent } = readTaskMetadata(path);
+  const out = [];
+  for (const raw of data) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const entry = raw;
+    if (entry.type !== "say" || entry.say !== "api_req_started") continue;
+    if (typeof entry.text !== "string") continue;
+    const ts = parseEntryTimestamp(entry.ts);
+    if (ts === null) continue;
+    const payload = parseApiReqStartedPayload(entry.text);
+    if (payload === void 0) continue;
+    const providerId = providerFromApiProtocol(payload.apiProtocol);
+    const tokens = emptyTokens();
+    tokens.input = payload.tokensIn;
+    tokens.output = payload.tokensOut;
+    tokens.cacheRead = payload.cacheReads;
+    tokens.cacheWrite = payload.cacheWrites;
+    const record = {
+      platformId: PLATFORM_ID,
+      modelId: model,
+      providerId,
+      sessionId,
+      tokens,
+      ts,
+      messageCount: 1,
+      confidence: "host-reported"
+    };
+    if (payload.cost > 0) record.cost = payload.cost;
+    if (agent !== void 0) record.agent = agent;
+    out.push(record);
+  }
+  return out;
+}
+var rooCodeReader = {
+  platformId: PLATFORM_ID,
+  kind: "local",
+  async read({ sinceMs }) {
+    const root = tasksRoot();
+    if (!existsSync(root)) return [];
+    const files = walkFiles(root, (name, abs) => {
+      return name === "ui_messages.json" && /[\\/]ui_messages\.json$/.test(abs);
+    });
+    const records = [];
+    for (const file of files) {
+      let rows;
+      try {
+        rows = parseRooCodeFile(file);
+      } catch {
+        continue;
+      }
+      for (const row of rows) {
+        if (sinceMs !== void 0 && row.ts < sinceMs) continue;
+        records.push(row);
+      }
+    }
+    return records;
+  }
+};
+var roo_code_default = rooCodeReader;
+export {
+  roo_code_default as default
+};
+//# sourceMappingURL=roo-code-ZLKH4A7N.js.map

package/dist/roo-code-ZLKH4A7N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usage/readers/roo-code.ts"],"sourcesContent":["/**\n * usage/readers/roo-code — Roo Code (VS Code extension) task-log reader.\n *\n * Faithful port of tokscale sessions/roocode.rs (parse_roo_kilo_file, source\n * \"roocode\"). Roo Code (rooveterinaryinc.roo-cline) is a Cline-fork VS Code\n * extension that persists per-task logs under its VS Code globalStorage:\n *   <vscodeUserDir>/globalStorage/rooveterinaryinc.roo-cline/tasks/<taskId>/\n *     ui_messages.json               (the UI message stream — token source)\n *     api_conversation_history.json  (sibling — model/agent source)\n *\n * roo-code is NOT in paths.ts hostRoots (the framework's per-platform table\n * targets CLIs with ~/.<tool> roots, not VS Code extension globalStorage), so\n * this reader resolves the cross-OS VS Code \"User\" dir itself, mirroring the\n * roo-code platform adapter (adapters/roo-code/index.ts vscodeUserDir):\n *   - macOS   → ~/Library/Application Support/Code/User\n *   - Windows → %APPDATA%/Code/User  (else ~/AppData/Roaming/Code/User)\n *   - Linux   → ~/.config/Code/User\n * An AGENT_CONNECTOR_ROO_CODE_DIR override (verbatim, non-empty, ~-expanded)\n * points directly at a `tasks` parent when set, matching the env convention in\n * paths.ts hostRoots.\n *\n * Tokens (ui_messages.json): the file is a JSON ARRAY of entries; only entries\n * with type==\"say\" AND say==\"api_req_started\" carry usage. Each such entry's\n * `text` field is a JSON-in-string payload:\n *   tokensIn     → input\n *   tokensOut    → output\n *   cacheReads   → cacheRead\n *   cacheWrites  → cacheWrite\n *   cost (f64)   → cost\n *   apiProtocol  → providerId (preserved verbatim, e.g. \"bedrock/anthropic\")\n * reasoning is ALWAYS 0 (Roo Code does not report it). A malformed text payload,\n * a missing text, or an unparseable `ts` skips just that entry.\n *\n * model / agent (api_conversation_history.json): scan every\n * <environment_details>…</environment_details> block for <model>, <slug>, <name>\n * tags; the LAST <model> wins (default \"unknown\"); agent prefers <slug> then\n * <name> (optional). When the sibling file is absent/unreadable: model \"unknown\",\n * no agent — exactly the Rust read_task_metadata fallback.\n *\n * session id is the taskId — the parent directory name of ui_messages.json\n * (port of extract_session_id), defaulting to \"unknown\". provider from\n * apiProtocol (trimmed, default \"unknown\"). No project attribution (Roo Code's\n * logs carry no cwd). No dedup — one row per api_req_started event. Confidence is\n * \"host-reported\".\n *\n * Fail-open: no root → []; unreadable/malformed file, entry, or payload → skipped\n * (never throws). Read-only.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir, platform as osPlatform } from \"node:os\";\nimport { basename, dirname, isAbsolute, join, resolve } from \"node:path\";\n\nimport type { UsageReader, UsageRecord } from \"../types.js\";\nimport { emptyTokens } from \"../aggregate.js\";\nimport { readJsonFile } from \"../jsonl.js\";\nimport { expandHome, walkFiles } from \"../paths.js\";\n\nconst PLATFORM_ID = \"roo-code\" as const;\nconst DEFAULT_MODEL = \"unknown\";\nconst DEFAULT_PROVIDER = \"unknown\";\nconst DEFAULT_SESSION = \"unknown\";\n\n/** Roo Code extension id → its VS Code globalStorage folder. */\nconst ROO_EXTENSION_ID = \"rooveterinaryinc.roo-cline\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Storage-root resolution (mirrors adapters/roo-code vscodeUserDir + the\n// AGENT_CONNECTOR_<PLATFORM>_DIR env convention in paths.ts hostRoots)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Resolve the cross-OS VS Code per-user \"User\" dir (the globalStorage parent). */\nfunction vscodeUserDir(): string {\n  const home = homedir();\n  switch (osPlatform()) {\n    case \"darwin\":\n      return join(home, \"Library\", \"Application Support\", \"Code\", \"User\");\n    case \"win32\": {\n      const appData = process.env.APPDATA ?? join(home, \"AppData\", \"Roaming\");\n      return join(appData, \"Code\", \"User\");\n    }\n    default:\n      return join(home, \".config\", \"Code\", \"User\");\n  }\n}\n\n/**\n * The `tasks` root holding per-task subdirectories. Honors an\n * AGENT_CONNECTOR_ROO_CODE_DIR override (verbatim, non-empty, ~-expanded,\n * resolved against CWD when relative), else the extension's globalStorage tasks\n * dir under the resolved VS Code user dir.\n */\nfunction tasksRoot(): string {\n  const raw = process.env.AGENT_CONNECTOR_ROO_CODE_DIR;\n  if (raw != null && raw.trim() !== \"\") {\n    const expanded = expandHome(raw.trim());\n    return isAbsolute(expanded) ? expanded : resolve(expanded);\n  }\n  return join(vscodeUserDir(), \"globalStorage\", ROO_EXTENSION_ID, \"tasks\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Value coercion (ports of utils.rs extract_i64 / extract_f64 / parse_timestamp_str)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Port of extract_i64: number / numeric-string → integer, else undefined. */\nfunction extractI64(v: unknown): number | undefined {\n  if (typeof v === \"number\") {\n    if (!Number.isFinite(v)) return undefined;\n    return Math.trunc(v);\n  }\n  if (typeof v === \"string\") {\n    const trimmed = v.trim();\n    if (!/^[+-]?\\d+$/.test(trimmed)) return undefined; // Rust parses as i64 (integer-only)\n    const n = Number(trimmed);\n    return Number.isFinite(n) ? Math.trunc(n) : undefined;\n  }\n  return undefined;\n}\n\n/** A non-negative integer from a payload field (0 on absence/garbage, clamped ≥ 0). */\nfunction tokenField(v: unknown): number {\n  const n = extractI64(v);\n  return n === undefined ? 0 : Math.max(0, n);\n}\n\n/** Port of extract_f64: number / numeric-string → f64, else undefined. */\nfunction extractF64(v: unknown): number | undefined {\n  if (typeof v === \"number\") return Number.isFinite(v) ? v : undefined;\n  if (typeof v === \"string\") {\n    const n = Number(v.trim());\n    return Number.isFinite(n) ? n : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Port of utils.rs parse_timestamp_str / parse_entry_timestamp: an RFC3339 string\n * → epoch ms; an integer (string or number) → ms (×1000 when below the 1e12 ms\n * threshold); rejects ≤ 0. Returns null when unusable so the entry is skipped.\n */\nfunction parseEntryTimestamp(v: unknown): number | null {\n  let s: string;\n  if (typeof v === \"string\") s = v;\n  else if (typeof v === \"number\" && Number.isFinite(v)) s = String(Math.trunc(v));\n  else return null;\n\n  return parseTimestampStr(s);\n}\n\nfunction parseTimestampStr(value: string): number | null {\n  const ms = Date.parse(value);\n  if (!Number.isNaN(ms)) return ms; // RFC3339 / any Date-parseable form\n\n  if (/^[+-]?\\d+$/.test(value.trim())) {\n    const numeric = Number(value.trim());\n    if (!Number.isFinite(numeric) || numeric <= 0) return null;\n    return numeric >= 1_000_000_000_000 ? numeric : numeric * 1000;\n  }\n  return null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// session id (port of extract_session_id)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Session id = the parent directory (taskId) of ui_messages.json, else \"unknown\". */\nfunction extractSessionId(path: string): string {\n  const parent = basename(dirname(path));\n  return parent !== \"\" ? parent : DEFAULT_SESSION;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// model / agent (ports of read_task_metadata / extract_model_and_agent / extract_tag_value)\n// ─────────────────────────────────────────────────────────────────────────\n\ninterface TaskMetadata {\n  model: string;\n  agent?: string;\n}\n\n/** Read the sibling api_conversation_history.json for model/agent (fail-open). */\nfunction readTaskMetadata(uiMessagesPath: string): TaskMetadata {\n  const historyPath = join(dirname(uiMessagesPath), \"api_conversation_history.json\");\n  let content: string;\n  try {\n    content = readFileSync(historyPath, \"utf8\");\n  } catch {\n    return { model: DEFAULT_MODEL }; // missing/unreadable → (\"unknown\", None)\n  }\n  return extractModelAndAgent(content);\n}\n\n/**\n * Scan every <environment_details>…</environment_details> block, extracting\n * <model>, <slug>, <name>. The LAST non-empty value of each tag wins (port of the\n * Rust last_* accumulation). model defaults to \"unknown\"; agent prefers slug then\n * name (and is omitted when neither is present).\n */\nfunction extractModelAndAgent(content: string): TaskMetadata {\n  const ENV_START = \"<environment_details>\";\n  const ENV_END = \"</environment_details>\";\n\n  let offset = 0;\n  let lastModel: string | undefined;\n  let lastSlug: string | undefined;\n  let lastName: string | undefined;\n\n  for (;;) {\n    const startRel = content.indexOf(ENV_START, offset);\n    if (startRel < 0) break;\n    const startIdx = startRel + ENV_START.length;\n\n    const endRel = content.indexOf(ENV_END, startIdx);\n    if (endRel < 0) break;\n\n    const block = content.slice(startIdx, endRel);\n\n    const model = extractTagValue(block, \"model\");\n    if (model !== undefined) lastModel = model;\n    const slug = extractTagValue(block, \"slug\");\n    if (slug !== undefined) lastSlug = slug;\n    const name = extractTagValue(block, \"name\");\n    if (name !== undefined) lastName = name;\n\n    offset = endRel + ENV_END.length;\n  }\n\n  const agent = lastSlug ?? lastName;\n  const result: TaskMetadata = { model: lastModel ?? DEFAULT_MODEL };\n  if (agent !== undefined) result.agent = agent;\n  return result;\n}\n\n/** First <tag>…</tag> value in `block`, trimmed; undefined when absent or empty. */\nfunction extractTagValue(block: string, tag: string): string | undefined {\n  const open = `<${tag}>`;\n  const close = `</${tag}>`;\n\n  const openIdx = block.indexOf(open);\n  if (openIdx < 0) return undefined;\n  const start = openIdx + open.length;\n  const endRel = block.indexOf(close, start);\n  if (endRel < 0) return undefined;\n\n  const value = block.slice(start, endRel).trim();\n  return value === \"\" ? undefined : value;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// api_req_started payload (port of parse_api_req_started_payload + provider_from_api_protocol)\n// ─────────────────────────────────────────────────────────────────────────\n\ninterface ApiReqStartedPayload {\n  cost: number;\n  tokensIn: number;\n  tokensOut: number;\n  cacheReads: number;\n  cacheWrites: number;\n  apiProtocol?: string;\n}\n\n/** Parse the JSON-in-string `text` payload of an api_req_started entry. */\nfunction parseApiReqStartedPayload(text: string): ApiReqStartedPayload | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n  if (typeof value !== \"object\" || value === null) return undefined;\n  const obj = value as Record<string, unknown>;\n\n  // cost: extract_f64(.cost).unwrap_or(0.0).max(0.0)\n  const cost = Math.max(0, extractF64(obj[\"cost\"]) ?? 0);\n  const apiProtocolRaw = typeof obj[\"apiProtocol\"] === \"string\" ? (obj[\"apiProtocol\"] as string) : undefined;\n\n  const payload: ApiReqStartedPayload = {\n    cost,\n    tokensIn: tokenField(obj[\"tokensIn\"]),\n    tokensOut: tokenField(obj[\"tokensOut\"]),\n    cacheReads: tokenField(obj[\"cacheReads\"]),\n    cacheWrites: tokenField(obj[\"cacheWrites\"]),\n  };\n  if (apiProtocolRaw !== undefined) payload.apiProtocol = apiProtocolRaw;\n  return payload;\n}\n\n/** Provider from apiProtocol: trimmed, non-empty, else \"unknown\" (verbatim — no inference). */\nfunction providerFromApiProtocol(apiProtocol: string | undefined): string {\n  if (apiProtocol === undefined) return DEFAULT_PROVIDER;\n  const trimmed = apiProtocol.trim();\n  return trimmed === \"\" ? DEFAULT_PROVIDER : trimmed;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// File parse (port of parse_roo_kilo_file with source \"roocode\")\n// ─────────────────────────────────────────────────────────────────────────\n\n/** The fields we read off a ui_messages.json entry (all optional / unknown). */\ninterface UiMessageEntry {\n  type?: unknown;\n  say?: unknown;\n  text?: unknown;\n  ts?: unknown;\n}\n\n/** Parse one task's ui_messages.json into usage records. */\nfunction parseRooCodeFile(path: string): UsageRecord[] {\n  const data = readJsonFile(path);\n  if (!Array.isArray(data)) return []; // malformed / non-array → no rows\n\n  const sessionId = extractSessionId(path);\n  const { model, agent } = readTaskMetadata(path);\n\n  const out: UsageRecord[] = [];\n  for (const raw of data) {\n    if (typeof raw !== \"object\" || raw === null) continue;\n    const entry = raw as UiMessageEntry;\n\n    if (entry.type !== \"say\" || entry.say !== \"api_req_started\") continue;\n\n    if (typeof entry.text !== \"string\") continue; // None => skip\n    const ts = parseEntryTimestamp(entry.ts);\n    if (ts === null) continue; // unparseable ts => skip\n\n    const payload = parseApiReqStartedPayload(entry.text);\n    if (payload === undefined) continue; // malformed payload => skip\n\n    const providerId = providerFromApiProtocol(payload.apiProtocol);\n\n    const tokens = emptyTokens();\n    tokens.input = payload.tokensIn;\n    tokens.output = payload.tokensOut;\n    tokens.cacheRead = payload.cacheReads;\n    tokens.cacheWrite = payload.cacheWrites;\n    // reasoning stays 0 (Roo Code does not report it).\n\n    const record: UsageRecord = {\n      platformId: PLATFORM_ID,\n      modelId: model,\n      providerId,\n      sessionId,\n      tokens,\n      ts,\n      messageCount: 1,\n      confidence: \"host-reported\",\n    };\n    if (payload.cost > 0) record.cost = payload.cost;\n    if (agent !== undefined) record.agent = agent;\n    out.push(record);\n  }\n\n  return out;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Reader singleton\n// ─────────────────────────────────────────────────────────────────────────\n\n/** The Roo Code (VS Code extension) usage reader singleton. */\nconst rooCodeReader: UsageReader = {\n  platformId: PLATFORM_ID,\n  kind: \"local\",\n  async read({ sinceMs }: { sinceMs?: number }): Promise<UsageRecord[]> {\n    const root = tasksRoot();\n    if (!existsSync(root)) return []; // no tasks dir → fail-open\n\n    // <root>/<taskId>/ui_messages.json\n    const files = walkFiles(root, (name, abs) => {\n      return name === \"ui_messages.json\" && /[\\\\/]ui_messages\\.json$/.test(abs);\n    });\n\n    const records: UsageRecord[] = [];\n    for (const file of files) {\n      let rows: UsageRecord[];\n      try {\n        rows = parseRooCodeFile(file);\n      } catch {\n        continue; // fail-open per file\n      }\n      for (const row of rows) {\n        if (sinceMs !== undefined && row.ts < sinceMs) continue;\n        records.push(row);\n      }\n    }\n    return records;\n  },\n};\n\nexport default rooCodeReader;\n"],"mappings":"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","names":[]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,157 @@
+import { c as HookEventName, h as PlatformId } from '../types-CYUB1OTr.js';
+
+/**
+ * runtime/hook-entrypoint — the universal json-stdio hook dispatcher.
+ *
+ * Every json-stdio host points its hook config at the single stable home binary
+ * (`<homeBin> hook <platformId> <event> --connector <id>`, built by
+ * core/spawn.buildHomeBinHookCommand). The CLI reads stdin and calls
+ * {@link runHook} with the parsed flags + the raw stdin string. This module:
+ *
+ *   1. Loads the registered connector (live handlers) and the host adapter.
+ *   2. Parses the host's stdin payload into a normalized event via the adapter.
+ *   3. Finds the connector's handler for the event, honoring the tool matcher.
+ *   4. Runs the handler, normalizes its return, and formats the adapter's native
+ *      reply.
+ *
+ * Fail-open is the safety contract: ANY error degrades to exit 0 ("allow") so a
+ * framework or handler bug can never wedge a host's tool call — EXCEPT when the
+ * event is PreToolUse and the handler explicitly denied, in which case the deny
+ * (a deliberate security decision) is preserved rather than swallowed.
+ */
+
+/** Flags + stdin the CLI hands to {@link runHook}. */
+interface RunHookOptions {
+    /** Host platform id from the hook command (`hook <platformId> ...`). */
+    platformId: string;
+    /** Canonical lifecycle event name from the hook command. */
+    event: HookEventName;
+    /** Connector id from `--connector <id>`. */
+    connectorId: string;
+    /** Raw stdin payload (host-native JSON). Empty string is tolerated → `{}`. */
+    stdin: string;
+}
+/** Process-level result the CLI translates into exit code + stdout/stderr. */
+interface RunHookResult {
+    exitCode: number;
+    stdout?: string;
+    stderr?: string;
+}
+/**
+ * Dispatch one host hook invocation. Always resolves (never rejects): every
+ * failure path returns a concrete {@link RunHookResult} so the CLI can exit
+ * cleanly. See the module header for the fail-open contract.
+ */
+declare function runHook(opts: RunHookOptions): Promise<RunHookResult>;
+
+/**
+ * telemetry/types — runtime telemetry contracts.
+ *
+ * The framework measures the MCP server's OWN bytes (tool args in, tool result
+ * out, tool-definition schemas) and tokenizes them locally — the only signal
+ * identical across every host (no host reports per-tool usage to a server).
+ * Records are aggregate counts only; raw arguments/results are NEVER stored.
+ */
+
+/**
+ * The install scope a wrapped server was deployed under, narrowed to the two
+ * dimensions that matter for slicing telemetry: a `user`-global install vs a
+ * `project`-local one. The framework's broader {@link InstallScope}
+ * (`system|user|project|profile|managed`) is mapped down to this at wrap time —
+ * everything that is not project-local reads as `user`. Optional on the record
+ * so rows written before this field existed are treated as "unknown".
+ */
+type TelemetryInstallScope = "user" | "project";
+
+/**
+ * runtime/serve — the `agent-connector serve` telemetry-wrapping entrypoint.
+ *
+ * When a stdio MCP server opts into transparent telemetry, its host config is
+ * rewritten (by the adapter, via core/spawn.buildServeWrapperCommand) to launch
+ *   <homeBin> serve --connector <id> -- <realCommand> <realArgs...>
+ * instead of the server directly. The CLI parses those flags and calls
+ * {@link runServe}, which stands up the per-session telemetry context (store,
+ * tokenizer, project identity, host detection) and hands off to the proxy.
+ *
+ * The proxy (telemetry/proxy.runServeProxy) forwards bytes VERBATIM in both
+ * directions and measures aggregate per-tool token counts out of band, so this
+ * wrapper is transparent to both the host and the real server. It resolves with
+ * the child server's exit code, which the CLI uses as its own.
+ */
+
+/** Flags the CLI hands to {@link runServe}. */
+interface RunServeOptions {
+    /** Connector id from `--connector <id>`; selects telemetry config + stamps records. */
+    connectorId: string;
+    /** The real MCP server executable to spawn (everything after `--`). */
+    serverCommand: string;
+    /** Arguments passed to that executable. */
+    serverArgs: string[];
+    /**
+     * Install scope from `--scope <user|project>`. OPTIONAL: absent for configs
+     * written before scope plumbing existed — left unstamped so older rows read
+     * as "unknown". Stamped verbatim onto every telemetry record when present.
+     */
+    installScope?: TelemetryInstallScope;
+    /**
+     * Install TARGET platform id from `--host <platformId>` (baked into the
+     * wrapper at install time). OPTIONAL: when a recognized platform id, it
+     * OVERRIDES runtime env detection so headless spawns stamp hostPlatform
+     * correctly (detectRuntimeHost only knows env markers for a few hosts and
+     * otherwise mis-attributes). Absent/unrecognized → fall back to detection.
+     */
+    hostPlatformOverride?: PlatformId;
+}
+declare function runServe(opts: RunServeOptions): Promise<number>;
+
+/**
+ * runtime/usage-event — the OPT-IN host-native turn-usage enricher (enricher 4a).
+ *
+ * Gemini CLI / Antigravity fire an `AfterModel` (Antigravity CLI: `PostInvocation`)
+ * hook AFTER each model turn, whose stdin payload carries a `usageMetadata` block
+ * with the host's OWN exact token accounting for that whole conversation turn:
+ *   { promptTokenCount, candidatesTokenCount, cachedContentTokenCount,
+ *     thoughtsTokenCount, totalTokenCount }
+ * This is the single point in the whole matrix where a host reports REAL per-turn
+ * usage to a command we control — so we record it as `confidenceSource:"host-native"`
+ * (the top of CONFIDENCE_RANK), upgrading those rows from the serve-proxy estimate.
+ *
+ * DISTINCT, NEVER-SUMMED ORIGIN. Host-native turn usage is WHOLE-CONVERSATION, not
+ * per-MCP. To avoid double-counting against (a) the per-MCP serve-proxy `call`
+ * rows and (b) the usage-reader host-scan numbers, every record written here uses
+ * the DISTINCT scope `"model_turn"`. The MCP leaderboard excludes that scope (just
+ * as it special-cases `tool_defs`); the unified leaderboard surfaces it as its own
+ * clearly-labeled section that is explicitly never added to the other two origins.
+ *
+ * PRIVACY + FAIL-OPEN. This enricher is OPT-IN at install time (see the adapters);
+ * it stores AGGREGATE COUNTS ONLY (no raw content — the payload's prompt/response
+ * text is never read). ANY parse / store / IO error degrades to exit 0 and records
+ * NOTHING: a host-native usage hook must never break a model turn. This function
+ * never throws.
+ */
+/** Flags + stdin the CLI hands to {@link runUsageEvent}. */
+interface RunUsageEventOptions {
+    /** Host platform id from the command (`usage-event <platformId> …`). */
+    platformId: string;
+    /** Connector id from `--connector <id>` (stamped on the record). */
+    connectorId: string;
+    /** Raw stdin payload (host-native JSON). Empty string is tolerated → no record. */
+    stdin: string;
+}
+/** Process-level result the CLI translates into an exit code. */
+interface RunUsageEventResult {
+    /** Always 0 — a host-native usage hook must never block a model turn. */
+    exitCode: number;
+    /** True when a `model_turn` record was appended (false on any fail-open path). */
+    recorded: boolean;
+}
+/**
+ * Record one host-native model turn. Parses the host's `usageMetadata`, maps it to
+ * a DISTINCT `model_turn` `ToolEventRecord` (confidence `host-native`, toolName
+ * `"*"`), and appends it to the shared telemetry store. NEVER throws and never
+ * blocks the turn: every failure path resolves to {@link NOOP} (exit 0, nothing
+ * recorded).
+ */
+declare function runUsageEvent(opts: RunUsageEventOptions): Promise<RunUsageEventResult>;
+
+export { type RunHookOptions, type RunHookResult, type RunServeOptions, type RunUsageEventOptions, type RunUsageEventResult, runHook, runServe, runUsageEvent };

package/dist/runtime/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import {
+  runHook,
+  runServe,
+  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";
+export {
+  runHook,
+  runServe,
+  runUsageEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/serve-HVWWY4B6.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import {
+  fail
+} from "./chunk-54EMKTTX.js";
+import {
+  runServe
+} 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/serve.ts
+import { parseArgs } from "util";
+async function run(argv) {
+  const sepIndex = argv.indexOf("--");
+  if (sepIndex === -1) {
+    return fail(
+      "usage: agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <command> [args...]"
+    );
+  }
+  const flagArgs = argv.slice(0, sepIndex);
+  const serverInvocation = argv.slice(sepIndex + 1);
+  const { values } = parseArgs({
+    args: flagArgs,
+    options: {
+      connector: { type: "string" },
+      scope: { type: "string" },
+      // `--host <platformId>` bakes the install TARGET platform into the wrapper
+      // so the proxy stamps hostPlatform correctly under a headless spawn (where
+      // runtime env markers are absent). Optional + tolerated (strict:false).
+      host: { type: "string" }
+    },
+    allowPositionals: true,
+    strict: false
+  });
+  const connectorId = typeof values.connector === "string" ? values.connector : void 0;
+  if (!connectorId || connectorId.trim() === "") {
+    return fail("serve requires --connector <id>");
+  }
+  const rawScope = values.scope;
+  const installScope = rawScope === "user" || rawScope === "project" ? rawScope : void 0;
+  const hostPlatformOverride = typeof values.host === "string" ? values.host : void 0;
+  const serverCommand = serverInvocation[0];
+  if (!serverCommand) {
+    return fail("serve requires a command after `--`");
+  }
+  const serverArgs = serverInvocation.slice(1);
+  const code = await runServe({
+    connectorId,
+    serverCommand,
+    serverArgs,
+    installScope,
+    hostPlatformOverride
+  });
+  process.exit(code);
+}
+export {
+  run
+};
+//# sourceMappingURL=serve-HVWWY4B6.js.map

package/dist/serve-HVWWY4B6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/serve.ts"],"sourcesContent":["/**\n * cli/commands/serve — the telemetry-wrapping MCP stdio proxy entrypoint.\n *\n *   agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <realCommand> <realArgs...>\n *\n * A stdio MCP server that opts into transparent telemetry has its host config\n * rewritten to launch THIS instead of the server directly. We split argv at the\n * literal `--` separator: flags on the left, the real server command + args on\n * the right (taken verbatim). The optional `--scope` flag records the install\n * dimension (global user vs project-local) onto telemetry; it is absent for\n * configs written before scope plumbing existed → the runtime reads \"unknown\".\n * The optional `--host` flag carries the install TARGET platform id so the proxy\n * stamps hostPlatform correctly under a headless spawn; absent configs fall back\n * to runtime env detection.\n * runServe stands up the per-session telemetry context and proxies bytes both\n * ways, resolving with the child's exit code.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport type { PlatformId } from \"../../core/types.js\";\nimport type { TelemetryInstallScope } from \"../../telemetry/types.js\";\nimport { runServe } from \"../../runtime/index.js\";\nimport { fail } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  // Split at the FIRST literal \"--\": everything after it is the real server\n  // invocation and must be passed through verbatim (never re-parsed as flags).\n  const sepIndex = argv.indexOf(\"--\");\n  if (sepIndex === -1) {\n    return fail(\n      \"usage: agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <command> [args...]\",\n    );\n  }\n  const flagArgs = argv.slice(0, sepIndex);\n  const serverInvocation = argv.slice(sepIndex + 1);\n\n  // strict:false so an unknown FUTURE flag before `--` (written by a newer host\n  // config) is ignored instead of throwing — a parse throw here would prevent the\n  // real MCP server from ever spawning and wedge the host's tool call. We only\n  // read the two flags we understand; everything else is tolerated.\n  const { values } = parseArgs({\n    args: flagArgs,\n    options: {\n      connector: { type: \"string\" },\n      scope: { type: \"string\" },\n      // `--host <platformId>` bakes the install TARGET platform into the wrapper\n      // so the proxy stamps hostPlatform correctly under a headless spawn (where\n      // runtime env markers are absent). Optional + tolerated (strict:false).\n      host: { type: \"string\" },\n    },\n    allowPositionals: true,\n    strict: false,\n  });\n\n  // With strict:false, parseArgs types each value as string | boolean; we only\n  // accept the string form (a bare `--connector` flag with no value is invalid).\n  const connectorId = typeof values.connector === \"string\" ? values.connector : undefined;\n  if (!connectorId || connectorId.trim() === \"\") {\n    return fail(\"serve requires --connector <id>\");\n  }\n\n  // `--scope` is optional and only ever \"user\" | \"project\" (the wrapper emits\n  // exactly those). An unrecognized value is ignored rather than fatal so a\n  // future/older wrapper can never break a real tool call over a flag mismatch.\n  const rawScope = values.scope;\n  const installScope: TelemetryInstallScope | undefined =\n    rawScope === \"user\" || rawScope === \"project\" ? rawScope : undefined;\n\n  // `--host` carries the install TARGET platform id (string only). runServe\n  // validates it against the registry and falls back to runtime detection when\n  // it is absent or unrecognized — so a future/older wrapper never breaks here.\n  const hostPlatformOverride =\n    typeof values.host === \"string\" ? (values.host as PlatformId) : undefined;\n\n  const serverCommand = serverInvocation[0];\n  if (!serverCommand) {\n    return fail(\"serve requires a command after `--`\");\n  }\n  const serverArgs = serverInvocation.slice(1);\n\n  const code = await runServe({\n    connectorId,\n    serverCommand,\n    serverArgs,\n    installScope,\n    hostPlatformOverride,\n  });\n  process.exit(code);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAS,iBAAiB;AAO1B,eAAsB,IAAI,MAAiC;AAGzD,QAAM,WAAW,KAAK,QAAQ,IAAI;AAClC,MAAI,aAAa,IAAI;AACnB,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACA,QAAM,WAAW,KAAK,MAAM,GAAG,QAAQ;AACvC,QAAM,mBAAmB,KAAK,MAAM,WAAW,CAAC;AAMhD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,OAAO,EAAE,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA,MAIxB,MAAM,EAAE,MAAM,SAAS;AAAA,IACzB;AAAA,IACA,kBAAkB;AAAA,IAClB,QAAQ;AAAA,EACV,CAAC;AAID,QAAM,cAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAC9E,MAAI,CAAC,eAAe,YAAY,KAAK,MAAM,IAAI;AAC7C,WAAO,KAAK,iCAAiC;AAAA,EAC/C;AAKA,QAAM,WAAW,OAAO;AACxB,QAAM,eACJ,aAAa,UAAU,aAAa,YAAY,WAAW;AAK7D,QAAM,uBACJ,OAAO,OAAO,SAAS,WAAY,OAAO,OAAsB;AAElE,QAAM,gBAAgB,iBAAiB,CAAC;AACxC,MAAI,CAAC,eAAe;AAClB,WAAO,KAAK,qCAAqC;AAAA,EACnD;AACA,QAAM,aAAa,iBAAiB,MAAM,CAAC;AAE3C,QAAM,OAAO,MAAM,SAAS;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,IAAI;AACnB;","names":[]}

package/dist/status-FE7TECZD.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import {
+  fail,
+  parseScope,
+  print
+} from "./chunk-54EMKTTX.js";
+import {
+  detectInstalledPlatforms,
+  loadAdapter
+} from "./chunk-XUCWLJY5.js";
+import {
+  findConnectorConfig,
+  listRegisteredConnectors,
+  loadConnectorFromPath
+} from "./chunk-LTT56GI3.js";
+import "./chunk-XNAM7F35.js";
+import {
+  dataRoot,
+  homeBinPath
+} from "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/status.ts
+import { parseArgs } from "util";
+import { readFileSync } from "fs";
+async function resolveConnectors(connectorPath, projectDir) {
+  const configPath = connectorPath ?? findConnectorConfig(projectDir);
+  if (configPath) {
+    try {
+      const { connector } = await loadConnectorFromPath(configPath);
+      return [connector];
+    } catch {
+    }
+  }
+  return listRegisteredConnectors();
+}
+function buildContext(connector, id, scope, projectDir) {
+  return {
+    connector,
+    scope: connector.platforms[id]?.scope ?? scope,
+    projectDir,
+    homeBinPath: homeBinPath(),
+    dataRoot: dataRoot(),
+    dryRun: true
+  };
+}
+function fileMentions(path, needle) {
+  try {
+    return readFileSync(path, "utf8").includes(needle);
+  } catch {
+    return false;
+  }
+}
+async function run(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      scope: { type: "string", default: "user" },
+      connector: { type: "string" },
+      project: { type: "string" },
+      json: { type: "boolean", default: false }
+    },
+    allowPositionals: false
+  });
+  const projectDir = values.project ?? process.cwd();
+  const scope = parseScope(values.scope);
+  if (scope == null) return fail(`invalid --scope "${values.scope}" (use user|project)`);
+  const connectors = await resolveConnectors(values.connector, projectDir);
+  const detected = await detectInstalledPlatforms(projectDir);
+  const rows = [];
+  for (const p of detected) {
+    const adapter = await loadAdapter(p.id);
+    if (!adapter) continue;
+    const connStatuses = connectors.map((connector) => {
+      const ctx = buildContext(connector, p.id, scope, projectDir);
+      let serverPath = "";
+      let hookPath = "";
+      try {
+        serverPath = adapter.getServerConfigPath(ctx);
+      } catch {
+      }
+      try {
+        hookPath = adapter.getHookConfigPath(ctx);
+      } catch {
+      }
+      return {
+        id: connector.id,
+        serverPresent: serverPath ? fileMentions(serverPath, connector.id) : false,
+        hooksPresent: hookPath ? fileMentions(hookPath, connector.id) : false
+      };
+    });
+    rows.push({
+      platform: p.id,
+      scope: p.scope,
+      configPath: p.configPath,
+      connectors: connStatuses
+    });
+  }
+  if (values.json) {
+    print(JSON.stringify(rows, null, 2));
+    return 0;
+  }
+  if (rows.length === 0) {
+    print("status: no agent platforms detected.");
+    return 0;
+  }
+  if (connectors.length === 0) {
+    print("status: no connectors found (pass --connector <path> or install one).\n");
+  }
+  for (const r of rows) {
+    print(`${r.platform}  [${r.scope}]  ${r.configPath}`);
+    if (r.connectors.length === 0) {
+      print("  (no connectors to check)");
+    } else {
+      for (const c of r.connectors) {
+        const mark = c.serverPresent || c.hooksPresent ? "[installed]" : "[absent   ]";
+        const server = c.serverPresent ? "server \u2713" : "server \xB7";
+        const hooks = c.hooksPresent ? "hooks \u2713" : "hooks \xB7";
+        print(`  ${mark} ${c.id}  ${server}  ${hooks}`);
+      }
+    }
+    print("");
+  }
+  return 0;
+}
+export {
+  run
+};
+//# sourceMappingURL=status-FE7TECZD.js.map