@alpsckr/unitycli 0.4.0

package/dist/tools/package/search.js

@@ -0,0 +1,39 @@
+import { resolve } from "node:path";
+import { PackageManagerError, readSnapshot, searchRegistry, validatePackageName, validateRegistryUrl } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+const DEFAULT_REGISTRY = "https://package.openupm.com";
+/** 解析 registry 来源：显式 registry 优先；显式 project 必须有效；无 project 的非 Unity CWD 回退公开 UPM registry。 */
+async function resolveRegistrySource(request, projectPath) {
+    if (request.registry) {
+        return request.registry;
+    }
+    try {
+        return (await readSnapshot(resolve(request.project ?? projectPath))).registry ?? DEFAULT_REGISTRY;
+    }
+    catch (error) {
+        if (!request.project && error instanceof PackageManagerError && error.code === "MANIFEST_NOT_FOUND") {
+            return DEFAULT_REGISTRY;
+        }
+        throw error;
+    }
+}
+export default defineTool({
+    name: "package.search",
+    summary: "Search a Unity package registry by name and return candidate packages with versions/descriptions.",
+    description: "Search a Unity package registry by name and return candidate packages with versions/descriptions. Offline (HTTP to registry, no Unity needed). Explicit registry avoids reading a project manifest; otherwise the tool reads the project registry and falls back to https://package.openupm.com when no project manifest is available. Use this before package.install.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Search a registry", argv: ["tools", "run", "package.search", "--input", "{\"query\":\"textmeshpro\",\"registry\":\"https://package.openupm.com\"}"] }
+    ],
+    /** 查询 Unity package registry；不触发 Unity Editor，也不修改 manifest。 */
+    async execute(request, context) {
+        const query = validatePackageName(request.query);
+        const registry = validateRegistryUrl(await resolveRegistrySource(request, context.projectPath));
+        return { registry, query, packages: await searchRegistry(registry, query) };
+    }
+});
+//# sourceMappingURL=search.js.map

package/dist/tools/package/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/package/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACvI,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB1C,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAEvD,8FAA8F;AAC9F,KAAK,UAAU,qBAAqB,CAAC,OAA6B,EAAE,WAAmB;IACrF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACpG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACpG,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,eAAe,UAAU,CAA4C;IACnE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,mGAAmG;IAC5G,WAAW,EAAE,yWAAyW;IACtX,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,0EAA0E,CAAC,EAAE;KACtK;IACD,gEAAgE;IAChE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAChG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;IAC9E,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/status.d.ts

@@ -0,0 +1,21 @@
+export interface PackageStatusRequest {
+    project?: string;
+}
+export interface PackageStatusEntry {
+    name: string;
+    requestedVersion?: string | null;
+    lockedVersion?: string | null;
+    source?: string | null;
+    resolved: boolean;
+}
+export interface PackageStatusResult {
+    projectPath: string;
+    manifestPath: string;
+    lockPath: string;
+    packageCount: number;
+    registry?: string | null;
+    scopedRegistryCount: number;
+    packages: PackageStatusEntry[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageStatusRequest, PackageStatusResult>;
+export default _default;

package/dist/tools/package/status.js

@@ -0,0 +1,37 @@
+import { resolve } from "node:path";
+import { readSnapshot } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.status",
+    summary: "Summarize manifest and lock state: package count, registry, scoped registries, and per-package resolved flag.",
+    description: "Summarize manifest and lock state: package count, registry, scoped registries, and per-package resolved flag. Offline.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Show package status", argv: ["tools", "run", "package.status", "--input", "{\"project\":\"./Dev/UnityProject\"}"] }
+    ],
+    /** 汇总 manifest/lock 快照，不触发 Unity Editor 或 PackageManager resolve。 */
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const snapshot = await readSnapshot(projectPath);
+        return {
+            projectPath,
+            manifestPath: snapshot.manifestPath,
+            lockPath: snapshot.lockPath,
+            packageCount: snapshot.packages.length,
+            registry: snapshot.registry ?? null,
+            scopedRegistryCount: snapshot.scopedRegistries.length,
+            packages: snapshot.packages.map((entry) => ({
+                name: entry.name,
+                requestedVersion: entry.requestedVersion ?? null,
+                lockedVersion: entry.lockedVersion ?? null,
+                source: entry.source ?? null,
+                resolved: entry.lockedVersion !== undefined
+            }))
+        };
+    }
+});
+//# sourceMappingURL=status.js.map

package/dist/tools/package/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/tools/package/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAwB1C,eAAe,UAAU,CAA4C;IACnE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,+GAA+G;IACxH,WAAW,EAAE,wHAAwH;IACrI,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,sCAAsC,CAAC,EAAE;KACpI;IACD,qEAAqE;IACrE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO;YACL,WAAW;YACX,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;YACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACnC,mBAAmB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,MAAM;YACrD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI;gBAChD,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI;gBAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;gBAC5B,QAAQ,EAAE,KAAK,CAAC,aAAa,KAAK,SAAS;aAC5C,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/reflect/member.d.ts

@@ -0,0 +1,22 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface ReflectMemberRequest {
+    member: string;
+    reflectDir?: string;
+    unityVersion?: string;
+    format?: string;
+}
+export interface ReflectMemberResult {
+    mode: string;
+    requiresUnity: boolean;
+    source: Record<string, AnyJson>;
+    unityVersion: Record<string, AnyJson>;
+    assemblies: Record<string, AnyJson>[];
+    diagnostics: Record<string, AnyJson>[];
+    target: string;
+    format: string;
+    type: Record<string, AnyJson>;
+    member: Record<string, AnyJson>;
+    text?: string;
+}
+declare const _default: import("../define.js").ToolDefinition<ReflectMemberRequest, ReflectMemberResult>;
+export default _default;

package/dist/tools/reflect/member.js

@@ -0,0 +1,22 @@
+import { defineTool } from "../define.js";
+import { getReflectMember } from "../../services/reflect-service.js";
+export default defineTool({
+    name: "reflect.member",
+    summary: "Look up a single member's full signature on a C# type in the offline reflection cache.",
+    description: "Look up a single member's full signature on a C# type in the offline reflection cache. Pass the member as Type.Member (last dot splits type and member). Use this for detailed parameter/return info; use reflect.type for the whole member list.",
+    group: "reflect",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    target: "editor",
+    examples: [
+        { description: "Read one member's full signature", argv: ["tools", "run", "reflect.member", "--input", "{\"member\":\"UnityEngine.Camera.Render\",\"reflectDir\":\".cache/unity-reflect\",\"format\":\"text\"}"] },
+        { description: "Read one member as JSON", argv: ["tools", "run", "reflect.member", "--input", "{\"member\":\"UnityEngine.Camera.Render\",\"reflectDir\":\".cache/unity-reflect\",\"format\":\"json\"}"] }
+    ],
+    /** 读取离线反射 cache 中的单个成员签名；service 只执行文件读取和筛选。 */
+    execute(request, context) {
+        return getReflectMember(request, { dataDir: context.dataDir ?? context.artifactDir });
+    }
+});
+//# sourceMappingURL=member.js.map

package/dist/tools/reflect/member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member.js","sourceRoot":"","sources":["../../../src/tools/reflect/member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAwBrE,eAAe,UAAU,CAA4C;IACnE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,wFAAwF;IACjG,WAAW,EAAE,mPAAmP;IAChQ,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,wGAAwG,CAAC,EAAE;QAClN,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,wGAAwG,CAAC,EAAE;KAC1M;IACD,gDAAgD;IAChD,OAAO,CAAC,OAAO,EAAE,OAAO;QACtB,OAAO,gBAAgB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxF,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/reflect/search.d.ts

@@ -0,0 +1,30 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface ReflectSearchRequest {
+    query: string;
+    reflectDir?: string;
+    unityVersion?: string;
+    pageSize?: number;
+    cursor?: string;
+    format?: string;
+}
+export interface ReflectSearchPageInfo {
+    pageSize: number;
+    cursor: string;
+    nextCursor?: string;
+    total: number;
+}
+export interface ReflectSearchResult {
+    mode: string;
+    requiresUnity: boolean;
+    source: Record<string, AnyJson>;
+    unityVersion: Record<string, AnyJson>;
+    assemblies: Record<string, AnyJson>[];
+    diagnostics: Record<string, AnyJson>[];
+    query: string;
+    format: string;
+    items: Record<string, AnyJson>[];
+    pageInfo: ReflectSearchPageInfo;
+    text?: string;
+}
+declare const _default: import("../define.js").ToolDefinition<ReflectSearchRequest, ReflectSearchResult>;
+export default _default;

package/dist/tools/reflect/search.js

@@ -0,0 +1,22 @@
+import { defineTool } from "../define.js";
+import { searchReflect } from "../../services/reflect-service.js";
+export default defineTool({
+    name: "reflect.search",
+    summary: "Search cached C# types and members by query, returning ranked, paged results.",
+    description: "Search cached C# types and members by query, returning ranked, paged results. Use this to discover exact type/member names before reflect.type or reflect.member. Results include both type and member matches scored by the query.",
+    group: "reflect",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    target: "editor",
+    examples: [
+        { description: "Search for Render-related members", argv: ["tools", "run", "reflect.search", "--input", "{\"query\":\"Render\",\"reflectDir\":\".cache/unity-reflect\",\"pageSize\":10}"] },
+        { description: "Search reflection data as text", argv: ["tools", "run", "reflect.search", "--input", "{\"query\":\"Camera\",\"reflectDir\":\".cache/unity-reflect\",\"pageSize\":10,\"format\":\"text\"}"] }
+    ],
+    /** 搜索离线反射 cache 中的类型和成员；service 负责排序与 cursor 分页。 */
+    execute(request, context) {
+        return searchReflect(request, { dataDir: context.dataDir ?? context.artifactDir });
+    }
+});
+//# sourceMappingURL=search.js.map

package/dist/tools/reflect/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/reflect/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAiClE,eAAe,UAAU,CAA4C;IACnE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,+EAA+E;IACxF,WAAW,EAAE,qOAAqO;IAClP,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,mCAAmC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,gFAAgF,CAAC,EAAE;QAC3L,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,oGAAoG,CAAC,EAAE;KAC7M;IACD,oDAAoD;IACpD,OAAO,CAAC,OAAO,EAAE,OAAO;QACtB,OAAO,aAAa,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrF,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/reflect/type.d.ts

@@ -0,0 +1,21 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface ReflectTypeRequest {
+    name: string;
+    reflectDir?: string;
+    unityVersion?: string;
+    format?: string;
+}
+export interface ReflectTypeResult {
+    mode: string;
+    requiresUnity: boolean;
+    source: Record<string, AnyJson>;
+    unityVersion: Record<string, AnyJson>;
+    assemblies: Record<string, AnyJson>[];
+    diagnostics: Record<string, AnyJson>[];
+    name: string;
+    format: string;
+    type: Record<string, AnyJson>;
+    text?: string;
+}
+declare const _default: import("../define.js").ToolDefinition<ReflectTypeRequest, ReflectTypeResult>;
+export default _default;

package/dist/tools/reflect/type.js

@@ -0,0 +1,22 @@
+import { defineTool } from "../define.js";
+import { getReflectType } from "../../services/reflect-service.js";
+export default defineTool({
+    name: "reflect.type",
+    summary: "Look up a C# type and its member names in the offline Unity reflection cache.",
+    description: "Look up a C# type and its member names in the offline Unity reflection cache. Use this to verify a type exists and read its public member names before writing C# or calling reflection.method.*. Use reflect.search first when the exact type name is unknown.",
+    group: "reflect",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    target: "editor",
+    examples: [
+        { description: "Read a type's member names", argv: ["tools", "run", "reflect.type", "--input", "{\"name\":\"UnityEngine.Camera\",\"reflectDir\":\".cache/unity-reflect\",\"format\":\"text\"}"] },
+        { description: "Read a type as JSON", argv: ["tools", "run", "reflect.type", "--input", "{\"name\":\"UnityEngine.Camera\",\"reflectDir\":\".cache/unity-reflect\",\"format\":\"json\"}"] }
+    ],
+    /** 读取离线反射 cache 中的 type 详情；service 只执行文件读取和筛选。 */
+    execute(request, context) {
+        return getReflectType(request, { dataDir: context.dataDir ?? context.artifactDir });
+    }
+});
+//# sourceMappingURL=type.js.map

package/dist/tools/reflect/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/tools/reflect/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAuBnE,eAAe,UAAU,CAAwC;IAC/D,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,+EAA+E;IACxF,WAAW,EAAE,iQAAiQ;IAC9Q,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,4BAA4B,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,+FAA+F,CAAC,EAAE;QACjM,EAAE,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,+FAA+F,CAAC,EAAE;KAC3L;IACD,kDAAkD;IAClD,OAAO,CAAC,OAAO,EAAE,OAAO;QACtB,OAAO,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtF,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/runtime/console.d.ts

@@ -0,0 +1,24 @@
+export type RuntimeConsoleLevel = "log" | "warning" | "error";
+export interface RuntimeConsoleRequest {
+    since?: number;
+    limit?: number;
+    level?: RuntimeConsoleLevel;
+    includeStackTrace?: boolean;
+}
+export interface RuntimeConsoleEntry {
+    sequence: number;
+    observedAt: string;
+    frameCount: number;
+    level: RuntimeConsoleLevel;
+    message: string;
+    stackTrace: string;
+}
+export interface RuntimeConsoleResult {
+    runtimeSessionId: string;
+    cursor: number;
+    droppedBeforeSequence: number;
+    count: number;
+    entries: RuntimeConsoleEntry[];
+}
+declare const _default: import("../define.js").ToolDefinition<RuntimeConsoleRequest, RuntimeConsoleResult>;
+export default _default;

package/dist/tools/runtime/console.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "runtime.console",
+    summary: "Read bounded console entries from the selected development Player.",
+    description: "Read a bounded in-memory log page owned by the current development Player session. since is exclusive (entries require sequence > since), so use the returned cursor as since on the next call. level is a minimum severity: log includes info/log, warning includes warning/error, and error includes only error. Process exit invalidates the cursor and buffer.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: [],
+    supportsDryRun: false,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Read up to 50 current Player console entries.", argv: ["tools", "run", "runtime.console", "--input", "{\"limit\":50}"], input: { limit: 50 } }],
+    execute() { throw new Error("runtime.console must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=console.js.map

package/dist/tools/runtime/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/tools/runtime/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB1C,eAAe,UAAU,CAA8C;IACrE,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,oEAAoE;IAC7E,WAAW,EAAE,oWAAoW;IACjX,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1K,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC,CAAC,CAAC;CACrG,CAAC,CAAC"}

package/dist/tools/runtime/input/key.d.ts

@@ -0,0 +1,23 @@
+export type RuntimeKeyEvent = "down" | "up" | "press";
+export interface RuntimeInputKeyRequest {
+    key: string;
+    event?: RuntimeKeyEvent;
+}
+export interface RuntimeInputKeyResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    simulated: boolean;
+    key: string;
+    event: RuntimeKeyEvent;
+    controlPath: string;
+    beforePressed: boolean;
+    afterPressed: boolean;
+    observedPressedStates: boolean[];
+    plannedEffects: Array<{
+        type: "runtime-input-key";
+        key: string;
+        event: RuntimeKeyEvent;
+    }>;
+}
+declare const _default: import("../../define.js").ToolDefinition<RuntimeInputKeyRequest, RuntimeInputKeyResult>;
+export default _default;

package/dist/tools/runtime/input/key.js

@@ -0,0 +1,18 @@
+import { defineTool } from "../../define.js";
+export default defineTool({
+    name: "runtime.input.key",
+    summary: "Inject one bounded Input System key event into a development Player.",
+    description: "Resolve one current Input System keyboard control, queue down, up, or press only in the selected development Player, flush the event, and return fresh pressed-state observations. The Tool is unavailable when com.unity.inputsystem is absent.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    requiresPackages: ["com.unity.inputsystem"],
+    destructiveHint: false,
+    sideEffects: ["runtime-session"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Press Space in the current development Player.", argv: ["tools", "run", "runtime.input.key", "--input", "{\"key\":\"Space\",\"event\":\"press\"}"], input: { key: "Space", event: "press" } }],
+    execute() { throw new Error("runtime.input.key must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=key.js.map

package/dist/tools/runtime/input/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../../src/tools/runtime/input/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7C,eAAe,UAAU,CAAgD;IACvE,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,sEAAsE;IAC/E,WAAW,EAAE,kPAAkP;IAC/P,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;IAC3C,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,yCAAyC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACzN,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC,CAAC,CAAC;CACvG,CAAC,CAAC"}

package/dist/tools/runtime/input/pointer.d.ts

@@ -0,0 +1,34 @@
+export type RuntimePointerEvent = "move" | "down" | "up" | "click";
+export type RuntimePointerButton = "left" | "right" | "middle";
+export interface RuntimeInputPointerRequest {
+    x: number;
+    y: number;
+    event?: RuntimePointerEvent;
+    button?: RuntimePointerButton;
+}
+export interface RuntimePoint {
+    x: number;
+    y: number;
+}
+export interface RuntimeInputPointerResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    simulated: boolean;
+    event: RuntimePointerEvent;
+    button: RuntimePointerButton;
+    controlPath: string;
+    beforePosition: RuntimePoint;
+    afterPosition: RuntimePoint;
+    beforePressed: boolean;
+    afterPressed: boolean;
+    observedPressedStates: boolean[];
+    plannedEffects: Array<{
+        type: "runtime-input-pointer";
+        x: number;
+        y: number;
+        event: RuntimePointerEvent;
+        button: RuntimePointerButton;
+    }>;
+}
+declare const _default: import("../../define.js").ToolDefinition<RuntimeInputPointerRequest, RuntimeInputPointerResult>;
+export default _default;

package/dist/tools/runtime/input/pointer.js

@@ -0,0 +1,18 @@
+import { defineTool } from "../../define.js";
+export default defineTool({
+    name: "runtime.input.pointer",
+    summary: "Inject one bounded Input System pointer event into a development Player.",
+    description: "Resolve the current Input System mouse, validate in-screen pixel coordinates, queue move, down, up, or click only in the selected development Player, flush the event, and return fresh position and pressed-state observations.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    requiresPackages: ["com.unity.inputsystem"],
+    destructiveHint: false,
+    sideEffects: ["runtime-session"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Click the left pointer button at screen position 100,100.", argv: ["tools", "run", "runtime.input.pointer", "--input", "{\"x\":100,\"y\":100,\"event\":\"click\",\"button\":\"left\"}"], input: { x: 100, y: 100, event: "click", button: "left" } }],
+    execute() { throw new Error("runtime.input.pointer must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=pointer.js.map

package/dist/tools/runtime/input/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../../../src/tools/runtime/input/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqB7C,eAAe,UAAU,CAAwD;IAC/E,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,0EAA0E;IACnF,WAAW,EAAE,kOAAkO;IAC/O,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;IAC3C,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,+DAA+D,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAChR,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC,CAAC,CAAC;CAC3G,CAAC,CAAC"}

package/dist/tools/runtime/log.d.ts

@@ -0,0 +1,20 @@
+export type RuntimeLogLevel = "info" | "warning" | "error";
+export interface RuntimeLogRequest {
+    message: string;
+    level?: RuntimeLogLevel;
+}
+export interface RuntimeLogResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    logged: boolean;
+    level: RuntimeLogLevel;
+    message: string;
+    sequence: number | null;
+    observedAt: string;
+    plannedEffects: Array<{
+        type: "runtime-log";
+        level: RuntimeLogLevel;
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<RuntimeLogRequest, RuntimeLogResult>;
+export default _default;

package/dist/tools/runtime/log.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "runtime.log",
+    summary: "Write one bounded message to the selected development Player log.",
+    description: "Validate and write one bounded message to the current development Player log, then return the exact in-memory console sequence as fresh session-bound proof. level=info is observed by runtime.console as level=log. Dry-run performs validation without writing.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: ["runtime-session"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Write an informational Player log entry.", argv: ["tools", "run", "runtime.log", "--input", "{\"message\":\"runtime probe\",\"level\":\"info\"}"], input: { message: "runtime probe", level: "info" } }],
+    execute() { throw new Error("runtime.log must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=log.js.map

package/dist/tools/runtime/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/tools/runtime/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAe1C,eAAe,UAAU,CAAsC;IAC7D,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,mEAAmE;IAC5E,WAAW,EAAE,mQAAmQ;IAChR,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,oDAAoD,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IACnO,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC,CAAC,CAAC;CACjG,CAAC,CAAC"}

package/dist/tools/runtime/state.d.ts

@@ -0,0 +1,45 @@
+export interface RuntimeStateRequest {
+}
+export interface RuntimeSceneState {
+    name: string;
+    buildIndex: number;
+    isLoaded: boolean;
+}
+export interface RuntimeFrameState {
+    frameCount: number;
+    realtimeSinceStartup: number;
+    targetFrameRate: number;
+}
+export interface RuntimeTimeState {
+    timeScale: number;
+    time: number;
+    unscaledTime: number;
+}
+export interface RuntimeScreenState {
+    width: number;
+    height: number;
+    dpi: number;
+    fullScreen: boolean;
+    focused: boolean;
+}
+export interface RuntimeMemoryState {
+    totalAllocatedBytes: number;
+    totalReservedBytes: number;
+    totalUnusedReservedBytes: number;
+}
+export interface RuntimeStateResult {
+    runtimeSessionId: string;
+    buildId: string;
+    observedAt: string;
+    unityVersion: string;
+    platform: string;
+    productName: string;
+    applicationVersion: string;
+    scene: RuntimeSceneState;
+    frame: RuntimeFrameState;
+    time: RuntimeTimeState;
+    screen: RuntimeScreenState;
+    memory: RuntimeMemoryState;
+}
+declare const _default: import("../define.js").ToolDefinition<RuntimeStateRequest, RuntimeStateResult>;
+export default _default;

package/dist/tools/runtime/state.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "runtime.state",
+    summary: "Read bounded state from the selected development Player session.",
+    description: "Read one fresh, session-bound snapshot from the selected Windows development Player, including application, scene, frame, time, screen, and managed runtime memory state.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: [],
+    supportsDryRun: false,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Read the current development Player state.", argv: ["tools", "run", "runtime.state", "--input", "{}"], input: {} }],
+    execute() { throw new Error("runtime.state must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=state.js.map

package/dist/tools/runtime/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/tools/runtime/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAuB1C,eAAe,UAAU,CAA0C;IACjE,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,kEAAkE;IAC3E,WAAW,EAAE,2KAA2K;IACxL,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9I,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC,CAAC,CAAC;CACnG,CAAC,CAAC"}

package/dist/tools/runtime/target-framerate/set.d.ts

@@ -0,0 +1,16 @@
+export interface RuntimeTargetFramerateSetRequest {
+    frameRate: number;
+}
+export interface RuntimeTargetFramerateSetResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    changed: boolean;
+    before: number;
+    after: number;
+    plannedEffects: Array<{
+        type: "runtime-target-framerate-set";
+        frameRate: number;
+    }>;
+}
+declare const _default: import("../../define.js").ToolDefinition<RuntimeTargetFramerateSetRequest, RuntimeTargetFramerateSetResult>;
+export default _default;

package/dist/tools/runtime/target-framerate/set.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../../define.js";
+export default defineTool({
+    name: "runtime.target-framerate.set",
+    summary: "Set and read back the current development Player target frame rate.",
+    description: "Validate one session-only target frame rate, apply it to the selected development Player, and return fresh Application.targetFrameRate readback. Use -1 for platform default or 0 for unlimited/VSync behavior.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: ["runtime-session"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Set the current Player target to 60 FPS.", argv: ["tools", "run", "runtime.target-framerate.set", "--input", "{\"frameRate\":60}"], input: { frameRate: 60 } }],
+    execute() { throw new Error("runtime.target-framerate.set must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=set.js.map

package/dist/tools/runtime/target-framerate/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../src/tools/runtime/target-framerate/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAY7C,eAAe,UAAU,CAAoE;IAC3F,IAAI,EAAE,8BAA8B;IACpC,OAAO,EAAE,qEAAqE;IAC9E,WAAW,EAAE,iNAAiN;IAC9N,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,SAAS,EAAE,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1L,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC,CAAC,CAAC;CAClH,CAAC,CAAC"}

package/dist/tools/runtime/time-scale/set.d.ts

@@ -0,0 +1,16 @@
+export interface RuntimeTimeScaleSetRequest {
+    scale: number;
+}
+export interface RuntimeTimeScaleSetResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    changed: boolean;
+    before: number;
+    after: number;
+    plannedEffects: Array<{
+        type: "runtime-time-scale-set";
+        scale: number;
+    }>;
+}
+declare const _default: import("../../define.js").ToolDefinition<RuntimeTimeScaleSetRequest, RuntimeTimeScaleSetResult>;
+export default _default;

package/dist/tools/runtime/time-scale/set.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../../define.js";
+export default defineTool({
+    name: "runtime.time-scale.set",
+    summary: "Set and read back the current development Player time scale.",
+    description: "Validate one finite non-negative session-only scale, apply it to the selected development Player, and return fresh Time.timeScale readback. Use 0 to pause and 1 for normal time.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: ["runtime-session"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 10_000,
+    examples: [{ description: "Run the current Player at half time scale.", argv: ["tools", "run", "runtime.time-scale.set", "--input", "{\"scale\":0.5}"], input: { scale: 0.5 } }],
+    execute() { throw new Error("runtime.time-scale.set must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=set.js.map

package/dist/tools/runtime/time-scale/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../src/tools/runtime/time-scale/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAY7C,eAAe,UAAU,CAAwD;IAC/E,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,8DAA8D;IACvE,WAAW,EAAE,mLAAmL;IAChM,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IAChL,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC,CAAC,CAAC;CAC5G,CAAC,CAAC"}