unity-open-mcp 0.1.0

package/dist/capabilities/tool-groups.js

@@ -0,0 +1,396 @@
+// M18 Plan 2 / T18.2 — canonical tool-group catalog.
+//
+// Single source of truth for the Coplay-style tool-group visibility system.
+// Drives two surfaces:
+//
+//  - `unity_open_mcp_manage_tools` meta-tool (session activation state).
+//  - `unity_open_mcp_capabilities` `toolGroups` block (compiled-state only).
+//
+// Every registered MCP tool maps to a group id via `groupFor(toolName)`.
+// Tools with no entry map to `null` and are always visible — they are server
+// meta-tools (capabilities, ping, manage_tools itself, etc.).
+//
+// Groups are stable lowercase identifiers. The DEFAULT_ENABLED set is
+// `{ "core" }` only — every other group is hidden from ListTools until the
+// connected MCP session activates it via manage_tools. This matches Coplay's
+// model (see references/unity-mcp-beta-codev/Server/src/services/registry/
+// tool_registry.py: DEFAULT_ENABLED_GROUPS = {"core"}).
+//
+// Domain groups (navigation, input, probuilder, particle-system, animation)
+// carry a `domainDefine` so capabilities can report compiled-state
+// availability — `available: true` when the bridge compiled the domain in
+// (the matching `UNITY_OPEN_MCP_EXT_<DOMAIN>` symbol was defined), `false`
+// when the Unity domain package is absent. Availability is compiled-state
+// only; it does not change per session.
+/**
+ * Ordered catalog. Order is preserved in manage_tools / capabilities output
+ * so consumers render a stable list.
+ */
+export const TOOL_GROUPS = [
+    {
+        id: "core",
+        description: "Essential editor entry points: ping, execute_csharp, invoke_method, " +
+            "find_members, execute_menu, editor_status, compile_check. Always on.",
+        defaultEnabled: true,
+    },
+    {
+        id: "gate-and-verify",
+        description: "Gate, checkpoint, delta, find_references, scan_paths, apply_fix, " +
+            "scan_all, baseline_create, regression_check — the verify surface.",
+        defaultEnabled: true,
+    },
+    {
+        id: "asset-intelligence",
+        description: "reserialize, read_asset, search_assets, list_assets — offline asset " +
+            "reads and reference intelligence.",
+        defaultEnabled: true,
+    },
+    {
+        id: "typed-editor",
+        description: "Typed editor surface (M16 Plans 1–6, 9): assets, materials, shaders, " +
+            "prefabs, GameObjects, components, scenes, packages, console, editor " +
+            "state, selection, undo, tags, layers, reflection, scripts, object " +
+            "data, build pipeline, project settings.",
+        defaultEnabled: true,
+    },
+    {
+        id: "diagnostics",
+        description: "Profiler session control, counters, memory snapshots, and the M10 " +
+            "per-frame capture / memory / rendering reads.",
+        defaultEnabled: true,
+    },
+    {
+        id: "gate-intelligence",
+        description: "Pre/post-mutation intelligence: impact_preview, gate_budget_estimate, " +
+            "mutation_explain (read-only compositions of the gate foundations).",
+        defaultEnabled: false,
+    },
+    {
+        id: "build-settings",
+        description: "Build pipeline + ProjectSettings reads and mutators (build_set_target, " +
+            "build_start, settings_set_player, …).",
+        defaultEnabled: false,
+    },
+    {
+        id: "navigation",
+        description: "NavMesh (AI Navigation) tools — surfaces, modifiers, links, agents. " +
+            "Compile-gated on the com.unity.ai.navigation package.",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_NAVIGATION",
+        unityPackage: "com.unity.ai.navigation",
+    },
+    {
+        id: "input-system",
+        description: "Input System tools — .inputactions asset authoring (action maps, " +
+            "actions, bindings, composites, control schemes). Compile-gated on " +
+            "com.unity.inputsystem.",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_INPUTSYSTEM",
+        unityPackage: "com.unity.inputsystem",
+    },
+    {
+        id: "probuilder",
+        description: "ProBuilder 3D modeling tools — shapes, mesh info, extrude, face " +
+            "delete, face material. Compile-gated on com.unity.probuilder.",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_PROBUILDER",
+        unityPackage: "com.unity.probuilder",
+    },
+    {
+        id: "particle-system",
+        description: "Particle System tools — per-module reads and field-patch mutator. " +
+            "Compile-gated on the built-in ParticleSystemModule.",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_PARTICLESYSTEM",
+        unityPackage: "UnityEngine.ParticleSystemModule",
+    },
+    {
+        id: "animation",
+        description: "AnimationClip + AnimatorController tools — create / read / modify " +
+            ".anim and .controller assets. Compile-gated on the built-in animation " +
+            "module.",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_ANIMATION",
+        unityPackage: "com.unity.modules.animation",
+    },
+    {
+        id: "splines",
+        description: "Splines tools — SplineContainer authoring, knots, tangent modes, " +
+            "evaluation. Compile-gated on the com.unity.splines package. First " +
+            "backlog domain under the embedded + grouped model (M18 Plan 7).",
+        defaultEnabled: false,
+        domainDefine: "UNITY_OPEN_MCP_EXT_SPLINES",
+        unityPackage: "com.unity.splines",
+    },
+    {
+        id: "agent-senses",
+        description: "Agent senses surface (run_tests, screenshot, read_console, profiler " +
+            "capture / memory / rendering, spatial_query). Live-only.",
+        defaultEnabled: false,
+    },
+];
+/**
+ * Set of group ids enabled by default for every fresh session.
+ * Per the resolved decision (M18 execution-plan.md), this is `core` only.
+ */
+export const DEFAULT_ENABLED_GROUPS = new Set(TOOL_GROUPS.filter((g) => g.defaultEnabled).map((g) => g.id));
+/** All known group ids (validates activate / deactivate input). */
+export const GROUP_IDS = new Set(TOOL_GROUPS.map((g) => g.id));
+const GROUP_BY_ID = new Map(TOOL_GROUPS.map((g) => [g.id, g]));
+export function getGroup(id) {
+    return GROUP_BY_ID.get(id);
+}
+// ---------------------------------------------------------------------------
+// Per-tool group assignment — the authoritative mapping from a registered MCP
+// tool name to its group id. Tools not listed here default to `null` (always
+// visible). Mirrors the capability categories in build-capabilities.ts; the
+// group vocabulary is the curated, session-visibility-relevant subset.
+//
+// KEEP THIS TABLE ALIGNED with TOOL_CATEGORY in build-capabilities.ts when
+// adding tools. A tool that gets a non-`core` category in capabilities should
+// map to the matching group id here, and vice versa.
+// ---------------------------------------------------------------------------
+const TOOL_GROUP_ASSIGNMENT = {};
+function assign(group, names) {
+    for (const name of names)
+        TOOL_GROUP_ASSIGNMENT[name] = group;
+}
+// --- core -------------------------------------------------------------------
+assign("core", [
+    "unity_open_mcp_ping",
+    "unity_open_mcp_execute_csharp",
+    "unity_open_mcp_invoke_method",
+    "unity_open_mcp_execute_menu",
+    "unity_open_mcp_find_members",
+    "unity_open_mcp_editor_status",
+]);
+// --- gate-and-verify --------------------------------------------------------
+assign("gate-and-verify", [
+    "unity_open_mcp_compile_check",
+    "unity_open_mcp_validate_edit",
+    "unity_open_mcp_checkpoint_create",
+    "unity_open_mcp_delta",
+    "unity_open_mcp_find_references",
+    "unity_open_mcp_scan_paths",
+    "unity_open_mcp_apply_fix",
+    "unity_open_mcp_scan_all",
+    "unity_open_mcp_baseline_create",
+    "unity_open_mcp_regression_check",
+]);
+// --- asset-intelligence -----------------------------------------------------
+assign("asset-intelligence", [
+    "unity_open_mcp_reserialize",
+    "unity_open_mcp_read_asset",
+    "unity_open_mcp_search_assets",
+    "unity_open_mcp_list_assets",
+]);
+// --- typed-editor (M16 Plans 1–6, 9) ---------------------------------------
+assign("typed-editor", [
+    "assets_create_folder",
+    "assets_copy",
+    "assets_move",
+    "assets_delete",
+    "assets_refresh",
+    "material_create",
+    "material_get_properties",
+    "material_set_property",
+    "material_get_keywords",
+    "material_set_keyword",
+    "material_set_shader",
+    "shader_list_all",
+    "shader_get_data",
+    "prefab_instantiate",
+    "prefab_create",
+    "prefab_open",
+    "prefab_close",
+    "prefab_save",
+    "prefab_apply",
+    "prefab_revert",
+    "prefab_unpack",
+    "prefab_get_overrides",
+    "prefab_status",
+    "gameobject_create",
+    "gameobject_destroy",
+    "gameobject_duplicate",
+    "gameobject_find",
+    "gameobject_modify",
+    "gameobject_set_parent",
+    "component_add",
+    "component_destroy",
+    "component_get",
+    "component_modify",
+    "component_list_all",
+    "scene_create",
+    "scene_open",
+    "scene_save",
+    "scene_unload",
+    "scene_set_active",
+    "scene_list_opened",
+    "scene_get_data",
+    "scene_get_dirty_summary",
+    "scene_focus",
+    "package_list",
+    "package_search",
+    "package_add",
+    "package_remove",
+    "package_get_info",
+    "package_get_dependencies",
+    "package_check",
+    "console_clear",
+    "console_log",
+    "editor_set_state",
+    "selection_get",
+    "selection_set",
+    "editor_undo",
+    "editor_redo",
+    "editor_get_tags",
+    "editor_get_layers",
+    "editor_add_tag",
+    "editor_add_layer",
+    "type_schema",
+    "script_read",
+    "script_write",
+    "script_delete",
+    "object_get_data",
+    "object_modify",
+].map((suffix) => `unity_open_mcp_${suffix}`));
+// --- diagnostics (profiler + per-frame reads) ------------------------------
+assign("diagnostics", [
+    "unity_open_mcp_profiler_start",
+    "unity_open_mcp_profiler_stop",
+    "unity_open_mcp_profiler_get_status",
+    "unity_open_mcp_profiler_get_config",
+    "unity_open_mcp_profiler_set_config",
+    "unity_open_mcp_profiler_list_modules",
+    "unity_open_mcp_profiler_enable_module",
+    "unity_open_mcp_profiler_clear_data",
+    "unity_open_mcp_profiler_save_data",
+    "unity_open_mcp_profiler_load_data",
+    "unity_open_mcp_profiler_get_script_stats",
+]);
+// --- gate-intelligence ------------------------------------------------------
+assign("gate-intelligence", [
+    "unity_open_mcp_impact_preview",
+    "unity_open_mcp_gate_budget_estimate",
+    "unity_open_mcp_mutation_explain",
+]);
+// --- build-settings ---------------------------------------------------------
+assign("build-settings", [
+    "build_get_targets",
+    "build_get_active_target",
+    "build_set_target",
+    "build_get_scenes",
+    "build_set_scenes",
+    "build_start",
+    "build_get_defines",
+    "build_set_defines",
+    "settings_get_player",
+    "settings_set_player",
+    "settings_get_quality",
+    "settings_set_quality",
+    "settings_get_physics",
+    "settings_set_physics",
+    "settings_get_lighting",
+    "settings_set_lighting",
+].map((suffix) => `unity_open_mcp_${suffix}`));
+// --- navigation -------------------------------------------------------------
+assign("navigation", [
+    "surface_add",
+    "set_bake_settings",
+    "surface_bake",
+    "modifier_add",
+    "modifier_volume_add",
+    "link_add",
+    "agent_add",
+    "agent_set_destination",
+    "list",
+    "get",
+    "modify",
+].map((suffix) => `unity_open_mcp_navigation_${suffix}`));
+// --- input-system -----------------------------------------------------------
+assign("input-system", [
+    "asset_create",
+    "actionmap_add",
+    "action_add",
+    "binding_add",
+    "binding_composite_add",
+    "controlscheme_add",
+    "get",
+].map((suffix) => `unity_open_mcp_inputsystem_${suffix}`));
+// --- probuilder -------------------------------------------------------------
+assign("probuilder", [
+    "create_shape",
+    "get_mesh_info",
+    "extrude",
+    "delete_faces",
+    "set_face_material",
+].map((suffix) => `unity_open_mcp_probuilder_${suffix}`));
+// --- particle-system --------------------------------------------------------
+assign("particle-system", ["get", "modify"].map((suffix) => `unity_open_mcp_particle_system_${suffix}`));
+// --- animation --------------------------------------------------------------
+assign("animation", [
+    "animation_create",
+    "animation_get_data",
+    "animation_modify",
+    "animator_create",
+    "animator_get_data",
+    "animator_modify",
+]);
+// --- splines (M18 Plan 7 / T18.7.3 — first backlog domain) -----------------
+assign("splines", [
+    "container_create",
+    "add_knot",
+    "set_knot",
+    "set_tangent_mode",
+    "evaluate",
+    "get_knots",
+    "modify",
+].map((suffix) => `unity_open_mcp_splines_${suffix}`));
+// --- agent-senses (live-only reads) ----------------------------------------
+assign("agent-senses", [
+    "unity_senses_run_tests",
+    "unity_senses_screenshot",
+    // M20 Plan 1 / T20.1.1 — senses parity residual. Arbitrary-pose screenshot
+    // + inline-image capture extend the screenshot surface.
+    "unity_senses_screenshot_camera",
+    "unity_senses_capture_inline",
+    // M20 Plan 1 / T20.1.2 — EditorWindow capture.
+    "unity_senses_screenshot_window",
+    "unity_senses_read_console",
+    "unity_senses_profiler_capture",
+    "unity_senses_profiler_memory",
+    "unity_senses_profiler_rendering",
+    "unity_senses_spatial_query",
+]);
+// ---------------------------------------------------------------------------
+// Read API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a tool name to its group id. Returns `null` for tools with no
+ * assignment (server meta-tools: capabilities, list_rules, generate_skill,
+ * manage_tools, pull_events, read_compile_errors). Null means "always
+ * visible" — manage_tools and ListTools never hide a null-group tool.
+ */
+export function groupFor(toolName) {
+    return TOOL_GROUP_ASSIGNMENT[toolName] ?? null;
+}
+/**
+ * Inverse map: group id → sorted tool names. Used by manage_tools
+ * `list_groups` to enumerate every group with its tool roster. Tools with a
+ * null group are intentionally omitted (they are always-visible meta-tools).
+ */
+export function groupToTools() {
+    const out = {};
+    for (const group of TOOL_GROUPS) {
+        out[group.id] = [];
+    }
+    for (const [tool, group] of Object.entries(TOOL_GROUP_ASSIGNMENT)) {
+        if (!out[group])
+            out[group] = [];
+        out[group].push(tool);
+    }
+    for (const names of Object.values(out))
+        names.sort();
+    return out;
+}
+//# sourceMappingURL=tool-groups.js.map

package/dist/capabilities/tool-groups.js.map

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

package/dist/cli/args.d.ts

@@ -0,0 +1,36 @@
+export type CliCommand = "ping" | "wait-for-ready" | "status" | "run-tool" | "help" | "version";
+export declare const KNOWN_COMMANDS: readonly string[];
+export interface ParsedCli {
+    command: CliCommand | null;
+    /** Bare `--json` flag — switches human-readable output to JSON. */
+    json: boolean;
+    /** Resolved project path (flag wins, else UNITY_PROJECT_PATH env). */
+    projectPath: string | undefined;
+    /** Resolved bridge port override (flag wins, else UNITY_OPEN_MCP_BRIDGE_PORT env). */
+    port: number | undefined;
+    /** Ping / wait-for-ready overall timeout (ms). */
+    timeoutMs: number | undefined;
+    /** wait-for-ready poll interval (ms). */
+    intervalMs: number | undefined;
+    /** Tool name for run-tool. */
+    toolName: string | undefined;
+    /** Tool args for run-tool, merged from --args + --arg. */
+    toolArgs: Record<string, unknown>;
+    /** Parse error message; when set, the dispatcher prints it and exits non-zero. */
+    error: string | undefined;
+    /** Unknown / unparsed leftovers (currently an error condition). */
+    unknown: string[];
+}
+export declare function emptyParsed(): ParsedCli;
+/**
+ * Parse the CLI argv (everything after `node dist/index.js`). Returns a
+ * structured result; the dispatcher interprets `command`/`error`. Never throws
+ * — parse problems are reported through `error`.
+ */
+export declare function parseCliArgs(argv: string[]): ParsedCli;
+/**
+ * Coerce a `--arg key=value` value. If the raw value parses as JSON, use the
+ * parsed form (so `--arg timeout_ms=30000` yields a number and `--arg
+ * include_planned=true` yields a boolean); otherwise keep it as a string.
+ */
+export declare function coerceArgValue(rawValue: string): unknown;

package/dist/cli/args.js

@@ -0,0 +1,239 @@
+// M15 T6.1 — Thin CLI argument parsing.
+//
+// No runtime deps (mcp-server/AGENTS.md: only @modelcontextprotocol/sdk). The
+// parser is hand-rolled and intentionally small — it covers the four CLI
+// subcommands and their shared options. Anything more complex should go through
+// the MCP server proper.
+//
+// Command shapes:
+//   unity-open-mcp ping [--json] [--timeout-ms N]
+//   unity-open-mcp wait-for-ready [--json] [--timeout-ms N] [--interval-ms N]
+//   unity-open-mcp status [--json]
+//   unity-open-mcp run-tool <name> [--json] [--args '<json>'] [--arg k=v]...
+//   unity-open-mcp --help | -h
+//   unity-open-mcp --version | -V
+//
+// Shared options (where relevant):
+//   --project <path> | -P <path>   override UNITY_PROJECT_PATH
+//   --port <n>      | -p <n>       override UNITY_OPEN_MCP_BRIDGE_PORT
+//   --timeout-ms <n>               ping/wait timeout in milliseconds
+//   --interval-ms <n>              wait-for-ready poll interval
+//   --json                         emit JSON instead of human-readable output
+export const KNOWN_COMMANDS = [
+    "ping",
+    "wait-for-ready",
+    "status",
+    "run-tool",
+];
+export function emptyParsed() {
+    return {
+        command: null,
+        json: false,
+        projectPath: undefined,
+        port: undefined,
+        timeoutMs: undefined,
+        intervalMs: undefined,
+        toolName: undefined,
+        toolArgs: {},
+        error: undefined,
+        unknown: [],
+    };
+}
+/**
+ * Parse the CLI argv (everything after `node dist/index.js`). Returns a
+ * structured result; the dispatcher interprets `command`/`error`. Never throws
+ * — parse problems are reported through `error`.
+ */
+export function parseCliArgs(argv) {
+    const parsed = emptyParsed();
+    // Make a mutable copy; we walk it with an index so `--arg`/`--set` can
+    // consume their following token.
+    const args = argv.slice();
+    let i = 0;
+    // First non-flag token is the command (positional). For run-tool, a second
+    // positional is the tool name.
+    let positionalCount = 0;
+    while (i < args.length) {
+        const tok = args[i];
+        // --- flags that take no value ---
+        if (tok === "--json") {
+            parsed.json = true;
+            i++;
+            continue;
+        }
+        if (tok === "-h" || tok === "--help") {
+            parsed.command = "help";
+            return parsed;
+        }
+        if (tok === "-V" || tok === "--version") {
+            parsed.command = "version";
+            return parsed;
+        }
+        // --- flags that take a value ---
+        if (tok === "--project" || tok === "-P") {
+            const v = args[i + 1];
+            if (!v || v.startsWith("-")) {
+                parsed.error = `${tok} requires a project path.`;
+                return parsed;
+            }
+            parsed.projectPath = v;
+            i += 2;
+            continue;
+        }
+        if (tok === "--port" || tok === "-p") {
+            const v = args[i + 1];
+            const n = parsePositiveInt(v);
+            if (n === undefined) {
+                parsed.error = `${tok} requires a valid port number (1-65535).`;
+                return parsed;
+            }
+            parsed.port = n;
+            i += 2;
+            continue;
+        }
+        if (tok === "--timeout-ms") {
+            const v = args[i + 1];
+            const n = parsePositiveInt(v);
+            if (n === undefined) {
+                parsed.error = "--timeout-ms requires a positive integer (ms).";
+                return parsed;
+            }
+            parsed.timeoutMs = n;
+            i += 2;
+            continue;
+        }
+        if (tok === "--interval-ms") {
+            const v = args[i + 1];
+            const n = parsePositiveInt(v);
+            if (n === undefined) {
+                parsed.error = "--interval-ms requires a positive integer (ms).";
+                return parsed;
+            }
+            parsed.intervalMs = n;
+            i += 2;
+            continue;
+        }
+        // run-tool arg passing. Two shapes:
+        //   --args '<json blob>'   → merge parsed JSON object into toolArgs
+        //   --arg key=value        → set one key; value JSON-parsed if valid JSON,
+        //                             else kept as a string. Repeatable.
+        if (tok === "--args") {
+            const v = args[i + 1];
+            if (v === undefined) {
+                parsed.error = "--args requires a JSON object argument.";
+                return parsed;
+            }
+            const merged = mergeJsonArgs(parsed.toolArgs, v);
+            if (merged instanceof Error) {
+                parsed.error = merged.message;
+                return parsed;
+            }
+            parsed.toolArgs = merged;
+            i += 2;
+            continue;
+        }
+        if (tok === "--arg" || tok === "--set") {
+            const v = args[i + 1];
+            if (v === undefined || !v.includes("=")) {
+                parsed.error = `${tok} requires a key=value token.`;
+                return parsed;
+            }
+            const eq = v.indexOf("=");
+            const key = v.slice(0, eq);
+            const rawValue = v.slice(eq + 1);
+            if (key.length === 0) {
+                parsed.error = `${tok} has an empty key in '${v}'.`;
+                return parsed;
+            }
+            parsed.toolArgs[key] = coerceArgValue(rawValue);
+            i += 2;
+            continue;
+        }
+        // --- positionals ---
+        if (!tok.startsWith("-")) {
+            if (positionalCount === 0) {
+                if (!KNOWN_COMMANDS.includes(tok)) {
+                    parsed.error = `Unknown command '${tok}'. Known: ${KNOWN_COMMANDS.join(", ")}.`;
+                    return parsed;
+                }
+                // narrowed by the includes() check above
+                parsed.command = tok;
+            }
+            else if (positionalCount === 1) {
+                if (parsed.command !== "run-tool") {
+                    parsed.error = `Unexpected positional '${tok}' for command '${parsed.command}'.`;
+                    return parsed;
+                }
+                parsed.toolName = tok;
+            }
+            else {
+                parsed.error = `Unexpected positional '${tok}'.`;
+                return parsed;
+            }
+            positionalCount++;
+            i++;
+            continue;
+        }
+        // Anything else is an unknown flag. Collect for a helpful error.
+        parsed.unknown.push(tok);
+        i++;
+    }
+    if (parsed.unknown.length > 0) {
+        parsed.error = `Unknown option(s): ${parsed.unknown.join(", ")}.`;
+        return parsed;
+    }
+    // Command-specific validation.
+    if (parsed.command === "run-tool" && !parsed.toolName) {
+        parsed.error = "run-tool requires a tool name (run-tool <name>).";
+        return parsed;
+    }
+    if (!parsed.command) {
+        // No command at all — the caller (dispatcher) decides what to do. When
+        // invoked as an MCP server (no subcommand), the stdio path handles it; we
+        // surface help for an explicit `--json` with no command, but otherwise
+        // return null command so the dispatcher can fall through to the server.
+    }
+    return parsed;
+}
+function parsePositiveInt(v) {
+    if (v === undefined || v.startsWith("-"))
+        return undefined;
+    const n = Number(v);
+    if (!Number.isInteger(n) || n <= 0)
+        return undefined;
+    return n;
+}
+/**
+ * Parse a `--args` JSON blob and merge it into the existing args object. The
+ * blob MUST parse to a JSON object — arrays / scalars are rejected so a stray
+ * `--args '[1,2]'` doesn't silently become `{ "0": 1 }`. Returns an Error when
+ * the blob is invalid so the parser can surface a clean message.
+ */
+function mergeJsonArgs(into, blob) {
+    let parsed;
+    try {
+        parsed = JSON.parse(blob);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return new Error(`--args is not valid JSON: ${msg}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return new Error("--args must be a JSON object.");
+    }
+    return { ...into, ...parsed };
+}
+/**
+ * Coerce a `--arg key=value` value. If the raw value parses as JSON, use the
+ * parsed form (so `--arg timeout_ms=30000` yields a number and `--arg
+ * include_planned=true` yields a boolean); otherwise keep it as a string.
+ */
+export function coerceArgValue(rawValue) {
+    try {
+        return JSON.parse(rawValue);
+    }
+    catch {
+        return rawValue;
+    }
+}
+//# sourceMappingURL=args.js.map