Class CodexAdapter

tools/adapters/codex.py:328–654

class CodexAdapter(HarnessAdapter):
    harness_id = "codex"
    # Effective cap for the body. Codex's hard limit is 8192 bytes of *injected* skill
    # content; we leave ~700 bytes of headroom for frontmatter + the pointer note we
    # add when splitting, so the emitted SKILL.md file stays under the limit.
    SKILL_BODY_CAP = 7400
    AGENTS_MD_LINE_CAP = 150

    def __init__(
        self,
        output_root: Path | None = None,
        repo_root: Path | None = None,
    ) -> None:
        super().__init__(output_root=output_root)
        # AGENTS.md is committed at the repo root, not under output_root.
        # Tests override repo_root to point at a temp dir.
        self.repo_root = repo_root if repo_root is not None else WORKTREE

    def emit_plugin(self, plugin: PluginSource) -> EmitResult:
        result = EmitResult()

        # Detect skill/command name collisions before emitting — Codex maps both into
        # `.codex/skills/<plugin>__<name>/`, so duplicates would silently overwrite.
        skill_names = {s.name for s in plugin.skills}
        command_collisions = {c.name for c in plugin.commands} & skill_names

        # Second-order collision: if a skill is literally named `<x>__command`, the
        # `__command` suffix the adapter uses for collision-resolution would clash
        # with it. Detect and route the command-skill to `__cmd` instead.
        skill_suffix_conflicts: set[str] = set()
        for cmd_name in command_collisions:
            if f"{cmd_name}__command" in skill_names:
                skill_suffix_conflicts.add(cmd_name)
                result.warnings.append(
                    f"plugin `{plugin.name}` has skill `{cmd_name}`, command `{cmd_name}`, "
                    f"AND skill `{cmd_name}__command` — command-skill routed to "
                    f"`{cmd_name}__cmd` to avoid second-order collision"
                )

        for skill in plugin.skills:
            self._emit_skill(plugin, skill, result)
        for agent in plugin.agents:
            self._emit_agent(plugin, agent, result)
        # Codex deprecated prompts in favor of skills. Synthesize a skill from each command.
        for cmd in plugin.commands:
            collides = cmd.name in command_collisions
            suffix_conflict = cmd.name in skill_suffix_conflicts
            self._emit_command_as_skill(
                plugin,
                cmd,
                result,
                collides=collides,
                fallback_suffix=suffix_conflict,
            )

        # Per-plugin Codex manifest for native marketplace install (reads source skills).
        self._emit_codex_plugin_manifest(plugin, result)