@ken-jo/agent-connector 0.6.3 → 0.6.5

package/dist/chunk-BB4DFAHC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/codex/index.ts"],"sourcesContent":["/**\n * adapters/codex — Codex CLI platform adapter for agent-connector.\n *\n * Codex CLI hook paradigm is \"json-stdio\": the host pipes a JSON payload to a\n * command on stdin and reads JSON/exit-code back — the same wire protocol as\n * Claude Code (PascalCase fields, `hookSpecificOutput` reply wrapper).\n *\n * Two native config files live under the Codex config dir\n * (`$CODEX_HOME` || `~/.codex`, mirrored to `<projectDir>/.codex` for project\n * scope):\n *   - config.toml  → `[mcp_servers.<id>]` MCP registration (TOML, NO native\n *     interpolation, so env-refs are resolved to literals at install time).\n *   - hooks.json   → Claude-compatible hook registration ({ matcher, hooks }).\n *\n * Grounded in context-mode's proven Codex adapter (configs/codex/{config.toml,\n * hooks.json}, src/adapters/codex/*) — exact TOML MCP shape + hook JSON schema.\n *\n * Codex capabilities (upstream, verified against openai/codex source at the\n * stable release tags noted):\n *   - PreToolUse `updatedInput` rewrite IS honored (PR #20527, commit d08906a9,\n *     stable since codex 0.131.0; applied in the shell/mcp/apply_patch tool\n *     handlers, confirmed present through 0.141.0) — hence canModifyArgs is now\n *     TRUE. Codex's output_parser.rs requires the rewrite to be paired with\n *     `permissionDecision:\"allow\"` (an allow WITHOUT updatedInput, and an\n *     updatedInput WITHOUT allow, are both rejected as invalid), so \"modify\"\n *     emits the allow+updatedInput envelope together. The still-open tracking\n *     issue openai/codex#18491 is now scoped to a NARROWER gap — read_file/grep\n *     have no PreToolUse handler yet — not to updatedInput itself, which works\n *     for every tool that fires PreToolUse (shell/Bash, apply_patch, MCP).\n *   - PostToolUse `updatedMCPToolOutput` is still explicitly rejected as\n *     \"unsupported\" by output_parser.rs (no output-rewrite field on\n *     PostToolUseOutput at 0.141.0) — hence canModifyOutput stays FALSE.\n *\n * E1 extension events (verified against developers.openai.com/codex/hooks):\n *   - PermissionRequest — native, decision-capable via the nested\n *     hookSpecificOutput.decision{behavior:\"allow\"|\"deny\", message?} envelope.\n *     Codex docs: updatedInput / updatedPermissions / interrupt FAIL CLOSED on\n *     this event, so they are never emitted here.\n *   - SubagentStart — native; hookSpecificOutput.additionalContext is injected\n *     as developer context for the subagent (not blockable).\n *   - SubagentStop — native; the documented continuation shape is the TOP-LEVEL\n *     {\"decision\":\"block\",\"reason\"} (Stop semantics: keeps the subagent going).\n *   - PostToolUseFailure — NO Codex analog (PostToolUse only); declared hooks\n *     for it warn-skip at install and the capability flag stays unset.\n *   - PostCompact — native (Codex's hook system fires both PreCompact and\n *     PostCompact); observe-only, normalizing the `trigger` (manual|auto)\n *     exactly like PreCompact, with a passthrough formatReply.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\n\nimport TOML from \"@iarna/toml\";\n\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookEventName,\n  HookParadigm,\n  HookResponse,\n  PlatformCapabilities,\n  PlatformId,\n  ServerDef,\n  SkillDef,\n  SubagentDef,\n} from \"../../core/types.js\";\nimport { ensureDir } from \"../../core/paths.js\";\nimport { codexConfigHome } from \"../../core/host-paths.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  removeFromObjectMap,\n  upsertInObjectMap,\n  type ObjectMapCodec,\n} from \"../../core/object-map.js\";\nimport { writeTomlString } from \"../../core/toml.js\";\nimport {\n  buildHomeBinHookCommand,\n  buildWrappedStdio,\n} from \"../../core/spawn.js\";\nimport { renderCommandMd, renderSkillMd } from \"../claude-code/render.js\";\nimport { normalizeSessionSource } from \"../claude-code/wire.js\";\nimport { BaseAdapter, type HookMergeDescriptor } from \"../base.js\";\nimport type {\n  HookReply,\n  InstallContext,\n  MemoryTarget,\n  NormalizedEvent,\n} from \"../spi.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Native shapes\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Raw Codex hook payload (PascalCase event, snake_case fields — Claude-style). */\ninterface CodexHookInput {\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  // PostToolUse only. The host serializes this as serde_json::Value (any JSON):\n  // a BARE STRING for shell/apply_patch (e.g. json!(\"shell output\")) but an\n  // OBJECT for MCP/structured tools (the serialized CallToolResult, e.g.\n  // json!({content,structuredContent,isError})) — NOT always a string. Typed\n  // `unknown` so PostToolUse coerces it for the string-typed toolOutput.\n  // Primary source: openai/codex codex-rs/hooks/src/schema.rs PostToolUseCommandInput\n  // `tool_response: Value` + core/src/tools/handlers/{mcp.rs object, shell_tests.rs string}.\n  tool_response?: unknown;\n  session_id?: string;\n  cwd?: string;\n  hook_event_name?: string;\n  source?: string;\n  prompt?: string;\n  // NO is_error: Codex's PostToolUseCommandInput struct (#[serde(deny_unknown_fields)])\n  // never serializes a top-level is_error — the error signal for MCP tools lives\n  // INSIDE tool_response as the CallToolResult `isError`. The field was removed;\n  // see derivePostToolUseIsError below. (openai/codex codex-rs/hooks/src/schema.rs:317-337)\n  stop_hook_active?: boolean;\n  trigger?: string;\n  message?: string;\n  // PostToolUseFailure-style failure field. Codex has NO failure event today;\n  // parsed defensively only (the Claude-compatible wire would carry it).\n  error?: string;\n  // SubagentStart / SubagentStop (agent_type is the matcher subject).\n  agent_id?: string;\n  agent_type?: string;\n  // SubagentStop only — the subagent's own transcript + final message.\n  agent_transcript_path?: string;\n  last_assistant_message?: string;\n}\n\n/** One hook entry inside hooks.json (Claude-compatible). */\nexport interface CodexHookEntry {\n  matcher?: string;\n  hooks: Array<{ type: \"command\"; command: string }>;\n}\n\n/** Rendered `[mcp_servers.<id>]` table — string env table, no interpolation. */\ninterface CodexMcpEntry {\n  // stdio transport\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  // streamable HTTP transport (remote): codex infers the transport from `url`\n  // (no explicit transport key). Verified against codex-cli 0.139.0.\n  url?: string;\n  bearer_token_env_var?: string;\n  http_headers?: Record<string, string>;\n}\n\n/**\n * Codex hook events agent-connector registers, in the canonical → native order.\n * Codex uses the same PascalCase event names as Claude Code; the home-binary\n * hook command receives the lowercased event token.\n */\nexport const CODEX_HOOK_EVENTS = [\n  \"SessionStart\",\n  \"PreToolUse\",\n  \"PostToolUse\",\n  \"PreCompact\",\n  \"UserPromptSubmit\",\n  \"Stop\",\n  \"PermissionRequest\",\n  \"SubagentStart\",\n  \"SubagentStop\",\n  \"PostCompact\",\n] as const;\n\nexport type CodexHookEventName = (typeof CODEX_HOOK_EVENTS)[number];\n\n/**\n * Newer E1 canonical events with NO Codex analog: Codex ships PostToolUse only —\n * there is no failure event on the live hooks page. Declared hooks for these\n * warn-skip (action `warn`, exit-1) — the established convention. The legacy\n * SessionEnd / Notification, which Codex also cannot fire, are reported as a\n * VISIBLE `skip` instead (exit-0 preserving) — see the hook descriptor's\n * `unmappedAction`. Nothing Codex cannot fire is ever silently dropped.\n */\nconst WARN_SKIP_EVENTS: ReadonlySet<HookEventName> = new Set([\"PostToolUseFailure\"]);\n\n/**\n * PreToolUse matcher — canonical Codex tool names + bare MCP tool names +\n * external MCP catch-all literal. Charset-clean ([A-Za-z0-9_|] only) so Codex's\n * Rust `regex` exact-matcher short-circuits (no look-around, which Codex\n * rejects at boot). Copied from context-mode's proven matcher.\n */\nconst PRE_TOOL_USE_MATCHER =\n  \"local_shell|shell|shell_command|exec_command|Bash|Shell|apply_patch|Edit|Write|grep_files|mcp__\";\n\n/**\n * Coerce Codex's PostToolUse `tool_response` (serde_json::Value — bare string\n * for shell/apply_patch, OBJECT for MCP/structured tools) to a string for the\n * string-typed `toolOutput`. A string passes through verbatim; everything else\n * (object/array/number/bool) is JSON-stringified; undefined/null → undefined\n * (leave `toolOutput` unset).\n *\n * Source: openai/codex codex-rs/hooks/src/schema.rs PostToolUseCommandInput\n * `tool_response: Value`; core/src/tools/handlers/shell_tests.rs emits\n * `json!(\"shell output\")` (string), mcp.rs emits `json!({...})` (object).\n */\nfunction coerceToolResponse(value: unknown): string | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value === \"string\") return value;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * Derive PostToolUse `isError`. Codex's PostToolUseCommandInput\n * (`#[serde(deny_unknown_fields)]`) has NO top-level is_error field, so the only\n * machine-readable error signal is the MCP CallToolResult `isError` nested in\n * the `tool_response` object (serialized camelCase by rmcp). For shell/\n * apply_patch tool_response is a bare string carrying no boolean, so we report\n * false. Returns false when no such signal exists (never invents one).\n *\n * Source: openai/codex codex-rs/hooks/src/schema.rs:317-337 (no is_error field);\n * codex-rs/core/src/tools/handlers/mcp.rs (tool_response = serialized\n * CallToolResult → `isError` when the MCP call failed).\n */\nfunction derivePostToolUseIsError(toolResponse: unknown): boolean {\n  if (toolResponse !== null && typeof toolResponse === \"object\") {\n    const flag = (toolResponse as Record<string, unknown>).isError;\n    if (typeof flag === \"boolean\") return flag;\n  }\n  return false;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Adapter\n// ─────────────────────────────────────────────────────────────────────────\n\nexport class CodexAdapter extends BaseAdapter {\n  readonly id: PlatformId = \"codex\";\n  readonly name: string = \"Codex CLI\";\n  readonly paradigm: HookParadigm = \"json-stdio\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block. memoryTargets below probes\n    // AGENTS.override.md first (it shadows AGENTS.md per directory on codex).\n    supportsMemory: true,\n    preToolUse: true,\n    postToolUse: true,\n    preCompact: true,\n    sessionStart: true,\n    sessionEnd: false,\n    userPromptSubmit: true,\n    stop: true,\n    notification: false,\n    // E1 events: PermissionRequest (decision-capable) + SubagentStart/Stop are\n    // Codex-native. postToolUseFailure stays unset — Codex has no failure event,\n    // so a declared hook for it warn-skips at install.\n    permissionRequest: true,\n    subagentStart: true,\n    subagentStop: true,\n    // PostCompact: Codex's hook system fires both PreCompact and PostCompact\n    // (developers.openai.com/codex/hooks). Observational only — the reply\n    // contract mirrors PreCompact (cannot block/modify a completed compaction).\n    postCompact: true,\n    // PreToolUse updatedInput rewrite is honored upstream (paired with\n    // permissionDecision:\"allow\"); PostToolUse output rewrite is not (see header).\n    canModifyArgs: true,\n    canModifyOutput: false,\n    canInjectSessionContext: true,\n    transports: [\"stdio\", \"http\"],\n    // Content surfaces: Codex implements all three.\n    //   command  → ~/.codex/prompts/<name>.md   (md+frontmatter, USER SCOPE ONLY)\n    //   skill    → project: .codex/skills/<name>/SKILL.md · user: ~/.agents/skills/<name>/SKILL.md\n    //   subagent → <codexDir>/agents/<name>.toml (TOML)\n    supportsCommands: true,\n    supportsSkills: true,\n    supportsSubagents: true,\n  };\n\n  // ── Detection ──────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = this.userConfigDir();\n    const projDir = join(projectDir, \".codex\");\n    const userCfg = join(userDir, \"config.toml\");\n    const projCfg = join(projDir, \"config.toml\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userCfg);\n    const projInstalled = existsSync(projDir) || existsSync(projCfg);\n    const installed = userInstalled || projInstalled;\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projCfg : userCfg;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `Found Codex config dir (${scope})`\n        : `No .codex config dir at ${userDir} or ${projDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ───────────────────────────────────────────────────────\n\n  override getConfigDir(ctx: InstallContext): string {\n    if (ctx.scope === \"project\") return join(ctx.projectDir, \".codex\");\n    return this.userConfigDir();\n  }\n\n  override getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"config.toml\");\n  }\n\n  override getHookConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"hooks.json\");\n  }\n\n  // ── Memory surface: AGENTS.override.md probe + 32 KiB doc-cap budget ─────\n  // Codex reads AGENTS.override.md > AGENTS.md per directory (one file per\n  // directory), so when the override file exists OUR block must live there or\n  // it is never loaded. Combined project docs are capped at 32 KiB\n  // (`project_doc_max_bytes`), hence the ~28 KiB per-file budget warn.\n  protected override memoryTargets(ctx: InstallContext): MemoryTarget[] {\n    // An explicit path override keeps the base resolution (escape hatch wins).\n    if (this.memoryOverride(ctx)?.path) return super.memoryTargets(ctx);\n    if (ctx.scope !== \"project\" && ctx.scope !== \"user\") return [];\n    const budgetBytes = 28 * 1024;\n    const dir = ctx.scope === \"project\" ? ctx.projectDir : this.userConfigDir();\n    const overrideMd = join(dir, \"AGENTS.override.md\");\n    if (existsSync(overrideMd)) {\n      return [\n        {\n          path: overrideMd,\n          reason: \"AGENTS.override.md shadows AGENTS.md on codex (one doc per directory)\",\n          budgetBytes,\n        },\n      ];\n    }\n    return [\n      {\n        path: join(dir, \"AGENTS.md\"),\n        reason:\n          ctx.scope === \"project\"\n            ? \"AGENTS.md standard (project root; codex is the format's originator)\"\n            : \"codex global guidance ($CODEX_HOME/AGENTS.md)\",\n        budgetBytes,\n      },\n    ];\n  }\n\n  /** `$CODEX_HOME` (tilde-expanded, then resolved) || `~/.codex` for user\n   *  scope. Shared with marketplace detection via `codexConfigHome` so the\n   *  config writer and the install probe never target different dirs. */\n  protected userConfigDir(): string {\n    return codexConfigHome();\n  }\n\n  // ── TOML config IO (override JSON helpers — config.toml is TOML) ─────────\n\n  protected readToml(path: string): Record<string, unknown> {\n    if (!existsSync(path)) return {};\n    try {\n      return TOML.parse(readFileSync(path, \"utf8\")) as Record<string, unknown>;\n    } catch {\n      return {};\n    }\n  }\n\n  protected writeToml(path: string, data: Record<string, unknown>, dryRun: boolean): void {\n    if (dryRun) return;\n    ensureDir(dirname(path));\n    // @iarna/toml's stringify type wants its JsonMap; our object is structurally compatible.\n    writeFileSync(path, TOML.stringify(data as never), \"utf8\");\n  }\n\n  /** An ObjectMapCodec over config.toml for the core/object-map engine.\n   * `isPresentButUnparseable` is `() => false`: readToml fail-softs to {} and the\n   * server path has historically coerced/overwritten rather than warn-skip on an\n   * unparseable file — preserved here for byte-identical behavior. */\n  protected tomlObjectMapCodec(): ObjectMapCodec {\n    return {\n      parse: (path) => this.readToml(path),\n      serialize: (path, data, dryRun) => this.writeToml(path, data, dryRun),\n      isPresentButUnparseable: () => false,\n    };\n  }\n\n  // ── Install server (config.toml → [mcp_servers.<id>]) ───────────────────\n\n  override installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector, dryRun } = ctx;\n    const server = this.effectiveServer(ctx);\n    const path = this.getServerConfigPath(ctx);\n\n    if (!server) {\n      return [{ platform: this.id, action: \"skip\", path, detail: \"no server declared\" }];\n    }\n    const isStdio = server.transport === \"stdio\" && !!server.command;\n    const isHttp = server.transport === \"http\" && !!server.url;\n    if (!isStdio && !isHttp) {\n      // Codex config.toml [mcp_servers] supports stdio (command) + streamable\n      // HTTP (url). Other remote transports (sse/ws) have no codex analog.\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path,\n          detail: `transport \"${server.transport}\" not registrable in config.toml (stdio + streamable-http only)`,\n        },\n      ];\n    }\n\n    const symlink = this.symlinkPathWarning(path);\n    if (symlink) return [symlink];\n\n    const entry = this.renderMcpEntry(ctx, server);\n\n    return [\n      upsertInObjectMap({\n        codec: this.tomlObjectMapCodec(),\n        rootKey: \"mcp_servers\",\n        policy: \"coerce\",\n        platform: this.id,\n        configPath: path,\n        entryId: connector.id,\n        entry,\n        dryRun,\n      }),\n    ];\n  }\n\n  override uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector, dryRun } = ctx;\n    const path = this.getServerConfigPath(ctx);\n    const symlink = this.symlinkPathWarning(path);\n    if (symlink) return [symlink];\n\n    return [\n      removeFromObjectMap({\n        codec: this.tomlObjectMapCodec(),\n        rootKey: \"mcp_servers\",\n        policy: \"coerce\",\n        platform: this.id,\n        configPath: path,\n        entryId: connector.id,\n        dryRun,\n      }),\n    ];\n  }\n\n  // ── Install hooks (hooks.json) ──────────────────────────────────────────\n\n  /**\n   * Host-native hook events this adapter registers. A Codex FORK that fires a\n   * superset (open-interpreter also fires SessionEnd) overrides this once; the\n   * install, descriptor and remove paths all read it.\n   */\n  protected get hookEventNames(): readonly string[] {\n    return CODEX_HOOK_EVENTS;\n  }\n\n  /** Host label used in unsupported-event warn details (\"<event> has no Codex hook equivalent\"). */\n  protected get hookHostLabel(): string {\n    return \"Codex\";\n  }\n\n  override installHooks(ctx: InstallContext): ChangeRecord[] {\n    const path = this.getHookConfigPath(ctx);\n    const hooksOff = ctx.connector.platforms[this.id]?.hooks === false;\n    const declared = hooksOff ? [] : ctx.connector.hookEvents;\n\n    if (declared.length === 0) {\n      return [{ platform: this.id, action: \"skip\", path, detail: \"no hooks declared\" }];\n    }\n\n    // HOST-ORDERED pending: the unsupported events (mapEvent → undefined →\n    // warn/skip via the descriptor) FIRST, then the supported events in\n    // CODEX_HOOK_EVENTS order. EVERY declared event is enqueued — an event with\n    // no Codex analog is reported VISIBLY (warn for the E1 newer events, a `skip`\n    // for the legacy SessionEnd/Notification whose drop predates the convention),\n    // never silently dropped. matcher is \"\" for every item; renderEntry derives\n    // the real matcher from the event (PreToolUse/PermissionRequest).\n    const supported = (e: HookEventName) => this.hookEventNames.includes(e);\n    const pending = [\n      ...declared.filter((e) => !supported(e)).map((event) => ({ event: event as string, matcher: \"\" })),\n      ...declared.filter(supported).map((event) => ({ event: event as string, matcher: \"\" })),\n    ];\n    return this.upsertHookEntries(ctx, path, pending, this.hookDescriptor(ctx));\n  }\n\n  override uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    return this.removeHookEntries(ctx, this.getHookConfigPath(ctx), this.hookDescriptor(ctx));\n  }\n\n  /**\n   * Codex hook-merge policy for the shared object-map engine. EVENT-SPECIFIC by\n   * construction: every observable (coerce root + bucket, the path-normalized\n   * per-event ownership find, the event-derived matcher with `hooks`-then-\n   * `matcher` key order, the BARE `hooks.<event>` skip/remove details with NO\n   * count, the warn wording, and the absent/no-match skips) is carried here so\n   * the engine reproduces the prior in-adapter loop byte-for-byte.\n   */\n  protected hookDescriptor(_ctx: InstallContext): HookMergeDescriptor<CodexHookEntry> {\n    return {\n      // Codex's server path coerces a malformed root; the hook path matches it.\n      malformedPolicy: \"coerce\",\n      // Supported event → identity; any other canonical event → undefined → the\n      // engine reports it (never silent), at the severity unmappedAction picks.\n      mapEvent: (e) => (this.hookEventNames.includes(e) ? e : undefined),\n      unmappedWarnDetail: (e) => `${e} has no ${this.hookHostLabel} hook equivalent — skipped`,\n      // E1 newer events (PostToolUseFailure) keep the established `warn` (exit-1);\n      // the legacy SessionEnd / Notification — silently dropped before this fix —\n      // become a VISIBLE `skip` so the install exit code is unchanged for them.\n      unmappedAction: (e) =>\n        WARN_SKIP_EVENTS.has(e as HookEventName) ? \"warn\" : \"skip\",\n      renderEntry: (event, _matcher, command) => {\n        const entry: CodexHookEntry = { hooks: [{ type: \"command\", command }] };\n        // KEY ORDER: hooks THEN matcher. Matcher is EVENT-derived, not from the\n        // connector's declared matcher: PermissionRequest matches tool names like\n        // PreToolUse (charset-clean), everything else registers \"\" (all).\n        entry.matcher =\n          event === \"PreToolUse\" || event === \"PermissionRequest\" ? PRE_TOOL_USE_MATCHER : \"\";\n        return entry;\n      },\n      // Idempotency find for the CANONICAL event the engine built `command` from —\n      // path-normalized, exact-command, the body of isOurEntry's command check.\n      entryOwnsCommand: (entry, command) =>\n        Array.isArray(entry.hooks) &&\n        entry.hooks.some(\n          (h) => (h.command ?? \"\").replace(/\\\\/g, \"/\") === command.replace(/\\\\/g, \"/\"),\n        ),\n      // FLAT whole-entry removal, EVENT-SPECIFIC: isOurEntry rebuilds our command\n      // from the event key being stripped, so a SubagentStop entry is never matched\n      // while iterating the PreToolUse bucket.\n      ownsEntryForRemove: (c, event) => (entry) =>\n        this.isOurEntry(c, event as CodexHookEventName, entry),\n      skipDetail: (e) => `hooks.${e}`,\n      removeDetail: (e, _n) => `hooks.${e}`,\n      absentDetail: \"no hooks.json\",\n      noMatchDetail: \"no agent-connector hooks present\",\n      // Uninstall scans EXACTLY codex's fixed event set (not Object.keys), so a\n      // home-bin command hand-placed under a foreign event key is left untouched —\n      // byte-identical to the prior `for (const event of CODEX_HOOK_EVENTS)` loop.\n      removeEventKeys: this.hookEventNames,\n    };\n  }\n\n  // ── Health checks (default doctor renders these) ────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const path = this.getServerConfigPath(ctx);\n    const id = ctx.connector.id;\n    const checks: HealthCheck[] = [\n      {\n        name: `${this.name}: config.toml exists`,\n        check: () =>\n          existsSync(path)\n            ? { status: \"OK\", detail: path }\n            : { status: \"FAIL\", detail: `not found: ${path}` },\n      },\n      {\n        name: `${this.name}: mcp_servers.${id} registered`,\n        check: () => {\n          // Only assert what the connector declares (same rule as the\n          // content-surface checks below): a server-less connector — e.g. a\n          // catalog-only bundle of agents/skills/commands — never writes an\n          // [mcp_servers.<id>] table, so its absence is healthy.\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readToml(path);\n          const bucket = cfg[\"mcp_servers\"];\n          const present =\n            typeof bucket === \"object\" &&\n            bucket !== null &&\n            id in (bucket as Record<string, unknown>);\n          return present\n            ? { status: \"OK\", detail: `mcp_servers.${id}` }\n            : { status: \"FAIL\", detail: `mcp_servers.${id} not found in ${path}` };\n        },\n      },\n    ];\n\n    // Content-surface checks: assert presence only for surfaces this connector\n    // declares. Codex commands are user-scope only, so a project-scope install\n    // won't have written them — only check command files in user scope.\n    if (ctx.scope !== \"project\") {\n      for (const cmd of ctx.connector.commands) {\n        const p = this.commandPath(cmd.name);\n        checks.push({\n          name: `${this.name}: command ${cmd.name} present`,\n          check: () =>\n            existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n        });\n      }\n    }\n    for (const skill of ctx.connector.skills) {\n      const p = join(this.skillDir(ctx, skill.name), \"SKILL.md\");\n      checks.push({\n        name: `${this.name}: skill ${skill.name} present`,\n        check: () =>\n          existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n      });\n    }\n    for (const agent of ctx.connector.subagents) {\n      const p = this.subagentPath(ctx, agent.name);\n      checks.push({\n        name: `${this.name}: subagent ${agent.name} present`,\n        check: () =>\n          existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n      });\n    }\n    return checks;\n  }\n\n  // ── Content surfaces: commands / skills / subagents ──────────────────────\n  // CONTENT-ONLY: pure native-file writers. No runtime dispatch, no home-bin\n  // pointer, no telemetry wrap. Each method is idempotent (byte-identical →\n  // skip) via writeContentFile and reversible via removeContentFile. Honors\n  // platforms[\"codex\"] per-surface false to skip.\n  //\n  // Native locations:\n  //   command  → ~/.codex/prompts/<name>.md   md+frontmatter(description,argument-hint)\n  //              USER SCOPE ONLY — project scope yields a single \"warn\".\n  //   skill    → project: <projectDir>/.codex/skills/<name>/SKILL.md (+ resources)\n  //              user:    ~/.agents/skills/<name>/SKILL.md (~/.codex/skills is deprecated)\n  //   subagent → <codexDir>/agents/<name>.toml  TOML via writeTomlString\n\n  /** Command files always live under the USER codex dir: ~/.codex/prompts. */\n  protected commandPath(name: string): string {\n    return join(this.userConfigDir(), \"prompts\", `${name}.md`);\n  }\n  protected skillDir(ctx: InstallContext, name: string): string {\n    // Project scope: <projectDir>/.codex/skills/<name> — the Project config-layer\n    // skills root (codex-rs/core-skills/src/loader.rs, ConfigLayerSource::Project),\n    // NOT deprecated. User scope: $HOME/.agents/skills/<name> — codex's CURRENT\n    // user skills root. The older $CODEX_HOME/skills (~/.codex/skills) is still\n    // read but the loader labels it a \"Deprecated user skills location, kept for\n    // backward compatibility\". .agents is anchored to the OS home (home_dir), NOT\n    // $CODEX_HOME — so use homedir() here, never userConfigDir() (which honors\n    // CODEX_HOME).\n    if (ctx.scope === \"project\") return join(this.getConfigDir(ctx), \"skills\", name);\n    return join(homedir(), \".agents\", \"skills\", name);\n  }\n  protected subagentPath(ctx: InstallContext, name: string): string {\n    return join(this.getConfigDir(ctx), \"agents\", `${name}.toml`);\n  }\n\n  // ── Commands (USER SCOPE ONLY) ───────────────────────────────────────────\n\n  override installCommands(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[this.id]?.commands === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"commands disabled for codex\" }];\n    }\n    if (ctx.scope === \"project\") {\n      return [{ platform: this.id, action: \"warn\", detail: \"codex commands are user-scope only\" }];\n    }\n    if (connector.commands.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no commands\" }];\n    }\n    return connector.commands.map((cmd) =>\n      this.writeContentFile(\n        this.commandPath(cmd.name),\n        renderCommandMd(cmd, { includeToolsAndModel: false }),\n        ctx.dryRun,\n      ),\n    );\n  }\n\n  override uninstallCommands(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (ctx.scope === \"project\") {\n      return [{ platform: this.id, action: \"warn\", detail: \"codex commands are user-scope only\" }];\n    }\n    if (connector.commands.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no commands\" }];\n    }\n    return connector.commands.map((cmd) =>\n      this.removeContentFile(this.commandPath(cmd.name), ctx.dryRun),\n    );\n  }\n\n  // ── Skills ───────────────────────────────────────────────────────────────\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[this.id]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for codex\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      const rendered = renderSkillMd(skill);\n      changes.push(this.writeContentFile(join(dir, \"SKILL.md\"), rendered, ctx.dryRun));\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n      // Migrate away an AC-owned copy at the deprecated user skills root so the\n      // skill is not double-registered after the move to ~/.agents/skills.\n      changes.push(...this.migrateDeprecatedUserSkill(ctx, skill, rendered));\n    }\n    return changes;\n  }\n\n  /**\n   * One-time, opt-out-safe migration: prior AC versions wrote user-scope skills\n   * to the now-deprecated $CODEX_HOME/skills/<name> root, which codex STILL reads\n   * (kept for backward compatibility). Once we write the same skill to the current\n   * ~/.agents/skills root, codex would register it TWICE (same frontmatter name,\n   * two User-scope roots). If a SKILL.md exists at the deprecated path AND is\n   * byte-identical to what we render — i.e. AC-owned, not hand-authored — remove\n   * it (and its now-empty dir). The content-equality guard guarantees we never\n   * delete a skill a user placed there by hand. No-op for project scope (where\n   * .codex/skills is the valid, non-deprecated Project config-layer path) and when\n   * a custom CODEX_HOME would make the deprecated path coincide with the new one.\n   */\n  protected migrateDeprecatedUserSkill(\n    ctx: InstallContext,\n    skill: SkillDef,\n    rendered: string,\n  ): ChangeRecord[] {\n    if (ctx.scope === \"project\") return [];\n    const deprecated = join(this.userConfigDir(), \"skills\", skill.name, \"SKILL.md\");\n    // Never touch the file we just wrote (pathological CODEX_HOME === ~/.agents).\n    if (deprecated === join(this.skillDir(ctx, skill.name), \"SKILL.md\")) return [];\n    if (!existsSync(deprecated)) return [];\n    if (readFileSync(deprecated, \"utf8\") !== rendered) return []; // hand-authored — leave it\n    return [\n      this.removeContentFile(deprecated, ctx.dryRun),\n      this.removeDirIfEmpty(dirname(deprecated), ctx.dryRun),\n    ];\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  // ── Subagents (TOML) ─────────────────────────────────────────────────────\n\n  override installSubagents(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[this.id]?.subagents === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"subagents disabled for codex\" }];\n    }\n    if (connector.subagents.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no subagents\" }];\n    }\n    return connector.subagents.map((agent) =>\n      this.writeContentFile(this.subagentPath(ctx, agent.name), this.renderSubagent(agent), ctx.dryRun),\n    );\n  }\n\n  override uninstallSubagents(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.subagents.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no subagents\" }];\n    }\n    return connector.subagents.map((agent) =>\n      this.removeContentFile(this.subagentPath(ctx, agent.name), ctx.dryRun),\n    );\n  }\n\n  /**\n   * Render a subagent to a Codex agent TOML file:\n   *   { name, description, developer_instructions: prompt, model }.\n   * model is omitted when undefined so Codex applies its default.\n   *\n   * Codex custom agent files are config layers, not a closed four-field\n   * manifest. The Codex manual documents required custom-agent keys, plus\n   * optional config keys such as nickname_candidates, model_reasoning_effort,\n   * sandbox_mode, mcp_servers, and skills.config. Keep `extra` as the\n   * author-controlled escape hatch for that native surface.\n   */\n  protected renderSubagent(agent: SubagentDef): string {\n    const table: Record<string, unknown> = {\n      name: agent.name,\n      description: agent.description,\n      developer_instructions: agent.prompt,\n    };\n    if (agent.model !== undefined) table.model = agent.model;\n    if (agent.extra) Object.assign(table, agent.extra);\n    return writeTomlString(table);\n  }\n\n  // ── Runtime dispatch ────────────────────────────────────────────────────\n\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as CodexHookInput;\n    const base = {\n      hostPlatform: this.id,\n      connectorId: \"\",\n      sessionId: input.session_id ?? `pid-${process.ppid}`,\n      projectDir: input.cwd ?? process.env.CODEX_PROJECT_DIR ?? process.cwd(),\n      raw,\n    };\n\n    switch (event) {\n      case \"PreToolUse\":\n        return {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n        };\n      case \"PostToolUse\":\n        return {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n          // tool_response is a bare string for shell/apply_patch but an OBJECT\n          // for MCP tools — coerce non-strings to JSON so the string-typed\n          // toolOutput never receives a raw object.\n          toolOutput: coerceToolResponse(input.tool_response),\n          // Codex never serializes a top-level is_error (deny_unknown_fields);\n          // the true error signal is the CallToolResult.isError nested inside\n          // tool_response for MCP tools. Derive it from there.\n          isError: derivePostToolUseIsError(input.tool_response),\n        };\n      case \"SessionStart\":\n        return { ...base, source: normalizeSessionSource(input.source) };\n      case \"SessionEnd\":\n        return { ...base, reason: input.message };\n      case \"UserPromptSubmit\":\n        return { ...base, prompt: input.prompt ?? \"\" };\n      case \"PreCompact\":\n        return { ...base, trigger: input.trigger === \"manual\" ? \"manual\" : \"auto\" };\n      case \"PostCompact\":\n        // Post-compaction sibling of PreCompact — same `trigger` normalization\n        // (manual|auto), observe-only. Codex's PostCompact payload mirrors\n        // PreCompact's; everything else rides on `raw`.\n        return { ...base, trigger: input.trigger === \"manual\" ? \"manual\" : \"auto\" };\n      case \"Stop\":\n        return { ...base, stopHookActive: input.stop_hook_active ?? false };\n      case \"Notification\":\n        return { ...base, message: input.message ?? \"\" };\n      case \"PermissionRequest\":\n        // Codex documents tool_name/tool_input (+tool_input.description); it has\n        // no permission_suggestions field, so the normalized optional stays unset.\n        return {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n        };\n      case \"PostToolUseFailure\":\n        // No Codex analog — never fired natively. Parsed defensively (Claude-\n        // compatible wire) so a manual `hook codex PostToolUseFailure` invocation\n        // still normalizes instead of throwing.\n        return {\n          ...base,\n          toolName: input.tool_name ?? \"\",\n          toolInput: input.tool_input ?? {},\n          error: input.error ?? \"\",\n        };\n      case \"SubagentStart\":\n        return {\n          ...base,\n          ...(typeof input.agent_id === \"string\" ? { agentId: input.agent_id } : {}),\n          ...(typeof input.agent_type === \"string\" ? { agentType: input.agent_type } : {}),\n        };\n      case \"SubagentStop\":\n        // agent_id/agent_type stay optional — never depend on hosts populating\n        // them on stop (the Claude-family SDK quirk).\n        return {\n          ...base,\n          ...(typeof input.agent_id === \"string\" ? { agentId: input.agent_id } : {}),\n          ...(typeof input.agent_type === \"string\" ? { agentType: input.agent_type } : {}),\n          ...(typeof input.agent_transcript_path === \"string\"\n            ? { agentTranscriptPath: input.agent_transcript_path }\n            : {}),\n          ...(typeof input.last_assistant_message === \"string\"\n            ? { lastAssistantMessage: input.last_assistant_message }\n            : {}),\n          ...(typeof input.stop_hook_active === \"boolean\"\n            ? { stopHookActive: input.stop_hook_active }\n            : {}),\n        };\n    }\n  }\n\n  formatReply(event: HookEventName, response: HookResponse): HookReply {\n    // Codex (like Claude Code) reads a `hookSpecificOutput` JSON wrapper from\n    // stdout; exit code 0 = allow. Fields the host cannot honor are dropped.\n\n    // PermissionRequest uses Codex's nested decision{behavior} envelope and is\n    // the ONE event where an EXPLICIT \"allow\" is an ACTIVE grant (suppresses the\n    // approval prompt). ask/context/void → NO decision output: fall through to\n    // the normal approval flow (the prompt IS the ask). Codex docs: updatedInput\n    // / updatedPermissions / interrupt FAIL CLOSED on this event, so \"modify\"\n    // also falls through — emitting a bare allow would grant the ORIGINAL input\n    // the handler wanted rewritten.\n    if (event === \"PermissionRequest\") {\n      if (response.decision === \"deny\") {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            hookSpecificOutput: {\n              hookEventName: \"PermissionRequest\",\n              decision: {\n                behavior: \"deny\",\n                message: response.reason ?? \"Blocked by hook\",\n              },\n            },\n          }),\n        };\n      }\n      if (response.decision === \"allow\") {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            hookSpecificOutput: {\n              hookEventName: \"PermissionRequest\",\n              decision: { behavior: \"allow\" },\n            },\n          }),\n        };\n      }\n      return { exitCode: 0 };\n    }\n\n    // SubagentStart is observe/context-only on Codex (continue:false is parsed\n    // but does not stop the subagent): \"context\" injects additionalContext as\n    // developer context for the SUBAGENT, and a \"deny\" DEGRADES to the same\n    // shape carrying the reason.\n    if (event === \"SubagentStart\") {\n      const context =\n        response.decision === \"context\"\n          ? response.additionalContext\n          : response.decision === \"deny\"\n            ? response.reason ?? response.additionalContext\n            : undefined;\n      if (context) {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            hookSpecificOutput: {\n              hookEventName: \"SubagentStart\",\n              additionalContext: context,\n            },\n          }),\n        };\n      }\n      return { exitCode: 0 };\n    }\n\n    if (response.decision === \"deny\") {\n      // PreToolUse deny is honored; other events fail-open to allow.\n      if (event === \"PreToolUse\") {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            hookSpecificOutput: {\n              hookEventName: \"PreToolUse\",\n              permissionDecision: \"deny\",\n              permissionDecisionReason: response.reason ?? \"Blocked by hook\",\n            },\n          }),\n        };\n      }\n      // SubagentStop deny = Stop semantics: the documented continuation shape is\n      // the TOP-LEVEL {\"decision\":\"block\",\"reason\"} (keeps the subagent going\n      // with `reason` as its next instruction).\n      if (event === \"SubagentStop\") {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            decision: \"block\",\n            reason: response.reason ?? \"Blocked by hook\",\n          }),\n        };\n      }\n      return { exitCode: 0 };\n    }\n\n    // modify → rewrite PreToolUse tool input. Codex applies `updatedInput`\n    // (PR #20527, stable since 0.131.0) but its output_parser.rs only accepts it\n    // when paired with permissionDecision:\"allow\" — emitting updatedInput alone\n    // (the Claude Code shape) is rejected as \"updatedInput without\n    // permissionDecision:allow\", and an allow alone is rejected too, so the pair\n    // is emitted together. Other events fail open (no updatedInput surface).\n    if (response.decision === \"modify\") {\n      if (event === \"PreToolUse\" && response.updatedInput) {\n        return {\n          exitCode: 0,\n          stdout: JSON.stringify({\n            hookSpecificOutput: {\n              hookEventName: \"PreToolUse\",\n              permissionDecision: \"allow\",\n              updatedInput: response.updatedInput,\n            },\n          }),\n        };\n      }\n      return { exitCode: 0 };\n    }\n\n    // Context injection: honored on SessionStart, PostToolUse, and PreToolUse\n    // (additionalContext — PreToolUse support shipped via PR #20692, stable since\n    // codex 0.130.0; injected independent of any permission decision).\n    // (SubagentStop accepts only the common output fields — no additionalContext.)\n    if (\n      response.additionalContext &&\n      (event === \"SessionStart\" || event === \"PostToolUse\" || event === \"PreToolUse\")\n    ) {\n      return {\n        exitCode: 0,\n        stdout: JSON.stringify({\n          hookSpecificOutput: {\n            hookEventName: event,\n            additionalContext: response.additionalContext,\n          },\n        }),\n      };\n    }\n\n    // \"allow\" / unsupported-on-Codex (ask) → passthrough.\n    return { exitCode: 0 };\n  }\n\n  // ── Internal helpers ────────────────────────────────────────────────────\n\n  /** Resolve the per-platform server override into an effective ServerDef. */\n  protected effectiveServer(ctx: InstallContext): ServerDef | undefined {\n    const override = ctx.connector.platforms[this.id]?.server;\n    if (override === false) return undefined;\n    const base = ctx.connector.server;\n    if (!base) return undefined;\n    return override ? { ...base, ...override } : base;\n  }\n\n  /**\n   * Render the `[mcp_servers.<id>]` table. TOML has NO interpolation, so every\n   * `${env:VAR}` is resolved to a literal at install time. The env table is a\n   * plain string→string map. Honors the telemetry serve-wrapper.\n   */\n  protected renderMcpEntry(ctx: InstallContext, server: ServerDef): CodexMcpEntry {\n    // Streamable HTTP server: codex infers the transport from `url` (no explicit\n    // transport key). VERIFIED against codex-cli 0.139.0 — `codex mcp add <id>\n    // --url <U> --bearer-token-env-var <E>` writes:\n    //   [mcp_servers.<id>]\n    //   url = \"…\"\n    //   bearer_token_env_var = \"…\"   (only with bearerEnv auth)\n    // Telemetry serve-wrapping is stdio-only (remote cannot be intercepted).\n    // installServer's guard only lets stdio+command or http+url reach here, so\n    // this branch is exactly the streamable-HTTP case (lock-step with the guard).\n    if (server.transport === \"http\") {\n      const remote: CodexMcpEntry = { url: resolveEnvRefsDeep(server.url ?? \"\") };\n      if (server.auth?.type === \"bearerEnv\" && server.auth.bearerEnvVar) {\n        remote.bearer_token_env_var = server.auth.bearerEnvVar;\n      }\n      if (server.headers && Object.keys(server.headers).length > 0) {\n        const headers: Record<string, string> = {};\n        for (const [k, v] of Object.entries(resolveEnvRefsDeep(server.headers))) {\n          headers[k] = String(v);\n        }\n        remote.http_headers = headers;\n      }\n      return remote;\n    }\n    let command = server.command as string;\n    let args = [...(server.args ?? [])];\n\n    ({ command, args } = buildWrappedStdio(ctx, server, this.id, command, args));\n\n    // Resolve env-refs to literals (TOML cannot interpolate).\n    command = resolveEnvRefsDeep(command);\n    args = resolveEnvRefsDeep(args);\n\n    const entry: CodexMcpEntry = { command };\n    if (args.length > 0) entry.args = args;\n\n    if (server.env && Object.keys(server.env).length > 0) {\n      const env: Record<string, string> = {};\n      for (const [k, v] of Object.entries(resolveEnvRefsDeep(server.env))) {\n        env[k] = String(v);\n      }\n      entry.env = env;\n    }\n    return entry;\n  }\n\n  /**\n   * Does this hooks.json entry belong to this connector for `event`? EVENT-\n   * SPECIFIC + path-normalized exact-command match. The engine binds this per\n   * event in the uninstall (whole-entry FLAT removal) and the install idempotency\n   * find reuses its command body via the descriptor's entryOwnsCommand.\n   */\n  protected isOurEntry(ctx: InstallContext, event: CodexHookEventName, entry: CodexHookEntry): boolean {\n    if (!entry || typeof entry !== \"object\" || !Array.isArray(entry.hooks)) return false;\n    const ours = buildHomeBinHookCommand(ctx.homeBinPath, this.id, event, ctx.connector.id);\n    const needle = ours.replace(/\\\\/g, \"/\");\n    return entry.hooks.some((h) => (h.command ?? \"\").replace(/\\\\/g, \"/\") === needle);\n  }\n}\n\nexport const adapter = new CodexAdapter();\nexport default adapter;\n"],"mappings":"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","names":[]}

package/dist/{chunk-STR3CRH3.js → chunk-C4NDV6GW.js}

@@ -14,7 +14,7 @@ import {
   isConcreteSemver,
   isPlaceholderVersion,
   registryTransportType
-} from "./chunk-O7CFTOM5.js";
+} from "./chunk-S2TAC22E.js";
 import {
   renderCommandMd,
   renderSkillMd,
@@ -1490,4 +1490,4 @@ export {
   packageConnectorAll,
   installInstructions
 };
-//# sourceMappingURL=chunk-STR3CRH3.js.map
+//# sourceMappingURL=chunk-C4NDV6GW.js.map

package/dist/{chunk-LO6NIZSL.js → chunk-CG44RWYJ.js}

@@ -3,7 +3,7 @@ import {
   installInstructions,
   packageConnector,
   readAgentPluginManifest
-} from "./chunk-STR3CRH3.js";
+} from "./chunk-C4NDV6GW.js";
 import {
   MARKETPLACE_NAME,
   agyPluginInstalled,
@@ -50,7 +50,7 @@ import {
 } from "./chunk-GDIAHWNY.js";
 import {
   detectInstalledPlatforms
-} from "./chunk-OXANBA4I.js";
+} from "./chunk-ITVST3SZ.js";
 import {
   log
 } from "./chunk-KHO5WNTP.js";
@@ -58,11 +58,11 @@ import {
   deregisterConnector,
   loadRegisteredConnector,
   registerConnector
-} from "./chunk-BGPVMJOG.js";
+} from "./chunk-ZYB2UFEN.js";
 import {
   REGISTERED_PLATFORM_IDS,
   loadAdapter
-} from "./chunk-QG26JEJF.js";
+} from "./chunk-7C3COFOD.js";
 import {
   configPatchManualEdit
 } from "./chunk-NBYKLUF6.js";
@@ -3421,4 +3421,4 @@ export {
   upgradeViaMarketplace,
   marketplaceDoctorChecks
 };
-//# sourceMappingURL=chunk-LO6NIZSL.js.map
+//# sourceMappingURL=chunk-CG44RWYJ.js.map

package/dist/chunk-D35FMUFZ.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+// src/core/version.ts
+import { existsSync, readFileSync } from "fs";
+import { createRequire } from "module";
+import { dirname, join } from "path";
+var PACKAGE_NAME = "@ken-jo/agent-connector";
+function resolveOwnVersion() {
+  const req = createRequire(import.meta.url);
+  for (const rel of ["../package.json", "../../package.json", "../../../package.json"]) {
+    try {
+      const pkg = req(rel);
+      if (pkg.name === PACKAGE_NAME && typeof pkg.version === "string") {
+        return pkg.version;
+      }
+    } catch {
+    }
+  }
+  return "0.0.0";
+}
+function versionOfCliEntry(cliEntry) {
+  let dir = dirname(cliEntry);
+  for (let i = 0; i < 6; i++) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        if (pkg.name === PACKAGE_NAME && typeof pkg.version === "string") return pkg.version;
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function cliEntryOfLauncher(launcherText) {
+  const m = launcherText.match(/"([^"]+)"\s+"([^"]+)"\s+(?:"\$@"|%\*)/);
+  return m?.[2] ?? null;
+}
+
+export {
+  resolveOwnVersion,
+  versionOfCliEntry,
+  cliEntryOfLauncher
+};
+//# sourceMappingURL=chunk-D35FMUFZ.js.map

package/dist/chunk-D35FMUFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/version.ts"],"sourcesContent":["/**\n * core/version — agent-connector's own package version, plus the version of\n * the agent-connector install that a given CLI entry file belongs to.\n *\n * Used by `--version`, by registerConnector (which stamps the framework version\n * onto every connector record so doctor can spot installs rendered by an older\n * release), and by doctor's home-bin check (which compares the launcher's\n * target install against the running CLI).\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\n\nconst PACKAGE_NAME = \"@ken-jo/agent-connector\";\n\n/**\n * Resolve agent-connector's own package version at runtime. Works from both the\n * bundled dist layout (dist/*.js → ../package.json) and the src layout under\n * tsx/vitest (src/core/ → ../../package.json); the name check guards against\n * accidentally reading some other package.json on the walk.\n */\nexport function resolveOwnVersion(): string {\n  const req = createRequire(import.meta.url);\n  for (const rel of [\"../package.json\", \"../../package.json\", \"../../../package.json\"]) {\n    try {\n      const pkg = req(rel) as { name?: string; version?: string };\n      if (pkg.name === PACKAGE_NAME && typeof pkg.version === \"string\") {\n        return pkg.version;\n      }\n    } catch {\n      /* keep walking */\n    }\n  }\n  return \"0.0.0\";\n}\n\n/**\n * The agent-connector package version that OWNS `cliEntry` (an absolute path to\n * a `dist/cli.js`), found by walking up to the nearest package.json whose name\n * is agent-connector's. Returns null when no such package.json is reachable\n * (the entry is not inside an agent-connector install, or it is gone).\n */\nexport function versionOfCliEntry(cliEntry: string): string | null {\n  let dir = dirname(cliEntry);\n  for (let i = 0; i < 6; i++) {\n    const pkgPath = join(dir, \"package.json\");\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, \"utf8\")) as { name?: string; version?: string };\n        if (pkg.name === PACKAGE_NAME && typeof pkg.version === \"string\") return pkg.version;\n      } catch {\n        /* unreadable — keep walking */\n      }\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/**\n * The CLI entry a home-bin launcher execs, parsed from the launcher text that\n * ensureHomeBin writes (`exec \"<node>\" \"<cli>\" \"$@\"` on POSIX, `\"<node>\" \"<cli>\" %*`\n * on Windows). Null when the text is not a launcher we wrote.\n */\nexport function cliEntryOfLauncher(launcherText: string): string | null {\n  const m = launcherText.match(/\"([^\"]+)\"\\s+\"([^\"]+)\"\\s+(?:\"\\$@\"|%\\*)/);\n  return m?.[2] ?? null;\n}\n"],"mappings":";;;AAUA,SAAS,YAAY,oBAAoB;AACzC,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAE9B,IAAM,eAAe;AAQd,SAAS,oBAA4B;AAC1C,QAAM,MAAM,cAAc,YAAY,GAAG;AACzC,aAAW,OAAO,CAAC,mBAAmB,sBAAsB,uBAAuB,GAAG;AACpF,QAAI;AACF,YAAM,MAAM,IAAI,GAAG;AACnB,UAAI,IAAI,SAAS,gBAAgB,OAAO,IAAI,YAAY,UAAU;AAChE,eAAO,IAAI;AAAA,MACb;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAQO,SAAS,kBAAkB,UAAiC;AACjE,MAAI,MAAM,QAAQ,QAAQ;AAC1B,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,UAAU,KAAK,KAAK,cAAc;AACxC,QAAI,WAAW,OAAO,GAAG;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,aAAa,SAAS,MAAM,CAAC;AACpD,YAAI,IAAI,SAAS,gBAAgB,OAAO,IAAI,YAAY,SAAU,QAAO,IAAI;AAAA,MAC/E,QAAQ;AAAA,MAER;AAAA,IACF;AACA,UAAM,SAAS,QAAQ,GAAG;AAC1B,QAAI,WAAW,IAAK;AACpB,UAAM;AAAA,EACR;AACA,SAAO;AACT;AAOO,SAAS,mBAAmB,cAAqC;AACtE,QAAM,IAAI,aAAa,MAAM,uCAAuC;AACpE,SAAO,IAAI,CAAC,KAAK;AACnB;","names":[]}

package/dist/{chunk-OXANBA4I.js → chunk-ITVST3SZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ADAPTER_REGISTRY
-} from "./chunk-QG26JEJF.js";
+} from "./chunk-7C3COFOD.js";
 
 // src/adapters/detect.ts
 async function detectInstalledPlatforms(projectDir) {
@@ -85,4 +85,4 @@ export {
   detectInstalledPlatforms,
   detectRuntimeHost
 };
-//# sourceMappingURL=chunk-OXANBA4I.js.map
+//# sourceMappingURL=chunk-ITVST3SZ.js.map

package/dist/{chunk-W4GVN3TJ.js → chunk-KQBRUI3Y.js}

@@ -12,11 +12,11 @@ import {
 import {
   loadRegisteredConnector,
   readRegisteredMeta
-} from "./chunk-BGPVMJOG.js";
+} from "./chunk-ZYB2UFEN.js";
 import {
   REGISTERED_PLATFORM_IDS,
   loadAdapter
-} from "./chunk-QG26JEJF.js";
+} from "./chunk-7C3COFOD.js";
 import {
   projectIdentity
 } from "./chunk-GZGLCCEE.js";
@@ -371,4 +371,4 @@ export {
   isNativeHookDeclared,
   runNativeHook
 };
-//# sourceMappingURL=chunk-W4GVN3TJ.js.map
+//# sourceMappingURL=chunk-KQBRUI3Y.js.map

package/dist/{chunk-TCJN5S4T.js → chunk-PTITNBSS.js}

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import {
+  resolveOwnVersion
+} from "./chunk-D35FMUFZ.js";
 
 // src/cli/app.ts
-import { createRequire } from "module";
 import { homedir } from "os";
 
 // src/cli/banner.ts
@@ -209,19 +211,6 @@ function maybePrintBanner(flags) {
   print(renderBrandBanner(activeProgramName, { color, columns, palette }));
   print("");
 }
-function resolveOwnVersion() {
-  const req = createRequire(import.meta.url);
-  for (const rel of ["../package.json", "../../package.json", "../../../package.json"]) {
-    try {
-      const pkg = req(rel);
-      if (pkg.name === "@ken-jo/agent-connector" && typeof pkg.version === "string") {
-        return pkg.version;
-      }
-    } catch {
-    }
-  }
-  return "0.0.0";
-}
 function parseScope(value) {
   if (value === "user" || value === "project") return value;
   return null;
@@ -460,37 +449,37 @@ function renderInstallResult(result, verb) {
   return lines.join("\n");
 }
 var COMMANDS = {
-  detect: () => import("./detect-KYRQJUDY.js"),
-  install: () => import("./install-RCHVHCHO.js"),
-  uninstall: () => import("./uninstall-WZHO4CVL.js"),
+  detect: () => import("./detect-RT75DWQ5.js"),
+  install: () => import("./install-XNTRLUZI.js"),
+  uninstall: () => import("./uninstall-EJLQGZRN.js"),
   // `upgrade` is the single "bring everything current" verb (re-render host
   // config + refresh the home pointer + managed channel guidance). `sync` and
   // `update` are kept as back-compat aliases that route to the same module so
   // existing scripts/docs keep working without a second concept to learn.
-  upgrade: () => import("./upgrade-DZMEUPF2.js"),
-  sync: () => import("./upgrade-DZMEUPF2.js"),
-  update: () => import("./upgrade-DZMEUPF2.js"),
-  package: () => import("./package-75T46SXP.js"),
-  audit: () => import("./audit-5K2H7PAT.js"),
-  doctor: () => import("./doctor-BGWPZ676.js"),
-  status: () => import("./status-VJVNMWT7.js"),
-  telemetry: () => import("./telemetry-YVMUXTDG.js"),
-  usage: () => import("./usage-QSM4PP3E.js"),
-  leaderboard: () => import("./leaderboard-V3DXXZNL.js"),
-  hook: () => import("./hook-YMCFZRJE.js"),
+  upgrade: () => import("./upgrade-ZPHQELKG.js"),
+  sync: () => import("./upgrade-ZPHQELKG.js"),
+  update: () => import("./upgrade-ZPHQELKG.js"),
+  package: () => import("./package-VRV5YHUJ.js"),
+  audit: () => import("./audit-IMNQJZ4W.js"),
+  doctor: () => import("./doctor-F3RRQBQN.js"),
+  status: () => import("./status-3EHFFIQ7.js"),
+  telemetry: () => import("./telemetry-AEE4TOFA.js"),
+  usage: () => import("./usage-IWPGACHN.js"),
+  leaderboard: () => import("./leaderboard-VF4W6PZ2.js"),
+  hook: () => import("./hook-VYA4Q3YR.js"),
   // Internal (omitted from USAGE): the statusline (HUD) entrypoint a host's
   // status line config points at. Fail-safe: always exits 0 with at most a
   // rendered line. See cli/commands/statusline.ts.
-  statusline: () => import("./statusline-OKW44KFR.js"),
+  statusline: () => import("./statusline-64IDYANK.js"),
   // Internal (omitted from USAGE): the user-invokable action entrypoint a future
   // host affordance points at. USER-TRIGGERED: surfaces errors (exit 1 + stderr),
   // unlike the fail-open hook / fail-safe statusline. See cli/commands/action.ts.
-  action: () => import("./action-IKJ2J3X4.js"),
-  serve: () => import("./serve-IRMYJWFT.js"),
+  action: () => import("./action-DFUJOXVJ.js"),
+  serve: () => import("./serve-EPEAGVOE.js"),
   // Hidden (omitted from USAGE): the opt-in host-native turn-usage entrypoint an
   // AfterModel / PostInvocation hook points at. Always exits 0; records a
   // distinct `model_turn` row. See cli/commands/usage-event.ts.
-  "usage-event": () => import("./usage-event-FH3X232T.js")
+  "usage-event": () => import("./usage-event-W5VLRA3X.js")
 };
 var DEFAULT_PROGRAM_NAME = "agent-connector";
 var COMMAND_USAGE = {
@@ -590,4 +579,4 @@ export {
   renderInstallResult,
   main
 };
-//# sourceMappingURL=chunk-TCJN5S4T.js.map
+//# sourceMappingURL=chunk-PTITNBSS.js.map

package/dist/chunk-PTITNBSS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/app.ts","../src/cli/banner.ts"],"sourcesContent":["/**\n * cli/app — shared CLI helpers + command dispatch (NO side effects).\n *\n * Command modules import the shared helpers (print, fail, parse-flags,\n * renderInstallResult) from here, and main() dispatches the first positional to a\n * command module.\n * This module never auto-runs — `cli/index.ts` is the thin bin entry that calls\n * `main()`. Keeping the auto-run out of here is what prevents a dispatch recursion\n * (a command module importing a helper must not re-trigger the program) and makes\n * it robust to bundler entry-splitting (the old import.meta.url entry-guard broke\n * once tsup hoisted this code into a shared chunk).\n */\n\nimport { homedir } from \"node:os\";\n\nimport { PALETTES, renderBrandBanner, resolveColorMode, shouldShowBanner } from \"./banner.js\";\nimport type {\n  ChangeRecord,\n  ConnectorSummary,\n  InstallResult,\n  InstallScope,\n  PlatformId,\n  ResolvedConnector,\n} from \"../core/types.js\";\nimport { resolveOwnVersion } from \"../core/version.js\";\n\n// ─────────────────────────────────────────────────────────────────────────\n// Shared helpers (imported by the command modules)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** Print a line to stdout (machine-readable payloads must stay on stdout). */\nexport function print(line: string): void {\n  process.stdout.write(`${line}\\n`);\n}\n\n/**\n * The brand active for THIS invocation. main() sets it from\n * {@link MainOptions.programName} before dispatch, so error messages printed by\n * command modules via {@link fail} read as the embedding tool (e.g. `acme-db:`)\n * instead of always `agent-connector:`.\n */\nlet activeProgramName = \"agent-connector\";\n\n/** Print an error to stderr (branded) and return a non-zero exit code (default 2). */\nexport function fail(message: string, code = 2): number {\n  process.stderr.write(`${activeProgramName}: ${message}\\n`);\n  return code;\n}\n\n/**\n * The brand active for THIS invocation (what the banner renders in ASCII art).\n * main() sets it from {@link MainOptions.programName} before dispatch; reading it\n * here keeps the banner branded for an embedding SDK CLI without each command\n * module needing the program name threaded through.\n */\nexport function getActiveProgramName(): string {\n  return activeProgramName;\n}\n\n/**\n * Print the branded ASCII banner once, atop install / uninstall / upgrade /\n * doctor — but ONLY for an interactive TTY (suppressed when piped/redirected,\n * under --json, or under --quiet) so scripts and pipelines see byte-identical\n * command output. The pure render lives in cli/banner; this thin wrapper reads\n * the real stdout/env and feeds it in.\n */\nexport function maybePrintBanner(flags: { json?: boolean; quiet?: boolean }): void {\n  const isTTY = process.stdout.isTTY === true;\n  const noColor = process.env.NO_COLOR != null && process.env.NO_COLOR !== \"\";\n  if (!shouldShowBanner({ isTTY, noColor, json: flags.json === true, quiet: flags.quiet === true })) {\n    return;\n  }\n  const color = resolveColorMode({\n    noColor,\n    colorterm: process.env.COLORTERM,\n    term: process.env.TERM,\n  });\n  // Coerce an unknown/zero width to a conservative 80 so an unknown-width TTY\n  // shows the safe one-line title rather than the 129-col block art.\n  const c = process.stdout.columns;\n  const columns = typeof c === \"number\" && c > 0 ? c : 80;\n  // Rotate the gradient per run so each real invocation reads differently. The\n  // random pick lives HERE (the impure wrapper) so the pure renderer stays\n  // deterministic for tests/direct callers.\n  const palette = PALETTES[Math.floor(Math.random() * PALETTES.length)]!;\n  print(renderBrandBanner(activeProgramName, { color, columns, palette }));\n  print(\"\");\n}\n\n/** Re-exported for the command modules and branded CLIs (moved to core/version). */\nexport { resolveOwnVersion };\n\n/** Parse a --scope value the CLI accepts (user|project) into an InstallScope. */\nexport function parseScope(value: string | undefined): InstallScope | null {\n  if (value === \"user\" || value === \"project\") return value;\n  return null;\n}\n\n/**\n * Parse a comma-separated --targets value into PlatformId[]. Returns undefined\n * when the flag is absent/empty so callers can fall back to connector/detection.\n */\nexport function parseTargets(value: string | undefined): PlatformId[] | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const ids = value\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s !== \"\") as PlatformId[];\n  return ids.length > 0 ? ids : undefined;\n}\n\n/**\n * Build the render-only {@link ConnectorSummary} from a resolved connector. The\n * command modules call this on the {@link ResolvedConnector} they already loaded\n * and attach the result to {@link InstallResult.connector}, so the friendly\n * renderer can print a header describing WHAT was deployed without importing the\n * heavyweight connector type or its live handlers.\n */\nexport function buildConnectorSummary(connector: ResolvedConnector): ConnectorSummary {\n  let server: ConnectorSummary[\"server\"];\n  if (connector.server) {\n    const s = connector.server;\n    // stdio → \"node server.mjs\"; remote → the URL (best-effort one-liner).\n    // HOME-relativize each part so a bundled absolute server path reads short.\n    const cmd =\n      s.transport === \"stdio\"\n        ? [s.command, ...(s.args ?? [])]\n            .filter((p): p is string => p != null && p !== \"\")\n            .map((p) => tildify(p))\n            .join(\" \")\n        : (s.url ?? \"\");\n    server = { transport: s.transport, command: cmd };\n  }\n  return {\n    id: connector.id,\n    version: connector.version,\n    displayName: connector.displayName,\n    server,\n    hookEvents: [...connector.hookEvents],\n    telemetryEnabled: connector.telemetry.enabled,\n    commands: connector.commands.length,\n    skills: connector.skills.length,\n    subagents: connector.subagents.length,\n    memory: connector.memory.length,\n    hasStatusline: connector.statusline != null,\n    actions: connector.actions.length,\n  };\n}\n\n/**\n * Rewrite an absolute path under the user's home dir to a leading `~/…` so the\n * per-host paths read short. Leaves non-home and relative paths untouched.\n */\nfunction tildify(path: string): string {\n  // Normalize both to forward slashes so the home-prefix check is separator-\n  // robust (Windows mixes `\\` and `/`) and the displayed path reads `~/…`\n  // consistently on every platform (Windows terminals accept `/` fine).\n  const home = homedir().replace(/\\\\/g, \"/\");\n  const np = path.replace(/\\\\/g, \"/\");\n  if (home && (np === home || np.startsWith(home + \"/\"))) {\n    return \"~\" + np.slice(home.length);\n  }\n  return np;\n}\n\n/** Truncate a long single-line command for the header (keeps it scannable). */\nfunction truncateCommand(cmd: string, max = 64): string {\n  if (cmd.length <= max) return cmd;\n  return cmd.slice(0, max - 1) + \"…\";\n}\n\n/**\n * The surface a ChangeRecord touched, derived from its detail (primary signal)\n * then its path (fallback for content files whose detail is a bare basename).\n */\ntype Surface = \"mcp\" | \"hooks\" | \"commands\" | \"skills\" | \"subagents\" | \"memory\" | \"statusline\" | \"actions\" | \"backup\" | \"other\";\n\nfunction classifySurface(c: ChangeRecord): Surface {\n  const detail = c.detail.toLowerCase();\n  // A safety backup the installer wrote before a destructive change.\n  if (detail.startsWith(\"backed up\") || detail.includes(\"backup\")) return \"backup\";\n  // MCP server entry: mcpServers.<id> / mcp_servers.<id> / mcp.servers.<id>.\n  if (/^mcp[._]?servers?\\./.test(detail) || detail.startsWith(\"mcp.\")) return \"mcp\";\n  // Normalized + native hook entries: hooks.<Event> (case varies per host).\n  if (detail.startsWith(\"hooks.\") || detail.startsWith(\"hook \")) return \"hooks\";\n  if (detail.includes(\"nativehooks\")) return \"hooks\";\n  if (detail.startsWith(\"memory\")) return \"memory\";\n  if (detail.startsWith(\"statusline\")) return \"statusline\";\n  if (detail.startsWith(\"actions\") || detail.startsWith(\"action \")) return \"actions\";\n  if (detail.includes(\"configpatch\")) return \"other\";\n  // Path-based fallback for content-file surfaces (detail is a bare basename).\n  const p = (c.path ?? \"\").replace(/\\\\/g, \"/\").toLowerCase();\n  if (/\\/commands?\\//.test(p)) return \"commands\";\n  if (/\\/skills?\\//.test(p)) return \"skills\";\n  if (/\\/(subagents?|agents?)\\//.test(p)) return \"subagents\";\n  // Detail mentions a surface noun (skip/warn lines like \"no skills\").\n  if (/\\bcommands?\\b/.test(detail)) return \"commands\";\n  if (/\\bskills?\\b/.test(detail)) return \"skills\";\n  if (/\\bsubagents?\\b/.test(detail)) return \"subagents\";\n  return \"other\";\n}\n\nconst SURFACE_LABEL_SINGULAR: Record<Surface, string> = {\n  mcp: \"MCP server\",\n  hooks: \"hook\",\n  commands: \"command\",\n  skills: \"skill\",\n  subagents: \"subagent\",\n  memory: \"memory block\",\n  statusline: \"status line\",\n  actions: \"action\",\n  backup: \"backup\",\n  other: \"change\",\n};\n\n/** Pluralize a surface count, e.g. (2,\"hooks\") → \"2 hooks\". */\nfunction countLabel(n: number, surface: Surface): string {\n  const base = SURFACE_LABEL_SINGULAR[surface];\n  if (surface === \"mcp\") return \"MCP server\"; // singular by construction\n  return n === 1 ? `1 ${base}` : `${n} ${base}s`;\n}\n\n/** Verb-appropriate glyph for a host's NET status. */\nfunction hostGlyph(status: \"ok\" | \"skip\" | \"warn\"): string {\n  return status === \"warn\" ? \"!\" : status === \"skip\" ? \"=\" : \"✓\";\n}\n\n/**\n * One host's collapsed view: its net status, a surface summary line, the\n * deduped HOME-relativized paths it touched, and any inline warnings.\n */\ninterface HostGroup {\n  platform: PlatformId;\n  status: \"ok\" | \"skip\" | \"warn\";\n  summary: string;\n  paths: string[];\n  warnings: string[];\n}\n\n/**\n * Collapse the per-(host,surface) ChangeRecords into ONE entry per host:\n *   - status: warn if any record warned; ok if any created/updated/removed;\n *     else skip (everything was a no-op).\n *   - summary: the active (non-skip) surfaces, joined (\"MCP server + 2 hooks\").\n *     When every record skipped, the reason is surfaced instead.\n */\nfunction groupByHost(changes: ChangeRecord[], verb: Verb): HostGroup[] {\n  const order: PlatformId[] = [];\n  const byHost = new Map<PlatformId, ChangeRecord[]>();\n  for (const c of changes) {\n    if (!byHost.has(c.platform)) {\n      byHost.set(c.platform, []);\n      order.push(c.platform);\n    }\n    byHost.get(c.platform)!.push(c);\n  }\n\n  const groups: HostGroup[] = [];\n  for (const platform of order) {\n    const recs = byHost.get(platform)!;\n    // A safety backup the installer wrote is INCIDENTAL, not an installed\n    // surface: it must not flip an otherwise-no-op host to \"changed\" (an\n    // idempotent re-install that only re-backs-up should still read \"already\n    // current\"). It is shown only ALONGSIDE a real surface change.\n    const written = recs.filter((c) => c.action !== \"skip\" && c.action !== \"warn\");\n    const realChanges = written.filter((c) => classifySurface(c) !== \"backup\");\n    const warned = recs.filter((c) => c.action === \"warn\");\n    const status: HostGroup[\"status\"] =\n      warned.length > 0 ? \"warn\" : realChanges.length > 0 ? \"ok\" : \"skip\";\n\n    // Surface summary from the written records (created/updated/removed),\n    // preserving a stable surface order and collapsing per-surface counts. The\n    // incidental `backup` surface is included ONLY when a real surface changed.\n    const SURFACE_ORDER: Surface[] = [\n      \"mcp\",\n      \"hooks\",\n      \"commands\",\n      \"skills\",\n      \"subagents\",\n      \"memory\",\n      \"statusline\",\n      \"actions\",\n      \"backup\",\n      \"other\",\n    ];\n    const counts = new Map<Surface, number>();\n    const summarySource = realChanges.length > 0 ? written : realChanges;\n    for (const c of summarySource) {\n      const s = classifySurface(c);\n      counts.set(s, (counts.get(s) ?? 0) + 1);\n    }\n    const parts = SURFACE_ORDER.filter((s) => counts.has(s)).map((s) =>\n      countLabel(counts.get(s)!, s),\n    );\n\n    let summary: string;\n    if (parts.length > 0) {\n      summary = parts.join(\" + \");\n    } else if (status === \"warn\") {\n      // No real surface change but a warning — the warning line carries detail.\n      summary = \"\";\n    } else {\n      // Nothing real changed: surface a skip reason (or note the incidental\n      // backup) for context.\n      const reason =\n        recs.find((c) => c.action === \"skip\")?.detail ??\n        (written.length > 0 ? \"already current (re-backed-up only)\" : \"no changes\");\n      summary = verb === \"uninstall\" ? `nothing to remove (${reason})` : `unchanged (${reason})`;\n    }\n\n    const paths = [\n      ...new Set(\n        recs\n          .filter((c) => c.path != null && c.path !== \"\")\n          .map((c) => tildify(c.path!)),\n      ),\n    ];\n    const warnings = warned.map((c) => c.detail);\n\n    groups.push({ platform, status, summary, paths, warnings });\n  }\n  return groups;\n}\n\ntype Verb = \"install\" | \"upgrade\" | \"uninstall\";\n\n/**\n * Render an InstallResult as a friendly, grouped report (the DEFAULT output):\n *   1. a connector header (id/version/displayName + server/hooks/telemetry +\n *      one line per shipped content surface), when the summary is threaded in;\n *   2. one line per host (net glyph + surface summary + deduped ~/… paths),\n *      with any host warnings inline beneath it;\n *   3. a friendly closing line + restart hint + doctor/uninstall next steps.\n *\n * Used by install / upgrade / uninstall. The exit-non-zero-on-warn convention\n * is enforced by the callers (this function only renders).\n */\nexport function renderInstallResult(result: InstallResult, verb: Verb): string {\n  const lines: string[] = [];\n  const summary = result.connector;\n\n  // ── 1. Connector header ───────────────────────────────────────────────────\n  if (summary) {\n    const head = [`${summary.id}  v${summary.version}`];\n    if (summary.displayName && summary.displayName !== summary.id) {\n      head.push(summary.displayName);\n    }\n    lines.push(head.join(\"  ·  \"));\n\n    if (summary.server) {\n      lines.push(\n        `  server      ${summary.server.transport} · ${truncateCommand(summary.server.command)}`,\n      );\n    } else {\n      lines.push(\"  server      (hooks-only)\");\n    }\n    if (summary.hookEvents.length > 0) {\n      lines.push(`  hooks       ${summary.hookEvents.join(\", \")}`);\n    }\n    lines.push(`  telemetry   ${summary.telemetryEnabled ? \"on\" : \"off\"}`);\n    if (summary.commands > 0)\n      lines.push(`  commands    ${summary.commands}`);\n    if (summary.skills > 0) lines.push(`  skills      ${summary.skills}`);\n    if (summary.subagents > 0)\n      lines.push(`  subagents   ${summary.subagents}`);\n    if (summary.memory > 0) lines.push(`  memory      ${summary.memory}`);\n    if (summary.hasStatusline) lines.push(`  statusline  1`);\n    if (summary.actions > 0) lines.push(`  actions     ${summary.actions}`);\n    lines.push(\"\");\n  } else {\n    // No summary threaded (back-compat): keep a minimal verb header.\n    const mode = result.dryRun ? \" (dry-run — nothing written)\" : \"\";\n    lines.push(`${verb} \"${result.connectorId}\"${mode}`);\n  }\n\n  // ── 2. Per-host grouping ──────────────────────────────────────────────────\n  const groups = groupByHost(result.changes, verb);\n  if (groups.length === 0) {\n    lines.push(\"(no changes)\");\n  } else {\n    const verbed = verb === \"uninstall\" ? \"removed from\" : verb === \"upgrade\" ? \"synced to\" : \"detected\";\n    lines.push(`→ ${groups.length} agent ${groups.length === 1 ? \"host\" : \"hosts\"} ${verbed}:`);\n    // Width-align the platform column for a scannable table; the summary column\n    // gets a fixed min width but always keeps a 2-space gap before the paths\n    // even when an unusually long summary overflows it.\n    const pad = Math.max(...groups.map((g) => g.platform.length));\n    for (const g of groups) {\n      const glyph = hostGlyph(g.status);\n      const name = g.platform.padEnd(pad);\n      const pathsCol = g.paths.join(\", \");\n      const gap = pathsCol === \"\" ? \"\" : \"  \";\n      const summaryCol = pathsCol === \"\" ? g.summary : g.summary.padEnd(26) + gap;\n      lines.push(`  ${glyph} ${name}   ${summaryCol}${pathsCol}`.trimEnd());\n      for (const w of g.warnings) lines.push(`      ! ${w}`);\n    }\n  }\n\n  // ── 3. Closing summary + next steps ───────────────────────────────────────\n  // The headline file tally counts only REAL surface writes — an incidental\n  // safety backup must not masquerade as an installed file, so a re-install\n  // whose only write was a backup honestly reports 0 files / \"already current\".\n  const tally = result.changes.reduce(\n    (acc, c) => {\n      const isWrite = c.action === \"create\" || c.action === \"update\" || c.action === \"remove\";\n      if (isWrite && classifySurface(c) !== \"backup\") acc.files += 1;\n      if (c.action === \"warn\") acc.warns += 1;\n      return acc;\n    },\n    { files: 0, warns: 0 },\n  );\n  const cliCount = groups.length;\n  const cliWord = cliCount === 1 ? \"host\" : \"hosts\";\n  const fileWord = tally.files === 1 ? \"file\" : \"files\";\n\n  lines.push(\"\");\n  if (verb === \"uninstall\") {\n    if (result.dryRun) {\n      lines.push(`✓ Would remove ${summary?.id ?? result.connectorId} from ${cliCount} ${cliWord} · ${tally.files} ${fileWord} (dry-run — nothing written).`);\n    } else if (tally.files === 0 && tally.warns === 0) {\n      lines.push(`✓ Nothing to remove — ${summary?.id ?? result.connectorId} was not installed (zero residue).`);\n    } else {\n      lines.push(`✓ Removed ${summary?.id ?? result.connectorId} from ${cliCount} ${cliWord} · ${tally.files} ${fileWord} cleaned${tally.warns === 0 ? \" (zero residue)\" : \"\"}.`);\n    }\n  } else {\n    const what = verb === \"upgrade\" ? \"Synced\" : \"Installed\";\n    const wouldWhat = verb === \"upgrade\" ? \"sync\" : \"install\";\n    if (result.dryRun) {\n      lines.push(`✓ Would ${wouldWhat} ${summary?.id ?? result.connectorId} to ${cliCount} ${cliWord} · ${tally.files} ${fileWord} (dry-run — nothing written).`);\n    } else if (tally.files === 0) {\n      lines.push(`✓ ${summary?.id ?? result.connectorId}: already current on ${cliCount} ${cliWord} — nothing to write.`);\n    } else {\n      lines.push(`✓ ${what} ${summary?.id ?? result.connectorId} to ${cliCount} ${cliWord} · ${tally.files} ${fileWord}. Restart each host to load it.`);\n    }\n  }\n\n  // Warnings block (kept explicit — callers exit non-zero on any warn). A\n  // remote-transport connector pushes the SAME string to both a warn\n  // ChangeRecord (already shown inline on its host line) and result.warnings, so\n  // skip any bottom-block entry already surfaced inline to show each warning ONCE.\n  const inlineWarnings = new Set(groups.flatMap((g) => g.warnings));\n  const blockWarnings = result.warnings.filter((w) => !inlineWarnings.has(w));\n  if (blockWarnings.length > 0) {\n    lines.push(\"\");\n    lines.push(\"warnings:\");\n    for (const w of blockWarnings) lines.push(`  ! ${w}`);\n  }\n\n  // Next-step hints (the verbs read as the active brand).\n  if (verb === \"uninstall\") {\n    lines.push(`  Verify it's gone: ${activeProgramName} doctor`);\n  } else {\n    lines.push(\n      `  Verify: ${activeProgramName} doctor   ·   Remove: ${activeProgramName} uninstall`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Command dispatch\n// ─────────────────────────────────────────────────────────────────────────\n\n/** A command module: takes the post-command argv slice, returns an exit code. */\ntype CommandModule = { run: (argv: string[]) => Promise<number> | number };\n\n/** Lazy command loaders — keyed by the first positional. Imported on demand. */\nconst COMMANDS: Record<string, () => Promise<CommandModule>> = {\n  detect: () => import(\"./commands/detect.js\"),\n  install: () => import(\"./commands/install.js\"),\n  uninstall: () => import(\"./commands/uninstall.js\"),\n  // `upgrade` is the single \"bring everything current\" verb (re-render host\n  // config + refresh the home pointer + managed channel guidance). `sync` and\n  // `update` are kept as back-compat aliases that route to the same module so\n  // existing scripts/docs keep working without a second concept to learn.\n  upgrade: () => import(\"./commands/upgrade.js\"),\n  sync: () => import(\"./commands/upgrade.js\"),\n  update: () => import(\"./commands/upgrade.js\"),\n  package: () => import(\"./commands/package.js\"),\n  audit: () => import(\"./commands/audit.js\"),\n  doctor: () => import(\"./commands/doctor.js\"),\n  status: () => import(\"./commands/status.js\"),\n  telemetry: () => import(\"./commands/telemetry.js\"),\n  usage: () => import(\"./commands/usage.js\"),\n  leaderboard: () => import(\"./commands/leaderboard.js\"),\n  hook: () => import(\"./commands/hook.js\"),\n  // Internal (omitted from USAGE): the statusline (HUD) entrypoint a host's\n  // status line config points at. Fail-safe: always exits 0 with at most a\n  // rendered line. See cli/commands/statusline.ts.\n  statusline: () => import(\"./commands/statusline.js\"),\n  // Internal (omitted from USAGE): the user-invokable action entrypoint a future\n  // host affordance points at. USER-TRIGGERED: surfaces errors (exit 1 + stderr),\n  // unlike the fail-open hook / fail-safe statusline. See cli/commands/action.ts.\n  action: () => import(\"./commands/action.js\"),\n  serve: () => import(\"./commands/serve.js\"),\n  // Hidden (omitted from USAGE): the opt-in host-native turn-usage entrypoint an\n  // AfterModel / PostInvocation hook points at. Always exits 0; records a\n  // distinct `model_turn` row. See cli/commands/usage-event.ts.\n  \"usage-event\": () => import(\"./commands/usage-event.js\"),\n};\n\n/** Default program name; an embedding SDK CLI overrides it via {@link MainOptions}. */\nexport const DEFAULT_PROGRAM_NAME = \"agent-connector\";\n\n/**\n * One-line usage signature per command — the single central copy behind\n * `<command> --help` and the friendly bad-flag error. Command modules use\n * node:util parseArgs (strict), which THROWS on an unknown flag; without the\n * dispatcher-level handling in {@link main}, `agent-connector install --help`\n * would die with a raw ERR_PARSE_ARGS stack trace — the very invocation the\n * root help tells users to run.\n */\nconst COMMAND_USAGE: Record<string, string> = {\n  detect: \"detect [--json] [--project <dir>]\",\n  install:\n    \"install [<source>] [--method direct|marketplace] [--connector <source>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run] [--force] [--quiet]\\n\" +\n    \"  <source>    a local path OR a remote connector source: owner/repo[/subpath][#ref], a github.com URL (incl. /tree/<ref>/<sub>), git@github.com:owner/repo, github:owner/repo, npm:<package>[@version], archive:<path-or-url>, or a direct .tgz/.tar.gz URL/path. Remote sources are fetched to ~/.agent-connector/sources/ and must be an agent-connector package (have an agent-connector.config.{mjs,js,json}).\",\n  uninstall:\n    \"uninstall [--method auto|direct|marketplace] [--connector <path>] [--connector-id <id>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run] [--purge] [--quiet]\",\n  upgrade:\n    \"upgrade [--method direct|marketplace] [--channel stable|latest] [--connector <path>] [--scope user|project] [--targets a,b] [--project <dir>] [--dry-run] [--quiet]\",\n  sync: \"sync — alias of upgrade (see `upgrade --help`)\",\n  update: \"update — alias of upgrade (see `upgrade --help`)\",\n  package:\n    \"package [--connector <path>] [--format <fmt>|all] [--out <dir>] [--project <dir>] [--dry-run]\",\n  audit:\n    \"audit [--connector <path>] [--package-json <path>] [--project <dir>] [--json] [--strict]\",\n  doctor:\n    \"doctor [--targets a,b] [--connector <path>] [--scope user|project] [--project <dir>] [--probe] [--explain] [--json] [--heal] [--dry-run] [--quiet]\\n\" +\n    \"  --explain   per-(host,event) hook honor matrix (honored/degraded/dropped). Exit non-zero ONLY when an explicitly-targeted host DEGRADES a declared event (fires it but silently won't honor the reply); dropped/mcp-only hosts and fleet-wide (targets:auto) gaps are informational (exit 0).\",\n  status: \"status [--connector <path>] [--scope user|project] [--project <dir>] [--json]\",\n  telemetry:\n    \"telemetry report|export|leaderboard [--by <dim>] [--since <dur>] [--connector <id>] [--scope <slice>] [--format csv|json] [--out <file>] [--json]\",\n  usage:\n    \"usage report|export|leaderboard [--by <dim>] [--since <dur>] [--platform <id>] [--format csv|json] [--out <file>] [--json]\",\n  leaderboard: \"leaderboard [--since <dur>] [--connector <id>] [--scope <slice>] [--json]\",\n  hook: \"hook <platform> <event> --connector <id>   (internal — host hook configs point here)\",\n  statusline:\n    \"statusline <platform> --connector <id>   (internal — host status line configs point here)\",\n  action:\n    \"action <platform> <actionId> --connector <id>   (internal — host action affordances point here)\",\n  serve:\n    \"serve --connector <id> [--scope user|project] [--host <platformId>] -- <command> [args...]   (internal — host MCP entries point here)\",\n};\n\n/**\n * Build the top-level usage string for a given program name. The brand replaces\n * \"agent-connector\" in the title, the `usage:` line, and the per-command help\n * footer so an embedded CLI (e.g. `acme-db`) reads as its own tool.\n */\nfunction buildUsage(programName: string): string {\n  return `${programName} — write your MCP server + hooks once, install everywhere.\n\nusage: ${programName} <command> [flags]\n\ncommands:\n  detect       List the AI-agent platforms installed on this machine.\n  install      Deploy a connector across its target platforms (--method direct writes host config; --method marketplace drives the host's plugin install).\n  uninstall    Remove a connector's registrations (--method auto reverses whichever method is actually installed).\n  upgrade      Bring everything current: re-render host config + heal the home pointer + managed update guidance (alias: update, sync).\n  package      Emit a marketplace/extension bundle (9 host formats; default agent-plugin = the portable Agent Plugins 1.0.0 bundle Codex/Copilot/VS Code/Kiro/Hermes install, or the standard artifacts mcp-server-json | mcpb).\n  audit        Check branded package identity before install/publish.\n  doctor       Health-check every detected platform; non-zero exit on any failure.\n  status       Light install-state summary: which connectors are present on which hosts (always exits 0).\n  telemetry    Inspect local per-tool token telemetry (report | export | leaderboard).\n  usage        Inspect host-native token usage from agent host logs (report | export | leaderboard).\n  leaderboard  Three leaderboards: 🔌 MCP/plugin (mcp-self) + 🖥️ host/user (host-scan-logs) + 🛰️ host-native turns (host-native-live) — never summed.\n  hook         Universal json-stdio hook entrypoint (hosts call this).\n  serve        Telemetry-wrapping MCP stdio proxy (wraps a real server command).\n\nRun \\`${programName} <command> --help\\` for command-specific flags.`;\n}\n\n/** Options accepted by {@link main}. */\nexport interface MainOptions {\n  /**\n   * The brand shown in usage/help text. Defaults to {@link DEFAULT_PROGRAM_NAME}.\n   * An embedding SDK CLI (see cli/sdk.ts) passes its own bin name so every\n   * subcommand's help reads as the developer's tool.\n   */\n  programName?: string;\n  /**\n   * Version shown by --version. Defaults to agent-connector's own package version.\n   * Embedded branded CLIs pass their package.json version.\n   */\n  programVersion?: string;\n}\n\nexport async function main(argv: string[], opts: MainOptions = {}): Promise<number> {\n  const programName = opts.programName ?? DEFAULT_PROGRAM_NAME;\n  activeProgramName = programName; // brand every fail() in this invocation\n  const usage = buildUsage(programName);\n  const command = argv[0];\n\n  if (command == null || command === \"--help\" || command === \"-h\" || command === \"help\") {\n    print(usage);\n    return command == null ? 1 : 0;\n  }\n  if (command === \"--version\" || command === \"-v\") {\n    print(`${programName} ${opts.programVersion ?? resolveOwnVersion()}`);\n    return 0;\n  }\n\n  const loader = COMMANDS[command];\n  if (!loader) {\n    process.stderr.write(`${programName}: unknown command \"${command}\"\\n\\n`);\n    process.stderr.write(`${usage}\\n`);\n    return 2;\n  }\n\n  // Per-command help: no command module defines a --help flag (strict parseArgs\n  // would throw on it), so answer it centrally from COMMAND_USAGE.\n  const rest = argv.slice(1);\n  if (rest.includes(\"--help\") || rest.includes(\"-h\")) {\n    const sig = COMMAND_USAGE[command];\n    if (sig) {\n      print(`usage: ${programName} ${sig}`);\n      return 0;\n    }\n  }\n\n  const mod = await loader();\n  try {\n    return await mod.run(rest);\n  } catch (err) {\n    // Friendly bad-flag errors: strict parseArgs throws ERR_PARSE_ARGS_* for an\n    // unknown/malformed option — print the message + the usage line instead of\n    // letting a raw stack trace reach the user. Everything else still rethrows\n    // (the bin entry reports those as fatal).\n    const code = (err as { code?: string }).code;\n    if (typeof code === \"string\" && code.startsWith(\"ERR_PARSE_ARGS\")) {\n      const message = err instanceof Error ? err.message : String(err);\n      const sig = COMMAND_USAGE[command];\n      if (sig) process.stderr.write(`usage: ${programName} ${sig}\\n`);\n      return fail(message);\n    }\n    throw err;\n  }\n}\n","/**\n * cli/banner — the branded ASCII-art header shown once atop install / uninstall\n * / upgrade / doctor.\n *\n * Two PURE functions drive everything (no process.* reads here — the command\n * wiring injects the real env so tests can call these directly without a TTY):\n *\n *   renderBrandBanner(name, { color, columns, palette })  → the banner string\n *   shouldShowBanner({ isTTY, noColor, json, quiet }) → whether to show it\n *\n * RESPONSIVE (one line, NEVER stacked), two forms:\n *   • WIDE — a 6-row \"ANSI Shadow\" block font (solid `█` + `╗╔╝╚║═` shadow,\n *     ~8 cols/char, hand-transcribed + fixed-width so it tiles cleanly) when its\n *     render fits the terminal width.\n *   • NARROW — a single-line gradient TITLE `◆  AGENT-CONNECTOR` (the brand\n *     uppercased, each char colored along the palette + bold). ~18 cols, so it\n *     fits any real terminal; it is the universal narrow form.\n * The WIDE font covers the connector-id charset [A-Za-z0-9 ._-].\n *\n * COLOR: a palette gradient (three RGB stops, a {@link Palette}) — swept per\n * column across the block art, or per character across the title. The render is\n * PURE and palette-parameterized — the caller picks the palette (the impure\n * app.ts wrapper rotates {@link PALETTES} per run). truecolor→256→16→none tiers\n * all honor the palette; NO_COLOR = zero ANSI.\n */\n\n/** Color capability the host terminal advertises, highest → lowest. */\nexport type ColorMode = \"truecolor\" | \"ansi256\" | \"ansi16\" | \"none\";\n\n/** A 24-bit RGB triple. */\nexport type RGB = readonly [number, number, number];\n\n/** A 3-stop gradient: the sweep lerps stop0 → stop1 → stop2 across the columns. */\nexport type Palette = readonly [RGB, RGB, RGB];\n\n/**\n * The 10 rotation palettes. The impure {@link maybePrintBanner} wrapper picks one\n * at random per run so each real invocation shows a different color; the pure\n * renderer defaults to PALETTES[0] so direct callers + tests stay deterministic.\n */\nexport const PALETTES: readonly Palette[] = [\n  [[255, 210, 0], [255, 110, 10], [220, 30, 25]], // Sunset\n  [[255, 225, 90], [255, 120, 0], [200, 20, 20]], // Lava\n  [[230, 30, 30], [255, 120, 0], [255, 220, 0]], // Fire\n  [[255, 225, 120], [255, 170, 40], [225, 110, 20]], // Amber gold\n  [[255, 205, 150], [255, 150, 130], [255, 120, 175]], // Peach pastel\n  [[255, 80, 170], [200, 40, 200], [100, 60, 210]], // Berry\n  [[0, 220, 180], [0, 160, 230], [60, 90, 230]], // Ocean\n  [[80, 230, 140], [0, 200, 210], [150, 90, 235]], // Aurora\n  [[170, 230, 90], [60, 200, 120], [20, 150, 140]], // Forest\n  [[0, 200, 200], [40, 80, 230], [200, 40, 200]], // Synthwave\n] as const;\n\n/** Inputs to {@link renderBrandBanner} — all injected, never read from process. */\nexport interface BannerOptions {\n  /** Color capability to render at. \"none\" emits zero ANSI codes. */\n  color: ColorMode;\n  /** Terminal width in columns; selects the form (wide block art → one-line title). */\n  columns: number;\n  /** The 3-stop gradient. Defaults to {@link PALETTES}[0] (Sunset) when omitted. */\n  palette?: Palette;\n}\n\n/** Inputs to {@link shouldShowBanner} — the real env, injected by the caller. */\nexport interface BannerGate {\n  /** process.stdout.isTTY (banner is suppressed entirely when not a TTY). */\n  isTTY: boolean;\n  /** NO_COLOR is set (the banner still shows, but with zero color codes). */\n  noColor: boolean;\n  /** A machine-readable --json was requested (suppress entirely). */\n  json: boolean;\n  /** An explicit --quiet was passed (suppress entirely). */\n  quiet: boolean;\n}\n\n/**\n * Whether to print the banner at all. The banner is decorative, so it shows ONLY\n * for an interactive TTY and never when output is being consumed by a script or\n * pipeline: not when piped/redirected (`!isTTY`), not under `--json`, and not\n * under `--quiet`. `NO_COLOR` does NOT suppress it — the banner renders without\n * color in that case (handled by {@link resolveColorMode}).\n */\nexport function shouldShowBanner(gate: BannerGate): boolean {\n  return gate.isTTY && !gate.json && !gate.quiet;\n}\n\n/**\n * Resolve the color tier from the (injected) terminal env. 24-bit when the\n * terminal advertises it (COLORTERM=truecolor|24bit), 256-color when TERM names\n * a 256 palette, else 16-color — and PLAIN (no color) under NO_COLOR or a dumb /\n * absent TERM.\n */\nexport function resolveColorMode(env: {\n  noColor: boolean;\n  colorterm?: string | undefined;\n  term?: string | undefined;\n}): ColorMode {\n  if (env.noColor) return \"none\";\n  const term = (env.term ?? \"\").toLowerCase();\n  if (term === \"\" || term === \"dumb\") return \"none\";\n  const colorterm = (env.colorterm ?? \"\").toLowerCase();\n  if (colorterm === \"truecolor\" || colorterm === \"24bit\") return \"truecolor\";\n  if (term.includes(\"256\")) return \"ansi256\";\n  return \"ansi16\";\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// WIDE font — \"ANSI Shadow\" (6 rows). Hand-transcribed bold figlet glyphs —\n// solid `█` with a `╗╔╝╚║═` 3D shadow — fixed-width per glyph so they TILE\n// cleanly when concatenated (~8 cols/char → \"agent-connector\" ≈ 126 cols on\n// one line). Used only when the terminal is wide enough.\n// ─────────────────────────────────────────────────────────────────────────\n\nconst WIDE_FONT: Record<string, readonly string[]> = {\n  A: [\" █████╗ \", \"██╔══██╗\", \"███████║\", \"██╔══██║\", \"██║  ██║\", \"╚═╝  ╚═╝\"],\n  B: [\"██████╗ \", \"██╔══██╗\", \"██████╔╝\", \"██╔══██╗\", \"██████╔╝\", \"╚═════╝ \"],\n  C: [\" ██████╗\", \"██╔════╝\", \"██║     \", \"██║     \", \"╚██████╗\", \" ╚═════╝\"],\n  D: [\"██████╗ \", \"██╔══██╗\", \"██║  ██║\", \"██║  ██║\", \"██████╔╝\", \"╚═════╝ \"],\n  E: [\"███████╗\", \"██╔════╝\", \"█████╗  \", \"██╔══╝  \", \"███████╗\", \"╚══════╝\"],\n  F: [\"███████╗\", \"██╔════╝\", \"█████╗  \", \"██╔══╝  \", \"██║     \", \"╚═╝     \"],\n  G: [\" ██████╗ \", \"██╔════╝ \", \"██║  ███╗\", \"██║   ██║\", \"╚██████╔╝\", \" ╚═════╝ \"],\n  H: [\"██╗  ██╗\", \"██║  ██║\", \"███████║\", \"██╔══██║\", \"██║  ██║\", \"╚═╝  ╚═╝\"],\n  I: [\"██╗\", \"██║\", \"██║\", \"██║\", \"██║\", \"╚═╝\"],\n  J: [\"     ██╗\", \"     ██║\", \"     ██║\", \"██   ██║\", \"╚█████╔╝\", \" ╚════╝ \"],\n  K: [\"██╗  ██╗\", \"██║ ██╔╝\", \"█████╔╝ \", \"██╔═██╗ \", \"██║  ██╗\", \"╚═╝  ╚═╝\"],\n  L: [\"██╗     \", \"██║     \", \"██║     \", \"██║     \", \"███████╗\", \"╚══════╝\"],\n  M: [\"███╗   ███╗\", \"████╗ ████║\", \"██╔████╔██║\", \"██║╚██╔╝██║\", \"██║ ╚═╝ ██║\", \"╚═╝     ╚═╝\"],\n  N: [\"███╗   ██╗\", \"████╗  ██║\", \"██╔██╗ ██║\", \"██║╚██╗██║\", \"██║ ╚████║\", \"╚═╝  ╚═══╝\"],\n  O: [\" ██████╗ \", \"██╔═══██╗\", \"██║   ██║\", \"██║   ██║\", \"╚██████╔╝\", \" ╚═════╝ \"],\n  P: [\"██████╗ \", \"██╔══██╗\", \"██████╔╝\", \"██╔═══╝ \", \"██║     \", \"╚═╝     \"],\n  Q: [\" ██████╗ \", \"██╔═══██╗\", \"██║   ██║\", \"██║▄▄ ██║\", \"╚██████╔╝\", \" ╚══▀▀═╝ \"],\n  R: [\"██████╗ \", \"██╔══██╗\", \"██████╔╝\", \"██╔══██╗\", \"██║  ██║\", \"╚═╝  ╚═╝\"],\n  S: [\"███████╗\", \"██╔════╝\", \"███████╗\", \"╚════██║\", \"███████║\", \"╚══════╝\"],\n  T: [\"████████╗\", \"╚══██╔══╝\", \"   ██║   \", \"   ██║   \", \"   ██║   \", \"   ╚═╝   \"],\n  U: [\"██╗   ██╗\", \"██║   ██║\", \"██║   ██║\", \"██║   ██║\", \"╚██████╔╝\", \" ╚═════╝ \"],\n  V: [\"██╗   ██╗\", \"██║   ██║\", \"██║   ██║\", \"╚██╗ ██╔╝\", \" ╚████╔╝ \", \"  ╚═══╝  \"],\n  W: [\"██╗    ██╗\", \"██║    ██║\", \"██║ █╗ ██║\", \"██║███╗██║\", \"╚███╔███╔╝\", \" ╚══╝╚══╝ \"],\n  X: [\"██╗  ██╗\", \"╚██╗██╔╝\", \" ╚███╔╝ \", \" ██╔██╗ \", \"██╔╝ ██╗\", \"╚═╝  ╚═╝\"],\n  Y: [\"██╗   ██╗\", \"╚██╗ ██╔╝\", \" ╚████╔╝ \", \"  ╚██╔╝  \", \"   ██║   \", \"   ╚═╝   \"],\n  Z: [\"███████╗\", \"╚══███╔╝\", \"  ███╔╝ \", \" ███╔╝  \", \"███████╗\", \"╚══════╝\"],\n  \"0\": [\" ██████╗ \", \"██╔═████╗\", \"██║██╔██║\", \"████╔╝██║\", \"╚██████╔╝\", \" ╚═════╝ \"],\n  \"1\": [\" ██╗\", \"███║\", \"╚██║\", \" ██║\", \" ██║\", \" ╚═╝\"],\n  \"2\": [\"██████╗ \", \"╚════██╗\", \" █████╔╝\", \"██╔═══╝ \", \"███████╗\", \"╚══════╝\"],\n  \"3\": [\"██████╗ \", \"╚════██╗\", \" █████╔╝\", \" ╚═══██╗\", \"██████╔╝\", \"╚═════╝ \"],\n  \"4\": [\"██╗  ██╗\", \"██║  ██║\", \"███████║\", \"╚════██║\", \"     ██║\", \"     ╚═╝\"],\n  \"5\": [\"███████╗\", \"██╔════╝\", \"███████╗\", \"╚════██║\", \"███████║\", \"╚══════╝\"],\n  \"6\": [\" ██████╗ \", \"██╔════╝ \", \"███████╗ \", \"██╔═══██╗\", \"╚██████╔╝\", \" ╚═════╝ \"],\n  \"7\": [\"███████╗\", \"╚════██║\", \"    ██╔╝\", \"   ██╔╝ \", \"   ██║  \", \"   ╚═╝  \"],\n  \"8\": [\" █████╗ \", \"██╔══██╗\", \"╚█████╔╝\", \"██╔══██╗\", \"╚█████╔╝\", \" ╚════╝ \"],\n  \"9\": [\" █████╗ \", \"██╔══██╗\", \"╚██████║\", \" ╚═══██║\", \" █████╔╝\", \" ╚════╝ \"],\n  \"-\": [\"      \", \"      \", \"█████╗\", \"╚════╝\", \"      \", \"      \"],\n  \"_\": [\"       \", \"       \", \"       \", \"       \", \"███████╗\", \"╚══════╝\"],\n  \".\": [\"   \", \"   \", \"   \", \"   \", \"██╗\", \"╚═╝\"],\n  \" \": [\"    \", \"    \", \"    \", \"    \", \"    \", \"    \"],\n};\n\nconst GLYPH_ROWS = 6;\n\n/** Visible column count of a string (full-block + box-drawing are 1 cell each). */\nfunction vlen(s: string): number {\n  return [...s].length;\n}\n\n/**\n * Render `name` into the fixed-width `font` as GLYPH_ROWS lines. The ANSI-Shadow\n * glyphs already carry their own trailing shadow column and tile cleanly with NO\n * inter-glyph gap. Returns null when the name has no renderable characters; the\n * glyphs are width-consistent per glyph, so the rows stay aligned.\n */\nfunction renderWithFont(name: string, font: Record<string, readonly string[]>): string[] | null {\n  const chars = [...name];\n  if (chars.length === 0) return null;\n  const blank = font[\" \"]!;\n  const rows: string[] = Array.from({ length: GLYPH_ROWS }, () => \"\");\n  for (const ch of chars) {\n    const glyph = font[ch.toUpperCase()] ?? blank;\n    for (let r = 0; r < GLYPH_ROWS; r++) {\n      rows[r] += glyph[r] ?? \"\";\n    }\n  }\n  // Drop any fully-blank bottom rows so a name built from narrower glyphs (e.g.\n  // \".\" / \"_\") never pads the banner with trailing empty lines.\n  while (rows.length > 1 && rows[rows.length - 1]!.trim() === \"\") rows.pop();\n  return rows;\n}\n\n/** Max visible width across an art block's rows. */\nfunction blockWidth(rows: string[]): number {\n  return rows.length === 0 ? 0 : Math.max(...rows.map(vlen));\n}\n\n/**\n * The WIDE ANSI-Shadow block art for `name` when it fits `columns` (ONE line,\n * never stacked); else null so the caller renders the narrow one-line title.\n * `columns <= 0` means \"no constraint\" → always the WIDE art.\n */\nfunction selectWideArt(name: string, columns: number): string[] | null {\n  const limit = columns > 0 ? columns : Infinity;\n  const wide = renderWithFont(name, WIDE_FONT);\n  return wide != null && blockWidth(wide) <= limit ? wide : null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Palette-parameterized gradient. The sweep lerps the three palette stops\n// across each row's columns (t∈[0,1]). truecolor uses the exact RGB; 256 and 16\n// derive the nearest representable code FROM the same RGB, so every palette\n// works in every tier. \"none\" emits the bare char.\n// ─────────────────────────────────────────────────────────────────────────\n\n/** The interpolated RGB of `palette` at gradient position t∈[0,1]. */\nfunction gradientRGB(t: number, palette: Palette): RGB {\n  const clamp = Math.max(0, Math.min(1, t));\n  const seg = clamp >= 0.5 ? 1 : 0;\n  const local = (clamp - seg * 0.5) / 0.5;\n  const a = palette[seg]!;\n  const b = palette[seg + 1]!;\n  return [\n    Math.round(a[0] + (b[0] - a[0]) * local),\n    Math.round(a[1] + (b[1] - a[1]) * local),\n    Math.round(a[2] + (b[2] - a[2]) * local),\n  ];\n}\n\n/** Nearest xterm-256 cube index (16..231) for an RGB triple. */\nfunction rgbTo256(r: number, g: number, b: number): number {\n  const q = (v: number): number => (v < 48 ? 0 : v < 115 ? 1 : Math.round((v - 35) / 40));\n  return 16 + 36 * q(r) + 6 * q(g) + q(b);\n}\n\n/** Nearest of the 8 bright 16-color fg codes (90..97) for an RGB triple. */\nfunction rgbTo16(r: number, g: number, b: number): number {\n  // Threshold each channel; map the on/off triple to its bright SGR code.\n  const hi = (v: number): number => (v >= 128 ? 1 : 0);\n  const key = (hi(r) << 2) | (hi(g) << 1) | hi(b);\n  // index: RGB bits → code. 0:black(90) 1:blue(94) 2:green(92) 3:cyan(96)\n  //        4:red(91) 5:magenta(95) 6:yellow(93) 7:white(97)\n  return [90, 94, 92, 96, 91, 95, 93, 97][key]!;\n}\n\nconst RESET = \"\\x1b[0m\";\n\n/**\n * Wrap a single grapheme `ch` at gradient position `t` in the SGR escape for the\n * given color tier + palette. Whitespace is never colored (no point paying for\n * an escape around a space) and \"none\" returns the bare char.\n */\nfunction colorChar(ch: string, t: number, color: ColorMode, palette: Palette): string {\n  if (color === \"none\" || ch.trim() === \"\") return ch;\n  const [r, g, b] = gradientRGB(t, palette);\n  if (color === \"truecolor\") return `\\x1b[38;2;${r};${g};${b}m${ch}${RESET}`;\n  if (color === \"ansi256\") return `\\x1b[38;5;${rgbTo256(r, g, b)}m${ch}${RESET}`;\n  return `\\x1b[${rgbTo16(r, g, b)}m${ch}${RESET}`;\n}\n\n/** Apply the left-to-right gradient across one art row (by visible column). */\nfunction colorizeRow(row: string, color: ColorMode, palette: Palette): string {\n  if (color === \"none\") return row;\n  const chars = [...row];\n  const width = Math.max(1, chars.length - 1);\n  let out = \"\";\n  for (let i = 0; i < chars.length; i++) {\n    out += colorChar(chars[i]!, i / width, color, palette);\n  }\n  return out;\n}\n\n/** A single BOLD grapheme at gradient position `t` (used by the narrow title). */\nfunction boldColorChar(ch: string, t: number, color: ColorMode, palette: Palette): string {\n  if (color === \"none\") return ch;\n  const [r, g, b] = gradientRGB(t, palette);\n  const fg =\n    color === \"truecolor\"\n      ? `38;2;${r};${g};${b}`\n      : color === \"ansi256\"\n        ? `38;5;${rgbTo256(r, g, b)}`\n        : `${rgbTo16(r, g, b)}`;\n  return `\\x1b[1;${fg}m${ch}${RESET}`;\n}\n\n/**\n * The NARROW one-line title `◆  AGENT-CONNECTOR`: a colored leading diamond (the\n * palette mid stop), two spaces, then the UPPERCASED brand with each character\n * colored along the palette gradient (i → t = i/(len-1)) and bold. Under \"none\"\n * it is the plain text with ZERO ANSI. ~18 cols for \"agent-connector\", so it\n * fits any real terminal.\n */\nfunction renderTitle(name: string, color: ColorMode, palette: Palette): string {\n  const upper = name.toUpperCase();\n  if (color === \"none\") return `◆  ${upper}`;\n  const diamond = boldColorChar(\"◆\", 0.5, color, palette);\n  const chars = [...upper];\n  const span = Math.max(1, chars.length - 1);\n  let title = \"\";\n  for (let i = 0; i < chars.length; i++) {\n    title += boldColorChar(chars[i]!, i / span, color, palette);\n  }\n  return `${diamond}  ${title}`;\n}\n\n// ─────────────────────────────────────────────────────────────────────────\n// Footer (engine attribution). Shown on BOTH the global and branded CLIs — the\n// \"powered by\" wording is intentional.\n// ─────────────────────────────────────────────────────────────────────────\n\nconst FOOTER_LINES = [\n  \"powered by @ken-jo/agent-connector\",\n  \"more → https://github.com/ken-jo/agent-connector\",\n] as const;\n\n/** Dim (de-emphasized) footer line; plain under \"none\". */\nfunction dim(text: string, color: ColorMode): string {\n  return color === \"none\" ? text : `\\x1b[2m${text}${RESET}`;\n}\n\n/**\n * Render the full banner: a responsive brand title with a palette-driven\n * gradient, then a two-line dim footer directly below.\n *\n *   • WIDE — the ANSI-Shadow block art when it fits `columns` (ONE line, never\n *     stacked; `columns <= 0` = no constraint).\n *   • NARROW — the one-line `◆  AGENT-CONNECTOR` gradient title (the universal\n *     narrow form, ~18 cols) when the block art would overflow.\n *   • `palette` defaults to PALETTES[0] so direct callers + tests are\n *     deterministic; the impure app.ts wrapper rotates the palettes per run.\n *   • Under `color: \"none\"` (NO_COLOR / dumb term) the output carries zero ANSI\n *     escape codes — only the raw art/title + footer text.\n *\n * The result has NO trailing newline; the caller prints it with one.\n */\nexport function renderBrandBanner(name: string, opts: BannerOptions): string {\n  const { color, columns } = opts;\n  const palette = opts.palette ?? PALETTES[0]!;\n  const footer = FOOTER_LINES.map((l) => dim(l, color)).join(\"\\n\");\n\n  const art = selectWideArt(name, columns);\n  const body =\n    art != null\n      ? art.map((row) => colorizeRow(row, color, palette)).join(\"\\n\")\n      : renderTitle(name, color, palette);\n  return `${body}\\n${footer}`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-O7CFTOM5.js → chunk-S2TAC22E.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   REGISTERED_PLATFORM_IDS
-} from "./chunk-QG26JEJF.js";
+} from "./chunk-7C3COFOD.js";
 import {
   CONFIG_PATCH_SEGMENT_RE,
   configPatchNamespaceViolation,
@@ -773,4 +773,4 @@ export {
   defineConfigPatch,
   defineNativeHook
 };
-//# sourceMappingURL=chunk-O7CFTOM5.js.map
+//# sourceMappingURL=chunk-S2TAC22E.js.map