@ken-jo/agent-connector 0.4.91 → 0.4.92

package/dist/runtime/index.js

@@ -4,24 +4,24 @@ import {
   runServe,
   runStatusline,
   runUsageEvent
-} from "../chunk-BLTVZACS.js";
+} from "../chunk-447JWFZO.js";
 import "../chunk-OP4KBXUO.js";
-import "../chunk-LN76OGNR.js";
-import "../chunk-ZMLVR4J7.js";
+import "../chunk-Z2MRSS2I.js";
+import "../chunk-FO5CEXXN.js";
 import {
   isNativeHookDeclared,
   runHook,
   runNativeHook
-} from "../chunk-LAIITCMW.js";
+} from "../chunk-FBCBHEGB.js";
 import "../chunk-KHO5WNTP.js";
-import "../chunk-4FWETID5.js";
-import "../chunk-NWLRJNXM.js";
-import "../chunk-G4CEELKO.js";
-import "../chunk-25CPWJA7.js";
-import "../chunk-56R2ER7K.js";
-import "../chunk-HORHRHNG.js";
-import "../chunk-YYNXIUR2.js";
-import "../chunk-IXOQDZWC.js";
+import "../chunk-IVAWP6HH.js";
+import "../chunk-JVO6NBTT.js";
+import "../chunk-AY3VFNOH.js";
+import "../chunk-KA55FISM.js";
+import "../chunk-NBYKLUF6.js";
+import "../chunk-4NHXLXSD.js";
+import "../chunk-M2H7JURF.js";
+import "../chunk-GZGLCCEE.js";
 export {
   isNativeHookDeclared,
   runAction,

package/dist/sdk/index.d.ts

@@ -1,7 +1,7 @@
 export { ConnectorConfigError, defineAction, defineCommand, defineConfigPatch, defineConnector, defineHook, defineMemory, defineNativeHook, defineSkill, defineStatusline, defineSubagent } from '../index.js';
-export { S as SURFACE_PREDICATES, a as SurfaceName, c as capabilitiesOf, h as hostsSupporting, s as surfaceSupport } from '../introspect-DYOIX8Ov.js';
-import { P as PlatformId } from '../types-C4qMgbJn.js';
-export { A as ActionDef, a as ActionResult, b as AuthSpec, C as CommandDef, c as ConfigPatchDef, d as ConnectorConfig, E as EventPayloadMap, H as HookDefinition, e as HookEventName, f as HookParadigm, g as HookResponse, h as HooksConfig, i as HostCtx, I as InstallScope, J as JsonValue, M as MemoryDef, N as NativeHookDef, j as NativeHookEvent, k as NotificationEvent, l as PermissionRequestEvent, m as PlatformCapabilities, n as PlatformMemoryOverride, o as PlatformOverride, p as PostToolUseEvent, q as PostToolUseFailureEvent, r as PreCompactEvent, s as PreToolUseEvent, t as PublishConfig, R as ResolvedConnector, S as ServerDef, u as SessionEndEvent, v as SessionStartEvent, w as SkillDef, x as StatuslineContext, y as StatuslineDef, z as StopEvent, B as SubagentDef, D as SubagentStartEvent, F as SubagentStopEvent, G as SurfaceToolPolicy, T as TelemetryAccessor, K as TelemetryConfig, L as TelemetryUsageSummary, O as ToolFilter, Q as Transport, U as UserPromptSubmitEvent } from '../types-C4qMgbJn.js';
+export { S as SURFACE_PREDICATES, a as SurfaceName, c as capabilitiesOf, h as hostsSupporting, s as surfaceSupport } from '../introspect-BkId4LGP.js';
+import { P as PlatformId } from '../types-D0RqWxT8.js';
+export { A as ActionDef, a as ActionResult, b as AuthSpec, C as CommandDef, c as ConfigPatchDef, d as ConnectorConfig, E as EventPayloadMap, H as HookDefinition, e as HookEventName, f as HookParadigm, g as HookResponse, h as HooksConfig, i as HostCtx, I as InstallScope, J as JsonValue, M as MemoryDef, N as NativeHookDef, j as NativeHookEvent, k as NotificationEvent, l as PermissionRequestEvent, m as PlatformCapabilities, n as PlatformMemoryOverride, o as PlatformOverride, p as PostToolUseEvent, q as PostToolUseFailureEvent, r as PreCompactEvent, s as PreToolUseEvent, t as PublishConfig, R as ResolvedConnector, S as ServerDef, u as SessionEndEvent, v as SessionStartEvent, w as SkillDef, x as StatuslineContext, y as StatuslineDef, z as StopEvent, B as SubagentDef, D as SubagentStartEvent, F as SubagentStopEvent, G as SurfaceToolPolicy, T as TelemetryAccessor, K as TelemetryConfig, L as TelemetryUsageSummary, O as ToolFilter, Q as Transport, U as UserPromptSubmitEvent } from '../types-D0RqWxT8.js';
 
 /**
  * sdk/helpers — host-aware authoring helpers for connector handlers.

package/dist/sdk/index.js

@@ -4,7 +4,7 @@ import {
   capabilitiesOf,
   hostsSupporting,
   surfaceSupport
-} from "../chunk-R6LML2YS.js";
+} from "../chunk-7UT6OB52.js";
 import {
   ConnectorConfigError,
   defineAction,
@@ -17,11 +17,11 @@ import {
   defineSkill,
   defineStatusline,
   defineSubagent
-} from "../chunk-G4CEELKO.js";
-import "../chunk-25CPWJA7.js";
-import "../chunk-56R2ER7K.js";
-import "../chunk-YYNXIUR2.js";
-import "../chunk-IXOQDZWC.js";
+} from "../chunk-AY3VFNOH.js";
+import "../chunk-KA55FISM.js";
+import "../chunk-NBYKLUF6.js";
+import "../chunk-M2H7JURF.js";
+import "../chunk-GZGLCCEE.js";
 
 // src/sdk/helpers.ts
 var PREFIXED_HOSTS = /* @__PURE__ */ new Set([

package/dist/sdk/test.d.ts

@@ -1,5 +1,5 @@
-import { P as PlatformId, e as HookEventName, R as ResolvedConnector } from '../types-C4qMgbJn.js';
-import { a as SurfaceName } from '../introspect-DYOIX8Ov.js';
+import { P as PlatformId, e as HookEventName, R as ResolvedConnector } from '../types-D0RqWxT8.js';
+import { a as SurfaceName } from '../introspect-BkId4LGP.js';
 
 /**
  * sdk/test-harness — the SHIPPED, OFFLINE behavioral harness.

package/dist/sdk/test.js

@@ -3,17 +3,17 @@ import {
   explain,
   explainHooks,
   simulate
-} from "../chunk-QARPXSIV.js";
-import "../chunk-LAIITCMW.js";
+} from "../chunk-L26PSQTY.js";
+import "../chunk-FBCBHEGB.js";
 import "../chunk-KHO5WNTP.js";
-import "../chunk-4FWETID5.js";
-import "../chunk-R6LML2YS.js";
-import "../chunk-NWLRJNXM.js";
-import "../chunk-G4CEELKO.js";
-import "../chunk-25CPWJA7.js";
-import "../chunk-56R2ER7K.js";
-import "../chunk-YYNXIUR2.js";
-import "../chunk-IXOQDZWC.js";
+import "../chunk-IVAWP6HH.js";
+import "../chunk-7UT6OB52.js";
+import "../chunk-JVO6NBTT.js";
+import "../chunk-AY3VFNOH.js";
+import "../chunk-KA55FISM.js";
+import "../chunk-NBYKLUF6.js";
+import "../chunk-M2H7JURF.js";
+import "../chunk-GZGLCCEE.js";
 export {
   explain,
   explainHooks,

package/dist/{serve-K62FW3V7.js → serve-EPRN7F2X.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import {
   fail
-} from "./chunk-7HUUINPB.js";
+} from "./chunk-5Z36KVU2.js";
 import {
   runServe
-} from "./chunk-BLTVZACS.js";
+} from "./chunk-447JWFZO.js";
 import "./chunk-OP4KBXUO.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-ZMLVR4J7.js";
-import "./chunk-LAIITCMW.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
+import "./chunk-FBCBHEGB.js";
 import "./chunk-KHO5WNTP.js";
-import "./chunk-4FWETID5.js";
-import "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
-import "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+import "./chunk-IVAWP6HH.js";
+import "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/serve.ts
 import { parseArgs } from "util";
@@ -74,4 +74,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=serve-K62FW3V7.js.map
+//# sourceMappingURL=serve-EPRN7F2X.js.map

package/dist/{status-E5MCFZM6.js → status-B2PG6YKR.js}

@@ -1,31 +1,31 @@
 #!/usr/bin/env node
 import {
   marketplaceEvidence
-} from "./chunk-QKLJU4JX.js";
+} from "./chunk-2Y2MZRLP.js";
 import "./chunk-UM5S7DKK.js";
 import {
   fail,
   parseScope,
   print
-} from "./chunk-7HUUINPB.js";
+} from "./chunk-5Z36KVU2.js";
 import {
   detectInstalledPlatforms
-} from "./chunk-ZMLVR4J7.js";
+} from "./chunk-FO5CEXXN.js";
 import {
   findConnectorConfig,
   listRegisteredConnectors,
   loadConnectorFromPath
-} from "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
 import {
   loadAdapter
-} from "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-YYNXIUR2.js";
+} from "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
+import "./chunk-M2H7JURF.js";
 import {
   dataRoot,
   homeBinPath
-} from "./chunk-IXOQDZWC.js";
+} from "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/status.ts
 import { parseArgs } from "util";
@@ -139,4 +139,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=status-E5MCFZM6.js.map
+//# sourceMappingURL=status-B2PG6YKR.js.map

package/dist/{statusline-LIPF2KVP.js → statusline-5ERFMYSM.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   runStatusline
-} from "./chunk-BLTVZACS.js";
+} from "./chunk-447JWFZO.js";
 import "./chunk-OP4KBXUO.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-ZMLVR4J7.js";
-import "./chunk-LAIITCMW.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
+import "./chunk-FBCBHEGB.js";
 import "./chunk-KHO5WNTP.js";
-import "./chunk-4FWETID5.js";
-import "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
-import "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+import "./chunk-IVAWP6HH.js";
+import "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/statusline.ts
 import { parseArgs } from "util";
@@ -57,4 +57,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=statusline-LIPF2KVP.js.map
+//# sourceMappingURL=statusline-5ERFMYSM.js.map

package/dist/{telemetry-4OC56NTM.js → telemetry-ZMCAWBWB.js}

@@ -8,25 +8,25 @@ import {
   mcpLeaderboard,
   surfaceLeaderboard,
   toolLeaderboard
-} from "./chunk-AY3RGRTT.js";
+} from "./chunk-6TF7MHG5.js";
 import {
   fail,
   print
-} from "./chunk-7HUUINPB.js";
+} from "./chunk-5Z36KVU2.js";
 import {
   openStore
-} from "./chunk-4FWETID5.js";
+} from "./chunk-IVAWP6HH.js";
 import {
   connectorFromMeta,
   listRegisteredConnectors,
   loadRegisteredConnector,
   readRegisteredMeta
-} from "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
-import "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/telemetry.ts
 import { writeFileSync } from "fs";
@@ -349,4 +349,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=telemetry-4OC56NTM.js.map
+//# sourceMappingURL=telemetry-ZMCAWBWB.js.map

package/dist/{trae-Z7CQ2A2Q.js → trae-7KDCYIMN.js}

@@ -5,13 +5,13 @@ import {
 import {
   BaseAdapter,
   renderSkillMd
-} from "./chunk-VVFDU4IX.js";
+} from "./chunk-WFEHWTLM.js";
 import {
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+} from "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/adapters/trae/index.ts
 import { existsSync } from "fs";
@@ -271,4 +271,4 @@ export {
   adapter,
   trae_default as default
 };
-//# sourceMappingURL=trae-Z7CQ2A2Q.js.map
+//# sourceMappingURL=trae-7KDCYIMN.js.map

package/dist/{types-C4qMgbJn.d.ts → types-D0RqWxT8.d.ts}

@@ -573,6 +573,7 @@ interface SkillDef {
     disableModelInvocation?: boolean;
     /** Extra files bundled beside SKILL.md, relative path → contents. */
     resources?: Record<string, string>;
+    /** Verbatim per-platform frontmatter additions (escape hatch). */
     extra?: Record<string, unknown>;
 }
 /** A named subagent (system-prompt + tool/model scoping). */
@@ -588,6 +589,13 @@ interface SubagentDef {
     model?: string;
     /** Coarse permission knob → Cursor readonly, opencode/kilo permission map. */
     readonly?: boolean;
+    /**
+     * Verbatim per-platform subagent manifest additions (escape hatch).
+     *
+     * Markdown/frontmatter hosts merge these as frontmatter. Hosts whose subagent
+     * files are native config/manifests merge them only when that native format is
+     * itself an extensible subagent surface.
+     */
     extra?: Record<string, unknown>;
 }
 /**
@@ -1061,6 +1069,41 @@ interface InstallResult {
     dryRun: boolean;
     changes: ChangeRecord[];
     warnings: string[];
+    /**
+     * Render-only digest of the resolved connector (id/version/server/hooks/
+     * telemetry/surface counts), threaded in by the CLI command so the friendly
+     * renderer can print a connector header. OPTIONAL: the core install/uninstall
+     * functions never populate it (they don't shape presentation) — the CLI
+     * attaches it from the {@link ResolvedConnector} it already loaded. The
+     * `--json` machine contract does NOT include it; see cli/app
+     * buildConnectorSummary / renderInstallResult.
+     */
+    connector?: ConnectorSummary;
+}
+/**
+ * A minimal, presentation-only digest of a {@link ResolvedConnector} used by the
+ * CLI's friendly install/uninstall/upgrade output. Lives here (not in cli/) so
+ * {@link InstallResult} can reference it without a CLI→core import cycle; it is
+ * BUILT by cli/app buildConnectorSummary. Render-only: never part of any machine
+ * (JSON) contract.
+ */
+interface ConnectorSummary {
+    id: string;
+    version: string;
+    displayName?: string;
+    /** stdio command line / remote URL; absent ⇒ hooks-only connector. */
+    server?: {
+        transport: string;
+        command: string;
+    };
+    hookEvents: string[];
+    telemetryEnabled: boolean;
+    commands: number;
+    skills: number;
+    subagents: number;
+    memory: number;
+    hasStatusline: boolean;
+    actions: number;
 }
 interface DiagnosticResult {
     check: string;

package/dist/{uninstall-2YYKN5DX.js → uninstall-M76BHLTH.js}

@@ -5,49 +5,51 @@ import {
   resolveUninstallTargets,
   uninstallConnector,
   uninstallViaMarketplace
-} from "./chunk-KIRCPLM4.js";
-import "./chunk-LF76VPGQ.js";
+} from "./chunk-JO2IM2JL.js";
+import "./chunk-IBLYVAWH.js";
 import {
   marketplaceEvidence,
   readMarketplaceInstalls
-} from "./chunk-QKLJU4JX.js";
+} from "./chunk-2Y2MZRLP.js";
 import "./chunk-UM5S7DKK.js";
-import "./chunk-NBUEL74R.js";
+import "./chunk-JFXL4HYA.js";
 import "./chunk-OPXAP3AC.js";
 import {
+  buildConnectorSummary,
   fail,
+  maybePrintBanner,
   parseScope,
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-7HUUINPB.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-ZMLVR4J7.js";
+} from "./chunk-5Z36KVU2.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
-import "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
-import "./chunk-VVFDU4IX.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
+import "./chunk-WFEHWTLM.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
 import {
   assertConnectorId
-} from "./chunk-IXOQDZWC.js";
+} from "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/uninstall.ts
 import { parseArgs } from "util";
 async function resolveConnectorId(explicitId, connectorPath, projectDir) {
-  if (explicitId && explicitId.trim() !== "") return explicitId;
+  if (explicitId && explicitId.trim() !== "") return { id: explicitId };
   const configPath = connectorPath ?? findConnectorConfig(projectDir);
   if (!configPath) return null;
   const { connector } = await loadConnectorFromPath(configPath);
-  return connector.id;
+  return { id: connector.id, connector };
 }
 async function run(argv) {
   const { values } = parseArgs({
@@ -60,10 +62,13 @@ async function run(argv) {
       "connector-id": { type: "string" },
       project: { type: "string" },
       "dry-run": { type: "boolean", default: false },
-      purge: { type: "boolean", default: false }
+      purge: { type: "boolean", default: false },
+      // Decorative-banner suppressor (no effect on command output bytes).
+      quiet: { type: "boolean", default: false }
     },
     allowPositionals: false
   });
+  maybePrintBanner({ quiet: values.quiet });
   const method = parseUninstallMethod(values.method);
   if (method == null) {
     return fail(`invalid --method "${values.method}" (use auto|direct|marketplace)`);
@@ -71,16 +76,18 @@ async function run(argv) {
   const projectDir = values.project ?? process.cwd();
   const scope = parseScope(values.scope);
   if (scope == null) return fail(`invalid --scope "${values.scope}" (use user|project)`);
-  const connectorId = await resolveConnectorId(
+  const resolved = await resolveConnectorId(
     values["connector-id"],
     values.connector,
     projectDir
   );
-  if (!connectorId) {
+  if (!resolved) {
     return fail(
       "could not determine connector id. Pass --connector-id <id>, --connector <path>, or run inside a project with an agent-connector config."
     );
   }
+  const connectorId = resolved.id;
+  const summary = resolved.connector ? buildConnectorSummary(resolved.connector) : void 0;
   try {
     assertConnectorId(connectorId);
   } catch (err) {
@@ -97,19 +104,20 @@ async function run(argv) {
       ...targets ? { targets } : {}
     });
     if (values.purge) purgeFrameworkState(connectorId, dryRun, result);
+    result.connector = summary;
     print(renderInstallResult(result, "uninstall"));
     return result.changes.some((c) => c.action === "warn") ? 1 : 0;
   }
   let marketplaceTargets = [];
   let directTargets = [];
   if (method === "auto") {
-    const resolved = await resolveUninstallTargets(connectorId, targets, projectDir);
+    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);
     const recorded = targets ? [] : Object.keys(readMarketplaceInstalls(connectorId));
-    const candidates = [.../* @__PURE__ */ new Set([...resolved, ...recorded])];
+    const candidates = [.../* @__PURE__ */ new Set([...resolvedTargets, ...recorded])];
     marketplaceTargets = candidates.filter(
       (id) => marketplaceEvidence(connectorId, id) != null
     );
-    directTargets = resolved.filter((id) => !marketplaceTargets.includes(id));
+    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));
   }
   if (marketplaceTargets.length === 0) {
     const result = await uninstallConnector({
@@ -120,6 +128,7 @@ async function run(argv) {
       purge: values.purge,
       ...targets ? { targets } : {}
     });
+    result.connector = summary;
     print(renderInstallResult(result, "uninstall"));
     return result.changes.some((c) => c.action === "warn") ? 1 : 0;
   }
@@ -165,7 +174,8 @@ async function run(argv) {
     connectorId,
     dryRun,
     changes: results.flatMap((r) => r.changes),
-    warnings: results.flatMap((r) => r.warnings)
+    warnings: results.flatMap((r) => r.warnings),
+    connector: summary
   };
   print(renderInstallResult(merged, "uninstall"));
   return merged.changes.some((c) => c.action === "warn") ? 1 : 0;
@@ -173,4 +183,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=uninstall-2YYKN5DX.js.map
+//# sourceMappingURL=uninstall-M76BHLTH.js.map

package/dist/uninstall-M76BHLTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/uninstall.ts"],"sourcesContent":["/**\n * cli/commands/uninstall — strip a connector's registrations, method-aware.\n *\n * The connector id is taken from --connector-id, or inferred from the local\n * connector config (--connector <path> / findConnectorConfig).\n *\n * --method auto (default) reverses WHATEVER is actually there, per target:\n * targets with marketplace evidence (the state record, or the host's own plugin\n * state) get the HOST plugin uninstall; everything else gets the existing\n * direct adapter strip. Install chooses a method (a user decision); uninstall\n * reverses what exists (a state decision) — and since the double-install guard\n * enforces exactly one method per (connector, host, scope), auto is\n * unambiguous. Explicit --method direct|marketplace forces one path for every\n * target. Config removal vs plugin uninstall is therefore method-resolved:\n * never both, never neither.\n *\n * --purge additionally removes the framework-state this connector left behind:\n * its DATA-dir connector record (connectorDir(id)), the empty marketplace\n * staging root, and, when no connectors remain, the shared home-bin launcher.\n * Without --purge those linger so the connector can be re-synced without\n * re-registering.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport {\n  purgeFrameworkState,\n  resolveUninstallTargets,\n  uninstallConnector,\n} from \"../../core/installer.js\";\nimport {\n  marketplaceEvidence,\n  parseUninstallMethod,\n  uninstallViaMarketplace,\n} from \"../../core/marketplace.js\";\nimport { readMarketplaceInstalls } from \"../../core/marketplace-state.js\";\nimport { assertConnectorId } from \"../../core/ids.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport type {\n  ConnectorSummary,\n  InstallResult,\n  PlatformId,\n  ResolvedConnector,\n} from \"../../core/types.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\n/**\n * Resolve the connector id from flags, then from a local config file. When the\n * id was inferred by LOADING a config, the resolved connector is returned too so\n * the caller can build a header summary; an explicit `--connector-id` yields no\n * connector (id-only uninstall), and the renderer degrades to an id-only header.\n */\nasync function resolveConnectorId(\n  explicitId: string | undefined,\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<{ id: string; connector?: ResolvedConnector } | null> {\n  if (explicitId && explicitId.trim() !== \"\") return { id: explicitId };\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (!configPath) return null;\n  const { connector } = await loadConnectorFromPath(configPath);\n  return { id: connector.id, connector };\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"auto\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      \"connector-id\": { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      purge: { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const method = parseUninstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use auto|direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const resolved = await resolveConnectorId(\n    values[\"connector-id\"],\n    values.connector,\n    projectDir,\n  );\n  if (!resolved) {\n    return fail(\n      \"could not determine connector id. Pass --connector-id <id>, \" +\n        \"--connector <path>, or run inside a project with an agent-connector config.\",\n    );\n  }\n  const connectorId = resolved.id;\n  // Header summary when a connector config was actually loaded; id-only\n  // (--connector-id) uninstalls have no connector → the renderer degrades to an\n  // id-only header.\n  const summary: ConnectorSummary | undefined = resolved.connector\n    ? buildConnectorSummary(resolved.connector)\n    : undefined;\n\n  // Single choke-point: validate the id BEFORE any path is built or any delete\n  // runs. Every branch below (explicit --method marketplace, --method auto, and\n  // the direct strip) constructs record / staging-root paths from this id —\n  // including the explicit --targets marketplace path, which reaches\n  // driver.finishUninstall(id) → rmSync(join(stagingRoot, id)) without otherwise\n  // routing the raw id through connectorDir's validation. Failing loud here closes\n  // the `--connector-id ../../x` traversal window for ALL of them at once.\n  try {\n    assertConnectorId(connectorId);\n  } catch (err) {\n    return fail(err instanceof Error ? err.message : String(err));\n  }\n\n  const targets = parseTargets(values.targets);\n  const dryRun = values[\"dry-run\"];\n\n  // ── Explicit --method marketplace: every target goes to the marketplace path\n  // (targets default to the recorded installs); framework purge runs here since\n  // no direct pass follows.\n  if (method === \"marketplace\") {\n    const result = await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    if (values.purge) purgeFrameworkState(connectorId, dryRun, result);\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  // ── --method auto: partition the resolved targets by marketplace evidence.\n  // (--method direct keeps every target on the adapter strip — today's path.)\n  let marketplaceTargets: PlatformId[] = [];\n  let directTargets: PlatformId[] = [];\n  if (method === \"auto\") {\n    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);\n    // With no explicit --targets, recorded marketplace platforms are unioned\n    // in: the state record IS the authority for what we installed, and host\n    // detection can miss a host whose probe-able config dir was relocated.\n    // An explicit --targets list is always respected as-is.\n    const recorded = targets\n      ? []\n      : (Object.keys(readMarketplaceInstalls(connectorId)) as PlatformId[]);\n    const candidates = [...new Set([...resolvedTargets, ...recorded])];\n    marketplaceTargets = candidates.filter(\n      (id) => marketplaceEvidence(connectorId, id) != null,\n    );\n    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));\n  }\n\n  // No marketplace evidence anywhere (or --method direct): exactly today's\n  // single-orchestration path, byte-for-byte — zero behavior change for users\n  // who never touched the marketplace method.\n  if (marketplaceTargets.length === 0) {\n    const result = await uninstallConnector({\n      connectorId,\n      scope,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  const results: InstallResult[] = [\n    await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      targets: marketplaceTargets,\n      dryRun,\n      purge: values.purge,\n    }),\n  ];\n\n  // The direct strip runs only for its partition (never both methods on one\n  // target). When every target was marketplace-routed, --purge still runs the\n  // framework purge (the marketplace records were just cleared, so it can\n  // proceed to the connector record + home-bin).\n  if (directTargets.length > 0) {\n    results.push(\n      await uninstallConnector({\n        connectorId,\n        scope,\n        projectDir,\n        dryRun,\n        purge: values.purge,\n        targets: directTargets,\n      }),\n    );\n  } else if (values.purge) {\n    const purgeResult: InstallResult = {\n      connectorId,\n      dryRun,\n      changes: [],\n      warnings: [],\n    };\n    if (dryRun) {\n      // On a real run the marketplace records are removed BEFORE this purge;\n      // calling purgeFrameworkState now would false-refuse on records that the\n      // marketplace pass only PLANNED to remove. Report the plan instead.\n      purgeResult.changes.push({\n        platform: connectorId as PlatformId,\n        action: \"remove\",\n        detail:\n          \"would purge framework state (connector record; home-bin when no connectors remain)\",\n      });\n    } else {\n      purgeFrameworkState(connectorId, dryRun, purgeResult);\n    }\n    results.push(purgeResult);\n  }\n\n  const merged: InstallResult = {\n    connectorId,\n    dryRun,\n    changes: results.flatMap((r) => r.changes),\n    warnings: results.flatMap((r) => r.warnings),\n    connector: summary,\n  };\n  print(renderInstallResult(merged, \"uninstall\"));\n  return merged.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAS,iBAAiB;AAqC1B,eAAe,mBACb,YACA,eACA,YAC+D;AAC/D,MAAI,cAAc,WAAW,KAAK,MAAM,GAAI,QAAO,EAAE,IAAI,WAAW;AACpE,QAAM,aAAa,iBAAiB,oBAAoB,UAAU;AAClE,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,EAAE,UAAU,IAAI,MAAM,sBAAsB,UAAU;AAC5D,SAAO,EAAE,IAAI,UAAU,IAAI,UAAU;AACvC;AAEA,eAAsB,IAAI,MAAiC;AACzD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,QAAQ,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MAC1C,OAAO,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MACzC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,gBAAgB,EAAE,MAAM,SAAS;AAAA,MACjC,SAAS,EAAE,MAAM,SAAS;AAAA,MAC1B,WAAW,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,MAC7C,OAAO,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA;AAAA,MAEzC,OAAO,EAAE,MAAM,WAAW,SAAS,MAAM;AAAA,IAC3C;AAAA,IACA,kBAAkB;AAAA,EACpB,CAAC;AAED,mBAAiB,EAAE,OAAO,OAAO,MAAM,CAAC;AAExC,QAAM,SAAS,qBAAqB,OAAO,MAAM;AACjD,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK,qBAAqB,OAAO,MAAM,iCAAiC;AAAA,EACjF;AAEA,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AAEjD,QAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,MAAI,SAAS,KAAM,QAAO,KAAK,oBAAoB,OAAO,KAAK,sBAAsB;AAErF,QAAM,WAAW,MAAM;AAAA,IACrB,OAAO,cAAc;AAAA,IACrB,OAAO;AAAA,IACP;AAAA,EACF;AACA,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,MACL;AAAA,IAEF;AAAA,EACF;AACA,QAAM,cAAc,SAAS;AAI7B,QAAM,UAAwC,SAAS,YACnD,sBAAsB,SAAS,SAAS,IACxC;AASJ,MAAI;AACF,sBAAkB,WAAW;AAAA,EAC/B,SAAS,KAAK;AACZ,WAAO,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,EAC9D;AAEA,QAAM,UAAU,aAAa,OAAO,OAAO;AAC3C,QAAM,SAAS,OAAO,SAAS;AAK/B,MAAI,WAAW,eAAe;AAC5B,UAAM,SAAS,MAAM,wBAAwB;AAAA,MAC3C;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,OAAO;AAAA,MACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC/B,CAAC;AACD,QAAI,OAAO,MAAO,qBAAoB,aAAa,QAAQ,MAAM;AACjE,WAAO,YAAY;AACnB,UAAM,oBAAoB,QAAQ,WAAW,CAAC;AAC9C,WAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAAA,EAC/D;AAIA,MAAI,qBAAmC,CAAC;AACxC,MAAI,gBAA8B,CAAC;AACnC,MAAI,WAAW,QAAQ;AACrB,UAAM,kBAAkB,MAAM,wBAAwB,aAAa,SAAS,UAAU;AAKtF,UAAM,WAAW,UACb,CAAC,IACA,OAAO,KAAK,wBAAwB,WAAW,CAAC;AACrD,UAAM,aAAa,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,QAAQ,CAAC,CAAC;AACjE,yBAAqB,WAAW;AAAA,MAC9B,CAAC,OAAO,oBAAoB,aAAa,EAAE,KAAK;AAAA,IAClD;AACA,oBAAgB,gBAAgB,OAAO,CAAC,OAAO,CAAC,mBAAmB,SAAS,EAAE,CAAC;AAAA,EACjF;AAKA,MAAI,mBAAmB,WAAW,GAAG;AACnC,UAAM,SAAS,MAAM,mBAAmB;AAAA,MACtC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,OAAO;AAAA,MACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC/B,CAAC;AACD,WAAO,YAAY;AACnB,UAAM,oBAAoB,QAAQ,WAAW,CAAC;AAC9C,WAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAAA,EAC/D;AAEA,QAAM,UAA2B;AAAA,IAC/B,MAAM,wBAAwB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT;AAAA,MACA,OAAO,OAAO;AAAA,IAChB,CAAC;AAAA,EACH;AAMA,MAAI,cAAc,SAAS,GAAG;AAC5B,YAAQ;AAAA,MACN,MAAM,mBAAmB;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAO,OAAO;AAAA,QACd,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAAA,EACF,WAAW,OAAO,OAAO;AACvB,UAAM,cAA6B;AAAA,MACjC;AAAA,MACA;AAAA,MACA,SAAS,CAAC;AAAA,MACV,UAAU,CAAC;AAAA,IACb;AACA,QAAI,QAAQ;AAIV,kBAAY,QAAQ,KAAK;AAAA,QACvB,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,QACE;AAAA,MACJ,CAAC;AAAA,IACH,OAAO;AACL,0BAAoB,aAAa,QAAQ,WAAW;AAAA,IACtD;AACA,YAAQ,KAAK,WAAW;AAAA,EAC1B;AAEA,QAAM,SAAwB;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,SAAS,QAAQ,QAAQ,CAAC,MAAM,EAAE,OAAO;AAAA,IACzC,UAAU,QAAQ,QAAQ,CAAC,MAAM,EAAE,QAAQ;AAAA,IAC3C,WAAW;AAAA,EACb;AACA,QAAM,oBAAoB,QAAQ,WAAW,CAAC;AAC9C,SAAO,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,IAAI;AAC/D;","names":[]}

package/dist/{upgrade-55AFPJEF.js → upgrade-JLSCNAQA.js}

@@ -4,38 +4,40 @@ import {
   resolveCliEntry,
   syncConnector,
   upgradeViaMarketplace
-} from "./chunk-KIRCPLM4.js";
-import "./chunk-LF76VPGQ.js";
-import "./chunk-QKLJU4JX.js";
+} from "./chunk-JO2IM2JL.js";
+import "./chunk-IBLYVAWH.js";
+import "./chunk-2Y2MZRLP.js";
 import "./chunk-UM5S7DKK.js";
-import "./chunk-NBUEL74R.js";
+import "./chunk-JFXL4HYA.js";
 import "./chunk-OPXAP3AC.js";
 import {
+  buildConnectorSummary,
   fail,
+  maybePrintBanner,
   parseScope,
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-7HUUINPB.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-ZMLVR4J7.js";
+} from "./chunk-5Z36KVU2.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-NWLRJNXM.js";
-import "./chunk-G4CEELKO.js";
-import "./chunk-25CPWJA7.js";
-import "./chunk-56R2ER7K.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
-import "./chunk-VVFDU4IX.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
+import "./chunk-WFEHWTLM.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
 import {
   ensureHomeBin,
   homeBinPath
-} from "./chunk-IXOQDZWC.js";
+} from "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/upgrade.ts
 import { parseArgs } from "util";
@@ -53,10 +55,13 @@ async function run(argv) {
       targets: { type: "string" },
       connector: { type: "string" },
       project: { type: "string" },
-      "dry-run": { type: "boolean", default: false }
+      "dry-run": { type: "boolean", default: false },
+      // Decorative-banner suppressor (no effect on command output bytes).
+      quiet: { type: "boolean", default: false }
     },
     allowPositionals: false
   });
+  maybePrintBanner({ quiet: values.quiet });
   const channel = values.channel;
   if (channel !== "stable" && channel !== "latest") {
     return fail(`invalid --channel "${channel}" (use stable|latest)`);
@@ -88,6 +93,7 @@ async function run(argv) {
       ...targets ? { targets } : {}
     };
     const result = method === "marketplace" ? await upgradeViaMarketplace(opts) : await syncConnector(opts);
+    result.connector = buildConnectorSummary(connector);
     print(renderInstallResult(result, "upgrade"));
     if (result.changes.some((c) => c.action === "warn")) hadWarn = true;
     print("");
@@ -127,4 +133,4 @@ Refreshed home binary pointer: ${binPath}`);
 export {
   run
 };
-//# sourceMappingURL=upgrade-55AFPJEF.js.map
+//# sourceMappingURL=upgrade-JLSCNAQA.js.map