@ken-jo/agent-connector 0.3.1 → 0.4.1

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-35-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-1916%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: **35 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 |
+> | `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 · Continue |
+> | `mcp-only` (MCP registration only) | Warp · Roo Code · Cline · Trae · Zed · Amp · Codebuff · Mux · Pi · Amazon Q · Windsurf |
+> | `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.
+- **1874 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.
+> 35-adapter registry — there is no "install to all 35 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 35 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-WT7GVRCC.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import {
+  fail
+} from "./chunk-O5TWCIJN.js";
+import {
+  runAction
+} from "./chunk-5OWS5CMA.js";
+import "./chunk-OP4KBXUO.js";
+import "./chunk-F5RX62T7.js";
+import "./chunk-EGCBZ2DC.js";
+import "./chunk-2AVLX7GH.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-24IDL5RW.js";
+import "./chunk-4ENJK5S2.js";
+import "./chunk-DCKFYWGM.js";
+import "./chunk-FAHIMJRU.js";
+import "./chunk-I5MLE6S7.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-WT7GVRCC.js.map

package/dist/action-WT7GVRCC.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/amazon-q-COAL3764.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+import {
+  resolveEnvRefsDeep
+} from "./chunk-DBQMX75U.js";
+import {
+  BaseAdapter
+} from "./chunk-CPLK7GTE.js";
+import "./chunk-7L6ITC4T.js";
+import {
+  buildServeWrapperCommand,
+  shouldWrapForTelemetry
+} from "./chunk-I5MLE6S7.js";
+import "./chunk-N6HH7K6P.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/adapters/amazon-q/index.ts
+import { existsSync, statSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var HOST = "amazon-q";
+var MCP_ROOT_KEY = "mcpServers";
+var AmazonQAdapter = class extends BaseAdapter {
+  id = HOST;
+  name = "Amazon Q Developer CLI";
+  paradigm = "mcp-only";
+  capabilities = {
+    // Memory surface: WIRED. Amazon Q reads `.amazonq/rules` (NOT AGENTS.md), so
+    // the AGENTS.md-first BaseAdapter default does not apply — memoryTargets()
+    // below overrides it to write a DEDICATED agent-connector-owned file
+    // (<projectDir>/.amazonq/rules/agent-connector.md, plain Markdown, no
+    // frontmatter — auto-applied as context per the AWS docs). Project scope
+    // only; user scope skip-warns (no verified user/global rules dir).
+    supportsMemory: true,
+    //
+    // Amazon Q CLI: the hooks layer lives inside per-agent JSON files, not in
+    // the global/workspace mcp.json that AC targets. Every hook flag is false
+    // for this mcp-only adapter (hooks not wired into AC install yet).
+    preToolUse: false,
+    postToolUse: false,
+    preCompact: false,
+    sessionStart: false,
+    sessionEnd: false,
+    userPromptSubmit: false,
+    stop: false,
+    notification: false,
+    // No hook layer wired → no arg/output rewrite, no context injection.
+    canModifyArgs: false,
+    canModifyOutput: false,
+    canInjectSessionContext: false,
+    // Amazon Q registers stdio + Streamable HTTP MCP servers (primary-verified).
+    transports: ["stdio", "http"]
+    // Content surfaces: Amazon Q DOES have user-authored surfaces — agents
+    // (per-agent JSON in ~/.aws/amazonq/cli-agents/*.json or project
+    // .amazonq/cli-agents/*.json: name/description/prompt/tools/hooks/resources;
+    // agent-format.md) and a prompt library (~/.aws/amazonq/prompts/*.md). AC does
+    // not render either yet, so the supports* flags stay UNSET (base skip-warns) —
+    // a deferred wiring opportunity, NOT an absent surface.
+  };
+  // ── Detection ────────────────────────────────────────────────────────────
+  detectInstalled(projectDir) {
+    const userDir = join(homedir(), ".aws", "amazonq");
+    const userMcp = join(userDir, "mcp.json");
+    const projDir = join(projectDir, ".amazonq");
+    const projMcp = join(projDir, "mcp.json");
+    const userInstalled = existsSync(userDir) || existsSync(userMcp);
+    const projInstalled = existsSync(projDir) || existsSync(projMcp);
+    const installed = userInstalled || projInstalled;
+    const scope = projInstalled && !userInstalled ? "project" : "user";
+    const configPath = scope === "project" ? projMcp : userMcp;
+    return {
+      id: this.id,
+      name: this.name,
+      installed,
+      paradigm: this.paradigm,
+      capabilities: this.capabilities,
+      configPath,
+      scope,
+      reason: installed ? `found Amazon Q config (${scope}) at ${configPath}` : `no Amazon Q mcp.json at ${userDir} or ${projDir}`,
+      confidence: installed ? "high" : "low"
+    };
+  }
+  // ── Native paths ─────────────────────────────────────────────────────────
+  /**
+   * Config directory per scope. Amazon Q uses DIFFERENT basenames:
+   *   user:    ~/.aws/amazonq   (two segments — NOT a single dotDir)
+   *   project: <projectDir>/.amazonq
+   * This is the ONE deviation from droid/cursor's single-basename getConfigDir.
+   */
+  getConfigDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".amazonq") : join(homedir(), ".aws", "amazonq");
+  }
+  getServerConfigPath(ctx) {
+    return join(this.getConfigDir(ctx), "mcp.json");
+  }
+  /**
+   * Amazon Q has no separate hook file — hook config path aliases the MCP file
+   * so the generic doctor/backup helpers behave sensibly (roo-code idiom).
+   */
+  getHookConfigPath(ctx) {
+    return this.getServerConfigPath(ctx);
+  }
+  // ── Memory surface: the `.amazonq/rules` content tree ─────────────────────
+  // Amazon Q uses `.amazonq/rules` (NOT AGENTS.md) for its OWN project rules, so
+  // this override replaces the AGENTS.md base default entirely:
+  //   project → <projectDir>/.amazonq/rules/agent-connector.md  (DEDICATED file
+  //             AC owns; plain Markdown, auto-applied — no frontmatter needed)
+  //   user    → [] (no verified user/global rules dir → base installMemory
+  //             skip-warns rather than guessing a path the CLI may not read)
+  // When `.amazonq/rules` exists as a single FILE (not a directory) we must NOT
+  // create `.amazonq/rules/agent-connector.md` underneath it (that would throw
+  // ENOTDIR), so memoryTargets() returns [] and installMemory() emits a precise
+  // skip-warn rather than crashing (the cline `.clinerules`-is-a-file precedent).
+  memoryTargets(ctx) {
+    if (this.memoryOverride(ctx)?.path) return super.memoryTargets(ctx);
+    if (ctx.scope === "project") {
+      if (this.rulesDirIsFile(ctx.projectDir)) return [];
+      return [
+        {
+          path: join(ctx.projectDir, ".amazonq", "rules", "agent-connector.md"),
+          reason: "amazon-q project rules dir (.amazonq/rules; agent-connector-owned file)"
+        }
+      ];
+    }
+    return [];
+  }
+  /**
+   * Override installMemory ONLY to surface a precise warn when `.amazonq/rules`
+   * exists as a single FILE at project scope (so memoryTargets() returned []):
+   * we never write under it. All other behavior delegates to the base
+   * implementation (the cline `.clinerules`-is-a-file precedent).
+   */
+  installMemory(ctx) {
+    if (ctx.scope === "project" && !this.memoryOverride(ctx)?.path && (ctx.connector.memory ?? []).length > 0 && ctx.connector.platforms[this.id]?.memory !== false && this.rulesDirIsFile(ctx.projectDir)) {
+      return [
+        {
+          platform: this.id,
+          action: "warn",
+          path: join(ctx.projectDir, ".amazonq", "rules"),
+          detail: "existing .amazonq/rules is a file, not a directory; left untouched \u2014 convert it to a .amazonq/rules/ directory to receive agent-connector memory"
+        }
+      ];
+    }
+    return super.installMemory(ctx);
+  }
+  /** True when `<dir>/.amazonq/rules` exists and is a regular FILE (not a dir). */
+  rulesDirIsFile(dir) {
+    const p = join(dir, ".amazonq", "rules");
+    if (!existsSync(p)) return false;
+    try {
+      return statSync(p).isFile();
+    } catch {
+      return false;
+    }
+  }
+  // ── 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 amazon-q" : "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 Amazon Q'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 entry = {
+        command: resolveEnvRefsDeep(command)
+      };
+      if (args.length > 0) entry.args = resolveEnvRefsDeep(args);
+      const env = this.renderEnv(server.env);
+      if (env) entry.env = env;
+      if (server.timeoutMs !== void 0) entry.timeout = server.timeoutMs;
+      return entry;
+    }
+    return {
+      type: "http",
+      url: resolveEnvRefsDeep(server.url ?? "")
+    };
+  }
+  /**
+   * Render stdio env values. Amazon Q has no documented native interpolation
+   * token, so resolve `${env:VAR}` references to literals at install time.
+   */
+  renderEnv(env) {
+    if (!env || Object.keys(env).length === 0) return void 0;
+    return resolveEnvRefsDeep({ ...env });
+  }
+  // ── Hooks (unavailable — Amazon Q CLI is mcp-only in this adapter) ────────
+  installHooks(_ctx) {
+    return [
+      {
+        platform: this.id,
+        action: "skip",
+        detail: "hooks unavailable (Amazon Q CLI is mcp-only)"
+      }
+    ];
+  }
+  uninstallHooks(_ctx) {
+    return [
+      {
+        platform: this.id,
+        action: "skip",
+        detail: "hooks unavailable (Amazon Q CLI is mcp-only)"
+      }
+    ];
+  }
+  // ── Diagnostics ──────────────────────────────────────────────────────────
+  getHealthChecks(ctx) {
+    const mcpPath = this.getServerConfigPath(ctx);
+    const connectorId = ctx.connector.id;
+    return [
+      {
+        name: `${this.name}: mcp.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 AmazonQAdapter();
+var amazon_q_default = adapter;
+export {
+  AmazonQAdapter,
+  adapter,
+  amazon_q_default as default
+};
+//# sourceMappingURL=amazon-q-COAL3764.js.map

package/dist/amazon-q-COAL3764.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/amazon-q/index.ts"],"sourcesContent":["/**\n * adapters/amazon-q — Amazon Q Developer CLI platform adapter.\n *\n * Amazon Q Developer CLI (`q` / `qchat`) is an **mcp-only** host from\n * agent-connector's perspective. Although the agent JSON format exposes a\n * real hooks layer (agentSpawn / userPromptSubmit / preToolUse / postToolUse,\n * JSON-over-STDIN, exit-code 0/2 contract — primary-verified via\n * aws.github.io/amazon-q-developer-cli agent-format + hooks.md), the VERIFIED\n * CONTRACT classifies this adapter as mcp-only because the hook layer lives\n * inside per-agent JSON files (cli-agents/*.json), not in the global/workspace\n * mcp.json that AC targets for MCP registration. We install MCP entries only;\n * hook registration into agent files is a separate, unimplemented surface.\n *\n * MCP config (legacy files, primary-verified via AWS docs):\n *   - user scope    → ~/.aws/amazonq/mcp.json   (global; applies to all workspaces)\n *   - project scope → <projectDir>/.amazonq/mcp.json   (local workspace)\n *   Both are JSON, root key \"mcpServers\". Amazon Q reads BOTH when both exist\n *   and merges them (union); workspace wins on same-name conflict with a warning.\n *\n * Server entry shape (primary-verified):\n *   - stdio: { command: string; args?: string[]; env?: { [k: string]: string };\n *              timeout?: number }   (timeout in MILLISECONDS, e.g. 60000;\n *              transport inferred from presence of `command` — no `type` key)\n *   - http:  { type: \"http\"; url: string }\n *             (the remote/HTTP shape is written with an explicit `type: \"http\"`\n *              discriminator + `url`, per command-line-mcp-config-CLI.html. No\n *              `headers` field — Amazon Q remote auth is OAuth, not static\n *              headers — and no `disabled` flag.)\n *\n * Path resolution — NOTE the nested user scope:\n *   - user:    join(homedir(), \".aws\", \"amazonq\")  (two path segments)\n *   - project: join(projectDir, \".amazonq\")         (single dotDir, no .aws)\n *   homedir() handles USERPROFILE on Windows automatically; no manual branch.\n *\n * Env interpolation: Amazon Q has no documented native ${env:VAR} token;\n * resolve all references to literals at install time (the safe path, same as\n * droid/crush).\n *\n * Memory / rules (primary-verified — docs.aws.amazon.com context-project-rules):\n *   Project rules are plain Markdown files in <projectDir>/.amazonq/rules; Amazon\n *   Q \"will automatically use them as context whenever a developer chats with\n *   Amazon Q within your project\". NO frontmatter required. We write a DEDICATED\n *   agent-connector-owned file there (`.amazonq/rules/agent-connector.md`),\n *   mirroring the cline `.clinerules/agent-connector.md` approach: memoryTargets()\n *   points at the dedicated file and the base managed-block engine performs the\n *   surgical, hash-stamped, uninstall-reversible write. PROJECT SCOPE ONLY — the\n *   AWS docs do not cleanly document a user/global rules directory for the CLI\n *   (a `~/.aws/amazonq/.../rules` path is unverified), so user scope returns [] →\n *   the base installMemory skip-warns rather than writing into an unread path.\n *\n * Hook \"config path\" is aliased to the MCP file (no separate hook file) so the\n * base doctor/backup helpers behave sensibly.\n */\n\nimport { existsSync, statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, InstallContext, MemoryTarget } 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 = \"amazon-q\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/**\n * Native MCP server entry shapes Amazon Q accepts under `mcpServers`.\n *   - stdio: BARE shape — NO `type` discriminator and NO `disabled` flag; the\n *     transport is inferred from the presence of `command`. timeout is in\n *     MILLISECONDS (pass timeoutMs through unchanged, do NOT divide).\n *   - http: REMOTE shape — explicit `type: \"http\"` + `url`\n *     (command-line-mcp-config-CLI.html). NO `headers` (remote auth is OAuth,\n *     not static headers) and NO `disabled` flag.\n */\ninterface AmazonQStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  timeout?: number;\n}\ninterface AmazonQHttpServer {\n  type: \"http\";\n  url: string;\n}\n\nexport class AmazonQAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Amazon Q Developer CLI\";\n  readonly paradigm: HookParadigm = \"mcp-only\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: WIRED. Amazon Q reads `.amazonq/rules` (NOT AGENTS.md), so\n    // the AGENTS.md-first BaseAdapter default does not apply — memoryTargets()\n    // below overrides it to write a DEDICATED agent-connector-owned file\n    // (<projectDir>/.amazonq/rules/agent-connector.md, plain Markdown, no\n    // frontmatter — auto-applied as context per the AWS docs). Project scope\n    // only; user scope skip-warns (no verified user/global rules dir).\n    supportsMemory: true,\n    //\n    // Amazon Q CLI: the hooks layer lives inside per-agent JSON files, not in\n    // the global/workspace mcp.json that AC targets. Every hook flag is false\n    // for this mcp-only adapter (hooks not wired into AC install yet).\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 wired → no arg/output rewrite, no context injection.\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    // Amazon Q registers stdio + Streamable HTTP MCP servers (primary-verified).\n    transports: [\"stdio\", \"http\"],\n    // Content surfaces: Amazon Q DOES have user-authored surfaces — agents\n    // (per-agent JSON in ~/.aws/amazonq/cli-agents/*.json or project\n    // .amazonq/cli-agents/*.json: name/description/prompt/tools/hooks/resources;\n    // agent-format.md) and a prompt library (~/.aws/amazonq/prompts/*.md). AC does\n    // not render either yet, so the supports* flags stay UNSET (base skip-warns) —\n    // a deferred wiring opportunity, NOT an absent surface.\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".aws\", \"amazonq\");\n    const userMcp = join(userDir, \"mcp.json\");\n    const projDir = join(projectDir, \".amazonq\");\n    const projMcp = join(projDir, \"mcp.json\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userMcp);\n    const projInstalled = existsSync(projDir) || existsSync(projMcp);\n    const installed = userInstalled || projInstalled;\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projMcp : userMcp;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `found Amazon Q config (${scope}) at ${configPath}`\n        : `no Amazon Q mcp.json at ${userDir} or ${projDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  /**\n   * Config directory per scope. Amazon Q uses DIFFERENT basenames:\n   *   user:    ~/.aws/amazonq   (two segments — NOT a single dotDir)\n   *   project: <projectDir>/.amazonq\n   * This is the ONE deviation from droid/cursor's single-basename getConfigDir.\n   */\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".amazonq\")\n      : join(homedir(), \".aws\", \"amazonq\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp.json\");\n  }\n\n  /**\n   * Amazon Q has no separate hook file — hook config path aliases the MCP file\n   * so the generic doctor/backup helpers behave sensibly (roo-code idiom).\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  // ── Memory surface: the `.amazonq/rules` content tree ─────────────────────\n  // Amazon Q uses `.amazonq/rules` (NOT AGENTS.md) for its OWN project rules, so\n  // this override replaces the AGENTS.md base default entirely:\n  //   project → <projectDir>/.amazonq/rules/agent-connector.md  (DEDICATED file\n  //             AC owns; plain Markdown, auto-applied — no frontmatter needed)\n  //   user    → [] (no verified user/global rules dir → base installMemory\n  //             skip-warns rather than guessing a path the CLI may not read)\n  // When `.amazonq/rules` exists as a single FILE (not a directory) we must NOT\n  // create `.amazonq/rules/agent-connector.md` underneath it (that would throw\n  // ENOTDIR), so memoryTargets() returns [] and installMemory() emits a precise\n  // skip-warn rather than crashing (the cline `.clinerules`-is-a-file precedent).\n  protected override memoryTargets(ctx: InstallContext): MemoryTarget[] {\n    // An explicit platforms[amazon-q].memory.path override wins (escape hatch).\n    if (this.memoryOverride(ctx)?.path) return super.memoryTargets(ctx);\n    if (ctx.scope === \"project\") {\n      if (this.rulesDirIsFile(ctx.projectDir)) return [];\n      return [\n        {\n          path: join(ctx.projectDir, \".amazonq\", \"rules\", \"agent-connector.md\"),\n          reason: \"amazon-q project rules dir (.amazonq/rules; agent-connector-owned file)\",\n        },\n      ];\n    }\n    // user scope: no primary-verified user/global rules dir → [] → skip-warn.\n    return [];\n  }\n\n  /**\n   * Override installMemory ONLY to surface a precise warn when `.amazonq/rules`\n   * exists as a single FILE at project scope (so memoryTargets() returned []):\n   * we never write under it. All other behavior delegates to the base\n   * implementation (the cline `.clinerules`-is-a-file precedent).\n   */\n  override installMemory(ctx: InstallContext): ChangeRecord[] {\n    if (\n      ctx.scope === \"project\" &&\n      !this.memoryOverride(ctx)?.path &&\n      (ctx.connector.memory ?? []).length > 0 &&\n      ctx.connector.platforms[this.id]?.memory !== false &&\n      this.rulesDirIsFile(ctx.projectDir)\n    ) {\n      return [\n        {\n          platform: this.id,\n          action: \"warn\",\n          path: join(ctx.projectDir, \".amazonq\", \"rules\"),\n          detail:\n            \"existing .amazonq/rules is a file, not a directory; left untouched — \" +\n            \"convert it to a .amazonq/rules/ directory to receive agent-connector memory\",\n        },\n      ];\n    }\n    return super.installMemory(ctx);\n  }\n\n  /** True when `<dir>/.amazonq/rules` exists and is a regular FILE (not a dir). */\n  private rulesDirIsFile(dir: string): boolean {\n    const p = join(dir, \".amazonq\", \"rules\");\n    if (!existsSync(p)) return false;\n    try {\n      return statSync(p).isFile();\n    } catch {\n      return false;\n    }\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 amazon-q\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /** Render a normalized ServerDef into Amazon Q's native mcpServers entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): AmazonQStdioServer | AmazonQHttpServer {\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      // Amazon Q has no documented native interpolation token — resolve every\n      // ${env:VAR} to a literal at install time (safe path, matches droid/crush).\n      const entry: AmazonQStdioServer = {\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      // timeout: Amazon Q uses MILLISECONDS — pass timeoutMs through unchanged.\n      // Only emit when the connector explicitly sets one (do NOT invent a default).\n      if (server.timeoutMs !== undefined) entry.timeout = server.timeoutMs;\n      return entry;\n    }\n\n    // http (and any other remote transport) — Amazon Q registers a remote URL.\n    // REMOTE shape: { type: \"http\", url } — explicit `type` discriminator, NO\n    // `headers` (OAuth auth, not static headers), NO `disabled`.\n    return {\n      type: \"http\",\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n    };\n  }\n\n  /**\n   * Render stdio env values. Amazon Q has no documented native interpolation\n   * token, so resolve `${env:VAR}` references to literals at install time.\n   */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    return resolveEnvRefsDeep({ ...env });\n  }\n\n  // ── Hooks (unavailable — Amazon Q CLI is mcp-only in this adapter) ────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amazon Q CLI 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 (Amazon Q CLI 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.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 AmazonQAdapter();\nexport default adapter;\n"],"mappings":"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","names":[]}