@ken-jo/agent-connector 0.3.1 → 0.4.0

package/dist/sdk/test.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+import {
+  compileMatcher,
+  eventMatcherSubject
+} from "../chunk-CIRDOY2V.js";
+import "../chunk-BCHWFTV4.js";
+import "../chunk-KHO5WNTP.js";
+import {
+  SURFACE_PREDICATES
+} from "../chunk-76FUSVIA.js";
+import "../chunk-KGJWE6A2.js";
+import "../chunk-ADTHT2FN.js";
+import {
+  allAdapters,
+  loadAdapter
+} from "../chunk-3PFFTFCU.js";
+import "../chunk-N6HH7K6P.js";
+import "../chunk-TRQKHP7D.js";
+
+// src/sdk/test-harness.ts
+function declaredGlobalSurfaces(connector) {
+  const out = [];
+  if (connector.server) out.push("server");
+  if (Object.keys(connector.hooks).length > 0) out.push("hooks");
+  if (connector.commands.length > 0) out.push("commands");
+  if (connector.skills.length > 0) out.push("skills");
+  if (connector.subagents.length > 0) out.push("subagents");
+  if (connector.memory.length > 0) out.push("memory");
+  if (connector.statusline) out.push("statusline");
+  if (connector.actions.length > 0) out.push("actions");
+  return out;
+}
+function platformScopedSurfacesFor(override) {
+  const out = [];
+  if (!override) return out;
+  if ((override.configPatch?.length ?? 0) > 0) out.push("configPatch");
+  if (override.nativeHooks != null && Object.keys(override.nativeHooks).length > 0) {
+    out.push("nativeHooks");
+  }
+  return out;
+}
+function isDisabledForHost(connector, host, surface) {
+  const override = connector.platforms[host];
+  if (!override) return false;
+  switch (surface) {
+    case "server":
+      return override.server === false;
+    case "hooks":
+      return override.hooks === false;
+    case "commands":
+      return override.commands === false;
+    case "skills":
+      return override.skills === false;
+    case "subagents":
+      return override.subagents === false;
+    case "memory":
+      return override.memory === false;
+    case "statusline":
+      return override.statusline === false;
+    case "actions":
+    case "configPatch":
+    case "nativeHooks":
+      return false;
+  }
+}
+async function explain(connector) {
+  const globalSurfaces = declaredGlobalSurfaces(connector);
+  const adapters = await allAdapters();
+  const rows = [];
+  for (const adapter of adapters) {
+    const override = connector.platforms[adapter.id];
+    const surfaces = [
+      ...globalSurfaces,
+      ...platformScopedSurfacesFor(override)
+    ];
+    for (const surface of surfaces) {
+      if (isDisabledForHost(connector, adapter.id, surface)) {
+        rows.push({
+          host: adapter.id,
+          surface,
+          support: "disabled",
+          reason: `connector opted out for ${adapter.id} (platforms.${adapter.id}.${surface} = false)`
+        });
+        continue;
+      }
+      const native = SURFACE_PREDICATES[surface](adapter.capabilities);
+      rows.push({
+        host: adapter.id,
+        surface,
+        support: native ? "native" : "skip-warn",
+        reason: explainReason(adapter.id, surface, native)
+      });
+    }
+  }
+  rows.sort(
+    (a, b) => a.host === b.host ? a.surface.localeCompare(b.surface) : a.host.localeCompare(b.host)
+  );
+  return rows;
+}
+function explainReason(host, surface, native) {
+  if (surface === "server") {
+    return native ? `${host} advertises an MCP transport (capability-based; registration may be host-managed)` : `${host} advertises no MCP transport; install skip-warns`;
+  }
+  return native ? `${host} natively supports ${surface}` : `${host} cannot honor ${surface}; install skip-warns`;
+}
+function coerceInput(input) {
+  if (input == null) return {};
+  if (typeof input === "string") {
+    const trimmed = input.trim();
+    if (trimmed === "") return {};
+    try {
+      return JSON.parse(trimmed);
+    } catch {
+      return {};
+    }
+  }
+  return input;
+}
+function normalizeResponse(value) {
+  if (value == null || typeof value !== "object") return {};
+  return value;
+}
+function parseReplyStdout(stdout) {
+  if (stdout == null || stdout.trim() === "") return void 0;
+  try {
+    const value = JSON.parse(stdout);
+    return value != null && typeof value === "object" ? value : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== typeof b || a == null || b == null) return false;
+  if (typeof a !== "object") return false;
+  const aArr = Array.isArray(a);
+  if (aArr !== Array.isArray(b)) return false;
+  if (aArr) {
+    const x2 = a;
+    const y2 = b;
+    return x2.length === y2.length && x2.every((v, i) => deepEqual(v, y2[i]));
+  }
+  const x = a;
+  const y = b;
+  const xk = Object.keys(x);
+  const yk = Object.keys(y);
+  return xk.length === yk.length && xk.every((k) => deepEqual(x[k], y[k]));
+}
+function judgeHookHonor(host, event, response, stdout) {
+  const decision = response.decision;
+  if (decision === void 0 || decision === "allow") {
+    return { honored: true, reason: "pass-through allow" };
+  }
+  const reply = parseReplyStdout(stdout);
+  const hso = reply?.hookSpecificOutput;
+  if (decision === "context") {
+    const want = response.additionalContext;
+    const got = hso?.additionalContext ?? reply?.systemMessage;
+    if (reply && got === want) {
+      return { honored: true, reason: `${host} injects context on ${event}` };
+    }
+    return {
+      honored: false,
+      reason: `${host} drops context on ${event} (no stdout path)`
+    };
+  }
+  if (decision === "deny") {
+    if (!reply) {
+      return {
+        honored: false,
+        reason: `${host} drops deny on ${event} (deny not honored; fails open to allow)`
+      };
+    }
+    if (hso?.permissionDecision === "deny" || hso?.decision?.behavior === "deny") {
+      return { honored: true, reason: `${host} blocks ${event}` };
+    }
+    if (reply.decision === "block") {
+      return {
+        honored: true,
+        reason: `${host} continues the session/subagent on ${event} (persistence) \u2014 NOT a block`
+      };
+    }
+    if (hso?.additionalContext != null) {
+      return {
+        honored: false,
+        reason: `${host} degrades deny to a context note on ${event}; spawn/failure not blocked`
+      };
+    }
+    return {
+      honored: false,
+      reason: `${host} drops deny on ${event} (deny not honored; fails open to allow)`
+    };
+  }
+  if (decision === "ask") {
+    if (hso?.permissionDecision === "ask") {
+      return { honored: true, reason: `${host} asks on ${event}` };
+    }
+    if (event === "PermissionRequest" && !reply) {
+      return {
+        honored: true,
+        reason: `${host} shows the native confirmation dialog on ${event} (the ask)`
+      };
+    }
+    return {
+      honored: false,
+      reason: `${host} drops ask on ${event} (no ask path)`
+    };
+  }
+  const wrote = hso?.updatedInput ?? hso?.decision?.updatedInput;
+  if (reply && wrote !== void 0 && deepEqual(wrote, response.updatedInput)) {
+    return { honored: true, reason: `${host} rewrites tool input on ${event}` };
+  }
+  return {
+    honored: false,
+    reason: `${host} drops modify on ${event} (modify not honored)`
+  };
+}
+async function simulate(connector, opts) {
+  try {
+    const adapter = await loadAdapter(opts.host);
+    if (!adapter) {
+      return { honored: false, reason: `unknown host "${opts.host}"` };
+    }
+    if (opts.surface === "statusline") {
+      if (!(adapter.capabilities.supportsStatusline ?? false) || !adapter.parseStatusInput || !adapter.formatStatusOutput) {
+        return { honored: false, reason: `${opts.host} has no statusline surface` };
+      }
+      if (!connector.statusline || typeof connector.statusline.render !== "function") {
+        return { honored: false, reason: "connector declares no statusline" };
+      }
+      const ctx = adapter.parseStatusInput(coerceInput(opts.input));
+      ctx.connectorId = connector.id;
+      if (ctx.capabilities == null) ctx.capabilities = adapter.capabilities;
+      const perHost2 = connector.statusline.hosts?.[opts.host]?.render;
+      const render = typeof perHost2 === "function" ? perHost2 : connector.statusline.render;
+      const rendered = await render(ctx);
+      const line = rendered == null ? "" : String(rendered);
+      const reply2 = adapter.formatStatusOutput(line);
+      return {
+        honored: true,
+        ...reply2.stdout !== void 0 ? { hostReply: reply2.stdout } : {},
+        reason: "rendered"
+      };
+    }
+    const event = opts.event;
+    if (!event) {
+      return { honored: false, reason: 'event is required when surface === "hooks"' };
+    }
+    if (!adapter.parseEvent || !adapter.formatReply) {
+      return { honored: false, reason: `${opts.host} has no hook runtime (mcp-only)` };
+    }
+    const evt = adapter.parseEvent(event, coerceInput(opts.input));
+    evt.connectorId = connector.id;
+    evt.capabilities = adapter.capabilities;
+    const definition = connector.hooks[event];
+    if (!definition || typeof definition.handler !== "function") {
+      return { honored: false, reason: `connector declares no ${event} handler` };
+    }
+    const subject = eventMatcherSubject(evt);
+    if (subject !== void 0) {
+      const re = compileMatcher(definition.matcher);
+      if (re && !re.test(subject)) {
+        return {
+          honored: true,
+          reason: `matcher excludes ${subject} (handler not run)`
+        };
+      }
+    }
+    const perHost = definition.hosts?.[opts.host]?.handler;
+    const handler = typeof perHost === "function" ? perHost : definition.handler;
+    const response = normalizeResponse(
+      await handler(evt)
+    );
+    const reply = adapter.formatReply(event, response);
+    const verdict = judgeHookHonor(String(opts.host), event, response, reply.stdout);
+    return {
+      honored: verdict.honored,
+      ...reply.stdout !== void 0 ? { hostReply: reply.stdout } : {},
+      reason: verdict.reason
+    };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const verb = opts.surface === "statusline" ? "render" : "handler";
+    return { honored: false, reason: `${verb} threw: ${message}` };
+  }
+}
+export {
+  explain,
+  simulate
+};
+//# sourceMappingURL=test.js.map

package/dist/sdk/test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sdk/test-harness.ts"],"sourcesContent":["/**\n * sdk/test-harness — the SHIPPED, OFFLINE behavioral harness.\n *\n * Two read-only tools a connector author runs WITHOUT installing anything or\n * touching the host's filesystem:\n *\n *   • `explain(connector)` — the static per-host × per-DECLARED-surface matrix:\n *     for every registered host and every surface the connector actually ships,\n *     is it `native` (the host can honor it), `disabled` (the connector opted\n *     out for that host via `platforms[host].<surface> === false`), or\n *     `skip-warn` (the host cannot honor it → install would skip-warn)?\n *\n *   • `simulate(connector, opts)` — runs the REAL adapter parse → handler →\n *     format chain INLINE against a host-shaped raw payload and reports whether\n *     the host actually HONORS the connector's response (the trustworthy part:\n *     it surfaces the documented degradations, e.g. Codex silently dropping a\n *     UserPromptSubmit \"context\" injection that has no stdout path).\n *\n * It deliberately does NOT import the runtime entrypoints (runHook /\n * runStatusline) — those load the REGISTERED connector from disk and record\n * telemetry. The harness instead re-implements the tiny parse→handler→format\n * chain against the in-memory connector + the adapter, mirroring the runtime's\n * input tolerance (empty/malformed payload → `{}`) and its fail-safe envelope.\n */\n\nimport type {\n  HookEventName,\n  HookResponse,\n  PlatformId,\n  PlatformOverride,\n  ResolvedConnector,\n} from \"../core/types.js\";\nimport { allAdapters, loadAdapter } from \"../adapters/registry.js\";\nimport type { NormalizedEvent } from \"../adapters/spi.js\";\nimport {\n  compileMatcher,\n  eventMatcherSubject,\n} from \"../runtime/hook-entrypoint.js\";\nimport type { SurfaceName } from \"./introspect.js\";\nimport { SURFACE_PREDICATES } from \"./introspect.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// explain — the static per-host × per-declared-surface matrix\n// ─────────────────────────────────────────────────────────────────────────\n\n/** One cell of the {@link explain} matrix: a host × a declared surface. */\nexport interface ExplainRow {\n  host: PlatformId;\n  surface: SurfaceName;\n  /**\n   *  - \"native\"    — the host's capabilities pass the surface predicate.\n   *  - \"disabled\"  — the connector opted out for this host\n   *                  (`platforms[host].<surface> === false`).\n   *  - \"skip-warn\" — the host cannot honor it; install would skip-warn.\n   */\n  support: \"native\" | \"skip-warn\" | \"disabled\";\n  reason: string;\n}\n\n/**\n * The GLOBAL surfaces a connector declares (these apply to every host — only\n * declared surfaces get a matrix row). The two platform-scoped surfaces\n * (`configPatch` / `nativeHooks`) are deliberately EXCLUDED here: they are\n * declared under one specific `platforms[host]`, so each is added PER HOST in\n * {@link explain} (see {@link platformScopedSurfacesFor}) — adding them globally\n * would falsely promise a configPatch row on hosts that never declared it.\n */\nfunction declaredGlobalSurfaces(connector: ResolvedConnector): SurfaceName[] {\n  const out: SurfaceName[] = [];\n  if (connector.server) out.push(\"server\");\n  if (Object.keys(connector.hooks).length > 0) out.push(\"hooks\");\n  if (connector.commands.length > 0) out.push(\"commands\");\n  if (connector.skills.length > 0) out.push(\"skills\");\n  if (connector.subagents.length > 0) out.push(\"subagents\");\n  if (connector.memory.length > 0) out.push(\"memory\");\n  if (connector.statusline) out.push(\"statusline\");\n  if (connector.actions.length > 0) out.push(\"actions\");\n  return out;\n}\n\n/**\n * The platform-scoped surfaces (`configPatch` / `nativeHooks`) THIS host\n * actually declares — keyed off the host's own `platforms[host]` override, so a\n * configPatch declared under claude-code never shows up as a row for codex.\n */\nfunction platformScopedSurfacesFor(\n  override: PlatformOverride | undefined,\n): SurfaceName[] {\n  const out: SurfaceName[] = [];\n  if (!override) return out;\n  if ((override.configPatch?.length ?? 0) > 0) out.push(\"configPatch\");\n  if (override.nativeHooks != null && Object.keys(override.nativeHooks).length > 0) {\n    out.push(\"nativeHooks\");\n  }\n  return out;\n}\n\n/**\n * Is the surface explicitly DISABLED for this host? Mirrors the per-host opt-out\n * the installer honors: a boolean-or-object surface override is \"disabled\" only\n * when set to the literal `false` (the object form is a tuning, not an opt-out).\n * `configPatch` / `nativeHooks` have no boolean opt-out form — declaring them is\n * the opt-in, so they are never \"disabled\".\n */\nfunction isDisabledForHost(\n  connector: ResolvedConnector,\n  host: PlatformId,\n  surface: SurfaceName,\n): boolean {\n  const override = connector.platforms[host];\n  if (!override) return false;\n  switch (surface) {\n    case \"server\":\n      return override.server === false;\n    case \"hooks\":\n      return override.hooks === false;\n    case \"commands\":\n      return override.commands === false;\n    case \"skills\":\n      return override.skills === false;\n    case \"subagents\":\n      return override.subagents === false;\n    case \"memory\":\n      return override.memory === false;\n    case \"statusline\":\n      return override.statusline === false;\n    case \"actions\":\n    case \"configPatch\":\n    case \"nativeHooks\":\n      // No per-host boolean opt-out form (declaring them is the opt-in).\n      return false;\n  }\n}\n\n/**\n * The static support matrix: every registered host × every surface the\n * connector declares. Rows are sorted by host then surface for stable output.\n * Pure read of the adapter capabilities — installs nothing, writes nothing.\n */\nexport async function explain(connector: ResolvedConnector): Promise<ExplainRow[]> {\n  const globalSurfaces = declaredGlobalSurfaces(connector);\n  const adapters = await allAdapters();\n  const rows: ExplainRow[] = [];\n\n  for (const adapter of adapters) {\n    // Per-host surface set = the global surfaces every host gets a row for, plus\n    // the platform-scoped surfaces THIS host actually declares (configPatch /\n    // nativeHooks live under platforms[host], so they are host-local).\n    const override = connector.platforms[adapter.id];\n    const surfaces = [\n      ...globalSurfaces,\n      ...platformScopedSurfacesFor(override),\n    ];\n    for (const surface of surfaces) {\n      if (isDisabledForHost(connector, adapter.id, surface)) {\n        rows.push({\n          host: adapter.id,\n          surface,\n          support: \"disabled\",\n          reason: `connector opted out for ${adapter.id} (platforms.${adapter.id}.${surface} = false)`,\n        });\n        continue;\n      }\n      const native = SURFACE_PREDICATES[surface](adapter.capabilities);\n      rows.push({\n        host: adapter.id,\n        surface,\n        support: native ? \"native\" : \"skip-warn\",\n        reason: explainReason(adapter.id, surface, native),\n      });\n    }\n  }\n\n  rows.sort((a, b) =>\n    a.host === b.host ? a.surface.localeCompare(b.surface) : a.host.localeCompare(b.host),\n  );\n  return rows;\n}\n\n/**\n * The human-readable reason for a native/skip-warn cell. `server` is a special\n * case: the predicate is CAPABILITY-based (the host advertises ≥1 MCP\n * transport), but advertising a transport does NOT guarantee a writable\n * registration — e.g. jetbrains-copilot advertises stdio yet its installServer\n * skip-warns because MCP is managed in IDE settings. So the server reason states\n * the verdict is capability-based and registration may be host-managed, rather\n * than promising a write. (A precise per-adapter installServer dry-run is a\n * Phase-2 enhancement — until then this avoids over-promising.)\n */\nfunction explainReason(host: PlatformId, surface: SurfaceName, native: boolean): string {\n  if (surface === \"server\") {\n    return native\n      ? `${host} advertises an MCP transport (capability-based; registration may be host-managed)`\n      : `${host} advertises no MCP transport; install skip-warns`;\n  }\n  return native\n    ? `${host} natively supports ${surface}`\n    : `${host} cannot honor ${surface}; install skip-warns`;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// simulate — the real adapter parse → handler → format chain, inline\n// ─────────────────────────────────────────────────────────────────────────\n\n/** What to drive through the harness: one host, one surface, one raw payload. */\nexport interface SimulateOptions {\n  surface: \"hooks\" | \"statusline\";\n  host: PlatformId | string;\n  /** REQUIRED when `surface === \"hooks\"`: which normalized lifecycle event. */\n  event?: HookEventName;\n  /** The host-shaped RAW payload (what the host would pipe in on stdin). */\n  input: unknown;\n}\n\n/** The harness verdict: did the host actually honor the connector's response? */\nexport interface SimulateResult {\n  /** True when the host's native reply carries the connector's intent. */\n  honored: boolean;\n  /** The host-native stdout the adapter would emit (when there is one). */\n  hostReply?: string;\n  /** Human-readable why — names the documented degradation when honored:false. */\n  reason: string;\n}\n\n/**\n * Tolerantly coerce the raw payload, mirroring the runtime's parseStdin: a\n * string is JSON-parsed (empty/malformed → `{}`); a nullish value → `{}`; any\n * other value (already-parsed object) is passed through untouched.\n */\nfunction coerceInput(input: unknown): unknown {\n  if (input == null) return {};\n  if (typeof input === \"string\") {\n    const trimmed = input.trim();\n    if (trimmed === \"\") return {};\n    try {\n      return JSON.parse(trimmed);\n    } catch {\n      return {};\n    }\n  }\n  return input;\n}\n\n/** Normalize a handler's return into a concrete response (void/non-object → `{}`). */\nfunction normalizeResponse(value: HookResponse | void): HookResponse {\n  if (value == null || typeof value !== \"object\") return {};\n  return value;\n}\n\n/**\n * The decoded shape of a host's native hook reply on stdout. Every json-stdio\n * adapter writes a SUBSET of these fields (claude-code / codex share the\n * `hookSpecificOutput` envelope; Stop-class continuation uses the TOP-LEVEL\n * `decision:\"block\"`). We read the DECODED fields — never substring-match the\n * serialized JSON, which a path/newline/quote in the payload would break.\n */\ninterface ParsedReply {\n  /** Top-level Stop-class continuation: {\"decision\":\"block\",\"reason\"}. */\n  decision?: unknown;\n  reason?: unknown;\n  /** Top-level Claude context channel (no adapter emits it yet; future-proofing). */\n  systemMessage?: unknown;\n  hookSpecificOutput?: {\n    hookEventName?: unknown;\n    additionalContext?: unknown;\n    permissionDecision?: unknown;\n    permissionDecisionReason?: unknown;\n    updatedInput?: unknown;\n    /** PermissionRequest nested envelope: decision:{behavior:\"allow\"|\"deny\", updatedInput?}. */\n    decision?: { behavior?: unknown; updatedInput?: unknown };\n  };\n}\n\n/**\n * Tolerantly decode a reply's stdout into {@link ParsedReply}. Empty / absent /\n * unparseable stdout is a legitimate \"no payload\" signal (the adapter wrote a\n * bare exit-0) → `undefined`, the honest \"this decision had no stdout path\"\n * verdict input.\n */\nfunction parseReplyStdout(stdout: string | undefined): ParsedReply | undefined {\n  if (stdout == null || stdout.trim() === \"\") return undefined;\n  try {\n    const value = JSON.parse(stdout);\n    return value != null && typeof value === \"object\"\n      ? (value as ParsedReply)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Structural deep-equal for plain JSON values (objects/arrays/primitives). */\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== typeof b || a == null || b == null) return false;\n  if (typeof a !== \"object\") return false;\n  const aArr = Array.isArray(a);\n  if (aArr !== Array.isArray(b)) return false;\n  if (aArr) {\n    const x = a as unknown[];\n    const y = b as unknown[];\n    return x.length === y.length && x.every((v, i) => deepEqual(v, y[i]));\n  }\n  const x = a as Record<string, unknown>;\n  const y = b as Record<string, unknown>;\n  const xk = Object.keys(x);\n  const yk = Object.keys(y);\n  return xk.length === yk.length && xk.every((k) => deepEqual(x[k], y[k]));\n}\n\n/**\n * Decide whether the host HONORED a decision-bearing response, judging the\n * PARSED reply against each adapter's ACTUAL (event, decision) contract — never\n * by substring-matching the serialized JSON. `allow`/no-decision is always\n * pass-through honored; every other decision is honored only when the decoded\n * reply carries that exact intent, and the verdict names the documented\n * degradation when it does not.\n */\nfunction judgeHookHonor(\n  host: string,\n  event: HookEventName,\n  response: HookResponse,\n  stdout: string | undefined,\n): { honored: boolean; reason: string } {\n  const decision = response.decision;\n  if (decision === undefined || decision === \"allow\") {\n    return { honored: true, reason: \"pass-through allow\" };\n  }\n\n  const reply = parseReplyStdout(stdout);\n  const hso = reply?.hookSpecificOutput;\n\n  if (decision === \"context\") {\n    // Honored only when the DECODED additionalContext equals what the handler\n    // asked to inject (claude-code's hookSpecificOutput.additionalContext, or a\n    // future top-level systemMessage). codex only emits this on\n    // SessionStart/PostToolUse — every other event silently drops it.\n    const want = response.additionalContext;\n    const got = hso?.additionalContext ?? reply?.systemMessage;\n    if (reply && got === want) {\n      return { honored: true, reason: `${host} injects context on ${event}` };\n    }\n    return {\n      honored: false,\n      reason: `${host} drops context on ${event} (no stdout path)`,\n    };\n  }\n\n  if (decision === \"deny\") {\n    if (!reply) {\n      return {\n        honored: false,\n        reason: `${host} drops deny on ${event} (deny not honored; fails open to allow)`,\n      };\n    }\n    // A real block: PreToolUse's permissionDecision:\"deny\", or the\n    // PermissionRequest nested decision.behavior:\"deny\".\n    if (hso?.permissionDecision === \"deny\" || hso?.decision?.behavior === \"deny\") {\n      return { honored: true, reason: `${host} blocks ${event}` };\n    }\n    // Stop-class continuation: top-level decision:\"block\" KEEPS the session /\n    // subagent running (persistence) — the SEMANTIC OPPOSITE of a block. Honored\n    // (the reply carried the intent), but the reason must not say \"blocks\".\n    if (reply.decision === \"block\") {\n      return {\n        honored: true,\n        reason: `${host} continues the session/subagent on ${event} (persistence) — NOT a block`,\n      };\n    }\n    // SubagentStart / PostToolUseFailure DEGRADE a deny to a context note — the\n    // spawn/failure is not actually blocked.\n    if (hso?.additionalContext != null) {\n      return {\n        honored: false,\n        reason: `${host} degrades deny to a context note on ${event}; spawn/failure not blocked`,\n      };\n    }\n    return {\n      honored: false,\n      reason: `${host} drops deny on ${event} (deny not honored; fails open to allow)`,\n    };\n  }\n\n  if (decision === \"ask\") {\n    if (hso?.permissionDecision === \"ask\") {\n      return { honored: true, reason: `${host} asks on ${event}` };\n    }\n    // On PermissionRequest, ask/void falls through to the host's NATIVE dialog\n    // (the dialog IS the ask), which the adapter expresses as a bare exit-0.\n    if (event === \"PermissionRequest\" && !reply) {\n      return {\n        honored: true,\n        reason: `${host} shows the native confirmation dialog on ${event} (the ask)`,\n      };\n    }\n    return {\n      honored: false,\n      reason: `${host} drops ask on ${event} (no ask path)`,\n    };\n  }\n\n  // decision === \"modify\": honored only when the decoded updatedInput deep-equals\n  // what the handler asked to write (hookSpecificOutput.updatedInput, or the\n  // PermissionRequest nested decision.updatedInput).\n  const wrote = hso?.updatedInput ?? hso?.decision?.updatedInput;\n  if (reply && wrote !== undefined && deepEqual(wrote, response.updatedInput)) {\n    return { honored: true, reason: `${host} rewrites tool input on ${event}` };\n  }\n  return {\n    honored: false,\n    reason: `${host} drops modify on ${event} (modify not honored)`,\n  };\n}\n\n/**\n * Run the connector against ONE host-shaped payload through the REAL adapter\n * path and report whether the host honors the response. Self-contained (does not\n * touch the registered-connector loader or telemetry) and fail-safe: any throw\n * in the chain degrades to `honored:false` with the error message, never rejects.\n */\nexport async function simulate(\n  connector: ResolvedConnector,\n  opts: SimulateOptions,\n): Promise<SimulateResult> {\n  try {\n    const adapter = await loadAdapter(opts.host);\n    if (!adapter) {\n      return { honored: false, reason: `unknown host \"${opts.host}\"` };\n    }\n\n    if (opts.surface === \"statusline\") {\n      if (\n        !(adapter.capabilities.supportsStatusline ?? false) ||\n        !adapter.parseStatusInput ||\n        !adapter.formatStatusOutput\n      ) {\n        return { honored: false, reason: `${opts.host} has no statusline surface` };\n      }\n      // Guarding on the TOP-LEVEL render is sufficient: a `hosts`-only statusline\n      // (a hosts: map with no top-level render) is rejected at defineConnector, so\n      // a connector that targets `opts.host` only via hosts[] still has a top-level\n      // render here. (If that author-time invariant ever relaxes, revisit this.)\n      if (!connector.statusline || typeof connector.statusline.render !== \"function\") {\n        return { honored: false, reason: \"connector declares no statusline\" };\n      }\n      const ctx = adapter.parseStatusInput(coerceInput(opts.input));\n      ctx.connectorId = connector.id;\n      // Defensive: parseStatusInput now sets ctx.capabilities (it is required on\n      // StatuslineContext), but a future adapter could omit it — backfill from\n      // the adapter so render() can always read ctx.capabilities.\n      if (ctx.capabilities == null) ctx.capabilities = adapter.capabilities;\n      // Per-host render override, mirroring the runtime: hosts[host].render wins\n      // over the top-level render; an unlisted host falls back to top-level.\n      const perHost = connector.statusline.hosts?.[opts.host as PlatformId]?.render;\n      const render =\n        typeof perHost === \"function\" ? perHost : connector.statusline.render;\n      const rendered = await render(ctx);\n      const line = rendered == null ? \"\" : String(rendered);\n      const reply = adapter.formatStatusOutput(line);\n      return {\n        honored: true,\n        ...(reply.stdout !== undefined ? { hostReply: reply.stdout } : {}),\n        reason: \"rendered\",\n      };\n    }\n\n    // surface === \"hooks\"\n    const event = opts.event;\n    if (!event) {\n      return { honored: false, reason: \"event is required when surface === \\\"hooks\\\"\" };\n    }\n    if (!adapter.parseEvent || !adapter.formatReply) {\n      return { honored: false, reason: `${opts.host} has no hook runtime (mcp-only)` };\n    }\n\n    const evt = adapter.parseEvent(event, coerceInput(opts.input));\n    evt.connectorId = connector.id;\n    // Mirror the runtime: runHook backfills evt.capabilities from the adapter so\n    // a handler reading evt.capabilities behaves the same here. (scope/telemetry\n    // are runtime-only — recovered from the registered meta / store, which the\n    // offline harness deliberately never touches — so they stay undefined.)\n    evt.capabilities = adapter.capabilities;\n\n    // Guarding on the TOP-LEVEL handler is sufficient: a `hosts`-only hook (a\n    // hosts: map with no top-level handler) is rejected at defineConnector, so a\n    // host targeted only via hosts[] still has a top-level handler here. (If that\n    // author-time invariant ever relaxes, revisit this.)\n    const definition = connector.hooks[event];\n    if (!definition || typeof definition.handler !== \"function\") {\n      return { honored: false, reason: `connector declares no ${event} handler` };\n    }\n\n    // Matcher filtering, in lockstep with runHook: when the connector's matcher\n    // is set and the event's subject (tool name, or agent type for Subagent*\n    // events) does not match, the host never runs the handler — so the harness\n    // must NOT run it either, and reports the (honored) exclusion. Reuses the\n    // runtime helpers directly so the two stay byte-for-byte aligned.\n    const subject = eventMatcherSubject(evt as NormalizedEvent);\n    if (subject !== undefined) {\n      const re = compileMatcher(definition.matcher);\n      if (re && !re.test(subject)) {\n        return {\n          honored: true,\n          reason: `matcher excludes ${subject} (handler not run)`,\n        };\n      }\n    }\n\n    // Per-host handler override, mirroring runHook: hosts[host].handler wins\n    // over the top-level handler; an unlisted host falls back to top-level.\n    const perHost = definition.hosts?.[opts.host as PlatformId]?.handler;\n    const handler = typeof perHost === \"function\" ? perHost : definition.handler;\n    const response = normalizeResponse(\n      await handler(evt as never),\n    );\n    const reply = adapter.formatReply(event, response);\n    const verdict = judgeHookHonor(String(opts.host), event, response, reply.stdout);\n    return {\n      honored: verdict.honored,\n      ...(reply.stdout !== undefined ? { hostReply: reply.stdout } : {}),\n      reason: verdict.reason,\n    };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    const verb = opts.surface === \"statusline\" ? \"render\" : \"handler\";\n    return { honored: false, reason: `${verb} threw: ${message}` };\n  }\n}\n"],"mappings":"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","names":["x","y","perHost","reply"]}

package/dist/{serve-3C2VFPAY.js → serve-D3GO36UT.js}

@@ -1,17 +1,20 @@
 #!/usr/bin/env node
 import {
   fail
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-KGXDYGNJ.js";
 import {
   runServe
-} from "./chunk-ZAM4M7LI.js";
-import "./chunk-BCHWFTV4.js";
+} from "./chunk-BHUCB6LY.js";
 import "./chunk-OP4KBXUO.js";
-import "./chunk-KVAAFYRR.js";
-import "./chunk-NJU275US.js";
-import "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-22Y24V7O.js";
+import "./chunk-J3D5W5T2.js";
+import "./chunk-CIRDOY2V.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
+import "./chunk-BXGFUENQ.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -63,4 +66,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=serve-3C2VFPAY.js.map
+//# sourceMappingURL=serve-D3GO36UT.js.map

package/dist/{serve-3C2VFPAY.js.map → serve-D3GO36UT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/serve.ts"],"sourcesContent":["/**\n * cli/commands/serve — the telemetry-wrapping MCP stdio proxy entrypoint.\n *\n *   agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <realCommand> <realArgs...>\n *\n * A stdio MCP server that opts into transparent telemetry has its host config\n * rewritten to launch THIS instead of the server directly. We split argv at the\n * literal `--` separator: flags on the left, the real server command + args on\n * the right (taken verbatim). The optional `--scope` flag records the install\n * dimension (global user vs project-local) onto telemetry; it is absent for\n * configs written before scope plumbing existed → the runtime reads \"unknown\".\n * The optional `--host` flag carries the install TARGET platform id so the proxy\n * stamps hostPlatform correctly under a headless spawn; absent configs fall back\n * to runtime env detection.\n * runServe stands up the per-session telemetry context and proxies bytes both\n * ways, resolving with the child's exit code.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport type { PlatformId } from \"../../core/types.js\";\nimport type { TelemetryInstallScope } from \"../../telemetry/types.js\";\nimport { runServe } from \"../../runtime/index.js\";\nimport { fail } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  // Split at the FIRST literal \"--\": everything after it is the real server\n  // invocation and must be passed through verbatim (never re-parsed as flags).\n  const sepIndex = argv.indexOf(\"--\");\n  if (sepIndex === -1) {\n    return fail(\n      \"usage: agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <command> [args...]\",\n    );\n  }\n  const flagArgs = argv.slice(0, sepIndex);\n  const serverInvocation = argv.slice(sepIndex + 1);\n\n  // strict:false so an unknown FUTURE flag before `--` (written by a newer host\n  // config) is ignored instead of throwing — a parse throw here would prevent the\n  // real MCP server from ever spawning and wedge the host's tool call. We only\n  // read the two flags we understand; everything else is tolerated.\n  const { values } = parseArgs({\n    args: flagArgs,\n    options: {\n      connector: { type: \"string\" },\n      scope: { type: \"string\" },\n      // `--host <platformId>` bakes the install TARGET platform into the wrapper\n      // so the proxy stamps hostPlatform correctly under a headless spawn (where\n      // runtime env markers are absent). Optional + tolerated (strict:false).\n      host: { type: \"string\" },\n    },\n    allowPositionals: true,\n    strict: false,\n  });\n\n  // With strict:false, parseArgs types each value as string | boolean; we only\n  // accept the string form (a bare `--connector` flag with no value is invalid).\n  const connectorId = typeof values.connector === \"string\" ? values.connector : undefined;\n  if (!connectorId || connectorId.trim() === \"\") {\n    return fail(\"serve requires --connector <id>\");\n  }\n\n  // `--scope` is optional and only ever \"user\" | \"project\" (the wrapper emits\n  // exactly those). An unrecognized value is ignored rather than fatal so a\n  // future/older wrapper can never break a real tool call over a flag mismatch.\n  const rawScope = values.scope;\n  const installScope: TelemetryInstallScope | undefined =\n    rawScope === \"user\" || rawScope === \"project\" ? rawScope : undefined;\n\n  // `--host` carries the install TARGET platform id (string only). runServe\n  // validates it against the registry and falls back to runtime detection when\n  // it is absent or unrecognized — so a future/older wrapper never breaks here.\n  const hostPlatformOverride =\n    typeof values.host === \"string\" ? (values.host as PlatformId) : undefined;\n\n  const serverCommand = serverInvocation[0];\n  if (!serverCommand) {\n    return fail(\"serve requires a command after `--`\");\n  }\n  const serverArgs = serverInvocation.slice(1);\n\n  const code = await runServe({\n    connectorId,\n    serverCommand,\n    serverArgs,\n    installScope,\n    hostPlatformOverride,\n  });\n  process.exit(code);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,SAAS,iBAAiB;AAO1B,eAAsB,IAAI,MAAiC;AAGzD,QAAM,WAAW,KAAK,QAAQ,IAAI;AAClC,MAAI,aAAa,IAAI;AACnB,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACA,QAAM,WAAW,KAAK,MAAM,GAAG,QAAQ;AACvC,QAAM,mBAAmB,KAAK,MAAM,WAAW,CAAC;AAMhD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,OAAO,EAAE,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA,MAIxB,MAAM,EAAE,MAAM,SAAS;AAAA,IACzB;AAAA,IACA,kBAAkB;AAAA,IAClB,QAAQ;AAAA,EACV,CAAC;AAID,QAAM,cAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAC9E,MAAI,CAAC,eAAe,YAAY,KAAK,MAAM,IAAI;AAC7C,WAAO,KAAK,iCAAiC;AAAA,EAC/C;AAKA,QAAM,WAAW,OAAO;AACxB,QAAM,eACJ,aAAa,UAAU,aAAa,YAAY,WAAW;AAK7D,QAAM,uBACJ,OAAO,OAAO,SAAS,WAAY,OAAO,OAAsB;AAElE,QAAM,gBAAgB,iBAAiB,CAAC;AACxC,MAAI,CAAC,eAAe;AAClB,WAAO,KAAK,qCAAqC;AAAA,EACnD;AACA,QAAM,aAAa,iBAAiB,MAAM,CAAC;AAE3C,QAAM,OAAO,MAAM,SAAS;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,IAAI;AACnB;","names":[]}
+{"version":3,"sources":["../src/cli/commands/serve.ts"],"sourcesContent":["/**\n * cli/commands/serve — the telemetry-wrapping MCP stdio proxy entrypoint.\n *\n *   agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <realCommand> <realArgs...>\n *\n * A stdio MCP server that opts into transparent telemetry has its host config\n * rewritten to launch THIS instead of the server directly. We split argv at the\n * literal `--` separator: flags on the left, the real server command + args on\n * the right (taken verbatim). The optional `--scope` flag records the install\n * dimension (global user vs project-local) onto telemetry; it is absent for\n * configs written before scope plumbing existed → the runtime reads \"unknown\".\n * The optional `--host` flag carries the install TARGET platform id so the proxy\n * stamps hostPlatform correctly under a headless spawn; absent configs fall back\n * to runtime env detection.\n * runServe stands up the per-session telemetry context and proxies bytes both\n * ways, resolving with the child's exit code.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport type { PlatformId } from \"../../core/types.js\";\nimport type { TelemetryInstallScope } from \"../../telemetry/types.js\";\nimport { runServe } from \"../../runtime/index.js\";\nimport { fail } from \"../app.js\";\n\nexport async function run(argv: string[]): Promise<number> {\n  // Split at the FIRST literal \"--\": everything after it is the real server\n  // invocation and must be passed through verbatim (never re-parsed as flags).\n  const sepIndex = argv.indexOf(\"--\");\n  if (sepIndex === -1) {\n    return fail(\n      \"usage: agent-connector serve --connector <id> [--scope <user|project>] [--host <platformId>] -- <command> [args...]\",\n    );\n  }\n  const flagArgs = argv.slice(0, sepIndex);\n  const serverInvocation = argv.slice(sepIndex + 1);\n\n  // strict:false so an unknown FUTURE flag before `--` (written by a newer host\n  // config) is ignored instead of throwing — a parse throw here would prevent the\n  // real MCP server from ever spawning and wedge the host's tool call. We only\n  // read the two flags we understand; everything else is tolerated.\n  const { values } = parseArgs({\n    args: flagArgs,\n    options: {\n      connector: { type: \"string\" },\n      scope: { type: \"string\" },\n      // `--host <platformId>` bakes the install TARGET platform into the wrapper\n      // so the proxy stamps hostPlatform correctly under a headless spawn (where\n      // runtime env markers are absent). Optional + tolerated (strict:false).\n      host: { type: \"string\" },\n    },\n    allowPositionals: true,\n    strict: false,\n  });\n\n  // With strict:false, parseArgs types each value as string | boolean; we only\n  // accept the string form (a bare `--connector` flag with no value is invalid).\n  const connectorId = typeof values.connector === \"string\" ? values.connector : undefined;\n  if (!connectorId || connectorId.trim() === \"\") {\n    return fail(\"serve requires --connector <id>\");\n  }\n\n  // `--scope` is optional and only ever \"user\" | \"project\" (the wrapper emits\n  // exactly those). An unrecognized value is ignored rather than fatal so a\n  // future/older wrapper can never break a real tool call over a flag mismatch.\n  const rawScope = values.scope;\n  const installScope: TelemetryInstallScope | undefined =\n    rawScope === \"user\" || rawScope === \"project\" ? rawScope : undefined;\n\n  // `--host` carries the install TARGET platform id (string only). runServe\n  // validates it against the registry and falls back to runtime detection when\n  // it is absent or unrecognized — so a future/older wrapper never breaks here.\n  const hostPlatformOverride =\n    typeof values.host === \"string\" ? (values.host as PlatformId) : undefined;\n\n  const serverCommand = serverInvocation[0];\n  if (!serverCommand) {\n    return fail(\"serve requires a command after `--`\");\n  }\n  const serverArgs = serverInvocation.slice(1);\n\n  const code = await runServe({\n    connectorId,\n    serverCommand,\n    serverArgs,\n    installScope,\n    hostPlatformOverride,\n  });\n  process.exit(code);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAS,iBAAiB;AAO1B,eAAsB,IAAI,MAAiC;AAGzD,QAAM,WAAW,KAAK,QAAQ,IAAI;AAClC,MAAI,aAAa,IAAI;AACnB,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACA,QAAM,WAAW,KAAK,MAAM,GAAG,QAAQ;AACvC,QAAM,mBAAmB,KAAK,MAAM,WAAW,CAAC;AAMhD,QAAM,EAAE,OAAO,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS;AAAA,MACP,WAAW,EAAE,MAAM,SAAS;AAAA,MAC5B,OAAO,EAAE,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA,MAIxB,MAAM,EAAE,MAAM,SAAS;AAAA,IACzB;AAAA,IACA,kBAAkB;AAAA,IAClB,QAAQ;AAAA,EACV,CAAC;AAID,QAAM,cAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAC9E,MAAI,CAAC,eAAe,YAAY,KAAK,MAAM,IAAI;AAC7C,WAAO,KAAK,iCAAiC;AAAA,EAC/C;AAKA,QAAM,WAAW,OAAO;AACxB,QAAM,eACJ,aAAa,UAAU,aAAa,YAAY,WAAW;AAK7D,QAAM,uBACJ,OAAO,OAAO,SAAS,WAAY,OAAO,OAAsB;AAElE,QAAM,gBAAgB,iBAAiB,CAAC;AACxC,MAAI,CAAC,eAAe;AAClB,WAAO,KAAK,qCAAqC;AAAA,EACnD;AACA,QAAM,aAAa,iBAAiB,MAAM,CAAC;AAE3C,QAAM,OAAO,MAAM,SAAS;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,IAAI;AACnB;","names":[]}

package/dist/{status-MKQYX5MW.js → status-KOSKCETC.js}

@@ -6,17 +6,19 @@ import {
   fail,
   parseScope,
   print
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-KGXDYGNJ.js";
 import {
-  detectInstalledPlatforms,
-  loadAdapter
-} from "./chunk-NJU275US.js";
+  detectInstalledPlatforms
+} from "./chunk-J3D5W5T2.js";
 import {
   findConnectorConfig,
   listRegisteredConnectors,
   loadConnectorFromPath
-} from "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
+} from "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import {
+  loadAdapter
+} from "./chunk-3PFFTFCU.js";
 import "./chunk-N6HH7K6P.js";
 import {
   dataRoot,
@@ -135,4 +137,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=status-MKQYX5MW.js.map
+//# sourceMappingURL=status-KOSKCETC.js.map

package/dist/{status-MKQYX5MW.js.map → status-KOSKCETC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/commands/status.ts"],"sourcesContent":["/**\n * cli/commands/status — a light, glanceable install-state summary.\n *\n * There is NO MCP standard for \"which connectors are installed into which host\n * configs on this machine\" — distribution/wire standards (server.json, MCPB,\n * the lifecycle) cover publishing + the protocol, not local install state. So\n * `status` is purely agent-connector infrastructure, and we design it for the\n * everyday question it answers in one line per platform:\n *\n *   \"which of my connectors are present on which hosts?\"\n *\n * It REUSES detect (host enumeration) + the adapters' own config-path resolvers\n * (a read-only presence check) — NO new adapter SPI methods. Unlike `doctor`\n * (deep health checks, non-zero exit on failure) and `doctor --probe` (a live\n * protocol probe that FAILs on a dead server), `status` ALWAYS exits 0: it\n * describes, it never gates. A connector being absent is informational.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { readFileSync } from \"node:fs\";\n\nimport type { InstallScope, PlatformId, ResolvedConnector } from \"../../core/types.js\";\nimport type { InstallContext } from \"../../adapters/spi.js\";\nimport { detectInstalledPlatforms } from \"../../adapters/detect.js\";\nimport { loadAdapter } from \"../../adapters/registry.js\";\nimport {\n  findConnectorConfig,\n  listRegisteredConnectors,\n  loadConnectorFromPath,\n} from \"../../core/load-connector.js\";\nimport { marketplaceEvidence } from \"../../core/marketplace-state.js\";\nimport { dataRoot, homeBinPath } from \"../../core/paths.js\";\nimport { fail, parseScope, print } from \"../app.js\";\n\n/**\n * Resolve which connector(s) status reports on: an explicit --connector path or\n * a local config first, else every connector registered under the data-root\n * (what is actually installed). Empty array when none — status still lists the\n * detected platforms.\n */\nasync function resolveConnectors(\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<ResolvedConnector[]> {\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    try {\n      const { connector } = await loadConnectorFromPath(configPath);\n      return [connector];\n    } catch {\n      /* fall through to the registry */\n    }\n  }\n  return listRegisteredConnectors();\n}\n\nfunction buildContext(\n  connector: ResolvedConnector,\n  id: PlatformId,\n  scope: InstallScope,\n  projectDir: string,\n): InstallContext {\n  return {\n    connector,\n    scope: connector.platforms[id]?.scope ?? scope,\n    projectDir,\n    homeBinPath: homeBinPath(),\n    dataRoot: dataRoot(),\n    dryRun: true,\n  };\n}\n\n/** Read-only: does the file at `path` mention `needle`? Missing/unreadable → false. */\nfunction fileMentions(path: string, needle: string): boolean {\n  try {\n    return readFileSync(path, \"utf8\").includes(needle);\n  } catch {\n    return false;\n  }\n}\n\ninterface ConnStatus {\n  id: string;\n  serverPresent: boolean;\n  hooksPresent: boolean;\n  /**\n   * Delivery method actually present on this host: `direct` (managed entries in\n   * the host config), `marketplace` (the host's own plugin state / our install\n   * record), `both` (the double-install invariant is VIOLATED — doctor FAILs\n   * it), or null when absent.\n   */\n  method: \"direct\" | \"marketplace\" | \"both\" | null;\n}\ninterface StatusRow {\n  platform: PlatformId;\n  scope: InstallScope;\n  configPath: string;\n  connectors: ConnStatus[];\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      scope: { type: \"string\", default: \"user\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const connectors = await resolveConnectors(values.connector, projectDir);\n  const detected = await detectInstalledPlatforms(projectDir);\n\n  const rows: StatusRow[] = [];\n  for (const p of detected) {\n    const adapter = await loadAdapter(p.id);\n    if (!adapter) continue;\n    const connStatuses: ConnStatus[] = connectors.map((connector) => {\n      const ctx = buildContext(connector, p.id, scope, projectDir);\n      let serverPath = \"\";\n      let hookPath = \"\";\n      try {\n        serverPath = adapter.getServerConfigPath(ctx);\n      } catch {\n        /* adapter has no server config path */\n      }\n      try {\n        hookPath = adapter.getHookConfigPath(ctx);\n      } catch {\n        /* adapter has no hook config path */\n      }\n      const serverPresent = serverPath\n        ? fileMentions(serverPath, connector.id)\n        : false;\n      const hooksPresent = hookPath ? fileMentions(hookPath, connector.id) : false;\n      const direct = serverPresent || hooksPresent;\n      const viaMarketplace = marketplaceEvidence(connector.id, p.id) != null;\n      return {\n        id: connector.id,\n        serverPresent,\n        hooksPresent,\n        method: direct && viaMarketplace\n          ? (\"both\" as const)\n          : direct\n            ? (\"direct\" as const)\n            : viaMarketplace\n              ? (\"marketplace\" as const)\n              : null,\n      };\n    });\n    rows.push({\n      platform: p.id,\n      scope: p.scope,\n      configPath: p.configPath,\n      connectors: connStatuses,\n    });\n  }\n\n  if (values.json) {\n    print(JSON.stringify(rows, null, 2));\n    return 0;\n  }\n\n  if (rows.length === 0) {\n    print(\"status: no agent platforms detected.\");\n    return 0;\n  }\n  if (connectors.length === 0) {\n    print(\"status: no connectors found (pass --connector <path> or install one).\\n\");\n  }\n\n  for (const r of rows) {\n    print(`${r.platform}  [${r.scope}]  ${r.configPath}`);\n    if (r.connectors.length === 0) {\n      print(\"  (no connectors to check)\");\n    } else {\n      for (const c of r.connectors) {\n        const mark = c.method != null ? \"[installed]\" : \"[absent   ]\";\n        const server = c.serverPresent ? \"server ✓\" : \"server ·\";\n        const hooks = c.hooksPresent ? \"hooks ✓\" : \"hooks ·\";\n        // `both(!)` flags a violated one-method-per-host invariant — doctor's\n        // duplicate-registration check FAILs it with the fix.\n        const method =\n          c.method == null ? \"\" : c.method === \"both\" ? \"  (both!)\" : `  (${c.method})`;\n        print(`  ${mark} ${c.id}  ${server}  ${hooks}${method}`);\n      }\n    }\n    print(\"\");\n  }\n\n  // Always 0: status is descriptive (what is installed where), never a gate —\n  // that contrast with doctor (non-zero on FAIL) is the reason it exists.\n  return 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli/commands/status.ts"],"sourcesContent":["/**\n * cli/commands/status — a light, glanceable install-state summary.\n *\n * There is NO MCP standard for \"which connectors are installed into which host\n * configs on this machine\" — distribution/wire standards (server.json, MCPB,\n * the lifecycle) cover publishing + the protocol, not local install state. So\n * `status` is purely agent-connector infrastructure, and we design it for the\n * everyday question it answers in one line per platform:\n *\n *   \"which of my connectors are present on which hosts?\"\n *\n * It REUSES detect (host enumeration) + the adapters' own config-path resolvers\n * (a read-only presence check) — NO new adapter SPI methods. Unlike `doctor`\n * (deep health checks, non-zero exit on failure) and `doctor --probe` (a live\n * protocol probe that FAILs on a dead server), `status` ALWAYS exits 0: it\n * describes, it never gates. A connector being absent is informational.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { readFileSync } from \"node:fs\";\n\nimport type { InstallScope, PlatformId, ResolvedConnector } from \"../../core/types.js\";\nimport type { InstallContext } from \"../../adapters/spi.js\";\nimport { detectInstalledPlatforms } from \"../../adapters/detect.js\";\nimport { loadAdapter } from \"../../adapters/registry.js\";\nimport {\n  findConnectorConfig,\n  listRegisteredConnectors,\n  loadConnectorFromPath,\n} from \"../../core/load-connector.js\";\nimport { marketplaceEvidence } from \"../../core/marketplace-state.js\";\nimport { dataRoot, homeBinPath } from \"../../core/paths.js\";\nimport { fail, parseScope, print } from \"../app.js\";\n\n/**\n * Resolve which connector(s) status reports on: an explicit --connector path or\n * a local config first, else every connector registered under the data-root\n * (what is actually installed). Empty array when none — status still lists the\n * detected platforms.\n */\nasync function resolveConnectors(\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<ResolvedConnector[]> {\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    try {\n      const { connector } = await loadConnectorFromPath(configPath);\n      return [connector];\n    } catch {\n      /* fall through to the registry */\n    }\n  }\n  return listRegisteredConnectors();\n}\n\nfunction buildContext(\n  connector: ResolvedConnector,\n  id: PlatformId,\n  scope: InstallScope,\n  projectDir: string,\n): InstallContext {\n  return {\n    connector,\n    scope: connector.platforms[id]?.scope ?? scope,\n    projectDir,\n    homeBinPath: homeBinPath(),\n    dataRoot: dataRoot(),\n    dryRun: true,\n  };\n}\n\n/** Read-only: does the file at `path` mention `needle`? Missing/unreadable → false. */\nfunction fileMentions(path: string, needle: string): boolean {\n  try {\n    return readFileSync(path, \"utf8\").includes(needle);\n  } catch {\n    return false;\n  }\n}\n\ninterface ConnStatus {\n  id: string;\n  serverPresent: boolean;\n  hooksPresent: boolean;\n  /**\n   * Delivery method actually present on this host: `direct` (managed entries in\n   * the host config), `marketplace` (the host's own plugin state / our install\n   * record), `both` (the double-install invariant is VIOLATED — doctor FAILs\n   * it), or null when absent.\n   */\n  method: \"direct\" | \"marketplace\" | \"both\" | null;\n}\ninterface StatusRow {\n  platform: PlatformId;\n  scope: InstallScope;\n  configPath: string;\n  connectors: ConnStatus[];\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      scope: { type: \"string\", default: \"user\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  const projectDir = values.project ?? process.cwd();\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const connectors = await resolveConnectors(values.connector, projectDir);\n  const detected = await detectInstalledPlatforms(projectDir);\n\n  const rows: StatusRow[] = [];\n  for (const p of detected) {\n    const adapter = await loadAdapter(p.id);\n    if (!adapter) continue;\n    const connStatuses: ConnStatus[] = connectors.map((connector) => {\n      const ctx = buildContext(connector, p.id, scope, projectDir);\n      let serverPath = \"\";\n      let hookPath = \"\";\n      try {\n        serverPath = adapter.getServerConfigPath(ctx);\n      } catch {\n        /* adapter has no server config path */\n      }\n      try {\n        hookPath = adapter.getHookConfigPath(ctx);\n      } catch {\n        /* adapter has no hook config path */\n      }\n      const serverPresent = serverPath\n        ? fileMentions(serverPath, connector.id)\n        : false;\n      const hooksPresent = hookPath ? fileMentions(hookPath, connector.id) : false;\n      const direct = serverPresent || hooksPresent;\n      const viaMarketplace = marketplaceEvidence(connector.id, p.id) != null;\n      return {\n        id: connector.id,\n        serverPresent,\n        hooksPresent,\n        method: direct && viaMarketplace\n          ? (\"both\" as const)\n          : direct\n            ? (\"direct\" as const)\n            : viaMarketplace\n              ? (\"marketplace\" as const)\n              : null,\n      };\n    });\n    rows.push({\n      platform: p.id,\n      scope: p.scope,\n      configPath: p.configPath,\n      connectors: connStatuses,\n    });\n  }\n\n  if (values.json) {\n    print(JSON.stringify(rows, null, 2));\n    return 0;\n  }\n\n  if (rows.length === 0) {\n    print(\"status: no agent platforms detected.\");\n    return 0;\n  }\n  if (connectors.length === 0) {\n    print(\"status: no connectors found (pass --connector <path> or install one).\\n\");\n  }\n\n  for (const r of rows) {\n    print(`${r.platform}  [${r.scope}]  ${r.configPath}`);\n    if (r.connectors.length === 0) {\n      print(\"  (no connectors to check)\");\n    } else {\n      for (const c of r.connectors) {\n        const mark = c.method != null ? \"[installed]\" : \"[absent   ]\";\n        const server = c.serverPresent ? \"server ✓\" : \"server ·\";\n        const hooks = c.hooksPresent ? \"hooks ✓\" : \"hooks ·\";\n        // `both(!)` flags a violated one-method-per-host invariant — doctor's\n        // duplicate-registration check FAILs it with the fix.\n        const method =\n          c.method == null ? \"\" : c.method === \"both\" ? \"  (both!)\" : `  (${c.method})`;\n        print(`  ${mark} ${c.id}  ${server}  ${hooks}${method}`);\n      }\n    }\n    print(\"\");\n  }\n\n  // Always 0: status is descriptive (what is installed where), never a gate —\n  // that contrast with doctor (non-zero on FAIL) is the reason it exists.\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/statusline-ZNTCL5YC.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import {
+  runStatusline
+} from "./chunk-BHUCB6LY.js";
+import "./chunk-OP4KBXUO.js";
+import "./chunk-22Y24V7O.js";
+import "./chunk-J3D5W5T2.js";
+import "./chunk-CIRDOY2V.js";
+import "./chunk-BCHWFTV4.js";
+import "./chunk-KHO5WNTP.js";
+import "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
+import "./chunk-BXGFUENQ.js";
+import "./chunk-N6HH7K6P.js";
+import "./chunk-TRQKHP7D.js";
+
+// src/cli/commands/statusline.ts
+import { parseArgs } from "util";
+async function readAll(stream) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function run(argv) {
+  let platformId = "";
+  let connectorId = "";
+  try {
+    const { values, positionals } = parseArgs({
+      args: argv,
+      options: { connector: { type: "string" } },
+      allowPositionals: true,
+      strict: false
+    });
+    platformId = positionals[0] ?? "";
+    connectorId = typeof values.connector === "string" ? values.connector : "";
+  } catch {
+    return 0;
+  }
+  const stdin = await readAll(process.stdin).catch(() => "");
+  if (platformId === "" || connectorId === "") {
+    return 0;
+  }
+  const reply = await runStatusline({ platformId, connectorId, stdin });
+  if (reply.stdout !== void 0 && reply.stdout !== "") {
+    process.stdout.write(reply.stdout);
+  }
+  if (reply.stderr !== void 0 && reply.stderr !== "") {
+    process.stderr.write(reply.stderr.endsWith("\n") ? reply.stderr : `${reply.stderr}
+`);
+  }
+  return reply.exitCode;
+}
+export {
+  run
+};
+//# sourceMappingURL=statusline-ZNTCL5YC.js.map

package/dist/statusline-ZNTCL5YC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/statusline.ts"],"sourcesContent":["/**\n * cli/commands/statusline — the universal statusline (HUD) entrypoint.\n *\n *   agent-connector statusline <platform> --connector <id>\n *\n * A statusline-supporting host points its status line config at the single stable\n * home binary (via core/spawn.buildHomeBinStatuslineCommand). This command reads\n * the ENTIRE host payload from stdin, dispatches through runStatusline, writes the\n * rendered line to stdout, and exits with the adapter's exit code.\n *\n * FAIL-SAFE is the runtime's contract: a status line must NEVER wedge the host or\n * spew an error into the status bar. runStatusline never rejects (always exits 0\n * with at most a rendered line), and even a malformed invocation here degrades to\n * exit 0 with no output — never the strict `fail()` non-zero used by other\n * commands.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { runStatusline } from \"../../runtime/index.js\";\n\n/** Read all of a readable stream to a UTF-8 string. */\nasync function readAll(stream: NodeJS.ReadStream): Promise<string> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  // strict:false so a future flag from a newer install can never make this throw\n  // and surface a non-zero exit into the host's status bar.\n  let platformId = \"\";\n  let connectorId = \"\";\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv,\n      options: { connector: { type: \"string\" } },\n      allowPositionals: true,\n      strict: false,\n    });\n    platformId = positionals[0] ?? \"\";\n    connectorId = typeof values.connector === \"string\" ? values.connector : \"\";\n  } catch {\n    // A malformed invocation must still fail-safe (render nothing, exit 0).\n    return 0;\n  }\n\n  // Drain stdin regardless — a host expects the command to consume its payload.\n  const stdin = await readAll(process.stdin).catch(() => \"\");\n\n  // Missing platform/connector → render nothing, exit 0 (never a non-zero exit).\n  if (platformId === \"\" || connectorId === \"\") {\n    return 0;\n  }\n\n  const reply = await runStatusline({ platformId, connectorId, stdin });\n  if (reply.stdout !== undefined && reply.stdout !== \"\") {\n    process.stdout.write(reply.stdout);\n  }\n  if (reply.stderr !== undefined && reply.stderr !== \"\") {\n    process.stderr.write(reply.stderr.endsWith(\"\\n\") ? reply.stderr : `${reply.stderr}\\n`);\n  }\n  return reply.exitCode;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAS,iBAAiB;AAK1B,eAAe,QAAQ,QAA4C;AACjE,QAAM,SAAmB,CAAC;AAC1B,mBAAiB,SAAS,QAAQ;AAChC,WAAO,KAAK,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK,IAAI,KAAK;AAAA,EACpE;AACA,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,MAAM;AAC9C;AAEA,eAAsB,IAAI,MAAiC;AAGzD,MAAI,aAAa;AACjB,MAAI,cAAc;AAClB,MAAI;AACF,UAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,MACxC,MAAM;AAAA,MACN,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,EAAE;AAAA,MACzC,kBAAkB;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AACD,iBAAa,YAAY,CAAC,KAAK;AAC/B,kBAAc,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;AAAA,EAC1E,QAAQ;AAEN,WAAO;AAAA,EACT;AAGA,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,MAAM,EAAE;AAGzD,MAAI,eAAe,MAAM,gBAAgB,IAAI;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,MAAM,cAAc,EAAE,YAAY,aAAa,MAAM,CAAC;AACpE,MAAI,MAAM,WAAW,UAAa,MAAM,WAAW,IAAI;AACrD,YAAQ,OAAO,MAAM,MAAM,MAAM;AAAA,EACnC;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,SAAO,MAAM;AACf;","names":[]}

package/dist/{telemetry-3DN6XGYB.js → telemetry-XIKUUGTQ.js}

@@ -12,7 +12,7 @@ import {
 import {
   fail,
   print
-} from "./chunk-3RBLIHPZ.js";
+} from "./chunk-KGXDYGNJ.js";
 import {
   openStore
 } from "./chunk-BCHWFTV4.js";
@@ -21,8 +21,9 @@ import {
   listRegisteredConnectors,
   loadRegisteredConnector,
   readRegisteredMeta
-} from "./chunk-3JCRUROU.js";
-import "./chunk-GSGDG2BV.js";
+} from "./chunk-KGJWE6A2.js";
+import "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -347,4 +348,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=telemetry-3DN6XGYB.js.map
+//# sourceMappingURL=telemetry-XIKUUGTQ.js.map