@ken-jo/agent-connector 0.3.1 → 0.4.0

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   readRegisteredMeta
-} from "./chunk-3JCRUROU.js";
+} from "./chunk-KGJWE6A2.js";
 import {
   addLedgerOwner,
   configPatchManualEdit,
@@ -17,14 +17,15 @@ import {
   loadConfigPatchLedger,
   removeLedgerOwner,
   saveConfigPatchLedger
-} from "./chunk-GSGDG2BV.js";
+} from "./chunk-ADTHT2FN.js";
+import "./chunk-3PFFTFCU.js";
 import {
   resolveEnvRefsDeep,
   rewriteEnvRefs
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
+} from "./chunk-IW77FFNX.js";
 import {
   renderCommandMd,
   renderSkillMd,
@@ -32,10 +33,12 @@ import {
 } from "./chunk-7L6ITC4T.js";
 import {
   buildHomeBinHookCommand,
+  buildHomeBinStatuslineCommand,
   buildServeWrapperCommand,
   isHomeBinHookCommand,
+  isHomeBinStatuslineCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-BXGFUENQ.js";
 import {
   linesOutsideFences,
   listManagedBlocks,
@@ -80,6 +83,7 @@ function toolResponseToString(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 +116,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 +383,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 +432,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 +461,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 +487,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 +496,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 +505,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 +517,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 +533,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 +543,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 +559,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 +593,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 +603,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 +612,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 +622,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 +631,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 +653,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 +661,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 +777,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) {
@@ -1144,6 +1272,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 ──────────────────
@@ -1429,4 +1581,4 @@ export {
   claudeSensitiveKeyViolation,
   claude_code_default as default
 };
-//# sourceMappingURL=claude-code-4275HQU4.js.map
+//# sourceMappingURL=claude-code-MLWS7CW6.js.map