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

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.plugin-authoring.v1", "aw.catalog-context.v1", "aw.catalog-authoring.v1", "aw.catalog-source.v2", "aw.catalog-dev-source.v1", "aw.catalog-publication.v1", "aw.catalog-snapshot.v5", "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,105 @@
+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.plugin-authoring.v1',
+    'aw.catalog-context.v1',
+    'aw.catalog-authoring.v1',
+    'aw.catalog-source.v2',
+    'aw.catalog-dev-source.v1',
+    'aw.catalog-publication.v1',
+    'aw.catalog-snapshot.v5',
+    '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":"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"}

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

@@ -0,0 +1,10 @@
+export type CatalogWorkspaceResolvedFrom = 'explicit' | 'workspace-marker' | 'git-worktree' | 'cwd';
+export interface CatalogWorkspaceResolution {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+}
+export declare function resolveCatalogWorkspaceRoot(options: {
+    cwd: string;
+    explicitRoot?: string;
+    mode: 'existing' | 'initialize';
+}): Promise<CatalogWorkspaceResolution>;

package/dist/catalog-workspace-resolution.js

@@ -0,0 +1,103 @@
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import fs from 'fs-extra';
+import { CATALOG_WORKSPACE_MARKER_FILENAME } from './workspace.js';
+const execFileAsync = promisify(execFile);
+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;
+}
+async function validateMarker(root) {
+    const markerPath = path.join(root, CATALOG_WORKSPACE_MARKER_FILENAME);
+    const stat = await fs.lstat(markerPath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!stat?.isFile() || stat.isSymbolicLink()) {
+        throw new Error(`Invalid Catalog Workspace marker: ${markerPath}`);
+    }
+    let marker;
+    try {
+        marker = await fs.readJson(markerPath);
+    }
+    catch {
+        throw new Error(`Invalid Catalog Workspace marker: ${markerPath}`);
+    }
+    const record = marker;
+    if (!record
+        || typeof record !== 'object'
+        || Array.isArray(record)
+        || Object.keys(record).sort().join('\0') !== ['kind', 'schemaVersion', 'workspaceIdentity'].join('\0')
+        || record.schemaVersion !== 1
+        || record.kind !== 'aw-catalog-workspace'
+        || typeof record.workspaceIdentity !== 'string'
+        || record.workspaceIdentity.trim() === '') {
+        throw new Error(`Invalid Catalog Workspace marker: ${markerPath}`);
+    }
+}
+async function findAncestorWorkspace(from) {
+    let current = await startDirectory(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 validateMarker(current);
+            return fs.realpath(current);
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+async function findGitWorktreeRoot(cwd) {
+    try {
+        const env = { ...process.env };
+        delete env.GIT_DIR;
+        delete env.GIT_WORK_TREE;
+        delete env.GIT_COMMON_DIR;
+        env.GIT_OPTIONAL_LOCKS = '0';
+        const result = await execFileAsync('git', ['rev-parse', '--show-toplevel'], {
+            cwd: await startDirectory(cwd),
+            env,
+            encoding: 'utf8',
+        });
+        return fs.realpath(result.stdout.trim());
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveCatalogWorkspaceRoot(options) {
+    if (options.explicitRoot !== undefined) {
+        const workspaceRoot = path.resolve(options.cwd, options.explicitRoot);
+        if (options.mode === 'existing')
+            await validateMarker(workspaceRoot);
+        return { workspaceRoot, workspaceRootResolvedFrom: 'explicit' };
+    }
+    const ancestor = await findAncestorWorkspace(options.cwd);
+    if (ancestor) {
+        return { workspaceRoot: ancestor, workspaceRootResolvedFrom: 'workspace-marker' };
+    }
+    if (options.mode === 'existing') {
+        throw new Error(`Catalog Workspace marker not found from: ${path.resolve(options.cwd)}`);
+    }
+    const gitRoot = await findGitWorktreeRoot(options.cwd);
+    if (gitRoot)
+        return { workspaceRoot: gitRoot, workspaceRootResolvedFrom: 'git-worktree' };
+    return { workspaceRoot: await startDirectory(options.cwd), workspaceRootResolvedFrom: 'cwd' };
+}
+//# 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":"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"}

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

@@ -1,20 +1,20 @@
 /**
- * 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[];
 /**
- * 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 +25,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 +34,7 @@ export interface PluginManifestSourceV1 {
      * @maxItems 64
      */
     dependencies?: string[];
-    compatibility?: Compatibility;
+    requires?: Requires;
     skills?: PluginPath;
     slashCommands?: PluginPath;
     mcpServers?: PluginPath;
@@ -49,16 +49,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 +67,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 +81,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 +90,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 +104,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 +115,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 +127,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 +138,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 +148,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 +157,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 +168,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 {
@@ -206,7 +206,7 @@ export interface ArtifactTarget {
     }[];
 }
 /**
- * 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 {
@@ -257,7 +257,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 +265,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 +273,7 @@ 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` "importReference".
  */
 export interface ImportReference {
@@ -281,7 +281,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 +306,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 +315,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 +352,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,5 @@
 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 './catalog-workspace-resolution.js';
 export * from './plugin-release.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './manifest.js';
 export * from './workspace.js';
+export * from './catalog-workspace-resolution.js';
 export * from './plugin-release.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;AACjD,cAAc,qBAAqB,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>;