@shivaedev/agent-codex 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.6.0 - 2026-11-06
+
+### Breaking
+
+- Import the rate-limit event adapter from `adapters/rateLimitEvents.ts` instead of `adapters/rateLimits.ts`.
+
+## 0.5.0 - 2026-11-05
+
+### Breaking
+
+- Import `Codex` from `@shivaedev/agent-codex/codex/service.ts` and `codexLayer` from `@shivaedev/agent-codex/codexLayer.ts` instead of the former combined module. Provide `codexLayer` with `CodexConfig`; it supplies the adapter engine service for every Codex operation. Replace direct adapter `engine(config, spawn)` construction with this Layer; custom process adapters provide `ProcessSpawner` from `@shivaedev/agent-codex/adapters/process.ts` through a Layer.
+- Replace the spawn callback arguments to the low-level `initializeEngine` and `openServer` adapters with `ProcessSpawner` provision. Use `codexLayer` instead of calling `initializeCodex` or `configuredBackend` directly; initialization now returns the configured engine interface, and backend assembly yields `Codex` from the environment.
+- The low-level adapter `backend(state)` returns the configured backend directly. Remove the trailing function call and Effect execution when constructing it; application code continues to call the Effect-returning `Codex.backend()` operation.
+
 ## 0.4.0 - 2026-11-05
 
 ### Breaking

package/README.md

@@ -23,14 +23,14 @@ const program = Effect.gen(function* () {
 
 ## Using the adapter
 
-The Layer owns one local `codex app-server` process. Keep the caller's scope open for queued delivery and event observation. A receipt identifies a provider turn and its thread; acceptance does not mean completion. `inspect` and transcript reads query provider history without resuming a thread.
+The Layer owns one local `codex app-server` process and provides its adapter engine as a service. `Codex` declares that engine once; its operations yield it from the environment and keep no dependency in initializer state. Applications provide only `codexLayer` and `CodexConfig`. Keep the caller's scope open for queued delivery and event observation. A receipt identifies a provider turn and its thread; acceptance does not mean completion. `inspect` and transcript reads query provider history without resuming a thread.
 
 Provide the program above with the Codex Layer and its configuration:
 
 ```ts
 import { Effect, Layer } from "effect";
 import { CodexConfig } from "@shivaedev/agent-codex/config.ts";
-import { codexLayer } from "@shivaedev/agent-codex/codex.ts";
+import { codexLayer } from "@shivaedev/agent-codex/codexLayer.ts";
 
 const live = codexLayer.pipe(Layer.provide(Layer.succeed(CodexConfig)({})));
 await Effect.runPromise(program.pipe(Effect.scoped, Effect.provide(live)));
@@ -42,7 +42,9 @@ The backend declares sessions, queued input, steering, interruption, transcripts
 
 `CodexConfig` accepts a command, arguments, process working directory, request timeout, sandbox, base instructions and dynamic tools. A tool supplies its name, description, JSON input schema and an Effect returning `{ ok, text }`. Tools are registered for the live root thread on start and resume. Tool inheritance by child threads is unsupported. Provider approval and interactive input consumers are unsupported; requests are declined. Cloud transport, remote endpoints, runner logs, wake scheduling, application storage and agent identity are outside this package.
 
-Read `Codex` from Effect's environment and call `census(rootThreadId)` to passively list descendants and claim their ownership. Child threads cannot be resumed because doing so changes their goals. Event mapping preserves item content, child attribution, rate-limit windows and raw frames when the shared vocabulary cannot express a provider item. Usage is provider-reported cumulative session usage; cost estimation is unsupported.
+Custom process adapters provide `ProcessSpawner` from `@shivaedev/agent-codex/adapters/process.ts` through a Layer. Its default spawns the configured local process; the adapter Layer releases the process when it closes.
+
+Import `Codex` from `@shivaedev/agent-codex/codex/service.ts`, yield it from Effect's environment and call `census(rootThreadId)` to passively list descendants and claim their ownership. Child threads cannot be resumed because doing so changes their goals. Event mapping preserves item content, child attribution, rate-limit windows and raw frames when the shared vocabulary cannot express a provider item. Usage is provider-reported cumulative session usage; cost estimation is unsupported.
 
 The initialize response is compared with the protocol's CLI pin and a mismatch is logged. Version drift is diagnostic, not protocol negotiation. Live provider validation belongs in the consuming application; scripted peers do not prove compatibility with a running provider.
 

package/dist/adapters/backend.d.ts

@@ -1,5 +1,4 @@
-import { Effect } from "effect";
 import type { ConfiguredBackend } from "@shivaedev/agent/backend.ts";
 import type { EngineState } from "#adapters/initializeEngine.ts";
-export declare function backend(state: EngineState): () => Effect.Effect<ConfiguredBackend, never, never>;
+export declare function backend(state: EngineState): ConfiguredBackend;
 //# sourceMappingURL=backend.d.ts.map

package/dist/adapters/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/adapters/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,wDAuBzC"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/adapters/backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAsB7D"}

package/dist/adapters/backend.js

@@ -1,6 +1,6 @@
 import { Effect, PubSub, Stream } from "effect";
 export function backend(state) {
-    const configured = {
+    return {
         backend: "codex",
         events: (receipt) => Stream.unwrap(Effect.gen(function* () {
             const session = state.sessions.get(receipt.session?.value ?? "");
@@ -18,6 +18,5 @@ export function backend(state) {
         reconcile: state.reconcile,
         start: state.start,
     };
-    return Effect.fn("Codex.backend")(() => Effect.succeed(configured));
 }
 //# sourceMappingURL=backend.js.map

package/dist/adapters/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/adapters/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhD,MAAM,UAAU,OAAO,CAAC,KAAkB;IACzC,MAAM,UAAU,GAAsB;QACrC,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CACnB,MAAM,CAAC,MAAM,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC,KAAK,CAAC;YACrB,CAAC;YACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,YAAY,CAAW;gBACpC,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE;gBACjC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE;aACvD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC,CACF;QACF,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;KAClB,CAAC;IACF,OAAO,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/adapters/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhD,MAAM,UAAU,OAAO,CAAC,KAAkB;IACzC,OAAO;QACN,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CACnB,MAAM,CAAC,MAAM,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC,KAAK,CAAC;YACrB,CAAC;YACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,YAAY,CAAW;gBACpC,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE;gBACjC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE;aACvD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC,CACF;QACF,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;KAClB,CAAC;AACH,CAAC"}

package/dist/adapters/census.js

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import { sweepSpawnedDescendants } from "#adapters/threadSweep.ts";
 export function census(state) {
-    return Effect.fn("Codex.census")((rootThreadId) => sweepSpawnedDescendants(state.read, rootThreadId).pipe(Effect.tap((children) => Effect.sync(() => {
+    return Effect.fn("CodexEngine.census")((rootThreadId) => sweepSpawnedDescendants(state.read, rootThreadId).pipe(Effect.tap((children) => Effect.sync(() => {
         for (const child of children) {
             state.claims.claim(rootThreadId, child.threadId);
         }

package/dist/adapters/census.js.map

@@ -1 +1 @@
-{"version":3,"file":"census.js","sourceRoot":"","sources":["../../src/adapters/census.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,UAAU,MAAM,CAAC,KAA2C;IACjE,OAAO,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,YAAoB,EAAE,EAAE,CACzD,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACvB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;IACF,CAAC,CAAC,CACF,CACD,CACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"census.js","sourceRoot":"","sources":["../../src/adapters/census.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,UAAU,MAAM,CAAC,KAA2C;IACjE,OAAO,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,YAAoB,EAAE,EAAE,CAC/D,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACvB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;IACF,CAAC,CAAC,CACF,CACD,CACD,CAAC;AACH,CAAC"}

package/dist/adapters/configuredBackend.d.ts

@@ -1,6 +1,3 @@
 import { Effect } from "effect";
-import type { ConfiguredBackend } from "@shivaedev/agent/backend.ts";
-export declare const configuredBackend: (codex: {
-    readonly backend: () => Effect.Effect<ConfiguredBackend>;
-}) => Effect.Effect<ConfiguredBackend, never, never>;
+export declare const configuredBackend: () => Effect.Effect<import("@shivaedev/agent/backend.ts").ConfiguredBackend, never, "@shivaedev/agent-codex/Codex">;
 //# sourceMappingURL=configuredBackend.d.ts.map

package/dist/adapters/configuredBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuredBackend.d.ts","sourceRoot":"","sources":["../../src/adapters/configuredBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,eAAO,MAAM,iBAAiB;sBAAoE,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;oDAEvI,CAAC"}
+{"version":3,"file":"configuredBackend.d.ts","sourceRoot":"","sources":["../../src/adapters/configuredBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,eAAO,MAAM,iBAAiB,qHAG5B,CAAC"}

package/dist/adapters/configuredBackend.js

@@ -1,3 +1,7 @@
 import { Effect } from "effect";
-export const configuredBackend = Effect.fn("Codex.configuredBackend")((codex) => codex.backend());
+import { Codex } from "#codex/service.ts";
+export const configuredBackend = Effect.fn("Codex.configuredBackend")(function* () {
+    const codex = yield* Codex;
+    return yield* codex.backend();
+});
 //# sourceMappingURL=configuredBackend.js.map

package/dist/adapters/configuredBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuredBackend.js","sourceRoot":"","sources":["../../src/adapters/configuredBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC,KAAmE,EAAE,EAAE,CAC7I,KAAK,CAAC,OAAO,EAAE,CACf,CAAC"}
+{"version":3,"file":"configuredBackend.js","sourceRoot":"","sources":["../../src/adapters/configuredBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,QAAQ,CAAC;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC;IAC3B,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC,CAAC,CAAC"}

package/dist/adapters/engine.d.ts

@@ -1,8 +1,10 @@
-import { Effect } from "effect";
-import type { LineProcess } from "#adapters/process.ts";
-import type { CodexConfiguration } from "#config.ts";
-export declare const engine: (config: CodexConfiguration, spawn?: (() => LineProcess) | undefined) => Effect.Effect<{
-    backend: () => Effect.Effect<import("@shivaedev/agent/backend.ts").ConfiguredBackend, never, never>;
+import { Context, type Effect, Layer } from "effect";
+declare const CodexEngine_base: Context.ServiceClass<CodexEngine, "@shivaedev/agent-codex/CodexEngine", {
+    backend: import("@shivaedev/agent/backend.ts").ConfiguredBackend;
     census: (rootThreadId: string) => Effect.Effect<import("./threadSweep.ts").CensusSweep, import("@shivaedev/agent/failures.ts").ReadFailure, never>;
-}, import("@shivaedev/agent/failures.ts").BackendUnavailable | import("@shivaedev/agent/failures.ts").ProtocolFailure | import("@shivaedev/agent/failures.ts").Rejected | import("@shivaedev/agent/failures.ts").UnknownAcceptance, import("effect/Scope").Scope>;
+}>;
+export declare class CodexEngine extends CodexEngine_base {
+}
+export declare const codexEngineLayer: Layer.Layer<CodexEngine, import("@shivaedev/agent/failures.ts").BackendUnavailable | import("@shivaedev/agent/failures.ts").ProtocolFailure | import("@shivaedev/agent/failures.ts").Rejected | import("@shivaedev/agent/failures.ts").UnknownAcceptance, import("../config.ts").CodexConfig>;
+export {};
 //# sourceMappingURL=engine.d.ts.map

package/dist/adapters/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/adapters/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,MAAM,8CAAkF,WAAW;;;iQAG9G,CAAC"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/adapters/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;;;;;AAGrD,qBAAa,WAAY,SAAQ,gBAA4G;CAAG;AAEhJ,eAAO,MAAM,gBAAgB,+RAA6C,CAAC"}

package/dist/adapters/engine.js

@@ -1,9 +1,6 @@
-import { Effect } from "effect";
-import { backend } from "#adapters/backend.ts";
-import { census } from "#adapters/census.ts";
-import { initializeEngine } from "#adapters/initializeEngine.ts";
-export const engine = Effect.fn("Codex.engine")(function* (config, spawn) {
-    const state = yield* initializeEngine(config, spawn);
-    return { backend: backend(state), census: census(state) };
-});
+import { Context, Layer } from "effect";
+import { initializeCodex } from "#adapters/initializeCodex.ts";
+export class CodexEngine extends Context.Service()("@shivaedev/agent-codex/CodexEngine") {
+}
+export const codexEngineLayer = Layer.effect(CodexEngine)(initializeCodex);
 //# sourceMappingURL=engine.js.map

package/dist/adapters/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/adapters/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,EAAE,MAA0B,EAAE,KAAyB;IAC/G,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3D,CAAC,CAAC,CAAC"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/adapters/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,KAAK,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAAuD,CAAC,oCAAoC,CAAC;CAAG;AAEhJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,eAAe,CAAC,CAAC"}