@ken-jo/agent-connector 0.1.0

package/dist/openclaw-ETN2M63O.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 *   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 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  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} 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};\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}\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    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    // 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  // ── 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 (PreToolUse|PostToolUse|SessionStart)\\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(\"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      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          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\nexport const adapter = new OpenClawAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/openclaw-IYA7ASL6.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import {
+  fileMtimeMs,
+  readJsonlLines
+} from "./chunk-RK6VBLXP.js";
+import {
+  expandHome,
+  walkFiles
+} from "./chunk-JWNT5KW7.js";
+import {
+  emptyTokens
+} from "./chunk-XD7MY6HB.js";
+
+// src/usage/readers/openclaw.ts
+import { basename, isAbsolute, join, resolve } from "path";
+import { homedir } from "os";
+var PLATFORM_ID = "openclaw";
+var DEFAULT_PROVIDER = "unknown";
+function toNonNegInt(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  if (!Number.isFinite(n)) return 0;
+  return Math.max(0, Math.trunc(n));
+}
+function toNonNegFloat(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  if (!Number.isFinite(n)) return void 0;
+  return Math.max(0, n);
+}
+function nonEmptyString(v) {
+  if (typeof v !== "string") return void 0;
+  return v === "" ? void 0 : v;
+}
+function parseTs(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  if (!Number.isFinite(n) || n <= 0) return null;
+  return n >= 1e12 ? n : n * 1e3;
+}
+function sessionIdFromFilename(path) {
+  const name = basename(path);
+  const idx = name.indexOf(".jsonl");
+  if (idx < 0) return null;
+  const id = name.slice(0, idx);
+  return id === "" ? null : id;
+}
+function parseOpenclawTranscript(path) {
+  const sessionId = sessionIdFromFilename(path);
+  if (sessionId === null) return [];
+  const lines = readJsonlLines(path);
+  if (lines.length === 0) return [];
+  const mtime = fileMtimeMs(path);
+  const out = [];
+  let currentModel;
+  let currentProvider;
+  let ordinal = 0;
+  for (const raw of lines) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const entry = raw;
+    const type = entry.type;
+    if (type === "model_change") {
+      const model2 = nonEmptyString(entry.modelId);
+      if (model2 !== void 0) currentModel = model2;
+      const provider2 = nonEmptyString(entry.provider);
+      if (provider2 !== void 0) currentProvider = provider2;
+      continue;
+    }
+    if (type === "custom") {
+      if (entry.customType !== "model-snapshot") continue;
+      const data = entry.data;
+      if (data !== void 0 && data !== null) {
+        const model2 = nonEmptyString(data.modelId);
+        if (model2 !== void 0) currentModel = model2;
+        const provider2 = nonEmptyString(data.provider);
+        if (provider2 !== void 0) currentProvider = provider2;
+      }
+      continue;
+    }
+    if (type !== "message") continue;
+    const msg = entry.message;
+    if (msg === void 0 || msg === null) continue;
+    if (msg.role !== "assistant") continue;
+    const usage = msg.usage;
+    if (usage === void 0 || usage === null) continue;
+    const model = nonEmptyString(msg.model) ?? currentModel;
+    if (model === void 0) continue;
+    const provider = nonEmptyString(msg.provider) ?? currentProvider ?? DEFAULT_PROVIDER;
+    currentModel = model;
+    currentProvider = provider;
+    const ts = parseTs(msg.timestamp) ?? mtime;
+    const tokens = emptyTokens();
+    tokens.input = toNonNegInt(usage.input);
+    tokens.output = toNonNegInt(usage.output);
+    tokens.cacheRead = toNonNegInt(usage.cacheRead);
+    tokens.cacheWrite = toNonNegInt(usage.cacheWrite);
+    ordinal += 1;
+    const entryId = nonEmptyString(entry.id);
+    const dedupKey = `openclaw:${sessionId}:${entryId ?? `#${ordinal}`}`;
+    const record = {
+      platformId: PLATFORM_ID,
+      modelId: model,
+      providerId: provider,
+      sessionId,
+      tokens,
+      ts,
+      messageCount: 1,
+      dedupKey,
+      confidence: "host-reported"
+    };
+    const cost = toNonNegFloat(usage.cost?.total);
+    if (cost !== void 0 && cost > 0) record.cost = cost;
+    out.push(record);
+  }
+  return out;
+}
+function openclawRoots() {
+  const out = [];
+  const override = process.env.AGENT_CONNECTOR_OPENCLAW_DIR;
+  if (override != null && override.trim() !== "") {
+    const expanded = expandHome(override.trim());
+    out.push(isAbsolute(expanded) ? expanded : resolve(expanded));
+  }
+  const home = homedir();
+  out.push(join(home, ".openclaw", "agents"));
+  out.push(join(home, ".clawdbot", "agents"));
+  out.push(join(home, ".moltbot", "agents"));
+  out.push(join(home, ".moldbot", "agents"));
+  return out;
+}
+var openclawReader = {
+  platformId: PLATFORM_ID,
+  kind: "local",
+  async read({ sinceMs }) {
+    const records = [];
+    for (const root of openclawRoots()) {
+      const files = walkFiles(root, (name) => name.includes(".jsonl"));
+      for (const file of files) {
+        const rows = parseOpenclawTranscript(file);
+        for (const row of rows) {
+          if (sinceMs !== void 0 && row.ts < sinceMs) continue;
+          records.push(row);
+        }
+      }
+    }
+    return records;
+  }
+};
+var openclaw_default = openclawReader;
+export {
+  openclaw_default as default
+};
+//# sourceMappingURL=openclaw-IYA7ASL6.js.map

package/dist/openclaw-IYA7ASL6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usage/readers/openclaw.ts"],"sourcesContent":["/**\n * usage/readers/openclaw — OpenClaw (Gateway) native transcript reader.\n *\n * Faithful port of tokscale sessions/openclaw.rs (the transcript-direct path).\n * OpenClaw stores one JSONL transcript per session under an agent directory:\n *   ~/.openclaw/agents/**\\/*.jsonl   (current)\n *   ~/.clawdbot/agents/**\\/*.jsonl   (legacy: Clawd → Moltbot → OpenClaw rebrand)\n *   ~/.moltbot/agents/**\\/*.jsonl    (legacy)\n *   ~/.moldbot/agents/**\\/*.jsonl    (legacy)\n * The glob is `*.jsonl*` in tokscale (clients.rs OpenClaw.pattern), so archived\n * copies are also picked up: `name.jsonl`, `name.jsonl.deleted.<ts>`, and\n * `name.jsonl.reset.<ISO8601>`. The session id is the filename stem before the\n * first `.jsonl`, so all three forms map to the same session id.\n *\n * Each line is one entry with a `type`:\n *   - \"model_change\"  → snapshot of the current model/provider (entry.modelId /\n *                       entry.provider). STATEFUL: applies to later messages.\n *   - \"custom\" + customType==\"model-snapshot\" → same, from entry.data.{modelId,\n *                       provider}. STATEFUL.\n *   - \"message\"       → only `role:\"assistant\"` lines with a `usage` block count.\n *                       Tokens come straight from message.usage.{input, output,\n *                       cacheRead, cacheWrite}; cost from usage.cost.total.\n *                       Model/provider prefer the inline message.{model,provider}\n *                       (when non-empty), else fall back to the tracked current\n *                       model/provider state; provider defaults to \"unknown\".\n * reasoning is always 0 (OpenClaw does not report it).\n *\n * DEDUP — this is where double-counting hides. tokscale's PRODUCTION scan parses\n * ONLY the transcripts via parse_openclaw_transcript (one `*.jsonl*` file at a\n * time, each scan root visited once). The legacy `sessions.json` index parser\n * (parse_openclaw_index) is NOT wired into the live scan — it points at the SAME\n * `.jsonl` files the walk already visits, so parsing both would double-count.\n * We therefore mirror production: walk transcripts only, never the index. The\n * per-record dedupKey (`openclaw:<sessionId>:<entry.id|ordinal>`) collapses the\n * same transcript line if it is ever seen twice (e.g. a `.jsonl` plus its\n * `.deleted`/`.reset` archive of the same session), keeping totals honest while\n * never merging genuinely distinct messages.\n *\n * Project/workspace attribution: not exposed in the OpenClaw transcript format,\n * so projectKey/projectLabel are left unset (matching the Rust parser, which\n * never sets workspace on these rows).\n *\n * Confidence: \"host-reported\" (real token counts logged by the host).\n *\n * Fail-open: no agent root present → []; an unreadable/malformed file or line is\n * skipped (never thrown). Read-only — this reader only enumerates and reads.\n */\n\nimport { basename, isAbsolute, join, resolve } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nimport type { UsageReader, UsageRecord } from \"../types.js\";\nimport { emptyTokens } from \"../aggregate.js\";\nimport { fileMtimeMs, readJsonlLines } from \"../jsonl.js\";\nimport { expandHome, walkFiles } from \"../paths.js\";\n\nconst PLATFORM_ID = \"openclaw\" as const;\nconst DEFAULT_PROVIDER = \"unknown\";\n\n/** One OpenClaw JSONL entry (every field optional / unknown). */\ninterface OpenClawEntry {\n  type?: unknown;\n  /** Stable per-entry id (e.g. \"msg1\") — used for the dedup key when present. */\n  id?: unknown;\n  message?: OpenClawMessage;\n  /** \"custom\" entry discriminator (e.g. \"model-snapshot\"). */\n  customType?: unknown;\n  /** Payload for a \"custom\" model-snapshot entry. */\n  data?: { provider?: unknown; modelId?: unknown };\n  /** Set on a \"model_change\" entry. */\n  modelId?: unknown;\n  provider?: unknown;\n}\n\n/** The `message` object on a \"message\" entry. */\ninterface OpenClawMessage {\n  role?: unknown;\n  usage?: OpenClawUsage;\n  timestamp?: unknown;\n  provider?: unknown;\n  model?: unknown;\n}\n\n/** The `message.usage` token/cost block. */\ninterface OpenClawUsage {\n  input?: unknown;\n  output?: unknown;\n  cacheRead?: unknown;\n  cacheWrite?: unknown;\n  cost?: { total?: unknown };\n}\n\n/** Coerce an unknown to a non-negative integer (0 on absence/garbage). */\nfunction toNonNegInt(v: unknown): number {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" ? Number(v) : NaN;\n  if (!Number.isFinite(n)) return 0;\n  return Math.max(0, Math.trunc(n));\n}\n\n/** Coerce an unknown to a finite non-negative number, else undefined. */\nfunction toNonNegFloat(v: unknown): number | undefined {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" ? Number(v) : NaN;\n  if (!Number.isFinite(n)) return undefined;\n  return Math.max(0, n);\n}\n\n/** A non-empty trimmed string, or undefined. */\nfunction nonEmptyString(v: unknown): string | undefined {\n  if (typeof v !== \"string\") return undefined;\n  return v === \"\" ? undefined : v;\n}\n\n/**\n * Parse the OpenClaw `timestamp` (i64 milliseconds) to epoch ms, or null when\n * unusable. The Rust parser treats it as raw millis; we accept a numeric string\n * too and tolerate a seconds-scale value defensively.\n */\nfunction parseTs(v: unknown): number | null {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" ? Number(v) : NaN;\n  if (!Number.isFinite(n) || n <= 0) return null;\n  return n >= 1e12 ? n : n * 1000;\n}\n\n/**\n * Session id = the filename stem before the FIRST `.jsonl` (port of\n * parse_openclaw_transcript's `split_once(\".jsonl\")`). Handles archived suffixes:\n *   \"abc.jsonl\"                              → \"abc\"\n *   \"abc.jsonl.deleted.1700000000000\"        → \"abc\"\n *   \"abc.jsonl.reset.2026-03-20T06-34-44.520Z\" → \"abc\"\n * Returns null when there is no `.jsonl` segment or the stem is empty.\n */\nfunction sessionIdFromFilename(path: string): string | null {\n  const name = basename(path);\n  const idx = name.indexOf(\".jsonl\");\n  if (idx < 0) return null;\n  const id = name.slice(0, idx);\n  return id === \"\" ? null : id;\n}\n\n/**\n * Parse one OpenClaw transcript into usage records (port of\n * parse_openclaw_session). Tracks current model/provider statefully across the\n * file and emits one record per assistant message that carries a usage block.\n */\nfunction parseOpenclawTranscript(path: string): UsageRecord[] {\n  const sessionId = sessionIdFromFilename(path);\n  if (sessionId === null) return [];\n\n  const lines = readJsonlLines(path);\n  if (lines.length === 0) return [];\n\n  const mtime = fileMtimeMs(path);\n  const out: UsageRecord[] = [];\n\n  let currentModel: string | undefined;\n  let currentProvider: string | undefined;\n  let ordinal = 0; // fallback per-message identity when entry.id is absent\n\n  for (const raw of lines) {\n    if (typeof raw !== \"object\" || raw === null) continue;\n    const entry = raw as OpenClawEntry;\n    const type = entry.type;\n\n    if (type === \"model_change\") {\n      const model = nonEmptyString(entry.modelId);\n      if (model !== undefined) currentModel = model;\n      const provider = nonEmptyString(entry.provider);\n      if (provider !== undefined) currentProvider = provider;\n      continue;\n    }\n\n    if (type === \"custom\") {\n      if (entry.customType !== \"model-snapshot\") continue;\n      const data = entry.data;\n      if (data !== undefined && data !== null) {\n        const model = nonEmptyString(data.modelId);\n        if (model !== undefined) currentModel = model;\n        const provider = nonEmptyString(data.provider);\n        if (provider !== undefined) currentProvider = provider;\n      }\n      continue;\n    }\n\n    if (type !== \"message\") continue;\n\n    const msg = entry.message;\n    if (msg === undefined || msg === null) continue;\n    if (msg.role !== \"assistant\") continue;\n\n    const usage = msg.usage;\n    if (usage === undefined || usage === null) continue;\n\n    // Model: inline message.model (non-empty) → tracked current model.\n    // No model anywhere → skip (port: `None => continue`).\n    const model = nonEmptyString(msg.model) ?? currentModel;\n    if (model === undefined) continue;\n\n    // Provider: inline message.provider (non-empty) → tracked current provider →\n    // \"unknown\" fallback (port of the unwrap_or(\"unknown\")).\n    const provider = nonEmptyString(msg.provider) ?? currentProvider ?? DEFAULT_PROVIDER;\n\n    // The parser persists the resolved model/provider as the new state.\n    currentModel = model;\n    currentProvider = provider;\n\n    const ts = parseTs(msg.timestamp) ?? mtime;\n\n    const tokens = emptyTokens();\n    tokens.input = toNonNegInt(usage.input);\n    tokens.output = toNonNegInt(usage.output);\n    tokens.cacheRead = toNonNegInt(usage.cacheRead);\n    tokens.cacheWrite = toNonNegInt(usage.cacheWrite);\n    // reasoning stays 0 (OpenClaw does not report it).\n\n    ordinal += 1;\n    const entryId = nonEmptyString(entry.id);\n    const dedupKey = `openclaw:${sessionId}:${entryId ?? `#${ordinal}`}`;\n\n    const record: UsageRecord = {\n      platformId: PLATFORM_ID,\n      modelId: model,\n      providerId: provider,\n      sessionId,\n      tokens,\n      ts,\n      messageCount: 1,\n      dedupKey,\n      confidence: \"host-reported\",\n    };\n\n    // NOTE: provider is stored verbatim (host value or \"unknown\"); the Rust\n    // parser never applies model-based provider inference here, so we do not\n    // either — provider grouping happens at aggregation time in the infra.\n    const cost = toNonNegFloat(usage.cost?.total);\n    if (cost !== undefined && cost > 0) record.cost = cost;\n\n    out.push(record);\n  }\n\n  return out;\n}\n\n/**\n * Candidate OpenClaw agent roots, most-preferred first. paths.ts has no\n * `openclaw` case (the framework's hostRoots table only covers the simpler\n * single-root platforms), so the agent dirs are resolved here directly, mirroring\n * tokscale scanner.rs: the current `~/.openclaw/agents` plus the legacy rebrand\n * dirs. An AGENT_CONNECTOR_OPENCLAW_DIR override (non-empty) is honored first.\n */\nfunction openclawRoots(): string[] {\n  const out: string[] = [];\n  const override = process.env.AGENT_CONNECTOR_OPENCLAW_DIR;\n  if (override != null && override.trim() !== \"\") {\n    const expanded = expandHome(override.trim());\n    out.push(isAbsolute(expanded) ? expanded : resolve(expanded));\n  }\n  const home = homedir();\n  out.push(join(home, \".openclaw\", \"agents\"));\n  out.push(join(home, \".clawdbot\", \"agents\"));\n  out.push(join(home, \".moltbot\", \"agents\"));\n  out.push(join(home, \".moldbot\", \"agents\"));\n  return out;\n}\n\n/** The OpenClaw transcript usage reader singleton. */\nconst openclawReader: UsageReader = {\n  platformId: PLATFORM_ID,\n  kind: \"local\",\n  async read({ sinceMs }: { sinceMs?: number }): Promise<UsageRecord[]> {\n    const records: UsageRecord[] = [];\n\n    // Walk every agent root (current + legacy). walkFiles is fail-open: a\n    // non-existent root yields []. If NO root exists, this stays empty → [].\n    for (const root of openclawRoots()) {\n      // Glob `*.jsonl*`: `.jsonl`, `.jsonl.deleted.<ts>`, `.jsonl.reset.<ISO>`.\n      const files = walkFiles(root, (name) => name.includes(\".jsonl\"));\n      for (const file of files) {\n        const rows = parseOpenclawTranscript(file);\n        for (const row of rows) {\n          if (sinceMs !== undefined && row.ts < sinceMs) continue;\n          records.push(row);\n        }\n      }\n    }\n\n    return records;\n  },\n};\n\nexport default openclawReader;\n"],"mappings":"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","names":["model","provider"]}