@moorline/core 0.0.1

package/dist/core/extension/packages/npmRegistryClient.js

@@ -0,0 +1,261 @@
+import semver from 'semver';
+import { validatePackageId } from '../../../types/package.js';
+import { findPackageRegistryBlock } from './packageRegistryBlocklist.js';
+const DEFAULT_NPM_REGISTRY_URL = 'https://registry.npmjs.org';
+const DEFAULT_FETCH_TIMEOUT_MS = 10_000;
+const DEFAULT_MAX_SEARCH_RESULTS = 20;
+const MOORLINE_KEYWORD = 'moorline-package';
+function normalizeRegistryUrl(raw) {
+    return (raw ?? process.env.MOORLINE_NPM_REGISTRY_URL ?? DEFAULT_NPM_REGISTRY_URL).replace(/\/+$/u, '');
+}
+function scopedNpmPackageName(name) {
+    return typeof name === 'string' && /^@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*$/u.test(name);
+}
+function packageIdKeyword(packageId) {
+    return `moorline-id-${packageId.replace('/', '-')}`;
+}
+function packageNamespace(packageId) {
+    return packageId.split('/')[0] ?? '';
+}
+function isPackageKind(value) {
+    return value === 'api-adapter' || value === 'transport' || value === 'provider' || value === 'plugin' || value === 'skill' || value === 'bundle';
+}
+function parseMoorlineMetadata(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    const record = value;
+    if (record.schemaVersion !== 1 || !isPackageKind(record.kind)) {
+        return null;
+    }
+    if (typeof record.packageId !== 'string' || typeof record.manifestPath !== 'string' || typeof record.distroPath !== 'string') {
+        return null;
+    }
+    try {
+        validatePackageId(record.packageId, 'package.json.moorline.packageId');
+    }
+    catch {
+        return null;
+    }
+    return {
+        schemaVersion: 1,
+        packageId: record.packageId,
+        kind: record.kind,
+        manifestPath: record.manifestPath,
+        distroPath: record.distroPath
+    };
+}
+function metadataKeywords(metadata, packageMetadata) {
+    return [...new Set([...(metadata.keywords ?? []), ...(packageMetadata?.keywords ?? [])])];
+}
+function allowUnverifiedNpmPackages() {
+    return process.env.MOORLINE_ALLOW_UNVERIFIED_NPM_PACKAGE === '1';
+}
+function publisherFromPackageName(npmName) {
+    const scope = npmName.split('/')[0]?.replace(/^@/u, '');
+    return scope === 'moorline' ? 'Moorline' : scope || 'Unknown';
+}
+function displayNameFromPackageId(packageId) {
+    const name = packageId.split('/')[1] ?? packageId;
+    return name
+        .split(/[-_]/u)
+        .filter(Boolean)
+        .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
+        .join(' ');
+}
+function officialNpmNameMatchesPackageId(npmName, packageId) {
+    const expectedName = npmNameForOfficialPackageId(packageId);
+    return expectedName !== null && npmName === expectedName;
+}
+function sourceForNpm(input) {
+    return {
+        kind: 'remote_archive',
+        url: input.tarball,
+        ...(input.integrity ? { integrity: input.integrity } : {}),
+        provenance: {
+            type: 'npm',
+            registryUrl: input.registryUrl,
+            packageName: input.npmName,
+            version: input.version,
+            ...(input.integrity ? { integrity: input.integrity } : {})
+        }
+    };
+}
+export class NpmRegistryClient {
+    registryUrl;
+    fetchTimeoutMs;
+    maxSearchResults;
+    constructor(options = {}) {
+        this.registryUrl = normalizeRegistryUrl(options.registryUrl);
+        this.fetchTimeoutMs = options.fetchTimeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;
+        this.maxSearchResults = options.maxSearchResults ?? DEFAULT_MAX_SEARCH_RESULTS;
+    }
+    async search(input = {}) {
+        const query = [MOORLINE_KEYWORD, input.query?.trim()].filter(Boolean).join(' ');
+        const url = new URL(`${this.registryUrl}/-/v1/search`);
+        url.searchParams.set('text', query);
+        url.searchParams.set('size', String(input.size ?? this.maxSearchResults));
+        url.searchParams.set('from', String(input.from ?? 0));
+        const search = await this.fetchJson(url.toString());
+        const entries = await Promise.all((search.objects ?? []).map(async (object) => {
+            const packageName = object.package?.name;
+            if (!scopedNpmPackageName(packageName)) {
+                return null;
+            }
+            try {
+                return await this.getByNpmPackage(packageName, object.package?.version, object);
+            }
+            catch {
+                return null;
+            }
+        }));
+        return entries
+            .filter((entry) => Boolean(entry))
+            .filter((entry) => !input.kind || entry.kind === input.kind);
+    }
+    async findByPackageId(input) {
+        const keyword = packageIdKeyword(input.packageId);
+        const entries = await this.search({
+            query: keyword,
+            kind: input.kind,
+            size: this.maxSearchResults
+        });
+        return entries.filter((entry) => entry.packageId === input.packageId && (!input.kind || entry.kind === input.kind));
+    }
+    async getByNpmPackage(npmName, versionHint, searchObject) {
+        const packageMetadata = await this.fetchPackageMetadata(npmName);
+        const version = this.resolveVersion(packageMetadata, versionHint);
+        const versionMetadata = packageMetadata.versions?.[version];
+        if (!versionMetadata) {
+            return null;
+        }
+        return this.convertVersionMetadata({
+            npmName,
+            packageMetadata,
+            versionMetadata,
+            searchObject
+        });
+    }
+    async fetchPackageMetadata(npmName) {
+        const encoded = npmName.startsWith('@') ? npmName.replace('/', '%2f') : encodeURIComponent(npmName);
+        return await this.fetchJson(`${this.registryUrl}/${encoded}`);
+    }
+    resolveVersion(metadata, versionHint) {
+        if (versionHint && metadata.versions?.[versionHint]) {
+            return versionHint;
+        }
+        const latest = metadata['dist-tags']?.latest;
+        if (latest && metadata.versions?.[latest]) {
+            return latest;
+        }
+        const versions = Object.keys(metadata.versions ?? {}).filter((version) => semver.valid(version));
+        const resolved = versions.sort(semver.rcompare)[0];
+        if (!resolved) {
+            throw new Error(`npm package ${metadata.name ?? '<unknown>'} has no valid versions.`);
+        }
+        return resolved;
+    }
+    convertVersionMetadata(input) {
+        const npmName = input.npmName;
+        if (!scopedNpmPackageName(npmName)) {
+            return null;
+        }
+        const moorline = parseMoorlineMetadata(input.versionMetadata.moorline);
+        if (!moorline) {
+            return null;
+        }
+        if (npmName.startsWith('@moorline/') && !officialNpmNameMatchesPackageId(npmName, moorline.packageId)) {
+            return null;
+        }
+        if (moorline.packageId.startsWith('official/') && !officialNpmNameMatchesPackageId(npmName, moorline.packageId)) {
+            return null;
+        }
+        if (findPackageRegistryBlock({ packageId: moorline.packageId, npmName })) {
+            return null;
+        }
+        const keywords = metadataKeywords(input.versionMetadata, input.packageMetadata);
+        const requiredKeywords = [
+            MOORLINE_KEYWORD,
+            `moorline-kind-${moorline.kind}`,
+            `moorline-namespace-${packageNamespace(moorline.packageId)}`,
+            packageIdKeyword(moorline.packageId)
+        ];
+        if (!requiredKeywords.every((keyword) => keywords.includes(keyword))) {
+            return null;
+        }
+        const version = input.versionMetadata.version;
+        if (!version || !semver.valid(version)) {
+            return null;
+        }
+        const tarball = input.versionMetadata.dist?.tarball;
+        const integrity = input.versionMetadata.dist?.integrity;
+        if (!tarball || (!integrity && !allowUnverifiedNpmPackages())) {
+            return null;
+        }
+        const trustLevel = officialNpmNameMatchesPackageId(npmName, moorline.packageId)
+            ? 'official'
+            : 'community';
+        const description = input.versionMetadata.description ?? input.packageMetadata.description ?? moorline.packageId;
+        return {
+            schemaVersion: 1,
+            kind: moorline.kind,
+            surface: moorline.kind,
+            packageId: moorline.packageId,
+            name: displayNameFromPackageId(moorline.packageId),
+            description,
+            version,
+            recommendedForSetup: false,
+            tags: keywords.filter((keyword) => !keyword.startsWith('moorline-')).sort(),
+            source: sourceForNpm({
+                registryUrl: this.registryUrl,
+                npmName,
+                version,
+                tarball,
+                ...(integrity ? { integrity } : {})
+            }),
+            requires: [],
+            ...(moorline.kind === 'bundle' ? { members: [] } : {}),
+            trustLevel,
+            registrySource: 'npm',
+            publisher: publisherFromPackageName(npmName),
+            npm: {
+                registryUrl: this.registryUrl,
+                packageName: npmName,
+                version,
+                ...(integrity ? { integrity } : {}),
+                npmUrl: `https://www.npmjs.com/package/${encodeURIComponent(npmName)}`,
+                ...(input.searchObject?.downloads ? { downloads: input.searchObject.downloads } : {}),
+                ...(input.searchObject?.updated ?? input.packageMetadata.time?.[version]
+                    ? { updatedAt: input.searchObject?.updated ?? input.packageMetadata.time?.[version] }
+                    : {})
+            }
+        };
+    }
+    async fetchJson(url) {
+        const controller = new globalThis.AbortController();
+        const timeout = globalThis.setTimeout(() => controller.abort(), this.fetchTimeoutMs);
+        try {
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    accept: 'application/json'
+                }
+            });
+            if (!response.ok) {
+                throw new Error(`npm registry request failed: ${response.status} ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        finally {
+            globalThis.clearTimeout(timeout);
+        }
+    }
+}
+export function npmNameForOfficialPackageId(packageId) {
+    const [namespace, name] = packageId.split('/');
+    if (namespace !== 'official' || !name) {
+        return null;
+    }
+    return `@moorline/${name}`;
+}
+//# sourceMappingURL=npmRegistryClient.js.map

package/dist/core/extension/packages/npmRegistryClient.js.map

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

package/dist/core/extension/packages/officialArchiveResolver.d.ts

@@ -0,0 +1,2 @@
+import type { PackageSourceDescriptor } from '../../../types/package.js';
+export declare function tryResolveBundledOfficialPackage(source: PackageSourceDescriptor): string | null;

package/dist/core/extension/packages/officialArchiveResolver.js

@@ -0,0 +1,51 @@
+import { readdirSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { detectMoorlineRuntimeMode, resolveMoorlineAssetRoot } from '../../system/release/releaseArtifacts.js';
+function findArchiveByBasename(root, archiveName) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        const stat = statSync(current, { throwIfNoEntry: false });
+        if (!stat?.isDirectory()) {
+            continue;
+        }
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            const child = join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(child);
+                continue;
+            }
+            if (entry.isFile() && entry.name === archiveName) {
+                return child;
+            }
+        }
+    }
+    return null;
+}
+function findInstallableArchive(assetRoot, archiveName) {
+    return (findArchiveByBasename(join(assetRoot, 'installable-archives'), archiveName) ??
+        findArchiveByBasename(join(assetRoot, 'dist', 'installable-archives'), archiveName));
+}
+function isOfficialReleaseArchiveUrl(url) {
+    return /^https:\/\/github\.com\/Moorline\/(?:moorline|packages)\/releases\/download\//u.test(url);
+}
+export function tryResolveBundledOfficialPackage(source) {
+    if (source.kind !== 'remote_archive' || !isOfficialReleaseArchiveUrl(source.url)) {
+        return null;
+    }
+    if (detectMoorlineRuntimeMode(import.meta.url) === 'packaged_release') {
+        return null;
+    }
+    try {
+        const assetRoot = resolveMoorlineAssetRoot(import.meta.url);
+        const archiveName = basename(new URL(source.url).pathname);
+        return findInstallableArchive(assetRoot, archiveName);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=officialArchiveResolver.js.map

package/dist/core/extension/packages/officialArchiveResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"officialArchiveResolver.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/packages/officialArchiveResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,0CAA0C,CAAC;AAElD,SAAS,qBAAqB,CAAC,IAAY,EAAE,WAAmB;IAC9D,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACjD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAiB,EAAE,WAAmB;IACpE,OAAO,CACL,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,WAAW,CAAC;QAC3E,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,WAAW,CAAC,CACpF,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAW;IAC9C,OAAO,gFAAgF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,MAA+B;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,yBAAyB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,kBAAkB,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/extension/packages/officialCatalog.d.ts

@@ -0,0 +1,9 @@
+import type { PackageCatalogEntry, PackageKind } from '../../../types/package.js';
+export declare function getOfficialCatalog(): PackageCatalogEntry[];
+export declare function assertOfficialCatalogChecksums(input?: {
+    kind?: PackageKind;
+    surface?: PackageKind;
+    packageId?: string;
+}): void;
+export declare const OFFICIAL_CATALOG: PackageCatalogEntry[];
+export declare function findOfficialCatalogEntry(surface: PackageKind, packageId: string): (typeof OFFICIAL_CATALOG)[number] | null;

package/dist/core/extension/packages/officialCatalog.js

@@ -0,0 +1,198 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { detectMoorlineRuntimeMode, loadOfficialCatalogResource, resolveMoorlineAssetRoot } from '../../system/release/releaseArtifacts.js';
+import { discoverOfficialPackageMetadata } from './packageDistroMetadata.js';
+import { assertValidPackageRange, assertValidPackageVersion } from './packageVersionResolver.js';
+const RELEASE_BASE_URL = 'https://github.com/Moorline/moorline/releases/download';
+function archiveFileName(surface, sourceSubdir, version) {
+    const relativeSource = sourceSubdir
+        .replace(/^packages\//u, '')
+        .replace(new RegExp(`^${surface}s/`, 'u'), '');
+    return `moorline-${surface}-${relativeSource.replaceAll('/', '-')}-${version}.tar.gz`;
+}
+function releaseArchiveSource(surface, sourceSubdir, version, ref, sha256) {
+    return {
+        kind: 'remote_archive',
+        url: `${RELEASE_BASE_URL}/${ref}/${archiveFileName(surface, sourceSubdir, version)}`,
+        ...(sha256 ? { sha256 } : {})
+    };
+}
+function suggestedAfterInstall(catalog, surface, packageId) {
+    if (surface !== 'transport') {
+        return [];
+    }
+    return catalog
+        .filter((entry) => entry.surface === 'plugin' &&
+        entry.requires.includes(packageId))
+        .map((entry) => entry.packageId)
+        .sort();
+}
+function resolveInstallableArchiveRoot(assetRoot) {
+    const roots = [
+        assetRoot,
+        join(assetRoot, '..'),
+        join(assetRoot, '..', '..')
+    ];
+    for (const root of roots) {
+        const direct = join(root, 'installable-archives');
+        if (existsSync(direct)) {
+            return direct;
+        }
+        const dist = join(root, 'dist', 'installable-archives');
+        if (existsSync(dist)) {
+            return dist;
+        }
+    }
+    return join(assetRoot, 'dist', 'installable-archives');
+}
+function findArchiveByBasename(root, archiveName) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        const stat = statSync(current, { throwIfNoEntry: false });
+        if (!stat?.isDirectory()) {
+            continue;
+        }
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            const child = join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(child);
+                continue;
+            }
+            if (entry.isFile() && entry.name === archiveName) {
+                return child;
+            }
+        }
+    }
+    return null;
+}
+function ensureLocalArchiveSha(assetRoot, surface, sourceSubdir, version) {
+    const archiveName = basename(archiveFileName(surface, sourceSubdir, version));
+    const archiveRoot = resolveInstallableArchiveRoot(assetRoot);
+    const path = findArchiveByBasename(archiveRoot, archiveName);
+    if (!path || !existsSync(path)) {
+        return undefined;
+    }
+    return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+function allowMissingRecommendedChecksums() {
+    return process.env.MOORLINE_ALLOW_MISSING_RECOMMENDED_CHECKSUMS === '1';
+}
+function assertRecommendedChecksumPresent(input) {
+    if (!input.recommendedForSetup) {
+        return;
+    }
+    if (input.sha256 && input.sha256.length > 0) {
+        return;
+    }
+    if (allowMissingRecommendedChecksums()) {
+        return;
+    }
+    throw new Error(`Recommended official package ${input.packageId} is missing a sha256 checksum. ` +
+        'Build installable archives first or set MOORLINE_ALLOW_MISSING_RECOMMENDED_CHECKSUMS=1 for local development only.');
+}
+function buildSourceCatalog(assetRoot) {
+    const discoveredCatalog = discoverOfficialPackageMetadata().map((entry) => {
+        const explicitlyRecommendedForSetup = entry.distro.distribution?.recommendedForSetup === true;
+        const recommendedForSetup = explicitlyRecommendedForSetup;
+        const recommendedRef = entry.distro.release?.recommendedRef;
+        if (explicitlyRecommendedForSetup && !recommendedRef) {
+            throw new Error(`Recommended official package ${entry.packageId} is missing release.recommendedRef`);
+        }
+        const releaseRef = recommendedForSetup ? recommendedRef ?? 'v0.0.1' : 'v0.0.1';
+        const sha256 = ensureLocalArchiveSha(assetRoot, entry.surface, entry.sourceSubdir, entry.distro.display.version);
+        return {
+            kind: entry.surface,
+            surface: entry.surface,
+            packageId: entry.packageId,
+            name: entry.distro.display.name,
+            description: entry.distro.display.description,
+            version: entry.distro.display.version,
+            recommendedForSetup,
+            tags: entry.distro.display.tags ?? [],
+            source: releaseArchiveSource(entry.surface, entry.sourceSubdir, entry.distro.display.version, releaseRef, sha256),
+            requires: ('dependencies' in entry.manifest ? entry.manifest.dependencies ?? [] : []).map((dependency) => dependency.packageId),
+            ...('members' in entry.manifest ? { members: entry.manifest.members } : {})
+        };
+    });
+    return discoveredCatalog.map((entry) => ({
+        ...entry,
+        ...(suggestedAfterInstall(discoveredCatalog, entry.surface, entry.packageId).length > 0
+            ? { suggestedAfterInstall: suggestedAfterInstall(discoveredCatalog, entry.surface, entry.packageId) }
+            : {})
+    }));
+}
+function validateCatalogVersions(catalog) {
+    for (const entry of catalog) {
+        assertValidPackageVersion({ packageId: entry.packageId, version: entry.version });
+        for (const member of entry.members ?? []) {
+            assertValidPackageRange({ packageId: member.packageId, range: member.version });
+        }
+    }
+    return catalog;
+}
+function loadCatalog() {
+    const assetRoot = resolveMoorlineAssetRoot(import.meta.url);
+    const runtimeMode = detectMoorlineRuntimeMode(import.meta.url);
+    const resourceCatalog = process.env.MOORLINE_IGNORE_OFFICIAL_CATALOG_RESOURCE === '1'
+        ? null
+        : loadOfficialCatalogResource(assetRoot, runtimeMode);
+    if (resourceCatalog && resourceCatalog.length > 0) {
+        return validateCatalogVersions(resourceCatalog.map((entry) => ({
+            ...entry,
+            kind: entry.kind ?? entry.surface
+        })));
+    }
+    return validateCatalogVersions(buildSourceCatalog(assetRoot));
+}
+let cachedCatalog = null;
+function loadCachedCatalog() {
+    if (cachedCatalog) {
+        return cachedCatalog;
+    }
+    cachedCatalog = loadCatalog();
+    return cachedCatalog;
+}
+export function getOfficialCatalog() {
+    return loadCachedCatalog();
+}
+export function assertOfficialCatalogChecksums(input) {
+    const catalog = loadCachedCatalog();
+    const entries = (input?.kind ?? input?.surface) && input.packageId
+        ? catalog.filter((entry) => entry.kind === (input.kind ?? input.surface) && entry.packageId === input.packageId)
+        : catalog.filter((entry) => entry.recommendedForSetup);
+    for (const entry of entries) {
+        if (entry.source.kind !== 'remote_archive') {
+            assertRecommendedChecksumPresent({
+                packageId: entry.packageId,
+                recommendedForSetup: entry.recommendedForSetup,
+                sha256: undefined
+            });
+            continue;
+        }
+        assertRecommendedChecksumPresent({
+            packageId: entry.packageId,
+            recommendedForSetup: entry.recommendedForSetup,
+            sha256: entry.source.sha256
+        });
+    }
+}
+const officialCatalogProxyHandler = {
+    get(_target, property) {
+        const catalog = loadCachedCatalog();
+        const value = Reflect.get(catalog, property, catalog);
+        if (typeof value === 'function') {
+            return value.bind(catalog);
+        }
+        return value;
+    }
+};
+export const OFFICIAL_CATALOG = new Proxy([], officialCatalogProxyHandler);
+export function findOfficialCatalogEntry(surface, packageId) {
+    return loadCachedCatalog().find((entry) => entry.kind === surface && entry.packageId === packageId) ?? null;
+}
+//# sourceMappingURL=officialCatalog.js.map

package/dist/core/extension/packages/officialCatalog.js.map

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

package/dist/core/extension/packages/packageActivation.d.ts

@@ -0,0 +1,21 @@
+import type { MoorlineConfig } from '../../../types/config.js';
+import type { PackageAppliedState, PackageInstallRecord, PackageRef, PackageSurface } from '../../../types/package.js';
+export declare function packageKey(ref: PackageRef): string;
+export declare function samePackageRef(left: PackageRef, right: PackageRef): boolean;
+export declare function sortPackageRefs(refs: PackageRef[]): PackageRef[];
+export declare function uniquePackageRefs(refs: PackageRef[]): PackageRef[];
+export declare function activatedPackageRefsFromLegacyState(input: {
+    transportActivePackageId?: string | null;
+    providerActivePackageId?: string | null;
+    enabledPluginPackageIds?: string[];
+    enabledSkillPackageIds?: string[];
+    apiAdapterActivePackageId?: string | null;
+}): PackageRef[];
+export declare function desiredPackageRefsFromConfig(config: MoorlineConfig): PackageRef[];
+export declare function appliedPackageRefs(state: PackageAppliedState): PackageRef[];
+export declare function isPackageActivated(refs: PackageRef[], ref: PackageRef): boolean;
+export declare function isBuiltInActivatedPackage(ref: Pick<PackageRef, 'surface' | 'packageId'>): boolean;
+export declare function packageActivationUniqueKey(surface: PackageSurface, record?: Pick<PackageInstallRecord, 'surface' | 'activation'>): string | null;
+export declare function activatedPackageForUniqueKey(refs: PackageRef[], uniqueKey: string): PackageRef | null;
+export declare function activatePackageRef(refs: PackageRef[], ref: PackageRef): PackageRef[];
+export declare function deactivatePackageRef(refs: PackageRef[], ref: PackageRef): PackageRef[];