effect-codex-app-server

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}

[juliusmarminge]

Typesafe JSONRPC effect API for Codex App Server. Generated from the protocol's JSON schemas

import*asConsolefrom"effect/Console";import*asEffectfrom"effect/Effect";import*asNodeRuntimefrom"@effect/platform-node/NodeRuntime";import*asNodeServicesfrom"@effect/platform-node/NodeServices";import*asCodexClientfrom"effect-codex-app-server/client";constprogram=Effect.gen(function*(){constcodexLayer=CodexClient.layerCommand({command: process.env.CODEX_BIN??"codex",args: ["app-server"],cwd: process.cwd(),logIncoming: true,logOutgoing: true,});yield*Effect.gen(function*(){constclient=yield*CodexClient.CodexAppServerClient;yield*client.handleServerRequest("item/tool/requestUserInput",(payload)=>Effect.succeed({answers: Object.fromEntries(payload.questions.map((question)=>[question.id,{answers:
question.options&&question.options.length>0
? [question.options[0]!.label]
: ["ok"],},]),),}),);constinitialized=yield*client.request("initialize",{clientInfo: {name: "effect-codex-app-server-probe",title: "Effect Codex App Server Probe",version: "0.0.0",},capabilities: {experimentalApi: true,optOutNotificationMethods: null,},});yield*Console.log("initialize",JSON.stringify(initialized,null,2));yield*client.notify("initialized",undefined);constaccount=yield*client.request("account/read",{});yield*Console.log("account/read",JSON.stringify(account,null,2));constskills=yield*client.request("skills/list",{cwds: [process.cwd()],});yield*Console.log("skills/list",JSON.stringify(skills,null,2));}).pipe(Effect.provide(codexLayer));});program.pipe(Effect.scoped,Effect.provide(NodeServices.layer),NodeRuntime.runMain);

---

Note

Medium Risk
Moderate risk because it replaces the Codex provider’s session/runtime implementation and event mapping, which can affect session lifecycle and downstream consumers of provider events.

Overview
Switches the server’s Codex integration from the in-repo CodexAppServerManager to the effect-codex-app-server typed JSON-RPC runtime, including per-thread scoped session lifecycles and a new schema-driven mapping from raw Codex notifications/requests to canonical runtime events.

Removes the legacy manager implementation and its large test suite, adds shared CodexDeveloperInstructions constants, and updates Codex git text generation to use fastMode directly (dropping capability-based normalization). The Codex adapter tests are rewritten to exercise the new runtime factory/scoping behavior, native event log flushing on layer shutdown, and updated payload shapes (e.g., user-input answers, request resolution, plan item typing).

^{Reviewed by Cursor Bugbot for commit 97a9354. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add effect-codex-app-server package with typed RPC client and migrate Codex provider to app-server protocol

• Introduces a new packages/effect-codex-app-server package providing a JSONL-over-stdio RPC client, generated protocol schemas, and structured error types for communicating with the Codex app-server subprocess.
• Rewrites the Codex provider in CodexProvider.ts to probe provider status by spawning the app-server and querying it via RPC for account, models, and skills, replacing all CLI-based auth parsing and config.toml logic.
• Rewrites CodexAdapter.ts to manage per-thread CodexSessionRuntimeShape instances directly, streaming typed events into a queue via a per-session fiber, replacing CodexAppServerManager and its event emitter.
• Adds CodexSessionRuntime.ts defining the session runtime interface, options, and schemas consumed by the adapter.
• Risk: Built-in model defaults, CLI version gating, and config.toml-driven provider selection are permanently removed; deployments relying on those paths will need the app-server binary available.

^{Macroscope summarized 97a9354.}