@lesliechan721/aw-plugin-core 0.1.0-beta.4 → 0.1.0-beta.41

package/dist/manifest.js

@@ -1,12 +1,12 @@
 import { Ajv2020 } from 'ajv/dist/2020.js';
-import schema from '../schemas/plugin-manifest-v1.json' with { type: 'json' };
-export const PLUGIN_MANIFEST_SCHEMA_VERSION = 1;
-export const SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION = 7;
+import schema from '../schemas/plugin-manifest-v3.json' with { type: 'json' };
+export const PLUGIN_MANIFEST_SCHEMA_VERSION = 3;
+export const SOURCE_PLUGIN_MANIFEST_CONTRACT_VERSION = 16;
 const ajv = new Ajv2020({
     allErrors: true,
     strict: true,
 });
-const validateV1 = ajv.compile(schema);
+const validateV3 = ajv.compile(schema);
 export class PluginManifestStructureError extends Error {
     issues;
     constructor(message, issues = []) {
@@ -18,7 +18,7 @@ export class PluginManifestStructureError extends Error {
 function formatIssue(issue) {
     const location = issue.instancePath || '/';
     if (issue.keyword === 'pattern'
-        && (location === '/version' || location.endsWith('/minVersion'))) {
+        && location === '/version') {
         return `${location} must match pattern (expected a strict SemVer 2.0.0 string)`;
     }
     return `${location} ${issue.message ?? 'is invalid'}`;
@@ -31,8 +31,13 @@ export function assertPluginManifestStructure(value) {
         && value.schemaVersion !== PLUGIN_MANIFEST_SCHEMA_VERSION) {
         throw new PluginManifestStructureError(`Unsupported plugin manifest schemaVersion: expected ${PLUGIN_MANIFEST_SCHEMA_VERSION}.`);
     }
-    if (!validateV1(value)) {
-        const issues = validateV1.errors ?? [];
+    if (!validateV3(value)) {
+        const issues = validateV3.errors ?? [];
+        if (issues.some((issue) => issue.instancePath.endsWith('/runtimeConfig')
+            && issue.keyword === 'additionalProperties'
+            && ['resourceVersion', 'artifactIds'].includes(issue.params.additionalProperty))) {
+            throw new PluginManifestStructureError('runtimeConfigMigrationRequired: Remove runtimeConfig.resourceVersion and runtimeConfig.artifactIds; keep only keys and require aw.installed-runtime-config.v2. Rebuild, then sync or reinstall.', issues);
+        }
         throw new PluginManifestStructureError(`Invalid plugin manifest structure: ${issues.map(formatIssue).join('; ')}`, issues);
     }
 }
@@ -50,7 +55,12 @@ export * from './permission-command.js';
 export * from './platform-entries.js';
 export * from './platform-support.js';
 export * from './runtime-export-source.js';
+export * from './runtime-config.js';
 export * from './plugin-script-contract.js';
+export * from './plugin-authoring-capabilities.js';
+export * from './plugin-config.js';
+export * from './aw-capabilities.js';
+export * from './plugin-requirements.js';
 export * from './portable-skill-validation.js';
 export * from './skill-authoring.js';
 export * from './skill-frontmatter-capabilities.js';

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAoB,MAAM,kBAAkB,CAAA;AAE5D,OAAO,MAAM,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAK7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAA;AACxD,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAA;AAExD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;IACtB,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,IAAI;CACb,CAAC,CAAA;AACF,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAyB,MAAM,CAAC,CAAA;AAE9D,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,MAAM,CAAe;IAE9B,YAAY,OAAe,EAAE,SAAwB,EAAE;QACrD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;CACF;AAED,SAAS,WAAW,CAAC,KAAkB;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,IAAI,GAAG,CAAA;IAC1C,IACE,KAAK,CAAC,OAAO,KAAK,SAAS;WACxB,CAAC,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAChE,CAAC;QACD,OAAO,GAAG,QAAQ,6DAA6D,CAAA;IACjF,CAAC;IACD,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,OAAO,IAAI,YAAY,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,IACE,KAAK,KAAK,IAAI;WACX,OAAO,KAAK,KAAK,QAAQ;WACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WACrB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC;WACpC,KAAqC,CAAC,aAAa,KAAK,8BAA8B,EAC1F,CAAC;QACD,MAAM,IAAI,4BAA4B,CACpC,uDAAuD,8BAA8B,GAAG,CACzF,CAAA;IACH,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAA;QACtC,MAAM,IAAI,4BAA4B,CACpC,sCAAsC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC1E,MAAM,CACP,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,6BAA6B,CAAC,KAAK,CAAC,CAAA;IACpC,OAAO;QACL,GAAG,KAAK;QACR,aAAa,EAAE,8BAA8B;KAC9C,CAAA;AACH,CAAC;AAED,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qCAAqC,CAAA;AACnD,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/plugin-authoring-capabilities.d.ts

@@ -0,0 +1,21 @@
+export declare const PLUGIN_AUTHORING_CAPABILITY_SURFACES: readonly ["manifest", "build-config", "extensions", "slash-commands", "mcp-apps", "config", "pre-apply", "artifacts"];
+export type PluginAuthoringCapabilitySurfaceName = (typeof PLUGIN_AUTHORING_CAPABILITY_SURFACES)[number];
+export type PluginAuthoringAcceptedValue = string | number | boolean;
+export interface PluginAuthoringCapabilityEntry {
+    field: string;
+    type: string;
+    required: boolean | string;
+    acceptedValues?: readonly PluginAuthoringAcceptedValue[] | string;
+}
+export interface PluginAuthoringCapabilitySurface {
+    surface: PluginAuthoringCapabilitySurfaceName;
+    entries: readonly PluginAuthoringCapabilityEntry[];
+}
+export interface PluginAuthoringCapabilityRegistry {
+    schemaVersion: 1;
+    surfaces: Readonly<Record<PluginAuthoringCapabilitySurfaceName, PluginAuthoringCapabilitySurface>>;
+}
+export declare function getPluginAuthoringCapabilities(): PluginAuthoringCapabilityRegistry;
+export declare function getPluginAuthoringCapabilitySurface(surface: PluginAuthoringCapabilitySurfaceName): PluginAuthoringCapabilitySurface;
+export declare function getPluginAuthoringAcceptedValues(surface: PluginAuthoringCapabilitySurfaceName, field: string): readonly PluginAuthoringAcceptedValue[];
+export declare function getPluginCoreVersion(): string;

package/dist/plugin-authoring-capabilities.js

@@ -0,0 +1,210 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PLUGIN_SCRIPT_TIMEOUT_MAX_MS, PLUGIN_SCRIPT_TIMEOUT_MIN_MS, } from './plugin-script-contract.js';
+import { PUBLIC_HOOK_EVENTS } from './hooks-contract.js';
+export const PLUGIN_AUTHORING_CAPABILITY_SURFACES = [
+    'manifest',
+    'build-config',
+    'extensions',
+    'slash-commands',
+    'mcp-apps',
+    'config',
+    'pre-apply',
+    'artifacts',
+];
+const registry = {
+    schemaVersion: 1,
+    surfaces: {
+        manifest: {
+            surface: 'manifest',
+            entries: [
+                { field: 'schemaVersion', type: 'literal 3', required: true, acceptedValues: [3] },
+                { field: 'name', type: 'kebab-case string', required: true },
+                { field: 'version', type: 'stable strict SemVer', required: true },
+                { field: 'description', type: 'non-empty string', required: true },
+                { field: 'requires.aw.capabilities', type: 'unique AW capability ID[]', required: false },
+                { field: 'dependencies', type: 'unique plugin-name[]', required: false },
+                { field: 'skills', type: './ plugin-relative path', required: false },
+                { field: 'slashCommands', type: './ plugin-relative path', required: false },
+                { field: 'mcpServers', type: './ plugin-relative path', required: false },
+                { field: 'apps', type: './ plugin-relative path', required: false },
+                { field: 'distributions.agentSkills', type: '{skills?}', required: false },
+                { field: 'distributions.agentSkills.skills', type: './ plugin-relative path', required: false },
+                { field: 'marketplace.category', type: 'non-empty string', required: true },
+                { field: 'marketplace.tags', type: 'string[]', required: false },
+                { field: 'marketplace.strict', type: 'boolean', required: true },
+                { field: 'marketplace.policy.installation', type: 'enum', required: true, acceptedValues: ['AVAILABLE', 'NOT_AVAILABLE', 'INSTALLED_BY_DEFAULT'] },
+                { field: 'marketplace.policy.authentication', type: 'enum', required: true, acceptedValues: ['ON_INSTALL', 'ON_USE'] },
+                { field: 'marketplace.policy.products', type: 'unique enum[]', required: false, acceptedValues: ['CODEX', 'CLAUDE'] },
+                { field: 'interface.displayName', type: 'non-empty string', required: false },
+                { field: 'interface.shortDescription', type: 'non-empty string', required: false },
+                { field: 'interface.capabilities', type: 'string[]', required: false },
+            ],
+        },
+        'build-config': {
+            surface: 'build-config',
+            entries: [
+                { field: 'buildConfig.cacheable', type: 'literal true', required: false, acceptedValues: [true] },
+                { field: 'buildConfig.templates', type: '{vars,include}', required: false },
+                { field: 'buildConfig.templates.vars.<key>', type: '{claude:string|boolean,codex:string|boolean}', required: 'with buildConfig.templates' },
+                { field: 'buildConfig.templates.include', type: 'string[]', required: 'with buildConfig.templates' },
+                { field: 'buildConfig.fileRules', type: 'platform include/exclude object', required: false },
+                { field: 'buildConfig.fileRules.<platform>', type: '{include,exclude}', required: false, acceptedValues: ['claude', 'codex'] },
+                { field: 'buildConfig.manifestOverrides.claude', type: 'object', required: false, acceptedValues: ['outputStyles', 'lspServers', 'userConfig', 'channels'] },
+                { field: 'buildConfig.runtimeExports', type: '{name,source,requires}[]', required: false },
+                { field: 'buildConfig.runtimeExports[].requires.aw.capabilities', type: 'unique AW capability ID[]', required: true },
+                { field: 'buildConfig.buildImports', type: '{plugin,export,env}[]', required: false },
+                { field: 'buildConfig.skillRuntimeFiles', type: '{skill,target,platforms?,distributions?,source|import}[]', required: false },
+                { field: 'buildConfig.skillRuntimeFiles[].platforms', type: 'unique enum[]', required: false, acceptedValues: ['codex', 'claude'] },
+                { field: 'buildConfig.skillRuntimeFiles[].distributions', type: 'unique enum[]', required: false, acceptedValues: ['agent-skills'] },
+                { field: 'buildConfig.generatedSkillRuntimeFiles', type: '{skill,target,distributions?}[]', required: false },
+                { field: 'buildConfig.generatedSkillRuntimeFiles[].distributions', type: 'unique enum[]', required: false, acceptedValues: ['agent-skills'] },
+            ],
+        },
+        extensions: {
+            surface: 'extensions',
+            entries: [
+                { field: 'extensions.instructions', type: '{name,title,content,paths?,agentOverrides?}[]', required: false },
+                { field: 'extensions.permissions', type: '{name,allow?,ask?,deny?,agentOverrides?}[]', required: false },
+                { field: 'extensions.hooks', type: '{event,matcher?,command,agentOverrides?}[]', required: false },
+                { field: 'extensions.hooks[].event', type: 'enum', required: true, acceptedValues: PUBLIC_HOOK_EVENTS },
+                { field: 'extensions.nativeHooks.claude', type: 'native hook[]', required: false },
+                { field: 'extensions.nativeHooks.codex', type: 'native hook[]', required: false },
+                { field: 'extensions.agents', type: '{name,description,prompt,tools?,agentOverrides?}[]', required: false },
+            ],
+        },
+        'slash-commands': {
+            surface: 'slash-commands',
+            entries: [
+                { field: 'description', type: 'string', required: true },
+                { field: 'claude', type: 'frontmatter object', required: false, acceptedValues: ['description', 'allowed-tools', 'model', 'argument-hint', 'shell'] },
+                { field: 'claude.shell', type: 'enum', required: false, acceptedValues: ['bash', 'powershell'] },
+                { field: 'codex.description', type: 'string', required: false },
+                { field: 'codex.interface', type: 'display metadata object', required: false, acceptedValues: ['display_name', 'short_description', 'icon_small', 'icon_large', 'brand_color', 'default_prompt'] },
+                { field: 'codex.generated.policy.allow_implicit_invocation', type: 'literal false', required: true, acceptedValues: [false] },
+            ],
+        },
+        'mcp-apps': {
+            surface: 'mcp-apps',
+            entries: [
+                { field: 'mcpServers.<key>.command', type: 'string', required: 'stdio transport' },
+                { field: 'mcpServers.<key>.args', type: 'string[]', required: false },
+                { field: 'mcpServers.<key>.env', type: 'string map', required: false },
+                { field: 'mcpServers.<key>.headers', type: 'string map', required: false },
+                { field: 'mcpServers.<key>.url', type: 'URL string', required: 'HTTP transport' },
+                { field: 'apps.<key>.id', type: 'non-empty string', required: true },
+            ],
+        },
+        config: {
+            surface: 'config',
+            entries: [
+                { field: 'config.schemaVersion', type: 'literal 3 or 4; omitted for legacy Config v2', required: false, acceptedValues: [3, 4] },
+                { field: 'config.definitions', type: 'local field definition map; at most 64 entries', required: false },
+                { field: 'config.fields.<key>.$ref', type: '#/config/definitions/Name; at most 8 reference edges, including child references; only title/description/default/required overrides', required: false },
+                { field: 'config.fields', type: 'field map; at most 256 entries for v3/v4', required: 'with config' },
+                { field: 'config.fields.<key>.type', type: 'enum', required: 'unless $ref', acceptedValues: ['string', 'number', 'boolean', 'object', 'array'] },
+                { field: 'config.fields.<key>.title', type: 'string', required: false },
+                { field: 'config.fields.<key>.description', type: 'string', required: false },
+                { field: 'config.fields.<key>.default', type: 'string|number|boolean|object|homogeneous array', required: false },
+                { field: 'config.fields.<key>.required', type: 'boolean', required: false },
+                { field: 'config.fields.<key>.sensitive', type: 'literal true; top-level string fields only; incompatible with default or choices', required: false, acceptedValues: [true] },
+                { field: 'config.fields.<key>.choices', type: '{allowCustom,presets}', required: false },
+                { field: 'config.fields.<key>.choices.allowCustom', type: 'boolean', required: 'with choices' },
+                { field: 'config.fields.<key>.choices.presets', type: '{id,title,description?,value,recommended?}[]', required: 'with choices' },
+                { field: 'config.fields.<key>.validation', type: 'type-specific validation object', required: false },
+                { field: 'config.fields.<key>.validation.minItems', type: 'integer 0..128', required: false },
+                { field: 'config.fields.<key>.validation.maxItems', type: 'integer 0..128', required: false },
+                { field: 'config.fields.<key>.validation.uniqueItems', type: 'boolean; default false', required: false },
+                { field: 'config.fields.<key>.validation.uniqueBy', type: 'own fixed scalar property; Config v3/v4 object arrays only', required: false },
+                { field: 'config.fields.<key>.valueRef', type: '{field,key,label?,include?}; non-sensitive scalar; Config v3/v4; source is a fixed-object array with matching uniqueBy and key type; included values are reserved', required: false },
+                { field: 'config.fields.<key>.properties.<property>.valueRef', type: '{field,key,label?,include?}; shallow scalar reference; complete candidate and source dependency validation', required: false },
+                { field: 'config.fields.<key>.items', type: 'one homogeneous scalar or shallow object schema; arrays only in Config v3/v4', required: 'for array field' },
+                { field: 'config.fields.<key>.validation.maxLength', type: 'integer 0..4096', required: 'with pattern' },
+                { field: 'config.fields.<key>.validation.pattern', type: 'RE2 Unicode pattern up to 512 code points', required: false },
+                { field: 'config.fields.<key>.validation.format', type: 'enum', required: false, acceptedValues: ['identifier', 'slug', 'semver', 'url', 'hostname', 'email'] },
+                { field: 'config.fields.<key>.validation.key.maxLength', type: 'integer 0..4096', required: 'with key.pattern' },
+                { field: 'config.fields.<key>.validation.key.pattern', type: 'RE2 Unicode pattern up to 512 code points', required: false },
+                { field: 'config.fields.<key>.properties', type: 'scalar child field map; v4 also permits leaf scalar arrays and scalar key-value objects', required: 'for fixed object properties' },
+                { field: 'config.fields.<key>.const', type: 'typed non-sensitive scalar constant; Config v4; no implicit default or required relaxation', required: false },
+                { field: 'config.fields.<key>.variants', type: 'finite fixed-object branch map; Config v4; common plus selected branch properties; at most 32 combined properties', required: false },
+                { field: 'config.fields.<key>.variants.discriminator', type: 'own common string property; validated before case selection', required: 'with variants' },
+                { field: 'config.fields.<key>.variants.cases', type: '1..32 named {properties} branches; cannot override common properties', required: 'with variants' },
+                { field: 'config.fields.<key>.variants.missing', type: 'declared case name; used only when discriminator is absent', required: false },
+                { field: 'config.fields.<key>.variants.otherwise', type: '{properties}; used for other valid discriminator values', required: false },
+                { field: 'config.fields.<key>.additionalProperties', type: 'false | scalar child field', required: 'false for fixed objects; scalar child field for key-value objects' },
+                { field: 'config.presentation.summaries', type: 'named join summaries; v3/v4; at most 4 parts, 8 separator code points, 128 path characters, 256 output code points', required: false },
+                { field: 'config.presentation.summaries.<name>.parts[].path', type: 'single own fixed scalar property JSON Pointer; ~0 and ~1 decoding', required: true },
+                { field: 'config.presentation.summaries.<name>.parts[].format', type: 'enum', required: false, acceptedValues: ['raw', 'choiceTitle'] },
+                { field: 'config.presentation.fieldViews.<key>.summary', type: 'local summary name for a fixed object field; v3/v4', required: false },
+                { field: 'config.presentation.fieldViews.<key>.itemSummary', type: 'local summary name for fixed object array items; v3/v4', required: false },
+                { field: 'config.presentation.groups', type: 'group[]', required: false },
+            ],
+        },
+        'pre-apply': {
+            surface: 'pre-apply',
+            entries: [
+                { field: 'scripts.preApply', type: '{path,timeoutMs?}', required: false },
+                { field: 'scripts.preApply.path', type: './ Node path', required: true },
+                { field: 'scripts.preApply.timeoutMs', type: 'integer', required: false, acceptedValues: `${PLUGIN_SCRIPT_TIMEOUT_MIN_MS}..${PLUGIN_SCRIPT_TIMEOUT_MAX_MS}` },
+                { field: 'scripts.helpers.config', type: './ Node path', required: false },
+                { field: 'scripts.node.packageRoot', type: './ package directory path', required: false },
+                { field: 'scripts.node.build', type: '{runner,path,args?}', required: false },
+                { field: 'scripts.node.build.runner', type: 'literal node', required: true, acceptedValues: ['node'] },
+                { field: 'scripts.tests.node', type: './ Node path[]', required: false },
+            ],
+        },
+        artifacts: {
+            surface: 'artifacts',
+            entries: [
+                { field: 'scripts.artifacts.render', type: '{runner,path,args?}', required: 'with artifacts.targets' },
+                { field: 'scripts.artifacts.render.runner', type: 'literal node', required: true, acceptedValues: ['node'] },
+                { field: 'rendererContext.requestedArtifactIds', type: 'non-empty unique artifact id[]', required: true },
+                { field: 'artifacts.targets', type: 'artifact target[]', required: false },
+                { field: 'artifacts.targets[].id', type: 'surface/scope-unique stable identifier; globally unique for codex-native', required: true },
+                { field: 'artifacts.targets[].platform', type: 'enum', required: 'for native targets', acceptedValues: ['codex', 'claude'] },
+                { field: 'artifacts.targets[].distribution', type: 'enum', required: 'for portable targets', acceptedValues: ['agent-skills'] },
+                { field: 'artifacts.targets[].target', type: 'enum', required: true, acceptedValues: ['codex.developerInstructionsBlock', 'codex.agentRole', 'codex.skill', 'claude.skill', 'agent-skills.skill'] },
+                { field: 'artifacts.targets[].kind', type: 'enum', required: false, acceptedValues: ['instruction', 'codexRole', 'skill'] },
+                { field: 'artifacts.targets[].projectManagedKind', type: 'enum', required: false, acceptedValues: ['skill', 'mcpServer', 'instruction', 'permission', 'hook', 'agent'] },
+                { field: 'artifacts.targets[].scopes', type: 'unique enum[]', required: true, acceptedValues: ['user', 'project'] },
+                { field: 'artifacts.targets[].states', type: 'unique enum[]', required: true, acceptedValues: ['present', 'disabled'] },
+                { field: 'artifacts.targets[].refreshKeys', type: 'unique config key[]', required: true },
+                { field: 'artifacts.targets[].delivery', type: 'codex.skill delivery union', required: 'for codex.skill' },
+                { field: 'artifacts.targets[].delivery.mode', type: 'enum', required: 'with delivery', acceptedValues: ['codex-native', 'aw-extension'] },
+                { field: 'artifacts.targets[].delivery.identity', type: 'literal shared', required: 'when delivery.mode is codex-native', acceptedValues: ['shared'] },
+                { field: 'artifacts.targets[].delivery.renderProfile', type: 'literal user', required: 'when delivery.mode is codex-native', acceptedValues: ['user'] },
+                { field: 'artifacts.targets[].requiresCodexProjectConfig', type: 'boolean', required: false },
+                { field: 'artifacts.targets[].roleKey', type: 'stable role key', required: 'for codex.agentRole' },
+                { field: 'artifacts.targets[].skillKey', type: 'stable Skill key; globally unique for codex-native', required: 'for Skill targets' },
+                { field: 'artifacts.targets[].sourceDirs', type: './ plugin-relative path[]', required: false },
+                { field: 'artifacts.targets[].runtimeConfig', type: '{keys}; non-sensitive installed Skill config', required: false },
+                { field: 'artifacts.targets[].runtimeConfig.keys', type: 'non-empty unique declared refresh key[]; dependency closure must be non-sensitive', required: 'with runtimeConfig' },
+                { field: 'artifacts.targets[].runtimeImports', type: '{name,plugin,export}[]', required: false },
+            ],
+        },
+    },
+};
+export function getPluginAuthoringCapabilities() {
+    return registry;
+}
+export function getPluginAuthoringCapabilitySurface(surface) {
+    return registry.surfaces[surface];
+}
+export function getPluginAuthoringAcceptedValues(surface, field) {
+    const entries = registry.surfaces[surface].entries;
+    const entry = entries.find((candidate) => candidate.field === field);
+    if (!entry || !Array.isArray(entry.acceptedValues)) {
+        throw new Error(`Plugin authoring capability ${surface}.${field} has no accepted values.`);
+    }
+    return entry.acceptedValues;
+}
+export function getPluginCoreVersion() {
+    const packageJsonPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    if (typeof packageJson.version !== 'string') {
+        throw new Error('Cannot read @lesliechan721/aw-plugin-core package version.');
+    }
+    return packageJson.version;
+}
+//# sourceMappingURL=plugin-authoring-capabilities.js.map

package/dist/plugin-authoring-capabilities.js.map

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

package/dist/plugin-config.d.ts

@@ -0,0 +1,39 @@
+import type { PluginConfigDefinition, PluginConfigObjectField, PluginConfigObjectPropertyField, PluginConfigPreset, PluginConfigScalar, PluginConfigSchemaField, PluginConfigValidationIssue, PluginConfigValue } from './types.js';
+export declare const PLUGIN_CONFIG_V3_MAX_DEFINITIONS = 64;
+export declare const PLUGIN_CONFIG_V3_MAX_FIELDS = 256;
+/** Count each followed $ref edge, including edges from object properties; inline objects add zero. */
+export declare const PLUGIN_CONFIG_V3_MAX_REF_DEPTH = 8;
+export declare const PLUGIN_CONFIG_SUMMARY_MAX_PARTS = 4;
+export declare const PLUGIN_CONFIG_SUMMARY_MAX_SEPARATOR_CODE_POINTS = 8;
+export declare const PLUGIN_CONFIG_SUMMARY_MAX_PATH_LENGTH = 128;
+export declare const PLUGIN_CONFIG_SUMMARY_MAX_CODE_POINTS = 256;
+export declare const PLUGIN_CONFIG_ARRAY_MAX_ITEMS = 128;
+export declare const PLUGIN_CONFIG_ARRAY_MAX_BYTES = 262144;
+export interface PluginConfigObjectPropertiesResolution {
+    properties: Record<string, PluginConfigObjectPropertyField>;
+    variant?: {
+        kind: 'case' | 'otherwise';
+        case?: string;
+    };
+    issues: PluginConfigValidationIssue[];
+}
+/** Resolve visible and allowed own properties without changing the supplied value. */
+export declare function resolvePluginConfigObjectProperties(definition: PluginConfigObjectField, value: unknown, field?: string): PluginConfigObjectPropertiesResolution;
+export declare function validatePluginConfigValue(definition: PluginConfigSchemaField, value: unknown, field?: string): PluginConfigValidationIssue[];
+export declare function validatePluginConfigValue(field: string, definition: PluginConfigSchemaField, value: unknown): PluginConfigValidationIssue[];
+export declare function validatePluginConfigDocument(definition: PluginConfigDefinition, value: unknown): PluginConfigValidationIssue[];
+/** Returns validation dependencies only; callers still project their original allowed keys. */
+export declare function getPluginConfigDependencyKeys(definition: PluginConfigDefinition, keys: readonly string[]): string[];
+/** Validate one effective candidate, including complete sources required by selected fields. */
+export declare function validatePluginConfigCandidate(definition: PluginConfigDefinition, values: unknown, keys?: readonly string[]): PluginConfigValidationIssue[];
+export declare function canonicalizePluginConfigValue(value: PluginConfigValue): PluginConfigValue;
+export declare function canonicalizePluginConfigValues(values: Readonly<Record<string, PluginConfigValue>>): Record<string, PluginConfigValue>;
+export declare function stablePluginConfigStringify(value: PluginConfigValue): string;
+export declare function matchPluginConfigPreset(definition: PluginConfigSchemaField, value: PluginConfigValue): PluginConfigPreset | undefined;
+export declare function validatePluginConfigPreset(definition: PluginConfigSchemaField, preset: PluginConfigPreset, field?: string): PluginConfigValidationIssue[];
+export type RedactedPluginConfigValue = PluginConfigValue | '[redacted]' | Record<string, PluginConfigScalar | '[redacted]'>;
+export declare function redactPluginConfigValue(definition: PluginConfigSchemaField, value: PluginConfigValue): RedactedPluginConfigValue;
+export declare function formatPluginConfigIssue(issue: PluginConfigValidationIssue): string;
+/** Decode exactly one local property token, never a traversal path. */
+export declare function decodePluginConfigSummaryPath(value: string): string;
+export declare function normalizePluginConfigDefinition(value: unknown, path?: string): PluginConfigDefinition;