@lesliechan721/aw-plugin-core 0.1.0-beta.54 → 0.1.0-beta.56

package/dist/aw-capabilities.d.ts

@@ -1,4 +1,4 @@
-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.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 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.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 {

package/dist/aw-capabilities.js

@@ -12,6 +12,8 @@ export const AW_CAPABILITY_IDS = [
     'aw.plugin-config-summary.v1',
     'aw.plugin-pre-apply.v1',
     'aw.dynamic-artifacts.v2',
+    'aw.managed-commands.v1',
+    'aw.claude.sandbox-exclusions.v1',
     'aw.portable-skills.v1',
     'aw.runtime-imports.v1',
     'aw.installed-runtime-config.v2',

package/dist/aw-capabilities.js.map

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

package/dist/generated/plugin-manifest-v3.d.ts

@@ -13,6 +13,16 @@ export type PluginPath = string;
  * via the `definition` "stringArray".
  */
 export type StringArray = string[];
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "commandName".
+ */
+export type CommandName = string;
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "permissionCommands".
+ */
+export type PermissionCommands = (string | ManagedCommandPermission)[];
 /**
  * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
  * via the `definition` "artifactTarget".
@@ -81,6 +91,41 @@ export type ArtifactRuntimeImports = {
         capabilitySetDigest: string;
     };
 }[];
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommandSet".
+ */
+export type ManagedCommandSet = ({
+    set: CommandName;
+    producer: ManagedCommandProducer;
+    mode: "static";
+    entries: CommandDefinition[];
+} | {
+    set: CommandName;
+    producer: ManagedCommandProducer;
+    mode: "dynamic";
+    refreshKeys: string[];
+});
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommandProducer".
+ */
+export type ManagedCommandProducer = ({
+    kind: "artifact";
+    artifactId: string;
+} | {
+    kind: "static-skill";
+    platform: ("codex" | "claude");
+    skillKey: string;
+} | {
+    kind: "package";
+    packageKey: CommandName;
+});
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "commandRelativeFile".
+ */
+export type CommandRelativeFile = string;
 /**
  * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
  * via the `definition` "config".
@@ -200,6 +245,7 @@ export interface PluginManifestSourceV3 {
     interface?: Interface;
     extensions?: Extensions;
     artifacts?: Artifacts;
+    managedCommands?: ManagedCommands;
     buildConfig?: BuildConfig;
     scripts?: Scripts;
     config?: Config;
@@ -288,10 +334,48 @@ export interface PlatformOverrides {
  */
 export interface Permission {
     name: string;
-    allow?: StringArray;
-    ask?: StringArray;
-    deny?: StringArray;
-    agentOverrides?: PlatformOverrides;
+    allow?: PermissionCommands;
+    ask?: PermissionCommands;
+    deny?: PermissionCommands;
+    agentOverrides?: PermissionOverrides;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommandPermission".
+ */
+export interface ManagedCommandPermission {
+    command: ManagedCommandReference;
+    argsPrefix?: string[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommandReference".
+ */
+export interface ManagedCommandReference {
+    set: CommandName;
+    key: CommandName;
+    variant?: CommandName;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "permissionOverrides".
+ */
+export interface PermissionOverrides {
+    codex?: (null | {
+        name?: string;
+        allow?: PermissionCommands;
+        ask?: PermissionCommands;
+        deny?: PermissionCommands;
+    });
+    claude?: (null | {
+        name?: string;
+        allow?: PermissionCommands;
+        ask?: PermissionCommands;
+        deny?: PermissionCommands;
+        sandbox?: {
+            excludedCommands: ManagedCommandPermission[];
+        };
+    });
 }
 /**
  * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
@@ -340,6 +424,60 @@ export interface RuntimeConfig {
      */
     keys: [string, ...(string)[]];
 }
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommands".
+ */
+export interface ManagedCommands {
+    packages?: ManagedCommandPackage[];
+    sets?: ManagedCommandSet[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "managedCommandPackage".
+ */
+export interface ManagedCommandPackage {
+    key: CommandName;
+    scope: ("user" | "project");
+    /**
+     * @minItems 1
+     */
+    platforms: [("codex" | "claude"), ...(("codex" | "claude"))[]];
+    sourceDir: PluginPath;
+    render?: true;
+    refreshKeys?: string[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "commandDefinition".
+ */
+export interface CommandDefinition {
+    key: CommandName;
+    variant?: CommandName;
+    runner: ("node" | "executable");
+    entry: CommandRelativeFile;
+    /**
+     * @maxItems 128
+     */
+    args?: string[];
+    env?: CommandEnvironment;
+    envFrom?: CommandEnvironmentSource;
+    cwd?: ("caller" | "resource");
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "commandEnvironment".
+ */
+export interface CommandEnvironment {
+    [k: string]: string;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
+ * via the `definition` "commandEnvironmentSource".
+ */
+export interface CommandEnvironmentSource {
+    [k: string]: string;
+}
 /**
  * This interface was referenced by `PluginManifestSourceV3`'s JSON-Schema
  * via the `definition` "buildConfig".

package/dist/managed-commands.d.ts

@@ -0,0 +1,165 @@
+import type { ArtifactState, CodexSkillDelivery, NormalizedPluginManifest, PlatformName, Scope } from './types.js';
+export interface CommandLaunch {
+    runner: 'node' | 'executable';
+    entry: string;
+    args: string[];
+    env: Record<string, string>;
+    envFrom: Record<string, string>;
+    cwd: 'caller' | 'resource';
+}
+export interface CommandDefinition extends CommandLaunch {
+    key: string;
+    variant: string;
+}
+export interface ManagedCommandReference {
+    set: string;
+    key: string;
+    variant: string;
+}
+export interface ManagedCommandPermission {
+    command: ManagedCommandReference;
+    argsPrefix: string[];
+}
+export type PermissionCommand = string | ManagedCommandPermission;
+export type ManagedCommandProducerRef = {
+    kind: 'artifact';
+    artifactId: string;
+} | {
+    kind: 'static-skill';
+    platform: PlatformName;
+    skillKey: string;
+} | {
+    kind: 'package';
+    packageKey: string;
+};
+export interface ManagedCommandPackage {
+    key: string;
+    scope: Scope;
+    platforms: [PlatformName, ...PlatformName[]];
+    sourceDir: string;
+    render?: true;
+    refreshKeys: string[];
+}
+export type ManagedCommandSet = {
+    set: string;
+    producer: ManagedCommandProducerRef;
+    mode: 'static';
+    entries: CommandDefinition[];
+} | {
+    set: string;
+    producer: ManagedCommandProducerRef;
+    mode: 'dynamic';
+    refreshKeys: string[];
+};
+export interface ManagedCommands {
+    packages: ManagedCommandPackage[];
+    sets: ManagedCommandSet[];
+}
+export interface ProducerIdentity {
+    sourceId: string;
+    sourceIdentity: string;
+    pluginName: string;
+    kind: 'artifact' | 'static-skill' | 'package';
+    key: string;
+    platform: PlatformName | null;
+    scope: Scope;
+    projectRoot: string | null;
+}
+export interface CommandIdentity {
+    schemaVersion: 1;
+    producer: ProducerIdentity;
+    set: string;
+    key: string;
+    variant: string;
+}
+export interface InstalledCommandProducer {
+    schemaVersion: 1;
+    producer: ProducerIdentity;
+    sets: Array<{
+        set: string;
+        state: ArtifactState;
+        entries: CommandDefinition[];
+    }>;
+}
+export interface UserCommandDefinition {
+    schemaVersion: 1;
+    id: string;
+    name: string;
+    packageRevision: string;
+    launch: CommandLaunch;
+}
+export type ManagedCommandArtifactSurface = {
+    kind: 'platform';
+    platform: PlatformName;
+} | {
+    kind: 'aw';
+    name: 'managed-commands';
+};
+export interface ManagedCommandArtifactTargetDefinition {
+    id: string;
+    target: 'aw.command-set' | 'aw.command-package';
+    kind: 'commandSet' | 'commandPackage';
+    surface: ManagedCommandArtifactSurface;
+    platform?: PlatformName;
+    scopes: Scope[];
+    states: ArtifactState[];
+    refreshKeys: string[];
+    producer: ManagedCommandProducerRef;
+    set?: string;
+    packageKey?: string;
+    delivery?: CodexSkillDelivery;
+}
+export interface CommandSetArtifact {
+    id: string;
+    target: 'aw.command-set';
+    kind: 'commandSet';
+    platform?: PlatformName;
+    distribution?: never;
+    state: ArtifactState;
+    refreshKeys: string[];
+    entries: CommandDefinition[];
+    disabledReason?: string;
+}
+export interface CommandPackageArtifact {
+    id: string;
+    target: 'aw.command-package';
+    kind: 'commandPackage';
+    platform?: never;
+    distribution?: never;
+    state: 'present';
+    refreshKeys: string[];
+    files: Record<string, string>;
+}
+export declare const COMMAND_PRODUCER_RECORD_FILE = ".aw-command-producer.json";
+export declare const MANAGED_COMMAND_NAME_PATTERN: RegExp;
+export declare function normalizeCommandRelativeFile(value: unknown, field?: string): string;
+export declare function validateCommandEnvironment(env: Record<string, string>, envFrom: Record<string, string>, platform?: NodeJS.Platform): void;
+export declare function normalizeCommandLaunch(value: unknown, field?: string): CommandLaunch;
+export declare function normalizeCommandDefinition(value: unknown, field?: string): CommandDefinition;
+export declare function normalizeCommandDefinitions(value: unknown, field?: string): CommandDefinition[];
+export declare function normalizeManagedCommandReference(value: unknown, field?: string): ManagedCommandReference;
+export declare function normalizeManagedCommandPermission(value: unknown, field?: string): ManagedCommandPermission;
+export declare function normalizeManagedCommands(value: unknown, field?: string): ManagedCommands;
+export declare function normalizeProducerIdentity(value: unknown, field?: string): ProducerIdentity;
+export declare function normalizeCommandIdentity(value: unknown, field?: string): CommandIdentity;
+export declare function canonicalizeCommandIdentity(value: CommandIdentity): string;
+export declare function getPluginCommandId(identity: CommandIdentity): string;
+export declare function getCommandPackageId(producer: ProducerIdentity): string;
+export declare function isManagedCommandId(value: unknown): value is string;
+export declare function isUserCommandId(value: unknown): value is string;
+export declare function isCommandPackageId(value: unknown): value is string;
+export declare function normalizeInstalledCommandProducer(value: unknown): InstalledCommandProducer;
+export declare function normalizeUserCommandDefinition(value: unknown): UserCommandDefinition;
+export interface ManagedCommandPlaceholder {
+    start: number;
+    end: number;
+    reference: ManagedCommandReference;
+}
+export declare function parseManagedCommandPlaceholders(value: string): ManagedCommandPlaceholder[];
+export declare function replaceManagedCommandPlaceholders(value: string, resolve: (reference: ManagedCommandReference) => string): string;
+export declare function validateManagedCommandManifest(manifest: NormalizedPluginManifest): void;
+export declare function getManagedCommandArtifactTargets(manifest: NormalizedPluginManifest): ManagedCommandArtifactTargetDefinition[];
+/** Checks entry path chains after a producer candidate is complete. */
+export declare function validateCommandEntryFiles(resourceRoot: string, entries: readonly CommandDefinition[]): Promise<void>;
+/** Validates the package input closure without following dependency or author-only trees. */
+export declare function validateManagedCommandSources(pluginRoot: string, manifest: NormalizedPluginManifest): Promise<void>;