@lesliechan721/aw 0.1.0-beta.8 → 0.1.0-beta.9

package/dist/src/utils/codex-reconciler.js

@@ -0,0 +1,327 @@
+import crypto from 'node:crypto';
+import { getCodexOperationRequirement } from './agent-version.js';
+export class CodexReconcilePlanError extends Error {
+    code;
+    constructor(code, detail) {
+        super(`${code}: ${detail}`);
+        this.name = 'CodexReconcilePlanError';
+        this.code = code;
+    }
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function canonicalStrings(values) {
+    return [...new Set(values)].sort(compareText);
+}
+function digest(value) {
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify(value)).digest('hex')}`;
+}
+function targetKey(target) {
+    return `${target.pluginId}\0${target.codexPluginId}`;
+}
+function desiredScopes(target) {
+    return [...new Set(target.desiredScopes ?? [target.resolvedScope])].sort(compareText);
+}
+function assertTarget(target) {
+    if (!target.surface.ok) {
+        throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${target.pluginId} has an ambiguous or unsupported Codex surface.`);
+    }
+    if (!target.codexPluginId.includes('@')) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `${target.pluginId} has an invalid Codex plugin ID.`);
+    }
+    if (!/^sha256:[0-9a-f]{64}$/u.test(target.payloadDigest)) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `${target.pluginId} has an invalid payload digest.`);
+    }
+}
+function nativeAction(options) {
+    const { operation, target, evidence } = options;
+    const requiresNative = target.surface.nativeKinds.length > 0
+        && desiredScopes(target).length > 0;
+    if (!requiresNative || operation === 'uninstall')
+        return 'none';
+    const state = evidence.sharedNative;
+    if (state.state === 'foreign') {
+        throw new CodexReconcilePlanError('codexSharedNativeForeign', `${target.codexPluginId} collides with foreign native state.`);
+    }
+    if (state.state === 'corrupt') {
+        if (evidence.repairableSharedNative)
+            return 'repair';
+        throw new CodexReconcilePlanError('codexSharedNativeCorrupt', `${target.codexPluginId} is corrupt and is not safely repairable.`);
+    }
+    if (operation === 'reinstall') {
+        return state.state === 'absent' ? 'install' : 'replace';
+    }
+    if (state.state === 'absent')
+        return 'install';
+    if (state.state === 'outdated')
+        return 'replace';
+    if (state.state === 'claimable')
+        return 'claim';
+    return 'reuse';
+}
+function activationAction(options) {
+    if (options.desired)
+        return options.actual === true ? 'none' : 'enable';
+    if (options.scope === 'user' && options.nativeDesiredSomewhere) {
+        return options.actual === false ? 'none' : 'disable';
+    }
+    return options.actual === undefined ? 'none' : 'remove';
+}
+function liveExtensionState(evidence, componentKey, scope) {
+    return evidence.extensions?.find((entry) => entry.componentKey === componentKey && entry.scope === scope)?.state ?? 'absent';
+}
+function addExtensionActions(options) {
+    const scopes = desiredScopes(options.target);
+    const awComponents = options.target.surface.components.filter((component) => component.owner === 'aw');
+    if (awComponents.length > 0 && scopes.includes('user') && scopes.includes('project')) {
+        throw new CodexReconcilePlanError('codexExtensionScopeConflict', `${options.target.pluginId} has AW-owned output at both user and project scope.`);
+    }
+    for (const component of awComponents) {
+        for (const scope of ['user', 'project']) {
+            const state = liveExtensionState(options.evidence, component.key, scope);
+            if (state === 'foreign') {
+                throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${options.target.pluginId} extension ${component.key} is foreign at ${scope} scope.`);
+            }
+            const desired = scopes.includes(scope) && component.scopes.includes(scope);
+            const shouldWrite = desired && (state !== 'present'
+                || options.input.operation === 'upgrade'
+                || options.input.operation === 'reinstall');
+            if (shouldWrite) {
+                options.writes.push({
+                    pluginId: options.target.pluginId,
+                    componentKey: component.key,
+                    kind: component.kind,
+                    scope,
+                    action: 'write',
+                });
+            }
+            else if (!desired && state !== 'absent') {
+                options.removals.push({
+                    pluginId: options.target.pluginId,
+                    componentKey: component.key,
+                    kind: component.kind,
+                    scope,
+                    action: 'remove',
+                });
+            }
+        }
+    }
+}
+function sortActivationActions(actions) {
+    actions.sort((left, right) => compareText(`${left.codexPluginId}\0${left.pluginId}`, `${right.codexPluginId}\0${right.pluginId}`));
+}
+function sortExtensionActions(actions) {
+    actions.sort((left, right) => compareText(`${left.scope}\0${left.pluginId}\0${left.componentKey}`, `${right.scope}\0${right.pluginId}\0${right.componentKey}`));
+}
+function evidenceFor(target, evidenceById) {
+    const evidence = evidenceById.get(target.codexPluginId);
+    if (!evidence) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Missing live evidence for ${target.codexPluginId}.`);
+    }
+    return evidence;
+}
+export function createCodexReconcilePlan(input) {
+    const sortedTargets = [...input.catalogClosure].sort((left, right) => compareText(targetKey(left), targetKey(right)));
+    const duplicateTarget = sortedTargets.find((target, index) => index > 0 && targetKey(sortedTargets[index - 1]) === targetKey(target));
+    if (duplicateTarget) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Duplicate catalog target ${duplicateTarget.pluginId}.`);
+    }
+    sortedTargets.forEach(assertTarget);
+    const ownersByCodexPluginId = new Map();
+    for (const target of sortedTargets) {
+        const owners = ownersByCodexPluginId.get(target.codexPluginId) ?? new Set();
+        owners.add(target.pluginId);
+        ownersByCodexPluginId.set(target.codexPluginId, owners);
+    }
+    const ownerCollision = [...ownersByCodexPluginId.entries()].find(([, owners]) => owners.size > 1);
+    if (ownerCollision) {
+        throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${ownerCollision[0]} is claimed by ${[...ownerCollision[1]].sort(compareText).join(', ')}.`);
+    }
+    const evidenceById = new Map();
+    for (const evidence of input.liveEvidence) {
+        if (evidenceById.has(evidence.codexPluginId)) {
+            throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Duplicate live evidence for ${evidence.codexPluginId}.`);
+        }
+        evidenceById.set(evidence.codexPluginId, evidence);
+    }
+    const sharedNativeActions = [];
+    const userActions = [];
+    const projectActions = [];
+    const extensionWrites = [];
+    const extensionRemovals = [];
+    const warnings = [];
+    const postcheckPlugins = [];
+    let projectContractRequired = input.scope === 'project'
+        || sortedTargets.some((target) => target.resolvedScope === 'project');
+    for (const target of sortedTargets) {
+        const evidence = evidenceFor(target, evidenceById);
+        const scopes = desiredScopes(target);
+        const hasNative = target.surface.nativeKinds.length > 0;
+        const userDesired = hasNative && scopes.includes('user');
+        const projectDesired = hasNative && scopes.includes('project');
+        const nativeDesiredSomewhere = userDesired || projectDesired;
+        projectContractRequired ||= projectDesired;
+        const action = nativeAction({ operation: input.operation, target, evidence });
+        if (hasNative || action !== 'none') {
+            sharedNativeActions.push({
+                pluginId: target.pluginId,
+                codexPluginId: target.codexPluginId,
+                action,
+                desiredVersion: target.version,
+                affectsOtherScopes: action === 'replace' || action === 'repair',
+            });
+        }
+        if (action === 'claim')
+            warnings.push(`codexSharedNativeClaim:${target.codexPluginId}`);
+        if (action === 'replace' || action === 'repair') {
+            warnings.push(`codexSharedNativeAffectsOtherScopes:${target.codexPluginId}`);
+        }
+        const userAction = {
+            pluginId: target.pluginId,
+            codexPluginId: target.codexPluginId,
+            scope: 'user',
+            action: activationAction({
+                actual: evidence.activations.user,
+                desired: userDesired,
+                scope: 'user',
+                nativeDesiredSomewhere,
+            }),
+            desired: userDesired,
+        };
+        const projectAction = {
+            pluginId: target.pluginId,
+            codexPluginId: target.codexPluginId,
+            scope: 'project',
+            action: activationAction({
+                actual: evidence.activations.project,
+                desired: projectDesired,
+                scope: 'project',
+                nativeDesiredSomewhere,
+            }),
+            desired: projectDesired,
+        };
+        userActions.push(userAction);
+        projectActions.push(projectAction);
+        addExtensionActions({
+            input,
+            target,
+            evidence,
+            writes: extensionWrites,
+            removals: extensionRemovals,
+        });
+        if (hasNative && (userDesired || projectDesired)) {
+            postcheckPlugins.push({
+                pluginId: target.pluginId,
+                codexPluginId: target.codexPluginId,
+                expectedUserEnabled: userDesired,
+                expectedProjectEnabled: projectDesired,
+                exactCwd: input.cwd,
+                neutralCwdRequired: projectDesired,
+            });
+        }
+    }
+    const actualDesiredIds = canonicalStrings(sortedTargets.flatMap((target) => target.surface.nativeKinds.length > 0 && desiredScopes(target).length > 0
+        ? [target.codexPluginId]
+        : []));
+    const desiredIds = canonicalStrings(sortedTargets.flatMap((target) => (target.intentScopes ?? desiredScopes(target)).includes(input.scope)
+        ? [target.codexPluginId]
+        : []));
+    const relatedScope = input.scope === 'user' ? 'project' : 'user';
+    const relatedDesiredIds = canonicalStrings(sortedTargets.flatMap((target) => (target.intentScopes ?? desiredScopes(target)).includes(relatedScope)
+        ? [target.codexPluginId]
+        : []));
+    const beforeIds = canonicalStrings(input.intentBefore.managed.codexPluginIds);
+    const relatedBeforeIds = canonicalStrings(input.relatedIntentBefore?.managed.codexPluginIds ?? []);
+    const nativeReconciledPluginIds = new Set(sortedTargets.flatMap((target) => target.surface.nativeKinds.length > 0 ? [target.codexPluginId] : []));
+    const reconciledPluginIds = new Set(sortedTargets.map((target) => target.codexPluginId));
+    const staleActivationRemovals = canonicalStrings([...beforeIds, ...relatedBeforeIds].filter((pluginId) => nativeReconciledPluginIds.has(pluginId)
+        && !actualDesiredIds.includes(pluginId))).flatMap((codexPluginId) => [
+        { scope: 'user', codexPluginId },
+        { scope: 'project', codexPluginId },
+    ]);
+    const requirement = getCodexOperationRequirement(projectContractRequired ? 'project' : 'user');
+    const support = input.activationSupport ?? 'observed';
+    if (support === 'assumed')
+        warnings.push('codexProjectActivationAssumed');
+    sharedNativeActions.sort((left, right) => compareText(left.codexPluginId, right.codexPluginId));
+    sortActivationActions(userActions);
+    sortActivationActions(projectActions);
+    sortExtensionActions(extensionWrites);
+    sortExtensionActions(extensionRemovals);
+    postcheckPlugins.sort((left, right) => compareText(left.codexPluginId, right.codexPluginId));
+    const ownershipSuperset = canonicalStrings([...beforeIds, ...desiredIds]);
+    const convergedIds = canonicalStrings([
+        ...beforeIds.filter((pluginId) => !reconciledPluginIds.has(pluginId)),
+        ...desiredIds,
+    ]);
+    const relatedOwnershipSuperset = canonicalStrings([...relatedBeforeIds, ...relatedDesiredIds]);
+    const relatedConvergedIds = canonicalStrings([
+        ...relatedBeforeIds.filter((pluginId) => !reconciledPluginIds.has(pluginId)),
+        ...relatedDesiredIds,
+    ]);
+    const evidenceDescriptor = {
+        scope: input.scope,
+        cwd: input.cwd,
+        operation: input.operation,
+        intentBefore: input.intentBefore,
+        intentAfter: input.intentAfter,
+        relatedIntentBefore: input.relatedIntentBefore,
+        relatedIntentAfter: input.relatedIntentAfter,
+        catalogClosure: sortedTargets,
+        liveEvidence: [...input.liveEvidence]
+            .map((evidence) => ({
+            ...evidence,
+            ...(evidence.extensions
+                ? { extensions: [...evidence.extensions].sort((left, right) => compareText(`${left.scope}\0${left.componentKey}\0${left.state}\0${left.owner ?? ''}`, `${right.scope}\0${right.componentKey}\0${right.state}\0${right.owner ?? ''}`)) }
+                : {}),
+        }))
+            .sort((left, right) => compareText(left.codexPluginId, right.codexPluginId)),
+        activationSupport: support,
+    };
+    const evidenceDigest = digest(evidenceDescriptor);
+    const planDescriptor = {
+        requirement,
+        desiredTargets: sortedTargets.map((target) => ({
+            pluginId: target.pluginId,
+            scopes: desiredScopes(target),
+        })),
+        sharedNativeActions,
+        activationActions: { user: userActions, project: projectActions },
+        extensionWrites,
+        extensionRemovals,
+        staleActivationRemovals,
+        managedInventory: {
+            before: beforeIds,
+            desired: desiredIds,
+            ownershipSuperset,
+            converged: convergedIds,
+            related: {
+                before: relatedBeforeIds,
+                desired: relatedDesiredIds,
+                ownershipSuperset: relatedOwnershipSuperset,
+                converged: relatedConvergedIds,
+            },
+        },
+        warnings: canonicalStrings(warnings),
+        postcheck: { requirement, support, plugins: postcheckPlugins },
+    };
+    const planDigest = digest(planDescriptor);
+    const sharedImpactPluginIds = sharedNativeActions.flatMap((entry) => entry.affectsOtherScopes ? [entry.codexPluginId] : []);
+    return {
+        ...planDescriptor,
+        review: {
+            evidenceDigest,
+            planDigest,
+            requiresConfirmation: sharedImpactPluginIds.length > 0,
+            sharedImpact: {
+                pluginIds: sharedImpactPluginIds,
+                ...(sharedImpactPluginIds.length > 0 ? {
+                    warning: 'Replacing or reinstalling shared Codex native state can affect other projects.',
+                } : {}),
+            },
+        },
+    };
+}
+export const planCodexReconciliation = createCodexReconcilePlan;
+//# sourceMappingURL=codex-reconciler.js.map

package/dist/src/utils/codex-reconciler.js.map

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

package/dist/src/utils/codex-shared-native.d.ts

@@ -0,0 +1,56 @@
+import type { CodexMarketplaceSnapshot } from './codex-config.js';
+import type { CodexPluginListEntry } from './native-cli.js';
+export type CodexSharedNativeDiagnostic = 'marketplaceRegistrationForeign' | 'marketplacePathUnsafe' | 'pluginListUnavailable' | 'pluginListDuplicate' | 'pluginNameCollision' | 'pluginListVersionMismatch' | 'manifestMissing' | 'manifestUnreadable' | 'manifestIdentityMismatch' | 'manifestVersionInvalid' | 'payloadPathUnsafe' | 'payloadDigestMismatch';
+export type CodexSharedNativeState = {
+    state: 'absent';
+    nativeAction: 'install';
+} | {
+    state: 'claimable';
+    version: string;
+    nativeAction: 'none';
+} | {
+    state: 'present';
+    version: string;
+    nativeAction: 'none';
+} | {
+    state: 'outdated';
+    version: string;
+    desiredVersion: string;
+    nativeAction: 'replace';
+} | {
+    state: 'corrupt';
+    diagnostic: CodexSharedNativeDiagnostic;
+    nativeAction: 'blocked';
+} | {
+    state: 'foreign';
+    diagnostic: CodexSharedNativeDiagnostic;
+    nativeAction: 'blocked';
+};
+export type CodexSharedNativeManifestEvidence = {
+    state: 'absent';
+} | {
+    state: 'unreadable';
+} | {
+    state: 'present';
+    identity: string;
+    version: string;
+    payloadDigest: string;
+    payloadPath: string;
+    pathSafe: boolean;
+};
+export interface CodexSharedNativeEvidence {
+    pluginName: string;
+    pluginId: string;
+    marketplaceName: string;
+    canonicalMarketplaceRoot: string;
+    desiredVersion: string;
+    expectedPayloadDigest: string;
+    marketplaceRegistration?: CodexMarketplaceSnapshot;
+    marketplacePathSafe: boolean;
+    pluginListEntries: CodexPluginListEntry[] | null;
+    manifest: CodexSharedNativeManifestEvidence;
+    managedByCurrentIntent: boolean;
+}
+export declare function isCanonicalCodexMarketplaceRegistration(registration: CodexMarketplaceSnapshot | undefined, canonicalMarketplaceRoot: string): boolean;
+export declare function inspectCodexSharedNative(evidence: CodexSharedNativeEvidence): CodexSharedNativeState;
+export declare const classifyCodexSharedNativeEvidence: typeof inspectCodexSharedNative;

package/dist/src/utils/codex-shared-native.js

@@ -0,0 +1,87 @@
+import path from 'node:path';
+import { tryParseStrictSemVer } from './manifest.js';
+function namespacedPluginName(pluginId) {
+    const separator = pluginId.lastIndexOf('@');
+    return separator > 0 ? pluginId.slice(0, separator) : null;
+}
+function samePath(left, right) {
+    return path.resolve(left) === path.resolve(right);
+}
+export function isCanonicalCodexMarketplaceRegistration(registration, canonicalMarketplaceRoot) {
+    return registration?.sourceType === 'local'
+        && registration.sourcePointsToManifest === false
+        && typeof registration.source === 'string'
+        && samePath(registration.source, canonicalMarketplaceRoot);
+}
+function corrupt(diagnostic) {
+    return { state: 'corrupt', diagnostic, nativeAction: 'blocked' };
+}
+function foreign(diagnostic) {
+    return { state: 'foreign', diagnostic, nativeAction: 'blocked' };
+}
+export function inspectCodexSharedNative(evidence) {
+    const expectedPluginId = `${evidence.pluginName}@${evidence.marketplaceName}`;
+    if (evidence.pluginId !== expectedPluginId) {
+        throw new Error(`Invalid Codex shared native identity: expected ${expectedPluginId}.`);
+    }
+    if (!tryParseStrictSemVer(evidence.desiredVersion)) {
+        throw new Error(`Invalid desired Codex shared native version: ${evidence.desiredVersion}.`);
+    }
+    if (!/^sha256:[0-9a-f]{64}$/u.test(evidence.expectedPayloadDigest)) {
+        throw new Error('Invalid expected Codex shared native payload digest.');
+    }
+    if (evidence.marketplaceRegistration && !isCanonicalCodexMarketplaceRegistration(evidence.marketplaceRegistration, evidence.canonicalMarketplaceRoot)) {
+        return foreign('marketplaceRegistrationForeign');
+    }
+    if (!evidence.marketplacePathSafe)
+        return foreign('marketplacePathUnsafe');
+    if (evidence.pluginListEntries === null)
+        return corrupt('pluginListUnavailable');
+    const nameCollisions = evidence.pluginListEntries.filter((entry) => namespacedPluginName(entry.pluginId) === evidence.pluginName
+        && entry.pluginId !== evidence.pluginId);
+    if (nameCollisions.length > 0)
+        return foreign('pluginNameCollision');
+    const listMatches = evidence.pluginListEntries.filter((entry) => entry.pluginId === evidence.pluginId);
+    if (listMatches.length > 1)
+        return corrupt('pluginListDuplicate');
+    const listEntry = listMatches[0];
+    if (evidence.manifest.state === 'unreadable')
+        return corrupt('manifestUnreadable');
+    if (evidence.manifest.state === 'absent') {
+        return listEntry || evidence.managedByCurrentIntent
+            ? corrupt('manifestMissing')
+            : { state: 'absent', nativeAction: 'install' };
+    }
+    if (!listEntry)
+        return corrupt('pluginListUnavailable');
+    if (!evidence.marketplaceRegistration)
+        return corrupt('marketplaceRegistrationForeign');
+    if (!evidence.manifest.pathSafe)
+        return foreign('payloadPathUnsafe');
+    if (evidence.manifest.identity !== evidence.pluginId
+        && evidence.manifest.identity !== evidence.pluginName) {
+        return foreign('manifestIdentityMismatch');
+    }
+    if (!tryParseStrictSemVer(evidence.manifest.version)) {
+        return corrupt('manifestVersionInvalid');
+    }
+    if (listEntry.version !== undefined && listEntry.version !== evidence.manifest.version) {
+        return corrupt('pluginListVersionMismatch');
+    }
+    if (evidence.manifest.version !== evidence.desiredVersion) {
+        return {
+            state: 'outdated',
+            version: evidence.manifest.version,
+            desiredVersion: evidence.desiredVersion,
+            nativeAction: 'replace',
+        };
+    }
+    if (evidence.manifest.payloadDigest !== evidence.expectedPayloadDigest) {
+        return corrupt('payloadDigestMismatch');
+    }
+    return evidence.managedByCurrentIntent
+        ? { state: 'present', version: evidence.manifest.version, nativeAction: 'none' }
+        : { state: 'claimable', version: evidence.manifest.version, nativeAction: 'none' };
+}
+export const classifyCodexSharedNativeEvidence = inspectCodexSharedNative;
+//# sourceMappingURL=codex-shared-native.js.map

package/dist/src/utils/codex-shared-native.js.map

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

package/dist/src/utils/codex-surface-analysis.d.ts

@@ -0,0 +1,44 @@
+import type { NormalizedPluginManifest, Scope } from '../types.js';
+export declare const QUALIFIED_CODEX_NATIVE_KINDS: readonly ["skill", "mcp", "hook", "app"];
+export type CodexNativeKind = typeof QUALIFIED_CODEX_NATIVE_KINDS[number];
+export type CodexUnsupportedNativeKind = 'slashCommand';
+export type CodexExtensionKind = 'skill' | 'instruction' | 'permission' | 'agent' | 'config' | 'lifecycle';
+export type CodexSurfaceClassification = 'empty' | 'native' | 'aw-extension' | 'mixed' | 'unsupported';
+export type CodexSurfaceDeliveryOwner = 'none' | 'codex-native' | 'aw' | 'split' | 'unsupported';
+export type CodexScopeOverlap = 'none' | 'native-compatible' | 'aw-owned-conflict';
+export interface CodexSurfaceComponent {
+    key: string;
+    kind: CodexNativeKind | CodexExtensionKind;
+    owner: 'codex-native' | 'aw';
+    scopes: Scope[];
+    dynamic: boolean;
+    name?: string;
+}
+export interface CodexSurfaceOwnerCollision {
+    kind: CodexNativeKind | CodexExtensionKind;
+    name: string;
+    owners: ['codex-native', 'aw'];
+}
+export interface CodexSurfaceAnalysisOptions {
+    nativeArtifactNames?: Partial<Record<CodexNativeKind, readonly string[]>>;
+}
+export interface CodexSurfaceAnalysis {
+    ok: boolean;
+    nativeKinds: CodexNativeKind[];
+    extensionKinds: CodexExtensionKind[];
+    unsupportedKinds: CodexUnsupportedNativeKind[];
+    classification: CodexSurfaceClassification;
+    deliveryOwner: CodexSurfaceDeliveryOwner;
+    scopeOverlap: CodexScopeOverlap;
+    components: CodexSurfaceComponent[];
+    collisions: CodexSurfaceOwnerCollision[];
+    missingNativeIdentityKinds: CodexNativeKind[];
+    errorCode?: 'codexSurfaceOwnerCollision' | 'codexSurfaceNativeIdentityMissing' | 'codexNativeKindUnsupported';
+}
+export declare class CodexSurfaceAnalysisError extends Error {
+    readonly code: 'codexSurfaceOwnerCollision' | 'codexSurfaceNativeIdentityMissing' | 'codexNativeKindUnsupported';
+    readonly analysis: CodexSurfaceAnalysis;
+    constructor(analysis: CodexSurfaceAnalysis);
+}
+export declare function analyzeCodexSurface(manifest: NormalizedPluginManifest, options?: CodexSurfaceAnalysisOptions): CodexSurfaceAnalysis;
+export declare function assertCodexSurfaceSupported(analysis: CodexSurfaceAnalysis): CodexSurfaceAnalysis;