@ken-jo/agent-connector 0.1.0 → 0.2.0

package/dist/omp-AXA7XY22.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/omp/index.ts"],"sourcesContent":["/**\n * adapters/omp — Oh My Pi (OMP) platform adapter for agent-connector.\n *\n * OMP is a ts-plugin host with NATIVE MCP. The two surfaces are split:\n *\n *   • MCP (native, real file) — OMP reads a real `mcp.json`:\n *       user scope    → <agentDir>/mcp.json   (agentDir = ~/.omp/agent)\n *       project scope → <projectDir>/.omp/mcp.json\n *     JSON, root key \"mcpServers\", stdio entry { command, args, env } — the\n *     portable field names. Verified against can1357/oh-my-pi\n *     (packages/utils/src/dirs.ts getMCPConfigPath + docs/mcp-config.md). OMP\n *     documents no native ${env:VAR} token, so env refs resolve to literals at\n *     install time (resolveEnvRefsDeep).\n *\n *   • Hooks (ts-plugin, in-process) — OMP loads EXTENSION PACKAGES. Its plugin\n *     loader reads a package whose package.json carries an `omp` (or `pi`)\n *     manifest field; the manifest's `extensions` array points at the plugin\n *     module, whose DEFAULT export is a HookFactory `(pi) => void` that calls\n *     `pi.on(event, handler)` (upstream loader.ts:75\n *     `pluginPkg.omp || pluginPkg.pi`; hook factory types.ts:809). context-mode\n *     proved this by dropping an extension under\n *     `<agentDir>/extensions/<name>/{package.json,index.js}` whose index.js\n *     default-exports the OMP plugin factory (src/setup.ts applyPlatformInstall\n *     \"omp\"; src/adapters/omp/plugin.ts).\n *\n * Why we SYNTHESIZE instead of importing context-mode's plugin:\n *   context-mode could load its own plugin module in-process because the handler\n *   code shipped with the package. agent-connector cannot — the connector's hook\n *   handlers are arbitrary developer code we must not import into OMP's runtime\n *   (wrong cwd, wrong deps, version skew, the cache-heal bug class). So, exactly\n *   like the OpenCode adapter, we generate a tiny self-contained ESM extension\n *   that imports NOTHING from agent-connector: each `pi.on(...)` handler shells\n *   out to the ONE stable home binary's universal entrypoint\n *   (`<homeBin> hook omp <event> --connector <id>`) over child_process, feeds it\n *   the OMP-shaped payload as JSON on stdin, and JSON.parses the normalized\n *   HookResponse back from stdout. Fail-open: any bridge error → no-op. One\n *   entrypoint, every paradigm.\n *\n * Event mapping (only events the connector declares are subscribed):\n *   PreToolUse   → pi.on(\"tool_call\",  …)  block via { block:true, reason }\n *                  (OMP tool_call cannot mutate args → canModifyArgs:false)\n *   PostToolUse  → pi.on(\"tool_result\", …) observe-only (no output rewrite hook)\n *   SessionStart → pi.on(\"session_start\", …) (no context-injection surface)\n *   PreCompact   → pi.on(\"session_before_compact\", …) observe-only\n *\n * Distinct storage root from Pi: OMP lives under ~/.omp (NOT ~/.pi); the\n * PI_CODING_AGENT_DIR env var (the only OMP runtime dir override — OMP mirrors\n * any .env `OMP_*` keys to `PI_*` before process.env is read) takes precedence.\n */\n\nimport {\n  chmodSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type {\n  Adapter,\n  GeneratedPluginFile,\n  HookReply,\n  InstallContext,\n  NormalizedEvent,\n} from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookEventName,\n  HookParadigm,\n  HookResponse,\n  PlatformCapabilities,\n  PlatformId,\n  PostToolUseEvent,\n  PreCompactEvent,\n  PreToolUseEvent,\n  ServerDef,\n  SessionStartEvent,\n  Transport,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"omp\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/**\n * Canonical → OMP event name map. A connector hook event is only subscribed by\n * the generated plugin when it appears here AND is declared by the connector.\n * Names verified against the proven context-mode OMP plugin (pi.on targets).\n */\nconst EVENT_TO_OMP: Partial<Record<HookEventName, string>> = {\n  PreToolUse: \"tool_call\",\n  PostToolUse: \"tool_result\",\n  SessionStart: \"session_start\",\n  PreCompact: \"session_before_compact\",\n};\n\n/** Raw payload the generated plugin posts to the universal hook entrypoint. */\ninterface OmpBridgePayload {\n  toolName?: string;\n  toolInput?: Record<string, unknown>;\n  toolOutput?: string;\n  isError?: boolean;\n  sessionId?: string;\n  projectDir?: string;\n}\n\n/** Native MCP server entry shapes OMP accepts under \"mcpServers\". */\ninterface OmpStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\ninterface OmpRemoteServer {\n  url: string;\n  headers?: Record<string, string>;\n}\n\nexport class OMPAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Oh My Pi (OMP)\";\n  readonly paradigm: HookParadigm = \"ts-plugin\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default\n    // (memoryTargets: project <projectDir>/AGENTS.md; user scope where documented).\n    supportsMemory: true,\n    preToolUse: true,\n    postToolUse: true,\n    // session_before_compact is wired as an observe-only PreCompact surface.\n    preCompact: true,\n    sessionStart: true,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    // Newer events: OMP's agent_start/agent_end/turn_* hooks are the MAIN loop\n    // (no subagent lifecycle events), there is no permission/approval surface,\n    // and tool failure is merged into tool_result (isError) rather than a\n    // dedicated event. None are wired, so permissionRequest /\n    // postToolUseFailure / subagentStart / subagentStop stay unset — the\n    // generated bridge never references them and install reports them as\n    // \"unsupported here\".\n    // OMP tool_call gates via { block, reason } only — it does not hand the\n    // handler a mutable args object, so input rewrite is unsupported.\n    canModifyArgs: false,\n    // No tool_result output-rewrite surface upstream.\n    canModifyOutput: false,\n    // No session_start context-injection surface upstream.\n    canInjectSessionContext: false,\n    // OMP registers stdio and remote (http) MCP servers.\n    transports: [\"stdio\", \"http\"],\n  };\n\n  // ── Native paths ───────────────────────────────────────────────────────\n\n  /**\n   * Resolve the OMP agent dir, honoring the PI_CODING_AGENT_DIR override (the\n   * only OMP runtime dir env), else ~/.omp/agent. This is the user-scope root.\n   */\n  private agentDir(): string {\n    const override = process.env.PI_CODING_AGENT_DIR;\n    return override && override !== \"\"\n      ? override\n      : join(homedir(), \".omp\", \"agent\");\n  }\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".omp\")\n      : this.agentDir();\n  }\n\n  /** Native MCP file: <agentDir>/mcp.json (user) or <projectDir>/.omp/mcp.json. */\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp.json\");\n  }\n\n  /**\n   * For this ts-plugin host the \"hook config path\" is the generated extension\n   * entrypoint module (index.js). OMP loads the extension package by reading its\n   * package.json manifest, so the package.json is written alongside (see\n   * synthesizePlugin); this returns the entry module the manifest points at.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return join(this.extensionDir(ctx), \"index.js\");\n  }\n\n  /** Extension package directory OMP loads the plugin from, per scope. */\n  private extensionDir(ctx: InstallContext): string {\n    const base =\n      ctx.scope === \"project\"\n        ? join(ctx.projectDir, \".omp\")\n        : this.agentDir();\n    return join(base, \"extensions\", ctx.connector.id);\n  }\n\n  // ── Detection ──────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userAgentDir = this.agentDir();\n    const userConfig = join(userAgentDir, \"mcp.json\");\n    const projectConfig = join(projectDir, \".omp\", \"mcp.json\");\n\n    const userInstalled = existsSync(userAgentDir) || existsSync(userConfig);\n    const projInstalled =\n      existsSync(join(projectDir, \".omp\")) || existsSync(projectConfig);\n    const installed = userInstalled || projInstalled;\n\n    // Report the marker that actually matched.\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projectConfig : userConfig;\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        ? scope === \"project\"\n          ? `found project OMP dir at ${join(projectDir, \".omp\")}`\n          : `found OMP agent dir at ${userAgentDir}`\n        : `no OMP agent dir at ${userAgentDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── MCP server install / uninstall (native mcp.json) ────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const server = this.effectiveServer(ctx);\n    const serverPath = this.getServerConfigPath(ctx);\n\n    if (!server) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: serverPath,\n          detail: ctx.connector.server\n            ? \"server registration disabled for omp\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    const entry = this.renderServerEntry(ctx, server);\n    return [\n      this.upsertServerInJson(\n        serverPath,\n        MCP_ROOT_KEY,\n        ctx.connector.id,\n        entry,\n        ctx.dryRun,\n      ),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(\n        serverPath,\n        MCP_ROOT_KEY,\n        ctx.connector.id,\n        ctx.dryRun,\n      ),\n    ];\n  }\n\n  /** Resolve the per-platform server override into an effective ServerDef. */\n  private effectiveServer(ctx: InstallContext): ServerDef | undefined {\n    const override = ctx.connector.platforms[HOST]?.server;\n    if (override === false) return undefined;\n    const base = ctx.connector.server;\n    if (!base) return undefined;\n    return override && typeof override === \"object\"\n      ? { ...base, ...override }\n      : base;\n  }\n\n  /**\n   * Render a normalized ServerDef into OMP's native \"mcpServers\" entry.\n   *\n   * stdio  → { command, args, env }  (portable field names)\n   * remote → { url, headers? }\n   *\n   * Telemetry wrapping routes the real command through\n   * `<homeBin> serve --connector <id> -- <command> <args...>`. OMP has no native\n   * env interpolation token, so every ${env:VAR} ref resolves to a literal.\n   */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): OmpStdioServer | OmpRemoteServer {\n    const transport: Transport = server.transport;\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n        const wrapped = buildServeWrapperCommand(\n          ctx.homeBinPath,\n          ctx.connector.id,\n          command,\n          args,\n          ctx.scope,\n          this.id,\n        );\n        command = wrapped.command;\n        args = wrapped.args;\n      }\n\n      const entry: OmpStdioServer = {\n        command: resolveEnvRefsDeep(command),\n      };\n      const resolvedArgs = resolveEnvRefsDeep(args).filter((s) => s !== \"\");\n      if (resolvedArgs.length > 0) entry.args = resolvedArgs;\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // remote (http / sse / ws) — OMP registers a URL.\n    const entry: OmpRemoteServer = {\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n    };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /** Resolve every ${env:VAR} ref to a literal (OMP has no native token). */\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 (ts-plugin extension package) ──────────────\n\n  installHooks(ctx: InstallContext): ChangeRecord[] {\n    const entryPath = this.getHookConfigPath(ctx);\n\n    if (ctx.connector.platforms[HOST]?.hooks === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: entryPath,\n          detail: \"hooks disabled for omp\",\n        },\n      ];\n    }\n    if (ctx.connector.hookEvents.length === 0) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: entryPath,\n          detail: \"connector declares no hooks\",\n        },\n      ];\n    }\n\n    const files = this.synthesizePlugin(ctx);\n    const changes: ChangeRecord[] = [];\n\n    for (const file of files) {\n      const before = existsSync(file.path)\n        ? this.safeRead(file.path)\n        : undefined;\n      let action: ChangeRecord[\"action\"];\n      if (before === undefined) action = \"create\";\n      else if (before === file.contents) action = \"skip\";\n      else action = \"update\";\n\n      if (action !== \"skip\" && !ctx.dryRun) {\n        ensureDir(dirname(file.path));\n        writeFileSync(file.path, file.contents, \"utf8\");\n        chmodSync(file.path, file.executable ? 0o755 : 0o644);\n      }\n\n      changes.push({\n        platform: this.id,\n        action,\n        path: file.path,\n        detail: file.path.endsWith(\"package.json\")\n          ? \"omp extension manifest\"\n          : `omp plugin module (${this.hookDetail(ctx)})`,\n      });\n    }\n\n    return changes;\n  }\n\n  /**\n   * Human-facing summary of which declared events the synthesized module ACTUALLY\n   * wires. Only events present in EVENT_TO_OMP are mapped/wired; any declared\n   * event with no OMP mapping (e.g. UserPromptSubmit) is reported separately as\n   * \"unsupported here\" so the detail never overstates coverage.\n   */\n  private hookDetail(ctx: InstallContext): string {\n    const declared = ctx.connector.hookEvents;\n    const mapped = declared.filter((e) => EVENT_TO_OMP[e] !== undefined);\n    const unsupported = declared.filter((e) => EVENT_TO_OMP[e] === undefined);\n    const base = mapped.join(\",\");\n    return unsupported.length > 0\n      ? `${base}; unsupported here: ${unsupported.join(\",\")}`\n      : base;\n  }\n\n  uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    const entryPath = this.getHookConfigPath(ctx);\n    const manifestPath = join(this.extensionDir(ctx), \"package.json\");\n    const present = [entryPath, manifestPath].filter((p) => existsSync(p));\n\n    if (present.length === 0) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: entryPath,\n          detail: \"no omp extension present\",\n        },\n      ];\n    }\n\n    const changes: ChangeRecord[] = [];\n    for (const p of present) {\n      if (!ctx.dryRun) rmSync(p, { force: true });\n      changes.push({\n        platform: this.id,\n        action: \"remove\",\n        path: p,\n        detail: p.endsWith(\"package.json\")\n          ? \"omp extension manifest\"\n          : \"omp plugin module\",\n      });\n    }\n    return changes;\n  }\n\n  // ── ts-plugin synthesis ────────────────────────────────────────────────\n\n  /**\n   * Build the OMP extension package: TWO files.\n   *\n   *   1. package.json — the manifest OMP's loader reads. It carries the `omp`\n   *      field (`pluginPkg.omp || pluginPkg.pi`) whose `extensions` array points\n   *      at the entry module, plus `type:\"module\"` and `main:\"index.js\"`.\n   *   2. index.js — a self-contained ESM plugin that imports nothing from\n   *      agent-connector. Its default export is the OMP HookFactory `(pi)=>void`;\n   *      each declared event registers a `pi.on(...)` handler that bridges to the\n   *      home binary via execFileSync (fail-open) and applies the normalized\n   *      response.\n   */\n  synthesizePlugin(ctx: InstallContext): GeneratedPluginFile[] {\n    const dir = this.extensionDir(ctx);\n    return [\n      {\n        path: join(dir, \"package.json\"),\n        contents: this.buildManifest(ctx),\n        executable: false,\n      },\n      {\n        path: join(dir, \"index.js\"),\n        contents: this.buildPluginSource(ctx),\n        executable: false,\n      },\n    ];\n  }\n\n  /** The extension package.json manifest OMP's plugin loader reads. */\n  private buildManifest(ctx: InstallContext): string {\n    const manifest = {\n      name: ctx.connector.id,\n      version: ctx.connector.version || \"0.0.0\",\n      description: `${ctx.connector.displayName} OMP extension (generated by agent-connector)`,\n      type: \"module\",\n      main: \"index.js\",\n      // pluginPkg.omp || pluginPkg.pi → manifest. extensions points at the entry.\n      omp: {\n        extensions: [\"./index.js\"],\n      },\n    };\n    return `${JSON.stringify(manifest, null, 2)}\\n`;\n  }\n\n  /** Compose the generated plugin source with plain string concatenation. */\n  private buildPluginSource(ctx: InstallContext): string {\n    const homeBin = JSON.stringify(ctx.homeBinPath);\n    const connectorId = JSON.stringify(ctx.connector.id);\n\n    const events = ctx.connector.hookEvents.filter(\n      (e): e is HookEventName => EVENT_TO_OMP[e] !== undefined,\n    );\n    const has = (e: HookEventName) => events.includes(e);\n\n    const header = `/**\n * AUTO-GENERATED by agent-connector — DO NOT EDIT.\n *\n * Self-contained Oh My Pi (OMP) plugin extension for connector ${ctx.connector.id}.\n * It imports nothing from agent-connector: every hook invocation shells out to\n * the stable home binary's universal entrypoint and JSON-parses the normalized\n * response. Fail-open: any bridge error degrades to a no-op (never wedges OMP).\n *\n * OMP loads this module via the sibling package.json \"omp\" manifest field; the\n * default export is the HookFactory (pi) => void called once at load time.\n */\nimport { execFileSync, execSync } from \"node:child_process\";\n\nconst HOME_BIN = ${homeBin};\nconst CONNECTOR_ID = ${connectorId};\n\n/**\n * Invoke the universal hook entrypoint for one event.\n * @param {string} event canonical event name\n * @param {object} payload OMP-shaped payload posted on stdin\n * @returns {object|null} normalized HookResponse, or null on any failure\n */\nfunction bridge(event, payload) {\n  try {\n    // On Windows HOME_BIN is the agent-connector.cmd launcher: Node cannot\n    // execFile a batch file, and shell+args is deprecated (DEP0190), so run one\n    // quoted command line via a shell. POSIX keeps the direct execFile (no shell).\n    const args = [\"hook\", \"omp\", event, \"--connector\", CONNECTOR_ID];\n    const opts = { input: JSON.stringify(payload), encoding: \"utf8\" };\n    const stdout =\n      process.platform === \"win32\"\n        ? execSync([HOME_BIN, ...args].map((a) => '\"' + a + '\"').join(\" \"), opts)\n        : execFileSync(HOME_BIN, args, opts);\n    const text = (stdout || \"\").trim();\n    if (text === \"\") return { decision: \"allow\" };\n    return JSON.parse(text);\n  } catch {\n    // Fail-open — never break an OMP tool call / lifecycle event.\n    return null;\n  }\n}\n\n// OMP exposes the project dir via PI_PROJECT_DIR (PI_*-prefixed only); fall\n// through to cwd. The plugin process is long-lived, so resolve once at load.\nconst PROJECT_DIR = process.env.PI_PROJECT_DIR || process.cwd();\n\n// Derive a stable session id from OMP's session manager when available\n// (ctx.sessionManager.getSessionFile()), else a wall-clock token. The id is\n// rebound on each session_start so multi-session reuse stays attributed.\nlet SESSION_ID = \"\";\nfunction deriveSessionId(ctx) {\n  try {\n    const f = ctx && ctx.sessionManager && typeof ctx.sessionManager.getSessionFile === \"function\"\n      ? ctx.sessionManager.getSessionFile()\n      : \"\";\n    if (f && typeof f === \"string\") return f;\n  } catch {\n    // best effort\n  }\n  return \"omp-\" + Date.now();\n}\n`;\n\n    const handlers: string[] = [];\n\n    if (has(\"SessionStart\")) {\n      handlers.push(`  // SessionStart → rebind the session id and notify the connector.\n  pi.on(\"session_start\", (_event, ctx) => {\n    SESSION_ID = deriveSessionId(ctx);\n    bridge(\"SessionStart\", { sessionId: SESSION_ID, projectDir: PROJECT_DIR });\n    return undefined;\n  });`);\n    }\n\n    if (has(\"PreToolUse\")) {\n      handlers.push(`  // PreToolUse → block via { block, reason }. OMP tool_call cannot mutate\n  // args, so \"ask\" degrades to a block (the safe direction); \"modify\" degrades\n  // to ALLOW (no-block), matching opencode/claude-code — only deny/ask block.\n  pi.on(\"tool_call\", (event) => {\n    const payload = {\n      toolName: (event && event.toolName) || \"\",\n      toolInput: (event && event.input) || {},\n      sessionId: SESSION_ID,\n      projectDir: PROJECT_DIR,\n    };\n    const res = bridge(\"PreToolUse\", payload);\n    if (!res) return undefined;\n    if (res.decision === \"deny\" || res.decision === \"ask\") {\n      return { block: true, reason: res.reason || \"Blocked by ${ctx.connector.id}\" };\n    }\n    return undefined;\n  });`);\n    }\n\n    if (has(\"PostToolUse\")) {\n      handlers.push(`  // PostToolUse → observe tool results (no output-rewrite surface upstream).\n  pi.on(\"tool_result\", (event) => {\n    const content = (event && Array.isArray(event.content)) ? event.content : [];\n    const toolOutput = content\n      .filter((c) => c && c.type === \"text\" && typeof c.text === \"string\")\n      .map((c) => c.text)\n      .join(\"\\\\n\");\n    const payload = {\n      toolName: (event && event.toolName) || \"\",\n      toolInput: (event && event.input) || {},\n      toolOutput,\n      isError: !!(event && event.isError),\n      sessionId: SESSION_ID,\n      projectDir: PROJECT_DIR,\n    };\n    bridge(\"PostToolUse\", payload);\n    return undefined;\n  });`);\n    }\n\n    if (has(\"PreCompact\")) {\n      handlers.push(`  // PreCompact → notify before OMP compacts the context window.\n  pi.on(\"session_before_compact\", () => {\n    bridge(\"PreCompact\", { sessionId: SESSION_ID, projectDir: PROJECT_DIR });\n    return undefined;\n  });`);\n    }\n\n    const factory = `\nexport default function plugin(pi) {\n${handlers.join(\"\\n\\n\")}\n}\n`;\n\n    return header + factory;\n  }\n\n  // ── Runtime: parse OUR bridge payload → normalized event ───────────────\n\n  /**\n   * `raw` is the payload OUR generated plugin posts (NOT a host-native shape):\n   *   { toolName?, toolInput?, toolOutput?, isError?, sessionId?, projectDir? }\n   * so this maps straight through.\n   */\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as OmpBridgePayload;\n    const base = {\n      hostPlatform: HOST,\n      connectorId: \"\",\n      sessionId: typeof input.sessionId === \"string\" ? input.sessionId : \"\",\n      raw,\n      ...(typeof input.projectDir === \"string\"\n        ? { projectDir: input.projectDir }\n        : {}),\n    } as const;\n\n    switch (event) {\n      case \"PreToolUse\": {\n        const ev: PreToolUseEvent = {\n          ...base,\n          toolName: input.toolName ?? \"\",\n          toolInput: input.toolInput ?? {},\n        };\n        return ev;\n      }\n      case \"PostToolUse\": {\n        const ev: PostToolUseEvent = {\n          ...base,\n          toolName: input.toolName ?? \"\",\n          toolInput: input.toolInput ?? {},\n          ...(typeof input.toolOutput === \"string\"\n            ? { toolOutput: input.toolOutput }\n            : {}),\n          ...(typeof input.isError === \"boolean\"\n            ? { isError: input.isError }\n            : {}),\n        };\n        return ev;\n      }\n      case \"PreCompact\": {\n        const ev: PreCompactEvent = { ...base };\n        return ev;\n      }\n      case \"SessionStart\": {\n        const ev: SessionStartEvent = { ...base, source: \"startup\" };\n        return ev;\n      }\n      default:\n        // Other canonical events are not surfaced by OMP; treat as a\n        // session-start-shaped no-op so the dispatcher fails open gracefully.\n        return { ...base, source: \"startup\" } satisfies SessionStartEvent;\n    }\n  }\n\n  // ── Runtime: normalized response → reply the generated bridge parses ───\n\n  /**\n   * Unlike json-stdio hosts (whose reply is the host's NATIVE control payload),\n   * OUR generated bridge consumes this stdout directly. So the reply body is the\n   * NORMALIZED HookResponse itself — the bridge JSON.parses it and maps decision\n   * → OMP's { block, reason } for tool_call (and ignores it otherwise).\n   */\n  formatReply(_event: HookEventName, response: HookResponse): HookReply {\n    return {\n      exitCode: 0,\n      stdout: JSON.stringify(response ?? { decision: \"allow\" }),\n    };\n  }\n\n  // ── Diagnostics ────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    const entryPath = this.getHookConfigPath(ctx);\n    const manifestPath = join(this.extensionDir(ctx), \"package.json\");\n    const connectorId = ctx.connector.id;\n    const hasHooks = ctx.connector.hookEvents.length > 0;\n\n    return [\n      {\n        name: `${this.name}: mcp.json present`,\n        check: () =>\n          existsSync(serverPath)\n            ? { status: \"OK\", detail: serverPath }\n            : { status: \"FAIL\", detail: `not found: ${serverPath}` },\n      },\n      {\n        name: `${this.name}: ${MCP_ROOT_KEY}.${connectorId} 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> }>(\n            serverPath,\n          );\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return {\n              status: \"FAIL\",\n              detail: `no ${MCP_ROOT_KEY} in ${serverPath}`,\n            };\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 ${serverPath}`,\n              };\n        },\n      },\n      {\n        name: `${this.name}: extension package present`,\n        check: () => {\n          if (!hasHooks) return { status: \"OK\", detail: \"no hooks declared\" };\n          if (!existsSync(manifestPath)) {\n            return { status: \"FAIL\", detail: `not found: ${manifestPath}` };\n          }\n          return existsSync(entryPath)\n            ? { status: \"OK\", detail: entryPath }\n            : { status: \"FAIL\", detail: `not found: ${entryPath}` };\n        },\n      },\n    ];\n  }\n\n  /** Read a file, returning undefined on any error (idempotency compare). */\n  private safeRead(path: string): string | undefined {\n    try {\n      return readFileSync(path, \"utf8\");\n    } catch {\n      return undefined;\n    }\n  }\n}\n\n/** Create a directory (recursive) if it does not already exist. */\nfunction ensureDir(dir: string): void {\n  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n}\n\nexport const adapter = new OMPAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;AAkDA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe;AACxB,SAAS,SAAS,YAAY;AAgC9B,IAAM,OAAmB;AACzB,IAAM,eAAe;AAOrB,IAAM,eAAuD;AAAA,EAC3D,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,cAAc;AAAA,EACd,YAAY;AACd;AAuBO,IAAM,aAAN,cAAyB,YAA+B;AAAA,EACpD,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA;AAAA,IAG5C,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,aAAa;AAAA;AAAA,IAEb,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,MAAM;AAAA,IACN,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUd,eAAe;AAAA;AAAA,IAEf,iBAAiB;AAAA;AAAA,IAEjB,yBAAyB;AAAA;AAAA,IAEzB,YAAY,CAAC,SAAS,MAAM;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,WAAmB;AACzB,UAAM,WAAW,QAAQ,IAAI;AAC7B,WAAO,YAAY,aAAa,KAC5B,WACA,KAAK,QAAQ,GAAG,QAAQ,OAAO;AAAA,EACrC;AAAA,EAEA,aAAa,KAA6B;AACxC,WAAO,IAAI,UAAU,YACjB,KAAK,IAAI,YAAY,MAAM,IAC3B,KAAK,SAAS;AAAA,EACpB;AAAA;AAAA,EAGA,oBAAoB,KAA6B;AAC/C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,UAAU;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,UAAU;AAAA,EAChD;AAAA;AAAA,EAGQ,aAAa,KAA6B;AAChD,UAAM,OACJ,IAAI,UAAU,YACV,KAAK,IAAI,YAAY,MAAM,IAC3B,KAAK,SAAS;AACpB,WAAO,KAAK,MAAM,cAAc,IAAI,UAAU,EAAE;AAAA,EAClD;AAAA;AAAA,EAIA,gBAAgB,YAAsC;AACpD,UAAM,eAAe,KAAK,SAAS;AACnC,UAAM,aAAa,KAAK,cAAc,UAAU;AAChD,UAAM,gBAAgB,KAAK,YAAY,QAAQ,UAAU;AAEzD,UAAM,gBAAgB,WAAW,YAAY,KAAK,WAAW,UAAU;AACvE,UAAM,gBACJ,WAAW,KAAK,YAAY,MAAM,CAAC,KAAK,WAAW,aAAa;AAClE,UAAM,YAAY,iBAAiB;AAGnC,UAAM,QAAQ,iBAAiB,CAAC,gBAAgB,YAAY;AAC5D,UAAM,aAAa,UAAU,YAAY,gBAAgB;AAEzD,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,UAAU,YACR,4BAA4B,KAAK,YAAY,MAAM,CAAC,KACpD,0BAA0B,YAAY,KACxC,uBAAuB,YAAY;AAAA,MACvC,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,SAAS,KAAK,gBAAgB,GAAG;AACvC,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAE/C,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ,IAAI,UAAU,SAClB,yCACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,KAAK,kBAAkB,KAAK,MAAM;AAChD,WAAO;AAAA,MACL,KAAK;AAAA,QACH;AAAA,QACA;AAAA,QACA,IAAI,UAAU;AAAA,QACd;AAAA,QACA,IAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,WAAO;AAAA,MACL,KAAK;AAAA,QACH;AAAA,QACA;AAAA,QACA,IAAI,UAAU;AAAA,QACd,IAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGQ,gBAAgB,KAA4C;AAClE,UAAM,WAAW,IAAI,UAAU,UAAU,IAAI,GAAG;AAChD,QAAI,aAAa,MAAO,QAAO;AAC/B,UAAM,OAAO,IAAI,UAAU;AAC3B,QAAI,CAAC,KAAM,QAAO;AAClB,WAAO,YAAY,OAAO,aAAa,WACnC,EAAE,GAAG,MAAM,GAAG,SAAS,IACvB;AAAA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYQ,kBACN,KACA,QACkC;AAClC,UAAM,YAAuB,OAAO;AAEpC,QAAI,cAAc,SAAS;AACzB,UAAI,UAAU,OAAO,WAAW;AAChC,UAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAElC,UAAI,uBAAuB,QAAQ,IAAI,UAAU,SAAS,GAAG;AAC3D,cAAM,UAAU;AAAA,UACd,IAAI;AAAA,UACJ,IAAI,UAAU;AAAA,UACd;AAAA,UACA;AAAA,UACA,IAAI;AAAA,UACJ,KAAK;AAAA,QACP;AACA,kBAAU,QAAQ;AAClB,eAAO,QAAQ;AAAA,MACjB;AAEA,YAAMA,SAAwB;AAAA,QAC5B,SAAS,mBAAmB,OAAO;AAAA,MACrC;AACA,YAAM,eAAe,mBAAmB,IAAI,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AACpE,UAAI,aAAa,SAAS,EAAG,CAAAA,OAAM,OAAO;AAC1C,YAAM,MAAM,KAAK,UAAU,OAAO,GAAG;AACrC,UAAI,IAAK,CAAAA,OAAM,MAAM;AACrB,aAAOA;AAAA,IACT;AAGA,UAAM,QAAyB;AAAA,MAC7B,KAAK,mBAAmB,OAAO,OAAO,EAAE;AAAA,IAC1C;AACA,UAAM,UAAU,KAAK,UAAU,OAAO,OAAO;AAC7C,QAAI,QAAS,OAAM,UAAU;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA,EAGQ,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,YAAY,KAAK,kBAAkB,GAAG;AAE5C,QAAI,IAAI,UAAU,UAAU,IAAI,GAAG,UAAU,OAAO;AAClD,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AACA,QAAI,IAAI,UAAU,WAAW,WAAW,GAAG;AACzC,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,KAAK,iBAAiB,GAAG;AACvC,UAAM,UAA0B,CAAC;AAEjC,eAAW,QAAQ,OAAO;AACxB,YAAM,SAAS,WAAW,KAAK,IAAI,IAC/B,KAAK,SAAS,KAAK,IAAI,IACvB;AACJ,UAAI;AACJ,UAAI,WAAW,OAAW,UAAS;AAAA,eAC1B,WAAW,KAAK,SAAU,UAAS;AAAA,UACvC,UAAS;AAEd,UAAI,WAAW,UAAU,CAAC,IAAI,QAAQ;AACpC,kBAAU,QAAQ,KAAK,IAAI,CAAC;AAC5B,sBAAc,KAAK,MAAM,KAAK,UAAU,MAAM;AAC9C,kBAAU,KAAK,MAAM,KAAK,aAAa,MAAQ,GAAK;AAAA,MACtD;AAEA,cAAQ,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf;AAAA,QACA,MAAM,KAAK;AAAA,QACX,QAAQ,KAAK,KAAK,SAAS,cAAc,IACrC,2BACA,sBAAsB,KAAK,WAAW,GAAG,CAAC;AAAA,MAChD,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,WAAW,KAA6B;AAC9C,UAAM,WAAW,IAAI,UAAU;AAC/B,UAAM,SAAS,SAAS,OAAO,CAAC,MAAM,aAAa,CAAC,MAAM,MAAS;AACnE,UAAM,cAAc,SAAS,OAAO,CAAC,MAAM,aAAa,CAAC,MAAM,MAAS;AACxE,UAAM,OAAO,OAAO,KAAK,GAAG;AAC5B,WAAO,YAAY,SAAS,IACxB,GAAG,IAAI,uBAAuB,YAAY,KAAK,GAAG,CAAC,KACnD;AAAA,EACN;AAAA,EAEA,eAAe,KAAqC;AAClD,UAAM,YAAY,KAAK,kBAAkB,GAAG;AAC5C,UAAM,eAAe,KAAK,KAAK,aAAa,GAAG,GAAG,cAAc;AAChE,UAAM,UAAU,CAAC,WAAW,YAAY,EAAE,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;AAErE,QAAI,QAAQ,WAAW,GAAG;AACxB,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UAA0B,CAAC;AACjC,eAAW,KAAK,SAAS;AACvB,UAAI,CAAC,IAAI,OAAQ,QAAO,GAAG,EAAE,OAAO,KAAK,CAAC;AAC1C,cAAQ,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,QAAQ,EAAE,SAAS,cAAc,IAC7B,2BACA;AAAA,MACN,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,iBAAiB,KAA4C;AAC3D,UAAM,MAAM,KAAK,aAAa,GAAG;AACjC,WAAO;AAAA,MACL;AAAA,QACE,MAAM,KAAK,KAAK,cAAc;AAAA,QAC9B,UAAU,KAAK,cAAc,GAAG;AAAA,QAChC,YAAY;AAAA,MACd;AAAA,MACA;AAAA,QACE,MAAM,KAAK,KAAK,UAAU;AAAA,QAC1B,UAAU,KAAK,kBAAkB,GAAG;AAAA,QACpC,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGQ,cAAc,KAA6B;AACjD,UAAM,WAAW;AAAA,MACf,MAAM,IAAI,UAAU;AAAA,MACpB,SAAS,IAAI,UAAU,WAAW;AAAA,MAClC,aAAa,GAAG,IAAI,UAAU,WAAW;AAAA,MACzC,MAAM;AAAA,MACN,MAAM;AAAA;AAAA,MAEN,KAAK;AAAA,QACH,YAAY,CAAC,YAAY;AAAA,MAC3B;AAAA,IACF;AACA,WAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA;AAAA,EAC7C;AAAA;AAAA,EAGQ,kBAAkB,KAA6B;AACrD,UAAM,UAAU,KAAK,UAAU,IAAI,WAAW;AAC9C,UAAM,cAAc,KAAK,UAAU,IAAI,UAAU,EAAE;AAEnD,UAAM,SAAS,IAAI,UAAU,WAAW;AAAA,MACtC,CAAC,MAA0B,aAAa,CAAC,MAAM;AAAA,IACjD;AACA,UAAM,MAAM,CAAC,MAAqB,OAAO,SAAS,CAAC;AAEnD,UAAM,SAAS;AAAA;AAAA;AAAA,kEAG+C,IAAI,UAAU,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAU/D,OAAO;AAAA,uBACH,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiD9B,UAAM,WAAqB,CAAC;AAE5B,QAAI,IAAI,cAAc,GAAG;AACvB,eAAS,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA,MAKd;AAAA,IACF;AAEA,QAAI,IAAI,YAAY,GAAG;AACrB,eAAS,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gEAa4C,IAAI,UAAU,EAAE;AAAA;AAAA;AAAA,MAG1E;AAAA,IACF;AAEA,QAAI,IAAI,aAAa,GAAG;AACtB,eAAS,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAiBd;AAAA,IACF;AAEA,QAAI,IAAI,YAAY,GAAG;AACrB,eAAS,KAAK;AAAA;AAAA;AAAA;AAAA,MAId;AAAA,IACF;AAEA,UAAM,UAAU;AAAA;AAAA,EAElB,SAAS,KAAK,MAAM,CAAC;AAAA;AAAA;AAInB,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,OAAsB,KAA+B;AAC9D,UAAM,QAAS,OAAO,CAAC;AACvB,UAAM,OAAO;AAAA,MACX,cAAc;AAAA,MACd,aAAa;AAAA,MACb,WAAW,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;AAAA,MACnE;AAAA,MACA,GAAI,OAAO,MAAM,eAAe,WAC5B,EAAE,YAAY,MAAM,WAAW,IAC/B,CAAC;AAAA,IACP;AAEA,YAAQ,OAAO;AAAA,MACb,KAAK,cAAc;AACjB,cAAM,KAAsB;AAAA,UAC1B,GAAG;AAAA,UACH,UAAU,MAAM,YAAY;AAAA,UAC5B,WAAW,MAAM,aAAa,CAAC;AAAA,QACjC;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,eAAe;AAClB,cAAM,KAAuB;AAAA,UAC3B,GAAG;AAAA,UACH,UAAU,MAAM,YAAY;AAAA,UAC5B,WAAW,MAAM,aAAa,CAAC;AAAA,UAC/B,GAAI,OAAO,MAAM,eAAe,WAC5B,EAAE,YAAY,MAAM,WAAW,IAC/B,CAAC;AAAA,UACL,GAAI,OAAO,MAAM,YAAY,YACzB,EAAE,SAAS,MAAM,QAAQ,IACzB,CAAC;AAAA,QACP;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,cAAc;AACjB,cAAM,KAAsB,EAAE,GAAG,KAAK;AACtC,eAAO;AAAA,MACT;AAAA,MACA,KAAK,gBAAgB;AACnB,cAAM,KAAwB,EAAE,GAAG,MAAM,QAAQ,UAAU;AAC3D,eAAO;AAAA,MACT;AAAA,MACA;AAGE,eAAO,EAAE,GAAG,MAAM,QAAQ,UAAU;AAAA,IACxC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,YAAY,QAAuB,UAAmC;AACpE,WAAO;AAAA,MACL,UAAU;AAAA,MACV,QAAQ,KAAK,UAAU,YAAY,EAAE,UAAU,QAAQ,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,YAAY,KAAK,kBAAkB,GAAG;AAC5C,UAAM,eAAe,KAAK,KAAK,aAAa,GAAG,GAAG,cAAc;AAChE,UAAM,cAAc,IAAI,UAAU;AAClC,UAAM,WAAW,IAAI,UAAU,WAAW,SAAS;AAEnD,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,UAAU,IACjB,EAAE,QAAQ,MAAM,QAAQ,WAAW,IACnC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,UAAU,GAAG;AAAA,MAC7D;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI,KAAK,YAAY,IAAI,WAAW;AAAA,QAClD,OAAO,MAAM;AACX,cAAI,CAAC,IAAI,UAAU,QAAQ;AACzB,mBAAO,EAAE,QAAQ,MAAM,QAAQ,yBAAyB;AAAA,UAC1D;AACA,gBAAM,MAAM,KAAK;AAAA,YACf;AAAA,UACF;AACA,gBAAM,SAAS,MAAM,YAAY;AACjC,cAAI,CAAC,OAAO,CAAC,QAAQ;AACnB,mBAAO;AAAA,cACL,QAAQ;AAAA,cACR,QAAQ,MAAM,YAAY,OAAO,UAAU;AAAA,YAC7C;AAAA,UACF;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,UAAU;AAAA,UAC5D;AAAA,QACN;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,CAAC,SAAU,QAAO,EAAE,QAAQ,MAAM,QAAQ,oBAAoB;AAClE,cAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,mBAAO,EAAE,QAAQ,QAAQ,QAAQ,cAAc,YAAY,GAAG;AAAA,UAChE;AACA,iBAAO,WAAW,SAAS,IACvB,EAAE,QAAQ,MAAM,QAAQ,UAAU,IAClC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,SAAS,GAAG;AAAA,QAC1D;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGQ,SAAS,MAAkC;AACjD,QAAI;AACF,aAAO,aAAa,MAAM,MAAM;AAAA,IAClC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAGA,SAAS,UAAU,KAAmB;AACpC,MAAI,CAAC,WAAW,GAAG,EAAG,WAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAC1D;AAEO,IAAM,UAAU,IAAI,WAAW;AACtC,IAAO,cAAQ;","names":["entry"]}

package/dist/{openclaw-ETN2M63O.js → openclaw-UZ5BMCGQ.js}

@@ -5,12 +5,13 @@ import {
 import {
   BaseAdapter,
   parseJsonc
-} from "./chunk-TIIP3RG2.js";
+} from "./chunk-PD4VFEBY.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
 } from "./chunk-MEH7GC7R.js";
+import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
 // src/adapters/openclaw/index.ts
@@ -35,13 +36,26 @@ var PLUGIN_MANIFEST_FILE = "openclaw.plugin.json";
 var EVENT_TO_OPENCLAW = {
   PreToolUse: "before_tool_call",
   PostToolUse: "after_tool_call",
-  SessionStart: "session_start"
+  SessionStart: "session_start",
+  // Subagent lifecycle: OpenClaw observes launch + completion (no decision
+  // control on either). PermissionRequest is deliberately ABSENT — OpenClaw's
+  // permission gate is the requireApproval RETURN VALUE of before_tool_call,
+  // not an observable event; PostToolUseFailure is ABSENT too (a failure
+  // arrives merged into after_tool_call, already surfaced as PostToolUse
+  // isError). Unmapped declared events are reported as "unsupported here".
+  SubagentStart: "subagent_spawned",
+  SubagentStop: "subagent_ended"
 };
 var OpenClawAdapter = class extends BaseAdapter {
   id = HOST;
   name = "OpenClaw";
   paradigm = "ts-plugin";
   capabilities = {
+    // Memory surface: AGENTS.md-first managed block. OpenClaw's AGENTS.md
+    // lives in the AGENT WORKSPACE (default ~/.openclaw/workspace), NOT the
+    // user's repo — memoryTargets below maps BOTH scopes there (R2:
+    // platforms force scopes; personal-assistant semantics, no project file).
+    supportsMemory: true,
     preToolUse: true,
     postToolUse: true,
     // OpenClaw compaction is owned by a context engine, not wired through the
@@ -52,6 +66,15 @@ var OpenClawAdapter = class extends BaseAdapter {
     userPromptSubmit: false,
     stop: false,
     notification: false,
+    // Newer events: OpenClaw observes the full subagent lifecycle via
+    // subagent_spawned / subagent_ended (observe-only — no decision control,
+    // so a SubagentStop "deny" cannot keep the subagent running here).
+    // permissionRequest / postToolUseFailure stay unset: the permission gate
+    // is a RETURN VALUE of before_tool_call (not an event) and tool failures
+    // arrive merged into after_tool_call. Install reports the standard
+    // "unsupported here" for unmapped declared events.
+    subagentStart: true,
+    subagentStop: true,
     // before_tool_call mutates event.params in place → input rewrite supported.
     canModifyArgs: true,
     // after_tool_call observes but cannot rewrite the tool result upstream.
@@ -83,6 +106,29 @@ var OpenClawAdapter = class extends BaseAdapter {
       return null;
     }
   }
+  // ── Memory surface: agent-workspace AGENTS.md (both scopes) ─────────────
+  /**
+   * OpenClaw loads AGENTS.md (operating instructions) from its AGENT WORKSPACE
+   * every session — `agents.defaults.workspace` in openclaw.json when set,
+   * else `<stateDir>/workspace` (default ~/.openclaw/workspace). That file is
+   * personal-assistant state, NOT a repo file, so a "project scope" write does
+   * not apply: BOTH scopes map to the workspace (R2: platforms force scopes),
+   * with the reason string flagging the semantics.
+   */
+  memoryTargets(ctx) {
+    if (this.memoryOverride(ctx)?.path) return super.memoryTargets(ctx);
+    if (ctx.scope !== "project" && ctx.scope !== "user") return [];
+    const configPath = resolveOpenClawConfigPath();
+    const cfg = this.readJson(configPath);
+    const declared = cfg?.agents?.defaults?.workspace;
+    const workspace = typeof declared === "string" && declared.trim() !== "" ? declared.startsWith("~") ? resolve(homedir(), declared.replace(/^~[/\\]?/, "")) : resolve(declared) : join(dirname(configPath), "workspace");
+    return [
+      {
+        path: join(workspace, "AGENTS.md"),
+        reason: "openclaw agent-workspace AGENTS.md (workspace-scoped operating instructions, not the project repo \u2014 both scopes map here)"
+      }
+    ];
+  }
   // ── Detection ──────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
     const userConfig = resolveOpenClawConfigPath();
@@ -520,7 +566,8 @@ const HOME_BIN = ` + homeBin + ";\nconst CONNECTOR_ID = " + connectorId + `;
 
 /**
  * Invoke the universal hook entrypoint for one canonical event.
- * @param {string} event canonical event name (PreToolUse|PostToolUse|SessionStart)
+ * @param {string} event canonical event name
+ *   (PreToolUse|PostToolUse|SessionStart|SubagentStart|SubagentStop)
  * @param {object} payload OpenClaw-shaped payload posted on stdin
  * @returns {object|null} normalized HookResponse, or null on any failure
  */
@@ -567,6 +614,33 @@ let contextInjected = false;
         '\n    // PostToolUse \u2192 after_tool_call: observe the completed tool call.\n    // OpenClaw exposes the result (v2+) or output (older builds); it cannot\n    // rewrite the tool result, so updatedOutput is intentionally dropped.\n    on("after_tool_call", async (event) => {\n      const e = event || {};\n      const rawResult = e.result !== undefined ? e.result : e.output;\n      const toolOutput =\n        typeof rawResult === "string"\n          ? rawResult\n          : rawResult != null\n            ? JSON.stringify(rawResult)\n            : undefined;\n      bridge("PostToolUse", {\n        toolName: e.toolName || "",\n        toolInput: e.params || {},\n        toolOutput,\n        isError: Boolean(e.error || e.isError),\n        sessionId: SESSION_ID,\n        projectDir: PROJECT_DIR,\n      });\n      return undefined;\n    });\n'
       );
     }
+    if (has("SubagentStart")) {
+      reg.push(
+        '\n    // SubagentStart \u2192 subagent_spawned: observe-only (OpenClaw exposes no\n    // decision or context-injection payload for subagent launches). Field\n    // names vary across builds, so the common variants are normalized;\n    // empty values are omitted so the dispatcher never matcher-filters on\n    // an empty agent type (fail-open).\n    on("subagent_spawned", async (event) => {\n      const e = event || {};\n      bridge("SubagentStart", {\n        agentId: e.agentId || e.subagentId || undefined,\n        agentType: e.agentType || e.subagentType || e.agent || undefined,\n        sessionId: SESSION_ID,\n        projectDir: PROJECT_DIR,\n      });\n      return undefined;\n    });\n'
+      );
+    }
+    if (has("SubagentStop")) {
+      reg.push(
+        `
+    // SubagentStop \u2192 subagent_ended: observe-only completion. A normalized
+    // 'deny' cannot keep the subagent running on OpenClaw, so the bridge
+    // reply is intentionally ignored.
+    on("subagent_ended", async (event) => {
+      const e = event || {};
+      const rawResult = e.result !== undefined ? e.result : e.output;
+      bridge("SubagentStop", {
+        agentId: e.agentId || e.subagentId || undefined,
+        agentType: e.agentType || e.subagentType || e.agent || undefined,
+        lastAssistantMessage:
+          typeof rawResult === "string" && rawResult !== "" ? rawResult : undefined,
+        sessionId: SESSION_ID,
+        projectDir: PROJECT_DIR,
+      });
+      return undefined;
+    });
+`
+      );
+    }
     if (has("SessionStart")) {
       reg.push(
         '\n    // SessionStart \u2192 session_start records the real session id and fetches\n    // the additionalContext to inject; before_prompt_build performs the\n    // injection (the verified context-injection point upstream).\n    on("session_start", async (event) => {\n      const e = event || {};\n      SESSION_ID = e.sessionId || e.sessionKey || SESSION_ID;\n      const res = bridge("SessionStart", {\n        sessionId: SESSION_ID,\n        source: e.resumedFrom ? "resume" : "startup",\n        projectDir: PROJECT_DIR,\n      });\n      contextInjected = false;\n      pendingContext =\n        res && typeof res.additionalContext === "string" && res.additionalContext\n          ? res.additionalContext\n          : null;\n      return undefined;\n    });\n\n    // Inject the session-start context once, at prompt-build time.\n    on("before_prompt_build", () => {\n      if (contextInjected || !pendingContext) return undefined;\n      contextInjected = true;\n      return { appendSystemContext: pendingContext };\n    });\n'
@@ -615,6 +689,23 @@ let contextInjected = false;
         const ev = { ...base, source };
         return ev;
       }
+      case "SubagentStart": {
+        const ev = {
+          ...base,
+          ...isNonEmptyString(input.agentId) ? { agentId: input.agentId } : {},
+          ...isNonEmptyString(input.agentType) ? { agentType: input.agentType } : {}
+        };
+        return ev;
+      }
+      case "SubagentStop": {
+        const ev = {
+          ...base,
+          ...isNonEmptyString(input.agentId) ? { agentId: input.agentId } : {},
+          ...isNonEmptyString(input.agentType) ? { agentType: input.agentType } : {},
+          ...isNonEmptyString(input.lastAssistantMessage) ? { lastAssistantMessage: input.lastAssistantMessage } : {}
+        };
+        return ev;
+      }
       default:
         return { ...base, source: "startup" };
     }
@@ -654,6 +745,9 @@ let contextInjected = false;
         // `module` field, which openclaw config validate rejects.)
         name: `${this.name}: dual registration (plugins.entries+load.paths + mcp.servers.${id})`,
         check: () => {
+          if (!hasServer && !hasHooks) {
+            return { status: "OK", detail: "no MCP server or hooks declared" };
+          }
           const cfg = this.readJson(configPath);
           if (!cfg) return { status: "FAIL", detail: `cannot read ${configPath}` };
           const inEntries = this.hasPluginEntry(cfg, id) && this.hasLoadPath(cfg, pluginDir);
@@ -741,6 +835,9 @@ function resolveOpenClawConfigPath(env = process.env) {
 function ensureDir(dir) {
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 }
+function isNonEmptyString(value) {
+  return typeof value === "string" && value !== "";
+}
 var adapter = new OpenClawAdapter();
 var openclaw_default = adapter;
 export {
@@ -748,4 +845,4 @@ export {
   adapter,
   openclaw_default as default
 };
-//# sourceMappingURL=openclaw-ETN2M63O.js.map
+//# sourceMappingURL=openclaw-UZ5BMCGQ.js.map

package/dist/openclaw-UZ5BMCGQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/openclaw/index.ts"],"sourcesContent":["/**\n * adapters/openclaw — OpenClaw (Gateway) platform adapter for agent-connector.\n *\n * OpenClaw is a **ts-plugin** host, but with a twist no other ts-plugin host\n * has: a plugin only delivers its MCP tools to the agent when it is registered\n * in TWO places at once (DUAL REGISTRATION):\n *\n *   (a) plugins.entries.<id> = { enabled: true }  + plugins.load.paths: [dir]\n *                                — so the gateway DISCOVERS and LOADS the plugin\n *                                module (runs register(api), wiring the hooks).\n *                                NOTE: the entry is { enabled } only — a per-entry\n *                                `module` field is rejected by `openclaw config\n *                                validate`, so discovery goes through the\n *                                plugins.load.paths dir scan instead; and\n *   (b) mcp.servers.<id>       — nested under a top-level \"mcp\" object, so the\n *                                plugin's MCP tools SURFACE to the agent.\n *\n *   If only (a) is present, the plugin loads but ZERO tools reach the agent.\n *   If only (b) is present, the tools are declared but the hook bridge never\n *   loads. context-mode's own adapter proved this empirically against OpenClaw\n *   2026.4.22 (src/adapters/openclaw/index.ts checkPluginRegistration: \"in\n *   plugins.entries but missing from mcp.servers — plugin loads but no ctx_*\n *   tools reach the agent\"). So getHealthChecks() FAILS when the two are\n *   inconsistent (entries XOR mcp.servers).\n *\n * Why we BRIDGE instead of importing handlers (mirrors the OpenCode adapter):\n *   context-mode could load ITS OWN plugin in-process because the handler code\n *   shipped with the package. agent-connector cannot: the connector's hook\n *   handlers are arbitrary developer code we must not import into the gateway's\n *   runtime (wrong cwd, wrong deps, version skew). So installHooks synthesizes a\n *   tiny, fully self-contained ESM plugin module — { id, name, configSchema,\n *   register(api) } — that imports NOTHING from agent-connector and, on each\n *   hook firing, shells out to the ONE stable home binary's universal entrypoint\n *     <homeBin> hook openclaw <event> --connector <id>\n *   feeding the event payload on stdin and JSON.parsing the normalized\n *   HookResponse back from stdout. Fail-open: any bridge error → no-op. The same\n *   universal json-stdio dispatcher every other host uses thus serves OpenClaw.\n *\n * Plugin module shape (grounded in context-mode build/adapters/openclaw/plugin.js):\n *   export default { id, name, configSchema, register(api) }\n *   register(api) wires typed lifecycle hooks via api.on(event, handler):\n *     before_tool_call → block (return { block, blockReason }) / rewrite args\n *                        (mutate event.params in place); deny+ask both block.\n *     after_tool_call  → observe (capture result/output).\n *     session_start    → record the real session id.\n *     before_prompt_build → inject SessionStart additionalContext via\n *                        { appendSystemContext } (the verified context-injection\n *                        point; session_start itself returns no context payload).\n *     subagent_spawned / subagent_ended → observe the subagent lifecycle\n *                        (SubagentStart / SubagentStop; observe-only — no\n *                        decision or context payload).\n *   api.on() is the correct API for typed lifecycle hooks; api.registerHook() is\n *   for generic command hooks. We register defensively (api.on present check).\n *\n * Config file (JSON5 / JSONC — PARSE TOLERANTLY):\n *   user scope    → resolveOpenClawConfigPath():\n *                     $OPENCLAW_CONFIG_PATH\n *                     else $OPENCLAW_STATE_DIR/openclaw.json\n *                     else ~/.openclaw/openclaw.json\n *                   (mirrors context-mode openclawConfigPath — the file the\n *                    gateway actually loads, NOT process.cwd()).\n *   project scope → <projectDir>/openclaw.json (also supported).\n *   openclaw.json may contain comments + trailing commas (JSON5), so we NEVER\n *   use strict JSON.parse — readJson is overridden to strip comments/commas\n *   first via the shared core/jsonc parseJsonc. writes are strict JSON\n *   (idempotent, comment-free).\n *\n * Plugin module location (project | user):\n *   user    → <stateDir>/extensions/<id>/index.mjs    (stateDir = dir of openclaw.json)\n *   project → <projectDir>/.openclaw/extensions/<id>/index.mjs\n *   Beside index.mjs we also emit an openclaw.plugin.json manifest. The plugin's\n *   DIRECTORY (not the file) is added to plugins.load.paths so the gateway scans\n *   it and loads the module; the plugins.entries.<id> = { enabled: true } half\n *   then activates it. (There is no per-entry \"module\" field — validate rejects it.)\n *\n * The gateway hot-reloads its config on SIGUSR1 — no action needed here; the\n * next reload (or restart) picks up our entries/servers/module.\n *\n * Capabilities (per OpenClaw hook API):\n *   preToolUse / postToolUse / sessionStart / subagentStart / subagentStop\n *   true; transports [\"stdio\"].\n *   before_tool_call mutates event.params → canModifyArgs true.\n *   after_tool_call cannot rewrite the tool result → canModifyOutput false.\n *   before_prompt_build injects context → canInjectSessionContext true.\n */\n\nimport {\n  chmodSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type {\n  Adapter,\n  GeneratedPluginFile,\n  HookReply,\n  InstallContext,\n  MemoryTarget,\n  NormalizedEvent,\n} 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  SessionStartEvent,\n  SubagentStartEvent,\n  SubagentStopEvent,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport { parseJsonc } from \"../../core/jsonc.js\";\nimport {\n  buildServeWrapperCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"openclaw\";\n\n/**\n * MCP servers live nested under the top-level \"mcp\" object: mcp.servers.<id>\n * (NOT a top-level \"mcpServers\" key). plugins.entries.<id> is the second half of\n * the dual registration.\n */\nconst MCP_ROOT_KEY = \"mcp\";\nconst MCP_SERVERS_KEY = \"servers\";\nconst PLUGINS_KEY = \"plugins\";\nconst PLUGINS_ENTRIES_KEY = \"entries\";\n/**\n * The gateway discovers a synthesized plugin module by scanning the directories\n * listed in plugins.load.paths — it does NOT take a per-entry `module` field\n * (that fails `openclaw config validate`). We add the plugin's own dir here.\n */\nconst PLUGINS_LOAD_KEY = \"load\";\nconst PLUGINS_LOAD_PATHS_KEY = \"paths\";\n/** Manifest the gateway reads inside a plugins.load.paths directory. */\nconst PLUGIN_MANIFEST_FILE = \"openclaw.plugin.json\";\n\n/**\n * Canonical → OpenClaw event name map. A connector hook event is only emitted by\n * the generated plugin when it appears here AND is declared by the connector.\n *\n * SessionStart maps to OpenClaw's session_start (to learn the real session id)\n * plus before_prompt_build (the verified context-injection point — session_start\n * itself returns no context payload upstream).\n */\nconst EVENT_TO_OPENCLAW: Partial<Record<HookEventName, string>> = {\n  PreToolUse: \"before_tool_call\",\n  PostToolUse: \"after_tool_call\",\n  SessionStart: \"session_start\",\n  // Subagent lifecycle: OpenClaw observes launch + completion (no decision\n  // control on either). PermissionRequest is deliberately ABSENT — OpenClaw's\n  // permission gate is the requireApproval RETURN VALUE of before_tool_call,\n  // not an observable event; PostToolUseFailure is ABSENT too (a failure\n  // arrives merged into after_tool_call, already surfaced as PostToolUse\n  // isError). Unmapped declared events are reported as \"unsupported here\".\n  SubagentStart: \"subagent_spawned\",\n  SubagentStop: \"subagent_ended\",\n};\n\n/** Raw payload the generated plugin posts to the universal hook entrypoint. */\ninterface OpenClawBridgePayload {\n  toolName?: string;\n  toolInput?: Record<string, unknown>;\n  toolOutput?: string;\n  isError?: boolean;\n  sessionId?: string;\n  source?: string;\n  projectDir?: string;\n  // subagent_spawned / subagent_ended (the generated plugin normalizes the\n  // host's field-name variants before posting; empty strings are omitted).\n  agentId?: string;\n  agentType?: string;\n  lastAssistantMessage?: string;\n}\n\n/**\n * Native MCP server entry shapes OpenClaw accepts under mcp.servers.<id>.\n *\n * A stdio sidecar carries NO `transport` field: OpenClaw's config validator\n * only accepts `transport: \"sse\" | \"streamable-http\"` for remote servers and\n * REJECTS `transport: \"stdio\"` (verified against OpenClaw 2026.6.1). A stdio\n * server is INFERRED from the presence of `command`, so we must never write a\n * transport key here.\n */\ninterface OpenClawStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  enabled?: boolean;\n}\ninterface OpenClawRemoteServer {\n  url: string;\n  transport: \"sse\" | \"http\";\n  headers?: Record<string, string>;\n  enabled?: boolean;\n}\n\n/**\n * plugins.entries.<id> reference shape.\n *\n * `openclaw config validate` REJECTS a `module` field here (it is not part of\n * the entry schema), so the entry is `{ enabled: true }` ONLY. Discovery of the\n * synthesized module is wired separately via `plugins.load.paths` (the dir that\n * holds the module + its openclaw.plugin.json manifest).\n */\ninterface OpenClawPluginEntry {\n  enabled: boolean;\n}\n\nexport class OpenClawAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"OpenClaw\";\n  readonly paradigm: HookParadigm = \"ts-plugin\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block. OpenClaw's AGENTS.md\n    // lives in the AGENT WORKSPACE (default ~/.openclaw/workspace), NOT the\n    // user's repo — memoryTargets below maps BOTH scopes there (R2:\n    // platforms force scopes; personal-assistant semantics, no project file).\n    supportsMemory: true,\n    preToolUse: true,\n    postToolUse: true,\n    // OpenClaw compaction is owned by a context engine, not wired through the\n    // universal bridge here.\n    preCompact: false,\n    sessionStart: true,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    // Newer events: OpenClaw observes the full subagent lifecycle via\n    // subagent_spawned / subagent_ended (observe-only — no decision control,\n    // so a SubagentStop \"deny\" cannot keep the subagent running here).\n    // permissionRequest / postToolUseFailure stay unset: the permission gate\n    // is a RETURN VALUE of before_tool_call (not an event) and tool failures\n    // arrive merged into after_tool_call. Install reports the standard\n    // \"unsupported here\" for unmapped declared events.\n    subagentStart: true,\n    subagentStop: true,\n    // before_tool_call mutates event.params in place → input rewrite supported.\n    canModifyArgs: true,\n    // after_tool_call observes but cannot rewrite the tool result upstream.\n    canModifyOutput: false,\n    // injected via before_prompt_build at prompt assembly.\n    canInjectSessionContext: true,\n    // OpenClaw's MCP sidecar registration is stdio-only in practice.\n    transports: [\"stdio\"],\n  };\n\n  // ── Tolerant JSON5/JSONC read (override base strict JSON.parse) ──────────\n\n  /**\n   * openclaw.json is officially JSON5 (comments + trailing commas allowed). A\n   * strict JSON.parse false-fails a perfectly valid commented file, so we strip\n   * comments and trailing commas before parsing. Writes remain strict JSON\n   * (writeJson in BaseAdapter), which is itself valid JSON5 — so round-trips\n   * stay safe and idempotent.\n   */\n  protected override readJson<T = Record<string, unknown>>(path: string): T | null {\n    if (!existsSync(path)) return null;\n    let raw: string;\n    try {\n      raw = readFileSync(path, \"utf8\");\n    } catch {\n      return null;\n    }\n    try {\n      // Shared, string-aware JSONC stripper (the local stripJsonish whose\n      // trailing-comma regex corrupted in-string \",]\"/\",}\"-like values is gone).\n      return parseJsonc<T>(raw);\n    } catch {\n      return null;\n    }\n  }\n\n  // ── Memory surface: agent-workspace AGENTS.md (both scopes) ─────────────\n  /**\n   * OpenClaw loads AGENTS.md (operating instructions) from its AGENT WORKSPACE\n   * every session — `agents.defaults.workspace` in openclaw.json when set,\n   * else `<stateDir>/workspace` (default ~/.openclaw/workspace). That file is\n   * personal-assistant state, NOT a repo file, so a \"project scope\" write does\n   * not apply: BOTH scopes map to the workspace (R2: platforms force scopes),\n   * with the reason string flagging the semantics.\n   */\n  protected override memoryTargets(ctx: InstallContext): MemoryTarget[] {\n    if (this.memoryOverride(ctx)?.path) return super.memoryTargets(ctx);\n    if (ctx.scope !== \"project\" && ctx.scope !== \"user\") return [];\n    const configPath = resolveOpenClawConfigPath();\n    const cfg = this.readJson<{ agents?: { defaults?: { workspace?: unknown } } }>(configPath);\n    const declared = cfg?.agents?.defaults?.workspace;\n    const workspace =\n      typeof declared === \"string\" && declared.trim() !== \"\"\n        ? declared.startsWith(\"~\")\n          ? resolve(homedir(), declared.replace(/^~[/\\\\]?/, \"\"))\n          : resolve(declared)\n        : join(dirname(configPath), \"workspace\");\n    return [\n      {\n        path: join(workspace, \"AGENTS.md\"),\n        reason:\n          \"openclaw agent-workspace AGENTS.md (workspace-scoped operating instructions, \" +\n          \"not the project repo — both scopes map here)\",\n      },\n    ];\n  }\n\n  // ── Detection ──────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userConfig = resolveOpenClawConfigPath();\n    const userDir = join(homedir(), \".openclaw\");\n    const projectConfig = join(projectDir, \"openclaw.json\");\n\n    const userInstalled = existsSync(userConfig) || existsSync(userDir);\n    const projInstalled = existsSync(projectConfig);\n    const installed = userInstalled || projInstalled;\n\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projectConfig : userConfig;\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        ? scope === \"project\"\n          ? `found project OpenClaw config at ${projectConfig}`\n          : `found OpenClaw config at ${configPath}`\n        : `no OpenClaw config at ${userConfig} or ${userDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ───────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? ctx.projectDir\n      : dirname(resolveOpenClawConfigPath());\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \"openclaw.json\")\n      : resolveOpenClawConfigPath();\n  }\n\n  /**\n   * For ts-plugin hosts the \"hook config path\" is the generated plugin FILE.\n   * OpenClaw additionally needs the plugins.entries reference written into\n   * openclaw.json (handled in installHooks); this is the module on disk.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return join(this.pluginDir(ctx), this.pluginFileName());\n  }\n\n  /** Extensions directory the synthesized plugin module is written into. */\n  private pluginDir(ctx: InstallContext): string {\n    const base =\n      ctx.scope === \"project\"\n        ? join(ctx.projectDir, \".openclaw\")\n        : dirname(resolveOpenClawConfigPath());\n    return join(base, \"extensions\", ctx.connector.id);\n  }\n\n  /** Plugin module file name (ESM so the gateway loads it without a loader). */\n  private pluginFileName(): string {\n    return \"index.mjs\";\n  }\n\n  // ── MCP server install / uninstall (mcp.servers.<id>) ───────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const server = this.effectiveServer(ctx);\n    const serverPath = this.getServerConfigPath(ctx);\n\n    if (!server) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: serverPath,\n          detail: ctx.connector.server\n            ? \"server registration disabled for openclaw\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    const entry = this.renderServerEntry(ctx, server);\n    return [this.upsertNestedServer(serverPath, ctx.connector.id, entry, ctx.dryRun)];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [this.removeNestedServer(serverPath, ctx.connector.id, ctx.dryRun)];\n  }\n\n  /** Resolve the per-platform server override into an effective ServerDef. */\n  private effectiveServer(ctx: InstallContext): ServerDef | undefined {\n    const override = ctx.connector.platforms[HOST]?.server;\n    if (override === false) return undefined;\n    const base = ctx.connector.server;\n    if (!base) return undefined;\n    return override && typeof override === \"object\" ? { ...base, ...override } : base;\n  }\n\n  /**\n   * Render a normalized ServerDef into OpenClaw's native mcp.servers.<id> entry.\n   *\n   * stdio  → { command, args?, env? }  (NO transport key — a stdio sidecar is\n   *          inferred from `command`; OpenClaw's validator rejects\n   *          transport:\"stdio\" and only accepts \"sse\"/\"streamable-http\")\n   * remote → { url, transport: \"sse\"|\"http\", headers? }\n   *\n   * OpenClaw documents no native ${env:VAR} token, so refs resolve to literals.\n   */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): OpenClawStdioServer | OpenClawRemoteServer {\n    if (server.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      if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n        const wrapped = buildServeWrapperCommand(\n          ctx.homeBinPath,\n          ctx.connector.id,\n          command,\n          args,\n          ctx.scope,\n          this.id,\n        );\n        command = wrapped.command;\n        args = wrapped.args;\n      }\n\n      // NO `transport` key: OpenClaw infers a stdio sidecar from `command` and\n      // its validator rejects transport:\"stdio\" (only \"sse\"/\"streamable-http\").\n      const entry: OpenClawStdioServer = {\n        command: resolveEnvRefsDeep(command),\n      };\n      const resolvedArgs = resolveEnvRefsDeep(args).filter((s) => s !== \"\");\n      if (resolvedArgs.length > 0) entry.args = resolvedArgs;\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      if (server.enabled === false) entry.enabled = false;\n      return entry;\n    }\n\n    // sse / http / ws → OpenClaw registers a remote URL sidecar.\n    const transport: \"sse\" | \"http\" = server.transport === \"http\" ? \"http\" : \"sse\";\n    const entry: OpenClawRemoteServer = {\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n      transport,\n    };\n    if (server.headers && Object.keys(server.headers).length > 0) {\n      entry.headers = resolveEnvRefsDeep({ ...server.headers });\n    }\n    if (server.enabled === false) entry.enabled = false;\n    return entry;\n  }\n\n  /** Resolve every ${env:VAR} in env values to literals (no native token). */\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  /** Upsert config.mcp.servers.<id> idempotently. */\n  private upsertNestedServer(\n    path: string,\n    id: string,\n    entry: unknown,\n    dryRun: boolean,\n  ): ChangeRecord {\n    // OVERWRITE GUARD: never blank a present-but-unparseable openclaw.json.\n    if (this.isPresentButUnparseable(path)) {\n      return {\n        platform: this.id,\n        action: \"warn\",\n        path,\n        detail: `existing ${path} is not parseable; left untouched (back it up / fix it, then re-run)`,\n      };\n    }\n    const cfg = this.readJson<Record<string, unknown>>(path) ?? {};\n    const servers = this.nestedServersBucket(cfg);\n    const before = JSON.stringify(servers[id]);\n    const after = JSON.stringify(entry);\n    let action: ChangeRecord[\"action\"];\n    if (before === undefined) action = \"create\";\n    else if (before === after) action = \"skip\";\n    else action = \"update\";\n    if (action !== \"skip\") {\n      servers[id] = entry;\n      this.writeJson(path, cfg, dryRun);\n    }\n    return {\n      platform: this.id,\n      action,\n      path,\n      detail: `${MCP_ROOT_KEY}.${MCP_SERVERS_KEY}.${id}`,\n    };\n  }\n\n  /** Remove config.mcp.servers.<id>. */\n  private removeNestedServer(path: string, id: string, dryRun: boolean): ChangeRecord {\n    const cfg = this.readJson<Record<string, unknown>>(path);\n    const mcp = cfg?.[MCP_ROOT_KEY];\n    const servers =\n      mcp && typeof mcp === \"object\" && !Array.isArray(mcp)\n        ? ((mcp as Record<string, unknown>)[MCP_SERVERS_KEY] as\n            | Record<string, unknown>\n            | undefined)\n        : undefined;\n    if (!cfg || !servers || !(id in servers)) {\n      return {\n        platform: this.id,\n        action: \"skip\",\n        path,\n        detail: `${MCP_ROOT_KEY}.${MCP_SERVERS_KEY}.${id} absent`,\n      };\n    }\n    delete servers[id];\n    this.writeJson(path, cfg, dryRun);\n    return {\n      platform: this.id,\n      action: \"remove\",\n      path,\n      detail: `${MCP_ROOT_KEY}.${MCP_SERVERS_KEY}.${id}`,\n    };\n  }\n\n  /** Get-or-create config.mcp.servers as a mutable object. */\n  private nestedServersBucket(cfg: Record<string, unknown>): Record<string, unknown> {\n    let mcp = cfg[MCP_ROOT_KEY];\n    if (!mcp || typeof mcp !== \"object\" || Array.isArray(mcp)) {\n      mcp = {};\n      cfg[MCP_ROOT_KEY] = mcp;\n    }\n    const mcpObj = mcp as Record<string, unknown>;\n    let servers = mcpObj[MCP_SERVERS_KEY];\n    if (!servers || typeof servers !== \"object\" || Array.isArray(servers)) {\n      servers = {};\n      mcpObj[MCP_SERVERS_KEY] = servers;\n    }\n    return servers as Record<string, unknown>;\n  }\n\n  // ── Hook install / uninstall (ts-plugin + DUAL REGISTRATION) ────────────\n\n  installHooks(ctx: InstallContext): ChangeRecord[] {\n    const pluginPath = this.getHookConfigPath(ctx);\n    const configPath = this.getServerConfigPath(ctx);\n\n    if (ctx.connector.platforms[HOST]?.hooks === false) {\n      return [\n        { platform: this.id, action: \"skip\", path: pluginPath, detail: \"hooks disabled for openclaw\" },\n      ];\n    }\n    if (ctx.connector.hookEvents.length === 0) {\n      return [\n        { platform: this.id, action: \"skip\", path: pluginPath, detail: \"connector declares no hooks\" },\n      ];\n    }\n\n    const changes: ChangeRecord[] = [];\n\n    // 1. Write the synthesized plugin module(s).\n    for (const file of this.synthesizePlugin(ctx)) {\n      const before = existsSync(file.path) ? this.safeRead(file.path) : undefined;\n      let action: ChangeRecord[\"action\"];\n      if (before === undefined) action = \"create\";\n      else if (before === file.contents) action = \"skip\";\n      else action = \"update\";\n\n      if (action !== \"skip\" && !ctx.dryRun) {\n        ensureDir(dirname(file.path));\n        writeFileSync(file.path, file.contents, \"utf8\");\n        chmodSync(file.path, file.executable ? 0o755 : 0o644);\n      }\n      changes.push({\n        platform: this.id,\n        action,\n        path: file.path,\n        detail: `openclaw plugin module (${this.hookDetail(ctx)})`,\n      });\n    }\n\n    // 2. DUAL REGISTRATION half (a): enable plugins.entries.<id> AND add the\n    //    plugin DIR to plugins.load.paths so the gateway discovers + loads the\n    //    module. (half (b), mcp.servers.<id>, is written by installServer — both\n    //    are required for tools to reach the agent.)\n    changes.push(this.upsertPluginEntry(configPath, ctx, this.pluginDir(ctx)));\n\n    return changes;\n  }\n\n  /**\n   * Human-facing summary of which declared events the synthesized module ACTUALLY\n   * wires. Only events present in EVENT_TO_OPENCLAW are mapped/wired; any declared\n   * event with no OpenClaw mapping (e.g. UserPromptSubmit) is reported separately\n   * as \"unsupported here\" so the detail never overstates coverage.\n   */\n  private hookDetail(ctx: InstallContext): string {\n    const declared = ctx.connector.hookEvents;\n    const mapped = declared.filter((e) => EVENT_TO_OPENCLAW[e] !== undefined);\n    const unsupported = declared.filter((e) => EVENT_TO_OPENCLAW[e] === undefined);\n    const base = mapped.join(\",\");\n    return unsupported.length > 0\n      ? `${base}; unsupported here: ${unsupported.join(\",\")}`\n      : base;\n  }\n\n  uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    const pluginPath = this.getHookConfigPath(ctx);\n    const configPath = this.getServerConfigPath(ctx);\n    const changes: ChangeRecord[] = [];\n\n    // 1. Remove the plugins.entries.<id> reference AND drop the plugin dir from\n    //    plugins.load.paths.\n    changes.push(\n      this.removePluginEntry(configPath, ctx.connector.id, this.pluginDir(ctx), ctx.dryRun),\n    );\n\n    // 2. Remove the plugin module + its manifest on disk.\n    const manifestPath = join(this.pluginDir(ctx), PLUGIN_MANIFEST_FILE);\n    for (const [path, label] of [\n      [pluginPath, \"openclaw plugin module\"],\n      [manifestPath, \"openclaw plugin manifest\"],\n    ] as const) {\n      if (existsSync(path)) {\n        if (!ctx.dryRun) rmSync(path, { force: true });\n        changes.push({ platform: this.id, action: \"remove\", path, detail: label });\n      } else {\n        changes.push({\n          platform: this.id,\n          action: \"skip\",\n          path,\n          detail: `no ${label} present`,\n        });\n      }\n    }\n\n    // 3. Drop the now-empty plugin dir (only if WE own its full contents).\n    changes.push(this.removeDirIfEmpty(this.pluginDir(ctx), ctx.dryRun));\n\n    return changes;\n  }\n\n  /**\n   * Upsert plugins.entries.<id> = { enabled: true } AND add `pluginDir` to\n   * plugins.load.paths idempotently.\n   *\n   * `openclaw config validate` rejects a per-entry `module` field, so the entry\n   * carries ONLY `{ enabled: true }`. The gateway discovers the synthesized\n   * module by scanning the directories in plugins.load.paths (the dir holding\n   * index.mjs + openclaw.plugin.json), so the dir is added there.\n   */\n  private upsertPluginEntry(\n    configPath: string,\n    ctx: InstallContext,\n    pluginDir: string,\n  ): ChangeRecord {\n    // OVERWRITE GUARD: never blank a present-but-unparseable openclaw.json.\n    if (this.isPresentButUnparseable(configPath)) {\n      return {\n        platform: this.id,\n        action: \"warn\",\n        path: configPath,\n        detail: `existing ${configPath} is not parseable; left untouched (back it up / fix it, then re-run)`,\n      };\n    }\n    const cfg = this.readJson<Record<string, unknown>>(configPath) ?? {};\n    const entries = this.pluginEntriesBucket(cfg);\n    const id = ctx.connector.id;\n    const desired: OpenClawPluginEntry = { enabled: true };\n    const entryBefore = JSON.stringify(entries[id]);\n    const entryAfter = JSON.stringify(desired);\n\n    // plugins.load.paths: add the plugin dir if absent.\n    const loadPaths = this.pluginLoadPathsBucket(cfg);\n    const pathPresent = loadPaths.includes(pluginDir);\n\n    const entryChanged = entryBefore !== entryAfter;\n    const pathChanged = !pathPresent;\n    let action: ChangeRecord[\"action\"];\n    if (entryBefore === undefined) action = \"create\";\n    else if (!entryChanged && !pathChanged) action = \"skip\";\n    else action = \"update\";\n\n    if (action !== \"skip\") {\n      entries[id] = desired;\n      if (!pathPresent) loadPaths.push(pluginDir);\n      this.writeJson(configPath, cfg, ctx.dryRun);\n    }\n    return {\n      platform: this.id,\n      action,\n      path: configPath,\n      detail: `${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}.${id} + ${PLUGINS_KEY}.${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY}`,\n    };\n  }\n\n  /** Remove plugins.entries.<id> AND drop `pluginDir` from plugins.load.paths. */\n  private removePluginEntry(\n    configPath: string,\n    id: string,\n    pluginDir: string,\n    dryRun: boolean,\n  ): ChangeRecord {\n    const cfg = this.readJson<Record<string, unknown>>(configPath);\n    const plugins = cfg?.[PLUGINS_KEY];\n    const pluginsObj =\n      plugins && typeof plugins === \"object\" && !Array.isArray(plugins)\n        ? (plugins as Record<string, unknown>)\n        : undefined;\n    const entries = pluginsObj?.[PLUGINS_ENTRIES_KEY] as\n      | Record<string, unknown>\n      | undefined;\n    const load = pluginsObj?.[PLUGINS_LOAD_KEY] as Record<string, unknown> | undefined;\n    const loadPaths =\n      load && Array.isArray(load[PLUGINS_LOAD_PATHS_KEY])\n        ? (load[PLUGINS_LOAD_PATHS_KEY] as unknown[])\n        : undefined;\n\n    const entryPresent = Boolean(entries && id in entries);\n    const pathIdx = loadPaths ? loadPaths.indexOf(pluginDir) : -1;\n\n    if (!cfg || (!entryPresent && pathIdx < 0)) {\n      return {\n        platform: this.id,\n        action: \"skip\",\n        path: configPath,\n        detail: `${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}.${id} absent`,\n      };\n    }\n    if (entryPresent && entries) delete entries[id];\n    if (loadPaths && pathIdx >= 0) loadPaths.splice(pathIdx, 1);\n    this.writeJson(configPath, cfg, dryRun);\n    return {\n      platform: this.id,\n      action: \"remove\",\n      path: configPath,\n      detail: `${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}.${id} + ${PLUGINS_KEY}.${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY}`,\n    };\n  }\n\n  /** Get-or-create config.plugins.entries as a mutable object. */\n  private pluginEntriesBucket(cfg: Record<string, unknown>): Record<string, unknown> {\n    let plugins = cfg[PLUGINS_KEY];\n    if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) {\n      plugins = {};\n      cfg[PLUGINS_KEY] = plugins;\n    }\n    const pluginsObj = plugins as Record<string, unknown>;\n    let entries = pluginsObj[PLUGINS_ENTRIES_KEY];\n    if (!entries || typeof entries !== \"object\" || Array.isArray(entries)) {\n      entries = {};\n      pluginsObj[PLUGINS_ENTRIES_KEY] = entries;\n    }\n    return entries as Record<string, unknown>;\n  }\n\n  /** Get-or-create config.plugins.load.paths as a mutable string array. */\n  private pluginLoadPathsBucket(cfg: Record<string, unknown>): string[] {\n    let plugins = cfg[PLUGINS_KEY];\n    if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) {\n      plugins = {};\n      cfg[PLUGINS_KEY] = plugins;\n    }\n    const pluginsObj = plugins as Record<string, unknown>;\n    let load = pluginsObj[PLUGINS_LOAD_KEY];\n    if (!load || typeof load !== \"object\" || Array.isArray(load)) {\n      load = {};\n      pluginsObj[PLUGINS_LOAD_KEY] = load;\n    }\n    const loadObj = load as Record<string, unknown>;\n    const existing = loadObj[PLUGINS_LOAD_PATHS_KEY];\n    // Normalize to a fresh string[] (drop any non-string a user may have placed\n    // here) and write it back so the caller mutates the live array.\n    const paths = Array.isArray(existing)\n      ? existing.filter((p): p is string => typeof p === \"string\")\n      : [];\n    loadObj[PLUGINS_LOAD_PATHS_KEY] = paths;\n    return paths;\n  }\n\n  // ── ts-plugin synthesis ────────────────────────────────────────────────\n\n  /**\n   * Build ONE self-contained ESM plugin module for OpenClaw.\n   *\n   * The module imports nothing from agent-connector. It embeds two constants\n   * (the absolute home-bin path and the connector id) and a `bridge()` helper\n   * that shells out to the universal hook entrypoint via execFileSync, feeding\n   * the OpenClaw event payload on stdin and JSON.parsing the normalized\n   * HookResponse back from stdout (fail-open: any error → null). Its default\n   * export is the OpenClaw plugin definition { id, name, configSchema,\n   * register(api) }; register wires api.on(...) handlers for the events this\n   * connector actually declares.\n   */\n  synthesizePlugin(ctx: InstallContext): GeneratedPluginFile[] {\n    const path = this.getHookConfigPath(ctx);\n    const contents = this.buildPluginSource(ctx);\n    // The gateway scans plugins.load.paths dirs for a manifest, so emit an\n    // openclaw.plugin.json beside index.mjs pointing at the module entry.\n    const manifestPath = join(this.pluginDir(ctx), PLUGIN_MANIFEST_FILE);\n    const manifest = this.buildPluginManifest(ctx);\n    return [\n      { path, contents, executable: false },\n      { path: manifestPath, contents: manifest, executable: false },\n    ];\n  }\n\n  /**\n   * Build the openclaw.plugin.json manifest the gateway reads inside a\n   * plugins.load.paths directory. It names the plugin and points at the ESM\n   * module entry (index.mjs) so the loader knows what to import.\n   */\n  private buildPluginManifest(ctx: InstallContext): string {\n    const manifest = {\n      id: ctx.connector.id,\n      name: ctx.connector.displayName || ctx.connector.id,\n      main: this.pluginFileName(),\n      enabled: true,\n    };\n    return `${JSON.stringify(manifest, null, 2)}\\n`;\n  }\n\n  /** Compose the generated plugin source with plain string concatenation. */\n  private buildPluginSource(ctx: InstallContext): string {\n    const homeBin = JSON.stringify(ctx.homeBinPath);\n    const connectorId = JSON.stringify(ctx.connector.id);\n    const connectorName = JSON.stringify(ctx.connector.displayName || ctx.connector.id);\n\n    const events = ctx.connector.hookEvents.filter(\n      (e): e is HookEventName => EVENT_TO_OPENCLAW[e] !== undefined,\n    );\n    const has = (e: HookEventName) => events.includes(e);\n\n    const header =\n      \"/**\\n\" +\n      \" * AUTO-GENERATED by agent-connector — DO NOT EDIT.\\n\" +\n      \" *\\n\" +\n      \" * Self-contained OpenClaw plugin bridge for connector \" +\n      ctx.connector.id +\n      \".\\n\" +\n      \" * It imports nothing from agent-connector: every hook invocation shells out\\n\" +\n      \" * to the stable home binary's universal entrypoint and JSON-parses the\\n\" +\n      \" * normalized response. Fail-open: any bridge error degrades to a no-op.\\n\" +\n      \" *\\n\" +\n      \" * Registered via DUAL REGISTRATION in openclaw.json: plugins.entries.<id>\\n\" +\n      \" * (loads this module) + mcp.servers.<id> (surfaces the MCP tools). The\\n\" +\n      \" * gateway hot-reloads its config on SIGUSR1.\\n\" +\n      \" */\\n\" +\n      'import { execFileSync, execSync } from \"node:child_process\";\\n\\n' +\n      \"const HOME_BIN = \" +\n      homeBin +\n      \";\\n\" +\n      \"const CONNECTOR_ID = \" +\n      connectorId +\n      \";\\n\\n\" +\n      \"/**\\n\" +\n      \" * Invoke the universal hook entrypoint for one canonical event.\\n\" +\n      \" * @param {string} event canonical event name\\n\" +\n      \" *   (PreToolUse|PostToolUse|SessionStart|SubagentStart|SubagentStop)\\n\" +\n      \" * @param {object} payload OpenClaw-shaped payload posted on stdin\\n\" +\n      \" * @returns {object|null} normalized HookResponse, or null on any failure\\n\" +\n      \" */\\n\" +\n      \"function bridge(event, payload) {\\n\" +\n      \"  try {\\n\" +\n      \"    // On Windows HOME_BIN is the agent-connector.cmd launcher: Node cannot\\n\" +\n      \"    // execFile a batch file, and shell+args is deprecated (DEP0190), so run\\n\" +\n      \"    // one quoted command line via a shell. POSIX keeps the direct execFile.\\n\" +\n      '    const args = [\"hook\", \"openclaw\", event, \"--connector\", CONNECTOR_ID];\\n' +\n      '    const opts = { input: JSON.stringify(payload), encoding: \"utf8\" };\\n' +\n      \"    const stdout =\\n\" +\n      '      process.platform === \"win32\"\\n' +\n      \"        ? execSync([HOME_BIN, ...args].map((a) => '\\\"' + a + '\\\"').join(\\\" \\\"), opts)\\n\" +\n      \"        : execFileSync(HOME_BIN, args, opts);\\n\" +\n      '    const text = (stdout || \"\").trim();\\n' +\n      '    if (text === \"\") return { decision: \"allow\" };\\n' +\n      \"    return JSON.parse(text);\\n\" +\n      \"  } catch {\\n\" +\n      \"    // Fail-open — never wedge a tool call on a bridge error.\\n\" +\n      \"    return null;\\n\" +\n      \"  }\\n\" +\n      \"}\\n\\n\" +\n      \"// Module-scoped context the prompt-build hook injects at session start.\\n\" +\n      \"// before_prompt_build is the verified injection point (session_start itself\\n\" +\n      \"// returns no context payload). The flag prevents double-injection.\\n\" +\n      \"let PROJECT_DIR = process.cwd();\\n\" +\n      \"let SESSION_ID = \\\"\\\";\\n\" +\n      \"let pendingContext = null;\\n\" +\n      \"let contextInjected = false;\\n\\n\";\n\n    // register(api) body — wire only the handlers this connector declares.\n    const reg: string[] = [];\n\n    reg.push(\n      \"  register(api) {\\n\" +\n        \"    PROJECT_DIR = process.cwd();\\n\" +\n        \"    const on = (event, handler) => {\\n\" +\n        '      if (typeof api?.on === \"function\") {\\n' +\n        \"        try { api.on(event, handler); return; } catch { /* fall through */ }\\n\" +\n        \"      }\\n\" +\n        '      if (typeof api?.registerHook === \"function\") {\\n' +\n        \"        try {\\n\" +\n        '          api.registerHook(event, handler, { name: CONNECTOR_ID + \":\" + event, description: \"agent-connector bridge\" });\\n' +\n        \"        } catch { /* best effort */ }\\n\" +\n        \"      }\\n\" +\n        \"    };\\n\",\n    );\n\n    if (has(\"PreToolUse\")) {\n      reg.push(\n        \"\\n\" +\n          \"    // PreToolUse → before_tool_call: block (return { block, blockReason })\\n\" +\n          \"    // for deny/ask; rewrite args by mutating event.params in place for modify.\\n\" +\n          '    on(\"before_tool_call\", async (event) => {\\n' +\n          \"      const e = event || {};\\n\" +\n          \"      const toolInput = e.params || {};\\n\" +\n          \"      const res = bridge(\\\"PreToolUse\\\", {\\n\" +\n          '        toolName: e.toolName || \"\",\\n' +\n          \"        toolInput,\\n\" +\n          \"        sessionId: SESSION_ID,\\n\" +\n          \"        projectDir: PROJECT_DIR,\\n\" +\n          \"      });\\n\" +\n          \"      if (!res) return undefined;\\n\" +\n          \"      // OpenClaw has no separate ask gate — deny and ask both block (safe).\\n\" +\n          '      if (res.decision === \"deny\" || res.decision === \"ask\") {\\n' +\n          '        return { block: true, blockReason: res.reason || (\"Blocked by \" + CONNECTOR_ID) };\\n' +\n          \"      }\\n\" +\n          '      if (res.decision === \"modify\" && res.updatedInput && typeof toolInput === \"object\") {\\n' +\n          \"        Object.assign(toolInput, res.updatedInput);\\n\" +\n          \"      }\\n\" +\n          \"      return undefined;\\n\" +\n          \"    });\\n\",\n      );\n    }\n\n    if (has(\"PostToolUse\")) {\n      reg.push(\n        \"\\n\" +\n          \"    // PostToolUse → after_tool_call: observe the completed tool call.\\n\" +\n          \"    // OpenClaw exposes the result (v2+) or output (older builds); it cannot\\n\" +\n          \"    // rewrite the tool result, so updatedOutput is intentionally dropped.\\n\" +\n          '    on(\"after_tool_call\", async (event) => {\\n' +\n          \"      const e = event || {};\\n\" +\n          \"      const rawResult = e.result !== undefined ? e.result : e.output;\\n\" +\n          \"      const toolOutput =\\n\" +\n          '        typeof rawResult === \"string\"\\n' +\n          \"          ? rawResult\\n\" +\n          \"          : rawResult != null\\n\" +\n          \"            ? JSON.stringify(rawResult)\\n\" +\n          \"            : undefined;\\n\" +\n          \"      bridge(\\\"PostToolUse\\\", {\\n\" +\n          '        toolName: e.toolName || \"\",\\n' +\n          \"        toolInput: e.params || {},\\n\" +\n          \"        toolOutput,\\n\" +\n          \"        isError: Boolean(e.error || e.isError),\\n\" +\n          \"        sessionId: SESSION_ID,\\n\" +\n          \"        projectDir: PROJECT_DIR,\\n\" +\n          \"      });\\n\" +\n          \"      return undefined;\\n\" +\n          \"    });\\n\",\n      );\n    }\n\n    if (has(\"SubagentStart\")) {\n      reg.push(\n        \"\\n\" +\n          \"    // SubagentStart → subagent_spawned: observe-only (OpenClaw exposes no\\n\" +\n          \"    // decision or context-injection payload for subagent launches). Field\\n\" +\n          \"    // names vary across builds, so the common variants are normalized;\\n\" +\n          \"    // empty values are omitted so the dispatcher never matcher-filters on\\n\" +\n          '    // an empty agent type (fail-open).\\n' +\n          '    on(\"subagent_spawned\", async (event) => {\\n' +\n          \"      const e = event || {};\\n\" +\n          \"      bridge(\\\"SubagentStart\\\", {\\n\" +\n          \"        agentId: e.agentId || e.subagentId || undefined,\\n\" +\n          \"        agentType: e.agentType || e.subagentType || e.agent || undefined,\\n\" +\n          \"        sessionId: SESSION_ID,\\n\" +\n          \"        projectDir: PROJECT_DIR,\\n\" +\n          \"      });\\n\" +\n          \"      return undefined;\\n\" +\n          \"    });\\n\",\n      );\n    }\n\n    if (has(\"SubagentStop\")) {\n      reg.push(\n        \"\\n\" +\n          \"    // SubagentStop → subagent_ended: observe-only completion. A normalized\\n\" +\n          \"    // 'deny' cannot keep the subagent running on OpenClaw, so the bridge\\n\" +\n          \"    // reply is intentionally ignored.\\n\" +\n          '    on(\"subagent_ended\", async (event) => {\\n' +\n          \"      const e = event || {};\\n\" +\n          \"      const rawResult = e.result !== undefined ? e.result : e.output;\\n\" +\n          \"      bridge(\\\"SubagentStop\\\", {\\n\" +\n          \"        agentId: e.agentId || e.subagentId || undefined,\\n\" +\n          \"        agentType: e.agentType || e.subagentType || e.agent || undefined,\\n\" +\n          \"        lastAssistantMessage:\\n\" +\n          '          typeof rawResult === \"string\" && rawResult !== \"\" ? rawResult : undefined,\\n' +\n          \"        sessionId: SESSION_ID,\\n\" +\n          \"        projectDir: PROJECT_DIR,\\n\" +\n          \"      });\\n\" +\n          \"      return undefined;\\n\" +\n          \"    });\\n\",\n      );\n    }\n\n    if (has(\"SessionStart\")) {\n      reg.push(\n        \"\\n\" +\n          \"    // SessionStart → session_start records the real session id and fetches\\n\" +\n          \"    // the additionalContext to inject; before_prompt_build performs the\\n\" +\n          \"    // injection (the verified context-injection point upstream).\\n\" +\n          '    on(\"session_start\", async (event) => {\\n' +\n          \"      const e = event || {};\\n\" +\n          \"      SESSION_ID = e.sessionId || e.sessionKey || SESSION_ID;\\n\" +\n          \"      const res = bridge(\\\"SessionStart\\\", {\\n\" +\n          \"        sessionId: SESSION_ID,\\n\" +\n          '        source: e.resumedFrom ? \"resume\" : \"startup\",\\n' +\n          \"        projectDir: PROJECT_DIR,\\n\" +\n          \"      });\\n\" +\n          \"      contextInjected = false;\\n\" +\n          \"      pendingContext =\\n\" +\n          '        res && typeof res.additionalContext === \"string\" && res.additionalContext\\n' +\n          \"          ? res.additionalContext\\n\" +\n          \"          : null;\\n\" +\n          \"      return undefined;\\n\" +\n          \"    });\\n\" +\n          \"\\n\" +\n          \"    // Inject the session-start context once, at prompt-build time.\\n\" +\n          '    on(\"before_prompt_build\", () => {\\n' +\n          \"      if (contextInjected || !pendingContext) return undefined;\\n\" +\n          \"      contextInjected = true;\\n\" +\n          \"      return { appendSystemContext: pendingContext };\\n\" +\n          \"    });\\n\",\n      );\n    }\n\n    reg.push(\"  },\\n\");\n\n    const definition =\n      \"const plugin = {\\n\" +\n      \"  id: CONNECTOR_ID,\\n\" +\n      \"  name: \" +\n      connectorName +\n      \",\\n\" +\n      \"  configSchema: {\\n\" +\n      '    type: \"object\",\\n' +\n      \"    properties: {\\n\" +\n      \"      enabled: {\\n\" +\n      '        type: \"boolean\",\\n' +\n      \"        default: true,\\n\" +\n      '        description: \"Enable or disable the \" + CONNECTOR_ID + \" plugin.\",\\n' +\n      \"      },\\n\" +\n      \"    },\\n\" +\n      \"    additionalProperties: false,\\n\" +\n      \"  },\\n\" +\n      reg.join(\"\") +\n      \"};\\n\\n\" +\n      \"export default plugin;\\n\";\n\n    return header + definition;\n  }\n\n  // ── Runtime: parse OUR bridge payload → normalized event ───────────────\n\n  /**\n   * `raw` is the payload OUR generated plugin posts (NOT a host-native shape):\n   *   { toolName, toolInput, toolOutput?, isError?, sessionId, source?, projectDir }\n   * so this maps straight through.\n   */\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as OpenClawBridgePayload;\n    const base = {\n      hostPlatform: HOST,\n      connectorId: \"\",\n      sessionId: typeof input.sessionId === \"string\" ? input.sessionId : \"\",\n      raw,\n      ...(typeof input.projectDir === \"string\" ? { projectDir: input.projectDir } : {}),\n    } as const;\n\n    switch (event) {\n      case \"PreToolUse\": {\n        const ev: PreToolUseEvent = {\n          ...base,\n          toolName: input.toolName ?? \"\",\n          toolInput: input.toolInput ?? {},\n        };\n        return ev;\n      }\n      case \"PostToolUse\": {\n        const ev: PostToolUseEvent = {\n          ...base,\n          toolName: input.toolName ?? \"\",\n          toolInput: input.toolInput ?? {},\n          ...(typeof input.toolOutput === \"string\" ? { toolOutput: input.toolOutput } : {}),\n          ...(typeof input.isError === \"boolean\" ? { isError: input.isError } : {}),\n        };\n        return ev;\n      }\n      case \"SessionStart\": {\n        const source: SessionStartEvent[\"source\"] =\n          input.source === \"resume\"\n            ? \"resume\"\n            : input.source === \"compact\"\n              ? \"compact\"\n              : input.source === \"clear\"\n                ? \"clear\"\n                : \"startup\";\n        const ev: SessionStartEvent = { ...base, source };\n        return ev;\n      }\n      case \"SubagentStart\": {\n        // Empty strings are dropped so the runtime matcher never filters a\n        // real spawn on an unknown agent type (fail-open, per the dispatcher).\n        const ev: SubagentStartEvent = {\n          ...base,\n          ...(isNonEmptyString(input.agentId) ? { agentId: input.agentId } : {}),\n          ...(isNonEmptyString(input.agentType)\n            ? { agentType: input.agentType }\n            : {}),\n        };\n        return ev;\n      }\n      case \"SubagentStop\": {\n        const ev: SubagentStopEvent = {\n          ...base,\n          ...(isNonEmptyString(input.agentId) ? { agentId: input.agentId } : {}),\n          ...(isNonEmptyString(input.agentType)\n            ? { agentType: input.agentType }\n            : {}),\n          ...(isNonEmptyString(input.lastAssistantMessage)\n            ? { lastAssistantMessage: input.lastAssistantMessage }\n            : {}),\n        };\n        return ev;\n      }\n      default:\n        // Other canonical events are not surfaced by OpenClaw; treat as a\n        // session-start-shaped no-op so the dispatcher fails open gracefully.\n        return { ...base, source: \"startup\" } satisfies SessionStartEvent;\n    }\n  }\n\n  // ── Runtime: normalized response → reply the generated bridge parses ───\n\n  /**\n   * Unlike json-stdio hosts (whose reply is the host's NATIVE control payload),\n   * OUR generated bridge consumes this stdout directly. So the reply body is the\n   * NORMALIZED HookResponse itself — the bridge JSON.parses it and reads\n   * decision / updatedInput / additionalContext.\n   */\n  formatReply(_event: HookEventName, response: HookResponse): HookReply {\n    return {\n      exitCode: 0,\n      stdout: JSON.stringify(response ?? { decision: \"allow\" }),\n    };\n  }\n\n  // ── Diagnostics ────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const configPath = this.getServerConfigPath(ctx);\n    const pluginPath = this.getHookConfigPath(ctx);\n    const pluginDir = this.pluginDir(ctx);\n    const id = ctx.connector.id;\n    const hasHooks = ctx.connector.hookEvents.length > 0;\n    const hasServer = Boolean(ctx.connector.server);\n\n    return [\n      {\n        name: `${this.name}: openclaw.json present`,\n        check: () =>\n          existsSync(configPath)\n            ? { status: \"OK\", detail: configPath }\n            : { status: \"FAIL\", detail: `not found: ${configPath}` },\n      },\n      {\n        // HARDEST PART — dual registration must be CONSISTENT. The plugin only\n        // delivers tools when it is LOADED (plugins.entries.<id> enabled AND its\n        // dir in plugins.load.paths) AND in mcp.servers. A config with one half\n        // but not the other is a tool-less (or never-loaded) install, so FAIL on\n        // loaded XOR mcp.servers. (We assert plugins.load.paths — NOT a per-entry\n        // `module` field, which openclaw config validate rejects.)\n        name: `${this.name}: dual registration (plugins.entries+load.paths + mcp.servers.${id})`,\n        check: () => {\n          // Only assert what the connector declares: a catalog-only connector\n          // (no MCP server, no hooks) never writes either half of the dual\n          // registration, so absence — even of the config file — is healthy.\n          if (!hasServer && !hasHooks) {\n            return { status: \"OK\", detail: \"no MCP server or hooks declared\" };\n          }\n          const cfg = this.readJson<Record<string, unknown>>(configPath);\n          if (!cfg) return { status: \"FAIL\", detail: `cannot read ${configPath}` };\n\n          const inEntries = this.hasPluginEntry(cfg, id) && this.hasLoadPath(cfg, pluginDir);\n          const inMcp = this.hasMcpServer(cfg, id);\n\n          // A hooks-only connector (no MCP server declared) does not need the\n          // mcp.servers half — the load half alone is correct and complete.\n          if (!hasServer) {\n            return inEntries || !hasHooks\n              ? { status: \"OK\", detail: \"hooks-only connector (no MCP server)\" }\n              : {\n                  status: \"FAIL\",\n                  detail: `${id} not enabled in ${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY} + ${PLUGINS_KEY}.${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY} (plugin will not load)`,\n                };\n          }\n\n          if (inEntries && inMcp) {\n            return {\n              status: \"OK\",\n              detail: `${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}.${id}+${PLUGINS_KEY}.${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY} + ${MCP_ROOT_KEY}.${MCP_SERVERS_KEY}.${id}`,\n            };\n          }\n          if (inEntries && !inMcp) {\n            return {\n              status: \"FAIL\",\n              detail: `loaded (${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}+${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY}) but missing from ${MCP_ROOT_KEY}.${MCP_SERVERS_KEY} — plugin loads but no tools reach the agent`,\n            };\n          }\n          if (!inEntries && inMcp) {\n            return {\n              status: \"FAIL\",\n              detail: `in ${MCP_ROOT_KEY}.${MCP_SERVERS_KEY} but not loaded (missing ${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY} or ${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY}) — tools declared but plugin never loads`,\n            };\n          }\n          return {\n            status: \"FAIL\",\n            detail: `not loaded (${PLUGINS_KEY}.${PLUGINS_ENTRIES_KEY}+${PLUGINS_LOAD_KEY}.${PLUGINS_LOAD_PATHS_KEY}) and not in ${MCP_ROOT_KEY}.${MCP_SERVERS_KEY}`,\n          };\n        },\n      },\n      {\n        name: `${this.name}: plugin module present`,\n        check: () => {\n          if (!hasHooks) return { status: \"OK\", detail: \"no hooks declared\" };\n          return existsSync(pluginPath)\n            ? { status: \"OK\", detail: pluginPath }\n            : { status: \"FAIL\", detail: `not found: ${pluginPath}` };\n        },\n      },\n    ];\n  }\n\n  /** True when config.plugins.entries.<id> exists (and is not disabled). */\n  private hasPluginEntry(cfg: Record<string, unknown>, id: string): boolean {\n    const plugins = cfg[PLUGINS_KEY];\n    if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) return false;\n    const entries = (plugins as Record<string, unknown>)[PLUGINS_ENTRIES_KEY];\n    if (!entries || typeof entries !== \"object\" || Array.isArray(entries)) return false;\n    const entry = (entries as Record<string, unknown>)[id];\n    if (entry === undefined) return false;\n    // An explicit { enabled: false } means the gateway will not load it.\n    return !(\n      entry &&\n      typeof entry === \"object\" &&\n      (entry as Record<string, unknown>).enabled === false\n    );\n  }\n\n  /** True when config.plugins.load.paths includes `pluginDir`. */\n  private hasLoadPath(cfg: Record<string, unknown>, pluginDir: string): boolean {\n    const plugins = cfg[PLUGINS_KEY];\n    if (!plugins || typeof plugins !== \"object\" || Array.isArray(plugins)) return false;\n    const load = (plugins as Record<string, unknown>)[PLUGINS_LOAD_KEY];\n    if (!load || typeof load !== \"object\" || Array.isArray(load)) return false;\n    const paths = (load as Record<string, unknown>)[PLUGINS_LOAD_PATHS_KEY];\n    return Array.isArray(paths) && paths.includes(pluginDir);\n  }\n\n  /** True when config.mcp.servers.<id> exists. */\n  private hasMcpServer(cfg: Record<string, unknown>, id: string): boolean {\n    const mcp = cfg[MCP_ROOT_KEY];\n    if (!mcp || typeof mcp !== \"object\" || Array.isArray(mcp)) return false;\n    const servers = (mcp as Record<string, unknown>)[MCP_SERVERS_KEY];\n    if (!servers || typeof servers !== \"object\" || Array.isArray(servers)) return false;\n    return id in (servers as Record<string, unknown>);\n  }\n\n  /** Read a file, returning undefined on any error (idempotency compare). */\n  private safeRead(path: string): string | undefined {\n    try {\n      return readFileSync(path, \"utf8\");\n    } catch {\n      return undefined;\n    }\n  }\n}\n\n/**\n * Resolve the openclaw.json the gateway actually loads (mirrors context-mode's\n * openclawConfigPath): $OPENCLAW_CONFIG_PATH, else $OPENCLAW_STATE_DIR/openclaw.json,\n * else ~/.openclaw/openclaw.json. The gateway never loads a CWD/project-local\n * openclaw.json for user scope, so this is the canonical user-scope path.\n */\nfunction resolveOpenClawConfigPath(env: NodeJS.ProcessEnv = process.env): string {\n  if (env.OPENCLAW_CONFIG_PATH) return resolve(env.OPENCLAW_CONFIG_PATH);\n  const stateDir = env.OPENCLAW_STATE_DIR\n    ? resolve(env.OPENCLAW_STATE_DIR)\n    : resolve(homedir(), \".openclaw\");\n  return resolve(stateDir, \"openclaw.json\");\n}\n\n/** Create a directory (recursive) if it does not already exist. */\nfunction ensureDir(dir: string): void {\n  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n}\n\n/** Narrow to a non-empty string (the bridge omits empties, but stay defensive). */\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value !== \"\";\n}\n\nexport const adapter = new OpenClawAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;;AAsFA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe;AACxB,SAAS,SAAS,MAAM,eAAe;AAkCvC,IAAM,OAAmB;AAOzB,IAAM,eAAe;AACrB,IAAM,kBAAkB;AACxB,IAAM,cAAc;AACpB,IAAM,sBAAsB;AAM5B,IAAM,mBAAmB;AACzB,IAAM,yBAAyB;AAE/B,IAAM,uBAAuB;AAU7B,IAAM,oBAA4D;AAAA,EAChE,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,eAAe;AAAA,EACf,cAAc;AAChB;AAoDO,IAAM,kBAAN,cAA8B,YAA+B;AAAA,EACzD,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA;AAAA;AAAA;AAAA,IAK5C,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,aAAa;AAAA;AAAA;AAAA,IAGb,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,MAAM;AAAA,IACN,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQd,eAAe;AAAA,IACf,cAAc;AAAA;AAAA,IAEd,eAAe;AAAA;AAAA,IAEf,iBAAiB;AAAA;AAAA,IAEjB,yBAAyB;AAAA;AAAA,IAEzB,YAAY,CAAC,OAAO;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWmB,SAAsC,MAAwB;AAC/E,QAAI,CAAC,WAAW,IAAI,EAAG,QAAO;AAC9B,QAAI;AACJ,QAAI;AACF,YAAM,aAAa,MAAM,MAAM;AAAA,IACjC,QAAQ;AACN,aAAO;AAAA,IACT;AACA,QAAI;AAGF,aAAO,WAAc,GAAG;AAAA,IAC1B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWmB,cAAc,KAAqC;AACpE,QAAI,KAAK,eAAe,GAAG,GAAG,KAAM,QAAO,MAAM,cAAc,GAAG;AAClE,QAAI,IAAI,UAAU,aAAa,IAAI,UAAU,OAAQ,QAAO,CAAC;AAC7D,UAAM,aAAa,0BAA0B;AAC7C,UAAM,MAAM,KAAK,SAA8D,UAAU;AACzF,UAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,UAAM,YACJ,OAAO,aAAa,YAAY,SAAS,KAAK,MAAM,KAChD,SAAS,WAAW,GAAG,IACrB,QAAQ,QAAQ,GAAG,SAAS,QAAQ,YAAY,EAAE,CAAC,IACnD,QAAQ,QAAQ,IAClB,KAAK,QAAQ,UAAU,GAAG,WAAW;AAC3C,WAAO;AAAA,MACL;AAAA,QACE,MAAM,KAAK,WAAW,WAAW;AAAA,QACjC,QACE;AAAA,MAEJ;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,gBAAgB,YAAsC;AACpD,UAAM,aAAa,0BAA0B;AAC7C,UAAM,UAAU,KAAK,QAAQ,GAAG,WAAW;AAC3C,UAAM,gBAAgB,KAAK,YAAY,eAAe;AAEtD,UAAM,gBAAgB,WAAW,UAAU,KAAK,WAAW,OAAO;AAClE,UAAM,gBAAgB,WAAW,aAAa;AAC9C,UAAM,YAAY,iBAAiB;AAEnC,UAAM,QAAQ,iBAAiB,CAAC,gBAAgB,YAAY;AAC5D,UAAM,aAAa,UAAU,YAAY,gBAAgB;AAEzD,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,UAAU,YACR,oCAAoC,aAAa,KACjD,4BAA4B,UAAU,KACxC,yBAAyB,UAAU,OAAO,OAAO;AAAA,MACrD,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA,EAIA,aAAa,KAA6B;AACxC,WAAO,IAAI,UAAU,YACjB,IAAI,aACJ,QAAQ,0BAA0B,CAAC;AAAA,EACzC;AAAA,EAEA,oBAAoB,KAA6B;AAC/C,WAAO,IAAI,UAAU,YACjB,KAAK,IAAI,YAAY,eAAe,IACpC,0BAA0B;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,KAAK,UAAU,GAAG,GAAG,KAAK,eAAe,CAAC;AAAA,EACxD;AAAA;AAAA,EAGQ,UAAU,KAA6B;AAC7C,UAAM,OACJ,IAAI,UAAU,YACV,KAAK,IAAI,YAAY,WAAW,IAChC,QAAQ,0BAA0B,CAAC;AACzC,WAAO,KAAK,MAAM,cAAc,IAAI,UAAU,EAAE;AAAA,EAClD;AAAA;AAAA,EAGQ,iBAAyB;AAC/B,WAAO;AAAA,EACT;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,SAAS,KAAK,gBAAgB,GAAG;AACvC,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAE/C,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ,IAAI,UAAU,SAClB,8CACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,KAAK,kBAAkB,KAAK,MAAM;AAChD,WAAO,CAAC,KAAK,mBAAmB,YAAY,IAAI,UAAU,IAAI,OAAO,IAAI,MAAM,CAAC;AAAA,EAClF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,WAAO,CAAC,KAAK,mBAAmB,YAAY,IAAI,UAAU,IAAI,IAAI,MAAM,CAAC;AAAA,EAC3E;AAAA;AAAA,EAGQ,gBAAgB,KAA4C;AAClE,UAAM,WAAW,IAAI,UAAU,UAAU,IAAI,GAAG;AAChD,QAAI,aAAa,MAAO,QAAO;AAC/B,UAAM,OAAO,IAAI,UAAU;AAC3B,QAAI,CAAC,KAAM,QAAO;AAClB,WAAO,YAAY,OAAO,aAAa,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS,IAAI;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYQ,kBACN,KACA,QAC4C;AAC5C,QAAI,OAAO,cAAc,SAAS;AAChC,UAAI,UAAU,OAAO,WAAW;AAChC,UAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAIlC,UAAI,uBAAuB,QAAQ,IAAI,UAAU,SAAS,GAAG;AAC3D,cAAM,UAAU;AAAA,UACd,IAAI;AAAA,UACJ,IAAI,UAAU;AAAA,UACd;AAAA,UACA;AAAA,UACA,IAAI;AAAA,UACJ,KAAK;AAAA,QACP;AACA,kBAAU,QAAQ;AAClB,eAAO,QAAQ;AAAA,MACjB;AAIA,YAAMA,SAA6B;AAAA,QACjC,SAAS,mBAAmB,OAAO;AAAA,MACrC;AACA,YAAM,eAAe,mBAAmB,IAAI,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AACpE,UAAI,aAAa,SAAS,EAAG,CAAAA,OAAM,OAAO;AAC1C,YAAM,MAAM,KAAK,UAAU,OAAO,GAAG;AACrC,UAAI,IAAK,CAAAA,OAAM,MAAM;AACrB,UAAI,OAAO,YAAY,MAAO,CAAAA,OAAM,UAAU;AAC9C,aAAOA;AAAA,IACT;AAGA,UAAM,YAA4B,OAAO,cAAc,SAAS,SAAS;AACzE,UAAM,QAA8B;AAAA,MAClC,KAAK,mBAAmB,OAAO,OAAO,EAAE;AAAA,MACxC;AAAA,IACF;AACA,QAAI,OAAO,WAAW,OAAO,KAAK,OAAO,OAAO,EAAE,SAAS,GAAG;AAC5D,YAAM,UAAU,mBAAmB,EAAE,GAAG,OAAO,QAAQ,CAAC;AAAA,IAC1D;AACA,QAAI,OAAO,YAAY,MAAO,OAAM,UAAU;AAC9C,WAAO;AAAA,EACT;AAAA;AAAA,EAGQ,UACN,KACoC;AACpC,QAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAClD,WAAO,mBAAmB,EAAE,GAAG,IAAI,CAAC;AAAA,EACtC;AAAA;AAAA,EAGQ,mBACN,MACA,IACA,OACA,QACc;AAEd,QAAI,KAAK,wBAAwB,IAAI,GAAG;AACtC,aAAO;AAAA,QACL,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ,YAAY,IAAI;AAAA,MAC1B;AAAA,IACF;AACA,UAAM,MAAM,KAAK,SAAkC,IAAI,KAAK,CAAC;AAC7D,UAAM,UAAU,KAAK,oBAAoB,GAAG;AAC5C,UAAM,SAAS,KAAK,UAAU,QAAQ,EAAE,CAAC;AACzC,UAAM,QAAQ,KAAK,UAAU,KAAK;AAClC,QAAI;AACJ,QAAI,WAAW,OAAW,UAAS;AAAA,aAC1B,WAAW,MAAO,UAAS;AAAA,QAC/B,UAAS;AACd,QAAI,WAAW,QAAQ;AACrB,cAAQ,EAAE,IAAI;AACd,WAAK,UAAU,MAAM,KAAK,MAAM;AAAA,IAClC;AACA,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf;AAAA,MACA;AAAA,MACA,QAAQ,GAAG,YAAY,IAAI,eAAe,IAAI,EAAE;AAAA,IAClD;AAAA,EACF;AAAA;AAAA,EAGQ,mBAAmB,MAAc,IAAY,QAA+B;AAClF,UAAM,MAAM,KAAK,SAAkC,IAAI;AACvD,UAAM,MAAM,MAAM,YAAY;AAC9B,UAAM,UACJ,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG,IAC9C,IAAgC,eAAe,IAGjD;AACN,QAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,UAAU;AACxC,aAAO;AAAA,QACL,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ,GAAG,YAAY,IAAI,eAAe,IAAI,EAAE;AAAA,MAClD;AAAA,IACF;AACA,WAAO,QAAQ,EAAE;AACjB,SAAK,UAAU,MAAM,KAAK,MAAM;AAChC,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf,QAAQ;AAAA,MACR;AAAA,MACA,QAAQ,GAAG,YAAY,IAAI,eAAe,IAAI,EAAE;AAAA,IAClD;AAAA,EACF;AAAA;AAAA,EAGQ,oBAAoB,KAAuD;AACjF,QAAI,MAAM,IAAI,YAAY;AAC1B,QAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,YAAM,CAAC;AACP,UAAI,YAAY,IAAI;AAAA,IACtB;AACA,UAAM,SAAS;AACf,QAAI,UAAU,OAAO,eAAe;AACpC,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACrE,gBAAU,CAAC;AACX,aAAO,eAAe,IAAI;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAIA,aAAa,KAAqC;AAChD,UAAM,aAAa,KAAK,kBAAkB,GAAG;AAC7C,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAE/C,QAAI,IAAI,UAAU,UAAU,IAAI,GAAG,UAAU,OAAO;AAClD,aAAO;AAAA,QACL,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,MAAM,YAAY,QAAQ,8BAA8B;AAAA,MAC/F;AAAA,IACF;AACA,QAAI,IAAI,UAAU,WAAW,WAAW,GAAG;AACzC,aAAO;AAAA,QACL,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,MAAM,YAAY,QAAQ,8BAA8B;AAAA,MAC/F;AAAA,IACF;AAEA,UAAM,UAA0B,CAAC;AAGjC,eAAW,QAAQ,KAAK,iBAAiB,GAAG,GAAG;AAC7C,YAAM,SAAS,WAAW,KAAK,IAAI,IAAI,KAAK,SAAS,KAAK,IAAI,IAAI;AAClE,UAAI;AACJ,UAAI,WAAW,OAAW,UAAS;AAAA,eAC1B,WAAW,KAAK,SAAU,UAAS;AAAA,UACvC,UAAS;AAEd,UAAI,WAAW,UAAU,CAAC,IAAI,QAAQ;AACpC,kBAAU,QAAQ,KAAK,IAAI,CAAC;AAC5B,sBAAc,KAAK,MAAM,KAAK,UAAU,MAAM;AAC9C,kBAAU,KAAK,MAAM,KAAK,aAAa,MAAQ,GAAK;AAAA,MACtD;AACA,cAAQ,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf;AAAA,QACA,MAAM,KAAK;AAAA,QACX,QAAQ,2BAA2B,KAAK,WAAW,GAAG,CAAC;AAAA,MACzD,CAAC;AAAA,IACH;AAMA,YAAQ,KAAK,KAAK,kBAAkB,YAAY,KAAK,KAAK,UAAU,GAAG,CAAC,CAAC;AAEzE,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,WAAW,KAA6B;AAC9C,UAAM,WAAW,IAAI,UAAU;AAC/B,UAAM,SAAS,SAAS,OAAO,CAAC,MAAM,kBAAkB,CAAC,MAAM,MAAS;AACxE,UAAM,cAAc,SAAS,OAAO,CAAC,MAAM,kBAAkB,CAAC,MAAM,MAAS;AAC7E,UAAM,OAAO,OAAO,KAAK,GAAG;AAC5B,WAAO,YAAY,SAAS,IACxB,GAAG,IAAI,uBAAuB,YAAY,KAAK,GAAG,CAAC,KACnD;AAAA,EACN;AAAA,EAEA,eAAe,KAAqC;AAClD,UAAM,aAAa,KAAK,kBAAkB,GAAG;AAC7C,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,UAA0B,CAAC;AAIjC,YAAQ;AAAA,MACN,KAAK,kBAAkB,YAAY,IAAI,UAAU,IAAI,KAAK,UAAU,GAAG,GAAG,IAAI,MAAM;AAAA,IACtF;AAGA,UAAM,eAAe,KAAK,KAAK,UAAU,GAAG,GAAG,oBAAoB;AACnE,eAAW,CAAC,MAAM,KAAK,KAAK;AAAA,MAC1B,CAAC,YAAY,wBAAwB;AAAA,MACrC,CAAC,cAAc,0BAA0B;AAAA,IAC3C,GAAY;AACV,UAAI,WAAW,IAAI,GAAG;AACpB,YAAI,CAAC,IAAI,OAAQ,QAAO,MAAM,EAAE,OAAO,KAAK,CAAC;AAC7C,gBAAQ,KAAK,EAAE,UAAU,KAAK,IAAI,QAAQ,UAAU,MAAM,QAAQ,MAAM,CAAC;AAAA,MAC3E,OAAO;AACL,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR;AAAA,UACA,QAAQ,MAAM,KAAK;AAAA,QACrB,CAAC;AAAA,MACH;AAAA,IACF;AAGA,YAAQ,KAAK,KAAK,iBAAiB,KAAK,UAAU,GAAG,GAAG,IAAI,MAAM,CAAC;AAEnE,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,kBACN,YACA,KACA,WACc;AAEd,QAAI,KAAK,wBAAwB,UAAU,GAAG;AAC5C,aAAO;AAAA,QACL,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,QAAQ,YAAY,UAAU;AAAA,MAChC;AAAA,IACF;AACA,UAAM,MAAM,KAAK,SAAkC,UAAU,KAAK,CAAC;AACnE,UAAM,UAAU,KAAK,oBAAoB,GAAG;AAC5C,UAAM,KAAK,IAAI,UAAU;AACzB,UAAM,UAA+B,EAAE,SAAS,KAAK;AACrD,UAAM,cAAc,KAAK,UAAU,QAAQ,EAAE,CAAC;AAC9C,UAAM,aAAa,KAAK,UAAU,OAAO;AAGzC,UAAM,YAAY,KAAK,sBAAsB,GAAG;AAChD,UAAM,cAAc,UAAU,SAAS,SAAS;AAEhD,UAAM,eAAe,gBAAgB;AACrC,UAAM,cAAc,CAAC;AACrB,QAAI;AACJ,QAAI,gBAAgB,OAAW,UAAS;AAAA,aAC/B,CAAC,gBAAgB,CAAC,YAAa,UAAS;AAAA,QAC5C,UAAS;AAEd,QAAI,WAAW,QAAQ;AACrB,cAAQ,EAAE,IAAI;AACd,UAAI,CAAC,YAAa,WAAU,KAAK,SAAS;AAC1C,WAAK,UAAU,YAAY,KAAK,IAAI,MAAM;AAAA,IAC5C;AACA,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf;AAAA,MACA,MAAM;AAAA,MACN,QAAQ,GAAG,WAAW,IAAI,mBAAmB,IAAI,EAAE,MAAM,WAAW,IAAI,gBAAgB,IAAI,sBAAsB;AAAA,IACpH;AAAA,EACF;AAAA;AAAA,EAGQ,kBACN,YACA,IACA,WACA,QACc;AACd,UAAM,MAAM,KAAK,SAAkC,UAAU;AAC7D,UAAM,UAAU,MAAM,WAAW;AACjC,UAAM,aACJ,WAAW,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,IAC3D,UACD;AACN,UAAM,UAAU,aAAa,mBAAmB;AAGhD,UAAM,OAAO,aAAa,gBAAgB;AAC1C,UAAM,YACJ,QAAQ,MAAM,QAAQ,KAAK,sBAAsB,CAAC,IAC7C,KAAK,sBAAsB,IAC5B;AAEN,UAAM,eAAe,QAAQ,WAAW,MAAM,OAAO;AACrD,UAAM,UAAU,YAAY,UAAU,QAAQ,SAAS,IAAI;AAE3D,QAAI,CAAC,OAAQ,CAAC,gBAAgB,UAAU,GAAI;AAC1C,aAAO;AAAA,QACL,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,QAAQ,GAAG,WAAW,IAAI,mBAAmB,IAAI,EAAE;AAAA,MACrD;AAAA,IACF;AACA,QAAI,gBAAgB,QAAS,QAAO,QAAQ,EAAE;AAC9C,QAAI,aAAa,WAAW,EAAG,WAAU,OAAO,SAAS,CAAC;AAC1D,SAAK,UAAU,YAAY,KAAK,MAAM;AACtC,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,QAAQ,GAAG,WAAW,IAAI,mBAAmB,IAAI,EAAE,MAAM,WAAW,IAAI,gBAAgB,IAAI,sBAAsB;AAAA,IACpH;AAAA,EACF;AAAA;AAAA,EAGQ,oBAAoB,KAAuD;AACjF,QAAI,UAAU,IAAI,WAAW;AAC7B,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACrE,gBAAU,CAAC;AACX,UAAI,WAAW,IAAI;AAAA,IACrB;AACA,UAAM,aAAa;AACnB,QAAI,UAAU,WAAW,mBAAmB;AAC5C,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACrE,gBAAU,CAAC;AACX,iBAAW,mBAAmB,IAAI;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGQ,sBAAsB,KAAwC;AACpE,QAAI,UAAU,IAAI,WAAW;AAC7B,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACrE,gBAAU,CAAC;AACX,UAAI,WAAW,IAAI;AAAA,IACrB;AACA,UAAM,aAAa;AACnB,QAAI,OAAO,WAAW,gBAAgB;AACtC,QAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,GAAG;AAC5D,aAAO,CAAC;AACR,iBAAW,gBAAgB,IAAI;AAAA,IACjC;AACA,UAAM,UAAU;AAChB,UAAM,WAAW,QAAQ,sBAAsB;AAG/C,UAAM,QAAQ,MAAM,QAAQ,QAAQ,IAChC,SAAS,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IACzD,CAAC;AACL,YAAQ,sBAAsB,IAAI;AAClC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,iBAAiB,KAA4C;AAC3D,UAAM,OAAO,KAAK,kBAAkB,GAAG;AACvC,UAAM,WAAW,KAAK,kBAAkB,GAAG;AAG3C,UAAM,eAAe,KAAK,KAAK,UAAU,GAAG,GAAG,oBAAoB;AACnE,UAAM,WAAW,KAAK,oBAAoB,GAAG;AAC7C,WAAO;AAAA,MACL,EAAE,MAAM,UAAU,YAAY,MAAM;AAAA,MACpC,EAAE,MAAM,cAAc,UAAU,UAAU,YAAY,MAAM;AAAA,IAC9D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,oBAAoB,KAA6B;AACvD,UAAM,WAAW;AAAA,MACf,IAAI,IAAI,UAAU;AAAA,MAClB,MAAM,IAAI,UAAU,eAAe,IAAI,UAAU;AAAA,MACjD,MAAM,KAAK,eAAe;AAAA,MAC1B,SAAS;AAAA,IACX;AACA,WAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA;AAAA,EAC7C;AAAA;AAAA,EAGQ,kBAAkB,KAA6B;AACrD,UAAM,UAAU,KAAK,UAAU,IAAI,WAAW;AAC9C,UAAM,cAAc,KAAK,UAAU,IAAI,UAAU,EAAE;AACnD,UAAM,gBAAgB,KAAK,UAAU,IAAI,UAAU,eAAe,IAAI,UAAU,EAAE;AAElF,UAAM,SAAS,IAAI,UAAU,WAAW;AAAA,MACtC,CAAC,MAA0B,kBAAkB,CAAC,MAAM;AAAA,IACtD;AACA,UAAM,MAAM,CAAC,MAAqB,OAAO,SAAS,CAAC;AAEnD,UAAM,SACJ,+HAIA,IAAI,UAAU,KACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAWA,UACA,6BAEA,cACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCF,UAAM,MAAgB,CAAC;AAEvB,QAAI;AAAA,MACF;AAAA,IAYF;AAEA,QAAI,IAAI,YAAY,GAAG;AACrB,UAAI;AAAA,QACF;AAAA,MAsBF;AAAA,IACF;AAEA,QAAI,IAAI,aAAa,GAAG;AACtB,UAAI;AAAA,QACF;AAAA,MAuBF;AAAA,IACF;AAEA,QAAI,IAAI,eAAe,GAAG;AACxB,UAAI;AAAA,QACF;AAAA,MAgBF;AAAA,IACF;AAEA,QAAI,IAAI,cAAc,GAAG;AACvB,UAAI;AAAA,QACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAiBF;AAAA,IACF;AAEA,QAAI,IAAI,cAAc,GAAG;AACvB,UAAI;AAAA,QACF;AAAA,MA0BF;AAAA,IACF;AAEA,QAAI,KAAK,QAAQ;AAEjB,UAAM,aACJ,oDAGA,gBACA,6QAYA,IAAI,KAAK,EAAE,IACX;AAGF,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,OAAsB,KAA+B;AAC9D,UAAM,QAAS,OAAO,CAAC;AACvB,UAAM,OAAO;AAAA,MACX,cAAc;AAAA,MACd,aAAa;AAAA,MACb,WAAW,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;AAAA,MACnE;AAAA,MACA,GAAI,OAAO,MAAM,eAAe,WAAW,EAAE,YAAY,MAAM,WAAW,IAAI,CAAC;AAAA,IACjF;AAEA,YAAQ,OAAO;AAAA,MACb,KAAK,cAAc;AACjB,cAAM,KAAsB;AAAA,UAC1B,GAAG;AAAA,UACH,UAAU,MAAM,YAAY;AAAA,UAC5B,WAAW,MAAM,aAAa,CAAC;AAAA,QACjC;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,eAAe;AAClB,cAAM,KAAuB;AAAA,UAC3B,GAAG;AAAA,UACH,UAAU,MAAM,YAAY;AAAA,UAC5B,WAAW,MAAM,aAAa,CAAC;AAAA,UAC/B,GAAI,OAAO,MAAM,eAAe,WAAW,EAAE,YAAY,MAAM,WAAW,IAAI,CAAC;AAAA,UAC/E,GAAI,OAAO,MAAM,YAAY,YAAY,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,QACzE;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,gBAAgB;AACnB,cAAM,SACJ,MAAM,WAAW,WACb,WACA,MAAM,WAAW,YACf,YACA,MAAM,WAAW,UACf,UACA;AACV,cAAM,KAAwB,EAAE,GAAG,MAAM,OAAO;AAChD,eAAO;AAAA,MACT;AAAA,MACA,KAAK,iBAAiB;AAGpB,cAAM,KAAyB;AAAA,UAC7B,GAAG;AAAA,UACH,GAAI,iBAAiB,MAAM,OAAO,IAAI,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,UACpE,GAAI,iBAAiB,MAAM,SAAS,IAChC,EAAE,WAAW,MAAM,UAAU,IAC7B,CAAC;AAAA,QACP;AACA,eAAO;AAAA,MACT;AAAA,MACA,KAAK,gBAAgB;AACnB,cAAM,KAAwB;AAAA,UAC5B,GAAG;AAAA,UACH,GAAI,iBAAiB,MAAM,OAAO,IAAI,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,UACpE,GAAI,iBAAiB,MAAM,SAAS,IAChC,EAAE,WAAW,MAAM,UAAU,IAC7B,CAAC;AAAA,UACL,GAAI,iBAAiB,MAAM,oBAAoB,IAC3C,EAAE,sBAAsB,MAAM,qBAAqB,IACnD,CAAC;AAAA,QACP;AACA,eAAO;AAAA,MACT;AAAA,MACA;AAGE,eAAO,EAAE,GAAG,MAAM,QAAQ,UAAU;AAAA,IACxC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,YAAY,QAAuB,UAAmC;AACpE,WAAO;AAAA,MACL,UAAU;AAAA,MACV,QAAQ,KAAK,UAAU,YAAY,EAAE,UAAU,QAAQ,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,aAAa,KAAK,kBAAkB,GAAG;AAC7C,UAAM,YAAY,KAAK,UAAU,GAAG;AACpC,UAAM,KAAK,IAAI,UAAU;AACzB,UAAM,WAAW,IAAI,UAAU,WAAW,SAAS;AACnD,UAAM,YAAY,QAAQ,IAAI,UAAU,MAAM;AAE9C,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,UAAU,IACjB,EAAE,QAAQ,MAAM,QAAQ,WAAW,IACnC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,UAAU,GAAG;AAAA,MAC7D;AAAA,MACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOE,MAAM,GAAG,KAAK,IAAI,iEAAiE,EAAE;AAAA,QACrF,OAAO,MAAM;AAIX,cAAI,CAAC,aAAa,CAAC,UAAU;AAC3B,mBAAO,EAAE,QAAQ,MAAM,QAAQ,kCAAkC;AAAA,UACnE;AACA,gBAAM,MAAM,KAAK,SAAkC,UAAU;AAC7D,cAAI,CAAC,IAAK,QAAO,EAAE,QAAQ,QAAQ,QAAQ,eAAe,UAAU,GAAG;AAEvE,gBAAM,YAAY,KAAK,eAAe,KAAK,EAAE,KAAK,KAAK,YAAY,KAAK,SAAS;AACjF,gBAAM,QAAQ,KAAK,aAAa,KAAK,EAAE;AAIvC,cAAI,CAAC,WAAW;AACd,mBAAO,aAAa,CAAC,WACjB,EAAE,QAAQ,MAAM,QAAQ,uCAAuC,IAC/D;AAAA,cACE,QAAQ;AAAA,cACR,QAAQ,GAAG,EAAE,mBAAmB,WAAW,IAAI,mBAAmB,MAAM,WAAW,IAAI,gBAAgB,IAAI,sBAAsB;AAAA,YACnI;AAAA,UACN;AAEA,cAAI,aAAa,OAAO;AACtB,mBAAO;AAAA,cACL,QAAQ;AAAA,cACR,QAAQ,GAAG,WAAW,IAAI,mBAAmB,IAAI,EAAE,IAAI,WAAW,IAAI,gBAAgB,IAAI,sBAAsB,MAAM,YAAY,IAAI,eAAe,IAAI,EAAE;AAAA,YAC7J;AAAA,UACF;AACA,cAAI,aAAa,CAAC,OAAO;AACvB,mBAAO;AAAA,cACL,QAAQ;AAAA,cACR,QAAQ,WAAW,WAAW,IAAI,mBAAmB,IAAI,gBAAgB,IAAI,sBAAsB,sBAAsB,YAAY,IAAI,eAAe;AAAA,YAC1J;AAAA,UACF;AACA,cAAI,CAAC,aAAa,OAAO;AACvB,mBAAO;AAAA,cACL,QAAQ;AAAA,cACR,QAAQ,MAAM,YAAY,IAAI,eAAe,4BAA4B,WAAW,IAAI,mBAAmB,OAAO,gBAAgB,IAAI,sBAAsB;AAAA,YAC9J;AAAA,UACF;AACA,iBAAO;AAAA,YACL,QAAQ;AAAA,YACR,QAAQ,eAAe,WAAW,IAAI,mBAAmB,IAAI,gBAAgB,IAAI,sBAAsB,gBAAgB,YAAY,IAAI,eAAe;AAAA,UACxJ;AAAA,QACF;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,CAAC,SAAU,QAAO,EAAE,QAAQ,MAAM,QAAQ,oBAAoB;AAClE,iBAAO,WAAW,UAAU,IACxB,EAAE,QAAQ,MAAM,QAAQ,WAAW,IACnC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,UAAU,GAAG;AAAA,QAC3D;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGQ,eAAe,KAA8B,IAAqB;AACxE,UAAM,UAAU,IAAI,WAAW;AAC/B,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,EAAG,QAAO;AAC9E,UAAM,UAAW,QAAoC,mBAAmB;AACxE,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,EAAG,QAAO;AAC9E,UAAM,QAAS,QAAoC,EAAE;AACrD,QAAI,UAAU,OAAW,QAAO;AAEhC,WAAO,EACL,SACA,OAAO,UAAU,YAChB,MAAkC,YAAY;AAAA,EAEnD;AAAA;AAAA,EAGQ,YAAY,KAA8B,WAA4B;AAC5E,UAAM,UAAU,IAAI,WAAW;AAC/B,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,EAAG,QAAO;AAC9E,UAAM,OAAQ,QAAoC,gBAAgB;AAClE,QAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,EAAG,QAAO;AACrE,UAAM,QAAS,KAAiC,sBAAsB;AACtE,WAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,SAAS;AAAA,EACzD;AAAA;AAAA,EAGQ,aAAa,KAA8B,IAAqB;AACtE,UAAM,MAAM,IAAI,YAAY;AAC5B,QAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,EAAG,QAAO;AAClE,UAAM,UAAW,IAAgC,eAAe;AAChE,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,EAAG,QAAO;AAC9E,WAAO,MAAO;AAAA,EAChB;AAAA;AAAA,EAGQ,SAAS,MAAkC;AACjD,QAAI;AACF,aAAO,aAAa,MAAM,MAAM;AAAA,IAClC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAQA,SAAS,0BAA0B,MAAyB,QAAQ,KAAa;AAC/E,MAAI,IAAI,qBAAsB,QAAO,QAAQ,IAAI,oBAAoB;AACrE,QAAM,WAAW,IAAI,qBACjB,QAAQ,IAAI,kBAAkB,IAC9B,QAAQ,QAAQ,GAAG,WAAW;AAClC,SAAO,QAAQ,UAAU,eAAe;AAC1C;AAGA,SAAS,UAAU,KAAmB;AACpC,MAAI,CAAC,WAAW,GAAG,EAAG,WAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAC1D;AAGA,SAAS,iBAAiB,OAAiC;AACzD,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEO,IAAM,UAAU,IAAI,gBAAgB;AAC3C,IAAO,mBAAQ;","names":["entry"]}

package/dist/{opencode-FZ33JKUZ.js → opencode-NZBRLJN3.js}

@@ -4,12 +4,13 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-TIIP3RG2.js";
+} from "./chunk-PD4VFEBY.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
 } from "./chunk-MEH7GC7R.js";
+import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
 // src/adapters/opencode/index.ts
@@ -38,6 +39,10 @@ var OpenCodeAdapter = class extends BaseAdapter {
   name = "OpenCode";
   paradigm = "ts-plugin";
   capabilities = {
+    // Memory surface: AGENTS.md-first managed block. memoryTargets below probes
+    // project scope (CLAUDE.md is opencode's fallback ONLY when AGENTS.md is
+    // absent — creating AGENTS.md beside it would shadow the user's rules).
+    supportsMemory: true,
     preToolUse: true,
     postToolUse: true,
     // OpenCode's compaction hook is experimental and not wired here.
@@ -47,6 +52,14 @@ var OpenCodeAdapter = class extends BaseAdapter {
     userPromptSubmit: false,
     stop: false,
     notification: false,
+    // Newer events: OpenCode HAS a decision-capable `permission.ask` plugin
+    // hook upstream, but it is NOT wired here (E1 keeps this adapter
+    // degrade-only); subagents run as child sessions (bus events only — no
+    // dedicated lifecycle hook) and tool failure is merged into
+    // tool.execute.after / session.error. permissionRequest /
+    // postToolUseFailure / subagentStart / subagentStop stay unset — the
+    // generated bridge never references them and install reports them as
+    // "unsupported here".
     // tool.execute.before mutates output.args → input rewrite supported.
     canModifyArgs: true,
     // tool.execute.after mutates output.output → output rewrite supported.
@@ -81,6 +94,32 @@ var OpenCodeAdapter = class extends BaseAdapter {
       confidence: installed ? "high" : "low"
     };
   }
+  // ── Memory surface: AGENTS.md / CLAUDE.md-fallback probe (project) ──────
+  // OpenCode reads project AGENTS.md, falling back to CLAUDE.md ONLY when no
+  // AGENTS.md exists. If the user relies on that CLAUDE.md fallback, CREATING
+  // AGENTS.md beside it would shadow their own rules — so the block goes into
+  // the file opencode actually reads today; AGENTS.md is created only when
+  // neither exists. User scope (~/.config/opencode/AGENTS.md) stays on the
+  // BaseAdapter default.
+  memoryTargets(ctx) {
+    if (this.memoryOverride(ctx)?.path || ctx.scope !== "project") {
+      return super.memoryTargets(ctx);
+    }
+    const agentsMd = join(ctx.projectDir, "AGENTS.md");
+    if (existsSync(agentsMd)) {
+      return [{ path: agentsMd, reason: "AGENTS.md (opencode's primary project rules file)" }];
+    }
+    const claudeMd = join(ctx.projectDir, "CLAUDE.md");
+    if (existsSync(claudeMd)) {
+      return [
+        {
+          path: claudeMd,
+          reason: "CLAUDE.md (opencode's fallback rules file \u2014 creating AGENTS.md would shadow it)"
+        }
+      ];
+    }
+    return [{ path: agentsMd, reason: "AGENTS.md standard (created; no opencode rules file yet)" }];
+  }
   // ── Native paths ───────────────────────────────────────────────────────
   getConfigDir(ctx) {
     return ctx.scope === "project" ? ctx.projectDir : join(homedir(), ".config", "opencode");
@@ -287,21 +326,28 @@ var OpenCodeAdapter = class extends BaseAdapter {
   // agent}. No runtime dispatch, no home-bin pointer, no telemetry wrap. Each
   // method is idempotent (byte-identical → skip) via BaseAdapter.writeContentFile
   // and reversible via removeContentFile. Honors platforms["opencode"]
-  // per-surface false to skip. <ocDir> is reused from getConfigDir (user
-  // ~/.config/opencode, project <projectDir>/.opencode).
+  // per-surface false to skip.
+  //
+  // <ocDir> is NOT getConfigDir for project scope: opencode.json lives at the
+  // project ROOT, but content surfaces are read from <projectDir>/.opencode/
+  // (e.g. .opencode/skills/<name>/SKILL.md per opencode.ai/docs/skills) — the
+  // 0.1.0 adapter wrote <projectDir>/skills, which OpenCode never reads.
   //
   // NOTE on dirs: commands live in commands/<name>.md and skills in
   // skills/<name>/SKILL.md, but subagents use the SINGULAR "agent/" dir
   // (agent/<name>.md) — the OpenCode loader/CLI historically uses singular
   // (anomalyco/opencode#14410); singular is the safe choice.
+  contentRootDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".opencode") : this.getConfigDir(ctx);
+  }
   commandsDir(ctx) {
-    return join(this.getConfigDir(ctx), "commands");
+    return join(this.contentRootDir(ctx), "commands");
   }
   skillsDir(ctx) {
-    return join(this.getConfigDir(ctx), "skills");
+    return join(this.contentRootDir(ctx), "skills");
   }
   agentDir(ctx) {
-    return join(this.getConfigDir(ctx), "agent");
+    return join(this.contentRootDir(ctx), "agent");
   }
   /** Native command file path: <ocDir>/commands/<name>.md. */
   commandPath(ctx, name) {
@@ -731,4 +777,4 @@ export {
   adapter,
   opencode_default as default
 };
-//# sourceMappingURL=opencode-FZ33JKUZ.js.map
+//# sourceMappingURL=opencode-NZBRLJN3.js.map