@ai-agent-forge/agent-forge 0.85.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/state.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 {\n\tDEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1,\n\tMAX_PLUGIN_SCOPE_REF_CHARS_V1,\n\ttype PluginInstallationV1,\n} from \"./installer.ts\";\n\nexport const PLUGIN_STATE_SNAPSHOT_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_STATE_RECORDS_V1 = 256;\nexport const MAX_PLUGIN_STATE_STRING_CHARS_V1 = 4096;\nexport const MAX_PLUGIN_STATE_ID_CHARS_V1 = 256;\nexport const MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1 = 2048;\n/** Optional acquisition source label (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`). */\nexport const MAX_PLUGIN_STATE_SOURCE_CHARS_V1 = 128;\n\nexport type PluginStateScopeV1 = \"global\" | \"project\";\nexport type PluginStateLifecycleV1 = PluginInstallationV1[\"state\"];\n\n/** Persisted identity, enablement, scope, and recoverable installation lifecycle. */\nexport interface PluginStateRecordV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestDigest: string;\n\t/** Opaque host handle. It must never be a local path or file URI. */\n\treadonly installationRef: string;\n\t/** Optional acquisition source label; absent on records written before S1-b. */\n\treadonly source?: string;\n\treadonly state: {\n\t\treadonly scope: PluginStateScopeV1;\n\t\t/** Opaque concrete installation namespace; never a local path. */\n\t\treadonly scopeRef: string;\n\t\treadonly enabled: boolean;\n\t\treadonly lifecycle: PluginStateLifecycleV1;\n\t};\n}\n\nexport interface PluginStateSnapshotV1 {\n\treadonly version: typeof PLUGIN_STATE_SNAPSHOT_VERSION_V1;\n\treadonly records: readonly PluginStateRecordV1[];\n}\n\nexport type PluginStateDiagnosticCodeV1 =\n\t| \"invalid_path\"\n\t| \"invalid_json\"\n\t| \"invalid_schema\"\n\t| \"duplicate_identity\"\n\t| \"too_many_records\"\n\t| \"invalid_installation_ref\"\n\t| \"cancelled\";\n\nexport interface PluginStateDiagnosticV1 {\n\treadonly code: PluginStateDiagnosticCodeV1;\n\treadonly message: string;\n\treadonly identity?: string;\n}\n\nexport type PluginStateReadResultV1 =\n\t| { readonly status: \"ok\"; readonly snapshot: PluginStateSnapshotV1 }\n\t| { readonly status: \"missing\"; readonly snapshot: PluginStateSnapshotV1 }\n\t| {\n\t\t\treadonly status: \"invalid\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  }\n\t| {\n\t\t\treadonly status: \"cancelled\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  };\n\nexport type PluginStateMutationResultV1 =\n\t| {\n\t\t\treadonly status: \"ok\";\n\t\t\treadonly snapshot: PluginStateSnapshotV1;\n\t\t\treadonly changed: boolean;\n\t  }\n\t| {\n\t\t\treadonly status: \"invalid\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  }\n\t| {\n\t\t\treadonly status: \"cancelled\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  };\n\nexport interface PluginStateFileSystemV1 {\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 PluginStateStoreOptionsV1 {\n\t/** Absolute path to the host-owned plugin-state.json file. */\n\treadonly filePath: string;\n\t/** Injectable filesystem for deterministic tests and alternate hosts. */\n\treadonly fileSystem?: PluginStateFileSystemV1;\n}\n\nexport interface PluginStateStoreV1 {\n\treadonly read: (options?: { readonly signal?: AbortSignal }) => Promise<PluginStateReadResultV1>;\n\treadonly upsert: (input: {\n\t\treadonly installation: PluginInstallationV1;\n\t\treadonly scope: PluginStateScopeV1;\n\t\treadonly enabled: boolean;\n\t\t/** Optional acquisition source label persisted with the record. */\n\t\treadonly source?: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginStateMutationResultV1>;\n\treadonly remove: (input: {\n\t\treadonly pluginId: string;\n\t\treadonly pluginVersion: string;\n\t\treadonly scope: PluginStateScopeV1;\n\t\treadonly scopeRef: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginStateMutationResultV1>;\n}\n\nconst EMPTY_SNAPSHOT: PluginStateSnapshotV1 = Object.freeze({\n\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\trecords: Object.freeze([]),\n});\n\nfunction diagnostic(code: PluginStateDiagnosticCodeV1, message: string, identity?: string): PluginStateDiagnosticV1 {\n\treturn Object.freeze(identity === undefined ? { code, message } : { code, message, identity });\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\tif (typeof error !== \"object\" || error === null) return false;\n\treturn \"code\" in error && (error as { readonly code?: unknown }).code === \"ENOENT\";\n}\n\nfunction validateFilePath(value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_STATE_STRING_CHARS_V1)\n\t\tthrow new Error(\"invalid plugin state file path\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid plugin state 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 state 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 state file path\");\n\treturn normalized;\n}\n\nfunction validateOpaqueInstallationRef(value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1)\n\t\tthrow new Error(\"invalid installation reference\");\n\tif (/^(?:file:|[a-zA-Z]:[\\\\/]|[\\\\/]{1,2}|\\\\\\\\)/u.test(value) || /\\s/u.test(value))\n\t\tthrow new Error(\"invalid installation reference\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid installation reference\");\n\treturn value;\n}\n\nfunction validateScopeRef(scope: PluginStateScopeV1, value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_SCOPE_REF_CHARS_V1)\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\tif (/^(?:file:|[a-zA-Z]:[\\\\/]|[\\\\/]{1,2}|\\\\\\\\)/u.test(value) || /\\s/u.test(value))\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid plugin scope reference\");\n\tif (scope === \"global\" && value !== DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1)\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\treturn value;\n}\n\nfunction validateString(value: unknown, label: string, max = MAX_PLUGIN_STATE_STRING_CHARS_V1): string {\n\tif (typeof value !== \"string\" || value.trim().length === 0 || value.length > max || /[\\u0000-\\u001f]/u.test(value))\n\t\tthrow new Error(`${label} is invalid`);\n\treturn value;\n}\n\n/** Acquisition source labels (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`, `github:<owner>/<repo>@<tag|latest>`). */\nfunction validateSourceLabel(value: unknown): string {\n\tif (\n\t\ttypeof value !== \"string\" ||\n\t\tvalue.length === 0 ||\n\t\tvalue.length > MAX_PLUGIN_STATE_SOURCE_CHARS_V1 ||\n\t\t!/^[a-z][a-z0-9.:[\\]_/@-]*$/u.test(value)\n\t)\n\t\tthrow new Error(\"record source label is invalid\");\n\treturn value;\n}\n\nfunction identityOf(record: PluginStateRecordV1): string {\n\treturn `${record.state.scope}:${record.state.scopeRef}:${record.pluginId}@${record.pluginVersion}`;\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 validateRecord(value: unknown): PluginStateRecordV1 {\n\tconst requiredKeys = [\"pluginId\", \"pluginVersion\", \"manifestDigest\", \"installationRef\", \"state\"];\n\tconst allowedKeys = new Set([...requiredKeys, \"source\"]);\n\tif (!isObject(value) || Object.keys(value).some((key) => !allowedKeys.has(key)))\n\t\tthrow new Error(\"record schema is invalid\");\n\tfor (const key of requiredKeys) if (!(key in value)) throw new Error(\"record schema is invalid\");\n\tconst pluginId = validateString(value.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst pluginVersion = validateString(value.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst manifestDigest = validateString(value.manifestDigest, \"manifestDigest\");\n\tconst installationRef = validateOpaqueInstallationRef(value.installationRef);\n\tconst source = value.source === undefined ? undefined : validateSourceLabel(value.source);\n\tif (!isObject(value.state) || !hasExactKeys(value.state, [\"scope\", \"scopeRef\", \"enabled\", \"lifecycle\"]))\n\t\tthrow new Error(\"state schema is invalid\");\n\tif (value.state.scope !== \"global\" && value.state.scope !== \"project\") throw new Error(\"state scope is invalid\");\n\tconst scopeRef = validateScopeRef(value.state.scope, value.state.scopeRef);\n\tif (typeof value.state.enabled !== \"boolean\") throw new Error(\"state enabled flag is invalid\");\n\tif (\n\t\tvalue.state.lifecycle !== \"installed\" &&\n\t\tvalue.state.lifecycle !== \"active\" &&\n\t\tvalue.state.lifecycle !== \"retained\"\n\t)\n\t\tthrow new Error(\"state lifecycle is invalid\");\n\treturn Object.freeze({\n\t\tpluginId,\n\t\tpluginVersion,\n\t\tmanifestDigest,\n\t\tinstallationRef,\n\t\t...(source === undefined ? {} : { source }),\n\t\tstate: Object.freeze({\n\t\t\tscope: value.state.scope,\n\t\t\tscopeRef,\n\t\t\tenabled: value.state.enabled,\n\t\t\tlifecycle: value.state.lifecycle,\n\t\t}),\n\t});\n}\n\nfunction validateSnapshot(value: unknown): PluginStateSnapshotV1 {\n\tif (!isObject(value) || !hasExactKeys(value, [\"version\", \"records\"])) throw new Error(\"snapshot schema is invalid\");\n\tif (value.version !== PLUGIN_STATE_SNAPSHOT_VERSION_V1) throw new Error(\"snapshot version is unsupported\");\n\tif (!Array.isArray(value.records)) throw new Error(\"records must be an array\");\n\tif (value.records.length > MAX_PLUGIN_STATE_RECORDS_V1) throw new Error(\"too many plugin state records\");\n\tconst records = value.records.map(validateRecord);\n\tconst identities = new Set<string>();\n\tfor (const record of records) {\n\t\tconst identity = identityOf(record);\n\t\tif (identities.has(identity)) throw new Error(`duplicate identity: ${identity}`);\n\t\tidentities.add(identity);\n\t}\n\trecords.sort((left, right) => identityOf(left).localeCompare(identityOf(right)));\n\treturn Object.freeze({\n\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\trecords: Object.freeze(records),\n\t});\n}\n\nfunction invalidFromError(error: unknown): PluginStateDiagnosticV1 {\n\tconst message = error instanceof Error ? error.message : \"plugin state schema is invalid\";\n\tconst duplicatePrefix = \"duplicate identity: \";\n\tif (message.startsWith(duplicatePrefix))\n\t\treturn diagnostic(\"duplicate_identity\", message, message.slice(duplicatePrefix.length));\n\tif (message === \"too many plugin state records\") return diagnostic(\"too_many_records\", message);\n\tif (message === \"invalid installation reference\") return diagnostic(\"invalid_installation_ref\", message);\n\treturn diagnostic(\"invalid_schema\", message);\n}\n\nfunction defaultFileSystem(): PluginStateFileSystemV1 {\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 PluginStateDiagnosticV1[];\n} {\n\treturn Object.freeze({\n\t\tstatus: \"cancelled\",\n\t\tdiagnostics: Object.freeze([diagnostic(\"cancelled\", \"Plugin state operation was cancelled\")]),\n\t});\n}\n\nfunction sortRecords(records: readonly PluginStateRecordV1[]): readonly PluginStateRecordV1[] {\n\treturn Object.freeze([...records].sort((left, right) => identityOf(left).localeCompare(identityOf(right))));\n}\n\nfunction makeRecord(\n\tinstallation: PluginInstallationV1,\n\tscope: PluginStateScopeV1,\n\tenabled: boolean,\n\tsource?: string,\n): PluginStateRecordV1 {\n\tif (installation.version !== 1) throw new Error(\"plugin installation handle is invalid\");\n\tconst pluginId = validateString(installation.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst pluginVersion = validateString(installation.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst manifestDigest = validateString(installation.manifestDigest, \"manifestDigest\");\n\tconst installationRef = validateOpaqueInstallationRef(installation.installationRef);\n\tif (scope !== \"global\" && scope !== \"project\") throw new Error(\"state scope is invalid\");\n\tif (installation.scope !== scope) throw new Error(\"installation scope does not match state scope\");\n\tconst scopeRef = validateScopeRef(\n\t\tscope,\n\t\tscope === \"global\" ? (installation.scopeRef ?? DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1) : installation.scopeRef,\n\t);\n\tif (typeof enabled !== \"boolean\") throw new Error(\"state enabled flag is invalid\");\n\tconst sourceLabel = source === undefined ? undefined : validateSourceLabel(source);\n\treturn Object.freeze({\n\t\tpluginId,\n\t\tpluginVersion,\n\t\tmanifestDigest,\n\t\tinstallationRef,\n\t\t...(sourceLabel === undefined ? {} : { source: sourceLabel }),\n\t\tstate: Object.freeze({ scope, scopeRef, enabled, lifecycle: installation.state }),\n\t});\n}\n\nexport function createPluginStateStoreV1(options: PluginStateStoreOptionsV1): PluginStateStoreV1 {\n\tconst filePath = validateFilePath(options.filePath);\n\tconst fileSystem = options.fileSystem ?? defaultFileSystem();\n\n\tasync function read(signal?: AbortSignal): Promise<PluginStateReadResultV1> {\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 state JSON is invalid\")]),\n\t\t\t});\n\t\t}\n\t\ttry {\n\t\t\treturn Object.freeze({\n\t\t\t\tstatus: \"ok\",\n\t\t\t\tsnapshot: validateSnapshot(parsed),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn Object.freeze({\n\t\t\t\tstatus: \"invalid\",\n\t\t\t\tdiagnostics: Object.freeze([invalidFromError(error)]),\n\t\t\t});\n\t\t}\n\t}\n\n\tasync function write(snapshot: PluginStateSnapshotV1, signal?: AbortSignal): Promise<PluginStateMutationResultV1> {\n\t\tif (signal?.aborted) return cancelledResult();\n\t\tconst parent = dirname(filePath);\n\t\tconst temporaryPath = join(parent, `.${basename(filePath)}.${randomUUID()}.tmp`);\n\t\ttry {\n\t\t\tawait fileSystem.mkdir(parent);\n\t\t\tif (signal?.aborted) return cancelledResult();\n\t\t\tawait fileSystem.writeFile(temporaryPath, `${JSON.stringify(snapshot)}\\n`);\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\t// Serialize mutations made through one store instance so concurrent CLI/UI\n\t// actions cannot lose each other's read-modify-write updates.\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\tupsert: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet record: PluginStateRecordV1;\n\t\t\t\ttry {\n\t\t\t\t\trecord = makeRecord(input.installation, input.scope, input.enabled, input.source);\n\t\t\t\t} catch (error) {\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([invalidFromError(error)]),\n\t\t\t\t\t});\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 records = current.snapshot.records.filter(\n\t\t\t\t\t(candidate) => identityOf(candidate) !== identityOf(record),\n\t\t\t\t);\n\t\t\t\tif (\n\t\t\t\t\trecords.length >= MAX_PLUGIN_STATE_RECORDS_V1 &&\n\t\t\t\t\t!current.snapshot.records.some((candidate) => identityOf(candidate) === identityOf(record))\n\t\t\t\t)\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_records\", \"too many plugin state records\")]),\n\t\t\t\t\t});\n\t\t\t\tconst snapshot = Object.freeze({\n\t\t\t\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\t\t\t\trecords: sortRecords([...records, record]),\n\t\t\t\t});\n\t\t\t\treturn await write(snapshot, input.signal);\n\t\t\t}),\n\t\tremove: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet pluginId: string;\n\t\t\t\tlet pluginVersion: string;\n\t\t\t\tlet scope: PluginStateScopeV1;\n\t\t\t\tlet scopeRef: string;\n\t\t\t\ttry {\n\t\t\t\t\tpluginId = validateString(input.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\t\t\t\t\tpluginVersion = validateString(input.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\t\t\t\t\tif (input.scope !== \"global\" && input.scope !== \"project\") throw new Error(\"state scope is invalid\");\n\t\t\t\t\tscope = input.scope;\n\t\t\t\t\tscopeRef = validateScopeRef(scope, input.scopeRef);\n\t\t\t\t} catch (error) {\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([invalidFromError(error)]),\n\t\t\t\t\t});\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 identity = `${scope}:${scopeRef}:${pluginId}@${pluginVersion}`;\n\t\t\t\tconst records = current.snapshot.records.filter((candidate) => identityOf(candidate) !== identity);\n\t\t\t\tif (records.length === current.snapshot.records.length)\n\t\t\t\t\treturn Object.freeze({\n\t\t\t\t\t\tstatus: \"ok\",\n\t\t\t\t\t\tsnapshot: current.snapshot,\n\t\t\t\t\t\tchanged: false,\n\t\t\t\t\t});\n\t\t\t\tconst snapshot = Object.freeze({\n\t\t\t\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\t\t\t\trecords: sortRecords(records),\n\t\t\t\t});\n\t\t\t\treturn await write(snapshot, input.signal);\n\t\t\t}),\n\t};\n}\n"]}

package/dist/plugins/ecosystem/state.js

@@ -0,0 +1,346 @@
+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 { DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1, MAX_PLUGIN_SCOPE_REF_CHARS_V1, } from "./installer.js";
+export const PLUGIN_STATE_SNAPSHOT_VERSION_V1 = 1;
+export const MAX_PLUGIN_STATE_RECORDS_V1 = 256;
+export const MAX_PLUGIN_STATE_STRING_CHARS_V1 = 4096;
+export const MAX_PLUGIN_STATE_ID_CHARS_V1 = 256;
+export const MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1 = 2048;
+/** Optional acquisition source label (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`). */
+export const MAX_PLUGIN_STATE_SOURCE_CHARS_V1 = 128;
+const EMPTY_SNAPSHOT = Object.freeze({
+    version: PLUGIN_STATE_SNAPSHOT_VERSION_V1,
+    records: Object.freeze([]),
+});
+function diagnostic(code, message, identity) {
+    return Object.freeze(identity === undefined ? { code, message } : { code, message, identity });
+}
+function isAbortError(error) {
+    return error instanceof Error && (error.name === "AbortError" || error.name === "AbortSignalError");
+}
+function isMissingError(error) {
+    if (typeof error !== "object" || error === null)
+        return false;
+    return "code" in error && error.code === "ENOENT";
+}
+function validateFilePath(value) {
+    if (typeof value !== "string" || value.trim() === "" || value.length > MAX_PLUGIN_STATE_STRING_CHARS_V1)
+        throw new Error("invalid plugin state file path");
+    if (value.includes("\0") || /[\u0000-\u001f]/u.test(value))
+        throw new Error("invalid plugin state 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 state file path");
+    const normalized = isAbsolute(value) ? value : resolve(value);
+    if (basename(normalized).length === 0 || basename(normalized) === "." || basename(normalized) === "..")
+        throw new Error("invalid plugin state file path");
+    return normalized;
+}
+function validateOpaqueInstallationRef(value) {
+    if (typeof value !== "string" || value.trim() === "" || value.length > MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1)
+        throw new Error("invalid installation reference");
+    if (/^(?:file:|[a-zA-Z]:[\\/]|[\\/]{1,2}|\\\\)/u.test(value) || /\s/u.test(value))
+        throw new Error("invalid installation reference");
+    if (value.includes("\0") || /[\u0000-\u001f]/u.test(value))
+        throw new Error("invalid installation reference");
+    return value;
+}
+function validateScopeRef(scope, value) {
+    if (typeof value !== "string" || value.trim() === "" || value.length > MAX_PLUGIN_SCOPE_REF_CHARS_V1)
+        throw new Error("invalid plugin scope reference");
+    if (/^(?:file:|[a-zA-Z]:[\\/]|[\\/]{1,2}|\\\\)/u.test(value) || /\s/u.test(value))
+        throw new Error("invalid plugin scope reference");
+    if (value.includes("\0") || /[\u0000-\u001f]/u.test(value))
+        throw new Error("invalid plugin scope reference");
+    if (scope === "global" && value !== DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1)
+        throw new Error("invalid plugin scope reference");
+    return value;
+}
+function validateString(value, label, max = MAX_PLUGIN_STATE_STRING_CHARS_V1) {
+    if (typeof value !== "string" || value.trim().length === 0 || value.length > max || /[\u0000-\u001f]/u.test(value))
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+/** Acquisition source labels (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`, `github:<owner>/<repo>@<tag|latest>`). */
+function validateSourceLabel(value) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.length > MAX_PLUGIN_STATE_SOURCE_CHARS_V1 ||
+        !/^[a-z][a-z0-9.:[\]_/@-]*$/u.test(value))
+        throw new Error("record source label is invalid");
+    return value;
+}
+function identityOf(record) {
+    return `${record.state.scope}:${record.state.scopeRef}:${record.pluginId}@${record.pluginVersion}`;
+}
+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 validateRecord(value) {
+    const requiredKeys = ["pluginId", "pluginVersion", "manifestDigest", "installationRef", "state"];
+    const allowedKeys = new Set([...requiredKeys, "source"]);
+    if (!isObject(value) || Object.keys(value).some((key) => !allowedKeys.has(key)))
+        throw new Error("record schema is invalid");
+    for (const key of requiredKeys)
+        if (!(key in value))
+            throw new Error("record schema is invalid");
+    const pluginId = validateString(value.pluginId, "pluginId", MAX_PLUGIN_STATE_ID_CHARS_V1);
+    const pluginVersion = validateString(value.pluginVersion, "pluginVersion", MAX_PLUGIN_STATE_ID_CHARS_V1);
+    const manifestDigest = validateString(value.manifestDigest, "manifestDigest");
+    const installationRef = validateOpaqueInstallationRef(value.installationRef);
+    const source = value.source === undefined ? undefined : validateSourceLabel(value.source);
+    if (!isObject(value.state) || !hasExactKeys(value.state, ["scope", "scopeRef", "enabled", "lifecycle"]))
+        throw new Error("state schema is invalid");
+    if (value.state.scope !== "global" && value.state.scope !== "project")
+        throw new Error("state scope is invalid");
+    const scopeRef = validateScopeRef(value.state.scope, value.state.scopeRef);
+    if (typeof value.state.enabled !== "boolean")
+        throw new Error("state enabled flag is invalid");
+    if (value.state.lifecycle !== "installed" &&
+        value.state.lifecycle !== "active" &&
+        value.state.lifecycle !== "retained")
+        throw new Error("state lifecycle is invalid");
+    return Object.freeze({
+        pluginId,
+        pluginVersion,
+        manifestDigest,
+        installationRef,
+        ...(source === undefined ? {} : { source }),
+        state: Object.freeze({
+            scope: value.state.scope,
+            scopeRef,
+            enabled: value.state.enabled,
+            lifecycle: value.state.lifecycle,
+        }),
+    });
+}
+function validateSnapshot(value) {
+    if (!isObject(value) || !hasExactKeys(value, ["version", "records"]))
+        throw new Error("snapshot schema is invalid");
+    if (value.version !== PLUGIN_STATE_SNAPSHOT_VERSION_V1)
+        throw new Error("snapshot version is unsupported");
+    if (!Array.isArray(value.records))
+        throw new Error("records must be an array");
+    if (value.records.length > MAX_PLUGIN_STATE_RECORDS_V1)
+        throw new Error("too many plugin state records");
+    const records = value.records.map(validateRecord);
+    const identities = new Set();
+    for (const record of records) {
+        const identity = identityOf(record);
+        if (identities.has(identity))
+            throw new Error(`duplicate identity: ${identity}`);
+        identities.add(identity);
+    }
+    records.sort((left, right) => identityOf(left).localeCompare(identityOf(right)));
+    return Object.freeze({
+        version: PLUGIN_STATE_SNAPSHOT_VERSION_V1,
+        records: Object.freeze(records),
+    });
+}
+function invalidFromError(error) {
+    const message = error instanceof Error ? error.message : "plugin state schema is invalid";
+    const duplicatePrefix = "duplicate identity: ";
+    if (message.startsWith(duplicatePrefix))
+        return diagnostic("duplicate_identity", message, message.slice(duplicatePrefix.length));
+    if (message === "too many plugin state records")
+        return diagnostic("too_many_records", message);
+    if (message === "invalid installation reference")
+        return diagnostic("invalid_installation_ref", message);
+    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 state operation was cancelled")]),
+    });
+}
+function sortRecords(records) {
+    return Object.freeze([...records].sort((left, right) => identityOf(left).localeCompare(identityOf(right))));
+}
+function makeRecord(installation, scope, enabled, source) {
+    if (installation.version !== 1)
+        throw new Error("plugin installation handle is invalid");
+    const pluginId = validateString(installation.pluginId, "pluginId", MAX_PLUGIN_STATE_ID_CHARS_V1);
+    const pluginVersion = validateString(installation.pluginVersion, "pluginVersion", MAX_PLUGIN_STATE_ID_CHARS_V1);
+    const manifestDigest = validateString(installation.manifestDigest, "manifestDigest");
+    const installationRef = validateOpaqueInstallationRef(installation.installationRef);
+    if (scope !== "global" && scope !== "project")
+        throw new Error("state scope is invalid");
+    if (installation.scope !== scope)
+        throw new Error("installation scope does not match state scope");
+    const scopeRef = validateScopeRef(scope, scope === "global" ? (installation.scopeRef ?? DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1) : installation.scopeRef);
+    if (typeof enabled !== "boolean")
+        throw new Error("state enabled flag is invalid");
+    const sourceLabel = source === undefined ? undefined : validateSourceLabel(source);
+    return Object.freeze({
+        pluginId,
+        pluginVersion,
+        manifestDigest,
+        installationRef,
+        ...(sourceLabel === undefined ? {} : { source: sourceLabel }),
+        state: Object.freeze({ scope, scopeRef, enabled, lifecycle: installation.state }),
+    });
+}
+export function createPluginStateStoreV1(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 state 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 parent = dirname(filePath);
+        const temporaryPath = join(parent, `.${basename(filePath)}.${randomUUID()}.tmp`);
+        try {
+            await fileSystem.mkdir(parent);
+            if (signal?.aborted)
+                return cancelledResult();
+            await fileSystem.writeFile(temporaryPath, `${JSON.stringify(snapshot)}\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.
+            }
+        }
+    }
+    // Serialize mutations made through one store instance so concurrent CLI/UI
+    // actions cannot lose each other's read-modify-write updates.
+    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),
+        upsert: (input) => enqueueMutation(async () => {
+            let record;
+            try {
+                record = makeRecord(input.installation, input.scope, input.enabled, input.source);
+            }
+            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 records = current.snapshot.records.filter((candidate) => identityOf(candidate) !== identityOf(record));
+            if (records.length >= MAX_PLUGIN_STATE_RECORDS_V1 &&
+                !current.snapshot.records.some((candidate) => identityOf(candidate) === identityOf(record)))
+                return Object.freeze({
+                    status: "invalid",
+                    diagnostics: Object.freeze([diagnostic("too_many_records", "too many plugin state records")]),
+                });
+            const snapshot = Object.freeze({
+                version: PLUGIN_STATE_SNAPSHOT_VERSION_V1,
+                records: sortRecords([...records, record]),
+            });
+            return await write(snapshot, input.signal);
+        }),
+        remove: (input) => enqueueMutation(async () => {
+            let pluginId;
+            let pluginVersion;
+            let scope;
+            let scopeRef;
+            try {
+                pluginId = validateString(input.pluginId, "pluginId", MAX_PLUGIN_STATE_ID_CHARS_V1);
+                pluginVersion = validateString(input.pluginVersion, "pluginVersion", MAX_PLUGIN_STATE_ID_CHARS_V1);
+                if (input.scope !== "global" && input.scope !== "project")
+                    throw new Error("state scope is invalid");
+                scope = input.scope;
+                scopeRef = validateScopeRef(scope, input.scopeRef);
+            }
+            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 identity = `${scope}:${scopeRef}:${pluginId}@${pluginVersion}`;
+            const records = current.snapshot.records.filter((candidate) => identityOf(candidate) !== identity);
+            if (records.length === current.snapshot.records.length)
+                return Object.freeze({
+                    status: "ok",
+                    snapshot: current.snapshot,
+                    changed: false,
+                });
+            const snapshot = Object.freeze({
+                version: PLUGIN_STATE_SNAPSHOT_VERSION_V1,
+                records: sortRecords(records),
+            });
+            return await write(snapshot, input.signal);
+        }),
+    };
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/state.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 {\n\tDEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1,\n\tMAX_PLUGIN_SCOPE_REF_CHARS_V1,\n\ttype PluginInstallationV1,\n} from \"./installer.ts\";\n\nexport const PLUGIN_STATE_SNAPSHOT_VERSION_V1 = 1 as const;\nexport const MAX_PLUGIN_STATE_RECORDS_V1 = 256;\nexport const MAX_PLUGIN_STATE_STRING_CHARS_V1 = 4096;\nexport const MAX_PLUGIN_STATE_ID_CHARS_V1 = 256;\nexport const MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1 = 2048;\n/** Optional acquisition source label (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`). */\nexport const MAX_PLUGIN_STATE_SOURCE_CHARS_V1 = 128;\n\nexport type PluginStateScopeV1 = \"global\" | \"project\";\nexport type PluginStateLifecycleV1 = PluginInstallationV1[\"state\"];\n\n/** Persisted identity, enablement, scope, and recoverable installation lifecycle. */\nexport interface PluginStateRecordV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestDigest: string;\n\t/** Opaque host handle. It must never be a local path or file URI. */\n\treadonly installationRef: string;\n\t/** Optional acquisition source label; absent on records written before S1-b. */\n\treadonly source?: string;\n\treadonly state: {\n\t\treadonly scope: PluginStateScopeV1;\n\t\t/** Opaque concrete installation namespace; never a local path. */\n\t\treadonly scopeRef: string;\n\t\treadonly enabled: boolean;\n\t\treadonly lifecycle: PluginStateLifecycleV1;\n\t};\n}\n\nexport interface PluginStateSnapshotV1 {\n\treadonly version: typeof PLUGIN_STATE_SNAPSHOT_VERSION_V1;\n\treadonly records: readonly PluginStateRecordV1[];\n}\n\nexport type PluginStateDiagnosticCodeV1 =\n\t| \"invalid_path\"\n\t| \"invalid_json\"\n\t| \"invalid_schema\"\n\t| \"duplicate_identity\"\n\t| \"too_many_records\"\n\t| \"invalid_installation_ref\"\n\t| \"cancelled\";\n\nexport interface PluginStateDiagnosticV1 {\n\treadonly code: PluginStateDiagnosticCodeV1;\n\treadonly message: string;\n\treadonly identity?: string;\n}\n\nexport type PluginStateReadResultV1 =\n\t| { readonly status: \"ok\"; readonly snapshot: PluginStateSnapshotV1 }\n\t| { readonly status: \"missing\"; readonly snapshot: PluginStateSnapshotV1 }\n\t| {\n\t\t\treadonly status: \"invalid\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  }\n\t| {\n\t\t\treadonly status: \"cancelled\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  };\n\nexport type PluginStateMutationResultV1 =\n\t| {\n\t\t\treadonly status: \"ok\";\n\t\t\treadonly snapshot: PluginStateSnapshotV1;\n\t\t\treadonly changed: boolean;\n\t  }\n\t| {\n\t\t\treadonly status: \"invalid\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  }\n\t| {\n\t\t\treadonly status: \"cancelled\";\n\t\t\treadonly diagnostics: readonly PluginStateDiagnosticV1[];\n\t  };\n\nexport interface PluginStateFileSystemV1 {\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 PluginStateStoreOptionsV1 {\n\t/** Absolute path to the host-owned plugin-state.json file. */\n\treadonly filePath: string;\n\t/** Injectable filesystem for deterministic tests and alternate hosts. */\n\treadonly fileSystem?: PluginStateFileSystemV1;\n}\n\nexport interface PluginStateStoreV1 {\n\treadonly read: (options?: { readonly signal?: AbortSignal }) => Promise<PluginStateReadResultV1>;\n\treadonly upsert: (input: {\n\t\treadonly installation: PluginInstallationV1;\n\t\treadonly scope: PluginStateScopeV1;\n\t\treadonly enabled: boolean;\n\t\t/** Optional acquisition source label persisted with the record. */\n\t\treadonly source?: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginStateMutationResultV1>;\n\treadonly remove: (input: {\n\t\treadonly pluginId: string;\n\t\treadonly pluginVersion: string;\n\t\treadonly scope: PluginStateScopeV1;\n\t\treadonly scopeRef: string;\n\t\treadonly signal?: AbortSignal;\n\t}) => Promise<PluginStateMutationResultV1>;\n}\n\nconst EMPTY_SNAPSHOT: PluginStateSnapshotV1 = Object.freeze({\n\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\trecords: Object.freeze([]),\n});\n\nfunction diagnostic(code: PluginStateDiagnosticCodeV1, message: string, identity?: string): PluginStateDiagnosticV1 {\n\treturn Object.freeze(identity === undefined ? { code, message } : { code, message, identity });\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\tif (typeof error !== \"object\" || error === null) return false;\n\treturn \"code\" in error && (error as { readonly code?: unknown }).code === \"ENOENT\";\n}\n\nfunction validateFilePath(value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_STATE_STRING_CHARS_V1)\n\t\tthrow new Error(\"invalid plugin state file path\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid plugin state 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 state 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 state file path\");\n\treturn normalized;\n}\n\nfunction validateOpaqueInstallationRef(value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_STATE_INSTALLATION_REF_CHARS_V1)\n\t\tthrow new Error(\"invalid installation reference\");\n\tif (/^(?:file:|[a-zA-Z]:[\\\\/]|[\\\\/]{1,2}|\\\\\\\\)/u.test(value) || /\\s/u.test(value))\n\t\tthrow new Error(\"invalid installation reference\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid installation reference\");\n\treturn value;\n}\n\nfunction validateScopeRef(scope: PluginStateScopeV1, value: unknown): string {\n\tif (typeof value !== \"string\" || value.trim() === \"\" || value.length > MAX_PLUGIN_SCOPE_REF_CHARS_V1)\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\tif (/^(?:file:|[a-zA-Z]:[\\\\/]|[\\\\/]{1,2}|\\\\\\\\)/u.test(value) || /\\s/u.test(value))\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\tif (value.includes(\"\\0\") || /[\\u0000-\\u001f]/u.test(value)) throw new Error(\"invalid plugin scope reference\");\n\tif (scope === \"global\" && value !== DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1)\n\t\tthrow new Error(\"invalid plugin scope reference\");\n\treturn value;\n}\n\nfunction validateString(value: unknown, label: string, max = MAX_PLUGIN_STATE_STRING_CHARS_V1): string {\n\tif (typeof value !== \"string\" || value.trim().length === 0 || value.length > max || /[\\u0000-\\u001f]/u.test(value))\n\t\tthrow new Error(`${label} is invalid`);\n\treturn value;\n}\n\n/** Acquisition source labels (`npm:<host>`, `url:<host>`, `local:dir`, `local:file`, `github:<owner>/<repo>@<tag|latest>`). */\nfunction validateSourceLabel(value: unknown): string {\n\tif (\n\t\ttypeof value !== \"string\" ||\n\t\tvalue.length === 0 ||\n\t\tvalue.length > MAX_PLUGIN_STATE_SOURCE_CHARS_V1 ||\n\t\t!/^[a-z][a-z0-9.:[\\]_/@-]*$/u.test(value)\n\t)\n\t\tthrow new Error(\"record source label is invalid\");\n\treturn value;\n}\n\nfunction identityOf(record: PluginStateRecordV1): string {\n\treturn `${record.state.scope}:${record.state.scopeRef}:${record.pluginId}@${record.pluginVersion}`;\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 validateRecord(value: unknown): PluginStateRecordV1 {\n\tconst requiredKeys = [\"pluginId\", \"pluginVersion\", \"manifestDigest\", \"installationRef\", \"state\"];\n\tconst allowedKeys = new Set([...requiredKeys, \"source\"]);\n\tif (!isObject(value) || Object.keys(value).some((key) => !allowedKeys.has(key)))\n\t\tthrow new Error(\"record schema is invalid\");\n\tfor (const key of requiredKeys) if (!(key in value)) throw new Error(\"record schema is invalid\");\n\tconst pluginId = validateString(value.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst pluginVersion = validateString(value.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst manifestDigest = validateString(value.manifestDigest, \"manifestDigest\");\n\tconst installationRef = validateOpaqueInstallationRef(value.installationRef);\n\tconst source = value.source === undefined ? undefined : validateSourceLabel(value.source);\n\tif (!isObject(value.state) || !hasExactKeys(value.state, [\"scope\", \"scopeRef\", \"enabled\", \"lifecycle\"]))\n\t\tthrow new Error(\"state schema is invalid\");\n\tif (value.state.scope !== \"global\" && value.state.scope !== \"project\") throw new Error(\"state scope is invalid\");\n\tconst scopeRef = validateScopeRef(value.state.scope, value.state.scopeRef);\n\tif (typeof value.state.enabled !== \"boolean\") throw new Error(\"state enabled flag is invalid\");\n\tif (\n\t\tvalue.state.lifecycle !== \"installed\" &&\n\t\tvalue.state.lifecycle !== \"active\" &&\n\t\tvalue.state.lifecycle !== \"retained\"\n\t)\n\t\tthrow new Error(\"state lifecycle is invalid\");\n\treturn Object.freeze({\n\t\tpluginId,\n\t\tpluginVersion,\n\t\tmanifestDigest,\n\t\tinstallationRef,\n\t\t...(source === undefined ? {} : { source }),\n\t\tstate: Object.freeze({\n\t\t\tscope: value.state.scope,\n\t\t\tscopeRef,\n\t\t\tenabled: value.state.enabled,\n\t\t\tlifecycle: value.state.lifecycle,\n\t\t}),\n\t});\n}\n\nfunction validateSnapshot(value: unknown): PluginStateSnapshotV1 {\n\tif (!isObject(value) || !hasExactKeys(value, [\"version\", \"records\"])) throw new Error(\"snapshot schema is invalid\");\n\tif (value.version !== PLUGIN_STATE_SNAPSHOT_VERSION_V1) throw new Error(\"snapshot version is unsupported\");\n\tif (!Array.isArray(value.records)) throw new Error(\"records must be an array\");\n\tif (value.records.length > MAX_PLUGIN_STATE_RECORDS_V1) throw new Error(\"too many plugin state records\");\n\tconst records = value.records.map(validateRecord);\n\tconst identities = new Set<string>();\n\tfor (const record of records) {\n\t\tconst identity = identityOf(record);\n\t\tif (identities.has(identity)) throw new Error(`duplicate identity: ${identity}`);\n\t\tidentities.add(identity);\n\t}\n\trecords.sort((left, right) => identityOf(left).localeCompare(identityOf(right)));\n\treturn Object.freeze({\n\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\trecords: Object.freeze(records),\n\t});\n}\n\nfunction invalidFromError(error: unknown): PluginStateDiagnosticV1 {\n\tconst message = error instanceof Error ? error.message : \"plugin state schema is invalid\";\n\tconst duplicatePrefix = \"duplicate identity: \";\n\tif (message.startsWith(duplicatePrefix))\n\t\treturn diagnostic(\"duplicate_identity\", message, message.slice(duplicatePrefix.length));\n\tif (message === \"too many plugin state records\") return diagnostic(\"too_many_records\", message);\n\tif (message === \"invalid installation reference\") return diagnostic(\"invalid_installation_ref\", message);\n\treturn diagnostic(\"invalid_schema\", message);\n}\n\nfunction defaultFileSystem(): PluginStateFileSystemV1 {\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 PluginStateDiagnosticV1[];\n} {\n\treturn Object.freeze({\n\t\tstatus: \"cancelled\",\n\t\tdiagnostics: Object.freeze([diagnostic(\"cancelled\", \"Plugin state operation was cancelled\")]),\n\t});\n}\n\nfunction sortRecords(records: readonly PluginStateRecordV1[]): readonly PluginStateRecordV1[] {\n\treturn Object.freeze([...records].sort((left, right) => identityOf(left).localeCompare(identityOf(right))));\n}\n\nfunction makeRecord(\n\tinstallation: PluginInstallationV1,\n\tscope: PluginStateScopeV1,\n\tenabled: boolean,\n\tsource?: string,\n): PluginStateRecordV1 {\n\tif (installation.version !== 1) throw new Error(\"plugin installation handle is invalid\");\n\tconst pluginId = validateString(installation.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst pluginVersion = validateString(installation.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\tconst manifestDigest = validateString(installation.manifestDigest, \"manifestDigest\");\n\tconst installationRef = validateOpaqueInstallationRef(installation.installationRef);\n\tif (scope !== \"global\" && scope !== \"project\") throw new Error(\"state scope is invalid\");\n\tif (installation.scope !== scope) throw new Error(\"installation scope does not match state scope\");\n\tconst scopeRef = validateScopeRef(\n\t\tscope,\n\t\tscope === \"global\" ? (installation.scopeRef ?? DEFAULT_GLOBAL_PLUGIN_SCOPE_REF_V1) : installation.scopeRef,\n\t);\n\tif (typeof enabled !== \"boolean\") throw new Error(\"state enabled flag is invalid\");\n\tconst sourceLabel = source === undefined ? undefined : validateSourceLabel(source);\n\treturn Object.freeze({\n\t\tpluginId,\n\t\tpluginVersion,\n\t\tmanifestDigest,\n\t\tinstallationRef,\n\t\t...(sourceLabel === undefined ? {} : { source: sourceLabel }),\n\t\tstate: Object.freeze({ scope, scopeRef, enabled, lifecycle: installation.state }),\n\t});\n}\n\nexport function createPluginStateStoreV1(options: PluginStateStoreOptionsV1): PluginStateStoreV1 {\n\tconst filePath = validateFilePath(options.filePath);\n\tconst fileSystem = options.fileSystem ?? defaultFileSystem();\n\n\tasync function read(signal?: AbortSignal): Promise<PluginStateReadResultV1> {\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 state JSON is invalid\")]),\n\t\t\t});\n\t\t}\n\t\ttry {\n\t\t\treturn Object.freeze({\n\t\t\t\tstatus: \"ok\",\n\t\t\t\tsnapshot: validateSnapshot(parsed),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn Object.freeze({\n\t\t\t\tstatus: \"invalid\",\n\t\t\t\tdiagnostics: Object.freeze([invalidFromError(error)]),\n\t\t\t});\n\t\t}\n\t}\n\n\tasync function write(snapshot: PluginStateSnapshotV1, signal?: AbortSignal): Promise<PluginStateMutationResultV1> {\n\t\tif (signal?.aborted) return cancelledResult();\n\t\tconst parent = dirname(filePath);\n\t\tconst temporaryPath = join(parent, `.${basename(filePath)}.${randomUUID()}.tmp`);\n\t\ttry {\n\t\t\tawait fileSystem.mkdir(parent);\n\t\t\tif (signal?.aborted) return cancelledResult();\n\t\t\tawait fileSystem.writeFile(temporaryPath, `${JSON.stringify(snapshot)}\\n`);\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\t// Serialize mutations made through one store instance so concurrent CLI/UI\n\t// actions cannot lose each other's read-modify-write updates.\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\tupsert: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet record: PluginStateRecordV1;\n\t\t\t\ttry {\n\t\t\t\t\trecord = makeRecord(input.installation, input.scope, input.enabled, input.source);\n\t\t\t\t} catch (error) {\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([invalidFromError(error)]),\n\t\t\t\t\t});\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 records = current.snapshot.records.filter(\n\t\t\t\t\t(candidate) => identityOf(candidate) !== identityOf(record),\n\t\t\t\t);\n\t\t\t\tif (\n\t\t\t\t\trecords.length >= MAX_PLUGIN_STATE_RECORDS_V1 &&\n\t\t\t\t\t!current.snapshot.records.some((candidate) => identityOf(candidate) === identityOf(record))\n\t\t\t\t)\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_records\", \"too many plugin state records\")]),\n\t\t\t\t\t});\n\t\t\t\tconst snapshot = Object.freeze({\n\t\t\t\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\t\t\t\trecords: sortRecords([...records, record]),\n\t\t\t\t});\n\t\t\t\treturn await write(snapshot, input.signal);\n\t\t\t}),\n\t\tremove: (input) =>\n\t\t\tenqueueMutation(async () => {\n\t\t\t\tlet pluginId: string;\n\t\t\t\tlet pluginVersion: string;\n\t\t\t\tlet scope: PluginStateScopeV1;\n\t\t\t\tlet scopeRef: string;\n\t\t\t\ttry {\n\t\t\t\t\tpluginId = validateString(input.pluginId, \"pluginId\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\t\t\t\t\tpluginVersion = validateString(input.pluginVersion, \"pluginVersion\", MAX_PLUGIN_STATE_ID_CHARS_V1);\n\t\t\t\t\tif (input.scope !== \"global\" && input.scope !== \"project\") throw new Error(\"state scope is invalid\");\n\t\t\t\t\tscope = input.scope;\n\t\t\t\t\tscopeRef = validateScopeRef(scope, input.scopeRef);\n\t\t\t\t} catch (error) {\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([invalidFromError(error)]),\n\t\t\t\t\t});\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 identity = `${scope}:${scopeRef}:${pluginId}@${pluginVersion}`;\n\t\t\t\tconst records = current.snapshot.records.filter((candidate) => identityOf(candidate) !== identity);\n\t\t\t\tif (records.length === current.snapshot.records.length)\n\t\t\t\t\treturn Object.freeze({\n\t\t\t\t\t\tstatus: \"ok\",\n\t\t\t\t\t\tsnapshot: current.snapshot,\n\t\t\t\t\t\tchanged: false,\n\t\t\t\t\t});\n\t\t\t\tconst snapshot = Object.freeze({\n\t\t\t\t\tversion: PLUGIN_STATE_SNAPSHOT_VERSION_V1,\n\t\t\t\t\trecords: sortRecords(records),\n\t\t\t\t});\n\t\t\t\treturn await write(snapshot, input.signal);\n\t\t\t}),\n\t};\n}\n"]}

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

@@ -0,0 +1,90 @@
+/**
+ * Host-independent plugin ecosystem contracts.
+ *
+ * These types describe compatibility facts only. They intentionally do not
+ * contain approval, sandbox, credential, or domain-specific policy.
+ */
+import type { CapabilityRefV1, PluginArchitecture, PluginManifestV1, PluginOperatingSystem } from "@agent-forge/plugin-sdk";
+export type { CapabilityRefV1, CapabilityRequirementV1, PluginAdapterManifestV1, PluginArchitecture, PluginManifestV1, PluginOperatingSystem, PluginPlatformBindingV1, RuntimeConstraintV1, } from "@agent-forge/plugin-sdk";
+export interface HostRuntimeFactV1 {
+    readonly name: string;
+    readonly version: string;
+}
+export interface HostAdapterFactV1 {
+    readonly id: string;
+    readonly version: string;
+    readonly os?: PluginOperatingSystem;
+    readonly arch?: PluginArchitecture;
+    readonly hostFeatures?: readonly string[];
+}
+/** Concrete facts observed by the host; no security judgement is implied. */
+export interface HostFactsV1 {
+    readonly os: Exclude<PluginOperatingSystem, "any"> | string;
+    readonly arch: Exclude<PluginArchitecture, "any"> | string;
+    readonly runtime: readonly HostRuntimeFactV1[];
+    readonly apiVersion: string;
+    readonly hostFeatures: readonly string[];
+    readonly adapters?: readonly HostAdapterFactV1[];
+}
+export type PluginResolutionStatusV1 = "installed-ready" | "installed-unavailable" | "dependency-unavailable" | "version-incompatible" | "disabled" | "manifest-missing";
+export type PluginDiagnosticCodeV1 = "unsupported-platform" | "unsupported-architecture" | "missing-runtime" | "runtime-version-incompatible" | "missing-host-feature" | "api-version-incompatible" | "host-version-incompatible" | "adapter-unavailable" | "missing-capability" | "optional-capability-unavailable" | "plugin-disabled" | "test-only-plugin" | "manifest_missing";
+export interface PluginDiagnosticV1 {
+    readonly code: PluginDiagnosticCodeV1;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, string>>;
+}
+export interface SelectedAdapterV1 {
+    readonly id: string;
+    readonly version: string;
+}
+export interface ResolvedPluginV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly capabilityRefs: readonly CapabilityRefV1[];
+    readonly selectedAdapter?: SelectedAdapterV1;
+}
+export interface PluginResolutionV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly required: boolean;
+    readonly status: PluginResolutionStatusV1;
+    readonly diagnostics: readonly PluginDiagnosticV1[];
+    readonly selectedAdapter?: SelectedAdapterV1;
+    readonly resolved?: ResolvedPluginV1;
+}
+export interface ResolvedManifestV1 {
+    readonly profileId: string;
+    readonly profileVersion: string;
+    readonly plugins: readonly ResolvedPluginV1[];
+    readonly capabilityRefs: readonly CapabilityRefV1[];
+    readonly manifestDigest: string;
+}
+export interface ProfileResolutionV1 {
+    readonly profileId: string;
+    readonly profileVersion: string;
+    readonly status: "ready" | "blocked";
+    readonly plugins: readonly PluginResolutionV1[];
+    readonly diagnostics: readonly PluginDiagnosticV1[];
+    readonly resolvedManifest: ResolvedManifestV1;
+}
+export type PluginUpdateStateV1 = "staged" | "verified" | "active";
+export interface PluginUpdateRecordV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly source: string;
+    readonly manifest: PluginManifestV1;
+    readonly manifestDigest: string;
+    readonly state: PluginUpdateStateV1;
+}
+export type PluginSourceVerifierV1 = (input: {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly source: string;
+    readonly manifestDigest: string;
+}) => {
+    readonly status: "accepted";
+} | {
+    readonly status: "rejected";
+    readonly reason?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/ecosystem/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Host-independent plugin ecosystem contracts.\n *\n * These types describe compatibility facts only. They intentionally do not\n * contain approval, sandbox, credential, or domain-specific policy.\n */\n\nimport type {\n\tCapabilityRefV1,\n\tPluginArchitecture,\n\tPluginManifestV1,\n\tPluginOperatingSystem,\n} from \"@agent-forge/plugin-sdk\";\n\n// agent-forge.json manifest schema types moved to @agent-forge/plugin-sdk\n// (D-075 S2); re-exported here so existing consumers keep resolving.\nexport type {\n\tCapabilityRefV1,\n\tCapabilityRequirementV1,\n\tPluginAdapterManifestV1,\n\tPluginArchitecture,\n\tPluginManifestV1,\n\tPluginOperatingSystem,\n\tPluginPlatformBindingV1,\n\tRuntimeConstraintV1,\n} from \"@agent-forge/plugin-sdk\";\n\nexport interface HostRuntimeFactV1 {\n\treadonly name: string;\n\treadonly version: string;\n}\n\nexport interface HostAdapterFactV1 {\n\treadonly id: string;\n\treadonly version: string;\n\treadonly os?: PluginOperatingSystem;\n\treadonly arch?: PluginArchitecture;\n\treadonly hostFeatures?: readonly string[];\n}\n\n/** Concrete facts observed by the host; no security judgement is implied. */\nexport interface HostFactsV1 {\n\treadonly os: Exclude<PluginOperatingSystem, \"any\"> | string;\n\treadonly arch: Exclude<PluginArchitecture, \"any\"> | string;\n\treadonly runtime: readonly HostRuntimeFactV1[];\n\treadonly apiVersion: string;\n\treadonly hostFeatures: readonly string[];\n\treadonly adapters?: readonly HostAdapterFactV1[];\n}\n\nexport type PluginResolutionStatusV1 =\n\t| \"installed-ready\"\n\t| \"installed-unavailable\"\n\t| \"dependency-unavailable\"\n\t| \"version-incompatible\"\n\t| \"disabled\"\n\t| \"manifest-missing\";\n\nexport type PluginDiagnosticCodeV1 =\n\t| \"unsupported-platform\"\n\t| \"unsupported-architecture\"\n\t| \"missing-runtime\"\n\t| \"runtime-version-incompatible\"\n\t| \"missing-host-feature\"\n\t| \"api-version-incompatible\"\n\t| \"host-version-incompatible\"\n\t| \"adapter-unavailable\"\n\t| \"missing-capability\"\n\t| \"optional-capability-unavailable\"\n\t| \"plugin-disabled\"\n\t| \"test-only-plugin\"\n\t| \"manifest_missing\";\n\nexport interface PluginDiagnosticV1 {\n\treadonly code: PluginDiagnosticCodeV1;\n\treadonly message: string;\n\treadonly details?: Readonly<Record<string, string>>;\n}\n\nexport interface SelectedAdapterV1 {\n\treadonly id: string;\n\treadonly version: string;\n}\n\nexport interface ResolvedPluginV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly capabilityRefs: readonly CapabilityRefV1[];\n\treadonly selectedAdapter?: SelectedAdapterV1;\n}\n\nexport interface PluginResolutionV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly required: boolean;\n\treadonly status: PluginResolutionStatusV1;\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n\treadonly selectedAdapter?: SelectedAdapterV1;\n\treadonly resolved?: ResolvedPluginV1;\n}\n\nexport interface ResolvedManifestV1 {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly plugins: readonly ResolvedPluginV1[];\n\treadonly capabilityRefs: readonly CapabilityRefV1[];\n\treadonly manifestDigest: string;\n}\n\nexport interface ProfileResolutionV1 {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly status: \"ready\" | \"blocked\";\n\treadonly plugins: readonly PluginResolutionV1[];\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n\treadonly resolvedManifest: ResolvedManifestV1;\n}\n\nexport type PluginUpdateStateV1 = \"staged\" | \"verified\" | \"active\";\n\nexport interface PluginUpdateRecordV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly source: string;\n\treadonly manifest: PluginManifestV1;\n\treadonly manifestDigest: string;\n\treadonly state: PluginUpdateStateV1;\n}\n\nexport type PluginSourceVerifierV1 = (input: {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly source: string;\n\treadonly manifestDigest: string;\n}) => { readonly status: \"accepted\" } | { readonly status: \"rejected\"; readonly reason?: string };\n"]}

package/dist/plugins/ecosystem/types.js

@@ -0,0 +1,8 @@
+/**
+ * Host-independent plugin ecosystem contracts.
+ *
+ * These types describe compatibility facts only. They intentionally do not
+ * contain approval, sandbox, credential, or domain-specific policy.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/ecosystem/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Host-independent plugin ecosystem contracts.\n *\n * These types describe compatibility facts only. They intentionally do not\n * contain approval, sandbox, credential, or domain-specific policy.\n */\n\nimport type {\n\tCapabilityRefV1,\n\tPluginArchitecture,\n\tPluginManifestV1,\n\tPluginOperatingSystem,\n} from \"@agent-forge/plugin-sdk\";\n\n// agent-forge.json manifest schema types moved to @agent-forge/plugin-sdk\n// (D-075 S2); re-exported here so existing consumers keep resolving.\nexport type {\n\tCapabilityRefV1,\n\tCapabilityRequirementV1,\n\tPluginAdapterManifestV1,\n\tPluginArchitecture,\n\tPluginManifestV1,\n\tPluginOperatingSystem,\n\tPluginPlatformBindingV1,\n\tRuntimeConstraintV1,\n} from \"@agent-forge/plugin-sdk\";\n\nexport interface HostRuntimeFactV1 {\n\treadonly name: string;\n\treadonly version: string;\n}\n\nexport interface HostAdapterFactV1 {\n\treadonly id: string;\n\treadonly version: string;\n\treadonly os?: PluginOperatingSystem;\n\treadonly arch?: PluginArchitecture;\n\treadonly hostFeatures?: readonly string[];\n}\n\n/** Concrete facts observed by the host; no security judgement is implied. */\nexport interface HostFactsV1 {\n\treadonly os: Exclude<PluginOperatingSystem, \"any\"> | string;\n\treadonly arch: Exclude<PluginArchitecture, \"any\"> | string;\n\treadonly runtime: readonly HostRuntimeFactV1[];\n\treadonly apiVersion: string;\n\treadonly hostFeatures: readonly string[];\n\treadonly adapters?: readonly HostAdapterFactV1[];\n}\n\nexport type PluginResolutionStatusV1 =\n\t| \"installed-ready\"\n\t| \"installed-unavailable\"\n\t| \"dependency-unavailable\"\n\t| \"version-incompatible\"\n\t| \"disabled\"\n\t| \"manifest-missing\";\n\nexport type PluginDiagnosticCodeV1 =\n\t| \"unsupported-platform\"\n\t| \"unsupported-architecture\"\n\t| \"missing-runtime\"\n\t| \"runtime-version-incompatible\"\n\t| \"missing-host-feature\"\n\t| \"api-version-incompatible\"\n\t| \"host-version-incompatible\"\n\t| \"adapter-unavailable\"\n\t| \"missing-capability\"\n\t| \"optional-capability-unavailable\"\n\t| \"plugin-disabled\"\n\t| \"test-only-plugin\"\n\t| \"manifest_missing\";\n\nexport interface PluginDiagnosticV1 {\n\treadonly code: PluginDiagnosticCodeV1;\n\treadonly message: string;\n\treadonly details?: Readonly<Record<string, string>>;\n}\n\nexport interface SelectedAdapterV1 {\n\treadonly id: string;\n\treadonly version: string;\n}\n\nexport interface ResolvedPluginV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly capabilityRefs: readonly CapabilityRefV1[];\n\treadonly selectedAdapter?: SelectedAdapterV1;\n}\n\nexport interface PluginResolutionV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly required: boolean;\n\treadonly status: PluginResolutionStatusV1;\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n\treadonly selectedAdapter?: SelectedAdapterV1;\n\treadonly resolved?: ResolvedPluginV1;\n}\n\nexport interface ResolvedManifestV1 {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly plugins: readonly ResolvedPluginV1[];\n\treadonly capabilityRefs: readonly CapabilityRefV1[];\n\treadonly manifestDigest: string;\n}\n\nexport interface ProfileResolutionV1 {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\treadonly status: \"ready\" | \"blocked\";\n\treadonly plugins: readonly PluginResolutionV1[];\n\treadonly diagnostics: readonly PluginDiagnosticV1[];\n\treadonly resolvedManifest: ResolvedManifestV1;\n}\n\nexport type PluginUpdateStateV1 = \"staged\" | \"verified\" | \"active\";\n\nexport interface PluginUpdateRecordV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly source: string;\n\treadonly manifest: PluginManifestV1;\n\treadonly manifestDigest: string;\n\treadonly state: PluginUpdateStateV1;\n}\n\nexport type PluginSourceVerifierV1 = (input: {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly source: string;\n\treadonly manifestDigest: string;\n}) => { readonly status: \"accepted\" } | { readonly status: \"rejected\"; readonly reason?: string };\n"]}