@ken-jo/agent-connector 0.3.1 → 0.4.1

package/dist/chunk-WZA4CSGJ.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+// src/adapters/claude-code/wire.ts
+function extractSessionId(input) {
+  if (typeof input.transcript_path === "string") {
+    const m = input.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);
+    if (m && m[1]) return m[1];
+  }
+  if (typeof input.session_id === "string" && input.session_id !== "") {
+    return input.session_id;
+  }
+  return "";
+}
+function toolResponseToString(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+
+export {
+  extractSessionId,
+  toolResponseToString
+};
+//# sourceMappingURL=chunk-WZA4CSGJ.js.map

package/dist/chunk-WZA4CSGJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/claude-code/wire.ts"],"sourcesContent":["/**\n * adapters/claude-code/wire — Claude Code hook wire protocol.\n *\n * Claude Code pipes a JSON object to a hook command on stdin and reads a JSON\n * object (or empty) from stdout, interpreting the exit code as well. This module\n * captures the exact stdin shape and the canonical reply shape so the adapter's\n * parse/format methods are a single source of truth.\n *\n * Stdin (documented Claude Code hook input):\n *   {\n *     session_id, transcript_path, cwd, hook_event_name,\n *     tool_name, tool_input, tool_response,            // tool events\n *     permission_suggestions,                          // PermissionRequest\n *     tool_use_id, error, is_interrupt, duration_ms,   // PostToolUseFailure\n *     agent_id, agent_type,                            // SubagentStart/Stop\n *     agent_transcript_path, last_assistant_message,   // SubagentStop\n *     source,                                          // SessionStart\n *     reason,                                          // SessionEnd\n *     prompt,                                          // UserPromptSubmit\n *     trigger,                                         // PreCompact\n *     stop_hook_active,                                // Stop / SubagentStop\n *     message                                          // Notification\n *   }\n *\n * Stdout (canonical reply): a `hookSpecificOutput` object keyed by\n * `hookEventName`, carrying `permissionDecision` (allow|deny|ask) +\n * `permissionDecisionReason`, `additionalContext`, and (PreToolUse)\n * `updatedInput`; PermissionRequest instead takes a nested\n * `decision: { behavior: \"allow\"|\"deny\", ... }`; Stop-class blocks\n * (Stop / SubagentStop / UserPromptSubmit / PostToolUse) take the TOP-LEVEL\n * `{\"decision\":\"block\",\"reason\"}`. Exit 0 = proceed; the JSON refines the\n * decision.\n */\n\n/** Canonical Claude Code hook event names (the values of `hook_event_name`). */\nexport const CLAUDE_HOOK_EVENTS = [\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"PreCompact\",\n  \"SessionStart\",\n  \"SessionEnd\",\n  \"UserPromptSubmit\",\n  \"Stop\",\n  \"Notification\",\n  \"PermissionRequest\",\n  \"PostToolUseFailure\",\n  \"SubagentStart\",\n  \"SubagentStop\",\n] as const;\n\nexport type ClaudeHookEvent = (typeof CLAUDE_HOOK_EVENTS)[number];\n\n/**\n * Raw Claude Code hook stdin payload. Every field is optional — a given event\n * only populates the subset relevant to it. `connector` is NOT a Claude field;\n * it is threaded in by the universal entrypoint so parseEvent can recover the\n * connector id (the home binary passes `--connector <id>` and may inject it).\n */\nexport interface ClaudeWireInput {\n  session_id?: string;\n  transcript_path?: string;\n  cwd?: string;\n  hook_event_name?: string;\n\n  // tool events\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  /** PostToolUse result payload (string or structured). */\n  tool_response?: unknown;\n\n  // PermissionRequest — permission-update entries the dialog would offer.\n  // NOTE: the docs explicitly state PermissionRequest has NO tool_use_id.\n  permission_suggestions?: unknown[];\n\n  // PostToolUseFailure\n  tool_use_id?: string;\n  error?: string;\n  is_interrupt?: boolean;\n  duration_ms?: number;\n\n  // SubagentStart / SubagentStop — agent_type is unreliable on SubagentStop\n  // (the SDK may not populate it); treat both as optional everywhere.\n  agent_id?: string;\n  agent_type?: string;\n  // SubagentStop — the subagent's OWN transcript (transcript_path stays the\n  // parent session's) + the text of its final response.\n  agent_transcript_path?: string;\n  last_assistant_message?: string;\n\n  // SessionStart\n  source?: string;\n  // SessionEnd\n  reason?: string;\n  // UserPromptSubmit\n  prompt?: string;\n  // PreCompact\n  trigger?: string;\n  // Stop / SubagentStop\n  stop_hook_active?: boolean;\n  // Notification\n  message?: string;\n\n  /** Injected by the entrypoint so the runtime knows which connector to dispatch. */\n  connector?: string;\n}\n\n/**\n * Extract a stable session id from a Claude wire payload.\n * Priority mirrors the proven adapter: transcript UUID > session_id > \"\".\n * (The framework's normalized event uses \"\" when no id is available, per\n * core/types BaseEvent.sessionId docstring — no ppid fabrication here.)\n */\nexport function extractSessionId(input: ClaudeWireInput): string {\n  if (typeof input.transcript_path === \"string\") {\n    const m = input.transcript_path.match(/([a-f0-9-]{36})\\.jsonl$/);\n    if (m && m[1]) return m[1];\n  }\n  if (typeof input.session_id === \"string\" && input.session_id !== \"\") {\n    return input.session_id;\n  }\n  return \"\";\n}\n\n/** Coerce a Claude PostToolUse `tool_response` into a string for the normalized event. */\nexport function toolResponseToString(value: unknown): string | undefined {\n  if (value == null) return undefined;\n  if (typeof value === \"string\") return value;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n"],"mappings":";;;AAgHO,SAAS,iBAAiB,OAAgC;AAC/D,MAAI,OAAO,MAAM,oBAAoB,UAAU;AAC7C,UAAM,IAAI,MAAM,gBAAgB,MAAM,yBAAyB;AAC/D,QAAI,KAAK,EAAE,CAAC,EAAG,QAAO,EAAE,CAAC;AAAA,EAC3B;AACA,MAAI,OAAO,MAAM,eAAe,YAAY,MAAM,eAAe,IAAI;AACnE,WAAO,MAAM;AAAA,EACf;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,OAAoC;AACvE,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-XJ4S47CT.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import {
+  allAdapters,
+  loadAdapter
+} from "./chunk-DCKFYWGM.js";
+
+// src/sdk/introspect.ts
+var SURFACE_PREDICATES = {
+  server: (c) => c.transports.length > 0,
+  hooks: (c) => c.sessionStart || c.preToolUse || c.postToolUse || c.userPromptSubmit || c.stop || c.sessionEnd || c.preCompact || c.notification || (c.permissionRequest ?? false) || (c.postToolUseFailure ?? false) || (c.subagentStart ?? false) || (c.subagentStop ?? false),
+  commands: (c) => c.supportsCommands ?? false,
+  skills: (c) => c.supportsSkills ?? false,
+  subagents: (c) => c.supportsSubagents ?? false,
+  memory: (c) => c.supportsMemory ?? false,
+  statusline: (c) => c.supportsStatusline ?? false,
+  // Emitters ship on droid + hermes + warp plus the ts-plugin slash-command
+  // hosts omp + openclaw (+ the nemoclaw fork) — the hosts with a verifiable
+  // target. Every other host leaves supportsActions unset, so explain() marks
+  // actions skip-warn there — the honest state for a host with no emission target.
+  actions: (c) => c.supportsActions ?? false,
+  configPatch: (c) => c.supportsConfigPatch ?? false,
+  nativeHooks: (c) => c.supportsNativeHooks ?? false
+};
+async function capabilitiesOf(host) {
+  const adapter = await loadAdapter(host);
+  return adapter?.capabilities;
+}
+async function hostsSupporting(surface) {
+  const predicate = SURFACE_PREDICATES[surface];
+  const adapters = await allAdapters();
+  return adapters.filter((adapter) => predicate(adapter.capabilities)).map((adapter) => adapter.id).sort();
+}
+async function surfaceSupport(host, surface) {
+  const capabilities = await capabilitiesOf(host);
+  return capabilities ? SURFACE_PREDICATES[surface](capabilities) : false;
+}
+
+export {
+  SURFACE_PREDICATES,
+  capabilitiesOf,
+  hostsSupporting,
+  surfaceSupport
+};
+//# sourceMappingURL=chunk-XJ4S47CT.js.map

package/dist/chunk-XJ4S47CT.js.map

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

package/dist/{claude-code-4275HQU4.js → claude-code-W4PUFZL5.js}

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
+import {
+  extractSessionId,
+  toolResponseToString
+} from "./chunk-WZA4CSGJ.js";
 import {
   readRegisteredMeta
-} from "./chunk-3JCRUROU.js";
+} from "./chunk-24IDL5RW.js";
+import "./chunk-4ENJK5S2.js";
+import "./chunk-DCKFYWGM.js";
 import {
   addLedgerOwner,
   configPatchManualEdit,
@@ -17,14 +23,14 @@ import {
   loadConfigPatchLedger,
   removeLedgerOwner,
   saveConfigPatchLedger
-} from "./chunk-GSGDG2BV.js";
+} from "./chunk-FAHIMJRU.js";
 import {
   resolveEnvRefsDeep,
   rewriteEnvRefs
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-CPLK7GTE.js";
 import {
   renderCommandMd,
   renderSkillMd,
@@ -32,10 +38,12 @@ import {
 } from "./chunk-7L6ITC4T.js";
 import {
   buildHomeBinHookCommand,
+  buildHomeBinStatuslineCommand,
   buildServeWrapperCommand,
   isHomeBinHookCommand,
+  isHomeBinStatuslineCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-I5MLE6S7.js";
 import {
   linesOutsideFences,
   listManagedBlocks,
@@ -55,31 +63,9 @@ import {
 import { copyFileSync, existsSync, lstatSync, readFileSync, realpathSync } from "fs";
 import { homedir } from "os";
 import { basename, dirname, join } from "path";
-
-// src/adapters/claude-code/wire.ts
-function extractSessionId(input) {
-  if (typeof input.transcript_path === "string") {
-    const m = input.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);
-    if (m && m[1]) return m[1];
-  }
-  if (typeof input.session_id === "string" && input.session_id !== "") {
-    return input.session_id;
-  }
-  return "";
-}
-function toolResponseToString(value) {
-  if (value == null) return void 0;
-  if (typeof value === "string") return value;
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return String(value);
-  }
-}
-
-// src/adapters/claude-code/index.ts
 var HOST = "claude-code";
 var MCP_ROOT_KEY = "mcpServers";
+var STATUSLINE_KEY = "statusLine";
 var CLAUDE_AGENTS_IMPORT_BLOCK_ID = "_shared/claude-agents-import";
 var ClaudeCodeAdapter = class extends BaseAdapter {
   id = HOST;
@@ -112,6 +98,11 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
     // (set-if-absent leaf keys in settings.json, refcounted ownership ledger,
     // sensitive-key denylist — see SENSITIVE_KEY_RULES below).
     supportsConfigPatch: true,
+    // Statusline surface: claude-code is the ONLY v1 host. installStatusline
+    // wires settings.json.statusLine = {type:"command", command:<home-bin
+    // statusline cmd>} through the SAME set-if-absent ownership ledger as
+    // configPatch (never clobbers a statusLine agent-connector does not own).
+    supportsStatusline: true,
     transports: ["stdio", "http"],
     // Content surfaces: Claude Code is the reference implementation for all three.
     supportsCommands: true,
@@ -374,6 +365,20 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
         { platform: this.id, action: "skip", detail: "connector declares no configPatch entries" }
       ];
     }
+    return this.applyConfigPatches(ctx, patches);
+  }
+  /**
+   * The shared set-if-absent / ownership-ledger apply loop behind BOTH
+   * {@link installConfigPatches} and {@link installStatusline}. Routing the
+   * statusline through the EXACT same path is how a connector's statusLine
+   * inherits the configPatch contract verbatim: never clobber a statusLine
+   * agent-connector does not own (skip-warn), record prior state + owner,
+   * refcounted across connectors, reversible by uninstallConfigPatches.
+   */
+  applyConfigPatches(ctx, patches, opts = {}) {
+    const surfaceLabel = opts.surfaceLabel ?? "configPatch";
+    const internal = surfaceLabel !== "configPatch";
+    const { connector } = ctx;
     const filePath = this.getPatchableConfigPath(ctx);
     if (this.isPresentButUnparseable(filePath)) {
       return [
@@ -409,14 +414,16 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
         });
         continue;
       }
-      const namespace = configPatchNamespaceViolation(patch.key);
-      if (namespace) {
-        changes.push({
-          platform: this.id,
-          action: "warn",
-          detail: `configPatch refused: ${namespace}`
-        });
-        continue;
+      if (!internal) {
+        const namespace = configPatchNamespaceViolation(patch.key);
+        if (namespace) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `configPatch refused: ${namespace}`
+          });
+          continue;
+        }
       }
       const sensitive = claudeSensitiveKeyViolation(patch.key);
       if (sensitive) {
@@ -436,7 +443,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           platform: this.id,
           action: "warn",
           path: filePath,
-          detail: `configPatch ${patch.key} skipped: "${leaf.atPath}" exists but is not an object \u2014 ${configPatchManualEdit(patch)}`
+          detail: `${surfaceLabel} ${patch.key} skipped: "${leaf.atPath}" exists but is not an object \u2014 ${configPatchManualEdit(patch)}`
         });
         continue;
       }
@@ -462,7 +469,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           platform: this.id,
           action: "create",
           path: filePath,
-          detail: `configPatch ${patch.key}: <absent> \u2192 ${describeJsonValue(desired)} (${patch.reason})`
+          detail: `${surfaceLabel} ${patch.key}: <absent> \u2192 ${describeJsonValue(desired)} (${patch.reason})`
         });
         continue;
       }
@@ -471,7 +478,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           platform: this.id,
           action: "warn",
           path: filePath,
-          detail: `configPatch ${patch.key} skipped: already set to ${describeJsonValue(leaf.value)} (not created by agent-connector; desired ${describeJsonValue(desired)}) \u2014 ` + configPatchManualEdit(patch)
+          detail: `${surfaceLabel} ${patch.key} skipped: already set to ${describeJsonValue(leaf.value)} (not created by agent-connector; desired ${describeJsonValue(desired)}) \u2014 ` + configPatchManualEdit(patch)
         });
         continue;
       }
@@ -480,7 +487,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           platform: this.id,
           action: "warn",
           path: filePath,
-          detail: `configPatch ${patch.key}: value changed since install (current ${describeJsonValue(leaf.value)}, wrote ${describeJsonValue(entry.writtenValue)}); leaving in place \u2014 ${configPatchManualEdit(patch)}`
+          detail: `${surfaceLabel} ${patch.key}: value changed since install (current ${describeJsonValue(leaf.value)}, wrote ${describeJsonValue(entry.writtenValue)}); leaving in place \u2014 ${configPatchManualEdit(patch)}`
         });
         continue;
       }
@@ -492,14 +499,14 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "skip",
             path: filePath,
-            detail: `configPatch ${patch.key} already installed; registered as co-owner (co-owned with ${owners.join(", ")})`
+            detail: `${surfaceLabel} ${patch.key} already installed; registered as co-owner (co-owned with ${owners.join(", ")})`
           });
         } else {
           changes.push({
             platform: this.id,
             action: "skip",
             path: filePath,
-            detail: `configPatch ${patch.key} already installed`
+            detail: `${surfaceLabel} ${patch.key} already installed`
           });
         }
         continue;
@@ -508,7 +515,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
         platform: this.id,
         action: "warn",
         path: filePath,
-        detail: `configPatch ${patch.key} skipped: already owned by ${entry.owners.map((o) => o.connectorId).join(", ")} with a different value (current ${describeJsonValue(leaf.value)}, desired ${describeJsonValue(desired)}) \u2014 ` + configPatchManualEdit(patch)
+        detail: `${surfaceLabel} ${patch.key} skipped: already owned by ${entry.owners.map((o) => o.connectorId).join(", ")} with a different value (current ${describeJsonValue(leaf.value)}, desired ${describeJsonValue(desired)}) \u2014 ` + configPatchManualEdit(patch)
       });
     }
     if (fileMutated) this.writeJson(filePath, settings, ctx.dryRun);
@@ -518,7 +525,9 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
   uninstallConfigPatches(ctx) {
     const connectorId = ctx.connector.id;
     const ledger = loadConfigPatchLedger(ctx.dataRoot);
-    const owned = ledgerEntriesOwnedBy(ledger, HOST, connectorId);
+    const owned = ledgerEntriesOwnedBy(ledger, HOST, connectorId).filter(
+      (e) => e.key !== STATUSLINE_KEY
+    );
     const declared = ctx.connector.platforms[HOST]?.configPatch ?? [];
     const changes = [];
     const ownedKeys = new Set(owned.map((e) => e.key));
@@ -532,6 +541,20 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
       }
     }
     if (owned.length === 0) return changes;
+    changes.push(...this.releaseOwnedConfigPatches(ctx, ledger, owned));
+    return changes;
+  }
+  /**
+   * The shared last-owner-verified release loop behind BOTH
+   * {@link uninstallConfigPatches} and {@link uninstallStatusline}: for each
+   * already-selected owned ledger entry, drop this connector's ownership and
+   * remove the key ONLY when last-owner ∧ value-unchanged ∧ prior-absent (else
+   * skip-warn + leave the key). Saves the ledger when it mutated.
+   */
+  releaseOwnedConfigPatches(ctx, ledger, owned, opts = {}) {
+    const surfaceLabel = opts.surfaceLabel ?? "configPatch";
+    const connectorId = ctx.connector.id;
+    const changes = [];
     let ledgerMutated = false;
     const backedUp = /* @__PURE__ */ new Set();
     const byFile = /* @__PURE__ */ new Map();
@@ -552,7 +575,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "skip",
             path: filePath,
-            detail: `configPatch ${entry.key} retained: still owned by ${entry.owners.map((o) => o.connectorId).join(", ")}`
+            detail: `${surfaceLabel} ${entry.key} retained: still owned by ${entry.owners.map((o) => o.connectorId).join(", ")}`
           });
           continue;
         }
@@ -562,7 +585,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "warn",
             path: filePath,
-            detail: `configPatch ${entry.key}: ${filePath} is not parseable; key left in place (ownership released)`
+            detail: `${surfaceLabel} ${entry.key}: ${filePath} is not parseable; key left in place (ownership released)`
           });
           continue;
         }
@@ -571,7 +594,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "skip",
             path: filePath,
-            detail: `configPatch ${entry.key} already absent (no settings file); ownership record dropped`
+            detail: `${surfaceLabel} ${entry.key} already absent (no settings file); ownership record dropped`
           });
           continue;
         }
@@ -581,7 +604,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "skip",
             path: filePath,
-            detail: `configPatch ${entry.key} already absent; ownership record dropped`
+            detail: `${surfaceLabel} ${entry.key} already absent; ownership record dropped`
           });
           continue;
         }
@@ -590,7 +613,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
             platform: this.id,
             action: "warn",
             path: filePath,
-            detail: `configPatch ${entry.key}: value changed since install (current ${describeJsonValue(leaf.value)}, wrote ${describeJsonValue(entry.writtenValue)}); left in place`
+            detail: `${surfaceLabel} ${entry.key}: value changed since install (current ${describeJsonValue(leaf.value)}, wrote ${describeJsonValue(entry.writtenValue)}); left in place`
           });
           continue;
         }
@@ -612,7 +635,7 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           platform: this.id,
           action: "remove",
           path: filePath,
-          detail: `configPatch ${entry.key} removed (was ${describeJsonValue(entry.writtenValue)})`
+          detail: `${surfaceLabel} ${entry.key} removed (was ${describeJsonValue(entry.writtenValue)})`
         });
       }
       if (fileMutated && settings) this.writeJson(filePath, settings, ctx.dryRun);
@@ -620,6 +643,91 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
     if (ledgerMutated && !ctx.dryRun) saveConfigPatchLedger(ctx.dataRoot, ledger);
     return changes;
   }
+  // ── Statusline surface (a HUD/status line) ────────────────────────────────
+  // Wires settings.json.statusLine = { type:"command", command:<home-bin
+  // statusline cmd> } through the SAME ownership ledger as configPatch: a
+  // synthetic ConfigPatchDef routed through applyConfigPatches, so the statusLine
+  // inherits the full set-if-absent contract verbatim — never clobbers a
+  // statusLine agent-connector does not own (skip-warn), records prior state +
+  // owner, reversible. The home-bin command makes the host exec
+  // `<homeBin> statusline claude-code --connector <id>` for every status refresh,
+  // which re-imports the connector module and renders the line (runtime/
+  // statusline-entrypoint). No telemetry in v1.
+  /** The synthetic statusLine configPatch this connector would write. */
+  statuslineConfigPatch(ctx) {
+    const command = buildHomeBinStatuslineCommand(ctx.homeBinPath, HOST, ctx.connector.id);
+    return {
+      key: STATUSLINE_KEY,
+      value: { type: "command", command },
+      reason: "agent-connector statusline surface"
+    };
+  }
+  installStatusline(ctx) {
+    const { connector } = ctx;
+    if (connector.statusline == null) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no statusline" }];
+    }
+    if (connector.platforms[HOST]?.statusline === false) {
+      return [{ platform: this.id, action: "skip", detail: "statusline disabled for claude-code" }];
+    }
+    return this.applyConfigPatches(ctx, [this.statuslineConfigPatch(ctx)], {
+      surfaceLabel: "statusline"
+    });
+  }
+  uninstallStatusline(ctx) {
+    const ledger = loadConfigPatchLedger(ctx.dataRoot);
+    const owned = ledgerEntriesOwnedBy(ledger, HOST, ctx.connector.id).filter(
+      (e) => e.key === STATUSLINE_KEY
+    );
+    if (owned.length === 0) {
+      return [
+        {
+          platform: this.id,
+          action: "skip",
+          detail: "statusline: no ownership recorded; left untouched"
+        }
+      ];
+    }
+    return this.releaseOwnedConfigPatches(ctx, ledger, owned, {
+      surfaceLabel: "statusline"
+    });
+  }
+  /**
+   * Parse Claude Code's statusLine stdin JSON into the normalized
+   * {@link StatuslineContext}. Claude pipes a JSON object to the statusLine
+   * command on stdin (model, workspace, cost, etc.); fields the payload omits
+   * stay undefined. `raw` keeps the verbatim payload (incl. `version`).
+   */
+  parseStatusInput(raw) {
+    const input = raw ?? {};
+    const model = {};
+    if (typeof input.model?.id === "string") model.id = input.model.id;
+    if (typeof input.model?.display_name === "string") {
+      model.displayName = input.model.display_name;
+    }
+    const cwd = typeof input.cwd === "string" ? input.cwd : typeof input.workspace?.current_dir === "string" ? input.workspace.current_dir : void 0;
+    const ctx = {
+      host: HOST,
+      capabilities: this.capabilities,
+      raw
+    };
+    if (typeof input.session_id === "string" && input.session_id !== "") {
+      ctx.sessionId = input.session_id;
+    }
+    if (cwd !== void 0) ctx.cwd = cwd;
+    if (model.id !== void 0 || model.displayName !== void 0) ctx.model = model;
+    if (typeof input.cost?.total_cost_usd === "number") {
+      ctx.cost = { totalUsd: input.cost.total_cost_usd };
+    }
+    if (typeof input.transcript_path === "string") {
+      ctx.transcriptPath = input.transcript_path;
+    }
+    return ctx;
+  }
+  /** Format the rendered status line into Claude's native reply: stdout = line, exit 0. */
+  formatStatusOutput(rendered) {
+    return { exitCode: 0, stdout: rendered };
+  }
   /**
    * Back up ONE exact file (the ledger-recorded patch target, which may belong
    * to a different scope than the current ctx) into the standard backups dir.
@@ -651,7 +759,9 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
     const results = [];
     const ledger = loadConfigPatchLedger(ctx.dataRoot);
     const connectorId = ctx.connector.id;
-    const platformEntries = ledger.entries.filter((e) => e.platform === this.id);
+    const platformEntries = ledger.entries.filter(
+      (e) => e.platform === this.id && e.key !== STATUSLINE_KEY
+    );
     for (const entry of platformEntries) {
       const ownedByThis = entry.owners.some((o) => o.connectorId === connectorId);
       if (!ownedByThis) {
@@ -678,7 +788,8 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
           check: `${this.name}: configPatch ${entry.key}`,
           status: "warn",
           message: `missing \u2014 key deleted from ${entry.file} since install`,
-          fix: `agent-connector install (sync) will re-assert it`
+          fix: `agent-connector install (sync) will re-assert it`,
+          fixable: true
         });
       } else {
         results.push({
@@ -1144,6 +1255,30 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
         check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
       });
     }
+    const statuslineLedgerOwned = ledgerEntriesOwnedBy(
+      loadConfigPatchLedger(ctx.dataRoot),
+      HOST,
+      connectorId
+    ).some((e) => e.key === STATUSLINE_KEY);
+    if ((ctx.connector.statusline != null || statuslineLedgerOwned) && ctx.connector.platforms[HOST]?.statusline !== false) {
+      checks.push({
+        name: `${this.name}: statusline wired`,
+        check: () => {
+          const settings = this.readJson(settingsPath);
+          const command = settings?.statusLine?.command;
+          if (command === void 0) {
+            return { status: "FAIL", detail: `statusLine not set in ${settingsPath}` };
+          }
+          if (typeof command === "string" && isHomeBinStatuslineCommand(command, homeBin, connectorId)) {
+            return { status: "OK", detail: "statusLine command present" };
+          }
+          return {
+            status: "FAIL",
+            detail: `statusLine in ${settingsPath} is not agent-connector's (left untouched)`
+          };
+        }
+      });
+    }
     return checks;
   }
   // ── Runtime: parse Claude stdin JSON → normalized event ──────────────────
@@ -1259,6 +1394,13 @@ var ClaudeCodeAdapter = class extends BaseAdapter {
         };
         return ev;
       }
+      case "PostCompact": {
+        const ev = {
+          ...base,
+          ...input.trigger === "auto" || input.trigger === "manual" ? { trigger: input.trigger } : {}
+        };
+        return ev;
+      }
       default: {
         const _never = event;
         throw new Error(`unsupported claude-code hook event: ${String(_never)}`);
@@ -1429,4 +1571,4 @@ export {
   claudeSensitiveKeyViolation,
   claude_code_default as default
 };
-//# sourceMappingURL=claude-code-4275HQU4.js.map
+//# sourceMappingURL=claude-code-W4PUFZL5.js.map