@excitedjs/agent-runtime-codex 0.2.0-alpha.g2b7e2d09fbdc → 0.2.0-alpha.gc17e7fda283d

package/dist/provider.d.ts

@@ -3,13 +3,14 @@ import { CodexProcess, type CodexProcessOptions } from './supervisor.js';
 import { dispatcherCodexConfig, type DispatcherCodexConfig } from './config.js';
 import type { AgentRuntimeCapabilities, AgentRuntimeMcpServer, AgentRuntimeProvider, AgentRuntimeProviderDescriptor, AgentRuntimeProviderFactory, ProviderDescriptor, ProviderFactoryContext } from '@excitedjs/dreamux-types';
 /**
- * Host-supplied hooks for the built-in Codex provider. Everything that is a
- * Dreamux host contract — the volatile socket root, the package-bin `PATH`, the
- * Codex home/auth pre-start check — is injected here by Dreamux core (or by an
- * external embedder), so this package reconstructs none of it. Role-gated
- * bundled skills arrive on the create context as neutral `skillSources` (not a
- * host hook). The `descriptor` and the test factories let core and tests wire
- * process/WS/home seams without changing the provider.
+ * Construction options for the built-in Codex provider. The runtime's host
+ * contracts now arrive on the NEUTRAL create context, not as factory hooks:
+ * volatile socket placement comes from `context.paths.runtimeSocketDirs()` (this
+ * package owns the allocation policy), and env injection comes from
+ * `context.injectEnv`. Role-gated bundled skills arrive as neutral
+ * `skillSources`. What remains here is the `descriptor` and the test/host seams
+ * (process/WS factories, the optional Codex home pre-start check, restart
+ * backoff) that let core and tests wire behavior without changing the provider.
  */
 export interface CodexAgentRuntimeProviderOptions {
     /**
@@ -19,16 +20,7 @@ export interface CodexAgentRuntimeProviderOptions {
      * `agentRuntime` descriptor.
      */
     descriptor?: ProviderDescriptor;
-    /**
-     * Allocate a fresh volatile rendezvous socket path per app-server start. The
-     * Dreamux host injects its own shared runtime-socket root here; when omitted
-     * the package falls back to {@link defaultVolatileSocketPath} so a
-     * loader-constructed / standalone runtime is still runnable.
-     */
-    allocateSocketPath?: (id: string) => string;
-    /** Build the base process env (host seeds `PATH` with the Dreamux package bins). */
-    baseProcessEnv?: (extraEnv: Record<string, string>) => NodeJS.ProcessEnv;
-    /** Host-owned Codex home/auth pre-start check, invoked with the runtime id and cwd. */
+    /** Optional Codex home/auth pre-start check, invoked with the runtime id and cwd. */
     codexHomeDoctor?: (info: {
         runtimeId: string;
         cwd: string;
@@ -38,15 +30,6 @@ export interface CodexAgentRuntimeProviderOptions {
     restartBackoffBaseMs?: number;
     restartBackoffMaxMs?: number;
 }
-/**
- * Final codex binary path for one runtime. The `CODEX_HOST_CODEX_BIN`
- * environment variable is a deliberate host-level override that takes precedence
- * over the configured `runtime.config.bin`; otherwise the configured bin
- * (default `"codex"`) is used. `env` defaults to the live process environment
- * for the runtime spawn path; doctor passes the installed service unit's
- * environment so it checks what the service will run.
- */
-export declare function resolveCodexBinPath(configBin: string, env?: NodeJS.ProcessEnv): string;
 export declare const CODEX_AGENT_RUNTIME_CAPABILITIES: AgentRuntimeCapabilities;
 /**
  * Create the built-in Codex `AgentRuntimeProvider`. It implements the neutral

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,qBAAqB,EAErB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EACV,wBAAwB,EAGxB,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC;IACzE,uFAAuF;IACvF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,YAAY,CAAC;IAClE,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,CAAC;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAIR;AAED,eAAO,MAAM,gCAAgC,EAAE,wBAe9C,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,oBAAoB,CAAC,qBAAqB,CAAC,CAiE7C;AAED,0EAA0E;AAC1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,EAAE,CAEV;AAED;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GACrC,sBAAsB,CAAC,8BAA8B,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,gCAAgC,EAAE,2BAA2B,CAAC,qBAAqB,CACP,CAAC;AAEnF,eAAe,gCAAgC,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAEL,qBAAqB,EAErB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAMrB,OAAO,KAAK,EACV,wBAAwB,EAGxB,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,qFAAqF;IACrF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,YAAY,CAAC;IAClE,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,CAAC;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,gCAAgC,EAAE,wBAe9C,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,oBAAoB,CAAC,qBAAqB,CAAC,CAgF7C;AAED,0EAA0E;AAC1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,EAAE,CAEV;AAED;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GACrC,sBAAsB,CAAC,8BAA8B,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,gCAAgC,EAAE,2BAA2B,CAAC,qBAAqB,CACP,CAAC;AAEnF,eAAe,gCAAgC,CAAC"}

package/dist/provider.js

@@ -1,23 +1,11 @@
 import { codexMcpServerArgs } from './mcp-config.js';
 import { CodexRuntime, } from './runtime.js';
-import { dispatcherCodexConfig, readDispatcherCodexConfig, } from './config.js';
+import { DEFAULT_CODEX_BIN, dispatcherCodexConfig, readDispatcherCodexConfig, } from './config.js';
 import { codexArgsFromConfig, codexArgsToCli } from './args.js';
 import { BUILTIN_CODEX_PROVIDER_REF } from './provider-ref.js';
-import { defaultVolatileSocketPath } from './internal/socket.js';
-/**
- * Final codex binary path for one runtime. The `CODEX_HOST_CODEX_BIN`
- * environment variable is a deliberate host-level override that takes precedence
- * over the configured `runtime.config.bin`; otherwise the configured bin
- * (default `"codex"`) is used. `env` defaults to the live process environment
- * for the runtime spawn path; doctor passes the installed service unit's
- * environment so it checks what the service will run.
- */
-export function resolveCodexBinPath(configBin, env = process.env) {
-    const fromEnv = env['CODEX_HOST_CODEX_BIN'];
-    if (fromEnv !== undefined && fromEnv.trim() !== '')
-        return fromEnv;
-    return configBin;
-}
+import { resolveCodexBinPath } from './bin.js';
+import { codexAgentRuntimeDiagnostic } from './diagnostic.js';
+import { allocateCodexSocketPath } from './internal/socket.js';
 export const CODEX_AGENT_RUNTIME_CAPABILITIES = {
     resume: { supported: true, checkpoint: 'codexThread' },
     steer: { supported: true },
@@ -60,6 +48,17 @@ export function createCodexAgentRuntimeProvider(options = {}) {
             ? DEFAULT_CODEX_DESCRIPTOR
             : asAgentRuntimeDescriptor(options.descriptor),
         getCapabilities: () => CODEX_AGENT_RUNTIME_CAPABILITIES,
+        diagnostic: codexAgentRuntimeDiagnostic,
+        onboard: {
+            async collect(_context, prompts) {
+                const bin = await prompts.text({
+                    message: 'Codex CLI binary',
+                    initialValue: DEFAULT_CODEX_BIN,
+                    required: true,
+                });
+                return { bin };
+            },
+        },
         readConfig(rawConfig, context) {
             return readDispatcherCodexConfig(rawConfig, context.file, context.prefix);
         },
@@ -76,15 +75,21 @@ export function createCodexAgentRuntimeProvider(options = {}) {
                 ...codexArgsToCli(codexArgs),
                 ...codexMcpServerArgs(context.mcpServers),
             ];
+            const paths = context.paths;
             const deps = {
                 cwd: context.cwd,
                 state: context.state,
-                paths: context.paths,
-                allocateSocketPath: options.allocateSocketPath ?? defaultVolatileSocketPath,
+                paths,
+                // The package owns socket allocation: pick a fresh name in the first of
+                // the host's preference-ordered candidate dirs that fits the budget.
+                allocateSocketPath: (id) => allocateCodexSocketPath(paths.runtimeSocketDirs(), id),
                 codexBinPath: resolveCodexBinPath(codexConfig.bin),
                 resolveExtraArgs: () => runtimeArgs,
                 handshakeTimeoutMs: codexConfig.initialize_timeout_ms,
                 extraEnv: codexConfig.extra_env,
+                ...(context.injectEnv !== undefined
+                    ? { injectEnv: context.injectEnv }
+                    : {}),
                 ...(context.skillSources !== undefined
                     ? { skillSources: context.skillSources }
                     : {}),
@@ -95,9 +100,6 @@ export function createCodexAgentRuntimeProvider(options = {}) {
                     ? { onTurnSettled: context.onTurnSettled }
                     : {}),
                 ...(context.logger !== undefined ? { logger: context.logger } : {}),
-                ...(options.baseProcessEnv !== undefined
-                    ? { baseProcessEnv: options.baseProcessEnv }
-                    : {}),
                 ...(options.codexHomeDoctor !== undefined
                     ? { codexHomeDoctor: options.codexHomeDoctor }
                     : {}),

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,EACL,YAAY,GAEb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAkDjE;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAA6B;IACxE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE;IACtD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACxB,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACzB,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7B,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACjC,kBAAkB,EAAE;QAClB;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,wEAAwE;gBACxE,2BAA2B;SAC9B;KACF;CACF,CAAC;AAEF,MAAM,wBAAwB,GAAmC;IAC/D,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,cAAc;IACpB,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,0BAA0B,EAAE;CACzE,CAAC;AAEF,qEAAqE;AACrE,SAAS,wBAAwB,CAC/B,UAA8B;IAE9B,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAA4C,EAAE;IAE9C,OAAO;QACL,GAAG,EAAE,0BAA0B;QAC/B,UAAU,EACR,OAAO,CAAC,UAAU,KAAK,SAAS;YAC9B,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC;QAClD,eAAe,EAAE,GAAG,EAAE,CAAC,gCAAgC;QACvD,UAAU,CAAC,SAAS,EAAE,OAAO;YAC3B,OAAO,yBAAyB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QACD,aAAa,CAAC,OAAyD;YACrE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YACnC,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG;gBAClB,GAAG,cAAc,CAAC,SAAS,CAAC;gBAC5B,GAAG,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC;aAC1C,CAAC;YACF,MAAM,IAAI,GAAqB;gBAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,yBAAyB;gBAC3E,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC,GAAG,CAAC;gBAClD,gBAAgB,EAAE,GAAG,EAAE,CAAC,WAAW;gBACnC,kBAAkB,EAAE,WAAW,CAAC,qBAAqB;gBACrD,QAAQ,EAAE,WAAW,CAAC,SAAS;gBAC/B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE;oBACxC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;oBAC3C,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE;oBACtD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;oBACrC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;oBAC1C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;oBACtC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;oBAC5C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;oBACvC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;oBAC9C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;oBAC3C,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE;oBACtD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;oBAC1C,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE;oBACpD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,oBAAoB,KAAK,SAAS;oBAC5C,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAAE;oBACxD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;oBAC3C,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE;oBACtD,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,MAAM,UAAU,6BAA6B,CAC3C,OAAyC;IAEzC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,gCAAgC,GACpC,CAAC,OAAO,EAAE,EAAE,CAAC,+BAA+B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAEnF,eAAe,gCAAgC,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/runtime-support.d.ts

@@ -1,15 +1,16 @@
 import type { CompletionEnvelope } from '@excitedjs/dreamux-types';
 /**
- * Build the process env for a Codex app-server child. `buildBaseEnv` is supplied
- * by the host (it seeds `PATH` with the Dreamux package bins so the child can
- * reach the bundled MCP shims — a host packaging contract this package must not
- * reconstruct). This wrapper then strips `CODEX_HOME` so the child follows the
- * operator's global `~/.codex` instead of any inherited override — a
- * Codex-specific concern that must not live in the host's runtime-neutral env
- * builder (issue #143 de-leak). When no host builder is supplied (standalone /
- * tests) it falls back to the live process env.
+ * Build the process env for a Codex app-server child. The neutral env boundary
+ * (issue #209 cleanup) is `{ ...process.env, ...injectEnv, ...extraEnv }`:
+ *   - `injectEnv` is the host's optional neutral env-injection seam from the
+ *     create context (empty today); core owns what it injects.
+ *   - `extraEnv` is THIS provider's own `config.extra_env`, merged last so a
+ *     dispatcher can override an injected value.
+ * The child inherits the operator's ambient `CODEX_HOME` like a vanilla
+ * `codex` invocation — Dreamux creates no dispatcher-private Codex home (MVP),
+ * so there is nothing to strip.
  */
-export declare function codexProcessEnv(buildBaseEnv: ((extraEnv: Record<string, string>) => NodeJS.ProcessEnv) | undefined, extraEnv?: Record<string, string>): NodeJS.ProcessEnv;
+export declare function codexProcessEnv(injectEnv?: Record<string, string>, extraEnv?: Record<string, string>): NodeJS.ProcessEnv;
 /**
  * Build the raw Responses API item injected into the dispatcher thread's
  * model-visible history via `thread/inject_items`. A `message` item with role

package/dist/runtime-support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-support.d.ts","sourceRoot":"","sources":["../src/runtime-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EACR,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,GACzD,SAAS,EACb,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACpC,MAAM,CAAC,UAAU,CAOnB;AA0BD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOlC;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAG4B,CAAC"}
+{"version":3,"file":"runtime-support.d.ts","sourceRoot":"","sources":["../src/runtime-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACtC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACpC,MAAM,CAAC,UAAU,CAEnB;AA0BD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOlC;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAG4B,CAAC"}

package/dist/runtime-support.js

@@ -1,20 +1,17 @@
-import { resolveCompletionBody, } from './internal/completion-body.js';
+import { resolveCompletionBody, } from '@excitedjs/dreamux-utils';
 /**
- * Build the process env for a Codex app-server child. `buildBaseEnv` is supplied
- * by the host (it seeds `PATH` with the Dreamux package bins so the child can
- * reach the bundled MCP shims — a host packaging contract this package must not
- * reconstruct). This wrapper then strips `CODEX_HOME` so the child follows the
- * operator's global `~/.codex` instead of any inherited override — a
- * Codex-specific concern that must not live in the host's runtime-neutral env
- * builder (issue #143 de-leak). When no host builder is supplied (standalone /
- * tests) it falls back to the live process env.
+ * Build the process env for a Codex app-server child. The neutral env boundary
+ * (issue #209 cleanup) is `{ ...process.env, ...injectEnv, ...extraEnv }`:
+ *   - `injectEnv` is the host's optional neutral env-injection seam from the
+ *     create context (empty today); core owns what it injects.
+ *   - `extraEnv` is THIS provider's own `config.extra_env`, merged last so a
+ *     dispatcher can override an injected value.
+ * The child inherits the operator's ambient `CODEX_HOME` like a vanilla
+ * `codex` invocation — Dreamux creates no dispatcher-private Codex home (MVP),
+ * so there is nothing to strip.
  */
-export function codexProcessEnv(buildBaseEnv, extraEnv = {}) {
-    const env = buildBaseEnv !== undefined
-        ? buildBaseEnv(extraEnv)
-        : { ...globalThis.process.env, ...extraEnv };
-    delete env['CODEX_HOME'];
-    return env;
+export function codexProcessEnv(injectEnv = {}, extraEnv = {}) {
+    return { ...globalThis.process.env, ...injectEnv, ...extraEnv };
 }
 /**
  * Frame a TeamMate completion as recognizable notification text. Delivered as

package/dist/runtime-support.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-support.js","sourceRoot":"","sources":["../src/runtime-support.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,YAEa,EACb,WAAmC,EAAE;IAErC,MAAM,GAAG,GACP,YAAY,KAAK,SAAS;QACxB,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;QACxB,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IACjD,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,UAA8B,EAC9B,IAA4B;IAE5B,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,QAAQ;QACpB,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,mEAAmE,IAAI,CAAC,IAAI,EAAE,CAAC;IACrF,OAAO;QACL,wCAAwC,UAAU,CAAC,MAAM,IAAI;YAC3D,OAAO,UAAU,CAAC,EAAE,aAAa,UAAU,CAAC,MAAM,IAAI;QACxD,KAAK;QACL,gCAAgC;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAA8B,EAC9B,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,gFAAgF;IAChF,gFAAgF;IAChF,oEAAoE,CAAC"}
+{"version":3,"file":"runtime-support.js","sourceRoot":"","sources":["../src/runtime-support.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,GAEtB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoC,EAAE,EACtC,WAAmC,EAAE;IAErC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,UAA8B,EAC9B,IAA4B;IAE5B,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,QAAQ;QACpB,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,mEAAmE,IAAI,CAAC,IAAI,EAAE,CAAC;IACrF,OAAO;QACL,wCAAwC,UAAU,CAAC,MAAM,IAAI;YAC3D,OAAO,UAAU,CAAC,EAAE,aAAa,UAAU,CAAC,MAAM,IAAI;QACxD,KAAK;QACL,gCAAgC;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAA8B,EAC9B,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,gFAAgF;IAChF,gFAAgF;IAChF,oEAAoE,CAAC"}

package/dist/runtime.d.ts

@@ -1,89 +1,27 @@
-/**
- * CodexRuntime — one running Codex-backed AgentRuntime instance.
- *
- * Owns:
- *   - CodexProcess (child app-server)
- *   - CodexWsClient (WS connection)
- *   - thread_id (lazily created via thread/start or resumed)
- *   - TurnManager (FIFO worker for this dispatcher)
- *
- * Lifecycle: declared → starting → ready → (degraded) → stopping → stopped.
- *
- * Current MVP:
- *   - accepted inbound work is process-local and is dropped on restart;
- *   - thread/resume failure does not degrade the whole dispatcher; we
- *     start a fresh thread, record the lost one in last_lost_thread_id,
- *     and post a visible warning to the next source chat.
- */
 import { CodexProcess, type CodexProcessOptions } from './supervisor.js';
 import { CodexWsClient } from './rpc.js';
 import type { AgentRuntime, AgentRuntimeCapabilities, AgentRuntimeIdentity, AgentRuntimeLastResult, AgentRuntimePathContext, AgentRuntimeResumeInput, AgentRuntimeSkillSource, AgentRuntimeStateCallbacks, AgentRuntimeStatus, AgentRuntimeSystemInput, AgentRuntimeTurnResult, CompletionEnvelope, DreamuxLogger, InboundDeliveryHooks, InboundTurnInput, TeamMateCompletionDeliveryResult, TurnSettledSignal } from '@excitedjs/dreamux-types';
 export interface CodexRuntimeDeps {
-    /** Working directory the codex app-server runs in (required launch param). */
     cwd: string;
-    /**
-     * Launcher-supplied system-prompt content used as codex `baseInstructions`
-     * (codex applies it as a REPLACE per its `systemPrompt` capability). Omitted
-     * for launches that supply none (e.g. teammates).
-     */
     systemPromptContent?: string;
-    /** Neutral state sink the host adapts from its dispatcher store. */
     state: AgentRuntimeStateCallbacks;
-    /** Host-supplied per-dispatcher path context (logs/spill live in the host tree). */
     paths: AgentRuntimePathContext;
-    /**
-     * Allocate a fresh volatile rendezvous socket path for one app-server start.
-     * Host-supplied: the socket root is a Dreamux runtime contract this package
-     * must not reconstruct.
-     */
     allocateSocketPath: (id: string) => string;
-    /**
-     * Role-gated bundled skill sources core selected for this runtime (issue #209
-     * slice 6). Applied via the app-server `skills/extraRoots/set` RPC after
-     * initialize and before thread start/resume, and reapplied after every
-     * app-server restart. Empty/omitted means no roots are set (the default for
-     * teammates and any role core does not gate skills for).
-     */
     skillSources?: readonly AgentRuntimeSkillSource[];
-    /**
-     * Build the base process env for the codex child (host seeds `PATH` with the
-     * Dreamux package bins). Optional: standalone use falls back to the live env.
-     */
-    baseProcessEnv?: (extraEnv: Record<string, string>) => NodeJS.ProcessEnv;
-    /** Optional bin path override for tests. */
+    injectEnv?: Record<string, string>;
     codexBinPath?: string;
-    /** Override process construction for tests. */
     codexProcessFactory?: (opts: CodexProcessOptions) => CodexProcess;
-    /** Override WS client factory for tests. */
     codexClientFactory?: (socketPath: string) => CodexWsClient;
-    /**
-     * Optional host-owned Codex home/auth pre-start check, invoked before the
-     * child spawns with the runtime id and cwd. The host owns its path/socket
-     * inputs and builds its own validation context from these.
-     */
     codexHomeDoctor?: (info: {
         runtimeId: string;
         cwd: string;
     }) => void | Promise<void>;
-    /** Codex extraArgs (parsed from dispatcher.codex_args_json). */
     resolveExtraArgs?: () => string[];
-    /**
-     * Codex initialize handshake timeout (ms). From this dispatcher's
-     * `dispatchers[].runtime.config.initialize_timeout_ms` (default 10000).
-     */
     handshakeTimeoutMs?: number;
-    /** Per-dispatcher environment overrides from config. */
     extraEnv?: Record<string, string>;
-    /** Codex child/WS restart backoff base (tests may override). */
     restartBackoffBaseMs?: number;
-    /** Codex child/WS restart backoff cap (tests may override). */
     restartBackoffMaxMs?: number;
-    /**
-     * Fired each time a delivered turn reaches a terminal state. Supplied by the
-     * launcher (teammate service) and omitted for dispatcher launches.
-     */
     onTurnSettled?: (settled: TurnSettledSignal) => void;
-    /** Neutral logger the host passes in; a console fallback is used when absent. */
     logger?: DreamuxLogger;
 }
 export declare class CodexRuntime implements AgentRuntime {
@@ -94,35 +32,12 @@ export declare class CodexRuntime implements AgentRuntime {
     private client;
     private turnManager;
     private threadId;
-    /**
-     * Whether the most recent thread resolution resumed an existing Codex thread
-     * (true) rather than starting a fresh one or recovering from a failed resume.
-     * Consulted by the server right after the slot is ready to decide whether a
-     * `daemon restart` notice should be injected (issue #78).
-     */
     private threadResumed;
     private status;
-    /** Monotonic per-attempt suffix for TeamMate delivery turn dedup ids (#110 PR8). */
     private teammateDeliverySeq;
-    /**
-     * Completion deliveries currently being processed. Duplicate settled events can
-     * race into `completionInput`; coalescing by completion id keeps one logical
-     * completion from injecting or triggering more than once concurrently.
-     */
     private readonly inFlightCompletionDeliveries;
-    /**
-     * Completion ids whose trigger turn has already been accepted. A later replay
-     * of the same settled teammate turn is an idempotent success, not a new wake-up.
-     */
     private readonly acceptedCompletionIds;
     private readonly acceptedCompletionOrder;
-    /**
-     * Completion ids whose item has already been injected into the thread. The
-     * Dispatcher Service retries `completionInput` on `failed`; if the inject
-     * succeeded but the trigger turn failed, the retry must NOT re-inject the same
-     * item (that would persist a duplicate completion to the rollout). Bounded so
-     * a long-lived dispatcher does not grow this set without limit.
-     */
     private readonly injectedCompletionIds;
     private readonly injectedCompletionOrder;
     private readonly log;
@@ -138,63 +53,19 @@ export declare class CodexRuntime implements AgentRuntime {
     getStatus(): AgentRuntimeStatus;
     getCapabilities(): AgentRuntimeCapabilities;
     getThreadId(): string | null;
-    /** True when the live thread was resumed (not freshly started/recovered). */
     wasThreadResumed(): boolean;
     getLast(): Promise<AgentRuntimeLastResult | null>;
     getContext(): Promise<null>;
     resume(input?: AgentRuntimeResumeInput): Promise<void>;
     private submitRestartNotice;
-    /**
-     * Bring the dispatcher up. Order:
-     *  1. spawn codex app-server child
-     *  2. open WS client
-     *  3. install fail-fast approval handler
-     *  4. thread/start (new) or thread/resume (existing)
-     *  5. install turn manager
-     *  6. status = ready
-     */
     start(): Promise<void>;
     private startCodexRuntime;
-    /**
-     * Apply the role-gated bundled skill sources to the live app-server via
-     * `skills/extraRoots/set`. Codex treats each extra root as a directory whose
-     * immediate children are skill dirs, so a `skill-dir` source maps to the
-     * *parent* of its own directory; roots are deduped (the bundled Dreamux skills
-     * share one parent). Empty input skips the RPC entirely (a fresh per-runtime
-     * app-server starts with no extra roots, so nothing to clear). Errors are
-     * fatal to the start: a dispatcher/leader that cannot load its operational
-     * skills must fail loud, not run skill-blind.
-     */
     private applySkillExtraRoots;
     private resolveThread;
-    /**
-     * Submit any accepted inbound message arriving for this dispatcher. Called by
-     * the Feishu inbound layer.
-     */
     channelInput(input: InboundTurnInput, hooks?: InboundDeliveryHooks): Promise<AgentRuntimeTurnResult>;
-    /** Inject a system-originated notice (e.g. a restart notice). */
     systemInput(notice: AgentRuntimeSystemInput): Promise<AgentRuntimeTurnResult>;
-    /**
-     * Codex TeamMate completion delivery — the native inbox-then-trigger idiom.
-     *
-     * Two steps, in order:
-     *  1. `thread/inject_items` appends the completion to the dispatcher thread's
-     *     model-visible history as a developer-role message (no fake user turn).
-     *     codex folds the item onto the active turn when one is running and never
-     *     rejects on a busy thread, so a failure here is a genuine RPC error.
-     *  2. a minimal trigger turn through the public `channelInput` seam wakes the
-     *     idle dispatcher so it reads the just-injected notification and acts.
-     *
-     * The trigger turn uses a fresh, non-routable source id per attempt. The turn
-     * manager commits its dedup id before `turn/start` and does not roll it back
-     * on failure, so a retry that reused one id would come back `duplicate` and be
-     * mis-counted as delivered when nothing was submitted. The Dispatcher Service
-     * only retries on `failed` (definitely not submitted), so a unique id per
-     * attempt re-submits the trigger safely.
-     */
     completionInput(completion: CompletionEnvelope): Promise<TeamMateCompletionDeliveryResult>;
     private deliverCompletionInput;
-    /** Graceful stop: stop accepting work, reap codex child. */
     stop(): Promise<void>;
     private cleanupOnFailure;
     private teardownCodexRuntime;
@@ -206,9 +77,7 @@ export declare class CodexRuntime implements AgentRuntime {
     private clearRestartTimer;
     private markReady;
     private recordCollectedTurn;
-    /** Record a completion id as injected, evicting the oldest past a small cap. */
     private rememberInjectedCompletion;
-    /** Record a completion id as fully accepted, evicting the oldest past a cap. */
     private rememberAcceptedCompletion;
     private setStatus;
 }

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}