Refactor Codex adapter lifecycle helpers

[juliusmarminge]

• Split adapter setup into named Effect.fn helpers
• Keep listener registration and cleanup explicit

What Changed

Why

UI Changes

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

---

Note

Low Risk
Refactor-only change in the Codex provider adapter; primary risk is subtle lifecycle/cleanup differences around manager acquisition and event listener registration/shutdown.

Overview
Refactors apps/server/src/provider/Layers/CodexAdapter.ts to break makeCodexAdapter into named Effect.fn helpers, improving stack traces and making the lifecycle steps more explicit.

This extracts helpers for manager acquisition (acquireManager), attachment loading/encoding (resolveAttachment used by sendTurn), and event listener registration/cleanup (registerListener/unregisterListener plus writeNativeEvent), while keeping the adapter’s public operations and error mapping behavior the same.

^{Written by Cursor Bugbot for commit 9b9c9b3. This will update automatically on new commits. Configure here.}

Note

Refactor CodexAdapter lifecycle helpers into named Effect.fn generators

Restructures CodexAdapter.ts to use named Effect.fn generators throughout, improving traceability in Effect traces.

• Extracts acquireManager as a standalone helper that resolves an existing manager from options or constructs one via CodexAppServerManager
• Adds resolveAttachment helper to consolidate inline file-reading logic from sendTurn, using Effect.forEach with concurrency 1
• Extracts registerListener and unregisterListener as named helpers wired via Effect.acquireRelease, and adds writeNativeEvent to isolate native event logging
• No behavioral changes; all handler logic (session management, turn sending, thread operations) is preserved as-is

^{Macroscope summarized 9b9c9b3.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 01f6268a-0e28-45cf-9b3a-843cfef2fb9e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/refactor-codex-adapter-lifecycle

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}