unity-open-mcp 0.1.0

package/dist/compressible-router.js

@@ -0,0 +1,191 @@
+// M9 Plan 2 + Plan 3 — compressible-tool router.
+//
+// Intercepts `read_asset` / `search_assets`: produces the structured
+// AssetModel / SearchModel (offline parser for text-serialized assets, or live
+// bridge for binary formats) and applies the shared compression module
+// (compact.ts) to produce the compact drill-down response.
+//
+// A session-scoped AssetModel cache lets `--component` / `--path` / `--id`
+// drill-downs reuse the last-fetched model instead of re-parsing the asset.
+// The cache key includes field_limit and depth (the parameters that change what
+// the source returns); detail/component/path/id are pure TS-side render options
+// and do not invalidate the cache.
+import { renderAssetSummary, renderSearchSummary, } from "./compression/compact.js";
+import { readAssetOffline, isOfflineAsset } from "./offline.js";
+import { searchAssetsOffline } from "./offline.js";
+import { makeErrorResult } from "./results.js";
+const COMPRESSIBLE = new Set([
+    "unity_open_mcp_read_asset",
+    "unity_open_mcp_search_assets",
+]);
+export function isCompressible(toolName) {
+    return COMPRESSIBLE.has(toolName);
+}
+const CACHE_LIMIT = 8;
+/** Session-scoped LRU for the last few AssetModels read by `read_asset`. */
+export class AssetModelCache {
+    entries = new Map();
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return null;
+        // Move-to-end so the LRU eviction order updates.
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        return entry.model;
+    }
+    set(key, model) {
+        if (this.entries.has(key))
+            this.entries.delete(key);
+        this.entries.set(key, { model });
+        while (this.entries.size > CACHE_LIMIT) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+    get size() {
+        return this.entries.size;
+    }
+}
+function makeResult(payload, cacheHit, source) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ...payload,
+                    _cache: cacheHit ? "hit" : "miss",
+                    ...(source ? { _source: source } : {}),
+                }),
+            },
+        ],
+        isError: false,
+    };
+}
+/**
+ * Route a compressible tool: try offline parser first for text-serialized
+ * assets, fall back to the live bridge for binary formats. Cache the model
+ * (read_asset only), apply the compression module, and return.
+ */
+export async function routeCompressible(toolName, args, live, cache, projectPath) {
+    if (toolName === "unity_open_mcp_read_asset") {
+        return routeReadAsset(args, live, cache, projectPath);
+    }
+    return routeSearchAssets(args, live, projectPath);
+}
+async function routeReadAsset(args, live, cache, projectPath) {
+    const assetPath = typeof args.asset_path === "string" ? args.asset_path : "";
+    if (assetPath === "") {
+        return makeErrorResult({ code: "missing_parameter", message: "'asset_path' is required." });
+    }
+    const fieldLimit = typeof args.field_limit === "number" ? args.field_limit : 0;
+    const depth = typeof args.depth === "number" ? args.depth : -1;
+    const cacheKey = `${assetPath}|${fieldLimit}|${depth}`;
+    let model = cache.get(cacheKey);
+    let cacheHit = true;
+    let source = "offline";
+    if (!model) {
+        cacheHit = false;
+        if (isOfflineAsset(assetPath)) {
+            try {
+                const result = await readAssetOffline(assetPath, { fieldLimit, projectRoot: projectPath });
+                model = result.model;
+                source = "offline";
+                cache.set(cacheKey, model);
+            }
+            catch {
+                // Offline parse failed — fall through to live bridge.
+                model = null;
+            }
+        }
+        if (!model) {
+            // Fall back to live bridge (for binary formats or parse failures).
+            const liveAvailable = await live.isLiveAvailable();
+            if (!liveAvailable) {
+                return makeErrorResult({
+                    code: "source_unavailable",
+                    message: isOfflineAsset(assetPath)
+                        ? `Offline parse failed and live bridge is unavailable for: ${assetPath}`
+                        : `Binary or unsupported format requires the live bridge, which is unavailable: ${assetPath}`,
+                });
+            }
+            const raw = await live.route("unity_open_mcp_read_asset", args);
+            const parsed = parseContentJson(raw);
+            if (parsed === null) {
+                return raw.isError
+                    ? raw
+                    : makeErrorResult({ code: "bridge_error", message: "Bridge returned an unreadable asset model." });
+            }
+            if (parsed.error) {
+                return { ...raw, isError: true };
+            }
+            model = parsed;
+            source = "live";
+            cache.set(cacheKey, model);
+        }
+    }
+    const opts = {
+        detail: typeof args.detail === "string" ? args.detail : "summary",
+        component: typeof args.component === "string" ? args.component : undefined,
+        path: typeof args.path === "string" ? args.path : undefined,
+        id: typeof args.id === "string" ? args.id : undefined,
+        override: typeof args.override === "boolean" ? args.override : undefined,
+        depth: typeof args.depth === "number" ? args.depth : undefined,
+        limit: typeof args.limit === "number" ? args.limit : undefined,
+    };
+    const compact = renderAssetSummary(model, opts);
+    return makeResult(compact, cacheHit, source);
+}
+async function routeSearchAssets(args, live, projectPath) {
+    try {
+        const model = await searchAssetsOffline({
+            name: typeof args.name === "string" ? args.name : undefined,
+            component: typeof args.component === "string" ? args.component : undefined,
+            guid: typeof args.guid === "string" ? args.guid : undefined,
+            type: typeof args.type === "string" ? args.type : undefined,
+            folder: typeof args.folder === "string" ? args.folder : "Assets",
+            projectRoot: projectPath,
+            maxResults: typeof args.max_results === "number" ? args.max_results : 50,
+        });
+        const objectLimit = typeof args.object_limit === "number" ? args.object_limit : 12;
+        const matchLimit = typeof args.max_results === "number" ? args.max_results : 50;
+        const compact = renderSearchSummary(model, { objectLimit, matchLimit });
+        return makeResult(compact, false, "offline");
+    }
+    catch {
+        // Fall back to live bridge.
+    }
+    const raw = await live.route("unity_open_mcp_search_assets", args);
+    const parsed = parseContentJson(raw);
+    if (parsed === null) {
+        return raw.isError
+            ? raw
+            : makeErrorResult({ code: "bridge_error", message: "Bridge returned an unreadable search result." });
+    }
+    if (parsed.error) {
+        return { ...raw, isError: true };
+    }
+    const objectLimit = typeof args.object_limit === "number" ? args.object_limit : 12;
+    const matchLimit = typeof args.max_results === "number" ? args.max_results : 50;
+    const compact = renderSearchSummary(parsed, { objectLimit, matchLimit });
+    return makeResult(compact, false, "live");
+}
+function parseContentJson(result) {
+    if (result.content.length === 0)
+        return null;
+    const first = result.content[0];
+    if (first.type !== "text")
+        return null;
+    try {
+        return JSON.parse(first.text);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=compressible-router.js.map

package/dist/compressible-router.js.map

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

package/dist/compression/asset-model.d.ts

@@ -0,0 +1,86 @@
+export type AssetKind = "prefab" | "scene" | "asset" | "material" | "animation" | "controller" | "other";
+export interface ComponentField {
+    /** Serialized field name (Unity's backing-field name, e.g. m_Speed). */
+    name: string;
+    /** Field value rendered as a short string (already truncated by the source). */
+    value: string;
+}
+export interface AssetComponent {
+    /** Component type name (Transform, MeshRenderer, MonoBehaviour script name). */
+    name: string;
+    /** Resolved .cs path for MonoBehaviour scripts (offline GUID index; live omits). */
+    scriptPath?: string;
+    /** Serialized fields. Present only when the source fetched them (field_limit > 0). */
+    fields?: ComponentField[];
+}
+export interface HierarchyNode {
+    /** GameObject display name. */
+    name: string;
+    /** Slash-joined path from the asset root (e.g. "Player/Model/Helmet"). */
+    path: string;
+    /** Depth from the root (root = 0). */
+    depth: number;
+    components: AssetComponent[];
+    children: HierarchyNode[];
+    /** Local YAML fileID. Offline-only (Plan 3); the live bridge omits this. */
+    fileID?: string;
+}
+/** Object entry for non-hierarchical assets (ScriptableObject, Material, .asset). */
+export interface FlatObject {
+    name: string;
+    type: string;
+    fields?: ComponentField[];
+}
+/** A single prefab variant override (from PrefabInstance m_Modifications etc.). */
+export interface PrefabOverrideEntry {
+    kind: "property" | "added-component" | "added-gameobjects" | "removed-components" | "removed-gameobjects";
+    /** Property path (backing-field names unwrapped). Property overrides only. */
+    propertyPath?: string;
+    /** Override value. Property overrides only. */
+    value?: string;
+    /** Resolved target label (GameObject path or "Component on Path"). Omitted when unresolvable. */
+    target?: string;
+    /** Resolved added-object label. Added-component / added-gameobjects only. */
+    addedObject?: string;
+}
+export interface AssetModel {
+    kind: AssetKind | string;
+    path: string;
+    guid?: string;
+    /** Total YAML objects in the file (GameObjects + components + others). */
+    objectCount: number;
+    /** Total components across the hierarchy. */
+    componentCount: number;
+    roots: HierarchyNode[];
+    /** Present for non-hierarchical assets (no GameObject tree). */
+    flatObjects?: FlatObject[];
+    /** Prefab variant overrides. Populated for prefabs with PrefabInstance objects. */
+    overrides?: PrefabOverrideEntry[];
+    /** Optional source-side notice (e.g. "scene hierarchy requires offline parser"). */
+    note?: string;
+}
+export interface SearchObjectMatch {
+    path: string;
+    components: string[];
+}
+export interface SearchMatch {
+    path: string;
+    guid?: string;
+    kind: string;
+    /** Why this file matched: "file-name" | "gameobject" | "component" | "guid". */
+    reasons: string[];
+    /** Matching GameObjects / components inside the asset (structured search). */
+    objects?: SearchObjectMatch[];
+}
+export interface SearchModel {
+    query: {
+        name?: string;
+        component?: string;
+        guid?: string;
+        type?: string;
+    };
+    matchCount: number;
+    matches: SearchMatch[];
+    /** Number of matches hidden by the source cap. */
+    truncated: number;
+}

package/dist/compression/asset-model.js

@@ -0,0 +1,15 @@
+// M9 Plan 2 — Shared asset model contract.
+//
+// Normalized representation of a text-serialized Unity asset produced by a data
+// source (live bridge today; offline YAML parser in M9 Plan 3). The compression
+// module (compress.ts / render.ts) consumes this shape and emits the compact
+// drill-down response. Both the live path (bridge -> AssetModel JSON -> MCP
+// server compresses) and the future offline path (Node parser -> AssetModel ->
+// same compression) flow through the same types so the compression code is
+// written once.
+//
+// Design rule: the model is STRUCTURED DATA, never pre-compressed. All folding,
+// component-set declaration, omission counts, and match-reason tagging happen in
+// the compression module so the algorithm lives in exactly one place.
+export {};
+//# sourceMappingURL=asset-model.js.map

package/dist/compression/asset-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-model.js","sourceRoot":"","sources":["../../src/compression/asset-model.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,gBAAgB;AAChB,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,sEAAsE"}

package/dist/compression/compact.d.ts

@@ -0,0 +1,153 @@
+import type { AssetModel, AssetComponent, HierarchyNode, PrefabOverrideEntry, SearchModel, SearchObjectMatch } from "./asset-model.js";
+/**
+ * Fold stable numbered sequences such as Recipe_001..018. Runs of fewer than
+ * three stay explicit. Names without a trailing number pass through. Ported
+ * from unity-scanner CompressNames (compress.go).
+ */
+export declare function compressNames(names: string[]): string[];
+export declare function isTrivialComponent(name: string): boolean;
+export declare function isRenderOnly(componentNames: string[]): boolean;
+export declare function hasFocusComponent(componentNames: string[]): boolean;
+export declare function componentMatches(component: AssetComponent, query: string): boolean;
+export declare function displayObjectName(node: HierarchyNode): string;
+export interface ComponentSetDeclaration {
+    code: string;
+    names: string[];
+}
+export interface AssignedNode {
+    node: HierarchyNode;
+    index: number;
+    componentNames: string[];
+    componentSet: string | null;
+    focus: boolean;
+    renderOnly: boolean;
+}
+export declare function flattenAndAssign(roots: HierarchyNode[]): {
+    rows: AssignedNode[];
+    sets: ComponentSetDeclaration[];
+};
+export interface FoldedRow {
+    index: number;
+    endIndex: number;
+    depth: number;
+    name: string;
+    path: string;
+    componentSet: string | null;
+    count: number;
+    foldedNames?: string[];
+    folded: boolean;
+}
+export interface FoldResult {
+    rows: FoldedRow[];
+    hiddenByDepth: number;
+    hiddenByLimit: number;
+    collapsed: number;
+}
+/**
+ * Walk the assigned rows and produce the folded TREE representation. Render-only
+ * leaf runs of 3+ (same depth, same component set, no children, no focus) are
+ * collapsed into a single folded row whose names run through compressNames.
+ * Depth and limit caps produce omission counts instead of silent truncation.
+ *
+ * Mirrors unity-scanner printTreeRows / collapsibleRunEnd (read.go). Full-tree
+ * mode (no folding) is selected by `fold = false`.
+ */
+export declare function foldHierarchy(rows: AssignedNode[], opts?: {
+    depth?: number;
+    limit?: number;
+    fold?: boolean;
+}): FoldResult;
+export type DetailLevel = "summary" | "normal" | "verbose";
+export interface RenderOptions {
+    detail?: DetailLevel;
+    component?: string;
+    path?: string;
+    id?: string;
+    override?: boolean;
+    depth?: number;
+    limit?: number;
+}
+export interface TreeNodeOut {
+    idx: number;
+    name: string;
+    depth: number;
+    cmp?: string;
+    toIdx?: number;
+    names?: string[];
+    count?: number;
+    components?: string[];
+}
+export interface ComponentMatchOut {
+    object: string;
+    component: string;
+    scriptPath?: string;
+    fields?: {
+        name: string;
+        value: string;
+    }[];
+    moreFieldsHidden?: number;
+}
+export interface IdResult {
+    id: string;
+    matched: boolean;
+    object?: {
+        name?: string;
+        path?: string;
+        components?: string[];
+        fields?: {
+            name: string;
+            value: string;
+        }[];
+    };
+    note?: string;
+}
+export interface CompactAssetResult {
+    asset: string;
+    path: string;
+    guid?: string;
+    objects: number;
+    components: number;
+    depth?: number;
+    cmp?: Record<string, string[]>;
+    tree?: TreeNodeOut[];
+    flatObjects?: AssetModel["flatObjects"];
+    note?: string;
+    moreHidden?: number;
+    collapsed?: number;
+    hint?: string;
+    componentMatches?: ComponentMatchOut[];
+    componentQuery?: string;
+    pathScope?: string;
+    idResult?: IdResult;
+    overrides?: PrefabOverrideEntry[];
+}
+/** Render the compact asset summary / drill-down. */
+export declare function renderAssetSummary(model: AssetModel, opts?: RenderOptions): CompactAssetResult;
+export interface CompactSearchResult {
+    query: SearchModel["query"];
+    matchCount: number;
+    shown: number;
+    matches: SearchMatchOut[];
+    truncated: number;
+    ext?: Record<string, string>;
+}
+export interface SearchMatchOut {
+    path: string;
+    kind: string;
+    guid?: string;
+    reasons: string[];
+    objects?: SearchObjectMatch[];
+    moreObjectsHidden?: number;
+}
+/**
+ * Render search matches. Reason tags are preserved per file; object listings are
+ * capped per file with a moreObjectsHidden count. Paths are compacted (Assets/
+ * prefix dropped) and an EXT table declared once when multiple kinds appear.
+ */
+export declare function renderSearchSummary(model: SearchModel, opts?: {
+    objectLimit?: number;
+    matchLimit?: number;
+}): CompactSearchResult;
+/** Drop the Assets/ prefix (declared once via EXT) and normalize slashes. */
+export declare function compactPath(path: string): string;
+export declare function extForKind(kind: string): string;