unity-agentic-tools 0.6.1 → 0.7.0

package/README.md

@@ -14,6 +14,8 @@ unity-agentic-tools stream console -p /path/to/UnityProject
 unity-agentic-tools cleanup -p /path/to/UnityProject
 ```
 
+By default, `install` writes the GitHub package URL. For local bridge package development, use `unity-agentic-tools install --local [path]`; existing `file:` dependencies are preserved unless `unity-agentic-tools install --remote` is passed.
+
 ## Command Surface
 
 The CLI intentionally exposes seven broad commands:
@@ -26,10 +28,18 @@ The CLI intentionally exposes seven broad commands:
 | `install` | Install the Unity bridge package |
 | `uninstall` | Remove the Unity bridge package |
 | `cleanup` | Remove stale bridge state or rebuildable `.unity-agentic` caches |
-| `status` | Check command runner and bridge reachability |
+| `status` | Check command runner and bridge reachability, and what the Editor is busy with |
 
 There are no hidden local serialized-file mutation commands or editor APIs.
 
+## Domain Reloads
+
+Script edits and entering play mode reload Unity's domain, which takes the bridge down for seconds at a time. Read commands and `play.enter`/`play.exit` wait that window out automatically — up to 30s, and only while the Unity process is still alive — so expect a slow call rather than a failure. `stream` reconnects on the same budget and reports `Stream lost: ...` if it cannot.
+
+Mutating commands are deliberately not retried across a reload: the request may already be executing on Unity's main thread, and replaying it could apply it twice. Treat `Editor invoke was interrupted by a server transition ...` as "result unknown", check the side effects, then decide whether to re-run.
+
+`play.enter` and `play.exit` report the state at the moment they return, not the requested one — `requested` names the intent, `state` and `isPlaying` are queried live. Gate on `play.state`.
+
 ## Examples
 
 ```bash
@@ -43,7 +53,13 @@ unity-agentic-tools stream console --type Error -p <project>
 unity-agentic-tools cleanup --cache -p <project>
 ```
 
-Use `--args '<json array>'` when an argument itself is structured JSON.
+Structured arguments go positionally in single quotes — the CLI encodes the outer JSON array itself:
+
+```bash
+unity-agentic-tools run update.batch Assets/Scenes/Main.unity '[{"gameObjectPath":"Player","propertyPath":"m_Name","value":"Hero"}]' -p <project>
+```
+
+`--args '<json array>'` sends the same payload with the escaping done by hand. Reach for it only when an argument starts with `-`, which the option parser would otherwise claim.
 
 ## Project Commands
 

package/dist/bridge-install.d.ts

@@ -1,10 +1,15 @@
+export interface BridgeInstallOptions {
+    remote?: boolean;
+    local_package_path?: string;
+    require_local?: boolean;
+}
 interface BridgeInstallResult {
     success: true;
     action: 'added' | 'updated' | 'preserved';
     name: string;
     version: string;
 }
-export declare function install_bridge_package(project_path: string): BridgeInstallResult | {
+export declare function install_bridge_package(project_path: string, options?: BridgeInstallOptions): BridgeInstallResult | {
     error: string;
 };
 export {};

package/dist/bridge-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-install.d.ts","sourceRoot":"","sources":["../src/bridge-install.ts"],"names":[],"mappings":"AAKA,UAAU,mBAAmB;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBpG"}
+{"version":3,"file":"bridge-install.d.ts","sourceRoot":"","sources":["../src/bridge-install.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,mBAAmB;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACnC,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAuBzC"}

package/dist/bridge-install.js

@@ -1,16 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.install_bridge_package = install_bridge_package;
+const fs_1 = require("fs");
+const path_1 = require("path");
 const packages_1 = require("./packages");
 const BRIDGE_PACKAGE_NAME = 'com.unity-agentic-tools.editor-bridge';
-const BRIDGE_PACKAGE_VERSION = 'https://github.com/taconotsandwich/unity-agentic-tools.git?path=unity-package';
-function install_bridge_package(project_path) {
+const REMOTE_BRIDGE_PACKAGE_VERSION = 'https://github.com/taconotsandwich/unity-agentic-tools.git?path=unity-package';
+function install_bridge_package(project_path, options = {}) {
+    const target = resolve_bridge_package_target(options);
+    if ('error' in target) {
+        return target;
+    }
     const manifest_result = (0, packages_1.load_manifest)(project_path);
     if ('error' in manifest_result) {
         return manifest_result;
     }
     const existing_version = manifest_result.manifest.dependencies[BRIDGE_PACKAGE_NAME];
-    if (typeof existing_version === 'string' && existing_version.startsWith('file:')) {
+    const should_preserve_existing_file = !options.remote && !options.local_package_path && !options.require_local;
+    if (should_preserve_existing_file && typeof existing_version === 'string' && existing_version.startsWith('file:')) {
         return {
             success: true,
             action: 'preserved',
@@ -18,6 +25,70 @@ function install_bridge_package(project_path) {
             version: existing_version,
         };
     }
-    return (0, packages_1.add_package)(project_path, BRIDGE_PACKAGE_NAME, BRIDGE_PACKAGE_VERSION);
+    return (0, packages_1.add_package)(project_path, BRIDGE_PACKAGE_NAME, target.version);
+}
+function resolve_bridge_package_target(options) {
+    if (options.remote && (options.local_package_path || options.require_local)) {
+        return { error: 'Use either --local or --remote, not both.' };
+    }
+    if (options.remote) {
+        return { version: REMOTE_BRIDGE_PACKAGE_VERSION };
+    }
+    if (options.local_package_path) {
+        const local_path = (0, path_1.resolve)(options.local_package_path);
+        return local_package_target(local_path);
+    }
+    if (options.require_local) {
+        const detected_path = detect_local_bridge_package_path();
+        if (detected_path) {
+            return local_package_target(detected_path);
+        }
+        return {
+            error: 'Local bridge package could not be auto-detected. Pass --local <path-to-unity-package> or run from a source checkout.',
+        };
+    }
+    return { version: REMOTE_BRIDGE_PACKAGE_VERSION };
+}
+function detect_local_bridge_package_path() {
+    const candidate = (0, path_1.resolve)(__dirname, '..', '..', 'unity-package');
+    return is_bridge_package(candidate) ? candidate : undefined;
+}
+function local_package_target(package_path) {
+    const normalized_path = normalize_local_bridge_package_path(package_path);
+    if (!normalized_path) {
+        return {
+            error: `Local bridge package not found at ${package_path}. Expected package.json with name "${BRIDGE_PACKAGE_NAME}".`,
+        };
+    }
+    return { version: to_file_dependency(normalized_path) };
+}
+function normalize_local_bridge_package_path(package_path) {
+    if (is_bridge_package(package_path)) {
+        return package_path;
+    }
+    const nested_package_path = (0, path_1.join)(package_path, 'unity-package');
+    if (is_bridge_package(nested_package_path)) {
+        return nested_package_path;
+    }
+    return undefined;
+}
+function is_bridge_package(package_path) {
+    const package_json_path = (0, path_1.join)(package_path, 'package.json');
+    if (!(0, fs_1.existsSync)(package_json_path)) {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(package_json_path, 'utf-8'));
+        return is_record(parsed) && parsed.name === BRIDGE_PACKAGE_NAME;
+    }
+    catch {
+        return false;
+    }
+}
+function is_record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function to_file_dependency(package_path) {
+    return `file:${package_path.replace(/\\/g, '/')}`;
 }
 //# sourceMappingURL=bridge-install.js.map

package/dist/bridge-install.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-install.js","sourceRoot":"","sources":["../src/bridge-install.ts"],"names":[],"mappings":";;AAYA,wDAiBC;AA7BD,yCAAwD;AAExD,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AACpE,MAAM,sBAAsB,GAAG,+EAA+E,CAAC;AAS/G,SAAgB,sBAAsB,CAAC,YAAoB;IACvD,MAAM,eAAe,GAAG,IAAA,wBAAa,EAAC,YAAY,CAAC,CAAC;IACpD,IAAI,OAAO,IAAI,eAAe,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACpF,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,gBAAgB;SAC5B,CAAC;IACN,CAAC;IAED,OAAO,IAAA,sBAAW,EAAC,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"bridge-install.js","sourceRoot":"","sources":["../src/bridge-install.ts"],"names":[],"mappings":"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"}