@ai-agent-forge/agent-forge 0.85.0

package/dist/plugins/ecosystem/resolver.js

@@ -0,0 +1,325 @@
+import { stableJsonDigest } from "../../profile/identity.js";
+import { comparePluginVersionsV1 } from "./catalog.js";
+function assertNonEmpty(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        throw new Error(`${label} must be a non-empty string`);
+}
+function matchesList(value, allowed) {
+    return (allowed === undefined || (allowed.length > 0 && (allowed.includes(value) || allowed.includes("any"))));
+}
+function hasAllFeatures(hostFeatures, required) {
+    if (required === undefined)
+        return undefined;
+    const available = new Set(hostFeatures);
+    return required.find((feature) => !available.has(feature));
+}
+function runtimeVersion(host, name) {
+    return host.runtime.find((runtime) => runtime.name === name)?.version;
+}
+function diagnostic(code, message, details) {
+    return details === undefined ? { code, message } : { code, message, details };
+}
+function adapterMatches(adapter, host) {
+    return (matchesList(host.os, adapter.os) &&
+        matchesList(host.arch, adapter.arch) &&
+        hasAllFeatures(host.hostFeatures, adapter.hostFeatures) === undefined);
+}
+function hostAdapterMatches(adapter, hostAdapter, host) {
+    return (hostAdapter.id === adapter.id &&
+        hostAdapter.version === adapter.version &&
+        adapterMatches(adapter, host) &&
+        (hostAdapter.os === undefined || hostAdapter.os === host.os || hostAdapter.os === "any") &&
+        (hostAdapter.arch === undefined || hostAdapter.arch === host.arch || hostAdapter.arch === "any") &&
+        hasAllFeatures(hostAdapter.hostFeatures ?? [], adapter.hostFeatures) === undefined);
+}
+function selectAdapter(manifest, host) {
+    const adapters = manifest.platform?.adapters;
+    if (adapters === undefined || adapters.length === 0)
+        return undefined;
+    const installed = host.adapters ?? [];
+    const candidates = adapters
+        .filter((adapter) => adapterMatches(adapter, host))
+        .filter((adapter) => installed.some((hostAdapter) => hostAdapterMatches(adapter, hostAdapter, host)))
+        .sort((left, right) => {
+        const idOrder = left.id.localeCompare(right.id);
+        return idOrder === 0 ? comparePluginVersionsV1(right.version, left.version) : idOrder;
+    });
+    const selected = candidates[0];
+    return selected === undefined
+        ? {
+            diagnostic: diagnostic("adapter-unavailable", `No installed adapter satisfies plugin ${manifest.id} on ${host.os}/${host.arch}`),
+        }
+        : { selected: { id: selected.id, version: selected.version } };
+}
+function normalizeRefs(refs) {
+    const normalized = [...(refs ?? [])].map((ref) => {
+        assertNonEmpty(ref.id, "capability id");
+        if (!Number.isSafeInteger(ref.version) || ref.version < 1) {
+            throw new Error(`capability ${ref.id} version must be a positive safe integer`);
+        }
+        return { id: ref.id, version: ref.version };
+    });
+    normalized.sort((left, right) => left.id === right.id ? left.version - right.version : left.id.localeCompare(right.id));
+    return normalized;
+}
+function hasCapability(ref, available) {
+    return available.some((candidate) => candidate.id === ref.id && candidate.version === ref.version);
+}
+function resolvePlatform(manifest, host) {
+    const platform = manifest.platform;
+    if (platform === undefined)
+        return { diagnostics: [] };
+    if (!matchesList(host.os, platform.os)) {
+        return {
+            status: "installed-unavailable",
+            diagnostics: [diagnostic("unsupported-platform", `Plugin ${manifest.id} does not support host OS ${host.os}`)],
+        };
+    }
+    if (!matchesList(host.arch, platform.arch)) {
+        return {
+            status: "installed-unavailable",
+            diagnostics: [
+                diagnostic("unsupported-architecture", `Plugin ${manifest.id} does not support host architecture ${host.arch}`),
+            ],
+        };
+    }
+    const missingFeature = hasAllFeatures(host.hostFeatures, platform.hostFeatures);
+    if (missingFeature !== undefined) {
+        return {
+            status: "installed-unavailable",
+            diagnostics: [
+                diagnostic("missing-host-feature", `Host feature is missing: ${missingFeature}`, {
+                    feature: missingFeature,
+                }),
+            ],
+        };
+    }
+    for (const constraint of platform.runtime ?? []) {
+        const actual = runtimeVersion(host, constraint.name);
+        if (actual === undefined) {
+            return {
+                status: "version-incompatible",
+                diagnostics: [
+                    diagnostic("missing-runtime", `Required runtime is missing: ${constraint.name}`, {
+                        runtime: constraint.name,
+                    }),
+                ],
+            };
+        }
+        if ((constraint.minVersion !== undefined && comparePluginVersionsV1(actual, constraint.minVersion) < 0) ||
+            (constraint.maxVersion !== undefined && comparePluginVersionsV1(actual, constraint.maxVersion) > 0)) {
+            return {
+                status: "version-incompatible",
+                diagnostics: [
+                    diagnostic("runtime-version-incompatible", `Runtime ${constraint.name}@${actual} is outside the supported range`, {
+                        runtime: constraint.name,
+                        actual,
+                    }),
+                ],
+            };
+        }
+    }
+    const selected = selectAdapter(manifest, host);
+    if (selected?.diagnostic !== undefined)
+        return { status: "dependency-unavailable", diagnostics: [selected.diagnostic] };
+    return { diagnostics: [], selectedAdapter: selected?.selected };
+}
+/** Resolve one installed plugin against concrete host facts. */
+export function resolvePluginCompatibilityV1(input) {
+    const { manifest, host } = input;
+    assertNonEmpty(manifest.id, "plugin id");
+    assertNonEmpty(manifest.pluginVersion, "pluginVersion");
+    assertNonEmpty(manifest.apiVersion, "apiVersion");
+    const required = input.required ?? true;
+    if (input.disabled === true) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "disabled",
+            diagnostics: [diagnostic("plugin-disabled", `Plugin ${manifest.id} is disabled`)],
+        };
+    }
+    if (manifest.testOnly === true) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "installed-unavailable",
+            diagnostics: [
+                diagnostic("test-only-plugin", `Plugin ${manifest.id} is test-only and cannot be selected for production`),
+            ],
+        };
+    }
+    if (!["windows", "macos", "linux"].includes(host.os)) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "installed-unavailable",
+            diagnostics: [diagnostic("unsupported-platform", `Host OS is unknown: ${host.os}`)],
+        };
+    }
+    if (!["x64", "arm64"].includes(host.arch)) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "installed-unavailable",
+            diagnostics: [diagnostic("unsupported-architecture", `Host architecture is unknown: ${host.arch}`)],
+        };
+    }
+    if (manifest.minHostVersion !== undefined || manifest.maxHostVersion !== undefined) {
+        if (manifest.minHostVersion !== undefined)
+            assertNonEmpty(manifest.minHostVersion, "minHostVersion");
+        if (manifest.maxHostVersion !== undefined)
+            assertNonEmpty(manifest.maxHostVersion, "maxHostVersion");
+        if (input.hostVersion !== undefined) {
+            const belowFloor = manifest.minHostVersion !== undefined &&
+                comparePluginVersionsV1(input.hostVersion, manifest.minHostVersion) < 0;
+            const aboveCeiling = manifest.maxHostVersion !== undefined &&
+                comparePluginVersionsV1(input.hostVersion, manifest.maxHostVersion) > 0;
+            if (belowFloor || aboveCeiling) {
+                // The declared compatibility range, rendered human-readably
+                // (e.g. ">= 1.0.0 and <= 2.0.0"); a single bound keeps the
+                // floor-only shape the diagnostics contract pins.
+                const requiredRange = [
+                    manifest.minHostVersion !== undefined ? `>= ${manifest.minHostVersion}` : undefined,
+                    manifest.maxHostVersion !== undefined ? `<= ${manifest.maxHostVersion}` : undefined,
+                ]
+                    .filter((bound) => bound !== undefined)
+                    .join(" and ");
+                const guidance = belowFloor
+                    ? `Upgrade the host to at least ${manifest.minHostVersion} to load this plugin.`
+                    : `Install a plugin version whose declared host range includes ${input.hostVersion}.`;
+                return {
+                    pluginId: manifest.id,
+                    pluginVersion: manifest.pluginVersion,
+                    required,
+                    status: "version-incompatible",
+                    diagnostics: [
+                        diagnostic("host-version-incompatible", `Plugin ${manifest.id} requires host version ${requiredRange}, but the host is ${input.hostVersion}. ${guidance}`, { required: requiredRange, actual: input.hostVersion }),
+                    ],
+                };
+            }
+        }
+    }
+    if (manifest.apiVersion !== host.apiVersion) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "version-incompatible",
+            diagnostics: [
+                diagnostic("api-version-incompatible", `Plugin requires API ${manifest.apiVersion}, host provides ${host.apiVersion}`),
+            ],
+        };
+    }
+    const platform = resolvePlatform(manifest, host);
+    if (platform.status !== undefined) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: platform.status,
+            diagnostics: platform.diagnostics,
+        };
+    }
+    const available = input.availableCapabilities ?? [];
+    const dependencyDiagnostics = [];
+    for (const requirement of manifest.requires ?? []) {
+        if (hasCapability(requirement, available))
+            continue;
+        dependencyDiagnostics.push(diagnostic(requirement.optional === true ? "optional-capability-unavailable" : "missing-capability", `Capability ${requirement.id}@${requirement.version} is unavailable`, { capability: requirement.id, version: String(requirement.version) }));
+    }
+    const hasRequiredMissing = dependencyDiagnostics.some((item) => item.code === "missing-capability");
+    if (hasRequiredMissing) {
+        return {
+            pluginId: manifest.id,
+            pluginVersion: manifest.pluginVersion,
+            required,
+            status: "dependency-unavailable",
+            diagnostics: dependencyDiagnostics,
+        };
+    }
+    const capabilityRefs = normalizeRefs(manifest.capabilityRefs);
+    const resolved = {
+        pluginId: manifest.id,
+        pluginVersion: manifest.pluginVersion,
+        capabilityRefs,
+        ...(platform.selectedAdapter === undefined ? {} : { selectedAdapter: platform.selectedAdapter }),
+    };
+    return {
+        pluginId: manifest.id,
+        pluginVersion: manifest.pluginVersion,
+        required,
+        status: "installed-ready",
+        diagnostics: dependencyDiagnostics,
+        resolved,
+        ...(platform.selectedAdapter === undefined ? {} : { selectedAdapter: platform.selectedAdapter }),
+    };
+}
+function compareResolvedPlugins(left, right) {
+    return left.pluginId === right.pluginId
+        ? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)
+        : left.pluginId.localeCompare(right.pluginId);
+}
+function compareRefs(left, right) {
+    return left.id === right.id ? left.version - right.version : left.id.localeCompare(right.id);
+}
+/** Build an order-independent identity including adapter and capability refs. */
+export function buildResolvedManifestV1(input) {
+    assertNonEmpty(input.profileId, "profileId");
+    assertNonEmpty(input.profileVersion, "profileVersion");
+    const plugins = [...input.plugins]
+        .map((plugin) => ({
+        pluginId: plugin.pluginId,
+        pluginVersion: plugin.pluginVersion,
+        capabilityRefs: normalizeRefs(plugin.capabilityRefs),
+        ...(plugin.selectedAdapter === undefined ? {} : { selectedAdapter: { ...plugin.selectedAdapter } }),
+    }))
+        .sort(compareResolvedPlugins);
+    const capabilityRefs = plugins
+        .flatMap((plugin) => plugin.capabilityRefs)
+        .sort(compareRefs)
+        .filter((ref, index, all) => index === 0 || all[index - 1].id !== ref.id || all[index - 1].version !== ref.version);
+    const digestInput = { profileId: input.profileId, profileVersion: input.profileVersion, plugins, capabilityRefs };
+    return Object.freeze({
+        profileId: input.profileId,
+        profileVersion: input.profileVersion,
+        plugins: Object.freeze(plugins.map((plugin) => Object.freeze({ ...plugin, capabilityRefs: Object.freeze(plugin.capabilityRefs) }))),
+        capabilityRefs: Object.freeze(capabilityRefs),
+        manifestDigest: stableJsonDigest(digestInput),
+    });
+}
+/** Resolve all plugins in a Profile; optional unavailable plugins do not block startup. */
+export function resolvePluginProfileV1(input) {
+    const plugins = input.plugins
+        .map((candidate) => resolvePluginCompatibilityV1({
+        manifest: candidate.manifest,
+        host: input.host,
+        required: candidate.required,
+        disabled: candidate.disabled,
+        availableCapabilities: input.availableCapabilities,
+        hostVersion: input.hostVersion,
+    }))
+        .sort((left, right) => left.pluginId === right.pluginId
+        ? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)
+        : left.pluginId.localeCompare(right.pluginId));
+    const diagnostics = plugins.flatMap((plugin) => plugin.diagnostics);
+    const blocked = plugins.some((plugin) => plugin.required && plugin.status !== "installed-ready");
+    const resolvedPlugins = plugins.flatMap((plugin) => (plugin.resolved === undefined ? [] : [plugin.resolved]));
+    return Object.freeze({
+        profileId: input.profileId,
+        profileVersion: input.profileVersion,
+        status: blocked ? "blocked" : "ready",
+        plugins: Object.freeze(plugins),
+        diagnostics: Object.freeze(diagnostics),
+        resolvedManifest: buildResolvedManifestV1({
+            profileId: input.profileId,
+            profileVersion: input.profileVersion,
+            plugins: resolvedPlugins,
+        }),
+    });
+}
+//# sourceMappingURL=resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { stableJsonDigest } from \"../../profile/identity.ts\";\nimport { comparePluginVersionsV1 } from \"./catalog.ts\";\nimport type {\n\tCapabilityRefV1,\n\tHostAdapterFactV1,\n\tHostFactsV1,\n\tPluginAdapterManifestV1,\n\tPluginDiagnosticV1,\n\tPluginManifestV1,\n\tPluginResolutionStatusV1,\n\tPluginResolutionV1,\n\tProfileResolutionV1,\n\tResolvedManifestV1,\n\tResolvedPluginV1,\n\tSelectedAdapterV1,\n} from \"./types.ts\";\n\nfunction assertNonEmpty(value: string, label: string): void {\n\tif (typeof value !== \"string\" || value.trim().length === 0) throw new Error(`${label} must be a non-empty string`);\n}\n\nfunction matchesList<T extends string>(value: string, allowed: readonly T[] | undefined): boolean {\n\treturn (\n\t\tallowed === undefined || (allowed.length > 0 && (allowed.includes(value as T) || allowed.includes(\"any\" as T)))\n\t);\n}\n\nfunction hasAllFeatures(hostFeatures: readonly string[], required: readonly string[] | undefined): string | undefined {\n\tif (required === undefined) return undefined;\n\tconst available = new Set(hostFeatures);\n\treturn required.find((feature) => !available.has(feature));\n}\n\nfunction runtimeVersion(host: HostFactsV1, name: string): string | undefined {\n\treturn host.runtime.find((runtime) => runtime.name === name)?.version;\n}\n\nfunction diagnostic(\n\tcode: PluginDiagnosticV1[\"code\"],\n\tmessage: string,\n\tdetails?: Readonly<Record<string, string>>,\n): PluginDiagnosticV1 {\n\treturn details === undefined ? { code, message } : { code, message, details };\n}\n\nfunction adapterMatches(adapter: PluginAdapterManifestV1, host: HostFactsV1): boolean {\n\treturn (\n\t\tmatchesList(host.os, adapter.os) &&\n\t\tmatchesList(host.arch, adapter.arch) &&\n\t\thasAllFeatures(host.hostFeatures, adapter.hostFeatures) === undefined\n\t);\n}\n\nfunction hostAdapterMatches(\n\tadapter: PluginAdapterManifestV1,\n\thostAdapter: HostAdapterFactV1,\n\thost: HostFactsV1,\n): boolean {\n\treturn (\n\t\thostAdapter.id === adapter.id &&\n\t\thostAdapter.version === adapter.version &&\n\t\tadapterMatches(adapter, host) &&\n\t\t(hostAdapter.os === undefined || hostAdapter.os === host.os || hostAdapter.os === \"any\") &&\n\t\t(hostAdapter.arch === undefined || hostAdapter.arch === host.arch || hostAdapter.arch === \"any\") &&\n\t\thasAllFeatures(hostAdapter.hostFeatures ?? [], adapter.hostFeatures) === undefined\n\t);\n}\n\nfunction selectAdapter(\n\tmanifest: PluginManifestV1,\n\thost: HostFactsV1,\n): { readonly selected?: SelectedAdapterV1; readonly diagnostic?: PluginDiagnosticV1 } | undefined {\n\tconst adapters = manifest.platform?.adapters;\n\tif (adapters === undefined || adapters.length === 0) return undefined;\n\tconst installed = host.adapters ?? [];\n\tconst candidates = adapters\n\t\t.filter((adapter) => adapterMatches(adapter, host))\n\t\t.filter((adapter) => installed.some((hostAdapter) => hostAdapterMatches(adapter, hostAdapter, host)))\n\t\t.sort((left, right) => {\n\t\t\tconst idOrder = left.id.localeCompare(right.id);\n\t\t\treturn idOrder === 0 ? comparePluginVersionsV1(right.version, left.version) : idOrder;\n\t\t});\n\tconst selected = candidates[0];\n\treturn selected === undefined\n\t\t? {\n\t\t\t\tdiagnostic: diagnostic(\n\t\t\t\t\t\"adapter-unavailable\",\n\t\t\t\t\t`No installed adapter satisfies plugin ${manifest.id} on ${host.os}/${host.arch}`,\n\t\t\t\t),\n\t\t\t}\n\t\t: { selected: { id: selected.id, version: selected.version } };\n}\n\nfunction normalizeRefs(refs: readonly CapabilityRefV1[] | undefined): readonly CapabilityRefV1[] {\n\tconst normalized = [...(refs ?? [])].map((ref) => {\n\t\tassertNonEmpty(ref.id, \"capability id\");\n\t\tif (!Number.isSafeInteger(ref.version) || ref.version < 1) {\n\t\t\tthrow new Error(`capability ${ref.id} version must be a positive safe integer`);\n\t\t}\n\t\treturn { id: ref.id, version: ref.version };\n\t});\n\tnormalized.sort((left, right) =>\n\t\tleft.id === right.id ? left.version - right.version : left.id.localeCompare(right.id),\n\t);\n\treturn normalized;\n}\n\nfunction hasCapability(ref: CapabilityRefV1, available: readonly CapabilityRefV1[]): boolean {\n\treturn available.some((candidate) => candidate.id === ref.id && candidate.version === ref.version);\n}\n\nfunction resolvePlatform(\n\tmanifest: PluginManifestV1,\n\thost: HostFactsV1,\n): {\n\treadonly status?: PluginResolutionStatusV1;\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n\treadonly selectedAdapter?: SelectedAdapterV1;\n} {\n\tconst platform = manifest.platform;\n\tif (platform === undefined) return { diagnostics: [] };\n\tif (!matchesList(host.os, platform.os)) {\n\t\treturn {\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [diagnostic(\"unsupported-platform\", `Plugin ${manifest.id} does not support host OS ${host.os}`)],\n\t\t};\n\t}\n\tif (!matchesList(host.arch, platform.arch)) {\n\t\treturn {\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [\n\t\t\t\tdiagnostic(\n\t\t\t\t\t\"unsupported-architecture\",\n\t\t\t\t\t`Plugin ${manifest.id} does not support host architecture ${host.arch}`,\n\t\t\t\t),\n\t\t\t],\n\t\t};\n\t}\n\tconst missingFeature = hasAllFeatures(host.hostFeatures, platform.hostFeatures);\n\tif (missingFeature !== undefined) {\n\t\treturn {\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [\n\t\t\t\tdiagnostic(\"missing-host-feature\", `Host feature is missing: ${missingFeature}`, {\n\t\t\t\t\tfeature: missingFeature,\n\t\t\t\t}),\n\t\t\t],\n\t\t};\n\t}\n\tfor (const constraint of platform.runtime ?? []) {\n\t\tconst actual = runtimeVersion(host, constraint.name);\n\t\tif (actual === undefined) {\n\t\t\treturn {\n\t\t\t\tstatus: \"version-incompatible\",\n\t\t\t\tdiagnostics: [\n\t\t\t\t\tdiagnostic(\"missing-runtime\", `Required runtime is missing: ${constraint.name}`, {\n\t\t\t\t\t\truntime: constraint.name,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t};\n\t\t}\n\t\tif (\n\t\t\t(constraint.minVersion !== undefined && comparePluginVersionsV1(actual, constraint.minVersion) < 0) ||\n\t\t\t(constraint.maxVersion !== undefined && comparePluginVersionsV1(actual, constraint.maxVersion) > 0)\n\t\t) {\n\t\t\treturn {\n\t\t\t\tstatus: \"version-incompatible\",\n\t\t\t\tdiagnostics: [\n\t\t\t\t\tdiagnostic(\n\t\t\t\t\t\t\"runtime-version-incompatible\",\n\t\t\t\t\t\t`Runtime ${constraint.name}@${actual} is outside the supported range`,\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\truntime: constraint.name,\n\t\t\t\t\t\t\tactual,\n\t\t\t\t\t\t},\n\t\t\t\t\t),\n\t\t\t\t],\n\t\t\t};\n\t\t}\n\t}\n\tconst selected = selectAdapter(manifest, host);\n\tif (selected?.diagnostic !== undefined)\n\t\treturn { status: \"dependency-unavailable\", diagnostics: [selected.diagnostic] };\n\treturn { diagnostics: [], selectedAdapter: selected?.selected };\n}\n\n/** Resolve one installed plugin against concrete host facts. */\nexport function resolvePluginCompatibilityV1(input: {\n\treadonly manifest: PluginManifestV1;\n\treadonly host: HostFactsV1;\n\treadonly required?: boolean;\n\treadonly disabled?: boolean;\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\t/** Host's own version; when omitted, the manifest min/maxHostVersion range is not checked. */\n\treadonly hostVersion?: string;\n}): PluginResolutionV1 {\n\tconst { manifest, host } = input;\n\tassertNonEmpty(manifest.id, \"plugin id\");\n\tassertNonEmpty(manifest.pluginVersion, \"pluginVersion\");\n\tassertNonEmpty(manifest.apiVersion, \"apiVersion\");\n\tconst required = input.required ?? true;\n\tif (input.disabled === true) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"disabled\",\n\t\t\tdiagnostics: [diagnostic(\"plugin-disabled\", `Plugin ${manifest.id} is disabled`)],\n\t\t};\n\t}\n\tif (manifest.testOnly === true) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [\n\t\t\t\tdiagnostic(\"test-only-plugin\", `Plugin ${manifest.id} is test-only and cannot be selected for production`),\n\t\t\t],\n\t\t};\n\t}\n\tif (![\"windows\", \"macos\", \"linux\"].includes(host.os)) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [diagnostic(\"unsupported-platform\", `Host OS is unknown: ${host.os}`)],\n\t\t};\n\t}\n\tif (![\"x64\", \"arm64\"].includes(host.arch)) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"installed-unavailable\",\n\t\t\tdiagnostics: [diagnostic(\"unsupported-architecture\", `Host architecture is unknown: ${host.arch}`)],\n\t\t};\n\t}\n\tif (manifest.minHostVersion !== undefined || manifest.maxHostVersion !== undefined) {\n\t\tif (manifest.minHostVersion !== undefined) assertNonEmpty(manifest.minHostVersion, \"minHostVersion\");\n\t\tif (manifest.maxHostVersion !== undefined) assertNonEmpty(manifest.maxHostVersion, \"maxHostVersion\");\n\t\tif (input.hostVersion !== undefined) {\n\t\t\tconst belowFloor =\n\t\t\t\tmanifest.minHostVersion !== undefined &&\n\t\t\t\tcomparePluginVersionsV1(input.hostVersion, manifest.minHostVersion) < 0;\n\t\t\tconst aboveCeiling =\n\t\t\t\tmanifest.maxHostVersion !== undefined &&\n\t\t\t\tcomparePluginVersionsV1(input.hostVersion, manifest.maxHostVersion) > 0;\n\t\t\tif (belowFloor || aboveCeiling) {\n\t\t\t\t// The declared compatibility range, rendered human-readably\n\t\t\t\t// (e.g. \">= 1.0.0 and <= 2.0.0\"); a single bound keeps the\n\t\t\t\t// floor-only shape the diagnostics contract pins.\n\t\t\t\tconst requiredRange = [\n\t\t\t\t\tmanifest.minHostVersion !== undefined ? `>= ${manifest.minHostVersion}` : undefined,\n\t\t\t\t\tmanifest.maxHostVersion !== undefined ? `<= ${manifest.maxHostVersion}` : undefined,\n\t\t\t\t]\n\t\t\t\t\t.filter((bound) => bound !== undefined)\n\t\t\t\t\t.join(\" and \");\n\t\t\t\tconst guidance = belowFloor\n\t\t\t\t\t? `Upgrade the host to at least ${manifest.minHostVersion} to load this plugin.`\n\t\t\t\t\t: `Install a plugin version whose declared host range includes ${input.hostVersion}.`;\n\t\t\t\treturn {\n\t\t\t\t\tpluginId: manifest.id,\n\t\t\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\t\t\trequired,\n\t\t\t\t\tstatus: \"version-incompatible\",\n\t\t\t\t\tdiagnostics: [\n\t\t\t\t\t\tdiagnostic(\n\t\t\t\t\t\t\t\"host-version-incompatible\",\n\t\t\t\t\t\t\t`Plugin ${manifest.id} requires host version ${requiredRange}, but the host is ${input.hostVersion}. ${guidance}`,\n\t\t\t\t\t\t\t{ required: requiredRange, actual: input.hostVersion },\n\t\t\t\t\t\t),\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t}\n\tif (manifest.apiVersion !== host.apiVersion) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"version-incompatible\",\n\t\t\tdiagnostics: [\n\t\t\t\tdiagnostic(\n\t\t\t\t\t\"api-version-incompatible\",\n\t\t\t\t\t`Plugin requires API ${manifest.apiVersion}, host provides ${host.apiVersion}`,\n\t\t\t\t),\n\t\t\t],\n\t\t};\n\t}\n\tconst platform = resolvePlatform(manifest, host);\n\tif (platform.status !== undefined) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: platform.status,\n\t\t\tdiagnostics: platform.diagnostics,\n\t\t};\n\t}\n\tconst available = input.availableCapabilities ?? [];\n\tconst dependencyDiagnostics: PluginDiagnosticV1[] = [];\n\tfor (const requirement of manifest.requires ?? []) {\n\t\tif (hasCapability(requirement, available)) continue;\n\t\tdependencyDiagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\trequirement.optional === true ? \"optional-capability-unavailable\" : \"missing-capability\",\n\t\t\t\t`Capability ${requirement.id}@${requirement.version} is unavailable`,\n\t\t\t\t{ capability: requirement.id, version: String(requirement.version) },\n\t\t\t),\n\t\t);\n\t}\n\tconst hasRequiredMissing = dependencyDiagnostics.some((item) => item.code === \"missing-capability\");\n\tif (hasRequiredMissing) {\n\t\treturn {\n\t\t\tpluginId: manifest.id,\n\t\t\tpluginVersion: manifest.pluginVersion,\n\t\t\trequired,\n\t\t\tstatus: \"dependency-unavailable\",\n\t\t\tdiagnostics: dependencyDiagnostics,\n\t\t};\n\t}\n\tconst capabilityRefs = normalizeRefs(manifest.capabilityRefs);\n\tconst resolved: ResolvedPluginV1 = {\n\t\tpluginId: manifest.id,\n\t\tpluginVersion: manifest.pluginVersion,\n\t\tcapabilityRefs,\n\t\t...(platform.selectedAdapter === undefined ? {} : { selectedAdapter: platform.selectedAdapter }),\n\t};\n\treturn {\n\t\tpluginId: manifest.id,\n\t\tpluginVersion: manifest.pluginVersion,\n\t\trequired,\n\t\tstatus: \"installed-ready\",\n\t\tdiagnostics: dependencyDiagnostics,\n\t\tresolved,\n\t\t...(platform.selectedAdapter === undefined ? {} : { selectedAdapter: platform.selectedAdapter }),\n\t};\n}\n\nfunction compareResolvedPlugins(left: ResolvedPluginV1, right: ResolvedPluginV1): number {\n\treturn left.pluginId === right.pluginId\n\t\t? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)\n\t\t: left.pluginId.localeCompare(right.pluginId);\n}\n\nfunction compareRefs(left: CapabilityRefV1, right: CapabilityRefV1): number {\n\treturn left.id === right.id ? left.version - right.version : left.id.localeCompare(right.id);\n}\n\n/** Build an order-independent identity including adapter and capability refs. */\nexport function buildResolvedManifestV1(input: {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly plugins: readonly ResolvedPluginV1[];\n}): ResolvedManifestV1 {\n\tassertNonEmpty(input.profileId, \"profileId\");\n\tassertNonEmpty(input.profileVersion, \"profileVersion\");\n\tconst plugins = [...input.plugins]\n\t\t.map((plugin) => ({\n\t\t\tpluginId: plugin.pluginId,\n\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\tcapabilityRefs: normalizeRefs(plugin.capabilityRefs),\n\t\t\t...(plugin.selectedAdapter === undefined ? {} : { selectedAdapter: { ...plugin.selectedAdapter } }),\n\t\t}))\n\t\t.sort(compareResolvedPlugins);\n\tconst capabilityRefs = plugins\n\t\t.flatMap((plugin) => plugin.capabilityRefs)\n\t\t.sort(compareRefs)\n\t\t.filter(\n\t\t\t(ref, index, all) => index === 0 || all[index - 1]!.id !== ref.id || all[index - 1]!.version !== ref.version,\n\t\t);\n\tconst digestInput = { profileId: input.profileId, profileVersion: input.profileVersion, plugins, capabilityRefs };\n\treturn Object.freeze({\n\t\tprofileId: input.profileId,\n\t\tprofileVersion: input.profileVersion,\n\t\tplugins: Object.freeze(\n\t\t\tplugins.map((plugin) => Object.freeze({ ...plugin, capabilityRefs: Object.freeze(plugin.capabilityRefs) })),\n\t\t),\n\t\tcapabilityRefs: Object.freeze(capabilityRefs),\n\t\tmanifestDigest: stableJsonDigest(digestInput as unknown as Parameters<typeof stableJsonDigest>[0]),\n\t});\n}\n\n/** Resolve all plugins in a Profile; optional unavailable plugins do not block startup. */\nexport function resolvePluginProfileV1(input: {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly plugins: readonly {\n\t\treadonly manifest: PluginManifestV1;\n\t\treadonly required?: boolean;\n\t\treadonly disabled?: boolean;\n\t}[];\n\treadonly host: HostFactsV1;\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\t/** Host's own version, forwarded to each plugin's min/maxHostVersion range check. */\n\treadonly hostVersion?: string;\n}): ProfileResolutionV1 {\n\tconst plugins = input.plugins\n\t\t.map((candidate) =>\n\t\t\tresolvePluginCompatibilityV1({\n\t\t\t\tmanifest: candidate.manifest,\n\t\t\t\thost: input.host,\n\t\t\t\trequired: candidate.required,\n\t\t\t\tdisabled: candidate.disabled,\n\t\t\t\tavailableCapabilities: input.availableCapabilities,\n\t\t\t\thostVersion: input.hostVersion,\n\t\t\t}),\n\t\t)\n\t\t.sort((left, right) =>\n\t\t\tleft.pluginId === right.pluginId\n\t\t\t\t? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)\n\t\t\t\t: left.pluginId.localeCompare(right.pluginId),\n\t\t);\n\tconst diagnostics = plugins.flatMap((plugin) => plugin.diagnostics);\n\tconst blocked = plugins.some((plugin) => plugin.required && plugin.status !== \"installed-ready\");\n\tconst resolvedPlugins = plugins.flatMap((plugin) => (plugin.resolved === undefined ? [] : [plugin.resolved]));\n\treturn Object.freeze({\n\t\tprofileId: input.profileId,\n\t\tprofileVersion: input.profileVersion,\n\t\tstatus: blocked ? \"blocked\" : \"ready\",\n\t\tplugins: Object.freeze(plugins),\n\t\tdiagnostics: Object.freeze(diagnostics),\n\t\tresolvedManifest: buildResolvedManifestV1({\n\t\t\tprofileId: input.profileId,\n\t\t\tprofileVersion: input.profileVersion,\n\t\t\tplugins: resolvedPlugins,\n\t\t}),\n\t});\n}\n"]}

package/dist/plugins/ecosystem/selection-store.d.ts

@@ -0,0 +1,66 @@
+import { type PluginSelectionV1 } from "./selection.ts";
+/** Version of the host-independent user plugin selection snapshot. */
+export declare const PLUGIN_SELECTION_STORE_VERSION_V1: 1;
+export declare const MAX_PLUGIN_SELECTION_PROFILES_V1 = 256;
+export declare const MAX_PLUGIN_SELECTION_STORE_PATH_CHARS_V1 = 4096;
+export interface PluginSelectionStoreSnapshotV1 {
+    readonly version: typeof PLUGIN_SELECTION_STORE_VERSION_V1;
+    readonly selections: readonly PluginSelectionV1[];
+}
+export type PluginSelectionStoreDiagnosticCodeV1 = "invalid_json" | "invalid_schema" | "duplicate_profile" | "too_many_profiles" | "cancelled";
+export interface PluginSelectionStoreDiagnosticV1 {
+    readonly code: PluginSelectionStoreDiagnosticCodeV1;
+    readonly message: string;
+    readonly profileId?: string;
+}
+export type PluginSelectionStoreReadResultV1 = {
+    readonly status: "ok";
+    readonly snapshot: PluginSelectionStoreSnapshotV1;
+} | {
+    readonly status: "missing";
+    readonly snapshot: PluginSelectionStoreSnapshotV1;
+} | {
+    readonly status: "invalid";
+    readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[];
+} | {
+    readonly status: "cancelled";
+    readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[];
+};
+export type PluginSelectionStoreMutationResultV1 = {
+    readonly status: "ok";
+    readonly snapshot: PluginSelectionStoreSnapshotV1;
+    readonly changed: boolean;
+} | {
+    readonly status: "invalid";
+    readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[];
+} | {
+    readonly status: "cancelled";
+    readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[];
+};
+export interface PluginSelectionStoreFileSystemV1 {
+    readonly readFile: (path: string) => Promise<string>;
+    readonly mkdir: (path: string) => Promise<void>;
+    readonly writeFile: (path: string, data: string) => Promise<void>;
+    readonly rename: (oldPath: string, newPath: string) => Promise<void>;
+    readonly unlink: (path: string) => Promise<void>;
+}
+export interface PluginSelectionStoreOptionsV1 {
+    /** Absolute path to the host-owned `.plugin-selection.json` file. */
+    readonly filePath: string;
+    readonly fileSystem?: PluginSelectionStoreFileSystemV1;
+}
+export interface PluginSelectionStoreV1 {
+    readonly read: (options?: {
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginSelectionStoreReadResultV1>;
+    readonly set: (input: {
+        readonly selection: PluginSelectionV1;
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginSelectionStoreMutationResultV1>;
+    readonly clear: (input: {
+        readonly profileId: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginSelectionStoreMutationResultV1>;
+}
+export declare function createPluginSelectionStoreV1(options: PluginSelectionStoreOptionsV1): PluginSelectionStoreV1;
+//# sourceMappingURL=selection-store.d.ts.map

package/dist/plugins/ecosystem/selection-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-store.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/selection-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, unlink, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, isAbsolute, join, resolve } from \"node:path\";\n\nimport { createPluginSelectionV1, MAX_PLUGIN_SELECTION_IDS_V1, type PluginSelectionV1 } from \"./selection.ts\";\n\n/** Version of the host-independent user plugin selection snapshot. */\nexport const PLUGIN_SELECTION_STORE_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_SELECTION_PROFILES_V1 = 256;\nexport const MAX_PLUGIN_SELECTION_STORE_PATH_CHARS_V1 = 4096;\n\nexport interface PluginSelectionStoreSnapshotV1 {\n\treadonly version: typeof PLUGIN_SELECTION_STORE_VERSION_V1;\n\treadonly selections: readonly PluginSelectionV1[];\n}\n\nexport type PluginSelectionStoreDiagnosticCodeV1 =\n\t| \"invalid_json\"\n\t| \"invalid_schema\"\n\t| \"duplicate_profile\"\n\t| \"too_many_profiles\"\n\t| \"cancelled\";\n\nexport interface PluginSelectionStoreDiagnosticV1 {\n\treadonly code: PluginSelectionStoreDiagnosticCodeV1;\n\treadonly message: string;\n\treadonly profileId?: string;\n}\n\nexport type PluginSelectionStoreReadResultV1 =\n\t| { readonly status: \"ok\"; readonly snapshot: PluginSelectionStoreSnapshotV1 }\n\t| { readonly status: \"missing\"; readonly snapshot: PluginSelectionStoreSnapshotV1 }\n\t| { readonly status: \"invalid\"; readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[] }\n\t| { readonly status: \"cancelled\"; readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[] };\n\nexport type PluginSelectionStoreMutationResultV1 =\n\t| { readonly status: \"ok\"; readonly snapshot: PluginSelectionStoreSnapshotV1; readonly changed: boolean }\n\t| { readonly status: \"invalid\"; readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[] }\n\t| { readonly status: \"cancelled\"; readonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[] };\n\nexport interface PluginSelectionStoreFileSystemV1 {\n\treadonly readFile: (path: string) => Promise<string>;\n\treadonly mkdir: (path: string) => Promise<void>;\n\treadonly writeFile: (path: string, data: string) => Promise<void>;\n\treadonly rename: (oldPath: string, newPath: string) => Promise<void>;\n\treadonly unlink: (path: string) => Promise<void>;\n}\n\nexport interface PluginSelectionStoreOptionsV1 {\n\t/** Absolute path to the host-owned `.plugin-selection.json` file. */\n\treadonly filePath: string;\n\treadonly fileSystem?: PluginSelectionStoreFileSystemV1;\n}\n\nexport interface PluginSelectionStoreV1 {\n\treadonly read: (options?: { readonly signal?: AbortSignal }) => Promise<PluginSelectionStoreReadResultV1>;\n\treadonly set: (input: {\n\t\treadonly selection: PluginSelectionV1;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginSelectionStoreMutationResultV1>;\n\treadonly clear: (input: {\n\t\treadonly profileId: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginSelectionStoreMutationResultV1>;\n}\n\nconst EMPTY_SNAPSHOT: PluginSelectionStoreSnapshotV1 = Object.freeze({\n\tversion: PLUGIN_SELECTION_STORE_VERSION_V1,\n\tselections: Object.freeze([]),\n});\n\nfunction diagnostic(\n\tcode: PluginSelectionStoreDiagnosticCodeV1,\n\tmessage: string,\n\tprofileId?: string,\n): PluginSelectionStoreDiagnosticV1 {\n\treturn Object.freeze(profileId === undefined ? { code, message } : { code, message, profileId });\n}\n\nfunction isAbortError(error: unknown): boolean {\n\treturn error instanceof Error && (error.name === \"AbortError\" || error.name === \"AbortSignalError\");\n}\n\nfunction isMissingError(error: unknown): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error as { readonly code?: unknown }).code === \"ENOENT\"\n\t);\n}\n\nfunction validateFilePath(value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_SELECTION_STORE_PATH_CHARS_V1)\n\t\tthrow new Error(\"invalid plugin selection file path\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid plugin selection file path\");\n\tif (/^file:/iu.test(value) || (/^[a-z][a-z\\d+.-]*:/iu.test(value) && !/^[a-z]:[\\\\/]/iu.test(value)))\n\t\tthrow new Error(\"invalid plugin selection file path\");\n\tconst normalized = isAbsolute(value) ? value : resolve(value);\n\tif (basename(normalized).length === 0 || basename(normalized) === \".\" || basename(normalized) === \"..\")\n\t\tthrow new Error(\"invalid plugin selection file path\");\n\treturn normalized;\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction hasExactKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n\tconst expected = new Set(keys);\n\treturn Object.keys(value).length === expected.size && Object.keys(value).every((key) => expected.has(key));\n}\n\nfunction validateProfile(value: unknown): PluginSelectionV1 {\n\tif (!isObject(value) || !hasExactKeys(value, [\"profileId\", \"selectedPluginIds\", \"disabledPluginIds\"]))\n\t\tthrow new Error(\"selection schema is invalid\");\n\tif (!Array.isArray(value.selectedPluginIds) || !Array.isArray(value.disabledPluginIds))\n\t\tthrow new Error(\"selection IDs must be arrays\");\n\tif (\n\t\tvalue.selectedPluginIds.length > MAX_PLUGIN_SELECTION_IDS_V1 ||\n\t\tvalue.disabledPluginIds.length > MAX_PLUGIN_SELECTION_IDS_V1\n\t)\n\t\tthrow new Error(\"too many plugin IDs\");\n\treturn createPluginSelectionV1({\n\t\tprofileId: value.profileId as string,\n\t\tselectedPluginIds: value.selectedPluginIds,\n\t\tdisabledPluginIds: value.disabledPluginIds,\n\t});\n}\n\nfunction validateSnapshot(value: unknown): PluginSelectionStoreSnapshotV1 {\n\tif (!isObject(value) || !hasExactKeys(value, [\"version\", \"selections\"]))\n\t\tthrow new Error(\"snapshot schema is invalid\");\n\tif (value.version !== PLUGIN_SELECTION_STORE_VERSION_V1) throw new Error(\"snapshot version is unsupported\");\n\tif (!Array.isArray(value.selections)) throw new Error(\"selections must be an array\");\n\tif (value.selections.length > MAX_PLUGIN_SELECTION_PROFILES_V1) throw new Error(\"too many selection profiles\");\n\tconst selections = value.selections.map(validateProfile);\n\tconst profiles = new Set<string>();\n\tfor (const selection of selections) {\n\t\tif (profiles.has(selection.profileId)) throw new Error(`duplicate profile: ${selection.profileId}`);\n\t\tprofiles.add(selection.profileId);\n\t}\n\tselections.sort((left, right) => left.profileId.localeCompare(right.profileId));\n\treturn Object.freeze({ version: PLUGIN_SELECTION_STORE_VERSION_V1, selections: Object.freeze(selections) });\n}\n\nfunction invalidFromError(error: unknown): PluginSelectionStoreDiagnosticV1 {\n\tconst message = error instanceof Error ? error.message : \"plugin selection schema is invalid\";\n\tif (message === \"too many selection profiles\") return diagnostic(\"too_many_profiles\", message);\n\tconst duplicatePrefix = \"duplicate profile: \";\n\tif (message.startsWith(duplicatePrefix)) {\n\t\tconst profileId = message.slice(duplicatePrefix.length);\n\t\treturn diagnostic(\"duplicate_profile\", message, profileId);\n\t}\n\treturn diagnostic(\"invalid_schema\", message);\n}\n\nfunction defaultFileSystem(): PluginSelectionStoreFileSystemV1 {\n\treturn {\n\t\treadFile: async (path) => await readFile(path, \"utf8\"),\n\t\tmkdir: async (path) => {\n\t\t\tawait mkdir(path, { recursive: true });\n\t\t},\n\t\twriteFile: async (path, data) => {\n\t\t\tawait writeFile(path, data, \"utf8\");\n\t\t},\n\t\trename,\n\t\tunlink,\n\t};\n}\n\nfunction cancelledResult(): {\n\treadonly status: \"cancelled\";\n\treadonly diagnostics: readonly PluginSelectionStoreDiagnosticV1[];\n} {\n\treturn Object.freeze({\n\t\tstatus: \"cancelled\",\n\t\tdiagnostics: Object.freeze([diagnostic(\"cancelled\", \"Plugin selection operation was cancelled\")]),\n\t});\n}\n\nfunction sortSelections(selections: readonly PluginSelectionV1[]): readonly PluginSelectionV1[] {\n\treturn Object.freeze([...selections].sort((left, right) => left.profileId.localeCompare(right.profileId)));\n}\n\nfunction persistedSelection(selection: PluginSelectionV1): Readonly<Record<string, unknown>> {\n\treturn Object.freeze({\n\t\tprofileId: selection.profileId,\n\t\tselectedPluginIds: selection.selectedPluginIds,\n\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t});\n}\n\nexport function createPluginSelectionStoreV1(options: PluginSelectionStoreOptionsV1): PluginSelectionStoreV1 {\n\tconst filePath = validateFilePath(options.filePath);\n\tconst fileSystem = options.fileSystem ?? defaultFileSystem();\n\n\tasync function read(signal?: AbortSignal): Promise<PluginSelectionStoreReadResultV1> {\n\t\tif (signal?.aborted) return cancelledResult();\n\t\tlet content: string;\n\t\ttry {\n\t\t\tcontent = await fileSystem.readFile(filePath);\n\t\t} catch (error) {\n\t\t\tif (isMissingError(error)) return Object.freeze({ status: \"missing\", snapshot: EMPTY_SNAPSHOT });\n\t\t\tif (isAbortError(error) || signal?.aborted) return cancelledResult();\n\t\t\tthrow error;\n\t\t}\n\t\tif (signal?.aborted) return cancelledResult();\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(content) as unknown;\n\t\t} catch {\n\t\t\treturn Object.freeze({\n\t\t\t\tstatus: \"invalid\",\n\t\t\t\tdiagnostics: Object.freeze([diagnostic(\"invalid_json\", \"plugin selection JSON is invalid\")]),\n\t\t\t});\n\t\t}\n\t\ttry {\n\t\t\treturn Object.freeze({ status: \"ok\", snapshot: validateSnapshot(parsed) });\n\t\t} catch (error) {\n\t\t\treturn Object.freeze({ status: \"invalid\", diagnostics: Object.freeze([invalidFromError(error)]) });\n\t\t}\n\t}\n\n\tasync function write(\n\t\tsnapshot: PluginSelectionStoreSnapshotV1,\n\t\tsignal?: AbortSignal,\n\t): Promise<PluginSelectionStoreMutationResultV1> {\n\t\tif (signal?.aborted) return cancelledResult();\n\t\tconst temporaryPath = join(dirname(filePath), `.${basename(filePath)}.${randomUUID()}.tmp`);\n\t\ttry {\n\t\t\tawait fileSystem.mkdir(dirname(filePath));\n\t\t\tif (signal?.aborted) return cancelledResult();\n\t\t\tawait fileSystem.writeFile(\n\t\t\t\ttemporaryPath,\n\t\t\t\t`${JSON.stringify({\n\t\t\t\t\tversion: snapshot.version,\n\t\t\t\t\tselections: snapshot.selections.map(persistedSelection),\n\t\t\t\t})}\\n`,\n\t\t\t);\n\t\t\tif (signal?.aborted) return cancelledResult();\n\t\t\tawait fileSystem.rename(temporaryPath, filePath);\n\t\t\treturn Object.freeze({ status: \"ok\", snapshot, changed: true });\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tawait fileSystem.unlink(temporaryPath);\n\t\t\t} catch {\n\t\t\t\t// Cleanup must not replace the original write/rename error.\n\t\t\t}\n\t\t}\n\t}\n\n\tlet mutationTail: Promise<void> = Promise.resolve();\n\tfunction enqueueMutation<T>(operation: () => Promise<T>): Promise<T> {\n\t\tconst result = mutationTail.then(operation, operation);\n\t\tmutationTail = result.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t);\n\t\treturn result;\n\t}\n\n\treturn {\n\t\tread: async ({ signal } = {}) => await read(signal),\n\t\tset: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet selection: PluginSelectionV1;\n\t\t\t\ttry {\n\t\t\t\t\tselection = createPluginSelectionV1(input.selection);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn Object.freeze({ status: \"invalid\", diagnostics: Object.freeze([invalidFromError(error)]) });\n\t\t\t\t}\n\t\t\t\tconst current = await read(input.signal);\n\t\t\t\tif (current.status !== \"ok\" && current.status !== \"missing\") return current;\n\t\t\t\tif (input.signal?.aborted) return cancelledResult();\n\t\t\t\tconst existing = current.snapshot.selections.find((item) => item.profileId === selection.profileId);\n\t\t\t\tif (existing !== undefined && JSON.stringify(existing) === JSON.stringify(selection))\n\t\t\t\t\treturn Object.freeze({ status: \"ok\", snapshot: current.snapshot, changed: false });\n\t\t\t\tif (current.snapshot.selections.length >= MAX_PLUGIN_SELECTION_PROFILES_V1 && existing === undefined)\n\t\t\t\t\treturn Object.freeze({\n\t\t\t\t\t\tstatus: \"invalid\",\n\t\t\t\t\t\tdiagnostics: Object.freeze([diagnostic(\"too_many_profiles\", \"too many selection profiles\")]),\n\t\t\t\t\t});\n\t\t\t\tconst snapshot = Object.freeze({\n\t\t\t\t\tversion: PLUGIN_SELECTION_STORE_VERSION_V1,\n\t\t\t\t\tselections: sortSelections([\n\t\t\t\t\t\t...current.snapshot.selections.filter((item) => item.profileId !== selection.profileId),\n\t\t\t\t\t\tselection,\n\t\t\t\t\t]),\n\t\t\t\t});\n\t\t\t\treturn await write(snapshot, input.signal);\n\t\t\t}),\n\t\tclear: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet selection: PluginSelectionV1;\n\t\t\t\ttry {\n\t\t\t\t\tselection = createPluginSelectionV1({\n\t\t\t\t\t\tprofileId: input.profileId,\n\t\t\t\t\t\tselectedPluginIds: [],\n\t\t\t\t\t\tdisabledPluginIds: [],\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn Object.freeze({ status: \"invalid\", diagnostics: Object.freeze([invalidFromError(error)]) });\n\t\t\t\t}\n\t\t\t\tconst current = await read(input.signal);\n\t\t\t\tif (current.status !== \"ok\" && current.status !== \"missing\") return current;\n\t\t\t\tif (input.signal?.aborted) return cancelledResult();\n\t\t\t\tconst selections = current.snapshot.selections.filter((item) => item.profileId !== selection.profileId);\n\t\t\t\tif (selections.length === current.snapshot.selections.length)\n\t\t\t\t\treturn Object.freeze({ status: \"ok\", snapshot: current.snapshot, changed: false });\n\t\t\t\treturn await write(\n\t\t\t\t\tObject.freeze({ version: PLUGIN_SELECTION_STORE_VERSION_V1, selections: sortSelections(selections) }),\n\t\t\t\t\tinput.signal,\n\t\t\t\t);\n\t\t\t}),\n\t};\n}\n"]}