@lesliechan721/aw-plugin-core 0.1.0-beta.6 → 0.1.0-beta.60

package/dist/aw-capabilities.d.ts

@@ -0,0 +1,27 @@
+export declare const AW_CAPABILITY_IDS: readonly ["aw.plugin-manifest.v3", "aw.plugin-skills.v1", "aw.plugin-build-config.v1", "aw.plugin-config.v2", "aw.plugin-config.v3", "aw.plugin-config.v4", "aw.plugin-config-array.v1", "aw.plugin-config-unique-by.v1", "aw.plugin-config-value-ref.v1", "aw.plugin-config-summary.v1", "aw.plugin-pre-apply.v1", "aw.dynamic-artifacts.v2", "aw.managed-commands.v1", "aw.native-tools.v2", "aw.claude.sandbox-exclusions.v1", "aw.portable-skills.v1", "aw.runtime-imports.v1", "aw.installed-runtime-config.v2", "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-preparation.v1", "aw.review-inspection.v2", "aw.catalog-snapshot.v7", "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,117 @@
+import { createHash } from 'node:crypto';
+export const AW_CAPABILITY_IDS = [
+    'aw.plugin-manifest.v3',
+    'aw.plugin-skills.v1',
+    'aw.plugin-build-config.v1',
+    'aw.plugin-config.v2',
+    'aw.plugin-config.v3',
+    'aw.plugin-config.v4',
+    'aw.plugin-config-array.v1',
+    'aw.plugin-config-unique-by.v1',
+    'aw.plugin-config-value-ref.v1',
+    'aw.plugin-config-summary.v1',
+    'aw.plugin-pre-apply.v1',
+    'aw.dynamic-artifacts.v2',
+    'aw.managed-commands.v1',
+    'aw.native-tools.v2',
+    'aw.claude.sandbox-exclusions.v1',
+    'aw.portable-skills.v1',
+    'aw.runtime-imports.v1',
+    'aw.installed-runtime-config.v2',
+    '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-preparation.v1',
+    'aw.review-inspection.v2',
+    'aw.catalog-snapshot.v7',
+    '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-file-modes.d.ts

@@ -0,0 +1,5 @@
+export declare const CATALOG_EXECUTABLE_FILES_PATH = ".agents-plugin/aw-executable-files.json";
+export declare function listCatalogBundleFiles(root: string, relative?: string): Promise<string[]>;
+export declare function writeCatalogExecutableFiles(pluginRoot: string): Promise<void>;
+export declare function readCatalogExecutableFiles(pluginRoot: string, files: readonly string[]): Promise<ReadonlySet<string> | undefined>;
+export declare function catalogFileMode(relativePath: string, mode: number, executableFiles?: ReadonlySet<string>): '100644' | '100755';

package/dist/catalog-file-modes.js

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+export const CATALOG_EXECUTABLE_FILES_PATH = '.agents-plugin/aw-executable-files.json';
+export async function listCatalogBundleFiles(root, relative = '') {
+    const result = [];
+    for (const entry of await fs.readdir(path.join(root, relative), { withFileTypes: true })) {
+        const child = relative ? path.posix.join(relative, entry.name) : entry.name;
+        if (entry.isDirectory())
+            result.push(...await listCatalogBundleFiles(root, child));
+        else
+            result.push(child);
+    }
+    return result.sort();
+}
+export async function writeCatalogExecutableFiles(pluginRoot) {
+    const metadataPath = path.join(pluginRoot, CATALOG_EXECUTABLE_FILES_PATH);
+    const existing = await fs.lstat(metadataPath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (existing && !existing.isFile()) {
+        throw new Error('Catalog executable file metadata must be a regular file.');
+    }
+    const executableFiles = [];
+    for (const relative of await listCatalogBundleFiles(pluginRoot)) {
+        if (relative === CATALOG_EXECUTABLE_FILES_PATH)
+            continue;
+        const stat = await fs.lstat(path.join(pluginRoot, relative));
+        if (stat.isFile() && (stat.mode & 0o100) !== 0)
+            executableFiles.push(relative);
+    }
+    if (executableFiles.length === 0) {
+        if (existing)
+            await fs.unlink(metadataPath);
+        return;
+    }
+    await fs.outputFile(metadataPath, `${JSON.stringify(executableFiles, null, 2)}\n`);
+    await fs.chmod(metadataPath, 0o644);
+}
+export async function readCatalogExecutableFiles(pluginRoot, files) {
+    if (!files.includes(CATALOG_EXECUTABLE_FILES_PATH))
+        return undefined;
+    const metadataPath = path.join(pluginRoot, CATALOG_EXECUTABLE_FILES_PATH);
+    if (!(await fs.lstat(metadataPath)).isFile()) {
+        throw new Error('Catalog executable file metadata must be a regular file.');
+    }
+    const input = await fs.readJson(metadataPath);
+    const inventory = new Set(files);
+    if (!Array.isArray(input) || input.some((relative, index) => typeof relative !== 'string'
+        || /[\\:\u0000-\u001f]/u.test(relative)
+        || relative === CATALOG_EXECUTABLE_FILES_PATH
+        || !inventory.has(relative)
+        || (index > 0 && input[index - 1] >= relative))) {
+        throw new Error('Invalid Catalog executable file metadata.');
+    }
+    return new Set(input);
+}
+export function catalogFileMode(relativePath, mode, executableFiles) {
+    // Windows does not retain Unix execute bits. The inventory is itself bound
+    // by the Catalog digests; Unix still verifies the actual file permissions.
+    const executable = process.platform === 'win32' && executableFiles !== undefined
+        ? executableFiles.has(relativePath)
+        : (mode & 0o100) !== 0;
+    return executable ? '100755' : '100644';
+}
+//# sourceMappingURL=catalog-file-modes.js.map

package/dist/catalog-file-modes.js.map

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

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"}