@ken-jo/agent-connector 0.1.0 → 0.3.0

package/dist/status-FE7TECZD.js.map

@@ -1 +0,0 @@
-{"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 { 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}\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      return {\n        id: connector.id,\n        serverPresent: serverPath ? fileMentions(serverPath, connector.id) : false,\n        hooksPresent: hookPath ? fileMentions(hookPath, connector.id) : false,\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.serverPresent || c.hooksPresent ? \"[installed]\" : \"[absent   ]\";\n        const server = c.serverPresent ? \"server ✓\" : \"server ·\";\n        const hooks = c.hooksPresent ? \"hooks ✓\" : \"hooks ·\";\n        print(`  ${mark} ${c.id}  ${server}  ${hooks}`);\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":";;;;;;;;;;;;;;;;;;;;;;AAkBA,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAoB7B,eAAe,kBACb,eACA,YAC8B;AAC9B,QAAM,aAAa,iBAAiB,oBAAoB,UAAU;AAClE,MAAI,YAAY;AACd,QAAI;AACF,YAAM,EAAE,UAAU,IAAI,MAAM,sBAAsB,UAAU;AAC5D,aAAO,CAAC,SAAS;AAAA,IACnB,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,yBAAyB;AAClC;AAEA,SAAS,aACP,WACA,IACA,OACA,YACgB;AAChB,SAAO;AAAA,IACL;AAAA,IACA,OAAO,UAAU,UAAU,EAAE,GAAG,SAAS;AAAA,IACzC;AAAA,IACA,aAAa,YAAY;AAAA,IACzB,UAAU,SAAS;AAAA,IACnB,QAAQ;AAAA,EACV;AACF;AAGA,SAAS,aAAa,MAAc,QAAyB;AAC3D,MAAI;AACF,WAAO,aAAa,MAAM,MAAM,EAAE,SAAS,MAAM;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAcA,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,MAAM,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC1C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AAErF,QAAM,aAAa,MAAM,kBAAkB,OAAO,WAAW,UAAU;AACvE,QAAM,WAAW,MAAM,yBAAyB,UAAU;AAE1D,QAAM,OAAoB,CAAC;AAC3B,aAAW,KAAK,UAAU;AACxB,UAAM,UAAU,MAAM,YAAY,EAAE,EAAE;AACtC,QAAI,CAAC,QAAS;AACd,UAAM,eAA6B,WAAW,IAAI,CAAC,cAAc;AAC/D,YAAM,MAAM,aAAa,WAAW,EAAE,IAAI,OAAO,UAAU;AAC3D,UAAI,aAAa;AACjB,UAAI,WAAW;AACf,UAAI;AACF,qBAAa,QAAQ,oBAAoB,GAAG;AAAA,MAC9C,QAAQ;AAAA,MAER;AACA,UAAI;AACF,mBAAW,QAAQ,kBAAkB,GAAG;AAAA,MAC1C,QAAQ;AAAA,MAER;AACA,aAAO;AAAA,QACL,IAAI,UAAU;AAAA,QACd,eAAe,aAAa,aAAa,YAAY,UAAU,EAAE,IAAI;AAAA,QACrE,cAAc,WAAW,aAAa,UAAU,UAAU,EAAE,IAAI;AAAA,MAClE;AAAA,IACF,CAAC;AACD,SAAK,KAAK;AAAA,MACR,UAAU,EAAE;AAAA,MACZ,OAAO,EAAE;AAAA,MACT,YAAY,EAAE;AAAA,MACd,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAEA,MAAI,OAAO,MAAM;AACf,UAAM,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,sCAAsC;AAC5C,WAAO;AAAA,EACT;AACA,MAAI,WAAW,WAAW,GAAG;AAC3B,UAAM,yEAAyE;AAAA,EACjF;AAEA,aAAW,KAAK,MAAM;AACpB,UAAM,GAAG,EAAE,QAAQ,MAAM,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE;AACpD,QAAI,EAAE,WAAW,WAAW,GAAG;AAC7B,YAAM,4BAA4B;AAAA,IACpC,OAAO;AACL,iBAAW,KAAK,EAAE,YAAY;AAC5B,cAAM,OAAO,EAAE,iBAAiB,EAAE,eAAe,gBAAgB;AACjE,cAAM,SAAS,EAAE,gBAAgB,kBAAa;AAC9C,cAAM,QAAQ,EAAE,eAAe,iBAAY;AAC3C,cAAM,KAAK,IAAI,IAAI,EAAE,EAAE,KAAK,MAAM,KAAK,KAAK,EAAE;AAAA,MAChD;AAAA,IACF;AACA,UAAM,EAAE;AAAA,EACV;AAIA,SAAO;AACT;","names":[]}

package/dist/trae-JSNDZFKL.js.map

@@ -1 +0,0 @@
-{"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  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    // 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  };\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  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const mcpPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    return [\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          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}\n\nexport const adapter = new TraeAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/types-CYUB1OTr.d.ts

@@ -1,427 +0,0 @@
-/**
- * core/types — the shared contract surface for agent-connector.
- *
- * Everything in this file is type-only (no runtime), so it is safe to import
- * from anywhere without creating module cycles. It is the single source of
- * truth that every adapter, the telemetry layer, the CLI, and the public API
- * code against.
- *
- * Grounded in the understand-phase report (docs/research/understand-report.md)
- * and generalized from context-mode's proven 15-platform adapter SPI:
- *   - context-mode hardcoded the served identity ("context-mode"); here the
- *     identity is a parameter the developer supplies via defineConnector().
- *   - context-mode's session/memory/FTS domain logic is removed from the SPI.
- *   - MCP server registration is modeled here (root key + format differ per
- *     platform, so adapters must render it — it is NOT "100% portable").
- */
-/**
- * Stable identifiers for every host platform agent-connector can target.
- *
- * NOTE on usage-only platforms: `"synthetic"` is a TELEMETRY-ONLY id
- * (Octofriend / synthetic.new). It has a usage reader (usage/readers/synthetic)
- * but DELIBERATELY no deploy adapter and no ADAPTER_REGISTRY entry — Octofriend
- * exposes no writable MCP config to install into. The registry-completeness test
- * (tests/adapters/registry-completeness.test.ts) allowlists it for this reason.
- */
-type PlatformId = "claude-code" | "codex" | "cursor" | "vscode-copilot" | "jetbrains-copilot" | "copilot-cli" | "gemini-cli" | "opencode" | "kilo" | "kilo-cli" | "warp" | "hermes" | "openclaw" | "zed" | "antigravity" | "antigravity-cli" | "kiro" | "qwen-code" | "kimi" | "pi" | "omp" | "droid" | "roo-code" | "trae" | "amp" | "codebuff" | "mux" | "crush" | "goose" | "synthetic" | "unknown";
-/**
- * Hook I/O paradigm — the deepest cross-platform divergence (report §4).
- * Canonical shipped sets (keep in sync with src/adapters/registry.ts — this
- * comment once drifted and seeded a docs-wide misclassification):
- *   - "json-stdio" (16): host pipes JSON to a command on stdin, reads
- *     JSON/exit-code back — Claude Code, Codex, Cursor, VS Code/JetBrains
- *     Copilot, Copilot CLI, Gemini CLI, Qwen, Kiro, Kimi, Crush, Goose, Hermes,
- *     Droid (Factory), Antigravity (+ the agy CLI). One universal entrypoint
- *     binary handles all of them.
- *   - "ts-plugin" (4): host loads a JS/TS module exporting lifecycle functions
- *     — OpenCode, Kilo CLI, OMP, OpenClaw. Framework generates the module.
- *   - "mcp-only" (9): no hook layer at all — Warp, Kilo, Roo Code, Trae, Zed,
- *     Amp, Codebuff, Mux, Pi. Only the MCP server (or skills surface) is
- *     installed; hooks are reported unavailable.
- */
-type HookParadigm = "json-stdio" | "ts-plugin" | "mcp-only";
-/**
- * Install scope, normalized across platforms and ordered low→high precedence.
- * Each adapter maps these to a concrete config path and knows which it supports.
- */
-type InstallScope = "system" | "user" | "project" | "profile" | "managed";
-type Transport = "stdio" | "http" | "sse" | "ws";
-interface ToolFilter {
-    /** Glob/exact tool names to expose. Default: ["*"]. */
-    include?: string[];
-    /** Glob/exact tool names to hide. */
-    exclude?: string[];
-}
-interface AuthSpec {
-    type: "oauth" | "bearerEnv" | "none";
-    /** Env var holding the bearer token when type === "bearerEnv". */
-    bearerEnvVar?: string;
-}
-/**
- * A normalized, transport-polymorphic MCP server descriptor. Declared ONCE by
- * the developer; each adapter renders it into that platform's native dialect
- * (root key, field names, format). Adapters that cannot honor a requested
- * transport downgrade-or-skip and report it — they never throw.
- */
-interface ServerDef {
-    transport: Transport;
-    command?: string;
-    args?: string[];
-    /** Env vars passed to the server process. Values support ${env:VAR} interpolation. */
-    env?: Record<string, string>;
-    cwd?: string;
-    url?: string;
-    headers?: Record<string, string>;
-    auth?: AuthSpec;
-    tools?: ToolFilter;
-    timeoutMs?: number;
-    /** Default true. When false, the entry is written disabled where supported. */
-    enabled?: boolean;
-    /**
-     * Wrap the server with `agent-connector serve` so per-tool telemetry is
-     * captured transparently. Default: true for stdio servers when telemetry is
-     * enabled; false for remote servers (cannot intercept) and when explicitly off.
-     */
-    wrapForTelemetry?: boolean;
-}
-/** Canonical, platform-agnostic lifecycle event names. */
-type HookEventName = "SessionStart" | "SessionEnd" | "UserPromptSubmit" | "PreToolUse" | "PostToolUse" | "PreCompact" | "Stop" | "Notification";
-interface BaseEvent {
-    /** Which host produced this event (from runtime detection). */
-    hostPlatform: PlatformId;
-    /** Connector id this event is dispatched to. */
-    connectorId: string;
-    /** Host session id (adapter-extracted; "" when the host provides none). */
-    sessionId: string;
-    /** Project directory if the host exposes one. */
-    projectDir?: string;
-    /** Raw host-specific payload for passthrough/escape-hatch use. */
-    raw: unknown;
-}
-interface PreToolUseEvent extends BaseEvent {
-    toolName: string;
-    toolInput: Record<string, unknown>;
-}
-interface PostToolUseEvent extends BaseEvent {
-    toolName: string;
-    toolInput: Record<string, unknown>;
-    toolOutput?: string;
-    isError?: boolean;
-}
-interface SessionStartEvent extends BaseEvent {
-    source: "startup" | "compact" | "resume" | "clear";
-}
-interface SessionEndEvent extends BaseEvent {
-    reason?: string;
-}
-interface UserPromptSubmitEvent extends BaseEvent {
-    prompt: string;
-}
-interface PreCompactEvent extends BaseEvent {
-    trigger?: "auto" | "manual";
-}
-interface StopEvent extends BaseEvent {
-    /** True when the stop hook itself was triggered during a previous stop hook. */
-    stopHookActive?: boolean;
-}
-interface NotificationEvent extends BaseEvent {
-    message: string;
-}
-/** Map of event name → its normalized payload type. */
-interface EventPayloadMap {
-    SessionStart: SessionStartEvent;
-    SessionEnd: SessionEndEvent;
-    UserPromptSubmit: UserPromptSubmitEvent;
-    PreToolUse: PreToolUseEvent;
-    PostToolUse: PostToolUseEvent;
-    PreCompact: PreCompactEvent;
-    Stop: StopEvent;
-    Notification: NotificationEvent;
-}
-/**
- * Normalized hook response. A handler returns a subset of these; the adapter
- * formats it into the host's native reply (exit codes / JSON / control fields).
- * Adapters drop fields the host cannot honor (e.g. updatedOutput where the host
- * cannot rewrite tool output) and the framework reports the degradation.
- */
-interface HookResponse {
-    /**
-     *  - "allow":   pass through (default when handler returns void)
-     *  - "deny":    block tool execution / stop the action
-     *  - "modify":  replace tool input (PreToolUse) with `updatedInput`
-     *  - "context": inject `additionalContext` as soft guidance
-     *  - "ask":     prompt the user to confirm
-     */
-    decision?: "allow" | "deny" | "modify" | "context" | "ask";
-    /** Shown to the model/user; required in spirit for deny/ask. */
-    reason?: string;
-    /** Replacement tool input — only meaningful with decision "modify". */
-    updatedInput?: Record<string, unknown>;
-    /** Extra context to inject — meaningful with "context" or on SessionStart. */
-    additionalContext?: string;
-    /** Rewritten tool output — only where the host supports it (PostToolUse). */
-    updatedOutput?: string;
-}
-/** A handler bound to one event, optionally filtered by a tool matcher. */
-interface HookDefinition<E extends HookEventName = HookEventName> {
-    /**
-     * Regex string matched against the tool name (tool events only). Empty/omitted
-     * matches all. Rendered into each host's native matcher syntax where supported,
-     * else evaluated by the universal entrypoint at runtime.
-     */
-    matcher?: string;
-    handler(event: EventPayloadMap[E]): HookResponse | void | Promise<HookResponse | void>;
-}
-/** Developer-declared hooks, keyed by canonical event name. */
-interface HooksConfig {
-    SessionStart?: HookDefinition<"SessionStart">;
-    SessionEnd?: HookDefinition<"SessionEnd">;
-    UserPromptSubmit?: HookDefinition<"UserPromptSubmit">;
-    PreToolUse?: HookDefinition<"PreToolUse">;
-    PostToolUse?: HookDefinition<"PostToolUse">;
-    PreCompact?: HookDefinition<"PreCompact">;
-    Stop?: HookDefinition<"Stop">;
-    Notification?: HookDefinition<"Notification">;
-}
-/** What a given host can actually honor. The single-API layer degrades to it. */
-interface PlatformCapabilities {
-    preToolUse: boolean;
-    postToolUse: boolean;
-    preCompact: boolean;
-    sessionStart: boolean;
-    sessionEnd: boolean;
-    userPromptSubmit: boolean;
-    stop: boolean;
-    notification: boolean;
-    /** Can a PreToolUse hook rewrite tool arguments? */
-    canModifyArgs: boolean;
-    /** Can a PostToolUse hook rewrite tool output? */
-    canModifyOutput: boolean;
-    /** Can a hook inject context at session start / compaction? */
-    canInjectSessionContext: boolean;
-    /** MCP transports this host can register. */
-    transports: Transport[];
-    /**
-     * Content-surface support (all OPTIONAL so existing adapter capability
-     * literals compile unchanged; read as `?? false`). Only surface-supporting
-     * adapters set these true. The BaseAdapter install/uninstall defaults
-     * handle the "unsupported" skip/warn regardless of the flag.
-     */
-    supportsCommands?: boolean;
-    supportsSkills?: boolean;
-    supportsSubagents?: boolean;
-}
-/** Tool access expressed once; adapters render to allowed-tools / tools[] / readonly. */
-interface SurfaceToolPolicy {
-    allow?: string[];
-    deny?: string[];
-}
-/** A slash command (= a Skill on 2026 Claude; adapters pick the right surface). */
-interface CommandDef {
-    /** kebab-case; becomes the slash name and the filename stem. Source of truth. */
-    name: string;
-    /** One-line description for /help + model auto-selection. */
-    description?: string;
-    /** Prompt template body (markdown). The portable core of the command. */
-    prompt: string;
-    /** Shown in argument completion, e.g. "[environment]". */
-    argumentHint?: string;
-    tools?: SurfaceToolPolicy;
-    /** Model override (raw id or alias; adapters pass through or drop+warn). */
-    model?: string;
-    /** Force subagent / forked context where the platform supports it. */
-    subtask?: boolean;
-    /** Verbatim per-platform frontmatter additions (escape hatch). */
-    extra?: Record<string, unknown>;
-}
-/** An Agent Skill (folder + SKILL.md, Agent Skills open standard). */
-interface SkillDef {
-    /** <=64 chars, [a-z0-9-]; MUST equal the skill dir name. Source of truth. */
-    name: string;
-    /** <=1024 chars, 3rd-person "what + when"; drives model auto-selection. Required. */
-    description: string;
-    /** SKILL.md markdown body (instructions). */
-    body: string;
-    tools?: SurfaceToolPolicy;
-    model?: string;
-    disableModelInvocation?: boolean;
-    /** Extra files bundled beside SKILL.md, relative path → contents. */
-    resources?: Record<string, string>;
-    extra?: Record<string, unknown>;
-}
-/** A named subagent (system-prompt + tool/model scoping). */
-interface SubagentDef {
-    /** kebab-case identifier. Source of truth (filename stem on most platforms). */
-    name: string;
-    /** Delegation hint shown to the orchestrator. Required. */
-    description: string;
-    /** System prompt = the agent's instructions (markdown body / developer_instructions). */
-    prompt: string;
-    tools?: SurfaceToolPolicy;
-    /** Model: alias|full-id|"inherit". Default left to platform. */
-    model?: string;
-    /** Coarse permission knob → Cursor readonly, opencode/kilo permission map. */
-    readonly?: boolean;
-    extra?: Record<string, unknown>;
-}
-interface TelemetryConfig {
-    /** On by default. Global kill switch also via AGENT_CONNECTOR_TELEMETRY=0. */
-    enabled?: boolean;
-    /** Tokenizer family selection. "auto" infers from client/host. */
-    modelFamilyHint?: "auto" | "openai" | "anthropic" | "generic";
-    /** Tokenize tools/list schemas once → fixed per-turn tool-definition overhead. */
-    measureToolDefs?: boolean;
-    /** Opt-in network calibration (sends content off-box — off by default). */
-    calibration?: {
-        anthropicCountTokens?: boolean;
-    };
-    /**
-     * OPT-IN host-native turn-usage capture (off by default). When enabled, the
-     * Gemini / Antigravity adapters ALSO install an AfterModel / PostInvocation hook
-     * that reads the host's `usageMetadata` and records a DISTINCT `model_turn`
-     * telemetry row (confidence `host-native`). Whole-conversation, never summed with
-     * the per-MCP `call` rows. May also be forced on at install via the env switch
-     * AGENT_CONNECTOR_HOST_NATIVE=1. Aggregate counts only; no raw content stored.
-     */
-    hostNativeUsage?: boolean;
-    /** Storage backend. NDJSON (default) needs no native deps; sqlite is an upgrade. */
-    store?: "ndjson" | "sqlite";
-}
-/** Per-platform override / escape hatch (report §3.2). */
-interface PlatformOverride {
-    /** false → do not install hooks on this platform; object → merge/replace hooks. */
-    hooks?: boolean | Partial<HooksConfig>;
-    /** false → do not register the MCP server here; object → shallow-merge into ServerDef. */
-    server?: Partial<ServerDef> | false;
-    /** Force a specific scope for this platform. */
-    scope?: InstallScope;
-    /** false → skip command files on this platform. */
-    commands?: boolean;
-    /** false → skip skill files on this platform. */
-    skills?: boolean;
-    /** false → skip subagent files on this platform. */
-    subagents?: boolean;
-    /** Verbatim fields merged into the native config (reach platform-exclusive features). */
-    extra?: Record<string, unknown>;
-}
-/**
- * Distribution metadata for the OFFICIAL MCP standard artifacts `package` can
- * emit — the registry `server.json` and the MCPB `.mcpb` bundle. These describe
- * the developer's REAL upstream MCP server (what a registry installer / Claude
- * Desktop runs directly), NOT agent-connector's telemetry `serve` wrapper, so
- * they need inputs the cross-platform install does not: the namespace the dev
- * proved ownership of, their published package name, and bundle author info.
- *
- * All optional — a connector that never publishes to the registry or as a
- * bundle can omit this entirely; the relevant `package --format` raises a clear,
- * actionable error only when its required field is missing.
- */
-interface PublishConfig {
-    /**
-     * Reverse-DNS namespace the developer OWNS, e.g. "io.github.acme" or
-     * "com.acme". server.json `name` is rendered as `${registryNamespace}/${id}`.
-     * agent-connector never mints a namespace on the dev's behalf — the registry
-     * requires proven ownership (the `mcp-publisher login` step the dev runs).
-     */
-    registryNamespace?: string;
-    /**
-     * The developer's REAL published package that runs the MCP server, e.g.
-     * "@acme/acme-db-mcp" — server.json packages[].identifier. Required to emit a
-     * registry npm package entry (we cannot guess the published name).
-     */
-    packageName?: string;
-    /** Package registry base URL. Default https://registry.npmjs.org for npm. */
-    registryBaseUrl?: string;
-    /** Bundle author. The MCPB manifest requires author.name. */
-    author?: {
-        name: string;
-        email?: string;
-        url?: string;
-    };
-}
-/** What a developer passes to defineConnector(). */
-interface ConnectorConfig {
-    /** Stable connector id (kebab-case). Replaces context-mode's hardcoded identity. */
-    id: string;
-    displayName?: string;
-    version?: string;
-    /** The MCP server to deploy. Omit for a hooks-only connector. */
-    server?: ServerDef;
-    /** Lifecycle hooks. Omit for a server-only connector. */
-    hooks?: HooksConfig;
-    /** Telemetry options. Telemetry is ON by default even if this is omitted. */
-    telemetry?: TelemetryConfig;
-    /** Slash commands to deploy as native content files. */
-    commands?: CommandDef[];
-    /** Agent Skills to deploy as native content files. */
-    skills?: SkillDef[];
-    /** Named subagents to deploy as native content files. */
-    subagents?: SubagentDef[];
-    /** Per-platform overrides / escape hatches. */
-    platforms?: Partial<Record<PlatformId, PlatformOverride>>;
-    /** "auto" (all detected) or an explicit allow-list. Default "auto". */
-    targets?: "auto" | PlatformId[];
-    /** Distribution metadata for the registry server.json + MCPB bundle formats. */
-    publish?: PublishConfig;
-}
-/**
- * A validated, normalized connector — what defineConnector() returns and what
- * adapters/CLI consume. All optional config fields are resolved to defaults.
- */
-interface ResolvedConnector {
-    id: string;
-    displayName: string;
-    version: string;
-    server?: ServerDef;
-    hooks: HooksConfig;
-    hookEvents: HookEventName[];
-    telemetry: Required<Omit<TelemetryConfig, "calibration">> & {
-        calibration: {
-            anthropicCountTokens: boolean;
-        };
-    };
-    /** Normalized commands; defaults applied; [] when none. */
-    commands: CommandDef[];
-    /** Normalized skills; defaults applied; [] when none. */
-    skills: SkillDef[];
-    /** Normalized subagents; defaults applied; [] when none. */
-    subagents: SubagentDef[];
-    platforms: Partial<Record<PlatformId, PlatformOverride>>;
-    targets: "auto" | PlatformId[];
-    /** Distribution metadata (registry server.json + MCPB bundle); passed through verbatim. */
-    publish?: PublishConfig;
-}
-/** Result of detecting one platform on this machine. */
-interface DetectedPlatform {
-    id: PlatformId;
-    name: string;
-    installed: boolean;
-    paradigm: HookParadigm;
-    capabilities: PlatformCapabilities;
-    /** Native config path that would be written for `scope`. */
-    configPath: string;
-    scope: InstallScope;
-    reason: string;
-    confidence: "high" | "medium" | "low";
-}
-interface ChangeRecord {
-    platform: PlatformId;
-    action: "create" | "update" | "skip" | "remove" | "warn";
-    /** File touched (when applicable). */
-    path?: string;
-    detail: string;
-}
-interface InstallResult {
-    connectorId: string;
-    dryRun: boolean;
-    changes: ChangeRecord[];
-    warnings: string[];
-}
-interface DiagnosticResult {
-    check: string;
-    status: "pass" | "fail" | "warn";
-    message: string;
-    fix?: string;
-}
-
-export type { AuthSpec as A, ConnectorConfig as C, DetectedPlatform as D, EventPayloadMap as E, HookDefinition as H, InstallResult as I, NotificationEvent as N, PlatformCapabilities as P, ResolvedConnector as R, ServerDef as S, TelemetryConfig as T, UserPromptSubmitEvent as U, ChangeRecord as a, DiagnosticResult as b, HookEventName as c, HookParadigm as d, HookResponse as e, HooksConfig as f, InstallScope as g, PlatformId as h, PlatformOverride as i, PostToolUseEvent as j, PreCompactEvent as k, PreToolUseEvent as l, SessionEndEvent as m, SessionStartEvent as n, StopEvent as o, ToolFilter as p, Transport as q };

package/dist/uninstall-IGCKNOSF.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-import {
-  uninstallConnector
-} from "./chunk-7MSDGHJW.js";
-import {
-  fail,
-  parseScope,
-  parseTargets,
-  print,
-  renderInstallResult
-} from "./chunk-54EMKTTX.js";
-import "./chunk-KHO5WNTP.js";
-import "./chunk-XUCWLJY5.js";
-import {
-  findConnectorConfig,
-  loadConnectorFromPath
-} from "./chunk-LTT56GI3.js";
-import "./chunk-XNAM7F35.js";
-import "./chunk-TRQKHP7D.js";
-
-// src/cli/commands/uninstall.ts
-import { parseArgs } from "util";
-async function resolveConnectorId(explicitId, connectorPath, projectDir) {
-  if (explicitId && explicitId.trim() !== "") return explicitId;
-  const configPath = connectorPath ?? findConnectorConfig(projectDir);
-  if (!configPath) return null;
-  const { connector } = await loadConnectorFromPath(configPath);
-  return connector.id;
-}
-async function run(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    options: {
-      scope: { type: "string", default: "user" },
-      targets: { type: "string" },
-      connector: { type: "string" },
-      "connector-id": { type: "string" },
-      project: { type: "string" },
-      "dry-run": { type: "boolean", default: false },
-      purge: { type: "boolean", default: false }
-    },
-    allowPositionals: false
-  });
-  const projectDir = values.project ?? process.cwd();
-  const scope = parseScope(values.scope);
-  if (scope == null) return fail(`invalid --scope "${values.scope}" (use user|project)`);
-  const connectorId = await resolveConnectorId(
-    values["connector-id"],
-    values.connector,
-    projectDir
-  );
-  if (!connectorId) {
-    return fail(
-      "could not determine connector id. Pass --connector-id <id>, --connector <path>, or run inside a project with an agent-connector config."
-    );
-  }
-  const targets = parseTargets(values.targets);
-  const result = await uninstallConnector({
-    connectorId,
-    scope,
-    projectDir,
-    dryRun: values["dry-run"],
-    purge: values.purge,
-    ...targets ? { targets } : {}
-  });
-  print(renderInstallResult(result, "uninstall"));
-  return result.changes.some((c) => c.action === "warn") ? 1 : 0;
-}
-export {
-  run
-};
-//# sourceMappingURL=uninstall-IGCKNOSF.js.map

package/dist/uninstall-IGCKNOSF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/commands/uninstall.ts"],"sourcesContent":["/**\n * cli/commands/uninstall — strip a connector's MCP + hook registrations.\n *\n * The connector id is taken from --connector-id, or inferred from the local\n * connector config (--connector <path> / findConnectorConfig). The installer's\n * uninstall orchestration loads the registered connector for context and removes\n * its entries from every resolved target.\n *\n * --purge additionally removes the framework-state this connector left behind:\n * its DATA-dir connector record (connectorDir(id)) and, when no connectors\n * remain, the shared home-bin launcher. Without --purge those linger so the\n * connector can be re-synced without re-registering.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { uninstallConnector } from \"../../core/installer.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { fail, parseScope, parseTargets, print, renderInstallResult } from \"../app.js\";\n\n/** Resolve the connector id from flags, then from a local config file. */\nasync function resolveConnectorId(\n  explicitId: string | undefined,\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<string | null> {\n  if (explicitId && explicitId.trim() !== \"\") return explicitId;\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (!configPath) return null;\n  const { connector } = await loadConnectorFromPath(configPath);\n  return connector.id;\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      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      \"connector-id\": { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      purge: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const connectorId = await resolveConnectorId(\n    values[\"connector-id\"],\n    values.connector,\n    projectDir,\n  );\n  if (!connectorId) {\n    return fail(\n      \"could not determine connector id. Pass --connector-id <id>, \" +\n        \"--connector <path>, or run inside a project with an agent-connector config.\",\n    );\n  }\n\n  const targets = parseTargets(values.targets);\n\n  const result = await uninstallConnector({\n    connectorId,\n    scope,\n    projectDir,\n    dryRun: values[\"dry-run\"],\n    purge: values.purge,\n    ...(targets ? { targets } : {}),\n  });\n\n  print(renderInstallResult(result, \"uninstall\"));\n  return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAcA,SAAS,iBAAiB;AAO1B,eAAe,mBACb,YACA,eACA,YACwB;AACxB,MAAI,cAAc,WAAW,KAAK,MAAM,GAAI,QAAO;AACnD,QAAM,aAAa,iBAAiB,oBAAoB,UAAU;AAClE,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,EAAE,UAAU,IAAI,MAAM,sBAAsB,UAAU;AAC5D,SAAO,UAAU;AACnB;AAEA,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,gBAAgB,EAAE,MAAM,SAAS;AAAA,MACjC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,MAC7C,OAAO,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC3C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AAEjD,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AAErF,QAAM,cAAc,MAAM;AAAA,IACxB,OAAO,cAAc;AAAA,IACrB,OAAO;AAAA,IACP;AAAA,EACF;AACA,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,MACL;AAAA,IAEF;AAAA,EACF;AAEA,QAAM,UAAU,aAAa,OAAO,OAAO;AAE3C,QAAM,SAAS,MAAM,mBAAmB;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,OAAO,OAAO;AAAA,IACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC;AAED,QAAM,oBAAoB,QAAQ,WAAW,CAAC;AAC9C,SAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAC/D;","names":[]}

package/dist/upgrade-JV2VK242.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/commands/upgrade.ts"],"sourcesContent":["/**\n * cli/commands/upgrade — bring an agent-connector install current.\n *\n * `upgrade` (aliases: `update`, `sync`) consolidates the two former verbs into\n * ONE the way npm/brew pair `install` + `upgrade`, so there is a single verb to\n * learn for \"make everything current\". It:\n *\n *   1. re-renders the connector's config into every target host idempotently\n *      (identical entries report \"skip\"), exactly like the old `sync` — this is\n *      also the self-heal path: run `upgrade` to repair a drifted install; then\n *   2. refreshes the stable home-bin pointer and prints managed (never-silent)\n *      update guidance for the chosen channel, exactly like the old `update`.\n *\n * When no connector config is resolvable it still does step 2, so `upgrade`\n * works as a pure tool-refresh from anywhere. By design agent-connector NEVER\n * silently auto-updates (docs/ARCHITECTURE.md §3 R1).\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { resolveCliEntry, syncConnector } from \"../../core/installer.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { ensureHomeBin, homeBinPath } from \"../../core/paths.js\";\nimport { fail, parseScope, parseTargets, print, renderInstallResult } from \"../app.js\";\n\ntype Channel = \"stable\" | \"latest\";\n\n/** Heuristic: does the running CLI live under an npm-style node_modules tree? */\nfunction looksNpmManaged(): boolean {\n  const entry = resolveCliEntry().replace(/\\\\/g, \"/\");\n  return entry.includes(\"/node_modules/\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      channel: { type: \"string\", default: \"stable\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const channel = values.channel;\n  if (channel !== \"stable\" && channel !== \"latest\") {\n    return fail(`invalid --channel \"${channel}\" (use stable|latest)`);\n  }\n  const ch: Channel = channel;\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  let hadWarn = false;\n\n  // ── Step 1: re-render the connector into every target host (former `sync`). ──\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    const { connector, modulePath } = await loadConnectorFromPath(configPath);\n    const targets = parseTargets(values.targets);\n    const result = await syncConnector({\n      connector,\n      modulePath,\n      scope,\n      projectDir,\n      dryRun: values[\"dry-run\"],\n      ...(targets ? { targets } : {}),\n    });\n    print(renderInstallResult(result, \"upgrade\"));\n    if (result.changes.some((c) => c.action === \"warn\")) hadWarn = true;\n    print(\"\");\n  } else {\n    print(\"upgrade: no connector config found — refreshing the tool only.\");\n    print(\n      \"(pass --connector <path> or run inside a project to also re-render host config.)\\n\",\n    );\n  }\n\n  // ── Step 2: managed update guidance + home-bin pointer refresh (former `update`). ──\n  print(\"agent-connector uses managed (explicit) updates — never silent\");\n  print(\"auto-update — so one bad release can't break every project at once.\\n\");\n\n  const dist = ch === \"stable\" ? \"latest\" : \"next\";\n  if (looksNpmManaged()) {\n    print(`To update the ${ch} channel, run:`);\n    print(`  npm i -g @ken-jo/agent-connector@${dist}`);\n  } else {\n    print(\n      `This install does not look npm-managed. Update it the way you installed it,`,\n    );\n    print(`then re-run \\`agent-connector upgrade\\` to refresh the home pointer.`);\n    print(`(npm installs would use: npm i -g @ken-jo/agent-connector@${dist})`);\n  }\n\n  // Refresh the stable home-bin pointer so hosts keep execing a working CLI.\n  if (!values[\"dry-run\"]) {\n    try {\n      const binPath = ensureHomeBin(resolveCliEntry());\n      print(`\\nRefreshed home binary pointer: ${binPath}`);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      print(`\\n[warn] could not refresh home binary at ${homeBinPath()}: ${message}`);\n      return 1;\n    }\n  }\n\n  return hadWarn ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,SAAS,iBAAiB;AAU1B,SAAS,kBAA2B;AAClC,QAAM,QAAQ,gBAAgB,EAAE,QAAQ,OAAO,GAAG;AAClD,SAAO,MAAM,SAAS,gBAAgB;AACxC;AAEA,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,SAAS,EAAE,MAAM,UAAU,SAAS,SAAS;AAAA,MAC7C,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC/C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,UAAU,OAAO;AACvB,MAAI,YAAY,YAAY,YAAY,UAAU;AAChD,WAAO,KAAK,sBAAsB,OAAO,uBAAuB;AAAA,EAClE;AACA,QAAM,KAAc;AAEpB,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AAErF,MAAI,UAAU;AAGd,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,aAAa,OAAO,aAAa,oBAAoB,UAAU;AACrE,MAAI,YAAY;AACd,UAAM,EAAE,WAAW,WAAW,IAAI,MAAM,sBAAsB,UAAU;AACxE,UAAM,UAAU,aAAa,OAAO,OAAO;AAC3C,UAAM,SAAS,MAAM,cAAc;AAAA,MACjC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ,OAAO,SAAS;AAAA,MACxB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC/B,CAAC;AACD,UAAM,oBAAoB,QAAQ,SAAS,CAAC;AAC5C,QAAI,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,EAAG,WAAU;AAC/D,UAAM,EAAE;AAAA,EACV,OAAO;AACL,UAAM,qEAAgE;AACtE;AAAA,MACE;AAAA,IACF;AAAA,EACF;AAGA,QAAM,qEAAgE;AACtE,QAAM,4EAAuE;AAE7E,QAAM,OAAO,OAAO,WAAW,WAAW;AAC1C,MAAI,gBAAgB,GAAG;AACrB,UAAM,iBAAiB,EAAE,gBAAgB;AACzC,UAAM,sCAAsC,IAAI,EAAE;AAAA,EACpD,OAAO;AACL;AAAA,MACE;AAAA,IACF;AACA,UAAM,sEAAsE;AAC5E,UAAM,6DAA6D,IAAI,GAAG;AAAA,EAC5E;AAGA,MAAI,CAAC,OAAO,SAAS,GAAG;AACtB,QAAI;AACF,YAAM,UAAU,cAAc,gBAAgB,CAAC;AAC/C,YAAM;AAAA,iCAAoC,OAAO,EAAE;AAAA,IACrD,SAAS,KAAK;AACZ,YAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,YAAM;AAAA,0CAA6C,YAAY,CAAC,KAAK,OAAO,EAAE;AAC9E,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO,UAAU,IAAI;AACvB;","names":[]}