@alpsckr/unitycli 0.4.0

package/dist/tools/package/registry-get.d.ts

@@ -0,0 +1,10 @@
+export interface PackageRegistryGetRequest {
+    project?: string;
+}
+export interface PackageRegistryGetResult {
+    projectPath: string;
+    manifestPath: string;
+    registry?: string;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageRegistryGetRequest, PackageRegistryGetResult>;
+export default _default;

package/dist/tools/package/registry-get.js

@@ -0,0 +1,22 @@
+import { resolve } from "node:path";
+import { readSnapshot } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.registry.get",
+    summary: "Read the primary registry URL from the project manifest.",
+    description: "Read the primary registry URL from Packages/manifest.json. Offline and read-only.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Read the primary registry", argv: ["tools", "run", "package.registry.get", "--input", "{}"] }
+    ],
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const snapshot = await readSnapshot(projectPath);
+        return { projectPath, manifestPath: snapshot.manifestPath, registry: snapshot.registry };
+    }
+});
+//# sourceMappingURL=registry-get.js.map

package/dist/tools/package/registry-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-get.js","sourceRoot":"","sources":["../../../src/tools/package/registry-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAY5D,eAAe,UAAU,CAAsD;IAC7E,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,0DAA0D;IACnE,WAAW,EAAE,mFAAmF;IAChG,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;KAC9G;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC3F,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/registry-set.d.ts

@@ -0,0 +1,17 @@
+export interface PackageRegistrySetRequest {
+    url: string;
+    project?: string;
+}
+export interface PackageRegistrySetResult {
+    projectPath: string;
+    manifestPath: string;
+    registry?: string;
+    previousRegistry?: string;
+    dryRun?: boolean;
+    plannedEffects?: Array<{
+        type: string;
+        registry: string;
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageRegistrySetRequest, PackageRegistrySetResult>;
+export default _default;

package/dist/tools/package/registry-set.js

@@ -0,0 +1,28 @@
+import { resolve } from "node:path";
+import { setRegistry, validateRegistryUrl } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.registry.set",
+    summary: "Set the primary registry URL in the project manifest.",
+    description: "Set the primary registry URL in Packages/manifest.json. Supports --dry-run.",
+    group: "package",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["manifest-change"],
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Preview setting the primary registry", argv: ["tools", "run", "package.registry.set", "--input", "{\"url\":\"https://npm.example.com\"}", "--dry-run"] }
+    ],
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const registry = validateRegistryUrl(request.url);
+        const prepared = await setRegistry(projectPath, registry, { dryRun: true });
+        if (context.execution.dryRun)
+            return { projectPath, ...prepared };
+        await context.commitEffect?.();
+        return { projectPath, ...(await setRegistry(projectPath, registry)) };
+    }
+});
+//# sourceMappingURL=registry-set.js.map

package/dist/tools/package/registry-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-set.js","sourceRoot":"","sources":["../../../src/tools/package/registry-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAgB,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAgB5D,eAAe,UAAU,CAAsD;IAC7E,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,uDAAuD;IAChE,WAAW,EAAE,6EAA6E;IAC1F,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,sCAAsC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,uCAAuC,EAAE,WAAW,CAAC,EAAE;KACzK;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAA8B,CAAC;QAC9F,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC/B,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,EAA8B,CAAC;IACpG,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,47 @@
+import { type LiveResolveResult } from "./live-resolve.js";
+export interface PackageRemoveRequest {
+    name: string;
+    force?: boolean;
+}
+export interface PackageRemoveResult {
+    action: "remove";
+    package: string;
+    manifestPath: string;
+    manifestHash: string;
+    dependency: {
+        name: string;
+        present: false;
+    };
+    files: {
+        proven: true;
+        manifestPath: string;
+        manifestHash: string;
+    };
+    resolve: LiveResolveResult;
+}
+export interface PackageRemovePlannedEffect {
+    type: string;
+    package: string;
+    removedVersion?: string;
+    dependents: Array<{
+        name: string;
+        requiredVersion?: string;
+    }>;
+    forced: boolean;
+    blocked: boolean;
+}
+export interface PackageRemoveDryRunResult {
+    action: "remove";
+    package: string;
+    status: "dry_run" | "blocked";
+    dryRun: true;
+    blocked: boolean;
+    dependents: Array<{
+        name: string;
+        requiredVersion?: string;
+    }>;
+    forced: boolean;
+    plannedEffects: PackageRemovePlannedEffect[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageRemoveRequest, PackageRemoveResult | PackageRemoveDryRunResult>;
+export default _default;

package/dist/tools/package/remove.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { PackageManagerError, readUnityManifestDependencies, removePackage, validatePackageName } 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 } from "./public-result.js";
+/** manifest 删除与 UPM 终态共享一个 root，redelivery 只读验证删除结果。 */
+async function runPackageRemove(request, context) {
+    const name = validatePackageName(request.name);
+    if (context.execution.dryRun) {
+        await bindLivePackageProject(context, "remove");
+        const plan = await removePackage(context.projectPath, name, { force: request.force === true, dryRun: true });
+        return { action: "remove", package: name, status: plan.blocked ? "blocked" : "dry_run", dryRun: true, blocked: plan.blocked, dependents: plan.dependents, forced: plan.forced, plannedEffects: (plan.plannedEffects ?? []) };
+    }
+    return runLivePackageResolve(context, "remove", { name, force: request.force === true }, {
+        async prepare(signal) {
+            signal.throwIfAborted();
+            const prepared = await removePackage(context.projectPath, name, { force: request.force === true, dryRun: true });
+            signal.throwIfAborted();
+            if (prepared.blocked)
+                throw new PackageManagerError("PACKAGE_DEPENDENTS_BLOCKED", `Package ${name} is required by dependent packages.`, ["Remove dependents first or explicitly pass force=true."]);
+            return { name, force: request.force === true, manifestPath: prepared.manifestPath };
+        },
+        async apply(plan, signal, stopAtMs) {
+            const expected = removePlan(plan);
+            await runPackageFileMutationWorker("remove", context.projectPath, plan, stopAtMs, signal);
+            return removeBundle(context.projectPath, expected, expected.manifestPath);
+        },
+        async recover(plan, signal) {
+            signal.throwIfAborted();
+            const expected = removePlan(plan);
+            const bundle = await removeBundle(context.projectPath, expected, expected.manifestPath);
+            signal.throwIfAborted();
+            return bundle;
+        },
+    });
+}
+async function removeBundle(projectPath, plan, manifestPath) {
+    const dependencies = await readUnityManifestDependencies(projectPath);
+    if (Object.prototype.hasOwnProperty.call(dependencies, plan.name))
+        throw new Error(`Manifest dependency ${plan.name} remains after the committed remove plan.`);
+    const manifestHash = await hash(manifestPath);
+    const files = { proven: true, manifestPath, manifestHash };
+    const publicManifestPath = projectRelativePath(projectPath, manifestPath, "manifestPath");
+    const publicFiles = { ...files, manifestPath: publicManifestPath };
+    return {
+        expectedManifestSha256: manifestHash,
+        predicates: [{ name: plan.name, present: false }],
+        filesProof: files,
+        publicResultSeed: { action: "remove", package: plan.name, manifestPath: publicManifestPath, manifestHash, dependency: { name: plan.name, present: false }, files: publicFiles },
+    };
+}
+function removePlan(value) {
+    if (typeof value.name !== "string" || typeof value.force !== "boolean" || typeof value.manifestPath !== "string")
+        throw new Error("Durable package.remove file plan is corrupt.");
+    return { name: value.name, force: value.force, manifestPath: value.manifestPath };
+}
+async function hash(path) { return createHash("sha256").update(await readFile(path)).digest("hex"); }
+export default defineTool({
+    name: "package.remove", summary: "Remove a package and prove it absent through the open Unity Editor.",
+    description: "Writes a prevalidated manifest removal once, then requires a terminal live PackageInfo resolve proof.",
+    group: "package", destructiveHint: true, supportsDryRun: true, sideEffects: ["manifest-change", "session-affecting"], playModeSupport: "session-affecting", handler: "hybrid", supportStatus: "live-bridge", timeoutMs: 120_000,
+    examples: [{ description: "Remove a package.", argv: ["tools", "run", "package.remove", "--input", "{\"name\":\"com.unity.textmeshpro\"}"] }],
+    async execute(request, context) { return runPackageRemove(request, context); }
+});
+//# sourceMappingURL=remove.js.map

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

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

package/dist/tools/package/resolve.d.ts

@@ -0,0 +1,6 @@
+import { type LiveResolveResult } from "./live-resolve.js";
+export interface PackageResolveRequest {
+}
+export type PackageResolveResult = LiveResolveResult;
+declare const _default: import("../define.js").ToolDefinition<PackageResolveRequest, LiveResolveResult>;
+export default _default;

package/dist/tools/package/resolve.js

@@ -0,0 +1,14 @@
+import { runLivePackageResolve } from "./live-resolve.js";
+import { defineTool } from "../define.js";
+/** Resolve 调用、List fence 与 PackageInfo readback 共用公开 requestId root。 */
+async function runPackageResolve(_request, context) {
+    return runLivePackageResolve(context, "resolve", {});
+}
+export default defineTool({
+    name: "package.resolve", summary: "Resolve packages in the open Unity Editor and return PackageInfo proof.",
+    description: "Resolves the selected open Unity project through Unity PackageManager and returns only a terminal PackageInfo readback. This operation requires one verified live Editor session.",
+    group: "package", destructiveHint: true, sideEffects: ["session-affecting"], playModeSupport: "session-affecting", handler: "hybrid", supportStatus: "live-bridge", timeoutMs: 120_000,
+    examples: [{ description: "Resolve packages in the open Editor.", argv: ["tools", "run", "package.resolve"] }],
+    async execute(request, context) { return runPackageResolve(request, context); }
+});
+//# sourceMappingURL=resolve.js.map

package/dist/tools/package/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/tools/package/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA0B,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAK5D,wEAAwE;AACxE,KAAK,UAAU,iBAAiB,CAAC,QAA+B,EAAE,OAAoB;IACpF,OAAO,qBAAqB,CAAuB,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,eAAe,UAAU,CAA8C;IACrE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,yEAAyE;IAC3G,WAAW,EAAE,mLAAmL;IAChM,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,mBAAmB,CAAC,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO;IACtL,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,CAAC;IAC9G,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF,CAAC,CAAC"}

package/dist/tools/package/restore.d.ts

@@ -0,0 +1,42 @@
+import { type LiveResolveResult } from "./live-resolve.js";
+export interface PackageRestoreRequest {
+    packageName: string;
+}
+export interface PackageRestorePlannedEffect {
+    type?: string;
+    package?: string;
+    from?: string;
+    to?: string;
+    targetPath?: string;
+    fileCount?: number;
+    reason?: string;
+}
+export interface PackageRestoreFilesProof {
+    proven: true;
+    targetPath: string;
+    targetHash?: string;
+    copiedFileCount: number;
+    restoredFromBackup: boolean;
+    removedDeployedPackage: boolean;
+    backupPath?: string;
+    metadataPath: string;
+    metadataHash: string;
+}
+export interface PackageRestoreResult {
+    action: string;
+    status: string;
+    manifestPath: string;
+    packageName: string;
+    targetPath: string;
+    backupPath?: string;
+    restoredFromBackup: boolean;
+    removedDeployedPackage: boolean;
+    copiedFileCount: number;
+    dryRun: boolean;
+    plannedEffects: PackageRestorePlannedEffect[];
+    metadataPath: string;
+    files?: PackageRestoreFilesProof;
+    resolve?: LiveResolveResult;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageRestoreRequest, PackageRestoreResult>;
+export default _default;

package/dist/tools/package/restore.js

@@ -0,0 +1,122 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { inspectPackageDeploymentFiles, restoreDeployedPackage } 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";
+/** restore 删除/还原、UPM fence 与 PackageInfo readback 共用一个公开 root。 */
+async function runPackageRestore(request, context) {
+    if (context.execution.dryRun) {
+        await bindLivePackageProject(context, "restore");
+        const projectPath = resolve(context.projectPath);
+        const prepared = await restoreDeployedPackage(projectPath, request.packageName, { dryRun: true });
+        return publicRestoreResult(projectPath, "dry_run", prepared);
+    }
+    return runLivePackageResolve(context, "restore", { packageName: request.packageName }, {
+        async prepare(signal) {
+            const projectPath = resolve(context.projectPath);
+            signal.throwIfAborted();
+            const prepared = await restoreDeployedPackage(projectPath, request.packageName, { dryRun: true });
+            const observed = await inspectPackageDeploymentFiles(projectPath, prepared.packageName, prepared.targetPath, prepared.backupPath);
+            signal.throwIfAborted();
+            return {
+                ...prepared,
+                expectedTargetExists: observed.targetExists,
+                expectedTargetHash: observed.targetHash,
+                expectedRecordIdentity: observed.recordIdentity,
+                expectedBackupExists: observed.backupExists,
+                expectedBackupHash: observed.backupHash,
+            };
+        },
+        async apply(plan, signal, stopAtMs) {
+            const projectPath = resolve(context.projectPath);
+            const expected = restorePlan(plan);
+            const restored = await runPackageFileMutationWorker("restore", projectPath, plan, stopAtMs, signal);
+            return restoreBundle(projectPath, expected, restored);
+        },
+        async recover(plan, signal) {
+            const projectPath = resolve(context.projectPath);
+            signal.throwIfAborted();
+            const expected = restorePlan(plan);
+            const bundle = await restoreBundle(projectPath, expected, { ...expected, dryRun: false });
+            signal.throwIfAborted();
+            return bundle;
+        },
+    });
+}
+async function restoreBundle(projectPath, plan, restored) {
+    if (restored.packageName !== plan.packageName || restored.targetPath !== plan.targetPath || restored.restoredFromBackup !== plan.restoredFromBackup)
+        throw new Error("Restored package does not match its durable file plan.");
+    const observed = await inspectPackageDeploymentFiles(projectPath, plan.packageName, plan.targetPath, plan.backupPath);
+    if (observed.record)
+        throw new Error("Package deployment metadata still contains the restored package.");
+    if (plan.restoredFromBackup) {
+        if (!plan.expectedBackupHash || !observed.targetExists || observed.targetHash !== plan.expectedBackupHash || observed.targetFileCount !== plan.copiedFileCount || observed.backupExists)
+            throw new Error("Restored package target does not match the committed backup tree.");
+    }
+    else if (observed.targetExists || observed.backupExists) {
+        throw new Error("Remove-only package restore left a target or backup directory.");
+    }
+    const manifestHash = await hash(plan.manifestPath);
+    const files = {
+        proven: true, targetPath: plan.targetPath, copiedFileCount: observed.targetFileCount,
+        restoredFromBackup: plan.restoredFromBackup, removedDeployedPackage: plan.removedDeployedPackage,
+        metadataPath: observed.metadataPath, metadataHash: observed.metadataHash,
+        ...(observed.targetHash ? { targetHash: observed.targetHash } : {}), ...(plan.backupPath ? { backupPath: plan.backupPath } : {}),
+    };
+    // 文件内容已在 files.prove 时由 Editor fresh readback 精确验证；Resolve 后 Unity 可合法生成 .meta。
+    const predicate = plan.restoredFromBackup
+        ? { name: plan.packageName, present: true, resolvedPath: plan.targetPath }
+        : { name: plan.packageName, present: false };
+    return {
+        expectedManifestSha256: manifestHash,
+        predicates: [predicate],
+        filesProof: files,
+        publicResultSeed: publicRestoreResult(projectPath, "restored", restored, files),
+    };
+}
+/** 从内部 durable 文件结果构造公开 DTO；绝对路径只保留在 journal 与完成证明中。 */
+function publicRestoreResult(projectPath, status, restored, files) {
+    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: "restore",
+        status,
+        manifestPath: projectRelativePath(projectPath, restored.manifestPath, "manifestPath"),
+        packageName: restored.packageName,
+        targetPath: projectRelativePath(projectPath, restored.targetPath, "targetPath"),
+        ...(restored.backupPath ? { backupPath: projectRelativePath(projectPath, restored.backupPath, "backupPath") } : {}),
+        restoredFromBackup: restored.restoredFromBackup,
+        removedDeployedPackage: restored.removedDeployedPackage,
+        copiedFileCount: restored.copiedFileCount,
+        dryRun: restored.dryRun,
+        plannedEffects: publicPackageEffects(projectPath, restored.plannedEffects),
+        metadataPath: projectRelativePath(projectPath, restored.metadataPath, "metadataPath"),
+        ...(publicFiles ? { files: publicFiles } : {}),
+    };
+}
+function restorePlan(value) {
+    for (const key of ["projectPath", "manifestPath", "packageName", "targetPath", "metadataPath"])
+        if (typeof value[key] !== "string")
+            throw new Error(`Durable package.restore file plan is missing ${key}.`);
+    if (typeof value.restoredFromBackup !== "boolean" || typeof value.removedDeployedPackage !== "boolean" || typeof value.copiedFileCount !== "number"
+        || typeof value.expectedTargetExists !== "boolean" || typeof value.expectedRecordIdentity !== "string"
+        || typeof value.expectedBackupExists !== "boolean" || !Array.isArray(value.plannedEffects))
+        throw new Error("Durable package.restore file plan is corrupt.");
+    return value;
+}
+async function hash(path) { return createHash("sha256").update(await readFile(path)).digest("hex"); }
+export default defineTool({
+    name: "package.restore", summary: "Restore a package directory from the latest package.deploy backup.",
+    description: "Restore a package previously deployed by package.deploy. If package.deploy backed up an existing package directory, package.restore replaces Packages/<packageName> with that backup. If deploy created a new package with no previous directory, restore removes the deployed package directory. Destructive: writes/deletes project package files and can trigger Unity import/compile. Supports --dry-run to preview 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 restoring a deployed package", argv: ["tools", "run", "package.restore", "--input", "{\"packageName\":\"com.acme.tool\"}", "--dry-run"] }],
+    async execute(request, context) { return runPackageRestore(request, context); }
+});
+//# sourceMappingURL=restore.js.map

package/dist/tools/package/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/tools/package/restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAyD,MAAM,0BAA0B,CAAC;AACxJ,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAA0D,MAAM,mBAAmB,CAAC;AAC1I,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAkB/E,kEAAkE;AAClE,KAAK,UAAU,iBAAiB,CAAC,OAA8B,EAAE,OAAoB;IACnF,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClG,OAAO,mBAAmB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,qBAAqB,CAAuB,OAAO,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE;QAC3G,KAAK,CAAC,OAAO,CAAC,MAAM;YAClB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClG,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YAClI,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;gBACL,GAAG,QAAQ;gBACX,oBAAoB,EAAE,QAAQ,CAAC,YAAY;gBAC3C,kBAAkB,EAAE,QAAQ,CAAC,UAAU;gBACvC,sBAAsB,EAAE,QAAQ,CAAC,cAAc;gBAC/C,oBAAoB,EAAE,QAAQ,CAAC,YAAY;gBAC3C,kBAAkB,EAAE,QAAQ,CAAC,UAAU;aACF,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ;YAChC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAwC,CAAC;YAC3I,OAAO,aAAa,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM;YACxB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1F,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,IAAiB,EAAE,QAAkC;IACrG,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC/N,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtH,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACzG,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAChR,CAAC;SAAM,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,KAAK,GAA6B;QACtC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe;QACpF,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QAChG,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY;QACxE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjI,CAAC;IACF,gFAAgF;IAChF,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB;QACvC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE;QAC1E,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/C,OAAO;QACL,sBAAsB,EAAE,YAAY;QACpC,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,UAAU,EAAE,KAA2C;QACvD,gBAAgB,EAAE,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAuC;KACtH,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,SAAS,mBAAmB,CAC1B,WAAmB,EACnB,MAAc,EACd,QAAkC,EAClC,KAAgC;IAEhC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC;QAC1B,GAAG,KAAK;QACR,UAAU,EAAE,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAClF,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,oBAAoB,CAAC;QACxF,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpH,CAAC,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;QACrF,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU,EAAE,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;QAC/E,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnH,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;QACvD,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,cAAc,EAAE,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAkC;QAC3G,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;QACrF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAA8B;IACjD,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,CAAC;QAC5F,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,GAAG,GAAG,CAAC,CAAC;IAC9G,IAAI,OAAO,KAAK,CAAC,kBAAkB,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,sBAAsB,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;WAC9I,OAAO,KAAK,CAAC,oBAAoB,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,sBAAsB,KAAK,QAAQ;WACnG,OAAO,KAAK,CAAC,oBAAoB,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/J,OAAO,KAA+B,CAAC;AACzC,CAAC;AACD,KAAK,UAAU,IAAI,CAAC,IAAY,IAAqB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE9H,eAAe,UAAU,CAA8C;IACrE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oEAAoE;IACtG,WAAW,EAAE,kbAAkb;IAC/b,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO;IACzP,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,qCAAqC,EAAE,WAAW,CAAC,EAAE,CAAC;IAC7K,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF,CAAC,CAAC"}

package/dist/tools/package/scoped-registry-add.d.ts

@@ -0,0 +1,25 @@
+export interface PackageScopedRegistryAddRequest {
+    name: string;
+    url: string;
+    scope?: string;
+    scopes?: string;
+    project?: string;
+}
+export interface PackageScopedRegistryAddResult {
+    projectPath: string;
+    manifestPath: string;
+    registry?: {
+        name: string;
+        url: string;
+        scopes: string[];
+    };
+    dryRun?: boolean;
+    plannedEffects?: Array<{
+        type: string;
+        name: string;
+        url: string;
+        scopes: string[];
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageScopedRegistryAddRequest, PackageScopedRegistryAddResult>;
+export default _default;

package/dist/tools/package/scoped-registry-add.js

@@ -0,0 +1,30 @@
+import { resolve } from "node:path";
+import { addScopedRegistry, parseScopes, validatePackageName, validateRegistryUrl } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.scoped-registry.add",
+    summary: "Add or replace a scoped registry in the project manifest.",
+    description: "Add or replace a scoped registry in Packages/manifest.json. Supports --dry-run.",
+    group: "package",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["manifest-change"],
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Add a scoped registry", argv: ["tools", "run", "package.scoped-registry.add", "--input", "{\"name\":\"Acme\",\"url\":\"https://registry.acme.test\",\"scope\":\"com.acme\"}"] }
+    ],
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const name = validatePackageName(request.name);
+        const url = validateRegistryUrl(request.url);
+        const scopes = parseScopes(request.scope ?? request.scopes);
+        const prepared = await addScopedRegistry(projectPath, { name, url, scopes }, { dryRun: true });
+        if (context.execution.dryRun)
+            return { projectPath, ...prepared };
+        await context.commitEffect?.();
+        return { projectPath, ...(await addScopedRegistry(projectPath, { name, url, scopes })) };
+    }
+});
+//# sourceMappingURL=scoped-registry-add.js.map

package/dist/tools/package/scoped-registry-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-registry-add.js","sourceRoot":"","sources":["../../../src/tools/package/scoped-registry-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAgB,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClI,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAkB5D,eAAe,UAAU,CAAkE;IACzF,IAAI,EAAE,6BAA6B;IACnC,OAAO,EAAE,2DAA2D;IACpE,WAAW,EAAE,iFAAiF;IAC9F,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,mFAAmF,CAAC,EAAE;KAChM;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/F,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAoC,CAAC;QACpG,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC/B,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAoC,CAAC;IAC7H,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/scoped-registry-list.d.ts

@@ -0,0 +1,14 @@
+export interface PackageScopedRegistryListRequest {
+    project?: string;
+}
+export interface PackageScopedRegistryListResult {
+    projectPath: string;
+    manifestPath: string;
+    scopedRegistries: Array<{
+        name: string;
+        url: string;
+        scopes: string[];
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageScopedRegistryListRequest, PackageScopedRegistryListResult>;
+export default _default;

package/dist/tools/package/scoped-registry-list.js

@@ -0,0 +1,22 @@
+import { resolve } from "node:path";
+import { readSnapshot } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.scoped-registry.list",
+    summary: "List scoped registries from the project manifest.",
+    description: "Read scoped registries from Packages/manifest.json. Offline and read-only.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "List scoped registries", argv: ["tools", "run", "package.scoped-registry.list", "--input", "{}"] }
+    ],
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const snapshot = await readSnapshot(projectPath);
+        return { projectPath, manifestPath: snapshot.manifestPath, scopedRegistries: snapshot.scopedRegistries };
+    }
+});
+//# sourceMappingURL=scoped-registry-list.js.map

package/dist/tools/package/scoped-registry-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-registry-list.js","sourceRoot":"","sources":["../../../src/tools/package/scoped-registry-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAY5D,eAAe,UAAU,CAAoE;IAC3F,IAAI,EAAE,8BAA8B;IACpC,OAAO,EAAE,mDAAmD;IAC5D,WAAW,EAAE,4EAA4E;IACzF,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;KACnH;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IAC3G,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/scoped-registry-remove.d.ts

@@ -0,0 +1,29 @@
+export interface PackageScopedRegistryRemoveRequest {
+    name: string;
+    force?: boolean;
+    project?: string;
+}
+export interface PackageScopedRegistryRemoveResult {
+    projectPath: string;
+    manifestPath: string;
+    registryRemoved?: boolean;
+    removed?: {
+        name: string;
+        url: string;
+        scopes: string[];
+    };
+    matchedPackages?: string[];
+    forced?: boolean;
+    dryRun?: boolean;
+    blocked?: boolean;
+    plannedEffects?: Array<{
+        type?: string;
+        name?: string;
+        scopes?: string[];
+        matchedPackages?: string[];
+        forced?: boolean;
+        blocked?: boolean;
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageScopedRegistryRemoveRequest, PackageScopedRegistryRemoveResult>;
+export default _default;

package/dist/tools/package/scoped-registry-remove.js

@@ -0,0 +1,31 @@
+import { resolve } from "node:path";
+import { PackageManagerError, removeScopedRegistry, validatePackageName } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.scoped-registry.remove",
+    summary: "Remove a scoped registry from the project manifest.",
+    description: "Remove a scoped registry from Packages/manifest.json. Matching manifest dependencies require force=true. Supports --dry-run.",
+    group: "package",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["manifest-change"],
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Preview removing a scoped registry", argv: ["tools", "run", "package.scoped-registry.remove", "--input", "{\"name\":\"Acme\"}", "--dry-run"] }
+    ],
+    async execute(request, context) {
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const name = validatePackageName(request.name);
+        const prepared = await removeScopedRegistry(projectPath, name, { force: request.force === true, dryRun: true });
+        if (context.execution.dryRun)
+            return { projectPath, ...prepared };
+        if (prepared.blocked) {
+            throw new PackageManagerError("SCOPED_REGISTRY_IN_USE", `Scoped registry ${name} still matches manifest package(s): ${prepared.matchedPackages.join(", ")}.`, ["Remove or move matching packages first, or pass force=true only when intentional."]);
+        }
+        await context.commitEffect?.();
+        return { projectPath, ...(await removeScopedRegistry(projectPath, name, { force: request.force === true })) };
+    }
+});
+//# sourceMappingURL=scoped-registry-remove.js.map

package/dist/tools/package/scoped-registry-remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-registry-remove.js","sourceRoot":"","sources":["../../../src/tools/package/scoped-registry-remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAoB5D,eAAe,UAAU,CAAwE;IAC/F,IAAI,EAAE,gCAAgC;IACtC,OAAO,EAAE,qDAAqD;IAC9D,WAAW,EAAE,8HAA8H;IAC3I,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,iBAAiB,CAAC;IAChC,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,oCAAoC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,CAAC,EAAE;KAC/J;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChH,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,CAAC;QAClE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,EAAE,mBAAmB,IAAI,uCAAuC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,mFAAmF,CAAC,CAAC,CAAC;QACvP,CAAC;QACD,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC/B,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,oBAAoB,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAChH,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+export interface PackageSearchRequest {
+    query: string;
+    registry?: string;
+    project?: string;
+}
+export interface PackageSearchEntry {
+    name: string;
+    version?: string;
+    description?: string;
+}
+export interface PackageSearchResult {
+    registry: string;
+    query: string;
+    packages: PackageSearchEntry[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageSearchRequest, PackageSearchResult>;
+export default _default;