unity-agentic-tools 0.2.0 → 0.3.0

package/native/index.d.ts

@@ -90,6 +90,7 @@ export interface PaginationOptions {
 export interface PaginatedInspection {
   file: string
   total: number
+  totalInScene: number
   cursor: number
   nextCursor?: number | undefined
   truncated: boolean
@@ -135,6 +136,84 @@ export interface SearchResult {
   score: number
   metadata: ChunkMetadata
 }
+/**
+ * Extract type names from a single .NET DLL.
+ *
+ * Returns public types with their name and namespace.
+ * GUID is always None for DLL types (they have no .meta files).
+ */
+export declare function extractDllTypes(path: string): Array<CSharpTypeRef>
+/**
+ * Extract type info with fields from a single .NET DLL.
+ *
+ * Returns extended type info including serializable fields, base class,
+ * and struct/enum distinction via the Extends column.
+ */
+export declare function extractDllFields(path: string): Array<CSharpTypeInfo>
+/** 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 (e.g., "PlayerController") */
+  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
+  /** Base class (e.g., "MonoBehaviour", "ScriptableObject") */
+  baseClass?: string
+  /** Serializable fields */
+  fields: Array<CSharpFieldRef>
+}
+/** A C# type reference extracted from source or DLL. */
+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
+  /** Source file or DLL path (relative to project root) */
+  filePath: string
+  /** GUID from adjacent .meta file (None for DLL types) */
+  guid?: string
+}
+/**
+ * Extract C# type declarations from a single .cs file.
+ *
+ * Returns all public/internal class, struct, enum, and interface declarations
+ * with their namespace context and the GUID from the adjacent .meta file.
+ */
+export declare function extractCsharpTypes(path: string): Array<CSharpTypeRef>
+/**
+ * Build a type registry by scanning all .cs files in a Unity project.
+ *
+ * Scans Assets/ and optionally Library/PackageCache/ for .cs files,
+ * extracts type declarations, and returns them with GUID + namespace info.
+ * When include_packages is true, also scans Library/PackageCache/.
+ * When include_dlls is true, also extracts types from DLLs in Library/ScriptAssemblies/.
+ */
+export declare function buildTypeRegistry(projectRoot: string, includePackages?: boolean | undefined | null, includeDlls?: boolean | undefined | null): Array<CSharpTypeRef>
+/**
+ * Extract serialized field info from a single C# source file.
+ *
+ * Returns extended type info with fields, base class, and serialization attributes.
+ * This is called on-demand during component creation, not during registry builds.
+ */
+export declare function extractSerializedFields(path: string): Array<CSharpTypeInfo>
 /**
  * Walk a Unity project and collect files matching the given extensions.
  *
@@ -174,6 +253,14 @@ export declare function grepProject(options: NapiGrepOptions): NapiGrepResult
  * Returns a JSON object mapping `{ guid: relative_asset_path }`.
  */
 export declare function buildGuidCache(projectRoot: string): any
+/**
+ * Build a GUID cache for Library/PackageCache/ contents.
+ *
+ * Scans `Library/PackageCache/` for `.meta` files and returns
+ * `{ guid: relative_path }` just like `build_guid_cache` does for Assets/.
+ * Returns a separate cache so project assets and package assets stay distinct.
+ */
+export declare function buildPackageGuidCache(projectRoot: string): any
 /** Get the version of the native module */
 export declare function getVersion(): string
 /** Check if the native module is available */
@@ -191,6 +278,11 @@ export declare class Scanner {
   scanSceneMinimal(file: string): Array<GameObject>
   /** Scan scene with component information */
   scanSceneWithComponents(file: string, options?: ScanOptions | undefined | null): Array<any>
+  /**
+   * Scan scene for GO metadata (name, tag, layer) without component/hierarchy extraction.
+   * This is the "medium path" — faster than scan_scene_with_components for tag/layer filtering.
+   */
+  scanSceneMetadata(file: string): Array<any>
   /** Find GameObjects and PrefabInstances by name pattern */
   findByName(file: string, pattern: string, fuzzy: boolean): Array<FindResult>
   /** Inspect a specific GameObject */
@@ -199,8 +291,12 @@ export declare class Scanner {
   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
+  /**
+   * Read a .asset file and return its root objects with properties.
+   * When `decode_mesh` is true (default), Mesh assets (class 43) get their
+   * hex vertex/index data decoded into structured arrays.
+   */
+  readAsset(file: string, decodeMesh?: boolean | undefined | null): any
 }
 /** High-performance documentation indexer */
 export declare class Indexer {

package/native/index.js

@@ -310,14 +310,20 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { ChunkType, Scanner, Indexer, EmbeddingGenerator, walkProjectFiles, grepProject, buildGuidCache, getVersion, isNativeAvailable } = nativeBinding
+const { ChunkType, extractDllTypes, extractDllFields, extractCsharpTypes, buildTypeRegistry, extractSerializedFields, Scanner, Indexer, EmbeddingGenerator, walkProjectFiles, grepProject, buildGuidCache, buildPackageGuidCache, getVersion, isNativeAvailable } = nativeBinding
 
 module.exports.ChunkType = ChunkType
+module.exports.extractDllTypes = extractDllTypes
+module.exports.extractDllFields = extractDllFields
+module.exports.extractCsharpTypes = extractCsharpTypes
+module.exports.buildTypeRegistry = buildTypeRegistry
+module.exports.extractSerializedFields = extractSerializedFields
 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.buildPackageGuidCache = buildPackageGuidCache
 module.exports.getVersion = getVersion
 module.exports.isNativeAvailable = isNativeAvailable

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unity-agentic-tools",
   "packageManager": "bun@latest",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Fast, token-efficient Unity YAML parser for AI agents",
   "exports": {
     ".": {