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

package/dist/aw-capabilities.d.ts

@@ -0,0 +1,27 @@
+export declare const AW_CAPABILITY_IDS: readonly ["aw.plugin-manifest.v2", "aw.plugin-skills.v1", "aw.plugin-build-config.v1", "aw.plugin-config.v1", "aw.plugin-lifecycle.v1", "aw.dynamic-artifacts.v2", "aw.portable-skills.v1", "aw.runtime-imports.v1", "aw.skill-validation.v1", "aw.skill-eval.v2", "aw.plugin-authoring.v1", "aw.catalog-authoring.v1", "aw.catalog-source.v2", "aw.catalog-dev-source.v1", "aw.catalog-publication.v1", "aw.review-publication.v1", "aw.catalog-snapshot.v6", "aw.self-check.v1"];
+export type RegisteredAwCapabilityId = typeof AW_CAPABILITY_IDS[number];
+export type AwCapabilityId = string;
+export interface AwCapabilitySupport {
+    supported: boolean;
+    missing: AwCapabilityId[];
+}
+export declare function assertAwCapabilityId(value: unknown, fieldName?: string): asserts value is AwCapabilityId;
+export declare function normalizeAwCapabilities(values: readonly unknown[], fieldName?: string): AwCapabilityId[];
+export declare function getAwCapabilityRegistry(): readonly RegisteredAwCapabilityId[];
+export declare function computeAwCapabilitySetDigest(values: readonly unknown[]): string;
+export declare function checkAwCapabilitySupport(required: readonly unknown[], implemented: readonly unknown[]): AwCapabilitySupport;
+export interface AwPluginRequirementsReceiptV1 {
+    schemaVersion: 1;
+    kind: 'aw-plugin-requirements';
+    plugin: {
+        name: string;
+        version: string;
+    };
+    requiredCapabilities: AwCapabilityId[];
+    digest: string;
+}
+export declare function createAwPluginRequirementsReceipt(plugin: {
+    name: string;
+    version: string;
+}, requiredCapabilities: readonly unknown[]): AwPluginRequirementsReceiptV1;
+export declare function parseAwPluginRequirementsReceipt(value: unknown): AwPluginRequirementsReceiptV1;

package/dist/aw-capabilities.js

@@ -0,0 +1,106 @@
+import { createHash } from 'node:crypto';
+export const AW_CAPABILITY_IDS = [
+    'aw.plugin-manifest.v2',
+    'aw.plugin-skills.v1',
+    'aw.plugin-build-config.v1',
+    'aw.plugin-config.v1',
+    'aw.plugin-lifecycle.v1',
+    'aw.dynamic-artifacts.v2',
+    'aw.portable-skills.v1',
+    'aw.runtime-imports.v1',
+    'aw.skill-validation.v1',
+    'aw.skill-eval.v2',
+    'aw.plugin-authoring.v1',
+    'aw.catalog-authoring.v1',
+    'aw.catalog-source.v2',
+    'aw.catalog-dev-source.v1',
+    'aw.catalog-publication.v1',
+    'aw.review-publication.v1',
+    'aw.catalog-snapshot.v6',
+    'aw.self-check.v1',
+];
+const CAPABILITY_ID_PATTERN = /^aw\.[a-z0-9]+(?:-[a-z0-9]+)*(?:\.[a-z0-9]+(?:-[a-z0-9]+)*)*\.v[1-9][0-9]*$/u;
+const CAPABILITY_SET_DIGEST_DOMAIN = 'aw-capability-set-v1\0';
+const PLUGIN_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+const STRICT_SEMVER_PATTERN = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-((?:0|[1-9][0-9]*|(?:[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))(?:\.(?:0|[1-9][0-9]*|(?:[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
+export function assertAwCapabilityId(value, fieldName = 'capability') {
+    if (typeof value !== 'string' || !CAPABILITY_ID_PATTERN.test(value)) {
+        throw new Error(`Invalid ${fieldName}: expected an AW capability ID.`);
+    }
+}
+export function normalizeAwCapabilities(values, fieldName = 'capabilities') {
+    const normalized = new Set();
+    values.forEach((value, index) => {
+        assertAwCapabilityId(value, `${fieldName}[${index}]`);
+        normalized.add(value);
+    });
+    return [...normalized].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+}
+export function getAwCapabilityRegistry() {
+    const normalized = normalizeAwCapabilities(AW_CAPABILITY_IDS);
+    if (normalized.length !== AW_CAPABILITY_IDS.length) {
+        throw new Error('Invalid AW capability registry: capability IDs must be unique.');
+    }
+    return AW_CAPABILITY_IDS;
+}
+export function computeAwCapabilitySetDigest(values) {
+    const canonical = JSON.stringify(normalizeAwCapabilities(values));
+    return `sha256:${createHash('sha256').update(CAPABILITY_SET_DIGEST_DOMAIN).update(canonical).digest('hex')}`;
+}
+export function checkAwCapabilitySupport(required, implemented) {
+    const supported = new Set(normalizeAwCapabilities(implemented, 'implementedCapabilities'));
+    const missing = normalizeAwCapabilities(required, 'requiredCapabilities')
+        .filter((capability) => !supported.has(capability));
+    return { supported: missing.length === 0, missing };
+}
+export function createAwPluginRequirementsReceipt(plugin, requiredCapabilities) {
+    const normalized = normalizeAwCapabilities(requiredCapabilities);
+    return {
+        schemaVersion: 1,
+        kind: 'aw-plugin-requirements',
+        plugin,
+        requiredCapabilities: normalized,
+        digest: computeAwCapabilitySetDigest(normalized),
+    };
+}
+function assertRecord(value, fieldName) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid ${fieldName}: expected an object.`);
+    }
+}
+function assertExactKeys(value, keys, fieldName) {
+    const extras = Object.keys(value).filter((key) => !keys.includes(key));
+    if (extras.length > 0)
+        throw new Error(`Invalid ${fieldName}: unknown field ${JSON.stringify(extras[0])}.`);
+}
+export function parseAwPluginRequirementsReceipt(value) {
+    assertRecord(value, 'AW plugin requirements receipt');
+    assertExactKeys(value, ['schemaVersion', 'kind', 'plugin', 'requiredCapabilities', 'digest'], 'AW plugin requirements receipt');
+    if (value.schemaVersion !== 1)
+        throw new Error('Invalid AW plugin requirements receipt.schemaVersion: expected 1.');
+    if (value.kind !== 'aw-plugin-requirements')
+        throw new Error('Invalid AW plugin requirements receipt.kind.');
+    assertRecord(value.plugin, 'AW plugin requirements receipt.plugin');
+    assertExactKeys(value.plugin, ['name', 'version'], 'AW plugin requirements receipt.plugin');
+    if (typeof value.plugin.name !== 'string' || !PLUGIN_NAME_PATTERN.test(value.plugin.name)) {
+        throw new Error('Invalid AW plugin requirements receipt.plugin.name.');
+    }
+    if (typeof value.plugin.version !== 'string' || !STRICT_SEMVER_PATTERN.test(value.plugin.version)) {
+        throw new Error('Invalid AW plugin requirements receipt.plugin.version.');
+    }
+    if (!Array.isArray(value.requiredCapabilities)) {
+        throw new Error('Invalid AW plugin requirements receipt.requiredCapabilities: expected an array.');
+    }
+    const requiredCapabilities = normalizeAwCapabilities(value.requiredCapabilities, 'AW plugin requirements receipt.requiredCapabilities');
+    if (typeof value.digest !== 'string' || value.digest !== computeAwCapabilitySetDigest(requiredCapabilities)) {
+        throw new Error('Invalid AW plugin requirements receipt.digest.');
+    }
+    return {
+        schemaVersion: 1,
+        kind: 'aw-plugin-requirements',
+        plugin: { name: value.plugin.name, version: value.plugin.version },
+        requiredCapabilities,
+        digest: value.digest,
+    };
+}
+//# sourceMappingURL=aw-capabilities.js.map

package/dist/aw-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aw-capabilities.js","sourceRoot":"","sources":["../src/aw-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,uBAAuB;IACvB,qBAAqB;IACrB,2BAA2B;IAC3B,qBAAqB;IACrB,wBAAwB;IACxB,yBAAyB;IACzB,uBAAuB;IACvB,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB,wBAAwB;IACxB,yBAAyB;IACzB,sBAAsB;IACtB,0BAA0B;IAC1B,2BAA2B;IAC3B,0BAA0B;IAC1B,wBAAwB;IACxB,kBAAkB;CACV,CAAA;AAUV,MAAM,qBAAqB,GAAG,8EAA8E,CAAA;AAC5G,MAAM,4BAA4B,GAAG,wBAAwB,CAAA;AAC7D,MAAM,mBAAmB,GAAG,6BAA6B,CAAA;AACzD,MAAM,qBAAqB,GAAG,iOAAiO,CAAA;AAE/P,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,SAAS,GAAG,YAAY;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,iCAAiC,CAAC,CAAA;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAA0B,EAC1B,SAAS,GAAG,cAAc;IAE1B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;IACpC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,oBAAoB,CAAC,KAAK,EAAE,GAAG,SAAS,IAAI,KAAK,GAAG,CAAC,CAAA;QACrD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACxF,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,UAAU,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAA;IAC7D,IAAI,UAAU,CAAC,MAAM,KAAK,iBAAiB,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAA0B;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAA;IACjE,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAC9G,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAA4B,EAC5B,WAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAA;IAC1F,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,CAAC;SACtE,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;IACrD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;AACrD,CAAC;AAUD,MAAM,UAAU,iCAAiC,CAC/C,MAAyC,EACzC,oBAAwC;IAExC,MAAM,UAAU,GAAG,uBAAuB,CAAC,oBAAoB,CAAC,CAAA;IAChE,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,MAAM;QACN,oBAAoB,EAAE,UAAU;QAChC,MAAM,EAAE,4BAA4B,CAAC,UAAU,CAAC;KACjD,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,SAAiB;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,uBAAuB,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAA8B,EAAE,IAAuB,EAAE,SAAiB;IACjG,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAC7G,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAAc;IAC7D,YAAY,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAA;IACrD,eAAe,CAAC,KAAK,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,gCAAgC,CAAC,CAAA;IAC/H,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACnH,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAC5G,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAA;IACnE,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,uCAAuC,CAAC,CAAA;IAC3F,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACxE,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClG,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;IACpG,CAAC;IACD,MAAM,oBAAoB,GAAG,uBAAuB,CAClD,KAAK,CAAC,oBAAoB,EAC1B,qDAAqD,CACtD,CAAA;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,4BAA4B,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC5G,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;QAClE,oBAAoB;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAA;AACH,CAAC"}

package/dist/catalog-workspace-resolution.d.ts

@@ -0,0 +1,3 @@
+export declare function findNearestCatalogWorkspaceRoot(options: {
+    from: string;
+}): Promise<string | null>;

package/dist/catalog-workspace-resolution.js

@@ -0,0 +1,34 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_WORKSPACE_MARKER_FILENAME, readCatalogWorkspaceMarker, } from './workspace.js';
+async function startDirectory(value) {
+    const resolved = path.resolve(value);
+    const stat = await fs.lstat(resolved).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (stat?.isSymbolicLink())
+        throw new Error(`Catalog Workspace discovery path must not be a symbolic link: ${resolved}`);
+    return stat?.isFile() ? path.dirname(resolved) : resolved;
+}
+export async function findNearestCatalogWorkspaceRoot(options) {
+    let current = await startDirectory(options.from);
+    for (;;) {
+        const markerPath = path.join(current, CATALOG_WORKSPACE_MARKER_FILENAME);
+        const markerStat = await fs.lstat(markerPath).catch((error) => {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        });
+        if (markerStat) {
+            await readCatalogWorkspaceMarker(current);
+            return fs.realpath(current);
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+//# sourceMappingURL=catalog-workspace-resolution.js.map

package/dist/catalog-workspace-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-workspace-resolution.js","sourceRoot":"","sources":["../src/catalog-workspace-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,MAAM,UAAU,CAAA;AAEzB,OAAO,EACL,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,KAAK,UAAU,cAAc,CAAC,KAAa;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;QAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACxC,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;IACF,IAAI,IAAI,EAAE,cAAc,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,QAAQ,EAAE,CAAC,CAAA;IACxH,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAErD;IACC,IAAI,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,SAAS,CAAC;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAA;QACxE,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;YACnF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YACxC,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAA;YACzC,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAA;QACnC,OAAO,GAAG,MAAM,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/generated/{plugin-manifest-v1.d.ts → plugin-manifest-v2.d.ts}

@@ -1,20 +1,21 @@
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "semver".
  */
 export type Semver = string;
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "pluginPath".
  */
 export type PluginPath = string;
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "stringArray".
  */
 export type StringArray = string[];
+export type Capabilities = string[];
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "lifecycleDefinition".
  */
 export type LifecycleDefinition = (string | {
@@ -25,8 +26,8 @@ export type LifecycleDefinition = (string | {
     darwin?: ScriptEntry;
     win32?: ScriptEntry;
 });
-export interface PluginManifestSourceV1 {
-    schemaVersion?: 1;
+export interface PluginManifestSourceV2 {
+    schemaVersion: 2;
     name: string;
     version: Semver;
     description: string;
@@ -34,7 +35,7 @@ export interface PluginManifestSourceV1 {
      * @maxItems 64
      */
     dependencies?: string[];
-    compatibility?: Compatibility;
+    requires?: Requires;
     skills?: PluginPath;
     slashCommands?: PluginPath;
     mcpServers?: PluginPath;
@@ -49,16 +50,16 @@ export interface PluginManifestSourceV1 {
     config?: Config;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
- * via the `definition` "compatibility".
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
+ * via the `definition` "requires".
  */
-export interface Compatibility {
+export interface Requires {
     aw: {
-        minVersion: Semver;
+        capabilities?: string[];
     };
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "distributions".
  */
 export interface Distributions {
@@ -67,7 +68,7 @@ export interface Distributions {
     };
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "marketplace".
  */
 export interface Marketplace {
@@ -81,7 +82,7 @@ export interface Marketplace {
     };
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "interface".
  */
 export interface Interface {
@@ -90,7 +91,7 @@ export interface Interface {
     capabilities?: string[];
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "extensions".
  */
 export interface Extensions {
@@ -104,7 +105,7 @@ export interface Extensions {
     agents?: Agent[];
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "instruction".
  */
 export interface Instruction {
@@ -115,7 +116,7 @@ export interface Instruction {
     agentOverrides?: PlatformOverrides;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "platformOverrides".
  */
 export interface PlatformOverrides {
@@ -127,7 +128,7 @@ export interface PlatformOverrides {
     } | null);
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "permission".
  */
 export interface Permission {
@@ -138,7 +139,7 @@ export interface Permission {
     agentOverrides?: PlatformOverrides;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "hook".
  */
 export interface Hook {
@@ -148,7 +149,7 @@ export interface Hook {
     agentOverrides?: PlatformOverrides;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "nativeHook".
  */
 export interface NativeHook {
@@ -157,7 +158,7 @@ export interface NativeHook {
     command: string;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "agent".
  */
 export interface Agent {
@@ -168,14 +169,14 @@ export interface Agent {
     agentOverrides?: PlatformOverrides;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "artifacts".
  */
 export interface Artifacts {
     targets?: ArtifactTarget[];
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "artifactTarget".
  */
 export interface ArtifactTarget {
@@ -202,11 +203,13 @@ export interface ArtifactTarget {
             providerPluginId: string;
             providerVersion: Semver;
             source: string;
+            requiredCapabilities: Capabilities;
+            capabilitySetDigest: string;
         };
     }[];
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "buildConfig".
  */
 export interface BuildConfig {
@@ -236,6 +239,7 @@ export interface BuildConfig {
     runtimeExports?: {
         name: string;
         source: string;
+        requires: RuntimeExportRequires;
     }[];
     buildImports?: {
         plugin: string;
@@ -257,7 +261,7 @@ export interface BuildConfig {
     }[];
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "platformTemplateValue".
  */
 export interface PlatformTemplateValue {
@@ -265,7 +269,7 @@ export interface PlatformTemplateValue {
     codex: (string | boolean);
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "fileRules".
  */
 export interface FileRules {
@@ -273,7 +277,16 @@ export interface FileRules {
     exclude: StringArray;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
+ * via the `definition` "runtimeExportRequires".
+ */
+export interface RuntimeExportRequires {
+    aw: {
+        capabilities: Capabilities;
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "importReference".
  */
 export interface ImportReference {
@@ -281,7 +294,7 @@ export interface ImportReference {
     export: string;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "scripts".
  */
 export interface Scripts {
@@ -306,7 +319,7 @@ export interface Scripts {
     };
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "scriptEntry".
  */
 export interface ScriptEntry {
@@ -315,7 +328,7 @@ export interface ScriptEntry {
     args?: StringArray;
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "config".
  */
 export interface Config {
@@ -352,7 +365,7 @@ export interface Config {
     };
 }
 /**
- * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * This interface was referenced by `PluginManifestSourceV2`'s JSON-Schema
  * via the `definition` "configField".
  */
 export interface ConfigField {

package/dist/generated/{plugin-manifest-v1.js → plugin-manifest-v2.js}

@@ -1,3 +1,3 @@
 /* This file is generated. Run `pnpm generate` in packages/plugin-core to update it. */
 export {};
-//# sourceMappingURL=plugin-manifest-v1.js.map
+//# sourceMappingURL=plugin-manifest-v2.js.map

package/dist/generated/plugin-manifest-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-v2.js","sourceRoot":"","sources":["../../src/generated/plugin-manifest-v2.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from './manifest.js';
-export type { PluginManifestSourceV1 } from './generated/plugin-manifest-v1.js';
+export type { PluginManifestSourceV2 } from './generated/plugin-manifest-v2.js';
 export * from './workspace.js';
-export * from './plugin-release.js';
+export * from './catalog-workspace-resolution.js';

package/dist/index.js

@@ -1,4 +1,4 @@
 export * from './manifest.js';
 export * from './workspace.js';
-export * from './plugin-release.js';
+export * from './catalog-workspace-resolution.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAE7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAE7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mCAAmC,CAAA"}

package/dist/manifest-contract.d.ts

@@ -1,9 +1,8 @@
 import { SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION } from './manifest.js';
-import type { CatalogMarketplaceIdentity, CatalogChannel, CatalogManifestEntry, MarketplaceManifest, MarketplaceSourceMeta, PlatformName, PlatformPluginManifest, PluginCompatibility, PluginManifestSource, NormalizedPluginManifest, PluginMeta } from './types.js';
+import type { CatalogMarketplaceIdentity, CatalogChannel, CatalogManifestEntry, MarketplaceManifest, MarketplaceSourceMeta, PlatformName, PlatformPluginManifest, PluginRequirements, PluginManifestSource, NormalizedPluginManifest, PluginMeta } from './types.js';
 export declare const SOURCE_MANIFEST_PATH: string;
 export { SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION };
 export declare const MARKETPLACE_SOURCE_PATH: string;
-export declare const DEFAULT_SOURCE_PLUGIN_AW_MIN_VERSION = "0.0.0";
 export interface StrictSemVer {
     raw: string;
     major: number;
@@ -64,8 +63,6 @@ export declare function validateMarketplaceSourceMeta(rawValue: unknown): Market
 export declare function normalizeCatalogMarketplaceIdentity(rawValue: unknown, fieldName?: string): CatalogMarketplaceIdentity;
 export declare function readMarketplaceSourceMeta(repoRoot: string): Promise<MarketplaceSourceMeta>;
 export interface ValidatePluginManifestOptions {
-    compatibilityMode?: 'defaulted' | 'required';
-    defaultMinVersion?: string;
     reservedImports?: ReservedImportRegistry;
 }
 export type ReservedImportRegistry = Readonly<Record<string, readonly string[]>>;
@@ -87,10 +84,10 @@ export declare function normalizeManifestDigestInput(value: PluginManifestSource
 export interface NormalizedCatalogManifestBase {
     catalogVersion: string;
     channel: CatalogChannel;
-    compatibility: PluginCompatibility;
+    requires: PluginRequirements;
 }
 export declare function normalizeCatalogManifestBase(input: Record<string, unknown>, fieldName: string): NormalizedCatalogManifestBase;
 export declare function normalizeCatalogManifestEntries(rawEntries: unknown, base: NormalizedCatalogManifestBase, fieldName: string): CatalogManifestEntry[];
-export declare function createBundleSourceManifest(plugin: PluginMeta): NormalizedPluginManifest;
+export declare function createBundleSourceManifest(plugin: PluginMeta, requiredCapabilities?: readonly string[]): NormalizedPluginManifest;
 export declare function createPlatformManifestBase(plugin: PluginMeta): PlatformPluginManifest;
 export declare function validatePlatformManifestProjection(plugin: PluginMeta, platform: PlatformName, rawManifest: unknown): Promise<PlatformPluginManifest>;