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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 excitedjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @excitedjs/agent-runtime-claude-code
+
+The built-in **Claude Code** Agent Runtime provider for
+[Dreamux](https://github.com/excitedjs/dreamux), published behind the stable
+`builtin:claude-code` alias.
+
+It implements the public `AgentRuntimeProvider` contract from
+[`@excitedjs/dreamux-types`](../../dreamux-types) against a resident `claude`
+stream-json child: process supervision, the stream-json wire protocol (line
+framing, turn aggregation, control-request replies), per-turn idle-deadline
+handling, MCP config translation (`--mcp-config`), teammate completion delivery
+as a plain user turn, and Claude Code doctor diagnostics.
+
+## Boundary
+
+This package depends on `@excitedjs/dreamux-types` **only**. It never imports
+`@excitedjs/dreamux` core. Everything host-specific — per-dispatcher paths, the
+durable state sink, the process `PATH` seeded from the host package bins — is
+supplied by the Dreamux host through the neutral `AgentRuntimeCreateContext` and
+the provider factory options. The package owns only Claude Code engine mechanics
+and its own runtime config parsing; it reconstructs no Dreamux host
+layout/path/log contracts. Generic OS/validation/turn helpers it needs are
+vendored under `src/internal/`.
+
+## Loading
+
+Dreamux core resolves `builtin:claude-code` to this package and constructs the
+provider through its own core-owned adapter, which maps core's host-shaped create
+context onto the neutral one and supplies the host contracts. The package also
+default-exports a generic provider-loader factory, so
+`loadExternalAgentRuntimeProviders({ refs: ['builtin:claude-code'] })` can load it
+through the same package-loader path as external `npm:` providers.

package/dist/args.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pure Claude Code CLI/MCP argument translation (issue #110 PR6).
+ *
+ * This is the concrete proof that the AgentRuntimeProvider abstraction is not
+ * "Codex renamed": the same Dreamux `AgentRuntimeMcpServer[]` descriptors that
+ * the Codex runtime turns into `-c mcp_servers.*` TOML CLI flags are here turned
+ * into Claude Code's native MCP config — a JSON document loaded via
+ * `claude --mcp-config <file>`. Two runtimes, one descriptor contract, two
+ * completely different process argument shapes.
+ *
+ * Pure functions only — no IO, no process spawning — so they are fully unit
+ * testable without a live `claude` binary.
+ */
+import type { AgentRuntimeSkillSource } from '@excitedjs/dreamux-types';
+import type { DispatcherClaudeCodeConfig } from './config.js';
+/**
+ * The skill-source `layout` Claude Code can translate into `--add-dir`: `path`
+ * is a directory that contains a `.claude/skills` tree (claude's native skill
+ * discovery location for added directories). Sources with any other layout —
+ * e.g. the bundled Dreamux `skill-dir` sources, which are flat skill folders
+ * with no `.claude/skills` parent — are NOT add-dir compatible and emit nothing,
+ * so today's bundled skills feed codex only (claude-code's existing behavior of
+ * injecting no bundled skills is preserved). The mapping is implemented for
+ * compatible / external sources. Kept as a plain string because
+ * `@excitedjs/dreamux-types` is declaration-only.
+ */
+export declare const CLAUDE_SKILLS_PARENT_LAYOUT = "claude-skills-parent";
+export interface ClaudeCodeResidentArgsInput {
+    config: DispatcherClaudeCodeConfig;
+    /** Path to the generated Claude Code MCP config document. */
+    mcpConfigPath: string;
+    /** Resume an existing Claude Code session, when one is known (spawn-time). */
+    resumeSessionId?: string | null;
+    /**
+     * Launcher-supplied dispatcher/role system-prompt content. Claude Code applies
+     * it as an APPEND (per its `systemPrompt` capability) via
+     * `--append-system-prompt`, layered on top of the engine's own system prompt.
+     * Omitted/empty for launches that supply none (e.g. teammates).
+     */
+    systemPromptContent?: string;
+    /**
+     * Role-gated bundled/external skill sources core selected (issue #209 slice
+     * 6). Claude Code translates the add-dir-compatible ones (see
+     * {@link CLAUDE_SKILLS_PARENT_LAYOUT}) into `--add-dir <path>` flags so claude
+     * discovers their `.claude/skills`. Omitted/empty for launches with none.
+     */
+    skillSources?: readonly AgentRuntimeSkillSource[];
+}
+/**
+ * The `--add-dir` flag pairs for the add-dir-compatible skill sources, deduped
+ * by path and preserving first-seen order. Pure: compatibility is decided from
+ * the source `layout`, never by touching the filesystem.
+ */
+export declare function claudeCodeSkillAddDirArgs(skillSources: readonly AgentRuntimeSkillSource[] | undefined): string[];
+/**
+ * Build the `claude` CLI args for the *resident* stream-json transport (issue
+ * #120). Unlike the retired one-shot `claude --print <prompt>`, this launches a
+ * long-lived process that keeps stdin/stdout open: `--input-format stream-json`
+ * consumes NDJSON `user` messages on stdin (one per turn) until EOF, and
+ * `--output-format stream-json --verbose` streams `init` / `assistant` /
+ * `result` envelopes on stdout. The prompt is therefore NOT a CLI argument —
+ * each turn is written to stdin as a `user` message line (see
+ * `claude-code/stream.ts`).
+ *
+ * It reads its MCP servers from the JSON config (`--mcp-config`), optionally
+ * resumes a prior session at spawn time (`--resume`, used both for operator
+ * resume and for re-spawn after an unexpected exit), and threads the operator's
+ * model / permission mode / extra args through.
+ */
+export declare function claudeCodeResidentArgs(input: ClaudeCodeResidentArgsInput): string[];
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,0BAA0B,CAAC;IACnC,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,GAC3D,MAAM,EAAE,CASV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,EAAE,CAoCnF"}

package/dist/args.js

@@ -0,0 +1,87 @@
+/**
+ * Pure Claude Code CLI/MCP argument translation (issue #110 PR6).
+ *
+ * This is the concrete proof that the AgentRuntimeProvider abstraction is not
+ * "Codex renamed": the same Dreamux `AgentRuntimeMcpServer[]` descriptors that
+ * the Codex runtime turns into `-c mcp_servers.*` TOML CLI flags are here turned
+ * into Claude Code's native MCP config — a JSON document loaded via
+ * `claude --mcp-config <file>`. Two runtimes, one descriptor contract, two
+ * completely different process argument shapes.
+ *
+ * Pure functions only — no IO, no process spawning — so they are fully unit
+ * testable without a live `claude` binary.
+ */
+/**
+ * The skill-source `layout` Claude Code can translate into `--add-dir`: `path`
+ * is a directory that contains a `.claude/skills` tree (claude's native skill
+ * discovery location for added directories). Sources with any other layout —
+ * e.g. the bundled Dreamux `skill-dir` sources, which are flat skill folders
+ * with no `.claude/skills` parent — are NOT add-dir compatible and emit nothing,
+ * so today's bundled skills feed codex only (claude-code's existing behavior of
+ * injecting no bundled skills is preserved). The mapping is implemented for
+ * compatible / external sources. Kept as a plain string because
+ * `@excitedjs/dreamux-types` is declaration-only.
+ */
+export const CLAUDE_SKILLS_PARENT_LAYOUT = 'claude-skills-parent';
+/**
+ * The `--add-dir` flag pairs for the add-dir-compatible skill sources, deduped
+ * by path and preserving first-seen order. Pure: compatibility is decided from
+ * the source `layout`, never by touching the filesystem.
+ */
+export function claudeCodeSkillAddDirArgs(skillSources) {
+    const paths = [
+        ...new Set((skillSources ?? [])
+            .filter((s) => s.layout === CLAUDE_SKILLS_PARENT_LAYOUT)
+            .map((s) => s.path)),
+    ];
+    return paths.flatMap((path) => ['--add-dir', path]);
+}
+/**
+ * Build the `claude` CLI args for the *resident* stream-json transport (issue
+ * #120). Unlike the retired one-shot `claude --print <prompt>`, this launches a
+ * long-lived process that keeps stdin/stdout open: `--input-format stream-json`
+ * consumes NDJSON `user` messages on stdin (one per turn) until EOF, and
+ * `--output-format stream-json --verbose` streams `init` / `assistant` /
+ * `result` envelopes on stdout. The prompt is therefore NOT a CLI argument —
+ * each turn is written to stdin as a `user` message line (see
+ * `claude-code/stream.ts`).
+ *
+ * It reads its MCP servers from the JSON config (`--mcp-config`), optionally
+ * resumes a prior session at spawn time (`--resume`, used both for operator
+ * resume and for re-spawn after an unexpected exit), and threads the operator's
+ * model / permission mode / extra args through.
+ */
+export function claudeCodeResidentArgs(input) {
+    const args = [
+        '--print',
+        '--input-format',
+        'stream-json',
+        '--output-format',
+        'stream-json',
+        '--verbose',
+        '--mcp-config',
+        input.mcpConfigPath,
+    ];
+    // Role-gated skills: add each compatible source dir so claude discovers its
+    // `.claude/skills`. Present on every (re)spawn — start and resume both rebuild
+    // these args — so skills survive a crash-respawn (issue #209 slice 6).
+    args.push(...claudeCodeSkillAddDirArgs(input.skillSources));
+    if (input.config.permission_mode !== null) {
+        args.push('--permission-mode', input.config.permission_mode);
+    }
+    if (input.config.model !== null) {
+        args.push('--model', input.config.model);
+    }
+    if (input.systemPromptContent !== undefined &&
+        input.systemPromptContent !== '') {
+        args.push('--append-system-prompt', input.systemPromptContent);
+    }
+    if (input.resumeSessionId !== undefined &&
+        input.resumeSessionId !== null &&
+        input.resumeSessionId !== '') {
+        args.push('--resume', input.resumeSessionId);
+    }
+    args.push(...input.config.extra_args);
+    return args;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAwBlE;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAA4D;IAE5D,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,GAAG,CACR,CAAC,YAAY,IAAI,EAAE,CAAC;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,2BAA2B,CAAC;aACvD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB;KACF,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAkC;IACvE,MAAM,IAAI,GAAG;QACX,SAAS;QACT,gBAAgB;QAChB,aAAa;QACb,iBAAiB;QACjB,aAAa;QACb,WAAW;QACX,cAAc;QACd,KAAK,CAAC,aAAa;KACpB,CAAC;IACF,4EAA4E;IAC5E,+EAA+E;IAC/E,uEAAuE;IACvE,IAAI,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,IACE,KAAK,CAAC,mBAAmB,KAAK,SAAS;QACvC,KAAK,CAAC,mBAAmB,KAAK,EAAE,EAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACjE,CAAC;IACD,IACE,KAAK,CAAC,eAAe,KAAK,SAAS;QACnC,KAAK,CAAC,eAAe,KAAK,IAAI;QAC9B,KAAK,CAAC,eAAe,KAAK,EAAE,EAC5B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Builtin `builtin:claude-code` runtime config: schema type, defaults, reader,
+ * and the typed accessor.
+ *
+ * Owned by the `@excitedjs/agent-runtime-claude-code` package (issue #209). It
+ * depends only on the shared neutral validation primitives
+ * (`@excitedjs/dreamux-utils`) and the package's own provider ref
+ * (`./provider-ref`); it never imports `@excitedjs/dreamux` core. Core re-exports
+ * these symbols through its `config/config.ts` (via the package's light
+ * `./config` subpath) so the non-builtin callers (doctor, tests) keep their
+ * import paths, and the cold-start config path never pulls in the runtime engine.
+ */
+/**
+ * Builtin Claude Code runtime settings under a named `agents[].config` entry
+ * whose `provider` is `builtin:claude-code` (issue #110 PR6), referenced by a
+ * dispatcher via `dispatchers[].agentRuntime`.
+ *
+ * Deliberately distinct from `DispatcherCodexConfig`: Claude Code runs as a
+ * resident headless stream-json process (`claude --print --input-format
+ * stream-json …`, issue #120) with no `initialize` handshake, so there is no
+ * handshake timeout, approval policy, or sandbox mode here. `bin` is the Claude
+ * Code binary; `model` / `permission_mode` map to `--model` / `--permission-mode`;
+ * `remote_control` enables Claude Code Remote Control at resident-session
+ * startup; `extra_args` / `extra_env` are passed through. `model` and
+ * `permission_mode` are `null` when the operator does not pin them (Claude
+ * Code's own defaults apply). `turn_timeout_ms` is a per-turn *idle /
+ * inactivity* window (issue #120 anti-hang, made idle-based in issue #156): it
+ * is reset on every inbound stream line, so it bounds the max time the
+ * still-alive child may emit *no* stream activity — not the total turn duration.
+ * A child silent for the whole window is failed and reaped/re-spawned (rather
+ * than wedging the serial turn queue and, behind it, TeamMate completion
+ * delivery), while a long but actively-streaming turn never trips it.
+ */
+export interface DispatcherClaudeCodeConfig {
+    bin: string;
+    model: string | null;
+    permission_mode: string | null;
+    remote_control: boolean;
+    extra_args: string[];
+    extra_env: Record<string, string>;
+    turn_timeout_ms: number;
+}
+/** Default `dispatchers[].runtime.config.bin` for `builtin:claude-code`. */
+export declare const DEFAULT_CLAUDE_CODE_BIN = "claude";
+/**
+ * Default per-turn *idle* window for the resident `builtin:claude-code` child
+ * (ms). This is the max time the child may emit no stream activity before the
+ * turn is failed and the child reaped (issue #120 anti-hang, idle-based since
+ * issue #156) — it is reset on every stream line, so it does not cap a long but
+ * actively-streaming turn. Operators can override via
+ * `dispatchers[].runtime.config.turn_timeout_ms`.
+ */
+export declare const DEFAULT_CLAUDE_CODE_TURN_TIMEOUT_MS = 600000;
+/** Permission modes accepted for `builtin:claude-code` (Claude Code `--permission-mode`). */
+export declare const ALLOWED_CLAUDE_CODE_PERMISSION_MODES: Set<string>;
+export declare function defaultDispatcherClaudeCodeConfig(): DispatcherClaudeCodeConfig;
+export declare function readDispatcherClaudeCodeConfig(rawClaude: Record<string, unknown>, file: string, prefix: string): DispatcherClaudeCodeConfig;
+/**
+ * Typed accessor for a dispatcher's resolved claude-code runtime config. Typed
+ * structurally (not against `DispatcherConfig`) so this module never imports
+ * the host config type — a full `DispatcherConfig` still satisfies it at the
+ * call sites.
+ */
+export declare function dispatcherClaudeCodeConfig(dispatcher: {
+    id: string;
+    runtime: {
+        provider: string;
+        config: unknown;
+    };
+}): DispatcherClaudeCodeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAE3D,6FAA6F;AAC7F,eAAO,MAAM,oCAAoC,aAK/C,CAAC;AAEH,wBAAgB,iCAAiC,IAAI,0BAA0B,CAU9E;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,0BAA0B,CAgE5B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD,GAAG,0BAA0B,CAO7B"}

package/dist/config.js

@@ -0,0 +1,86 @@
+/**
+ * Builtin `builtin:claude-code` runtime config: schema type, defaults, reader,
+ * and the typed accessor.
+ *
+ * Owned by the `@excitedjs/agent-runtime-claude-code` package (issue #209). It
+ * depends only on the shared neutral validation primitives
+ * (`@excitedjs/dreamux-utils`) and the package's own provider ref
+ * (`./provider-ref`); it never imports `@excitedjs/dreamux` core. Core re-exports
+ * these symbols through its `config/config.ts` (via the package's light
+ * `./config` subpath) so the non-builtin callers (doctor, tests) keep their
+ * import paths, and the cold-start config path never pulls in the runtime engine.
+ */
+import { BUILTIN_CLAUDE_CODE_PROVIDER_REF } from './provider-ref.js';
+import { readOptionalBoolean, readOptionalString, rejectUnknownKeys, requirePositiveInt, requireStringArray, requireStringRecord, } from '@excitedjs/dreamux-utils';
+/** Default `dispatchers[].runtime.config.bin` for `builtin:claude-code`. */
+export const DEFAULT_CLAUDE_CODE_BIN = 'claude';
+/**
+ * Default per-turn *idle* window for the resident `builtin:claude-code` child
+ * (ms). This is the max time the child may emit no stream activity before the
+ * turn is failed and the child reaped (issue #120 anti-hang, idle-based since
+ * issue #156) — it is reset on every stream line, so it does not cap a long but
+ * actively-streaming turn. Operators can override via
+ * `dispatchers[].runtime.config.turn_timeout_ms`.
+ */
+export const DEFAULT_CLAUDE_CODE_TURN_TIMEOUT_MS = 600_000;
+/** Permission modes accepted for `builtin:claude-code` (Claude Code `--permission-mode`). */
+export const ALLOWED_CLAUDE_CODE_PERMISSION_MODES = new Set([
+    'default',
+    'acceptEdits',
+    'plan',
+    'bypassPermissions',
+]);
+export function defaultDispatcherClaudeCodeConfig() {
+    return {
+        bin: DEFAULT_CLAUDE_CODE_BIN,
+        model: null,
+        permission_mode: null,
+        remote_control: false,
+        extra_args: [],
+        extra_env: {},
+        turn_timeout_ms: DEFAULT_CLAUDE_CODE_TURN_TIMEOUT_MS,
+    };
+}
+export function readDispatcherClaudeCodeConfig(rawClaude, file, prefix) {
+    rejectUnknownKeys(rawClaude, new Set([
+        'bin',
+        'model',
+        'permission_mode',
+        'remote_control',
+        'extra_args',
+        'extra_env',
+        'turn_timeout_ms',
+    ]), file, prefix);
+    const defaults = defaultDispatcherClaudeCodeConfig();
+    const bin = readOptionalString(rawClaude, 'bin', file, prefix) ?? defaults.bin;
+    if (bin.trim() === '') {
+        throw new Error(`dreamux config error in ${file}: ${prefix}bin must be a non-empty string`);
+    }
+    const permissionMode = readOptionalString(rawClaude, 'permission_mode', file, prefix);
+    if (permissionMode !== null &&
+        !ALLOWED_CLAUDE_CODE_PERMISSION_MODES.has(permissionMode)) {
+        throw new Error(`dreamux config error in ${file}: ${prefix}permission_mode='${permissionMode}' is not one of ${Array.from(ALLOWED_CLAUDE_CODE_PERMISSION_MODES).join(' | ')}`);
+    }
+    return {
+        bin,
+        model: readOptionalString(rawClaude, 'model', file, prefix),
+        permission_mode: permissionMode,
+        remote_control: readOptionalBoolean(rawClaude, 'remote_control', defaults.remote_control, file, prefix),
+        extra_args: requireStringArray(rawClaude, 'extra_args', defaults.extra_args, file, prefix),
+        extra_env: requireStringRecord(rawClaude, 'extra_env', defaults.extra_env, file, prefix),
+        turn_timeout_ms: requirePositiveInt(rawClaude, 'turn_timeout_ms', defaults.turn_timeout_ms, file, prefix),
+    };
+}
+/**
+ * Typed accessor for a dispatcher's resolved claude-code runtime config. Typed
+ * structurally (not against `DispatcherConfig`) so this module never imports
+ * the host config type — a full `DispatcherConfig` still satisfies it at the
+ * call sites.
+ */
+export function dispatcherClaudeCodeConfig(dispatcher) {
+    if (dispatcher.runtime.provider !== BUILTIN_CLAUDE_CODE_PROVIDER_REF) {
+        throw new Error(`dispatcher '${dispatcher.id}' runtime provider ${JSON.stringify(dispatcher.runtime.provider)} is not wired to Claude Code`);
+    }
+    return dispatcher.runtime.config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/diagnostic.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `builtin:claude-code` self-reported doctor surface (issue #146 fold;
+ * relocated into the owning package by the issue #209 cleanup).
+ *
+ * Claude Code has no host-managed home/auth/version state Dreamux owns, so it
+ * only declares its bin check; the internal diagnostic is a neutral pass. Runs
+ * entirely against the neutral `@excitedjs/dreamux-types` diagnostic context.
+ */
+import type { AgentRuntimeDiagnostic } from '@excitedjs/dreamux-types';
+import { type DispatcherClaudeCodeConfig } from './config.js';
+export declare const claudeCodeAgentRuntimeDiagnostic: AgentRuntimeDiagnostic<DispatcherClaudeCodeConfig>;
+//# 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;;;;;;;GAOG;AACH,OAAO,KAAK,EAEV,sBAAsB,EAGvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,aAAa,CAAC;AAWrB,eAAO,MAAM,gCAAgC,EAAE,sBAAsB,CAAC,0BAA0B,CAkB7F,CAAC"}

package/dist/diagnostic.js

@@ -0,0 +1,25 @@
+import { DEFAULT_CLAUDE_CODE_BIN, } from './config.js';
+function claudeBinCheckName(scope) {
+    return scope === 'managedService'
+        ? 'managed service Claude Code binary'
+        : 'claude-code binary';
+}
+export const claudeCodeAgentRuntimeDiagnostic = {
+    binChecks(context) {
+        return [
+            {
+                name: claudeBinCheckName(context.scope),
+                bin: context.config.bin || DEFAULT_CLAUDE_CODE_BIN,
+                args: ['--help'],
+            },
+        ];
+    },
+    async runDiagnostic() {
+        return {
+            ok: true,
+            detail: 'Claude Code runtime has no host-managed home state',
+            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":"AAeA,OAAO,EAEL,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAKrB,SAAS,kBAAkB,CAAC,KAAuC;IACjE,OAAO,KAAK,KAAK,gBAAgB;QAC/B,CAAC,CAAC,oCAAoC;QACtC,CAAC,CAAC,oBAAoB,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAC3C;IACE,SAAS,CAAC,OAAO;QACf,OAAO;YACL;gBACE,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC;gBACvC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,uBAAuB;gBAClD,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,aAAa;QACjB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,oDAAoD;YAC5D,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@excitedjs/agent-runtime-claude-code` — the built-in Claude Code Agent
+ * Runtime provider for Dreamux (alias `builtin:claude-code`). Implements the
+ * `@excitedjs/dreamux-types` `AgentRuntimeProvider` contract; never imports
+ * `@excitedjs/dreamux` core.
+ */
+export { default, createClaudeCodeAgentRuntimeProvider, dispatcherClaudeCodeConfig, CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES, type ClaudeCodeAgentRuntimeProviderOptions, type ClaudeCodeProviderFactoryContext, } from './provider.js';
+export { ClaudeCodeRuntime, type ClaudeCodeRuntimeDeps, } from './runtime.js';
+export { createDefaultClaudeCodeSession, type ClaudeCodeSession, type ClaudeCodeSessionFactory, type ClaudeCodeSessionSpec, type TurnOutcome, type TurnSubmitOptions, } from './supervisor.js';
+export { ClaudeCodeStreamRpc, type ClaudeCodeStreamRpcOptions, } from './rpc.js';
+export { LineBuffer, TurnAggregator, assistantText, parseLine, buildUserMessage, buildRemoteControlEnable, buildCanUseToolAllow, buildControlAck, } from './stream.js';
+export type { JsonObject, ParsedLine, ResultEnvelope, } from './types.js';
+export { claudeCodeMcpConfig, stringifyClaudeCodeMcpConfig, type ClaudeCodeMcpConfig, } from './mcp-config.js';
+export { claudeCodeResidentArgs, claudeCodeSkillAddDirArgs, CLAUDE_SKILLS_PARENT_LAYOUT, type ClaudeCodeResidentArgsInput, } from './args.js';
+export { type DispatcherClaudeCodeConfig, readDispatcherClaudeCodeConfig, defaultDispatcherClaudeCodeConfig, DEFAULT_CLAUDE_CODE_BIN, DEFAULT_CLAUDE_CODE_TURN_TIMEOUT_MS, ALLOWED_CLAUDE_CODE_PERMISSION_MODES, } from './config.js';
+export { BUILTIN_CLAUDE_CODE_PROVIDER_REF } from './provider-ref.js';
+export { claudeCodeAgentRuntimeDiagnostic } from './diagnostic.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,oCAAoC,EACpC,0BAA0B,EAC1B,sCAAsC,EACtC,KAAK,qCAAqC,EAC1C,KAAK,gCAAgC,GACtC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,0BAA0B,EAC/B,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * `@excitedjs/agent-runtime-claude-code` — the built-in Claude Code Agent
+ * Runtime provider for Dreamux (alias `builtin:claude-code`). Implements the
+ * `@excitedjs/dreamux-types` `AgentRuntimeProvider` contract; never imports
+ * `@excitedjs/dreamux` core.
+ */
+export { default, createClaudeCodeAgentRuntimeProvider, dispatcherClaudeCodeConfig, CLAUDE_CODE_AGENT_RUNTIME_CAPABILITIES, } from './provider.js';
+export { ClaudeCodeRuntime, } from './runtime.js';
+export { createDefaultClaudeCodeSession, } from './supervisor.js';
+export { ClaudeCodeStreamRpc, } from './rpc.js';
+export { LineBuffer, TurnAggregator, assistantText, parseLine, buildUserMessage, buildRemoteControlEnable, buildCanUseToolAllow, buildControlAck, } from './stream.js';
+export { claudeCodeMcpConfig, stringifyClaudeCodeMcpConfig, } from './mcp-config.js';
+export { claudeCodeResidentArgs, claudeCodeSkillAddDirArgs, CLAUDE_SKILLS_PARENT_LAYOUT, } from './args.js';
+export { readDispatcherClaudeCodeConfig, defaultDispatcherClaudeCodeConfig, DEFAULT_CLAUDE_CODE_BIN, DEFAULT_CLAUDE_CODE_TURN_TIMEOUT_MS, ALLOWED_CLAUDE_CODE_PERMISSION_MODES, } from './config.js';
+export { BUILTIN_CLAUDE_CODE_PROVIDER_REF } from './provider-ref.js';
+// The claude-code doctor surface now lives in this package (issue #209 cleanup).
+export { claudeCodeAgentRuntimeDiagnostic } from './diagnostic.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,oCAAoC,EACpC,0BAA0B,EAC1B,sCAAsC,GAGvC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,GAElB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,8BAA8B,GAM/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AAQrB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAE7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAE5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AAErE,iFAAiF;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/internal/completion-body.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Neutral completion-body resolution for the Claude Code runtime.
+ *
+ * A teammate completion is delivered back to the dispatcher as turn text. When
+ * the result is short it is inlined verbatim; when it overflows the inline
+ * budget the full result is spilled to an owner-only 0600 file under the
+ * host-supplied spill directory and only the path is inlined, so a large result
+ * never floods the dispatcher's context window.
+ *
+ * Vendored from the host's neutral `agent-runtime/completion-body.ts` so this
+ * package never imports `@excitedjs/dreamux` core. The spill directory is
+ * supplied by the host through the create context's path context, so this
+ * module owns no Dreamux layout contract — only the safe filename shape inside
+ * that directory.
+ */
+import type { CompletionEnvelope } from '@excitedjs/dreamux-types';
+export declare const COMPLETION_INLINE_BUDGET_DEFAULT = 32000;
+export declare const COMPLETION_INLINE_BUDGET_MAX = 160000;
+export type ResolvedCompletionBody = {
+    kind: 'inline';
+    text: string;
+} | {
+    kind: 'spilled';
+    path: string;
+};
+/**
+ * Resolve the effective inline budget from the environment: unset/blank or
+ * non-positive falls back to the default; values above the upper bound are
+ * clamped; a non-integer value falls back to the default.
+ */
+export declare function completionInlineBudget(env?: NodeJS.ProcessEnv): number;
+/**
+ * Decide whether a completion result is inlined or spilled. Spilling writes the
+ * FULL result to a 0600 file (async fs only) under the host-supplied
+ * `spillDir`, then returns the path; the caller inlines only that path.
+ */
+export declare function resolveCompletionBody(completion: CompletionEnvelope, spillDir: string): Promise<ResolvedCompletionBody>;
+//# sourceMappingURL=completion-body.d.ts.map

package/dist/internal/completion-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-body.d.ts","sourceRoot":"","sources":["../../src/internal/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAGpD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAgBtC;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAmC,GAC9C,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAUjC"}

package/dist/internal/completion-body.js

@@ -0,0 +1,62 @@
+/**
+ * Neutral completion-body resolution for the Claude Code runtime.
+ *
+ * A teammate completion is delivered back to the dispatcher as turn text. When
+ * the result is short it is inlined verbatim; when it overflows the inline
+ * budget the full result is spilled to an owner-only 0600 file under the
+ * host-supplied spill directory and only the path is inlined, so a large result
+ * never floods the dispatcher's context window.
+ *
+ * Vendored from the host's neutral `agent-runtime/completion-body.ts` so this
+ * package never imports `@excitedjs/dreamux` core. The spill directory is
+ * supplied by the host through the create context's path context, so this
+ * module owns no Dreamux layout contract — only the safe filename shape inside
+ * that directory.
+ */
+import { chmod, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ensureOwnerOnlyDir } from './os.js';
+export const COMPLETION_INLINE_BUDGET_DEFAULT = 32_000;
+export const COMPLETION_INLINE_BUDGET_MAX = 160_000;
+const COMPLETION_INLINE_BUDGET_ENV = 'TASK_MAX_OUTPUT_LENGTH';
+/** Sanitize a name into a safe single path segment. */
+function safeSegment(name) {
+    return name.replace(/[^A-Za-z0-9._-]/g, '_');
+}
+/** Spill file for an overflowing completion result, inside `spillDir`. */
+function completionOutputPath(spillDir, source, id) {
+    return join(spillDir, `teammate-${safeSegment(source)}-${safeSegment(id)}.output`);
+}
+/**
+ * Resolve the effective inline budget from the environment: unset/blank or
+ * non-positive falls back to the default; values above the upper bound are
+ * clamped; a non-integer value falls back to the default.
+ */
+export function completionInlineBudget(env = globalThis.process.env) {
+    const raw = env[COMPLETION_INLINE_BUDGET_ENV]?.trim();
+    if (raw === undefined || raw === '' || !/^\d+$/.test(raw)) {
+        return COMPLETION_INLINE_BUDGET_DEFAULT;
+    }
+    const parsed = Number(raw);
+    if (parsed <= 0) {
+        return COMPLETION_INLINE_BUDGET_DEFAULT;
+    }
+    return Math.min(parsed, COMPLETION_INLINE_BUDGET_MAX);
+}
+/**
+ * Decide whether a completion result is inlined or spilled. Spilling writes the
+ * FULL result to a 0600 file (async fs only) under the host-supplied
+ * `spillDir`, then returns the path; the caller inlines only that path.
+ */
+export async function resolveCompletionBody(completion, spillDir) {
+    const budget = completionInlineBudget();
+    if (completion.result.length <= budget) {
+        return { kind: 'inline', text: completion.result };
+    }
+    const path = completionOutputPath(spillDir, completion.source, completion.id);
+    await ensureOwnerOnlyDir(spillDir);
+    await writeFile(path, completion.result, { mode: 0o600 });
+    await chmod(path, 0o600);
+    return { kind: 'spilled', path };
+}
+//# sourceMappingURL=completion-body.js.map

package/dist/internal/completion-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-body.js","sourceRoot":"","sources":["../../src/internal/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AACpD,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAM9D,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,0EAA0E;AAC1E,SAAS,oBAAoB,CAC3B,QAAgB,EAChB,MAAc,EACd,EAAU;IAEV,OAAO,IAAI,CAAC,QAAQ,EAAE,YAAY,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB,UAAU,CAAC,OAAO,CAAC,GAAG;IAE/C,MAAM,GAAG,GAAG,GAAG,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAA8B,EAC9B,QAAgB;IAEhB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/internal/config-validate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 declare function isPlainObject(v: unknown): v is Record<string, unknown>;
+export declare function describeType(v: unknown): string;
+export declare function rejectUnknownKeys(obj: Record<string, unknown>, allowed: Set<string>, file: string, prefix: string): void;
+export declare function requireNonEmptyString(obj: Record<string, unknown>, key: string, file: string, prefix?: string): string;
+export declare function readOptionalString(obj: Record<string, unknown>, key: string, file: string, prefix?: string): string | null;
+export declare function readOptionalBoolean(obj: Record<string, unknown>, key: string, fallback: boolean, file: string, prefix?: string): boolean;
+export declare function requireStringArray(obj: Record<string, unknown>, key: string, fallback: string[], file: string, prefix?: string): string[];
+export declare function requireStringRecord(obj: Record<string, unknown>, key: string, fallback: Record<string, string>, file: string, prefix?: string): Record<string, string>;
+export declare function requirePositiveInt(obj: Record<string, unknown>, key: string, fallback: number, file: string, prefix?: string): number;
+export declare function readProviderConfigObject(rawConfig: unknown, file: string, name: string, options?: {
+    allowMissing?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=config-validate.d.ts.map

package/dist/internal/config-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validate.d.ts","sourceRoot":"","sources":["../../src/internal/config-validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAI/C;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAgBN;AAuBD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,MAAM,GAAG,IAAI,CAIf;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,OAAO,CAOT;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,MAAM,EAAE,CAgBV;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAgBD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,MAAM,CASR;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}