@ken-jo/agent-connector 0.3.1 → 0.4.0

package/dist/chunk-3PFFTFCU.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+
+// src/adapters/registry.ts
+var ADAPTER_REGISTRY = [
+  {
+    id: "claude-code",
+    load: () => import("./claude-code-MLWS7CW6.js").then((m) => m.default)
+  },
+  {
+    id: "codex",
+    load: () => import("./codex-BXA4FIF4.js").then((m) => m.default)
+  },
+  {
+    id: "cursor",
+    load: () => import("./cursor-ASJPWZ4R.js").then((m) => m.default)
+  },
+  // vscode-copilot after cursor: cursor is a VS Code fork, so the fork's runtime
+  // markers must be checked first during host detection.
+  {
+    id: "vscode-copilot",
+    load: () => import("./vscode-copilot-ALV45XF6.js").then((m) => m.default)
+  },
+  {
+    id: "copilot-cli",
+    load: () => import("./copilot-cli-ROIBTTDT.js").then((m) => m.default)
+  },
+  {
+    id: "gemini-cli",
+    load: () => import("./gemini-cli-SLVWLXJW.js").then((m) => m.default)
+  },
+  {
+    id: "warp",
+    load: () => import("./warp-H6IX4U3J.js").then((m) => m.default)
+  },
+  // ts-plugin paradigm: OpenCode loads a generated plugin module that bridges
+  // its in-process events to the universal hook entrypoint.
+  {
+    id: "opencode",
+    load: () => import("./opencode-Q6KBSAKW.js").then((m) => m.default)
+  },
+  // mimo-code is Xiaomi's MiMoCode (@mimo-ai/cli, bin `mimo`) — an OpenCode FORK
+  // (ts-plugin, MCP root key "mcp", ~/.config/mimocode/mimocode.json). Grouped
+  // beside the OpenCode family whose config dialect + plugin contract it shares;
+  // detected via the DISTINCT ~/.config/mimocode dir, so there is no fork-ordering
+  // constraint vs opencode (no shared config file to disambiguate).
+  {
+    id: "mimo-code",
+    load: () => import("./mimo-code-IMM5YM3M.js").then((m) => m.default)
+  },
+  // kilo-cli is the SQLite-backed OpenCode FORK command-line product (ts-plugin,
+  // loads @kilocode/plugin modules registered in kilo.jsonc's "plugin" array;
+  // MCP root key "mcp", ~/.config/kilo/kilo.jsonc). Grouped beside the OpenCode
+  // family whose plugin contract + config dialect it shares; distinct host from
+  // the "kilo" extension so there is no fork-ordering constraint between them.
+  {
+    id: "kilo-cli",
+    load: () => import("./kilo-cli-3HWPWBY4.js").then((m) => m.default)
+  },
+  // Wave 1 — mcp-only adapters (no lifecycle hooks; MCP registration only).
+  {
+    id: "droid",
+    load: () => import("./droid-NCSS3B5Y.js").then((m) => m.default)
+  },
+  {
+    id: "roo-code",
+    load: () => import("./roo-code-GWSNU3OW.js").then((m) => m.default)
+  },
+  // kilo is the Kilo Code VS Code extension (kilocode.kilo-code) — a Roo/Cline
+  // fork, so it sits beside roo-code (mcp-only, root key "mcpServers", VS Code
+  // globalStorage / .kilocode project scope). Distinct host from "kilo-cli".
+  {
+    id: "kilo",
+    load: () => import("./kilo-F3ZDZKCT.js").then((m) => m.default)
+  },
+  {
+    id: "trae",
+    load: () => import("./trae-NWT3TMSZ.js").then((m) => m.default)
+  },
+  // antigravity-cli BEFORE antigravity: the `agy` CLI is a fork of the IDE
+  // adapter with its own runtime markers (the universal hook command tags the
+  // host as "antigravity-cli"), so the more-specific CLI marker must be checked
+  // before the IDE/parent during host detection.
+  {
+    id: "antigravity-cli",
+    load: () => import("./antigravity-cli-LLRPDDOT.js").then((m) => m.default)
+  },
+  {
+    id: "antigravity",
+    load: () => import("./antigravity-ANDKF3K7.js").then((m) => m.default)
+  },
+  {
+    id: "zed",
+    load: () => import("./zed-RH34TNSW.js").then((m) => m.default)
+  },
+  {
+    id: "amp",
+    load: () => import("./amp-B524U6LO.js").then((m) => m.default)
+  },
+  {
+    id: "codebuff",
+    load: () => import("./codebuff-SH2S3QAN.js").then((m) => m.default)
+  },
+  {
+    id: "mux",
+    load: () => import("./mux-DSSH4AFS.js").then((m) => m.default)
+  },
+  // Pi — mcp-only host with no writable MCP config; drives the Agent Skills
+  // surface only (writes <piDir>/skills/<name>/SKILL.md).
+  {
+    id: "pi",
+    load: () => import("./pi-LZT6WWAZ.js").then((m) => m.default)
+  },
+  // Wave 2 — json-stdio adapters (full hook dispatch via the universal entrypoint).
+  // jetbrains-copilot before vscode-copilot is unnecessary (distinct hosts); grouped here.
+  {
+    id: "jetbrains-copilot",
+    load: () => import("./jetbrains-copilot-YABZ3HFA.js").then((m) => m.default)
+  },
+  {
+    id: "qwen-code",
+    load: () => import("./qwen-code-WQBKRPWJ.js").then((m) => m.default)
+  },
+  {
+    id: "kiro",
+    load: () => import("./kiro-C5W6AGDR.js").then((m) => m.default)
+  },
+  {
+    id: "kimi",
+    load: () => import("./kimi-NV72FVAO.js").then((m) => m.default)
+  },
+  {
+    id: "crush",
+    load: () => import("./crush-QLEFLHUC.js").then((m) => m.default)
+  },
+  // Wave 3 — json-stdio adapters with YAML config (MCP in YAML; hooks per host).
+  {
+    id: "goose",
+    load: () => import("./goose-PBA7KTE5.js").then((m) => m.default)
+  },
+  {
+    id: "hermes",
+    load: () => import("./hermes-ONDCECP2.js").then((m) => m.default)
+  },
+  // Wave 4 — ts-plugin adapters (generate a bridge module to the universal entrypoint).
+  {
+    id: "omp",
+    load: () => import("./omp-Z6FRNDPN.js").then((m) => m.default)
+  },
+  // nemoclaw BEFORE openclaw (fork-before-parent convention). NVIDIA NemoClaw
+  // wraps OpenClaw and DRIVES the SAME ~/.openclaw/openclaw.json, so a NemoClaw
+  // box carries BOTH the ~/.nemoclaw/ and ~/.openclaw/ markers. Exclusivity is
+  // enforced at the SOURCE: OpenClawAdapter.detectInstalled BOWS OUT when
+  // ~/.nemoclaw/ is present, so the shared config is never double-targeted as two
+  // platforms. This ordering is the deterministic tie-break (matching the
+  // antigravity-cli/antigravity precedent). nemoclaw extends OpenClawAdapter
+  // (id/name/detection overridden), so inherited server/hook registration still
+  // lands in the wrapped openclaw.json.
+  {
+    id: "nemoclaw",
+    load: () => import("./nemoclaw-3EVNKD3I.js").then((m) => m.default)
+  },
+  {
+    id: "openclaw",
+    load: () => import("./openclaw-7G437NT7.js").then((m) => m.default)
+  }
+];
+var REGISTRY_BY_ID = new Map(
+  ADAPTER_REGISTRY.map((factory) => [factory.id, factory])
+);
+var REGISTERED_PLATFORM_IDS = new Set(
+  ADAPTER_REGISTRY.map((factory) => factory.id)
+);
+function getFactory(id) {
+  return REGISTRY_BY_ID.get(id);
+}
+async function loadAdapter(id) {
+  const factory = getFactory(id);
+  return factory ? factory.load() : void 0;
+}
+async function allAdapters() {
+  return Promise.all(ADAPTER_REGISTRY.map((factory) => factory.load()));
+}
+
+export {
+  ADAPTER_REGISTRY,
+  REGISTERED_PLATFORM_IDS,
+  loadAdapter,
+  allAdapters
+};
+//# sourceMappingURL=chunk-3PFFTFCU.js.map

package/dist/chunk-3PFFTFCU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/registry.ts"],"sourcesContent":["/**\n * adapters/registry — single source of truth for the platforms agent-connector\n * targets. Generalized from context-mode's `ADAPTER_REGISTRY` pattern, adapted\n * to our `Adapter` / `AdapterFactory` contract (adapters/spi.ts).\n *\n * In context-mode the same platform set was redeclared in four places (env-var\n * detection, session-dir lookup, the lazy adapter loader, and per-adapter base\n * constructors); adding a platform meant editing all of them and missing one\n * was silent. Here the list lives ONCE below: each platform is one entry with a\n * lazy `load()` thunk that resolves the adapter singleton. Adding a platform is\n * a single new entry — `getFactory` / `loadAdapter` / `allAdapters` and the\n * detection cascade in detect.ts all derive from this list.\n *\n * `load()` returns the module's default export, which every adapter file is\n * required to provide as its singleton (`export default adapter;`). It is a\n * function (not an eager import) so module loading stays lazy: an adapter is\n * only imported when it is actually needed, keeping startup cheap.\n *\n * Order is load-bearing for runtime host detection (detect.ts iterates env\n * markers in registry order): forks MUST precede their parent so a session\n * running inside a derived shell is not misclassified as the parent. For the\n * three Phase-1 adapters this is moot, but the ordering convention is fixed now\n * so later additions (cursor is a VS Code fork, etc.) slot in correctly.\n */\n\nimport type { PlatformId } from \"../core/types.js\";\nimport type { Adapter, AdapterFactory } from \"./spi.js\";\n\n/**\n * Authoritative list of installable platforms. One entry per platform; the\n * `load` thunk lazily imports the adapter module and returns its default-export\n * singleton. To add a platform: drop its `src/adapters/<id>/index.ts` in place\n * (default-exporting an `Adapter`) and add one entry here.\n */\nexport const ADAPTER_REGISTRY: readonly AdapterFactory[] = [\n  {\n    id: \"claude-code\",\n    load: () => import(\"./claude-code/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"codex\",\n    load: () => import(\"./codex/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"cursor\",\n    load: () => import(\"./cursor/index.js\").then((m) => m.default),\n  },\n  // vscode-copilot after cursor: cursor is a VS Code fork, so the fork's runtime\n  // markers must be checked first during host detection.\n  {\n    id: \"vscode-copilot\",\n    load: () => import(\"./vscode-copilot/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"copilot-cli\",\n    load: () => import(\"./copilot-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"gemini-cli\",\n    load: () => import(\"./gemini-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"warp\",\n    load: () => import(\"./warp/index.js\").then((m) => m.default),\n  },\n  // ts-plugin paradigm: OpenCode loads a generated plugin module that bridges\n  // its in-process events to the universal hook entrypoint.\n  {\n    id: \"opencode\",\n    load: () => import(\"./opencode/index.js\").then((m) => m.default),\n  },\n  // mimo-code is Xiaomi's MiMoCode (@mimo-ai/cli, bin `mimo`) — an OpenCode FORK\n  // (ts-plugin, MCP root key \"mcp\", ~/.config/mimocode/mimocode.json). Grouped\n  // beside the OpenCode family whose config dialect + plugin contract it shares;\n  // detected via the DISTINCT ~/.config/mimocode dir, so there is no fork-ordering\n  // constraint vs opencode (no shared config file to disambiguate).\n  {\n    id: \"mimo-code\",\n    load: () => import(\"./mimo-code/index.js\").then((m) => m.default),\n  },\n  // kilo-cli is the SQLite-backed OpenCode FORK command-line product (ts-plugin,\n  // loads @kilocode/plugin modules registered in kilo.jsonc's \"plugin\" array;\n  // MCP root key \"mcp\", ~/.config/kilo/kilo.jsonc). Grouped beside the OpenCode\n  // family whose plugin contract + config dialect it shares; distinct host from\n  // the \"kilo\" extension so there is no fork-ordering constraint between them.\n  {\n    id: \"kilo-cli\",\n    load: () => import(\"./kilo-cli/index.js\").then((m) => m.default),\n  },\n  // Wave 1 — mcp-only adapters (no lifecycle hooks; MCP registration only).\n  {\n    id: \"droid\",\n    load: () => import(\"./droid/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"roo-code\",\n    load: () => import(\"./roo-code/index.js\").then((m) => m.default),\n  },\n  // kilo is the Kilo Code VS Code extension (kilocode.kilo-code) — a Roo/Cline\n  // fork, so it sits beside roo-code (mcp-only, root key \"mcpServers\", VS Code\n  // globalStorage / .kilocode project scope). Distinct host from \"kilo-cli\".\n  {\n    id: \"kilo\",\n    load: () => import(\"./kilo/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"trae\",\n    load: () => import(\"./trae/index.js\").then((m) => m.default),\n  },\n  // antigravity-cli BEFORE antigravity: the `agy` CLI is a fork of the IDE\n  // adapter with its own runtime markers (the universal hook command tags the\n  // host as \"antigravity-cli\"), so the more-specific CLI marker must be checked\n  // before the IDE/parent during host detection.\n  {\n    id: \"antigravity-cli\",\n    load: () => import(\"./antigravity-cli/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"antigravity\",\n    load: () => import(\"./antigravity/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"zed\",\n    load: () => import(\"./zed/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"amp\",\n    load: () => import(\"./amp/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"codebuff\",\n    load: () => import(\"./codebuff/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"mux\",\n    load: () => import(\"./mux/index.js\").then((m) => m.default),\n  },\n  // Pi — mcp-only host with no writable MCP config; drives the Agent Skills\n  // surface only (writes <piDir>/skills/<name>/SKILL.md).\n  {\n    id: \"pi\",\n    load: () => import(\"./pi/index.js\").then((m) => m.default),\n  },\n  // Wave 2 — json-stdio adapters (full hook dispatch via the universal entrypoint).\n  // jetbrains-copilot before vscode-copilot is unnecessary (distinct hosts); grouped here.\n  {\n    id: \"jetbrains-copilot\",\n    load: () => import(\"./jetbrains-copilot/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"qwen-code\",\n    load: () => import(\"./qwen-code/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"kiro\",\n    load: () => import(\"./kiro/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"kimi\",\n    load: () => import(\"./kimi/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"crush\",\n    load: () => import(\"./crush/index.js\").then((m) => m.default),\n  },\n  // Wave 3 — json-stdio adapters with YAML config (MCP in YAML; hooks per host).\n  {\n    id: \"goose\",\n    load: () => import(\"./goose/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"hermes\",\n    load: () => import(\"./hermes/index.js\").then((m) => m.default),\n  },\n  // Wave 4 — ts-plugin adapters (generate a bridge module to the universal entrypoint).\n  {\n    id: \"omp\",\n    load: () => import(\"./omp/index.js\").then((m) => m.default),\n  },\n  // nemoclaw BEFORE openclaw (fork-before-parent convention). NVIDIA NemoClaw\n  // wraps OpenClaw and DRIVES the SAME ~/.openclaw/openclaw.json, so a NemoClaw\n  // box carries BOTH the ~/.nemoclaw/ and ~/.openclaw/ markers. Exclusivity is\n  // enforced at the SOURCE: OpenClawAdapter.detectInstalled BOWS OUT when\n  // ~/.nemoclaw/ is present, so the shared config is never double-targeted as two\n  // platforms. This ordering is the deterministic tie-break (matching the\n  // antigravity-cli/antigravity precedent). nemoclaw extends OpenClawAdapter\n  // (id/name/detection overridden), so inherited server/hook registration still\n  // lands in the wrapped openclaw.json.\n  {\n    id: \"nemoclaw\",\n    load: () => import(\"./nemoclaw/index.js\").then((m) => m.default),\n  },\n  {\n    id: \"openclaw\",\n    load: () => import(\"./openclaw/index.js\").then((m) => m.default),\n  },\n];\n\n/** O(1) lookup index, built once at module-load time. */\nconst REGISTRY_BY_ID: ReadonlyMap<PlatformId, AdapterFactory> = new Map(\n  ADAPTER_REGISTRY.map((factory) => [factory.id, factory] as const),\n);\n\n/** Every platform id present in the registry (useful for matrix tests). */\nexport const REGISTERED_PLATFORM_IDS: ReadonlySet<PlatformId> = new Set(\n  ADAPTER_REGISTRY.map((factory) => factory.id),\n);\n\n/**\n * Look up the lazy factory for a platform id. Returns `undefined` for ids that\n * are not registered (including `\"unknown\"` and typos) so callers can fall back\n * deliberately rather than crash.\n */\nexport function getFactory(id: PlatformId | string): AdapterFactory | undefined {\n  return REGISTRY_BY_ID.get(id as PlatformId);\n}\n\n/**\n * Resolve a platform id to its adapter singleton. Returns `undefined` when the\n * id is not registered — callers decide whether to skip or fall back.\n */\nexport async function loadAdapter(id: PlatformId | string): Promise<Adapter | undefined> {\n  const factory = getFactory(id);\n  return factory ? factory.load() : undefined;\n}\n\n/**\n * Load every registered adapter. Imports run in parallel; the result preserves\n * registry order so downstream detection/install logic sees forks before\n * parents.\n */\nexport async function allAdapters(): Promise<Adapter[]> {\n  return Promise.all(ADAPTER_REGISTRY.map((factory) => factory.load()));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-SCVBYSF7.js → chunk-6XHB6BE3.js}

@@ -354,4 +354,4 @@ export {
   hostLeaderboard,
   formatHostLeaderboard
 };
-//# sourceMappingURL=chunk-SCVBYSF7.js.map
+//# sourceMappingURL=chunk-6XHB6BE3.js.map

package/dist/chunk-76FUSVIA.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import {
+  allAdapters,
+  loadAdapter
+} from "./chunk-3PFFTFCU.js";
+
+// src/sdk/introspect.ts
+var SURFACE_PREDICATES = {
+  server: (c) => c.transports.length > 0,
+  hooks: (c) => c.sessionStart || c.preToolUse || c.postToolUse || c.userPromptSubmit || c.stop || c.sessionEnd || c.preCompact || c.notification || (c.permissionRequest ?? false) || (c.postToolUseFailure ?? false) || (c.subagentStart ?? false) || (c.subagentStop ?? false),
+  commands: (c) => c.supportsCommands ?? false,
+  skills: (c) => c.supportsSkills ?? false,
+  subagents: (c) => c.supportsSubagents ?? false,
+  memory: (c) => c.supportsMemory ?? false,
+  statusline: (c) => c.supportsStatusline ?? false,
+  // v1: no adapter sets supportsActions (no affordance emitter yet), so this is
+  // false everywhere and explain() marks actions skip-warn on every host — the
+  // honest state until the affordance emitter ships.
+  actions: (c) => c.supportsActions ?? false,
+  configPatch: (c) => c.supportsConfigPatch ?? false,
+  nativeHooks: (c) => c.supportsNativeHooks ?? false
+};
+async function capabilitiesOf(host) {
+  const adapter = await loadAdapter(host);
+  return adapter?.capabilities;
+}
+async function hostsSupporting(surface) {
+  const predicate = SURFACE_PREDICATES[surface];
+  const adapters = await allAdapters();
+  return adapters.filter((adapter) => predicate(adapter.capabilities)).map((adapter) => adapter.id).sort();
+}
+async function surfaceSupport(host, surface) {
+  const capabilities = await capabilitiesOf(host);
+  return capabilities ? SURFACE_PREDICATES[surface](capabilities) : false;
+}
+
+export {
+  SURFACE_PREDICATES,
+  capabilitiesOf,
+  hostsSupporting,
+  surfaceSupport
+};
+//# sourceMappingURL=chunk-76FUSVIA.js.map

package/dist/chunk-76FUSVIA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk/introspect.ts"],"sourcesContent":["/**\n * sdk/introspect — host-capability introspection over the adapter registry.\n *\n * A thin, READ-ONLY query layer above {@link loadAdapter} / {@link allAdapters}:\n * \"which hosts can honor surface X?\" and \"what can host Y do?\". It exists so a\n * connector author (or a docs/CLI surface) can answer those questions WITHOUT\n * reaching into adapter internals or re-deriving the per-surface capability\n * rules — the predicates below are the single source of truth for mapping the\n * raw {@link PlatformCapabilities} flags onto the developer-facing surface names.\n *\n * Everything is async because adapters load lazily (one entry per platform in\n * the registry, imported only when queried).\n */\n\nimport type { PlatformCapabilities, PlatformId } from \"../core/types.js\";\nimport { allAdapters, loadAdapter } from \"../adapters/registry.js\";\n\n/**\n * The developer-facing surface names a connector can declare. These mirror the\n * top-level {@link import(\"../core/types.js\").ConnectorConfig} keys (server,\n * hooks, commands, …) plus the platform-scoped `configPatch` / `nativeHooks`\n * escape hatches — the same vocabulary the install diff and `explain` use.\n */\nexport type SurfaceName =\n  | \"server\"\n  | \"hooks\"\n  | \"commands\"\n  | \"skills\"\n  | \"subagents\"\n  | \"memory\"\n  | \"statusline\"\n  | \"actions\"\n  | \"configPatch\"\n  | \"nativeHooks\";\n\n/**\n * Pure capability predicate per surface — `true` when the host can NATIVELY\n * honor that surface. The optional capability flags are read as `?? false`\n * (the supportsCommands precedent in core/types), so a host that simply leaves\n * a flag unset reports the surface as unsupported (the installer skip-warns it).\n *\n * `hooks` is satisfied by ANY normalized hook event (i.e. the host has at least\n * one event it can dispatch); the per-event flags map 1:1 onto the\n * {@link import(\"../core/types.js\").HookEventName} union.\n */\nexport const SURFACE_PREDICATES: Record<\n  SurfaceName,\n  (c: PlatformCapabilities) => boolean\n> = {\n  server: (c) => c.transports.length > 0,\n  hooks: (c) =>\n    c.sessionStart ||\n    c.preToolUse ||\n    c.postToolUse ||\n    c.userPromptSubmit ||\n    c.stop ||\n    c.sessionEnd ||\n    c.preCompact ||\n    c.notification ||\n    (c.permissionRequest ?? false) ||\n    (c.postToolUseFailure ?? false) ||\n    (c.subagentStart ?? false) ||\n    (c.subagentStop ?? false),\n  commands: (c) => c.supportsCommands ?? false,\n  skills: (c) => c.supportsSkills ?? false,\n  subagents: (c) => c.supportsSubagents ?? false,\n  memory: (c) => c.supportsMemory ?? false,\n  statusline: (c) => c.supportsStatusline ?? false,\n  // v1: no adapter sets supportsActions (no affordance emitter yet), so this is\n  // false everywhere and explain() marks actions skip-warn on every host — the\n  // honest state until the affordance emitter ships.\n  actions: (c) => c.supportsActions ?? false,\n  configPatch: (c) => c.supportsConfigPatch ?? false,\n  nativeHooks: (c) => c.supportsNativeHooks ?? false,\n};\n\n/**\n * The {@link PlatformCapabilities} a host advertises, or `undefined` for an id\n * that is not in the registry (`\"unknown\"`, a usage-only id like `\"synthetic\"`,\n * or a typo) — callers branch on undefined rather than crash.\n */\nexport async function capabilitiesOf(\n  host: PlatformId | string,\n): Promise<PlatformCapabilities | undefined> {\n  const adapter = await loadAdapter(host);\n  return adapter?.capabilities;\n}\n\n/**\n * Every registered host that can NATIVELY honor `surface`, as a sorted id list\n * (stable output for snapshots/docs). Loads all adapters in parallel and keeps\n * only those whose capabilities pass {@link SURFACE_PREDICATES}.\n */\nexport async function hostsSupporting(surface: SurfaceName): Promise<PlatformId[]> {\n  const predicate = SURFACE_PREDICATES[surface];\n  const adapters = await allAdapters();\n  return adapters\n    .filter((adapter) => predicate(adapter.capabilities))\n    .map((adapter) => adapter.id)\n    .sort();\n}\n\n/**\n * Convenience: does `host` natively support `surface`? `false` for an unknown\n * id (no capabilities → cannot support anything).\n */\nexport async function surfaceSupport(\n  host: PlatformId | string,\n  surface: SurfaceName,\n): Promise<boolean> {\n  const capabilities = await capabilitiesOf(host);\n  return capabilities ? SURFACE_PREDICATES[surface](capabilities) : false;\n}\n"],"mappings":";;;;;;;AA6CO,IAAM,qBAGT;AAAA,EACF,QAAQ,CAAC,MAAM,EAAE,WAAW,SAAS;AAAA,EACrC,OAAO,CAAC,MACN,EAAE,gBACF,EAAE,cACF,EAAE,eACF,EAAE,oBACF,EAAE,QACF,EAAE,cACF,EAAE,cACF,EAAE,iBACD,EAAE,qBAAqB,WACvB,EAAE,sBAAsB,WACxB,EAAE,iBAAiB,WACnB,EAAE,gBAAgB;AAAA,EACrB,UAAU,CAAC,MAAM,EAAE,oBAAoB;AAAA,EACvC,QAAQ,CAAC,MAAM,EAAE,kBAAkB;AAAA,EACnC,WAAW,CAAC,MAAM,EAAE,qBAAqB;AAAA,EACzC,QAAQ,CAAC,MAAM,EAAE,kBAAkB;AAAA,EACnC,YAAY,CAAC,MAAM,EAAE,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAI3C,SAAS,CAAC,MAAM,EAAE,mBAAmB;AAAA,EACrC,aAAa,CAAC,MAAM,EAAE,uBAAuB;AAAA,EAC7C,aAAa,CAAC,MAAM,EAAE,uBAAuB;AAC/C;AAOA,eAAsB,eACpB,MAC2C;AAC3C,QAAM,UAAU,MAAM,YAAY,IAAI;AACtC,SAAO,SAAS;AAClB;AAOA,eAAsB,gBAAgB,SAA6C;AACjF,QAAM,YAAY,mBAAmB,OAAO;AAC5C,QAAM,WAAW,MAAM,YAAY;AACnC,SAAO,SACJ,OAAO,CAAC,YAAY,UAAU,QAAQ,YAAY,CAAC,EACnD,IAAI,CAAC,YAAY,QAAQ,EAAE,EAC3B,KAAK;AACV;AAMA,eAAsB,eACpB,MACA,SACkB;AAClB,QAAM,eAAe,MAAM,eAAe,IAAI;AAC9C,SAAO,eAAe,mBAAmB,OAAO,EAAE,YAAY,IAAI;AACpE;","names":[]}

package/dist/{chunk-GSGDG2BV.js → chunk-ADTHT2FN.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  REGISTERED_PLATFORM_IDS
+} from "./chunk-3PFFTFCU.js";
 import {
   MANAGED_BLOCK_BEGIN_TOKEN,
   MANAGED_BLOCK_END_TOKEN,
@@ -49,6 +52,9 @@ function configPatchNamespaceViolation(key) {
   if (head === "mcpServers" || head === "enableAllProjectMcpServers" || head === "enabledMcpjsonServers" || head === "disabledMcpjsonServers") {
     return `"${key}" targets MCP server registration agent-connector already models; declare it via \`server\` / \`platforms.<id>.server\` / \`extra\` instead`;
   }
+  if (head === "statusLine") {
+    return `"${key}" is modeled by the statusline surface; declare it via \`statusline: { render }\` instead`;
+  }
   return null;
 }
 function configPatchManualEdit(patch) {
@@ -228,15 +234,17 @@ function defineConnector(config) {
   const hasSkills = Array.isArray(config.skills) && config.skills.length > 0;
   const hasSubagents = Array.isArray(config.subagents) && config.subagents.length > 0;
   const hasMemory = Array.isArray(config.memory) && config.memory.length > 0;
+  const hasStatusline = config.statusline != null;
+  const hasActions = Array.isArray(config.actions) && config.actions.length > 0;
   const hasNativeHooks = Object.values(config.platforms ?? {}).some(
     (override) => override?.nativeHooks != null && Object.keys(override.nativeHooks).length > 0
   );
   const hasConfigPatch = Object.values(config.platforms ?? {}).some(
     (override) => Array.isArray(override?.configPatch) && override.configPatch.length > 0
   );
-  if (!config.server && !config.hooks && !hasCommands && !hasSkills && !hasSubagents && !hasMemory && !hasNativeHooks && !hasConfigPatch) {
+  if (!config.server && !config.hooks && !hasCommands && !hasSkills && !hasSubagents && !hasMemory && !hasStatusline && !hasActions && !hasNativeHooks && !hasConfigPatch) {
     throw new ConnectorConfigError(
-      "a connector must declare at least one of `server`, `hooks`, `commands`, `skills`, `subagents`, `memory`, or a per-platform `nativeHooks` / `configPatch` declaration"
+      "a connector must declare at least one of `server`, `hooks`, `commands`, `skills`, `subagents`, `memory`, `statusline`, `actions`, or a per-platform `nativeHooks` / `configPatch` declaration"
     );
   }
   if (config.server) {
@@ -261,6 +269,7 @@ function defineConnector(config) {
       if (def != null && typeof def.handler !== "function") {
         throw new ConnectorConfigError(`hooks.${ev}.handler must be a function`);
       }
+      validateHostsMap(def?.hosts, `hooks.${ev}.hosts`, "handler");
     }
   }
   validateNativeHooks(config.platforms);
@@ -269,6 +278,8 @@ function defineConnector(config) {
   const skills = normalizeSkills(config.skills);
   const subagents = normalizeSubagents(config.subagents);
   const memory = normalizeMemory(config.memory);
+  const statusline = normalizeStatusline(config.statusline);
+  const actions = normalizeActions(config.actions);
   const t = config.telemetry ?? {};
   const resolved = {
     id: config.id,
@@ -293,6 +304,8 @@ function defineConnector(config) {
     skills,
     subagents,
     memory,
+    ...statusline ? { statusline } : {},
+    actions,
     platforms: config.platforms ?? {},
     targets: config.targets ?? "auto",
     ...config.publish ? { publish: normalizePublish(config.publish) } : {}
@@ -300,6 +313,27 @@ function defineConnector(config) {
   return resolved;
 }
 var NORMALIZED_EVENT_SET = new Set(ALL_EVENTS);
+function validateHostsMap(map, surfaceLabel, implField) {
+  if (map == null) return;
+  if (typeof map !== "object" || Array.isArray(map)) {
+    throw new ConnectorConfigError(
+      `${surfaceLabel} must be an object keyed by platform id`
+    );
+  }
+  for (const [platformId, entry] of Object.entries(map)) {
+    if (!REGISTERED_PLATFORM_IDS.has(platformId)) {
+      const valid = [...REGISTERED_PLATFORM_IDS].sort().join(", ");
+      throw new ConnectorConfigError(
+        `unknown platform id "${platformId}" in hosts map for ${surfaceLabel}; valid ids: ${valid}`
+      );
+    }
+    if (entry == null || typeof entry !== "object" || typeof entry[implField] !== "function") {
+      throw new ConnectorConfigError(
+        `${surfaceLabel}.${platformId}.${implField} must be a function`
+      );
+    }
+  }
+}
 function validateNativeHooks(platforms) {
   if (platforms == null) return;
   for (const [platformId, override] of Object.entries(platforms)) {
@@ -394,10 +428,10 @@ function normalizePublish(publish) {
   }
   return { ...publish };
 }
-function assertSurfaceName(surface, name, index) {
+function assertSurfaceName(surface, name, index, field = "name") {
   if (typeof name !== "string" || !SURFACE_NAME_RE.test(name)) {
     throw new ConnectorConfigError(
-      `${surface}[${index}].name must be kebab-case matching ${SURFACE_NAME_RE} (got ${JSON.stringify(name)})`
+      `${surface}[${index}].${field} must be kebab-case matching ${SURFACE_NAME_RE} (got ${JSON.stringify(name)})`
     );
   }
   return name;
@@ -408,9 +442,9 @@ function assertNonEmptyString(surface, index, field, value) {
   }
   return value;
 }
-function assertNoDuplicate(surface, seen, name, index) {
+function assertNoDuplicate(surface, seen, name, index, field = "name") {
   if (seen.has(name)) {
-    throw new ConnectorConfigError(`${surface}[${index}] duplicate name "${name}"`);
+    throw new ConnectorConfigError(`${surface}[${index}] duplicate ${field} "${name}"`);
   }
   seen.add(name);
 }
@@ -511,6 +545,56 @@ function normalizeMemory(input) {
     return { ...entry, name };
   });
 }
+var STATUSLINE_DEFAULT_NAME = "statusline";
+function normalizeStatusline(input) {
+  if (input == null) return void 0;
+  if (typeof input !== "object" || Array.isArray(input)) {
+    throw new ConnectorConfigError("statusline must be an object");
+  }
+  if (typeof input.render !== "function") {
+    throw new ConnectorConfigError("statusline.render must be a function");
+  }
+  const name = input.name === void 0 ? STATUSLINE_DEFAULT_NAME : assertSurfaceName("statusline", input.name, 0);
+  if (input.description !== void 0 && typeof input.description !== "string") {
+    throw new ConnectorConfigError("statusline.description must be a string");
+  }
+  validateHostsMap(input.hosts, "statusline.hosts", "render");
+  return { ...input, name };
+}
+function normalizeActions(input) {
+  if (input == null) return [];
+  if (!Array.isArray(input)) {
+    throw new ConnectorConfigError("actions must be an array");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return input.map((action, i) => {
+    if (!action || typeof action !== "object" || Array.isArray(action)) {
+      throw new ConnectorConfigError(`actions[${i}] must be an object`);
+    }
+    const id = assertSurfaceName("actions", action.id, i, "id");
+    assertNoDuplicate("actions", seen, id, i, "id");
+    if (typeof action.run !== "function") {
+      throw new ConnectorConfigError(`actions[${i}].run must be a function`);
+    }
+    if (action.description !== void 0 && typeof action.description !== "string") {
+      throw new ConnectorConfigError(`actions[${i}].description must be a string`);
+    }
+    validateHostsMap(action.hosts, `actions.${id}.hosts`, "run");
+    return { ...action, id };
+  });
+}
+var defineStatusline = (def) => def;
+var defineHook = (event, def) => {
+  void event;
+  return def;
+};
+var defineCommand = (def) => def;
+var defineSkill = (def) => def;
+var defineSubagent = (def) => def;
+var defineMemory = (def) => def;
+var defineAction = (def) => def;
+var defineConfigPatch = (def) => def;
+var defineNativeHook = (def) => def;
 function normalizeSubagents(input) {
   if (input == null) return [];
   if (!Array.isArray(input)) {
@@ -540,14 +624,6 @@ function normalizeServer(server) {
 }
 
 export {
-  MCP_SERVER_SCHEMA_URL,
-  MCPB_MANIFEST_VERSION,
-  MCP_PROTOCOL_VERSION,
-  NPM_REGISTRY_BASE_URL,
-  registryTransportType,
-  isConcreteSemver,
-  isPlaceholderVersion,
-  REGISTRY_NAME_RE,
   isValidConfigPatchKey,
   configPatchNamespaceViolation,
   configPatchManualEdit,
@@ -562,7 +638,24 @@ export {
   addLedgerOwner,
   removeLedgerOwner,
   dropLedgerEntry,
+  MCP_SERVER_SCHEMA_URL,
+  MCPB_MANIFEST_VERSION,
+  MCP_PROTOCOL_VERSION,
+  NPM_REGISTRY_BASE_URL,
+  registryTransportType,
+  isConcreteSemver,
+  isPlaceholderVersion,
+  REGISTRY_NAME_RE,
   ConnectorConfigError,
-  defineConnector
+  defineConnector,
+  defineStatusline,
+  defineHook,
+  defineCommand,
+  defineSkill,
+  defineSubagent,
+  defineMemory,
+  defineAction,
+  defineConfigPatch,
+  defineNativeHook
 };
-//# sourceMappingURL=chunk-GSGDG2BV.js.map
+//# sourceMappingURL=chunk-ADTHT2FN.js.map