@lesliechan721/aw 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/src/utils/catalog-generation-store.js

@@ -0,0 +1,251 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_STORE_DIRECTORY, CATALOG_STORE_METADATA_FILE } from '../constants.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { validateCatalogSnapshotTransport } from './catalog-snapshot.js';
+import { normalizeAwCapabilities, parseStrictSemVer } from './manifest.js';
+import { canonicalizePathThroughExistingAncestorSync, ensureRegularDirectoryPath, resolveAwHome, } from './state-paths.js';
+const DIGEST_PATTERN = /^sha256:([0-9a-f]{64})$/u;
+function metadataError(message, cause) {
+    return new CatalogGenerationError({
+        code: 'catalogGenerationMetadataInvalid',
+        message: `${message} Remove the damaged store entry and run aw catalog source sync.`,
+        cause,
+    });
+}
+function digestHex(value, name) {
+    const match = DIGEST_PATTERN.exec(value);
+    if (!match)
+        throw metadataError(`Invalid ${name}: expected a SHA-256 digest.`);
+    return match[1];
+}
+function logicalIdentitySegment(value) {
+    if (typeof value !== 'string' || value.trim() === '' || value !== value.trim()) {
+        throw metadataError('Invalid Catalog logical identity.');
+    }
+    try {
+        if (value === '.')
+            return '%2E';
+        if (value === '..')
+            return '%2E%2E';
+        const segment = encodeURIComponent(value);
+        if (segment === '.' || segment === '..' || /[\\/]/u.test(segment)) {
+            throw metadataError('Invalid Catalog logical identity.');
+        }
+        return segment;
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw metadataError('Invalid Catalog logical identity.', error);
+    }
+}
+function resolveStrictStoreDescendant(storeRootDir, ...segments) {
+    const candidate = path.resolve(storeRootDir, ...segments);
+    const relative = path.relative(storeRootDir, candidate);
+    if (relative === ''
+        || path.isAbsolute(relative)
+        || relative === '..'
+        || relative.startsWith(`..${path.sep}`))
+        throw metadataError('Invalid Catalog store path.');
+    return candidate;
+}
+export function createCatalogStoreKey(logicalIdentity, snapshotDigest) {
+    return `${logicalIdentitySegment(logicalIdentity)}/${digestHex(snapshotDigest, 'snapshot digest')}`;
+}
+export function resolveCatalogStoreLocation(options) {
+    const awHomeDir = canonicalizePathThroughExistingAncestorSync(resolveAwHome(options.env ?? process.env));
+    const storeRootDir = path.join(awHomeDir, CATALOG_STORE_DIRECTORY);
+    const logicalIdentity = logicalIdentitySegment(options.logicalIdentity);
+    const digest = digestHex(options.snapshotDigest, 'snapshot digest');
+    const storeKey = `${logicalIdentity}/${digest}`;
+    const logicalIdentityDirectory = resolveStrictStoreDescendant(storeRootDir, logicalIdentity);
+    const entryDir = resolveStrictStoreDescendant(storeRootDir, logicalIdentity, digest);
+    return {
+        awHomeDir,
+        storeRootDir,
+        logicalIdentityDirectory,
+        entryDir,
+        metadataPath: path.join(entryDir, CATALOG_STORE_METADATA_FILE),
+        snapshotRoot: path.join(entryDir, 'snapshot'),
+        storeKey,
+    };
+}
+function strictRecord(value, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const actual = Object.keys(value).sort();
+    const expected = [...keys].sort();
+    return actual.length === expected.length
+        && actual.every((key, index) => key === expected[index]);
+}
+function parseMetadata(value) {
+    if (!strictRecord(value, [
+        'schemaVersion', 'logicalIdentity', 'catalogVersion', 'channel', 'manifestDigest',
+        'snapshotDigest', 'requiredAwCapabilities',
+    ]))
+        throw metadataError('Invalid Catalog store metadata.');
+    if (value.schemaVersion !== 1
+        || typeof value.logicalIdentity !== 'string'
+        || value.logicalIdentity.trim() === ''
+        || value.logicalIdentity !== value.logicalIdentity.trim()
+        || typeof value.catalogVersion !== 'string'
+        || (value.channel !== 'latest' && value.channel !== 'beta')
+        || typeof value.manifestDigest !== 'string'
+        || !DIGEST_PATTERN.test(value.manifestDigest)
+        || typeof value.snapshotDigest !== 'string'
+        || !DIGEST_PATTERN.test(value.snapshotDigest)
+        || !Array.isArray(value.requiredAwCapabilities)
+        || value.requiredAwCapabilities.some((entry) => typeof entry !== 'string'))
+        throw metadataError('Invalid Catalog store metadata.');
+    try {
+        parseStrictSemVer(value.catalogVersion, 'Catalog store catalogVersion');
+        if (JSON.stringify(normalizeAwCapabilities(value.requiredAwCapabilities))
+            !== JSON.stringify(value.requiredAwCapabilities)) {
+            throw new Error('Capabilities are not normalized.');
+        }
+    }
+    catch (error) {
+        throw metadataError('Invalid Catalog store metadata.', error);
+    }
+    return value;
+}
+export async function readCatalogSnapshotLogicalIdentity(snapshotRoot) {
+    try {
+        const markerPath = path.join(snapshotRoot, '.aw-generated.json');
+        const stat = await fs.lstat(markerPath).catch((error) => {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        });
+        if (!stat?.isFile() || stat.isSymbolicLink())
+            throw metadataError('Catalog marker is missing or unsafe.');
+        const marker = await fs.readJson(markerPath);
+        if (!strictRecord(marker, ['schemaVersion', 'kind', 'workspaceIdentity', 'sourceIdentity'])
+            || marker.schemaVersion !== 1
+            || marker.kind !== 'catalog'
+            || typeof marker.workspaceIdentity !== 'string'
+            || marker.workspaceIdentity.trim() === '') {
+            throw metadataError('Catalog marker is invalid.');
+        }
+        return marker.workspaceIdentity;
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw metadataError('Catalog marker is unreadable.', error);
+    }
+}
+async function validateEntry(options) {
+    try {
+        const stat = await fs.lstat(options.location.entryDir).catch((error) => {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        });
+        if (!stat?.isDirectory() || stat.isSymbolicLink())
+            throw metadataError('Catalog store entry is missing or unsafe.');
+        const metadataStat = await fs.lstat(options.location.metadataPath).catch((error) => error.code === 'ENOENT' ? null : Promise.reject(error));
+        if (!metadataStat?.isFile() || metadataStat.isSymbolicLink()) {
+            throw metadataError('Catalog store metadata is missing or unsafe.');
+        }
+        const metadata = parseMetadata(await fs.readJson(options.location.metadataPath));
+        const validation = await validateCatalogSnapshotTransport(options.location.snapshotRoot)
+            .catch((error) => { throw metadataError('Catalog store snapshot is damaged.', error); });
+        if (createCatalogStoreKey(metadata.logicalIdentity, metadata.snapshotDigest) !== options.location.storeKey
+            || validation.manifestDigest !== metadata.manifestDigest
+            || validation.snapshotDigest !== metadata.snapshotDigest
+            || validation.manifest.catalogVersion !== metadata.catalogVersion
+            || validation.manifest.channel !== metadata.channel
+            || JSON.stringify(normalizeAwCapabilities(validation.manifest.requires.aw.capabilities ?? []))
+                !== JSON.stringify(metadata.requiredAwCapabilities)
+            || await readCatalogSnapshotLogicalIdentity(options.location.snapshotRoot) !== metadata.logicalIdentity)
+            throw metadataError('Catalog store content does not match its immutable identity.');
+        return {
+            entryDir: options.location.entryDir,
+            snapshotRoot: options.location.snapshotRoot,
+            metadata,
+            manifest: validation.manifest,
+            reused: true,
+        };
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw metadataError('Catalog store entry is unreadable.', error);
+    }
+}
+export async function publishCatalogStoreEntry(options) {
+    options.signal?.throwIfAborted();
+    const logicalIdentity = await readCatalogSnapshotLogicalIdentity(options.resolution.rootDir);
+    const location = resolveCatalogStoreLocation({
+        logicalIdentity,
+        snapshotDigest: options.resolution.snapshotDigest,
+        env: options.env,
+    });
+    await ensureRegularDirectoryPath(location.storeRootDir, 'Catalog store');
+    await ensureRegularDirectoryPath(location.logicalIdentityDirectory, 'Catalog logical identity store');
+    if (await fs.pathExists(location.entryDir))
+        return validateEntry({ location });
+    const stagingDir = resolveStrictStoreDescendant(location.storeRootDir, path.basename(location.logicalIdentityDirectory), `.staging-${crypto.randomUUID()}.tmp`);
+    try {
+        await fs.mkdir(stagingDir);
+        const snapshotRoot = path.join(stagingDir, 'snapshot');
+        await fs.copy(options.resolution.rootDir, snapshotRoot, {
+            dereference: false,
+            preserveTimestamps: true,
+            filter: () => {
+                options.signal?.throwIfAborted();
+                return true;
+            },
+        });
+        const validation = await validateCatalogSnapshotTransport(snapshotRoot);
+        if (validation.manifestDigest !== options.resolution.manifestDigest
+            || validation.snapshotDigest !== options.resolution.snapshotDigest
+            || await readCatalogSnapshotLogicalIdentity(snapshotRoot) !== logicalIdentity)
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationPublishFailed',
+                sourceId: options.resolution.sourceId,
+                message: `Catalog source "${options.resolution.sourceId}" changed before store publication. Run source sync again.`,
+            });
+        const metadata = {
+            schemaVersion: 1,
+            logicalIdentity,
+            catalogVersion: validation.manifest.catalogVersion,
+            channel: validation.manifest.channel,
+            manifestDigest: validation.manifestDigest,
+            snapshotDigest: validation.snapshotDigest,
+            requiredAwCapabilities: normalizeAwCapabilities(validation.manifest.requires.aw.capabilities ?? []),
+        };
+        await fs.writeFile(path.join(stagingDir, CATALOG_STORE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+        options.signal?.throwIfAborted();
+        try {
+            await fs.rename(stagingDir, location.entryDir);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'EEXIST' && code !== 'ENOTEMPTY')
+                throw error;
+            return validateEntry({ location });
+        }
+        return { entryDir: location.entryDir, snapshotRoot: location.snapshotRoot, metadata, manifest: validation.manifest, reused: false };
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationPublishFailed',
+            sourceId: options.resolution.sourceId,
+            message: `Cannot publish Catalog store entry for source "${options.resolution.sourceId}". The previous Active entry is unchanged.`,
+            cause: error,
+        });
+    }
+    finally {
+        await fs.remove(stagingDir).catch(() => undefined);
+    }
+}
+export async function readCatalogStoreEntry(options) {
+    return validateEntry({ location: resolveCatalogStoreLocation(options) });
+}
+//# sourceMappingURL=catalog-generation-store.js.map

package/dist/src/utils/catalog-generation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generation-store.js","sourceRoot":"","sources":["../../../src/utils/catalog-generation-store.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/catalog-manifest-v6.d.ts

@@ -0,0 +1,5 @@
+import type { CatalogManifestV6, CatalogManifestV6Entry, PluginMeta } from '../types.js';
+export declare const CATALOG_SCHEMA_6_CAPABILITY = "aw.catalog-snapshot.v6";
+export declare function validateCatalogManifestV6(rawManifest: unknown): CatalogManifestV6;
+export declare function createCatalogManifestV6(manifest: Omit<CatalogManifestV6, 'schemaVersion'>): CatalogManifestV6;
+export declare function createCatalogManifestV6Entry(plugin: PluginMeta, pluginRoot: string): Promise<CatalogManifestV6Entry>;

package/dist/src/utils/{catalog-manifest-v4.js → catalog-manifest-v6.js}

@@ -1,8 +1,10 @@
+import fs from 'fs-extra';
+import path from 'node:path';
 import { calculateCatalogEntryArtifactDigest, calculateCatalogEntryContentDigest, calculateCatalogEntryManifestDigest, } from './catalog-digests.js';
-import { createMarketplaceManifestEntry, normalizeCatalogManifestBase, normalizeCatalogManifestEntries, normalizeCatalogMarketplaceIdentity, compareStrictSemVer, } from './manifest.js';
+import { createMarketplaceManifestEntry, normalizeCatalogManifestBase, normalizeCatalogManifestEntries, normalizeCatalogMarketplaceIdentity, normalizeAwCapabilities, } from './manifest.js';
 const DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/;
 const SOURCE_HEAD_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
-export const CATALOG_SCHEMA_4_CLI_FLOOR = '0.0.0';
+export const CATALOG_SCHEMA_6_CAPABILITY = 'aw.catalog-snapshot.v6';
 function assertObject(value, fieldName) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {
         throw new Error(`Invalid ${fieldName}: expected an object.`);
@@ -22,85 +24,75 @@ function digest(value, fieldName) {
     return value;
 }
 function normalizeRelease(raw) {
-    const release = assertObject(raw, 'catalog manifest v4.release');
+    const release = assertObject(raw, 'catalog manifest v6.release');
     if (release.state === 'development') {
-        assertAllowedKeys(release, 'catalog manifest v4.release', ['state']);
+        assertAllowedKeys(release, 'catalog manifest v6.release', ['state']);
         return { state: 'development' };
     }
     if (release.state !== 'published') {
-        throw new Error('Invalid catalog manifest v4.release.state.');
-    }
-    assertAllowedKeys(release, 'catalog manifest v4.release', [
-        'state', 'targetVersion', 'planId', 'sourceHead', 'contentDigest',
-    ]);
-    if (typeof release.targetVersion !== 'string' || !/^\d+\.\d+\.\d+$/u.test(release.targetVersion)) {
-        throw new Error('Invalid catalog manifest v4.release.targetVersion: expected a stable version.');
+        throw new Error('Invalid catalog manifest v6.release.state.');
     }
+    assertAllowedKeys(release, 'catalog manifest v6.release', ['state', 'sourceHead']);
     if (typeof release.sourceHead !== 'string' || !SOURCE_HEAD_PATTERN.test(release.sourceHead)) {
-        throw new Error('Invalid catalog manifest v4.release.sourceHead.');
+        throw new Error('Invalid catalog manifest v6.release.sourceHead.');
     }
     return {
         state: 'published',
-        targetVersion: release.targetVersion,
-        planId: digest(release.planId, 'catalog manifest v4.release.planId'),
         sourceHead: release.sourceHead,
-        contentDigest: digest(release.contentDigest, 'catalog manifest v4.release.contentDigest'),
     };
 }
-export function validateCatalogManifestV4(rawManifest) {
-    const input = assertObject(rawManifest, 'catalog manifest v4');
-    assertAllowedKeys(input, 'catalog manifest v4', [
-        'schemaVersion', 'catalogVersion', 'channel', 'compatibility', 'marketplace', 'release', 'entries',
+export function validateCatalogManifestV6(rawManifest) {
+    const input = assertObject(rawManifest, 'catalog manifest v6');
+    assertAllowedKeys(input, 'catalog manifest v6', [
+        'schemaVersion', 'catalogVersion', 'channel', 'requires', 'marketplace', 'release', 'entries',
     ]);
-    if (input.schemaVersion !== 4) {
-        throw new Error('Invalid catalog manifest v4.schemaVersion: expected 4.');
+    if (input.schemaVersion !== 6) {
+        throw new Error('Invalid catalog manifest v6.schemaVersion: expected 6.');
     }
     if (!Array.isArray(input.entries)) {
-        throw new Error('Invalid catalog manifest v4.entries: expected an array.');
+        throw new Error('Invalid catalog manifest v6.entries: expected an array.');
     }
     const contentDigests = [];
     const entryInputs = input.entries.map((rawEntry, index) => {
-        const entry = assertObject(rawEntry, `catalog manifest v4.entries[${index}]`);
-        contentDigests.push(digest(entry.contentDigest, `catalog manifest v4.entries[${index}].contentDigest`));
+        const entry = assertObject(rawEntry, `catalog manifest v6.entries[${index}]`);
+        contentDigests.push(digest(entry.contentDigest, `catalog manifest v6.entries[${index}].contentDigest`));
         const entryInput = { ...entry };
         delete entryInput.contentDigest;
         return entryInput;
     });
-    const base = normalizeCatalogManifestBase(input, 'catalog manifest v4');
+    const base = normalizeCatalogManifestBase(input, 'catalog manifest v6');
     const marketplace = normalizeCatalogMarketplaceIdentity(input.marketplace);
-    if (compareStrictSemVer(base.compatibility.aw.minVersion, CATALOG_SCHEMA_4_CLI_FLOOR) < 0) {
-        throw new Error(`Invalid catalog manifest v4.compatibility.aw.minVersion: schema 4 requires ${CATALOG_SCHEMA_4_CLI_FLOOR} or newer.`);
+    if (!(base.requires.aw.capabilities ?? []).includes(CATALOG_SCHEMA_6_CAPABILITY)) {
+        throw new Error(`Invalid catalog manifest v6.requires.aw.capabilities: expected ${CATALOG_SCHEMA_6_CAPABILITY}.`);
     }
-    const entries = normalizeCatalogManifestEntries(entryInputs, base, 'catalog manifest v4');
+    const entries = normalizeCatalogManifestEntries(entryInputs, base, 'catalog manifest v6');
     const release = normalizeRelease(input.release);
-    if (release.state === 'published'
-        && release.targetVersion !== base.catalogVersion.replace(/-beta\.[1-9]\d*$/u, '')) {
-        throw new Error('Invalid catalog manifest v4.release.targetVersion: must equal the stable catalogVersion core.');
-    }
     return {
-        schemaVersion: 4,
+        schemaVersion: 6,
         catalogVersion: base.catalogVersion,
         channel: base.channel,
-        compatibility: base.compatibility,
+        requires: base.requires,
         marketplace,
         release,
         entries: entries.map((entry, index) => ({ ...entry, contentDigest: contentDigests[index] })),
     };
 }
-export function createCatalogManifestV4(manifest) {
-    return validateCatalogManifestV4({ schemaVersion: 4, ...manifest });
+export function createCatalogManifestV6(manifest) {
+    return validateCatalogManifestV6({ schemaVersion: 6, ...manifest });
 }
-export async function createCatalogManifestV4Entry(plugin, pluginRoot) {
-    if (!plugin.manifest.compatibility) {
-        throw new Error(`Plugin "${plugin.manifest.name}" is missing compatibility metadata.`);
-    }
+export async function createCatalogManifestV6Entry(plugin, pluginRoot) {
     return {
         ...createMarketplaceManifestEntry(plugin),
         version: plugin.manifest.version,
-        compatibility: plugin.manifest.compatibility,
+        dependencies: [...(plugin.manifest.dependencies ?? [])].sort(),
+        requires: {
+            aw: {
+                capabilities: normalizeAwCapabilities(plugin.manifest.requires?.aw.capabilities ?? []),
+            },
+        },
         artifactDigest: await calculateCatalogEntryArtifactDigest(pluginRoot),
-        manifestDigest: calculateCatalogEntryManifestDigest(plugin.manifest),
+        manifestDigest: calculateCatalogEntryManifestDigest(await fs.readJson(path.join(pluginRoot, '.agents-plugin', 'plugin.json'))),
         contentDigest: await calculateCatalogEntryContentDigest(pluginRoot),
     };
 }
-//# sourceMappingURL=catalog-manifest-v4.js.map
+//# sourceMappingURL=catalog-manifest-v6.js.map

package/dist/src/utils/catalog-manifest-v6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-manifest-v6.js","sourceRoot":"","sources":["../../../src/utils/catalog-manifest-v6.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,+BAA+B,EAC/B,mCAAmC,EACnC,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAC9D,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAEpE,SAAS,YAAY,CAAC,KAAc,EAAE,SAAiB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,uBAAuB,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA8B,EAAE,SAAiB,EAAE,OAAiB;IAC7F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,SAAiB;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,uCAAuC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QACpC,iBAAiB,CAAC,OAAO,EAAE,6BAA6B,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,iBAAiB,CAAC,OAAO,EAAE,6BAA6B,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IACnF,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAoB;IAC5D,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAC/D,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,EAAE;QAC9C,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS;KAC9F,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,+BAA+B,KAAK,GAAG,CAAC,CAAC;QAC9E,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,+BAA+B,KAAK,iBAAiB,CAAC,CAAC,CAAC;QACxG,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC,aAAa,CAAC;QAChC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,mCAAmC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,kEAAkE,2BAA2B,GAAG,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,OAAO,GAAG,+BAA+B,CAAC,WAAW,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW;QACX,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,cAAc,CAAC,KAAK,CAAE,EAAE,CAAC,CAAC;KAC9F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAkD;IAElD,OAAO,yBAAyB,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAkB,EAClB,UAAkB;IAElB,OAAO;QACL,GAAG,8BAA8B,CAAC,MAAM,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;QAChC,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;QAC9D,QAAQ,EAAE;YACR,EAAE,EAAE;gBACF,YAAY,EAAE,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC;aACvF;SACF;QACD,cAAc,EAAE,MAAM,mCAAmC,CAAC,UAAU,CAAC;QACrE,cAAc,EAAE,mCAAmC,CACjD,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAC1E;QACD,aAAa,EAAE,MAAM,kCAAkC,CAAC,UAAU,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/dist/src/utils/catalog-operation-context.d.ts

@@ -0,0 +1,20 @@
+import type { CatalogGenerationSet, CatalogSourceId } from '../types.js';
+import type { CatalogStoreEntry } from './catalog-generation-store.js';
+import type { CatalogSourcesConfigSnapshot } from './catalog-sources.js';
+import type { MultiSourceCatalogResolution } from './multi-source-catalog.js';
+export interface CatalogOperationContext {
+    generationSet: CatalogGenerationSet;
+    generationSetDigest: string;
+    catalog: MultiSourceCatalogResolution;
+}
+export interface ResolveCatalogOperationContextOptions {
+    sourceIds?: CatalogSourceId[];
+    configSnapshot?: CatalogSourcesConfigSnapshot;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}
+export declare function selectCatalogOperationContext(context: CatalogOperationContext, sourceIds: CatalogSourceId[]): CatalogOperationContext;
+export declare function resolveCatalogOperationContext(options?: ResolveCatalogOperationContextOptions): Promise<CatalogOperationContext>;
+export declare function resolvePartialCatalogOperationContext(options?: ResolveCatalogOperationContextOptions): Promise<CatalogOperationContext>;

package/dist/src/utils/catalog-operation-context.js

@@ -0,0 +1,141 @@
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { calculateCatalogGenerationSetDigest, resolveCatalogGenerationSet, } from './catalog-generation-resolver.js';
+import { readCatalogGenerationControlSnapshot, } from './catalog-generation-control-snapshot.js';
+export function selectCatalogOperationContext(context, sourceIds) {
+    const requested = new Set(sourceIds);
+    const missing = sourceIds.find((sourceId) => !context.generationSet.sources.some((source) => source.sourceId === sourceId));
+    if (missing)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationUnavailable',
+            sourceId: missing,
+            message: `Catalog source "${missing}" was unavailable when this operation context was bound. Run aw catalog source sync ${missing}, then retry.`,
+        });
+    const sources = context.generationSet.sources.filter((source) => requested.has(source.sourceId));
+    const generationSetDigest = calculateCatalogGenerationSetDigest(context.generationSet.configDigest, context.generationSet.primarySourceId, sources);
+    return {
+        generationSet: { ...context.generationSet, sources, generationSetDigest },
+        generationSetDigest,
+        catalog: {
+            ...context.catalog,
+            sources: context.catalog.sources.filter((source) => requested.has(source.sourceId)),
+            compositeDigest: generationSetDigest,
+        },
+    };
+}
+function selectedSourceIds(snapshot, sourceIds) {
+    if (!sourceIds)
+        return snapshot.config.sources.map((source) => source.id);
+    const configured = new Set(snapshot.config.sources.map((source) => source.id));
+    const unknown = sourceIds.find((sourceId) => !configured.has(sourceId));
+    if (unknown)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: unknown,
+            message: `Catalog source "${unknown}" is not configured.`,
+        });
+    const requested = new Set(sourceIds);
+    return snapshot.config.sources.filter((source) => requested.has(source.id)).map((source) => source.id);
+}
+async function createContext(options) {
+    const configured = new Map(options.control.configSnapshot.config.sources.map((source) => [source.id, source]));
+    const sources = options.generationSet.sources.map((generation) => {
+        options.signal?.throwIfAborted();
+        const source = configured.get(generation.sourceId);
+        const active = options.control.generationState.sources[generation.sourceId]?.active;
+        if (!source || !active
+            || active.snapshotDigest !== generation.snapshotDigest
+            || active.sourceIdentity !== generation.sourceIdentity) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationIdentityMismatch',
+                sourceId: generation.sourceId,
+                message: `Active Catalog snapshot for source "${generation.sourceId}" changed while the operation context was being resolved. Retry the operation.`,
+            });
+        }
+        const resolution = {
+            sourceId: generation.sourceId,
+            sourceIdentity: generation.sourceIdentity,
+            requestedRef: active.requestedRef,
+            resolvedCommit: generation.resolvedCommit,
+            rootDir: generation.snapshotPath,
+            manifest: generation.manifest,
+            manifestDigest: generation.manifestDigest,
+            snapshotDigest: generation.snapshotDigest,
+            transport: source.type,
+            async cleanup() { },
+        };
+        return { sourceId: generation.sourceId, resolution };
+    });
+    return {
+        generationSet: options.generationSet,
+        generationSetDigest: options.generationSet.generationSetDigest,
+        catalog: {
+            sources,
+            primarySourceId: options.generationSet.primarySourceId,
+            configDigest: options.generationSet.configDigest,
+            compositeDigest: options.generationSet.generationSetDigest,
+        },
+    };
+}
+export async function resolveCatalogOperationContext(options = {}) {
+    const env = options.env ?? process.env;
+    options.signal?.throwIfAborted();
+    const control = await readCatalogGenerationControlSnapshot({
+        env,
+        configSnapshot: options.configSnapshot,
+    });
+    const generationSet = await resolveCatalogGenerationSet({
+        sourceIds: selectedSourceIds(control.configSnapshot, options.sourceIds),
+        env,
+        controlSnapshot: control,
+        validatedStoreEntries: options.validatedStoreEntries,
+        validatingStoreEntries: options.validatingStoreEntries,
+    });
+    return createContext({ generationSet, control, signal: options.signal });
+}
+export async function resolvePartialCatalogOperationContext(options = {}) {
+    const env = options.env ?? process.env;
+    const control = await readCatalogGenerationControlSnapshot({
+        env,
+        configSnapshot: options.configSnapshot,
+    });
+    const sourceIds = selectedSourceIds(control.configSnapshot, options.sourceIds);
+    const results = await Promise.all(sourceIds.map(async (sourceId) => {
+        try {
+            const generationSet = await resolveCatalogGenerationSet({
+                sourceIds: [sourceId],
+                env,
+                controlSnapshot: control,
+                validatedStoreEntries: options.validatedStoreEntries,
+                validatingStoreEntries: options.validatingStoreEntries,
+            });
+            return { sourceId, context: await createContext({ generationSet, control, signal: options.signal }) };
+        }
+        catch (error) {
+            if (options.signal?.aborted)
+                throw error;
+            return { sourceId, error: error };
+        }
+    }));
+    const sources = results.flatMap((result) => result.context?.generationSet.sources ?? [])
+        .sort((left, right) => left.sourceId.localeCompare(right.sourceId));
+    const primarySourceId = control.configSnapshot.config.sources.find((source) => source.primary).id;
+    const generationSetDigest = calculateCatalogGenerationSetDigest(control.configSnapshot.digest, primarySourceId, sources);
+    return {
+        generationSet: {
+            generationSetDigest,
+            configDigest: control.configSnapshot.digest,
+            primarySourceId,
+            sources,
+        },
+        generationSetDigest,
+        catalog: {
+            sources: results.map((result) => result.context
+                ? result.context.catalog.sources[0]
+                : { sourceId: result.sourceId, error: result.error }),
+            primarySourceId,
+            configDigest: control.configSnapshot.digest,
+            compositeDigest: generationSetDigest,
+        },
+    };
+}
+//# sourceMappingURL=catalog-operation-context.js.map

package/dist/src/utils/catalog-operation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-operation-context.js","sourceRoot":"","sources":["../../../src/utils/catalog-operation-context.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/catalog-public-error.d.ts

@@ -1,11 +1,15 @@
-export type CatalogProviderCompatibilityErrorCode = 'awVersionTooLow' | 'explicitCatalogIncompatible';
+export type CatalogProviderCompatibilityErrorCode = 'awCapabilityUnsupported';
 export declare class CatalogProviderCompatibilityError extends Error {
     readonly sourceId: string;
     readonly code: CatalogProviderCompatibilityErrorCode;
+    readonly requiredCapabilities: string[];
+    readonly missingCapabilities: string[];
+    readonly availableCapabilities: string[];
     constructor(options: {
         sourceId: string;
-        minAwVersion: string;
-        selection: 'cliChannel' | 'explicit';
+        requiredCapabilities: readonly string[];
+        missingCapabilities: readonly string[];
+        availableCapabilities: readonly string[];
     });
 }
 export declare function sanitizeCatalogSourceErrorMessage(message: string, env?: NodeJS.ProcessEnv, sensitiveRoots?: readonly string[]): string;