@lesliechan721/aw-plugin-core 0.1.0-beta.1

package/dist/file-rules.d.ts

@@ -0,0 +1,2 @@
+export declare function matchesGlob(filePath: string, pattern: string): boolean;
+export declare function applyFileRules(filePaths: string[], include: string[], exclude?: string[]): string[];

package/dist/file-rules.js

@@ -0,0 +1,42 @@
+import path from 'node:path';
+function escapeRegexSegment(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function compileGlob(pattern) {
+    const normalized = pattern.split(path.sep).join('/');
+    let source = '^';
+    for (let index = 0; index < normalized.length; index += 1) {
+        const char = normalized[index];
+        const next = normalized[index + 1];
+        if (char === '*' && next === '*') {
+            source += '.*';
+            index += 1;
+            continue;
+        }
+        if (char === '*') {
+            source += '[^/]*';
+            continue;
+        }
+        if (char === '?') {
+            source += '.';
+            continue;
+        }
+        source += escapeRegexSegment(char);
+    }
+    source += '$';
+    return new RegExp(source);
+}
+function normalizeRelativePath(filePath) {
+    return path.posix.normalize(filePath.split(path.sep).join('/'));
+}
+export function matchesGlob(filePath, pattern) {
+    return compileGlob(pattern).test(normalizeRelativePath(filePath));
+}
+export function applyFileRules(filePaths, include, exclude = []) {
+    return filePaths
+        .map((filePath) => normalizeRelativePath(filePath))
+        .filter((filePath) => include.some((pattern) => matchesGlob(filePath, pattern)) &&
+        !exclude.some((pattern) => matchesGlob(filePath, pattern)))
+        .sort();
+}
+//# sourceMappingURL=file-rules.js.map

package/dist/file-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-rules.js","sourceRoot":"","sources":["../src/file-rules.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAEnC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,IAAI,IAAI,CAAC;YACf,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,CAAC;YACd,SAAS;QACX,CAAC;QAED,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAmB,EACnB,OAAiB,EACjB,UAAoB,EAAE;IAEtB,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;SAClD,MAAM,CACL,CAAC,QAAQ,EAAE,EAAE,CACX,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAC7D;SACA,IAAI,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,368 @@
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "semver".
+ */
+export type Semver = string;
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "pluginPath".
+ */
+export type PluginPath = string;
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "stringArray".
+ */
+export type StringArray = string[];
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "lifecycleDefinition".
+ */
+export type LifecycleDefinition = (string | {
+    default?: ScriptEntry;
+    unix?: ScriptEntry;
+    windows?: ScriptEntry;
+    linux?: ScriptEntry;
+    darwin?: ScriptEntry;
+    win32?: ScriptEntry;
+});
+export interface PluginManifestSourceV1 {
+    schemaVersion?: 1;
+    name: string;
+    version: Semver;
+    description: string;
+    /**
+     * @maxItems 64
+     */
+    dependencies?: string[];
+    compatibility?: Compatibility;
+    skills?: PluginPath;
+    slashCommands?: PluginPath;
+    mcpServers?: PluginPath;
+    apps?: PluginPath;
+    distributions?: Distributions;
+    marketplace: Marketplace;
+    interface?: Interface;
+    extensions?: Extensions;
+    artifacts?: Artifacts;
+    buildConfig?: BuildConfig;
+    scripts?: Scripts;
+    config?: Config;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "compatibility".
+ */
+export interface Compatibility {
+    aw: {
+        minVersion: Semver;
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "distributions".
+ */
+export interface Distributions {
+    agentSkills?: {
+        skills?: PluginPath;
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "marketplace".
+ */
+export interface Marketplace {
+    category: string;
+    tags?: string[];
+    strict: boolean;
+    policy: {
+        installation: ("AVAILABLE" | "NOT_AVAILABLE" | "INSTALLED_BY_DEFAULT");
+        authentication: ("ON_INSTALL" | "ON_USE");
+        products?: string[];
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "interface".
+ */
+export interface Interface {
+    displayName?: string;
+    shortDescription?: string;
+    capabilities?: string[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "extensions".
+ */
+export interface Extensions {
+    instructions?: Instruction[];
+    permissions?: Permission[];
+    hooks?: Hook[];
+    nativeHooks?: {
+        claude?: NativeHook[];
+        codex?: NativeHook[];
+    };
+    agents?: Agent[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "instruction".
+ */
+export interface Instruction {
+    name: string;
+    title: string;
+    content: string;
+    paths?: StringArray;
+    agentOverrides?: PlatformOverrides;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "platformOverrides".
+ */
+export interface PlatformOverrides {
+    claude?: ({
+        [k: string]: unknown | undefined;
+    } | null);
+    codex?: ({
+        [k: string]: unknown | undefined;
+    } | null);
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "permission".
+ */
+export interface Permission {
+    name: string;
+    allow?: StringArray;
+    ask?: StringArray;
+    deny?: StringArray;
+    agentOverrides?: PlatformOverrides;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "hook".
+ */
+export interface Hook {
+    event: string;
+    matcher?: string;
+    command: string;
+    agentOverrides?: PlatformOverrides;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "nativeHook".
+ */
+export interface NativeHook {
+    event: string;
+    matcher?: string;
+    command: string;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "agent".
+ */
+export interface Agent {
+    name: string;
+    description: string;
+    prompt: string;
+    tools?: StringArray;
+    agentOverrides?: PlatformOverrides;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "artifacts".
+ */
+export interface Artifacts {
+    targets?: ArtifactTarget[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "artifactTarget".
+ */
+export interface ArtifactTarget {
+    id: string;
+    platform?: ("codex" | "claude");
+    distribution?: "agent-skills";
+    scopes: ("user" | "project")[];
+    target: ("codex.developerInstructionsBlock" | "codex.agentRole" | "codex.skill" | "claude.skill" | "agent-skills.skill");
+    kind?: ("instruction" | "codexRole" | "skill");
+    projectManagedKind?: ("skill" | "mcpServer" | "instruction" | "permission" | "hook" | "agent");
+    states: ("present" | "disabled")[];
+    refreshKeys: StringArray;
+    requiresCodexProjectConfig?: boolean;
+    roleKey?: string;
+    skillKey?: string;
+    sourceDirs?: StringArray;
+    runtimeImports?: {
+        name: string;
+        plugin: string;
+        export: string;
+        resolved?: {
+            path: string;
+            digest: string;
+            providerPluginId: string;
+            providerVersion: Semver;
+            source: string;
+        };
+    }[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "buildConfig".
+ */
+export interface BuildConfig {
+    cacheable?: true;
+    templates?: {
+        vars: {
+            [k: string]: PlatformTemplateValue | undefined;
+        };
+        include: StringArray;
+    };
+    fileRules?: {
+        claude?: FileRules;
+        codex?: FileRules;
+    };
+    manifestOverrides?: {
+        claude?: {
+            commands?: string;
+            outputStyles?: string;
+            lspServers?: unknown;
+            userConfig?: unknown;
+            channels?: unknown;
+        };
+        codex?: {
+            [k: string]: unknown | undefined;
+        };
+    };
+    runtimeExports?: {
+        name: string;
+        source: string;
+    }[];
+    buildImports?: {
+        plugin: string;
+        export: string;
+        env: string;
+    }[];
+    skillRuntimeFiles?: {
+        skill: string;
+        target: string;
+        platforms?: ("codex" | "claude")[];
+        distributions?: ("agent-skills")[];
+        source?: string;
+        import?: ImportReference;
+    }[];
+    generatedSkillRuntimeFiles?: {
+        skill: string;
+        target: string;
+        distributions?: ("agent-skills")[];
+    }[];
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "platformTemplateValue".
+ */
+export interface PlatformTemplateValue {
+    claude: (string | boolean);
+    codex: (string | boolean);
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "fileRules".
+ */
+export interface FileRules {
+    include: StringArray;
+    exclude: StringArray;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "importReference".
+ */
+export interface ImportReference {
+    plugin: string;
+    export: string;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "scripts".
+ */
+export interface Scripts {
+    timeoutMs?: number;
+    lifecycle?: {
+        install?: LifecycleDefinition;
+        upgrade?: LifecycleDefinition;
+        uninstall?: LifecycleDefinition;
+    };
+    helpers?: {
+        config: string;
+    };
+    node?: {
+        packageRoot?: string;
+        build?: ScriptEntry;
+    };
+    artifacts?: {
+        render?: ScriptEntry;
+    };
+    tests?: {
+        node?: StringArray;
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "scriptEntry".
+ */
+export interface ScriptEntry {
+    runner: ("node" | "sh" | "bash" | "pwsh" | "powershell" | "cmd" | "auto");
+    path: string;
+    args?: StringArray;
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "config".
+ */
+export interface Config {
+    schema: {
+        [k: string]: ConfigField | undefined;
+    };
+    presentation?: {
+        groups?: {
+            id: string;
+            title: string;
+            description?: string;
+            fields: StringArray;
+            advanced?: boolean;
+        }[];
+        fields?: {
+            [k: string]: {
+                valueLabels?: {
+                    [k: string]: string | undefined;
+                };
+                recommendedValue?: (string | number | boolean);
+                placeholder?: string;
+                unit?: string;
+                advanced?: boolean;
+            } | undefined;
+        };
+        presets?: {
+            id: string;
+            title: string;
+            description?: string;
+            values: {
+                [k: string]: (string | number | boolean) | undefined;
+            };
+        }[];
+    };
+}
+/**
+ * This interface was referenced by `PluginManifestSourceV1`'s JSON-Schema
+ * via the `definition` "configField".
+ */
+export interface ConfigField {
+    type: ("string" | "number" | "boolean" | "enum" | "file" | "directory");
+    title?: string;
+    description?: string;
+    default?: (string | number | boolean);
+    required?: boolean;
+    sensitive?: boolean;
+    values?: StringArray;
+    min?: number;
+    max?: number;
+}

package/dist/generated/plugin-manifest-v1.js

@@ -0,0 +1,3 @@
+/* This file is generated. Run `pnpm generate` in packages/plugin-core to update it. */
+export {};
+//# sourceMappingURL=plugin-manifest-v1.js.map

package/dist/generated/plugin-manifest-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-v1.js","sourceRoot":"","sources":["../../src/generated/plugin-manifest-v1.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/dist/hooks-contract.d.ts

@@ -0,0 +1,189 @@
+import type { CodexSharedHookGroup, HookDefinition, HookEvent, NativeHookDefinition, PlatformName, NormalizedPluginManifest, RenderedHookGroup, TrackedHookGroupIdentity } from './types.js';
+export declare const PUBLIC_HOOK_EVENTS: ["before_tool", "after_tool", "session_start"];
+export declare const PUBLIC_SESSION_START_SOURCES: readonly ["startup", "resume", "clear"];
+export declare const PUBLIC_SESSION_START_DEFAULT_MATCHER: string;
+export declare const PUBLIC_HOOK_EVENT_RENDER_MAP: {
+    readonly before_tool: {
+        readonly claude: "PreToolUse";
+        readonly codex: "PreToolUse";
+    };
+    readonly after_tool: {
+        readonly claude: "PostToolUse";
+        readonly codex: "PostToolUse";
+    };
+    readonly session_start: {
+        readonly claude: "SessionStart";
+        readonly codex: "SessionStart";
+    };
+};
+export declare const CLAUDE_NATIVE_HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged"];
+export declare const CODEX_NATIVE_HOOK_EVENTS: readonly ["PreToolUse", "PermissionRequest", "PostToolUse", "SessionStart", "UserPromptSubmit", "Stop"];
+export declare const NATIVE_HOOK_EVENT_CONTRACTS: {
+    readonly claude: {
+        readonly PreToolUse: {
+            readonly matcherAllowed: true;
+        };
+        readonly PostToolUse: {
+            readonly matcherAllowed: true;
+        };
+        readonly PostToolUseFailure: {
+            readonly matcherAllowed: true;
+        };
+        readonly Notification: {
+            readonly matcherAllowed: true;
+        };
+        readonly UserPromptSubmit: {
+            readonly matcherAllowed: false;
+        };
+        readonly SessionStart: {
+            readonly matcherAllowed: true;
+        };
+        readonly SessionEnd: {
+            readonly matcherAllowed: true;
+        };
+        readonly Stop: {
+            readonly matcherAllowed: false;
+        };
+        readonly StopFailure: {
+            readonly matcherAllowed: true;
+        };
+        readonly SubagentStart: {
+            readonly matcherAllowed: true;
+        };
+        readonly SubagentStop: {
+            readonly matcherAllowed: true;
+        };
+        readonly PreCompact: {
+            readonly matcherAllowed: true;
+        };
+        readonly PostCompact: {
+            readonly matcherAllowed: true;
+        };
+        readonly PermissionRequest: {
+            readonly matcherAllowed: true;
+        };
+        readonly PermissionDenied: {
+            readonly matcherAllowed: true;
+        };
+        readonly Setup: {
+            readonly matcherAllowed: true;
+        };
+        readonly TeammateIdle: {
+            readonly matcherAllowed: false;
+        };
+        readonly TaskCreated: {
+            readonly matcherAllowed: false;
+        };
+        readonly TaskCompleted: {
+            readonly matcherAllowed: false;
+        };
+        readonly Elicitation: {
+            readonly matcherAllowed: true;
+        };
+        readonly ElicitationResult: {
+            readonly matcherAllowed: true;
+        };
+        readonly ConfigChange: {
+            readonly matcherAllowed: true;
+        };
+        readonly WorktreeCreate: {
+            readonly matcherAllowed: false;
+        };
+        readonly WorktreeRemove: {
+            readonly matcherAllowed: false;
+        };
+        readonly InstructionsLoaded: {
+            readonly matcherAllowed: true;
+        };
+        readonly CwdChanged: {
+            readonly matcherAllowed: false;
+        };
+        readonly FileChanged: {
+            readonly matcherAllowed: true;
+        };
+    };
+    readonly codex: {
+        readonly PreToolUse: {
+            readonly matcherAllowed: true;
+        };
+        readonly PermissionRequest: {
+            readonly matcherAllowed: true;
+        };
+        readonly PostToolUse: {
+            readonly matcherAllowed: true;
+        };
+        readonly SessionStart: {
+            readonly matcherAllowed: true;
+        };
+        readonly UserPromptSubmit: {
+            readonly matcherAllowed: false;
+        };
+        readonly Stop: {
+            readonly matcherAllowed: false;
+        };
+    };
+};
+export interface ResolvedPublicHookDefinition {
+    kind: 'public';
+    event: HookEvent;
+    matcher?: string;
+    command: string;
+}
+export interface ResolvedNativeHookDefinition {
+    kind: 'native';
+    event: string;
+    matcher?: string;
+    command: string;
+}
+export type ResolvedPlatformHookDefinition = ResolvedPublicHookDefinition | ResolvedNativeHookDefinition;
+export interface ParsedCodexSharedHookGroup {
+    rawGroup: CodexSharedHookGroup;
+    managedIdentity?: TrackedHookGroupIdentity;
+}
+export interface ParsedCodexSharedHooksFile {
+    groups: ParsedCodexSharedHookGroup[];
+    rawGroups: CodexSharedHookGroup[];
+    managedIdentities: TrackedHookGroupIdentity[];
+    opaqueRawGroups: CodexSharedHookGroup[];
+}
+export interface PlannedCodexSharedHooksUpdate {
+    rerenderedAwRawGroups: CodexSharedHookGroup[];
+    preservedHistoricalAwRawGroups: CodexSharedHookGroup[];
+    preservedForeignRawGroups: CodexSharedHookGroup[];
+}
+export declare function assertPublicHookEvent(value: unknown, fieldName: string): HookEvent;
+export declare function renderPublicHookEvent(event: HookEvent, platform: PlatformName): string;
+export declare function assertNativeHookEvent(event: string, platform: PlatformName, fieldName: string): string;
+export declare function assertHookMatcherAllowed(options: {
+    kind: 'public';
+    event: HookEvent;
+    matcher: string | undefined;
+    fieldName: string;
+} | {
+    kind: 'native';
+    platform: PlatformName;
+    event: string;
+    matcher: string | undefined;
+    fieldName: string;
+}): void;
+export declare function resolvePlatformHookDefinitions(manifest: Pick<NormalizedPluginManifest, 'extensions'>, platform: PlatformName): ResolvedPlatformHookDefinition[];
+export declare function renderHookDefinitionGroup(definition: ResolvedPlatformHookDefinition, platform: PlatformName): RenderedHookGroup;
+export declare function normalizeRenderedHookGroupIdentity(options: {
+    platform: PlatformName;
+    event: string;
+    matcher?: string | null;
+    command: string;
+    mode?: 'strict' | 'codex-shared-read';
+}): TrackedHookGroupIdentity;
+export declare function serializeTrackedHookGroupIdentity(identity: TrackedHookGroupIdentity): string;
+export declare function renderTrackedHookGroupIdentity(identity: TrackedHookGroupIdentity): RenderedHookGroup;
+export declare function trackedHookGroupsContainAll(actualGroups: TrackedHookGroupIdentity[], expectedGroups: TrackedHookGroupIdentity[]): boolean;
+export declare function subtractTrackedHookGroupIdentities(groups: TrackedHookGroupIdentity[], removedGroups: TrackedHookGroupIdentity[]): TrackedHookGroupIdentity[];
+export declare function normalizeCodexSharedHookGroupForRead(event: string, value: unknown, fieldName: string): ParsedCodexSharedHookGroup;
+export declare function parseCodexSharedHooksFile(content: unknown, fieldName?: string): ParsedCodexSharedHooksFile;
+export declare function planCodexSharedHooksUpdate(parsed: ParsedCodexSharedHooksFile, options: {
+    rerenderedIdentities: TrackedHookGroupIdentity[];
+    historicalIdentities?: TrackedHookGroupIdentity[];
+}): PlannedCodexSharedHooksUpdate;
+export declare function normalizeNativeHookDefinition(entry: NativeHookDefinition): ResolvedNativeHookDefinition;
+export declare function normalizePublicHookDefinition(entry: HookDefinition): ResolvedPublicHookDefinition;