@lesliechan721/aw 0.1.0-beta.38 → 0.1.0-beta.39

package/dist/authoring/assets/aw-runtime-config.d.mts

@@ -0,0 +1,13 @@
+/** Read this Skill's installed effective values from its actual calling resource. */
+export function readRuntimeConfig(options?: {}): Promise<{
+    installedIdentity: any;
+    effectiveValues: {
+        [k: string]: any;
+    };
+    resourceRoot: string;
+} | undefined>;
+export class RuntimeConfigError extends Error {
+    constructor(code: any, detail?: string);
+    code: any;
+    recoveryActions: string[];
+}

package/dist/authoring/assets/aw-runtime-config.mjs

@@ -0,0 +1,199 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const BINDING = '.aw-runtime-config.json';
+const READER = 'scripts/aw-runtime-config.mjs';
+const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+export class RuntimeConfigError extends Error {
+    constructor(code, detail = 'Installed runtime config is unavailable.') {
+        super(`${code}: ${detail} Fix the configuration, then run aw sync or aw reinstall.`);
+        this.name = 'RuntimeConfigError';
+        this.code = code;
+        this.recoveryActions = ['sync', 'reinstall'];
+    }
+}
+function fail(code, detail) { throw new RuntimeConfigError(code, detail); }
+function relativeFile(value) {
+    return typeof value === 'string' && value.length > 0 && !value.includes('\\')
+        && !value.includes('\0') && !path.posix.isAbsolute(value)
+        && !path.win32.isAbsolute(value) && value.split('/').every((part) => part !== '' && part !== '.' && part !== '..');
+}
+async function regularFile(root, relative) {
+    if (!relativeFile(relative))
+        fail('runtimeConfigPathUnsafe');
+    let current = root;
+    const parts = relative.split('/');
+    for (let index = 0; index < parts.length; index += 1) {
+        current = path.join(current, parts[index]);
+        const stat = await fs.lstat(current).catch(() => fail('runtimeConfigResourceMissing'));
+        if (stat.isSymbolicLink() || (index === parts.length - 1 ? !stat.isFile() : !stat.isDirectory())) {
+            fail('runtimeConfigPathUnsafe');
+        }
+    }
+    return current;
+}
+async function assertPathSafe(file) {
+    const absolute = path.resolve(file);
+    const parsed = path.parse(absolute);
+    let current = parsed.root;
+    for (const part of absolute.slice(parsed.root.length).split(path.sep)) {
+        current = path.join(current, part);
+        const stat = await fs.lstat(current).catch(() => fail('runtimeConfigResourceMissing'));
+        if (stat.isSymbolicLink())
+            fail('runtimeConfigPathUnsafe');
+    }
+    return absolute;
+}
+function validateBinding(binding) {
+    if (!isRecord(binding) || binding.schemaVersion !== 2 || binding.kind !== 'aw-runtime-config') {
+        fail('runtimeConfigVersionUnsupported', 'Expected installed runtime config schemaVersion 2. Rebuild old runtime resources before installing them.');
+    }
+    if (['definition', 'sources', 'resourceVersion', 'revision', 'digest', 'resources', 'consistencyGroup', 'peerLocators']
+        .some((key) => Object.hasOwn(binding, key))) {
+        fail('runtimeConfigMigrationRequired', 'Remove v1 runtime metadata and regenerate the schemaVersion 2 binding.');
+    }
+    const identity = binding.installedIdentity;
+    if (!isRecord(identity) || !isRecord(binding.effectiveValues)
+        || Object.keys(binding).some((key) => !['schemaVersion', 'kind', 'installedIdentity', 'allowedKeys', 'effectiveValues', 'nativeReceiptPath'].includes(key))
+        || !Array.isArray(binding.allowedKeys) || binding.allowedKeys.length === 0
+        || binding.allowedKeys.some((key) => typeof key !== 'string' || !key)
+        || new Set(binding.allowedKeys).size !== binding.allowedKeys.length
+        || Object.values(binding.effectiveValues).some((value) => value === null))
+        fail('runtimeConfigBindingInvalid');
+    for (const key of ['sourceId', 'sourceIdentity', 'pluginId', 'pluginName', 'pluginVersion', 'artifactId', 'skillKey']) {
+        if (typeof identity[key] !== 'string' || !identity[key])
+            fail('runtimeConfigIdentityMismatch');
+    }
+    if (!['codex', 'claude'].includes(identity.platform) || !['user', 'project'].includes(identity.scope)
+        || !['user', 'project'].includes(identity.configScope)
+        || identity.pluginId !== `${identity.sourceId}/${identity.pluginName}`
+        || !/^[A-Za-z][A-Za-z0-9_-]*$/u.test(identity.skillKey)
+        || (identity.logicalIdentity !== undefined && (typeof identity.logicalIdentity !== 'string' || !identity.logicalIdentity))) {
+        fail('runtimeConfigIdentityMismatch');
+    }
+    // Core validates field definitions and dependency values when it creates this resource.
+    // The reader enforces only this resource's format and permitted projection.
+    if (Object.keys(binding.effectiveValues).some((key) => !binding.allowedKeys.includes(key)))
+        fail('runtimeConfigKeyDenied');
+    return binding;
+}
+async function checkOwner(root, identity) {
+    const ownerPath = path.join(root, '.agent-workflows-owner.json');
+    const stat = await fs.lstat(ownerPath).catch(() => null);
+    if (!stat)
+        return;
+    if (!stat.isFile() || stat.isSymbolicLink())
+        fail('runtimeConfigIdentityMismatch');
+    let owner;
+    try {
+        owner = JSON.parse(await fs.readFile(ownerPath, 'utf8'));
+    }
+    catch {
+        fail('runtimeConfigIdentityMismatch');
+    }
+    if (!isRecord(owner) || owner.schemaVersion !== 3 || owner.owner !== 'agent-workflows'
+        || owner.sourceId !== identity.sourceId || owner.pluginId !== identity.pluginId
+        || owner.plugin !== identity.pluginName || owner.artifactKey !== identity.skillKey
+        || owner.platform !== identity.platform || owner.scope !== identity.scope)
+        fail('runtimeConfigIdentityMismatch');
+}
+async function checkNativeReceipt(root, binding) {
+    if (binding.nativeReceiptPath === undefined)
+        return;
+    if (typeof binding.nativeReceiptPath !== 'string'
+        || (binding.nativeReceiptPath !== '.aw-runtime-native-receipt.json'
+            && !/^(?:\.\.\/)+\.agents-plugin\/aw-codex-native-render\.json$/u.test(binding.nativeReceiptPath))) {
+        fail('runtimeConfigPathUnsafe');
+    }
+    const receiptFile = await assertPathSafe(path.resolve(root, binding.nativeReceiptPath));
+    const stat = await fs.lstat(receiptFile);
+    if (!stat.isFile())
+        fail('runtimeConfigPathUnsafe');
+    let receipt;
+    try {
+        receipt = JSON.parse(await fs.readFile(receiptFile, 'utf8'));
+    }
+    catch {
+        fail('runtimeConfigBindingInvalid');
+    }
+    const identity = binding.installedIdentity;
+    if (!isRecord(receipt) || receipt.schemaVersion !== 1 || receipt.kind !== 'aw-codex-native-render') {
+        fail('runtimeConfigVersionUnsupported');
+    }
+    if (identity.platform !== 'codex' || identity.scope !== 'user' || identity.configScope !== 'user'
+        || receipt.logicalPluginId !== identity.pluginId || receipt.sourceIdentity !== identity.sourceIdentity
+        || receipt.pluginVersion !== identity.pluginVersion || receipt.strategy !== 'shared-user'
+        || !Array.isArray(receipt.targets) || !receipt.targets.some((target) => isRecord(target)
+        && target.id === identity.artifactId && target.skillKey === identity.skillKey)) {
+        fail('runtimeConfigIdentityMismatch');
+    }
+}
+/** Read this Skill's installed effective values from its actual calling resource. */
+export async function readRuntimeConfig(options = {}) {
+    try {
+        if (Object.hasOwn(options, 'expectedRevision')) {
+            fail('runtimeConfigMigrationRequired', 'expectedRevision is no longer supported. Call readRuntimeConfig with from and keys only.');
+        }
+        const { from, keys } = options;
+        if (!Array.isArray(keys) || keys.some((key) => typeof key !== 'string' || !key) || new Set(keys).size !== keys.length) {
+            fail('runtimeConfigKeyDenied');
+        }
+        let caller;
+        try {
+            caller = from instanceof URL || (typeof from === 'string' && from.startsWith('file:'))
+                ? fileURLToPath(from) : from;
+        }
+        catch {
+            fail('runtimeConfigPathUnsafe');
+        }
+        if (typeof caller !== 'string' || !path.isAbsolute(caller))
+            fail('runtimeConfigPathUnsafe');
+        caller = await assertPathSafe(caller);
+        const callerStat = await fs.lstat(caller);
+        if (!callerStat.isFile())
+            fail('runtimeConfigPathUnsafe');
+        let root = path.dirname(caller);
+        let binding;
+        while (true) {
+            const stat = await fs.lstat(path.join(root, BINDING)).catch(() => null);
+            if (stat) {
+                if (!stat.isFile() || stat.isSymbolicLink())
+                    fail('runtimeConfigPathUnsafe');
+                let value;
+                try {
+                    value = JSON.parse(await fs.readFile(path.join(root, BINDING), 'utf8'));
+                }
+                catch {
+                    fail('runtimeConfigBindingInvalid');
+                }
+                binding = validateBinding(value);
+                break;
+            }
+            const parent = path.dirname(root);
+            if (parent === root)
+                fail('runtimeConfigBindingMissing');
+            root = parent;
+        }
+        if (path.basename(root) !== binding.installedIdentity.skillKey)
+            fail('runtimeConfigIdentityMismatch');
+        await regularFile(root, path.relative(root, caller).split(path.sep).join('/'));
+        await regularFile(root, READER);
+        await regularFile(root, 'SKILL.md');
+        if (keys.some((key) => !binding.allowedKeys.includes(key)))
+            fail('runtimeConfigKeyDenied');
+        await checkOwner(root, binding.installedIdentity);
+        await checkNativeReceipt(root, binding);
+        return {
+            installedIdentity: structuredClone(binding.installedIdentity),
+            effectiveValues: Object.fromEntries(keys.filter((key) => Object.hasOwn(binding.effectiveValues, key))
+                .map((key) => [key, structuredClone(binding.effectiveValues[key])])),
+            resourceRoot: root,
+        };
+    }
+    catch (error) {
+        if (error instanceof RuntimeConfigError)
+            throw error;
+        fail('runtimeConfigReadFailed');
+    }
+}
+//# sourceMappingURL=aw-runtime-config.mjs.map

package/dist/authoring/assets/aw-runtime-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aw-runtime-config.mjs","sourceRoot":"","sources":["../../../authoring/assets/aw-runtime-config.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAC1C,MAAM,MAAM,GAAG,+BAA+B,CAAC;AAC/C,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEjG,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAI,EAAE,MAAM,GAAG,0CAA0C;QACnE,KAAK,CAAC,GAAG,IAAI,KAAK,MAAM,2DAA2D,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,SAAS,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3E,SAAS,YAAY,CAAC,KAAK;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;WACxE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;WACtD,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AACvH,CAAC;AACD,KAAK,UAAU,WAAW,CAAC,IAAI,EAAE,QAAQ;IACvC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC7D,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACjG,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,KAAK,UAAU,cAAc,CAAC,IAAI;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AACD,SAAS,eAAe,CAAC,OAAO;IAC9B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC9F,IAAI,CAAC,iCAAiC,EAAE,0GAA0G,CAAC,CAAC;IACtJ,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,CAAC;SACpH,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,gCAAgC,EAAE,wEAAwE,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC;WACxD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;WACxJ,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;WACvE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC;WAClE,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM;WAChE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;QAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACjH,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;QACtH,IAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;WAChG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;WACnD,QAAQ,CAAC,QAAQ,KAAK,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,EAAE;WACnE,CAAC,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;WACpD,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,QAAQ,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;QAC7H,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxC,CAAC;IACD,wFAAwF;IACxF,4EAA4E;IAC5E,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC3H,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,KAAK,UAAU,UAAU,CAAC,IAAI,EAAE,QAAQ;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE;QAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACnF,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAAC,CAAC;IAClH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,iBAAiB;WACjF,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;WAC5E,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,QAAQ;WAC/E,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;QAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;AACrH,CAAC;AACD,KAAK,UAAU,kBAAkB,CAAC,IAAI,EAAE,OAAO;IAC7C,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;QAAE,OAAO;IACpD,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ;WAC5C,CAAC,OAAO,CAAC,iBAAiB,KAAK,iCAAiC;eAC9D,CAAC,6DAA6D,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC;QACvG,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IACrE,MAAM,CAAC;QAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QACnG,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,IAAI,QAAQ,CAAC,WAAW,KAAK,MAAM;WAC5F,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,cAAc,KAAK,QAAQ,CAAC,cAAc;WACnG,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,QAAQ,KAAK,aAAa;WACtF,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;WACnF,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnF,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAO,GAAG,EAAE;IAClD,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,gCAAgC,EAAE,0FAA0F,CAAC,CAAC;QACrI,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACtH,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,GAAG,IAAI,YAAY,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC1F,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAAC,CAAC;QAC5E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5F,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC1D,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC;QACZ,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACxE,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE;oBAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBAC7E,IAAI,KAAK,CAAC;gBACV,IAAI,CAAC;oBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAChF,MAAM,CAAC;oBAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBAAC,CAAC;gBAC9C,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACjC,MAAM;YACR,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,MAAM,KAAK,IAAI;gBAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;YACzD,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,QAAQ;YAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACtG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC3F,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO;YACL,iBAAiB,EAAE,eAAe,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC7D,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;iBAClG,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YAAE,MAAM,KAAK,CAAC;QACrD,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/authoring/scripts/lib/plugin-version-check.mjs

@@ -10,7 +10,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { compareStrictSemVer, parseStrictSemVer } from './semver.mjs';
 import { assertAuthoringPluginPathFence, resolveAuthoringPluginRoot, } from './plugin-root.mjs';
 const execFileAsync = promisify(execFile);
-const EXPECTED_MANIFEST_CONTRACT_VERSION = 13;
+const EXPECTED_MANIFEST_CONTRACT_VERSION = 16;
 const PLUGIN_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u;
 const MAX_GIT_BLOB_BYTES = 50 * 1024 * 1024;

package/dist/authoring/scripts/validate-plugin.mjs

@@ -6,7 +6,7 @@ import { createRequire } from 'node:module';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { getPluginAuthoringAcceptedValues as getCorePluginAuthoringAcceptedValues, getSkillFrontmatterCapabilityRegistry, normalizePluginConfigDefinition, } from '@lesliechan721/aw-plugin-core/manifest';
+import { AW_RUNTIME_CONFIG_READER_PATH, createRuntimeConfigSnapshot, getPluginAuthoringAcceptedValues as getCorePluginAuthoringAcceptedValues, getSkillFrontmatterCapabilityRegistry, normalizePluginConfigDefinition, } from '@lesliechan721/aw-plugin-core/manifest';
 import { checkPluginVersions } from './lib/plugin-version-check.mjs';
 import { scanJavaScriptImportSpecifiers } from './lib/javascript-import-scanner.mjs';
 import { assertAuthoringPluginPathFence, assertCanonicalAuthoringPluginRoot, } from './lib/plugin-root.mjs';
@@ -18,7 +18,7 @@ const CLI_PACKAGE_ROOT = path.basename(authoringRuntimeRoot) === 'dist'
     : authoringRuntimeRoot;
 const errors = [];
 const warnings = [];
-const SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION = 13;
+const SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION = 16;
 let capabilityDiagnostic = null;
 const MAX_SKILL_NAME_LEN = 64;
 const MAX_SKILL_DESCRIPTION_LEN = 1024;
@@ -1631,6 +1631,10 @@ function scanNodeImportContract(pluginDir, entryPaths, options) {
                     continue;
                 }
                 if (!resolved.path) {
+                    const requested = path.posix.normalize(path.posix.join(path.posix.dirname(relativePath), specifier));
+                    if ((options.runtimeConfigSkillRoots ?? []).some((root) => (relativePath.startsWith(`${root}/`)
+                        && requested === path.posix.join(root, AW_RUNTIME_CONFIG_READER_PATH))))
+                        continue;
                     error(`${options.label}: unable to resolve relative import "${specifier}" from "${relativePath}"`);
                     continue;
                 }
@@ -1816,6 +1820,7 @@ function validateArtifactTargetEntry(entry, index, manifest, pluginDir) {
         'skillKey',
         'sourceDirs',
         'runtimeImports',
+        'runtimeConfig',
     ]);
     const id = validateArtifactId(target.id, `${fieldName}.id`);
     const artifactTarget = validateManifestString(target.target, `${fieldName}.target`);
@@ -2013,6 +2018,7 @@ function validateArtifactTargetEntry(entry, index, manifest, pluginDir) {
         roleKey,
         skillKey,
         sourceDirs,
+        runtimeConfig: target.runtimeConfig,
         runtimeImports: Array.isArray(target.runtimeImports) ? target.runtimeImports : [],
     };
 }
@@ -2650,6 +2656,32 @@ function runArtifactRendererFixture(pluginDir, manifest, renderEntry, declaratio
                 ? []
                 : [[key, manifest.config.fields[key]]]));
             const scopedValues = Object.fromEntries(refreshKeys.flatMap((key) => Object.prototype.hasOwnProperty.call(values, key) ? [[key, values[key]]] : []));
+            try {
+                for (const target of scopedDeclarations.filter((declaration) => declaration.runtimeConfig)) {
+                    const definition = normalizePluginConfigDefinition(manifest.config);
+                    createRuntimeConfigSnapshot({
+                        installedIdentity: {
+                            sourceId: 'authoring',
+                            sourceIdentity: 'authoring',
+                            pluginId: `authoring/${manifest.name}`,
+                            pluginName: manifest.name,
+                            pluginVersion: manifest.version,
+                            platform: target.platform,
+                            scope: target.delivery?.mode === 'codex-native' ? 'user' : scope,
+                            configScope,
+                            artifactId: target.id,
+                            skillKey: target.skillKey,
+                        },
+                        declaration: target.runtimeConfig,
+                        definition,
+                        values,
+                    });
+                }
+            }
+            catch (runtimeConfigError) {
+                error(`scripts.artifacts.render fixture (${surface}/${scope}) runtime config failed: ${runtimeConfigError.message}`);
+                continue;
+            }
             fs.writeFileSync(contextPath, JSON.stringify({
                 event,
                 surface: distribution
@@ -2674,7 +2706,9 @@ function runArtifactRendererFixture(pluginDir, manifest, renderEntry, declaratio
                 changedConfigKeys: [],
                 requestedArtifactIds: scopedDeclarations.map((target) => target.id),
                 previousArtifacts: [],
-                artifactSources: scopedDeclarations.map((target) => ({
+                artifactSources: declarations.filter((target) => (target.target === 'codex.skill' || target.target === 'claude.skill' || target.target === 'agent-skills.skill')
+                    && (distribution ? target.distribution === distribution : target.platform === platform)
+                    && target.scopes.includes(scope)).map((target) => ({
                     id: target.id,
                     target: target.target,
                     sourceDirs: target.sourceDirs.map((sourceDir) => path.join(pluginDir, normalizeRelativePath(sourceDir))),
@@ -2789,6 +2823,10 @@ function validateScriptsLightweight(pluginDir, manifest) {
     const runtimeNodeEntries = [];
     let artifactRenderEntry = null;
     let packageMeta = null;
+    const runtimeConfigSkillRoots = (manifest.artifacts?.targets ?? [])
+        .filter((target) => target.runtimeConfig !== undefined)
+        .flatMap((target) => target.sourceDirs ?? [])
+        .map(normalizeRelativePath);
     if (scripts.helpers !== undefined) {
         const helpers = expectRecord(scripts.helpers, 'scripts.helpers');
         if (helpers) {
@@ -2836,6 +2874,7 @@ function validateScriptsLightweight(pluginDir, manifest) {
                         label: 'scripts.node.build import contract',
                         packageMeta,
                         allowDevDependencies: true,
+                        runtimeConfigSkillRoots,
                     });
                 }
             }
@@ -2885,6 +2924,7 @@ function validateScriptsLightweight(pluginDir, manifest) {
                         label: 'scripts.tests.node import contract',
                         packageMeta,
                         allowDevDependencies: true,
+                        runtimeConfigSkillRoots,
                     });
                 }
             }
@@ -2894,6 +2934,7 @@ function validateScriptsLightweight(pluginDir, manifest) {
         label: 'runtime Node import contract',
         packageMeta,
         allowDevDependencies: false,
+        runtimeConfigSkillRoots,
     });
     return artifactRenderEntry;
 }