@ken-jo/agent-connector 0.1.0

package/dist/hermes-ZYLMOFLZ.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+import {
+  openSqlite
+} from "./chunk-YT43MUSJ.js";
+import {
+  firstExistingRoot
+} from "./chunk-JWNT5KW7.js";
+import {
+  emptyTokens,
+  inferProvider
+} from "./chunk-XD7MY6HB.js";
+
+// src/usage/readers/hermes.ts
+import { join } from "path";
+var PLATFORM_ID = "hermes";
+var DEFAULT_PROVIDER = "hermes";
+var HERMES_AGENT_NAME = "Hermes Agent";
+var QUERY = `
+  SELECT
+    id,
+    model,
+    billing_provider,
+    started_at,
+    message_count,
+    input_tokens,
+    output_tokens,
+    cache_read_tokens,
+    cache_write_tokens,
+    reasoning_tokens,
+    estimated_cost_usd,
+    actual_cost_usd
+  FROM sessions
+  WHERE model IS NOT NULL
+    AND TRIM(model) != ''
+    AND (
+      COALESCE(input_tokens, 0) > 0 OR
+      COALESCE(output_tokens, 0) > 0 OR
+      COALESCE(cache_read_tokens, 0) > 0 OR
+      COALESCE(cache_write_tokens, 0) > 0 OR
+      COALESCE(reasoning_tokens, 0) > 0 OR
+      COALESCE(actual_cost_usd, estimated_cost_usd, 0) > 0
+    )
+`;
+function resolveDbPath() {
+  const home = process.env.HERMES_HOME;
+  if (home != null && home.trim() !== "") {
+    const candidate = join(home.trim(), "state.db");
+    return candidate;
+  }
+  return firstExistingRoot(PLATFORM_ID);
+}
+function canonicalizeProviderSegment(segment) {
+  const normalized = segment.trim().replace(/\/+$/, "").toLowerCase().replace(/-/g, "_");
+  if (normalized.startsWith("<") && normalized.endsWith(">")) return void 0;
+  switch (normalized) {
+    case "":
+    case "unknown":
+      return void 0;
+    case "x_ai":
+    case "xai":
+      return "xai";
+    case "z_ai":
+    case "zai":
+      return "zai";
+    case "moonshot":
+    case "moonshotai":
+      return "moonshotai";
+    case "meta":
+    case "meta_llama":
+      return "meta_llama";
+    case "azure":
+    case "azure_ai":
+      return "azure_ai";
+    case "anthropic":
+    case "vertex":
+    case "vertex_ai":
+      return "anthropic";
+    case "together":
+    case "together_ai":
+      return "together_ai";
+    case "fireworks":
+    case "fireworks_ai":
+      return "fireworks_ai";
+    case "google":
+    case "gemini":
+      return "google";
+    case "openai":
+    case "openai_codex":
+      return "openai";
+    case "minimax":
+    case "minimaxai":
+    case "minimax_ai":
+      return "minimax";
+    case "mistral":
+    case "mistralai":
+      return "mistralai";
+    case "ai21":
+      return "ai21";
+    default:
+      if (/[0-9]/.test(normalized)) return void 0;
+      return normalized;
+  }
+}
+function canonicalProvider(raw) {
+  for (const segment of raw.trim().replace(/\/+$/, "").split("/")) {
+    const tag = canonicalizeProviderSegment(segment);
+    if (tag !== void 0) return tag;
+    if (segment.includes(".")) {
+      for (const dotted of segment.split(".")) {
+        const dottedTag = canonicalizeProviderSegment(dotted);
+        if (dottedTag !== void 0) return dottedTag;
+      }
+    }
+  }
+  return void 0;
+}
+function resolvedProvider(billingProvider, modelId) {
+  if (typeof billingProvider === "string") {
+    const trimmed = billingProvider.trim();
+    if (trimmed !== "") {
+      const canonical = canonicalProvider(trimmed);
+      if (canonical !== void 0) return canonical;
+    }
+  }
+  return inferProvider(modelId) ?? DEFAULT_PROVIDER;
+}
+function tokenCell(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  if (!Number.isFinite(n)) return 0;
+  return Math.max(0, Math.trunc(n));
+}
+function floatOrNull(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  return Number.isFinite(n) ? n : null;
+}
+function timestampSecsToMs(timestamp) {
+  return timestamp > 1e12 ? Math.trunc(timestamp) : Math.trunc(timestamp * 1e3);
+}
+var hermesReader = {
+  platformId: PLATFORM_ID,
+  kind: "local",
+  async read({ sinceMs }) {
+    const dbPath = resolveDbPath();
+    if (dbPath === void 0) return [];
+    const db = await openSqlite(dbPath);
+    if (db === null) return [];
+    try {
+      const rows = db.all(QUERY);
+      const records = [];
+      for (const raw of rows) {
+        const row = raw;
+        const sessionId = row.id;
+        if (typeof sessionId !== "string" || sessionId === "") continue;
+        const modelId = row.model;
+        if (typeof modelId !== "string" || modelId.trim() === "") continue;
+        const startedAt = floatOrNull(row.started_at) ?? 0;
+        const ts = timestampSecsToMs(startedAt);
+        if (sinceMs !== void 0 && ts < sinceMs) continue;
+        const providerId = resolvedProvider(row.billing_provider, modelId);
+        const tokens = emptyTokens();
+        tokens.input = tokenCell(row.input_tokens);
+        tokens.output = tokenCell(row.output_tokens);
+        tokens.cacheRead = tokenCell(row.cache_read_tokens);
+        tokens.cacheWrite = tokenCell(row.cache_write_tokens);
+        tokens.reasoning = tokenCell(row.reasoning_tokens);
+        const actual = floatOrNull(row.actual_cost_usd);
+        const estimated = floatOrNull(row.estimated_cost_usd);
+        const cost = Math.max(0, actual ?? estimated ?? 0);
+        const messageCount = tokenCell(row.message_count);
+        const record = {
+          platformId: PLATFORM_ID,
+          modelId,
+          providerId,
+          sessionId,
+          tokens,
+          cost,
+          ts,
+          messageCount,
+          dedupKey: sessionId,
+          // one row per session → session id is the dedup key
+          confidence: "host-reported",
+          agent: HERMES_AGENT_NAME
+        };
+        records.push(record);
+      }
+      return records;
+    } finally {
+      db.close();
+    }
+  }
+};
+var hermes_default = hermesReader;
+export {
+  hermes_default as default
+};
+//# sourceMappingURL=hermes-ZYLMOFLZ.js.map

package/dist/hermes-ZYLMOFLZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usage/readers/hermes.ts"],"sourcesContent":["/**\n * usage/readers/hermes — Hermes Agent usage reader (SQLite, sessions table).\n *\n * Faithful port of tokscale sessions/hermes.rs. Hermes stores one aggregated row\n * per session in a `sessions` table inside a single SQLite database:\n *   • ~/.hermes/state.db\n *   • $HERMES_HOME/state.db   (when HERMES_HOME is set, non-empty)\n * (the AGENT_CONNECTOR_HERMES_DIR override + the ~/.hermes default are resolved by\n * paths.ts hostRoots(\"hermes\"); HERMES_HOME is honored here, ahead of those, to\n * match the Rust storage-path spec which the fixed paths.ts does not encode.)\n *\n * One SELECT pulls every session that carries a model and at least one token/cost\n * signal (port of the Rust query verbatim):\n *   SELECT id, model, billing_provider, started_at, message_count,\n *          input_tokens, output_tokens, cache_read_tokens, cache_write_tokens,\n *          reasoning_tokens, estimated_cost_usd, actual_cost_usd\n *   FROM sessions\n *   WHERE model IS NOT NULL AND TRIM(model) != ''\n *     AND ( COALESCE(input_tokens,0)        > 0\n *        OR COALESCE(output_tokens,0)       > 0\n *        OR COALESCE(cache_read_tokens,0)   > 0\n *        OR COALESCE(cache_write_tokens,0)  > 0\n *        OR COALESCE(reasoning_tokens,0)    > 0\n *        OR COALESCE(actual_cost_usd, estimated_cost_usd, 0) > 0 )\n *\n * Token extraction (flat columns, no JSON nesting — each NULL → 0, clamped ≥ 0):\n *   input      = input_tokens\n *   output     = output_tokens\n *   cacheRead  = cache_read_tokens\n *   cacheWrite = cache_write_tokens\n *   reasoning  = reasoning_tokens\n * Cost = actual_cost_usd ?? estimated_cost_usd ?? 0 (clamped ≥ 0, prefer actual).\n *\n * Model: the `model` column (the WHERE already drops null/blank). Provider (port of\n * resolved_provider): canonical_provider() of a non-blank `billing_provider`, else\n * inferProvider(model), else \"hermes\". Timestamp: `started_at` (f64) disambiguated\n * seconds-vs-milliseconds (> 1e12 → ms as-is, else × 1000). Session id = the `id`\n * column, which is also the dedup key (one row per session). messageCount =\n * `message_count` (clamped ≥ 0). agent fixed to \"Hermes Agent\". No project/workspace\n * in the schema. Confidence is \"host-reported\".\n *\n * Fail-open: db missing/locked/unreadable → openSqlite returns null → []; a bad row\n * is skipped, never thrown.\n */\n\nimport { join } from \"node:path\";\n\nimport type { UsageReader, UsageRecord } from \"../types.js\";\nimport { emptyTokens } from \"../aggregate.js\";\nimport { inferProvider } from \"../normalize.js\";\nimport { firstExistingRoot } from \"../paths.js\";\nimport { openSqlite } from \"../sqlite.js\";\n\nconst PLATFORM_ID = \"hermes\" as const;\nconst DEFAULT_PROVIDER = \"hermes\";\nconst HERMES_AGENT_NAME = \"Hermes Agent\";\n\n/** The session columns we read (everything optional / unknown off the row). */\ninterface HermesRow {\n  id?: unknown;\n  model?: unknown;\n  billing_provider?: unknown;\n  started_at?: unknown;\n  message_count?: unknown;\n  input_tokens?: unknown;\n  output_tokens?: unknown;\n  cache_read_tokens?: unknown;\n  cache_write_tokens?: unknown;\n  reasoning_tokens?: unknown;\n  estimated_cost_usd?: unknown;\n  actual_cost_usd?: unknown;\n}\n\nconst QUERY = `\n  SELECT\n    id,\n    model,\n    billing_provider,\n    started_at,\n    message_count,\n    input_tokens,\n    output_tokens,\n    cache_read_tokens,\n    cache_write_tokens,\n    reasoning_tokens,\n    estimated_cost_usd,\n    actual_cost_usd\n  FROM sessions\n  WHERE model IS NOT NULL\n    AND TRIM(model) != ''\n    AND (\n      COALESCE(input_tokens, 0) > 0 OR\n      COALESCE(output_tokens, 0) > 0 OR\n      COALESCE(cache_read_tokens, 0) > 0 OR\n      COALESCE(cache_write_tokens, 0) > 0 OR\n      COALESCE(reasoning_tokens, 0) > 0 OR\n      COALESCE(actual_cost_usd, estimated_cost_usd, 0) > 0\n    )\n`;\n\n// ─────────────────────────────────────────────────────────────────────────\n// DB path resolution (honor $HERMES_HOME, ahead of paths.ts defaults)\n// ─────────────────────────────────────────────────────────────────────────\n\n/**\n * Resolve the Hermes state DB. The Rust spec lists both `~/.hermes/state.db` and\n * `$HERMES_HOME/state.db`; the fixed paths.ts only encodes the former (+ the\n * AGENT_CONNECTOR_HERMES_DIR override), so we honor HERMES_HOME first here.\n * Returns the first existing candidate, or undefined when none is present.\n */\nfunction resolveDbPath(): string | undefined {\n  const home = process.env.HERMES_HOME;\n  if (home != null && home.trim() !== \"\") {\n    const candidate = join(home.trim(), \"state.db\");\n    // existsSync is checked by openSqlite (returns null on a missing file), but we\n    // still need an explicit candidate; let firstExistingRoot cover the default.\n    return candidate;\n  }\n  return firstExistingRoot(PLATFORM_ID);\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Provider resolution (port of provider_identity.rs canonical_provider)\n// ─────────────────────────────────────────────────────────────────────────\n\n/**\n * Canonicalize a single provider segment (port of canonicalize_provider_segment):\n * trim, drop a trailing slash, lowercase, `-`→`_`; reject `<…>` placeholders, the\n * empty/`unknown` segment, and unknown segments that contain a digit (those are\n * model-name fragments). Returns the canonical id or undefined.\n */\nfunction canonicalizeProviderSegment(segment: string): string | undefined {\n  const normalized = segment.trim().replace(/\\/+$/, \"\").toLowerCase().replace(/-/g, \"_\");\n  if (normalized.startsWith(\"<\") && normalized.endsWith(\">\")) return undefined;\n  switch (normalized) {\n    case \"\":\n    case \"unknown\":\n      return undefined;\n    case \"x_ai\":\n    case \"xai\":\n      return \"xai\";\n    case \"z_ai\":\n    case \"zai\":\n      return \"zai\";\n    case \"moonshot\":\n    case \"moonshotai\":\n      return \"moonshotai\";\n    case \"meta\":\n    case \"meta_llama\":\n      return \"meta_llama\";\n    case \"azure\":\n    case \"azure_ai\":\n      return \"azure_ai\";\n    case \"anthropic\":\n    case \"vertex\":\n    case \"vertex_ai\":\n      return \"anthropic\";\n    case \"together\":\n    case \"together_ai\":\n      return \"together_ai\";\n    case \"fireworks\":\n    case \"fireworks_ai\":\n      return \"fireworks_ai\";\n    case \"google\":\n    case \"gemini\":\n      return \"google\";\n    case \"openai\":\n    case \"openai_codex\":\n      return \"openai\";\n    case \"minimax\":\n    case \"minimaxai\":\n    case \"minimax_ai\":\n      return \"minimax\";\n    case \"mistral\":\n    case \"mistralai\":\n      return \"mistralai\";\n    case \"ai21\":\n      return \"ai21\";\n    default:\n      if (/[0-9]/.test(normalized)) return undefined;\n      return normalized;\n  }\n}\n\n/**\n * Port of canonical_provider: the first canonical tag from `provider_tags(raw)`\n * (split on '/', and for any dotted segment also try its dot-parts), or undefined\n * when no segment canonicalizes — so the resolver can fall through to model\n * inference, matching the Rust `Option<String>` semantics.\n */\nfunction canonicalProvider(raw: string): string | undefined {\n  for (const segment of raw.trim().replace(/\\/+$/, \"\").split(\"/\")) {\n    const tag = canonicalizeProviderSegment(segment);\n    if (tag !== undefined) return tag;\n    if (segment.includes(\".\")) {\n      for (const dotted of segment.split(\".\")) {\n        const dottedTag = canonicalizeProviderSegment(dotted);\n        if (dottedTag !== undefined) return dottedTag;\n      }\n    }\n  }\n  return undefined;\n}\n\n/**\n * Resolve the provider (port of resolved_provider): canonical_provider of a\n * non-blank `billing_provider`, else inferProvider(model), else \"hermes\".\n */\nfunction resolvedProvider(billingProvider: unknown, modelId: string): string {\n  if (typeof billingProvider === \"string\") {\n    const trimmed = billingProvider.trim();\n    if (trimmed !== \"\") {\n      const canonical = canonicalProvider(trimmed);\n      if (canonical !== undefined) return canonical;\n    }\n  }\n  return inferProvider(modelId) ?? DEFAULT_PROVIDER;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Numbers & timestamps\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Coerce an unknown SQLite cell to an integer ≥ 0 (port of `Option<i64>?.unwrap_or(0).max(0)`). */\nfunction tokenCell(v: unknown): number {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" ? Number(v) : NaN;\n  if (!Number.isFinite(n)) return 0;\n  return Math.max(0, Math.trunc(n));\n}\n\n/** Coerce an unknown SQLite cell to a finite float, or null when absent/garbage. */\nfunction floatOrNull(v: unknown): number | null {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" ? Number(v) : NaN;\n  return Number.isFinite(n) ? n : null;\n}\n\n/**\n * Disambiguate `started_at` (f64) seconds-vs-milliseconds (port of\n * timestamp_secs_to_ms): values already in ms (> 1e12) pass through truncated to\n * an integer; smaller values are treated as seconds and scaled × 1000.\n */\nfunction timestampSecsToMs(timestamp: number): number {\n  return timestamp > 1e12 ? Math.trunc(timestamp) : Math.trunc(timestamp * 1000);\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Reader\n// ─────────────────────────────────────────────────────────────────────────\n\n/** The Hermes Agent usage reader singleton. */\nconst hermesReader: UsageReader = {\n  platformId: PLATFORM_ID,\n  kind: \"local\",\n  async read({ sinceMs }: { sinceMs?: number }): Promise<UsageRecord[]> {\n    const dbPath = resolveDbPath();\n    if (dbPath === undefined) return []; // no state.db → fail-open\n\n    const db = await openSqlite(dbPath);\n    if (db === null) return []; // missing / locked / unreadable / non-sqlite → fail-open\n\n    try {\n      const rows = db.all(QUERY); // bad SQL / schema mismatch → [] (fail-open)\n      const records: UsageRecord[] = [];\n\n      for (const raw of rows) {\n        const row = raw as HermesRow;\n\n        // id and model are read as non-null strings in the Rust decode; the WHERE\n        // clause already enforces a non-blank model, but we mirror the decode by\n        // skipping any row whose id/model is not a usable string.\n        const sessionId = row.id;\n        if (typeof sessionId !== \"string\" || sessionId === \"\") continue;\n\n        const modelId = row.model;\n        if (typeof modelId !== \"string\" || modelId.trim() === \"\") continue;\n\n        const startedAt = floatOrNull(row.started_at) ?? 0;\n        const ts = timestampSecsToMs(startedAt);\n        if (sinceMs !== undefined && ts < sinceMs) continue;\n\n        const providerId = resolvedProvider(row.billing_provider, modelId);\n\n        const tokens = emptyTokens();\n        tokens.input = tokenCell(row.input_tokens);\n        tokens.output = tokenCell(row.output_tokens);\n        tokens.cacheRead = tokenCell(row.cache_read_tokens);\n        tokens.cacheWrite = tokenCell(row.cache_write_tokens);\n        tokens.reasoning = tokenCell(row.reasoning_tokens);\n\n        // Cost: prefer actual, fall back to estimated, default 0 — clamped ≥ 0.\n        const actual = floatOrNull(row.actual_cost_usd);\n        const estimated = floatOrNull(row.estimated_cost_usd);\n        const cost = Math.max(0, actual ?? estimated ?? 0);\n\n        // message_count: Option<i32>.unwrap_or(0).max(0).\n        const messageCount = tokenCell(row.message_count);\n\n        const record: UsageRecord = {\n          platformId: PLATFORM_ID,\n          modelId,\n          providerId,\n          sessionId,\n          tokens,\n          cost,\n          ts,\n          messageCount,\n          dedupKey: sessionId, // one row per session → session id is the dedup key\n          confidence: \"host-reported\",\n          agent: HERMES_AGENT_NAME,\n        };\n        records.push(record);\n      }\n\n      return records;\n    } finally {\n      db.close();\n    }\n  },\n};\n\nexport default hermesReader;\n"],"mappings":";;;;;;;;;;;;;AA6CA,SAAS,YAAY;AAQrB,IAAM,cAAc;AACpB,IAAM,mBAAmB;AACzB,IAAM,oBAAoB;AAkB1B,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCd,SAAS,gBAAoC;AAC3C,QAAM,OAAO,QAAQ,IAAI;AACzB,MAAI,QAAQ,QAAQ,KAAK,KAAK,MAAM,IAAI;AACtC,UAAM,YAAY,KAAK,KAAK,KAAK,GAAG,UAAU;AAG9C,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,WAAW;AACtC;AAYA,SAAS,4BAA4B,SAAqC;AACxE,QAAM,aAAa,QAAQ,KAAK,EAAE,QAAQ,QAAQ,EAAE,EAAE,YAAY,EAAE,QAAQ,MAAM,GAAG;AACrF,MAAI,WAAW,WAAW,GAAG,KAAK,WAAW,SAAS,GAAG,EAAG,QAAO;AACnE,UAAQ,YAAY;AAAA,IAClB,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,UAAI,QAAQ,KAAK,UAAU,EAAG,QAAO;AACrC,aAAO;AAAA,EACX;AACF;AAQA,SAAS,kBAAkB,KAAiC;AAC1D,aAAW,WAAW,IAAI,KAAK,EAAE,QAAQ,QAAQ,EAAE,EAAE,MAAM,GAAG,GAAG;AAC/D,UAAM,MAAM,4BAA4B,OAAO;AAC/C,QAAI,QAAQ,OAAW,QAAO;AAC9B,QAAI,QAAQ,SAAS,GAAG,GAAG;AACzB,iBAAW,UAAU,QAAQ,MAAM,GAAG,GAAG;AACvC,cAAM,YAAY,4BAA4B,MAAM;AACpD,YAAI,cAAc,OAAW,QAAO;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAMA,SAAS,iBAAiB,iBAA0B,SAAyB;AAC3E,MAAI,OAAO,oBAAoB,UAAU;AACvC,UAAM,UAAU,gBAAgB,KAAK;AACrC,QAAI,YAAY,IAAI;AAClB,YAAM,YAAY,kBAAkB,OAAO;AAC3C,UAAI,cAAc,OAAW,QAAO;AAAA,IACtC;AAAA,EACF;AACA,SAAO,cAAc,OAAO,KAAK;AACnC;AAOA,SAAS,UAAU,GAAoB;AACrC,QAAM,IAAI,OAAO,MAAM,WAAW,IAAI,OAAO,MAAM,WAAW,OAAO,CAAC,IAAI;AAC1E,MAAI,CAAC,OAAO,SAAS,CAAC,EAAG,QAAO;AAChC,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC;AAClC;AAGA,SAAS,YAAY,GAA2B;AAC9C,QAAM,IAAI,OAAO,MAAM,WAAW,IAAI,OAAO,MAAM,WAAW,OAAO,CAAC,IAAI;AAC1E,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAOA,SAAS,kBAAkB,WAA2B;AACpD,SAAO,YAAY,OAAO,KAAK,MAAM,SAAS,IAAI,KAAK,MAAM,YAAY,GAAI;AAC/E;AAOA,IAAM,eAA4B;AAAA,EAChC,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,MAAM,KAAK,EAAE,QAAQ,GAAiD;AACpE,UAAM,SAAS,cAAc;AAC7B,QAAI,WAAW,OAAW,QAAO,CAAC;AAElC,UAAM,KAAK,MAAM,WAAW,MAAM;AAClC,QAAI,OAAO,KAAM,QAAO,CAAC;AAEzB,QAAI;AACF,YAAM,OAAO,GAAG,IAAI,KAAK;AACzB,YAAM,UAAyB,CAAC;AAEhC,iBAAW,OAAO,MAAM;AACtB,cAAM,MAAM;AAKZ,cAAM,YAAY,IAAI;AACtB,YAAI,OAAO,cAAc,YAAY,cAAc,GAAI;AAEvD,cAAM,UAAU,IAAI;AACpB,YAAI,OAAO,YAAY,YAAY,QAAQ,KAAK,MAAM,GAAI;AAE1D,cAAM,YAAY,YAAY,IAAI,UAAU,KAAK;AACjD,cAAM,KAAK,kBAAkB,SAAS;AACtC,YAAI,YAAY,UAAa,KAAK,QAAS;AAE3C,cAAM,aAAa,iBAAiB,IAAI,kBAAkB,OAAO;AAEjE,cAAM,SAAS,YAAY;AAC3B,eAAO,QAAQ,UAAU,IAAI,YAAY;AACzC,eAAO,SAAS,UAAU,IAAI,aAAa;AAC3C,eAAO,YAAY,UAAU,IAAI,iBAAiB;AAClD,eAAO,aAAa,UAAU,IAAI,kBAAkB;AACpD,eAAO,YAAY,UAAU,IAAI,gBAAgB;AAGjD,cAAM,SAAS,YAAY,IAAI,eAAe;AAC9C,cAAM,YAAY,YAAY,IAAI,kBAAkB;AACpD,cAAM,OAAO,KAAK,IAAI,GAAG,UAAU,aAAa,CAAC;AAGjD,cAAM,eAAe,UAAU,IAAI,aAAa;AAEhD,cAAM,SAAsB;AAAA,UAC1B,YAAY;AAAA,UACZ;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,UAAU;AAAA;AAAA,UACV,YAAY;AAAA,UACZ,OAAO;AAAA,QACT;AACA,gBAAQ,KAAK,MAAM;AAAA,MACrB;AAEA,aAAO;AAAA,IACT,UAAE;AACA,SAAG,MAAM;AAAA,IACX;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/hook-YVDILAMZ.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import {
+  fail
+} from "./chunk-54EMKTTX.js";
+import {
+  runHook
+} 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/hook.ts
+import { parseArgs } from "util";
+var HOOK_EVENTS = /* @__PURE__ */ new Set([
+  "SessionStart",
+  "SessionEnd",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PostToolUse",
+  "PreCompact",
+  "Stop",
+  "Notification"
+]);
+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) {
+  const { values, positionals } = parseArgs({
+    args: argv,
+    options: {
+      connector: { type: "string" }
+    },
+    allowPositionals: true
+  });
+  const platformId = positionals[0];
+  const event = positionals[1];
+  if (!platformId || !event) {
+    return fail("usage: agent-connector hook <platform> <event> --connector <id>");
+  }
+  if (!HOOK_EVENTS.has(event)) {
+    return fail(`unknown hook event "${event}"`);
+  }
+  const connectorId = values.connector;
+  if (!connectorId || connectorId.trim() === "") {
+    return fail("hook requires --connector <id>");
+  }
+  const stdin = await readAll(process.stdin);
+  const reply = await runHook({
+    platformId,
+    event,
+    connectorId,
+    stdin
+  });
+  if (reply.stdout !== void 0 && reply.stdout !== "") {
+    process.stdout.write(reply.stdout);
+  }
+  if (reply.stderr !== void 0 && reply.stderr !== "") {
+    process.stderr.write(reply.stderr.endsWith("\n") ? reply.stderr : `${reply.stderr}
+`);
+  }
+  process.exit(reply.exitCode);
+}
+export {
+  run
+};
+//# sourceMappingURL=hook-YVDILAMZ.js.map

package/dist/hook-YVDILAMZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/hook.ts"],"sourcesContent":["/**\n * cli/commands/hook — the universal json-stdio hook entrypoint.\n *\n *   agent-connector hook <platform> <event> --connector <id>\n *\n * This is the single command every host's hook config points at (via the stable\n * home binary). It reads the ENTIRE host payload from stdin, dispatches through\n * runHook, writes any stdout/stderr the adapter produced, and exits with the\n * adapter's exit code (the host interprets it as allow/deny/etc.).\n *\n * Fail-open is the runtime's contract: runHook never rejects, so a framework or\n * handler bug can't wedge a host's tool call.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport type { HookEventName } from \"../../core/types.js\";\nimport { runHook } from \"../../runtime/index.js\";\nimport { fail } from \"../app.js\";\n\nconst HOOK_EVENTS: ReadonlySet<string> = new Set<HookEventName>([\n  \"SessionStart\",\n  \"SessionEnd\",\n  \"UserPromptSubmit\",\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"PreCompact\",\n  \"Stop\",\n  \"Notification\",\n]);\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  const { values, positionals } = parseArgs({\n    args: argv,\n    options: {\n      connector: { type: \"string\" },\n    },\n    allowPositionals: true,\n  });\n\n  const platformId = positionals[0];\n  const event = positionals[1];\n  if (!platformId || !event) {\n    return fail(\"usage: agent-connector hook <platform> <event> --connector <id>\");\n  }\n  if (!HOOK_EVENTS.has(event)) {\n    return fail(`unknown hook event \"${event}\"`);\n  }\n  const connectorId = values.connector;\n  if (!connectorId || connectorId.trim() === \"\") {\n    return fail(\"hook requires --connector <id>\");\n  }\n\n  // Read the entire host payload before dispatching.\n  const stdin = await readAll(process.stdin);\n\n  const reply = await runHook({\n    platformId,\n    event: event as HookEventName,\n    connectorId,\n    stdin,\n  });\n\n  if (reply.stdout !== undefined && reply.stdout !== \"\") {\n    process.stdout.write(reply.stdout);\n  }\n  if (reply.stderr !== undefined && reply.stderr !== \"\") {\n    process.stderr.write(reply.stderr.endsWith(\"\\n\") ? reply.stderr : `${reply.stderr}\\n`);\n  }\n\n  process.exit(reply.exitCode);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcA,SAAS,iBAAiB;AAM1B,IAAM,cAAmC,oBAAI,IAAmB;AAAA,EAC9D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGD,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;AACzD,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,IACxC,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,EAAE,MAAM,SAAS;AAAA,IAC9B;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,aAAa,YAAY,CAAC;AAChC,QAAM,QAAQ,YAAY,CAAC;AAC3B,MAAI,CAAC,cAAc,CAAC,OAAO;AACzB,WAAO,KAAK,iEAAiE;AAAA,EAC/E;AACA,MAAI,CAAC,YAAY,IAAI,KAAK,GAAG;AAC3B,WAAO,KAAK,uBAAuB,KAAK,GAAG;AAAA,EAC7C;AACA,QAAM,cAAc,OAAO;AAC3B,MAAI,CAAC,eAAe,YAAY,KAAK,MAAM,IAAI;AAC7C,WAAO,KAAK,gCAAgC;AAAA,EAC9C;AAGA,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK;AAEzC,QAAM,QAAQ,MAAM,QAAQ;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,MAAM,WAAW,UAAa,MAAM,WAAW,IAAI;AACrD,YAAQ,OAAO,MAAM,MAAM,MAAM;AAAA,EACnC;AACA,MAAI,MAAM,WAAW,UAAa,MAAM,WAAW,IAAI;AACrD,YAAQ,OAAO,MAAM,MAAM,OAAO,SAAS,IAAI,IAAI,MAAM,SAAS,GAAG,MAAM,MAAM;AAAA,CAAI;AAAA,EACvF;AAEA,UAAQ,KAAK,MAAM,QAAQ;AAC7B;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { C as ConnectorConfig, R as ResolvedConnector } from './types-CYUB1OTr.js';
+export { A as AuthSpec, a as ChangeRecord, D as DetectedPlatform, b as DiagnosticResult, E as EventPayloadMap, H as HookDefinition, c as HookEventName, d as HookParadigm, e as HookResponse, f as HooksConfig, I as InstallResult, g as InstallScope, N as NotificationEvent, P as PlatformCapabilities, h as PlatformId, i as PlatformOverride, j as PostToolUseEvent, k as PreCompactEvent, l as PreToolUseEvent, S as ServerDef, m as SessionEndEvent, n as SessionStartEvent, o as StopEvent, T as TelemetryConfig, p as ToolFilter, q as Transport, U as UserPromptSubmitEvent } from './types-CYUB1OTr.js';
+
+/**
+ * core/define-connector — the public write-once entry point.
+ *
+ * Validates a ConnectorConfig and normalizes it into a ResolvedConnector with
+ * every optional field resolved to a default. Validation is intentionally
+ * dependency-free (no zod) to keep the single-binary install lean.
+ */
+
+/** Thrown on an invalid connector configuration. */
+declare class ConnectorConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate + normalize a connector definition.
+ * Returns a ResolvedConnector that adapters and the CLI consume directly.
+ */
+declare function defineConnector(config: ConnectorConfig): ResolvedConnector;
+
+export { ConnectorConfig, ConnectorConfigError, ResolvedConnector, defineConnector };

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  ConnectorConfigError,
+  defineConnector
+} from "./chunk-XNAM7F35.js";
+export {
+  ConnectorConfigError,
+  defineConnector
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/install-HQRYZOQ2.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import {
+  installConnector
+} from "./chunk-7MSDGHJW.js";
+import {
+  fail,
+  parseScope,
+  parseTargets,
+  print,
+  renderInstallResult
+} from "./chunk-54EMKTTX.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-XUCWLJY5.js";
+import {
+  findConnectorConfig,
+  loadConnectorFromPath
+} from "./chunk-LTT56GI3.js";
+import "./chunk-XNAM7F35.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/install.ts
+import { parseArgs } from "util";
+async function run(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      scope: { type: "string", default: "user" },
+      targets: { type: "string" },
+      connector: { type: "string" },
+      project: { type: "string" },
+      "dry-run": { type: "boolean", default: false }
+    },
+    allowPositionals: false
+  });
+  const projectDir = values.project ?? process.cwd();
+  const configPath = values.connector ?? findConnectorConfig(projectDir);
+  if (!configPath) {
+    return fail(
+      "no connector config found. Pass --connector <path> or add an agent-connector.config.{mjs,js,json} to your project."
+    );
+  }
+  const scope = parseScope(values.scope);
+  if (scope == null) return fail(`invalid --scope "${values.scope}" (use user|project)`);
+  const { connector, modulePath } = await loadConnectorFromPath(configPath);
+  const targets = parseTargets(values.targets);
+  const result = await installConnector({
+    connector,
+    modulePath,
+    scope,
+    projectDir,
+    dryRun: values["dry-run"],
+    ...targets ? { targets } : {}
+  });
+  print(renderInstallResult(result, "install"));
+  return result.changes.some((c) => c.action === "warn") ? 1 : 0;
+}
+export {
+  run
+};
+//# sourceMappingURL=install-HQRYZOQ2.js.map

package/dist/install-HQRYZOQ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/install.ts"],"sourcesContent":["/**\n * cli/commands/install — deploy a connector across its target platforms.\n *\n * Resolves the connector config (--connector <path>, else findConnectorConfig\n * walking up from the project dir), loads it into a live ResolvedConnector, and\n * hands it to the installer orchestration. The resulting ChangeRecords are\n * rendered as a readable diff; --dry-run renders the plan without writing.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { installConnector } from \"../../core/installer.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { fail, parseScope, parseTargets, print, renderInstallResult } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (!configPath) {\n    return fail(\n      \"no connector config found. Pass --connector <path> or add an \" +\n        \"agent-connector.config.{mjs,js,json} to your project.\",\n    );\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const { connector, modulePath } = await loadConnectorFromPath(configPath);\n  const targets = parseTargets(values.targets);\n\n  const result = await installConnector({\n    connector,\n    modulePath,\n    scope,\n    projectDir,\n    dryRun: values[\"dry-run\"],\n    ...(targets ? { targets } : {}),\n  });\n\n  print(renderInstallResult(result, \"install\"));\n  return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AASA,SAAS,iBAAiB;AAM1B,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC/C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,aAAa,OAAO,aAAa,oBAAoB,UAAU;AACrE,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,MACL;AAAA,IAEF;AAAA,EACF;AAEA,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AAErF,QAAM,EAAE,WAAW,WAAW,IAAI,MAAM,sBAAsB,UAAU;AACxE,QAAM,UAAU,aAAa,OAAO,OAAO;AAE3C,QAAM,SAAS,MAAM,iBAAiB;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC;AAED,QAAM,oBAAoB,QAAQ,SAAS,CAAC;AAC5C,SAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAC/D;","names":[]}