@ken-jo/agent-connector 0.1.0

package/dist/copilot-cli-MTCGHZ2T.js

@@ -0,0 +1,622 @@
+#!/usr/bin/env node
+import {
+  resolveEnvRefsDeep
+} from "./chunk-DBQMX75U.js";
+import {
+  BaseAdapter
+} from "./chunk-TIIP3RG2.js";
+import "./chunk-7L6ITC4T.js";
+import {
+  buildHomeBinHookCommand,
+  buildServeWrapperCommand,
+  isHomeBinHookCommand,
+  shouldWrapForTelemetry
+} from "./chunk-MEH7GC7R.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/adapters/copilot-cli/index.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var HOST = "copilot-cli";
+var MCP_ROOT_KEY = "mcpServers";
+var COPILOT_HOOKS_VERSION = 1;
+var CopilotCliAdapter = class extends BaseAdapter {
+  id = HOST;
+  name = "GitHub Copilot CLI";
+  paradigm = "json-stdio";
+  capabilities = {
+    // Copilot CLI delivers the full Claude-compatible lifecycle event set.
+    preToolUse: true,
+    postToolUse: true,
+    preCompact: true,
+    sessionStart: true,
+    sessionEnd: true,
+    userPromptSubmit: true,
+    stop: true,
+    notification: true,
+    // PreToolUse is fail-closed and can rewrite tool input (updatedInput); a
+    // PostToolUse hook cannot rewrite already-emitted tool output.
+    canModifyArgs: true,
+    canModifyOutput: false,
+    canInjectSessionContext: true,
+    transports: ["stdio", "http"],
+    // Content surfaces: Copilot CLI exposes skills + subagents, but has no
+    // prompt-file command surface, so commands stay false (inherits BaseAdapter
+    // skip/warn).
+    supportsCommands: false,
+    supportsSkills: true,
+    supportsSubagents: true
+  };
+  // ── Detection ────────────────────────────────────────────────────────────
+  detectInstalled(_projectDir) {
+    const userDir = join(homedir(), ".copilot");
+    const mcpConfig = join(userDir, "mcp-config.json");
+    const hooksDir = join(userDir, "hooks");
+    const installed = existsSync(userDir) || existsSync(mcpConfig) || existsSync(hooksDir);
+    return {
+      id: this.id,
+      name: this.name,
+      installed,
+      paradigm: this.paradigm,
+      capabilities: this.capabilities,
+      configPath: mcpConfig,
+      scope: "user",
+      reason: installed ? `found GitHub Copilot CLI config under ${userDir}` : `no GitHub Copilot CLI config at ${userDir}`,
+      confidence: installed ? "high" : "low"
+    };
+  }
+  // ── Native paths ─────────────────────────────────────────────────────────
+  /** Copilot CLI is user/global only — scope is ignored. */
+  getConfigDir(_ctx) {
+    return join(homedir(), ".copilot");
+  }
+  getServerConfigPath(ctx) {
+    return join(this.getConfigDir(ctx), "mcp-config.json");
+  }
+  /**
+   * Copilot CLI discovers hooks from any `~/.copilot/hooks/*.json`. We write a
+   * single dedicated file so we never disturb the user's own hook files and
+   * uninstall is a clean, scoped operation.
+   */
+  getHookConfigPath(ctx) {
+    return join(this.getConfigDir(ctx), "hooks", "agent-connector.json");
+  }
+  // ── 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 copilot-cli" : "connector declares no MCP server"
+        }
+      ];
+    }
+    const server = override && typeof override === "object" ? { ...connector.server, ...override } : connector.server;
+    const serverPath = this.getServerConfigPath(ctx);
+    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);
+    return [
+      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun)
+    ];
+  }
+  /** Render a normalized ServerDef into Copilot CLI's native mcpServers entry. */
+  renderServerEntry(ctx, server) {
+    const transport = server.transport;
+    const tools = this.renderTools(server);
+    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 = {
+        type: "local",
+        command: resolveEnvRefsDeep(command),
+        tools
+      };
+      if (args.length > 0) entry2.args = args.map((a) => resolveEnvRefsDeep(a));
+      const env = this.renderEnv(server.env);
+      if (env) entry2.env = env;
+      if (server.cwd) entry2.cwd = resolveEnvRefsDeep(server.cwd);
+      return entry2;
+    }
+    const entry = {
+      type: "http",
+      url: resolveEnvRefsDeep(server.url ?? ""),
+      tools
+    };
+    const headers = this.renderEnv(server.headers);
+    if (headers) entry.headers = headers;
+    return entry;
+  }
+  /**
+   * Render env/header values. Copilot CLI is not documented to support native
+   * `${env:VAR}` interpolation in mcp-config.json, so refs resolve to literals
+   * at install time (the safe default for a no-native-interp host).
+   */
+  renderEnv(env) {
+    if (!env || Object.keys(env).length === 0) return void 0;
+    return resolveEnvRefsDeep({ ...env });
+  }
+  /** Render the tool allow-list. Copilot CLI expects `tools` on every entry; default ["*"]. */
+  renderTools(server) {
+    const include = server.tools?.include;
+    return include && include.length > 0 ? [...include] : ["*"];
+  }
+  // ── Hook install / uninstall ─────────────────────────────────────────────
+  installHooks(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.hooks === false) {
+      return [
+        { platform: this.id, action: "skip", detail: "hooks disabled for copilot-cli" }
+      ];
+    }
+    if (connector.hookEvents.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no hooks" }];
+    }
+    const hooksPath = this.getHookConfigPath(ctx);
+    const file = this.readJson(hooksPath) ?? {};
+    const hooks = file.hooks ??= {};
+    const changes = [];
+    let mutated = false;
+    for (const event of connector.hookEvents) {
+      const copilotEvent = event;
+      const command = buildHomeBinHookCommand(ctx.homeBinPath, HOST, event, connector.id);
+      const matcher = connector.hooks[event]?.matcher ?? "";
+      const entry = {
+        matcher,
+        hooks: [{ type: "command", command }]
+      };
+      const bucket = hooks[copilotEvent] ??= [];
+      const existingIdx = bucket.findIndex((e) => this.entryHasOurCommand(e, ctx));
+      if (existingIdx >= 0) {
+        if (JSON.stringify(bucket[existingIdx]) === JSON.stringify(entry)) {
+          changes.push({
+            platform: this.id,
+            action: "skip",
+            path: hooksPath,
+            detail: `hooks.${copilotEvent} already registered`
+          });
+          continue;
+        }
+        bucket[existingIdx] = entry;
+        changes.push({
+          platform: this.id,
+          action: "update",
+          path: hooksPath,
+          detail: `hooks.${copilotEvent}`
+        });
+      } else {
+        bucket.push(entry);
+        changes.push({
+          platform: this.id,
+          action: "create",
+          path: hooksPath,
+          detail: `hooks.${copilotEvent}`
+        });
+      }
+      mutated = true;
+    }
+    if (mutated) {
+      file.version = COPILOT_HOOKS_VERSION;
+      this.writeJson(hooksPath, file, ctx.dryRun);
+    }
+    return changes;
+  }
+  uninstallHooks(ctx) {
+    const hooksPath = this.getHookConfigPath(ctx);
+    const file = this.readJson(hooksPath);
+    const hooks = file?.hooks;
+    if (!file || !hooks) {
+      return [
+        {
+          platform: this.id,
+          action: "skip",
+          path: hooksPath,
+          detail: "no hooks section present"
+        }
+      ];
+    }
+    const changes = [];
+    let mutated = false;
+    for (const copilotEvent of Object.keys(hooks)) {
+      const bucket = hooks[copilotEvent];
+      if (!Array.isArray(bucket)) continue;
+      const next = [];
+      let removed = 0;
+      for (const e of bucket) {
+        const innerBefore = e.hooks?.length ?? 0;
+        const inner = (e.hooks ?? []).filter((h) => !this.isOurCommand(h.command, ctx));
+        removed += innerBefore - inner.length;
+        if (inner.length > 0) next.push({ matcher: e.matcher ?? "", hooks: inner });
+      }
+      if (removed > 0) {
+        if (next.length > 0) hooks[copilotEvent] = next;
+        else delete hooks[copilotEvent];
+        changes.push({
+          platform: this.id,
+          action: "remove",
+          path: hooksPath,
+          detail: `hooks.${copilotEvent} (${removed})`
+        });
+        mutated = true;
+      }
+    }
+    if (mutated) this.writeJson(hooksPath, file, ctx.dryRun);
+    if (changes.length === 0) {
+      changes.push({
+        platform: this.id,
+        action: "skip",
+        path: hooksPath,
+        detail: "no matching hook entries"
+      });
+    }
+    return changes;
+  }
+  entryHasOurCommand(entry, ctx) {
+    return (entry.hooks ?? []).some((h) => this.isOurCommand(h.command, ctx));
+  }
+  /** True when a hook command references our home binary AND this connector id
+   *  (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand). */
+  isOurCommand(command, ctx) {
+    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);
+  }
+  // ── Content surfaces: skills / subagents ─────────────────────────────────
+  // CONTENT-ONLY: pure native-file writers. No runtime dispatch, no home-bin
+  // pointer, no telemetry wrap. Each method is idempotent (byte-identical →
+  // skip) via BaseAdapter.writeContentFile and reversible via removeContentFile.
+  // Honors platforms["copilot-cli"] per-surface false to skip. Commands are
+  // unsupported here — they inherit the BaseAdapter skip/warn default.
+  //
+  // Path scoping: user scope lives under ~/.copilot (getConfigDir); project
+  // scope lives under the shared <projectDir>/.github tree (the same files
+  // vscode-copilot / jetbrains-copilot would write). We write identical content
+  // and on uninstall remove only the files this connector wrote.
+  /** Root dir for content surfaces: ~/.copilot (user) or <projectDir>/.github (project). */
+  contentDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".github") : this.getConfigDir(ctx);
+  }
+  skillsDir(ctx) {
+    return join(this.contentDir(ctx), "skills");
+  }
+  agentsDir(ctx) {
+    return join(this.contentDir(ctx), "agents");
+  }
+  /** Native skill dir: <contentDir>/skills/<name>. */
+  skillDir(ctx, name) {
+    return join(this.skillsDir(ctx), name);
+  }
+  /** Native subagent file path: <contentDir>/agents/<name>.agent.md. */
+  subagentPath(ctx, name) {
+    return join(this.agentsDir(ctx), `${name}.agent.md`);
+  }
+  // ── Skills ────────────────────────────────────────────────────────────────
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for copilot-cli" }];
+    }
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(
+        this.writeContentFile(join(dir, "SKILL.md"), this.renderSkill(skill), ctx.dryRun)
+      );
+      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `skill resource "${rel}" escapes the skill dir; skipped`
+          });
+          continue;
+        }
+        changes.push(this.writeContentFile(target, contents, ctx.dryRun));
+      }
+    }
+    return changes;
+  }
+  uninstallSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(this.removeContentFile(join(dir, "SKILL.md"), ctx.dryRun));
+      for (const rel of Object.keys(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) continue;
+        changes.push(this.removeContentFile(target, ctx.dryRun));
+      }
+      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));
+    }
+    return changes;
+  }
+  /**
+   * Render a skill's SKILL.md: frontmatter (name, description + optional model,
+   * allowed-tools, disable-model-invocation) + body. Uniform Agent Skills shape
+   * shared across every skill-supporting connector.
+   */
+  renderSkill(skill) {
+    const frontmatter = {
+      name: skill.name,
+      description: skill.description
+    };
+    if (skill.model !== void 0) frontmatter.model = skill.model;
+    const allow = skill.tools?.allow;
+    if (allow && allow.length > 0) frontmatter["allowed-tools"] = allow.join(", ");
+    if (skill.disableModelInvocation !== void 0) {
+      frontmatter["disable-model-invocation"] = skill.disableModelInvocation;
+    }
+    if (skill.extra) Object.assign(frontmatter, skill.extra);
+    return this.renderFrontmatterMd(frontmatter, skill.body);
+  }
+  // ── Subagents ───────────────────────────────────────────────────────────────
+  installSubagents(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.subagents === false) {
+      return [{ platform: this.id, action: "skip", detail: "subagents disabled for copilot-cli" }];
+    }
+    if (connector.subagents.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no subagents" }];
+    }
+    return connector.subagents.map(
+      (agent) => this.writeContentFile(
+        this.subagentPath(ctx, agent.name),
+        this.renderSubagent(agent),
+        ctx.dryRun
+      )
+    );
+  }
+  uninstallSubagents(ctx) {
+    const { connector } = ctx;
+    if (connector.subagents.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no subagents" }];
+    }
+    return connector.subagents.map(
+      (agent) => this.removeContentFile(this.subagentPath(ctx, agent.name), ctx.dryRun)
+    );
+  }
+  /** Render a subagent to md+frontmatter (name, description, tools, model) + prompt body. */
+  renderSubagent(agent) {
+    const frontmatter = {
+      name: agent.name,
+      description: agent.description
+    };
+    const allow = agent.tools?.allow;
+    if (allow && allow.length > 0) frontmatter.tools = allow.join(", ");
+    if (agent.model !== void 0) frontmatter.model = agent.model;
+    if (agent.extra) Object.assign(frontmatter, agent.extra);
+    return this.renderFrontmatterMd(frontmatter, agent.prompt);
+  }
+  // ── Diagnostics ──────────────────────────────────────────────────────────
+  getHealthChecks(ctx) {
+    const mcpPath = this.getServerConfigPath(ctx);
+    const hooksPath = this.getHookConfigPath(ctx);
+    const connectorId = ctx.connector.id;
+    const homeBin = ctx.homeBinPath;
+    const hookEvents = ctx.connector.hookEvents;
+    const checks = [
+      {
+        name: `${this.name}: mcp-config.json present`,
+        check: () => existsSync(mcpPath) ? { status: "OK", detail: mcpPath } : { status: "FAIL", detail: `not found: ${mcpPath}` }
+      },
+      {
+        name: `${this.name}: hook command registered`,
+        check: () => {
+          if (hookEvents.length === 0) {
+            return { status: "OK", detail: "no hooks declared" };
+          }
+          const file = this.readJson(hooksPath);
+          if (!file) return { status: "FAIL", detail: `cannot read ${hooksPath}` };
+          const hooks = file.hooks ?? {};
+          const registered = Object.values(hooks).some(
+            (entries) => (entries ?? []).some(
+              (e) => (e.hooks ?? []).some(
+                (h) => isHomeBinHookCommand(h.command, homeBin, connectorId)
+              )
+            )
+          );
+          return registered ? { status: "OK", detail: "hook command present" } : { status: "FAIL", detail: `no hook for ${connectorId} in ${hooksPath}` };
+        }
+      }
+    ];
+    for (const skill of ctx.connector.skills) {
+      const p = join(this.skillDir(ctx, skill.name), "SKILL.md");
+      checks.push({
+        name: `${this.name}: skill ${skill.name} present`,
+        check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
+      });
+    }
+    for (const agent of ctx.connector.subagents) {
+      const p = this.subagentPath(ctx, agent.name);
+      checks.push({
+        name: `${this.name}: subagent ${agent.name} present`,
+        check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
+      });
+    }
+    return checks;
+  }
+  // ── Runtime: parse Copilot CLI stdin JSON → normalized event ─────────────
+  parseEvent(event, raw) {
+    const input = raw ?? {};
+    const connectorId = typeof input.connector === "string" ? input.connector : "";
+    const sessionId = extractSessionId(input);
+    const projectDir = typeof input.cwd === "string" ? input.cwd : void 0;
+    const base = {
+      hostPlatform: HOST,
+      connectorId,
+      sessionId,
+      raw,
+      ...projectDir !== void 0 ? { projectDir } : {}
+    };
+    switch (event) {
+      case "PreToolUse": {
+        const ev = {
+          ...base,
+          toolName: input.tool_name ?? "",
+          toolInput: input.tool_input ?? {}
+        };
+        return ev;
+      }
+      case "PostToolUse": {
+        const toolOutput = toolResponseToString(input.tool_response);
+        const ev = {
+          ...base,
+          toolName: input.tool_name ?? "",
+          toolInput: input.tool_input ?? {},
+          ...toolOutput !== void 0 ? { toolOutput } : {}
+        };
+        return ev;
+      }
+      case "SessionStart": {
+        const ev = {
+          ...base,
+          source: normalizeSessionSource(input.source)
+        };
+        return ev;
+      }
+      case "SessionEnd": {
+        const ev = {
+          ...base,
+          ...typeof input.reason === "string" ? { reason: input.reason } : {}
+        };
+        return ev;
+      }
+      case "UserPromptSubmit": {
+        const ev = {
+          ...base,
+          prompt: typeof input.prompt === "string" ? input.prompt : ""
+        };
+        return ev;
+      }
+      case "PreCompact": {
+        const ev = {
+          ...base,
+          ...input.trigger === "auto" || input.trigger === "manual" ? { trigger: input.trigger } : {}
+        };
+        return ev;
+      }
+      case "Stop": {
+        const ev = {
+          ...base,
+          ...typeof input.stop_hook_active === "boolean" ? { stopHookActive: input.stop_hook_active } : {}
+        };
+        return ev;
+      }
+      case "Notification": {
+        const ev = {
+          ...base,
+          message: typeof input.message === "string" ? input.message : ""
+        };
+        return ev;
+      }
+      default: {
+        const _never = event;
+        throw new Error(`unsupported copilot-cli hook event: ${String(_never)}`);
+      }
+    }
+  }
+  // ── Runtime: normalized response → Copilot CLI native hook reply ─────────
+  formatReply(event, response) {
+    const hookEventName = event;
+    const decision = response.decision ?? "allow";
+    if (decision === "deny") {
+      return this.stdout({
+        hookSpecificOutput: {
+          hookEventName,
+          permissionDecision: "deny",
+          permissionDecisionReason: response.reason ?? "Blocked by hook"
+        }
+      });
+    }
+    if (decision === "ask") {
+      return this.stdout({
+        hookSpecificOutput: {
+          hookEventName,
+          permissionDecision: "ask",
+          permissionDecisionReason: response.reason ?? "Confirmation required by hook"
+        }
+      });
+    }
+    if (decision === "modify") {
+      if (event === "PreToolUse" && response.updatedInput) {
+        return this.stdout({
+          hookSpecificOutput: { hookEventName, updatedInput: response.updatedInput }
+        });
+      }
+    }
+    if (decision === "context" && response.additionalContext) {
+      return this.stdout({
+        hookSpecificOutput: { hookEventName, additionalContext: response.additionalContext }
+      });
+    }
+    return { exitCode: 0 };
+  }
+  stdout(payload) {
+    return { exitCode: 0, stdout: JSON.stringify(payload) };
+  }
+};
+function extractSessionId(input) {
+  if (typeof input.transcript_path === "string") {
+    const m = input.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);
+    if (m && m[1]) return m[1];
+  }
+  if (typeof input.session_id === "string" && input.session_id !== "") {
+    return input.session_id;
+  }
+  return "";
+}
+function toolResponseToString(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function normalizeSessionSource(source) {
+  switch (source) {
+    case "compact":
+      return "compact";
+    case "resume":
+      return "resume";
+    case "clear":
+      return "clear";
+    default:
+      return "startup";
+  }
+}
+var adapter = new CopilotCliAdapter();
+var copilot_cli_default = adapter;
+export {
+  CopilotCliAdapter,
+  adapter,
+  copilot_cli_default as default
+};
+//# sourceMappingURL=copilot-cli-MTCGHZ2T.js.map