@excitedjs/agent-runtime-claude-code 0.2.0-alpha.g0ddd418597ca

package/dist/internal/config-validate.js

@@ -0,0 +1,122 @@
+/**
+ * Neutral config validation primitives.
+ *
+ * Extracted from `config/config.ts` so that per-runtime config readers (each
+ * builtin's `agent-runtime/builtin/<name>/config.ts`) can validate their own
+ * config blocks without importing `config/config.ts` — importing the host
+ * config module from a builtin would re-form the builtin -> config import
+ * cycle. These helpers are runtime-agnostic: they only know about JSON shapes
+ * and produce `dreamux config error in <file>: ...` messages.
+ */
+export function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+export function describeType(v) {
+    if (v === null)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    return typeof v;
+}
+export function rejectUnknownKeys(obj, allowed, file, prefix) {
+    for (const key of Object.keys(obj)) {
+        if (allowed.has(key))
+            continue;
+        const name = `${prefix}${key}`;
+        if (/^dispatchers\[\d+\]\.$/.test(prefix) && (key === 'feishu' || key === 'codex')) {
+            throw new Error(`dreamux config error in ${file}: ${name} is not supported by the providerized config v2 schema.\n` +
+                'Dreamux 0.x does not silently migrate operator-owned config. Rebuild this dispatcher with ' +
+                'dispatchers[].channels[] for the channel and a named agents[] entry referenced via ' +
+                'dispatchers[].agentRuntime for the runtime, then restart.');
+        }
+        throw new Error(`dreamux config error in ${file}: ${name} is not supported by the providerized config v2 schema`);
+    }
+}
+function ensureString(v, key, file) {
+    if (typeof v !== 'string') {
+        throw new Error(`dreamux config error in ${file}: ${key} must be a string (got ${describeType(v)})`);
+    }
+    return v;
+}
+function requireString(obj, key, fallback, file, prefix = '') {
+    const v = obj[key];
+    if (v === undefined)
+        return fallback;
+    return ensureString(v, `${prefix}${key}`, file);
+}
+export function requireNonEmptyString(obj, key, file, prefix = '') {
+    const value = requireString(obj, key, '', file, prefix);
+    if (value.trim() !== '')
+        return value;
+    throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be a non-empty string`);
+}
+export function readOptionalString(obj, key, file, prefix = '') {
+    const v = obj[key];
+    if (v === undefined || v === null)
+        return null;
+    return ensureString(v, `${prefix}${key}`, file);
+}
+export function readOptionalBoolean(obj, key, fallback, file, prefix = '') {
+    const v = obj[key];
+    if (v === undefined)
+        return fallback;
+    if (typeof v === 'boolean')
+        return v;
+    throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be a boolean (got ${describeType(v)})`);
+}
+export function requireStringArray(obj, key, fallback, file, prefix = '') {
+    const v = obj[key];
+    if (v === undefined)
+        return fallback;
+    if (!Array.isArray(v)) {
+        throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be an array of strings (got ${describeType(v)})`);
+    }
+    return v.map((item, i) => {
+        if (typeof item !== 'string') {
+            throw new Error(`dreamux config error in ${file}: ${prefix}${key}[${i}] must be a string (got ${describeType(item)})`);
+        }
+        return item;
+    });
+}
+export function requireStringRecord(obj, key, fallback, file, prefix = '') {
+    const v = obj[key];
+    if (v === undefined)
+        return { ...fallback };
+    if (!isPlainObject(v)) {
+        throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be an object of strings (got ${describeType(v)})`);
+    }
+    const out = {};
+    for (const [entryKey, entryValue] of Object.entries(v)) {
+        if (typeof entryValue !== 'string') {
+            throw new Error(`dreamux config error in ${file}: ${prefix}${key}.${entryKey} must be a string (got ${describeType(entryValue)})`);
+        }
+        out[entryKey] = entryValue;
+    }
+    return out;
+}
+function readInt(obj, key, file, prefix) {
+    const v = obj[key];
+    if (v === undefined)
+        return null;
+    if (typeof v === 'number' && Number.isInteger(v))
+        return v;
+    throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be an integer (got ${describeType(v)})`);
+}
+export function requirePositiveInt(obj, key, fallback, file, prefix = '') {
+    const n = readInt(obj, key, file, prefix);
+    if (n === null)
+        return fallback;
+    if (n <= 0) {
+        throw new Error(`dreamux config error in ${file}: ${prefix}${key} must be > 0 (got ${n})`);
+    }
+    return n;
+}
+export function readProviderConfigObject(rawConfig, file, name, options = {}) {
+    if (rawConfig === undefined && options.allowMissing === true)
+        return {};
+    if (!isPlainObject(rawConfig)) {
+        throw new Error(`dreamux config error in ${file}: ${name} must be an object (got ${describeType(rawConfig)})`);
+    }
+    return rawConfig;
+}
+//# sourceMappingURL=config-validate.js.map

package/dist/internal/config-validate.js.map

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

package/dist/internal/os.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generic OS/filesystem utilities the Codex runtime needs, vendored into this
+ * package so it depends on `@excitedjs/dreamux-types` only and never imports
+ * `@excitedjs/dreamux` core. These are platform primitives (process-group
+ * signalling, owner-only dir enforcement, empty-log cleanup, existence probe),
+ * NOT Dreamux host layout/path/socket/log contracts — those are supplied by the
+ * host through the create context and provider options.
+ */
+/** True when `pid` names a live process (EPERM counts as alive). */
+export declare function isProcessAlive(pid: number): boolean;
+/** Signal an entire process group; ESRCH/EPERM are swallowed. */
+export declare function killProcessGroup(pgid: number, signal: NodeJS.Signals | number): void;
+export interface EnsureOwnerOnlyDirOptions {
+    /** Current-user uid probe override (tests). */
+    getuid?: () => number;
+}
+/**
+ * Create/adopt a directory and guarantee the owner-only (0700) privacy
+ * invariant regardless of who created it: reject a symlink leaf, fail loud on a
+ * foreign-uid dir, and tighten any group/other permission bits.
+ */
+export declare function ensureOwnerOnlyDir(path: string, options?: EnsureOwnerOnlyDirOptions): Promise<void>;
+/**
+ * Remove `path` only if it exists and is zero bytes. Best-effort: a missing,
+ * non-empty, or busy file is left untouched and never throws.
+ */
+export declare function removeEmptyLogFile(path: string): Promise<void>;
+/** Best-effort existence probe — the async replacement for `existsSync`. */
+export declare function pathExists(path: string): Promise<boolean>;
+//# sourceMappingURL=os.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"os.d.ts","sourceRoot":"","sources":["../../src/internal/os.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAC9B,IAAI,CASN;AAED,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED,4EAA4E;AAC5E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}

package/dist/internal/os.js

@@ -0,0 +1,81 @@
+/**
+ * Generic OS/filesystem utilities the Codex runtime needs, vendored into this
+ * package so it depends on `@excitedjs/dreamux-types` only and never imports
+ * `@excitedjs/dreamux` core. These are platform primitives (process-group
+ * signalling, owner-only dir enforcement, empty-log cleanup, existence probe),
+ * NOT Dreamux host layout/path/socket/log contracts — those are supplied by the
+ * host through the create context and provider options.
+ */
+import { access, chmod, lstat, mkdir, stat, unlink } from 'node:fs/promises';
+/** True when `pid` names a live process (EPERM counts as alive). */
+export function isProcessAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        const errno = e.code;
+        return errno === 'EPERM';
+    }
+}
+/** Signal an entire process group; ESRCH/EPERM are swallowed. */
+export function killProcessGroup(pgid, signal) {
+    if (!Number.isFinite(pgid) || pgid <= 0)
+        return;
+    try {
+        process.kill(-pgid, signal);
+    }
+    catch (e) {
+        const errno = e.code;
+        if (errno === 'ESRCH' || errno === 'EPERM')
+            return;
+        throw e;
+    }
+}
+/**
+ * Create/adopt a directory and guarantee the owner-only (0700) privacy
+ * invariant regardless of who created it: reject a symlink leaf, fail loud on a
+ * foreign-uid dir, and tighten any group/other permission bits.
+ */
+export async function ensureOwnerOnlyDir(path, options = {}) {
+    await mkdir(path, { recursive: true, mode: 0o700 });
+    const info = await lstat(path);
+    if (info.isSymbolicLink()) {
+        throw new Error(`refusing to use Dreamux runtime directory ${path}: it is a symlink, not a real directory`);
+    }
+    const getuid = options.getuid ?? process.getuid?.bind(process);
+    if (getuid !== undefined && info.uid !== getuid()) {
+        throw new Error(`refusing to use Dreamux runtime directory ${path}: it is owned by uid ${info.uid}, ` +
+            `not the current user (uid ${getuid()})`);
+    }
+    if ((info.mode & 0o077) !== 0) {
+        await chmod(path, 0o700);
+    }
+}
+/**
+ * Remove `path` only if it exists and is zero bytes. Best-effort: a missing,
+ * non-empty, or busy file is left untouched and never throws.
+ */
+export async function removeEmptyLogFile(path) {
+    try {
+        const info = await stat(path);
+        if (info.size === 0)
+            await unlink(path);
+    }
+    catch {
+        /* best effort — missing/busy/non-empty files are left as-is */
+    }
+}
+/** Best-effort existence probe — the async replacement for `existsSync`. */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=os.js.map

package/dist/internal/os.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os.js","sourceRoot":"","sources":["../../src/internal/os.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE7E,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAI,CAA2B,CAAC,IAAI,CAAC;QAChD,OAAO,KAAK,KAAK,OAAO,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAA+B;IAE/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO;IAChD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAI,CAA2B,CAAC,IAAI,CAAC;QAChD,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO;QACnD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,UAAqC,EAAE;IAEvC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,yCAAyC,CAC3F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,wBAAwB,IAAI,CAAC,GAAG,IAAI;YACnF,6BAA6B,MAAM,EAAE,GAAG,CAC3C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/internal/turn-render.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Inbound-turn render helpers. The data shapes are published by
+ * `@excitedjs/dreamux-types`; these executable helpers render a neutral
+ * `InboundTurnInput` into Claude Code delivery text. Mirrors the host's neutral
+ * `agent-runtime/turn.ts` runtime helpers, vendored here so this package never
+ * imports `@excitedjs/dreamux` core.
+ */
+import type { InboundTurnInput } from '@excitedjs/dreamux-types';
+export declare const DEFAULT_MESSAGE_ID_DEDUPE_WINDOW = 1024;
+/**
+ * Wrap a channel turn body in the native `<channel source="…" …>` envelope.
+ * Only safe attribute keys (`^[a-zA-Z_][a-zA-Z0-9_]*$`) are rendered and every
+ * value is XML-escaped.
+ */
+export declare function renderChannelBlock(source: string, attrs: ReadonlyArray<readonly [string, string]>, body: string): string;
+/**
+ * Render an inbound turn to delivery text. A channel-structured input (both
+ * `attrs` and `body` present) is wrapped into the `<channel>` block; a plain
+ * input (e.g. a system trigger turn) passes its `text` through unchanged.
+ */
+export declare function renderChannelInput(input: InboundTurnInput): string;
+//# sourceMappingURL=turn-render.d.ts.map

package/dist/internal/turn-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-render.d.ts","sourceRoot":"","sources":["../../src/internal/turn-render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAYrD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/C,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAKlE"}

package/dist/internal/turn-render.js

@@ -0,0 +1,40 @@
+/**
+ * Inbound-turn render helpers. The data shapes are published by
+ * `@excitedjs/dreamux-types`; these executable helpers render a neutral
+ * `InboundTurnInput` into Claude Code delivery text. Mirrors the host's neutral
+ * `agent-runtime/turn.ts` runtime helpers, vendored here so this package never
+ * imports `@excitedjs/dreamux` core.
+ */
+export const DEFAULT_MESSAGE_ID_DEDUPE_WINDOW = 1024;
+const SAFE_CHANNEL_ATTR_KEY = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function escapeChannelAttr(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;');
+}
+/**
+ * Wrap a channel turn body in the native `<channel source="…" …>` envelope.
+ * Only safe attribute keys (`^[a-zA-Z_][a-zA-Z0-9_]*$`) are rendered and every
+ * value is XML-escaped.
+ */
+export function renderChannelBlock(source, attrs, body) {
+    const rendered = attrs
+        .filter(([key]) => SAFE_CHANNEL_ATTR_KEY.test(key))
+        .map(([key, value]) => ` ${key}="${escapeChannelAttr(value)}"`)
+        .join('');
+    return `<channel source="${escapeChannelAttr(source)}"${rendered}>\n${body}\n</channel>`;
+}
+/**
+ * Render an inbound turn to delivery text. A channel-structured input (both
+ * `attrs` and `body` present) is wrapped into the `<channel>` block; a plain
+ * input (e.g. a system trigger turn) passes its `text` through unchanged.
+ */
+export function renderChannelInput(input) {
+    if (input.attrs === undefined || input.body === undefined) {
+        return input.text;
+    }
+    return renderChannelBlock(input.source ?? 'channel', input.attrs, input.body);
+}
+//# sourceMappingURL=turn-render.js.map

package/dist/internal/turn-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-render.js","sourceRoot":"","sources":["../../src/internal/turn-render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAErD,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEzD,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,KAA+C,EAC/C,IAAY;IAEZ,MAAM,QAAQ,GAAG,KAAK;SACnB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC;SAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,oBAAoB,iBAAiB,CAAC,MAAM,CAAC,IAAI,QAAQ,MAAM,IAAI,cAAc,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAChF,CAAC"}

package/dist/mcp-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Claude Code MCP config document translation.
+ *
+ * Mirrors `codex/mcp-config.ts`: the same Dreamux MCP descriptors become
+ * Claude Code's native JSON document loaded via `--mcp-config <file>`.
+ */
+import type { AgentRuntimeMcpServer } from '@excitedjs/dreamux-types';
+/** Claude Code MCP config document shape (`--mcp-config <file>`). */
+export interface ClaudeCodeMcpConfig {
+    mcpServers: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+}
+/** Translate Dreamux MCP descriptors into Claude Code's MCP config document. */
+export declare function claudeCodeMcpConfig(servers: readonly AgentRuntimeMcpServer[]): ClaudeCodeMcpConfig;
+/** Serialize the Claude Code MCP config for writing to disk. */
+export declare function stringifyClaudeCodeMcpConfig(servers: readonly AgentRuntimeMcpServer[]): string;
+//# sourceMappingURL=mcp-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,mBAAmB,CASrB;AAED,gEAAgE;AAChE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,CAER"}

package/dist/mcp-config.js

@@ -0,0 +1,22 @@
+/**
+ * Claude Code MCP config document translation.
+ *
+ * Mirrors `codex/mcp-config.ts`: the same Dreamux MCP descriptors become
+ * Claude Code's native JSON document loaded via `--mcp-config <file>`.
+ */
+/** Translate Dreamux MCP descriptors into Claude Code's MCP config document. */
+export function claudeCodeMcpConfig(servers) {
+    const mcpServers = {};
+    for (const server of servers) {
+        mcpServers[server.name] = {
+            command: server.command,
+            args: [...server.args],
+        };
+    }
+    return { mcpServers };
+}
+/** Serialize the Claude Code MCP config for writing to disk. */
+export function stringifyClaudeCodeMcpConfig(servers) {
+    return `${JSON.stringify(claudeCodeMcpConfig(servers), null, 2)}\n`;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CACjC,OAAyC;IAEzC,MAAM,UAAU,GAAsC,EAAE,CAAC;IACzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;YACxB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,4BAA4B,CAC1C,OAAyC;IAEzC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/provider-ref.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The stable built-in provider ref this package ships behind. Dreamux core maps
+ * `builtin:claude-code` to `@excitedjs/agent-runtime-claude-code`; the ref string
+ * is the package's own public identity, so it is owned here rather than imported
+ * from core (which this package must never depend on).
+ */
+export declare const BUILTIN_CLAUDE_CODE_PROVIDER_REF = "builtin:claude-code";
+//# sourceMappingURL=provider-ref.d.ts.map

package/dist/provider-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-ref.d.ts","sourceRoot":"","sources":["../src/provider-ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,wBAAwB,CAAC"}

package/dist/provider-ref.js

@@ -0,0 +1,8 @@
+/**
+ * The stable built-in provider ref this package ships behind. Dreamux core maps
+ * `builtin:claude-code` to `@excitedjs/agent-runtime-claude-code`; the ref string
+ * is the package's own public identity, so it is owned here rather than imported
+ * from core (which this package must never depend on).
+ */
+export const BUILTIN_CLAUDE_CODE_PROVIDER_REF = 'builtin:claude-code';
+//# sourceMappingURL=provider-ref.js.map

package/dist/provider-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-ref.js","sourceRoot":"","sources":["../src/provider-ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,qBAAqB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,60 @@
+import { dispatcherClaudeCodeConfig, type DispatcherClaudeCodeConfig } from './config.js';
+import { type ClaudeCodeSessionFactory } from './supervisor.js';
+import type { AgentRuntimeCapabilities, AgentRuntimeProvider, AgentRuntimeProviderDescriptor, AgentRuntimeProviderFactory, ProviderDescriptor, ProviderFactoryContext } from '@excitedjs/dreamux-types';
+/**
+ * Construction options for the built-in Claude Code provider. Env injection now
+ * arrives on the NEUTRAL create context (`context.injectEnv`), not as a factory
+ * hook. What remains here is the `descriptor` and the test/host seams (the
+ * resident-session factory, an optional host bin resolver) that let core and
+ * tests wire behavior without changing the provider.
+ */
+export interface ClaudeCodeAgentRuntimeProviderOptions {
+    /**
+     * The registry descriptor for `builtin:claude-code`. 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 host-level bin resolver (default: identity on the config bin). */
+    resolveBinPath?: (bin: string) => string;
+    /** Override the resident-session factory (tests inject a fake). */
+    sessionFactory?: ClaudeCodeSessionFactory;
+}
+export declare const CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES: AgentRuntimeCapabilities;
+/**
+ * Create the built-in Claude Code `AgentRuntimeProvider`. It implements the
+ * neutral `@excitedjs/dreamux-types` contract: `readConfig` parses Claude Code
+ * runtime config, `getCapabilities` reports its append/synthesized/plain-turn
+ * shape, and `createRuntime` builds a {@link ClaudeCodeRuntime} from the neutral
+ * create context plus the host-supplied options.
+ */
+export declare function createClaudeCodeAgentRuntimeProvider(options?: ClaudeCodeAgentRuntimeProviderOptions): AgentRuntimeProvider<DispatcherClaudeCodeConfig>;
+/** Re-export the typed accessor for a runtime's resolved claude-code config. */
+export { dispatcherClaudeCodeConfig };
+/**
+ * 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 ClaudeCodeProviderFactoryContext = ProviderFactoryContext<AgentRuntimeProviderDescriptor>;
+/**
+ * Default export — the factory Dreamux core's generic provider-loader selects
+ * for the `builtin:claude-code` ref (it imports this package and calls the
+ * default export with `{ ref, descriptor }`). It returns a provider that runs on
+ * package defaults: the real resident-session factory, an identity bin resolver,
+ * and `process.env` base env.
+ *
+ * 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/claude-code/provider.ts`) to map that context onto the neutral one
+ * AND inject its host contracts (the package-bin `PATH`, the durable state sink,
+ * the per-dispatcher path context). This default export keeps the package a
+ * first-class, loadable `AgentRuntimeProvider` for the generic loader and for
+ * external embedders.
+ */
+declare const claudeCodeAgentRuntimeProviderFactory: AgentRuntimeProviderFactory<DispatcherClaudeCodeConfig>;
+export default claudeCodeAgentRuntimeProviderFactory;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,0BAA0B,EAE1B,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EACV,wBAAwB,EAGxB,oBAAoB,EACpB,8BAA8B,EAC9B,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,WAAW,qCAAqC;IACpD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,mEAAmE;IACnE,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C;AAED,eAAO,MAAM,sCAAsC,EAAE,wBAcpD,CAAC;AAyBF;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,qCAA0C,GAClD,oBAAoB,CAAC,0BAA0B,CAAC,CAyDlD;AAED,gFAAgF;AAChF,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC,GAC1C,sBAAsB,CAAC,8BAA8B,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,qCAAqC,EAAE,2BAA2B,CAAC,0BAA0B,CAEvB,CAAC;AAE7E,eAAe,qCAAqC,CAAC"}

package/dist/provider.js

@@ -0,0 +1,110 @@
+import { ClaudeCodeRuntime, } from './runtime.js';
+import { dispatcherClaudeCodeConfig, readDispatcherClaudeCodeConfig, } from './config.js';
+import { createDefaultClaudeCodeSession, } from './supervisor.js';
+import { BUILTIN_CLAUDE_CODE_PROVIDER_REF } from './provider-ref.js';
+import { claudeCodeAgentRuntimeDiagnostic } from './diagnostic.js';
+export const CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES = {
+    resume: { supported: true, checkpoint: 'claudeCodeSession' },
+    steer: { supported: true },
+    events: { kind: 'synthesized' },
+    last: { supported: true },
+    context: { supported: false },
+    systemPrompt: { mode: 'append' },
+    teammateCompletion: [
+        {
+            kind: 'claudeCodePlainTurn',
+            description: 'deliver the completion as a plain user turn (no task-notification harness path)',
+        },
+    ],
+};
+const DEFAULT_CLAUDE_CODE_DESCRIPTOR = {
+    id: 'claude-code',
+    kind: 'agentRuntime',
+    ref: {
+        source: 'builtin',
+        id: 'claude-code',
+        raw: BUILTIN_CLAUDE_CODE_PROVIDER_REF,
+    },
+};
+/** Validate + narrow a seed descriptor to the Agent Runtime kind. */
+function asAgentRuntimeDescriptor(descriptor) {
+    if (descriptor.kind !== 'agentRuntime') {
+        throw new Error(`@excitedjs/agent-runtime-claude-code: descriptor.kind must be ` +
+            `'agentRuntime' (got ${JSON.stringify(descriptor.kind)})`);
+    }
+    return { ...descriptor, kind: descriptor.kind };
+}
+/**
+ * Create the built-in Claude Code `AgentRuntimeProvider`. It implements the
+ * neutral `@excitedjs/dreamux-types` contract: `readConfig` parses Claude Code
+ * runtime config, `getCapabilities` reports its append/synthesized/plain-turn
+ * shape, and `createRuntime` builds a {@link ClaudeCodeRuntime} from the neutral
+ * create context plus the host-supplied options.
+ */
+export function createClaudeCodeAgentRuntimeProvider(options = {}) {
+    const sessionFactory = options.sessionFactory ?? createDefaultClaudeCodeSession;
+    const resolveBinPath = options.resolveBinPath ?? ((bin) => bin);
+    return {
+        ref: BUILTIN_CLAUDE_CODE_PROVIDER_REF,
+        descriptor: options.descriptor === undefined
+            ? DEFAULT_CLAUDE_CODE_DESCRIPTOR
+            : asAgentRuntimeDescriptor(options.descriptor),
+        getCapabilities: () => CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES,
+        diagnostic: claudeCodeAgentRuntimeDiagnostic,
+        readConfig(rawConfig, context) {
+            return readDispatcherClaudeCodeConfig(rawConfig, context.file, context.prefix);
+        },
+        createRuntime(context) {
+            if (context.state === undefined) {
+                throw new Error('claude-code runtime requires a state sink in the create context');
+            }
+            if (context.paths === undefined) {
+                throw new Error('claude-code runtime requires a path context in the create context');
+            }
+            const deps = {
+                config: context.config,
+                cwd: context.cwd,
+                state: context.state,
+                paths: context.paths,
+                mcpServers: context.mcpServers,
+                sessionFactory,
+                resolveBinPath,
+                ...(context.injectEnv !== undefined
+                    ? { injectEnv: context.injectEnv }
+                    : {}),
+                ...(context.skillSources !== undefined
+                    ? { skillSources: context.skillSources }
+                    : {}),
+                ...(context.systemPromptContent !== undefined
+                    ? { systemPromptContent: context.systemPromptContent }
+                    : {}),
+                ...(context.onTurnSettled !== undefined
+                    ? { onTurnSettled: context.onTurnSettled }
+                    : {}),
+                ...(context.logger !== undefined ? { logger: context.logger } : {}),
+            };
+            return new ClaudeCodeRuntime(context.identity, deps);
+        },
+    };
+}
+/** Re-export the typed accessor for a runtime's resolved claude-code config. */
+export { dispatcherClaudeCodeConfig };
+/**
+ * Default export — the factory Dreamux core's generic provider-loader selects
+ * for the `builtin:claude-code` ref (it imports this package and calls the
+ * default export with `{ ref, descriptor }`). It returns a provider that runs on
+ * package defaults: the real resident-session factory, an identity bin resolver,
+ * and `process.env` base env.
+ *
+ * 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/claude-code/provider.ts`) to map that context onto the neutral one
+ * AND inject its host contracts (the package-bin `PATH`, the durable state sink,
+ * the per-dispatcher path context). This default export keeps the package a
+ * first-class, loadable `AgentRuntimeProvider` for the generic loader and for
+ * external embedders.
+ */
+const claudeCodeAgentRuntimeProviderFactory = (context) => createClaudeCodeAgentRuntimeProvider({ descriptor: context.descriptor });
+export default claudeCodeAgentRuntimeProviderFactory;
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Claude Code stream-json turn RPC.
+ *
+ * The supervisor owns the child process. This class owns one in-flight turn,
+ * stdout line demux, turn aggregation, and defensive control-request replies.
+ */
+import type { Writable } from 'node:stream';
+import type { TurnOutcome, TurnSubmitOptions } from './types.js';
+export interface ClaudeCodeStreamRpcOptions {
+    turnTimeoutMs: number;
+    log?: (level: 'info' | 'warn' | 'error', msg: string, err?: unknown) => void;
+    reapOnTimeout: () => void;
+    onRemoteControlUrl?: (url: string) => void;
+}
+export declare class ClaudeCodeStreamRpc {
+    private readonly stdin;
+    private readonly options;
+    private readonly lineBuf;
+    private pending;
+    private remoteControlRequestId;
+    constructor(stdin: Writable, options: ClaudeCodeStreamRpcOptions);
+    submitTurn(prompt: string, options?: TurnSubmitOptions): Promise<TurnOutcome>;
+    steerTurn(prompt: string, options?: TurnSubmitOptions): Promise<void>;
+    onStdoutChunk(chunk: string): void;
+    failPending(err: Error): void;
+    enableRemoteControl(): void;
+    /**
+     * Detach the in-flight turn: clear its deadline timer and null `pending`,
+     * returning it so the caller can resolve or reject it exactly once.
+     */
+    private settlePending;
+    /**
+     * (Re)arm the per-turn idle deadline. `turnTimeoutMs` is a *max-idle* window,
+     * not a total-turn cap: any inbound stream line for this turn pushes it out
+     * (see `onLine`). A genuinely wedged child (no stream activity for the whole
+     * window) is still reaped — preserving the #120 anti-hang intent — but a long
+     * but continuously-streaming turn never trips the deadline (#156).
+     */
+    private armIdleTimer;
+    private onLine;
+    private deferSteeredResult;
+    private onControlRequest;
+    private onControlResponse;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAY5C,OAAO,KAAK,EAAc,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAY7E,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7E,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,sBAAsB,CAAuB;gBAGlC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,0BAA0B;IAGhD,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAgCjB,SAAS,CACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAuBhB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAI7B,mBAAmB,IAAI,IAAI;IAM3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,MAAM;IAyCd,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,iBAAiB;CAyB1B"}