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

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 = 18;
 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,11 +55,17 @@ 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';
 export * from './slash-commands.js';
 export * from './template-engine.js';
+export * from './managed-commands.js';
+export * from './native-tools.js';
 //# sourceMappingURL=manifest.js.map

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,oCAAoC,CAAA;AAClD,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/native-runtime/reader-runtime.mjs

@@ -0,0 +1,34 @@
+export const NATIVE_TOOL_CONTEXT_ENV = 'AW_NATIVE_TOOL_CONTEXT';
+
+// This standalone module is also the canonical text emitted into plugin bundles.
+export function readNativeTool(key, protocol, environment = process.env) {
+  function reject() {
+    const error = new Error('nativeContextInvalid');
+    error.code = 'nativeContextInvalid';
+    throw error;
+  }
+  function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+  }
+  if (typeof key !== 'string' || !key || typeof protocol !== 'string' || !protocol) reject();
+  const names = Object.keys(environment).filter((name) => name.toUpperCase() === 'AW_NATIVE_TOOL_CONTEXT');
+  if (names.length !== 1 || typeof environment[names[0]] !== 'string' || environment[names[0]].length > 128 * 1024) reject();
+  let context;
+  try { context = JSON.parse(environment[names[0]]); } catch { reject(); }
+  if (!record(context) || context.schemaVersion !== 1 || Object.keys(context).sort().join(',') !== 'schemaVersion,tools'
+    || !record(context.tools) || Object.keys(context.tools).length > 64) reject();
+  for (const [name, value] of Object.entries(context.tools)) {
+    if (!name || !record(value) || typeof value.protocol !== 'string' || !value.protocol) reject();
+    if (value.state === 'ready') {
+      if (Object.keys(value).sort().join(',') !== 'executable,protocol,state'
+        || typeof value.executable !== 'string' || value.executable.length > 32_768
+        || !/^(?:\/[^\x00]*|[A-Za-z]:[\\/][^\x00]*|\\\\[^\x00]+)$/.test(value.executable)
+        || /[\x00-\x1f\x7f]/.test(value.executable)) reject();
+    } else if (value.state === 'unavailable') {
+      if (Object.keys(value).sort().join(',') !== 'code,protocol,state'
+        || typeof value.code !== 'string' || !/^[a-zA-Z][a-zA-Z0-9]{0,95}$/.test(value.code)) reject();
+    } else reject();
+  }
+  if (!Object.hasOwn(context.tools, key) || context.tools[key].protocol !== protocol) reject();
+  return Object.freeze({ ...context.tools[key] });
+}

package/dist/native-runtime/reader.d.mts

@@ -0,0 +1,6 @@
+export interface NativeToolReady { state: 'ready'; protocol: string; executable: string }
+export interface NativeToolUnavailable { state: 'unavailable'; protocol: string; code: string }
+export interface NativeToolContext { schemaVersion: 1; tools: Record<string, NativeToolReady | NativeToolUnavailable> }
+export const NATIVE_TOOL_CONTEXT_ENV: 'AW_NATIVE_TOOL_CONTEXT';
+export function readNativeTool(key: string, protocol: string, environment?: Record<string, string | undefined>): NativeToolReady | NativeToolUnavailable;
+export function createNativeToolReaderSource(): string;

package/dist/native-runtime/reader.mjs

@@ -0,0 +1,11 @@
+import { readFileSync } from 'node:fs';
+
+export { NATIVE_TOOL_CONTEXT_ENV, readNativeTool } from './reader-runtime.mjs';
+
+// Read the standalone source, rather than a function transformed by the caller's
+// test runner or bundler. Normalize checkout line endings for identical bundles.
+const readerSource = readFileSync(new URL('./reader-runtime.mjs', import.meta.url), 'utf8').replace(/\r\n/g, '\n');
+
+export function createNativeToolReaderSource() {
+  return readerSource;
+}

package/dist/native-tools.d.ts

@@ -0,0 +1,48 @@
+import type { NormalizedPluginManifest } from './types.js';
+export { createNativeToolReaderSource } from './native-runtime/reader.mjs';
+export declare const DEFAULT_NATIVE_TOOL_READER = "./.aw/native-tool-reader.mjs";
+export declare const NATIVE_TOOLS_CAPABILITY = "aw.native-tools.v2";
+export interface NativeToolDefinition {
+    key: string;
+    protocol: string;
+}
+export type NativeToolBinding = {
+    key: string;
+    platforms: ['win32'];
+} & ({
+    policy: 'required';
+    fallback?: never;
+} | {
+    policy: 'preferred';
+    fallback: string;
+});
+export interface NativeToolConsumer {
+    kind: 'managed-command-set' | 'plugin-test';
+    key: string;
+    tools: NativeToolBinding[];
+}
+export interface NativeTools {
+    reader: string;
+    definitions: NativeToolDefinition[];
+    consumers: NativeToolConsumer[];
+}
+export type NativeToolClosure = NativeTools;
+export declare function normalizeNativeTools(value: unknown): NativeTools;
+export declare function validateNativeToolsManifest(manifest: NormalizedPluginManifest, options?: {
+    source?: boolean;
+}): void;
+export declare function normalizeNativeToolClosure(value: unknown): NativeToolClosure;
+export declare function loadPluginNativeToolClosure(pluginRoot: string, manifest: NormalizedPluginManifest): Promise<NativeToolClosure | undefined>;
+export declare function getNativeToolConsumerClosure(closure: NativeToolClosure | undefined, kind: NativeToolConsumer['kind'], key: string | readonly string[]): NativeToolClosure | undefined;
+/** Returns the generated reader and protocol requirements for the selected consumers. */
+export declare function materializeNativeToolClosureFiles(closure: NativeToolClosure): {
+    closure: NativeToolClosure;
+    files: Record<string, string>;
+};
+export declare function preparePluginNativeTools(pluginRoot: string, manifest: NormalizedPluginManifest): Promise<string | undefined>;
+export declare function validateNativeToolClosureFiles(root: string, closure: NativeToolClosure): Promise<void>;
+export declare function copyNativeToolClosureFiles(options: {
+    sourceRoot: string;
+    destinationRoot: string;
+    closure: NativeToolClosure;
+}): Promise<NativeToolClosure>;

package/dist/native-tools.js

@@ -0,0 +1,192 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { createNativeToolReaderSource } from './native-runtime/reader.mjs';
+import { resolveCanonicalRuntimeSourceIdentity } from './runtime-export-source.js';
+export { createNativeToolReaderSource } from './native-runtime/reader.mjs';
+export const DEFAULT_NATIVE_TOOL_READER = './.aw/native-tool-reader.mjs';
+export const NATIVE_TOOLS_CAPABILITY = 'aw.native-tools.v2';
+function object(value, field, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`Invalid ${field}: expected an object.`);
+    if (Object.keys(value).some((key) => !keys.includes(key)))
+        throw new Error(`Invalid ${field}: unknown field.`);
+    return value;
+}
+function name(value, field) {
+    if (typeof value !== 'string' || !/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/u.test(value))
+        throw new Error(`Invalid ${field}: expected a Name.`);
+    return value;
+}
+function protocol(value, field) {
+    if (typeof value !== 'string' || value.length > 128 || !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/u.test(value))
+        throw new Error(`Invalid ${field}: expected a protocol ID.`);
+    return value;
+}
+function relativeFile(value, field) {
+    if (typeof value !== 'string' || !value.startsWith('./') || value.length > 512
+        || /[\\:\u0000-\u001f\u007f-\u009f<>"|?*]/u.test(value)
+        || value.slice(2).split('/').some((segment) => !segment || segment === '.' || segment === '..'
+            || /[. ]$/u.test(segment) || /^(?:con|prn|aux|nul|com[0-9]|lpt[0-9])(?:\.|$)/iu.test(segment))
+        || value.slice(2).split('/').some((segment) => ['.git', 'node_modules', 'evals', 'reports', '.release', '.tmp'].includes(segment))) {
+        throw new Error(`Invalid ${field}: expected a safe plugin-relative file.`);
+    }
+    return value;
+}
+function array(value, field, max) {
+    if (!Array.isArray(value) || value.length < 1 || value.length > max)
+        throw new Error(`Invalid ${field}: expected 1..${max} entries.`);
+    return value;
+}
+function unique(values, field) {
+    if (new Set(values).size !== values.length)
+        throw new Error(`Invalid ${field}: duplicate entry.`);
+}
+function compare(left, right) { return left < right ? -1 : left > right ? 1 : 0; }
+function normalizeConsumers(value) {
+    const consumers = array(value, 'nativeTools.consumers', 128).map((value) => {
+        const input = object(value, 'nativeTools consumer', ['kind', 'key', 'tools']);
+        if (input.kind !== 'managed-command-set' && input.kind !== 'plugin-test')
+            throw new Error('Invalid nativeTools consumer.kind.');
+        const tools = array(input.tools, 'nativeTools consumer.tools', 32).map((value) => {
+            const binding = object(value, 'nativeTools binding', ['key', 'platforms', 'policy', 'fallback']);
+            if (!Array.isArray(binding.platforms) || binding.platforms.length !== 1 || binding.platforms[0] !== 'win32')
+                throw new Error('Invalid nativeTools binding.platforms: only win32 is supported.');
+            const base = { key: name(binding.key, 'nativeTools binding.key'), platforms: ['win32'] };
+            if (binding.policy === 'preferred')
+                return { ...base, policy: 'preferred', fallback: name(binding.fallback, 'nativeTools binding.fallback') };
+            if (binding.policy !== 'required' || binding.fallback !== undefined)
+                throw new Error('Invalid nativeTools binding: required forbids fallback; preferred requires fallback.');
+            return { ...base, policy: 'required' };
+        });
+        unique(tools.map((tool) => tool.key), 'nativeTools consumer.tools');
+        return { kind: input.kind, key: name(input.key, 'nativeTools consumer.key'), tools: tools.sort((a, b) => compare(a.key, b.key)) };
+    });
+    unique(consumers.map((consumer) => `${consumer.kind}/${consumer.key}`), 'nativeTools.consumers');
+    return consumers.sort((a, b) => compare(`${a.kind}/${a.key}`, `${b.kind}/${b.key}`));
+}
+function validateReferences(definitions, consumers) {
+    const keys = new Set(definitions.map((entry) => entry.key));
+    const used = new Set(consumers.flatMap((entry) => entry.tools.map((tool) => tool.key)));
+    if ([...used].some((key) => !keys.has(key)))
+        throw new Error('Invalid nativeTools: unknown tool reference.');
+    if ([...keys].some((key) => !used.has(key)))
+        throw new Error('Invalid nativeTools: unused tool definition.');
+}
+export function normalizeNativeTools(value) {
+    const input = object(value, 'nativeTools', ['reader', 'definitions', 'consumers']);
+    const reader = relativeFile(input.reader === undefined ? DEFAULT_NATIVE_TOOL_READER : input.reader, 'nativeTools.reader');
+    if (!reader.endsWith('.mjs'))
+        throw new Error('Invalid nativeTools.reader: expected an .mjs file.');
+    const definitions = array(input.definitions, 'nativeTools.definitions', 32).map((value) => {
+        const entry = object(value, 'nativeTools definition', ['key', 'protocol']);
+        return { key: name(entry.key, 'nativeTools definition.key'), protocol: protocol(entry.protocol, 'nativeTools definition.protocol') };
+    }).sort((a, b) => compare(a.key, b.key));
+    unique(definitions.map((entry) => entry.key), 'nativeTools.definitions');
+    unique(definitions.map((entry) => entry.key.toLowerCase()), 'nativeTools.definitions generated file names');
+    const consumers = normalizeConsumers(input.consumers);
+    validateReferences(definitions, consumers);
+    return { reader, definitions, consumers };
+}
+export function validateNativeToolsManifest(manifest, options = {}) {
+    if (!manifest.nativeTools)
+        return;
+    for (const consumer of manifest.nativeTools.consumers) {
+        if (consumer.kind === 'managed-command-set') {
+            if (!manifest.managedCommands?.sets.some((set) => set.set === consumer.key))
+                throw new Error('Invalid nativeTools consumer: unknown managed command set.');
+        }
+        else if (consumer.key !== 'node' || (options.source && (manifest.scripts?.tests?.node?.length ?? 0) === 0)) {
+            throw new Error('Invalid nativeTools consumer: unknown plugin test runner.');
+        }
+    }
+}
+export function normalizeNativeToolClosure(value) {
+    return normalizeNativeTools(value);
+}
+export async function loadPluginNativeToolClosure(pluginRoot, manifest) {
+    if (!manifest.nativeTools)
+        return undefined;
+    validateNativeToolsManifest(manifest);
+    const closure = normalizeNativeToolClosure(manifest.nativeTools);
+    if (await fs.pathExists(path.resolve(pluginRoot, closure.reader))) {
+        await validateNativeToolReader(pluginRoot, closure.reader);
+    }
+    return closure;
+}
+export function getNativeToolConsumerClosure(closure, kind, key) {
+    if (!closure)
+        return undefined;
+    const normalized = normalizeNativeToolClosure(closure);
+    const keys = new Set(typeof key === 'string' ? [key] : key);
+    const consumers = normalized.consumers.filter((entry) => entry.kind === kind && keys.has(entry.key));
+    if (consumers.length === 0)
+        return undefined;
+    const tools = new Set(consumers.flatMap((entry) => entry.tools.map((tool) => tool.key)));
+    return { reader: normalized.reader, definitions: normalized.definitions.filter((entry) => tools.has(entry.key)), consumers };
+}
+/** Returns the generated reader and protocol requirements for the selected consumers. */
+export function materializeNativeToolClosureFiles(closure) {
+    const normalized = normalizeNativeToolClosure(closure);
+    return {
+        closure: { ...normalized, reader: DEFAULT_NATIVE_TOOL_READER },
+        files: { [DEFAULT_NATIVE_TOOL_READER.slice(2)]: createNativeToolReaderSource() },
+    };
+}
+async function writeGeneratedFile(root, relative, content) {
+    const segments = relative.replace(/^\.\//u, '').split('/');
+    let current = root;
+    const rootStat = await fs.lstat(root);
+    if (!rootStat.isDirectory() || rootStat.isSymbolicLink())
+        throw new Error('nativeToolUnsafePath');
+    for (const segment of segments.slice(0, -1)) {
+        current = path.join(current, segment);
+        const stat = await fs.lstat(current).catch((error) => {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        });
+        if (!stat)
+            await fs.mkdir(current);
+        else if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new Error('nativeToolUnsafePath');
+    }
+    const target = path.join(root, ...segments);
+    const existing = await fs.lstat(target).catch((error) => {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    });
+    if (existing) {
+        if (!existing.isFile() || existing.isSymbolicLink() || await fs.readFile(target, 'utf8') !== content)
+            throw new Error('nativeToolGeneratedFileConflict');
+        return;
+    }
+    await fs.writeFile(target, content, { flag: 'wx' });
+}
+export async function preparePluginNativeTools(pluginRoot, manifest) {
+    const closure = await loadPluginNativeToolClosure(pluginRoot, manifest);
+    if (!closure)
+        return undefined;
+    await writeGeneratedFile(pluginRoot, closure.reader, createNativeToolReaderSource());
+    return path.resolve(pluginRoot, closure.reader);
+}
+export async function validateNativeToolClosureFiles(root, closure) {
+    const normalized = normalizeNativeToolClosure(closure);
+    await validateNativeToolReader(root, normalized.reader);
+}
+async function validateNativeToolReader(root, reader) {
+    const source = await resolveCanonicalRuntimeSourceIdentity(root, reader, 'native tool reader');
+    if ((await fs.stat(source.sourceRealPath)).size > 64 * 1024)
+        throw new Error('nativeToolReaderMismatch');
+    if (await fs.readFile(source.sourceRealPath, 'utf8') !== createNativeToolReaderSource())
+        throw new Error('nativeToolReaderMismatch');
+}
+export async function copyNativeToolClosureFiles(options) {
+    await validateNativeToolClosureFiles(options.sourceRoot, options.closure);
+    const materialized = materializeNativeToolClosureFiles(options.closure);
+    for (const [relative, content] of Object.entries(materialized.files))
+        await writeGeneratedFile(options.destinationRoot, relative, content);
+    await validateNativeToolClosureFiles(options.destinationRoot, materialized.closure);
+    return materialized.closure;
+}
+//# sourceMappingURL=native-tools.js.map

package/dist/native-tools.js.map

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

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

@@ -1,4 +1,4 @@
-export declare const PLUGIN_AUTHORING_CAPABILITY_SURFACES: readonly ["manifest", "build-config", "extensions", "slash-commands", "mcp-apps", "config", "lifecycle", "artifacts"];
+export declare const PLUGIN_AUTHORING_CAPABILITY_SURFACES: readonly ["manifest", "build-config", "extensions", "slash-commands", "mcp-apps", "config", "pre-apply", "managed-commands", "native-tools", "artifacts"];
 export type PluginAuthoringCapabilitySurfaceName = (typeof PLUGIN_AUTHORING_CAPABILITY_SURFACES)[number];
 export type PluginAuthoringAcceptedValue = string | number | boolean;
 export interface PluginAuthoringCapabilityEntry {