@ken-jo/agent-connector 0.3.1 → 0.4.1

package/dist/windsurf-FU5G4SHF.js

@@ -0,0 +1,443 @@
+#!/usr/bin/env node
+import {
+  resolveEnvRefsDeep
+} from "./chunk-DBQMX75U.js";
+import {
+  BaseAdapter
+} from "./chunk-CPLK7GTE.js";
+import {
+  renderCommandMd,
+  renderSkillMd
+} from "./chunk-7L6ITC4T.js";
+import {
+  buildServeWrapperCommand,
+  shouldWrapForTelemetry
+} from "./chunk-I5MLE6S7.js";
+import "./chunk-N6HH7K6P.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/adapters/windsurf/index.ts
+import { existsSync, statSync } from "fs";
+import { homedir } from "os";
+import { basename, join } from "path";
+var HOST = "windsurf";
+var MCP_ROOT_KEY = "mcpServers";
+var WORKFLOW_MAX_CHARS = 12e3;
+var WindsurfAdapter = class extends BaseAdapter {
+  id = HOST;
+  name = "Windsurf";
+  paradigm = "mcp-only";
+  capabilities = {
+    // Memory surface: WIRED. Windsurf reads `.windsurf/rules/*.md` (NOT
+    // AGENTS.md), so the AGENTS.md-first BaseAdapter default does not apply — the
+    // installMemory/uninstallMemory overrides below write a DEDICATED
+    // agent-connector-owned file (<projectDir>/.windsurf/rules/agent-connector.md)
+    // that LEADS with `trigger: always_on` frontmatter (full content in the
+    // system prompt on every message). Workspace/project scope only; user scope
+    // skip-warns (global_rules.md is a shared global file, not an AC-owned dir).
+    supportsMemory: true,
+    //
+    // mcp-only: Windsurf is a GUI editor with no user-installable hook/plugin
+    // layer. Every hook flag is false.
+    preToolUse: false,
+    postToolUse: false,
+    preCompact: false,
+    sessionStart: false,
+    sessionEnd: false,
+    userPromptSubmit: false,
+    stop: false,
+    notification: false,
+    // No hook layer → no arg/output rewrite, no context injection.
+    canModifyArgs: false,
+    canModifyOutput: false,
+    canInjectSessionContext: false,
+    // Windsurf registers stdio + remote (http/sse) MCP servers; the remote
+    // entry is distinguished by `serverUrl` (vs stdio's `command`).
+    transports: ["stdio", "http", "sse"],
+    // Content surfaces: WIRED in BOTH scopes. Windsurf reads user-authored
+    // WORKFLOWS (each becomes a `/<name>` slash command) and Agent SKILLS (the
+    // same SKILL.md frontmatter convention cline/claude-code/qwen-code use):
+    //   workflows → project .windsurf/workflows/<name>.md,
+    //               user ~/.codeium/windsurf/global_workflows/<name>.md
+    //   skills    → project .windsurf/skills/<name>/SKILL.md,
+    //               user ~/.codeium/windsurf/skills/<name>/SKILL.md
+    // The install overrides below branch the path on ctx.scope and write at both.
+    // Subagents stay UNSET (no documented user-authored dir): base skip-warns.
+    supportsCommands: true,
+    supportsSkills: true
+  };
+  // ── Detection ────────────────────────────────────────────────────────────
+  detectInstalled(_projectDir) {
+    const userDir = join(homedir(), ".codeium", "windsurf");
+    const userMcp = join(userDir, "mcp_config.json");
+    const installed = existsSync(userDir) || existsSync(userMcp);
+    return {
+      id: this.id,
+      name: this.name,
+      installed,
+      paradigm: this.paradigm,
+      capabilities: this.capabilities,
+      configPath: userMcp,
+      scope: "user",
+      reason: installed ? `found Windsurf config under ${userDir}` : `no Windsurf config at ${userDir}`,
+      confidence: installed ? "high" : "low"
+    };
+  }
+  // ── Native paths ─────────────────────────────────────────────────────────
+  /**
+   * Windsurf's MCP config is USER/GLOBAL scope only — the docs specify no
+   * project/workspace path. getConfigDir always resolves the user dir
+   * (homedir() covers USERPROFILE on Windows); a project-scope install is
+   * handled by installServer returning a skip, never a write under projectDir.
+   */
+  getConfigDir(_ctx) {
+    return join(homedir(), ".codeium", "windsurf");
+  }
+  getServerConfigPath(ctx) {
+    return join(this.getConfigDir(ctx), "mcp_config.json");
+  }
+  /**
+   * Windsurf has no separate hook file — hook config path aliases the MCP file
+   * so the generic doctor/backup helpers behave sensibly (amazon-q idiom).
+   */
+  getHookConfigPath(ctx) {
+    return this.getServerConfigPath(ctx);
+  }
+  // ── Memory surface: the `.windsurf/rules` content tree ────────────────────
+  // A DEDICATED agent-connector-owned file that MUST LEAD with `trigger:
+  // always_on` frontmatter (full content in the system prompt on every message).
+  // Because of that leading frontmatter we do NOT use the base managed-block
+  // engine — we own the whole file via the content-file writers: install
+  // writes/updates it idempotently, uninstall deletes it. WORKSPACE/PROJECT scope
+  // only (global_rules.md is a shared global file, not an AC-owned dir).
+  /** <projectDir>/.windsurf/rules/agent-connector.md — the dedicated owned file. */
+  memoryFilePath(ctx) {
+    return join(ctx.projectDir, ".windsurf", "rules", "agent-connector.md");
+  }
+  /** True when `<projectDir>/.windsurf/rules` exists and is a regular FILE. */
+  rulesDirIsFile(ctx) {
+    const p = join(ctx.projectDir, ".windsurf", "rules");
+    if (!existsSync(p)) return false;
+    try {
+      return statSync(p).isFile();
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Compose the dedicated rule file: `trigger: always_on` frontmatter (the
+   * always-on activation directive) + every declared memory entry's content,
+   * joined with a blank line. The connector's content is host-agnostic markdown
+   * (MemoryDef forbids its own frontmatter), so the directive is ours to add.
+   */
+  renderMemoryFile(ctx) {
+    const body = (ctx.connector.memory ?? []).map((m) => m.content.trim()).filter((c) => c.length > 0).join("\n\n");
+    return this.renderFrontmatterMd({ trigger: "always_on" }, body);
+  }
+  installMemory(ctx) {
+    const { connector } = ctx;
+    const entries = connector.memory ?? [];
+    if (connector.platforms[this.id]?.memory === false) {
+      return [{ platform: this.id, action: "skip", detail: `memory disabled for ${this.id}` }];
+    }
+    if (entries.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no memory" }];
+    }
+    if (ctx.scope !== "project") {
+      return [
+        {
+          platform: this.id,
+          action: "warn",
+          detail: `no ${ctx.scope}-scope rules dir verified for windsurf (.windsurf/rules is workspace-scope; global_rules.md is a shared file); ${entries.length} skipped`
+        }
+      ];
+    }
+    if (this.rulesDirIsFile(ctx)) {
+      return [
+        {
+          platform: this.id,
+          action: "warn",
+          path: join(ctx.projectDir, ".windsurf", "rules"),
+          detail: "existing .windsurf/rules is a file, not a directory; left untouched \u2014 convert it to a .windsurf/rules/ directory to receive agent-connector memory"
+        }
+      ];
+    }
+    return [this.writeContentFile(this.memoryFilePath(ctx), this.renderMemoryFile(ctx), ctx.dryRun)];
+  }
+  uninstallMemory(ctx) {
+    if (ctx.scope !== "project" || this.rulesDirIsFile(ctx)) {
+      const path = this.memoryFilePath(ctx);
+      return [
+        { platform: this.id, action: "skip", path, detail: `${basename(path)} absent` }
+      ];
+    }
+    return [this.removeContentFile(this.memoryFilePath(ctx), ctx.dryRun)];
+  }
+  // ── Content surfaces: commands (workflows) + skills ───────────────────────
+  // CONTENT-ONLY native-file writers, structured like installMemory: dedicated-
+  // file ownership, dryRun honored via writeContentFile/removeContentFile. Both
+  // reuse the shared claude-code renderers (renderCommandMd / renderSkillMd) — no
+  // new markdown serializer. BOTH scopes write (the project dir AND the
+  // ~/.codeium/windsurf user/global dirs are documented surfaces):
+  //
+  //   commands (workflows)
+  //     - project → <projectDir>/.windsurf/workflows/<name>.md
+  //     - user    → ~/.codeium/windsurf/global_workflows/<name>.md
+  //       (NOTE: the user dir is `global_workflows`, NOT `workflows`.)
+  //   skills
+  //     - project → <projectDir>/.windsurf/skills/<name>/SKILL.md
+  //     - user    → ~/.codeium/windsurf/skills/<name>/SKILL.md
+  //       (the dir is `skills` in BOTH scopes; same SKILL.md convention
+  //       cline/claude-code/qwen-code use.)
+  //
+  // renderCommandMd emits Claude-flavored frontmatter keys (argument-hint, model,
+  // allowed-tools); Windsurf ignores unknown frontmatter keys, so they are inert/
+  // tolerated — no Windsurf-specific renderer is needed.
+  /** Workflow file: project `.windsurf/workflows`, user `~/.codeium/windsurf/global_workflows`. */
+  commandPath(ctx, name) {
+    const dir = ctx.scope === "project" ? join(ctx.projectDir, ".windsurf", "workflows") : join(homedir(), ".codeium", "windsurf", "global_workflows");
+    return join(dir, `${name}.md`);
+  }
+  /** Skill dir: project `.windsurf/skills/<name>`, user `~/.codeium/windsurf/skills/<name>`. */
+  skillDir(ctx, name) {
+    const base = ctx.scope === "project" ? join(ctx.projectDir, ".windsurf", "skills") : join(homedir(), ".codeium", "windsurf", "skills");
+    return join(base, name);
+  }
+  // ── Commands (workflows) ──────────────────────────────────────────────────
+  installCommands(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.commands === false) {
+      return [{ platform: this.id, action: "skip", detail: "commands disabled for windsurf" }];
+    }
+    if (connector.commands.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no commands" }];
+    }
+    const changes = [];
+    for (const cmd of connector.commands) {
+      const rendered = renderCommandMd(cmd);
+      changes.push(this.writeContentFile(this.commandPath(ctx, cmd.name), rendered, ctx.dryRun));
+      if (rendered.length > WORKFLOW_MAX_CHARS) {
+        changes.push({
+          platform: this.id,
+          action: "warn",
+          path: this.commandPath(ctx, cmd.name),
+          detail: `workflow "${cmd.name}" is ${rendered.length} chars (Windsurf caps each workflow at ${WORKFLOW_MAX_CHARS}); the host may reject or truncate it \u2014 trim the command`
+        });
+      }
+    }
+    return changes;
+  }
+  uninstallCommands(ctx) {
+    const { connector } = ctx;
+    if (connector.commands.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no commands" }];
+    }
+    return connector.commands.map(
+      (cmd) => this.removeContentFile(this.commandPath(ctx, cmd.name), ctx.dryRun)
+    );
+  }
+  // ── Skills ────────────────────────────────────────────────────────────────
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for windsurf" }];
+    }
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(
+        this.writeContentFile(join(dir, "SKILL.md"), renderSkillMd(skill), ctx.dryRun)
+      );
+      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `skill resource "${rel}" escapes the skill dir; skipped`
+          });
+          continue;
+        }
+        changes.push(this.writeContentFile(target, contents, ctx.dryRun));
+      }
+    }
+    return changes;
+  }
+  uninstallSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(this.removeContentFile(join(dir, "SKILL.md"), ctx.dryRun));
+      for (const rel of Object.keys(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) continue;
+        changes.push(this.removeContentFile(target, ctx.dryRun));
+      }
+      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));
+    }
+    return changes;
+  }
+  // ── MCP server install / uninstall ───────────────────────────────────────
+  installServer(ctx) {
+    const { connector } = ctx;
+    const override = connector.platforms[HOST]?.server;
+    if (!connector.server || override === false) {
+      return [
+        {
+          platform: this.id,
+          action: "skip",
+          detail: connector.server ? "server registration disabled for windsurf" : "connector declares no MCP server"
+        }
+      ];
+    }
+    if (ctx.scope === "project") {
+      return [
+        {
+          platform: this.id,
+          action: "skip",
+          detail: "Windsurf has no project-level MCP config (user scope only); re-run with --scope user"
+        }
+      ];
+    }
+    const server = override && typeof override === "object" ? { ...connector.server, ...override } : connector.server;
+    const serverPath = this.getServerConfigPath(ctx);
+    const malformed = this.malformedRootKey(serverPath);
+    if (malformed) return [malformed];
+    const entry = this.renderServerEntry(ctx, server);
+    return [
+      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun)
+    ];
+  }
+  uninstallServer(ctx) {
+    const serverPath = this.getServerConfigPath(ctx);
+    const malformed = this.malformedRootKey(serverPath);
+    if (malformed) return [malformed];
+    return [
+      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun)
+    ];
+  }
+  /**
+   * Guard for a PRESENT-but-non-object `mcpServers` root key: returns a
+   * skip-warn ChangeRecord when the existing config parses but its `mcpServers`
+   * value is not a plain object (an array / string / number / null). Returns
+   * undefined when the file is absent, unparseable (the base upsert's own
+   * overwrite guard handles that), or `mcpServers` is absent / a plain object.
+   */
+  malformedRootKey(configPath) {
+    const cfg = this.readJson(configPath);
+    if (!cfg || !(MCP_ROOT_KEY in cfg)) return void 0;
+    const root = cfg[MCP_ROOT_KEY];
+    if (root !== null && typeof root === "object" && !Array.isArray(root)) {
+      return void 0;
+    }
+    return {
+      platform: this.id,
+      action: "warn",
+      path: configPath,
+      detail: `existing ${MCP_ROOT_KEY} in ${configPath} is not an object map; left untouched (back it up / fix it, then re-run)`
+    };
+  }
+  /** Render a normalized ServerDef into Windsurf's native mcpServers entry. */
+  renderServerEntry(ctx, server) {
+    const transport = server.transport;
+    if (transport === "stdio") {
+      let command = server.command ?? "";
+      let args = [...server.args ?? []];
+      if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {
+        const wrapped = buildServeWrapperCommand(
+          ctx.homeBinPath,
+          ctx.connector.id,
+          command,
+          args,
+          ctx.scope,
+          this.id
+        );
+        command = wrapped.command;
+        args = wrapped.args;
+      }
+      const entry2 = {
+        command: resolveEnvRefsDeep(command)
+      };
+      if (args.length > 0) entry2.args = resolveEnvRefsDeep(args);
+      const env = this.renderEnv(server.env);
+      if (env) entry2.env = env;
+      return entry2;
+    }
+    const entry = {
+      serverUrl: resolveEnvRefsDeep(server.url ?? "")
+    };
+    const headers = this.renderEnv(server.headers);
+    if (headers) entry.headers = headers;
+    return entry;
+  }
+  /**
+   * Render env/header values. Windsurf has a native ${env:VAR} token, but AC
+   * resolves references to literals at install time (the safe path).
+   */
+  renderEnv(env) {
+    if (!env || Object.keys(env).length === 0) return void 0;
+    return resolveEnvRefsDeep({ ...env });
+  }
+  // ── Hooks (unavailable — Windsurf is mcp-only) ────────────────────────────
+  installHooks(_ctx) {
+    return [
+      {
+        platform: this.id,
+        action: "skip",
+        detail: "hooks unavailable (Windsurf is mcp-only)"
+      }
+    ];
+  }
+  uninstallHooks(_ctx) {
+    return [
+      {
+        platform: this.id,
+        action: "skip",
+        detail: "hooks unavailable (Windsurf is mcp-only)"
+      }
+    ];
+  }
+  // ── Diagnostics ──────────────────────────────────────────────────────────
+  getHealthChecks(ctx) {
+    const mcpPath = this.getServerConfigPath(ctx);
+    const connectorId = ctx.connector.id;
+    return [
+      {
+        name: `${this.name}: mcp_config.json present`,
+        check: () => existsSync(mcpPath) ? { status: "OK", detail: mcpPath } : { status: "FAIL", detail: `not found: ${mcpPath}` }
+      },
+      {
+        name: `${this.name}: server entry registered`,
+        check: () => {
+          if (!ctx.connector.server) {
+            return { status: "OK", detail: "no MCP server declared" };
+          }
+          const cfg = this.readJson(mcpPath);
+          const bucket = cfg?.[MCP_ROOT_KEY];
+          if (!cfg || !bucket) {
+            return { status: "FAIL", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };
+          }
+          return connectorId in bucket ? { status: "OK", detail: `${MCP_ROOT_KEY}.${connectorId} present` } : {
+            status: "FAIL",
+            detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`
+          };
+        }
+      }
+    ];
+  }
+};
+var adapter = new WindsurfAdapter();
+var windsurf_default = adapter;
+export {
+  WindsurfAdapter,
+  adapter,
+  windsurf_default as default
+};
+//# sourceMappingURL=windsurf-FU5G4SHF.js.map

package/dist/windsurf-FU5G4SHF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/windsurf/index.ts"],"sourcesContent":["/**\n * adapters/windsurf — Windsurf (Codeium / Cognition's Cascade agent) adapter.\n *\n * Windsurf is an mcp-only host from agent-connector's perspective: there is no\n * user-installable hook/plugin layer (it is a GUI editor). AC registers the MCP\n * server PLUS three content surfaces (memory, workflows, skills — see below). The\n * MCP config is a Claude-Desktop-style OBJECT map keyed by server name (exactly\n * like the cursor adapter's `mcpServers`), NOT an array.\n *\n * MCP config (primary-verified — docs.devin.ai/desktop/cascade/mcp, formerly\n * docs.windsurf.com):\n *   - user/global scope ONLY → ~/.codeium/windsurf/mcp_config.json\n *     (Windows %USERPROFILE%\\.codeium\\windsurf\\mcp_config.json — homedir()\n *     covers it). The docs specify NO project/workspace config path, so a\n *     project-scope install returns a skip ChangeRecord.\n *   - root key \"mcpServers\" — a JSON object/map keyed by server name.\n *\n * Server entry shapes (primary-verified):\n *   - stdio:  { command, args?, env? }\n *   - remote: { serverUrl, headers? } — the docs use `serverUrl` (an `url`\n *     alias is mentioned but `serverUrl` is the documented primary). There is\n *     NO `type` discriminator and NO `disabled` field — stdio vs remote is\n *     distinguished by `command` vs `serverUrl`. `headers` is emitted only when\n *     the connector's remote server provides them.\n *\n * Native interpolation: Windsurf supports `${env:VAR}` / `${file:/path}`\n * tokens, but AC does not need to emit those — values are resolved to literals\n * at install time (the safe path, same as droid/crush/amazon-q).\n *\n * Memory / rules (primary-verified — docs.windsurf.com/windsurf/cascade/rules,\n * llms-full.txt): a `.windsurf/rules/` workspace directory holds `.md` rule\n * files, each declaring an activation mode \"in its frontmatter via the `trigger`\n * field\". `trigger: always_on` means \"full rule content is included in the\n * system prompt on every message\" (the docs' literal Activation-Modes table).\n * AC owns a DEDICATED file there (`.windsurf/rules/agent-connector.md`) that MUST\n * LEAD with that always-on frontmatter, so — like the continue adapter and unlike\n * the cline/amazon-q managed-block targets — we write the WHOLE file\n * (frontmatter + body) via the content-file writers and own it end-to-end\n * (install creates, uninstall deletes). The connector's memory `content` is\n * host-agnostic (MemoryDef forbids its own frontmatter), so the always-on\n * directive is an adapter-level wrapper. WORKSPACE/PROJECT SCOPE: `global_rules.md`\n * is a single SHARED global file (not an AC-owned dir), so user scope skip-warns.\n *\n * Content surfaces — workflows (slash commands) + skills, BOTH project AND user\n * scope:\n *   - workflows → project `<projectDir>/.windsurf/workflows/<name>.md`,\n *     user `~/.codeium/windsurf/global_workflows/<name>.md` (the user dir is\n *     `global_workflows`, NOT `workflows`). Each becomes a `/<name>` slash\n *     command. Windsurf caps each workflow file at 12,000 chars — over-budget\n *     files are still written but warned.\n *   - skills → project `<projectDir>/.windsurf/skills/<name>/SKILL.md`,\n *     user `~/.codeium/windsurf/skills/<name>/SKILL.md` (the dir is `skills` in\n *     BOTH scopes). Same SKILL.md convention cline/claude-code/qwen-code use.\n * Both reuse the shared claude-code renderers (renderCommandMd/renderSkillMd).\n *\n * Hook \"config path\" is aliased to the MCP file (no separate hook file) so the\n * base doctor/backup helpers behave sensibly (the amazon-q / roo-code idiom).\n */\n\nimport { existsSync, statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { basename, join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport { renderCommandMd, renderSkillMd } from \"../claude-code/render.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  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"windsurf\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/**\n * Windsurf caps each workflow (slash-command) file at 12,000 characters\n * (docs.windsurf.com). We still write an over-budget file but emit a warn so the\n * author can trim it, mirroring base.ts's memory soft-budget warn. Skills have no\n * documented size cap, so they are not guarded.\n */\nconst WORKFLOW_MAX_CHARS = 12000;\n\n/**\n * Native MCP server entry shapes Windsurf accepts under `mcpServers` (an OBJECT\n * map keyed by server name, Claude-Desktop-style):\n *   - stdio:  { command, args?, env? } — transport inferred from `command`.\n *   - remote: { serverUrl, headers? } — `serverUrl` (NOT `url`); NO `type`\n *     discriminator and NO `disabled` flag. `headers` only when provided.\n */\ninterface WindsurfStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\ninterface WindsurfRemoteServer {\n  serverUrl: string;\n  headers?: Record<string, string>;\n}\n\nexport class WindsurfAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Windsurf\";\n  readonly paradigm: HookParadigm = \"mcp-only\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: WIRED. Windsurf reads `.windsurf/rules/*.md` (NOT\n    // AGENTS.md), so the AGENTS.md-first BaseAdapter default does not apply — the\n    // installMemory/uninstallMemory overrides below write a DEDICATED\n    // agent-connector-owned file (<projectDir>/.windsurf/rules/agent-connector.md)\n    // that LEADS with `trigger: always_on` frontmatter (full content in the\n    // system prompt on every message). Workspace/project scope only; user scope\n    // skip-warns (global_rules.md is a shared global file, not an AC-owned dir).\n    supportsMemory: true,\n    //\n    // mcp-only: Windsurf is a GUI editor with no user-installable hook/plugin\n    // layer. Every hook flag 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    // No hook layer → no arg/output rewrite, no context injection.\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    // Windsurf registers stdio + remote (http/sse) MCP servers; the remote\n    // entry is distinguished by `serverUrl` (vs stdio's `command`).\n    transports: [\"stdio\", \"http\", \"sse\"],\n    // Content surfaces: WIRED in BOTH scopes. Windsurf reads user-authored\n    // WORKFLOWS (each becomes a `/<name>` slash command) and Agent SKILLS (the\n    // same SKILL.md frontmatter convention cline/claude-code/qwen-code use):\n    //   workflows → project .windsurf/workflows/<name>.md,\n    //               user ~/.codeium/windsurf/global_workflows/<name>.md\n    //   skills    → project .windsurf/skills/<name>/SKILL.md,\n    //               user ~/.codeium/windsurf/skills/<name>/SKILL.md\n    // The install overrides below branch the path on ctx.scope and write at both.\n    // Subagents stay UNSET (no documented user-authored dir): base skip-warns.\n    supportsCommands: true,\n    supportsSkills: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(_projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".codeium\", \"windsurf\");\n    const userMcp = join(userDir, \"mcp_config.json\");\n    const installed = existsSync(userDir) || existsSync(userMcp);\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath: userMcp,\n      scope: \"user\",\n      reason: installed\n        ? `found Windsurf config under ${userDir}`\n        : `no Windsurf config at ${userDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  /**\n   * Windsurf's MCP config is USER/GLOBAL scope only — the docs specify no\n   * project/workspace path. getConfigDir always resolves the user dir\n   * (homedir() covers USERPROFILE on Windows); a project-scope install is\n   * handled by installServer returning a skip, never a write under projectDir.\n   */\n  getConfigDir(_ctx: InstallContext): string {\n    return join(homedir(), \".codeium\", \"windsurf\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp_config.json\");\n  }\n\n  /**\n   * Windsurf has no separate hook file — hook config path aliases the MCP file\n   * so the generic doctor/backup helpers behave sensibly (amazon-q idiom).\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  // ── Memory surface: the `.windsurf/rules` content tree ────────────────────\n  // A DEDICATED agent-connector-owned file that MUST LEAD with `trigger:\n  // always_on` frontmatter (full content in the system prompt on every message).\n  // Because of that leading frontmatter we do NOT use the base managed-block\n  // engine — we own the whole file via the content-file writers: install\n  // writes/updates it idempotently, uninstall deletes it. WORKSPACE/PROJECT scope\n  // only (global_rules.md is a shared global file, not an AC-owned dir).\n\n  /** <projectDir>/.windsurf/rules/agent-connector.md — the dedicated owned file. */\n  private memoryFilePath(ctx: InstallContext): string {\n    return join(ctx.projectDir, \".windsurf\", \"rules\", \"agent-connector.md\");\n  }\n\n  /** True when `<projectDir>/.windsurf/rules` exists and is a regular FILE. */\n  private rulesDirIsFile(ctx: InstallContext): boolean {\n    const p = join(ctx.projectDir, \".windsurf\", \"rules\");\n    if (!existsSync(p)) return false;\n    try {\n      return statSync(p).isFile();\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Compose the dedicated rule file: `trigger: always_on` frontmatter (the\n   * always-on activation directive) + every declared memory entry's content,\n   * joined with a blank line. The connector's content is host-agnostic markdown\n   * (MemoryDef forbids its own frontmatter), so the directive is ours to add.\n   */\n  private renderMemoryFile(ctx: InstallContext): string {\n    const body = (ctx.connector.memory ?? [])\n      .map((m) => m.content.trim())\n      .filter((c) => c.length > 0)\n      .join(\"\\n\\n\");\n    return this.renderFrontmatterMd({ trigger: \"always_on\" }, body);\n  }\n\n  override installMemory(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const entries = connector.memory ?? [];\n    if (connector.platforms[this.id]?.memory === false) {\n      return [{ platform: this.id, action: \"skip\", detail: `memory disabled for ${this.id}` }];\n    }\n    if (entries.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no memory\" }];\n    }\n    // Windsurf's verified per-rule `.windsurf/rules` dir is WORKSPACE scope only.\n    if (ctx.scope !== \"project\") {\n      return [\n        {\n          platform: this.id,\n          action: \"warn\",\n          detail:\n            `no ${ctx.scope}-scope rules dir verified for windsurf ` +\n            `(.windsurf/rules is workspace-scope; global_rules.md is a shared file); ` +\n            `${entries.length} skipped`,\n        },\n      ];\n    }\n    // Rules-path collision: never write under a `.windsurf/rules` that is a FILE.\n    if (this.rulesDirIsFile(ctx)) {\n      return [\n        {\n          platform: this.id,\n          action: \"warn\",\n          path: join(ctx.projectDir, \".windsurf\", \"rules\"),\n          detail:\n            \"existing .windsurf/rules is a file, not a directory; left untouched — \" +\n            \"convert it to a .windsurf/rules/ directory to receive agent-connector memory\",\n        },\n      ];\n    }\n    return [this.writeContentFile(this.memoryFilePath(ctx), this.renderMemoryFile(ctx), ctx.dryRun)];\n  }\n\n  override uninstallMemory(ctx: InstallContext): ChangeRecord[] {\n    // Only the project-scope dedicated file was ever written; a `.windsurf/rules`\n    // that is a FILE was never ours (installMemory warned), so leave it.\n    if (ctx.scope !== \"project\" || this.rulesDirIsFile(ctx)) {\n      const path = this.memoryFilePath(ctx);\n      return [\n        { platform: this.id, action: \"skip\", path, detail: `${basename(path)} absent` },\n      ];\n    }\n    return [this.removeContentFile(this.memoryFilePath(ctx), ctx.dryRun)];\n  }\n\n  // ── Content surfaces: commands (workflows) + skills ───────────────────────\n  // CONTENT-ONLY native-file writers, structured like installMemory: dedicated-\n  // file ownership, dryRun honored via writeContentFile/removeContentFile. Both\n  // reuse the shared claude-code renderers (renderCommandMd / renderSkillMd) — no\n  // new markdown serializer. BOTH scopes write (the project dir AND the\n  // ~/.codeium/windsurf user/global dirs are documented surfaces):\n  //\n  //   commands (workflows)\n  //     - project → <projectDir>/.windsurf/workflows/<name>.md\n  //     - user    → ~/.codeium/windsurf/global_workflows/<name>.md\n  //       (NOTE: the user dir is `global_workflows`, NOT `workflows`.)\n  //   skills\n  //     - project → <projectDir>/.windsurf/skills/<name>/SKILL.md\n  //     - user    → ~/.codeium/windsurf/skills/<name>/SKILL.md\n  //       (the dir is `skills` in BOTH scopes; same SKILL.md convention\n  //       cline/claude-code/qwen-code use.)\n  //\n  // renderCommandMd emits Claude-flavored frontmatter keys (argument-hint, model,\n  // allowed-tools); Windsurf ignores unknown frontmatter keys, so they are inert/\n  // tolerated — no Windsurf-specific renderer is needed.\n\n  /** Workflow file: project `.windsurf/workflows`, user `~/.codeium/windsurf/global_workflows`. */\n  private commandPath(ctx: InstallContext, name: string): string {\n    const dir =\n      ctx.scope === \"project\"\n        ? join(ctx.projectDir, \".windsurf\", \"workflows\")\n        : join(homedir(), \".codeium\", \"windsurf\", \"global_workflows\");\n    return join(dir, `${name}.md`);\n  }\n\n  /** Skill dir: project `.windsurf/skills/<name>`, user `~/.codeium/windsurf/skills/<name>`. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    const base =\n      ctx.scope === \"project\"\n        ? join(ctx.projectDir, \".windsurf\", \"skills\")\n        : join(homedir(), \".codeium\", \"windsurf\", \"skills\");\n    return join(base, name);\n  }\n\n  // ── Commands (workflows) ──────────────────────────────────────────────────\n\n  override installCommands(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.commands === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"commands disabled for windsurf\" }];\n    }\n    if (connector.commands.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no commands\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const cmd of connector.commands) {\n      const rendered = renderCommandMd(cmd);\n      changes.push(this.writeContentFile(this.commandPath(ctx, cmd.name), rendered, ctx.dryRun));\n      // Windsurf caps each workflow file at 12,000 characters (docs.windsurf.com).\n      // Still write the file — warn so the author can trim it (Windsurf may reject\n      // or truncate the overflow), mirroring base.ts's memory soft-budget warn.\n      if (rendered.length > WORKFLOW_MAX_CHARS) {\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          path: this.commandPath(ctx, cmd.name),\n          detail:\n            `workflow \"${cmd.name}\" is ${rendered.length} chars ` +\n            `(Windsurf caps each workflow at ${WORKFLOW_MAX_CHARS}); ` +\n            `the host may reject or truncate it — trim the command`,\n        });\n      }\n    }\n    return changes;\n  }\n\n  override uninstallCommands(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.commands.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no commands\" }];\n    }\n    return connector.commands.map((cmd) =>\n      this.removeContentFile(this.commandPath(ctx, cmd.name), ctx.dryRun),\n    );\n  }\n\n  // ── Skills ────────────────────────────────────────────────────────────────\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for windsurf\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), renderSkillMd(skill), ctx.dryRun),\n      );\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue;\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\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 windsurf\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Windsurf has no project-level MCP config (user scope only — the docs\n    // document only ~/.codeium/windsurf/mcp_config.json). A project-scope\n    // install is reported as a skip rather than written into the project tree.\n    if (ctx.scope === \"project\") {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail:\n            \"Windsurf has no project-level MCP config (user scope only); \" +\n            \"re-run with --scope user\",\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\n    // NEVER clobber a malformed `mcpServers`. The base upsert tolerates a\n    // missing file / missing key (it creates the object), but a PRESENT-but-\n    // non-object `mcpServers` (e.g. an array or string from a hand-edit) would\n    // get a named property bolted on and silently corrupted — so skip-and-warn.\n    const malformed = this.malformedRootKey(serverPath);\n    if (malformed) return [malformed];\n\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    const malformed = this.malformedRootKey(serverPath);\n    if (malformed) return [malformed];\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /**\n   * Guard for a PRESENT-but-non-object `mcpServers` root key: returns a\n   * skip-warn ChangeRecord when the existing config parses but its `mcpServers`\n   * value is not a plain object (an array / string / number / null). Returns\n   * undefined when the file is absent, unparseable (the base upsert's own\n   * overwrite guard handles that), or `mcpServers` is absent / a plain object.\n   */\n  private malformedRootKey(configPath: string): ChangeRecord | undefined {\n    const cfg = this.readJson<Record<string, unknown>>(configPath);\n    if (!cfg || !(MCP_ROOT_KEY in cfg)) return undefined;\n    const root = cfg[MCP_ROOT_KEY];\n    if (root !== null && typeof root === \"object\" && !Array.isArray(root)) {\n      return undefined;\n    }\n    return {\n      platform: this.id,\n      action: \"warn\",\n      path: configPath,\n      detail: `existing ${MCP_ROOT_KEY} in ${configPath} is not an object map; left untouched (back it up / fix it, then re-run)`,\n    };\n  }\n\n  /** Render a normalized ServerDef into Windsurf's native mcpServers entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): WindsurfStdioServer | WindsurfRemoteServer {\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      // Windsurf supports ${env:VAR} natively, but AC resolves references to\n      // literals at install time (the safe path, same as amazon-q/droid/crush).\n      const entry: WindsurfStdioServer = {\n        command: resolveEnvRefsDeep(command),\n      };\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    // http / sse (and any other remote transport) — Windsurf registers a remote\n    // URL under `serverUrl` (NOT `url`). NO `type` discriminator, NO `disabled`.\n    // `headers` only when the connector's remote server provides them.\n    const entry: WindsurfRemoteServer = {\n      serverUrl: resolveEnvRefsDeep(server.url ?? \"\"),\n    };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /**\n   * Render env/header values. Windsurf has a native ${env:VAR} token, but AC\n   * resolves references to literals at install time (the safe path).\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 — Windsurf is mcp-only) ────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Windsurf 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 (Windsurf is mcp-only)\",\n      },\n    ];\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_config.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          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(mcpPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `${MCP_ROOT_KEY}.${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`,\n              };\n        },\n      },\n    ];\n  }\n}\n\nexport const adapter = new WindsurfAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2DA,SAAS,YAAY,gBAAgB;AACrC,SAAS,eAAe;AACxB,SAAS,UAAU,YAAY;AAqB/B,IAAM,OAAmB;AACzB,IAAM,eAAe;AAQrB,IAAM,qBAAqB;AAmBpB,IAAM,kBAAN,cAA8B,YAA+B;AAAA,EACzD,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQ5C,gBAAgB;AAAA;AAAA;AAAA;AAAA,IAIhB,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,MAAM;AAAA,IACN,cAAc;AAAA;AAAA,IAEd,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,yBAAyB;AAAA;AAAA;AAAA,IAGzB,YAAY,CAAC,SAAS,QAAQ,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUnC,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,EAClB;AAAA;AAAA,EAIA,gBAAgB,aAAuC;AACrD,UAAM,UAAU,KAAK,QAAQ,GAAG,YAAY,UAAU;AACtD,UAAM,UAAU,KAAK,SAAS,iBAAiB;AAC/C,UAAM,YAAY,WAAW,OAAO,KAAK,WAAW,OAAO;AAC3D,WAAO;AAAA,MACL,IAAI,KAAK;AAAA,MACT,MAAM,KAAK;AAAA,MACX;AAAA,MACA,UAAU,KAAK;AAAA,MACf,cAAc,KAAK;AAAA,MACnB,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,QAAQ,YACJ,+BAA+B,OAAO,KACtC,yBAAyB,OAAO;AAAA,MACpC,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,MAA8B;AACzC,WAAO,KAAK,QAAQ,GAAG,YAAY,UAAU;AAAA,EAC/C;AAAA,EAEA,oBAAoB,KAA6B;AAC/C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,iBAAiB;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,oBAAoB,GAAG;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,eAAe,KAA6B;AAClD,WAAO,KAAK,IAAI,YAAY,aAAa,SAAS,oBAAoB;AAAA,EACxE;AAAA;AAAA,EAGQ,eAAe,KAA8B;AACnD,UAAM,IAAI,KAAK,IAAI,YAAY,aAAa,OAAO;AACnD,QAAI,CAAC,WAAW,CAAC,EAAG,QAAO;AAC3B,QAAI;AACF,aAAO,SAAS,CAAC,EAAE,OAAO;AAAA,IAC5B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,iBAAiB,KAA6B;AACpD,UAAM,QAAQ,IAAI,UAAU,UAAU,CAAC,GACpC,IAAI,CAAC,MAAM,EAAE,QAAQ,KAAK,CAAC,EAC3B,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAC1B,KAAK,MAAM;AACd,WAAO,KAAK,oBAAoB,EAAE,SAAS,YAAY,GAAG,IAAI;AAAA,EAChE;AAAA,EAES,cAAc,KAAqC;AAC1D,UAAM,EAAE,UAAU,IAAI;AACtB,UAAM,UAAU,UAAU,UAAU,CAAC;AACrC,QAAI,UAAU,UAAU,KAAK,EAAE,GAAG,WAAW,OAAO;AAClD,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,uBAAuB,KAAK,EAAE,GAAG,CAAC;AAAA,IACzF;AACA,QAAI,QAAQ,WAAW,GAAG;AACxB,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AAEA,QAAI,IAAI,UAAU,WAAW;AAC3B,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QACE,MAAM,IAAI,KAAK,kHAEZ,QAAQ,MAAM;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAEA,QAAI,KAAK,eAAe,GAAG,GAAG;AAC5B,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM,KAAK,IAAI,YAAY,aAAa,OAAO;AAAA,UAC/C,QACE;AAAA,QAEJ;AAAA,MACF;AAAA,IACF;AACA,WAAO,CAAC,KAAK,iBAAiB,KAAK,eAAe,GAAG,GAAG,KAAK,iBAAiB,GAAG,GAAG,IAAI,MAAM,CAAC;AAAA,EACjG;AAAA,EAES,gBAAgB,KAAqC;AAG5D,QAAI,IAAI,UAAU,aAAa,KAAK,eAAe,GAAG,GAAG;AACvD,YAAM,OAAO,KAAK,eAAe,GAAG;AACpC,aAAO;AAAA,QACL,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,UAAU;AAAA,MAChF;AAAA,IACF;AACA,WAAO,CAAC,KAAK,kBAAkB,KAAK,eAAe,GAAG,GAAG,IAAI,MAAM,CAAC;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBQ,YAAY,KAAqB,MAAsB;AAC7D,UAAM,MACJ,IAAI,UAAU,YACV,KAAK,IAAI,YAAY,aAAa,WAAW,IAC7C,KAAK,QAAQ,GAAG,YAAY,YAAY,kBAAkB;AAChE,WAAO,KAAK,KAAK,GAAG,IAAI,KAAK;AAAA,EAC/B;AAAA;AAAA,EAGQ,SAAS,KAAqB,MAAsB;AAC1D,UAAM,OACJ,IAAI,UAAU,YACV,KAAK,IAAI,YAAY,aAAa,QAAQ,IAC1C,KAAK,QAAQ,GAAG,YAAY,YAAY,QAAQ;AACtD,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AAAA;AAAA,EAIS,gBAAgB,KAAqC;AAC5D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,aAAa,OAAO;AACjD,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,iCAAiC,CAAC;AAAA,IACzF;AACA,QAAI,UAAU,SAAS,WAAW,GAAG;AACnC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,iCAAiC,CAAC;AAAA,IACzF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,OAAO,UAAU,UAAU;AACpC,YAAM,WAAW,gBAAgB,GAAG;AACpC,cAAQ,KAAK,KAAK,iBAAiB,KAAK,YAAY,KAAK,IAAI,IAAI,GAAG,UAAU,IAAI,MAAM,CAAC;AAIzF,UAAI,SAAS,SAAS,oBAAoB;AACxC,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM,KAAK,YAAY,KAAK,IAAI,IAAI;AAAA,UACpC,QACE,aAAa,IAAI,IAAI,QAAQ,SAAS,MAAM,0CACT,kBAAkB;AAAA,QAEzD,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAES,kBAAkB,KAAqC;AAC9D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,SAAS,WAAW,GAAG;AACnC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,iCAAiC,CAAC;AAAA,IACzF;AACA,WAAO,UAAU,SAAS;AAAA,MAAI,CAAC,QAC7B,KAAK,kBAAkB,KAAK,YAAY,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM;AAAA,IACpE;AAAA,EACF;AAAA;AAAA,EAIS,cAAc,KAAqC;AAC1D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,WAAW,OAAO;AAC/C,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AACpC,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AACzC,cAAQ;AAAA,QACN,KAAK,iBAAiB,KAAK,KAAK,UAAU,GAAG,cAAc,KAAK,GAAG,IAAI,MAAM;AAAA,MAC/E;AACA,iBAAW,CAAC,KAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,aAAa,CAAC,CAAC,GAAG;AACnE,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,MAAM;AACnB,kBAAQ,KAAK;AAAA,YACX,UAAU,KAAK;AAAA,YACf,QAAQ;AAAA,YACR,QAAQ,mBAAmB,GAAG;AAAA,UAChC,CAAC;AACD;AAAA,QACF;AACA,gBAAQ,KAAK,KAAK,iBAAiB,QAAQ,UAAU,IAAI,MAAM,CAAC;AAAA,MAClE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAES,gBAAgB,KAAqC;AAC5D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AACpC,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AACzC,cAAQ,KAAK,KAAK,kBAAkB,KAAK,KAAK,UAAU,GAAG,IAAI,MAAM,CAAC;AACtE,iBAAW,OAAO,OAAO,KAAK,MAAM,aAAa,CAAC,CAAC,GAAG;AACpD,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,KAAM;AACrB,gBAAQ,KAAK,KAAK,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAAA,MACzD;AACA,cAAQ,KAAK,KAAK,iBAAiB,KAAK,IAAI,MAAM,CAAC;AAAA,IACrD;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,EAAE,UAAU,IAAI;AACtB,UAAM,WAAW,UAAU,UAAU,IAAI,GAAG;AAC5C,QAAI,CAAC,UAAU,UAAU,aAAa,OAAO;AAC3C,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QAAQ,UAAU,SACd,8CACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAKA,QAAI,IAAI,UAAU,WAAW;AAC3B,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QACE;AAAA,QAEJ;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SACJ,YAAY,OAAO,aAAa,WAC5B,EAAE,GAAG,UAAU,QAAQ,GAAG,SAAS,IACnC,UAAU;AAEhB,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAM/C,UAAM,YAAY,KAAK,iBAAiB,UAAU;AAClD,QAAI,UAAW,QAAO,CAAC,SAAS;AAEhC,UAAM,QAAQ,KAAK,kBAAkB,KAAK,MAAM;AAEhD,WAAO;AAAA,MACL,KAAK,mBAAmB,YAAY,cAAc,UAAU,IAAI,OAAO,IAAI,MAAM;AAAA,IACnF;AAAA,EACF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,YAAY,KAAK,iBAAiB,UAAU;AAClD,QAAI,UAAW,QAAO,CAAC,SAAS;AAChC,WAAO;AAAA,MACL,KAAK,qBAAqB,YAAY,cAAc,IAAI,UAAU,IAAI,IAAI,MAAM;AAAA,IAClF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,iBAAiB,YAA8C;AACrE,UAAM,MAAM,KAAK,SAAkC,UAAU;AAC7D,QAAI,CAAC,OAAO,EAAE,gBAAgB,KAAM,QAAO;AAC3C,UAAM,OAAO,IAAI,YAAY;AAC7B,QAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,IAAI,GAAG;AACrE,aAAO;AAAA,IACT;AACA,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,QAAQ,YAAY,YAAY,OAAO,UAAU;AAAA,IACnD;AAAA,EACF;AAAA;AAAA,EAGQ,kBACN,KACA,QAC4C;AAC5C,UAAM,YAAuB,OAAO;AAEpC,QAAI,cAAc,SAAS;AACzB,UAAI,UAAU,OAAO,WAAW;AAChC,UAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAIlC,UAAI,uBAAuB,QAAQ,IAAI,UAAU,SAAS,GAAG;AAC3D,cAAM,UAAU;AAAA,UACd,IAAI;AAAA,UACJ,IAAI,UAAU;AAAA,UACd;AAAA,UACA;AAAA,UACA,IAAI;AAAA,UACJ,KAAK;AAAA,QACP;AACA,kBAAU,QAAQ;AAClB,eAAO,QAAQ;AAAA,MACjB;AAIA,YAAMA,SAA6B;AAAA,QACjC,SAAS,mBAAmB,OAAO;AAAA,MACrC;AACA,UAAI,KAAK,SAAS,EAAG,CAAAA,OAAM,OAAO,mBAAmB,IAAI;AACzD,YAAM,MAAM,KAAK,UAAU,OAAO,GAAG;AACrC,UAAI,IAAK,CAAAA,OAAM,MAAM;AACrB,aAAOA;AAAA,IACT;AAKA,UAAM,QAA8B;AAAA,MAClC,WAAW,mBAAmB,OAAO,OAAO,EAAE;AAAA,IAChD;AACA,UAAM,UAAU,KAAK,UAAU,OAAO,OAAO;AAC7C,QAAI,QAAS,OAAM,UAAU;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,UACN,KACoC;AACpC,QAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAClD,WAAO,mBAAmB,EAAE,GAAG,IAAI,CAAC;AAAA,EACtC;AAAA;AAAA,EAIA,aAAa,MAAsC;AACjD,WAAO;AAAA,MACL;AAAA,QACE,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEA,eAAe,MAAsC;AACnD,WAAO;AAAA,MACL;AAAA,QACE,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,UAAU,KAAK,oBAAoB,GAAG;AAC5C,UAAM,cAAc,IAAI,UAAU;AAClC,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,OAAO,IACd,EAAE,QAAQ,MAAM,QAAQ,QAAQ,IAChC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,OAAO,GAAG;AAAA,MAC1D;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,CAAC,IAAI,UAAU,QAAQ;AACzB,mBAAO,EAAE,QAAQ,MAAM,QAAQ,yBAAyB;AAAA,UAC1D;AACA,gBAAM,MAAM,KAAK,SAAmD,OAAO;AAC3E,gBAAM,SAAS,MAAM,YAAY;AACjC,cAAI,CAAC,OAAO,CAAC,QAAQ;AACnB,mBAAO,EAAE,QAAQ,QAAQ,QAAQ,MAAM,YAAY,OAAO,OAAO,GAAG;AAAA,UACtE;AACA,iBAAO,eAAe,SAClB,EAAE,QAAQ,MAAM,QAAQ,GAAG,YAAY,IAAI,WAAW,WAAW,IACjE;AAAA,YACE,QAAQ;AAAA,YACR,QAAQ,MAAM,YAAY,IAAI,WAAW,OAAO,OAAO;AAAA,UACzD;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,UAAU,IAAI,gBAAgB;AAC3C,IAAO,mBAAQ;","names":["entry"]}

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

@@ -4,14 +4,14 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-CPLK7GTE.js";
 import {
   renderSkillMd
 } from "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-I5MLE6S7.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-SFUHL3GS.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ken-jo/agent-connector",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "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": [
@@ -28,7 +28,7 @@
     "url": "https://github.com/ken-jo/agent-connector/issues"
   },
   "bin": {
-    "agent-connector": "./dist/cli.js"
+    "agent-connector": "dist/cli.js"
   },
   "exports": {
     ".": {
@@ -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"]}