@alpsckr/unitycli 0.4.0

package/dist/tools/editor/dialog/click.js

@@ -0,0 +1,71 @@
+import { CLICK_DIALOG_MIN_EXECUTION_BUDGET_MS, clickObservedDialog, observeEditorDialogs } from "../../../editor-dialogs.js";
+import { InstanceRegistryError, selectObservationInstanceForFlags } from "../../../instances.js";
+import { defineTool } from "../../define.js";
+import { StructuredToolError } from "../../errors.js";
+export default defineTool({
+    name: "editor.dialog.click",
+    summary: "Click one enabled button on a currently observed Unity desktop dialog.",
+    description: "Re-observes the selected canonical Unity project, invokes the exact enabled button label returned by editor.dialogs, and proves that the original dialog disappeared or is no longer modal.",
+    group: "editor",
+    target: "editor",
+    destructiveHint: false,
+    supportsDryRun: false,
+    playModeSupport: "supported",
+    sideEffects: ["desktop-dialog-click"],
+    timeoutMs: 30_000,
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [{ description: "Click the Cancel button returned by the dialog Context.", argv: ["tools", "run", "editor.dialog.click", "--input", '{"dialogId":"dialog_example","button":"Cancel"}'] }],
+    async execute(request, context) {
+        if (!context.dataDir)
+            throw new StructuredToolError("E_INSTANCE_NOT_FOUND", "UnityCLI data directory is required to resolve the selected Editor instance.", ["Pass --instance <instanceId|projectPath|alias> or run from a Unity project directory."]);
+        const deadlineMs = context.absoluteDeadlineMs ?? Date.now() + 30_000;
+        let instance;
+        try {
+            instance = (await selectObservationInstanceForFlags(context.flags ?? {}, context.dataDir, Math.max(0, deadlineMs - Date.now()))).instance;
+        }
+        catch (error) {
+            if (error instanceof InstanceRegistryError)
+                throw new StructuredToolError(error.code, error.message, error.nextActions, error.details);
+            throw error;
+        }
+        if (instance.status === "conflict")
+            throw new StructuredToolError("E_INSTANCE_CONFLICT", "Multiple verified Unity Editor sessions claim the selected project identity.", ["Close duplicate Unity Editor processes before clicking a dialog."]);
+        if (instance.status === "unverifiable")
+            throw new StructuredToolError("E_INSTANCE_UNVERIFIABLE", "Unity Editor process ownership could not be verified safely.", ["Run unitycli instances list or tools run editor.state to observe the identity again."]);
+        const observed = await observeEditorDialogs({ instanceId: instance.instanceId, canonicalProjectPath: instance.canonicalProjectPath, displayProjectPath: instance.displayProjectPath }, Math.max(0, deadlineMs - Date.now()));
+        const recovery = ["Run tools run editor.dialogs, then run tools run editor.dialog.click with a current dialogId and exact enabled button label."];
+        if (observed.outcome === "unproven" && observed.reason === "process-claims-unverifiable")
+            throw new StructuredToolError("E_INSTANCE_UNVERIFIABLE", "Unity Editor process ownership could not be verified safely.", ["Run unitycli instances list or tools run editor.state to observe the identity again."]);
+        if (observed.outcome === "unproven" || observed.outcome === "unsupported")
+            throw new StructuredToolError("E_DIALOG_OBSERVATION_FAILED", "Windows dialog observation could not be proven for the selected Unity project.", recovery);
+        if (observed.outcome === "conflict")
+            throw new StructuredToolError("E_INSTANCE_CONFLICT", "Multiple verified Unity Editor processes claim the selected project identity.", recovery);
+        if (observed.outcome === "offline")
+            throw new StructuredToolError("E_INSTANCE_NOT_RUNNING", "The selected Unity project has no attributable Unity process.", recovery);
+        if (observed.outcome !== "observed")
+            throw new StructuredToolError("E_DIALOG_OBSERVATION_FAILED", "Windows dialog observation could not be proven for the selected Unity project.", recovery);
+        if (observed.dialogs.length === 0)
+            throw new StructuredToolError("E_DIALOG_NOT_FOUND", "No modal dialog is currently visible for the selected Unity project.", recovery);
+        const dialog = observed.dialogs.find((value) => value.dialogId === request.dialogId);
+        if (!dialog)
+            throw new StructuredToolError("E_DIALOG_STALE", "The requested dialogId is no longer current for the selected Unity project.", recovery);
+        const matches = dialog.buttonTargets.filter((value) => value.label === request.button && value.enabled);
+        if (matches.length === 0)
+            throw new StructuredToolError("E_DIALOG_BUTTON_NOT_FOUND", "The requested enabled button is not present on the current dialog.", recovery);
+        if (matches.length > 1)
+            throw new StructuredToolError("E_DIALOG_BUTTON_AMBIGUOUS", "Multiple enabled dialog buttons have the requested label.", recovery);
+        if (deadlineMs - Date.now() < CLICK_DIALOG_MIN_EXECUTION_BUDGET_MS)
+            throw new StructuredToolError("E_EXECUTION_TIMEOUT", "The request deadline elapsed before enough time remained to prove the dialog click.", recovery, { reason: "pre-effect-budget" });
+        await context.commitEffect?.();
+        const result = await clickObservedDialog(dialog, matches[0], deadlineMs);
+        if (result.outcome === "stale")
+            throw new StructuredToolError("E_DIALOG_STALE", "The dialog changed before the click effect could be applied.", recovery);
+        if (result.outcome === "button-not-found")
+            throw new StructuredToolError("E_DIALOG_BUTTON_NOT_FOUND", "The requested enabled button changed before the click effect could be applied.", recovery);
+        if (result.outcome !== "clicked")
+            throw new StructuredToolError("E_DIALOG_CLICK_UNPROVEN", "The dialog click did not prove that the original modal dialog closed.", recovery, result.reason ? { reason: result.reason } : undefined);
+        return { clicked: true, dialogId: dialog.dialogId, title: dialog.title, button: request.button };
+    },
+});
+//# sourceMappingURL=click.js.map

package/dist/tools/editor/dialog/click.js.map

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

package/dist/tools/editor/dialogs.d.ts

@@ -0,0 +1,12 @@
+import { type EditorDialog } from "../../editor-dialogs.js";
+import { type ToolContext } from "../define.js";
+export interface EditorDialogsRequest {
+    dialogId?: string;
+}
+export interface EditorDialogsResult {
+    dialogs: EditorDialog[];
+}
+declare const _default: import("../define.js").ToolDefinition<EditorDialogsRequest, EditorDialogsResult>;
+export default _default;
+/** 只观察选定 Editor 的当前模态窗口，不执行桌面操作。 */
+export declare function readEditorDialogs(request: EditorDialogsRequest, context: ToolContext): Promise<EditorDialogsResult>;

package/dist/tools/editor/dialogs.js

@@ -0,0 +1,58 @@
+import { observeEditorDialogs, publicDialog } from "../../editor-dialogs.js";
+import { InstanceRegistryError, selectObservationInstanceForFlags } from "../../instances.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "editor.dialogs",
+    summary: "Read current modal desktop dialogs for the selected Unity Editor project.",
+    description: "Read Windows modal dialogs for the uniquely attributable selected Unity project without contacting Unity Bridge or changing desktop state. Optionally filter the current observation by dialogId.",
+    group: "editor",
+    destructiveHint: false,
+    sideEffects: [],
+    handler: "offline",
+    target: "editor",
+    playModeSupport: "supported",
+    examples: [{ description: "Read every current modal dialog.", argv: ["tools", "run", "editor.dialogs", "--input", "{}"], input: {} }],
+    async execute(request, context) { return readEditorDialogs(request, context); },
+});
+/** 只观察选定 Editor 的当前模态窗口，不执行桌面操作。 */
+export async function readEditorDialogs(request, context) {
+    if (!context.dataDir)
+        throw new StructuredToolError("E_INSTANCE_NOT_FOUND", "UnityCLI data directory is required to resolve the selected Editor instance.", ["Pass --instance <instanceId|projectPath|alias> or run from a Unity project directory."]);
+    const deadlineMs = Math.min(Date.now() + 10_000, context.absoluteDeadlineMs ?? Number.POSITIVE_INFINITY);
+    let instance;
+    try {
+        instance = (await selectObservationInstanceForFlags(context.flags ?? {}, context.dataDir, Math.max(0, deadlineMs - Date.now()))).instance;
+    }
+    catch (error) {
+        if (error instanceof InstanceRegistryError)
+            throw new StructuredToolError(error.code, error.message, error.nextActions, error.details);
+        throw error;
+    }
+    if (instance.status === "conflict")
+        throw new StructuredToolError("E_INSTANCE_CONFLICT", "Multiple verified Unity Editor sessions claim the selected project identity.", ["Close duplicate Unity Editor processes before reading dialogs."]);
+    if (instance.status === "unverifiable")
+        throw new StructuredToolError("E_INSTANCE_UNVERIFIABLE", "Unity Editor process ownership could not be verified safely.", ["Run unitycli instances list or tools run editor.state to observe the identity again."]);
+    const observed = await observeEditorDialogs({ instanceId: instance.instanceId, canonicalProjectPath: instance.canonicalProjectPath, displayProjectPath: instance.displayProjectPath }, Math.max(0, deadlineMs - Date.now()));
+    if (observed.outcome === "unproven" && observed.reason === "process-claims-unverifiable")
+        throw new StructuredToolError("E_INSTANCE_UNVERIFIABLE", "Unity Editor process ownership could not be verified safely.", ["Run unitycli instances list or tools run editor.state to observe the identity again."]);
+    if (observed.outcome === "unproven")
+        throw new StructuredToolError("E_DIALOG_OBSERVATION_FAILED", "Windows dialog observation could not be proven for the selected Unity project.", ["Retry tools run editor.dialogs after the selected Unity process is stable."], { reason: observed.reason });
+    if (observed.outcome === "conflict")
+        throw new StructuredToolError("E_INSTANCE_CONFLICT", "Multiple verified Unity Editor processes claim the selected project identity.", ["Close duplicate Unity Editor processes before reading dialogs."]);
+    if (observed.outcome === "offline")
+        throw new StructuredToolError("E_INSTANCE_NOT_RUNNING", "The selected Unity project has no attributable Unity process.", ["Open the selected Unity project in Unity Editor."]);
+    if (observed.outcome === "unsupported")
+        throw new StructuredToolError("E_DIALOG_OBSERVATION_FAILED", "Windows dialog observation is unavailable on this platform.", ["Run tools run editor.dialogs on Windows."]);
+    if (observed.outcome !== "observed")
+        throw new StructuredToolError("E_DIALOG_OBSERVATION_FAILED", "Windows dialog observation could not be proven for the selected Unity project.", ["Run tools run editor.dialogs after the selected Unity process is stable."]);
+    const dialogs = observed.dialogs.map(publicDialog);
+    if (request.dialogId) {
+        const dialog = dialogs.find((value) => value.dialogId === request.dialogId);
+        if (!dialog)
+            throw new StructuredToolError("E_DIALOG_NOT_FOUND", "The requested dialogId is not currently visible for the selected Unity project.", ["Run tools run editor.dialogs to obtain the current dialogId."]);
+        return { dialogs: [dialog] };
+    }
+    return { dialogs };
+}
+//# sourceMappingURL=dialogs.js.map

package/dist/tools/editor/dialogs.js.map

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

package/dist/tools/editor/readiness.d.ts

@@ -0,0 +1,13 @@
+import { type EditorStateResult } from "./state.js";
+interface EditorReadinessContext {
+    flags?: Record<string, string | boolean>;
+    dataDir?: string;
+    rootAdmission?: unknown;
+    bridgeExecute?: unknown;
+}
+/**
+ * durable root 接受前等待 Editor 离开瞬时 transition。
+ * 该循环只读取 editor.state，不提交业务 effect，也不会重放任何 root。
+ */
+export declare function waitForEditorTransitionEnd(context: EditorReadinessContext, requestId: string, deadlineMs: number): Promise<EditorStateResult>;
+export {};

package/dist/tools/editor/readiness.js

@@ -0,0 +1,24 @@
+import { readEditorState } from "./state.js";
+/**
+ * durable root 接受前等待 Editor 离开瞬时 transition。
+ * 该循环只读取 editor.state，不提交业务 effect，也不会重放任何 root。
+ */
+export async function waitForEditorTransitionEnd(context, requestId, deadlineMs) {
+    for (;;) {
+        const state = await readEditorState({
+            requestId,
+            flags: context.flags,
+            dataDir: context.dataDir,
+            rootAdmission: context.rootAdmission,
+            bridgeExecute: context.bridgeExecute,
+            absoluteDeadlineMs: deadlineMs,
+        });
+        if (state.status !== "transitioning")
+            return state;
+        const remainingMs = deadlineMs - Date.now();
+        if (remainingMs <= 0)
+            return state;
+        await new Promise((resolveDelay) => setTimeout(resolveDelay, Math.min(250, remainingMs)));
+    }
+}
+//# sourceMappingURL=readiness.js.map

package/dist/tools/editor/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../../src/tools/editor/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AASrE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAA+B,EAC/B,SAAiB,EACjB,UAAkB;IAElB,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC;YAClC,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,kBAAkB,EAAE,UAAU;SACtB,CAAC,CAAC;QACZ,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe;YAAE,OAAO,KAAK,CAAC;QAEnD,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,IAAI,OAAO,CAAO,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}

package/dist/tools/editor/refresh.d.ts

@@ -0,0 +1,25 @@
+export interface EditorRefreshRequest {
+    compile?: boolean;
+}
+export interface EditorRefreshResult {
+    changed: boolean;
+    compilationTriggered: boolean;
+    sourceFileCount: number;
+    sourceFingerprint: string;
+    dependencyVersion: string;
+    editorState: {
+        status: "ready";
+        compile: false;
+        import: false;
+    };
+}
+export interface EditorRefreshDryRunResult {
+    dryRun: true;
+    plannedEffects: Array<{
+        type: "asset-refresh";
+    } | {
+        type: "script-compile";
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<EditorRefreshRequest, EditorRefreshResult | EditorRefreshDryRunResult>;
+export default _default;

package/dist/tools/editor/refresh.js

@@ -0,0 +1,154 @@
+import { createHash } from "node:crypto";
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withTransitionBinding } from "../../bridge/types.js";
+import { defineTool } from "../define.js";
+import { waitForEditorTransitionEnd } from "./readiness.js";
+import { rejectUnavailableEditorState } from "./state.js";
+import { blockersFromDetails, StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "editor.refresh",
+    summary: "Refresh the open Unity Editor and return stable import and compile readback.",
+    description: "Refreshes assets in the selected live Editor once, then waits for import and compilation to become stable. compile=true requests script compilation once after Refresh returns; compilationTriggered reports only a compilation cycle actually observed by Unity.",
+    group: "editor",
+    target: "editor",
+    destructiveHint: false,
+    supportsDryRun: true,
+    timeoutMs: 120_000,
+    playModeSupport: "editor-only",
+    sideEffects: ["asset-refresh", "script-compile", "domain-reload"],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [
+        { description: "Refresh the current open Editor.", argv: ["tools", "run", "editor.refresh"] },
+        { description: "Refresh and request script compilation.", argv: ["tools", "run", "editor.refresh", "--input", "{\"compile\":true}"] },
+    ],
+    async execute(request, context) {
+        if (context.execution.dryRun) {
+            return {
+                dryRun: true,
+                plannedEffects: request.compile
+                    ? [{ type: "asset-refresh" }, { type: "script-compile" }]
+                    : [{ type: "asset-refresh" }],
+            };
+        }
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 30_000);
+        const state = await waitForEditorTransitionEnd(context, childId(context.requestId, "_refresh_state"), deadline);
+        if (state.status === "blocked") {
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot refresh assets.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        }
+        rejectUnavailableEditorState(state, "editor.refresh");
+        if (!state.session.known || !state.session.editorSessionId) {
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "editor.refresh could not bind one verified Editor session.", ["Inspect editor.state and retry after the session is stable."]);
+        }
+        if (state.status !== "ready") {
+            throw new StructuredToolError("E_UNITY_TRANSITIONING", "editor.refresh requires a stable Editor generation.", ["Wait for editor.state to become ready, then retry."], undefined, true, 250);
+        }
+        if (state.state.playMode.value !== "edit") {
+            throw new StructuredToolError("E_TOOL_PLAYMODE_UNAVAILABLE", "editor.refresh is editor-only and cannot run in Play Mode.", ["Exit Play Mode before running editor.refresh."], { toolName: "editor.refresh", playModeSupport: "editor-only" }, false, 0);
+        }
+        const flags = { ...(context.flags ?? {}), instance: state.identity.instanceId };
+        const execute = withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline });
+        const observe = withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline });
+        let accepted = false;
+        let root;
+        try {
+            root = record((await bridge(context.requestId, "internal.editor.refresh.start", {
+                compile: request.compile === true,
+                expectedEditorSessionId: state.session.editorSessionId,
+            }, flags, context, execute)).data);
+            accepted = root.accepted === true || root.terminal === true;
+        }
+        catch (error) {
+            throw bridgeError(error);
+        }
+        // 已被 durable root 接受后，任何轮询/transport 失败都不能改写为普通失败。
+        if (root.terminal !== true) {
+            if (root.terminal !== false || root.accepted !== true)
+                throw invalid();
+            const rootRequestDigest = typeof root.rootRequestDigest === "string" && /^[a-f0-9]{64}$/.test(root.rootRequestDigest) ? root.rootRequestDigest : undefined;
+            if (!rootRequestDigest)
+                throw invalid();
+            accepted = true;
+            const statusId = childId(context.requestId, "_refresh_status");
+            while (root.terminal !== true) {
+                if (Date.now() >= deadline)
+                    throw executionTimeout("E_EXECUTION_TIMEOUT");
+                await delay(100);
+                try {
+                    root = record((await bridge(statusId, "internal.editor.refresh.status", { rootRequestId: context.requestId, rootRequestDigest }, flags, context, observe)).data);
+                }
+                catch (error) {
+                    throw executionTimeoutFrom(error);
+                }
+            }
+        }
+        try {
+            return terminalResult(root, context.requestId);
+        }
+        catch (error) {
+            if (accepted && !(error instanceof StructuredToolError && error.code !== "E_TOOL_COMPLETION_PROOF_INVALID"))
+                throw error;
+            throw error;
+        }
+    },
+});
+async function bridge(requestId, command, input, flags, context, invocation) {
+    const result = await executeBridgePayload(requestId, command, input, flags, {
+        dataDir: context.dataDir,
+        rootAdmission: context.rootAdmission,
+        bridgeExecute: context.bridgeExecute,
+    }, undefined, invocation);
+    if (!result.ok)
+        throw StructuredToolError.from(result.error ?? { code: "BRIDGE_CONNECTION_FAILED", message: "Live refresh bridge failed." });
+    return { data: result.data };
+}
+function terminalResult(root, requestId) {
+    const envelope = record(root.rootEnvelope);
+    if (envelope.requestId !== requestId || typeof envelope.ok !== "boolean")
+        throw invalid();
+    if (envelope.ok !== true) {
+        const error = record(envelope.error);
+        throw new StructuredToolError(typeof error.code === "string" ? error.code : "E_EXECUTION_TIMEOUT", typeof error.message === "string" ? error.message : "Refresh failed without a structured terminal.", stringArray(error.nextActions), recordOrUndefined(error.details), typeof error.transient === "boolean" ? error.transient : undefined, typeof error.retryAfterMs === "number" ? error.retryAfterMs : undefined);
+    }
+    const data = record(envelope.data);
+    const editor = record(data.editorState);
+    if (typeof data.changed !== "boolean" || typeof data.compilationTriggered !== "boolean"
+        || !nonnegativeInteger(data.sourceFileCount) || !sha256(data.sourceFingerprint)
+        || !sha256(data.dependencyVersion) || editor.status !== "ready" || editor.compile !== false || editor.import !== false)
+        throw invalid();
+    return {
+        changed: data.changed,
+        compilationTriggered: data.compilationTriggered,
+        sourceFileCount: data.sourceFileCount,
+        sourceFingerprint: data.sourceFingerprint,
+        dependencyVersion: data.dependencyVersion,
+        editorState: { status: "ready", compile: false, import: false },
+    };
+}
+function bridgeError(error) {
+    return error instanceof StructuredToolError
+        ? error
+        : new StructuredToolError("BRIDGE_CONNECTION_FAILED", "Live refresh bridge failed.");
+}
+function executionTimeoutFrom(error) {
+    const cause = bridgeError(error);
+    const blockers = blockersFromDetails(cause.details);
+    return new StructuredToolError("E_EXECUTION_TIMEOUT", "editor.refresh did not return a terminal result before the request deadline.", ["Inspect editor.state before deciding whether to submit a new request."], {
+        causeCode: cause.code,
+        ...(blockers ? { blockers } : {}),
+    }, false, 0);
+}
+function executionTimeout(causeCode) {
+    return new StructuredToolError("E_EXECUTION_TIMEOUT", "editor.refresh did not return a terminal result before the request deadline.", ["Inspect editor.state before deciding whether to submit a new request."], { causeCode }, false, 0);
+}
+function invalid() {
+    return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "editor.refresh did not return a stable terminal readback.", ["Inspect UnityCliBridge.log before retrying."]);
+}
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function recordOrUndefined(value) { const result = record(value); return Object.keys(result).length > 0 ? result : undefined; }
+function stringArray(value) { return Array.isArray(value) ? value.filter((item) => typeof item === "string") : []; }
+function sha256(value) { return typeof value === "string" && /^[a-f0-9]{64}$/i.test(value); }
+function nonnegativeInteger(value) { return typeof value === "number" && Number.isSafeInteger(value) && value >= 0; }
+function childId(root, suffix) { return root.length + suffix.length <= 200 ? root + suffix : `${root.slice(0, 160)}_${createHash("sha256").update(root).digest("hex").slice(0, 24)}${suffix}`; }
+function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }
+//# sourceMappingURL=refresh.js.map

package/dist/tools/editor/refresh.js.map

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

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

@@ -0,0 +1,63 @@
+import { inspectProjectProcessClaims, selectObservationInstanceForFlags, verifyRegistrySessionProcess, type ProjectProcessClaimInspection, type RegistryIdentity, type RegistrySession, type SessionProcessVerification } from "../../instances.js";
+import { EditorBlockerObserver, type EditorBlocker, type EditorBlockerObservation } from "../../editor-blocker-observer.js";
+import type { AnyJson } from "../../schema/any-json.js";
+import { type ToolContext } from "../define.js";
+export interface EditorStateRequest {
+}
+type Freshness = "live" | "fresh" | "stale" | "unknown";
+type ObservedField = {
+    known: boolean;
+    value?: AnyJson;
+};
+export interface EditorStateProgress {
+    kind: string;
+    title: string;
+    value?: number | null;
+    canWait: boolean;
+    source: "unity" | "registry";
+}
+export type EditorStateBlocker = EditorBlocker;
+export interface EditorStateResult {
+    identity: {
+        instanceId: string;
+        canonicalProjectPath: string;
+        displayProjectPath: string;
+    };
+    session: {
+        known: boolean;
+        editorSessionId: string | null;
+    };
+    status: "ready" | "transitioning" | "blocked" | "unresponsive" | "unverifiable" | "offline" | "conflict";
+    state: {
+        compile: ObservedField;
+        import: ObservedField;
+        build: ObservedField;
+        playMode: ObservedField;
+        prefabStage: ObservedField;
+        activeScene: ObservedField;
+        runtime: ObservedField;
+    };
+    progress: EditorStateProgress[];
+    blockers: EditorStateBlocker[];
+    observation: {
+        freshness: Freshness;
+    };
+}
+type EditorStateReadContext = Pick<ToolContext, "requestId" | "flags" | "dataDir" | "rootAdmission" | "bridgeExecute"> & Partial<Pick<ToolContext, "absoluteDeadlineMs">>;
+interface EditorStateReadDependencies {
+    selectObservation?: typeof selectObservationInstanceForFlags;
+    verifySession?: typeof verifyRegistrySessionProcess;
+    inspectClaims?: typeof inspectProjectProcessClaims;
+    observer?: Pick<EditorBlockerObserver, "observe">;
+}
+declare const _default: import("../define.js").ToolDefinition<EditorStateRequest, EditorStateResult>;
+export default _default;
+/** 聚合路径完全只读，总预算固定；任一 snapshot 只可单独作为状态字段来源。 */
+export declare function readEditorState(context: EditorStateReadContext, dependencies?: EditorStateReadDependencies): Promise<EditorStateResult>;
+/** 将身份与可响应性终态映射为稳定公开错误；blocked/transitioning 仍由具体业务决定。 */
+export declare function rejectUnavailableEditorState(state: EditorStateResult, operation: string): void;
+/**
+ * registry fallback 只有在 session PID、project claim 与 start identity 全部一致后才允许 UIAutomation。
+ * 任何多 PID、不可验证或 PID 复用迹象都在 observer 调用前 fail closed。
+ */
+export declare function observeVerifiedRegistrySession(identity: RegistryIdentity, session: RegistrySession, deadlineMs: number, verification: SessionProcessVerification, processClaims: ProjectProcessClaimInspection, observer?: Pick<EditorBlockerObserver, "observe">): Promise<EditorBlockerObservation>;