unity-agentic-tools 0.5.1 → 0.6.1

package/dist/editor-transport.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EDITOR_REQUEST_TIMEOUT_MS = void 0;
+exports.request_editor_at_port = request_editor_at_port;
+exports.ping_editor = ping_editor;
+exports.generate_editor_request_id = generate_editor_request_id;
+const util_1 = require("./util");
+/**
+ * Default per-request timeout shared between the orchestration layer
+ * (`call_editor` in editor-client.ts) and the wire layer (`request_editor_at_port`).
+ * When a caller leaves the timeout at the default we omit the `_timeout` hint;
+ * any non-default value is forwarded so the server can honor it.
+ */
+exports.DEFAULT_EDITOR_REQUEST_TIMEOUT_MS = 10000;
+/**
+ * Send a JSON-RPC request directly to a known editor bridge port.
+ */
+async function request_editor_at_port(options) {
+    const { port, method, params, timeout, no_wait } = options;
+    const url = `ws://127.0.0.1:${port}/unity-agentic`;
+    const request_id = generate_editor_request_id();
+    const wire_params = { ...params };
+    if (timeout !== exports.DEFAULT_EDITOR_REQUEST_TIMEOUT_MS)
+        wire_params._timeout = timeout;
+    if (no_wait)
+        wire_params.no_wait = true;
+    const request = {
+        jsonrpc: "2.0",
+        id: request_id,
+        method,
+        ...(Object.keys(wire_params).length > 0 ? { params: wire_params } : {}),
+    };
+    return new Promise((resolve) => {
+        let resolved = false;
+        let ws;
+        const timer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                try {
+                    ws?.close();
+                }
+                catch { }
+                resolve({
+                    jsonrpc: "2.0",
+                    id: request_id,
+                    error: { code: -32001, message: `Timeout after ${timeout}ms waiting for response to ${method}` },
+                });
+            }
+        }, timeout);
+        try {
+            ws = new WebSocket(url);
+            ws.onopen = () => {
+                ws.send(JSON.stringify(request));
+                if (no_wait && !resolved) {
+                    resolved = true;
+                    clearTimeout(timer);
+                    setTimeout(() => { try {
+                        ws.close();
+                    }
+                    catch { } }, 200);
+                    resolve({
+                        jsonrpc: "2.0",
+                        id: request_id,
+                        result: { queued: true },
+                    });
+                }
+            };
+            ws.onmessage = (event) => {
+                // Ignore non-JSON or partial frames; the bridge may interleave event
+                // notifications with the response we are awaiting.
+                try {
+                    const data = JSON.parse(String(event.data));
+                    if (data.id === request_id) {
+                        if (!resolved) {
+                            resolved = true;
+                            clearTimeout(timer);
+                            ws.close();
+                            resolve(data);
+                        }
+                    }
+                }
+                catch { }
+            };
+            ws.onerror = () => {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timer);
+                    resolve({
+                        jsonrpc: "2.0",
+                        id: request_id,
+                        error: { code: -32002, message: `WebSocket connection failed to ${url}. Is the Unity Editor running?` },
+                    });
+                }
+            };
+            ws.onclose = () => {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timer);
+                    resolve({
+                        jsonrpc: "2.0",
+                        id: request_id,
+                        error: { code: -32003, message: 'WebSocket connection closed before response received' },
+                    });
+                }
+            };
+        }
+        catch (err) {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timer);
+                resolve({
+                    jsonrpc: "2.0",
+                    id: request_id,
+                    error: { code: -32002, message: `Failed to connect: ${err instanceof Error ? err.message : String(err)}` },
+                });
+            }
+        }
+    });
+}
+/**
+ * Quick connectivity check: attempts a WebSocket handshake and immediately closes.
+ * Returns whether the bridge is reachable within the timeout.
+ */
+async function ping_editor(port, timeout_ms = 2000) {
+    const url = `ws://127.0.0.1:${port}/unity-agentic`;
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            resolve({ reachable: false, error: `Timeout after ${timeout_ms}ms` });
+        }, timeout_ms);
+        try {
+            const ws = new WebSocket(url);
+            ws.onopen = () => {
+                clearTimeout(timer);
+                try {
+                    ws.close();
+                }
+                catch { }
+                resolve({ reachable: true });
+            };
+            ws.onerror = (err) => {
+                clearTimeout(timer);
+                resolve({ reachable: false, error: describe_websocket_error(err, `WebSocket connection failed to ${url}`) });
+            };
+        }
+        catch (err) {
+            clearTimeout(timer);
+            resolve({ reachable: false, error: describe_websocket_error(err, `WebSocket connection failed to ${url}`) });
+        }
+    });
+}
+function generate_editor_request_id() {
+    return `${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+}
+function describe_websocket_error(err, fallback) {
+    if (err instanceof Error && err.message.trim().length > 0) {
+        return err.message;
+    }
+    if ((0, util_1.is_record)(err)) {
+        if (typeof err.message === 'string' && err.message.trim().length > 0) {
+            return err.message;
+        }
+        if (err.error instanceof Error && err.error.message.trim().length > 0) {
+            return err.error.message;
+        }
+        if (typeof err.type === 'string' && err.type.trim().length > 0) {
+            return `${fallback} (${err.type})`;
+        }
+    }
+    const stringified = String(err);
+    if (stringified && stringified !== '[object Event]' && stringified !== '[object ErrorEvent]') {
+        return stringified;
+    }
+    return fallback;
+}
+//# sourceMappingURL=editor-transport.js.map

package/dist/editor-transport.js.map

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

package/dist/gitignore.d.ts

@@ -0,0 +1,3 @@
+export declare function ensure_gitignore_ignores_agentic_dir(project_path: string): void;
+export declare function gitignore_ignores_agentic_dir(content: string): boolean;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../src/gitignore.ts"],"names":[],"mappings":"AAYA,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAe/E;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAatE"}

package/dist/gitignore.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensure_gitignore_ignores_agentic_dir = ensure_gitignore_ignores_agentic_dir;
+exports.gitignore_ignores_agentic_dir = gitignore_ignores_agentic_dir;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const AGENTIC_DIR = '.unity-agentic';
+const GITIGNORE_ENTRY = `${AGENTIC_DIR}/`;
+const ACCEPTED_AGENTIC_PATTERNS = new Set([
+    AGENTIC_DIR,
+    GITIGNORE_ENTRY,
+    `/${AGENTIC_DIR}`,
+    `/${GITIGNORE_ENTRY}`,
+]);
+function ensure_gitignore_ignores_agentic_dir(project_path) {
+    const gitignore_path = (0, path_1.join)(project_path, '.gitignore');
+    if (!(0, fs_1.existsSync)(gitignore_path)) {
+        (0, fs_1.writeFileSync)(gitignore_path, `${GITIGNORE_ENTRY}\n`);
+        return;
+    }
+    const content = (0, fs_1.readFileSync)(gitignore_path, 'utf-8');
+    if (gitignore_ignores_agentic_dir(content)) {
+        return;
+    }
+    const separator = content.length === 0 || content.endsWith('\n') ? '' : '\n';
+    (0, fs_1.writeFileSync)(gitignore_path, `${content}${separator}${GITIGNORE_ENTRY}\n`);
+}
+function gitignore_ignores_agentic_dir(content) {
+    for (const raw_line of content.split(/\r?\n/)) {
+        const line = raw_line.trim();
+        if (line.length === 0 || line.startsWith('#')) {
+            continue;
+        }
+        if (ACCEPTED_AGENTIC_PATTERNS.has(line)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../src/gitignore.ts"],"names":[],"mappings":";;AAYA,oFAeC;AAED,sEAaC;AA1CD,2BAA6D;AAC7D,+BAA4B;AAE5B,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,MAAM,eAAe,GAAG,GAAG,WAAW,GAAG,CAAC;AAC1C,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACtC,WAAW;IACX,eAAe;IACf,IAAI,WAAW,EAAE;IACjB,IAAI,eAAe,EAAE;CACxB,CAAC,CAAC;AAEH,SAAgB,oCAAoC,CAAC,YAAoB;IACrE,MAAM,cAAc,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,IAAA,eAAU,EAAC,cAAc,CAAC,EAAE,CAAC;QAC9B,IAAA,kBAAa,EAAC,cAAc,EAAE,GAAG,eAAe,IAAI,CAAC,CAAC;QACtD,OAAO;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,6BAA6B,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO;IACX,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,IAAA,kBAAa,EAAC,cAAc,EAAE,GAAG,OAAO,GAAG,SAAS,GAAG,eAAe,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAAe;IACzD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,SAAS;QACb,CAAC;QAED,IAAI,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/guid-cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared interface for a loaded GUID cache with lookup helpers.
+ * Centralizes the 7+ inline cache-loading sites across the codebase.
+ */
+export interface GuidCache {
+    /** Absolute project root path. */
+    project_path: string;
+    /** Raw guid -> relative path map. */
+    cache: Record<string, string>;
+    /** Number of entries in the cache. */
+    count: number;
+    /** Forward lookup: resolve a GUID to a relative asset path (or null). */
+    resolve(guid: string): string | null;
+    /** Forward lookup: resolve a GUID to an absolute asset path (or null). */
+    resolve_absolute(guid: string): string | null;
+    /** Batch forward lookup. */
+    resolve_many(guids: string[]): Record<string, string | null>;
+    /** Reverse lookup: find a GUID+path by filename, optionally filtered by extension. */
+    find_by_name(name: string, extension?: string): {
+        guid: string;
+        path: string;
+    } | null;
+    /** Reverse lookup: return all exact filename matches, optionally filtered by extension. */
+    find_all_by_name_exact(name: string, extension?: string): Array<{
+        guid: string;
+        path: string;
+    }>;
+}
+/**
+ * Load the GUID cache for a Unity project at the given root path.
+ * Returns null if the cache file doesn't exist.
+ * Results are memoized in-process.
+ */
+export declare function load_guid_cache(project_path: string): GuidCache | null;
+/**
+ * Load the GUID cache for a file by auto-discovering the project root.
+ * If explicit_project is provided, it takes priority.
+ * Returns null if no project root found or cache doesn't exist.
+ */
+export declare function load_guid_cache_for_file(file_path: string, explicit_project?: string): GuidCache | null;
+/**
+ * Clear the in-process cache. Useful for testing.
+ */
+export declare function clear_guid_cache_store(): void;
+//# sourceMappingURL=guid-cache.d.ts.map

package/dist/guid-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid-cache.d.ts","sourceRoot":"","sources":["../src/guid-cache.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,0EAA0E;IAC1E,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,4BAA4B;IAC5B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,sFAAsF;IACtF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,2FAA2F;IAC3F,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnG;AA0ED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBtE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIvG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/guid-cache.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.load_guid_cache = load_guid_cache;
+exports.load_guid_cache_for_file = load_guid_cache_for_file;
+exports.clear_guid_cache_store = clear_guid_cache_store;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_1 = require("./utils");
+/** In-process cache keyed by project_path to avoid re-reading JSON. */
+const _cache_store = new Map();
+/**
+ * Build a GuidCache wrapper from a raw guid->path record.
+ */
+function build_guid_cache(project_path, raw) {
+    return {
+        project_path,
+        cache: raw,
+        count: Object.keys(raw).length,
+        resolve(guid) {
+            return raw[guid] ?? null;
+        },
+        resolve_absolute(guid) {
+            const rel = raw[guid];
+            if (!rel)
+                return null;
+            // Some caches store absolute paths (e.g. test fixtures)
+            if ((0, path_1.isAbsolute)(rel))
+                return rel;
+            return (0, path_1.join)(project_path, rel);
+        },
+        resolve_many(guids) {
+            const result = {};
+            for (const guid of guids) {
+                result[guid] = raw[guid] ?? null;
+            }
+            return result;
+        },
+        find_by_name(name, extension) {
+            const nameLower = name.toLowerCase().replace(/\.[^.]+$/, '');
+            let substringMatch = null;
+            for (const [guid, assetPath] of Object.entries(raw)) {
+                if (extension && !assetPath.endsWith(extension))
+                    continue;
+                const fileName = (0, path_1.basename)(assetPath, (0, path_1.extname)(assetPath)).toLowerCase();
+                // Exact filename match -- return immediately
+                if (fileName === nameLower) {
+                    return { guid, path: assetPath };
+                }
+                // Track first substring match as fallback
+                if (!substringMatch && assetPath.toLowerCase().includes(nameLower)) {
+                    substringMatch = { guid, path: assetPath };
+                }
+            }
+            return substringMatch;
+        },
+        find_all_by_name_exact(name, extension) {
+            const nameLower = name.toLowerCase().replace(/\.[^.]+$/, '');
+            const matches = [];
+            for (const [guid, assetPath] of Object.entries(raw)) {
+                if (extension && !assetPath.endsWith(extension))
+                    continue;
+                const fileName = (0, path_1.basename)(assetPath, (0, path_1.extname)(assetPath)).toLowerCase();
+                if (fileName === nameLower) {
+                    matches.push({ guid, path: assetPath });
+                }
+            }
+            return matches;
+        },
+    };
+}
+/**
+ * Load the GUID cache for a Unity project at the given root path.
+ * Returns null if the cache file doesn't exist.
+ * Results are memoized in-process.
+ */
+function load_guid_cache(project_path) {
+    const resolved = project_path;
+    const existing = _cache_store.get(resolved);
+    if (existing)
+        return existing;
+    const cachePath = (0, path_1.join)(resolved, '.unity-agentic', 'guid-cache.json');
+    if (!(0, fs_1.existsSync)(cachePath))
+        return null;
+    try {
+        const raw = JSON.parse((0, fs_1.readFileSync)(cachePath, 'utf-8'));
+        const cache = build_guid_cache(resolved, raw);
+        _cache_store.set(resolved, cache);
+        return cache;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load the GUID cache for a file by auto-discovering the project root.
+ * If explicit_project is provided, it takes priority.
+ * Returns null if no project root found or cache doesn't exist.
+ */
+function load_guid_cache_for_file(file_path, explicit_project) {
+    const project_path = explicit_project || (0, utils_1.find_unity_project_root)((0, path_1.dirname)(file_path));
+    if (!project_path)
+        return null;
+    return load_guid_cache(project_path);
+}
+/**
+ * Clear the in-process cache. Useful for testing.
+ */
+function clear_guid_cache_store() {
+    _cache_store.clear();
+}
+//# sourceMappingURL=guid-cache.js.map

package/dist/guid-cache.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { UnityScanner, isNativeModuleAvailable, getNativeModuleError, getNativeExtractCsharpTypes, getNativeExtractDllTypes, getNativeBuildTypeRegistry, } from './scanner';
+export { setup } from './setup';
+export { cleanup } from './cleanup';
+export { search_project, grep_project, walk_project_files } from './project-search';
+export { atomicWrite, generateGuid, find_unity_project_root } from './utils';
+export type { FindResult, GameObject, GameObjectWithComponents, GameObjectDetail, Component, SceneInspection, InspectOptions, PaginationOptions, PaginatedInspection, AssetObject, } from './types';
+export type { ProjectSearchOptions, ProjectSearchResult, ProjectSearchMatch, ProjectGrepOptions, ProjectGrepResult, GrepMatch, } from './types';
+export type { CSharpTypeRef, CSharpFieldRef, CSharpTypeInfo, } from './types';
+export type { SetupOptions, SetupResult, GuidCache } from './setup';
+export type { CleanupOptions, CleanupResult } from './cleanup';
+//# 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":"AACA,OAAO,EACH,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,GAC7B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAG7E,YAAY,EACR,UAAU,EACV,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EACR,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EACR,aAAa,EACb,cAAc,EACd,cAAc,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}