@alpsckr/unitycli 0.4.0

package/dist/tools/occlusion/live.js

@@ -0,0 +1,201 @@
+import { createHash } from "node:crypto";
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withTransitionBinding } from "../../bridge/types.js";
+import { waitForEditorTransitionEnd } from "../editor/readiness.js";
+import { rejectUnavailableEditorState } from "../editor/state.js";
+import { blockerNextActions, blockerTimeoutMessage, blockersFromDetails, StructuredToolError } from "../errors.js";
+/** 以一个公开requestId启动Occlusion durable root，只在terminal scene/Umbra proof后返回。 */
+export async function runOcclusionBake(input, context) {
+    const binding = await bind(context, "occlusion.bake", true);
+    const deadline = deadlineOf(context);
+    const request = { expectedEditorSessionId: binding.sessionId, ...input };
+    if (context.execution.dryRun) {
+        const planned = await call(childId(context.requestId, "_occlusion_plan"), "internal.occlusion.bake.plan", request, binding.flags, context, withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline }));
+        return normalizeDryRun(record(planned.data));
+    }
+    const execute = withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline });
+    const observe = withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline });
+    let accepted = false;
+    let terminalReceived = false;
+    try {
+        let root = record((await call(context.requestId, "internal.occlusion.bake.start", request, binding.flags, context, execute)).data);
+        accepted = root.accepted === true || root.terminal === true;
+        const rootRequestDigest = root.terminal === true ? undefined : typeof root.rootRequestDigest === "string" && /^[a-f0-9]{64}$/.test(root.rootRequestDigest) ? root.rootRequestDigest : undefined;
+        if (root.terminal !== true && !rootRequestDigest)
+            throw invalid("start omitted its exact root digest");
+        while (root.terminal !== true) {
+            if (root.terminal !== false || root.accepted !== true)
+                throw invalid("start returned neither acceptance nor a root terminal");
+            if (Date.now() >= deadline)
+                throw timeout("occlusion.bake", "E_EXECUTION_TIMEOUT");
+            await delay(Math.min(100, Math.max(1, deadline - Date.now())));
+            root = record((await call(childId(context.requestId, "_occlusion_status"), "internal.occlusion.bake.status", { rootRequestId: context.requestId, rootRequestDigest }, binding.flags, context, observe)).data);
+        }
+        terminalReceived = true;
+        return terminal(root, context.requestId);
+    }
+    catch (error) {
+        if (terminalReceived || !accepted || (error instanceof StructuredToolError && error.code === "E_EXECUTION_TIMEOUT"))
+            throw error;
+        const cause = error instanceof StructuredToolError ? error : undefined;
+        throw timeout("occlusion.bake", cause?.code ?? "BRIDGE_CONNECTION_FAILED", cause?.details);
+    }
+}
+/** 读取当前process session的有界Occlusion状态，不获取mutation lease。 */
+export async function readOcclusionBakeStatus(context) {
+    const deadline = deadlineOf(context);
+    const flags = { ...(context.flags ?? {}) };
+    const response = await call(childId(context.requestId, "_occlusion_snapshot"), "internal.occlusion.bake.snapshot", {}, flags, context, withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline }));
+    return normalizeStatus(record(response.data));
+}
+/** 冻结exact operationId；仅queued operation可到达cancelled terminal，running返回false。 */
+export async function cancelOcclusionBake(requestedOperationId, context) {
+    const deadline = deadlineOf(context);
+    const flags = { ...(context.flags ?? {}) };
+    const observe = withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline });
+    let status;
+    let operationId = requestedOperationId;
+    if (operationId === undefined) {
+        status = normalizeStatus(record((await call(childId(context.requestId, "_occlusion_cancel_snapshot"), "internal.occlusion.bake.snapshot", {}, flags, context, observe)).data));
+        if (!status.active || status.state !== "running" || !status.operationId)
+            return { cancelled: false, operationId: null, status };
+        operationId = status.operationId;
+    }
+    await context.commitEffect?.();
+    const cancellation = record((await call(childId(context.requestId, "_occlusion_cancel"), "internal.occlusion.bake.cancel", { operationId }, flags, context, withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline }))).data);
+    status = normalizeStatus(record(cancellation.status));
+    if (cancellation.cancelled !== true)
+        return { cancelled: false, operationId, status };
+    if (!status.active && status.operationId === operationId && status.state === "cancelled")
+        return { cancelled: true, operationId, status };
+    if (!status.active && status.operationId === operationId && status.state === "failed")
+        throw timeout("occlusion.bake-cancel", "E_EXECUTION_TIMEOUT");
+    while (Date.now() < deadline) {
+        status = normalizeStatus(record((await call(childId(context.requestId, "_occlusion_cancel_readback"), "internal.occlusion.bake.snapshot", {}, flags, context, observe)).data));
+        if (!status.active && status.operationId === operationId && status.state === "cancelled")
+            return { cancelled: true, operationId, status };
+        if (!status.active && status.operationId === operationId && status.state === "failed")
+            throw timeout("occlusion.bake-cancel", "E_EXECUTION_TIMEOUT");
+        await delay(Math.min(100, Math.max(1, deadline - Date.now())));
+    }
+    throw timeout("occlusion.bake-cancel", "E_EXECUTION_TIMEOUT");
+}
+async function bind(context, tool, requireEditMode) {
+    const deadline = deadlineOf(context);
+    const state = await waitForEditorTransitionEnd(context, childId(context.requestId, "_occlusion_state"), deadline);
+    if (state.status === "blocked")
+        throw new StructuredToolError("E_UNITY_BLOCKED", `${tool} cannot run while the Editor is blocked.`, ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+    rejectUnavailableEditorState(state, tool);
+    if (!state.session.known || !state.session.editorSessionId)
+        throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", `${tool} could not bind one verified Editor session.`, ["Inspect editor.state and retry after the session is stable."]);
+    if (requireEditMode && isPlaying(state.state.playMode.value))
+        throw new StructuredToolError("E_TOOL_PLAYMODE_UNAVAILABLE", `${tool} is available only in Edit Mode.`, ["Exit Play Mode, then retry."]);
+    return { flags: { ...(context.flags ?? {}), instance: state.identity.instanceId }, sessionId: state.session.editorSessionId };
+}
+async function call(requestId, command, input, flags, context, invocation) {
+    const response = await executeBridgePayload(requestId, command, input, flags, { dataDir: context.dataDir, rootAdmission: context.rootAdmission, bridgeExecute: context.bridgeExecute }, undefined, invocation);
+    if (!response.ok)
+        throw StructuredToolError.from(response.error ?? { code: "BRIDGE_CONNECTION_FAILED", message: "Occlusion bridge command failed." });
+    return { data: response.data };
+}
+function terminal(root, requestId) {
+    const envelope = record(root.rootEnvelope);
+    if (envelope.requestId !== requestId || typeof envelope.ok !== "boolean")
+        throw invalid("returned an invalid root terminal envelope");
+    if (envelope.ok !== true) {
+        const error = record(envelope.error);
+        throw new StructuredToolError(string(error.code) ?? "E_EXECUTION_TIMEOUT", string(error.message) ?? "Occlusion bake failed without a structured terminal.", strings(error.nextActions), optionalRecord(error.details), error.transient === true, integer(error.retryAfterMs) ? error.retryAfterMs : 0);
+    }
+    return normalizeTerminal(record(envelope.data));
+}
+function normalizeDryRun(value) {
+    const targetCount = nonnegative(value.targetCount);
+    const scenes = Array.isArray(value.scenes) ? value.scenes.map(normalizeScene) : undefined;
+    const effectiveSettings = normalizeSettings(record(value.effectiveSettings));
+    const before = normalizeSnapshot(record(value.before));
+    const effects = normalizeEffects(value.plannedEffects, targetCount);
+    if (value.dryRun !== true || targetCount === undefined || targetCount === 0 || !scenes || scenes.length !== targetCount || !effectiveSettings || !before || !effects)
+        throw invalid("returned an invalid dry-run plan");
+    return { dryRun: true, targetCount, scenes, effectiveSettings, before, plannedEffects: effects };
+}
+function normalizeTerminal(value) {
+    const durationMs = nonnegative(value.durationMs);
+    const effectiveSettings = normalizeSettings(record(value.effectiveSettings));
+    const before = normalizeSnapshot(record(value.before));
+    const after = normalizeSnapshot(record(value.after));
+    const scenes = Array.isArray(value.scenes) ? value.scenes.map(normalizeScene) : undefined;
+    const effects = normalizeEffects(value.plannedEffects, scenes?.length);
+    if (!string(value.operationId) || value.status !== "completed" || !timestamp(value.startedAt) || !timestamp(value.finishedAt)
+        || Date.parse(value.finishedAt) < Date.parse(value.startedAt) || durationMs === undefined || !effectiveSettings || !before || !after
+        || !scenes || scenes.length === 0 || !effects || !sameSettings(effectiveSettings, after.settings))
+        throw invalid("returned an invalid business terminal");
+    return { operationId: value.operationId, status: "completed", startedAt: value.startedAt, finishedAt: value.finishedAt, durationMs, effectiveSettings, before, after, scenes, plannedEffects: effects };
+}
+function normalizeStatus(value) {
+    const states = new Set(["idle", "running", "completed", "cancelled", "failed"]);
+    const phases = new Set(["queued", "starting", "baking", "terminal", "unknown"]);
+    const durationMs = nonnegative(value.durationMs);
+    const targetCount = nonnegative(value.targetCount);
+    const umbraDataSizeBytes = nonnegative(value.umbraDataSizeBytes);
+    const settings = normalizeObservedSettings(record(value.settings));
+    const progress = value.progress === null ? null : finiteRange(value.progress, 0, 1);
+    if (!states.has(value.state) || typeof value.active !== "boolean" || durationMs === undefined || targetCount === undefined || umbraDataSizeBytes === undefined
+        || typeof value.doesSceneHaveManualPortals !== "boolean" || !settings || progress === undefined || (value.operationId !== null && !string(value.operationId))
+        || (value.phase !== null && !phases.has(value.phase)) || (value.startedAt !== null && !timestamp(value.startedAt)) || (value.finishedAt !== null && !timestamp(value.finishedAt))
+        || (value.state === "running") !== value.active || (value.active && !string(value.operationId)))
+        throw invalid("returned an invalid status snapshot");
+    return value;
+}
+function normalizeSettings(value) {
+    const smallestOccluder = finiteRange(value.smallestOccluder, 0.000001, 1_000_000);
+    const smallestHole = finiteRange(value.smallestHole, 0.000001, 1_000_000);
+    const backfaceThreshold = finiteRange(value.backfaceThreshold, 1, 100);
+    return smallestOccluder !== undefined && smallestHole !== undefined && backfaceThreshold !== undefined ? { smallestOccluder, smallestHole, backfaceThreshold } : undefined;
+}
+/** status是Unity当前值的只读观察，不把mutation输入下限误用于cancel前置读取。 */
+function normalizeObservedSettings(value) {
+    const smallestOccluder = finiteRange(value.smallestOccluder, 0, 1_000_000);
+    const smallestHole = finiteRange(value.smallestHole, 0, 1_000_000);
+    const backfaceThreshold = finiteRange(value.backfaceThreshold, 0, 100);
+    return smallestOccluder !== undefined && smallestHole !== undefined && backfaceThreshold !== undefined ? { smallestOccluder, smallestHole, backfaceThreshold } : undefined;
+}
+function normalizeSnapshot(value) {
+    const umbraDataSizeBytes = nonnegative(value.umbraDataSizeBytes);
+    const settings = normalizeSettings(record(value.settings));
+    return umbraDataSizeBytes !== undefined && typeof value.doesSceneHaveManualPortals === "boolean" && settings ? { umbraDataSizeBytes, doesSceneHaveManualPortals: value.doesSceneHaveManualPortals, settings } : undefined;
+}
+function normalizeScene(value) {
+    const item = record(value);
+    if (!string(item.path) || !String(item.path).startsWith("Assets/") || !String(item.path).endsWith(".unity") || !/^[a-f0-9]{32}$/.test(String(item.guid)) || !sha(item.sha256) || !positive(item.sizeBytes) || item.dirty !== false)
+        throw invalid("returned an invalid scene persistence proof");
+    return item;
+}
+function normalizeEffects(value, targetCount) {
+    if (!Array.isArray(value) || value.length !== 1)
+        return undefined;
+    const item = record(value[0]);
+    const count = nonnegative(item.targetCount);
+    if (item.type !== "occlusion.bake" || item.target !== "open-scenes" || count === undefined || count === 0 || (targetCount !== undefined && count !== targetCount))
+        return undefined;
+    return [{ type: "occlusion.bake", target: "open-scenes", targetCount: count }];
+}
+function sameSettings(left, right) { return close(left.smallestOccluder, right.smallestOccluder) && close(left.smallestHole, right.smallestHole) && close(left.backfaceThreshold, right.backfaceThreshold); }
+function close(left, right) { return Math.abs(left - right) <= 0.00001; }
+function deadlineOf(context) { return context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 30_000); }
+function timeout(tool, causeCode, details) { const blockers = blockersFromDetails(details); return new StructuredToolError("E_EXECUTION_TIMEOUT", blockerTimeoutMessage(tool, blockers), blockers ? blockerNextActions() : ["Run occlusion.bake-status and inspect the affected scenes before deciding whether to submit a new request."], { causeCode, ...(blockers ? { blockers } : {}) }, false, 0); }
+function invalid(reason) { return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", `Occlusion coordinator ${reason}.`, ["Inspect UnityCliBridge.log and occlusion.bake-status before retrying."]); }
+function childId(root, suffix) { if (root.length + suffix.length <= 200)
+    return root + suffix; return `${root.slice(0, 160)}_${createHash("sha256").update(root).digest("hex").slice(0, 24)}${suffix}`; }
+function isPlaying(value) { const item = record(value); return value === "play" || value === "playing" || value === "transitioning" || item.isPlaying === true || item.isPlayingOrWillChangePlaymode === true; }
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function optionalRecord(value) { const item = record(value); return Object.keys(item).length ? item : undefined; }
+function string(value) { return typeof value === "string" && value.length > 0 ? value : undefined; }
+function strings(value) { return Array.isArray(value) ? value.filter((item) => typeof item === "string") : []; }
+function integer(value) { return typeof value === "number" && Number.isSafeInteger(value) && value >= 0; }
+function nonnegative(value) { return integer(value) ? value : undefined; }
+function positive(value) { return typeof value === "number" && Number.isSafeInteger(value) && value > 0; }
+function finiteRange(value, min, max) { return typeof value === "number" && Number.isFinite(value) && value >= min && value <= max ? value : undefined; }
+function timestamp(value) { return typeof value === "string" && Number.isFinite(Date.parse(value)); }
+function sha(value) { return typeof value === "string" && /^[a-f0-9]{64}$/i.test(value); }
+function delay(ms) { return new Promise(resolve => setTimeout(resolve, ms)); }
+//# sourceMappingURL=live.js.map

package/dist/tools/occlusion/live.js.map

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

package/dist/tools/package/bridge-remove.d.ts

@@ -0,0 +1,26 @@
+export interface PackageBridgeRemoveRequest {
+    project?: string;
+}
+export interface PackageBridgeRemovePlannedEffect {
+    type?: string;
+    package?: string;
+    bridgePath?: string;
+    installMetadataPath?: string;
+    managedFileCount?: number;
+    previousVersion?: string;
+}
+export interface PackageBridgeRemoveResult {
+    action: "bridge-remove";
+    projectPath: string;
+    manifestPath: string;
+    bridgePath: string;
+    dependencyName: string;
+    packageVersion: string;
+    installMetadataPath: string;
+    fileManifestPath: string;
+    managedFileCount: number;
+    dryRun: boolean;
+    plannedEffects: PackageBridgeRemovePlannedEffect[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageBridgeRemoveRequest, PackageBridgeRemoveResult>;
+export default _default;

package/dist/tools/package/bridge-remove.js

@@ -0,0 +1,32 @@
+import { resolve } from "node:path";
+import { removePackageBridge } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+// 执行真正的 Bridge 移除；destructive 确认由 tools run 分发层在进入 defineTool 前完成。
+async function runPackageBridgeRemove(request, context) {
+    const projectPath = resolve(request.project ?? context.projectPath);
+    const prepared = await removePackageBridge(projectPath, { dryRun: true });
+    if (context.execution.dryRun)
+        return { action: "bridge-remove", ...prepared };
+    await context.commitEffect?.();
+    const removal = await removePackageBridge(projectPath);
+    return { action: "bridge-remove", ...removal };
+}
+export default defineTool({
+    name: "package.bridge-remove",
+    summary: "Remove the copied com.alpsckr.unitycli Bridge package installed by init.",
+    description: "Remove the copied com.alpsckr.unitycli Bridge package installed by init. Destructive: deletes Packages/com.alpsckr.unitycli and unitycli.install.json. Supports --dry-run to preview deleted files without changing the project. Use this only when intentionally uninstalling the UnityCLI Bridge from a project.",
+    group: "package",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["project-file-delete", "session-affecting"],
+    playModeSupport: "session-affecting",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Preview Bridge package removal", argv: ["tools", "run", "package.bridge-remove", "--input", "{\"project\":\".\"}", "--dry-run"] }
+    ],
+    async execute(request, context) {
+        return runPackageBridgeRemove(request, context);
+    }
+});
+//# sourceMappingURL=bridge-remove.js.map

package/dist/tools/package/bridge-remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-remove.js","sourceRoot":"","sources":["../../../src/tools/package/bridge-remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AA6B5D,mEAAmE;AACnE,KAAK,UAAU,sBAAsB,CAAC,OAAmC,EAAE,OAAoB;IAC7F,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9E,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,eAAe,UAAU,CAAwD;IAC/E,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,0EAA0E;IACnF,WAAW,EAAE,oTAAoT;IACjU,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;IACzD,eAAe,EAAE,mBAAmB;IACpC,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,CAAC,EAAE;KAClJ;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,OAAO,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/deploy.d.ts

@@ -0,0 +1,49 @@
+import { type LiveResolveResult } from "./live-resolve.js";
+export interface PackageDeployRequest {
+    source: string;
+    packageName?: string;
+}
+export interface PackageDeployPlannedEffect {
+    type?: string;
+    package?: string;
+    from?: string;
+    to?: string;
+    targetPath?: string;
+    packageVersion?: string | null;
+    fileCount?: number;
+    reason?: string;
+}
+export interface PackageDeployFilesProof {
+    proven: true;
+    targetPath: string;
+    sourceHash: string;
+    targetHash: string;
+    copiedFileCount: number;
+    metadataPath: string;
+    metadataHash: string;
+    backupPath?: string;
+    backupHash?: string;
+    backupPackageVersion?: string;
+}
+export interface PackageDeployResult {
+    action: string;
+    status: string;
+    manifestPath: string;
+    packageName: string;
+    packageVersion: string;
+    sourcePath: string;
+    sourceHash: string;
+    targetPath: string;
+    backupPath?: string;
+    backupPackageVersion?: string;
+    backupCreated: boolean;
+    repeatedDeployment: boolean;
+    copiedFileCount: number;
+    dryRun: boolean;
+    plannedEffects: PackageDeployPlannedEffect[];
+    metadataPath: string;
+    files?: PackageDeployFilesProof;
+    resolve?: LiveResolveResult;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageDeployRequest, PackageDeployResult>;
+export default _default;

package/dist/tools/package/deploy.js

@@ -0,0 +1,134 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { deployPackageSource, hashPackageTree, inspectPackageDeploymentFiles } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+import { runPackageFileMutationWorker } from "./file-mutation-worker.js";
+import { bindLivePackageProject, runLivePackageResolve } from "./live-resolve.js";
+import { projectRelativePath, publicPackageEffects } from "./public-result.js";
+/** deploy 的 backup/copy、Resolve 与 PackageInfo readback 共用一个 durable root。 */
+async function runPackageDeploy(request, context) {
+    if (context.execution.dryRun) {
+        await bindLivePackageProject(context, "deploy");
+        const projectPath = resolve(context.projectPath);
+        const prepared = await deployPackageSource(projectPath, request.source, { packageName: request.packageName, dryRun: true });
+        return publicDeployResult(projectPath, request.source, "dry_run", prepared);
+    }
+    return runLivePackageResolve(context, "deploy", { source: request.source, packageName: request.packageName }, {
+        async prepare(signal) {
+            const projectPath = resolve(context.projectPath);
+            signal.throwIfAborted();
+            const prepared = await deployPackageSource(projectPath, request.source, { packageName: request.packageName, dryRun: true });
+            const observed = await inspectPackageDeploymentFiles(projectPath, prepared.packageName, prepared.targetPath, prepared.backupPath);
+            signal.throwIfAborted();
+            return {
+                ...prepared,
+                requestedSource: request.source,
+                requestedPackageName: request.packageName ?? null,
+                previousTargetExists: observed.targetExists,
+                previousTargetHash: observed.targetHash,
+                previousRecordIdentity: observed.recordIdentity,
+                previousBackupExists: observed.backupExists,
+                previousBackupHash: observed.backupHash,
+            };
+        },
+        async apply(plan, signal, stopAtMs) {
+            const projectPath = resolve(context.projectPath);
+            const expected = deployPlan(plan);
+            const deployed = await runPackageFileMutationWorker("deploy", projectPath, plan, stopAtMs, signal);
+            return deployBundle(projectPath, expected, deployed);
+        },
+        async recover(plan, signal) {
+            const projectPath = resolve(context.projectPath);
+            signal.throwIfAborted();
+            const expected = deployPlan(plan);
+            const bundle = await deployBundle(projectPath, expected, { ...expected, dryRun: false });
+            signal.throwIfAborted();
+            return bundle;
+        },
+    });
+}
+async function deployBundle(projectPath, plan, deployed) {
+    if (deployed.packageName !== plan.packageName || deployed.packageVersion !== plan.packageVersion
+        || deployed.sourceHash !== plan.sourceHash || deployed.targetPath !== plan.targetPath
+        || (deployed.backupPath ?? null) !== (plan.backupPath ?? null)
+        || deployed.backupCreated !== plan.backupCreated || deployed.repeatedDeployment !== plan.repeatedDeployment
+        || deployed.copiedFileCount !== plan.copiedFileCount) {
+        throw new Error("Deployed package does not match its durable file plan.");
+    }
+    const observed = await inspectPackageDeploymentFiles(projectPath, plan.packageName, plan.targetPath, plan.backupPath);
+    const currentSourceHash = await hashPackageTree(plan.sourcePath);
+    if (!observed.targetExists || observed.targetHash !== plan.sourceHash || observed.targetFileCount !== plan.copiedFileCount || currentSourceHash !== plan.sourceHash)
+        throw new Error("Deployed package target does not match the committed source tree.");
+    if (!observed.record || observed.record.packageName !== plan.packageName || observed.record.packageVersion !== plan.packageVersion
+        || observed.record.sourcePath !== plan.sourcePath || observed.record.sourceHash !== plan.sourceHash || observed.record.targetPath !== plan.targetPath
+        || (observed.record.backupPath ?? null) !== (plan.backupPath ?? null)
+        || (observed.record.backupPackageVersion ?? null) !== (plan.backupPackageVersion ?? null))
+        throw new Error("Package deployment metadata does not match the committed plan.");
+    const expectedBackupHash = plan.backupCreated ? plan.previousTargetHash : plan.previousBackupHash;
+    if (expectedBackupHash && observed.backupHash !== expectedBackupHash)
+        throw new Error("Package deployment backup does not match its committed pre-state.");
+    const manifestHash = await hash(plan.manifestPath);
+    const files = {
+        proven: true, targetPath: plan.targetPath, sourceHash: plan.sourceHash, targetHash: observed.targetHash,
+        copiedFileCount: observed.targetFileCount, metadataPath: observed.metadataPath, metadataHash: observed.metadataHash,
+        ...(plan.backupPath ? { backupPath: plan.backupPath } : {}), ...(observed.backupHash ? { backupHash: observed.backupHash } : {}),
+        ...(plan.backupPackageVersion ? { backupPackageVersion: plan.backupPackageVersion } : {}),
+    };
+    return {
+        expectedManifestSha256: manifestHash,
+        predicates: [{ name: plan.packageName, version: plan.packageVersion, present: true, resolvedPath: plan.targetPath }],
+        filesProof: files,
+        publicResultSeed: publicDeployResult(projectPath, plan.requestedSource, "deployed", { ...plan, dryRun: false }, files),
+    };
+}
+/** 从内部 durable 文件结果构造公开 DTO；绝对路径只保留在 journal 与完成证明中。 */
+function publicDeployResult(projectPath, requestedSource, status, deployed, files) {
+    const sourceAliases = new Map([[resolve(deployed.sourcePath), requestedSource]]);
+    const publicFiles = files ? {
+        ...files,
+        targetPath: projectRelativePath(projectPath, files.targetPath, "files.targetPath"),
+        metadataPath: projectRelativePath(projectPath, files.metadataPath, "files.metadataPath"),
+        ...(files.backupPath ? { backupPath: projectRelativePath(projectPath, files.backupPath, "files.backupPath") } : {}),
+    } : undefined;
+    return {
+        action: "deploy",
+        status,
+        manifestPath: projectRelativePath(projectPath, deployed.manifestPath, "manifestPath"),
+        packageName: deployed.packageName,
+        packageVersion: deployed.packageVersion,
+        sourcePath: requestedSource,
+        sourceHash: deployed.sourceHash,
+        targetPath: projectRelativePath(projectPath, deployed.targetPath, "targetPath"),
+        ...(deployed.backupPath ? { backupPath: projectRelativePath(projectPath, deployed.backupPath, "backupPath") } : {}),
+        ...(deployed.backupPackageVersion ? { backupPackageVersion: deployed.backupPackageVersion } : {}),
+        backupCreated: deployed.backupCreated,
+        repeatedDeployment: deployed.repeatedDeployment,
+        copiedFileCount: deployed.copiedFileCount,
+        dryRun: deployed.dryRun,
+        plannedEffects: publicPackageEffects(projectPath, deployed.plannedEffects, sourceAliases),
+        metadataPath: projectRelativePath(projectPath, deployed.metadataPath, "metadataPath"),
+        ...(publicFiles ? { files: publicFiles } : {}),
+    };
+}
+function deployPlan(value) {
+    for (const key of ["projectPath", "manifestPath", "packageName", "packageVersion", "sourcePath", "sourceHash", "targetPath", "metadataPath", "requestedSource"])
+        if (typeof value[key] !== "string")
+            throw new Error(`Durable package.deploy file plan is missing ${key}.`);
+    if (value.requestedPackageName !== null && typeof value.requestedPackageName !== "string")
+        throw new Error("Durable package.deploy file plan has an invalid requestedPackageName.");
+    if (typeof value.backupCreated !== "boolean" || typeof value.repeatedDeployment !== "boolean" || typeof value.copiedFileCount !== "number"
+        || typeof value.previousTargetExists !== "boolean" || typeof value.previousRecordIdentity !== "string"
+        || typeof value.previousBackupExists !== "boolean" || !Array.isArray(value.plannedEffects))
+        throw new Error("Durable package.deploy file plan is corrupt.");
+    return value;
+}
+async function hash(path) { return createHash("sha256").update(await readFile(path)).digest("hex"); }
+export default defineTool({
+    name: "package.deploy", summary: "Deploy a local Unity package source folder into Packages/<packageName> with an automatic restore backup.",
+    description: "Deploy a local Unity package source folder into the target project's Packages/<packageName> directory. The source folder must contain package.json with name/version and must be outside the target project's Packages directory. If a package directory already exists, package.deploy backs it up under Packages/.unitycli_deploy_backups before copying the source. Destructive: writes project package files and can trigger Unity import/compile. Supports --dry-run to preview backup/copy effects without writing.",
+    group: "package", destructiveHint: true, supportsDryRun: true, sideEffects: ["project-file-write", "project-file-delete", "session-affecting"], playModeSupport: "session-affecting", handler: "hybrid", supportStatus: "live-bridge", timeoutMs: 120_000,
+    examples: [{ description: "Preview deploying a local package", argv: ["tools", "run", "package.deploy", "--input", "{\"source\":\"./Packages/my-package\"}", "--dry-run"] }],
+    async execute(request, context) { return runPackageDeploy(request, context); }
+});
+//# sourceMappingURL=deploy.js.map

package/dist/tools/package/deploy.js.map

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

package/dist/tools/package/embed.d.ts

@@ -0,0 +1,14 @@
+export interface PackageEmbedRequest {
+    package: string;
+}
+export interface PackageEmbedPlannedEffect {
+    type: "package.embed";
+    path: string;
+}
+export interface PackageEmbedResult {
+    packageId: string;
+    embeddedPath: string;
+    plannedEffects: PackageEmbedPlannedEffect[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageEmbedRequest, PackageEmbedResult>;
+export default _default;

package/dist/tools/package/embed.js

@@ -0,0 +1,93 @@
+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 "../editor/readiness.js";
+import { rejectUnavailableEditorState } from "../editor/state.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "package.embed",
+    summary: "Embed an installed registry package and return its verified local package readback.",
+    description: "Use PackageClient.Embed to copy an installed registry package into Packages/<id>, absorb package import/reload, and succeed only when PackageInfo reports source=Embedded and a real resolved directory. The embedded local copy replaces registry resolution until it is removed.",
+    group: "package",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["package-write"],
+    target: "editor",
+    playModeSupport: "editor-only",
+    timeoutMs: 120_000,
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [{ description: "Embed the installed ProBuilder package", argv: ["tools", "run", "package.embed", "--input", "{\"package\":\"com.unity.probuilder\"}"] }],
+    async execute(request, context) {
+        if (!request.package)
+            throw new StructuredToolError("E_PACKAGE_ID_REQUIRED", "package.embed requires --package <id>.", ["Pass a package id like com.unity.x."]);
+        if (context.execution.dryRun)
+            return { packageId: request.package, embeddedPath: `Packages/${request.package}`, plannedEffects: [{ type: "package.embed", path: request.package }] };
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 120_000);
+        const state = await waitForEditorTransitionEnd(context, childId(context.requestId, "_package_embed_state"), deadline);
+        if (state.status === "blocked")
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot embed packages.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        rejectUnavailableEditorState(state, "package.embed");
+        if (!state.session.known || !state.session.editorSessionId)
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "package.embed 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", "package.embed 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", "package.embed is editor-only and cannot run in Play Mode.", ["Exit Play Mode before running package.embed."], { toolName: "package.embed", playModeSupport: "editor-only" });
+        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 root = record((await bridge(context.requestId, "internal.package.embed.start", { ...request }, flags, context, execute)).data);
+        if (root.terminal !== true && (root.terminal !== false || root.accepted !== true))
+            throw invalid();
+        const rootRequestDigest = root.terminal === true ? undefined : typeof root.rootRequestDigest === "string" && /^[a-f0-9]{64}$/.test(root.rootRequestDigest) ? root.rootRequestDigest : undefined;
+        if (root.terminal !== true && !rootRequestDigest)
+            throw invalid();
+        while (root.terminal !== true) {
+            if (Date.now() >= deadline)
+                throw timeout();
+            await delay(100);
+            try {
+                root = record((await bridge(childId(context.requestId, "_package_embed_status"), "internal.package.embed.status", { rootRequestId: context.requestId, rootRequestDigest }, flags, context, observe)).data);
+            }
+            catch {
+                throw timeout();
+            }
+        }
+        return terminal(root, context.requestId);
+    },
+});
+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 package embed bridge failed." });
+    return { data: result.data };
+}
+function terminal(root, requestId) {
+    const envelope = record(root.rootEnvelope);
+    if (envelope.requestId !== requestId || envelope.ok !== true)
+        throw terminalError(envelope, requestId);
+    const data = record(envelope.data);
+    const effects = effectsOf(data.plannedEffects);
+    if (typeof data.packageId !== "string" || typeof data.embeddedPath !== "string" || data.embeddedPath.length === 0 || !effects || effects.length !== 1 || effects[0].path !== data.packageId)
+        throw invalid();
+    return { packageId: data.packageId, embeddedPath: data.embeddedPath, plannedEffects: effects };
+}
+function terminalError(envelope, requestId) { const error = record(envelope.error); if (envelope.requestId === requestId && envelope.ok === false && typeof error.code === "string" && typeof error.message === "string")
+    throw new StructuredToolError(error.code, error.message, strings(error.nextActions), recordOrUndefined(error.details), error.transient === true, typeof error.retryAfterMs === "number" ? error.retryAfterMs : undefined); throw invalid(); }
+function effectsOf(value) { if (!Array.isArray(value))
+    return undefined; const result = []; for (const raw of value) {
+    const effect = record(raw);
+    if (effect.type !== "package.embed" || typeof effect.path !== "string")
+        return undefined;
+    result.push({ type: "package.embed", path: effect.path });
+} return result; }
+function timeout() { return new StructuredToolError("E_EXECUTION_TIMEOUT", "package.embed did not return a terminal result before the request deadline.", ["Inspect editor.state and Package Manager before deciding whether to submit a new request."]); }
+function invalid() { return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "package.embed 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 strings(value) { return Array.isArray(value) ? value.filter((item) => typeof item === "string") : []; }
+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=embed.js.map