unity-agentic-tools 0.5.0 → 0.6.1

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,UAAU;AACV,qCAOmB;AANf,uGAAA,YAAY,OAAA;AACZ,kHAAA,uBAAuB,OAAA;AACvB,+GAAA,oBAAoB,OAAA;AACpB,sHAAA,2BAA2B,OAAA;AAC3B,mHAAA,wBAAwB,OAAA;AACxB,qHAAA,0BAA0B,OAAA;AAG9B,kBAAkB;AAClB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,mDAAoF;AAA3E,gHAAA,cAAc,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAEzD,QAAQ;AACR,iCAA6E;AAApE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,gHAAA,uBAAuB,OAAA"}

package/dist/loaded-protection.d.ts

@@ -0,0 +1,6 @@
+export declare function is_editor_connected_for_project(project_path: string): Promise<boolean>;
+export declare function enforce_loaded_edit_protection(file_path: string, bypass: boolean | undefined, project_path?: string): Promise<{
+    allowed: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=loaded-protection.d.ts.map

package/dist/loaded-protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-protection.d.ts","sourceRoot":"","sources":["../src/loaded-protection.ts"],"names":[],"mappings":"AAyDA,wBAAsB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5F;AAED,wBAAsB,8BAA8B,CAChD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgD/C"}

package/dist/loaded-protection.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.is_editor_connected_for_project = is_editor_connected_for_project;
+exports.enforce_loaded_edit_protection = enforce_loaded_edit_protection;
+const path_1 = require("path");
+const editor_client_1 = require("./editor-client");
+const utils_1 = require("./utils");
+function normalize_slashes(value) {
+    return value.replace(/\\/g, '/');
+}
+function to_project_asset_path(file_path, project_path) {
+    const abs_file = (0, path_1.resolve)(file_path);
+    const abs_project = (0, path_1.resolve)(project_path);
+    const rel = (0, path_1.relative)(abs_project, abs_file);
+    if (!rel || rel.startsWith('..') || rel.includes(`..${path_1.sep}`)) {
+        if (/^Assets[\\/]/.test(file_path)) {
+            return normalize_slashes(file_path);
+        }
+        return null;
+    }
+    return normalize_slashes(rel);
+}
+function normalize_loaded_paths(paths) {
+    return new Set(paths.map(p => normalize_slashes(p)));
+}
+async function get_loaded_state(project_path) {
+    const config = await (0, editor_client_1.discover_editor_config)(project_path);
+    if ('error' in config)
+        return null;
+    const response = await (0, editor_client_1.call_editor)({
+        project_path,
+        method: 'editor.scene.loaded',
+        timeout: 2500,
+    });
+    if (response.error || !response.result || typeof response.result !== 'object') {
+        return null;
+    }
+    const result = response.result;
+    const loaded = Array.isArray(result.loaded_scene_paths)
+        ? result.loaded_scene_paths.filter((v) => typeof v === 'string')
+        : [];
+    return {
+        loaded_scene_paths: loaded,
+        active_scene_path: typeof result.active_scene_path === 'string' ? result.active_scene_path : undefined,
+        prefab_stage_path: typeof result.prefab_stage_path === 'string' ? result.prefab_stage_path : undefined,
+    };
+}
+async function is_editor_connected_for_project(project_path) {
+    const resolved_project = (0, utils_1.resolve_project_path)(project_path);
+    const config = await (0, editor_client_1.discover_editor_config)(resolved_project);
+    return !('error' in config);
+}
+async function enforce_loaded_edit_protection(file_path, bypass, project_path) {
+    if (bypass)
+        return { allowed: true };
+    const ext = file_path.toLowerCase().split('.').pop();
+    if (!ext || (ext !== 'unity' && ext !== 'prefab')) {
+        return { allowed: true };
+    }
+    const inferred_project = project_path
+        ? (0, utils_1.resolve_project_path)(project_path)
+        : (0, utils_1.find_unity_project_root)((0, path_1.dirname)((0, path_1.resolve)(file_path))) || process.cwd();
+    const loaded_state = await get_loaded_state(inferred_project);
+    if (!loaded_state) {
+        return { allowed: true };
+    }
+    const target_asset_path = to_project_asset_path(file_path, inferred_project);
+    if (!target_asset_path) {
+        return { allowed: true };
+    }
+    const loaded_scenes = normalize_loaded_paths(loaded_state.loaded_scene_paths);
+    const active_scene = loaded_state.active_scene_path ? normalize_slashes(loaded_state.active_scene_path) : '';
+    const prefab_stage = loaded_state.prefab_stage_path ? normalize_slashes(loaded_state.prefab_stage_path) : '';
+    if (target_asset_path.endsWith('.unity')) {
+        if (loaded_scenes.has(target_asset_path)) {
+            const reason = active_scene === target_asset_path
+                ? 'it is currently the active scene in the Unity Editor'
+                : 'it is currently loaded in the Unity Editor';
+            return {
+                allowed: false,
+                error: `Refusing to edit ${target_asset_path}: ${reason}. Use --bypass-loaded-protection to force file-based edits while editor is connected.`,
+            };
+        }
+    }
+    if (target_asset_path.endsWith('.prefab')) {
+        if (prefab_stage === target_asset_path) {
+            return {
+                allowed: false,
+                error: `Refusing to edit ${target_asset_path}: it is currently open in Prefab Mode. Use --bypass-loaded-protection to force file-based edits while editor is connected.`,
+            };
+        }
+    }
+    return { allowed: true };
+}
+//# sourceMappingURL=loaded-protection.js.map

package/dist/loaded-protection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-protection.js","sourceRoot":"","sources":["../src/loaded-protection.ts"],"names":[],"mappings":";;AAyDA,0EAIC;AAED,wEAoDC;AAnHD,+BAAuD;AACvD,mDAAsE;AACtE,mCAAwE;AAQxE,SAAS,iBAAiB,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB,EAAE,YAAoB;IAClE,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,SAAS,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAA,eAAQ,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,UAAG,EAAE,CAAC,EAAE,CAAC;QAC3D,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAe;IAC3C,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IAChD,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAsB,EAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAW,EAAC;QAC/B,YAAY;QACZ,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAiC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAC7E,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACH,kBAAkB,EAAE,MAAM;QAC1B,iBAAiB,EAAE,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;QACtG,iBAAiB,EAAE,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;KACzG,CAAC;AACN,CAAC;AAEM,KAAK,UAAU,+BAA+B,CAAC,YAAoB;IACtE,MAAM,gBAAgB,GAAG,IAAA,4BAAoB,EAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAsB,EAAC,gBAAgB,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;AAChC,CAAC;AAEM,KAAK,UAAU,8BAA8B,CAChD,SAAiB,EACjB,MAA2B,EAC3B,YAAqB;IAErB,IAAI,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAErC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACrD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,gBAAgB,GAAG,YAAY;QACjC,CAAC,CAAC,IAAA,4BAAoB,EAAC,YAAY,CAAC;QACpC,CAAC,CAAC,IAAA,+BAAuB,EAAC,IAAA,cAAO,EAAC,IAAA,cAAO,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5E,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC7E,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,aAAa,GAAG,sBAAsB,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7G,MAAM,YAAY,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7G,IAAI,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,IAAI,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,YAAY,KAAK,iBAAiB;gBAC7C,CAAC,CAAC,sDAAsD;gBACxD,CAAC,CAAC,4CAA4C,CAAC;YACnD,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,oBAAoB,iBAAiB,KAAK,MAAM,uFAAuF;aACjJ,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,IAAI,YAAY,KAAK,iBAAiB,EAAE,CAAC;YACrC,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,oBAAoB,iBAAiB,4HAA4H;aAC3K,CAAC;QACN,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/packages.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Structure of Unity's Packages/manifest.json
+ */
+interface PackageManifest {
+    dependencies: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Load and validate a Unity package manifest.
+ * @returns The parsed manifest or an error string.
+ */
+export declare function load_manifest(project_path: string): {
+    manifest: PackageManifest;
+    path: string;
+} | {
+    error: string;
+};
+/**
+ * Save a manifest to disk preserving original key order, with 2-space indent.
+ */
+export declare function save_manifest(manifest_path: string, manifest: PackageManifest): void;
+/**
+ * List packages from the manifest, optionally filtering by search pattern.
+ */
+export declare function list_packages(project_path: string, search?: string): {
+    packages: {
+        name: string;
+        version: string;
+    }[];
+    count: number;
+} | {
+    error: string;
+};
+/**
+ * Add or update a package in the manifest.
+ */
+export declare function add_package(project_path: string, name: string, version: string): {
+    success: true;
+    action: 'added' | 'updated';
+    name: string;
+    version: string;
+} | {
+    error: string;
+};
+/**
+ * Remove a package from the manifest.
+ */
+export declare function remove_package(project_path: string, name: string): {
+    success: true;
+    name: string;
+} | {
+    error: string;
+};
+export {};
+//# sourceMappingURL=packages.d.ts.map

package/dist/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../src/packages.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,UAAU,eAAe;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAenH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEpF;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAYtF;AAgBD;;GAEG;AACH,wBAAgB,WAAW,CACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAYrD"}

package/dist/packages.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.load_manifest = load_manifest;
+exports.save_manifest = save_manifest;
+exports.list_packages = list_packages;
+exports.add_package = add_package;
+exports.remove_package = remove_package;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Load and validate a Unity package manifest.
+ * @returns The parsed manifest or an error string.
+ */
+function load_manifest(project_path) {
+    const manifest_path = (0, path_1.join)(project_path, 'Packages', 'manifest.json');
+    if (!(0, fs_1.existsSync)(manifest_path)) {
+        return { error: `manifest.json not found at ${manifest_path}` };
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(manifest_path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed.dependencies || typeof parsed.dependencies !== 'object') {
+            return { error: `Invalid manifest.json: missing "dependencies" object` };
+        }
+        return { manifest: parsed, path: manifest_path };
+    }
+    catch (err) {
+        return { error: `Failed to parse manifest.json: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/**
+ * Save a manifest to disk preserving original key order, with 2-space indent.
+ */
+function save_manifest(manifest_path, manifest) {
+    (0, fs_1.writeFileSync)(manifest_path, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+}
+/**
+ * List packages from the manifest, optionally filtering by search pattern.
+ */
+function list_packages(project_path, search) {
+    const result = load_manifest(project_path);
+    if ('error' in result)
+        return result;
+    let entries = Object.entries(result.manifest.dependencies).map(([name, version]) => ({ name, version }));
+    if (search) {
+        const pattern = search.toLowerCase();
+        entries = entries.filter(e => e.name.toLowerCase().includes(pattern));
+    }
+    return { packages: entries, count: entries.length };
+}
+/**
+ * Validate a package version string.
+ * Accepts semver (1.2.3, 1.2.3-preview.1), git URLs, file: paths, and Unity version aliases.
+ */
+function validate_version(version) {
+    // semver: 1.0.0, 1.2.3-preview.4, 0.1.0-exp.1
+    if (/^\d+\.\d+\.\d+(-[\w.]+)?$/.test(version))
+        return true;
+    // git URL
+    if (version.startsWith('https://') || version.startsWith('git://') || version.startsWith('ssh://'))
+        return true;
+    // file: path
+    if (version.startsWith('file:'))
+        return true;
+    return false;
+}
+/**
+ * Add or update a package in the manifest.
+ */
+function add_package(project_path, name, version) {
+    if (!name || name.trim() === '') {
+        return { error: 'Package name must not be empty' };
+    }
+    if (/\s/.test(name)) {
+        return { error: `Invalid package name "${name}". Package names must not contain spaces.` };
+    }
+    if (!validate_version(version)) {
+        return { error: `Invalid version "${version}". Expected semver (e.g., 1.2.3), git URL, or file: path.` };
+    }
+    const result = load_manifest(project_path);
+    if ('error' in result)
+        return result;
+    const action = result.manifest.dependencies[name] ? 'updated' : 'added';
+    result.manifest.dependencies[name] = version;
+    save_manifest(result.path, result.manifest);
+    return { success: true, action, name, version };
+}
+/**
+ * Remove a package from the manifest.
+ */
+function remove_package(project_path, name) {
+    const result = load_manifest(project_path);
+    if ('error' in result)
+        return result;
+    if (!(name in result.manifest.dependencies)) {
+        return { error: `Package "${name}" not found in manifest` };
+    }
+    delete result.manifest.dependencies[name];
+    save_manifest(result.path, result.manifest);
+    return { success: true, name };
+}
+//# sourceMappingURL=packages.js.map

package/dist/packages.js.map

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

package/dist/params.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Parameter normalization utility for handling LLM-generated parameter inconsistencies.
+ * Provides bidirectional snake_case/camelCase fallback inspired by CoPlay's ToolParams.
+ */
+export declare class ParamNormalizer {
+    private params;
+    constructor(params: Record<string, unknown>);
+    /**
+     * Get parameter with case-insensitive fallback.
+     * Tries exact match first, then opposite case.
+     */
+    get<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * Get required parameter or throw descriptive error.
+     */
+    getRequired<T = unknown>(key: string, errorMsg?: string): T;
+    /**
+     * Get boolean with string coercion ("true" -> true).
+     */
+    getBool(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Get integer with string parsing and validation.
+     */
+    getInt(key: string, defaultValue?: number): number | undefined;
+    /**
+     * Check if parameter exists (with case fallback).
+     */
+    has(key: string): boolean;
+    /**
+     * Get raw value (for objects/arrays) with case fallback.
+     */
+    getRaw(key: string): unknown;
+    private toOppositeCase;
+}
+/**
+ * Result type for parameter validation operations.
+ */
+export declare class Result<T> {
+    readonly isSuccess: boolean;
+    readonly value: T | null;
+    readonly errorMessage: string | null;
+    constructor(isSuccess: boolean, value: T | null, errorMessage: string | null);
+    static Success<T>(value: T): Result<T>;
+    static Error<T>(message: string): Result<T>;
+    /**
+     * Extract value or return error response object.
+     */
+    getOrError(outValue: {
+        value?: T;
+    }): {
+        error: string;
+    } | null;
+}
+//# sourceMappingURL=params.d.ts.map

package/dist/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3C;;;OAGG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAS9D;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC;IAQ3D;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO;IAOnD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO9D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,OAAO,CAAC,cAAc;CASzB;AAED;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC;aAEG,SAAS,EAAE,OAAO;aAClB,KAAK,EAAE,CAAC,GAAG,IAAI;aACf,YAAY,EAAE,MAAM,GAAG,IAAI;gBAF3B,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,CAAC,GAAG,IAAI,EACf,YAAY,EAAE,MAAM,GAAG,IAAI;IAG/C,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAItC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAI3C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAOhE"}

package/dist/params.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Parameter normalization utility for handling LLM-generated parameter inconsistencies.
+ * Provides bidirectional snake_case/camelCase fallback inspired by CoPlay's ToolParams.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Result = exports.ParamNormalizer = void 0;
+class ParamNormalizer {
+    constructor(params) {
+        this.params = params || {};
+    }
+    /**
+     * Get parameter with case-insensitive fallback.
+     * Tries exact match first, then opposite case.
+     */
+    get(key, defaultValue) {
+        if (key in this.params)
+            return this.params[key];
+        const alt = this.toOppositeCase(key);
+        if (alt in this.params)
+            return this.params[alt];
+        return defaultValue;
+    }
+    /**
+     * Get required parameter or throw descriptive error.
+     */
+    getRequired(key, errorMsg) {
+        const value = this.get(key);
+        if (value === undefined || value === null || value === '') {
+            throw new Error(errorMsg || `Required parameter '${key}' is missing`);
+        }
+        return value;
+    }
+    /**
+     * Get boolean with string coercion ("true" -> true).
+     */
+    getBool(key, defaultValue = false) {
+        const value = this.get(key);
+        if (value === undefined || value === null)
+            return defaultValue;
+        if (typeof value === 'boolean')
+            return value;
+        return String(value).toLowerCase() === 'true';
+    }
+    /**
+     * Get integer with string parsing and validation.
+     */
+    getInt(key, defaultValue) {
+        const value = this.get(key);
+        if (value === undefined || value === null)
+            return defaultValue;
+        const parsed = parseInt(String(value), 10);
+        return isNaN(parsed) ? defaultValue : parsed;
+    }
+    /**
+     * Check if parameter exists (with case fallback).
+     */
+    has(key) {
+        return key in this.params || this.toOppositeCase(key) in this.params;
+    }
+    /**
+     * Get raw value (for objects/arrays) with case fallback.
+     */
+    getRaw(key) {
+        return this.get(key);
+    }
+    toOppositeCase(str) {
+        if (str.includes('_')) {
+            // snake_case -> camelCase
+            return str.replace(/_([a-z])/gi, (_, c) => c.toUpperCase());
+        }
+        else {
+            // camelCase -> snake_case
+            return str.replace(/([A-Z])/g, (match) => '_' + match.toLowerCase());
+        }
+    }
+}
+exports.ParamNormalizer = ParamNormalizer;
+/**
+ * Result type for parameter validation operations.
+ */
+class Result {
+    constructor(isSuccess, value, errorMessage) {
+        this.isSuccess = isSuccess;
+        this.value = value;
+        this.errorMessage = errorMessage;
+    }
+    static Success(value) {
+        return new Result(true, value, null);
+    }
+    static Error(message) {
+        return new Result(false, null, message);
+    }
+    /**
+     * Extract value or return error response object.
+     */
+    getOrError(outValue) {
+        if (this.isSuccess && this.value !== null) {
+            outValue.value = this.value;
+            return null;
+        }
+        return { error: this.errorMessage || 'Unknown error' };
+    }
+}
+exports.Result = Result;
+//# sourceMappingURL=params.js.map

package/dist/params.js.map

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

package/dist/project-search.d.ts

@@ -0,0 +1,16 @@
+import type { ProjectSearchOptions, ProjectSearchResult, ProjectGrepOptions, ProjectGrepResult } from './types';
+/**
+ * Recursively walk a Unity project directory and collect files with given extensions.
+ * Uses native Rust walker when available, falls back to JS implementation.
+ */
+export declare function walk_project_files(project_path: string, extensions: string[], exclude_dirs?: string[]): string[];
+/**
+ * Search across all scene/prefab files in a Unity project for GameObjects.
+ */
+export declare function search_project(options: ProjectSearchOptions): ProjectSearchResult;
+/**
+ * Search for a regex pattern across project files.
+ * Uses native Rust grep when available, falls back to JS implementation.
+ */
+export declare function grep_project(options: ProjectGrepOptions): ProjectGrepResult;
+//# sourceMappingURL=project-search.d.ts.map

package/dist/project-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-search.d.ts","sourceRoot":"","sources":["../src/project-search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,oBAAoB,EACpB,mBAAmB,EAEnB,kBAAkB,EAClB,iBAAiB,EAMpB,MAAM,SAAS,CAAC;AAyCjB;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE,CAYV;AA+DD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAwQjF;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAmC3E"}