@excitedjs/agent-runtime-codex 0.5.0-beta.179 → 0.5.0-beta.182

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,GACjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAK/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,GACrC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,gCAAgC,GACtC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAO/C,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAK/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,GACrC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,7 +6,10 @@
  */
 export { default, createCodexAgentRuntimeProvider, codexSystemPromptReplace, codexRuntimeArgsForMcpServers, dispatcherCodexConfig, CODEX_AGENT_RUNTIME_CAPABILITIES, } from './provider.js';
 export { resolveCodexBinPath } from './bin.js';
-export { CodexRuntime, } from './runtime.js';
+// The concrete runtime class and the deps it is constructed from are both
+// implementation details: the package's public surface is the provider factory
+// and its options, and Core only ever holds the neutral `start`/`submit`/`stop`
+// handle `createRuntime` returns.
 export { CodexProcess, } from './supervisor.js';
 export { CodexWsClient, } from './rpc.js';
 export { performInitializeHandshake } from './handshake.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,GAGjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EACL,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,GAIb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,GAGd,MAAM,UAAU,CAAC;AASlB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,GAEf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,+EAA+E;AAC/E,yEAAyE;AACzE,8EAA8E;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,GAIhC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,GAEjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,0EAA0E;AAC1E,+EAA+E;AAC/E,gFAAgF;AAChF,kCAAkC;AAElC,OAAO,EACL,YAAY,GAIb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,GAGd,MAAM,UAAU,CAAC;AASlB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,GAEf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,+EAA+E;AAC/E,yEAAyE;AACzE,8EAA8E;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,GAIhC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/mcp-config.d.ts

@@ -1,9 +1,33 @@
 import type { AgentRuntimeMcpServer } from '@excitedjs/dreamux-types';
 /**
- * Render neutral MCP server descriptors into Codex `-c mcp_servers.<name>.*`
- * config-override CLI args. Provider-neutral: it knows nothing about which
+ * Render neutral MCP server descriptors into a Codex `-c mcp_servers=...`
+ * config-override CLI arg.
+ *
+ * Provider-neutral about *what* it renders: it knows nothing about which
  * channel or shim produced a descriptor — the Dreamux host decides which MCP
- * servers a runtime gets and passes them through the create context.
+ * servers a runtime gets and passes them through the create context. What it
+ * does own is *how* a descriptor becomes Codex configuration, including the
+ * server name. A name is a logical identity chosen by the host; making it
+ * expressible in TOML is this adapter's job, not a constraint the host has to
+ * honor when it picks one.
+ *
+ * That is why the whole table is rendered as one override value rather than as
+ * one `mcp_servers.<name>.<field>=` override per field. Codex parses the value
+ * of `-c key=value` as TOML but not the key: it splits the key on `.` and takes
+ * each segment literally, so a quoted segment arrives with its quotes attached
+ * and a name containing `.` is silently split across two config levels. Inside
+ * the value a real TOML parser is reading, so a quoted key carries any string —
+ * dots, spaces, quotes, `=`, `#`, newlines, non-ASCII — back out under exactly
+ * the name it went in under.
+ *
+ * The override still merges into the operator's own `config.toml` rather than
+ * replacing it, at every level: servers Dreamux does not name are untouched,
+ * and for a name it does, fields it does not set keep their configured values.
+ *
+ * Values that cannot survive the TOML/argv boundary at all — a lone surrogate,
+ * an unescaped control character — fail loud when Codex loads the override.
+ * That envelope already applies to `command`, `args`, and `env`; a name is not
+ * given a private encoding to escape it.
  */
 export declare function codexMcpServerArgs(servers: readonly AgentRuntimeMcpServer[]): string[];
 //# sourceMappingURL=mcp-config.d.ts.map

package/dist/mcp-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,EAAE,CAOV"}
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,EAAE,CAMV"}

package/dist/mcp-config.js

@@ -1,20 +1,66 @@
 /**
- * Render neutral MCP server descriptors into Codex `-c mcp_servers.<name>.*`
- * config-override CLI args. Provider-neutral: it knows nothing about which
+ * Render neutral MCP server descriptors into a Codex `-c mcp_servers=...`
+ * config-override CLI arg.
+ *
+ * Provider-neutral about *what* it renders: it knows nothing about which
  * channel or shim produced a descriptor — the Dreamux host decides which MCP
- * servers a runtime gets and passes them through the create context.
+ * servers a runtime gets and passes them through the create context. What it
+ * does own is *how* a descriptor becomes Codex configuration, including the
+ * server name. A name is a logical identity chosen by the host; making it
+ * expressible in TOML is this adapter's job, not a constraint the host has to
+ * honor when it picks one.
+ *
+ * That is why the whole table is rendered as one override value rather than as
+ * one `mcp_servers.<name>.<field>=` override per field. Codex parses the value
+ * of `-c key=value` as TOML but not the key: it splits the key on `.` and takes
+ * each segment literally, so a quoted segment arrives with its quotes attached
+ * and a name containing `.` is silently split across two config levels. Inside
+ * the value a real TOML parser is reading, so a quoted key carries any string —
+ * dots, spaces, quotes, `=`, `#`, newlines, non-ASCII — back out under exactly
+ * the name it went in under.
+ *
+ * The override still merges into the operator's own `config.toml` rather than
+ * replacing it, at every level: servers Dreamux does not name are untouched,
+ * and for a name it does, fields it does not set keep their configured values.
+ *
+ * Values that cannot survive the TOML/argv boundary at all — a lone surrogate,
+ * an unescaped control character — fail loud when Codex loads the override.
+ * That envelope already applies to `command`, `args`, and `env`; a name is not
+ * given a private encoding to escape it.
  */
 export function codexMcpServerArgs(servers) {
-    return servers.flatMap((server) => [
-        '-c',
-        `mcp_servers.${server.name}.command=${tomlString(server.command)}`,
-        '-c',
-        `mcp_servers.${server.name}.args=${tomlStringArray(server.args)}`,
-    ]);
+    if (servers.length === 0)
+        return [];
+    const entries = servers.map((server) => `${tomlString(server.name)} = ${tomlServerTable(server)}`);
+    return ['-c', `mcp_servers={${entries.join(', ')}}`];
+}
+function tomlServerTable(server) {
+    const fields = [
+        `command = ${tomlString(server.command)}`,
+        `args = ${tomlStringArray(server.args)}`,
+        // Carried, never dropped: a descriptor's `env` holds what its server needs
+        // to start, so losing it breaks the server it was minted for. Note that
+        // this rendering puts those values into Codex's own command line, so `env`
+        // is not a secrecy boundary here — the host is told as much and does not
+        // rely on one.
+        ...(server.env !== undefined ? [`env = ${tomlTable(server.env)}`] : []),
+    ];
+    return `{${fields.join(', ')}}`;
+}
+function tomlTable(entries) {
+    const pairs = Object.entries(entries).map(([key, value]) => `${tomlString(key)} = ${tomlString(value)}`);
+    return `{${pairs.join(', ')}}`;
 }
 function tomlStringArray(values) {
     return `[${values.map(tomlString).join(', ')}]`;
 }
+/**
+ * One TOML basic string, used for both keys and values.
+ *
+ * `JSON.stringify` is the whole implementation because TOML's basic-string
+ * escapes are a superset of JSON's: the same double quotes, the same `\"`,
+ * `\\`, `\b`, `\f`, `\n`, `\r`, `\t`, and the same `\uXXXX`.
+ */
 function tomlString(value) {
     return JSON.stringify(value);
 }

package/dist/mcp-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyC;IAEzC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,IAAI;QACJ,eAAe,MAAM,CAAC,IAAI,YAAY,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAClE,IAAI;QACJ,eAAe,MAAM,CAAC,IAAI,SAAS,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,MAAgB;IACvC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyC;IAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CACzB,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,EAAE,CACtE,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,eAAe,CAAC,MAA6B;IACpD,MAAM,MAAM,GAAG;QACb,aAAa,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QACzC,UAAU,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACxC,2EAA2E;QAC3E,wEAAwE;QACxE,2EAA2E;QAC3E,yEAAyE;QACzE,eAAe;QACf,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC;IACF,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAClC,CAAC;AAED,SAAS,SAAS,CAAC,OAAyC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CACvC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,CAC9D,CAAC;IACF,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CAAC,MAAyB;IAChD,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/provider.d.ts

@@ -1,26 +1,19 @@
 import { CodexWsClient } from './rpc.js';
 import { CodexProcess, type CodexProcessOptions } from './supervisor.js';
-import { type CodexRuntimeDeps } from './runtime.js';
 import { dispatcherCodexConfig, type DispatcherCodexConfig } from './config.js';
-import type { AgentRuntimeCapabilities, AgentRuntimeMcpServer, AgentRuntimeProvider, AgentRuntimeProviderDescriptor, AgentRuntimeSystemPrompt, AgentRuntimeProviderFactory, ProviderDescriptor, ProviderFactoryContext } from '@excitedjs/dreamux-types';
+import type { AgentRuntimeMcpServer, AgentRuntimeProvider, AgentRuntimeProviderCapabilities, AgentRuntimeProviderFactory, AgentRuntimeSessionRef, AgentRuntimeSystemPrompt } from '@excitedjs/dreamux-types';
 /**
  * Construction options for the built-in Codex provider. The runtime's host
- * contracts now arrive on the NEUTRAL create context, not as factory hooks:
+ * contracts 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.
+ * `skillSources`. Registration identity is Core's: the provider carries no
+ * descriptor. What remains here are 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 {
-    /**
-     * The registry descriptor for `builtin:codex`. Defaults to a minimal one.
-     * Accepted wide (`ProviderDescriptor`) so a host that resolved it from its
-     * registry need not pre-narrow the kind; the factory validates it is an
-     * `agentRuntime` descriptor.
-     */
-    descriptor?: ProviderDescriptor;
     /** Optional Codex home/auth pre-start check, invoked with the runtime id and cwd. */
     codexHomeDoctor?: (info: {
         runtimeId: string;
@@ -30,48 +23,41 @@ export interface CodexAgentRuntimeProviderOptions {
     codexClientFactory?: (socketPath: string) => CodexWsClient;
     restartBackoffBaseMs?: number;
     restartBackoffMaxMs?: number;
-    /** Override native transcript path validation for deterministic tests. */
-    validateTranscriptPath?: CodexRuntimeDeps['validateTranscriptPath'];
 }
-export declare const CODEX_AGENT_RUNTIME_CAPABILITIES: AgentRuntimeCapabilities;
+/**
+ * Provider-static selection metadata. Recovery, session-bound structured
+ * output, and recent Activity reads are mandatory provider behavior, so none of
+ * them is advertised here.
+ */
+export declare const CODEX_AGENT_RUNTIME_CAPABILITIES: AgentRuntimeProviderCapabilities;
 export declare function codexSystemPromptReplace(systemPrompt: AgentRuntimeSystemPrompt | undefined): string | undefined;
 export declare function codexSystemPromptAppend(systemPrompt: AgentRuntimeSystemPrompt | undefined): readonly string[] | undefined;
 /**
  * Create the built-in Codex `AgentRuntimeProvider`. It implements the neutral
- * `@excitedjs/dreamux-types` contract: `readConfig` parses Codex runtime config,
- * `getCapabilities` reports Codex's resume support, and
- * `createRuntime` builds a {@link CodexRuntime} from the neutral create context
- * plus the host-supplied hooks.
+ * `@excitedjs/dreamux-types` contract: `config.read` parses Codex runtime
+ * config, `readRecentActivity` serves neutral Activity Records for any session,
+ * and `createRuntime` builds a {@link CodexRuntime} from the neutral create
+ * context plus the host-supplied hooks.
+ *
+ * Codex resumes from its thread id alone, so its session identity is the base
+ * {@link AgentRuntimeSessionRef}.
  */
-export declare function createCodexAgentRuntimeProvider(options?: CodexAgentRuntimeProviderOptions): AgentRuntimeProvider<DispatcherCodexConfig>;
+export declare function createCodexAgentRuntimeProvider(options?: CodexAgentRuntimeProviderOptions): AgentRuntimeProvider<DispatcherCodexConfig, AgentRuntimeSessionRef>;
 /** Re-export the typed accessor for a runtime's resolved codex config. */
 export { dispatcherCodexConfig };
 export declare function codexRuntimeArgsForMcpServers(servers: readonly AgentRuntimeMcpServer[]): string[];
-/**
- * The context Dreamux core's generic provider package-loader passes to this
- * package's factory export. A back-compat alias of the public
- * {@link ProviderFactoryContext}, narrowed to the Agent Runtime descriptor kind
- * so the factory assigns `descriptor` without a cast.
- */
-export type CodexProviderFactoryContext = ProviderFactoryContext<AgentRuntimeProviderDescriptor>;
 /**
  * Default export — the factory Dreamux core's generic provider-loader selects
  * for the `builtin:codex` ref (it imports this package and calls the default
- * export with `{ ref, descriptor }`). It returns a provider that runs on package
- * defaults: a standalone volatile-socket allocator and no host-injected bundled
- * skills.
+ * export with `{ ref }`). It returns a provider on package defaults: a
+ * standalone volatile-socket allocator and no host-injected bundled skills.
  *
- * The Dreamux host does NOT use this bare path in production: its launcher still
- * drives the host-shaped create context, so it constructs the provider through
- * its own core-owned adapter (`@excitedjs/dreamux` `builtin/codex/provider.ts`)
- * to map that context onto the neutral one AND inject its host contracts (the
- * shared runtime-socket root and bundled Dreamux skills; MCP shims receive an
- * explicit dreamux bin path). This default export keeps the package a
- * first-class, loadable `AgentRuntimeProvider` for the generic loader and for
- * external embedders;
- * converging core's launcher onto the neutral context so it can drive the loaded
- * provider directly is later-slice work.
+ * This is the production path. Core drives the loaded provider through the
+ * neutral facade alone — it holds no adapter for this package — and supplies
+ * every host contract (socket root, skill sources, MCP servers, state lease)
+ * through the neutral create context. The options argument of
+ * {@link createCodexAgentRuntimeProvider} exists for embedders and tests.
  */
-declare const codexAgentRuntimeProviderFactory: AgentRuntimeProviderFactory<DispatcherCodexConfig>;
+declare const codexAgentRuntimeProviderFactory: AgentRuntimeProviderFactory<DispatcherCodexConfig, AgentRuntimeSessionRef>;
 export default codexAgentRuntimeProviderFactory;
 //# sourceMappingURL=provider.d.ts.map

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;AACzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,qBAAqB,EAErB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EACV,wBAAwB,EAGxB,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,wBAAwB,EACxB,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;IAC7B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;CACrE;AAED,eAAO,MAAM,gCAAgC,EAAE,wBAG9C,CAAC;AAQF,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,wBAAwB,GAAG,SAAS,GACjD,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,wBAAwB,GAAG,SAAS,GACjD,SAAS,MAAM,EAAE,GAAG,SAAS,CAO/B;AAeD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,oBAAoB,CAAC,qBAAqB,CAAC,CAuF7C;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;;;;;;;;;;;;;;;;;GAiBG;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;AAGzB,OAAO,EAEL,qBAAqB,EAErB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAUrB,OAAO,KAAK,EAGV,qBAAqB,EACrB,oBAAoB,EACpB,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gCAAgC;IAC/C,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;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,gCACjC,CAAC;AAEf,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,wBAAwB,GAAG,SAAS,GACjD,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,wBAAwB,GAAG,SAAS,GACjD,SAAS,MAAM,EAAE,GAAG,SAAS,CAO/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,oBAAoB,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAwFrE;AAED,0EAA0E;AAC1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,EAAE,CAEV;AAED;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,gCAAgC,EAAE,2BAA2B,CACjE,qBAAqB,EACrB,sBAAsB,CACmB,CAAC;AAE5C,eAAe,gCAAgC,CAAC"}

package/dist/provider.js

@@ -1,21 +1,18 @@
 import { codexMcpServerArgs } from './mcp-config.js';
-import { CodexRuntime, } from './runtime.js';
+import { CodexRuntime } from './runtime.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 { resolveCodexBinPath } from './bin.js';
 import { codexAgentRuntimeDiagnostic } from './diagnostic.js';
 import { allocateCodexSocketPath } from './internal/socket.js';
-import { readCodexTranscript } from './transcript/reader.js';
-export const CODEX_AGENT_RUNTIME_CAPABILITIES = {
-    resume: { supported: true },
-    structuredOutput: { supported: true, scope: 'per-turn' },
-};
-const DEFAULT_CODEX_DESCRIPTOR = {
-    id: 'codex',
-    kind: 'agentRuntime',
-    ref: { source: 'builtin', id: 'codex', raw: BUILTIN_CODEX_PROVIDER_REF },
-};
+import { readCodexRecentActivity } from './activity/reader.js';
+import { compileCodexOutputSchema, } from './output-schema-codec.js';
+/**
+ * Provider-static selection metadata. Recovery, session-bound structured
+ * output, and recent Activity reads are mandatory provider behavior, so none of
+ * them is advertised here.
+ */
+export const CODEX_AGENT_RUNTIME_CAPABILITIES = { tags: [] };
 export function codexSystemPromptReplace(systemPrompt) {
     if (systemPrompt === undefined)
         return undefined;
@@ -33,27 +30,18 @@ export function codexSystemPromptAppend(systemPrompt) {
     const append = systemPrompt.append.filter((prompt) => prompt !== '');
     return append.length > 0 ? append : undefined;
 }
-/** Validate + narrow a seed descriptor to the Agent Runtime kind. */
-function asAgentRuntimeDescriptor(descriptor) {
-    if (descriptor.kind !== 'agentRuntime') {
-        throw new Error(`@excitedjs/agent-runtime-codex: descriptor.kind must be 'agentRuntime' ` +
-            `(got ${JSON.stringify(descriptor.kind)})`);
-    }
-    return { ...descriptor, kind: descriptor.kind };
-}
 /**
  * Create the built-in Codex `AgentRuntimeProvider`. It implements the neutral
- * `@excitedjs/dreamux-types` contract: `readConfig` parses Codex runtime config,
- * `getCapabilities` reports Codex's resume support, and
- * `createRuntime` builds a {@link CodexRuntime} from the neutral create context
- * plus the host-supplied hooks.
+ * `@excitedjs/dreamux-types` contract: `config.read` parses Codex runtime
+ * config, `readRecentActivity` serves neutral Activity Records for any session,
+ * and `createRuntime` builds a {@link CodexRuntime} from the neutral create
+ * context plus the host-supplied hooks.
+ *
+ * Codex resumes from its thread id alone, so its session identity is the base
+ * {@link AgentRuntimeSessionRef}.
  */
 export function createCodexAgentRuntimeProvider(options = {}) {
     return {
-        ref: BUILTIN_CODEX_PROVIDER_REF,
-        descriptor: options.descriptor === undefined
-            ? DEFAULT_CODEX_DESCRIPTOR
-            : asAgentRuntimeDescriptor(options.descriptor),
         getCapabilities: () => CODEX_AGENT_RUNTIME_CAPABILITIES,
         diagnostic: codexAgentRuntimeDiagnostic,
         onboard: {
@@ -66,17 +54,13 @@ export function createCodexAgentRuntimeProvider(options = {}) {
                 return { bin };
             },
         },
-        readConfig(rawConfig, context) {
-            return readDispatcherCodexConfig(rawConfig, context.file, context.prefix);
+        config: {
+            read(rawConfig, context) {
+                return readDispatcherCodexConfig(rawConfig, context.file, context.prefix);
+            },
         },
-        readTranscript: readCodexTranscript,
-        createRuntime(context) {
-            if (context.state === undefined) {
-                throw new Error('codex runtime requires a state sink in the create context');
-            }
-            if (context.paths === undefined) {
-                throw new Error('codex runtime requires a path context in the create context');
-            }
+        readRecentActivity: (query, context) => readCodexRecentActivity(query, context),
+        async createRuntime(context) {
             const codexConfig = context.config;
             const codexArgs = codexArgsFromConfig(codexConfig);
             const runtimeArgs = [
@@ -86,10 +70,16 @@ export function createCodexAgentRuntimeProvider(options = {}) {
             const paths = context.paths;
             const systemPromptReplace = codexSystemPromptReplace(context.systemPrompt);
             const systemPromptAppend = codexSystemPromptAppend(context.systemPrompt);
+            // Bind the output schema once, here. A compile failure is a create-time
+            // error; no later submission can change or renegotiate the schema.
+            const codec = context.outputSchema === undefined
+                ? null
+                : compileCodexOutputSchema(context.outputSchema);
             const deps = {
                 cwd: context.cwd,
                 state: context.state,
-                activitySink: context.activitySink,
+                activitySink: context.activity ?? (() => undefined),
+                codec,
                 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.
@@ -126,9 +116,6 @@ export function createCodexAgentRuntimeProvider(options = {}) {
                 ...(options.restartBackoffMaxMs !== undefined
                     ? { restartBackoffMaxMs: options.restartBackoffMaxMs }
                     : {}),
-                ...(options.validateTranscriptPath !== undefined
-                    ? { validateTranscriptPath: options.validateTranscriptPath }
-                    : {}),
             };
             return new CodexRuntime(context.identity, deps);
         },
@@ -142,21 +129,15 @@ export function codexRuntimeArgsForMcpServers(servers) {
 /**
  * Default export — the factory Dreamux core's generic provider-loader selects
  * for the `builtin:codex` ref (it imports this package and calls the default
- * export with `{ ref, descriptor }`). It returns a provider that runs on package
- * defaults: a standalone volatile-socket allocator and no host-injected bundled
- * skills.
+ * export with `{ ref }`). It returns a provider on package defaults: a
+ * standalone volatile-socket allocator and no host-injected bundled skills.
  *
- * The Dreamux host does NOT use this bare path in production: its launcher still
- * drives the host-shaped create context, so it constructs the provider through
- * its own core-owned adapter (`@excitedjs/dreamux` `builtin/codex/provider.ts`)
- * to map that context onto the neutral one AND inject its host contracts (the
- * shared runtime-socket root and bundled Dreamux skills; MCP shims receive an
- * explicit dreamux bin path). This default export keeps the package a
- * first-class, loadable `AgentRuntimeProvider` for the generic loader and for
- * external embedders;
- * converging core's launcher onto the neutral context so it can drive the loaded
- * provider directly is later-slice work.
+ * This is the production path. Core drives the loaded provider through the
+ * neutral facade alone — it holds no adapter for this package — and supplies
+ * every host contract (socket root, skill sources, MCP servers, state lease)
+ * through the neutral create context. The options argument of
+ * {@link createCodexAgentRuntimeProvider} exists for embedders and tests.
  */
-const codexAgentRuntimeProviderFactory = (context) => createCodexAgentRuntimeProvider({ descriptor: context.descriptor });
+const codexAgentRuntimeProviderFactory = () => createCodexAgentRuntimeProvider();
 export default codexAgentRuntimeProviderFactory;
 //# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAmClC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAEf,MAAM,UAAU,wBAAwB,CACtC,YAAkD;IAElD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,YAAkD;IAElD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzD,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAA4C,EAAE;IAE9C,OAAO;QACL,eAAe,EAAE,GAAG,EAAE,CAAC,gCAAgC;QACvD,UAAU,EAAE,2BAA2B;QACvC,OAAO,EAAE;YACP,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO;gBAC7B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAC7B,OAAO,EAAE,kBAAkB;oBAC3B,YAAY,EAAE,iBAAiB;oBAC/B,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;gBACH,OAAO,EAAE,GAAG,EAAE,CAAC;YACjB,CAAC;SACF;QACD,MAAM,EAAE;YACN,IAAI,CAAC,SAAS,EAAE,OAAO;gBACrB,OAAO,yBAAyB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5E,CAAC;SACF;QACD,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACrC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC;QACzC,KAAK,CAAC,aAAa,CACjB,OAGC;YAED,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,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC3E,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACzE,wEAAwE;YACxE,mEAAmE;YACnE,MAAM,KAAK,GACT,OAAO,CAAC,YAAY,KAAK,SAAS;gBAChC,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACrD,MAAM,IAAI,GAAqB;gBAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;gBACnD,KAAK;gBACL,KAAK;gBACL,wEAAwE;gBACxE,qEAAqE;gBACrE,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,CACzB,uBAAuB,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,EAAE,CAAC;gBACxD,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,SAAS,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,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,mBAAmB,KAAK,SAAS;oBACnC,CAAC,CAAC,EAAE,mBAAmB,EAAE;oBACzB,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,kBAAkB,KAAK,SAAS;oBAClC,CAAC,CAAC,EAAE,kBAAkB,EAAE;oBACxB,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,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;AAED;;;;;;;;;;;GAWG;AACH,MAAM,gCAAgC,GAGlC,GAAG,EAAE,CAAC,+BAA+B,EAAE,CAAC;AAE5C,eAAe,gCAAgC,CAAC"}

package/dist/runtime-deps.d.ts

@@ -0,0 +1,43 @@
+import type { AgentRuntimeActivitySink, AgentRuntimePathContext, AgentRuntimeSessionRef, AgentRuntimeSkillSource, AgentRuntimeStateSink, DreamuxLogger } from '@excitedjs/dreamux-types';
+import type { CodexOutputSchemaCodec } from './output-schema-codec.js';
+import type { CodexWsClient } from './rpc.js';
+import type { CodexProcess, CodexProcessOptions } from './supervisor.js';
+/**
+ * How this package constructs one resident Codex runtime.
+ *
+ * Package-internal, and only that: `createRuntime` assembles it from the
+ * neutral create context plus the provider's own options, and `CodexRuntime`
+ * consumes it. It is not part of the package's public surface and it is not
+ * the provider's options type — a host configures this provider through
+ * `CodexAgentRuntimeProviderOptions`, which names none of these fields.
+ */
+export interface CodexRuntimeDeps {
+    cwd: string;
+    systemPromptReplace?: string;
+    systemPromptAppend?: readonly string[];
+    state: AgentRuntimeStateSink<AgentRuntimeSessionRef>;
+    paths: AgentRuntimePathContext;
+    /**
+     * The session-bound output schema codec, compiled once at create time. It is
+     * fixed for the life of this runtime; no submission can change it.
+     */
+    codec: CodexOutputSchemaCodec | null;
+    allocateSocketPath: (id: string) => string;
+    skillSources?: readonly AgentRuntimeSkillSource[];
+    injectEnv?: Record<string, string>;
+    codexBinPath?: string;
+    codexProcessFactory?: (opts: CodexProcessOptions) => CodexProcess;
+    codexClientFactory?: (socketPath: string) => CodexWsClient;
+    codexHomeDoctor?: (info: {
+        runtimeId: string;
+        cwd: string;
+    }) => void | Promise<void>;
+    resolveExtraArgs?: () => string[];
+    handshakeTimeoutMs?: number;
+    extraEnv?: Record<string, string>;
+    restartBackoffBaseMs?: number;
+    restartBackoffMaxMs?: number;
+    logger?: DreamuxLogger;
+    activitySink: AgentRuntimeActivitySink;
+}
+//# sourceMappingURL=runtime-deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-deps.d.ts","sourceRoot":"","sources":["../src/runtime-deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,KAAK,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;IACrD,KAAK,EAAE,uBAAuB,CAAC;IAC/B;;;OAGG;IACH,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACrC,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,YAAY,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,YAAY,CAAC;IAClE,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,CAAC;IAC3D,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,gBAAgB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,wBAAwB,CAAC;CACxC"}

package/dist/runtime-deps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-deps.js.map

package/dist/runtime-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-deps.js","sourceRoot":"","sources":["../src/runtime-deps.ts"],"names":[],"mappings":""}