unity-agentic-tools 0.5.1 → 0.7.0

package/dist/editor-discovery.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.read_editor_config = read_editor_config;
+exports.discover_editor_config = discover_editor_config;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const gitignore_1 = require("./gitignore");
+const editor_transport_1 = require("./editor-transport");
+const util_1 = require("./util");
+const BRIDGE_PORT_RANGE_START = 53782;
+const BRIDGE_PORT_RANGE_END = 53791;
+const LAST_KNOWN_CONFIG_FILE = 'editor.last.json';
+const LAST_KNOWN_EDITOR_CONFIGS = new Map();
+/**
+ * Read and validate the editor bridge lockfile.
+ * Returns the config if valid, or an object with an error string.
+ */
+function read_editor_config(project_path) {
+    const config_path = (0, path_1.join)(project_path, '.unity-agentic', 'editor.json');
+    if (!(0, fs_1.existsSync)(config_path)) {
+        return { error: `Editor bridge not found at ${config_path}. Is the Unity Editor running with the bridge package installed?` };
+    }
+    let config;
+    try {
+        const raw = (0, fs_1.readFileSync)(config_path, 'utf-8');
+        config = JSON.parse(raw);
+    }
+    catch (err) {
+        return { error: `Failed to parse editor.json: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (typeof config.port !== 'number' || typeof config.pid !== 'number') {
+        return { error: 'Invalid editor.json: missing port or pid' };
+    }
+    if (!is_pid_alive(config.pid)) {
+        return { error: `Unity Editor process (PID ${config.pid}) is not running. The editor may have been closed.` };
+    }
+    return config;
+}
+/**
+ * Resolve a usable bridge config.
+ * Prefers the lockfile when valid, otherwise discovers a matching bridge by project identity.
+ * Manual port selection remains an explicit escape hatch rather than the default fallback.
+ */
+async function discover_editor_config(project_path, timeout_ms = 350) {
+    const normalized_project_path = normalize_project_path(project_path);
+    const lockfile_result = read_editor_config(project_path);
+    const preferred_ports = [];
+    let cached_config = read_cached_editor_config(project_path, normalized_project_path)
+        ?? LAST_KNOWN_EDITOR_CONFIGS.get(normalized_project_path);
+    let stale_cached_port;
+    if (!('error' in lockfile_result)) {
+        preferred_ports.push(lockfile_result.port);
+        const direct_ping = await (0, editor_transport_1.ping_editor)(lockfile_result.port, timeout_ms);
+        if (direct_ping.reachable) {
+            const resolved_config = {
+                ...lockfile_result,
+                project_path: normalized_project_path,
+                source: 'lockfile',
+            };
+            remember_editor_config(normalized_project_path, resolved_config);
+            return resolved_config;
+        }
+    }
+    if (cached_config) {
+        preferred_ports.push(cached_config.port);
+        const cached_ping = await (0, editor_transport_1.ping_editor)(cached_config.port, timeout_ms);
+        if (cached_ping.reachable) {
+            const resolved_config = {
+                ...cached_config,
+                project_path: normalized_project_path,
+                source: 'cached',
+            };
+            remember_editor_config(normalized_project_path, resolved_config);
+            return resolved_config;
+        }
+        stale_cached_port = cached_config.port;
+        forget_cached_editor_config(project_path, normalized_project_path);
+        cached_config = undefined;
+    }
+    const discovered_infos = await discover_bridge_infos(timeout_ms, preferred_ports);
+    const matching_bridge = discovered_infos.find((info) => normalize_project_path(info.project_path) === normalized_project_path);
+    if (matching_bridge) {
+        const resolved_config = {
+            port: matching_bridge.port,
+            pid: matching_bridge.pid,
+            version: matching_bridge.version,
+            project_path: matching_bridge.project_path,
+            source: 'discovered',
+        };
+        remember_editor_config(normalized_project_path, resolved_config);
+        return resolved_config;
+    }
+    const discovered_projects = discovered_infos.map((info) => `${info.project_name ?? '(unknown)'}:${info.project_path}@${info.port}`);
+    const discovered_clause = discovered_projects.length > 0
+        ? ` Reachable bridges were found for different projects: ${discovered_projects.join(', ')}.`
+        : ` No reachable bridge in ports ${BRIDGE_PORT_RANGE_START}-${BRIDGE_PORT_RANGE_END} identified project ${normalized_project_path}.`;
+    const stale_cache_clause = stale_cached_port !== undefined
+        ? ` Cached bridge port ${stale_cached_port} was also unreachable.`
+        : '';
+    const port_hint = ' Use --port <n> only if you need to target a specific bridge manually.';
+    if (!('error' in lockfile_result)) {
+        return {
+            error: `Editor bridge lockfile pointed to port ${lockfile_result.port}, but it was unreachable and autodiscovery could not find a matching Unity project bridge.${stale_cache_clause}${discovered_clause}${port_hint}`,
+        };
+    }
+    return {
+        error: `${lockfile_result.error} Autodiscovery could not find a matching Unity project bridge.${stale_cache_clause}${discovered_clause}${port_hint}`,
+    };
+}
+/**
+ * Read bridge identity directly from a known port.
+ */
+async function read_bridge_info(port, timeout_ms) {
+    const response = await (0, editor_transport_1.request_editor_at_port)({
+        port,
+        method: 'editor.bridge.getInfo',
+        timeout: timeout_ms,
+    });
+    if (response.error) {
+        return null;
+    }
+    return parse_bridge_info(response.result, port);
+}
+/**
+ * Discover bridge identities by probing the known editor bridge port range.
+ * Only bridges that can identify their owning Unity project are returned.
+ */
+async function discover_bridge_infos(timeout_ms, preferred_ports = []) {
+    const ports = new Set();
+    for (const port of preferred_ports) {
+        if (Number.isInteger(port) && port >= BRIDGE_PORT_RANGE_START && port <= BRIDGE_PORT_RANGE_END) {
+            ports.add(port);
+        }
+    }
+    for (let port = BRIDGE_PORT_RANGE_START; port <= BRIDGE_PORT_RANGE_END; port += 1) {
+        ports.add(port);
+    }
+    const results = await Promise.all([...ports].map((port) => read_bridge_info(port, timeout_ms)));
+    return results.filter((result) => result !== null);
+}
+function parse_bridge_info(result, port) {
+    if (!(0, util_1.is_record)(result)) {
+        return null;
+    }
+    const project_path = typeof result.project_path === 'string' ? result.project_path : null;
+    if (!project_path) {
+        return null;
+    }
+    return {
+        port,
+        pid: typeof result.pid === 'number' ? result.pid : 0,
+        version: typeof result.version === 'string' ? result.version : 'unknown',
+        project_path,
+        ...(typeof result.project_name === 'string' ? { project_name: result.project_name } : {}),
+        ...(typeof result.unity_version === 'string' ? { unity_version: result.unity_version } : {}),
+    };
+}
+function remember_editor_config(project_path, config) {
+    const cached_config = {
+        port: config.port,
+        pid: config.pid,
+        version: config.version,
+        project_path: config.project_path ?? project_path,
+        source: config.source,
+    };
+    LAST_KNOWN_EDITOR_CONFIGS.set(project_path, cached_config);
+    write_cached_editor_config(project_path, cached_config);
+}
+function forget_cached_editor_config(project_path, normalized_project_path) {
+    LAST_KNOWN_EDITOR_CONFIGS.delete(normalized_project_path);
+    const config_path = (0, path_1.join)(project_path, '.unity-agentic', LAST_KNOWN_CONFIG_FILE);
+    try {
+        if ((0, fs_1.existsSync)(config_path)) {
+            (0, fs_1.unlinkSync)(config_path);
+        }
+    }
+    catch {
+        // Cache cleanup is best-effort. Discovery must still proceed without it.
+    }
+}
+function read_cached_editor_config(project_path, normalized_project_path) {
+    const config_path = (0, path_1.join)(project_path, '.unity-agentic', LAST_KNOWN_CONFIG_FILE);
+    if (!(0, fs_1.existsSync)(config_path)) {
+        return undefined;
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(config_path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.port !== 'number' || typeof parsed.pid !== 'number' || typeof parsed.version !== 'string') {
+            return undefined;
+        }
+        return {
+            port: parsed.port,
+            pid: parsed.pid,
+            version: parsed.version,
+            project_path: parsed.project_path ?? normalized_project_path,
+            source: 'cached',
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function write_cached_editor_config(project_path, config) {
+    const config_dir = (0, path_1.join)(project_path, '.unity-agentic');
+    const config_path = (0, path_1.join)(config_dir, LAST_KNOWN_CONFIG_FILE);
+    try {
+        (0, fs_1.mkdirSync)(config_dir, { recursive: true });
+        (0, gitignore_1.ensure_gitignore_ignores_agentic_dir)(project_path);
+        (0, fs_1.writeFileSync)(config_path, JSON.stringify({
+            port: config.port,
+            pid: config.pid,
+            version: config.version,
+            project_path: config.project_path,
+        }, null, 2));
+    }
+    catch {
+        // Cache writes are best-effort. Discovery must still work without them.
+    }
+}
+function normalize_project_path(project_path) {
+    const resolved_path = (0, path_1.resolve)(project_path);
+    let normalized = resolved_path;
+    try {
+        normalized = typeof fs_1.realpathSync.native === 'function'
+            ? fs_1.realpathSync.native(resolved_path)
+            : (0, fs_1.realpathSync)(resolved_path);
+    }
+    catch {
+        normalized = resolved_path;
+    }
+    return process.platform === 'win32'
+        ? normalized.toLowerCase()
+        : normalized;
+}
+function is_pid_alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        if ((0, util_1.is_record)(err) && err.code === 'EPERM') {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=editor-discovery.js.map

package/dist/editor-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-discovery.js","sourceRoot":"","sources":["../src/editor-discovery.ts"],"names":[],"mappings":";;AAoBA,gDAwBC;AAOD,wDA6EC;AAhID,2BAAkG;AAClG,+BAAqC;AACrC,2CAAmE;AACnE,yDAAyE;AACzE,iCAAmC;AAMnC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AACpC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAElD,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAwB,CAAC;AAElE;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACnD,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAExE,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,8BAA8B,WAAW,kEAAkE,EAAE,CAAC;IAClI,CAAC;IAED,IAAI,MAAoB,CAAC;IACzB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACzG,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,6BAA6B,MAAM,CAAC,GAAG,oDAAoD,EAAE,CAAC;IAClH,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAAC,YAAoB,EAAE,aAAqB,GAAG;IACvF,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,aAAa,GAAG,yBAAyB,CAAC,YAAY,EAAE,uBAAuB,CAAC;WAC7E,yBAAyB,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC9D,IAAI,iBAAqC,CAAC;IAE1C,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC,EAAE,CAAC;QAChC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,WAAW,GAAG,MAAM,IAAA,8BAAW,EAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxE,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,eAAe,GAAiB;gBAClC,GAAG,eAAe;gBAClB,YAAY,EAAE,uBAAuB;gBACrC,MAAM,EAAE,UAAU;aACrB,CAAC;YACF,sBAAsB,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;YACjE,OAAO,eAAe,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAChB,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,MAAM,IAAA,8BAAW,EAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,eAAe,GAAiB;gBAClC,GAAG,aAAa;gBAChB,YAAY,EAAE,uBAAuB;gBACrC,MAAM,EAAE,QAAQ;aACnB,CAAC;YACF,sBAAsB,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;YACjE,OAAO,eAAe,CAAC;QAC3B,CAAC;QAED,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC;QACvC,2BAA2B,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;QACnE,aAAa,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAClF,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACnD,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,uBAAuB,CACxE,CAAC;IAEF,IAAI,eAAe,EAAE,CAAC;QAClB,MAAM,eAAe,GAAiB;YAClC,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,GAAG,EAAE,eAAe,CAAC,GAAG;YACxB,OAAO,EAAE,eAAe,CAAC,OAAO;YAChC,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,MAAM,EAAE,YAAY;SACvB,CAAC;QACF,sBAAsB,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;QACjE,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,WAAW,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpI,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,GAAG,CAAC;QACpD,CAAC,CAAC,yDAAyD,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC5F,CAAC,CAAC,iCAAiC,uBAAuB,IAAI,qBAAqB,uBAAuB,uBAAuB,GAAG,CAAC;IACzI,MAAM,kBAAkB,GAAG,iBAAiB,KAAK,SAAS;QACtD,CAAC,CAAC,uBAAuB,iBAAiB,wBAAwB;QAClE,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,SAAS,GAAG,wEAAwE,CAAC;IAE3F,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO;YACH,KAAK,EAAE,0CAA0C,eAAe,CAAC,IAAI,6FAA6F,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAAE;SACzN,CAAC;IACN,CAAC;IAED,OAAO;QACH,KAAK,EAAE,GAAG,eAAe,CAAC,KAAK,iEAAiE,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAAE;KACvJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,UAAkB;IAC5D,MAAM,QAAQ,GAAG,MAAM,IAAA,yCAAsB,EAAC;QAC1C,IAAI;QACJ,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,UAAkB,EAAE,kBAA4B,EAAE;IACnF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,uBAAuB,IAAI,IAAI,IAAI,qBAAqB,EAAE,CAAC;YAC7F,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,uBAAuB,EAAE,IAAI,IAAI,qBAAqB,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAC/D,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAA8B,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAe,EAAE,IAAY;IACpD,IAAI,CAAC,IAAA,gBAAS,EAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,IAAI;QACJ,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACxE,YAAY;QACZ,GAAG,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,GAAG,CAAC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACN,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB,EAAE,MAAoB;IACtE,MAAM,aAAa,GAAiB;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,YAAY;QACjD,MAAM,EAAE,MAAM,CAAC,MAAM;KACxB,CAAC;IAEF,yBAAyB,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC3D,0BAA0B,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,2BAA2B,CAAC,YAAoB,EAAE,uBAA+B;IACtF,yBAAyB,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;IACjF,IAAI,CAAC;QACD,IAAI,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;YAC1B,IAAA,eAAU,EAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,yEAAyE;IAC7E,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,YAAoB,EAAE,uBAA+B;IACpF,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;IACjF,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;QAC/C,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1G,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO;YACH,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,uBAAuB;YAC5D,MAAM,EAAE,QAAQ;SACnB,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,YAAoB,EAAE,MAAoB;IAC1E,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAE7D,IAAI,CAAC;QACD,IAAA,cAAS,EAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAA,gDAAoC,EAAC,YAAY,CAAC,CAAC;QACnD,IAAA,kBAAa,EAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;YACtC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;SACpC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACL,wEAAwE;IAC5E,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB;IAChD,MAAM,aAAa,GAAG,IAAA,cAAO,EAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,CAAC;QACD,UAAU,GAAG,OAAO,iBAAY,CAAC,MAAM,KAAK,UAAU;YAClD,CAAC,CAAC,iBAAY,CAAC,MAAM,CAAC,aAAa,CAAC;YACpC,CAAC,CAAC,IAAA,iBAAY,EAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,UAAU,GAAG,aAAa,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC/B,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;QAC1B,CAAC,CAAC,UAAU,CAAC;AACrB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC7B,IAAI,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,IAAA,gBAAS,EAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/editor-transport.d.ts

@@ -0,0 +1,30 @@
+import type { RpcResponse } from './types';
+/**
+ * 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.
+ */
+export declare const DEFAULT_EDITOR_REQUEST_TIMEOUT_MS = 10000;
+export interface EditorPortRequestOptions {
+    port: number;
+    method: string;
+    params?: Record<string, unknown>;
+    timeout: number;
+    no_wait?: boolean;
+}
+export interface EditorPingResult {
+    reachable: boolean;
+    error?: string;
+}
+/**
+ * Send a JSON-RPC request directly to a known editor bridge port.
+ */
+export declare function request_editor_at_port(options: EditorPortRequestOptions): Promise<RpcResponse>;
+/**
+ * Quick connectivity check: attempts a WebSocket handshake and immediately closes.
+ * Returns whether the bridge is reachable within the timeout.
+ */
+export declare function ping_editor(port: number, timeout_ms?: number): Promise<EditorPingResult>;
+export declare function generate_editor_request_id(): string;
+//# sourceMappingURL=editor-transport.d.ts.map

package/dist/editor-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-transport.d.ts","sourceRoot":"","sources":["../src/editor-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAER,WAAW,EACd,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,QAAQ,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoGpG;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBpG;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}

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/index.d.ts

@@ -0,0 +1,4 @@
+export { cleanup } from './cleanup';
+export { atomicWrite, generateGuid, find_unity_project_root } from './utils';
+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,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAG7E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}