unity-agentic-tools 0.1.0

package/native/index.d.ts

@@ -0,0 +1,230 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** Basic GameObject information */
+export interface GameObject {
+  name: string
+  fileId: string
+  active: boolean
+  matchScore?: number | undefined
+}
+/** Component information */
+export interface Component {
+  type: string
+  classId: number
+  fileId: string
+  scriptPath?: string | undefined
+  scriptGuid?: string | undefined
+  scriptName?: string | undefined
+  properties?: Record<string, any> | undefined
+}
+/** GameObject with detailed component information */
+export interface GameObjectDetail {
+  name: string
+  fileId: string
+  active: boolean
+  tag: string
+  layer: number
+  depth?: number | undefined
+  components: Array<Component>
+  children?: string[] | undefined
+  parentTransformId?: string | undefined
+}
+/** PrefabInstance information */
+export interface PrefabInstanceInfo {
+  name: string
+  fileId: string
+  sourceGuid: string
+  sourcePrefab?: string | undefined
+  modificationsCount: number
+}
+/** A single property override in a PrefabInstance */
+export interface PrefabModification {
+  targetFileId: string
+  targetGuid?: string | undefined
+  propertyPath: string
+  value: string
+}
+/** Union result from find_by_name: either a GameObject or PrefabInstance */
+export interface FindResult {
+  name: string
+  fileId: string
+  resultType: string
+  active?: boolean | undefined
+  matchScore?: number | undefined
+  sourceGuid?: string | undefined
+  sourcePrefab?: string | undefined
+  modificationsCount?: number | undefined
+}
+/** Full scene inspection result */
+export interface SceneInspection {
+  file: string
+  count: number
+  gameobjects: Array<GameObjectDetail>
+  prefabInstances?: PrefabInstanceInfo[] | undefined
+}
+/** Options for scanning */
+export interface ScanOptions {
+  verbose?: boolean | undefined
+}
+/** Options for inspecting */
+export interface InspectOptions {
+  file: string
+  identifier?: string | undefined
+  includeProperties?: boolean | undefined
+  verbose?: boolean | undefined
+}
+/** Pagination options for inspect_all */
+export interface PaginationOptions {
+  file: string
+  includeProperties?: boolean | undefined
+  verbose?: boolean | undefined
+  pageSize?: number | undefined
+  cursor?: number | undefined
+  maxDepth?: number | undefined
+  filterComponent?: string | undefined
+}
+/** Paginated inspection result */
+export interface PaginatedInspection {
+  file: string
+  total: number
+  cursor: number
+  nextCursor?: number | undefined
+  truncated: boolean
+  pageSize: number
+  gameobjects: Array<GameObjectDetail>
+  prefabInstances?: PrefabInstanceInfo[] | undefined
+  error?: string | undefined
+}
+/** Chunk types for indexing */
+export const enum ChunkType {
+  Prose = 'Prose',
+  Code = 'Code',
+  Api = 'Api',
+  Example = 'Example'
+}
+/** Chunk metadata */
+export interface ChunkMetadata {
+  filePath: string
+  section?: string | undefined
+  language?: string | undefined
+  unityClass?: string | undefined
+  unityMethod?: string | undefined
+}
+/** A chunk of indexed content */
+export interface Chunk {
+  id: string
+  content: string
+  tokens: number
+  type: ChunkType
+  metadata: ChunkMetadata
+}
+/** Result of indexing operation */
+export interface IndexResult {
+  chunksIndexed: number
+  totalTokens: number
+  filesProcessed: number
+  elapsedMs: number
+}
+/** Search result from index */
+export interface SearchResult {
+  id: string
+  content: string
+  score: number
+  metadata: ChunkMetadata
+}
+/**
+ * Walk a Unity project and collect files matching the given extensions.
+ *
+ * Walks `Assets/` (and `ProjectSettings/` when `.asset` is among extensions).
+ * Skips standard Unity noise directories (Library, Temp, etc.).
+ */
+export declare function walkProjectFiles(projectPath: string, extensions: Array<string>, excludeDirs?: Array<string> | undefined | null): Array<string>
+export interface NapiGrepOptions {
+  projectPath: string
+  pattern: string
+  fileType?: string
+  maxResults?: number
+  contextLines?: number
+}
+export interface NapiGrepMatch {
+  file: string
+  lineNumber: number
+  line: string
+  contextBefore?: Array<string>
+  contextAfter?: Array<string>
+}
+export interface NapiGrepResult {
+  success: boolean
+  projectPath: string
+  pattern: string
+  totalFilesScanned: number
+  totalMatches: number
+  truncated: boolean
+  matches: Array<NapiGrepMatch>
+  error?: string
+}
+/** Grep across Unity project files in parallel using Rayon. */
+export declare function grepProject(options: NapiGrepOptions): NapiGrepResult
+/**
+ * Build the GUID cache by scanning all .meta files under Assets/ in parallel.
+ *
+ * Returns a JSON object mapping `{ guid: relative_asset_path }`.
+ */
+export declare function buildGuidCache(projectRoot: string): any
+/** Get the version of the native module */
+export declare function getVersion(): string
+/** Check if the native module is available */
+export declare function isNativeAvailable(): boolean
+/** High-performance Unity scene/prefab scanner */
+export declare class Scanner {
+  constructor()
+  /** Add a hierarchy provider class ID (Transform-like components). */
+  addHierarchyProvider(classId: number): void
+  /** Add a script container class ID (MonoBehaviour-like components). */
+  addScriptContainer(classId: number): void
+  /** Set project root for GUID resolution */
+  setProjectRoot(path: string): void
+  /** Scan scene for basic GameObject information */
+  scanSceneMinimal(file: string): Array<GameObject>
+  /** Scan scene with component information */
+  scanSceneWithComponents(file: string, options?: ScanOptions | undefined | null): Array<any>
+  /** Find GameObjects and PrefabInstances by name pattern */
+  findByName(file: string, pattern: string, fuzzy: boolean): Array<FindResult>
+  /** Inspect a specific GameObject */
+  inspect(options: InspectOptions): any | null
+  /** Inspect entire file */
+  inspectAll(file: string, includeProperties: boolean, verbose: boolean): SceneInspection
+  /** Inspect entire file with pagination support */
+  inspectAllPaginated(options: PaginationOptions): PaginatedInspection
+  /** Read a .asset file and return its root objects with properties */
+  readAsset(file: string): any
+}
+/** High-performance documentation indexer */
+export declare class Indexer {
+  constructor()
+  /** Index a single file */
+  indexFile(path: string): IndexResult
+  /** Index a directory of files */
+  indexDirectory(path: string): IndexResult
+  /** Search the index */
+  search(query: string): Array<SearchResult>
+  /** Clear the index */
+  clear(): void
+  /** Get index statistics */
+  stats(): any
+}
+/**
+ * Local CPU embedding generator using all-MiniLM-L6-v2 (384 dims).
+ * Wraps fastembed-rs / ONNX Runtime. Model auto-downloads on first use
+ * and is cached at ~/.claude/unity-agentic-tools/models/.
+ */
+export declare class EmbeddingGenerator {
+  constructor()
+  /** Generate embedding for a single text. Returns a Vec<f64> (384 dims). */
+  generate(text: string): Array<number>
+  /** Generate embeddings for a batch of texts. Returns Vec<Vec<f64>>. */
+  generateBatch(texts: Array<string>): Array<Array<number>>
+}

package/native/index.js

@@ -0,0 +1,323 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'unity-file-tools.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.android-arm64.node')
+          } else {
+            nativeBinding = require('unity-file-tools-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'unity-file-tools.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('unity-file-tools-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'unity-file-tools.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('unity-file-tools-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'unity-file-tools.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('unity-file-tools-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'unity-file-tools.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('unity-file-tools-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'unity-file-tools.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./unity-file-tools.darwin-universal.node')
+      } else {
+        nativeBinding = require('unity-file-tools-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'unity-file-tools.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.darwin-x64.node')
+          } else {
+            nativeBinding = require('unity-file-tools-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'unity-file-tools.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.darwin-arm64.node')
+          } else {
+            nativeBinding = require('unity-file-tools-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'unity-file-tools.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./unity-file-tools.freebsd-x64.node')
+      } else {
+        nativeBinding = require('unity-file-tools-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'unity-file-tools.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./unity-file-tools.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('unity-file-tools-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'unity-file-tools.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./unity-file-tools.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('unity-file-tools-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { ChunkType, Scanner, Indexer, EmbeddingGenerator, walkProjectFiles, grepProject, buildGuidCache, getVersion, isNativeAvailable } = nativeBinding
+
+module.exports.ChunkType = ChunkType
+module.exports.Scanner = Scanner
+module.exports.Indexer = Indexer
+module.exports.EmbeddingGenerator = EmbeddingGenerator
+module.exports.walkProjectFiles = walkProjectFiles
+module.exports.grepProject = grepProject
+module.exports.buildGuidCache = buildGuidCache
+module.exports.getVersion = getVersion
+module.exports.isNativeAvailable = isNativeAvailable

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "unity-agentic-tools",
+  "packageManager": "bun@latest",
+  "version": "0.1.0",
+  "description": "Fast, token-efficient Unity YAML parser for AI agents",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": "./dist/cli.js",
+    "./scanner": "./dist/scanner.js"
+  },
+  "files": [
+    "dist",
+    "native",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run build:lib && bun run build:cli && rm -f dist/*.node && cp ../doc-indexer/dist/cli.js dist/doc-indexer-cli.js",
+    "build:lib": "bun build src/index.ts --outdir=dist --target=bun --format=cjs --external unity-file-tools",
+    "build:cli": "bun build src/cli.ts --outdir=dist --target=bun --format=cjs --external unity-file-tools",
+    "build:rust": "cd ../rust-core && bun run build",
+    "build:all": "bun run build:rust || echo 'Rust build skipped' && bun run build",
+    "dev": "bun build src/index.ts --watch",
+    "clean": "rm -rf dist",
+    "rebuild": "bun run clean && bun run build",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage"
+  },
+  "dependencies": {
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "@vitest/ui": "^4.0.16",
+    "typescript": "^5.3.0",
+    "unity-file-tools": "workspace:*",
+    "vitest": "^4.0.16"
+  },
+  "type": "commonjs",
+  "bin": {
+    "unity-agentic-tools": "./dist/cli.js"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/taconotsandwich/unity-agentic-tools"
+  },
+  "keywords": [
+    "unity",
+    "yaml",
+    "parser",
+    "scene",
+    "prefab",
+    "gameobject",
+    "ai",
+    "cli"
+  ],
+  "license": "Apache-2.0"
+}