@alpsckr/unitycli 0.4.0

package/dist/tools/metadata/index.js

@@ -0,0 +1,130 @@
+/**
+ * Tool metadata index for TS-local tools.
+ *
+ * 设计原则:
+ * - TS local Tool 的 metadata 真源是 defineTool registry。
+ * - C# built-in、Extension 与 Project-defined descriptor 都从选定实例的 live registry 读取。
+ * - static catalog 只供生成、契约和离线审计，不进入公开 discovery。
+ * - 每项能力只有一个 descriptor owner，不维护 TS 手写重复 metadata。
+ */
+import { bridgeCommandRegistry } from "../../bridge/index.js";
+import { validateBridgeRegistryContracts } from "../../contracts/command-contract.js";
+import { scoreSearch } from "../../util.js";
+import "../.generated-registry.js";
+import { defineToolMetadata } from "../define.js";
+import { builtinExtensionGroupNames } from "../../extensions/tool-manifest.js";
+import { inferToolRiskLevel, isLongRunningTool, toolAvailabilityScope, toolContractProfile, toolPublicRoute, toolSource } from "./derived.js";
+import { toolHandler } from "./status.js";
+export { supportStatusForTool, toolHandler } from "./status.js";
+export { inferToolRiskLevel, isLongRunningTool, toolAvailabilityScope, toolContractProfile, toolDocsTopic, toolIsMutation, toolPublicRoute, toolSource } from "./derived.js";
+/** Extension groups are discovered from extension manifests, not TS tool metadata. */
+export const EXTENSION_GROUPS = new Set(builtinExtensionGroupNames());
+/** Normalize a ToolMetadata entry to include generated source and Play Mode defaults. */
+export function normalizeToolMetadata(tool, source = "built-in") {
+    const normalized = {
+        ...tool,
+        source: toolSource(tool, source),
+        handler: toolHandler(tool),
+        playModeSupport: tool.playModeSupport ?? inferPlayModeSupport(tool),
+        availabilityScope: toolAvailabilityScope(tool),
+        contractProfile: toolContractProfile(tool),
+        riskLevel: inferToolRiskLevel(tool),
+    };
+    return normalized;
+}
+/** 根据执行目标和副作用推导默认 Play Mode 语义。 */
+export function inferPlayModeSupport(tool) {
+    const handler = toolHandler(tool);
+    if (tool.target === "runtime" || handler === "bridge-runtime")
+        return "runtime-only";
+    if (handler === "offline")
+        return "editor-only";
+    if (isLongRunningTool(tool) || tool.sideEffects?.some((effect) => ["asset-import", "file-write", "package-modify"].includes(effect)))
+        return "session-affecting";
+    if (tool.destructiveHint || tool.supportsDryRun)
+        return "runtime-only";
+    return "supported";
+}
+/** TS 本地工具(metadata 真源 = defineTool registry)；公开 discovery 仍要求绑定实例。 */
+function localTsTools() {
+    return defineToolMetadata();
+}
+// Validate bridge registry once at module level. TS 本地工具 metadata 在运行时从 defineTool registry 取。
+if (process.env.UNITY_CLI_GENERATING_CONTRACT !== "1") {
+    validateBridgeRegistryContracts(bridgeCommandRegistry, EXTENSION_GROUPS);
+}
+/** Return TS-local tool metadata only. C# built-in/extension/project tools require a live bridge. */
+export function builtinToolMetadata() {
+    const tools = localTsTools();
+    validateBuiltinTools(tools, false);
+    return tools.map((tool) => normalizeToolMetadata(tool, tool.source ?? "built-in"));
+}
+/** Return all locally registered metadata entries (TS-local only). */
+export function allRegisteredToolMetadata() {
+    return builtinToolMetadata();
+}
+/** Return distinct TS-local group names only. C# groups require a live bridge. */
+export function builtinToolGroups() {
+    const groups = new Set();
+    for (const tool of localTsTools()) {
+        groups.add(tool.group);
+    }
+    return [...groups].sort();
+}
+/** Return distinct group names from locally visible metadata (TS-local only). */
+export function allRegisteredToolGroups() {
+    const groups = new Set();
+    for (const tool of allRegisteredToolMetadata()) {
+        groups.add(tool.group);
+    }
+    return [...groups].sort();
+}
+/** Find a single TS-local Tool by dotted name；仅供生成、契约与内部测试。 */
+export function findToolByName(name) {
+    return allRegisteredToolMetadata().find((t) => t.name === name);
+}
+/** Filter TS-local Tools by group；仅供生成、契约与内部测试。 */
+export function filterToolsByGroup(group) {
+    return allRegisteredToolMetadata().filter((t) => t.group === group);
+}
+/** Search TS-local Tools；仅供生成、契约与内部测试。 */
+export function searchTools(keyword) {
+    const lower = keyword.toLowerCase();
+    return allRegisteredToolMetadata().filter((t) => t.name.toLowerCase().includes(lower) ||
+        t.summary.toLowerCase().includes(lower) ||
+        t.description.toLowerCase().includes(lower) ||
+        t.group.toLowerCase().includes(lower)).sort((a, b) => {
+        const aScore = scoreSearch(a.name.toLowerCase(), lower) + scoreSearch(a.summary.toLowerCase(), lower);
+        const bScore = scoreSearch(b.name.toLowerCase(), lower) + scoreSearch(b.summary.toLowerCase(), lower);
+        return bScore - aScore;
+    });
+}
+function validateBuiltinTools(tools, skipCliCommandBridgeCheck) {
+    const names = new Set();
+    const duplicateNames = new Set();
+    for (const tool of tools) {
+        if (names.has(tool.name)) {
+            duplicateNames.add(tool.name);
+        }
+        names.add(tool.name);
+        if (!skipCliCommandBridgeCheck && toolHandler(tool) === "bridge" && tool.supportStatus !== "planned") {
+            const publicRoute = toolPublicRoute(tool);
+            const match = /^tools run (.+)$/.exec(publicRoute);
+            if (match) {
+                const toolName = match[1];
+                const spec = bridgeCommandRegistry.specs().find((s) => s.toolName === toolName || s.bridgeCommand === toolName);
+                if (!spec) {
+                    throw new Error(`Bridge tool metadata mismatch: ${tool.name} uses public route "${publicRoute}" but no bridge spec resolves toolName/bridgeCommand="${toolName}"`);
+                }
+                const resolved = spec.toolName ?? spec.bridgeCommand;
+                if (resolved !== tool.name) {
+                    throw new Error(`Bridge tool metadata mismatch: ${tool.name} uses public route "${publicRoute}" but bridge registry resolves ${resolved}`);
+                }
+            }
+        }
+    }
+    if (duplicateNames.size > 0) {
+        throw new Error(`Duplicate built-in tool metadata names: ${[...duplicateNames].sort().join(", ")}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/metadata/index.js.map

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

package/dist/tools/metadata/schemas.d.ts

@@ -0,0 +1,3 @@
+/** Minimal JSON Schema helpers. */
+export declare function objSchema(properties: Record<string, unknown>, required?: string[]): Record<string, unknown>;
+export declare function pageSchema(itemSchema: Record<string, unknown>): Record<string, unknown>;

package/dist/tools/metadata/schemas.js

@@ -0,0 +1,19 @@
+/** Minimal JSON Schema helpers. */
+export function objSchema(properties, required) {
+    const schema = { type: "object", properties };
+    if (required && required.length > 0)
+        schema.required = required;
+    return schema;
+}
+export function pageSchema(itemSchema) {
+    return objSchema({
+        items: { type: "array", items: itemSchema },
+        pageInfo: objSchema({
+            pageSize: { type: "integer" },
+            cursor: { type: "string" },
+            nextCursor: { type: "string" },
+            total: { type: "integer" }
+        }, ["pageSize", "cursor", "total"])
+    }, ["items", "pageInfo"]);
+}
+//# sourceMappingURL=schemas.js.map

package/dist/tools/metadata/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/metadata/schemas.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAC,UAAmC,EAAE,QAAmB;IAChF,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvE,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAmC;IAC5D,OAAO,SAAS,CAAC;QACf,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE;QAC3C,QAAQ,EAAE,SAAS,CAAC;YAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC3B,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;KACpC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ToolHandler, ToolMetadata, ToolSupportStatus } from "./types.js";
+/** 推导内部执行路由；metadata 只在无法从注册表或命名规则判断时覆盖。 */
+export declare function toolHandler(tool: Pick<ToolMetadata, "name" | "handler">): ToolHandler;
+export declare function supportStatusForTool(tool: ToolMetadata): ToolSupportStatus;

package/dist/tools/metadata/status.js

@@ -0,0 +1,61 @@
+import { bridgeCommandRegistry } from "../../bridge/index.js";
+const OFFLINE_TOOL_PREFIXES = ["docs.", "reflect."];
+const OFFLINE_TOOL_NAMES = new Set([
+    "diagnose.capabilities",
+    "editor.dialog.click",
+    "package.bridge-remove",
+    "package.deploy",
+    "package.info",
+    "package.list",
+    "package.registry.clear",
+    "package.registry.get",
+    "package.registry.set",
+    "package.restore",
+    "package.scoped-registry.add",
+    "package.scoped-registry.list",
+    "package.scoped-registry.remove",
+    "package.search",
+    "package.status",
+    "tools.describe",
+    "tools.group",
+    "tools.group-list",
+    "tools.search"
+]);
+const HYBRID_TOOL_NAMES = new Set([
+    "package.install",
+    "package.remove",
+    "package.resolve",
+    "profiler.start"
+]);
+const HYBRID_TOOL_PREFIXES = ["probuilder.", "cinemachine.", "urp.", "hdrp."];
+/** 推导内部执行路由；metadata 只在无法从注册表或命名规则判断时覆盖。 */
+export function toolHandler(tool) {
+    if (tool.handler)
+        return tool.handler;
+    if (OFFLINE_TOOL_NAMES.has(tool.name) || OFFLINE_TOOL_PREFIXES.some((prefix) => tool.name.startsWith(prefix)))
+        return "offline";
+    if (HYBRID_TOOL_NAMES.has(tool.name) || HYBRID_TOOL_PREFIXES.some((prefix) => tool.name.startsWith(prefix)))
+        return "hybrid";
+    const spec = bridgeCommandRegistry.specs().find((entry) => entry.toolName === tool.name || entry.bridgeCommand === tool.name);
+    if (spec)
+        return "bridge";
+    return "bridge";
+}
+export function supportStatusForTool(tool) {
+    if (tool.supportStatus) {
+        return tool.supportStatus;
+    }
+    switch (toolHandler(tool)) {
+        case "bridge":
+            return "live-bridge";
+        case "bridge-runtime":
+            return "live-bridge-runtime";
+        case "offline":
+            return "cli-only";
+        case "hybrid":
+            return "live-bridge";
+        default:
+            return "planned";
+    }
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/tools/metadata/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACpD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,uBAAuB;IACvB,qBAAqB;IACrB,uBAAuB;IACvB,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,wBAAwB;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,6BAA6B;IAC7B,8BAA8B;IAC9B,gCAAgC;IAChC,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,kBAAkB;IAClB,cAAc;CACf,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;CACjB,CAAC,CAAC;AACH,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9E,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,IAA4C;IACtE,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IACtC,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAChI,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7H,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9H,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,QAAQ,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB,KAAK,gBAAgB;YACnB,OAAO,qBAAqB,CAAC;QAC/B,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/tools/metadata/types.d.ts

@@ -0,0 +1,79 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface ToolExample {
+    description: string;
+    argv: string[];
+    /** 内部 authoring 输入；公开投影返回 description、input 与按需 execution。 */
+    input?: AnyJson;
+    execution?: {
+        dryRun?: boolean;
+        timeoutMs?: number;
+    };
+    output?: string;
+}
+export type ToolHandler = "bridge" | "bridge-runtime" | "offline" | "hybrid";
+export type ToolRiskLevel = "safe" | "low" | "medium" | "high" | "critical";
+export type ToolSupportStatus = "live-bridge" | "live-bridge-runtime" | "cli-only" | "planned";
+export type ToolSource = "built-in" | "project" | "extension";
+/** 区分本项目完整完成证明与官方 attribute 的保守方法返回边界。 */
+export type ToolContractProfile = "native" | "official-attribute";
+export type PlayModeSupport = "supported" | "runtime-only" | "session-affecting" | "editor-only" | "unknown";
+export interface ToolCompletionContract {
+    executionClass: "atomic" | "observed-state" | "resumable" | "external";
+    completionPredicate: string;
+    proofSource: string;
+    reloadPolicy: string;
+    timeoutError: string;
+    outcomeUnknownPolicy: string;
+    completionDriverId: string;
+    journalPolicy: "required" | "none";
+    mutation: boolean;
+}
+export interface ToolMetadata {
+    /** Optional origin override when a live bridge descriptor already knows whether this tool is built-in/extension/project. */
+    source?: ToolSource;
+    name: string;
+    summary: string;
+    description: string;
+    /** Logical group for discovery and `tools group list <group>`. */
+    group: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    destructiveHint: boolean;
+    /** Side effect categories this tool may produce, e.g. ['file-write', 'scene-modify']. */
+    sideEffects?: string[];
+    /** Play Mode execution semantics for AI routing and runtime safety. */
+    playModeSupport?: PlayModeSupport;
+    supportsDryRun?: boolean;
+    timeoutMs?: number;
+    permissions?: string[];
+    examples?: ToolExample[];
+    /** Internal execution route override. Omit when the route can be inferred from the bridge registry or tool name. */
+    handler?: ToolHandler;
+    /** 内部强类型路由状态，不进入公开 descriptor。 */
+    supportStatus?: ToolSupportStatus;
+    /** Execution target: "editor" (default), "runtime", or "both". */
+    target?: string;
+    /** Descriptor 声明的可用范围；live registry 值优先于 target 派生默认值。 */
+    availabilityScope?: string;
+    /** Whether the tool is currently available based on session state (runtime tools: only in Play Mode). */
+    available?: boolean;
+    /** 当前不可用的可执行原因；仅在 available=false 时公开。 */
+    unavailableReason?: string;
+    /** Unity package names required by this tool at runtime. When absent the tool has no package prerequisites. */
+    requiresPackages?: string[];
+    /** descriptor 的完成保证来源；TS 本地和 IUnityCliTool 默认为 native。 */
+    contractProfile?: ToolContractProfile;
+    /** Live Bridge 计算的 handler+descriptor 指纹；破坏性 proof 必须绑定此值。 */
+    liveDescriptorFingerprint?: string;
+    /** 每次直接调用必须命中的机器可执行 completion contract。 */
+    completionContract?: ToolCompletionContract;
+}
+export type ResolvedToolMetadata = ToolMetadata & {
+    source: ToolSource;
+    handler: ToolHandler;
+    playModeSupport: PlayModeSupport;
+    availabilityScope: string;
+    contractProfile: ToolContractProfile;
+    /** 仅供内部安全与路由计算使用，公开 catalog 不会投影。 */
+    riskLevel?: ToolRiskLevel;
+};

package/dist/tools/metadata/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/metadata/types.js.map

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

package/dist/tools/navmesh/bake-cancel.d.ts

@@ -0,0 +1,7 @@
+import { type NavMeshCancelResult } from "./live.js";
+export interface NavMeshBakeCancelRequest {
+    /** Optional exact operation identity returned by navmesh.bake-status. */
+    operationId?: string;
+}
+declare const _default: import("../define.js").ToolDefinition<NavMeshBakeCancelRequest, NavMeshCancelResult>;
+export default _default;

package/dist/tools/navmesh/bake-cancel.js

@@ -0,0 +1,21 @@
+import { defineTool } from "../define.js";
+import { cancelNavMeshBake } from "./live.js";
+export default defineTool({
+    name: "navmesh.bake-cancel",
+    summary: "Request cooperative cancellation for one frozen NavMesh bake.",
+    description: "Reads and freezes the active coordinator operation before the effect barrier. Queued work reaches a cancelled terminal immediately. Running work records a cooperative request, waits for the current native operation to end, and does not call legacy or NavMeshSurface native cancel APIs across frames. The call returns cancelled=true only after the same operation reaches its durable cancelled terminal; an idle coordinator is a no-op.",
+    group: "navmesh",
+    target: "editor",
+    destructiveHint: false,
+    timeoutMs: 60_000,
+    playModeSupport: "supported",
+    sideEffects: ["navmesh-bake-cancel"],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [
+        { description: "Cancel the current tracked bake.", argv: ["tools", "run", "navmesh.bake-cancel"] },
+        { description: "Cancel one exact operation.", argv: ["tools", "run", "navmesh.bake-cancel", "--input", "{\"operationId\":\"navmesh-...\"}"] }
+    ],
+    execute(request, context) { return cancelNavMeshBake(request.operationId, context); }
+});
+//# sourceMappingURL=bake-cancel.js.map

package/dist/tools/navmesh/bake-cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake-cancel.js","sourceRoot":"","sources":["../../../src/tools/navmesh/bake-cancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAA4B,MAAM,WAAW,CAAC;AAOxE,eAAe,UAAU,CAAgD;IACvE,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,+DAA+D;IACxE,WAAW,EAAE,mbAAmb;IAChc,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,KAAK;IACtB,SAAS,EAAE,MAAM;IACjB,eAAe,EAAE,WAAW;IAC5B,WAAW,EAAE,CAAC,qBAAqB,CAAC;IACpC,OAAO,EAAE,QAAQ;IACjB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,qBAAqB,CAAC,EAAE;QAClG,EAAE,WAAW,EAAE,6BAA6B,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,mCAAmC,CAAC,EAAE;KAC9I;IACD,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACtF,CAAC,CAAC"}

package/dist/tools/navmesh/bake-status.d.ts

@@ -0,0 +1,5 @@
+import { type NavMeshBakeStatusResult } from "./live.js";
+export interface NavMeshBakeStatusRequest {
+}
+declare const _default: import("../define.js").ToolDefinition<NavMeshBakeStatusRequest, NavMeshBakeStatusResult>;
+export default _default;

package/dist/tools/navmesh/bake-status.js

@@ -0,0 +1,18 @@
+import { defineTool } from "../define.js";
+import { readNavMeshBakeStatus } from "./live.js";
+export default defineTool({
+    name: "navmesh.bake-status",
+    summary: "Read the current session's active or most recent tracked NavMesh bake state.",
+    description: "Read-only: returns a bounded session-scoped snapshot for the unified legacy/surface bake coordinator, including exact operation identity, public phase, progress, target count, duration, and fresh NavMesh topology. It does not acquire the mutation lease or inspect another Editor process lifetime.",
+    group: "navmesh",
+    target: "editor",
+    destructiveHint: false,
+    timeoutMs: 30_000,
+    playModeSupport: "supported",
+    sideEffects: [],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [{ description: "Read NavMesh bake status.", argv: ["tools", "run", "navmesh.bake-status"] }],
+    execute(_request, context) { return readNavMeshBakeStatus(context); }
+});
+//# sourceMappingURL=bake-status.js.map

package/dist/tools/navmesh/bake-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake-status.js","sourceRoot":"","sources":["../../../src/tools/navmesh/bake-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAgC,MAAM,WAAW,CAAC;AAIhF,eAAe,UAAU,CAAoD;IAC3E,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,8EAA8E;IACvF,WAAW,EAAE,0SAA0S;IACvT,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,KAAK;IACtB,SAAS,EAAE,MAAM;IACjB,eAAe,EAAE,WAAW;IAC5B,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,QAAQ;IACjB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,qBAAqB,CAAC,EAAE,CAAC;IACvG,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC"}

package/dist/tools/navmesh/bake.d.ts

@@ -0,0 +1,5 @@
+import { type NavMeshBakeResult } from "./live.js";
+export interface NavMeshBakeRequest {
+}
+declare const _default: import("../define.js").ToolDefinition<NavMeshBakeRequest, NavMeshBakeResult>;
+export default _default;

package/dist/tools/navmesh/bake.js

@@ -0,0 +1,23 @@
+import { defineTool } from "../define.js";
+import { runNavMeshBake } from "./live.js";
+export default defineTool({
+    name: "navmesh.bake",
+    summary: "Bake the legacy NavMesh for loaded saved scenes and return its durable terminal readback.",
+    description: "Starts UnityEditor.AI.NavMeshBuilder under one session-scoped durable root. Every loaded target scene must already be saved and clean; terminal proof saves only those frozen scenes and returns GUID/hash/size with dirty=false. Timeout or reload ambiguity returns outcome unknown and must be inspected with navmesh.bake-status. Dry-run validates the complete scene plan without baking.",
+    group: "navmesh",
+    target: "editor",
+    destructiveHint: true,
+    supportsDryRun: true,
+    timeoutMs: 600_000,
+    playModeSupport: "editor-only",
+    sideEffects: ["navmesh-bake", "scene-modify"],
+    permissions: ["scene-modify"],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [
+        { description: "Bake the legacy NavMesh for loaded scenes.", argv: ["tools", "run", "navmesh.bake"] },
+        { description: "Validate the legacy bake plan.", argv: ["tools", "run", "navmesh.bake", "--dry-run"] }
+    ],
+    execute(_request, context) { return runNavMeshBake("legacy", context); }
+});
+//# sourceMappingURL=bake.js.map

package/dist/tools/navmesh/bake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.js","sourceRoot":"","sources":["../../../src/tools/navmesh/bake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAA0B,MAAM,WAAW,CAAC;AAInE,eAAe,UAAU,CAAwC;IAC/D,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,2FAA2F;IACpG,WAAW,EAAE,iYAAiY;IAC9Y,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE,OAAO;IAClB,eAAe,EAAE,aAAa;IAC9B,WAAW,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;IAC7C,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,OAAO,EAAE,QAAQ;IACjB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,4CAA4C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE;QACrG,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE;KACvG;IACD,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACzE,CAAC,CAAC"}

package/dist/tools/navmesh/live.d.ts

@@ -0,0 +1,86 @@
+import type { ToolContext } from "../define.js";
+export type NavMeshBakeKind = "legacy" | "surfaces";
+export type NavMeshBakeState = "idle" | "running" | "completed" | "cancelled" | "failed";
+export interface NavMeshTopology {
+    vertexCount: number;
+    indexCount: number;
+    sha256: string;
+}
+export interface NavMeshBakeTarget {
+    scenePath: string;
+    sceneGuid?: string;
+    globalId?: string;
+    name?: string;
+    beforeDataIdentity?: string;
+    beforeDataHash?: string;
+}
+export interface NavMeshSceneProof {
+    path: string;
+    guid: string;
+    sha256: string;
+    sizeBytes: number;
+    dirty: false;
+}
+export interface NavMeshSurfaceProof {
+    globalId: string;
+    name: string;
+    scenePath: string;
+    sceneDirty: boolean;
+    dataPath: string;
+    dataGuid: string;
+    dataLocalId: string;
+    dataIdentity: string;
+    dataHash: string;
+    dataSizeBytes: number;
+}
+export interface NavMeshPlannedEffect {
+    type: "navmesh.bake" | "navmesh.surface.bake";
+    target: "open-scenes" | "all-active-surfaces";
+    targetCount: number;
+}
+export interface NavMeshBakeDryRunResult {
+    dryRun: true;
+    kind: NavMeshBakeKind;
+    targetCount: number;
+    targets: NavMeshBakeTarget[];
+    scenes: NavMeshSceneProof[];
+    topology: NavMeshTopology;
+    plannedEffects: NavMeshPlannedEffect[];
+}
+export interface NavMeshBakeTerminalResult {
+    operationId: string;
+    kind: NavMeshBakeKind;
+    status: "completed";
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    topology: NavMeshTopology;
+    scenes: NavMeshSceneProof[];
+    surfaces: NavMeshSurfaceProof[];
+    plannedEffects: NavMeshPlannedEffect[];
+}
+export type NavMeshBakeResult = NavMeshBakeDryRunResult | NavMeshBakeTerminalResult;
+export interface NavMeshBakeStatusResult {
+    state: NavMeshBakeState;
+    active: boolean;
+    operationId: string | null;
+    kind: NavMeshBakeKind | null;
+    phase: "queued" | "starting" | "baking" | "terminal" | "unknown" | null;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number;
+    progress: number | null;
+    targetCount: number;
+    topology: NavMeshTopology;
+}
+export interface NavMeshCancelResult {
+    cancelled: boolean;
+    operationId: string | null;
+    status: NavMeshBakeStatusResult;
+}
+/** 以一个公开 requestId 启动 durable root，并只在 terminal proof 后返回。 */
+export declare function runNavMeshBake(kind: NavMeshBakeKind, context: ToolContext): Promise<NavMeshBakeResult>;
+/** 读取当前 session 的有界 bake snapshot；不会获取 mutation lease。 */
+export declare function readNavMeshBakeStatus(context: ToolContext): Promise<NavMeshBakeStatusResult>;
+/** 冻结 exact active operation 后提交取消；显式 operationId 由 coordinator 原子校验，不需要先做第二次 snapshot。 */
+export declare function cancelNavMeshBake(requestedOperationId: string | undefined, context: ToolContext): Promise<NavMeshCancelResult>;