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

package/dist/bin.d.ts

@@ -0,0 +1,14 @@
+import type { DreamuxEnvironment } from '@excitedjs/dreamux-types';
+/**
+ * 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.
+ *
+ * Lives in its own module so both the provider (spawn path) and the diagnostic
+ * (doctor path) import it without forming an import cycle.
+ */
+export declare function resolveCodexBinPath(configBin: string, env?: DreamuxEnvironment): string;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,kBAAgC,GACpC,MAAM,CAIR"}

package/dist/bin.js

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ *
+ * Lives in its own module so both the provider (spawn path) and the diagnostic
+ * (doctor path) import it without forming an import cycle.
+ */
+export function resolveCodexBinPath(configBin, env = process.env) {
+    const fromEnv = env['CODEX_HOST_CODEX_BIN'];
+    if (fromEnv !== undefined && fromEnv.trim() !== '')
+        return fromEnv;
+    return configBin;
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,MAA0B,OAAO,CAAC,GAAG;IAErC,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"}

package/dist/codex-home.d.ts

@@ -0,0 +1,42 @@
+import type { DreamuxEnvironment } from '@excitedjs/dreamux-types';
+export declare const DISPATCHER_APP_SERVER_SOCKET_PATH_MAX_BYTES = 103;
+export interface DispatcherCodexHomeDoctorContext {
+    dispatcherId: string;
+    codexHome: string;
+    configPath: string;
+    /**
+     * The runtime working directory. Optional/empty by default: the validation
+     * never reads it, so a caller that does not have it (e.g. doctor) omits it.
+     */
+    dispatcherCwd: string;
+    /**
+     * A representative socket allocation (issue #182: sockets are random per
+     * start, so this is a sample of the policy, not the path a runtime will
+     * bind). Doctor checks placement (never shared /tmp) and the path budget. An
+     * empty string skips the socket checks (no host candidate dirs were supplied).
+     */
+    socketPath: string;
+    codexCliArgs: string[];
+}
+export interface DispatcherCodexHomeDoctorResult {
+    ok: boolean;
+    errors: string[];
+    context: DispatcherCodexHomeDoctorContext;
+}
+export type DispatcherCodexHomeDoctor = (context: DispatcherCodexHomeDoctorContext) => void | Promise<void>;
+interface DoctorContextOptions {
+    codexCliArgs?: string[];
+    dispatcherCwd?: string;
+    /** Representative socket sample (from the path context's `runtimeSocketDirs()`). */
+    socketPath?: string;
+}
+interface DoctorOptions {
+    env?: DreamuxEnvironment;
+    codexCliArgs?: string[];
+}
+export declare function dispatcherCodexHomeDoctorContext(dispatcherId: string, options?: DoctorContextOptions): DispatcherCodexHomeDoctorContext;
+export declare function validateDispatcherCodexHome(input: string | DispatcherCodexHomeDoctorContext, options?: DoctorOptions): Promise<DispatcherCodexHomeDoctorResult>;
+export declare function assertDispatcherCodexHomeReady(context: DispatcherCodexHomeDoctorContext): Promise<void>;
+export declare function formatDispatcherCodexHomeErrors(result: DispatcherCodexHomeDoctorResult): string;
+export {};
+//# sourceMappingURL=codex-home.d.ts.map

package/dist/codex-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-home.d.ts","sourceRoot":"","sources":["../src/codex-home.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE,eAAO,MAAM,2CAA2C,MACpB,CAAC;AAErC,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,gCAAgC,CAAC;CAC3C;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,gCAAgC,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,gCAAgC,CASlC;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,GAAG,gCAAgC,EAChD,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,+BAA+B,CAAC,CAyD1C;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,+BAA+B,GACtC,MAAM,CAGR"}

package/dist/codex-home.js

@@ -0,0 +1,112 @@
+/**
+ * Codex home/auth pre-start validation (issue #209 cleanup — relocated from
+ * Dreamux core into the owning package).
+ *
+ * This is the codex-engine readiness check: it validates that Codex's own global
+ * home (`~/.codex`) exists, parses its `config.toml`, carries usable auth, and
+ * that the representative app-server socket placement is sane. It is
+ * codex-specific and carries NO `~/.dreamux` knowledge — the host's socket
+ * placement arrives as a neutral sample (`socketPath`) computed from the path
+ * context's `runtimeSocketDirs()`, and `dispatcherCwd` is optional (the
+ * validation never reads it).
+ */
+import { readFile } from 'node:fs/promises';
+import { join, normalize, sep } from 'node:path';
+import { parse as parseToml, TomlError } from 'smol-toml';
+import { DREAMUX_UNIX_SOCKET_PATH_MAX_BYTES, pathExists, unixSocketPathFitsBudget, } from '@excitedjs/dreamux-utils';
+import { dispatcherCodexConfigPath, dispatcherCodexHome } from './paths.js';
+export const DISPATCHER_APP_SERVER_SOCKET_PATH_MAX_BYTES = DREAMUX_UNIX_SOCKET_PATH_MAX_BYTES;
+export function dispatcherCodexHomeDoctorContext(dispatcherId, options = {}) {
+    return {
+        dispatcherId,
+        codexHome: dispatcherCodexHome(dispatcherId),
+        configPath: dispatcherCodexConfigPath(dispatcherId),
+        dispatcherCwd: options.dispatcherCwd ?? '',
+        socketPath: options.socketPath ?? '',
+        codexCliArgs: options.codexCliArgs ?? [],
+    };
+}
+export async function validateDispatcherCodexHome(input, options = {}) {
+    const context = typeof input === 'string'
+        ? dispatcherCodexHomeDoctorContext(input, {
+            codexCliArgs: options.codexCliArgs,
+        })
+        : {
+            ...input,
+            codexCliArgs: options.codexCliArgs ?? input.codexCliArgs,
+        };
+    const errors = [];
+    const env = options.env ?? process.env;
+    if (await pathExists(context.configPath)) {
+        try {
+            const parsed = parseToml(await readFile(context.configPath, 'utf8'));
+            if (!isRecord(parsed)) {
+                errors.push(`Codex config must be a TOML table: ${context.configPath}`);
+            }
+        }
+        catch (err) {
+            errors.push(formatTomlError(err, context.configPath));
+        }
+    }
+    if (!(await pathExists(context.codexHome))) {
+        errors.push(`missing Codex home directory: ${context.codexHome}`);
+    }
+    // An empty socketPath means no host candidate dirs were supplied — skip the
+    // placement/budget checks (a real allocation still fails loud at start time).
+    if (context.socketPath !== '') {
+        if (isTmpPath(context.socketPath)) {
+            errors.push(`dispatcher app-server socket must not be under /tmp: ${context.socketPath}`);
+        }
+        if (!unixSocketPathFitsBudget(context.socketPath)) {
+            const bytes = Buffer.byteLength(context.socketPath, 'utf8');
+            errors.push(`dispatcher app-server socket path is too long for Unix sockets (${bytes} bytes > ${DISPATCHER_APP_SERVER_SOCKET_PATH_MAX_BYTES} safe bytes): ${context.socketPath}`);
+        }
+    }
+    // The bundled dispatcher skill is no longer symlinked into the workspace
+    // (issue #209 slice 6); core injects it at runtime by role via
+    // `skills/extraRoots/set`, so the doctor no longer checks for an on-disk skill.
+    if (!(await hasAuth(context.codexHome, env))) {
+        errors.push(`missing Codex auth state in ${context.codexHome} or a supported auth environment variable`);
+    }
+    return {
+        ok: errors.length === 0,
+        errors,
+        context,
+    };
+}
+export async function assertDispatcherCodexHomeReady(context) {
+    const result = await validateDispatcherCodexHome(context);
+    if (result.ok)
+        return;
+    throw new Error(formatDispatcherCodexHomeErrors(result));
+}
+export function formatDispatcherCodexHomeErrors(result) {
+    const header = `dispatcher '${result.context.dispatcherId}' Codex home is not ready`;
+    return [header, ...result.errors.map((e) => `- ${e}`)].join('\n');
+}
+function formatTomlError(err, file) {
+    if (err instanceof TomlError) {
+        const where = typeof err.line === 'number' && typeof err.column === 'number'
+            ? `${file}:${err.line}:${err.column}`
+            : file;
+        return `Codex config parse error at ${where}: ${err.message}`;
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    return `Codex config parse error in ${file}: ${msg}`;
+}
+async function hasAuth(codexHome, env) {
+    if (await pathExists(join(codexHome, 'auth.json')))
+        return true;
+    return ['OPENAI_API_KEY', 'CODEX_API_KEY', 'CODEX_ACCESS_TOKEN'].some((name) => {
+        const value = env[name];
+        return value !== undefined && value.trim() !== '';
+    });
+}
+function isTmpPath(path) {
+    const normalized = normalize(path);
+    return normalized === '/tmp' || normalized.startsWith(`/tmp${sep}`);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=codex-home.js.map

package/dist/codex-home.js.map

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

package/dist/config.d.ts

@@ -3,9 +3,10 @@
  * the typed accessor.
  *
  * Codex runtime config is owned by this package (the `builtin:codex` provider),
- * not by the Dreamux host config module. It depends only on vendored neutral
- * validation primitives and the package-local provider ref, never on
- * `@excitedjs/dreamux` core. The Dreamux host config module re-exports these so
+ * not by the Dreamux host config module. It depends only on the shared neutral
+ * validation primitives (`@excitedjs/dreamux-utils`) and the package-local
+ * provider ref, never on `@excitedjs/dreamux` core. The Dreamux host config
+ * module re-exports these so
  * the non-builtin callers (doctor, daemon, tests) keep their import paths.
  */
 /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,eAAO,MAAM,yBAAyB,aAKpC,CAAC;AAEH,eAAO,MAAM,qBAAqB,aAIhC,CAAC;AAEH,wBAAgB,4BAA4B,IAAI,qBAAqB,CAUpE;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,qBAAqB,CA0EvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD,GAAG,qBAAqB,CAOxB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,eAAO,MAAM,yBAAyB,aAKpC,CAAC;AAEH,eAAO,MAAM,qBAAqB,aAIhC,CAAC;AAEH,wBAAgB,4BAA4B,IAAI,qBAAqB,CAUpE;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,qBAAqB,CA0EvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD,GAAG,qBAAqB,CAOxB"}

package/dist/config.js

@@ -3,13 +3,14 @@
  * the typed accessor.
  *
  * Codex runtime config is owned by this package (the `builtin:codex` provider),
- * not by the Dreamux host config module. It depends only on vendored neutral
- * validation primitives and the package-local provider ref, never on
- * `@excitedjs/dreamux` core. The Dreamux host config module re-exports these so
+ * not by the Dreamux host config module. It depends only on the shared neutral
+ * validation primitives (`@excitedjs/dreamux-utils`) and the package-local
+ * provider ref, never on `@excitedjs/dreamux` core. The Dreamux host config
+ * module re-exports these so
  * the non-builtin callers (doctor, daemon, tests) keep their import paths.
  */
 import { BUILTIN_CODEX_PROVIDER_REF } from './provider-ref.js';
-import { readOptionalString, rejectUnknownKeys, requirePositiveInt, requireStringArray, requireStringRecord, } from './internal/config-validate.js';
+import { readOptionalString, rejectUnknownKeys, requirePositiveInt, requireStringArray, requireStringRecord, } from '@excitedjs/dreamux-utils';
 /**
  * Default `dispatchers[].runtime.config.bin`. The Codex binary path is
  * dispatcher-local; `CODEX_HOST_CODEX_BIN` is a host-level override above it,

package/dist/config.js.map

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

package/dist/diagnostic.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `builtin:codex` self-reported diagnostic surface (issue #146 fold; relocated
+ * into the owning package by the issue #209 cleanup).
+ *
+ * Declares the codex bin check (deduped + executed by Dreamux core) and runs
+ * the codex-home validation plus the codex version gate (#147) itself,
+ * entirely against the neutral `@excitedjs/dreamux-types` diagnostic context. The
+ * representative app-server socket sample is derived from the neutral path
+ * context's `runtimeSocketDirs()`, so the package never names `~/.dreamux`.
+ */
+import type { AgentRuntimeDiagnostic } from '@excitedjs/dreamux-types';
+import { type DispatcherCodexConfig } from './config.js';
+export declare const codexAgentRuntimeDiagnostic: AgentRuntimeDiagnostic<DispatcherCodexConfig>;
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAEV,sBAAsB,EAIvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkCzD,eAAO,MAAM,2BAA2B,EAAE,sBAAsB,CAAC,qBAAqB,CAiCnF,CAAC"}

package/dist/diagnostic.js

@@ -0,0 +1,58 @@
+import { codexArgsFromConfig, codexArgsToCli } from './args.js';
+import { dispatcherCodexHomeDoctorContext, validateDispatcherCodexHome, } from './codex-home.js';
+import { representativeCodexSocketPath } from './internal/socket.js';
+import { resolveCodexBinPath } from './bin.js';
+import { MIN_CODEX_VERSION, codexVersionSatisfies } from './version.js';
+function codexBinCheckName(scope) {
+    return scope === 'managedService' ? 'managed service Codex binary' : 'codex binary';
+}
+async function checkCodexVersion(context, runner) {
+    const bin = resolveCodexBinPath(context.config.bin, context.env);
+    let raw;
+    try {
+        raw = await runner.capture(bin, ['--version'], { env: context.env });
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err.message : String(err);
+        return `could not determine Codex version from ${bin}: ${cause}; requires codex >= ${MIN_CODEX_VERSION}`;
+    }
+    if (codexVersionSatisfies(raw))
+        return null;
+    return (`Codex at ${bin} reported ${raw.trim() || '<empty>'}; requires codex >= ` +
+        `${MIN_CODEX_VERSION} for teammate completion delivery (thread/inject_items)`);
+}
+export const codexAgentRuntimeDiagnostic = {
+    binChecks(context) {
+        return [
+            {
+                name: codexBinCheckName(context.scope),
+                bin: resolveCodexBinPath(context.config.bin, context.env),
+                args: ['--help'],
+            },
+        ];
+    },
+    async runDiagnostic(context, runner) {
+        const cliArgs = codexArgsToCli(codexArgsFromConfig(context.config));
+        const socketDirs = context.paths?.runtimeSocketDirs() ?? [];
+        const homeContext = dispatcherCodexHomeDoctorContext(context.runtime_id, {
+            codexCliArgs: cliArgs,
+            socketPath: representativeCodexSocketPath(socketDirs, context.runtime_id),
+        });
+        const home = await validateDispatcherCodexHome(homeContext, {
+            env: context.env,
+            codexCliArgs: cliArgs,
+        });
+        const errors = [...home.errors];
+        const versionError = await checkCodexVersion(context, runner);
+        if (versionError !== null)
+            errors.push(versionError);
+        // Detail mirrors the old printCodexHomeDoctor line (the codex home path);
+        // per-problem lines live in `errors`.
+        return {
+            ok: errors.length === 0,
+            detail: homeContext.codexHome,
+            errors,
+        };
+    },
+};
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

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

package/dist/index.d.ts

@@ -4,9 +4,10 @@
  * `@excitedjs/dreamux-types` `AgentRuntimeProvider` contract; never imports
  * `@excitedjs/dreamux` core.
  */
-export { default, createCodexAgentRuntimeProvider, resolveCodexBinPath, codexRuntimeArgsForMcpServers, dispatcherCodexConfig, CODEX_AGENT_RUNTIME_CAPABILITIES, type CodexAgentRuntimeProviderOptions, type CodexProviderFactoryContext, } from './provider.js';
+export { default, createCodexAgentRuntimeProvider, codexRuntimeArgsForMcpServers, dispatcherCodexConfig, CODEX_AGENT_RUNTIME_CAPABILITIES, type CodexAgentRuntimeProviderOptions, type CodexProviderFactoryContext, } from './provider.js';
+export { resolveCodexBinPath } from './bin.js';
 export { CodexRuntime, type CodexRuntimeDeps, } from './runtime.js';
-export { CodexProcess, type CodexProcessOptions, type CodexProcessExit, } from './supervisor.js';
+export { CodexProcess, type CodexProcessOptions, type CodexProcessExit, type CodexProcessExitHandler, } from './supervisor.js';
 export { CodexWsClient, type CodexWsClientOptions, type NotificationHandler, } from './rpc.js';
 export type { ServerNotification, ServerRequest, ThreadStartResponse, TurnStartResponse, } from './types.js';
 export { performInitializeHandshake } from './handshake.js';
@@ -15,4 +16,7 @@ export { parseCodexArgs, codexArgsFromConfig, codexArgsToCli, type ParsedCodexAr
 export { type DispatcherCodexConfig, readDispatcherCodexConfig, defaultDispatcherCodexConfig, DEFAULT_CODEX_BIN, DEFAULT_INITIALIZE_TIMEOUT_MS, DEFAULT_CODEX_TURN_TIMEOUT_MS, DEFAULT_APPROVAL_POLICY, DEFAULT_SANDBOX_MODE, ALLOWED_APPROVAL_POLICIES, ALLOWED_SANDBOX_MODES, } from './config.js';
 export { MIN_CODEX_VERSION, parseCodexVersion, codexVersionSatisfies, } from './version.js';
 export { BUILTIN_CODEX_PROVIDER_REF } from './provider-ref.js';
+export { codexAgentRuntimeDiagnostic } from './diagnostic.js';
+export { DISPATCHER_APP_SERVER_SOCKET_PATH_MAX_BYTES, dispatcherCodexHomeDoctorContext, validateDispatcherCodexHome, assertDispatcherCodexHomeReady, formatDispatcherCodexHomeErrors, type DispatcherCodexHomeDoctor, type DispatcherCodexHomeDoctorContext, type DispatcherCodexHomeDoctorResult, } from './codex-home.js';
+export { operatorCodexHome, dispatcherCodexHome, dispatcherCodexConfigPath, } from './paths.js';
 //# sourceMappingURL=index.d.ts.map

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,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,GACjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,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"}

package/dist/index.js

@@ -4,7 +4,8 @@
  * `@excitedjs/dreamux-types` `AgentRuntimeProvider` contract; never imports
  * `@excitedjs/dreamux` core.
  */
-export { default, createCodexAgentRuntimeProvider, resolveCodexBinPath, codexRuntimeArgsForMcpServers, dispatcherCodexConfig, CODEX_AGENT_RUNTIME_CAPABILITIES, } from './provider.js';
+export { default, createCodexAgentRuntimeProvider, codexRuntimeArgsForMcpServers, dispatcherCodexConfig, CODEX_AGENT_RUNTIME_CAPABILITIES, } from './provider.js';
+export { resolveCodexBinPath } from './bin.js';
 export { CodexRuntime, } from './runtime.js';
 export { CodexProcess, } from './supervisor.js';
 export { CodexWsClient, } from './rpc.js';
@@ -14,4 +15,10 @@ export { parseCodexArgs, codexArgsFromConfig, codexArgsToCli, } from './args.js'
 export { readDispatcherCodexConfig, defaultDispatcherCodexConfig, DEFAULT_CODEX_BIN, DEFAULT_INITIALIZE_TIMEOUT_MS, DEFAULT_CODEX_TURN_TIMEOUT_MS, DEFAULT_APPROVAL_POLICY, DEFAULT_SANDBOX_MODE, ALLOWED_APPROVAL_POLICIES, ALLOWED_SANDBOX_MODES, } from './config.js';
 export { MIN_CODEX_VERSION, parseCodexVersion, codexVersionSatisfies, } from './version.js';
 export { BUILTIN_CODEX_PROVIDER_REF } from './provider-ref.js';
+// The Codex diagnostic surface now lives in this package (issue #209 cleanup):
+// the provider diagnostic, the Codex home/auth validation, and the Codex
+// home/config path resolvers. Core's doctor + onboard consume these directly.
+export { codexAgentRuntimeDiagnostic } from './diagnostic.js';
+export { DISPATCHER_APP_SERVER_SOCKET_PATH_MAX_BYTES, dispatcherCodexHomeDoctorContext, validateDispatcherCodexHome, assertDispatcherCodexHomeReady, formatDispatcherCodexHomeErrors, } from './codex-home.js';
+export { operatorCodexHome, dispatcherCodexHome, dispatcherCodexConfigPath, } from './paths.js';
 //# sourceMappingURL=index.js.map

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,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,EACrB,gCAAgC,GAGjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,GAGb,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,+BAA+B,EAC/B,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"}

package/dist/internal/socket.d.ts

@@ -1,14 +1,23 @@
 /**
- * Standalone default for the volatile rendezvous-socket path, used when no host
- * socket allocator is injected (e.g. the bare generic-loader path or external
- * standalone use).
- *
- * This is the PACKAGE's own fallback root — `$XDG_RUNTIME_DIR` when set, else the
- * OS temp dir — and is deliberately NOT the Dreamux host socket contract. The
- * Dreamux host injects its own allocator (its shared runtime-socket root) through
- * the provider adapter, so this fallback never duplicates or drifts that
- * contract; it only keeps a loader-constructed runtime runnable on its own. The
+ * Standalone default for the volatile socket path, used when no host candidate
+ * directories are supplied (the bare generic-loader path or external standalone
+ * use). This is the PACKAGE's own fallback root — `$XDG_RUNTIME_DIR` when set,
+ * else the OS temp dir — deliberately NOT the Dreamux host socket contract. The
  * path is random per call and never persisted.
  */
 export declare function defaultVolatileSocketPath(id: string): string;
+/**
+ * Allocate a fresh Codex app-server socket path inside the first host candidate
+ * directory whose full path fits the socket budget. Fails loud (naming `id`)
+ * when even the last candidate is over budget. With no candidate directories it
+ * uses {@link defaultVolatileSocketPath}.
+ */
+export declare function allocateCodexSocketPath(socketDirs: readonly string[], id: string): string;
+/**
+ * A representative, NON-throwing socket sample for the doctor: the first
+ * candidate whose path fits, else the last candidate (which is then over budget,
+ * so the home doctor can REPORT it as an error rather than throwing here). With
+ * no candidate directories it uses {@link defaultVolatileSocketPath}.
+ */
+export declare function representativeCodexSocketPath(socketDirs: readonly string[], id: string): string;
 //# sourceMappingURL=socket.d.ts.map

package/dist/internal/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/internal/socket.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/internal/socket.ts"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,EAAE,EAAE,MAAM,GACT,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,EAAE,EAAE,MAAM,GACT,MAAM,CAQR"}

package/dist/internal/socket.js

@@ -1,22 +1,73 @@
-import { randomUUID } from 'node:crypto';
+import { randomBytes, randomUUID } from 'node:crypto';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+import { assertUnixSocketPathBudget, unixSocketPathFitsBudget, } from '@excitedjs/dreamux-utils';
 /**
- * Standalone default for the volatile rendezvous-socket path, used when no host
- * socket allocator is injected (e.g. the bare generic-loader path or external
- * standalone use).
+ * Volatile rendezvous-socket allocation for the Codex app-server (issue #182,
+ * relocated into this package by the issue #209 cleanup).
  *
- * This is the PACKAGE's own fallback root — `$XDG_RUNTIME_DIR` when set, else the
- * OS temp dir — and is deliberately NOT the Dreamux host socket contract. The
- * Dreamux host injects its own allocator (its shared runtime-socket root) through
- * the provider adapter, so this fallback never duplicates or drifts that
- * contract; it only keeps a loader-constructed runtime runnable on its own. The
+ * A Codex socket is a pure per-start rendezvous endpoint: dreamux starts
+ * `codex app-server --listen unix://<path>` and connects with `ws+unix://<path>`
+ * immediately. Nothing resumes from a socket path, so every allocation is a
+ * fresh short random name and the path is never persisted.
+ *
+ * Dreamux core no longer hands this package a socket-allocator FUNCTION. Instead
+ * the neutral create/diagnostic context exposes the host's preference-ordered
+ * candidate directories (`AgentRuntimePathContext.runtimeSocketDirs()`), and this
+ * package owns the allocation policy: pick the first candidate whose full path
+ * fits the Unix `sun_path` budget (via `@excitedjs/dreamux-utils`), else fail
+ * loud. When the host supplies no candidate directories (the bare generic-loader
+ * / standalone path) the package falls back to its own short root.
+ */
+function socketName() {
+    return `${randomBytes(6).toString('base64url')}.sock`;
+}
+/**
+ * Standalone default for the volatile socket path, used when no host candidate
+ * directories are supplied (the bare generic-loader path or external standalone
+ * use). This is the PACKAGE's own fallback root — `$XDG_RUNTIME_DIR` when set,
+ * else the OS temp dir — deliberately NOT the Dreamux host socket contract. The
  * path is random per call and never persisted.
  */
 export function defaultVolatileSocketPath(id) {
     const root = globalThis.process.env['XDG_RUNTIME_DIR'] ?? tmpdir();
     return join(root, `arc-${sanitize(id)}-${randomUUID().slice(0, 8)}.sock`);
 }
+/**
+ * Allocate a fresh Codex app-server socket path inside the first host candidate
+ * directory whose full path fits the socket budget. Fails loud (naming `id`)
+ * when even the last candidate is over budget. With no candidate directories it
+ * uses {@link defaultVolatileSocketPath}.
+ */
+export function allocateCodexSocketPath(socketDirs, id) {
+    if (socketDirs.length === 0)
+        return defaultVolatileSocketPath(id);
+    const name = socketName();
+    for (const dir of socketDirs) {
+        const path = join(dir, name);
+        if (unixSocketPathFitsBudget(path))
+            return path;
+    }
+    const fallback = socketDirs[socketDirs.length - 1];
+    return assertUnixSocketPathBudget(join(fallback, name), `dispatcher '${id}' Codex socket path`);
+}
+/**
+ * A representative, NON-throwing socket sample for the doctor: the first
+ * candidate whose path fits, else the last candidate (which is then over budget,
+ * so the home doctor can REPORT it as an error rather than throwing here). With
+ * no candidate directories it uses {@link defaultVolatileSocketPath}.
+ */
+export function representativeCodexSocketPath(socketDirs, id) {
+    if (socketDirs.length === 0)
+        return defaultVolatileSocketPath(id);
+    const name = socketName();
+    for (const dir of socketDirs) {
+        const path = join(dir, name);
+        if (unixSocketPathFitsBudget(path))
+            return path;
+    }
+    return join(socketDirs[socketDirs.length - 1], name);
+}
 function sanitize(id) {
     return id.replace(/[^A-Za-z0-9._-]/g, '_');
 }

package/dist/internal/socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/internal/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM,EAAE,CAAC;IACnE,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,QAAQ,CAAC,EAAU;IAC1B,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/internal/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AAEH,SAAS,UAAU;IACjB,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM,EAAE,CAAC;IACnE,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA6B,EAC7B,EAAU;IAEV,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,wBAAwB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAClD,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAW,CAAC;IAC7D,OAAO,0BAA0B,CAC/B,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EACpB,eAAe,EAAE,qBAAqB,CACvC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA6B,EAC7B,EAAU;IAEV,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,wBAAwB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,QAAQ,CAAC,EAAU;IAC1B,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,7 @@
+/** The operator's global Codex home (`~/.codex`). */
+export declare function operatorCodexHome(): string;
+/** A runtime's Codex home — the operator's global home (no dispatcher-private home). */
+export declare function dispatcherCodexHome(id: string): string;
+/** A runtime's Codex `config.toml` path, under its (operator-global) Codex home. */
+export declare function dispatcherCodexConfigPath(id: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAaA,qDAAqD;AACrD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/paths.js

@@ -0,0 +1,26 @@
+/**
+ * Codex home/config paths (issue #209 cleanup — relocated from Dreamux core).
+ *
+ * These resolve Codex's OWN global home (`~/.codex`) and config file. They are
+ * codex-engine-specific and homedir-only: they carry no `~/.dreamux` knowledge,
+ * so they belong to this package, not to Dreamux core. Dreamux does NOT create a
+ * dispatcher-private `CODEX_HOME` for the MVP — every runtime follows the
+ * operator's global Codex home — so the per-runtime accessors accept an id only
+ * for call-site symmetry and ignore it.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** The operator's global Codex home (`~/.codex`). */
+export function operatorCodexHome() {
+    return join(homedir(), '.codex');
+}
+/** A runtime's Codex home — the operator's global home (no dispatcher-private home). */
+export function dispatcherCodexHome(id) {
+    void id;
+    return operatorCodexHome();
+}
+/** A runtime's Codex `config.toml` path, under its (operator-global) Codex home. */
+export function dispatcherCodexConfigPath(id) {
+    return join(dispatcherCodexHome(id), 'config.toml');
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qDAAqD;AACrD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,KAAK,EAAE,CAAC;IACR,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,OAAO,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC"}