unity-open-mcp 1.2.3 → 1.3.0

package/dist/tool-contract.js

@@ -0,0 +1,253 @@
+import { implementedRules } from "./capabilities/rule-catalog.js";
+// Explicit semantic inventory: prose edits must never change a locator contract.
+const GAME_OBJECT_PATH_TOOLS = new Set([
+    "unity_senses_spatial_query",
+    "unity_open_mcp_prefab_create",
+    "unity_open_mcp_prefab_apply",
+    "unity_open_mcp_prefab_revert",
+    "unity_open_mcp_prefab_unpack",
+    "unity_open_mcp_prefab_get_overrides",
+    "unity_open_mcp_prefab_status",
+    "unity_open_mcp_gameobject_destroy",
+    "unity_open_mcp_gameobject_duplicate",
+    "unity_open_mcp_gameobject_find",
+    "unity_open_mcp_gameobject_modify",
+    "unity_open_mcp_gameobject_set_parent",
+    "unity_open_mcp_component_add",
+    "unity_open_mcp_component_destroy",
+    "unity_open_mcp_component_get",
+    "unity_open_mcp_component_modify",
+    "unity_open_mcp_scene_focus",
+    "unity_open_mcp_selection_set",
+    "unity_open_mcp_navigation_surface_add",
+    "unity_open_mcp_navigation_set_bake_settings",
+    "unity_open_mcp_navigation_surface_bake",
+    "unity_open_mcp_navigation_modifier_add",
+    "unity_open_mcp_navigation_modifier_volume_add",
+    "unity_open_mcp_navigation_link_add",
+    "unity_open_mcp_navigation_agent_add",
+    "unity_open_mcp_navigation_agent_set_destination",
+    "unity_open_mcp_navigation_get",
+    "unity_open_mcp_navigation_modify",
+    "unity_open_mcp_probuilder_get_mesh_info",
+    "unity_open_mcp_probuilder_extrude",
+    "unity_open_mcp_probuilder_delete_faces",
+    "unity_open_mcp_probuilder_set_face_material",
+    "unity_open_mcp_particle_system_get",
+    "unity_open_mcp_particle_system_modify",
+    "unity_open_mcp_splines_add_knot",
+    "unity_open_mcp_splines_set_knot",
+    "unity_open_mcp_splines_set_tangent_mode",
+    "unity_open_mcp_splines_evaluate",
+    "unity_open_mcp_splines_get_knots",
+    "unity_open_mcp_splines_modify",
+    "unity_open_mcp_light_add",
+    "unity_open_mcp_light_set",
+    "unity_open_mcp_light_modify",
+    "unity_open_mcp_reflection_probe_bake",
+    "unity_open_mcp_reflection_probe_get",
+    "unity_open_mcp_audio_source_add",
+    "unity_open_mcp_audio_source_modify",
+    "unity_open_mcp_ui_canvas_add",
+    "unity_open_mcp_ui_layout_group_add",
+    "unity_open_mcp_ui_element_modify",
+    "unity_open_mcp_constraint_add",
+    "unity_open_mcp_lod_group_configure",
+    "unity_open_mcp_lod_add_level",
+    "unity_open_mcp_terrain_set_heights",
+    "unity_open_mcp_terrain_paint_layer",
+    "unity_open_mcp_terrain_place_trees",
+    "unity_open_mcp_terrain_set_neighbors",
+    "unity_open_mcp_cinemachine_set_targets",
+    "unity_open_mcp_cinemachine_set_lens",
+    "unity_open_mcp_cinemachine_set_body",
+    "unity_open_mcp_cinemachine_set_noise",
+    "unity_open_mcp_cinemachine_brain_ensure",
+    "unity_open_mcp_timeline_director_bind",
+    "unity_open_mcp_tilemap_set_tile",
+    "unity_open_mcp_tilemap_box_fill",
+]);
+const ASSET_PATH_TOOLS = new Set([
+    "unity_open_mcp_scene_create",
+    "unity_open_mcp_scene_open",
+    "unity_open_mcp_scene_save",
+    "unity_open_mcp_scene_unload",
+    "unity_open_mcp_scene_set_active",
+    "unity_open_mcp_scene_get_data",
+]);
+// GameObject host selectors for the "supply only one selector" rule. `name`
+// selects by name unless the tool uses it as a payload; such tools name their
+// by-name selector here and publish their full set as `x-gameobject-selectors`,
+// which the bridge's BatchSchemaValidator reads from the generated schema.
+const DEFAULT_GAMEOBJECT_SELECTORS = ["instance_id", "game_object_path", "path", "target_path", "name"];
+const NAME_SELECTOR_OVERRIDES = {
+    // `name` is the new name; the target is resolved by name_target.
+    unity_open_mcp_gameobject_modify: "name_target",
+};
+/** Selector keys the one-selector rule applies to; null when the schema has no GameObject host. */
+function gameObjectSelectors(schema) {
+    if (Array.isArray(schema["x-gameobject-selectors"]))
+        return schema["x-gameobject-selectors"];
+    if (schema["x-project-command"] || !schema.properties?.game_object_path)
+        return null;
+    return DEFAULT_GAMEOBJECT_SELECTORS.filter(k => schema.properties[k]);
+}
+/** Locator names are explicit in the published contract; aliases retain their wire key. */
+export function canonicalSchema(name, input) {
+    const schema = structuredClone(input);
+    const props = schema.properties;
+    // offline_integrity is a reporting aggregator, not a registered VerifyRunner rule.
+    for (const key of ["include_rules", "exclude_rules", ...(name === "unity_open_mcp_scan_paths" ? ["categories"] : [])])
+        if (props[key]?.items)
+            props[key].items.enum = implementedRules().filter(r => r.id !== "offline_integrity").map(r => r.id);
+    const rename = (s, old, key) => {
+        if (!s.properties?.[old] || s.properties[key])
+            return;
+        s.properties[key] = { ...s.properties[old], "x-wire-key": old };
+        s.properties[old] = { ...s.properties[old], deprecated: true, "x-alias-for": key,
+            description: `Deprecated alias; use ${key}.` };
+        delete s.properties[old].default;
+        if (s.required?.includes(old)) {
+            s.required = s.required.filter((k) => k !== old);
+            s.allOf = [...(s.allOf ?? []), { anyOf: [{ required: [key] }, { required: [old] }] }];
+        }
+    };
+    if (GAME_OBJECT_PATH_TOOLS.has(name))
+        rename(schema, "path", "game_object_path");
+    if (ASSET_PATH_TOOLS.has(name))
+        rename(schema, "path", "asset_path");
+    rename(schema, "prefab_asset_path", "asset_path");
+    if (props.prefab_asset_path)
+        props.prefab_path = { type: "string", deprecated: true, "x-alias-for": "asset_path", description: "Deprecated alias; use asset_path." };
+    if (props.game_object_path && !props.target_path)
+        props.target_path = { type: "string", deprecated: true, "x-alias-for": "game_object_path", description: "Deprecated alias; use game_object_path." };
+    if (/component_(get|modify|add)/.test(name))
+        rename(schema, "type_name", "component_type");
+    if (name.endsWith("component_modify"))
+        rename(props.fields.items, "path", "property_path");
+    if (name === "unity_open_mcp_find_references" || name === "unity_open_mcp_dependencies") {
+        props.path = { type: "string", deprecated: true, "x-alias-for": "asset_path", description: "Deprecated alias; use asset_path." };
+        for (const branch of schema.oneOf ?? [])
+            if (branch.required?.includes("asset_path")) {
+                branch.required = branch.required.filter((k) => k !== "asset_path");
+                branch.anyOf = [{ required: ["asset_path"] }, { required: ["path"] }];
+            }
+    }
+    if (props.prefab_path)
+        for (const clause of schema.allOf ?? [])
+            if (clause.anyOf?.some((b) => b.required?.includes("asset_path")))
+                clause.anyOf.push({ required: ["prefab_path"] });
+    if (props.game_object_path) {
+        const nameSelector = NAME_SELECTOR_OVERRIDES[name] ?? "name";
+        if (nameSelector !== "name")
+            schema["x-gameobject-selectors"] = DEFAULT_GAMEOBJECT_SELECTORS.map(k => k === "name" ? nameSelector : k).filter(k => props[k]);
+        props.game_object_path.description = `GameObject hierarchy path, e.g. Root/Child. Supply only one host selector: instance_id, game_object_path, or ${nameSelector}.`;
+    }
+    if (props.component_type)
+        props.component_type.description = "Component type (full name preferred); alternative to component_instance_id.";
+    return schema;
+}
+/**
+ * An explicit `null` for an OPTIONAL property whose schema declares a
+ * non-null type is read as "omitted": MCP clients routinely serialize an
+ * absent optional argument as null, and the bridge's own readers treat such a
+ * value as absent. A required property, a property without a declared type
+ * (opaque patch values such as component_modify's `value`) and a type that
+ * lists `null` keep the value as sent.
+ */
+function isNullOmitted(schema, key, value) {
+    if (value !== null)
+        return false;
+    if ((schema.required ?? []).includes(key))
+        return false;
+    const type = schema.properties?.[key]?.type;
+    if (!type)
+        return false;
+    return !(Array.isArray(type) ? type : [type]).includes("null");
+}
+/** `value` without its null-omitted properties; the input object is not mutated. */
+function withoutNullOmitted(value, schema) {
+    if (!schema.properties)
+        return value;
+    const kept = Object.entries(value).filter(([key, v]) => !isNullOmitted(schema, key, v));
+    return kept.length === Object.keys(value).length ? value : Object.fromEntries(kept);
+}
+/** Validate before dispatch, including nested records; arbitrary value payloads stay opaque. */
+export function validateSchema(value, schema, path = "args") {
+    if (value && typeof value === "object" && !Array.isArray(value))
+        value = withoutNullOmitted(value, schema);
+    const errors = [];
+    for (const op of ["anyOf", "oneOf", "allOf"])
+        if (schema[op]) {
+            const n = schema[op].filter((s) => validateSchema(value, s, path).length === 0).length;
+            if ((op === "anyOf" && !n) || (op === "oneOf" && n !== 1) || (op === "allOf" && n !== schema[op].length))
+                errors.push(`${path} must satisfy ${op}`);
+        }
+    const matches = (t) => t === "array" ? Array.isArray(value) : t === "object" ? value !== null && typeof value === "object" && !Array.isArray(value) : t === "integer" ? Number.isInteger(value) : t === "null" ? value === null : typeof value === t;
+    if (schema.type && !(Array.isArray(schema.type) ? schema.type : [schema.type]).some(matches))
+        return [`${path} must be ${schema.type}`];
+    if (schema.enum && !schema.enum.includes(value))
+        errors.push(`${path} must be one of ${schema.enum.join(", ")}`);
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        for (const key of schema.required ?? [])
+            if (value[key] === undefined)
+                errors.push(`${path}.${key} is required`);
+        const selectorKeys = gameObjectSelectors(schema);
+        if (selectorKeys) {
+            const supplied = (k) => value[k] !== undefined && value[k] !== null && value[k] !== "" && value[k] !== 0 && value[k] !== "0";
+            const selectors = selectorKeys.filter(supplied);
+            if (selectors.length > 1)
+                errors.push(`${path}: supply only one GameObject selector (prefer game_object_path); ignored keys: ${selectors.join(", ")}`);
+            if (supplied("component_instance_id") && ["component_type", "type_name"].some(supplied))
+                errors.push(`${path}: component_instance_id and component_type are alternatives`);
+        }
+        if (schema.properties)
+            for (const [key, child] of Object.entries(value)) {
+                const prop = Object.prototype.hasOwnProperty.call(schema.properties, key) ? schema.properties[key] : undefined;
+                if (!prop && schema.additionalProperties === false)
+                    errors.push(`${path}.${key} is unknown; canonical keys: ${Object.keys(schema.properties).filter(k => !schema.properties[k].deprecated).join(", ")}`);
+                if (prop) {
+                    if (prop["x-alias-for"] && Object.keys(value).some(other => other !== key && (other === prop["x-alias-for"] || schema.properties[other]?.["x-alias-for"] === prop["x-alias-for"])))
+                        errors.push(`${path}.${key} conflicts with another selector; use only ${prop["x-alias-for"]}`);
+                    errors.push(...validateSchema(child, prop, `${path}.${key}`));
+                }
+            }
+    }
+    if (Array.isArray(value) && schema.items)
+        value.forEach((v, i) => errors.push(...validateSchema(v, schema.items, `${path}[${i}]`)));
+    if (typeof value === "string" && schema.pattern && !new RegExp(schema.pattern).test(value))
+        errors.push(`${path} does not match ${schema.pattern}`);
+    const size = typeof value === "number" ? value : typeof value === "string" || Array.isArray(value) ? value.length : undefined;
+    if (size !== undefined) {
+        for (const k of ["minimum", "minItems", "minLength"])
+            if (schema[k] !== undefined && size < schema[k])
+                errors.push(`${path} violates ${k}`);
+        if (typeof value === "number" && schema.exclusiveMinimum !== undefined && value <= schema.exclusiveMinimum)
+            errors.push(`${path} violates exclusiveMinimum`);
+        if (typeof value === "number" && schema.exclusiveMaximum !== undefined && value >= schema.exclusiveMaximum)
+            errors.push(`${path} violates exclusiveMaximum`);
+        for (const k of ["maximum", "maxItems", "maxLength"])
+            if (schema[k] !== undefined && size > schema[k])
+                errors.push(`${path} violates ${k}`);
+    }
+    return errors;
+}
+export function wireArguments(value, schema, notes = []) {
+    if (Array.isArray(value))
+        return value.map(v => wireArguments(v, schema.items ?? {}, notes));
+    if (!value || typeof value !== "object" || !schema.properties)
+        return value;
+    const out = {};
+    // Null-omitted properties never reach the wire: the bridge validates the
+    // same schema and would otherwise refuse the null the server just waived.
+    for (const [key, v] of Object.entries(withoutNullOmitted(value, schema))) {
+        const p = schema.properties[key] ?? {};
+        const canonical = p["x-alias-for"];
+        if (canonical)
+            notes.push(`${key} is deprecated; use ${canonical}.`);
+        const target = p["x-wire-key"] ?? (canonical ? schema.properties[canonical]?.["x-wire-key"] ?? canonical : key);
+        out[target] = wireArguments(v, p, notes);
+    }
+    return out;
+}
+//# sourceMappingURL=tool-contract.js.map

package/dist/tool-contract.js.map

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

package/dist/tool-router.d.ts

@@ -1,7 +1,9 @@
+import { JobManager } from "./jobs/job-manager.js";
+import { type RequestIdentity } from "./agent-identity.js";
+import { type BridgeTagConfirmation } from "./release-lookup.js";
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import type { Router } from "./router.js";
-import type { LiveClient } from "./live-client.js";
-import type { BatchSpawn } from "./batch-spawn.js";
+import { LiveClient } from "./live-client.js";
 import type { BridgeEventStream } from "./event-stream.js";
 export declare function resolveRouteLogEnabled(env?: NodeJS.ProcessEnv): boolean;
 export declare const ROUTE_LOG_ENABLED: boolean;
@@ -23,7 +25,8 @@ export interface HubControlBackend {
     getInstallPath(): InstallPathResult;
     setInstallPath(path: string): ReturnType<typeof setInstallPath>;
 }
-import type { ToolSessionState } from "./tool-session-state.js";
+import { BatchSpawn } from "./batch-spawn.js";
+import { type ToolSessionState } from "./tool-session-state.js";
 export type SourceTag = "live" | "offline" | "local";
 export interface RouteMeta {
     /**
@@ -45,6 +48,19 @@ export interface RouteMeta {
      */
     editorPid?: number;
 }
+/**
+ * Release lookups behind `unity_open_mcp_upgrade`. Injectable so unit tests
+ * never touch npm or GitHub; production uses the shared `release-lookup`
+ * module with the global fetch.
+ */
+export interface ReleaseLookup {
+    latest(): Promise<{
+        version: string;
+    }>;
+    confirmBridgeTag(version: string): Promise<BridgeTagConfirmation>;
+}
+/** Test seam for the upgrade route's network lookups. Returns a restore function. */
+export declare function setReleaseLookupForTest(lookup: ReleaseLookup | null): () => void;
 export declare class ToolRouter implements Router {
     private live;
     private batch;
@@ -54,6 +70,10 @@ export declare class ToolRouter implements Router {
     private onToolListChanged?;
     private hubBackend;
     private globalLogPathOverride?;
+    private jobManager?;
+    get jobs(): JobManager;
+    closeJobs(): void;
+    routeJobs(args: Record<string, unknown>, identity?: RequestIdentity): Promise<CallToolResult>;
     private readonly modelCache;
     /**
      * M28-refactoring Plan 3 (T3.2) — named-tool dispatch map. Replaces the
@@ -68,17 +88,41 @@ export declare class ToolRouter implements Router {
     private routeHandlers?;
     private getRouteHandlers;
     constructor(live: LiveClient, batch: BatchSpawn, projectPath: string, eventStream: BridgeEventStream, sessionState: ToolSessionState, onToolListChanged?: (() => void | Promise<void>) | undefined, hubBackend?: HubControlBackend, globalLogPathOverride?: string | undefined);
-    route(toolName: string, args: Record<string, unknown>): Promise<CallToolResult>;
+    route(toolName: string, args: Record<string, unknown>, identity?: RequestIdentity): Promise<CallToolResult>;
+    /**
+     * `capabilities` / `bridge_status` with an explicit project_path, from any
+     * entry point (direct, manage_tools invoke, port override). The probe router
+     * gets the arguments without project_path, so it dispatches normally. A
+     * per-request port override is refused rather than dropped or mixed in:
+     * project_path brings its own port/auth discovery, and pinging the override
+     * port would present another bridge's answer as the probed project's.
+     */
+    private routeProjectProbe;
+    /**
+     * Router for a read-only probe of another project: its own port/auth
+     * discovery and a throwaway copy of this session. Discovery still reconciles
+     * auto-activation against the probed project's inventory, so the probe
+     * reports that project's view, but only the copy changes — this session's
+     * active groups and tools/list stay put, and no list_changed is wired. The
+     * probe tools are local-only and never spawn Unity; the probe's own batch
+     * router only answers headless availability for that project's editor.
+     */
+    private projectProbeRouter;
+    private static readonly PROBE_BATCH_CACHE_SIZE;
+    private readonly probeBatchByProject;
+    private projectProbeBatch;
     /**
      * M23 Plan 3 — route with a per-call live-client override. Used when a
      * per-request `_meta.port` override targets a different bridge instance than
      * the default. The override client bypasses shared session state (it is a
      * fresh LiveClient aimed at the override port); all other routing logic is
-     * identical to {@link route}. When `overrideLive` is null the default client
-     * is used (identical to {@link route}).
+     * identical to {@link route}. `identity` carries the override port and the
+     * request's agent id.
      */
-    routeOverride(toolName: string, args: Record<string, unknown>, overrideLive: LiveClient): Promise<CallToolResult>;
+    routeOverride(toolName: string, args: Record<string, unknown>, overrideLive: LiveClient, identity: RequestIdentity): Promise<CallToolResult>;
     private routeCore;
+    private routeValidated;
+    private routeUnchecked;
     private batchPingResult;
     /**
      * feedback-fable-04-08 §7 — when a `live_unavailable` batch fallback lands
@@ -106,6 +150,17 @@ export declare class ToolRouter implements Router {
     private routeListRules;
     private routeGenerateSkill;
     private routeManageTools;
+    /**
+     * `unity_open_mcp_upgrade` is a live tool, but its network lookups run HERE
+     * rather than inside the bridge: the bridge tool executes on the Editor main
+     * thread, where a 10 s registry timeout would freeze the Editor and every
+     * queued bridge request. The bridge only ever receives a resolved
+     * `target_version`, and an apply that will re-pin through UPM is forwarded
+     * only after the `bridge-v<version>` release tag was confirmed to exist —
+     * the same preview → confirm → apply order the bridge window follows.
+     */
+    private routeUpgrade;
+    private routeProjectCommands;
     private manageToolsListGroups;
     private manageToolsSuggest;
     private manageToolsActivateFor;