@ken-jo/agent-connector 0.3.1 → 0.4.1

package/dist/{status-MKQYX5MW.js → status-LAJE3BM5.js}

@@ -6,17 +6,20 @@ import {
   fail,
   parseScope,
   print
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-O5TWCIJN.js";
 import {
-  detectInstalledPlatforms,
-  loadAdapter
-} from "./chunk-NJU275US.js";
+  detectInstalledPlatforms
+} from "./chunk-EGCBZ2DC.js";
 import {
   findConnectorConfig,
   listRegisteredConnectors,
   loadConnectorFromPath
-} from "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
+} from "./chunk-24IDL5RW.js";
+import "./chunk-4ENJK5S2.js";
+import {
+  loadAdapter
+} from "./chunk-DCKFYWGM.js";
+import "./chunk-FAHIMJRU.js";
 import "./chunk-N6HH7K6P.js";
 import {
   dataRoot,
@@ -135,4 +138,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=status-MKQYX5MW.js.map
+//# sourceMappingURL=status-LAJE3BM5.js.map

package/dist/{status-MKQYX5MW.js.map → status-LAJE3BM5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/status.ts"],"sourcesContent":["/**\n * cli/commands/status — a light, glanceable install-state summary.\n *\n * There is NO MCP standard for \"which connectors are installed into which host\n * configs on this machine\" — distribution/wire standards (server.json, MCPB,\n * the lifecycle) cover publishing + the protocol, not local install state. So\n * `status` is purely agent-connector infrastructure, and we design it for the\n * everyday question it answers in one line per platform:\n *\n *   \"which of my connectors are present on which hosts?\"\n *\n * It REUSES detect (host enumeration) + the adapters' own config-path resolvers\n * (a read-only presence check) — NO new adapter SPI methods. Unlike `doctor`\n * (deep health checks, non-zero exit on failure) and `doctor --probe` (a live\n * protocol probe that FAILs on a dead server), `status` ALWAYS exits 0: it\n * describes, it never gates. A connector being absent is informational.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { readFileSync } from \"node:fs\";\n\nimport type { InstallScope, PlatformId, ResolvedConnector } from \"../../core/types.js\";\nimport type { InstallContext } from \"../../adapters/spi.js\";\nimport { detectInstalledPlatforms } from \"../../adapters/detect.js\";\nimport { loadAdapter } from \"../../adapters/registry.js\";\nimport {\n  findConnectorConfig,\n  listRegisteredConnectors,\n  loadConnectorFromPath,\n} from \"../../core/load-connector.js\";\nimport { marketplaceEvidence } from \"../../core/marketplace-state.js\";\nimport { dataRoot, homeBinPath } from \"../../core/paths.js\";\nimport { fail, parseScope, print } from \"../app.js\";\n\n/**\n * Resolve which connector(s) status reports on: an explicit --connector path or\n * a local config first, else every connector registered under the data-root\n * (what is actually installed). Empty array when none — status still lists the\n * detected platforms.\n */\nasync function resolveConnectors(\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<ResolvedConnector[]> {\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    try {\n      const { connector } = await loadConnectorFromPath(configPath);\n      return [connector];\n    } catch {\n      /* fall through to the registry */\n    }\n  }\n  return listRegisteredConnectors();\n}\n\nfunction buildContext(\n  connector: ResolvedConnector,\n  id: PlatformId,\n  scope: InstallScope,\n  projectDir: string,\n): InstallContext {\n  return {\n    connector,\n    scope: connector.platforms[id]?.scope ?? scope,\n    projectDir,\n    homeBinPath: homeBinPath(),\n    dataRoot: dataRoot(),\n    dryRun: true,\n  };\n}\n\n/** Read-only: does the file at `path` mention `needle`? Missing/unreadable → false. */\nfunction fileMentions(path: string, needle: string): boolean {\n  try {\n    return readFileSync(path, \"utf8\").includes(needle);\n  } catch {\n    return false;\n  }\n}\n\ninterface ConnStatus {\n  id: string;\n  serverPresent: boolean;\n  hooksPresent: boolean;\n  /**\n   * Delivery method actually present on this host: `direct` (managed entries in\n   * the host config), `marketplace` (the host's own plugin state / our install\n   * record), `both` (the double-install invariant is VIOLATED — doctor FAILs\n   * it), or null when absent.\n   */\n  method: \"direct\" | \"marketplace\" | \"both\" | null;\n}\ninterface StatusRow {\n  platform: PlatformId;\n  scope: InstallScope;\n  configPath: string;\n  connectors: ConnStatus[];\n}\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      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const connectors = await resolveConnectors(values.connector, projectDir);\n  const detected = await detectInstalledPlatforms(projectDir);\n\n  const rows: StatusRow[] = [];\n  for (const p of detected) {\n    const adapter = await loadAdapter(p.id);\n    if (!adapter) continue;\n    const connStatuses: ConnStatus[] = connectors.map((connector) => {\n      const ctx = buildContext(connector, p.id, scope, projectDir);\n      let serverPath = \"\";\n      let hookPath = \"\";\n      try {\n        serverPath = adapter.getServerConfigPath(ctx);\n      } catch {\n        /* adapter has no server config path */\n      }\n      try {\n        hookPath = adapter.getHookConfigPath(ctx);\n      } catch {\n        /* adapter has no hook config path */\n      }\n      const serverPresent = serverPath\n        ? fileMentions(serverPath, connector.id)\n        : false;\n      const hooksPresent = hookPath ? fileMentions(hookPath, connector.id) : false;\n      const direct = serverPresent || hooksPresent;\n      const viaMarketplace = marketplaceEvidence(connector.id, p.id) != null;\n      return {\n        id: connector.id,\n        serverPresent,\n        hooksPresent,\n        method: direct && viaMarketplace\n          ? (\"both\" as const)\n          : direct\n            ? (\"direct\" as const)\n            : viaMarketplace\n              ? (\"marketplace\" as const)\n              : null,\n      };\n    });\n    rows.push({\n      platform: p.id,\n      scope: p.scope,\n      configPath: p.configPath,\n      connectors: connStatuses,\n    });\n  }\n\n  if (values.json) {\n    print(JSON.stringify(rows, null, 2));\n    return 0;\n  }\n\n  if (rows.length === 0) {\n    print(\"status: no agent platforms detected.\");\n    return 0;\n  }\n  if (connectors.length === 0) {\n    print(\"status: no connectors found (pass --connector <path> or install one).\\n\");\n  }\n\n  for (const r of rows) {\n    print(`${r.platform}  [${r.scope}]  ${r.configPath}`);\n    if (r.connectors.length === 0) {\n      print(\"  (no connectors to check)\");\n    } else {\n      for (const c of r.connectors) {\n        const mark = c.method != null ? \"[installed]\" : \"[absent   ]\";\n        const server = c.serverPresent ? \"server ✓\" : \"server ·\";\n        const hooks = c.hooksPresent ? \"hooks ✓\" : \"hooks ·\";\n        // `both(!)` flags a violated one-method-per-host invariant — doctor's\n        // duplicate-registration check FAILs it with the fix.\n        const method =\n          c.method == null ? \"\" : c.method === \"both\" ? \"  (both!)\" : `  (${c.method})`;\n        print(`  ${mark} ${c.id}  ${server}  ${hooks}${method}`);\n      }\n    }\n    print(\"\");\n  }\n\n  // Always 0: status is descriptive (what is installed where), never a gate —\n  // that contrast with doctor (non-zero on FAIL) is the reason it exists.\n  return 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/status.ts"],"sourcesContent":["/**\n * cli/commands/status — a light, glanceable install-state summary.\n *\n * There is NO MCP standard for \"which connectors are installed into which host\n * configs on this machine\" — distribution/wire standards (server.json, MCPB,\n * the lifecycle) cover publishing + the protocol, not local install state. So\n * `status` is purely agent-connector infrastructure, and we design it for the\n * everyday question it answers in one line per platform:\n *\n *   \"which of my connectors are present on which hosts?\"\n *\n * It REUSES detect (host enumeration) + the adapters' own config-path resolvers\n * (a read-only presence check) — NO new adapter SPI methods. Unlike `doctor`\n * (deep health checks, non-zero exit on failure) and `doctor --probe` (a live\n * protocol probe that FAILs on a dead server), `status` ALWAYS exits 0: it\n * describes, it never gates. A connector being absent is informational.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { readFileSync } from \"node:fs\";\n\nimport type { InstallScope, PlatformId, ResolvedConnector } from \"../../core/types.js\";\nimport type { InstallContext } from \"../../adapters/spi.js\";\nimport { detectInstalledPlatforms } from \"../../adapters/detect.js\";\nimport { loadAdapter } from \"../../adapters/registry.js\";\nimport {\n  findConnectorConfig,\n  listRegisteredConnectors,\n  loadConnectorFromPath,\n} from \"../../core/load-connector.js\";\nimport { marketplaceEvidence } from \"../../core/marketplace-state.js\";\nimport { dataRoot, homeBinPath } from \"../../core/paths.js\";\nimport { fail, parseScope, print } from \"../app.js\";\n\n/**\n * Resolve which connector(s) status reports on: an explicit --connector path or\n * a local config first, else every connector registered under the data-root\n * (what is actually installed). Empty array when none — status still lists the\n * detected platforms.\n */\nasync function resolveConnectors(\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<ResolvedConnector[]> {\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    try {\n      const { connector } = await loadConnectorFromPath(configPath);\n      return [connector];\n    } catch {\n      /* fall through to the registry */\n    }\n  }\n  return listRegisteredConnectors();\n}\n\nfunction buildContext(\n  connector: ResolvedConnector,\n  id: PlatformId,\n  scope: InstallScope,\n  projectDir: string,\n): InstallContext {\n  return {\n    connector,\n    scope: connector.platforms[id]?.scope ?? scope,\n    projectDir,\n    homeBinPath: homeBinPath(),\n    dataRoot: dataRoot(),\n    dryRun: true,\n  };\n}\n\n/** Read-only: does the file at `path` mention `needle`? Missing/unreadable → false. */\nfunction fileMentions(path: string, needle: string): boolean {\n  try {\n    return readFileSync(path, \"utf8\").includes(needle);\n  } catch {\n    return false;\n  }\n}\n\ninterface ConnStatus {\n  id: string;\n  serverPresent: boolean;\n  hooksPresent: boolean;\n  /**\n   * Delivery method actually present on this host: `direct` (managed entries in\n   * the host config), `marketplace` (the host's own plugin state / our install\n   * record), `both` (the double-install invariant is VIOLATED — doctor FAILs\n   * it), or null when absent.\n   */\n  method: \"direct\" | \"marketplace\" | \"both\" | null;\n}\ninterface StatusRow {\n  platform: PlatformId;\n  scope: InstallScope;\n  configPath: string;\n  connectors: ConnStatus[];\n}\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      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const connectors = await resolveConnectors(values.connector, projectDir);\n  const detected = await detectInstalledPlatforms(projectDir);\n\n  const rows: StatusRow[] = [];\n  for (const p of detected) {\n    const adapter = await loadAdapter(p.id);\n    if (!adapter) continue;\n    const connStatuses: ConnStatus[] = connectors.map((connector) => {\n      const ctx = buildContext(connector, p.id, scope, projectDir);\n      let serverPath = \"\";\n      let hookPath = \"\";\n      try {\n        serverPath = adapter.getServerConfigPath(ctx);\n      } catch {\n        /* adapter has no server config path */\n      }\n      try {\n        hookPath = adapter.getHookConfigPath(ctx);\n      } catch {\n        /* adapter has no hook config path */\n      }\n      const serverPresent = serverPath\n        ? fileMentions(serverPath, connector.id)\n        : false;\n      const hooksPresent = hookPath ? fileMentions(hookPath, connector.id) : false;\n      const direct = serverPresent || hooksPresent;\n      const viaMarketplace = marketplaceEvidence(connector.id, p.id) != null;\n      return {\n        id: connector.id,\n        serverPresent,\n        hooksPresent,\n        method: direct && viaMarketplace\n          ? (\"both\" as const)\n          : direct\n            ? (\"direct\" as const)\n            : viaMarketplace\n              ? (\"marketplace\" as const)\n              : null,\n      };\n    });\n    rows.push({\n      platform: p.id,\n      scope: p.scope,\n      configPath: p.configPath,\n      connectors: connStatuses,\n    });\n  }\n\n  if (values.json) {\n    print(JSON.stringify(rows, null, 2));\n    return 0;\n  }\n\n  if (rows.length === 0) {\n    print(\"status: no agent platforms detected.\");\n    return 0;\n  }\n  if (connectors.length === 0) {\n    print(\"status: no connectors found (pass --connector <path> or install one).\\n\");\n  }\n\n  for (const r of rows) {\n    print(`${r.platform}  [${r.scope}]  ${r.configPath}`);\n    if (r.connectors.length === 0) {\n      print(\"  (no connectors to check)\");\n    } else {\n      for (const c of r.connectors) {\n        const mark = c.method != null ? \"[installed]\" : \"[absent   ]\";\n        const server = c.serverPresent ? \"server ✓\" : \"server ·\";\n        const hooks = c.hooksPresent ? \"hooks ✓\" : \"hooks ·\";\n        // `both(!)` flags a violated one-method-per-host invariant — doctor's\n        // duplicate-registration check FAILs it with the fix.\n        const method =\n          c.method == null ? \"\" : c.method === \"both\" ? \"  (both!)\" : `  (${c.method})`;\n        print(`  ${mark} ${c.id}  ${server}  ${hooks}${method}`);\n      }\n    }\n    print(\"\");\n  }\n\n  // Always 0: status is descriptive (what is installed where), never a gate —\n  // that contrast with doctor (non-zero on FAIL) is the reason it exists.\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/statusline-L376ZPZU.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import {
+  runStatusline
+} from "./chunk-5OWS5CMA.js";
+import "./chunk-OP4KBXUO.js";
+import "./chunk-F5RX62T7.js";
+import "./chunk-EGCBZ2DC.js";
+import "./chunk-2AVLX7GH.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-24IDL5RW.js";
+import "./chunk-4ENJK5S2.js";
+import "./chunk-DCKFYWGM.js";
+import "./chunk-FAHIMJRU.js";
+import "./chunk-I5MLE6S7.js";
+import "./chunk-N6HH7K6P.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/statusline.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 reply = await runStatusline({ platformId, 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}
+`);
+  }
+  return reply.exitCode;
+}
+export {
+  run
+};
+//# sourceMappingURL=statusline-L376ZPZU.js.map

package/dist/statusline-L376ZPZU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/statusline.ts"],"sourcesContent":["/**\n * cli/commands/statusline — the universal statusline (HUD) entrypoint.\n *\n *   agent-connector statusline <platform> --connector <id>\n *\n * A statusline-supporting host points its status line config at the single stable\n * home binary (via core/spawn.buildHomeBinStatuslineCommand). This command reads\n * the ENTIRE host payload from stdin, dispatches through runStatusline, writes the\n * rendered line to stdout, and exits with the adapter's exit code.\n *\n * FAIL-SAFE is the runtime's contract: a status line must NEVER wedge the host or\n * spew an error into the status bar. runStatusline never rejects (always exits 0\n * with at most a rendered line), and even a malformed invocation here degrades to\n * exit 0 with no output — never the strict `fail()` non-zero used by other\n * commands.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { runStatusline } 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 status bar.\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-safe (render nothing, exit 0).\n    return 0;\n  }\n\n  // Drain stdin regardless — a host expects the command to consume its payload.\n  const stdin = await readAll(process.stdin).catch(() => \"\");\n\n  // Missing platform/connector → render nothing, exit 0 (never a non-zero exit).\n  if (platformId === \"\" || connectorId === \"\") {\n    return 0;\n  }\n\n  const reply = await runStatusline({ platformId, connectorId, stdin });\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  return reply.exitCode;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,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;AAGA,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,MAAM,EAAE;AAGzD,MAAI,eAAe,MAAM,gBAAgB,IAAI;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,MAAM,cAAc,EAAE,YAAY,aAAa,MAAM,CAAC;AACpE,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;AACA,SAAO,MAAM;AACf;","names":[]}

package/dist/{telemetry-3DN6XGYB.js → telemetry-B3DX3PWU.js}

@@ -12,7 +12,7 @@ import {
 import {
   fail,
   print
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-O5TWCIJN.js";
 import {
   openStore
 } from "./chunk-BCHWFTV4.js";
@@ -21,8 +21,10 @@ import {
   listRegisteredConnectors,
   loadRegisteredConnector,
   readRegisteredMeta
-} from "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
+} from "./chunk-24IDL5RW.js";
+import "./chunk-4ENJK5S2.js";
+import "./chunk-DCKFYWGM.js";
+import "./chunk-FAHIMJRU.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -347,4 +349,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=telemetry-3DN6XGYB.js.map
+//# sourceMappingURL=telemetry-B3DX3PWU.js.map

package/dist/{telemetry-3DN6XGYB.js.map → telemetry-B3DX3PWU.js.map}

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

package/dist/{trae-CQC72RHH.js → trae-7CZZGOGI.js}

@@ -4,13 +4,13 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -42,7 +42,13 @@ var TraeAdapter = class extends BaseAdapter {
     canModifyOutput: false,
     canInjectSessionContext: false,
     // Trae registers stdio, SSE, and Streamable HTTP MCP servers.
-    transports: ["stdio", "sse", "http"]
+    transports: ["stdio", "sse", "http"],
+    // Content surfaces: Trae reads Agent Skills (SKILL.md) from
+    //   user scope    → ~/.trae/skills/<name>/SKILL.md
+    //   project scope → <projectDir>/.trae/skills/<name>/SKILL.md
+    // BOTH scopes are documented-writable. Commands/subagents have no native
+    // file surface here, so only skills is enabled.
+    supportsSkills: true
   };
   // ── Detection ────────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
@@ -172,11 +178,91 @@ var TraeAdapter = class extends BaseAdapter {
   isOurCommand(command, ctx) {
     return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);
   }
+  // ── Content surfaces: skills ─────────────────────────────────────────────
+  // CONTENT-ONLY: pure native-file writers. No runtime dispatch, no home-bin
+  // pointer, no telemetry wrap. Idempotent (byte-identical → skip) via
+  // writeContentFile and reversible via removeContentFile. Honors
+  // platforms["trae"].skills === false to skip. BOTH user and project scopes
+  // are documented-writable, so there is no scope guard.
+  //
+  // Native location:
+  //   skill → <configDir>/skills/<name>/SKILL.md (+ bundled resources)
+  //     user    → ~/.trae/skills/<name>/SKILL.md
+  //     project → <projectDir>/.trae/skills/<name>/SKILL.md
+  skillDir(ctx, name) {
+    return join(this.getConfigDir(ctx), "skills", name);
+  }
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for trae" }];
+    }
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(
+        this.writeContentFile(join(dir, "SKILL.md"), this.renderSkill(skill), ctx.dryRun)
+      );
+      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `skill resource "${rel}" escapes the skill dir; skipped`
+          });
+          continue;
+        }
+        changes.push(this.writeContentFile(target, contents, ctx.dryRun));
+      }
+    }
+    return changes;
+  }
+  uninstallSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(this.removeContentFile(join(dir, "SKILL.md"), ctx.dryRun));
+      for (const rel of Object.keys(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) continue;
+        changes.push(this.removeContentFile(target, ctx.dryRun));
+      }
+      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));
+    }
+    return changes;
+  }
+  /**
+   * Render a skill's SKILL.md: frontmatter (name, description + optional model,
+   * allowed-tools, disable-model-invocation) + body. UNIFORM with every other
+   * skill-supporting platform — only the parent dir differs.
+   */
+  renderSkill(skill) {
+    const frontmatter = {
+      name: skill.name,
+      description: skill.description
+    };
+    if (skill.model !== void 0) frontmatter.model = skill.model;
+    const allow = skill.tools?.allow;
+    if (allow && allow.length > 0) frontmatter["allowed-tools"] = allow.join(", ");
+    if (skill.disableModelInvocation !== void 0) {
+      frontmatter["disable-model-invocation"] = skill.disableModelInvocation;
+    }
+    if (skill.extra) Object.assign(frontmatter, skill.extra);
+    return this.renderFrontmatterMd(frontmatter, skill.body);
+  }
   // ── Diagnostics ──────────────────────────────────────────────────────────
   getHealthChecks(ctx) {
     const mcpPath = this.getServerConfigPath(ctx);
     const connectorId = ctx.connector.id;
-    return [
+    const checks = [
       {
         name: `${this.name}: mcp.json present`,
         check: () => existsSync(mcpPath) ? { status: "OK", detail: mcpPath } : { status: "FAIL", detail: `not found: ${mcpPath}` }
@@ -199,6 +285,14 @@ var TraeAdapter = class extends BaseAdapter {
         }
       }
     ];
+    for (const skill of ctx.connector.skills) {
+      const p = join(this.skillDir(ctx, skill.name), "SKILL.md");
+      checks.push({
+        name: `${this.name}: skill ${skill.name} present`,
+        check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
+      });
+    }
+    return checks;
   }
 };
 var adapter = new TraeAdapter();
@@ -208,4 +302,4 @@ export {
   adapter,
   trae_default as default
 };
-//# sourceMappingURL=trae-CQC72RHH.js.map
+//# sourceMappingURL=trae-7CZZGOGI.js.map

package/dist/trae-7CZZGOGI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/trae/index.ts"],"sourcesContent":["/**\n * adapters/trae — Trae (ByteDance) platform adapter for agent-connector.\n *\n * Trae is an **mcp-only** host for our purposes: it exposes MCP servers as its\n * extensibility mechanism but has no lifecycle hook system we can register\n * against. This adapter therefore installs only the MCP server and reports hooks\n * as unavailable, mirroring the Warp reference path that validates the\n * `mcp-only` paradigm end-to-end.\n *\n * MCP config (medium-confidence path — still implemented; doctor reports presence):\n *   - user scope    → ~/.trae/mcp.json\n *   - project scope → <projectDir>/.trae/mcp.json\n *   Both are JSON, root key \"mcpServers\", and are the SAME file used for the\n *   (non-existent) hook registration — there is no separate hook file here.\n *\n * A stdio server entry uses the standard Claude/Cursor shape:\n *   { command, args, env }  (object-keyed by connector id).\n *\n * Trae documents no native `${env:VAR}` interpolation token, so env/header/url\n * refs are resolved to literals at install time (the no-native-token path).\n */\n\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, InstallContext } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookParadigm,\n  PlatformCapabilities,\n  PlatformId,\n  ServerDef,\n  SkillDef,\n  Transport,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  isHomeBinHookCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"trae\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/** Native MCP server entry shapes Trae accepts under `mcpServers`. */\ninterface TraeStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\ninterface TraeHttpServer {\n  url: string;\n  headers?: Record<string, string>;\n}\n\nexport class TraeAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Trae\";\n  readonly paradigm: HookParadigm = \"mcp-only\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default\n    // (memoryTargets: project <projectDir>/AGENTS.md; user scope where documented).\n    supportsMemory: true,\n    // Trae has no lifecycle hook system we can target — every hook capability\n    // is false.\n    preToolUse: false,\n    postToolUse: false,\n    preCompact: false,\n    sessionStart: false,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    // Trae registers stdio, SSE, and Streamable HTTP MCP servers.\n    transports: [\"stdio\", \"sse\", \"http\"],\n    // Content surfaces: Trae reads Agent Skills (SKILL.md) from\n    //   user scope    → ~/.trae/skills/<name>/SKILL.md\n    //   project scope → <projectDir>/.trae/skills/<name>/SKILL.md\n    // BOTH scopes are documented-writable. Commands/subagents have no native\n    // file surface here, so only skills is enabled.\n    supportsSkills: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".trae\");\n    const userMcp = join(userDir, \"mcp.json\");\n    const projDir = join(projectDir, \".trae\");\n    const projMcp = join(projDir, \"mcp.json\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userMcp);\n    const projInstalled = existsSync(projDir) || existsSync(projMcp);\n    const installed = userInstalled || projInstalled;\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projMcp : userMcp;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `found Trae config (${scope})`\n        : `no Trae config at ${userDir} or ${projDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".trae\")\n      : join(homedir(), \".trae\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp.json\");\n  }\n\n  /**\n   * Trae has no hook file — hooks are not a thing here. The hook \"config path\"\n   * is the same mcp.json so the generic doctor/backup behave sensibly.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  // ── MCP server install / uninstall ───────────────────────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for trae\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /** Render a normalized ServerDef into Trae's native mcpServers entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): TraeStdioServer | TraeHttpServer {\n    const transport: Transport = server.transport;\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      // Transparent telemetry wrapping: route the real command through\n      // `<homeBin> serve --connector <id> -- <command> <args...>`.\n      if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n        const wrapped = buildServeWrapperCommand(\n          ctx.homeBinPath,\n          ctx.connector.id,\n          command,\n          args,\n          ctx.scope,\n          this.id,\n        );\n        command = wrapped.command;\n        args = wrapped.args;\n      }\n\n      // Trae has no documented native interpolation token, so resolve every\n      // ${env:VAR} to a literal at install time.\n      const entry: TraeStdioServer = { command: resolveEnvRefsDeep(command) };\n      if (args.length > 0) entry.args = resolveEnvRefsDeep(args);\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // sse / http (and any other remote transport) — Trae registers a URL.\n    const entry: TraeHttpServer = { url: resolveEnvRefsDeep(server.url ?? \"\") };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /**\n   * Render env/header values. Trae documents no native interpolation token, so\n   * resolve `${env:VAR}` references to literals at install time.\n   */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    return resolveEnvRefsDeep({ ...env });\n  }\n\n  // ── Hooks (unavailable — Trae is mcp-only) ───────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Trae is mcp-only)\",\n      },\n    ];\n  }\n\n  uninstallHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Trae is mcp-only)\",\n      },\n    ];\n  }\n\n  /**\n   * True when a hook command references our home binary AND this connector id\n   * (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand).\n   * Trae installs no hooks, but this guard keeps any future shared-file edit\n   * from removing another connector's entries.\n   */\n  private isOurCommand(command: string | undefined, ctx: InstallContext): boolean {\n    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Content surfaces: skills ─────────────────────────────────────────────\n  // CONTENT-ONLY: pure native-file writers. No runtime dispatch, no home-bin\n  // pointer, no telemetry wrap. Idempotent (byte-identical → skip) via\n  // writeContentFile and reversible via removeContentFile. Honors\n  // platforms[\"trae\"].skills === false to skip. BOTH user and project scopes\n  // are documented-writable, so there is no scope guard.\n  //\n  // Native location:\n  //   skill → <configDir>/skills/<name>/SKILL.md (+ bundled resources)\n  //     user    → ~/.trae/skills/<name>/SKILL.md\n  //     project → <projectDir>/.trae/skills/<name>/SKILL.md\n\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.getConfigDir(ctx), \"skills\", name);\n  }\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for trae\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), this.renderSkill(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  /**\n   * Render a skill's SKILL.md: frontmatter (name, description + optional model,\n   * allowed-tools, disable-model-invocation) + body. UNIFORM with every other\n   * skill-supporting platform — only the parent dir differs.\n   */\n  private renderSkill(skill: SkillDef): string {\n    const frontmatter: Record<string, unknown> = {\n      name: skill.name,\n      description: skill.description,\n    };\n    if (skill.model !== undefined) frontmatter.model = skill.model;\n    const allow = skill.tools?.allow;\n    if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\n    if (skill.disableModelInvocation !== undefined) {\n      frontmatter[\"disable-model-invocation\"] = skill.disableModelInvocation;\n    }\n    if (skill.extra) Object.assign(frontmatter, skill.extra);\n    return this.renderFrontmatterMd(frontmatter, skill.body);\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const mcpPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    const checks: HealthCheck[] = [\n      {\n        name: `${this.name}: mcp.json present`,\n        check: () =>\n          existsSync(mcpPath)\n            ? { status: \"OK\", detail: mcpPath }\n            : { status: \"FAIL\", detail: `not found: ${mcpPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          // Only assert what the connector declares: a server-less connector —\n          // e.g. a catalog-only bundle of agents/skills/commands — never writes\n          // an mcpServers entry, so its absence is healthy.\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(mcpPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `${MCP_ROOT_KEY}.${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`,\n              };\n        },\n      },\n    ];\n\n    // Content-surface checks: assert presence only for skills this connector\n    // declares (the SKILL.md lands under <configDir>/skills/<name>/).\n    for (const skill of ctx.connector.skills) {\n      const p = join(this.skillDir(ctx, skill.name), \"SKILL.md\");\n      checks.push({\n        name: `${this.name}: skill ${skill.name} present`,\n        check: () =>\n          existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n      });\n    }\n    return checks;\n  }\n}\n\nexport const adapter = new TraeAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}