@ken-jo/agent-connector 0.3.1 → 0.4.0

package/dist/{install-OWAS5UIE.js → install-UDCBL7HP.js}

@@ -3,8 +3,8 @@ import {
   installConnector,
   installViaMarketplace,
   parseInstallMethod
-} from "./chunk-KMAKDD3Z.js";
-import "./chunk-WNREHWKL.js";
+} from "./chunk-G3ER4SY5.js";
+import "./chunk-MAH6QQTO.js";
 import "./chunk-G5CQHVQG.js";
 import {
   fail,
@@ -12,17 +12,19 @@ import {
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-3RBLIHPZ.js";
-import "./chunk-KVAAFYRR.js";
-import "./chunk-NJU275US.js";
+} from "./chunk-KGXDYGNJ.js";
+import "./chunk-22Y24V7O.js";
+import "./chunk-J3D5W5T2.js";
+import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
+} from "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
 import "./chunk-OPXAP3AC.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -86,4 +88,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=install-OWAS5UIE.js.map
+//# sourceMappingURL=install-UDCBL7HP.js.map

package/dist/{install-OWAS5UIE.js.map → install-UDCBL7HP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/install.ts"],"sourcesContent":["/**\n * cli/commands/install — deploy a connector across its target platforms.\n *\n * Resolves the connector config (--connector <path>, else findConnectorConfig\n * walking up from the project dir), loads it into a live ResolvedConnector, and\n * hands it to the chosen DELIVERY METHOD's orchestration:\n *\n *   --method direct      (default) — the installer renders each host's native\n *                        MCP + hook + content config in place (zero behavior\n *                        change for existing scripts).\n *   --method marketplace — stage the connector's plugin bundle under the\n *                        data-root and DRIVE the host's own plugin/marketplace\n *                        install flow (v1 driver: claude-code; other hosts get\n *                        never-silent skip/warn records with manual commands).\n *\n * Both methods emit the same ChangeRecords, rendered as a readable diff;\n * --dry-run renders the plan without writing or spawning. A double-install\n * guard (both directions) enforces exactly one method per (connector, host,\n * scope) — a refusal is a `warn` record, so the exit-1-on-warn convention\n * carries over.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { installConnector } from \"../../core/installer.js\";\nimport { installViaMarketplace, parseInstallMethod } from \"../../core/marketplace.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { fail, parseScope, parseTargets, print, renderInstallResult } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"direct\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      // Memory surface: overwrite USER-EDITED managed blocks (hash drift).\n      // Default behavior is warn-and-leave; --force backs the file up first.\n      force: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const method = parseInstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (!configPath) {\n    return fail(\n      \"no connector config found. Pass --connector <path> or add an \" +\n        \"agent-connector.config.{mjs,js,json} to your project.\",\n    );\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n  if (method === \"marketplace\" && scope !== \"user\") {\n    return fail(\n      \"--method marketplace supports --scope user only (project-scope plugin installs are deferred)\",\n    );\n  }\n\n  const { connector, modulePath } = await loadConnectorFromPath(configPath);\n  const targets = parseTargets(values.targets);\n\n  const result =\n    method === \"marketplace\"\n      ? await installViaMarketplace({\n          connector,\n          modulePath,\n          scope,\n          projectDir,\n          dryRun: values[\"dry-run\"],\n          ...(targets ? { targets } : {}),\n        })\n      : await installConnector({\n          connector,\n          modulePath,\n          scope,\n          projectDir,\n          dryRun: values[\"dry-run\"],\n          force: values.force,\n          ...(targets ? { targets } : {}),\n        });\n\n  print(renderInstallResult(result, \"install\"));\n  return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAS,iBAAiB;AAO1B,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,QAAQ,EAAE,MAAM,UAAU,SAAS,SAAS;AAAA,MAC5C,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA;AAAA;AAAA,MAG7C,OAAO,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC3C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,SAAS,mBAAmB,OAAO,MAAM;AAC/C,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK,qBAAqB,OAAO,MAAM,4BAA4B;AAAA,EAC5E;AAEA,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,aAAa,OAAO,aAAa,oBAAoB,UAAU;AACrE,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,MACL;AAAA,IAEF;AAAA,EACF;AAEA,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AACrF,MAAI,WAAW,iBAAiB,UAAU,QAAQ;AAChD,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAEA,QAAM,EAAE,WAAW,WAAW,IAAI,MAAM,sBAAsB,UAAU;AACxE,QAAM,UAAU,aAAa,OAAO,OAAO;AAE3C,QAAM,SACJ,WAAW,gBACP,MAAM,sBAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC,IACD,MAAM,iBAAiB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,OAAO,OAAO;AAAA,IACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC;AAEP,QAAM,oBAAoB,QAAQ,SAAS,CAAC;AAC5C,SAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAC/D;","names":[]}
+{"version":3,"sources":["../src/cli/commands/install.ts"],"sourcesContent":["/**\n * cli/commands/install — deploy a connector across its target platforms.\n *\n * Resolves the connector config (--connector <path>, else findConnectorConfig\n * walking up from the project dir), loads it into a live ResolvedConnector, and\n * hands it to the chosen DELIVERY METHOD's orchestration:\n *\n *   --method direct      (default) — the installer renders each host's native\n *                        MCP + hook + content config in place (zero behavior\n *                        change for existing scripts).\n *   --method marketplace — stage the connector's plugin bundle under the\n *                        data-root and DRIVE the host's own plugin/marketplace\n *                        install flow (v1 driver: claude-code; other hosts get\n *                        never-silent skip/warn records with manual commands).\n *\n * Both methods emit the same ChangeRecords, rendered as a readable diff;\n * --dry-run renders the plan without writing or spawning. A double-install\n * guard (both directions) enforces exactly one method per (connector, host,\n * scope) — a refusal is a `warn` record, so the exit-1-on-warn convention\n * carries over.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { installConnector } from \"../../core/installer.js\";\nimport { installViaMarketplace, parseInstallMethod } from \"../../core/marketplace.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { fail, parseScope, parseTargets, print, renderInstallResult } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"direct\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      // Memory surface: overwrite USER-EDITED managed blocks (hash drift).\n      // Default behavior is warn-and-leave; --force backs the file up first.\n      force: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const method = parseInstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (!configPath) {\n    return fail(\n      \"no connector config found. Pass --connector <path> or add an \" +\n        \"agent-connector.config.{mjs,js,json} to your project.\",\n    );\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n  if (method === \"marketplace\" && scope !== \"user\") {\n    return fail(\n      \"--method marketplace supports --scope user only (project-scope plugin installs are deferred)\",\n    );\n  }\n\n  const { connector, modulePath } = await loadConnectorFromPath(configPath);\n  const targets = parseTargets(values.targets);\n\n  const result =\n    method === \"marketplace\"\n      ? await installViaMarketplace({\n          connector,\n          modulePath,\n          scope,\n          projectDir,\n          dryRun: values[\"dry-run\"],\n          ...(targets ? { targets } : {}),\n        })\n      : await installConnector({\n          connector,\n          modulePath,\n          scope,\n          projectDir,\n          dryRun: values[\"dry-run\"],\n          force: values.force,\n          ...(targets ? { targets } : {}),\n        });\n\n  print(renderInstallResult(result, \"install\"));\n  return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAS,iBAAiB;AAO1B,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,QAAQ,EAAE,MAAM,UAAU,SAAS,SAAS;AAAA,MAC5C,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA;AAAA;AAAA,MAG7C,OAAO,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC3C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,QAAM,SAAS,mBAAmB,OAAO,MAAM;AAC/C,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK,qBAAqB,OAAO,MAAM,4BAA4B;AAAA,EAC5E;AAEA,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,aAAa,OAAO,aAAa,oBAAoB,UAAU;AACrE,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,MACL;AAAA,IAEF;AAAA,EACF;AAEA,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AACrF,MAAI,WAAW,iBAAiB,UAAU,QAAQ;AAChD,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAEA,QAAM,EAAE,WAAW,WAAW,IAAI,MAAM,sBAAsB,UAAU;AACxE,QAAM,UAAU,aAAa,OAAO,OAAO;AAE3C,QAAM,SACJ,WAAW,gBACP,MAAM,sBAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC,IACD,MAAM,iBAAiB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,OAAO,SAAS;AAAA,IACxB,OAAO,OAAO;AAAA,IACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC;AAEP,QAAM,oBAAoB,QAAQ,SAAS,CAAC;AAC5C,SAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAC/D;","names":[]}

package/dist/introspect-DuZSPSHB.d.ts

@@ -0,0 +1,53 @@
+import { m as PlatformCapabilities, P as PlatformId } from './types-BEKsAium.js';
+
+/**
+ * sdk/introspect — host-capability introspection over the adapter registry.
+ *
+ * A thin, READ-ONLY query layer above {@link loadAdapter} / {@link allAdapters}:
+ * "which hosts can honor surface X?" and "what can host Y do?". It exists so a
+ * connector author (or a docs/CLI surface) can answer those questions WITHOUT
+ * reaching into adapter internals or re-deriving the per-surface capability
+ * rules — the predicates below are the single source of truth for mapping the
+ * raw {@link PlatformCapabilities} flags onto the developer-facing surface names.
+ *
+ * Everything is async because adapters load lazily (one entry per platform in
+ * the registry, imported only when queried).
+ */
+
+/**
+ * The developer-facing surface names a connector can declare. These mirror the
+ * top-level {@link import("../core/types.js").ConnectorConfig} keys (server,
+ * hooks, commands, …) plus the platform-scoped `configPatch` / `nativeHooks`
+ * escape hatches — the same vocabulary the install diff and `explain` use.
+ */
+type SurfaceName = "server" | "hooks" | "commands" | "skills" | "subagents" | "memory" | "statusline" | "actions" | "configPatch" | "nativeHooks";
+/**
+ * Pure capability predicate per surface — `true` when the host can NATIVELY
+ * honor that surface. The optional capability flags are read as `?? false`
+ * (the supportsCommands precedent in core/types), so a host that simply leaves
+ * a flag unset reports the surface as unsupported (the installer skip-warns it).
+ *
+ * `hooks` is satisfied by ANY normalized hook event (i.e. the host has at least
+ * one event it can dispatch); the per-event flags map 1:1 onto the
+ * {@link import("../core/types.js").HookEventName} union.
+ */
+declare const SURFACE_PREDICATES: Record<SurfaceName, (c: PlatformCapabilities) => boolean>;
+/**
+ * The {@link PlatformCapabilities} a host advertises, or `undefined` for an id
+ * that is not in the registry (`"unknown"`, a usage-only id like `"synthetic"`,
+ * or a typo) — callers branch on undefined rather than crash.
+ */
+declare function capabilitiesOf(host: PlatformId | string): Promise<PlatformCapabilities | undefined>;
+/**
+ * Every registered host that can NATIVELY honor `surface`, as a sorted id list
+ * (stable output for snapshots/docs). Loads all adapters in parallel and keeps
+ * only those whose capabilities pass {@link SURFACE_PREDICATES}.
+ */
+declare function hostsSupporting(surface: SurfaceName): Promise<PlatformId[]>;
+/**
+ * Convenience: does `host` natively support `surface`? `false` for an unknown
+ * id (no capabilities → cannot support anything).
+ */
+declare function surfaceSupport(host: PlatformId | string, surface: SurfaceName): Promise<boolean>;
+
+export { SURFACE_PREDICATES as S, type SurfaceName as a, capabilitiesOf as c, hostsSupporting as h, surfaceSupport as s };

package/dist/{jetbrains-copilot-C3HDGGML.js → jetbrains-copilot-YABZ3HFA.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildHomeBinHookCommand,
   isHomeBinHookCommand
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -644,4 +644,4 @@ export {
   adapter,
   jetbrains_copilot_default as default
 };
-//# sourceMappingURL=jetbrains-copilot-C3HDGGML.js.map
+//# sourceMappingURL=jetbrains-copilot-YABZ3HFA.js.map

package/dist/{kilo-PKAJCWPX.js → kilo-F3ZDZKCT.js}

@@ -4,12 +4,12 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -849,4 +849,4 @@ export {
   adapter,
   kilo_default as default
 };
-//# sourceMappingURL=kilo-PKAJCWPX.js.map
+//# sourceMappingURL=kilo-F3ZDZKCT.js.map

package/dist/{kilo-cli-QWUVXG2O.js → kilo-cli-3HWPWBY4.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderCommandMd,
   renderSkillMd
@@ -12,7 +12,7 @@ import {
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -763,4 +763,4 @@ export {
   adapter,
   kilo_cli_default as default
 };
-//# sourceMappingURL=kilo-cli-QWUVXG2O.js.map
+//# sourceMappingURL=kilo-cli-3HWPWBY4.js.map

package/dist/{kimi-EVD7YKXS.js → kimi-NV72FVAO.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderSkillMd
 } from "./chunk-7L6ITC4T.js";
@@ -13,7 +13,7 @@ import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import {
   ensureDir
@@ -578,4 +578,4 @@ export {
   adapter,
   kimi_default as default
 };
-//# sourceMappingURL=kimi-EVD7YKXS.js.map
+//# sourceMappingURL=kimi-NV72FVAO.js.map

package/dist/{kiro-UQRY6EIO.js → kiro-C5W6AGDR.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderSkillMd
 } from "./chunk-7L6ITC4T.js";
@@ -13,7 +13,7 @@ import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -542,4 +542,4 @@ export {
   adapter,
   kiro_default as default
 };
-//# sourceMappingURL=kiro-UQRY6EIO.js.map
+//# sourceMappingURL=kiro-C5W6AGDR.js.map

package/dist/{leaderboard-CSWHI4UY.js → leaderboard-TIBVONVT.js}

@@ -2,7 +2,7 @@
 import {
   formatHostLeaderboard,
   hostLeaderboard
-} from "./chunk-SCVBYSF7.js";
+} from "./chunk-6XHB6BE3.js";
 import {
   SCOPE_FILTER_VALUES,
   formatHostNativeTurns,
@@ -15,7 +15,7 @@ import "./chunk-XD7MY6HB.js";
 import {
   fail,
   print
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-KGXDYGNJ.js";
 import "./chunk-BCHWFTV4.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -134,4 +134,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=leaderboard-CSWHI4UY.js.map
+//# sourceMappingURL=leaderboard-TIBVONVT.js.map