@ken-jo/agent-connector 0.3.1 → 0.4.0

package/README.md

@@ -8,13 +8,13 @@
 
 [![npm](https://img.shields.io/npm/v/@ken-jo/agent-connector?color=cb3837&logo=npm)](https://www.npmjs.com/package/@ken-jo/agent-connector)
 [![license](https://img.shields.io/npm/l/@ken-jo/agent-connector?color=22c55e)](LICENSE)
-![platforms](https://img.shields.io/badge/platforms-29-2563eb)
-![surfaces](https://img.shields.io/badge/surfaces-MCP%20%7C%20hooks%20%7C%20commands%20%7C%20tools%20%7C%20memory-2563eb)
+![platforms](https://img.shields.io/badge/platforms-31-2563eb)
+![surfaces](https://img.shields.io/badge/surfaces-MCP%20%7C%20hooks%20%7C%20commands%20%7C%20tools%20%7C%20memory%20%7C%20status%20line-2563eb)
 ![hook paradigms](https://img.shields.io/badge/hook%20paradigms-3-2563eb)
 ![install verified](https://img.shields.io/badge/install%20verified-29%2F29-22c55e)
 ![headless runtime](https://img.shields.io/badge/headless%20runtime-10%20CLIs%20activated-22c55e)
 ![marketplace](https://img.shields.io/badge/package-9%20marketplace%20formats-2563eb)
-![tests](https://img.shields.io/badge/tests-1483%20passing-22c55e)
+![tests](https://img.shields.io/badge/tests-1727%20passing-22c55e)
 
 ## Who this is for
 
@@ -57,14 +57,14 @@ agent-connector is the middleware that does it for you:
    registered but **not wrapped** (the proxy cannot intercept remote transports),
    so they yield no per-tool telemetry.
 
-> Status: **29 platforms, all 3 hook paradigms** (exceeds the
+> Status: **31 platforms, all 3 hook paradigms** (exceeds the
 > [tokscale](https://github.com/junhoyeo/tokscale) token-leaderboard coverage).
 >
 > | Paradigm | Platforms |
 > |---|---|
 > | `json-stdio` (full hook dispatch) | Claude Code · Codex CLI · Cursor · VS Code Copilot · JetBrains Copilot · GitHub Copilot CLI · Gemini CLI · Qwen CLI · Kiro · Kimi CLI · Crush · Goose · Hermes · Droid (Factory) · Antigravity · Antigravity CLI |
 > | `mcp-only` (MCP registration only) | Warp · Kilo · Roo Code · Trae · Zed · Amp · Codebuff · Mux · Pi |
-> | `ts-plugin` (generated bridge module) | OpenCode · Kilo CLI · OMP · OpenClaw |
+> | `ts-plugin` (generated bridge module) | OpenCode · MiMoCode · Kilo CLI · Kilo · OMP · NemoClaw · OpenClaw |
 >
 > …plus the telemetry core. Adding a platform = **one registry entry + one
 > adapter**. (Google Antigravity is now fully supported, including the `agy` CLI,
@@ -72,10 +72,13 @@ agent-connector is the middleware that does it for you:
 
 ## Verification
 
-The full single-API contract is **install-verified across all 29 platforms**. A
+The full single-API contract is **install-verified across the platform set**. A
 sample connector declaring **all four launch surfaces** — MCP server **+**
 lifecycle hooks **+** slash commands **+** tools (skills + subagents) — was
-installed into an isolated environment for every adapter and inspected on disk:
+installed into an isolated environment for every adapter and inspected on disk
+(the 29-platform full sweep below; the two newest adapters — MiMoCode and
+NemoClaw — were added with a focused isolated-HOME install check landing the MCP
+server in the right file + root key):
 
 - **29 / 29 platforms — zero missing, zero failed surfaces.** Each surface is
   written where the host supports it and gracefully *skip-warned* (never silently
@@ -102,7 +105,7 @@ installed into an isolated environment for every adapter and inspected on disk:
 - **Clean uninstall + `--purge`.** Every installed surface reverses; `--purge`
   deregisters the connector record and tears down the home binary when no
   connectors remain (29 / 29).
-- **1483 tests passing** · `tsc` clean · build green.
+- **1727 tests passing** · `tsc` clean · build green.
 
 The 0.2.0 additions — the `memory` surface, the `nativeHooks` passthrough, and
 `configPatch` — went through the same bar: dogfooded against real connector
@@ -192,7 +195,7 @@ npx @ken-jo/agent-connector install
 
 > `install` targets only the hosts actually **detected** on this machine (or an
 > explicit `--targets` / `connector.targets` list), intersected with the
-> 29-adapter registry — there is no "install to all 29 unconditionally" path.
+> 31-adapter registry — there is no "install to all 31 unconditionally" path.
 
 > **Optional convenience.** A global `npm i -g @ken-jo/agent-connector` is **not**
 > required for the flow above — `npx @ken-jo/agent-connector …` runs it straight from
@@ -254,6 +257,72 @@ acme-db`, `acme-db install` ≈ `agent-connector install --connector
 tools share that infrastructure. An explicit `--connector` / `--connector-id`
 always overrides the injected default.
 
+### Author + test offline — the Connector SDK (`/sdk`, `/sdk/test`)
+
+```ts
+import { defineConnector, defineHook, hostsSupporting } from "@ken-jo/agent-connector/sdk";
+import { simulate, explain } from "@ken-jo/agent-connector/sdk/test";
+```
+
+`@ken-jo/agent-connector/sdk` is the consolidated **authoring** surface — it
+re-exports `defineConnector`, the full `define*` family, the introspection
+helpers, and public types from one import site (the root export is unchanged;
+`/sdk` is additive).
+
+**`define*` typed helpers** — each is a typed identity function (`(def) => def`)
+that gives you per-surface type inference and a single import site:
+`defineCommand`, `defineSkill`, `defineSubagent`, `defineMemory`,
+`defineConfigPatch`, `defineNativeHook`. `defineHook` is event-parameterized
+so the handler payload narrows to the concrete event type:
+
+```ts
+const guard = defineHook("PreToolUse", {
+  handler(evt) {
+    // evt.toolName is typed as PreToolUseEvent — not the union
+    return evt.toolName === "acme_write"
+      ? { decision: "ask", reason: "Confirm write" }
+      : { decision: "allow" };
+  },
+});
+```
+
+**Introspection** (async — adapters load lazily):
+
+- `hostsSupporting(surface)` → `Promise<PlatformId[]>` — which registered hosts
+  honor a surface (`"hooks"` | `"statusline"` | `"memory"` | …).
+- `capabilitiesOf(host)` → `Promise<PlatformCapabilities | undefined>`.
+- `surfaceSupport(host, surface)` → `Promise<boolean>` — convenience single-pair check.
+
+**Offline harness** (`@ken-jo/agent-connector/sdk/test`) answers *"does my
+handler / HUD actually work on host X?"* before you touch a real host:
+
+- `explain(connector)` → `Promise<ExplainRow[]>` — the per-host × per-declared-surface
+  matrix. Each row is `{ host, surface, support: "native"|"skip-warn"|"disabled", reason }`.
+  Only surfaces the connector actually declares are included.
+- `simulate(connector, { surface, host, event?, input })` → `Promise<{ honored, hostReply?, reason }>`
+  — runs the **real** adapter parse→handler→format chain offline and judges the
+  actual `(event, decision)` contract. It encodes each host's real honor / drop /
+  degrade quirks — not substring guessing:
+
+```ts
+// Does codex honor a context injection on UserPromptSubmit?
+const result = await simulate(connector, {
+  surface: "hooks",
+  host: "codex",
+  event: "UserPromptSubmit",
+  input: { hookEventName: "UserPromptSubmit", prompt: "explain this" },
+});
+// → { honored: false, reason: "drops context on UserPromptSubmit (no stdout path)" }
+```
+
+> Other verdicts the harness encodes: a `deny` on `Stop`/`SubagentStop` is
+> continuation/persistence → `honored:true` (reason explains); `deny` on
+> `SubagentStart`/`PostToolUseFailure` degrades to a context note →
+> `honored:false`; a PermissionRequest `ask` is honored by the host's native
+> dialog → `honored:true`. Matcher-scoped handlers that don't match the input
+> are not run. The harness mirrors the runtime exactly — tolerant stdin,
+> matcher filtering, real verdict.
+
 ### Two ways to ship: direct install **or** a marketplace package
 
 Same one definition, your choice of distribution:
@@ -332,14 +401,16 @@ export default defineConnector({
 > Code only for now; other hosts skip-warn, never silently.
 
 > **Host-config key patches.** For host-exclusive *settings keys* no other
-> surface reaches (Claude Code's `statusLine`, an experimental `env.*` flag),
-> declare `platforms: { "claude-code": { configPatch: [{ key, value, reason }] } }`.
+> surface reaches (e.g. an experimental `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`
+> flag), declare `platforms: { "claude-code": { configPatch: [{ key, value, reason }] } }`.
 > Semantics are fixed: **set-if-absent + skip-warn on any conflict** — never
 > overwrite, never deep-merge. Ownership is refcounted in a persisted ledger, so
 > uninstall removes a key only when the last owning connector releases it and the
 > value is untouched; security-relevant keys (`permissions*`, `apiKey*`,
-> `env.ANTHROPIC_*`, token/secret env vars, …) are hard-refused. Claude Code only
-> for now; other hosts skip-warn with the exact manual edit.
+> `env.ANTHROPIC_*`, token/secret env vars, …) are hard-refused, as are keys
+> agent-connector models as first-class surfaces (`hooks*`, `mcpServers*`,
+> `statusLine` → use the `statusline` surface instead). Claude Code only for now;
+> other hosts skip-warn with the exact manual edit.
 
 `agent-connector install` turns that into, e.g.:
 
@@ -366,7 +437,7 @@ memory: [
 ```
 
 **Write the guidance once — it lands in the standard
-[AGENTS.md](https://agents.md) on 27 of the 29 hosts** (the open, Linux
+[AGENTS.md](https://agents.md) on 29 of the 31 hosts** (the open, Linux
 Foundation-stewarded "README for agents" format): project scope targets
 `<projectDir>/AGENTS.md` — and where a host resolves its rules file
 exclusively, the target is *probed* so the block lands in the file the host
@@ -395,6 +466,99 @@ Uninstall excises exactly your blocks and `doctor` verifies them (present /
 hash-intact / user-edited / file missing). Hosts with no writable memory file at
 a scope skip-warn, never silently.
 
+### Status line (`statusline`) — live HUD per connector
+
+Ship a render function that the host calls on every status refresh:
+
+```ts
+import { defineConnector, defineStatusline } from "@ken-jo/agent-connector";
+
+export default defineConnector({
+  id: "acme-db",
+  // ...
+  statusline: defineStatusline({
+    render(ctx) {
+      const model = ctx.model?.displayName ?? ctx.model?.id ?? "unknown";
+      return `acme-db · ${model} · $${(ctx.cost?.totalUsd ?? 0).toFixed(4)}`;
+    },
+  }),
+});
+```
+
+`StatuslineContext` provides (where the host supplies them) `host`,
+`connectorId`, `sessionId`, `cwd`, `model` (`id` / `displayName`),
+`cost` (`totalUsd`), `context` (`usedTokens` / `maxTokens` / `percent`),
+`transcriptPath`, and `raw` (the host's verbatim payload). Fields the host
+does not provide are `undefined`.
+
+> **`ctx.context` is reserved** — `context.usedTokens` / `maxTokens` / `percent`
+> are declared in `StatuslineContext` for a future AC-usage integration but are
+> **not populated by any v1 code path**. Rendering `ctx.context?.percent ?? 0`
+> always produces `0%`. Use `ctx.cost?.totalUsd` and `ctx.model?.displayName`
+> (both populated by claude-code) instead.
+
+**v1: claude-code only.** Install registers `settings.json.statusLine` via the
+same configPatch ownership ledger — **set-if-absent, never clobbers a
+`statusLine` agent-connector doesn't own** (skip-warns and prints the manual
+edit instead), refcounted, reversible. Every other host adapter skip-warns at
+install time, never silently. The runtime is **fail-safe**: any error — a
+throwing `render`, unknown connector, malformed stdin — exits 0 with empty
+stdout so a HUD never wedges the host. `doctor` includes a dedicated
+`statusline wired` check.
+
+> `defineStatusline` is a typed identity helper and is optional — you can
+> pass the `{ render }` object directly to `statusline:`. Both
+> `StatuslineDef` and `StatuslineContext` are exported from
+> `@ken-jo/agent-connector`.
+
+### Actions (`defineAction`) — user-triggered dispatch
+
+Declare named, user-invocable operations on your connector:
+
+```ts
+import { defineConnector, defineAction } from "@ken-jo/agent-connector";
+
+export default defineConnector({
+  id: "acme-db",
+  // ...
+  actions: [
+    defineAction({
+      id: "flush-cache",
+      description: "Flush the acme-db query cache",
+      async run(ctx) {
+        // ctx is HostCtx — same context object as hooks
+        await flushCache();
+        return { message: "Cache flushed." };
+      },
+    }),
+  ],
+});
+```
+
+The **universal verb** runs any declared action from the shell (or from a
+script / IDE task):
+
+```bash
+agent-connector action <platform> flush-cache --connector acme-db
+```
+
+`run(ctx)` executes and its optional `{ message }` return is printed to
+stdout. **Error semantics are user-triggered**: an unknown action id or a
+throw exits 1 and writes to stderr (unlike hooks and statusline, which are
+fail-safe/silent on error).
+
+`defineAction` is a typed identity helper and is exported from both
+`@ken-jo/agent-connector` and `@ken-jo/agent-connector/sdk`.
+`ActionDef = { id, description?, run, hosts? }` and `ActionResult = { message? }`.
+
+**v1: dispatch backbone only.** `install` skip-warns on every host — there
+is no host affordance emitter yet (binding a slash-command or keybinding to
+the verb requires generated IDE extensions, a later phase). The `action`
+verb is fully functional today; host-side registration is deferred.
+`explain()` emits action rows (skip-warn everywhere in v1); `simulate()`
+does not cover actions (actions take no host payload and have no host-honor
+verdict — intentional).
+
 ## How it works (operating model)
 
 - **Home-dir, single binary.** The runtime installs once under

package/dist/action-PLZW5BGX.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import {
+  fail
+} from "./chunk-KGXDYGNJ.js";
+import {
+  runAction
+} from "./chunk-BHUCB6LY.js";
+import "./chunk-OP4KBXUO.js";
+import "./chunk-22Y24V7O.js";
+import "./chunk-J3D5W5T2.js";
+import "./chunk-CIRDOY2V.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
+import "./chunk-BXGFUENQ.js";
+import "./chunk-N6HH7K6P.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/action.ts
+import { parseArgs } from "util";
+async function run(argv) {
+  const { values, positionals } = parseArgs({
+    args: argv,
+    options: {
+      connector: { type: "string" }
+    },
+    allowPositionals: true
+  });
+  const platformId = positionals[0];
+  const actionId = positionals[1];
+  if (!platformId || !actionId) {
+    return fail("usage: agent-connector action <platform> <actionId> --connector <id>");
+  }
+  const connectorId = values.connector;
+  if (!connectorId || connectorId.trim() === "") {
+    return fail("action requires --connector <id>");
+  }
+  const reply = await runAction({ platformId, actionId, connectorId });
+  if (reply.stdout !== void 0 && reply.stdout !== "") {
+    process.stdout.write(reply.stdout.endsWith("\n") ? reply.stdout : `${reply.stdout}
+`);
+  }
+  if (reply.stderr !== void 0 && reply.stderr !== "") {
+    process.stderr.write(reply.stderr.endsWith("\n") ? reply.stderr : `${reply.stderr}
+`);
+  }
+  process.exit(reply.exitCode);
+}
+export {
+  run
+};
+//# sourceMappingURL=action-PLZW5BGX.js.map

package/dist/action-PLZW5BGX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/action.ts"],"sourcesContent":["/**\n * cli/commands/action — the universal user-invokable action entrypoint.\n *\n *   agent-connector action <platform> <actionId> --connector <id>\n *\n * A future host affordance (slash command / keybinding) points at the single\n * stable home binary (via core/spawn.buildHomeBinActionCommand). This command\n * parses the positionals + --connector, dispatches through runAction, writes any\n * stdout/stderr the action produced, and exits with its code. It reads NO stdin\n * (an action takes no host payload, unlike a hook or status line).\n *\n * USER-TRIGGERED is the runtime's contract: unlike the fail-open hook command,\n * an unknown action id or a throwing run surfaces as exit 1 + a stderr message —\n * the user invoked it deliberately, so the failure is shown, never swallowed.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { runAction } from \"../../runtime/index.js\";\nimport { fail } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    options: {\n      connector: { type: \"string\" },\n    },\n    allowPositionals: true,\n  });\n\n  const platformId = positionals[0];\n  const actionId = positionals[1];\n  if (!platformId || !actionId) {\n    return fail(\"usage: agent-connector action <platform> <actionId> --connector <id>\");\n  }\n  const connectorId = values.connector;\n  if (!connectorId || connectorId.trim() === \"\") {\n    return fail(\"action requires --connector <id>\");\n  }\n\n  const reply = await runAction({ platformId, actionId, connectorId });\n  if (reply.stdout !== undefined && reply.stdout !== \"\") {\n    process.stdout.write(reply.stdout.endsWith(\"\\n\") ? reply.stdout : `${reply.stdout}\\n`);\n  }\n  if (reply.stderr !== undefined && reply.stderr !== \"\") {\n    process.stderr.write(reply.stderr.endsWith(\"\\n\") ? reply.stderr : `${reply.stderr}\\n`);\n  }\n  process.exit(reply.exitCode);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgBA,SAAS,iBAAiB;AAK1B,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,IACxC,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,EAAE,MAAM,SAAS;AAAA,IAC9B;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,aAAa,YAAY,CAAC;AAChC,QAAM,WAAW,YAAY,CAAC;AAC9B,MAAI,CAAC,cAAc,CAAC,UAAU;AAC5B,WAAO,KAAK,sEAAsE;AAAA,EACpF;AACA,QAAM,cAAc,OAAO;AAC3B,MAAI,CAAC,eAAe,YAAY,KAAK,MAAM,IAAI;AAC7C,WAAO,KAAK,kCAAkC;AAAA,EAChD;AAEA,QAAM,QAAQ,MAAM,UAAU,EAAE,YAAY,UAAU,YAAY,CAAC;AACnE,MAAI,MAAM,WAAW,UAAa,MAAM,WAAW,IAAI;AACrD,YAAQ,OAAO,MAAM,MAAM,OAAO,SAAS,IAAI,IAAI,MAAM,SAAS,GAAG,MAAM,MAAM;AAAA,CAAI;AAAA,EACvF;AACA,MAAI,MAAM,WAAW,UAAa,MAAM,WAAW,IAAI;AACrD,YAAQ,OAAO,MAAM,MAAM,OAAO,SAAS,IAAI,IAAI,MAAM,SAAS,GAAG,MAAM,MAAM;AAAA,CAAI;AAAA,EACvF;AACA,UAAQ,KAAK,MAAM,QAAQ;AAC7B;","names":[]}

package/dist/{amp-YGV66GJT.js → amp-B524U6LO.js}

@@ -4,13 +4,15 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
-import "./chunk-7L6ITC4T.js";
+} from "./chunk-IW77FFNX.js";
+import {
+  renderSkillMd
+} from "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -41,7 +43,11 @@ var AmpAdapter = class extends BaseAdapter {
     canModifyOutput: false,
     canInjectSessionContext: false,
     // Amp registers stdio and Streamable HTTP MCP servers.
-    transports: ["stdio", "http"]
+    transports: ["stdio", "http"],
+    // Skills: Amp reads SKILL.md from ~/.config/agents/skills/<name>/SKILL.md
+    // (user) and <projectDir>/.agents/skills/<name>/SKILL.md (project) — a root
+    // OUTSIDE the config dir, so the skillDir() helper resolves it explicitly.
+    supportsSkills: true
   };
   // ── Detection ────────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
@@ -150,6 +156,76 @@ var AmpAdapter = class extends BaseAdapter {
   rewrite(value) {
     return rewriteEnvRefs(value, ampEnvToken);
   }
+  // ── Skills surface ───────────────────────────────────────────────────────
+  // CONTENT-ONLY: pure native-file writers under the skill root. No runtime
+  // dispatch, no home-bin pointer, no telemetry wrap. Idempotent (byte-identical
+  // → skip) via writeContentFile and reversible via removeContentFile. Honors
+  // platforms["amp"].skills === false to skip.
+  //
+  // QUIRK: the skill root is NOT under getConfigDir (~/.config/amp). Amp reads
+  // SKILL.md from the sibling cross-agent `agents` tree:
+  //   user scope    → ~/.config/agents/skills/<name>/SKILL.md
+  //   project scope → <projectDir>/.agents/skills/<name>/SKILL.md
+  // so skillDir() resolves it explicitly rather than reusing getConfigDir.
+  /** Skill root: user `~/.config/agents/skills`, project `<projectDir>/.agents/skills`. */
+  skillsDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".agents", "skills") : join(homedir(), ".config", "agents", "skills");
+  }
+  /** Native skill dir: <skillRoot>/<name>. */
+  skillDir(ctx, name) {
+    return join(this.skillsDir(ctx), name);
+  }
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for amp" }];
+    }
+    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 (delegates to the shared renderer). */
+  renderSkill(skill) {
+    return renderSkillMd(skill);
+  }
   // ── Hooks (unavailable — Amp is mcp-only) ────────────────────────────────
   installHooks(_ctx) {
     return [
@@ -221,4 +297,4 @@ export {
   adapter,
   amp_default as default
 };
-//# sourceMappingURL=amp-YGV66GJT.js.map
+//# sourceMappingURL=amp-B524U6LO.js.map

package/dist/amp-B524U6LO.js.map

@@ -0,0 +1 @@
+{"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 * Skills surface: Amp reads SKILL.md files (dir-per-skill, same shape as\n * claude-code) from a skill root that is NOT under the config dir\n * (`~/.config/amp`):\n *   - user scope    → ~/.config/agents/skills/<name>/SKILL.md  (the sibling\n *     cross-agent `agents` dir — `~/.config/amp/skills/` is also documented-native,\n *     but the `agents` root is the cross-agent standard we standardize on)\n *   - project scope → <projectDir>/.agents/skills/<name>/SKILL.md\n * Because that root differs from getConfigDir, skills use a dedicated skillDir()\n * helper rather than reusing getConfigDir.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, InstallContext } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookParadigm,\n  PlatformCapabilities,\n  PlatformId,\n  ServerDef,\n  SkillDef,\n  Transport,\n} from \"../../core/types.js\";\nimport { rewriteEnvRefs } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  isHomeBinHookCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\nimport { renderSkillMd } from \"../claude-code/render.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    // Skills: Amp reads SKILL.md from ~/.config/agents/skills/<name>/SKILL.md\n    // (user) and <projectDir>/.agents/skills/<name>/SKILL.md (project) — a root\n    // OUTSIDE the config dir, so the skillDir() helper resolves it explicitly.\n    supportsSkills: true,\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  // ── Skills surface ───────────────────────────────────────────────────────\n  // CONTENT-ONLY: pure native-file writers under the skill root. No runtime\n  // dispatch, no home-bin pointer, no telemetry wrap. Idempotent (byte-identical\n  // → skip) via writeContentFile and reversible via removeContentFile. Honors\n  // platforms[\"amp\"].skills === false to skip.\n  //\n  // QUIRK: the skill root is NOT under getConfigDir (~/.config/amp). Amp reads\n  // SKILL.md from the sibling cross-agent `agents` tree:\n  //   user scope    → ~/.config/agents/skills/<name>/SKILL.md\n  //   project scope → <projectDir>/.agents/skills/<name>/SKILL.md\n  // so skillDir() resolves it explicitly rather than reusing getConfigDir.\n\n  /** Skill root: user `~/.config/agents/skills`, project `<projectDir>/.agents/skills`. */\n  private skillsDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".agents\", \"skills\")\n      : join(homedir(), \".config\", \"agents\", \"skills\");\n  }\n\n  /** Native skill dir: <skillRoot>/<name>. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.skillsDir(ctx), name);\n  }\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for amp\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), this.renderSkill(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  /** Render a skill's SKILL.md (delegates to the shared renderer). */\n  private renderSkill(skill: SkillDef): string {\n    return renderSkillMd(skill);\n  }\n\n  // ── Hooks (unavailable — Amp is mcp-only) ────────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amp is mcp-only)\",\n      },\n    ];\n  }\n\n  uninstallHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amp is mcp-only)\",\n      },\n    ];\n  }\n\n  /**\n   * True when a hook command references our home binary AND this connector id\n   * (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand).\n   * Amp installs no hooks, but this guard keeps any future shared-file edit from\n   * removing another connector's entries.\n   */\n  private isOurCommand(command: string | undefined, ctx: InstallContext): boolean {\n    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const settingsPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    return [\n      {\n        name: `${this.name}: settings.json present`,\n        check: () =>\n          existsSync(settingsPath)\n            ? { status: \"OK\", detail: settingsPath }\n            : { status: \"FAIL\", detail: `not found: ${settingsPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          // Only assert what the connector declares: a server-less connector\n          // never writes a server entry, so its absence is healthy.\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(settingsPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no \"${MCP_ROOT_KEY}\" in ${settingsPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `\"${MCP_ROOT_KEY}\".${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no \"${MCP_ROOT_KEY}\".${connectorId} in ${settingsPath}`,\n              };\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Amp native interpolation token: `${env:VAR}` → `${VAR}`.\n *\n * When the portable ref carried a default (`${env:VAR:-fallback}`), Amp's native\n * `${VAR}` token has no way to express it — so a bare native token would silently\n * DROP the default. Instead, resolve the default at install time: emit the live\n * value when VAR is set and non-empty, else the literal fallback. The native\n * token is only emitted when there is no default to preserve.\n */\nfunction ampEnvToken(name: string, def?: string): string {\n  if (def !== undefined) {\n    const v = process.env[name];\n    return v != null && v !== \"\" ? v : def;\n  }\n  return `\\${${name}}`;\n}\n\nexport const adapter = new AmpAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/{antigravity-7IBYFO6P.js → antigravity-ANDKF3K7.js}

@@ -3,11 +3,11 @@ import {
   AntigravityAdapter,
   adapter,
   antigravity_default
-} from "./chunk-KQSNDFBN.js";
+} from "./chunk-LL4OBGRU.js";
 import "./chunk-DBQMX75U.js";
-import "./chunk-PD4VFEBY.js";
+import "./chunk-IW77FFNX.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 export {
@@ -15,4 +15,4 @@ export {
   adapter,
   antigravity_default as default
 };
-//# sourceMappingURL=antigravity-7IBYFO6P.js.map
+//# sourceMappingURL=antigravity-ANDKF3K7.js.map

package/dist/{antigravity-cli-JEOUP2VN.js → antigravity-cli-LLRPDDOT.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   AntigravityAdapter
-} from "./chunk-KQSNDFBN.js";
+} from "./chunk-LL4OBGRU.js";
 import "./chunk-DBQMX75U.js";
-import "./chunk-PD4VFEBY.js";
+import "./chunk-IW77FFNX.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -84,4 +84,4 @@ export {
   adapter,
   antigravity_cli_default as default
 };
-//# sourceMappingURL=antigravity-cli-JEOUP2VN.js.map
+//# sourceMappingURL=antigravity-cli-LLRPDDOT.js.map

package/dist/chunk-22Y24V7O.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import {
+  resolveSpawnCommand
+} from "./chunk-BXGFUENQ.js";
+
+// src/core/spawn-child.ts
+import { spawn } from "child_process";
+function winQuoteArg(s) {
+  return `"${s.replace(/"/g, '""')}"`;
+}
+function spawnChild(command, args, options) {
+  const resolved = resolveSpawnCommand(command);
+  if (!resolved.needsShell) return spawn(resolved.file, args, options);
+  const line = [resolved.file, ...args].map(winQuoteArg).join(" ");
+  return spawn(line, { ...options, shell: true });
+}
+
+export {
+  spawnChild
+};
+//# sourceMappingURL=chunk-22Y24V7O.js.map

package/dist/chunk-22Y24V7O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/spawn-child.ts"],"sourcesContent":["/**\n * core/spawn-child — the cross-platform child_process.spawn wrapper.\n *\n * Kept SEPARATE from core/spawn.ts (pure string/path helpers, imported widely\n * and early) so that pulling in `node:child_process` here does not perturb the\n * module-eval order of test suites that vi.mock(\"node:child_process\").\n */\n\nimport { type ChildProcess, type SpawnOptions, spawn } from \"node:child_process\";\n\nimport { resolveSpawnCommand } from \"./spawn.js\";\n\n/**\n * Quote one token for a cmd.exe command line: wrap in double quotes, doubling any\n * embedded double quote. Sufficient for the paths / package names / flags we\n * spawn (connector config, not untrusted end-user input) — we intentionally do\n * not escape cmd metacharacters (& | ^ %), which never appear in those tokens.\n */\nfunction winQuoteArg(s: string): string {\n  return `\"${s.replace(/\"/g, '\"\"')}\"`;\n}\n\n/**\n * Cross-platform child spawn that fixes native-Windows package-runner launches.\n * Direct spawn on macOS/Linux. On win32 it routes through\n * {@link resolveSpawnCommand}; an `.exe` runs directly, while a `.cmd`/`.bat`\n * (npx.cmd, the agent-connector.cmd launcher) is launched via a SINGLE quoted\n * command line with `shell: true` — a string rather than an args array, which\n * Node requires for a batch file AND which avoids the DEP0190 deprecation that\n * `shell: true` + an args array triggers on Node ≥ 24.\n */\nexport function spawnChild(\n  command: string,\n  args: string[],\n  options: SpawnOptions,\n): ChildProcess {\n  const resolved = resolveSpawnCommand(command);\n  if (!resolved.needsShell) return spawn(resolved.file, args, options);\n  const line = [resolved.file, ...args].map(winQuoteArg).join(\" \");\n  return spawn(line, { ...options, shell: true });\n}\n"],"mappings":";;;;;;AAQA,SAA+C,aAAa;AAU5D,SAAS,YAAY,GAAmB;AACtC,SAAO,IAAI,EAAE,QAAQ,MAAM,IAAI,CAAC;AAClC;AAWO,SAAS,WACd,SACA,MACA,SACc;AACd,QAAM,WAAW,oBAAoB,OAAO;AAC5C,MAAI,CAAC,SAAS,WAAY,QAAO,MAAM,SAAS,MAAM,MAAM,OAAO;AACnE,QAAM,OAAO,CAAC,SAAS,MAAM,GAAG,IAAI,EAAE,IAAI,WAAW,EAAE,KAAK,GAAG;AAC/D,SAAO,MAAM,MAAM,EAAE,GAAG,SAAS,OAAO,KAAK,CAAC;AAChD;","names":[]}