@ai-agent-forge/agent-forge 0.85.0

package/dist/plugins/ecosystem/bootstrap-factory-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-factory-manifest.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/bootstrap-factory-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAA6C,MAAM,CAAC,MAAM,CAAC;IAC3G,EAAE,QAAQ,EAAE,yBAAyB,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE;IACjG,EAAE,QAAQ,EAAE,yBAAyB,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE;IACjG,EAAE,QAAQ,EAAE,6BAA6B,EAAE,OAAO,EAAE,iCAAiC,EAAE,KAAK,EAAE,SAAS,EAAE;IACzG,EAAE,QAAQ,EAAE,kCAAkC,EAAE,OAAO,EAAE,sCAAsC,EAAE,KAAK,EAAE,SAAS,EAAE;IACnH,EAAE,QAAQ,EAAE,kCAAkC,EAAE,OAAO,EAAE,sCAAsC,EAAE,KAAK,EAAE,SAAS,EAAE;IACnH;QACC,QAAQ,EAAE,sCAAsC;QAChD,OAAO,EAAE,0CAA0C;QACnD,KAAK,EAAE,SAAS;KAChB;IACD,EAAE,QAAQ,EAAE,2BAA2B,EAAE,OAAO,EAAE,+BAA+B,EAAE,KAAK,EAAE,SAAS,EAAE;CACrG,CAAC,CAAC","sourcesContent":["/**\n * Factory plugin manifest for the startup bootstrap (design\n * `插件独立分发与启动装配设计.md` §4.4). Pure data only: the framework\n * declares which first-party plugin packages a fresh install should end up\n * with, as `pluginId → npm name + version constraint`. It ships with the\n * framework version and is never a code branch.\n *\n * Each S2–S4 migrated package appends one entry here with its publish name\n * (`@ai-agent-forge/plugin-<name>`, §0.8) together with the legacy short-id\n * mapping noted in §4.1.\n */\n\n/** One factory-declared first-party plugin package. */\nexport interface PluginBootstrapFactoryEntryV1 {\n\t/** Ecosystem plugin id (`agent-forge.plugin.<name>` domain, §4.1). */\n\treadonly pluginId: string;\n\t/** npm publish name (`@ai-agent-forge/plugin-<name>`, §0.8). */\n\treadonly npmName: string;\n\t/**\n\t * Minimal range subset shared with npm resolution (`x.y.z`, `^x.y.z`,\n\t * `~x.y.z`, `latest`); omitted means the highest available version.\n\t */\n\treadonly range?: string;\n}\n\n/**\n * Frozen factory manifest consumed by `runPluginBootstrapV1`. D-075 S4 first\n * batch: the goal/plan/todo-set capability packages joined; second batch:\n * session-share and observability joined; third batch: subagent-delegate\n * joined; fourth batch: memory joined (completing the six-package split).\n * Later B-class batches append their entries per package.\n */\nexport const BOOTSTRAP_FACTORY_PLUGIN_MANIFEST_V1: readonly PluginBootstrapFactoryEntryV1[] = Object.freeze([\n\t{ pluginId: \"agent-forge.plugin.goal\", npmName: \"@ai-agent-forge/plugin-goal\", range: \"^0.84.4\" },\n\t{ pluginId: \"agent-forge.plugin.plan\", npmName: \"@ai-agent-forge/plugin-plan\", range: \"^0.84.4\" },\n\t{ pluginId: \"agent-forge.plugin.todo-set\", npmName: \"@ai-agent-forge/plugin-todo-set\", range: \"^0.84.4\" },\n\t{ pluginId: \"agent-forge.plugin.session-share\", npmName: \"@ai-agent-forge/plugin-session-share\", range: \"^0.84.4\" },\n\t{ pluginId: \"agent-forge.plugin.observability\", npmName: \"@ai-agent-forge/plugin-observability\", range: \"^0.84.4\" },\n\t{\n\t\tpluginId: \"agent-forge.plugin.subagent-delegate\",\n\t\tnpmName: \"@ai-agent-forge/plugin-subagent-delegate\",\n\t\trange: \"^0.84.4\",\n\t},\n\t{ pluginId: \"agent-forge.plugin.memory\", npmName: \"@ai-agent-forge/plugin-memory\", range: \"^0.84.4\" },\n]);\n"]}

package/dist/plugins/ecosystem/catalog.d.ts

@@ -0,0 +1,38 @@
+import type { CapabilityRefV1, HostFactsV1, PluginManifestV1, PluginResolutionV1 } from "./types.ts";
+/** A bounded, read-only view consumed by Profile/plugin selection UIs. */
+export interface PluginCatalogEntryV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly manifestDigest: string;
+    readonly resolution: PluginResolutionV1;
+}
+export interface PluginCatalogSnapshotV1 {
+    readonly version: 1;
+    readonly entries: readonly PluginCatalogEntryV1[];
+    readonly truncated: boolean;
+}
+export type PluginCatalogErrorCodeV1 = "duplicate_plugin_version" | "invalid_limit";
+export declare class PluginCatalogErrorV1 extends Error {
+    readonly code: PluginCatalogErrorCodeV1;
+    constructor(code: PluginCatalogErrorCodeV1, message: string);
+}
+/** Compare package versions numerically, with prereleases ordered before releases. */
+export declare function comparePluginVersionsV1(left: string, right: string): number;
+/**
+ * Build a deterministic catalog projection without exposing adapter objects,
+ * file paths, credentials, or plugin-private state to the main session.
+ *
+ * The catalog is deliberately a pure snapshot. Installation, integrity
+ * verification and activation remain explicit operations (`stage/verify/
+ * activatePluginUpdateV1`) owned by a host or installer plugin.
+ */
+export declare function buildPluginCatalogV1(input: {
+    readonly manifests: readonly PluginManifestV1[];
+    readonly host: HostFactsV1;
+    readonly required?: boolean;
+    readonly disabledPluginIds?: readonly string[];
+    readonly availableCapabilities?: readonly CapabilityRefV1[];
+    readonly maxEntries?: number;
+}): PluginCatalogSnapshotV1;
+export declare function findPluginCatalogEntryV1(snapshot: PluginCatalogSnapshotV1, pluginId: string, pluginVersion?: string): PluginCatalogEntryV1 | undefined;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/plugins/ecosystem/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrG,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,GAAG,eAAe,CAAC;AAEpF,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAExC,YAAY,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,EAI1D;CACD;AAKD,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB3E;AAQD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,uBAAuB,CAuC1B;AAED,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACpB,oBAAoB,GAAG,SAAS,CAIlC","sourcesContent":["import { VERSION } from \"../../config.ts\";\nimport { resolvePluginCompatibilityV1 } from \"./resolver.ts\";\nimport type { CapabilityRefV1, HostFactsV1, PluginManifestV1, PluginResolutionV1 } from \"./types.ts\";\nimport { pluginManifestDigestV1 } from \"./updates.ts\";\n\n/** A bounded, read-only view consumed by Profile/plugin selection UIs. */\nexport interface PluginCatalogEntryV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestDigest: string;\n\treadonly resolution: PluginResolutionV1;\n}\n\nexport interface PluginCatalogSnapshotV1 {\n\treadonly version: 1;\n\treadonly entries: readonly PluginCatalogEntryV1[];\n\treadonly truncated: boolean;\n}\n\nexport type PluginCatalogErrorCodeV1 = \"duplicate_plugin_version\" | \"invalid_limit\";\n\nexport class PluginCatalogErrorV1 extends Error {\n\treadonly code: PluginCatalogErrorCodeV1;\n\n\tconstructor(code: PluginCatalogErrorCodeV1, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginCatalogErrorV1\";\n\t\tthis.code = code;\n\t}\n}\n\nconst DEFAULT_MAX_ENTRIES = 128;\nconst MAX_ENTRIES = 256;\n\n/** Compare package versions numerically, with prereleases ordered before releases. */\nexport function comparePluginVersionsV1(left: string, right: string): number {\n\tconst parse = (value: string): (number | string)[] =>\n\t\tvalue\n\t\t\t.trim()\n\t\t\t.replace(/^[vV]/u, \"\")\n\t\t\t.split(/[.+-]/u)\n\t\t\t.map((part) => (/^\\d+$/u.test(part) ? Number.parseInt(part, 10) : part));\n\tconst leftParts = parse(left);\n\tconst rightParts = parse(right);\n\tfor (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {\n\t\tconst a = leftParts[index] ?? 0;\n\t\tconst b = rightParts[index] ?? 0;\n\t\tif (a === b) continue;\n\t\tif (typeof a === \"number\" && typeof b === \"number\") return a < b ? -1 : 1;\n\t\tif (typeof a === \"number\") return 1;\n\t\tif (typeof b === \"number\") return -1;\n\t\treturn a < b ? -1 : 1;\n\t}\n\treturn 0;\n}\n\nfunction compareCatalogEntries(left: PluginManifestV1, right: PluginManifestV1): number {\n\tconst idOrder = left.id.localeCompare(right.id);\n\tif (idOrder !== 0) return idOrder;\n\treturn comparePluginVersionsV1(right.pluginVersion, left.pluginVersion);\n}\n\n/**\n * Build a deterministic catalog projection without exposing adapter objects,\n * file paths, credentials, or plugin-private state to the main session.\n *\n * The catalog is deliberately a pure snapshot. Installation, integrity\n * verification and activation remain explicit operations (`stage/verify/\n * activatePluginUpdateV1`) owned by a host or installer plugin.\n */\nexport function buildPluginCatalogV1(input: {\n\treadonly manifests: readonly PluginManifestV1[];\n\treadonly host: HostFactsV1;\n\treadonly required?: boolean;\n\treadonly disabledPluginIds?: readonly string[];\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\treadonly maxEntries?: number;\n}): PluginCatalogSnapshotV1 {\n\tconst maxEntries = input.maxEntries ?? DEFAULT_MAX_ENTRIES;\n\tif (!Number.isSafeInteger(maxEntries) || maxEntries < 1 || maxEntries > MAX_ENTRIES) {\n\t\tthrow new PluginCatalogErrorV1(\"invalid_limit\", `maxEntries must be an integer between 1 and ${MAX_ENTRIES}`);\n\t}\n\n\tconst manifests = [...input.manifests].sort(compareCatalogEntries);\n\tconst seen = new Set<string>();\n\tfor (const manifest of manifests) {\n\t\tconst identity = `${manifest.id}@${manifest.pluginVersion}`;\n\t\tif (seen.has(identity)) {\n\t\t\tthrow new PluginCatalogErrorV1(\n\t\t\t\t\"duplicate_plugin_version\",\n\t\t\t\t`Catalog contains duplicate plugin version: ${identity}`,\n\t\t\t);\n\t\t}\n\t\tseen.add(identity);\n\t}\n\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\tconst entries = manifests.slice(0, maxEntries).map((manifest): PluginCatalogEntryV1 => {\n\t\tconst resolution = resolvePluginCompatibilityV1({\n\t\t\tmanifest,\n\t\t\thost: input.host,\n\t\t\trequired: input.required,\n\t\t\tdisabled: disabled.has(manifest.id),\n\t\t\tavailableCapabilities: input.availableCapabilities,\n\t\t\t// D-073: catalog snapshots enforce the declared host version range;\n\t\t\t// previously this path skipped the check entirely.\n\t\t\thostVersion: VERSION,\n\t\t});\n\t\treturn Object.freeze({\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\tmanifestDigest: pluginManifestDigestV1(manifest),\n\t\t\tresolution,\n\t\t});\n\t});\n\treturn Object.freeze({ version: 1, entries: Object.freeze(entries), truncated: manifests.length > maxEntries });\n}\n\nexport function findPluginCatalogEntryV1(\n\tsnapshot: PluginCatalogSnapshotV1,\n\tpluginId: string,\n\tpluginVersion?: string,\n): PluginCatalogEntryV1 | undefined {\n\treturn snapshot.entries.find(\n\t\t(entry) => entry.pluginId === pluginId && (pluginVersion === undefined || entry.pluginVersion === pluginVersion),\n\t);\n}\n"]}

package/dist/plugins/ecosystem/catalog.js

@@ -0,0 +1,90 @@
+import { VERSION } from "../../config.js";
+import { resolvePluginCompatibilityV1 } from "./resolver.js";
+import { pluginManifestDigestV1 } from "./updates.js";
+export class PluginCatalogErrorV1 extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "PluginCatalogErrorV1";
+        this.code = code;
+    }
+}
+const DEFAULT_MAX_ENTRIES = 128;
+const MAX_ENTRIES = 256;
+/** Compare package versions numerically, with prereleases ordered before releases. */
+export function comparePluginVersionsV1(left, right) {
+    const parse = (value) => value
+        .trim()
+        .replace(/^[vV]/u, "")
+        .split(/[.+-]/u)
+        .map((part) => (/^\d+$/u.test(part) ? Number.parseInt(part, 10) : part));
+    const leftParts = parse(left);
+    const rightParts = parse(right);
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const a = leftParts[index] ?? 0;
+        const b = rightParts[index] ?? 0;
+        if (a === b)
+            continue;
+        if (typeof a === "number" && typeof b === "number")
+            return a < b ? -1 : 1;
+        if (typeof a === "number")
+            return 1;
+        if (typeof b === "number")
+            return -1;
+        return a < b ? -1 : 1;
+    }
+    return 0;
+}
+function compareCatalogEntries(left, right) {
+    const idOrder = left.id.localeCompare(right.id);
+    if (idOrder !== 0)
+        return idOrder;
+    return comparePluginVersionsV1(right.pluginVersion, left.pluginVersion);
+}
+/**
+ * Build a deterministic catalog projection without exposing adapter objects,
+ * file paths, credentials, or plugin-private state to the main session.
+ *
+ * The catalog is deliberately a pure snapshot. Installation, integrity
+ * verification and activation remain explicit operations (`stage/verify/
+ * activatePluginUpdateV1`) owned by a host or installer plugin.
+ */
+export function buildPluginCatalogV1(input) {
+    const maxEntries = input.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    if (!Number.isSafeInteger(maxEntries) || maxEntries < 1 || maxEntries > MAX_ENTRIES) {
+        throw new PluginCatalogErrorV1("invalid_limit", `maxEntries must be an integer between 1 and ${MAX_ENTRIES}`);
+    }
+    const manifests = [...input.manifests].sort(compareCatalogEntries);
+    const seen = new Set();
+    for (const manifest of manifests) {
+        const identity = `${manifest.id}@${manifest.pluginVersion}`;
+        if (seen.has(identity)) {
+            throw new PluginCatalogErrorV1("duplicate_plugin_version", `Catalog contains duplicate plugin version: ${identity}`);
+        }
+        seen.add(identity);
+    }
+    const disabled = new Set(input.disabledPluginIds ?? []);
+    const entries = manifests.slice(0, maxEntries).map((manifest) => {
+        const resolution = resolvePluginCompatibilityV1({
+            manifest,
+            host: input.host,
+            required: input.required,
+            disabled: disabled.has(manifest.id),
+            availableCapabilities: input.availableCapabilities,
+            // D-073: catalog snapshots enforce the declared host version range;
+            // previously this path skipped the check entirely.
+            hostVersion: VERSION,
+        });
+        return Object.freeze({
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            manifestDigest: pluginManifestDigestV1(manifest),
+            resolution,
+        });
+    });
+    return Object.freeze({ version: 1, entries: Object.freeze(entries), truncated: manifests.length > maxEntries });
+}
+export function findPluginCatalogEntryV1(snapshot, pluginId, pluginVersion) {
+    return snapshot.entries.find((entry) => entry.pluginId === pluginId && (pluginVersion === undefined || entry.pluginVersion === pluginVersion));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/plugins/ecosystem/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import { VERSION } from \"../../config.ts\";\nimport { resolvePluginCompatibilityV1 } from \"./resolver.ts\";\nimport type { CapabilityRefV1, HostFactsV1, PluginManifestV1, PluginResolutionV1 } from \"./types.ts\";\nimport { pluginManifestDigestV1 } from \"./updates.ts\";\n\n/** A bounded, read-only view consumed by Profile/plugin selection UIs. */\nexport interface PluginCatalogEntryV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestDigest: string;\n\treadonly resolution: PluginResolutionV1;\n}\n\nexport interface PluginCatalogSnapshotV1 {\n\treadonly version: 1;\n\treadonly entries: readonly PluginCatalogEntryV1[];\n\treadonly truncated: boolean;\n}\n\nexport type PluginCatalogErrorCodeV1 = \"duplicate_plugin_version\" | \"invalid_limit\";\n\nexport class PluginCatalogErrorV1 extends Error {\n\treadonly code: PluginCatalogErrorCodeV1;\n\n\tconstructor(code: PluginCatalogErrorCodeV1, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginCatalogErrorV1\";\n\t\tthis.code = code;\n\t}\n}\n\nconst DEFAULT_MAX_ENTRIES = 128;\nconst MAX_ENTRIES = 256;\n\n/** Compare package versions numerically, with prereleases ordered before releases. */\nexport function comparePluginVersionsV1(left: string, right: string): number {\n\tconst parse = (value: string): (number | string)[] =>\n\t\tvalue\n\t\t\t.trim()\n\t\t\t.replace(/^[vV]/u, \"\")\n\t\t\t.split(/[.+-]/u)\n\t\t\t.map((part) => (/^\\d+$/u.test(part) ? Number.parseInt(part, 10) : part));\n\tconst leftParts = parse(left);\n\tconst rightParts = parse(right);\n\tfor (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {\n\t\tconst a = leftParts[index] ?? 0;\n\t\tconst b = rightParts[index] ?? 0;\n\t\tif (a === b) continue;\n\t\tif (typeof a === \"number\" && typeof b === \"number\") return a < b ? -1 : 1;\n\t\tif (typeof a === \"number\") return 1;\n\t\tif (typeof b === \"number\") return -1;\n\t\treturn a < b ? -1 : 1;\n\t}\n\treturn 0;\n}\n\nfunction compareCatalogEntries(left: PluginManifestV1, right: PluginManifestV1): number {\n\tconst idOrder = left.id.localeCompare(right.id);\n\tif (idOrder !== 0) return idOrder;\n\treturn comparePluginVersionsV1(right.pluginVersion, left.pluginVersion);\n}\n\n/**\n * Build a deterministic catalog projection without exposing adapter objects,\n * file paths, credentials, or plugin-private state to the main session.\n *\n * The catalog is deliberately a pure snapshot. Installation, integrity\n * verification and activation remain explicit operations (`stage/verify/\n * activatePluginUpdateV1`) owned by a host or installer plugin.\n */\nexport function buildPluginCatalogV1(input: {\n\treadonly manifests: readonly PluginManifestV1[];\n\treadonly host: HostFactsV1;\n\treadonly required?: boolean;\n\treadonly disabledPluginIds?: readonly string[];\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\treadonly maxEntries?: number;\n}): PluginCatalogSnapshotV1 {\n\tconst maxEntries = input.maxEntries ?? DEFAULT_MAX_ENTRIES;\n\tif (!Number.isSafeInteger(maxEntries) || maxEntries < 1 || maxEntries > MAX_ENTRIES) {\n\t\tthrow new PluginCatalogErrorV1(\"invalid_limit\", `maxEntries must be an integer between 1 and ${MAX_ENTRIES}`);\n\t}\n\n\tconst manifests = [...input.manifests].sort(compareCatalogEntries);\n\tconst seen = new Set<string>();\n\tfor (const manifest of manifests) {\n\t\tconst identity = `${manifest.id}@${manifest.pluginVersion}`;\n\t\tif (seen.has(identity)) {\n\t\t\tthrow new PluginCatalogErrorV1(\n\t\t\t\t\"duplicate_plugin_version\",\n\t\t\t\t`Catalog contains duplicate plugin version: ${identity}`,\n\t\t\t);\n\t\t}\n\t\tseen.add(identity);\n\t}\n\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\tconst entries = manifests.slice(0, maxEntries).map((manifest): PluginCatalogEntryV1 => {\n\t\tconst resolution = resolvePluginCompatibilityV1({\n\t\t\tmanifest,\n\t\t\thost: input.host,\n\t\t\trequired: input.required,\n\t\t\tdisabled: disabled.has(manifest.id),\n\t\t\tavailableCapabilities: input.availableCapabilities,\n\t\t\t// D-073: catalog snapshots enforce the declared host version range;\n\t\t\t// previously this path skipped the check entirely.\n\t\t\thostVersion: VERSION,\n\t\t});\n\t\treturn Object.freeze({\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\tmanifestDigest: pluginManifestDigestV1(manifest),\n\t\t\tresolution,\n\t\t});\n\t});\n\treturn Object.freeze({ version: 1, entries: Object.freeze(entries), truncated: manifests.length > maxEntries });\n}\n\nexport function findPluginCatalogEntryV1(\n\tsnapshot: PluginCatalogSnapshotV1,\n\tpluginId: string,\n\tpluginVersion?: string,\n): PluginCatalogEntryV1 | undefined {\n\treturn snapshot.entries.find(\n\t\t(entry) => entry.pluginId === pluginId && (pluginVersion === undefined || entry.pluginVersion === pluginVersion),\n\t);\n}\n"]}

package/dist/plugins/ecosystem/cli.d.ts

@@ -0,0 +1,102 @@
+import type { PluginDistributionDescriptorV1, PluginDistributionV1 } from "./distribution.ts";
+import { type PluginInstallerV1 } from "./installer.ts";
+import { type PluginAcquisitionPackageV1 } from "./plugin-acquisition.ts";
+import type { PluginSelectionStoreV1 } from "./selection-store.ts";
+import type { PluginStateScopeV1, PluginStateStoreV1 } from "./state.ts";
+import type { HostFactsV1, PluginManifestV1 } from "./types.ts";
+export declare const PLUGIN_ECOSYSTEM_CLI_VERSION_V1: 1;
+export declare const MAX_PLUGIN_ECOSYSTEM_CLI_OUTPUT_BYTES_V1: number;
+export declare const MAX_PLUGIN_ECOSYSTEM_CLI_LIST_ENTRIES_V1 = 128;
+export declare const MAX_PLUGIN_ECOSYSTEM_CLI_ARGS_V1: number;
+export type PluginEcosystemCliOutputFormatV1 = "json" | "text";
+export type PluginEcosystemCliCommandNameV1 = "catalog-list" | "state-list" | "selection-list" | "selection-set" | "selection-clear" | "enable" | "disable" | "remove" | "install" | "update";
+export interface PluginRegistryPackageV1 {
+    readonly manifest: PluginManifestV1;
+    readonly source: string;
+    readonly expectedDigest?: string;
+    /** Optional signed package acquisition descriptor. It never contains package bytes or paths. */
+    readonly distribution?: PluginDistributionDescriptorV1;
+}
+/** Registry access is intentionally host-injected; this CLI never downloads itself. */
+export interface PluginEcosystemRegistryV1 {
+    readonly list?: (input: {
+        readonly signal?: AbortSignal;
+    }) => readonly PluginManifestV1[] | Promise<readonly PluginManifestV1[]>;
+    readonly resolve: (input: {
+        readonly pluginId: string;
+        readonly pluginVersion?: string;
+        readonly signal?: AbortSignal;
+    }) => PluginRegistryPackageV1 | undefined | Promise<PluginRegistryPackageV1 | undefined>;
+}
+/**
+ * Host-injected multi-source acquisition boundary for `plugin install <ref>`
+ * (npm / custom URL / local). Like registry access it is host-owned; the CLI
+ * never downloads by itself.
+ */
+export interface PluginEcosystemCliAcquisitionV1 {
+    readonly resolvePackage: (input: {
+        readonly ref: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginAcquisitionPackageV1>;
+}
+export interface PluginEcosystemCliOptionsV1 {
+    readonly host?: HostFactsV1;
+    readonly manifests?: readonly PluginManifestV1[];
+    readonly registry?: PluginEcosystemRegistryV1;
+    /** Optional multi-source acquisition boundary for `install <ref>` targets. */
+    readonly acquisition?: PluginEcosystemCliAcquisitionV1;
+    readonly installer?: PluginInstallerV1;
+    /** Host-owned descriptor verifier and artifact acquisition boundary. */
+    readonly distribution?: PluginDistributionV1;
+    readonly stateStore?: PluginStateStoreV1;
+    /** Alias for hosts that expose the persistence boundary as a state host. */
+    readonly stateHost?: PluginStateStoreV1;
+    /** Optional project-local state store. Global state remains the default. */
+    readonly projectStateStore?: PluginStateStoreV1;
+    /** Opaque concrete host namespace for project-scoped installations. */
+    readonly projectScopeRef?: string;
+    readonly selectionStore?: PluginSelectionStoreV1;
+    /** Alias for hosts that expose the persistence boundary as a selection host. */
+    readonly selectionHost?: PluginSelectionStoreV1;
+    /** Optional project-local selection store. Global selection remains the default. */
+    readonly projectSelectionStore?: PluginSelectionStoreV1;
+}
+export interface PluginEcosystemCliRequestV1 {
+    readonly argv: readonly string[];
+    readonly format?: PluginEcosystemCliOutputFormatV1;
+    readonly signal?: AbortSignal;
+}
+export interface PluginEcosystemCliParsedCommandV1 {
+    readonly version: typeof PLUGIN_ECOSYSTEM_CLI_VERSION_V1;
+    readonly command: PluginEcosystemCliCommandNameV1;
+    readonly format: PluginEcosystemCliOutputFormatV1;
+    readonly pluginId?: string;
+    readonly pluginVersion?: string;
+    /** Raw install/update target; kept so ref forms survive the identity split. */
+    readonly target?: string;
+    readonly profileId?: string;
+    readonly selectedPluginIds?: readonly string[];
+    readonly scope?: PluginStateScopeV1;
+}
+export type PluginEcosystemCliErrorCodeV1 = "invalid_command" | "unsupported_dependencies" | "not_found" | "not_installed" | "selection_failed" | "registry_failed" | "acquisition_failed" | "distribution_failed" | "incompatible" | "already_installed" | "installer_failed" | "uninstall_failed" | "state_failed" | "cancelled";
+export interface PluginEcosystemCliErrorV1 {
+    readonly code: PluginEcosystemCliErrorCodeV1;
+    readonly message: string;
+}
+export interface PluginEcosystemCliResponseV1 {
+    readonly version: typeof PLUGIN_ECOSYSTEM_CLI_VERSION_V1;
+    readonly command: PluginEcosystemCliCommandNameV1 | "invalid";
+    readonly format: PluginEcosystemCliOutputFormatV1;
+    readonly status: "succeeded" | "failed" | "unsupported" | "cancelled";
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly text: string;
+    readonly error?: PluginEcosystemCliErrorV1;
+}
+export interface PluginEcosystemCliV1 {
+    readonly execute: (input: PluginEcosystemCliRequestV1) => Promise<PluginEcosystemCliResponseV1>;
+}
+/** Parse only the ecosystem command grammar; legacy package commands are not accepted. */
+export declare function parsePluginEcosystemCliCommandV1(argv: readonly string[], defaultFormat?: PluginEcosystemCliOutputFormatV1): PluginEcosystemCliParsedCommandV1;
+export declare function createPluginEcosystemCliV1(options: PluginEcosystemCliOptionsV1): PluginEcosystemCliV1;
+export declare function runPluginEcosystemCliV1(options: PluginEcosystemCliOptionsV1, input: PluginEcosystemCliRequestV1): Promise<PluginEcosystemCliResponseV1>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/plugins/ecosystem/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { buildPluginCatalogV1 } from \"./catalog.ts\";\nimport type { PluginDistributionDescriptorV1, PluginDistributionV1 } from \"./distribution.ts\";\nimport { DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1, type PluginInstallerV1 } from \"./installer.ts\";\nimport {\n\tisPluginAcquisitionRefTargetV1,\n\tPluginAcquisitionErrorV1,\n\ttype PluginAcquisitionPackageV1,\n} from \"./plugin-acquisition.ts\";\nimport { createPluginSelectionV1, MAX_PLUGIN_SELECTION_IDS_V1, type PluginSelectionV1 } from \"./selection.ts\";\nimport type { PluginSelectionStoreV1 } from \"./selection-store.ts\";\nimport type { PluginStateRecordV1, PluginStateScopeV1, PluginStateStoreV1 } from \"./state.ts\";\nimport type { HostFactsV1, PluginManifestV1 } from \"./types.ts\";\n\nexport const PLUGIN_ECOSYSTEM_CLI_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_ECOSYSTEM_CLI_OUTPUT_BYTES_V1 = 64 * 1024;\nexport const MAX_PLUGIN_ECOSYSTEM_CLI_LIST_ENTRIES_V1 = 128;\nexport const MAX_PLUGIN_ECOSYSTEM_CLI_ARGS_V1 = MAX_PLUGIN_SELECTION_IDS_V1 + 8;\n\nexport type PluginEcosystemCliOutputFormatV1 = \"json\" | \"text\";\nexport type PluginEcosystemCliCommandNameV1 =\n\t| \"catalog-list\"\n\t| \"state-list\"\n\t| \"selection-list\"\n\t| \"selection-set\"\n\t| \"selection-clear\"\n\t| \"enable\"\n\t| \"disable\"\n\t| \"remove\"\n\t| \"install\"\n\t| \"update\";\n\nexport interface PluginRegistryPackageV1 {\n\treadonly manifest: PluginManifestV1;\n\treadonly source: string;\n\treadonly expectedDigest?: string;\n\t/** Optional signed package acquisition descriptor. It never contains package bytes or paths. */\n\treadonly distribution?: PluginDistributionDescriptorV1;\n}\n\n/** Registry access is intentionally host-injected; this CLI never downloads itself. */\nexport interface PluginEcosystemRegistryV1 {\n\treadonly list?: (input: {\n\t\treadonly signal?: AbortSignal;\n\t}) => readonly PluginManifestV1[] | Promise<readonly PluginManifestV1[]>;\n\treadonly resolve: (input: {\n\t\treadonly pluginId: string;\n\t\treadonly pluginVersion?: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => PluginRegistryPackageV1 | undefined | Promise<PluginRegistryPackageV1 | undefined>;\n}\n\n/**\n * Host-injected multi-source acquisition boundary for `plugin install <ref>`\n * (npm / custom URL / local). Like registry access it is host-owned; the CLI\n * never downloads by itself.\n */\nexport interface PluginEcosystemCliAcquisitionV1 {\n\treadonly resolvePackage: (input: {\n\t\treadonly ref: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginAcquisitionPackageV1>;\n}\n\nexport interface PluginEcosystemCliOptionsV1 {\n\treadonly host?: HostFactsV1;\n\treadonly manifests?: readonly PluginManifestV1[];\n\treadonly registry?: PluginEcosystemRegistryV1;\n\t/** Optional multi-source acquisition boundary for `install <ref>` targets. */\n\treadonly acquisition?: PluginEcosystemCliAcquisitionV1;\n\treadonly installer?: PluginInstallerV1;\n\t/** Host-owned descriptor verifier and artifact acquisition boundary. */\n\treadonly distribution?: PluginDistributionV1;\n\treadonly stateStore?: PluginStateStoreV1;\n\t/** Alias for hosts that expose the persistence boundary as a state host. */\n\treadonly stateHost?: PluginStateStoreV1;\n\t/** Optional project-local state store. Global state remains the default. */\n\treadonly projectStateStore?: PluginStateStoreV1;\n\t/** Opaque concrete host namespace for project-scoped installations. */\n\treadonly projectScopeRef?: string;\n\treadonly selectionStore?: PluginSelectionStoreV1;\n\t/** Alias for hosts that expose the persistence boundary as a selection host. */\n\treadonly selectionHost?: PluginSelectionStoreV1;\n\t/** Optional project-local selection store. Global selection remains the default. */\n\treadonly projectSelectionStore?: PluginSelectionStoreV1;\n}\n\nexport interface PluginEcosystemCliRequestV1 {\n\treadonly argv: readonly string[];\n\treadonly format?: PluginEcosystemCliOutputFormatV1;\n\treadonly signal?: AbortSignal;\n}\n\nexport interface PluginEcosystemCliParsedCommandV1 {\n\treadonly version: typeof PLUGIN_ECOSYSTEM_CLI_VERSION_V1;\n\treadonly command: PluginEcosystemCliCommandNameV1;\n\treadonly format: PluginEcosystemCliOutputFormatV1;\n\treadonly pluginId?: string;\n\treadonly pluginVersion?: string;\n\t/** Raw install/update target; kept so ref forms survive the identity split. */\n\treadonly target?: string;\n\treadonly profileId?: string;\n\treadonly selectedPluginIds?: readonly string[];\n\treadonly scope?: PluginStateScopeV1;\n}\n\nexport type PluginEcosystemCliErrorCodeV1 =\n\t| \"invalid_command\"\n\t| \"unsupported_dependencies\"\n\t| \"not_found\"\n\t| \"not_installed\"\n\t| \"selection_failed\"\n\t| \"registry_failed\"\n\t| \"acquisition_failed\"\n\t| \"distribution_failed\"\n\t| \"incompatible\"\n\t| \"already_installed\"\n\t| \"installer_failed\"\n\t| \"uninstall_failed\"\n\t| \"state_failed\"\n\t| \"cancelled\";\n\nexport interface PluginEcosystemCliErrorV1 {\n\treadonly code: PluginEcosystemCliErrorCodeV1;\n\treadonly message: string;\n}\n\nexport interface PluginEcosystemCliResponseV1 {\n\treadonly version: typeof PLUGIN_ECOSYSTEM_CLI_VERSION_V1;\n\treadonly command: PluginEcosystemCliCommandNameV1 | \"invalid\";\n\treadonly format: PluginEcosystemCliOutputFormatV1;\n\treadonly status: \"succeeded\" | \"failed\" | \"unsupported\" | \"cancelled\";\n\treadonly data?: Readonly<Record<string, unknown>>;\n\treadonly text: string;\n\treadonly error?: PluginEcosystemCliErrorV1;\n}\n\nexport interface PluginEcosystemCliV1 {\n\treadonly execute: (input: PluginEcosystemCliRequestV1) => Promise<PluginEcosystemCliResponseV1>;\n}\n\ntype ResultData = Readonly<Record<string, unknown>>;\n\nfunction invalidInput(message: string): never {\n\tthrow new Error(message);\n}\n\nfunction validateToken(value: string, label: string): string {\n\tif (value.length === 0 || value.length > 256 || /[\\u0000-\\u001f\\s]/u.test(value))\n\t\tinvalidInput(`${label} is invalid`);\n\treturn value;\n}\n\nfunction parseIdentity(value: string): {\n\treadonly pluginId: string;\n\treadonly pluginVersion?: string;\n} {\n\tconst token = validateToken(value, \"plugin identity\");\n\tconst at = token.lastIndexOf(\"@\");\n\tif (at <= 0) return { pluginId: token };\n\tconst pluginId = token.slice(0, at);\n\tconst pluginVersion = token.slice(at + 1);\n\tif (pluginVersion.length === 0) invalidInput(\"plugin version is invalid\");\n\treturn {\n\t\tpluginId: validateToken(pluginId, \"plugin ID\"),\n\t\tpluginVersion: validateToken(pluginVersion, \"plugin version\"),\n\t};\n}\n\n/** Parse only the ecosystem command grammar; legacy package commands are not accepted. */\nexport function parsePluginEcosystemCliCommandV1(\n\targv: readonly string[],\n\tdefaultFormat: PluginEcosystemCliOutputFormatV1 = \"text\",\n): PluginEcosystemCliParsedCommandV1 {\n\tif (!Array.isArray(argv) || argv.length === 0 || argv.length > MAX_PLUGIN_ECOSYSTEM_CLI_ARGS_V1)\n\t\tinvalidInput(\"ecosystem command is invalid\");\n\tlet format = defaultFormat;\n\tif (format !== \"json\" && format !== \"text\") invalidInput(\"output format is invalid\");\n\tconst args = [...argv];\n\tlet explicitFormat: PluginEcosystemCliOutputFormatV1 | undefined;\n\tlet scope: PluginStateScopeV1 | undefined;\n\tlet pluginIdsOption: readonly string[] | undefined;\n\tfor (let index = args.length - 1; index >= 0; index -= 1) {\n\t\tconst token = args[index];\n\t\tconst inlineScope = token.startsWith(\"--scope=\") ? token.slice(\"--scope=\".length) : undefined;\n\t\tconst selectedScope = inlineScope ?? (token === \"--scope\" ? args[index + 1] : undefined);\n\t\tif (selectedScope !== undefined) {\n\t\t\tif (selectedScope !== \"global\" && selectedScope !== \"project\") invalidInput(\"state scope is invalid\");\n\t\t\tif (scope !== undefined && scope !== selectedScope) invalidInput(\"state scope is specified more than once\");\n\t\t\tscope = selectedScope;\n\t\t\targs.splice(index, token === \"--scope\" ? 2 : 1);\n\t\t\tcontinue;\n\t\t}\n\t\tconst inlineFormat = token.startsWith(\"--format=\") ? token.slice(\"--format=\".length) : undefined;\n\t\tconst selected =\n\t\t\ttoken === \"--json\" || token === \"--text\"\n\t\t\t\t? token === \"--json\"\n\t\t\t\t\t? \"json\"\n\t\t\t\t\t: \"text\"\n\t\t\t\t: (inlineFormat ?? (token === \"--format\" ? args[index + 1] : undefined));\n\t\tif (selected !== undefined) {\n\t\t\tif (selected !== \"json\" && selected !== \"text\") invalidInput(\"output format is invalid\");\n\t\t\tif (explicitFormat !== undefined && explicitFormat !== selected)\n\t\t\t\tinvalidInput(\"output format is specified more than once\");\n\t\t\texplicitFormat = selected as PluginEcosystemCliOutputFormatV1;\n\t\t\tformat = explicitFormat;\n\t\t\targs.splice(index, token === \"--format\" ? 2 : 1);\n\t\t\tcontinue;\n\t\t}\n\t\tconst inlinePlugins = token.startsWith(\"--plugins=\") ? token.slice(\"--plugins=\".length) : undefined;\n\t\tconst selectedPlugins = inlinePlugins ?? (token === \"--plugins\" ? args[index + 1] : undefined);\n\t\tif (selectedPlugins !== undefined) {\n\t\t\tif (pluginIdsOption !== undefined) invalidInput(\"plugin IDs are specified more than once\");\n\t\t\tconst ids = selectedPlugins.split(\",\");\n\t\t\tif (ids.length > MAX_PLUGIN_SELECTION_IDS_V1) invalidInput(\"too many plugin IDs\");\n\t\t\tpluginIdsOption = Object.freeze(ids.map((id: string) => validateToken(id, \"plugin ID\")));\n\t\t\targs.splice(index, token === \"--plugins\" ? 2 : 1);\n\t\t}\n\t}\n\tif (args.length === 0) invalidInput(\"ecosystem command is invalid\");\n\tconst [group, action, target, ...rest] = args;\n\tif (group === \"selection\" && action === \"set\" && target !== undefined) {\n\t\tif (pluginIdsOption !== undefined && rest.length > 0) invalidInput(\"plugin IDs must use one input form\");\n\t\tconst selectedPluginIds = pluginIdsOption ?? Object.freeze(rest.map((id) => validateToken(id, \"plugin ID\")));\n\t\tif (selectedPluginIds.length > MAX_PLUGIN_SELECTION_IDS_V1) invalidInput(\"too many plugin IDs\");\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: \"selection-set\",\n\t\t\tformat,\n\t\t\tprofileId: validateToken(target, \"profile ID\"),\n\t\t\tselectedPluginIds,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t});\n\t}\n\tif (rest.length > 0) invalidInput(\"ecosystem command has unsupported arguments\");\n\tif (group === \"catalog\" && action === \"list\" && target === undefined)\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: \"catalog-list\",\n\t\t\tformat,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t});\n\tif (group === \"state\" && action === \"list\" && target === undefined)\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: \"state-list\",\n\t\t\tformat,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t});\n\tif (group === \"selection\" && action === \"list\" && target === undefined)\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: \"selection-list\",\n\t\t\tformat,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t});\n\tif (group === \"selection\" && action === \"clear\" && target !== undefined)\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: \"selection-clear\",\n\t\t\tformat,\n\t\t\tprofileId: validateToken(target, \"profile ID\"),\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t});\n\tif (group === \"state\" && (action === \"enable\" || action === \"disable\" || action === \"remove\") && target) {\n\t\tconst identity = parseIdentity(target);\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: action,\n\t\t\tformat,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t\t...identity,\n\t\t});\n\t}\n\t// Top-level aliases keep the common install/remove workflow concise while\n\t// preserving the explicit `state <action>` grammar for scripts.\n\tif ((group === \"enable\" || group === \"disable\" || group === \"remove\") && action) {\n\t\tconst identity = parseIdentity(action);\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: group,\n\t\t\tformat,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t\t...identity,\n\t\t});\n\t}\n\t// Install/update keeps the legacy `pluginId[@version]` identity grammar and\n\t// additionally preserves the raw target: refs with npm/path/URL markers\n\t// (`/`, `:`, `#`, leading `@`, `@^…`/`@~…`/`@latest`) route to the\n\t// acquisition boundary; bare IDs and exact-version identities keep the\n\t// registry resolve path unchanged.\n\tif ((group === \"install\" || group === \"update\") && action) {\n\t\tconst identity = parseIdentity(action);\n\t\treturn Object.freeze({\n\t\t\tversion: 1,\n\t\t\tcommand: group,\n\t\t\tformat,\n\t\t\ttarget: action,\n\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t\t...identity,\n\t\t});\n\t}\n\tinvalidInput(\"ecosystem command is invalid\");\n}\n\nfunction response(\n\tcommand: PluginEcosystemCliResponseV1[\"command\"],\n\tformat: PluginEcosystemCliOutputFormatV1,\n\tstatus: PluginEcosystemCliResponseV1[\"status\"],\n\terror?: PluginEcosystemCliErrorV1,\n\tdata?: ResultData,\n): PluginEcosystemCliResponseV1 {\n\tlet safeData = data === undefined ? undefined : boundData(data);\n\tif (safeData !== undefined && Array.isArray(safeData.entries)) {\n\t\tlet entries = [...safeData.entries];\n\t\tconst originalEntryCount = entries.length;\n\t\twhile (entries.length > 0) {\n\t\t\tconst candidate = {\n\t\t\t\t...safeData,\n\t\t\t\tentries,\n\t\t\t\t...(entries.length < safeData.entries.length ? { truncated: true } : {}),\n\t\t\t};\n\t\t\tif (responseWithinBudget(command, format, status, error, candidate)) {\n\t\t\t\tsafeData = Object.freeze(candidate);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tentries = entries.slice(0, -1);\n\t\t}\n\t\tif (entries.length === 0 && originalEntryCount > 0)\n\t\t\tsafeData = Object.freeze({\n\t\t\t\tentries: Object.freeze([]),\n\t\t\t\ttruncated: true,\n\t\t\t});\n\t}\n\tif (!responseWithinBudget(command, format, status, error, safeData)) safeData = Object.freeze({ truncated: true });\n\tconst base = responseBase(command, format, status, error, safeData);\n\tconst humanText = error ? `${status}: ${error.message}` : formatText(command, status, safeData);\n\tconst text = format === \"json\" ? JSON.stringify(base) : humanText;\n\treturn Object.freeze({\n\t\t...base,\n\t\ttext: boundText(text),\n\t});\n}\n\nfunction responseWithinBudget(\n\tcommand: PluginEcosystemCliResponseV1[\"command\"],\n\tformat: PluginEcosystemCliOutputFormatV1,\n\tstatus: PluginEcosystemCliResponseV1[\"status\"],\n\terror: PluginEcosystemCliErrorV1 | undefined,\n\tdata: ResultData | undefined,\n): boolean {\n\tconst base = responseBase(command, format, status, error, data);\n\tconst humanText = error ? `${status}: ${error.message}` : formatText(command, status, data);\n\tconst text = format === \"json\" ? JSON.stringify(base) : humanText;\n\treturn responseByteLength({ ...base, text: boundText(text) }) <= MAX_PLUGIN_ECOSYSTEM_CLI_OUTPUT_BYTES_V1;\n}\n\nfunction responseBase(\n\tcommand: PluginEcosystemCliResponseV1[\"command\"],\n\tformat: PluginEcosystemCliOutputFormatV1,\n\tstatus: PluginEcosystemCliResponseV1[\"status\"],\n\terror: PluginEcosystemCliErrorV1 | undefined,\n\tdata: ResultData | undefined,\n): Omit<PluginEcosystemCliResponseV1, \"text\"> {\n\treturn {\n\t\tversion: PLUGIN_ECOSYSTEM_CLI_VERSION_V1,\n\t\tcommand,\n\t\tformat,\n\t\tstatus,\n\t\t...(data === undefined ? {} : { data }),\n\t\t...(error === undefined ? {} : { error }),\n\t};\n}\n\nfunction responseByteLength(value: unknown): number {\n\treturn Buffer.byteLength(JSON.stringify(value), \"utf8\");\n}\n\nfunction boundText(value: string): string {\n\tif (Buffer.byteLength(value, \"utf8\") <= MAX_PLUGIN_ECOSYSTEM_CLI_OUTPUT_BYTES_V1) return value;\n\tconst suffix = \"\\n[output truncated]\";\n\tlet lower = 0;\n\tlet upper = value.length;\n\twhile (lower < upper) {\n\t\tconst middle = Math.ceil((lower + upper) / 2);\n\t\tif (Buffer.byteLength(`${value.slice(0, middle)}${suffix}`, \"utf8\") <= MAX_PLUGIN_ECOSYSTEM_CLI_OUTPUT_BYTES_V1)\n\t\t\tlower = middle;\n\t\telse upper = middle - 1;\n\t}\n\treturn `${value.slice(0, lower)}${suffix}`;\n}\n\nfunction boundData(data: ResultData): ResultData {\n\tconst list = data.entries;\n\tif (!Array.isArray(list) || list.length <= MAX_PLUGIN_ECOSYSTEM_CLI_LIST_ENTRIES_V1)\n\t\treturn Object.freeze({ ...data });\n\treturn Object.freeze({\n\t\t...data,\n\t\tentries: Object.freeze(list.slice(0, MAX_PLUGIN_ECOSYSTEM_CLI_LIST_ENTRIES_V1)),\n\t\ttruncated: true,\n\t});\n}\n\nfunction formatText(command: string, status: string, data?: ResultData): string {\n\tif (data === undefined) return `${status}: ${command}`;\n\tconst entries = data.entries;\n\tif (Array.isArray(entries)) {\n\t\tconst lines = entries.map((entry) => {\n\t\t\tif (typeof entry !== \"object\" || entry === null) return String(entry);\n\t\t\tconst item = entry as Record<string, unknown>;\n\t\t\tconst id =\n\t\t\t\ttypeof item.profileId === \"string\"\n\t\t\t\t\t? `profile:${item.profileId}`\n\t\t\t\t\t: typeof item.pluginId === \"string\"\n\t\t\t\t\t\t? item.pluginId\n\t\t\t\t\t\t: \"plugin\";\n\t\t\tconst version = typeof item.pluginVersion === \"string\" ? `@${item.pluginVersion}` : \"\";\n\t\t\tconst state =\n\t\t\t\ttypeof item.status === \"string\"\n\t\t\t\t\t? ` ${item.status}`\n\t\t\t\t\t: typeof item.lifecycle === \"string\"\n\t\t\t\t\t\t? ` ${item.lifecycle}`\n\t\t\t\t\t\t: \"\";\n\t\t\treturn `${id}${version}${state}`;\n\t\t});\n\t\treturn [`${status}: ${command}`, ...lines, ...(data.truncated === true ? [\"[output truncated]\"] : [])].join(\"\\n\");\n\t}\n\tif (typeof data.profileId === \"string\") {\n\t\tconst selected = Array.isArray(data.selectedPluginIds) ? ` selected=${data.selectedPluginIds.join(\",\")}` : \"\";\n\t\tconst disabled = Array.isArray(data.disabledPluginIds) ? ` disabled=${data.disabledPluginIds.join(\",\")}` : \"\";\n\t\treturn `${status}: ${command} profile:${data.profileId}${selected}${disabled}`;\n\t}\n\treturn `${status}: ${command}`;\n}\n\nfunction safeError(code: PluginEcosystemCliErrorCodeV1): PluginEcosystemCliErrorV1 {\n\tconst messages: Record<PluginEcosystemCliErrorCodeV1, string> = {\n\t\tinvalid_command: \"The plugin ecosystem command is invalid\",\n\t\tunsupported_dependencies: \"The plugin ecosystem operation is unavailable on this host\",\n\t\tnot_found: \"The requested plugin was not found\",\n\t\tnot_installed: \"The requested plugin is not installed\",\n\t\tregistry_failed: \"The plugin registry operation failed\",\n\t\tacquisition_failed: \"The plugin package acquisition failed\",\n\t\tdistribution_failed: \"The plugin distribution operation failed\",\n\t\tincompatible: \"The requested plugin is incompatible with this host\",\n\t\talready_installed: \"This plugin version is already installed in the requested scope\",\n\t\tinstaller_failed: \"The plugin installer operation failed\",\n\t\tuninstall_failed: \"The host plugin uninstall operation failed\",\n\t\tstate_failed: \"The plugin state operation failed\",\n\t\tselection_failed: \"The plugin selection operation failed\",\n\t\tcancelled: \"Plugin ecosystem operation was cancelled\",\n\t};\n\treturn Object.freeze({ code, message: messages[code] });\n}\n\nfunction isCancelled(signal: AbortSignal | undefined): boolean {\n\treturn signal?.aborted === true;\n}\n\nfunction stateStoreOf(\n\toptions: PluginEcosystemCliOptionsV1,\n\tscope: PluginStateScopeV1 | undefined,\n): PluginStateStoreV1 | undefined {\n\tif (scope === \"project\") return options.projectStateStore;\n\treturn options.stateStore ?? options.stateHost;\n}\n\nfunction operationScope(scope: PluginStateScopeV1 | undefined): PluginStateScopeV1 {\n\treturn scope ?? \"global\";\n}\n\nfunction scopeRefOf(options: PluginEcosystemCliOptionsV1, scope: PluginStateScopeV1): string | undefined {\n\treturn scope === \"global\" ? DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1 : options.projectScopeRef;\n}\n\nfunction installerSupportsScope(installer: PluginInstallerV1 | undefined, scope: PluginStateScopeV1): boolean {\n\treturn installer?.supportedScopes?.includes(scope) === true;\n}\n\nfunction selectionStoreOf(\n\toptions: PluginEcosystemCliOptionsV1,\n\tscope: PluginStateScopeV1 | undefined,\n): PluginSelectionStoreV1 | undefined {\n\tif (scope === \"project\") return options.projectSelectionStore;\n\treturn options.selectionStore ?? options.selectionHost;\n}\n\nfunction stateEntry(record: PluginStateRecordV1): Readonly<Record<string, unknown>> {\n\treturn Object.freeze({\n\t\tpluginId: record.pluginId,\n\t\tpluginVersion: record.pluginVersion,\n\t\tmanifestDigest: record.manifestDigest,\n\t\tscope: record.state.scope,\n\t\tscopeRef: record.state.scopeRef,\n\t\tenabled: record.state.enabled,\n\t\tlifecycle: record.state.lifecycle,\n\t\t...(record.source === undefined ? {} : { source: record.source }),\n\t});\n}\n\nfunction selectionEntry(selection: {\n\treadonly profileId: string;\n\treadonly selectedPluginIds: readonly string[];\n\treadonly disabledPluginIds: readonly string[];\n}): Readonly<Record<string, unknown>> {\n\treturn Object.freeze({\n\t\tprofileId: selection.profileId,\n\t\tselectedPluginIds: Object.freeze([...selection.selectedPluginIds]),\n\t\tdisabledPluginIds: Object.freeze([...selection.disabledPluginIds]),\n\t});\n}\n\nfunction catalogEntry(entry: {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestDigest: string;\n\treadonly resolution: {\n\t\treadonly status: string;\n\t\treadonly diagnostics: readonly { readonly code: string }[];\n\t};\n}): Readonly<Record<string, unknown>> {\n\treturn Object.freeze({\n\t\tpluginId: entry.pluginId,\n\t\tpluginVersion: entry.pluginVersion,\n\t\tmanifestDigest: entry.manifestDigest,\n\t\tstatus: entry.resolution.status,\n\t\tdiagnosticCodes: Object.freeze(entry.resolution.diagnostics.map((item) => item.code).slice(0, 16)),\n\t});\n}\n\nfunction findStateRecord(\n\trecords: readonly PluginStateRecordV1[],\n\tpluginId: string,\n\tpluginVersion?: string,\n\tscope?: PluginStateScopeV1,\n\tscopeRef?: string,\n): PluginStateRecordV1 | undefined {\n\treturn records.find(\n\t\t(record) =>\n\t\t\trecord.pluginId === pluginId &&\n\t\t\t(pluginVersion === undefined || record.pluginVersion === pluginVersion) &&\n\t\t\t(scope === undefined || record.state.scope === scope) &&\n\t\t\t(scopeRef === undefined || record.state.scopeRef === scopeRef),\n\t);\n}\n\nfunction findCurrentStateRecord(\n\trecords: readonly PluginStateRecordV1[],\n\tpluginId: string,\n\tscope?: PluginStateScopeV1,\n\tscopeRef?: string,\n): PluginStateRecordV1 | undefined {\n\treturn (\n\t\trecords.find(\n\t\t\t(record) =>\n\t\t\t\trecord.pluginId === pluginId &&\n\t\t\t\t(scope === undefined || record.state.scope === scope) &&\n\t\t\t\t(scopeRef === undefined || record.state.scopeRef === scopeRef) &&\n\t\t\t\trecord.state.lifecycle === \"active\",\n\t\t) ?? findStateRecord(records, pluginId, undefined, scope, scopeRef)\n\t);\n}\n\nfunction requireDependencies(\n\toptions: PluginEcosystemCliOptionsV1,\n\tscope: PluginStateScopeV1 | undefined,\n\tscopeRef: string | undefined,\n): asserts options is PluginEcosystemCliOptionsV1 & {\n\treadonly registry: PluginEcosystemRegistryV1;\n\treadonly installer: PluginInstallerV1;\n\treadonly host: HostFactsV1;\n} {\n\tconst requestedScope = operationScope(scope);\n\tif (\n\t\t!options.registry ||\n\t\t!options.installer ||\n\t\tscopeRef === undefined ||\n\t\t!installerSupportsScope(options.installer, requestedScope) ||\n\t\t!stateStoreOf(options, requestedScope) ||\n\t\t!options.host\n\t)\n\t\tthrow new Error(\"unsupported dependencies\");\n}\n\nasync function listManifests(\n\toptions: PluginEcosystemCliOptionsV1,\n\tsignal?: AbortSignal,\n): Promise<readonly PluginManifestV1[]> {\n\tif (options.registry?.list) return await options.registry.list({ signal });\n\tif (options.manifests) return options.manifests;\n\tthrow new Error(\"unsupported dependencies\");\n}\n\nfunction checkSignal(signal?: AbortSignal): void {\n\tif (isCancelled(signal)) throw new Error(\"cancelled\");\n}\n\nexport function createPluginEcosystemCliV1(options: PluginEcosystemCliOptionsV1): PluginEcosystemCliV1 {\n\t// Host installation and state persistence are a single logical transaction.\n\t// Serializing them prevents two same-version requests from both passing the\n\t// preflight state read and orphaning one physical installation.\n\tlet installTransactionTail: Promise<void> = Promise.resolve();\n\tasync function acquireInstallTransaction(): Promise<() => void> {\n\t\tlet release!: () => void;\n\t\tconst turn = new Promise<void>((resolve) => {\n\t\t\trelease = resolve;\n\t\t});\n\t\tconst previous = installTransactionTail;\n\t\tinstallTransactionTail = previous.then(\n\t\t\t() => turn,\n\t\t\t() => turn,\n\t\t);\n\t\tawait previous;\n\t\treturn release;\n\t}\n\n\tasync function execute(input: PluginEcosystemCliRequestV1): Promise<PluginEcosystemCliResponseV1> {\n\t\tlet parsed: PluginEcosystemCliParsedCommandV1;\n\t\ttry {\n\t\t\tparsed = parsePluginEcosystemCliCommandV1(input.argv, input.format ?? \"text\");\n\t\t} catch {\n\t\t\treturn response(\"invalid\", input.format === \"json\" ? \"json\" : \"text\", \"failed\", safeError(\"invalid_command\"));\n\t\t}\n\t\tconst releaseInstallTransaction =\n\t\t\tparsed.command === \"install\" || parsed.command === \"update\" ? await acquireInstallTransaction() : undefined;\n\t\ttry {\n\t\t\tconst signal = input.signal;\n\t\t\tconst requestedScope = operationScope(parsed.scope);\n\t\t\tconst scopeRef = scopeRefOf(options, requestedScope);\n\t\t\tif (isCancelled(signal)) return response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\tif (scopeRef === undefined)\n\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\tlet phase: \"registry\" | \"distribution\" | \"state\" | \"selection\" | \"installer\" = \"registry\";\n\t\t\ttry {\n\t\t\t\tif (parsed.command === \"catalog-list\") {\n\t\t\t\t\tif (!options.host)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst manifests = await listManifests(options, signal);\n\t\t\t\t\tcheckSignal(signal);\n\t\t\t\t\tconst snapshot = buildPluginCatalogV1({\n\t\t\t\t\t\tmanifests,\n\t\t\t\t\t\thost: options.host,\n\t\t\t\t\t\tmaxEntries: MAX_PLUGIN_ECOSYSTEM_CLI_LIST_ENTRIES_V1,\n\t\t\t\t\t});\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tversion: snapshot.version,\n\t\t\t\t\t\tentries: snapshot.entries.map(catalogEntry),\n\t\t\t\t\t\ttruncated: snapshot.truncated,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (parsed.command === \"selection-list\") {\n\t\t\t\t\tphase = \"selection\";\n\t\t\t\t\tconst selectionStore = selectionStoreOf(options, parsed.scope);\n\t\t\t\t\tif (!selectionStore)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst result = await selectionStore.read({ signal });\n\t\t\t\t\tif (result.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (result.status === \"invalid\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"selection_failed\"));\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tversion: result.snapshot.version,\n\t\t\t\t\t\tscope: parsed.scope ?? \"global\",\n\t\t\t\t\t\tentries: result.snapshot.selections.map(selectionEntry),\n\t\t\t\t\t\ttruncated: false,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (parsed.command === \"selection-set\") {\n\t\t\t\t\tphase = \"selection\";\n\t\t\t\t\tconst selectionStore = selectionStoreOf(options, parsed.scope);\n\t\t\t\t\tif (!selectionStore)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tlet selection: PluginSelectionV1;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tselection = createPluginSelectionV1({\n\t\t\t\t\t\t\tprofileId: parsed.profileId as string,\n\t\t\t\t\t\t\tselectedPluginIds: parsed.selectedPluginIds ?? [],\n\t\t\t\t\t\t\tdisabledPluginIds: [],\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch {\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"selection_failed\"));\n\t\t\t\t\t}\n\t\t\t\t\tconst result = await selectionStore.set({ selection, signal });\n\t\t\t\t\tif (result.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (result.status !== \"ok\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"selection_failed\"));\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tprofileId: selection.profileId,\n\t\t\t\t\t\tscope: parsed.scope ?? \"global\",\n\t\t\t\t\t\tselectedPluginIds: selection.selectedPluginIds,\n\t\t\t\t\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t\t\t\t\t\tchanged: result.changed,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (parsed.command === \"selection-clear\") {\n\t\t\t\t\tphase = \"selection\";\n\t\t\t\t\tconst selectionStore = selectionStoreOf(options, parsed.scope);\n\t\t\t\t\tif (!selectionStore)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst result = await selectionStore.clear({\n\t\t\t\t\t\tprofileId: parsed.profileId as string,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t});\n\t\t\t\t\tif (result.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (result.status !== \"ok\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"selection_failed\"));\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tprofileId: parsed.profileId,\n\t\t\t\t\t\tscope: parsed.scope ?? \"global\",\n\t\t\t\t\t\tchanged: result.changed,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (parsed.command === \"state-list\") {\n\t\t\t\t\tphase = \"state\";\n\t\t\t\t\tconst stateStore = stateStoreOf(options, requestedScope);\n\t\t\t\t\tif (!stateStore)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst result = await stateStore.read({ signal });\n\t\t\t\t\tif (result.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (result.status === \"invalid\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"state_failed\"));\n\t\t\t\t\tconst records = result.snapshot.records.filter(\n\t\t\t\t\t\t(record) => record.state.scope === requestedScope && record.state.scopeRef === scopeRef,\n\t\t\t\t\t);\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tversion: result.snapshot.version,\n\t\t\t\t\t\tentries: records.map(stateEntry),\n\t\t\t\t\t\ttruncated: false,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (parsed.command === \"enable\" || parsed.command === \"disable\" || parsed.command === \"remove\") {\n\t\t\t\t\tphase = \"state\";\n\t\t\t\t\tif (\n\t\t\t\t\t\tparsed.command === \"remove\" &&\n\t\t\t\t\t\trequestedScope === \"project\" &&\n\t\t\t\t\t\t!installerSupportsScope(options.installer, requestedScope)\n\t\t\t\t\t)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst stateStore = stateStoreOf(options, requestedScope);\n\t\t\t\t\tif (!stateStore)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tconst current = await stateStore.read({ signal });\n\t\t\t\t\tif (current.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (current.status === \"invalid\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"state_failed\"));\n\t\t\t\t\tconst record =\n\t\t\t\t\t\tparsed.pluginVersion === undefined\n\t\t\t\t\t\t\t? findCurrentStateRecord(\n\t\t\t\t\t\t\t\t\tcurrent.snapshot.records,\n\t\t\t\t\t\t\t\t\tparsed.pluginId as string,\n\t\t\t\t\t\t\t\t\trequestedScope,\n\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t: findStateRecord(\n\t\t\t\t\t\t\t\t\tcurrent.snapshot.records,\n\t\t\t\t\t\t\t\t\tparsed.pluginId as string,\n\t\t\t\t\t\t\t\t\tparsed.pluginVersion,\n\t\t\t\t\t\t\t\t\trequestedScope,\n\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\tif (!record) return response(parsed.command, parsed.format, \"failed\", safeError(\"not_installed\"));\n\t\t\t\t\tif (parsed.command === \"remove\") {\n\t\t\t\t\t\t// Global state-only removal remains available for repairing stale records.\n\t\t\t\t\t\t// Project removal requires a scope-capable installer and host cleanup first.\n\t\t\t\t\t\tif (options.installer !== undefined) {\n\t\t\t\t\t\t\tlet removedFromHost: Awaited<ReturnType<PluginInstallerV1[\"remove\"]>>;\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tremovedFromHost = await options.installer.remove({\n\t\t\t\t\t\t\t\t\tinstallation: {\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\tpluginId: record.pluginId,\n\t\t\t\t\t\t\t\t\t\tpluginVersion: record.pluginVersion,\n\t\t\t\t\t\t\t\t\t\tmanifestDigest: record.manifestDigest,\n\t\t\t\t\t\t\t\t\t\tscope: record.state.scope,\n\t\t\t\t\t\t\t\t\t\tscopeRef: record.state.scopeRef,\n\t\t\t\t\t\t\t\t\t\tinstallationRef: record.installationRef,\n\t\t\t\t\t\t\t\t\t\tstate: record.state.lifecycle,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"uninstall_failed\"));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (removedFromHost.status !== \"succeeded\")\n\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\tremovedFromHost.status === \"cancelled\" ? \"cancelled\" : \"failed\",\n\t\t\t\t\t\t\t\t\tsafeError(removedFromHost.status === \"cancelled\" ? \"cancelled\" : \"uninstall_failed\"),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst removed = await stateStore.remove({\n\t\t\t\t\t\t\tpluginId: record.pluginId,\n\t\t\t\t\t\t\tpluginVersion: record.pluginVersion,\n\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tif (removed.status === \"cancelled\")\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\t\tif (removed.status !== \"ok\")\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"state_failed\"));\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\t\tpluginId: record.pluginId,\n\t\t\t\t\t\t\tpluginVersion: record.pluginVersion,\n\t\t\t\t\t\t\t...(options.installer === undefined ? {} : { hostRemoved: true }),\n\t\t\t\t\t\t\tchanged: removed.changed,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst enabled = parsed.command === \"enable\";\n\t\t\t\t\tconst updated = await stateStore.upsert({\n\t\t\t\t\t\tinstallation: {\n\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\tpluginId: record.pluginId,\n\t\t\t\t\t\t\tpluginVersion: record.pluginVersion,\n\t\t\t\t\t\t\tmanifestDigest: record.manifestDigest,\n\t\t\t\t\t\t\tscope: record.state.scope,\n\t\t\t\t\t\t\tscopeRef: record.state.scopeRef,\n\t\t\t\t\t\t\tinstallationRef: record.installationRef,\n\t\t\t\t\t\t\tstate: record.state.lifecycle,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\tenabled,\n\t\t\t\t\t\t...(record.source === undefined ? {} : { source: record.source }),\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t});\n\t\t\t\t\tif (updated.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (updated.status !== \"ok\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"state_failed\"));\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\tpluginId: record.pluginId,\n\t\t\t\t\t\tpluginVersion: record.pluginVersion,\n\t\t\t\t\t\tenabled,\n\t\t\t\t\t\tchanged: updated.changed,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\t// install/update must have every host boundary injected. They never claim success with partial services.\n\t\t\t\tconst stateStore = stateStoreOf(options, requestedScope);\n\t\t\t\t// Const locals keep the narrowing alive inside the shared install flow closure.\n\t\t\t\tconst installer = options.installer;\n\t\t\t\tconst host = options.host;\n\t\t\t\tconst acquisitionTarget =\n\t\t\t\t\tparsed.command === \"install\" &&\n\t\t\t\t\tparsed.target !== undefined &&\n\t\t\t\t\tisPluginAcquisitionRefTargetV1(parsed.target)\n\t\t\t\t\t\t? parsed.target\n\t\t\t\t\t\t: undefined;\n\t\t\t\tif (\n\t\t\t\t\t!stateStore ||\n\t\t\t\t\t!installer ||\n\t\t\t\t\t!host ||\n\t\t\t\t\t!installerSupportsScope(installer, requestedScope) ||\n\t\t\t\t\t(acquisitionTarget === undefined && !options.registry)\n\t\t\t\t)\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t// One shared install transaction serves both resolutions: the legacy\n\t\t\t\t// registry resolve path and the multi-source acquisition ref path.\n\t\t\t\tconst runInstallFlow = async (resolved: {\n\t\t\t\t\treadonly manifest: PluginManifestV1;\n\t\t\t\t\treadonly source: string;\n\t\t\t\t\treadonly expectedDigest?: string;\n\t\t\t\t\treadonly distribution?: PluginDistributionDescriptorV1;\n\t\t\t\t\treadonly acquired?: PluginAcquisitionPackageV1;\n\t\t\t\t}): Promise<PluginEcosystemCliResponseV1> => {\n\t\t\t\t\tphase = \"state\";\n\t\t\t\t\tconst current = await stateStore.read({ signal });\n\t\t\t\t\tif (current.status === \"cancelled\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\tif (current.status === \"invalid\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"state_failed\"));\n\t\t\t\t\tconst previous = findCurrentStateRecord(\n\t\t\t\t\t\tcurrent.snapshot.records,\n\t\t\t\t\t\tresolved.manifest.id,\n\t\t\t\t\t\trequestedScope,\n\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t);\n\t\t\t\t\tconst installedVersion = findStateRecord(\n\t\t\t\t\t\tcurrent.snapshot.records,\n\t\t\t\t\t\tresolved.manifest.id,\n\t\t\t\t\t\tresolved.manifest.pluginVersion,\n\t\t\t\t\t\trequestedScope,\n\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t);\n\t\t\t\t\tif (installedVersion !== undefined)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"already_installed\"));\n\t\t\t\t\tif (parsed.command === \"update\" && (!previous || previous.state.lifecycle !== \"active\"))\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"not_installed\"));\n\t\t\t\t\tphase = \"installer\";\n\t\t\t\t\tconst verified = installer.prepare({\n\t\t\t\t\t\tmanifest: resolved.manifest,\n\t\t\t\t\t\tsource: resolved.source,\n\t\t\t\t\t\thost,\n\t\t\t\t\t\t...(resolved.expectedDigest === undefined ? {} : { expectedDigest: resolved.expectedDigest }),\n\t\t\t\t\t});\n\t\t\t\t\tif (verified.status !== \"verified\")\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"incompatible\"));\n\t\t\t\t\tlet artifact: Awaited<ReturnType<PluginDistributionV1[\"acquireArtifact\"]>> | undefined =\n\t\t\t\t\t\tresolved.acquired?.artifact;\n\t\t\t\t\tif (resolved.distribution !== undefined) {\n\t\t\t\t\t\tif (options.distribution === undefined)\n\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\t\tsafeError(\"unsupported_dependencies\"),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\tphase = \"distribution\";\n\t\t\t\t\t\tconst descriptor = options.distribution.validateDescriptor(resolved.distribution);\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tdescriptor.pluginId !== verified.record.pluginId ||\n\t\t\t\t\t\t\tdescriptor.pluginVersion !== verified.record.pluginVersion ||\n\t\t\t\t\t\t\tdescriptor.manifestDigest !== verified.record.manifestDigest\n\t\t\t\t\t\t)\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"incompatible\"));\n\t\t\t\t\t\tartifact = await options.distribution.acquireArtifact({\n\t\t\t\t\t\t\tdescriptor,\n\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tlet artifactReleased = false;\n\t\t\t\t\tconst releaseArtifact = async (): Promise<boolean> => {\n\t\t\t\t\t\tif (artifact === undefined || artifactReleased) return true;\n\t\t\t\t\t\tconst previousPhase = phase;\n\t\t\t\t\t\tphase = \"distribution\";\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tif (resolved.acquired !== undefined) {\n\t\t\t\t\t\t\t\t// Acquisition artifacts are owned by the acquisition boundary.\n\t\t\t\t\t\t\t\tconst released = await resolved.acquired.release();\n\t\t\t\t\t\t\t\tif (!released) return false;\n\t\t\t\t\t\t\t\tartifactReleased = true;\n\t\t\t\t\t\t\t\tphase = previousPhase;\n\t\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t// Cleanup must complete even after the caller has cancelled the workflow.\n\t\t\t\t\t\t\tif (options.distribution === undefined) return false;\n\t\t\t\t\t\t\tawait options.distribution.releaseArtifact({ artifact });\n\t\t\t\t\t\t\tartifactReleased = true;\n\t\t\t\t\t\t\tphase = previousPhase;\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\tlet transactionResponse: PluginEcosystemCliResponseV1 | undefined;\n\t\t\t\t\tlet transactionError: unknown;\n\t\t\t\t\tlet artifactCleanupFailed = false;\n\t\t\t\t\ttry {\n\t\t\t\t\t\ttransactionResponse = await (async (): Promise<PluginEcosystemCliResponseV1> => {\n\t\t\t\t\t\t\tcheckSignal(signal);\n\t\t\t\t\t\t\tphase = \"installer\";\n\t\t\t\t\t\t\tconst installed = await installer.install({\n\t\t\t\t\t\t\t\trecord: verified.record,\n\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t...(artifact === undefined ? {} : { artifact }),\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tif (installed.status !== \"succeeded\") {\n\t\t\t\t\t\t\t\tif (!(await releaseArtifact()))\n\t\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\t\tisCancelled(signal) ? \"cancelled\" : \"failed\",\n\t\t\t\t\t\t\t\t\t\tsafeError(isCancelled(signal) ? \"cancelled\" : \"distribution_failed\"),\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\tinstalled.status === \"cancelled\" ? \"cancelled\" : \"failed\",\n\t\t\t\t\t\t\t\t\tsafeError(installed.status === \"cancelled\" ? \"cancelled\" : \"installer_failed\"),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst activated = await installer.activate({\n\t\t\t\t\t\t\t\tinstallation: installed.installation,\n\t\t\t\t\t\t\t\trecord: verified.record,\n\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tif (activated.status !== \"succeeded\") {\n\t\t\t\t\t\t\t\tif (previous && previous.state.lifecycle === \"active\") {\n\t\t\t\t\t\t\t\t\tconst rollback = await installer.rollback({\n\t\t\t\t\t\t\t\t\t\tfailed: installed.installation,\n\t\t\t\t\t\t\t\t\t\tprevious: {\n\t\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\t\tpluginId: previous.pluginId,\n\t\t\t\t\t\t\t\t\t\t\tpluginVersion: previous.pluginVersion,\n\t\t\t\t\t\t\t\t\t\t\tmanifestDigest: previous.manifestDigest,\n\t\t\t\t\t\t\t\t\t\t\tscope: previous.state.scope,\n\t\t\t\t\t\t\t\t\t\t\tscopeRef: previous.state.scopeRef,\n\t\t\t\t\t\t\t\t\t\t\tinstallationRef: previous.installationRef,\n\t\t\t\t\t\t\t\t\t\t\tstate: \"active\",\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t\t\tsignal: undefined,\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t\tif (rollback.status !== \"succeeded\")\n\t\t\t\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"installer_failed\"));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst removed = await installer.remove({\n\t\t\t\t\t\t\t\t\tinstallation: installed.installation,\n\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tif (removed.status !== \"succeeded\")\n\t\t\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"installer_failed\"));\n\t\t\t\t\t\t\t\tif (!(await releaseArtifact()))\n\t\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\t\tisCancelled(signal) ? \"cancelled\" : \"failed\",\n\t\t\t\t\t\t\t\t\t\tsafeError(isCancelled(signal) ? \"cancelled\" : \"distribution_failed\"),\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\tactivated.status === \"cancelled\" ? \"cancelled\" : \"failed\",\n\t\t\t\t\t\t\t\t\tsafeError(activated.status === \"cancelled\" ? \"cancelled\" : \"installer_failed\"),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst restoreActivatedInstallation = async (): Promise<boolean> => {\n\t\t\t\t\t\t\t\tconst replacesPrevious =\n\t\t\t\t\t\t\t\t\tprevious !== undefined &&\n\t\t\t\t\t\t\t\t\t`${previous.pluginId}@${previous.pluginVersion}` !==\n\t\t\t\t\t\t\t\t\t\t`${activated.installation.pluginId}@${activated.installation.pluginVersion}`;\n\t\t\t\t\t\t\t\tif (replacesPrevious && previous.state.lifecycle === \"active\") {\n\t\t\t\t\t\t\t\t\tconst rollback = await installer.rollback({\n\t\t\t\t\t\t\t\t\t\tfailed: activated.installation,\n\t\t\t\t\t\t\t\t\t\tprevious: {\n\t\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\t\tpluginId: previous.pluginId,\n\t\t\t\t\t\t\t\t\t\t\tpluginVersion: previous.pluginVersion,\n\t\t\t\t\t\t\t\t\t\t\tmanifestDigest: previous.manifestDigest,\n\t\t\t\t\t\t\t\t\t\t\tscope: previous.state.scope,\n\t\t\t\t\t\t\t\t\t\t\tscopeRef: previous.state.scopeRef,\n\t\t\t\t\t\t\t\t\t\t\tinstallationRef: previous.installationRef,\n\t\t\t\t\t\t\t\t\t\t\tstate: \"active\",\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t\tif (rollback.status !== \"succeeded\") return false;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (previous !== undefined && !replacesPrevious) return true;\n\t\t\t\t\t\t\t\tconst removed = await installer.remove({\n\t\t\t\t\t\t\t\t\tinstallation: activated.installation,\n\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\treturn removed.status === \"succeeded\";\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tconst restoreState = async (): Promise<boolean> => {\n\t\t\t\t\t\t\t\tconst replacesPrevious =\n\t\t\t\t\t\t\t\t\tprevious !== undefined &&\n\t\t\t\t\t\t\t\t\t`${previous.pluginId}@${previous.pluginVersion}` !==\n\t\t\t\t\t\t\t\t\t\t`${activated.installation.pluginId}@${activated.installation.pluginVersion}`;\n\t\t\t\t\t\t\t\tlet restored = true;\n\t\t\t\t\t\t\t\tif (previous === undefined || replacesPrevious) {\n\t\t\t\t\t\t\t\t\tconst removed = await stateStore\n\t\t\t\t\t\t\t\t\t\t.remove({\n\t\t\t\t\t\t\t\t\t\t\tpluginId: activated.installation.pluginId,\n\t\t\t\t\t\t\t\t\t\t\tpluginVersion: activated.installation.pluginVersion,\n\t\t\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\t\t\tscopeRef,\n\t\t\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t\t\t\t.catch(() => undefined);\n\t\t\t\t\t\t\t\t\trestored = removed?.status === \"ok\";\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (previous !== undefined) {\n\t\t\t\t\t\t\t\t\tconst restoredPrevious = await stateStore\n\t\t\t\t\t\t\t\t\t\t.upsert({\n\t\t\t\t\t\t\t\t\t\t\tinstallation: {\n\t\t\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\t\t\tpluginId: previous.pluginId,\n\t\t\t\t\t\t\t\t\t\t\t\tpluginVersion: previous.pluginVersion,\n\t\t\t\t\t\t\t\t\t\t\t\tmanifestDigest: previous.manifestDigest,\n\t\t\t\t\t\t\t\t\t\t\t\tscope: previous.state.scope,\n\t\t\t\t\t\t\t\t\t\t\t\tscopeRef: previous.state.scopeRef,\n\t\t\t\t\t\t\t\t\t\t\t\tinstallationRef: previous.installationRef,\n\t\t\t\t\t\t\t\t\t\t\t\tstate: \"active\",\n\t\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\t\t\tenabled: previous.state.enabled,\n\t\t\t\t\t\t\t\t\t\t\t...(previous.source === undefined ? {} : { source: previous.source }),\n\t\t\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t\t\t\t.catch(() => undefined);\n\t\t\t\t\t\t\t\t\trestored = restored && restoredPrevious?.status === \"ok\";\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn restored;\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tconst stateFailure = async (\n\t\t\t\t\t\t\t\tstatus: \"failed\" | \"cancelled\",\n\t\t\t\t\t\t\t): Promise<PluginEcosystemCliResponseV1> => {\n\t\t\t\t\t\t\t\tconst [hostRestored, stateRestored] = await Promise.all([\n\t\t\t\t\t\t\t\t\trestoreActivatedInstallation().catch(() => false),\n\t\t\t\t\t\t\t\t\trestoreState().catch(() => false),\n\t\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\thostRestored && stateRestored ? status : \"failed\",\n\t\t\t\t\t\t\t\t\tsafeError(\n\t\t\t\t\t\t\t\t\t\thostRestored && stateRestored\n\t\t\t\t\t\t\t\t\t\t\t? status === \"cancelled\"\n\t\t\t\t\t\t\t\t\t\t\t\t? \"cancelled\"\n\t\t\t\t\t\t\t\t\t\t\t\t: \"state_failed\"\n\t\t\t\t\t\t\t\t\t\t\t: \"installer_failed\",\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tif (!(await releaseArtifact())) {\n\t\t\t\t\t\t\t\tphase = \"installer\";\n\t\t\t\t\t\t\t\tconst restored = await restoreActivatedInstallation().catch(() => false);\n\t\t\t\t\t\t\t\treturn response(\n\t\t\t\t\t\t\t\t\tparsed.command,\n\t\t\t\t\t\t\t\t\tparsed.format,\n\t\t\t\t\t\t\t\t\t\"failed\",\n\t\t\t\t\t\t\t\t\tsafeError(restored ? \"distribution_failed\" : \"installer_failed\"),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tphase = \"state\";\n\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\tprevious &&\n\t\t\t\t\t\t\t\t`${previous.pluginId}@${previous.pluginVersion}` !==\n\t\t\t\t\t\t\t\t\t`${installed.installation.pluginId}@${installed.installation.pluginVersion}`\n\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\tconst retained = await stateStore.upsert({\n\t\t\t\t\t\t\t\t\tinstallation: {\n\t\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\t\tpluginId: previous.pluginId,\n\t\t\t\t\t\t\t\t\t\tpluginVersion: previous.pluginVersion,\n\t\t\t\t\t\t\t\t\t\tmanifestDigest: previous.manifestDigest,\n\t\t\t\t\t\t\t\t\t\tscope: previous.state.scope,\n\t\t\t\t\t\t\t\t\t\tscopeRef: previous.state.scopeRef,\n\t\t\t\t\t\t\t\t\t\tinstallationRef: previous.installationRef,\n\t\t\t\t\t\t\t\t\t\tstate: \"retained\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\t\tenabled: previous.state.enabled,\n\t\t\t\t\t\t\t\t\t...(previous.source === undefined ? {} : { source: previous.source }),\n\t\t\t\t\t\t\t\t\tsignal: undefined,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tif (retained.status !== \"ok\") return await stateFailure(\"failed\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst persisted = await stateStore.upsert({\n\t\t\t\t\t\t\t\tinstallation: activated.installation,\n\t\t\t\t\t\t\t\tscope: requestedScope,\n\t\t\t\t\t\t\t\tenabled: previous?.state.enabled ?? true,\n\t\t\t\t\t\t\t\t...(resolved.acquired === undefined ? {} : { source: resolved.source }),\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tif (persisted.status === \"cancelled\") return await stateFailure(\"cancelled\");\n\t\t\t\t\t\t\tif (persisted.status !== \"ok\") return await stateFailure(\"failed\");\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"succeeded\", undefined, {\n\t\t\t\t\t\t\t\tpluginId: activated.installation.pluginId,\n\t\t\t\t\t\t\t\tpluginVersion: activated.installation.pluginVersion,\n\t\t\t\t\t\t\t\tlifecycle: \"active\",\n\t\t\t\t\t\t\t\tchanged: persisted.changed,\n\t\t\t\t\t\t\t\t...(resolved.acquired === undefined ? {} : { source: resolved.source }),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t})();\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\ttransactionError = error;\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tartifactCleanupFailed = !(await releaseArtifact());\n\t\t\t\t\t}\n\t\t\t\t\tif (artifactCleanupFailed)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"distribution_failed\"));\n\t\t\t\t\tif (transactionError !== undefined) throw transactionError;\n\t\t\t\t\tif (transactionResponse === undefined)\n\t\t\t\t\t\tthrow new Error(\"plugin installation transaction did not complete\");\n\t\t\t\t\treturn transactionResponse;\n\t\t\t\t};\n\t\t\t\tif (acquisitionTarget !== undefined) {\n\t\t\t\t\t// Ref installs consult the acquisition boundary instead of the\n\t\t\t\t\t// registry; the shared guard above already verified installer,\n\t\t\t\t\t// host, state store, and scope support.\n\t\t\t\t\tif (options.acquisition === undefined)\n\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t\tphase = \"distribution\";\n\t\t\t\t\tlet acquired: PluginAcquisitionPackageV1;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tacquired = await options.acquisition.resolvePackage({ ref: acquisitionTarget, signal });\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tif (isCancelled(signal) || (error instanceof PluginAcquisitionErrorV1 && error.code === \"cancelled\"))\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\t\t\tif (error instanceof PluginAcquisitionErrorV1)\n\t\t\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", {\n\t\t\t\t\t\t\t\tcode: \"acquisition_failed\",\n\t\t\t\t\t\t\t\tmessage: error.message,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\t\t\t\t\tcheckSignal(signal);\n\t\t\t\t\treturn await runInstallFlow({\n\t\t\t\t\t\tmanifest: acquired.manifest,\n\t\t\t\t\t\tsource: acquired.source,\n\t\t\t\t\t\tacquired,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\trequireDependencies(options, requestedScope, scopeRef);\n\t\t\t\t} catch {\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\t}\n\t\t\t\tconst identity = parsed.pluginId as string;\n\t\t\t\tconst packageValue = await options.registry.resolve({\n\t\t\t\t\tpluginId: identity,\n\t\t\t\t\tpluginVersion: parsed.pluginVersion,\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tcheckSignal(signal);\n\t\t\t\tif (!packageValue) return response(parsed.command, parsed.format, \"failed\", safeError(\"not_found\"));\n\t\t\t\tif (\n\t\t\t\t\tpackageValue.manifest.id !== identity ||\n\t\t\t\t\t(parsed.pluginVersion !== undefined && packageValue.manifest.pluginVersion !== parsed.pluginVersion)\n\t\t\t\t)\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"failed\", safeError(\"not_found\"));\n\t\t\t\treturn await runInstallFlow({\n\t\t\t\t\tmanifest: packageValue.manifest,\n\t\t\t\t\tsource: packageValue.source,\n\t\t\t\t\t...(packageValue.expectedDigest === undefined ? {} : { expectedDigest: packageValue.expectedDigest }),\n\t\t\t\t\t...(packageValue.distribution === undefined ? {} : { distribution: packageValue.distribution }),\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tif (isCancelled(signal) || (error instanceof Error && error.message === \"cancelled\"))\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"cancelled\", safeError(\"cancelled\"));\n\t\t\t\tif (error instanceof Error && error.message === \"unsupported dependencies\")\n\t\t\t\t\treturn response(parsed.command, parsed.format, \"unsupported\", safeError(\"unsupported_dependencies\"));\n\t\t\t\treturn response(\n\t\t\t\t\tparsed.command,\n\t\t\t\t\tparsed.format,\n\t\t\t\t\t\"failed\",\n\t\t\t\t\tsafeError(\n\t\t\t\t\t\tphase === \"registry\"\n\t\t\t\t\t\t\t? \"registry_failed\"\n\t\t\t\t\t\t\t: phase === \"distribution\"\n\t\t\t\t\t\t\t\t? \"distribution_failed\"\n\t\t\t\t\t\t\t\t: phase === \"state\"\n\t\t\t\t\t\t\t\t\t? \"state_failed\"\n\t\t\t\t\t\t\t\t\t: phase === \"selection\"\n\t\t\t\t\t\t\t\t\t\t? \"selection_failed\"\n\t\t\t\t\t\t\t\t\t\t: \"installer_failed\",\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t} finally {\n\t\t\treleaseInstallTransaction?.();\n\t\t}\n\t}\n\treturn { execute };\n}\n\nexport async function runPluginEcosystemCliV1(\n\toptions: PluginEcosystemCliOptionsV1,\n\tinput: PluginEcosystemCliRequestV1,\n): Promise<PluginEcosystemCliResponseV1> {\n\treturn await createPluginEcosystemCliV1(options).execute(input);\n}\n"]}