@ken-jo/agent-connector 0.4.79 → 0.4.91

package/dist/openhands-5LNH3BKB.js

@@ -0,0 +1,384 @@
+#!/usr/bin/env node
+import {
+  normalizeSessionSource
+} from "./chunk-H53QZQJI.js";
+import {
+  resolveEnvRefsDeep
+} from "./chunk-BEFVJ2OE.js";
+import {
+  BaseAdapter
+} from "./chunk-VVFDU4IX.js";
+import {
+  buildWrappedStdio,
+  isHomeBinHookCommand
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
+
+// src/adapters/openhands/index.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var HOST = "openhands";
+var MCP_ROOT_KEY = "mcpServers";
+function persistenceDir() {
+  return process.env.OPENHANDS_PERSISTENCE_DIR ?? join(homedir(), ".openhands");
+}
+var SUPPORTED_EVENTS = /* @__PURE__ */ new Set([
+  "PreToolUse",
+  "PostToolUse",
+  "UserPromptSubmit",
+  "SessionStart",
+  "SessionEnd",
+  "Stop"
+]);
+var OpenHandsAdapter = class extends BaseAdapter {
+  id = HOST;
+  name = "OpenHands";
+  paradigm = "json-stdio";
+  capabilities = {
+    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default.
+    supportsMemory: true,
+    preToolUse: true,
+    postToolUse: true,
+    userPromptSubmit: true,
+    sessionStart: true,
+    sessionEnd: true,
+    stop: true,
+    // OpenHands fires NONE of these on its hook wire (HookEventType has only the
+    // six above) — install reports the standard skip-warn for any of them.
+    // The two REQUIRED PlatformCapabilities flags below are explicitly false;
+    // subagentStop / permissionRequest / postToolUseFailure / subagentStart are
+    // optional and stay unset (read as ?? false) — no OpenHands analog.
+    preCompact: false,
+    notification: false,
+    // PreToolUse/UserPromptSubmit/Stop can block (exit 2 or {"decision":"deny"}),
+    // but the hook wire cannot rewrite tool ARGS or already-emitted tool OUTPUT.
+    canModifyArgs: false,
+    canModifyOutput: false,
+    // additionalContext on the stdout reply is honored (executor.py parses it).
+    canInjectSessionContext: true,
+    // OpenHands registers stdio + remote (Streamable HTTP / SSE) MCP servers.
+    transports: ["stdio", "http"]
+    // Content surfaces (commands/skills/subagents/statusline/actions) are NOT
+    // wired: OpenHands' CLI uses microagents + an interactive TUI rather than a
+    // Claude-style file-per-command/skill/subagent tree, and no first-party
+    // file layout for those was byte-confirmed. Left unset (honest CEILING).
+  };
+  // ── Detection ────────────────────────────────────────────────────────────
+  detectInstalled(projectDir) {
+    const userDir = persistenceDir();
+    const userMcp = join(userDir, "mcp.json");
+    const projDir = join(projectDir, ".openhands");
+    const projHooks = join(projDir, "hooks.json");
+    const userInstalled = existsSync(userDir) || existsSync(userMcp);
+    const projInstalled = existsSync(projDir) || existsSync(projHooks);
+    const installed = userInstalled || projInstalled;
+    const scope = userInstalled || !projInstalled ? "user" : "project";
+    const configPath = scope === "user" ? userMcp : projHooks;
+    return {
+      id: this.id,
+      name: this.name,
+      installed,
+      paradigm: this.paradigm,
+      capabilities: this.capabilities,
+      configPath,
+      scope,
+      reason: installed ? `found OpenHands config (${scope}) at ${configPath}` : `no OpenHands config at ${userDir} or ${projDir}`,
+      confidence: installed ? "high" : "low"
+    };
+  }
+  // ── Native paths ─────────────────────────────────────────────────────────
+  getConfigDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".openhands") : persistenceDir();
+  }
+  /**
+   * MCP `mcp.json` lives in the CLI persistence dir, which is USER-scoped only —
+   * the CLI reads exactly one `<persistence>/mcp.json` and has no project
+   * variant. So this ALWAYS resolves to the user persistence dir regardless of
+   * ctx.scope (writing a project `.openhands/mcp.json` the CLI never reads would
+   * be a silent no-op).
+   */
+  getServerConfigPath(_ctx) {
+    return join(persistenceDir(), "mcp.json");
+  }
+  /**
+   * Hooks live in a SEPARATE `.openhands/hooks.json`. HookConfig.load searches
+   * <working_dir>/.openhands/hooks.json then ~/.openhands/hooks.json, so both
+   * scopes are honored — project scope → <projectDir>/.openhands, user scope →
+   * the persistence dir.
+   */
+  getHookConfigPath(ctx) {
+    return join(this.getConfigDir(ctx), "hooks.json");
+  }
+  // ── MCP server install / uninstall ───────────────────────────────────────
+  installServer(ctx) {
+    const { connector } = ctx;
+    const override = connector.platforms[HOST]?.server;
+    if (!connector.server || override === false) {
+      return [
+        {
+          platform: this.id,
+          action: "skip",
+          detail: connector.server ? "server registration disabled for openhands" : "connector declares no MCP server"
+        }
+      ];
+    }
+    const server = override && typeof override === "object" ? { ...connector.server, ...override } : connector.server;
+    const serverPath = this.getServerConfigPath(ctx);
+    const entry = this.renderServerEntry(ctx, server);
+    return [
+      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun)
+    ];
+  }
+  uninstallServer(ctx) {
+    const serverPath = this.getServerConfigPath(ctx);
+    return [
+      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun)
+    ];
+  }
+  /** Render a normalized ServerDef into OpenHands' native mcpServers entry. */
+  renderServerEntry(ctx, server) {
+    const transport = server.transport;
+    if (transport === "stdio") {
+      let command = server.command ?? "";
+      let args = [...server.args ?? []];
+      ({ command, args } = buildWrappedStdio(ctx, server, this.id, command, args));
+      const entry2 = {
+        command: resolveEnvRefsDeep(command),
+        transport: "stdio"
+      };
+      if (args.length > 0) entry2.args = resolveEnvRefsDeep(args);
+      const env = this.renderEnv(server.env);
+      if (env) entry2.env = env;
+      return entry2;
+    }
+    const entry = {
+      url: resolveEnvRefsDeep(server.url ?? ""),
+      transport: transport === "sse" ? "sse" : "http"
+    };
+    const headers = this.renderEnv(server.headers);
+    if (headers) entry.headers = headers;
+    return entry;
+  }
+  /**
+   * Render env/header values. Resolve `${env:VAR}` references to literals at
+   * install time (the safe path matching Droid).
+   */
+  renderEnv(env) {
+    if (!env || Object.keys(env).length === 0) return void 0;
+    return resolveEnvRefsDeep({ ...env });
+  }
+  // ── Hook install / uninstall (separate hooks.json, nested-rule shape) ─────
+  installHooks(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.hooks === false) {
+      return [{ platform: this.id, action: "skip", detail: "hooks disabled for openhands" }];
+    }
+    if (connector.hookEvents.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no hooks" }];
+    }
+    const pending = connector.hookEvents.map((event) => ({
+      event,
+      matcher: connector.hooks[event]?.matcher ?? ""
+    }));
+    return this.upsertHookEntries(
+      ctx,
+      this.getHookConfigPath(ctx),
+      pending,
+      this.hookDescriptor(ctx)
+    );
+  }
+  uninstallHooks(ctx) {
+    return this.removeHookEntries(ctx, this.getHookConfigPath(ctx), this.hookDescriptor(ctx));
+  }
+  /**
+   * OpenHands' hook-merge descriptor (NESTED shape `{ matcher, hooks: [...] }`).
+   * Ownership is CONNECTOR-GENERIC (ANY of our commands in the entry's inner
+   * `hooks`, not a specific-command match), identical to Droid:
+   *  - mapEvent = drop events outside SUPPORTED_EVENTS; supported event names are
+   *    Claude-identical, so they map 1:1.
+   *  - entryOwnsCommand reuses isOurCommand over the inner commands.
+   *  - uninstall = inner-strip ONLY (ownsEntryForRemove never-true).
+   */
+  hookDescriptor(ctx) {
+    return {
+      mapEvent: (e) => SUPPORTED_EVENTS.has(e) ? e : void 0,
+      unmappedWarnDetail: (e) => `${e} has no OpenHands hook equivalent \u2014 skipped`,
+      renderEntry: (_event, matcher, command) => ({
+        matcher,
+        hooks: [{ type: "command", command }]
+      }),
+      entryOwnsCommand: (entry, _command) => (entry.hooks ?? []).some((h) => this.isOurCommand(h.command, ctx)),
+      ownsEntryForRemove: () => () => false,
+      stripInner: (c) => (entry) => {
+        const innerBefore = entry.hooks?.length ?? 0;
+        const inner = (entry.hooks ?? []).filter((h) => !this.isOurCommand(h.command, c));
+        return {
+          next: inner.length > 0 ? { matcher: entry.matcher ?? "", hooks: inner } : null,
+          removed: innerBefore - inner.length
+        };
+      },
+      skipDetail: (event) => `hooks.${event} already registered`,
+      removeDetail: (event, removed) => `hooks.${event} (${removed})`,
+      absentDetail: "no hooks section present",
+      noMatchDetail: "no matching hook entries"
+    };
+  }
+  /** True when a hook command references our home binary AND this connector id
+   *  (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand). */
+  isOurCommand(command, ctx) {
+    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);
+  }
+  // ── Diagnostics ──────────────────────────────────────────────────────────
+  getHealthChecks(ctx) {
+    const mcpPath = this.getServerConfigPath(ctx);
+    const hookPath = this.getHookConfigPath(ctx);
+    const connectorId = ctx.connector.id;
+    const homeBin = ctx.homeBinPath;
+    const hookEvents = ctx.connector.hookEvents;
+    return [
+      {
+        name: `${this.name}: mcp.json present`,
+        check: () => existsSync(mcpPath) ? { status: "OK", detail: mcpPath } : { status: "FAIL", detail: `not found: ${mcpPath}` }
+      },
+      {
+        name: `${this.name}: server entry registered`,
+        check: () => {
+          if (!ctx.connector.server) {
+            return { status: "OK", detail: "no MCP server declared" };
+          }
+          const cfg = this.readJson(mcpPath);
+          const bucket = cfg?.[MCP_ROOT_KEY];
+          if (!cfg || !bucket) {
+            return { status: "FAIL", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };
+          }
+          return connectorId in bucket ? { status: "OK", detail: `${MCP_ROOT_KEY}.${connectorId} present` } : {
+            status: "FAIL",
+            detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`
+          };
+        }
+      },
+      {
+        name: `${this.name}: hook command registered`,
+        check: () => {
+          if (hookEvents.length === 0) {
+            return { status: "OK", detail: "no hooks declared" };
+          }
+          const file = this.readJson(hookPath);
+          if (!file) return { status: "FAIL", detail: `cannot read ${hookPath}` };
+          const hooks = file.hooks ?? {};
+          const registered = Object.values(hooks).some(
+            (entries) => (entries ?? []).some(
+              (e) => (e.hooks ?? []).some(
+                (h) => isHomeBinHookCommand(h.command, homeBin, connectorId)
+              )
+            )
+          );
+          return registered ? { status: "OK", detail: "hook command present" } : { status: "FAIL", detail: `no hook for ${connectorId} in ${hookPath}` };
+        }
+      }
+    ];
+  }
+  // ── Runtime: parse OpenHands stdin JSON → normalized event ─────────────────
+  // The wire field names DIVERGE from Claude (event_type / working_dir / message
+  // / tool_response-dict) — see the header. Reading Claude's names here would be
+  // a silent false-friend (the kimi-code bug class).
+  parseEvent(event, raw) {
+    const input = raw ?? {};
+    const connectorId = typeof input.connector === "string" ? input.connector : "";
+    const sessionId = typeof input.session_id === "string" ? input.session_id : "";
+    const projectDir = typeof input.working_dir === "string" ? input.working_dir : void 0;
+    const base = {
+      hostPlatform: HOST,
+      connectorId,
+      sessionId,
+      raw,
+      ...projectDir !== void 0 ? { projectDir } : {}
+    };
+    switch (event) {
+      case "PreToolUse": {
+        const ev = {
+          ...base,
+          toolName: input.tool_name ?? "",
+          toolInput: input.tool_input ?? {}
+        };
+        return ev;
+      }
+      case "PostToolUse": {
+        const ev = {
+          ...base,
+          toolName: input.tool_name ?? "",
+          toolInput: input.tool_input ?? {},
+          ...toolResponseToString(input.tool_response) !== void 0 ? { toolOutput: toolResponseToString(input.tool_response) } : {}
+        };
+        return ev;
+      }
+      case "UserPromptSubmit": {
+        const ev = {
+          ...base,
+          prompt: typeof input.message === "string" ? input.message : ""
+        };
+        return ev;
+      }
+      case "SessionStart": {
+        const ev = {
+          ...base,
+          source: normalizeSessionSource(void 0)
+        };
+        return ev;
+      }
+      case "SessionEnd": {
+        const ev = { ...base };
+        return ev;
+      }
+      case "Stop": {
+        const ev = { ...base };
+        return ev;
+      }
+      default: {
+        throw new Error(`unsupported openhands hook event: ${String(event)}`);
+      }
+    }
+  }
+  // ── Runtime: normalized response → OpenHands native (FLAT JSON) hook reply ──
+  // Reply is a FLAT top-level object (NO hookSpecificOutput envelope) parsed by
+  // hooks/executor.py: keys `decision` (allow|deny), `reason`, `additionalContext`.
+  // There is NO "ask" decision (HookDecision is allow|deny only).
+  formatReply(event, response) {
+    const decision = response.decision ?? "allow";
+    if (event === "SessionEnd") {
+      return { exitCode: 0 };
+    }
+    if (decision === "deny" || decision === "ask") {
+      return this.stdout({
+        decision: "deny",
+        reason: response.reason ?? (decision === "ask" ? "Confirmation required by hook" : "Blocked by hook")
+      });
+    }
+    if (decision === "context" && response.additionalContext) {
+      return this.stdout({ additionalContext: response.additionalContext });
+    }
+    return { exitCode: 0 };
+  }
+  stdout(payload) {
+    return { exitCode: 0, stdout: JSON.stringify(payload) };
+  }
+};
+function toolResponseToString(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+var adapter = new OpenHandsAdapter();
+var openhands_default = adapter;
+export {
+  OpenHandsAdapter,
+  adapter,
+  openhands_default as default
+};
+//# sourceMappingURL=openhands-5LNH3BKB.js.map

package/dist/openhands-5LNH3BKB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/openhands/index.ts"],"sourcesContent":["/**\n * adapters/openhands — OpenHands (All-Hands-AI, ex-OpenDevin) platform adapter.\n *\n * OpenHands is a **json-stdio** host (the `openhands` CLI, installed via\n * `uv tool install openhands`). It exposes TWO native config surfaces that live\n * in DIFFERENT files, so getServerConfigPath ≠ getHookConfigPath:\n *\n *   1. MCP servers — `mcp.json` (root key `mcpServers`), in the CLI persistence\n *      dir, which is USER-scoped only:\n *        - persistence dir → ~/.openhands  (override: $OPENHANDS_PERSISTENCE_DIR)\n *        - file            → <persistence>/mcp.json\n *      Byte-confirmed from openhands_cli/locations.py (MCP_CONFIG_FILE=\"mcp.json\",\n *      get_persistence_dir() → ~/.openhands, env $OPENHANDS_PERSISTENCE_DIR) and\n *      openhands_cli/mcp/mcp_utils.py (MCPConfig.from_dict({\"mcpServers\": {}}),\n *      config.mcpServers[name]; the error path literally suggests \"create\n *      ~/.openhands/mcp.json manually\"). Native server entry shape is FastMCP's\n *      StdioMCPServer { command, args, env, transport:\"stdio\", cwd? } and\n *      RemoteMCPServer { url, transport, headers } (fastmcp.mcp_config).\n *      There is NO project-scoped mcp.json for the CLI — it reads the single\n *      persistence-dir file — so installServer ALWAYS targets the user file.\n *\n *   2. Hooks — a SEPARATE `.openhands/hooks.json` (root key `hooks`, the\n *      Claude-Code-plugin-compatible wrapper). OpenHands ships a hook system\n *      that the SDK explicitly documents as honoring \"Claude Code plugin hook\n *      files\" (openhands-sdk/openhands/sdk/hooks/config.py — the\n *      `_normalize_hooks_input` validator unwraps {\"hooks\": {...}} and accepts\n *      PascalCase keys). HookConfig.load() searches, in order:\n *        - <working_dir>/.openhands/hooks.json   (project scope)\n *        - ~/.openhands/hooks.json               (user scope)\n *      first-found wins, so BOTH scopes are valid; project takes precedence.\n *      Registrations use the Claude NESTED-rule shape:\n *        { hooks: { <Event>: [ { matcher?, hooks:[{ type:\"command\", command }] } ] } }\n *      which is exactly what the shared hook-merge engine writes.\n *\n * Supported events (Claude-compatible, byte-confirmed from\n * openhands-sdk/openhands/sdk/hooks/types.py HookEventType): PreToolUse,\n * PostToolUse, UserPromptSubmit, SessionStart, SessionEnd, Stop. OpenHands has\n * NO Notification / PreCompact / SubagentStop / PermissionRequest /\n * PostToolUseFailure / SubagentStart, so those degrade to a warn/skip at install.\n *\n * Runtime wire DIVERGES from Claude (do NOT assume Claude field names — verified\n * against HookEvent.model_dump_json() with use_enum_values=True in types.py):\n *   - `event_type`  (PascalCase string)   — NOT `hook_event_name`\n *   - `tool_name`, `tool_input`           — Claude-identical\n *   - `tool_response` is a DICT           — Claude-identical key, object value\n *   - `message`     (the prompt text)     — NOT `prompt`\n *   - `session_id`                        — Claude-identical\n *   - `working_dir` (the cwd)             — NOT `cwd`\n *   - `metadata`    (free dict)           — no normalized field\n *\n * Reply protocol (byte-confirmed from hooks/executor.py + the 33_hooks example):\n *   exit 0 → success; stdout is parsed as a FLAT JSON object with keys\n *   `decision` (\"allow\"|\"deny\"), `reason`, `additionalContext`. There is NO\n *   `hookSpecificOutput` envelope and NO \"ask\" decision (HookDecision is\n *   allow|deny; ASK is commented-out/future). exit 2 also blocks. So:\n *     - deny    → {\"decision\":\"deny\",\"reason\":...}     (exit 0)\n *     - context → {\"additionalContext\":...}            (exit 0)\n *     - ask     → unsupported; degrades to a deny-style block with the reason\n *                 (OpenHands has no native confirm dialog on the hook wire)\n *   canModifyOutput is false (it cannot rewrite already-emitted tool output);\n *   canInjectSessionContext is true (additionalContext is honored).\n *\n * Env handling: env/header/url refs are resolved to literals at install time via\n * resolveEnvRefsDeep — the safe default matching the Droid/Kiro/Qwen adapters.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter, type HookMergeDescriptor } from \"../base.js\";\nimport type { Adapter, HookReply, InstallContext, NormalizedEvent } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookEventName,\n  HookParadigm,\n  HookResponse,\n  PlatformCapabilities,\n  PlatformId,\n  PostToolUseEvent,\n  PreToolUseEvent,\n  ServerDef,\n  SessionEndEvent,\n  SessionStartEvent,\n  StopEvent,\n  Transport,\n  UserPromptSubmitEvent,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  buildWrappedStdio,\n  isHomeBinHookCommand,\n} from \"../../core/spawn.js\";\nimport { normalizeSessionSource } from \"../claude-code/wire.js\";\n\nconst HOST: PlatformId = \"openhands\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/**\n * Resolve the OpenHands CLI persistence dir. Byte-confirmed from\n * openhands_cli/locations.py: `os.environ.get(\"OPENHANDS_PERSISTENCE_DIR\",\n * os.path.expanduser(\"~/.openhands\"))`. The MCP `mcp.json` lives here regardless\n * of install scope (the CLI has no project-scoped mcp.json).\n */\nfunction persistenceDir(): string {\n  return process.env.OPENHANDS_PERSISTENCE_DIR ?? join(homedir(), \".openhands\");\n}\n\n/**\n * Canonical events OpenHands actually fires (HookEventType in types.py). Event\n * names are Claude-identical PascalCase, so each canonical name registers 1:1.\n * OpenHands has no Notification / PreCompact / SubagentStop / PermissionRequest /\n * PostToolUseFailure / SubagentStart — those warn/skip at install time.\n */\nconst SUPPORTED_EVENTS: ReadonlySet<HookEventName> = new Set<HookEventName>([\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"UserPromptSubmit\",\n  \"SessionStart\",\n  \"SessionEnd\",\n  \"Stop\",\n]);\n\n/**\n * Native MCP server entry shapes OpenHands accepts under `mcpServers` (FastMCP\n * StdioMCPServer / RemoteMCPServer). A stdio entry carries an explicit\n * `transport:\"stdio\"` discriminator; remote transports register a URL.\n */\ninterface OpenHandsStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  transport: \"stdio\";\n}\ninterface OpenHandsRemoteServer {\n  url: string;\n  transport: \"http\" | \"sse\";\n  headers?: Record<string, string>;\n}\n\n/** A single OpenHands native hook registration entry (Claude-shaped, nested). */\ninterface OpenHandsHookEntry {\n  matcher: string;\n  hooks: Array<{ type: \"command\"; command: string }>;\n}\n\n/** The shape of OpenHands' hooks.json (only the parts we touch). */\ninterface OpenHandsHooksFile {\n  hooks?: Record<string, OpenHandsHookEntry[]>;\n  [key: string]: unknown;\n}\n\n/**\n * Raw OpenHands CLI hook stdin payload. These are the EXACT serialized field\n * names of the SDK's HookEvent (use_enum_values=True), NOT Claude's wire —\n * see the header note on the divergences (`event_type`, `working_dir`,\n * `message`, `tool_response` dict).\n */\ninterface OpenHandsWireInput {\n  /** PascalCase event string (\"PreToolUse\", …). */\n  event_type?: string;\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  /** Tool result is a dict on the OpenHands wire (Claude sends it too). */\n  tool_response?: Record<string, unknown> | null;\n  /** UserPromptSubmit text rides on `message` (NOT `prompt`). */\n  message?: string;\n  session_id?: string;\n  /** The cwd rides on `working_dir` (NOT `cwd`). */\n  working_dir?: string;\n  /** Free-form dict; no normalized field. */\n  metadata?: Record<string, unknown>;\n  /** Injected by the entrypoint so the runtime knows which connector to dispatch. */\n  connector?: unknown;\n}\n\nexport class OpenHandsAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"OpenHands\";\n  readonly paradigm: HookParadigm = \"json-stdio\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default.\n    supportsMemory: true,\n    preToolUse: true,\n    postToolUse: true,\n    userPromptSubmit: true,\n    sessionStart: true,\n    sessionEnd: true,\n    stop: true,\n    // OpenHands fires NONE of these on its hook wire (HookEventType has only the\n    // six above) — install reports the standard skip-warn for any of them.\n    // The two REQUIRED PlatformCapabilities flags below are explicitly false;\n    // subagentStop / permissionRequest / postToolUseFailure / subagentStart are\n    // optional and stay unset (read as ?? false) — no OpenHands analog.\n    preCompact: false,\n    notification: false,\n\n    // PreToolUse/UserPromptSubmit/Stop can block (exit 2 or {\"decision\":\"deny\"}),\n    // but the hook wire cannot rewrite tool ARGS or already-emitted tool OUTPUT.\n    canModifyArgs: false,\n    canModifyOutput: false,\n    // additionalContext on the stdout reply is honored (executor.py parses it).\n    canInjectSessionContext: true,\n    // OpenHands registers stdio + remote (Streamable HTTP / SSE) MCP servers.\n    transports: [\"stdio\", \"http\"],\n    // Content surfaces (commands/skills/subagents/statusline/actions) are NOT\n    // wired: OpenHands' CLI uses microagents + an interactive TUI rather than a\n    // Claude-style file-per-command/skill/subagent tree, and no first-party\n    // file layout for those was byte-confirmed. Left unset (honest CEILING).\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = persistenceDir();\n    const userMcp = join(userDir, \"mcp.json\");\n    const projDir = join(projectDir, \".openhands\");\n    const projHooks = join(projDir, \"hooks.json\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userMcp);\n    const projInstalled = existsSync(projDir) || existsSync(projHooks);\n    const installed = userInstalled || projInstalled;\n    // MCP only lives at the user persistence dir; project scope only carries\n    // hooks. Default the reported scope to user (where the MCP config lives).\n    const scope = userInstalled || !projInstalled ? \"user\" : \"project\";\n    const configPath = scope === \"user\" ? userMcp : projHooks;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `found OpenHands config (${scope}) at ${configPath}`\n        : `no OpenHands config at ${userDir} or ${projDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".openhands\")\n      : persistenceDir();\n  }\n\n  /**\n   * MCP `mcp.json` lives in the CLI persistence dir, which is USER-scoped only —\n   * the CLI reads exactly one `<persistence>/mcp.json` and has no project\n   * variant. So this ALWAYS resolves to the user persistence dir regardless of\n   * ctx.scope (writing a project `.openhands/mcp.json` the CLI never reads would\n   * be a silent no-op).\n   */\n  getServerConfigPath(_ctx: InstallContext): string {\n    return join(persistenceDir(), \"mcp.json\");\n  }\n\n  /**\n   * Hooks live in a SEPARATE `.openhands/hooks.json`. HookConfig.load searches\n   * <working_dir>/.openhands/hooks.json then ~/.openhands/hooks.json, so both\n   * scopes are honored — project scope → <projectDir>/.openhands, user scope →\n   * the persistence dir.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"hooks.json\");\n  }\n\n  // ── MCP server install / uninstall ───────────────────────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for openhands\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /** Render a normalized ServerDef into OpenHands' native mcpServers entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): OpenHandsStdioServer | OpenHandsRemoteServer {\n    const transport: Transport = server.transport;\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      // Transparent telemetry wrapping: route the real command through\n      // `<homeBin> serve --connector <id> -- <command> <args...>`.\n      ({ command, args } = buildWrappedStdio(ctx, server, this.id, command, args));\n\n      // Resolve every ${env:VAR} to a literal at install time (safe path).\n      const entry: OpenHandsStdioServer = {\n        command: resolveEnvRefsDeep(command),\n        transport: \"stdio\",\n      };\n      if (args.length > 0) entry.args = resolveEnvRefsDeep(args);\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // http / sse — OpenHands registers a URL (FastMCP RemoteMCPServer). Default\n    // a non-stdio transport to \"http\" (the recommended Streamable HTTP form);\n    // honor an explicit \"sse\".\n    const entry: OpenHandsRemoteServer = {\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n      transport: transport === \"sse\" ? \"sse\" : \"http\",\n    };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /**\n   * Render env/header values. Resolve `${env:VAR}` references to literals at\n   * install time (the safe path matching Droid).\n   */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    return resolveEnvRefsDeep({ ...env });\n  }\n\n  // ── Hook install / uninstall (separate hooks.json, nested-rule shape) ─────\n\n  installHooks(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.hooks === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"hooks disabled for openhands\" }];\n    }\n    if (connector.hookEvents.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no hooks\" }];\n    }\n\n    const pending = connector.hookEvents.map((event) => ({\n      event,\n      matcher: connector.hooks[event]?.matcher ?? \"\",\n    }));\n    return this.upsertHookEntries(\n      ctx,\n      this.getHookConfigPath(ctx),\n      pending,\n      this.hookDescriptor(ctx),\n    );\n  }\n\n  uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    return this.removeHookEntries(ctx, this.getHookConfigPath(ctx), this.hookDescriptor(ctx));\n  }\n\n  /**\n   * OpenHands' hook-merge descriptor (NESTED shape `{ matcher, hooks: [...] }`).\n   * Ownership is CONNECTOR-GENERIC (ANY of our commands in the entry's inner\n   * `hooks`, not a specific-command match), identical to Droid:\n   *  - mapEvent = drop events outside SUPPORTED_EVENTS; supported event names are\n   *    Claude-identical, so they map 1:1.\n   *  - entryOwnsCommand reuses isOurCommand over the inner commands.\n   *  - uninstall = inner-strip ONLY (ownsEntryForRemove never-true).\n   */\n  private hookDescriptor(ctx: InstallContext): HookMergeDescriptor<OpenHandsHookEntry> {\n    return {\n      mapEvent: (e) => (SUPPORTED_EVENTS.has(e as HookEventName) ? e : undefined),\n      unmappedWarnDetail: (e) => `${e} has no OpenHands hook equivalent — skipped`,\n      renderEntry: (_event, matcher, command) => ({\n        matcher,\n        hooks: [{ type: \"command\", command }],\n      }),\n      entryOwnsCommand: (entry, _command) =>\n        (entry.hooks ?? []).some((h) => this.isOurCommand(h.command, ctx)),\n      ownsEntryForRemove: () => () => false,\n      stripInner: (c) => (entry) => {\n        const innerBefore = entry.hooks?.length ?? 0;\n        const inner = (entry.hooks ?? []).filter((h) => !this.isOurCommand(h.command, c));\n        return {\n          next: inner.length > 0 ? { matcher: entry.matcher ?? \"\", hooks: inner } : null,\n          removed: innerBefore - inner.length,\n        };\n      },\n      skipDetail: (event) => `hooks.${event} already registered`,\n      removeDetail: (event, removed) => `hooks.${event} (${removed})`,\n      absentDetail: \"no hooks section present\",\n      noMatchDetail: \"no matching hook entries\",\n    };\n  }\n\n  /** True when a hook command references our home binary AND this connector id\n   *  (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand). */\n  private isOurCommand(command: string | undefined, ctx: InstallContext): boolean {\n    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const mcpPath = this.getServerConfigPath(ctx);\n    const hookPath = this.getHookConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    const homeBin = ctx.homeBinPath;\n    const hookEvents = ctx.connector.hookEvents;\n    return [\n      {\n        name: `${this.name}: mcp.json present`,\n        check: () =>\n          existsSync(mcpPath)\n            ? { status: \"OK\", detail: mcpPath }\n            : { status: \"FAIL\", detail: `not found: ${mcpPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(mcpPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `${MCP_ROOT_KEY}.${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`,\n              };\n        },\n      },\n      {\n        name: `${this.name}: hook command registered`,\n        check: () => {\n          if (hookEvents.length === 0) {\n            return { status: \"OK\", detail: \"no hooks declared\" };\n          }\n          const file = this.readJson<OpenHandsHooksFile>(hookPath);\n          if (!file) return { status: \"FAIL\", detail: `cannot read ${hookPath}` };\n          const hooks = file.hooks ?? {};\n          const registered = Object.values(hooks).some((entries) =>\n            (entries ?? []).some((e) =>\n              (e.hooks ?? []).some((h) =>\n                isHomeBinHookCommand(h.command, homeBin, connectorId),\n              ),\n            ),\n          );\n          return registered\n            ? { status: \"OK\", detail: \"hook command present\" }\n            : { status: \"FAIL\", detail: `no hook for ${connectorId} in ${hookPath}` };\n        },\n      },\n    ];\n  }\n\n  // ── Runtime: parse OpenHands stdin JSON → normalized event ─────────────────\n  // The wire field names DIVERGE from Claude (event_type / working_dir / message\n  // / tool_response-dict) — see the header. Reading Claude's names here would be\n  // a silent false-friend (the kimi-code bug class).\n\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as OpenHandsWireInput;\n    const connectorId = typeof input.connector === \"string\" ? input.connector : \"\";\n    const sessionId = typeof input.session_id === \"string\" ? input.session_id : \"\";\n    const projectDir =\n      typeof input.working_dir === \"string\" ? input.working_dir : undefined;\n\n    const base = {\n      hostPlatform: HOST,\n      connectorId,\n      sessionId,\n      raw,\n      ...(projectDir !== undefined ? { projectDir } : {}),\n    } as const;\n\n    switch (event) {\n      case \"PreToolUse\": {\n        const ev: PreToolUseEvent = {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n        };\n        return ev;\n      }\n      case \"PostToolUse\": {\n        const ev: PostToolUseEvent = {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n          ...(toolResponseToString(input.tool_response) !== undefined\n            ? { toolOutput: toolResponseToString(input.tool_response) }\n            : {}),\n        };\n        return ev;\n      }\n      case \"UserPromptSubmit\": {\n        // The prompt text rides on `message` (NOT `prompt`).\n        const ev: UserPromptSubmitEvent = {\n          ...base,\n          prompt: typeof input.message === \"string\" ? input.message : \"\",\n        };\n        return ev;\n      }\n      case \"SessionStart\": {\n        // OpenHands SessionStart carries no documented `source` discriminator on\n        // the HookEvent wire; normalizeSessionSource(undefined) → the safe\n        // \"startup\" default.\n        const ev: SessionStartEvent = {\n          ...base,\n          source: normalizeSessionSource(undefined),\n        };\n        return ev;\n      }\n      case \"SessionEnd\": {\n        // No documented `reason` enum on the HookEvent wire — omit the field.\n        const ev: SessionEndEvent = { ...base };\n        return ev;\n      }\n      case \"Stop\": {\n        // No stop_hook_active loop-guard field on the OpenHands wire.\n        const ev: StopEvent = { ...base };\n        return ev;\n      }\n      default: {\n        // OpenHands never delivers Notification / PreCompact / SubagentStop /\n        // PermissionRequest / PostToolUseFailure / SubagentStart (no native\n        // equivalent — see SUPPORTED_EVENTS). Surface it loudly rather than\n        // silently mis-parse.\n        throw new Error(`unsupported openhands hook event: ${String(event)}`);\n      }\n    }\n  }\n\n  // ── Runtime: normalized response → OpenHands native (FLAT JSON) hook reply ──\n  // Reply is a FLAT top-level object (NO hookSpecificOutput envelope) parsed by\n  // hooks/executor.py: keys `decision` (allow|deny), `reason`, `additionalContext`.\n  // There is NO \"ask\" decision (HookDecision is allow|deny only).\n\n  formatReply(event: HookEventName, response: HookResponse): HookReply {\n    const decision = response.decision ?? \"allow\";\n\n    // SessionStart / SessionEnd are observe-only (cannot block); they carry no\n    // block surface. SessionStart still honors additionalContext, so it falls\n    // through to the `context` branch; SessionEnd is an unconditional no-op.\n    if (event === \"SessionEnd\") {\n      return { exitCode: 0 };\n    }\n\n    // deny → block with a reason. OpenHands has no \"ask\" on the hook wire, so an\n    // \"ask\" decision degrades to a deny-style block carrying the reason (the\n    // closest honest mapping — a hook that wants confirmation blocks and tells\n    // the agent why, rather than silently passing through).\n    if (decision === \"deny\" || decision === \"ask\") {\n      return this.stdout({\n        decision: \"deny\",\n        reason:\n          response.reason ??\n          (decision === \"ask\" ? \"Confirmation required by hook\" : \"Blocked by hook\"),\n      });\n    }\n\n    // context → inject soft guidance (OpenHands honors additionalContext).\n    if (decision === \"context\" && response.additionalContext) {\n      return this.stdout({ additionalContext: response.additionalContext });\n    }\n\n    // allow / modify (unsupported — exit-code/decision protocol only) / void →\n    // pass through with exit 0.\n    return { exitCode: 0 };\n  }\n\n  private stdout(payload: unknown): HookReply {\n    return { exitCode: 0, stdout: JSON.stringify(payload) };\n  }\n}\n\n/** Coerce an OpenHands PostToolUse `tool_response` (a dict) into a string. */\nfunction 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\nexport const adapter = new OpenHandsAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkEA,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AACxB,SAAS,YAAY;AA6BrB,IAAM,OAAmB;AACzB,IAAM,eAAe;AAQrB,SAAS,iBAAyB;AAChC,SAAO,QAAQ,IAAI,6BAA6B,KAAK,QAAQ,GAAG,YAAY;AAC9E;AAQA,IAAM,mBAA+C,oBAAI,IAAmB;AAAA,EAC1E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAuDM,IAAM,mBAAN,cAA+B,YAA+B;AAAA,EAC1D,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA,IAE5C,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMN,YAAY;AAAA,IACZ,cAAc;AAAA;AAAA;AAAA,IAId,eAAe;AAAA,IACf,iBAAiB;AAAA;AAAA,IAEjB,yBAAyB;AAAA;AAAA,IAEzB,YAAY,CAAC,SAAS,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAK9B;AAAA;AAAA,EAIA,gBAAgB,YAAsC;AACpD,UAAM,UAAU,eAAe;AAC/B,UAAM,UAAU,KAAK,SAAS,UAAU;AACxC,UAAM,UAAU,KAAK,YAAY,YAAY;AAC7C,UAAM,YAAY,KAAK,SAAS,YAAY;AAE5C,UAAM,gBAAgB,WAAW,OAAO,KAAK,WAAW,OAAO;AAC/D,UAAM,gBAAgB,WAAW,OAAO,KAAK,WAAW,SAAS;AACjE,UAAM,YAAY,iBAAiB;AAGnC,UAAM,QAAQ,iBAAiB,CAAC,gBAAgB,SAAS;AACzD,UAAM,aAAa,UAAU,SAAS,UAAU;AAEhD,WAAO;AAAA,MACL,IAAI,KAAK;AAAA,MACT,MAAM,KAAK;AAAA,MACX;AAAA,MACA,UAAU,KAAK;AAAA,MACf,cAAc,KAAK;AAAA,MACnB;AAAA,MACA;AAAA,MACA,QAAQ,YACJ,2BAA2B,KAAK,QAAQ,UAAU,KAClD,0BAA0B,OAAO,OAAO,OAAO;AAAA,MACnD,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA,EAIA,aAAa,KAA6B;AACxC,WAAO,IAAI,UAAU,YACjB,KAAK,IAAI,YAAY,YAAY,IACjC,eAAe;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,oBAAoB,MAA8B;AAChD,WAAO,KAAK,eAAe,GAAG,UAAU;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,YAAY;AAAA,EAClD;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,EAAE,UAAU,IAAI;AACtB,UAAM,WAAW,UAAU,UAAU,IAAI,GAAG;AAC5C,QAAI,CAAC,UAAU,UAAU,aAAa,OAAO;AAC3C,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QAAQ,UAAU,SACd,+CACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SACJ,YAAY,OAAO,aAAa,WAC5B,EAAE,GAAG,UAAU,QAAQ,GAAG,SAAS,IACnC,UAAU;AAEhB,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,QAAQ,KAAK,kBAAkB,KAAK,MAAM;AAEhD,WAAO;AAAA,MACL,KAAK,mBAAmB,YAAY,cAAc,UAAU,IAAI,OAAO,IAAI,MAAM;AAAA,IACnF;AAAA,EACF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,WAAO;AAAA,MACL,KAAK,qBAAqB,YAAY,cAAc,IAAI,UAAU,IAAI,IAAI,MAAM;AAAA,IAClF;AAAA,EACF;AAAA;AAAA,EAGQ,kBACN,KACA,QAC8C;AAC9C,UAAM,YAAuB,OAAO;AAEpC,QAAI,cAAc,SAAS;AACzB,UAAI,UAAU,OAAO,WAAW;AAChC,UAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAIlC,OAAC,EAAE,SAAS,KAAK,IAAI,kBAAkB,KAAK,QAAQ,KAAK,IAAI,SAAS,IAAI;AAG1E,YAAMA,SAA8B;AAAA,QAClC,SAAS,mBAAmB,OAAO;AAAA,QACnC,WAAW;AAAA,MACb;AACA,UAAI,KAAK,SAAS,EAAG,CAAAA,OAAM,OAAO,mBAAmB,IAAI;AACzD,YAAM,MAAM,KAAK,UAAU,OAAO,GAAG;AACrC,UAAI,IAAK,CAAAA,OAAM,MAAM;AACrB,aAAOA;AAAA,IACT;AAKA,UAAM,QAA+B;AAAA,MACnC,KAAK,mBAAmB,OAAO,OAAO,EAAE;AAAA,MACxC,WAAW,cAAc,QAAQ,QAAQ;AAAA,IAC3C;AACA,UAAM,UAAU,KAAK,UAAU,OAAO,OAAO;AAC7C,QAAI,QAAS,OAAM,UAAU;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,UACN,KACoC;AACpC,QAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAClD,WAAO,mBAAmB,EAAE,GAAG,IAAI,CAAC;AAAA,EACtC;AAAA;AAAA,EAIA,aAAa,KAAqC;AAChD,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,UAAU,OAAO;AAC9C,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,QAAI,UAAU,WAAW,WAAW,GAAG;AACrC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,8BAA8B,CAAC;AAAA,IACtF;AAEA,UAAM,UAAU,UAAU,WAAW,IAAI,CAAC,WAAW;AAAA,MACnD;AAAA,MACA,SAAS,UAAU,MAAM,KAAK,GAAG,WAAW;AAAA,IAC9C,EAAE;AACF,WAAO,KAAK;AAAA,MACV;AAAA,MACA,KAAK,kBAAkB,GAAG;AAAA,MAC1B;AAAA,MACA,KAAK,eAAe,GAAG;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,eAAe,KAAqC;AAClD,WAAO,KAAK,kBAAkB,KAAK,KAAK,kBAAkB,GAAG,GAAG,KAAK,eAAe,GAAG,CAAC;AAAA,EAC1F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,eAAe,KAA8D;AACnF,WAAO;AAAA,MACL,UAAU,CAAC,MAAO,iBAAiB,IAAI,CAAkB,IAAI,IAAI;AAAA,MACjE,oBAAoB,CAAC,MAAM,GAAG,CAAC;AAAA,MAC/B,aAAa,CAAC,QAAQ,SAAS,aAAa;AAAA,QAC1C;AAAA,QACA,OAAO,CAAC,EAAE,MAAM,WAAW,QAAQ,CAAC;AAAA,MACtC;AAAA,MACA,kBAAkB,CAAC,OAAO,cACvB,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,SAAS,GAAG,CAAC;AAAA,MACnE,oBAAoB,MAAM,MAAM;AAAA,MAChC,YAAY,CAAC,MAAM,CAAC,UAAU;AAC5B,cAAM,cAAc,MAAM,OAAO,UAAU;AAC3C,cAAM,SAAS,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,aAAa,EAAE,SAAS,CAAC,CAAC;AAChF,eAAO;AAAA,UACL,MAAM,MAAM,SAAS,IAAI,EAAE,SAAS,MAAM,WAAW,IAAI,OAAO,MAAM,IAAI;AAAA,UAC1E,SAAS,cAAc,MAAM;AAAA,QAC/B;AAAA,MACF;AAAA,MACA,YAAY,CAAC,UAAU,SAAS,KAAK;AAAA,MACrC,cAAc,CAAC,OAAO,YAAY,SAAS,KAAK,KAAK,OAAO;AAAA,MAC5D,cAAc;AAAA,MACd,eAAe;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA,EAIQ,aAAa,SAA6B,KAA8B;AAC9E,WAAO,qBAAqB,SAAS,IAAI,aAAa,IAAI,UAAU,EAAE;AAAA,EACxE;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,UAAU,KAAK,oBAAoB,GAAG;AAC5C,UAAM,WAAW,KAAK,kBAAkB,GAAG;AAC3C,UAAM,cAAc,IAAI,UAAU;AAClC,UAAM,UAAU,IAAI;AACpB,UAAM,aAAa,IAAI,UAAU;AACjC,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,OAAO,IACd,EAAE,QAAQ,MAAM,QAAQ,QAAQ,IAChC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,OAAO,GAAG;AAAA,MAC1D;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,CAAC,IAAI,UAAU,QAAQ;AACzB,mBAAO,EAAE,QAAQ,MAAM,QAAQ,yBAAyB;AAAA,UAC1D;AACA,gBAAM,MAAM,KAAK,SAAmD,OAAO;AAC3E,gBAAM,SAAS,MAAM,YAAY;AACjC,cAAI,CAAC,OAAO,CAAC,QAAQ;AACnB,mBAAO,EAAE,QAAQ,QAAQ,QAAQ,MAAM,YAAY,OAAO,OAAO,GAAG;AAAA,UACtE;AACA,iBAAO,eAAe,SAClB,EAAE,QAAQ,MAAM,QAAQ,GAAG,YAAY,IAAI,WAAW,WAAW,IACjE;AAAA,YACE,QAAQ;AAAA,YACR,QAAQ,MAAM,YAAY,IAAI,WAAW,OAAO,OAAO;AAAA,UACzD;AAAA,QACN;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,WAAW,WAAW,GAAG;AAC3B,mBAAO,EAAE,QAAQ,MAAM,QAAQ,oBAAoB;AAAA,UACrD;AACA,gBAAM,OAAO,KAAK,SAA6B,QAAQ;AACvD,cAAI,CAAC,KAAM,QAAO,EAAE,QAAQ,QAAQ,QAAQ,eAAe,QAAQ,GAAG;AACtE,gBAAM,QAAQ,KAAK,SAAS,CAAC;AAC7B,gBAAM,aAAa,OAAO,OAAO,KAAK,EAAE;AAAA,YAAK,CAAC,aAC3C,WAAW,CAAC,GAAG;AAAA,cAAK,CAAC,OACnB,EAAE,SAAS,CAAC,GAAG;AAAA,gBAAK,CAAC,MACpB,qBAAqB,EAAE,SAAS,SAAS,WAAW;AAAA,cACtD;AAAA,YACF;AAAA,UACF;AACA,iBAAO,aACH,EAAE,QAAQ,MAAM,QAAQ,uBAAuB,IAC/C,EAAE,QAAQ,QAAQ,QAAQ,eAAe,WAAW,OAAO,QAAQ,GAAG;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,WAAW,OAAsB,KAA+B;AAC9D,UAAM,QAAS,OAAO,CAAC;AACvB,UAAM,cAAc,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;AAC5E,UAAM,YAAY,OAAO,MAAM,eAAe,WAAW,MAAM,aAAa;AAC5E,UAAM,aACJ,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc;AAE9D,UAAM,OAAO;AAAA,MACX,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACnD;AAEA,YAAQ,OAAO;AAAA,MACb,KAAK,cAAc;AACjB,cAAM,KAAsB;AAAA,UAC1B,GAAG;AAAA,UACH,UAAU,MAAM,aAAa;AAAA,UAC7B,WAAW,MAAM,cAAc,CAAC;AAAA,QAClC;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,eAAe;AAClB,cAAM,KAAuB;AAAA,UAC3B,GAAG;AAAA,UACH,UAAU,MAAM,aAAa;AAAA,UAC7B,WAAW,MAAM,cAAc,CAAC;AAAA,UAChC,GAAI,qBAAqB,MAAM,aAAa,MAAM,SAC9C,EAAE,YAAY,qBAAqB,MAAM,aAAa,EAAE,IACxD,CAAC;AAAA,QACP;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,oBAAoB;AAEvB,cAAM,KAA4B;AAAA,UAChC,GAAG;AAAA,UACH,QAAQ,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;AAAA,QAC9D;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,gBAAgB;AAInB,cAAM,KAAwB;AAAA,UAC5B,GAAG;AAAA,UACH,QAAQ,uBAAuB,MAAS;AAAA,QAC1C;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,cAAc;AAEjB,cAAM,KAAsB,EAAE,GAAG,KAAK;AACtC,eAAO;AAAA,MACT;AAAA,MACA,KAAK,QAAQ;AAEX,cAAM,KAAgB,EAAE,GAAG,KAAK;AAChC,eAAO;AAAA,MACT;AAAA,MACA,SAAS;AAKP,cAAM,IAAI,MAAM,qCAAqC,OAAO,KAAK,CAAC,EAAE;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,OAAsB,UAAmC;AACnE,UAAM,WAAW,SAAS,YAAY;AAKtC,QAAI,UAAU,cAAc;AAC1B,aAAO,EAAE,UAAU,EAAE;AAAA,IACvB;AAMA,QAAI,aAAa,UAAU,aAAa,OAAO;AAC7C,aAAO,KAAK,OAAO;AAAA,QACjB,UAAU;AAAA,QACV,QACE,SAAS,WACR,aAAa,QAAQ,kCAAkC;AAAA,MAC5D,CAAC;AAAA,IACH;AAGA,QAAI,aAAa,aAAa,SAAS,mBAAmB;AACxD,aAAO,KAAK,OAAO,EAAE,mBAAmB,SAAS,kBAAkB,CAAC;AAAA,IACtE;AAIA,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAAA,EAEQ,OAAO,SAA6B;AAC1C,WAAO,EAAE,UAAU,GAAG,QAAQ,KAAK,UAAU,OAAO,EAAE;AAAA,EACxD;AACF;AAGA,SAAS,qBAAqB,OAAoC;AAChE,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;AAEO,IAAM,UAAU,IAAI,iBAAiB;AAC5C,IAAO,oBAAQ;","names":["entry"]}

package/dist/{package-H5V3AZHR.js → package-2EAIYSJ4.js}

@@ -6,20 +6,20 @@ import {
   isPackageFormat,
   packageConnector,
   packageConnectorAll
-} from "./chunk-UYZ53KWS.js";
+} from "./chunk-LF76VPGQ.js";
 import "./chunk-NBUEL74R.js";
+import "./chunk-OPXAP3AC.js";
 import {
   fail,
   print
-} from "./chunk-VKRGQLY4.js";
+} from "./chunk-7HUUINPB.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-7NXEHZAK.js";
-import "./chunk-PZHB5TVA.js";
-import "./chunk-X457NOFE.js";
+} from "./chunk-NWLRJNXM.js";
+import "./chunk-G4CEELKO.js";
+import "./chunk-25CPWJA7.js";
 import "./chunk-56R2ER7K.js";
-import "./chunk-OPXAP3AC.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
 import "./chunk-VVFDU4IX.js";
@@ -132,4 +132,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=package-H5V3AZHR.js.map
+//# sourceMappingURL=package-2EAIYSJ4.js.map

package/dist/{pi-I7BLL4EI.js → pi-BUADR5MJ.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  renderBridgePrelude
+} from "./chunk-FBJQGRET.js";
 import {
   BaseAdapter
 } from "./chunk-VVFDU4IX.js";
@@ -42,7 +45,13 @@ var PiAdapter = class extends BaseAdapter {
     // Content surfaces: prompt-template commands + skills.
     supportsCommands: true,
     supportsSkills: true,
-    supportsSubagents: false
+    supportsSubagents: false,
+    // Action surface: each declared action becomes a user-invokable command
+    // registered INSIDE a generated TS extension module (pi.registerCommand),
+    // shelling out to the home-bin `action` verb — the SAME mechanism the omp
+    // fork uses (omp's action support was inferred FROM pi). supportsActions →
+    // the installActions/uninstallActions overrides below.
+    supportsActions: true
   };
   // ── Detection ────────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
@@ -106,6 +115,21 @@ var PiAdapter = class extends BaseAdapter {
   skillDir(ctx, name) {
     return join(this.skillsDir(ctx), name);
   }
+  /**
+   * Extension package dir Pi loads the action module from, per scope:
+   *   project scope → <projectDir>/.pi/extensions/<id>/
+   *   user scope    → ~/.pi/agent/extensions/<id>/
+   * (mirrors the prompts/skills scope split; the OMP fork uses the analogous
+   * <agentDir>/extensions/<id>/ path.)
+   */
+  extensionDir(ctx) {
+    const base = ctx.scope === "project" ? join(ctx.projectDir, ".pi") : join(homedir(), ".pi", "agent");
+    return join(base, "extensions", ctx.connector.id);
+  }
+  /** The generated action extension entry module: <extensionDir>/index.js. */
+  actionEntryPath(ctx) {
+    return join(this.extensionDir(ctx), "index.js");
+  }
   // ── MCP server (unavailable — Pi has no writable MCP config) ─────────────
   installServer(_ctx) {
     return [
@@ -261,6 +285,112 @@ var PiAdapter = class extends BaseAdapter {
     if (skill.extra) Object.assign(frontmatter, skill.extra);
     return this.renderFrontmatterMd(frontmatter, skill.body);
   }
+  // ── Action surface (slash commands in a generated extension module) ───────
+  // Each declared action becomes a pi.registerCommand(...) inside a generated,
+  // self-contained TS extension module (<extensionDir>/index.js). This mirrors
+  // the OMP adapter's emitter near-verbatim (omp wraps Pi; its action support was
+  // inferred FROM Pi). UNLIKE omp the module is NOT shared with a hook surface —
+  // Pi has no lifecycle hook layer here — so it is actions-only AND
+  // uninstallActions owns the teardown directly (no uninstallHooks to delegate to).
+  // Idempotent (byte-identical → skip) via writeManagedFile; honors
+  // platforms["pi"].actions === false and the empty-actions skip.
+  installActions(ctx) {
+    const entryPath = this.actionEntryPath(ctx);
+    if (ctx.connector.platforms[HOST]?.actions === false) {
+      return [{ platform: this.id, action: "skip", path: entryPath, detail: "actions disabled for pi" }];
+    }
+    if (this.actionTriggers(ctx).length === 0) {
+      return [{ platform: this.id, action: "skip", path: entryPath, detail: "connector declares no actions" }];
+    }
+    return this.synthesizeExtension(ctx).map(
+      (file) => this.writeManagedFile(
+        file.path,
+        file.contents,
+        ctx.dryRun,
+        "pi extension module (action commands)",
+        file.executable
+      )
+    );
+  }
+  uninstallActions(ctx) {
+    const entryPath = this.actionEntryPath(ctx);
+    if (!existsSync(entryPath)) {
+      return [{ platform: this.id, action: "skip", path: entryPath, detail: "no pi extension present" }];
+    }
+    const changes = [
+      this.removeManagedFile(entryPath, ctx.dryRun, "pi extension module", "no pi extension module present")
+    ];
+    changes.push(this.removeDirIfEmpty(this.extensionDir(ctx), ctx.dryRun));
+    return changes;
+  }
+  /**
+   * Build the Pi action extension: a single self-contained ESM module
+   * (<extensionDir>/index.js) whose default export is the Pi plugin factory
+   * `(pi) => void`. It imports nothing from agent-connector. For each declared
+   * action it calls `pi.registerCommand(action.id, { handler })`; the handler
+   * shells out to the stable home binary's `action pi <id>` verb over
+   * child_process (fail-open). Mirrors the OMP adapter's registerCommand emission
+   * (the shared renderBridgePrelude head + the per-action block), minus the hook
+   * handlers Pi has no surface for.
+   */
+  synthesizeExtension(ctx) {
+    return [
+      {
+        path: this.actionEntryPath(ctx),
+        contents: this.buildExtensionSource(ctx),
+        executable: false
+      }
+    ];
+  }
+  /** Compose the generated extension source with plain string concatenation. */
+  buildExtensionSource(ctx) {
+    const header = `/**
+ * AUTO-GENERATED by agent-connector \u2014 DO NOT EDIT.
+ *
+ * Self-contained Pi extension for connector ${ctx.connector.id}. It imports
+ * nothing from agent-connector: each registered command shells out to the stable
+ * home binary's universal action entrypoint. Fail-open: any launcher error
+ * degrades to a no-op (never wedges Pi).
+ *
+ * Pi loads this module and calls its DEFAULT export, the plugin factory
+ * (pi) => void, once at load time; each pi.registerCommand(...) wires one
+ * user-invokable command.
+ */
+import { execFileSync, execSync } from "node:child_process";
+
+${renderBridgePrelude({
+      homeBin: ctx.homeBinPath,
+      connectorId: ctx.connector.id,
+      hookSlug: "pi",
+      payloadNoun: "Pi",
+      failOpenComment: "Fail-open \u2014 never break a Pi command invocation."
+    })}
+`;
+    const actionHandlers = [];
+    for (const action of this.actionTriggers(ctx)) {
+      const id = JSON.stringify(action.id);
+      const description = JSON.stringify(action.description);
+      actionHandlers.push(`  // Action /${action.id} \u2192 run the home-bin action verb directly.
+  pi.registerCommand(${id}, {
+    description: ${description},
+    handler: async (_args, _ctx) => {
+      try {
+        const args = ["action", "pi", ${id}, "--connector", CONNECTOR_ID];
+        process.platform === "win32"
+          ? execSync([HOME_BIN, ...args].map((a) => '"' + a + '"').join(" "), { stdio: "inherit" })
+          : execFileSync(HOME_BIN, args, { stdio: "inherit" });
+      } catch { /* fail-open */ }
+      return undefined;
+    },
+  });`);
+    }
+    const factory = `
+export default function plugin(pi) {
+${actionHandlers.join("\n\n")}
+}
+`;
+    return header + factory;
+  }
   // ── Diagnostics ──────────────────────────────────────────────────────────
   getHealthChecks(ctx) {
     const checks = [];
@@ -278,6 +408,13 @@ var PiAdapter = class extends BaseAdapter {
         check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
       });
     }
+    if (this.actionTriggers(ctx).length > 0 && ctx.connector.platforms[HOST]?.actions !== false) {
+      const p = this.actionEntryPath(ctx);
+      checks.push({
+        name: `${this.name}: action extension present`,
+        check: () => existsSync(p) ? { status: "OK", detail: p } : { status: "FAIL", detail: `not found: ${p}` }
+      });
+    }
     return checks;
   }
 };
@@ -288,4 +425,4 @@ export {
   adapter,
   pi_default as default
 };
-//# sourceMappingURL=pi-I7BLL4EI.js.map
+//# sourceMappingURL=pi-BUADR5MJ.js.map