@ken-jo/agent-connector 0.3.1 → 0.4.0

package/dist/{warp-X6MB67NT.js → warp-H6IX4U3J.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderSkillMd
 } from "./chunk-7L6ITC4T.js";
@@ -12,7 +12,7 @@ import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -302,4 +302,4 @@ export {
   adapter,
   warp_default as default
 };
-//# sourceMappingURL=warp-X6MB67NT.js.map
+//# sourceMappingURL=warp-H6IX4U3J.js.map

package/dist/{zed-NTCYW4V2.js → zed-RH34TNSW.js}

@@ -4,14 +4,14 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderSkillMd
 } from "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -321,4 +321,4 @@ export {
   adapter,
   zed_default as default
 };
-//# sourceMappingURL=zed-NTCYW4V2.js.map
+//# sourceMappingURL=zed-RH34TNSW.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ken-jo/agent-connector",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "description": "Write your MCP server + hooks once; agent-connector installs and adapts them across every AI-agent platform (Claude Code, Codex, Cursor, OpenCode, Copilot, Gemini, Warp, …) and gives you default, platform-independent per-tool token telemetry.",
   "keywords": [
@@ -39,6 +39,14 @@
       "types": "./dist/runtime/index.d.ts",
       "import": "./dist/runtime/index.js"
     },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js"
+    },
+    "./sdk/test": {
+      "types": "./dist/sdk/test.d.ts",
+      "import": "./dist/sdk/test.js"
+    },
     "./cli": {
       "types": "./dist/cli/sdk.d.ts",
       "import": "./dist/cli/sdk.js"

package/dist/amp-YGV66GJT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/amp/index.ts"],"sourcesContent":["/**\n * adapters/amp — Amp (Sourcegraph / AmpCode) platform adapter for agent-connector.\n *\n * Amp is an **mcp-only** host: it exposes no lifecycle hook system, so MCP is the\n * only extensibility surface. This adapter installs the MCP server entry and\n * reports hooks as unavailable — the same shape validated by the Warp adapter.\n *\n * MCP config (report §2 / §5.3):\n *   - user scope    → ~/.config/amp/settings.json\n *   - project scope → <projectDir>/.amp/settings.json\n *   Both are JSONC (we write plain JSON, which is valid JSONC). The settings file\n *   is SHARED with the rest of Amp's configuration, so we MERGE our entry into\n *   the existing object and never clobber unrelated keys.\n *\n * QUIRK 1 — dotted top-level key: Amp does NOT use a nested `mcpServers` object.\n * The MCP registry is a single FLAT settings key literally named\n * `\"amp.mcpServers\"`, whose value is an object of `{ id: { command, args, env } }`.\n * We therefore set `settings[\"amp.mcpServers\"][connectorId] = entry`. Because the\n * base JSON helpers index `config[rootKey][serverId]`, passing the dotted string\n * as the root key writes exactly that flat key while preserving every sibling\n * setting (true merge).\n *\n * QUIRK 2 — native interpolation: Amp expands `${VAR_NAME}` in stdio entries at\n * runtime, so we KEEP env/header/url refs native by rewriting the portable\n * `${env:VAR}` syntax to Amp's `${VAR}` token rather than resolving to literals\n * (secrets stay out of the settings file).\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  Transport,\n} from \"../../core/types.js\";\nimport { rewriteEnvRefs } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  isHomeBinHookCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"amp\";\n/**\n * QUIRK: a single FLAT, dotted settings key — NOT a nested object. The base\n * JSON helpers treat this as `config[\"amp.mcpServers\"][serverId]`.\n */\nconst MCP_ROOT_KEY = \"amp.mcpServers\";\n\n/** Native MCP server entry shapes Amp accepts under `amp.mcpServers`. */\ninterface AmpStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\ninterface AmpHttpServer {\n  url: string;\n  headers?: Record<string, string>;\n}\n\nexport class AmpAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Amp\";\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    // Amp has no lifecycle hook system — every hook capability 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    // Amp registers stdio and Streamable HTTP MCP servers.\n    transports: [\"stdio\", \"http\"],\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".config\", \"amp\");\n    const userSettings = join(userDir, \"settings.json\");\n    const projectDirAmp = join(projectDir, \".amp\");\n    const projectSettings = join(projectDirAmp, \"settings.json\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userSettings);\n    const projectInstalled = existsSync(projectDirAmp) || existsSync(projectSettings);\n    const installed = userInstalled || projectInstalled;\n    const scope = projectInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projectSettings : userSettings;\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 Amp config (${scope}) at ${configPath}`\n        : `no Amp config at ${userSettings} or ${projectSettings}`,\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, \".amp\")\n      : join(homedir(), \".config\", \"amp\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"settings.json\");\n  }\n\n  /**\n   * Amp has no hook file — hooks are not a thing here. The hook \"config path\" is\n   * the same settings.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 amp\"\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    // Upsert into the flat \"amp.mcpServers\" key, merging into existing settings.\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 Amp's native `amp.mcpServers` entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): AmpStdioServer | AmpHttpServer {\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      // Amp expands ${VAR_NAME} natively, so keep refs native (no literals).\n      const entry: AmpStdioServer = { command: this.rewrite(command) };\n      if (args.length > 0) entry.args = args.map((a) => this.rewrite(a));\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // http (and any other remote transport we surface) — Amp registers a URL.\n    const entry: AmpHttpServer = { url: this.rewrite(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. Amp supports native `${VAR_NAME}` interpolation,\n   * so translate `${env:VAR}` refs to that native token rather than baking\n   * secrets into the file. Literals pass through unchanged.\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    const out: Record<string, string> = {};\n    for (const [k, v] of Object.entries(env)) out[k] = this.rewrite(v);\n    return out;\n  }\n\n  /** Translate `${env:VAR(:-default)}` to Amp's native `${VAR}` token. */\n  private rewrite(value: string): string {\n    return rewriteEnvRefs(value, ampEnvToken);\n  }\n\n  // ── Hooks (unavailable — Amp is mcp-only) ────────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amp 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 (Amp 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   * Amp installs no hooks, but this guard keeps any future shared-file edit from\n   * 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  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const settingsPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    return [\n      {\n        name: `${this.name}: settings.json present`,\n        check: () =>\n          existsSync(settingsPath)\n            ? { status: \"OK\", detail: settingsPath }\n            : { status: \"FAIL\", detail: `not found: ${settingsPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          // Only assert what the connector declares: a server-less connector\n          // never writes a server 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> }>(settingsPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no \"${MCP_ROOT_KEY}\" in ${settingsPath}` };\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 ${settingsPath}`,\n              };\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Amp native interpolation token: `${env:VAR}` → `${VAR}`.\n *\n * When the portable ref carried a default (`${env:VAR:-fallback}`), Amp's native\n * `${VAR}` token has no way to express it — so a bare native token would silently\n * DROP the default. Instead, resolve the default at install time: emit the live\n * value when VAR is set and non-empty, else the literal fallback. The native\n * token is only emitted when there is no default to preserve.\n */\nfunction ampEnvToken(name: string, def?: string): string {\n  if (def !== undefined) {\n    const v = process.env[name];\n    return v != null && v !== \"\" ? v : def;\n  }\n  return `\\${${name}}`;\n}\n\nexport const adapter = new AmpAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/chunk-3JCRUROU.js.map

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

package/dist/chunk-3RBLIHPZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/app.ts"],"sourcesContent":["/**\n * cli/app — shared CLI helpers + command dispatch (NO side effects).\n *\n * Command modules import the shared helpers (print, fail, parse-flags,\n * renderInstallResult) from here, and main() dispatches the first positional to a\n * command module.\n * This module never auto-runs — `cli/index.ts` is the thin bin entry that calls\n * `main()`. Keeping the auto-run out of here is what prevents a dispatch recursion\n * (a command module importing a helper must not re-trigger the program) and makes\n * it robust to bundler entry-splitting (the old import.meta.url entry-guard broke\n * once tsup hoisted this code into a shared chunk).\n */\n\nimport { createRequire } from \"node:module\";\n\nimport type {\n  ChangeRecord,\n  InstallResult,\n  InstallScope,\n  PlatformId,\n} from \"../core/types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Shared helpers (imported by the command modules)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Print a line to stdout (machine-readable payloads must stay on stdout). */\nexport function print(line: string): void {\n  process.stdout.write(`${line}\\n`);\n}\n\n/**\n * The brand active for THIS invocation. main() sets it from\n * {@link MainOptions.programName} before dispatch, so error messages printed by\n * command modules via {@link fail} read as the embedding tool (e.g. `acme-db:`)\n * instead of always `agent-connector:`.\n */\nlet activeProgramName = \"agent-connector\";\n\n/** Print an error to stderr (branded) and return a non-zero exit code (default 2). */\nexport function fail(message: string, code = 2): number {\n  process.stderr.write(`${activeProgramName}: ${message}\\n`);\n  return code;\n}\n\n/**\n * Resolve agent-connector's own package version at runtime. Works from both the\n * bundled dist layout (dist/*.js → ../package.json) and the src layout under\n * tsx/vitest (src/cli/ → ../../package.json); the name check guards against\n * accidentally reading some other package.json on the walk.\n */\nexport function resolveOwnVersion(): string {\n  const req = createRequire(import.meta.url);\n  for (const rel of [\"../package.json\", \"../../package.json\", \"../../../package.json\"]) {\n    try {\n      const pkg = req(rel) as { name?: string; version?: string };\n      if (pkg.name === \"@ken-jo/agent-connector\" && typeof pkg.version === \"string\") {\n        return pkg.version;\n      }\n    } catch {\n      /* keep walking */\n    }\n  }\n  return \"0.0.0\";\n}\n\n/** Parse a --scope value the CLI accepts (user|project) into an InstallScope. */\nexport function parseScope(value: string | undefined): InstallScope | null {\n  if (value === \"user\" || value === \"project\") return value;\n  return null;\n}\n\n/**\n * Parse a comma-separated --targets value into PlatformId[]. Returns undefined\n * when the flag is absent/empty so callers can fall back to connector/detection.\n */\nexport function parseTargets(value: string | undefined): PlatformId[] | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const ids = value\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s !== \"\") as PlatformId[];\n  return ids.length > 0 ? ids : undefined;\n}\n\nconst ACTION_GLYPH: Record<ChangeRecord[\"action\"], string> = {\n  create: \"+\",\n  update: \"~\",\n  remove: \"-\",\n  skip: \"=\",\n  warn: \"!\",\n};\n\n/**\n * Render an InstallResult as a readable diff: one line per ChangeRecord (glyph,\n * platform, detail, path) followed by any warnings and a summary tally. Used by\n * install / upgrade / uninstall.\n */\nexport function renderInstallResult(\n  result: InstallResult,\n  verb: \"install\" | \"upgrade\" | \"uninstall\",\n): string {\n  const lines: string[] = [];\n  const mode = result.dryRun ? \" (dry-run — nothing written)\" : \"\";\n  lines.push(`${verb} \"${result.connectorId}\"${mode}`);\n\n  if (result.changes.length === 0) {\n    lines.push(\"  (no changes)\");\n  } else {\n    for (const c of result.changes) {\n      const glyph = ACTION_GLYPH[c.action];\n      const where = c.path ? `  ${c.path}` : \"\";\n      lines.push(`  ${glyph} [${c.platform}] ${c.action}: ${c.detail}${where}`);\n    }\n  }\n\n  if (result.warnings.length > 0) {\n    lines.push(\"\");\n    lines.push(\"warnings:\");\n    for (const w of result.warnings) lines.push(`  ! ${w}`);\n  }\n\n  const tally = result.changes.reduce<Record<ChangeRecord[\"action\"], number>>(\n    (acc, c) => {\n      acc[c.action] += 1;\n      return acc;\n    },\n    { create: 0, update: 0, remove: 0, skip: 0, warn: 0 },\n  );\n  lines.push(\"\");\n  lines.push(\n    `summary: ${tally.create} created, ${tally.update} updated, ` +\n      `${tally.remove} removed, ${tally.skip} skipped, ${tally.warn} warning(s)`,\n  );\n\n  return lines.join(\"\\n\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Command dispatch\n// ─────────────────────────────────────────────────────────────────────────\n\n/** A command module: takes the post-command argv slice, returns an exit code. */\ntype CommandModule = { run: (argv: string[]) => Promise<number> | number };\n\n/** Lazy command loaders — keyed by the first positional. Imported on demand. */\nconst COMMANDS: Record<string, () => Promise<CommandModule>> = {\n  detect: () => import(\"./commands/detect.js\"),\n  install: () => import(\"./commands/install.js\"),\n  uninstall: () => import(\"./commands/uninstall.js\"),\n  // `upgrade` is the single \"bring everything current\" verb (re-render host\n  // config + refresh the home pointer + managed channel guidance). `sync` and\n  // `update` are kept as back-compat aliases that route to the same module so\n  // existing scripts/docs keep working without a second concept to learn.\n  upgrade: () => import(\"./commands/upgrade.js\"),\n  sync: () => import(\"./commands/upgrade.js\"),\n  update: () => import(\"./commands/upgrade.js\"),\n  package: () => import(\"./commands/package.js\"),\n  doctor: () => import(\"./commands/doctor.js\"),\n  status: () => import(\"./commands/status.js\"),\n  telemetry: () => import(\"./commands/telemetry.js\"),\n  usage: () => import(\"./commands/usage.js\"),\n  leaderboard: () => import(\"./commands/leaderboard.js\"),\n  hook: () => import(\"./commands/hook.js\"),\n  serve: () => import(\"./commands/serve.js\"),\n  // Hidden (omitted from USAGE): the opt-in host-native turn-usage entrypoint an\n  // AfterModel / PostInvocation hook points at. Always exits 0; records a\n  // distinct `model_turn` row. See cli/commands/usage-event.ts.\n  \"usage-event\": () => import(\"./commands/usage-event.js\"),\n};\n\n/** Default program name; an embedding SDK CLI overrides it via {@link MainOptions}. */\nexport const DEFAULT_PROGRAM_NAME = \"agent-connector\";\n\n/**\n * One-line usage signature per command — the single central copy behind\n * `<command> --help` and the friendly bad-flag error. Command modules use\n * node:util parseArgs (strict), which THROWS on an unknown flag; without the\n * dispatcher-level handling in {@link main}, `agent-connector install --help`\n * would die with a raw ERR_PARSE_ARGS stack trace — the very invocation the\n * root help tells users to run.\n */\nconst COMMAND_USAGE: Record<string, string> = {\n  detect: \"detect [--json] [--project <dir>]\",\n  install:\n    \"install [--method direct|marketplace] [--connector <path>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run] [--force]\",\n  uninstall:\n    \"uninstall [--method auto|direct|marketplace] [--connector <path>] [--connector-id <id>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run] [--purge]\",\n  upgrade:\n    \"upgrade [--method direct|marketplace] [--channel stable|latest] [--connector <path>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run]\",\n  sync: \"sync — alias of upgrade (see `upgrade --help`)\",\n  update: \"update — alias of upgrade (see `upgrade --help`)\",\n  package:\n    \"package [--connector <path>] [--format <fmt>|all] [--out <dir>] [--project <dir>] [--dry-run]\",\n  doctor:\n    \"doctor [--targets a,b] [--connector <path>] [--scope user|project] [--project <dir>] [--probe] [--json]\",\n  status: \"status [--connector <path>] [--scope user|project] [--project <dir>] [--json]\",\n  telemetry:\n    \"telemetry report|export|leaderboard [--by <dim>] [--since <dur>] [--connector <id>] [--scope <slice>] [--format csv|json] [--out <file>] [--json]\",\n  usage:\n    \"usage report|export|leaderboard [--by <dim>] [--since <dur>] [--platform <id>] [--format csv|json] [--out <file>] [--json]\",\n  leaderboard: \"leaderboard [--since <dur>] [--connector <id>] [--scope <slice>] [--json]\",\n  hook: \"hook <platform> <event> --connector <id>   (internal — host hook configs point here)\",\n  serve:\n    \"serve --connector <id> [--scope user|project] [--host <platformId>] -- <command> [args...]   (internal — host MCP entries point here)\",\n};\n\n/**\n * Build the top-level usage string for a given program name. The brand replaces\n * \"agent-connector\" in the title, the `usage:` line, and the per-command help\n * footer so an embedded CLI (e.g. `acme-db`) reads as its own tool.\n */\nfunction buildUsage(programName: string): string {\n  return `${programName} — write your MCP server + hooks once, install everywhere.\n\nusage: ${programName} <command> [flags]\n\ncommands:\n  detect       List the AI-agent platforms installed on this machine.\n  install      Deploy a connector across its target platforms (--method direct writes host config; --method marketplace drives the host's plugin install).\n  uninstall    Remove a connector's registrations (--method auto reverses whichever method is actually installed).\n  upgrade      Bring everything current: re-render host config + heal the home pointer + managed update guidance (alias: update, sync).\n  package      Emit a marketplace/extension bundle (9 host formats, or the standard artifacts mcp-server-json | mcpb).\n  doctor       Health-check every detected platform; non-zero exit on any failure.\n  status       Light install-state summary: which connectors are present on which hosts (always exits 0).\n  telemetry    Inspect local per-tool token telemetry (report | export | leaderboard).\n  usage        Inspect host-native token usage from agent CLI logs (report | export | leaderboard).\n  leaderboard  Three leaderboards: 🔌 MCP/plugin (mcp-self) + 🖥️ host/user (host-scan-logs) + 🛰️ host-native turns (host-native-live) — never summed.\n  hook         Universal json-stdio hook entrypoint (hosts call this).\n  serve        Telemetry-wrapping MCP stdio proxy (wraps a real server command).\n\nRun \\`${programName} <command> --help\\` for command-specific flags.`;\n}\n\n/** Options accepted by {@link main}. */\nexport interface MainOptions {\n  /**\n   * The brand shown in usage/help text. Defaults to {@link DEFAULT_PROGRAM_NAME}.\n   * An embedding SDK CLI (see cli/sdk.ts) passes its own bin name so every\n   * subcommand's help reads as the developer's tool.\n   */\n  programName?: string;\n}\n\nexport async function main(argv: string[], opts: MainOptions = {}): Promise<number> {\n  const programName = opts.programName ?? DEFAULT_PROGRAM_NAME;\n  activeProgramName = programName; // brand every fail() in this invocation\n  const usage = buildUsage(programName);\n  const command = argv[0];\n\n  if (command == null || command === \"--help\" || command === \"-h\" || command === \"help\") {\n    print(usage);\n    return command == null ? 1 : 0;\n  }\n  if (command === \"--version\" || command === \"-v\") {\n    print(`${programName} ${resolveOwnVersion()}`);\n    return 0;\n  }\n\n  const loader = COMMANDS[command];\n  if (!loader) {\n    process.stderr.write(`${programName}: unknown command \"${command}\"\\n\\n`);\n    process.stderr.write(`${usage}\\n`);\n    return 2;\n  }\n\n  // Per-command help: no command module defines a --help flag (strict parseArgs\n  // would throw on it), so answer it centrally from COMMAND_USAGE.\n  const rest = argv.slice(1);\n  if (rest.includes(\"--help\") || rest.includes(\"-h\")) {\n    const sig = COMMAND_USAGE[command];\n    if (sig) {\n      print(`usage: ${programName} ${sig}`);\n      return 0;\n    }\n  }\n\n  const mod = await loader();\n  try {\n    return await mod.run(rest);\n  } catch (err) {\n    // Friendly bad-flag errors: strict parseArgs throws ERR_PARSE_ARGS_* for an\n    // unknown/malformed option — print the message + the usage line instead of\n    // letting a raw stack trace reach the user. Everything else still rethrows\n    // (the bin entry reports those as fatal).\n    const code = (err as { code?: string }).code;\n    if (typeof code === \"string\" && code.startsWith(\"ERR_PARSE_ARGS\")) {\n      const message = err instanceof Error ? err.message : String(err);\n      const sig = COMMAND_USAGE[command];\n      if (sig) process.stderr.write(`usage: ${programName} ${sig}\\n`);\n      return fail(message);\n    }\n    throw err;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-GSGDG2BV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/config-patch-ledger.ts","../src/core/define-connector.ts","../src/core/mcp-standard.ts"],"sourcesContent":["/**\n * core/config-patch-ledger — the persisted, refcounted ownership ledger behind\n * the declarative `configPatch` surface, plus the shared configPatch helpers\n * (leaf-path grammar, JSON-value checks, the agent-connector namespace guard,\n * canonical hashing, and the manual-edit hint every skip-warn prints).\n *\n * WHY A LEDGER (and not the hooks-style recompute ownership): hook entries\n * embed the connector id in their command string, so uninstall can identify\n * \"mine\" by inspection. configPatch writes bare host keys (`true` is `true`) —\n * not attributable by inspection — and the same key may be needed by SEVERAL\n * connectors (a shared host feature flag). Without a persisted refcount,\n * connector A uninstalling would delete a key connector B still relies on.\n *\n * Contract (docs/ARCHITECTURE.md §4 \"configPatch\"):\n *   • One global file at `<dataRoot>/state/config-patches.json`, written\n *     ATOMICALLY (temp + rename) — shared across connectors because\n *     refcounting requires a global view; survives a connector's record purge.\n *   • Primary key per entry: (platform, file, key). `prior` is ALWAYS\n *     `{ present: false }` — ownership only ever attaches to keys\n *     agent-connector itself created (set-if-absent), so the blind\n *     \"restore prior value\" footgun is structurally impossible.\n *   • Uninstall removes a key ONLY when the releasing connector is the LAST\n *     owner AND the current value still deep-equals `writtenValue` AND prior\n *     was absent; any mismatch → skip-warn and leave the key in place.\n *   • The ledger is advisory FOR DELETION ONLY: the worst desync outcome is a\n *     skip-warn and a leftover key, never data loss.\n */\n\nimport { createHash, randomBytes } from \"node:crypto\";\nimport {\n  existsSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nimport type { ConfigPatchDef, JsonValue, PlatformId } from \"./types.js\";\nimport { ensureDir } from \"./paths.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Shared configPatch helpers (grammar / values / namespace guard / hints)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Grammar for ONE dotted-path segment: no dots-in-key, no array indices. */\nexport const CONFIG_PATCH_SEGMENT_RE = /^[A-Za-z0-9_-]+$/;\n\n/**\n * True when `key` is a valid dotted LEAF path: 1+ segments joined by \".\",\n * every segment matching {@link CONFIG_PATCH_SEGMENT_RE}.\n */\nexport function isValidConfigPatchKey(key: unknown): key is string {\n  if (typeof key !== \"string\" || key.length === 0) return false;\n  return key.split(\".\").every((seg) => CONFIG_PATCH_SEGMENT_RE.test(seg));\n}\n\n/**\n * True when `value` is JSON-serializable data (string / finite number /\n * boolean / null / arrays / plain objects thereof). Rejects undefined,\n * functions, symbols, bigints, NaN/Infinity (JSON.stringify silently corrupts\n * those), and class instances other than plain objects/arrays.\n */\nexport function isJsonValue(value: unknown): value is JsonValue {\n  if (value === null) return true;\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"object\":\n      break;\n    default:\n      return false;\n  }\n  if (Array.isArray(value)) return value.every((v) => isJsonValue(v));\n  const proto = Object.getPrototypeOf(value);\n  if (proto !== Object.prototype && proto !== null) return false;\n  return Object.values(value as Record<string, unknown>).every((v) => isJsonValue(v));\n}\n\n/**\n * GUARDED NAMESPACE: keys agent-connector already models are NOT patchable —\n * the proper surface must be used instead (otherwise a connector could smuggle\n * hooks past the nativeHooks modeling/reporting, or fight the server install).\n * Returns a human-readable violation pointing at the proper surface, or null.\n * Checked at defineConnector (statically knowable) AND re-enforced in the\n * adapter (meta-loaded connectors must not bypass it).\n */\nexport function configPatchNamespaceViolation(key: string): string | null {\n  const head = key.split(\".\")[0] ?? \"\";\n  if (head === \"hooks\") {\n    return `\"${key}\" targets the hooks config agent-connector already models; declare it via \\`hooks\\` (normalized) or \\`platforms.<id>.nativeHooks\\` instead`;\n  }\n  if (\n    head === \"mcpServers\" ||\n    head === \"enableAllProjectMcpServers\" ||\n    head === \"enabledMcpjsonServers\" ||\n    head === \"disabledMcpjsonServers\"\n  ) {\n    return `\"${key}\" targets MCP server registration agent-connector already models; declare it via \\`server\\` / \\`platforms.<id>.server\\` / \\`extra\\` instead`;\n  }\n  return null;\n}\n\n/**\n * The exact manual edit a user can perform when a patch is skipped (conflict,\n * drift, unsupported host, denylist…). Printed in every skip-warn so a single\n * declaration doubles as its own documented manual step.\n */\nexport function configPatchManualEdit(patch: ConfigPatchDef): string {\n  const docs = patch.docsUrl ? ` — see ${patch.docsUrl}` : \"\";\n  return (\n    `manual edit if wanted: set ${patch.key} = ${describeJsonValue(patch.value)} ` +\n    `(${patch.reason})${docs}`\n  );\n}\n\n/** Compact single-line JSON rendering for diffs/warnings (\"<absent>\" for undefined). */\nexport function describeJsonValue(value: JsonValue | undefined): string {\n  if (value === undefined) return \"<absent>\";\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Canonical JSON / deep equality\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Canonical (sorted-keys) JSON of a value — the hash/equality basis. */\nexport function canonicalJson(value: JsonValue | undefined): string {\n  if (value === undefined) return \"undefined\";\n  if (value === null || typeof value !== \"object\") return JSON.stringify(value);\n  if (Array.isArray(value)) {\n    return `[${value.map((v) => canonicalJson(v)).join(\",\")}]`;\n  }\n  const keys = Object.keys(value).sort();\n  const parts = keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(value[k])}`);\n  return `{${parts.join(\",\")}}`;\n}\n\n/** sha256 of the canonical JSON — the fast path; deep-equal is the authority. */\nexport function hashJsonValue(value: JsonValue): string {\n  return createHash(\"sha256\").update(canonicalJson(value)).digest(\"hex\");\n}\n\n/** Order-insensitive (object keys) deep equality over JSON data. */\nexport function jsonDeepEquals(\n  a: JsonValue | undefined,\n  b: JsonValue | undefined,\n): boolean {\n  return canonicalJson(a) === canonicalJson(b);\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Ledger shape + persistence\n// ─────────────────────────────────────────────────────────────────────────\n\n/** One connector's registration on a ledger entry. */\nexport interface ConfigPatchOwner {\n  connectorId: string;\n  connectorVersion: string;\n  installedAt: string;\n}\n\n/** Refcounted ownership record for one (platform, file, key). */\nexport interface ConfigPatchLedgerEntry {\n  platform: PlatformId;\n  /** Absolute path of the file actually written (scope-resolved at install time). */\n  file: string;\n  /** Dotted leaf path — (platform, file, key) is the primary key. */\n  key: string;\n  writtenValue: JsonValue;\n  /** sha256 of canonical (sorted-keys) JSON of writtenValue (fast path only). */\n  writtenValueHash: string;\n  /** Always { present: false } — ownership ONLY attaches to keys we created. */\n  prior: { present: false };\n  owners: ConfigPatchOwner[];\n}\n\nexport interface ConfigPatchLedger {\n  version: 1;\n  entries: ConfigPatchLedgerEntry[];\n}\n\n/** Ledger file path under the framework data-root. */\nexport function configPatchLedgerPath(dataRoot: string): string {\n  return join(dataRoot, \"state\", \"config-patches.json\");\n}\n\n/**\n * Load the ledger; a missing or corrupt file degrades to an empty ledger\n * (advisory-for-deletion-only: a lost ledger can never cause data loss, only\n * retained keys + skip-warns).\n */\nexport function loadConfigPatchLedger(dataRoot: string): ConfigPatchLedger {\n  const path = configPatchLedgerPath(dataRoot);\n  if (!existsSync(path)) return { version: 1, entries: [] };\n  try {\n    const parsed = JSON.parse(readFileSync(path, \"utf8\")) as ConfigPatchLedger;\n    if (!parsed || !Array.isArray(parsed.entries)) return { version: 1, entries: [] };\n    return { version: 1, entries: parsed.entries.filter(isPlausibleEntry) };\n  } catch {\n    return { version: 1, entries: [] };\n  }\n}\n\n/** Minimal shape sanity for a persisted entry (corrupt rows are dropped). */\nfunction isPlausibleEntry(e: unknown): e is ConfigPatchLedgerEntry {\n  if (e == null || typeof e !== \"object\") return false;\n  const entry = e as Partial<ConfigPatchLedgerEntry>;\n  return (\n    typeof entry.platform === \"string\" &&\n    typeof entry.file === \"string\" &&\n    typeof entry.key === \"string\" &&\n    Array.isArray(entry.owners)\n  );\n}\n\n/**\n * Persist the ledger ATOMICALLY: write to a temp file in the same directory,\n * then rename over the target (rename is atomic on the same filesystem).\n */\nexport function saveConfigPatchLedger(dataRoot: string, ledger: ConfigPatchLedger): void {\n  const path = configPatchLedgerPath(dataRoot);\n  ensureDir(dirname(path));\n  const tmpFile = `${path}.${process.pid}-${randomBytes(4).toString(\"hex\")}.tmp`;\n  try {\n    writeFileSync(tmpFile, `${JSON.stringify(ledger, null, 2)}\\n`, \"utf8\");\n    renameSync(tmpFile, path);\n  } catch (err) {\n    rmSync(tmpFile, { force: true });\n    throw err;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Ledger operations (pure in-memory; callers load → mutate → save)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Find the entry for (platform, file, key), or undefined. */\nexport function findLedgerEntry(\n  ledger: ConfigPatchLedger,\n  platform: PlatformId,\n  file: string,\n  key: string,\n): ConfigPatchLedgerEntry | undefined {\n  return ledger.entries.find(\n    (e) => e.platform === platform && e.file === file && e.key === key,\n  );\n}\n\n/** Every entry on `platform` owned (at least in part) by `connectorId`. */\nexport function ledgerEntriesOwnedBy(\n  ledger: ConfigPatchLedger,\n  platform: PlatformId,\n  connectorId: string,\n): ConfigPatchLedgerEntry[] {\n  return ledger.entries.filter(\n    (e) => e.platform === platform && e.owners.some((o) => o.connectorId === connectorId),\n  );\n}\n\n/** Create a fresh entry (prior is absent BY CONSTRUCTION) and append it. */\nexport function createLedgerEntry(\n  ledger: ConfigPatchLedger,\n  init: {\n    platform: PlatformId;\n    file: string;\n    key: string;\n    value: JsonValue;\n    connectorId: string;\n    connectorVersion: string;\n  },\n): ConfigPatchLedgerEntry {\n  const entry: ConfigPatchLedgerEntry = {\n    platform: init.platform,\n    file: init.file,\n    key: init.key,\n    writtenValue: init.value,\n    writtenValueHash: hashJsonValue(init.value),\n    prior: { present: false },\n    owners: [\n      {\n        connectorId: init.connectorId,\n        connectorVersion: init.connectorVersion,\n        installedAt: new Date().toISOString(),\n      },\n    ],\n  };\n  ledger.entries.push(entry);\n  return entry;\n}\n\n/**\n * Register `connectorId` as a (co-)owner. Returns true when added, false when\n * it was already an owner (idempotent re-install → no ledger mutation).\n */\nexport function addLedgerOwner(\n  entry: ConfigPatchLedgerEntry,\n  connectorId: string,\n  connectorVersion: string,\n): boolean {\n  if (entry.owners.some((o) => o.connectorId === connectorId)) return false;\n  entry.owners.push({\n    connectorId,\n    connectorVersion,\n    installedAt: new Date().toISOString(),\n  });\n  return true;\n}\n\n/**\n * Remove `connectorId` from the owners. Returns whether an owner was removed\n * and whether the entry is now ownerless (last owner out).\n */\nexport function removeLedgerOwner(\n  entry: ConfigPatchLedgerEntry,\n  connectorId: string,\n): { removed: boolean; lastOwner: boolean } {\n  const before = entry.owners.length;\n  entry.owners = entry.owners.filter((o) => o.connectorId !== connectorId);\n  return { removed: entry.owners.length < before, lastOwner: entry.owners.length === 0 };\n}\n\n/** Drop an entry from the ledger (identity match). */\nexport function dropLedgerEntry(\n  ledger: ConfigPatchLedger,\n  entry: ConfigPatchLedgerEntry,\n): void {\n  ledger.entries = ledger.entries.filter((e) => e !== entry);\n}\n","/**\n * core/define-connector — the public write-once entry point.\n *\n * Validates a ConnectorConfig and normalizes it into a ResolvedConnector with\n * every optional field resolved to a default. Validation is intentionally\n * dependency-free (no zod) to keep the single-binary install lean.\n */\n\nimport { isAbsolute, normalize } from \"node:path\";\n\nimport type {\n  CommandDef,\n  ConnectorConfig,\n  HookEventName,\n  HooksConfig,\n  MemoryDef,\n  PublishConfig,\n  ResolvedConnector,\n  SkillDef,\n  SubagentDef,\n} from \"./types.js\";\nimport { REGISTRY_NAMESPACE_RE } from \"./mcp-standard.js\";\nimport {\n  MANAGED_BLOCK_BEGIN_TOKEN,\n  MANAGED_BLOCK_END_TOKEN,\n  MEMORY_CONTENT_HARD_CAP_BYTES,\n} from \"./managed-block.js\";\nimport {\n  CONFIG_PATCH_SEGMENT_RE,\n  configPatchNamespaceViolation,\n  isJsonValue,\n  isValidConfigPatchKey,\n} from \"./config-patch-ledger.js\";\n\nconst ID_RE = /^[a-z0-9][a-z0-9-]*$/;\n\n/** kebab-case name regex shared by command/skill/subagent names. */\nconst SURFACE_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;\n\n/** Max length of a skill description (Agent Skills open standard). */\nconst SKILL_DESCRIPTION_MAX = 1024;\n\n// NOTE: canonical ordering — append new events at the END (hookEvents ordering\n// is pinned by tests and feeds install-file ordering).\nconst ALL_EVENTS: HookEventName[] = [\n  \"SessionStart\",\n  \"SessionEnd\",\n  \"UserPromptSubmit\",\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"PreCompact\",\n  \"Stop\",\n  \"Notification\",\n  \"PermissionRequest\",\n  \"PostToolUseFailure\",\n  \"SubagentStart\",\n  \"SubagentStop\",\n];\n\n/** Thrown on an invalid connector configuration. */\nexport class ConnectorConfigError extends Error {\n  constructor(message: string) {\n    super(`Invalid connector config: ${message}`);\n    this.name = \"ConnectorConfigError\";\n  }\n}\n\nfunction declaredEvents(hooks: HooksConfig | undefined): HookEventName[] {\n  if (!hooks) return [];\n  return ALL_EVENTS.filter((e) => typeof hooks[e]?.handler === \"function\");\n}\n\n/**\n * Validate + normalize a connector definition.\n * Returns a ResolvedConnector that adapters and the CLI consume directly.\n */\nexport function defineConnector(config: ConnectorConfig): ResolvedConnector {\n  if (!config || typeof config !== \"object\") {\n    throw new ConnectorConfigError(\"config must be an object\");\n  }\n  if (typeof config.id !== \"string\" || !ID_RE.test(config.id)) {\n    throw new ConnectorConfigError(\n      `id must be kebab-case matching ${ID_RE} (got ${JSON.stringify(config.id)})`,\n    );\n  }\n  const hasCommands = Array.isArray(config.commands) && config.commands.length > 0;\n  const hasSkills = Array.isArray(config.skills) && config.skills.length > 0;\n  const hasSubagents = Array.isArray(config.subagents) && config.subagents.length > 0;\n  const hasMemory = Array.isArray(config.memory) && config.memory.length > 0;\n  // A platform-scoped nativeHooks declaration is a legitimate sole payload\n  // (a hooks-only connector wired entirely through native passthrough events).\n  const hasNativeHooks = Object.values(config.platforms ?? {}).some(\n    (override) =>\n      override?.nativeHooks != null && Object.keys(override.nativeHooks).length > 0,\n  );\n  // Likewise a platform-scoped configPatch declaration (a connector whose whole\n  // job is asserting a host config key, e.g. an experimental feature flag).\n  const hasConfigPatch = Object.values(config.platforms ?? {}).some(\n    (override) => Array.isArray(override?.configPatch) && override.configPatch.length > 0,\n  );\n  if (\n    !config.server &&\n    !config.hooks &&\n    !hasCommands &&\n    !hasSkills &&\n    !hasSubagents &&\n    !hasMemory &&\n    !hasNativeHooks &&\n    !hasConfigPatch\n  ) {\n    throw new ConnectorConfigError(\n      \"a connector must declare at least one of `server`, `hooks`, `commands`, `skills`, `subagents`, `memory`, \" +\n        \"or a per-platform `nativeHooks` / `configPatch` declaration\",\n    );\n  }\n\n  if (config.server) {\n    const s = config.server;\n    if (s.transport === \"stdio\") {\n      if (!s.command || typeof s.command !== \"string\") {\n        throw new ConnectorConfigError(\n          \"server.command is required for stdio transport\",\n        );\n      }\n    } else {\n      if (!s.url || typeof s.url !== \"string\") {\n        throw new ConnectorConfigError(\n          `server.url is required for ${s.transport} transport`,\n        );\n      }\n    }\n  }\n\n  // Validate hook handlers are functions.\n  if (config.hooks) {\n    for (const ev of ALL_EVENTS) {\n      const def = config.hooks[ev];\n      if (def != null && typeof def.handler !== \"function\") {\n        throw new ConnectorConfigError(`hooks.${ev}.handler must be a function`);\n      }\n    }\n  }\n\n  // Validate per-platform native passthrough hooks (handlers live in this same\n  // config module, exactly like normalized hooks — the resolved connector keeps\n  // `platforms` verbatim, so live handlers survive resolution and are recovered\n  // at runtime by re-importing the module via the registry's modulePath).\n  validateNativeHooks(config.platforms);\n\n  // Validate per-platform declarative config patches (pure JSON — persisted\n  // whole; semantics are FIXED set-if-absent/skip-warn, so only the shape is\n  // validated here; the host adapter enforces its sensitive-key denylist).\n  validateConfigPatches(config.platforms);\n\n  const commands = normalizeCommands(config.commands);\n  const skills = normalizeSkills(config.skills);\n  const subagents = normalizeSubagents(config.subagents);\n  const memory = normalizeMemory(config.memory);\n\n  const t = config.telemetry ?? {};\n\n  const resolved: ResolvedConnector = {\n    id: config.id,\n    displayName: config.displayName ?? config.id,\n    version: config.version ?? \"0.0.0\",\n    ...(config.server ? { server: normalizeServer(config.server) } : {}),\n    hooks: config.hooks ?? {},\n    hookEvents: declaredEvents(config.hooks),\n    telemetry: {\n      enabled: t.enabled ?? true,\n      modelFamilyHint: t.modelFamilyHint ?? \"auto\",\n      measureToolDefs: t.measureToolDefs ?? true,\n      // OPT-IN: host-native turn-usage capture is OFF unless explicitly enabled\n      // in config (or forced on at install via AGENT_CONNECTOR_HOST_NATIVE=1).\n      hostNativeUsage: t.hostNativeUsage ?? false,\n      store: t.store ?? \"ndjson\",\n      calibration: {\n        anthropicCountTokens: t.calibration?.anthropicCountTokens ?? false,\n      },\n    },\n    commands,\n    skills,\n    subagents,\n    memory,\n    platforms: config.platforms ?? {},\n    targets: config.targets ?? \"auto\",\n    ...(config.publish ? { publish: normalizePublish(config.publish) } : {}),\n  };\n\n  return resolved;\n}\n\n/** The 12 normalized event names, for the nativeHooks collision check. */\nconst NORMALIZED_EVENT_SET: ReadonlySet<string> = new Set(ALL_EVENTS);\n\n/**\n * Validate every `platforms[<id>].nativeHooks` declaration:\n *   - the value must be an object keyed by HOST-NATIVE event name;\n *   - an event name must NOT collide with the normalized {@link HookEventName}\n *     union (those belong in the cross-platform `hooks` API, which gets\n *     normalization, matcher evaluation, and HookResponse mapping);\n *   - each handler must be a function (it is re-imported from the config module\n *     at runtime, like normalized hook handlers);\n *   - `matcher`, when present, must be a string (written verbatim into the\n *     host's hook config — the host evaluates it).\n */\nfunction validateNativeHooks(platforms: ConnectorConfig[\"platforms\"]): void {\n  if (platforms == null) return;\n  for (const [platformId, override] of Object.entries(platforms)) {\n    const native = override?.nativeHooks;\n    if (native == null) continue;\n    const where = `platforms.${platformId}.nativeHooks`;\n    if (typeof native !== \"object\" || Array.isArray(native)) {\n      throw new ConnectorConfigError(\n        `${where} must be an object keyed by host-native event name`,\n      );\n    }\n    for (const [event, def] of Object.entries(native)) {\n      if (NORMALIZED_EVENT_SET.has(event)) {\n        throw new ConnectorConfigError(\n          `${where}.${event} collides with the normalized hook event \"${event}\"; ` +\n            `declare it under \\`hooks.${event}\\` (the normalized, cross-platform hooks API) instead`,\n        );\n      }\n      if (def == null || typeof def !== \"object\" || typeof def.handler !== \"function\") {\n        throw new ConnectorConfigError(`${where}.${event}.handler must be a function`);\n      }\n      if (def.matcher !== undefined && typeof def.matcher !== \"string\") {\n        throw new ConnectorConfigError(`${where}.${event}.matcher must be a string`);\n      }\n    }\n  }\n}\n\n/**\n * Validate every `platforms[<id>].configPatch` declaration:\n *   - the value must be an array of patch objects;\n *   - `key` must be a dotted LEAF path whose segments match\n *     {@link CONFIG_PATCH_SEGMENT_RE} — no dots-in-key, no array indices;\n *   - `key` must not collide with the agent-connector-modeled namespace\n *     (`hooks*` → hooks/nativeHooks; `mcpServers*` & friends → server/extra);\n *   - duplicate keys within one platform's list are rejected (a duplicate\n *     would double-apply / fight itself on refcounts);\n *   - `value` must be JSON-serializable data (it is persisted whole in the\n *     connector record and in the ownership ledger);\n *   - `reason` is REQUIRED (printed in the install diff and every skip-warn);\n *   - `docsUrl`, when present, must be a string.\n * The HOST-side sensitive-key denylist is deliberately NOT validated here —\n * it lives in (and is documented by) each supporting adapter.\n */\nfunction validateConfigPatches(platforms: ConnectorConfig[\"platforms\"]): void {\n  if (platforms == null) return;\n  for (const [platformId, override] of Object.entries(platforms)) {\n    const patches = override?.configPatch;\n    if (patches == null) continue;\n    const where = `platforms.${platformId}.configPatch`;\n    if (!Array.isArray(patches)) {\n      throw new ConnectorConfigError(`${where} must be an array of patch objects`);\n    }\n    const seen = new Set<string>();\n    patches.forEach((patch, i) => {\n      if (patch == null || typeof patch !== \"object\" || Array.isArray(patch)) {\n        throw new ConnectorConfigError(`${where}[${i}] must be an object`);\n      }\n      if (!isValidConfigPatchKey(patch.key)) {\n        throw new ConnectorConfigError(\n          `${where}[${i}].key must be a dotted LEAF path whose segments match ` +\n            `${CONFIG_PATCH_SEGMENT_RE} (no dots-in-key, no array indices); ` +\n            `got ${JSON.stringify(patch.key)}`,\n        );\n      }\n      const violation = configPatchNamespaceViolation(patch.key);\n      if (violation) {\n        throw new ConnectorConfigError(`${where}[${i}].key ${violation}`);\n      }\n      if (seen.has(patch.key)) {\n        throw new ConnectorConfigError(\n          `${where}[${i}] duplicate key \"${patch.key}\"`,\n        );\n      }\n      seen.add(patch.key);\n      if (!isJsonValue(patch.value)) {\n        throw new ConnectorConfigError(\n          `${where}[${i}].value must be JSON-serializable data ` +\n            `(string/finite number/boolean/null/array/plain object)`,\n        );\n      }\n      if (typeof patch.reason !== \"string\" || patch.reason.trim() === \"\") {\n        throw new ConnectorConfigError(\n          `${where}[${i}].reason is required (a human-readable why, printed in ` +\n            `the install diff and every skip-warn)`,\n        );\n      }\n      if (patch.docsUrl !== undefined && typeof patch.docsUrl !== \"string\") {\n        throw new ConnectorConfigError(`${where}[${i}].docsUrl must be a string`);\n      }\n    });\n  }\n}\n\n/**\n * Validate the optional `publish` block (registry server.json + MCPB bundle\n * distribution metadata). Light, dependency-free: we only reject shapes that\n * would emit a clearly INVALID standard artifact. The per-format required-field\n * checks (e.g. server.json needs registryNamespace, mcpb needs author.name)\n * live in the emitters so a connector that never publishes pays nothing.\n */\nfunction normalizePublish(publish: PublishConfig): PublishConfig {\n  if (typeof publish !== \"object\" || Array.isArray(publish)) {\n    throw new ConnectorConfigError(\"publish must be an object\");\n  }\n  if (publish.registryNamespace !== undefined) {\n    const ns = publish.registryNamespace;\n    if (typeof ns !== \"string\" || !REGISTRY_NAMESPACE_RE.test(ns)) {\n      throw new ConnectorConfigError(\n        `publish.registryNamespace must be a reverse-DNS namespace matching ${REGISTRY_NAMESPACE_RE} ` +\n          `(e.g. \"io.github.acme\" or \"com.acme\"); got ${JSON.stringify(ns)}`,\n      );\n    }\n  }\n  if (publish.packageName !== undefined && typeof publish.packageName !== \"string\") {\n    throw new ConnectorConfigError(\"publish.packageName must be a string\");\n  }\n  if (publish.author !== undefined) {\n    const a = publish.author;\n    if (typeof a !== \"object\" || a == null || typeof a.name !== \"string\" || a.name === \"\") {\n      throw new ConnectorConfigError(\"publish.author.name must be a non-empty string\");\n    }\n  }\n  return { ...publish };\n}\n\n/** Validate a surface name (kebab-case) or throw a ConnectorConfigError. */\nfunction assertSurfaceName(surface: string, name: unknown, index: number): string {\n  if (typeof name !== \"string\" || !SURFACE_NAME_RE.test(name)) {\n    throw new ConnectorConfigError(\n      `${surface}[${index}].name must be kebab-case matching ${SURFACE_NAME_RE} (got ${JSON.stringify(name)})`,\n    );\n  }\n  return name;\n}\n\n/** Require a non-empty string field on a surface entry. */\nfunction assertNonEmptyString(\n  surface: string,\n  index: number,\n  field: string,\n  value: unknown,\n): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    throw new ConnectorConfigError(`${surface}[${index}].${field} must be a non-empty string`);\n  }\n  return value;\n}\n\n/** Detect a duplicate surface name within one array, throwing on collision. */\nfunction assertNoDuplicate(\n  surface: string,\n  seen: Set<string>,\n  name: string,\n  index: number,\n): void {\n  if (seen.has(name)) {\n    throw new ConnectorConfigError(`${surface}[${index}] duplicate name \"${name}\"`);\n  }\n  seen.add(name);\n}\n\nfunction normalizeCommands(input: CommandDef[] | undefined): CommandDef[] {\n  if (input == null) return [];\n  if (!Array.isArray(input)) {\n    throw new ConnectorConfigError(\"commands must be an array\");\n  }\n  const seen = new Set<string>();\n  return input.map((cmd, i) => {\n    if (!cmd || typeof cmd !== \"object\") {\n      throw new ConnectorConfigError(`commands[${i}] must be an object`);\n    }\n    const name = assertSurfaceName(\"commands\", cmd.name, i);\n    assertNoDuplicate(\"commands\", seen, name, i);\n    assertNonEmptyString(\"commands\", i, \"prompt\", cmd.prompt);\n    // Pass through verbatim (content); arrays are content, not handlers.\n    return { ...cmd, name };\n  });\n}\n\nfunction normalizeSkills(input: SkillDef[] | undefined): SkillDef[] {\n  if (input == null) return [];\n  if (!Array.isArray(input)) {\n    throw new ConnectorConfigError(\"skills must be an array\");\n  }\n  const seen = new Set<string>();\n  return input.map((skill, i) => {\n    if (!skill || typeof skill !== \"object\") {\n      throw new ConnectorConfigError(`skills[${i}] must be an object`);\n    }\n    const name = assertSurfaceName(\"skills\", skill.name, i);\n    assertNoDuplicate(\"skills\", seen, name, i);\n    const description = assertNonEmptyString(\"skills\", i, \"description\", skill.description);\n    if (description.length > SKILL_DESCRIPTION_MAX) {\n      throw new ConnectorConfigError(\n        `skills[${i}].description exceeds ${SKILL_DESCRIPTION_MAX} chars (got ${description.length})`,\n      );\n    }\n    assertNonEmptyString(\"skills\", i, \"body\", skill.body);\n    assertSafeResourceKeys(\"skills\", i, skill.resources);\n    return { ...skill, name };\n  });\n}\n\n/**\n * Validate every `skill.resources` key as a SAFE relative path that stays inside\n * the skill dir. Each resource is later written/removed via join(skillDir, rel)\n * by every adapter, so an unvalidated key like \"../../settings.json\" would\n * escape the skill dir → arbitrary file write/delete. Reject (throw) when a key\n * is empty/\".\", absolute, or normalizes to a path that begins with \"..\" or\n * contains a \"/..\" (or platform-sep) traversal segment.\n */\nfunction assertSafeResourceKeys(\n  surface: string,\n  index: number,\n  resources: Record<string, string> | undefined,\n): void {\n  if (resources == null) return;\n  if (typeof resources !== \"object\" || Array.isArray(resources)) {\n    throw new ConnectorConfigError(`${surface}[${index}].resources must be an object`);\n  }\n  for (const rel of Object.keys(resources)) {\n    if (rel === \"\" || rel === \".\" || rel.trim() === \"\") {\n      throw new ConnectorConfigError(\n        `${surface}[${index}].resources key must be a non-empty relative path (got ${JSON.stringify(rel)})`,\n      );\n    }\n    if (isAbsolute(rel)) {\n      throw new ConnectorConfigError(\n        `${surface}[${index}].resources key must be a relative path inside the skill dir, not absolute (got ${JSON.stringify(rel)})`,\n      );\n    }\n    // Normalize with BOTH posix and native separators flattened so a Windows\n    // \"..\\\\x\" or a posix \"../x\" is caught regardless of the host OS.\n    const norm = normalize(rel.replace(/\\\\/g, \"/\"));\n    const segs = norm.split(/[/\\\\]/);\n    if (norm === \"..\" || norm.startsWith(\"../\") || norm.startsWith(\"..\\\\\") || segs.includes(\"..\")) {\n      throw new ConnectorConfigError(\n        `${surface}[${index}].resources key must not escape the skill dir via \"..\" (got ${JSON.stringify(rel)})`,\n      );\n    }\n  }\n}\n\n/** Default name for a single-entry memory declaration. */\nconst MEMORY_DEFAULT_NAME = \"memory\";\n\n/**\n * Validate + normalize `memory` entries (the managed-block content surface).\n *   - `name` defaults to \"memory\", then must be kebab-case and unique — it is\n *     half of the block marker id (`<connectorId>/<name>`) and must stay stable;\n *   - `content` must be a non-empty string, ≤ 16 KiB (hard cap — memory files\n *     are injected into every prompt of every session on the host), and must\n *     NOT contain the literal marker tokens `agent-connector:begin` /\n *     `agent-connector:end` (they would corrupt marker scanning in the shared\n *     file — rephrase the guidance instead). The 4 KiB SOFT budget is reported\n *     at install time as a `warn` ChangeRecord, not a config error\n *     (defineConnector has no warning channel).\n */\nfunction normalizeMemory(input: MemoryDef[] | undefined): MemoryDef[] {\n  if (input == null) return [];\n  if (!Array.isArray(input)) {\n    throw new ConnectorConfigError(\"memory must be an array\");\n  }\n  const seen = new Set<string>();\n  return input.map((entry, i) => {\n    if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) {\n      throw new ConnectorConfigError(`memory[${i}] must be an object`);\n    }\n    const name =\n      entry.name === undefined\n        ? MEMORY_DEFAULT_NAME\n        : assertSurfaceName(\"memory\", entry.name, i);\n    assertNoDuplicate(\"memory\", seen, name, i);\n    const content = assertNonEmptyString(\"memory\", i, \"content\", entry.content);\n    const bytes = Buffer.byteLength(content, \"utf8\");\n    if (bytes > MEMORY_CONTENT_HARD_CAP_BYTES) {\n      throw new ConnectorConfigError(\n        `memory[${i}].content exceeds the ${MEMORY_CONTENT_HARD_CAP_BYTES}-byte hard cap ` +\n          `(got ${bytes} bytes); memory is inlined into every prompt of every targeted host — keep it terse`,\n      );\n    }\n    for (const token of [MANAGED_BLOCK_BEGIN_TOKEN, MANAGED_BLOCK_END_TOKEN]) {\n      if (content.includes(token)) {\n        throw new ConnectorConfigError(\n          `memory[${i}].content must not contain the literal marker token \"${token}\" ` +\n            `(it would corrupt managed-block scanning in the shared memory file); rephrase the guidance`,\n        );\n      }\n    }\n    if (entry.description !== undefined && typeof entry.description !== \"string\") {\n      throw new ConnectorConfigError(`memory[${i}].description must be a string`);\n    }\n    return { ...entry, name };\n  });\n}\n\nfunction normalizeSubagents(input: SubagentDef[] | undefined): SubagentDef[] {\n  if (input == null) return [];\n  if (!Array.isArray(input)) {\n    throw new ConnectorConfigError(\"subagents must be an array\");\n  }\n  const seen = new Set<string>();\n  return input.map((agent, i) => {\n    if (!agent || typeof agent !== \"object\") {\n      throw new ConnectorConfigError(`subagents[${i}] must be an object`);\n    }\n    const name = assertSurfaceName(\"subagents\", agent.name, i);\n    assertNoDuplicate(\"subagents\", seen, name, i);\n    assertNonEmptyString(\"subagents\", i, \"description\", agent.description);\n    assertNonEmptyString(\"subagents\", i, \"prompt\", agent.prompt);\n    return { ...agent, name };\n  });\n}\n\nfunction normalizeServer(server: ConnectorConfig[\"server\"]): ResolvedConnector[\"server\"] {\n  if (!server) return undefined;\n  const wrapDefault = server.transport === \"stdio\";\n  return {\n    ...server,\n    enabled: server.enabled ?? true,\n    tools: server.tools ?? { include: [\"*\"] },\n    wrapForTelemetry: server.wrapForTelemetry ?? wrapDefault,\n  };\n}\n","/**\n * core/mcp-standard — pinned literals + guards for the official MCP standards\n * agent-connector EMITS (registry server.json, MCPB bundle) or SPEAKS (the\n * connection-lifecycle wire used by `doctor --probe`).\n *\n * Each pinned constant is the CURRENT released value verified 2026-06-05 against\n * the upstream spec/schema. They are deliberately centralized + annotated\n * MUST-VERIFY-AT-IMPLEMENTATION: a newer spec revision can supersede any of them\n * without breaking us, so the bump is a one-line change here, never scattered.\n *\n * Sources:\n *  • server.schema.json 2025-12-11 — https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json\n *  • MCPB manifest 0.3 — github.com/anthropics/mcpb (MANIFEST.md)\n *  • MCP protocol 2025-11-25 — modelcontextprotocol.io/specification/2025-11-25\n *    (latest RELEASED revision. 2026-07-28 is a release-candidate only — do NOT\n *    advance to it until it publishes as a stable dated revision. The probe\n *    offers this version but ACCEPTS whatever a server negotiates, so the\n *    offered literal being stale never breaks interop — only this constant.)\n */\n\nimport type { Transport } from \"./types.js\";\n\n/** Registry server.json JSON Schema URL (released 2025-12-11). MUST-VERIFY on bump. */\nexport const MCP_SERVER_SCHEMA_URL =\n  \"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json\";\n\n/** Current MCPB bundle manifest_version (anthropics/mcpb). MUST-VERIFY on bump. */\nexport const MCPB_MANIFEST_VERSION = \"0.3\";\n\n/**\n * Latest RELEASED MCP protocol revision `doctor --probe` offers in `initialize`.\n * Current = 2025-11-25. MUST-VERIFY on bump; stay on the latest *released*\n * revision (2026-07-28 is RC-only as of 2026-06). Negotiation accepts whatever\n * the server returns, so this is the offered value, not a hard requirement.\n */\nexport const MCP_PROTOCOL_VERSION = \"2025-11-25\";\n\n/** Default npm registry base URL stamped into server.json npm packages. */\nexport const NPM_REGISTRY_BASE_URL = \"https://registry.npmjs.org\";\n\n/**\n * server.json transport.type enum — the EXACT values the 2025-12-11 schema\n * accepts (packages[].transport.type and remotes[].type). Our `http` Transport\n * maps to the spec slug \"streamable-http\"; \"ws\" is non-spec (see below).\n */\nexport type RegistryTransportType = \"stdio\" | \"streamable-http\" | \"sse\";\n\n/**\n * Map our {@link Transport} union to the registry/server.json transport slug.\n * Returns null for \"ws\" — WebSocket is NOT a spec transport (it can only exist\n * as a vendor custom transport, e.g. Claude Code's non-spec type:\"ws\"), so a\n * conformant artifact must REJECT it rather than emit an invalid type. The spec\n * defines exactly stdio + streamable-http, with sse the deprecated HTTP+SSE.\n */\nexport function registryTransportType(transport: Transport): RegistryTransportType | null {\n  switch (transport) {\n    case \"stdio\":\n      return \"stdio\";\n    case \"http\":\n      return \"streamable-http\";\n    case \"sse\":\n      return \"sse\";\n    case \"ws\":\n      return null;\n  }\n}\n\n/**\n * Is `v` a CONCRETE version the MCP Registry accepts? The registry rejects\n * ranges (\"^1.2.3\", \"~1.2.3\", \">=1.2.3\", \"1.x\", \"1.*\"); only a pinned SemVer\n * (optionally with a -prerelease / +build suffix) is valid. \"0.0.0\" is concrete\n * (so it passes this guard) but is the unset placeholder — callers warn on it\n * separately via {@link isPlaceholderVersion}.\n */\nexport function isConcreteSemver(v: string): boolean {\n  return /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(v);\n}\n\n/** The unset default version a connector ships with until the dev sets a real one. */\nexport function isPlaceholderVersion(v: string): boolean {\n  return v === \"0.0.0\";\n}\n\n/**\n * Reverse-DNS registry namespace pattern (the part BEFORE the \"/\" in a\n * server.json `name`). The full name regex is\n * `^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$`; the namespace side allows letters, digits,\n * dots and hyphens (NO underscore) — e.g. \"io.github.acme\" or \"com.acme\".\n */\nexport const REGISTRY_NAMESPACE_RE = /^[a-zA-Z0-9.-]+$/;\n\n/** The full server.json `name` regex (namespace \"/\" server-name), per the schema. */\nexport const REGISTRY_NAME_RE = /^[a-zA-Z0-9.-]+\\/[a-zA-Z0-9._-]+$/;\n"],"mappings":"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","names":[]}