unity-agentic-tools 0.5.0 → 0.6.1

package/dist/types.d.ts

@@ -0,0 +1,390 @@
+export interface GameObject {
+    name: string;
+    file_id: string;
+    active: boolean;
+    tag?: string;
+    layer?: number;
+    component_count?: number;
+    components?: Component[];
+    match_score?: number;
+}
+export interface GameObjectWithComponents {
+    name: string;
+    file_id: string;
+    active: boolean;
+    tag?: string;
+    layer?: number;
+    component_count?: number;
+    components: Component[];
+    match_score?: number;
+}
+export interface Component {
+    type: string;
+    class_id: number;
+    file_id: string;
+    script_path?: string;
+    script_guid?: string;
+    script_name?: string;
+    properties?: Record<string, unknown>;
+}
+export interface GameObjectDetail {
+    name: string;
+    file_id: string;
+    active: boolean;
+    tag: string;
+    layer: number;
+    depth?: number;
+    components: Component[];
+    children?: string[];
+    parent_transform_id?: string | null;
+    is_error?: boolean;
+    error?: string;
+    isPrefabInstance?: boolean;
+}
+export interface PrefabInstanceInfo {
+    name: string;
+    fileId: string;
+    sourceGuid: string;
+    sourcePrefab?: string;
+    modificationsCount: number;
+}
+export interface PrefabModification {
+    targetFileId: string;
+    targetGuid?: string;
+    propertyPath: string;
+    value: string;
+}
+export interface FindResult {
+    name: string;
+    fileId: string;
+    resultType: string;
+    active?: boolean;
+    matchScore?: number;
+    sourceGuid?: string;
+    sourcePrefab?: string;
+    modificationsCount?: number;
+}
+export interface SceneInspection {
+    file: string;
+    count: number;
+    gameobjects: GameObjectDetail[];
+    prefabInstances?: PrefabInstanceInfo[];
+}
+export interface InspectOptions {
+    file: string;
+    identifier?: string;
+    include_properties?: boolean;
+    verbose?: boolean;
+}
+export interface ScanOptions {
+    verbose?: boolean;
+}
+export interface PaginationOptions {
+    file: string;
+    include_properties?: boolean;
+    verbose?: boolean;
+    page_size?: number;
+    cursor?: number;
+    max_depth?: number;
+    filter_component?: string;
+}
+export interface PaginatedInspection {
+    file: string;
+    total: number;
+    totalInScene: number;
+    cursor: number;
+    next_cursor?: number;
+    truncated: boolean;
+    page_size: number;
+    gameobjects: GameObjectDetail[];
+    prefabInstances?: PrefabInstanceInfo[];
+    error?: string;
+    warning?: string;
+}
+export interface NativeScanner {
+    new (): NativeScannerInstance;
+}
+export interface NativeScannerInstance {
+    setProjectRoot(path: string): void;
+    scanSceneMinimal(file: string): GameObject[];
+    scanSceneWithComponents(file: string, options?: ScanOptions): GameObjectWithComponents[];
+    scanSceneMetadata(file: string): GameObjectWithComponents[];
+    findByName(file: string, pattern: string, fuzzy: boolean): FindResult[];
+    inspect(options: {
+        file: string;
+        identifier?: string;
+        includeProperties?: boolean;
+        verbose?: boolean;
+    }): GameObjectDetail | null;
+    inspectAll(file: string, includeProperties: boolean, verbose: boolean): SceneInspection;
+    inspectAllPaginated(options: {
+        file: string;
+        includeProperties?: boolean;
+        verbose?: boolean;
+        pageSize?: number;
+        cursor?: number;
+        maxDepth?: number;
+        filterComponent?: string;
+    }): PaginatedInspection;
+    readAsset(file: string, decodeMesh?: boolean): AssetObject[];
+}
+export interface AssetObject {
+    class_id: number;
+    file_id: string;
+    type_name: string;
+    name: string;
+    properties: Record<string, unknown>;
+    script_guid?: string;
+    script_path?: string;
+}
+export interface ProjectSearchOptions {
+    project_path: string;
+    name?: string;
+    exact?: boolean;
+    component?: string;
+    tag?: string;
+    layer?: number;
+    file_type?: 'scene' | 'prefab' | 'mat' | 'anim' | 'controller' | 'asset' | 'all';
+    max_matches?: number;
+}
+export interface ProjectSearchMatch {
+    file: string;
+    game_object: string;
+    file_id: string;
+    tag?: string;
+    layer?: number;
+    components?: string[];
+}
+export interface ProjectSearchResult {
+    success: boolean;
+    project_path: string;
+    total_files_scanned: number;
+    total_matches: number;
+    files_with_errors?: number;
+    cursor?: number;
+    truncated: boolean;
+    matches: ProjectSearchMatch[];
+    error?: string;
+}
+export type ProjectGrepFileType = 'cs' | 'yaml' | 'unity' | 'prefab' | 'asset' | 'mat' | 'anim' | 'controller' | 'all';
+export interface ProjectGrepOptions {
+    project_path: string;
+    pattern: string;
+    file_type?: ProjectGrepFileType;
+    max_results?: number;
+    context_lines?: number;
+}
+export interface GrepMatch {
+    file: string;
+    line_number: number;
+    line: string;
+    context_before?: string[];
+    context_after?: string[];
+}
+export interface ProjectGrepResult {
+    success: boolean;
+    project_path: string;
+    pattern: string;
+    total_files_scanned: number;
+    total_matches: number;
+    truncated: boolean;
+    matches: GrepMatch[];
+    error?: string;
+}
+export interface CSharpTypeRef {
+    /** Type name (e.g., "PlayerController") */
+    name: string;
+    /** Kind: "class", "struct", "enum", or "interface" */
+    kind: string;
+    /** Namespace (e.g., "UnityEngine.UI") */
+    namespace: string | null;
+    /** Source file or DLL path relative to project root */
+    filePath: string;
+    /** GUID from adjacent .meta file (null for DLL types) */
+    guid: string | null;
+}
+/** A serializable field extracted from a C# type. */
+export interface CSharpFieldRef {
+    /** Field name (e.g., "health", "moveSpeed") */
+    name: string;
+    /** C# type name (e.g., "int", "Vector3", "List<string>", "GameObject") */
+    typeName: string;
+    /** Whether [SerializeField] attribute is present */
+    hasSerializeField: boolean;
+    /** Whether [SerializeReference] attribute is present */
+    hasSerializeReference: boolean;
+    /** Whether the field is public */
+    isPublic: boolean;
+    /** Which type this field belongs to */
+    ownerType: string;
+}
+/** Extended type info with fields and base class, extracted on demand. */
+export interface CSharpTypeInfo {
+    /** Type name (e.g., "PlayerController") */
+    name: string;
+    /** Kind: "class", "struct", "enum", or "interface" */
+    kind: string;
+    /** Namespace (e.g., "UnityEngine.UI") */
+    namespace: string | null;
+    /** Base class (e.g., "MonoBehaviour", "ScriptableObject") */
+    baseClass: string | null;
+    /** Serializable fields */
+    fields: CSharpFieldRef[];
+}
+export interface EditorConfig {
+    port: number;
+    pid: number;
+    version: string;
+    project_path?: string;
+    source?: 'lockfile' | 'discovered' | 'cached' | 'manual';
+}
+export interface EditorBridgeInfo {
+    port: number;
+    pid: number;
+    version: string;
+    project_path: string;
+    project_name?: string;
+    unity_version?: string;
+}
+export interface CallEditorOptions {
+    project_path: string;
+    method: string;
+    params?: Record<string, unknown>;
+    timeout?: number;
+    port?: number;
+    /** Number of retry attempts for transient connection errors (default: 2) */
+    retries?: number;
+    /** Fire-and-forget: send request and return immediately without waiting for response */
+    no_wait?: boolean;
+}
+export interface StreamEditorOptions extends CallEditorOptions {
+    on_event: (event: RpcEvent) => void;
+}
+export interface RpcRequest {
+    jsonrpc: "2.0";
+    id: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface RpcResponse {
+    jsonrpc: "2.0";
+    id: string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface RpcEvent {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface EditorStatusResult {
+    port: number;
+    pid: number;
+    version: string;
+    connected: boolean;
+}
+export interface PlayModeResult {
+    state: string;
+    isPlaying?: boolean;
+    isPaused?: boolean;
+}
+export interface ConsoleLogEntry {
+    message: string;
+    stackTrace: string;
+    type: string;
+    timestamp: string;
+}
+export interface ScreenshotResult {
+    success: boolean;
+    path: string;
+    superSize?: number;
+}
+export interface TestRunResult {
+    passed: number;
+    failed: number;
+    skipped: number;
+    duration: number;
+    results: TestResult[];
+}
+export interface TestResult {
+    name: string;
+    fullName: string;
+    status: string;
+    duration: number;
+    message: string;
+}
+export interface UIElementRef {
+    ref: string;
+    type: string;
+    name: string;
+    label?: string;
+    interactable: boolean;
+    source: 'uGUI' | 'UIToolkit';
+    parentRef?: string;
+    rect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+export interface UISnapshotResult {
+    refCount: number;
+    elements: UIElementRef[];
+}
+export interface HierarchyNodeRef {
+    ref: string;
+    name: string;
+    active: boolean;
+    tag?: string;
+    layer?: string;
+    components?: string[];
+    children?: HierarchyNodeRef[];
+    childCount?: number;
+}
+export interface HierarchySnapshotResult {
+    scene: string;
+    scenePath: string;
+    refCount: number;
+    tree: HierarchyNodeRef[];
+}
+export interface InputAction {
+    map: string;
+    name: string;
+    type: string;
+    controlType: string;
+    bindings: string[];
+}
+export interface LegacyAxis {
+    name: string;
+    positiveButton?: string;
+    negativeButton?: string;
+    altPositiveButton?: string;
+    altNegativeButton?: string;
+    type: string;
+    axis?: number;
+}
+export interface InputMapResult {
+    inputSystemAvailable: boolean;
+    actions: InputAction[];
+    legacyAxes: LegacyAxis[];
+}
+export interface WaitResult {
+    success: boolean;
+    condition: string;
+    elapsed?: number;
+    error?: string;
+}
+export interface AnnotatedScreenshotResult {
+    success: boolean;
+    path: string;
+    annotated: boolean;
+    width?: number;
+    height?: number;
+    elements: UIElementRef[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util.d.ts

@@ -0,0 +1,2 @@
+export declare function is_record(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}

package/dist/util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.is_record = is_record;
+function is_record(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":";;AAAA,8BAEC;AAFD,SAAgB,SAAS,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACvD,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Walk up from startDir looking for a Unity project root.
+ * Checks for `.unity-agentic/` first, then `Assets/`.
+ */
+export declare function find_unity_project_root(startDir?: string): string | null;
+/**
+ * Resolve an explicit project path or default to the current working directory.
+ */
+export declare function resolve_project_path(project_path?: string): string;
+/**
+ * Ensure the parent directory of a file path exists, creating it recursively if needed.
+ */
+export declare function ensure_parent_dir(file_path: string): void;
+export interface AtomicWriteResult {
+    success: boolean;
+    file_path: string;
+    bytes_written?: number;
+    error?: string;
+}
+/**
+ * Atomic write: write to temp file, then rename to prevent partial writes.
+ * Uses randomized temp file names to prevent collisions from concurrent writes.
+ * Handles ENOENT gracefully for TOCTOU races (e.g., Unity AssetDatabase deleting files).
+ */
+export declare function atomicWrite(filePath: string, content: string): AtomicWriteResult;
+/**
+ * Normalize property path: convert dot-notation array indices to bracket notation.
+ * e.g. "m_Materials.Array.data.0" -> "m_Materials.Array.data[0]"
+ * This provides a shell-safe alternative to bracket syntax which triggers glob expansion in zsh.
+ */
+export declare function normalize_property_path(path: string): string;
+/**
+ * Check if a pattern matches everything (wildcard-all).
+ * Patterns like "*", ".", "**" mean "all objects" — not a real filter.
+ */
+export declare function is_match_all(pattern: string): boolean;
+/**
+ * Match a string against a glob pattern (* and ? wildcards) or exact equality.
+ * Case-insensitive. If the pattern has no glob chars, does exact equality.
+ */
+export declare function glob_match(pattern: string, text: string): boolean;
+/**
+ * Convert a glob pattern to a RegExp for matching against file paths.
+ * Handles ** (match across directories), * (match within one segment), ? (single char).
+ * Without wildcards, performs case-insensitive substring match.
+ * Unlike glob_match, this is designed for path filtering (no anchoring, path-aware).
+ */
+export declare function path_glob_to_regex(pattern: string): RegExp;
+/**
+ * Validate a name (GameObject, tag, etc.) for characters that are illegal in Unity.
+ * Returns an error string if invalid, or null if the name is acceptable.
+ */
+export declare function validate_name(name: string, label: string): string | null;
+/**
+ * Generate a new GUID (32 hex characters).
+ */
+export declare function generateGuid(): string;
+/**
+ * Validate that a file path is safe for Unity operations.
+ * Rejects file:// URIs, path traversal, and Packages/ writes.
+ * Note: Absolute paths ARE allowed (this is a CLI tool, not a web API).
+ *
+ * @param file_path - The file path to validate
+ * @param operation - Whether this is a 'read' or 'write' operation
+ * @returns Error message if invalid, null if valid
+ */
+export declare function validate_file_path(file_path: string, operation: 'read' | 'write'): string | null;
+/**
+ * Validate Vector3 structure for Unity YAML.
+ *
+ * @param value - The value to validate as Vector3
+ * @returns Error message if invalid, null if valid
+ */
+export declare function validate_vector3(value: unknown): string | null;
+/**
+ * Validate GUID format (32-character hex string).
+ *
+ * @param guid - The GUID to validate
+ * @returns Error message if invalid, null if valid
+ */
+export declare function validate_guid(guid: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAoEhF;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBxE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAOrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAwChG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAe9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzD"}