@ai-agent-forge/agent-forge 0.85.0

package/dist/plugins/ecosystem/selection-store.js

@@ -0,0 +1,241 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { createPluginSelectionV1, MAX_PLUGIN_SELECTION_IDS_V1 } from "./selection.js";
+/** Version of the host-independent user plugin selection snapshot. */
+export const PLUGIN_SELECTION_STORE_VERSION_V1 = 1;
+export const MAX_PLUGIN_SELECTION_PROFILES_V1 = 256;
+export const MAX_PLUGIN_SELECTION_STORE_PATH_CHARS_V1 = 4096;
+const EMPTY_SNAPSHOT = Object.freeze({
+    version: PLUGIN_SELECTION_STORE_VERSION_V1,
+    selections: Object.freeze([]),
+});
+function diagnostic(code, message, profileId) {
+    return Object.freeze(profileId === undefined ? { code, message } : { code, message, profileId });
+}
+function isAbortError(error) {
+    return error instanceof Error && (error.name === "AbortError" || error.name === "AbortSignalError");
+}
+function isMissingError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+function validateFilePath(value) {
+    if (typeof value !== "string" || value.trim() === "" || value.length > MAX_PLUGIN_SELECTION_STORE_PATH_CHARS_V1)
+        throw new Error("invalid plugin selection file path");
+    if (value.includes("\0") || /[\u0000-\u001f]/u.test(value))
+        throw new Error("invalid plugin selection file path");
+    if (/^file:/iu.test(value) || (/^[a-z][a-z\d+.-]*:/iu.test(value) && !/^[a-z]:[\\/]/iu.test(value)))
+        throw new Error("invalid plugin selection file path");
+    const normalized = isAbsolute(value) ? value : resolve(value);
+    if (basename(normalized).length === 0 || basename(normalized) === "." || basename(normalized) === "..")
+        throw new Error("invalid plugin selection file path");
+    return normalized;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExactKeys(value, keys) {
+    const expected = new Set(keys);
+    return Object.keys(value).length === expected.size && Object.keys(value).every((key) => expected.has(key));
+}
+function validateProfile(value) {
+    if (!isObject(value) || !hasExactKeys(value, ["profileId", "selectedPluginIds", "disabledPluginIds"]))
+        throw new Error("selection schema is invalid");
+    if (!Array.isArray(value.selectedPluginIds) || !Array.isArray(value.disabledPluginIds))
+        throw new Error("selection IDs must be arrays");
+    if (value.selectedPluginIds.length > MAX_PLUGIN_SELECTION_IDS_V1 ||
+        value.disabledPluginIds.length > MAX_PLUGIN_SELECTION_IDS_V1)
+        throw new Error("too many plugin IDs");
+    return createPluginSelectionV1({
+        profileId: value.profileId,
+        selectedPluginIds: value.selectedPluginIds,
+        disabledPluginIds: value.disabledPluginIds,
+    });
+}
+function validateSnapshot(value) {
+    if (!isObject(value) || !hasExactKeys(value, ["version", "selections"]))
+        throw new Error("snapshot schema is invalid");
+    if (value.version !== PLUGIN_SELECTION_STORE_VERSION_V1)
+        throw new Error("snapshot version is unsupported");
+    if (!Array.isArray(value.selections))
+        throw new Error("selections must be an array");
+    if (value.selections.length > MAX_PLUGIN_SELECTION_PROFILES_V1)
+        throw new Error("too many selection profiles");
+    const selections = value.selections.map(validateProfile);
+    const profiles = new Set();
+    for (const selection of selections) {
+        if (profiles.has(selection.profileId))
+            throw new Error(`duplicate profile: ${selection.profileId}`);
+        profiles.add(selection.profileId);
+    }
+    selections.sort((left, right) => left.profileId.localeCompare(right.profileId));
+    return Object.freeze({ version: PLUGIN_SELECTION_STORE_VERSION_V1, selections: Object.freeze(selections) });
+}
+function invalidFromError(error) {
+    const message = error instanceof Error ? error.message : "plugin selection schema is invalid";
+    if (message === "too many selection profiles")
+        return diagnostic("too_many_profiles", message);
+    const duplicatePrefix = "duplicate profile: ";
+    if (message.startsWith(duplicatePrefix)) {
+        const profileId = message.slice(duplicatePrefix.length);
+        return diagnostic("duplicate_profile", message, profileId);
+    }
+    return diagnostic("invalid_schema", message);
+}
+function defaultFileSystem() {
+    return {
+        readFile: async (path) => await readFile(path, "utf8"),
+        mkdir: async (path) => {
+            await mkdir(path, { recursive: true });
+        },
+        writeFile: async (path, data) => {
+            await writeFile(path, data, "utf8");
+        },
+        rename,
+        unlink,
+    };
+}
+function cancelledResult() {
+    return Object.freeze({
+        status: "cancelled",
+        diagnostics: Object.freeze([diagnostic("cancelled", "Plugin selection operation was cancelled")]),
+    });
+}
+function sortSelections(selections) {
+    return Object.freeze([...selections].sort((left, right) => left.profileId.localeCompare(right.profileId)));
+}
+function persistedSelection(selection) {
+    return Object.freeze({
+        profileId: selection.profileId,
+        selectedPluginIds: selection.selectedPluginIds,
+        disabledPluginIds: selection.disabledPluginIds,
+    });
+}
+export function createPluginSelectionStoreV1(options) {
+    const filePath = validateFilePath(options.filePath);
+    const fileSystem = options.fileSystem ?? defaultFileSystem();
+    async function read(signal) {
+        if (signal?.aborted)
+            return cancelledResult();
+        let content;
+        try {
+            content = await fileSystem.readFile(filePath);
+        }
+        catch (error) {
+            if (isMissingError(error))
+                return Object.freeze({ status: "missing", snapshot: EMPTY_SNAPSHOT });
+            if (isAbortError(error) || signal?.aborted)
+                return cancelledResult();
+            throw error;
+        }
+        if (signal?.aborted)
+            return cancelledResult();
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            return Object.freeze({
+                status: "invalid",
+                diagnostics: Object.freeze([diagnostic("invalid_json", "plugin selection JSON is invalid")]),
+            });
+        }
+        try {
+            return Object.freeze({ status: "ok", snapshot: validateSnapshot(parsed) });
+        }
+        catch (error) {
+            return Object.freeze({ status: "invalid", diagnostics: Object.freeze([invalidFromError(error)]) });
+        }
+    }
+    async function write(snapshot, signal) {
+        if (signal?.aborted)
+            return cancelledResult();
+        const temporaryPath = join(dirname(filePath), `.${basename(filePath)}.${randomUUID()}.tmp`);
+        try {
+            await fileSystem.mkdir(dirname(filePath));
+            if (signal?.aborted)
+                return cancelledResult();
+            await fileSystem.writeFile(temporaryPath, `${JSON.stringify({
+                version: snapshot.version,
+                selections: snapshot.selections.map(persistedSelection),
+            })}\n`);
+            if (signal?.aborted)
+                return cancelledResult();
+            await fileSystem.rename(temporaryPath, filePath);
+            return Object.freeze({ status: "ok", snapshot, changed: true });
+        }
+        finally {
+            try {
+                await fileSystem.unlink(temporaryPath);
+            }
+            catch {
+                // Cleanup must not replace the original write/rename error.
+            }
+        }
+    }
+    let mutationTail = Promise.resolve();
+    function enqueueMutation(operation) {
+        const result = mutationTail.then(operation, operation);
+        mutationTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    return {
+        read: async ({ signal } = {}) => await read(signal),
+        set: (input) => enqueueMutation(async () => {
+            let selection;
+            try {
+                selection = createPluginSelectionV1(input.selection);
+            }
+            catch (error) {
+                return Object.freeze({ status: "invalid", diagnostics: Object.freeze([invalidFromError(error)]) });
+            }
+            const current = await read(input.signal);
+            if (current.status !== "ok" && current.status !== "missing")
+                return current;
+            if (input.signal?.aborted)
+                return cancelledResult();
+            const existing = current.snapshot.selections.find((item) => item.profileId === selection.profileId);
+            if (existing !== undefined && JSON.stringify(existing) === JSON.stringify(selection))
+                return Object.freeze({ status: "ok", snapshot: current.snapshot, changed: false });
+            if (current.snapshot.selections.length >= MAX_PLUGIN_SELECTION_PROFILES_V1 && existing === undefined)
+                return Object.freeze({
+                    status: "invalid",
+                    diagnostics: Object.freeze([diagnostic("too_many_profiles", "too many selection profiles")]),
+                });
+            const snapshot = Object.freeze({
+                version: PLUGIN_SELECTION_STORE_VERSION_V1,
+                selections: sortSelections([
+                    ...current.snapshot.selections.filter((item) => item.profileId !== selection.profileId),
+                    selection,
+                ]),
+            });
+            return await write(snapshot, input.signal);
+        }),
+        clear: (input) => enqueueMutation(async () => {
+            let selection;
+            try {
+                selection = createPluginSelectionV1({
+                    profileId: input.profileId,
+                    selectedPluginIds: [],
+                    disabledPluginIds: [],
+                });
+            }
+            catch (error) {
+                return Object.freeze({ status: "invalid", diagnostics: Object.freeze([invalidFromError(error)]) });
+            }
+            const current = await read(input.signal);
+            if (current.status !== "ok" && current.status !== "missing")
+                return current;
+            if (input.signal?.aborted)
+                return cancelledResult();
+            const selections = current.snapshot.selections.filter((item) => item.profileId !== selection.profileId);
+            if (selections.length === current.snapshot.selections.length)
+                return Object.freeze({ status: "ok", snapshot: current.snapshot, changed: false });
+            return await write(Object.freeze({ version: PLUGIN_SELECTION_STORE_VERSION_V1, selections: sortSelections(selections) }), input.signal);
+        }),
+    };
+}
+//# sourceMappingURL=selection-store.js.map

package/dist/plugins/ecosystem/selection-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-store.js","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"]}

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

@@ -0,0 +1,54 @@
+import { type PluginCatalogEntryV1, type PluginCatalogSnapshotV1 } from "./catalog.ts";
+import type { CapabilityRefV1, HostFactsV1, PluginDiagnosticV1, PluginManifestV1 } from "./types.ts";
+/** Version of the user-owned, host-independent plugin selection snapshot. */
+export declare const PLUGIN_SELECTION_VERSION_V1: 1;
+export declare const MAX_PLUGIN_SELECTION_ID_CHARS_V1 = 128;
+export declare const MAX_PLUGIN_SELECTION_IDS_V1 = 128;
+export interface PluginSelectionV1 {
+    readonly version: typeof PLUGIN_SELECTION_VERSION_V1;
+    readonly profileId: string;
+    readonly selectedPluginIds: readonly string[];
+    readonly disabledPluginIds: readonly string[];
+}
+export type PluginSelectionErrorCodeV1 = "invalid_profile_id" | "profile_id_too_long" | "invalid_plugin_id" | "plugin_id_too_long" | "too_many_plugin_ids" | "duplicate_plugin_id" | "unknown_plugin_id" | "catalog_truncated";
+export declare class PluginSelectionErrorV1 extends Error {
+    readonly code: PluginSelectionErrorCodeV1;
+    readonly pluginId?: string;
+    constructor(code: PluginSelectionErrorCodeV1, message: string, pluginId?: string);
+}
+/**
+ * A pure catalog projection for a user selection. It never downloads,
+ * writes, installs, activates, or mutates a plugin. The host owns those
+ * operations through the separate installer contract.
+ */
+export interface PluginSelectionResolutionV1 {
+    readonly selection: PluginSelectionV1;
+    /** The bounded catalog of every discovered manifest. */
+    readonly catalog: PluginCatalogSnapshotV1;
+    /** Entries requested by the selection, in catalog order. */
+    readonly entries: readonly PluginCatalogEntryV1[];
+    readonly diagnostics: readonly PluginDiagnosticV1[];
+}
+export interface PluginSelectionInputV1 {
+    readonly profileId: string;
+    /** Omitted means all discovered plugin IDs; [] means no plugin. */
+    readonly selectedPluginIds?: readonly string[];
+    readonly disabledPluginIds?: readonly string[];
+}
+/** Validate and freeze a selection without resolving or touching a host. */
+export declare function createPluginSelectionV1(input: PluginSelectionInputV1): PluginSelectionV1;
+/**
+ * Resolve a selection to bounded catalog entries and diagnostics. This is a
+ * read-only planning operation; it does not imply that any plugin is enabled.
+ */
+export declare function resolvePluginSelectionV1(input: {
+    readonly selection: PluginSelectionInputV1;
+    readonly manifests: readonly PluginManifestV1[];
+    readonly host: HostFactsV1;
+    readonly required?: boolean;
+    readonly availableCapabilities?: readonly CapabilityRefV1[];
+    readonly maxEntries?: number;
+}): PluginSelectionResolutionV1;
+/** Serialize only the stable selection data; no manifest, host, or payload is included. */
+export declare function serializePluginSelectionV1(selection: PluginSelectionV1): string;
+//# sourceMappingURL=selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC7G,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErG,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,GAAa,CAAC;AACtD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,2BAA2B,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,MAAM,0BAA0B,GACnC,oBAAoB,GACpB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,CAAC;AAEvB,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAK/E;CACD;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAqDD,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAUxF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;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,qBAAqB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,2BAA2B,CAkD9B;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAG/E","sourcesContent":["import { buildPluginCatalogV1, type PluginCatalogEntryV1, type PluginCatalogSnapshotV1 } from \"./catalog.ts\";\nimport type { CapabilityRefV1, HostFactsV1, PluginDiagnosticV1, PluginManifestV1 } from \"./types.ts\";\n\n/** Version of the user-owned, host-independent plugin selection snapshot. */\nexport const PLUGIN_SELECTION_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_SELECTION_ID_CHARS_V1 = 128;\nexport const MAX_PLUGIN_SELECTION_IDS_V1 = 128;\n\nexport interface PluginSelectionV1 {\n\treadonly version: typeof PLUGIN_SELECTION_VERSION_V1;\n\treadonly profileId: string;\n\treadonly selectedPluginIds: readonly string[];\n\treadonly disabledPluginIds: readonly string[];\n}\n\nexport type PluginSelectionErrorCodeV1 =\n\t| \"invalid_profile_id\"\n\t| \"profile_id_too_long\"\n\t| \"invalid_plugin_id\"\n\t| \"plugin_id_too_long\"\n\t| \"too_many_plugin_ids\"\n\t| \"duplicate_plugin_id\"\n\t| \"unknown_plugin_id\"\n\t| \"catalog_truncated\";\n\nexport class PluginSelectionErrorV1 extends Error {\n\treadonly code: PluginSelectionErrorCodeV1;\n\treadonly pluginId?: string;\n\n\tconstructor(code: PluginSelectionErrorCodeV1, message: string, pluginId?: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginSelectionErrorV1\";\n\t\tthis.code = code;\n\t\tthis.pluginId = pluginId;\n\t}\n}\n\n/**\n * A pure catalog projection for a user selection. It never downloads,\n * writes, installs, activates, or mutates a plugin. The host owns those\n * operations through the separate installer contract.\n */\nexport interface PluginSelectionResolutionV1 {\n\treadonly selection: PluginSelectionV1;\n\t/** The bounded catalog of every discovered manifest. */\n\treadonly catalog: PluginCatalogSnapshotV1;\n\t/** Entries requested by the selection, in catalog order. */\n\treadonly entries: readonly PluginCatalogEntryV1[];\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n}\n\nexport interface PluginSelectionInputV1 {\n\treadonly profileId: string;\n\t/** Omitted means all discovered plugin IDs; [] means no plugin. */\n\treadonly selectedPluginIds?: readonly string[];\n\treadonly disabledPluginIds?: readonly string[];\n}\n\nfunction validateId(value: unknown, label: \"profileId\" | \"pluginId\"): string {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\tlabel === \"profileId\" ? \"invalid_profile_id\" : \"invalid_plugin_id\",\n\t\t\t`${label} must be a non-empty string`,\n\t\t\ttypeof value === \"string\" ? value : undefined,\n\t\t);\n\t}\n\tif (value.length > MAX_PLUGIN_SELECTION_ID_CHARS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\tlabel === \"profileId\" ? \"profile_id_too_long\" : \"plugin_id_too_long\",\n\t\t\t`${label} must be at most ${MAX_PLUGIN_SELECTION_ID_CHARS_V1} characters`,\n\t\t\tvalue,\n\t\t);\n\t}\n\treturn value;\n}\n\nfunction normalizeIds(\n\tids: readonly string[] | undefined,\n\tlabel: \"selectedPluginIds\" | \"disabledPluginIds\",\n): readonly string[] {\n\tif (ids === undefined) return [];\n\tif (!Array.isArray(ids) || ids.length > MAX_PLUGIN_SELECTION_IDS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\"too_many_plugin_ids\",\n\t\t\t`${label} must contain at most ${MAX_PLUGIN_SELECTION_IDS_V1} plugin IDs`,\n\t\t);\n\t}\n\tconst seen = new Set<string>();\n\tconst normalized: string[] = [];\n\tfor (const candidate of ids) {\n\t\tconst id = validateId(candidate, \"pluginId\");\n\t\tif (seen.has(id)) {\n\t\t\tthrow new PluginSelectionErrorV1(\"duplicate_plugin_id\", `${label} contains duplicate plugin ID: ${id}`, id);\n\t\t}\n\t\tseen.add(id);\n\t\tnormalized.push(id);\n\t}\n\tnormalized.sort((left, right) => left.localeCompare(right));\n\treturn Object.freeze(normalized);\n}\n\nfunction assertKnownIds(ids: readonly string[], knownIds: ReadonlySet<string>): void {\n\tfor (const id of ids) {\n\t\tif (!knownIds.has(id)) {\n\t\t\tthrow new PluginSelectionErrorV1(\"unknown_plugin_id\", `Selection references unknown plugin ID: ${id}`, id);\n\t\t}\n\t}\n}\n\n/** Validate and freeze a selection without resolving or touching a host. */\nexport function createPluginSelectionV1(input: PluginSelectionInputV1): PluginSelectionV1 {\n\tconst profileId = validateId(input.profileId, \"profileId\");\n\tconst selectedPluginIds = normalizeIds(input.selectedPluginIds, \"selectedPluginIds\");\n\tconst disabledPluginIds = normalizeIds(input.disabledPluginIds, \"disabledPluginIds\");\n\treturn Object.freeze({\n\t\tversion: PLUGIN_SELECTION_VERSION_V1,\n\t\tprofileId,\n\t\tselectedPluginIds,\n\t\tdisabledPluginIds,\n\t});\n}\n\n/**\n * Resolve a selection to bounded catalog entries and diagnostics. This is a\n * read-only planning operation; it does not imply that any plugin is enabled.\n */\nexport function resolvePluginSelectionV1(input: {\n\treadonly selection: PluginSelectionInputV1;\n\treadonly manifests: readonly PluginManifestV1[];\n\treadonly host: HostFactsV1;\n\treadonly required?: boolean;\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\treadonly maxEntries?: number;\n}): PluginSelectionResolutionV1 {\n\tfor (const manifest of input.manifests) validateId(manifest.id, \"pluginId\");\n\tconst knownIds = new Set(input.manifests.map((manifest) => manifest.id));\n\tconst provisional = createPluginSelectionV1(input.selection);\n\tif (input.selection.selectedPluginIds === undefined && knownIds.size > MAX_PLUGIN_SELECTION_IDS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\"too_many_plugin_ids\",\n\t\t\t`discovered plugin IDs exceed the selection limit of ${MAX_PLUGIN_SELECTION_IDS_V1}`,\n\t\t);\n\t}\n\tconst selectedPluginIds =\n\t\tinput.selection.selectedPluginIds === undefined\n\t\t\t? Object.freeze([...knownIds].sort((a, b) => a.localeCompare(b)))\n\t\t\t: provisional.selectedPluginIds;\n\tconst selection = Object.freeze({ ...provisional, selectedPluginIds });\n\tassertKnownIds(selection.selectedPluginIds, knownIds);\n\tassertKnownIds(selection.disabledPluginIds, knownIds);\n\tconst catalog = buildPluginCatalogV1({\n\t\tmanifests: input.manifests,\n\t\thost: input.host,\n\t\trequired: input.required,\n\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t\tavailableCapabilities: input.availableCapabilities,\n\t\tmaxEntries: input.maxEntries,\n\t});\n\tconst selected = new Set(selection.selectedPluginIds);\n\t// Resolve selected manifests separately so a bounded/truncated all-manifest\n\t// catalog cannot silently hide an explicitly selected plugin.\n\tconst selectedCatalog = buildPluginCatalogV1({\n\t\tmanifests: input.manifests.filter((manifest) => selected.has(manifest.id)),\n\t\thost: input.host,\n\t\trequired: input.required,\n\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t\tavailableCapabilities: input.availableCapabilities,\n\t\tmaxEntries: Math.max(input.maxEntries ?? MAX_PLUGIN_SELECTION_IDS_V1, selection.selectedPluginIds.length),\n\t});\n\tif (selectedCatalog.truncated) {\n\t\tconst selectedEntryIds = new Set(selectedCatalog.entries.map((entry) => entry.pluginId));\n\t\tconst omitted = selection.selectedPluginIds.find((id) => !selectedEntryIds.has(id));\n\t\tif (omitted !== undefined) {\n\t\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\t\"catalog_truncated\",\n\t\t\t\t`Catalog truncation omitted selected plugin ID: ${omitted}`,\n\t\t\t\tomitted,\n\t\t\t);\n\t\t}\n\t}\n\tconst entries = Object.freeze(selectedCatalog.entries);\n\tconst diagnostics = Object.freeze(entries.flatMap((entry) => entry.resolution.diagnostics));\n\treturn Object.freeze({ selection, catalog, entries, diagnostics });\n}\n\n/** Serialize only the stable selection data; no manifest, host, or payload is included. */\nexport function serializePluginSelectionV1(selection: PluginSelectionV1): string {\n\tconst normalized = createPluginSelectionV1(selection);\n\treturn JSON.stringify(normalized);\n}\n"]}

package/dist/plugins/ecosystem/selection.js

@@ -0,0 +1,116 @@
+import { buildPluginCatalogV1 } from "./catalog.js";
+/** Version of the user-owned, host-independent plugin selection snapshot. */
+export const PLUGIN_SELECTION_VERSION_V1 = 1;
+export const MAX_PLUGIN_SELECTION_ID_CHARS_V1 = 128;
+export const MAX_PLUGIN_SELECTION_IDS_V1 = 128;
+export class PluginSelectionErrorV1 extends Error {
+    code;
+    pluginId;
+    constructor(code, message, pluginId) {
+        super(message);
+        this.name = "PluginSelectionErrorV1";
+        this.code = code;
+        this.pluginId = pluginId;
+    }
+}
+function validateId(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new PluginSelectionErrorV1(label === "profileId" ? "invalid_profile_id" : "invalid_plugin_id", `${label} must be a non-empty string`, typeof value === "string" ? value : undefined);
+    }
+    if (value.length > MAX_PLUGIN_SELECTION_ID_CHARS_V1) {
+        throw new PluginSelectionErrorV1(label === "profileId" ? "profile_id_too_long" : "plugin_id_too_long", `${label} must be at most ${MAX_PLUGIN_SELECTION_ID_CHARS_V1} characters`, value);
+    }
+    return value;
+}
+function normalizeIds(ids, label) {
+    if (ids === undefined)
+        return [];
+    if (!Array.isArray(ids) || ids.length > MAX_PLUGIN_SELECTION_IDS_V1) {
+        throw new PluginSelectionErrorV1("too_many_plugin_ids", `${label} must contain at most ${MAX_PLUGIN_SELECTION_IDS_V1} plugin IDs`);
+    }
+    const seen = new Set();
+    const normalized = [];
+    for (const candidate of ids) {
+        const id = validateId(candidate, "pluginId");
+        if (seen.has(id)) {
+            throw new PluginSelectionErrorV1("duplicate_plugin_id", `${label} contains duplicate plugin ID: ${id}`, id);
+        }
+        seen.add(id);
+        normalized.push(id);
+    }
+    normalized.sort((left, right) => left.localeCompare(right));
+    return Object.freeze(normalized);
+}
+function assertKnownIds(ids, knownIds) {
+    for (const id of ids) {
+        if (!knownIds.has(id)) {
+            throw new PluginSelectionErrorV1("unknown_plugin_id", `Selection references unknown plugin ID: ${id}`, id);
+        }
+    }
+}
+/** Validate and freeze a selection without resolving or touching a host. */
+export function createPluginSelectionV1(input) {
+    const profileId = validateId(input.profileId, "profileId");
+    const selectedPluginIds = normalizeIds(input.selectedPluginIds, "selectedPluginIds");
+    const disabledPluginIds = normalizeIds(input.disabledPluginIds, "disabledPluginIds");
+    return Object.freeze({
+        version: PLUGIN_SELECTION_VERSION_V1,
+        profileId,
+        selectedPluginIds,
+        disabledPluginIds,
+    });
+}
+/**
+ * Resolve a selection to bounded catalog entries and diagnostics. This is a
+ * read-only planning operation; it does not imply that any plugin is enabled.
+ */
+export function resolvePluginSelectionV1(input) {
+    for (const manifest of input.manifests)
+        validateId(manifest.id, "pluginId");
+    const knownIds = new Set(input.manifests.map((manifest) => manifest.id));
+    const provisional = createPluginSelectionV1(input.selection);
+    if (input.selection.selectedPluginIds === undefined && knownIds.size > MAX_PLUGIN_SELECTION_IDS_V1) {
+        throw new PluginSelectionErrorV1("too_many_plugin_ids", `discovered plugin IDs exceed the selection limit of ${MAX_PLUGIN_SELECTION_IDS_V1}`);
+    }
+    const selectedPluginIds = input.selection.selectedPluginIds === undefined
+        ? Object.freeze([...knownIds].sort((a, b) => a.localeCompare(b)))
+        : provisional.selectedPluginIds;
+    const selection = Object.freeze({ ...provisional, selectedPluginIds });
+    assertKnownIds(selection.selectedPluginIds, knownIds);
+    assertKnownIds(selection.disabledPluginIds, knownIds);
+    const catalog = buildPluginCatalogV1({
+        manifests: input.manifests,
+        host: input.host,
+        required: input.required,
+        disabledPluginIds: selection.disabledPluginIds,
+        availableCapabilities: input.availableCapabilities,
+        maxEntries: input.maxEntries,
+    });
+    const selected = new Set(selection.selectedPluginIds);
+    // Resolve selected manifests separately so a bounded/truncated all-manifest
+    // catalog cannot silently hide an explicitly selected plugin.
+    const selectedCatalog = buildPluginCatalogV1({
+        manifests: input.manifests.filter((manifest) => selected.has(manifest.id)),
+        host: input.host,
+        required: input.required,
+        disabledPluginIds: selection.disabledPluginIds,
+        availableCapabilities: input.availableCapabilities,
+        maxEntries: Math.max(input.maxEntries ?? MAX_PLUGIN_SELECTION_IDS_V1, selection.selectedPluginIds.length),
+    });
+    if (selectedCatalog.truncated) {
+        const selectedEntryIds = new Set(selectedCatalog.entries.map((entry) => entry.pluginId));
+        const omitted = selection.selectedPluginIds.find((id) => !selectedEntryIds.has(id));
+        if (omitted !== undefined) {
+            throw new PluginSelectionErrorV1("catalog_truncated", `Catalog truncation omitted selected plugin ID: ${omitted}`, omitted);
+        }
+    }
+    const entries = Object.freeze(selectedCatalog.entries);
+    const diagnostics = Object.freeze(entries.flatMap((entry) => entry.resolution.diagnostics));
+    return Object.freeze({ selection, catalog, entries, diagnostics });
+}
+/** Serialize only the stable selection data; no manifest, host, or payload is included. */
+export function serializePluginSelectionV1(selection) {
+    const normalized = createPluginSelectionV1(selection);
+    return JSON.stringify(normalized);
+}
+//# sourceMappingURL=selection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import { buildPluginCatalogV1, type PluginCatalogEntryV1, type PluginCatalogSnapshotV1 } from \"./catalog.ts\";\nimport type { CapabilityRefV1, HostFactsV1, PluginDiagnosticV1, PluginManifestV1 } from \"./types.ts\";\n\n/** Version of the user-owned, host-independent plugin selection snapshot. */\nexport const PLUGIN_SELECTION_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_SELECTION_ID_CHARS_V1 = 128;\nexport const MAX_PLUGIN_SELECTION_IDS_V1 = 128;\n\nexport interface PluginSelectionV1 {\n\treadonly version: typeof PLUGIN_SELECTION_VERSION_V1;\n\treadonly profileId: string;\n\treadonly selectedPluginIds: readonly string[];\n\treadonly disabledPluginIds: readonly string[];\n}\n\nexport type PluginSelectionErrorCodeV1 =\n\t| \"invalid_profile_id\"\n\t| \"profile_id_too_long\"\n\t| \"invalid_plugin_id\"\n\t| \"plugin_id_too_long\"\n\t| \"too_many_plugin_ids\"\n\t| \"duplicate_plugin_id\"\n\t| \"unknown_plugin_id\"\n\t| \"catalog_truncated\";\n\nexport class PluginSelectionErrorV1 extends Error {\n\treadonly code: PluginSelectionErrorCodeV1;\n\treadonly pluginId?: string;\n\n\tconstructor(code: PluginSelectionErrorCodeV1, message: string, pluginId?: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginSelectionErrorV1\";\n\t\tthis.code = code;\n\t\tthis.pluginId = pluginId;\n\t}\n}\n\n/**\n * A pure catalog projection for a user selection. It never downloads,\n * writes, installs, activates, or mutates a plugin. The host owns those\n * operations through the separate installer contract.\n */\nexport interface PluginSelectionResolutionV1 {\n\treadonly selection: PluginSelectionV1;\n\t/** The bounded catalog of every discovered manifest. */\n\treadonly catalog: PluginCatalogSnapshotV1;\n\t/** Entries requested by the selection, in catalog order. */\n\treadonly entries: readonly PluginCatalogEntryV1[];\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n}\n\nexport interface PluginSelectionInputV1 {\n\treadonly profileId: string;\n\t/** Omitted means all discovered plugin IDs; [] means no plugin. */\n\treadonly selectedPluginIds?: readonly string[];\n\treadonly disabledPluginIds?: readonly string[];\n}\n\nfunction validateId(value: unknown, label: \"profileId\" | \"pluginId\"): string {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\tlabel === \"profileId\" ? \"invalid_profile_id\" : \"invalid_plugin_id\",\n\t\t\t`${label} must be a non-empty string`,\n\t\t\ttypeof value === \"string\" ? value : undefined,\n\t\t);\n\t}\n\tif (value.length > MAX_PLUGIN_SELECTION_ID_CHARS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\tlabel === \"profileId\" ? \"profile_id_too_long\" : \"plugin_id_too_long\",\n\t\t\t`${label} must be at most ${MAX_PLUGIN_SELECTION_ID_CHARS_V1} characters`,\n\t\t\tvalue,\n\t\t);\n\t}\n\treturn value;\n}\n\nfunction normalizeIds(\n\tids: readonly string[] | undefined,\n\tlabel: \"selectedPluginIds\" | \"disabledPluginIds\",\n): readonly string[] {\n\tif (ids === undefined) return [];\n\tif (!Array.isArray(ids) || ids.length > MAX_PLUGIN_SELECTION_IDS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\"too_many_plugin_ids\",\n\t\t\t`${label} must contain at most ${MAX_PLUGIN_SELECTION_IDS_V1} plugin IDs`,\n\t\t);\n\t}\n\tconst seen = new Set<string>();\n\tconst normalized: string[] = [];\n\tfor (const candidate of ids) {\n\t\tconst id = validateId(candidate, \"pluginId\");\n\t\tif (seen.has(id)) {\n\t\t\tthrow new PluginSelectionErrorV1(\"duplicate_plugin_id\", `${label} contains duplicate plugin ID: ${id}`, id);\n\t\t}\n\t\tseen.add(id);\n\t\tnormalized.push(id);\n\t}\n\tnormalized.sort((left, right) => left.localeCompare(right));\n\treturn Object.freeze(normalized);\n}\n\nfunction assertKnownIds(ids: readonly string[], knownIds: ReadonlySet<string>): void {\n\tfor (const id of ids) {\n\t\tif (!knownIds.has(id)) {\n\t\t\tthrow new PluginSelectionErrorV1(\"unknown_plugin_id\", `Selection references unknown plugin ID: ${id}`, id);\n\t\t}\n\t}\n}\n\n/** Validate and freeze a selection without resolving or touching a host. */\nexport function createPluginSelectionV1(input: PluginSelectionInputV1): PluginSelectionV1 {\n\tconst profileId = validateId(input.profileId, \"profileId\");\n\tconst selectedPluginIds = normalizeIds(input.selectedPluginIds, \"selectedPluginIds\");\n\tconst disabledPluginIds = normalizeIds(input.disabledPluginIds, \"disabledPluginIds\");\n\treturn Object.freeze({\n\t\tversion: PLUGIN_SELECTION_VERSION_V1,\n\t\tprofileId,\n\t\tselectedPluginIds,\n\t\tdisabledPluginIds,\n\t});\n}\n\n/**\n * Resolve a selection to bounded catalog entries and diagnostics. This is a\n * read-only planning operation; it does not imply that any plugin is enabled.\n */\nexport function resolvePluginSelectionV1(input: {\n\treadonly selection: PluginSelectionInputV1;\n\treadonly manifests: readonly PluginManifestV1[];\n\treadonly host: HostFactsV1;\n\treadonly required?: boolean;\n\treadonly availableCapabilities?: readonly CapabilityRefV1[];\n\treadonly maxEntries?: number;\n}): PluginSelectionResolutionV1 {\n\tfor (const manifest of input.manifests) validateId(manifest.id, \"pluginId\");\n\tconst knownIds = new Set(input.manifests.map((manifest) => manifest.id));\n\tconst provisional = createPluginSelectionV1(input.selection);\n\tif (input.selection.selectedPluginIds === undefined && knownIds.size > MAX_PLUGIN_SELECTION_IDS_V1) {\n\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\"too_many_plugin_ids\",\n\t\t\t`discovered plugin IDs exceed the selection limit of ${MAX_PLUGIN_SELECTION_IDS_V1}`,\n\t\t);\n\t}\n\tconst selectedPluginIds =\n\t\tinput.selection.selectedPluginIds === undefined\n\t\t\t? Object.freeze([...knownIds].sort((a, b) => a.localeCompare(b)))\n\t\t\t: provisional.selectedPluginIds;\n\tconst selection = Object.freeze({ ...provisional, selectedPluginIds });\n\tassertKnownIds(selection.selectedPluginIds, knownIds);\n\tassertKnownIds(selection.disabledPluginIds, knownIds);\n\tconst catalog = buildPluginCatalogV1({\n\t\tmanifests: input.manifests,\n\t\thost: input.host,\n\t\trequired: input.required,\n\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t\tavailableCapabilities: input.availableCapabilities,\n\t\tmaxEntries: input.maxEntries,\n\t});\n\tconst selected = new Set(selection.selectedPluginIds);\n\t// Resolve selected manifests separately so a bounded/truncated all-manifest\n\t// catalog cannot silently hide an explicitly selected plugin.\n\tconst selectedCatalog = buildPluginCatalogV1({\n\t\tmanifests: input.manifests.filter((manifest) => selected.has(manifest.id)),\n\t\thost: input.host,\n\t\trequired: input.required,\n\t\tdisabledPluginIds: selection.disabledPluginIds,\n\t\tavailableCapabilities: input.availableCapabilities,\n\t\tmaxEntries: Math.max(input.maxEntries ?? MAX_PLUGIN_SELECTION_IDS_V1, selection.selectedPluginIds.length),\n\t});\n\tif (selectedCatalog.truncated) {\n\t\tconst selectedEntryIds = new Set(selectedCatalog.entries.map((entry) => entry.pluginId));\n\t\tconst omitted = selection.selectedPluginIds.find((id) => !selectedEntryIds.has(id));\n\t\tif (omitted !== undefined) {\n\t\t\tthrow new PluginSelectionErrorV1(\n\t\t\t\t\"catalog_truncated\",\n\t\t\t\t`Catalog truncation omitted selected plugin ID: ${omitted}`,\n\t\t\t\tomitted,\n\t\t\t);\n\t\t}\n\t}\n\tconst entries = Object.freeze(selectedCatalog.entries);\n\tconst diagnostics = Object.freeze(entries.flatMap((entry) => entry.resolution.diagnostics));\n\treturn Object.freeze({ selection, catalog, entries, diagnostics });\n}\n\n/** Serialize only the stable selection data; no manifest, host, or payload is included. */\nexport function serializePluginSelectionV1(selection: PluginSelectionV1): string {\n\tconst normalized = createPluginSelectionV1(selection);\n\treturn JSON.stringify(normalized);\n}\n"]}

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

@@ -0,0 +1,96 @@
+import { type PluginInstallationV1 } from "./installer.ts";
+export declare const PLUGIN_STATE_SNAPSHOT_VERSION_V1: 1;
+export declare const MAX_PLUGIN_STATE_RECORDS_V1 = 256;
+export declare const MAX_PLUGIN_STATE_STRING_CHARS_V1 = 4096;
+export declare const MAX_PLUGIN_STATE_ID_CHARS_V1 = 256;
+export declare const MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1 = 2048;
+/** Optional acquisition source label (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`). */
+export declare const MAX_PLUGIN_STATE_SOURCE_CHARS_V1 = 128;
+export type PluginStateScopeV1 = "global" | "project";
+export type PluginStateLifecycleV1 = PluginInstallationV1["state"];
+/** Persisted identity, enablement, scope, and recoverable installation lifecycle. */
+export interface PluginStateRecordV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly manifestDigest: string;
+    /** Opaque host handle. It must never be a local path or file URI. */
+    readonly installationRef: string;
+    /** Optional acquisition source label; absent on records written before S1-b. */
+    readonly source?: string;
+    readonly state: {
+        readonly scope: PluginStateScopeV1;
+        /** Opaque concrete installation namespace; never a local path. */
+        readonly scopeRef: string;
+        readonly enabled: boolean;
+        readonly lifecycle: PluginStateLifecycleV1;
+    };
+}
+export interface PluginStateSnapshotV1 {
+    readonly version: typeof PLUGIN_STATE_SNAPSHOT_VERSION_V1;
+    readonly records: readonly PluginStateRecordV1[];
+}
+export type PluginStateDiagnosticCodeV1 = "invalid_path" | "invalid_json" | "invalid_schema" | "duplicate_identity" | "too_many_records" | "invalid_installation_ref" | "cancelled";
+export interface PluginStateDiagnosticV1 {
+    readonly code: PluginStateDiagnosticCodeV1;
+    readonly message: string;
+    readonly identity?: string;
+}
+export type PluginStateReadResultV1 = {
+    readonly status: "ok";
+    readonly snapshot: PluginStateSnapshotV1;
+} | {
+    readonly status: "missing";
+    readonly snapshot: PluginStateSnapshotV1;
+} | {
+    readonly status: "invalid";
+    readonly diagnostics: readonly PluginStateDiagnosticV1[];
+} | {
+    readonly status: "cancelled";
+    readonly diagnostics: readonly PluginStateDiagnosticV1[];
+};
+export type PluginStateMutationResultV1 = {
+    readonly status: "ok";
+    readonly snapshot: PluginStateSnapshotV1;
+    readonly changed: boolean;
+} | {
+    readonly status: "invalid";
+    readonly diagnostics: readonly PluginStateDiagnosticV1[];
+} | {
+    readonly status: "cancelled";
+    readonly diagnostics: readonly PluginStateDiagnosticV1[];
+};
+export interface PluginStateFileSystemV1 {
+    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 PluginStateStoreOptionsV1 {
+    /** Absolute path to the host-owned plugin-state.json file. */
+    readonly filePath: string;
+    /** Injectable filesystem for deterministic tests and alternate hosts. */
+    readonly fileSystem?: PluginStateFileSystemV1;
+}
+export interface PluginStateStoreV1 {
+    readonly read: (options?: {
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginStateReadResultV1>;
+    readonly upsert: (input: {
+        readonly installation: PluginInstallationV1;
+        readonly scope: PluginStateScopeV1;
+        readonly enabled: boolean;
+        /** Optional acquisition source label persisted with the record. */
+        readonly source?: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginStateMutationResultV1>;
+    readonly remove: (input: {
+        readonly pluginId: string;
+        readonly pluginVersion: string;
+        readonly scope: PluginStateScopeV1;
+        readonly scopeRef: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<PluginStateMutationResultV1>;
+}
+export declare function createPluginStateStoreV1(options: PluginStateStoreOptionsV1): PluginStateStoreV1;
+//# sourceMappingURL=state.d.ts.map