@lesliechan721/aw 0.1.0-beta.10

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

@@ -0,0 +1,63 @@
+import type { CodexMarketplaceSnapshot } from './codex-config.js';
+import { type CodexNativeRenderProjection, type CodexNativeRenderReceipt } from './codex-native-render-receipt.js';
+import type { CodexNativePluginObservation } from './codex-native-observation.js';
+export type CodexSharedNativeDiagnostic = 'staleCacheObserved' | 'marketplaceRegistrationForeign' | 'marketplacePathUnsafe' | 'pluginListUnavailable' | 'pluginListDuplicate' | 'pluginNameCollision' | 'pluginListVersionMismatch' | 'manifestMissing' | 'manifestUnreadable' | 'manifestIdentityMismatch' | 'manifestVersionInvalid' | 'payloadPathUnsafe' | 'payloadDigestMismatch' | 'projectionReceiptMissing' | 'projectionReceiptUnreadable' | 'projectionExpectedPayloadDigestMissing' | 'projectionReceiptIdentityMismatch' | 'projectionPayloadDigestMismatch' | 'projectionRenderDrift';
+export type CodexSharedNativeState = 'missing' | 'usable' | 'replaceable' | 'blocked' | 'unobserved';
+export type CodexSharedNativeInspection = {
+    state: 'unobserved';
+    staleCacheObserved?: true;
+} | {
+    state: 'missing';
+    staleCacheObserved?: true;
+} | {
+    state: 'usable';
+    version: string;
+} | {
+    state: 'replaceable';
+    reason: 'outdated' | 'damaged' | 'renderDrift';
+    version?: string;
+    desiredVersion?: string;
+    diagnostic?: CodexSharedNativeDiagnostic;
+} | {
+    state: 'blocked';
+    reason: 'foreign' | 'unreadable';
+    diagnostic: CodexSharedNativeDiagnostic;
+};
+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;
+    observation: CodexNativePluginObservation;
+    manifest: CodexSharedNativeManifestEvidence;
+    expectedProjectionRequired?: boolean;
+    expectedProjectionIdentity?: Pick<CodexNativeRenderProjection, 'logicalPluginId' | 'strategy'>;
+    expectedProjection?: CodexNativeRenderProjection;
+    projectionReceipt?: {
+        state: 'absent';
+    } | {
+        state: 'unreadable';
+    } | {
+        state: 'present';
+        receipt: CodexNativeRenderReceipt;
+    };
+}
+export declare function isCanonicalCodexMarketplaceRegistration(registration: CodexMarketplaceSnapshot | undefined, canonicalMarketplaceRoot: string): boolean;
+export declare function inspectCodexSharedNative(evidence: CodexSharedNativeEvidence): CodexSharedNativeInspection;
+export declare const classifyCodexSharedNativeEvidence: typeof inspectCodexSharedNative;

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

@@ -0,0 +1,142 @@
+import path from 'node:path';
+import { tryParseStrictSemVer } from './manifest.js';
+import { codexNativeRenderProjectionsEqual, } from './codex-native-render-receipt.js';
+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 damaged(diagnostic) {
+    return { state: 'replaceable', reason: 'damaged', diagnostic };
+}
+function blocked(reason, diagnostic) {
+    return { state: 'blocked', reason, diagnostic };
+}
+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 (evidence.expectedPayloadDigest !== undefined
+        && !/^sha256:[0-9a-f]{64}$/u.test(evidence.expectedPayloadDigest)) {
+        throw new Error('Invalid expected Codex shared native payload digest.');
+    }
+    if (!evidence.marketplacePathSafe)
+        return blocked('foreign', 'marketplacePathUnsafe');
+    if (evidence.observation.state === 'unobserved') {
+        return evidence.manifest.state === 'absent'
+            ? { state: 'unobserved' }
+            : { state: 'unobserved', staleCacheObserved: true };
+    }
+    if (evidence.observation.state === 'failed') {
+        return blocked('unreadable', evidence.observation.reason === 'duplicate' ? 'pluginListDuplicate' : 'pluginListUnavailable');
+    }
+    if (evidence.observation.value === 'absent') {
+        return evidence.manifest.state === 'absent'
+            ? { state: 'missing' }
+            : { state: 'missing', staleCacheObserved: true };
+    }
+    const listEntry = evidence.observation.entry;
+    if (evidence.marketplaceRegistration && !isCanonicalCodexMarketplaceRegistration(evidence.marketplaceRegistration, evidence.canonicalMarketplaceRoot)) {
+        return blocked('foreign', 'marketplaceRegistrationForeign');
+    }
+    if (evidence.manifest.state === 'unreadable')
+        return blocked('unreadable', 'manifestUnreadable');
+    if (evidence.manifest.state === 'absent') {
+        return damaged('manifestMissing');
+    }
+    if (!evidence.marketplaceRegistration) {
+        return blocked('foreign', 'marketplaceRegistrationForeign');
+    }
+    if (!evidence.manifest.pathSafe)
+        return blocked('foreign', 'payloadPathUnsafe');
+    if (evidence.manifest.identity !== evidence.pluginId
+        && evidence.manifest.identity !== evidence.pluginName) {
+        return blocked('foreign', 'manifestIdentityMismatch');
+    }
+    const projectionExpected = evidence.expectedProjectionRequired
+        || evidence.expectedProjection !== undefined;
+    let projectionReceipt;
+    if (projectionExpected) {
+        if (evidence.projectionReceipt === undefined || evidence.projectionReceipt.state === 'absent') {
+            return damaged('projectionReceiptMissing');
+        }
+        if (evidence.projectionReceipt.state === 'unreadable') {
+            return blocked('unreadable', 'projectionReceiptUnreadable');
+        }
+        projectionReceipt = evidence.projectionReceipt.receipt;
+        const expectedIdentity = evidence.expectedProjectionIdentity ?? evidence.expectedProjection;
+        if (expectedIdentity
+            && (projectionReceipt.logicalPluginId !== expectedIdentity.logicalPluginId
+                || projectionReceipt.strategy !== expectedIdentity.strategy)) {
+            return blocked('foreign', 'projectionReceiptIdentityMismatch');
+        }
+    }
+    if (!tryParseStrictSemVer(evidence.manifest.version)) {
+        return damaged('manifestVersionInvalid');
+    }
+    if (listEntry.version !== undefined && listEntry.version !== evidence.manifest.version) {
+        return {
+            state: 'replaceable',
+            reason: 'outdated',
+            version: listEntry.version,
+            desiredVersion: evidence.desiredVersion,
+        };
+    }
+    if (evidence.manifest.version !== evidence.desiredVersion) {
+        return {
+            state: 'replaceable',
+            reason: 'outdated',
+            version: evidence.manifest.version,
+            desiredVersion: evidence.desiredVersion,
+        };
+    }
+    if (projectionExpected) {
+        const receipt = projectionReceipt;
+        if (evidence.expectedProjection === undefined) {
+            return damaged('projectionExpectedPayloadDigestMissing');
+        }
+        if (evidence.expectedPayloadDigest === undefined) {
+            return damaged('projectionExpectedPayloadDigestMissing');
+        }
+        if (receipt.logicalPluginId !== evidence.expectedProjection.logicalPluginId
+            || receipt.strategy !== evidence.expectedProjection.strategy) {
+            return blocked('foreign', 'projectionReceiptIdentityMismatch');
+        }
+        if (evidence.manifest.payloadDigest !== evidence.expectedPayloadDigest
+            || evidence.manifest.payloadDigest !== receipt.payloadDigest
+            || receipt.payloadDigest !== evidence.expectedPayloadDigest) {
+            return damaged('projectionPayloadDigestMismatch');
+        }
+        if (!codexNativeRenderProjectionsEqual(receipt, evidence.expectedProjection)) {
+            return {
+                state: 'replaceable',
+                reason: 'renderDrift',
+                version: evidence.manifest.version,
+                desiredVersion: evidence.desiredVersion,
+                diagnostic: 'projectionRenderDrift',
+            };
+        }
+        return {
+            state: 'usable',
+            version: evidence.manifest.version,
+        };
+    }
+    if (evidence.expectedPayloadDigest !== undefined
+        && evidence.manifest.payloadDigest !== evidence.expectedPayloadDigest) {
+        return damaged('payloadDigestMismatch');
+    }
+    return {
+        state: 'usable',
+        version: evidence.manifest.version,
+    };
+}
+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-skill-staging.d.ts

@@ -0,0 +1,11 @@
+import type { CodexSkillArtifact } from '../types.js';
+import { type DynamicSkillTree } from './dynamic-skill-tree.js';
+export type CodexSkillStagingTree = DynamicSkillTree;
+export declare function createCodexSkillExpectedTree(options: {
+    artifact: Pick<CodexSkillArtifact, 'target' | 'skillKey' | 'state' | 'content'>;
+    sourceDirs?: string[];
+    requireReadme?: boolean;
+    requirementsReceipt?: Buffer;
+    sourceRequirementsReceiptPolicy?: 'reject' | 'allow' | 'ignore';
+}): Promise<CodexSkillStagingTree>;
+export declare function createCodexSkillStagingTreeContentDigest(tree: CodexSkillStagingTree): string;

package/dist/src/utils/codex-skill-staging.js

@@ -0,0 +1,8 @@
+import { createDynamicSkillExpectedTree, createDynamicSkillTreeContentDigest, } from './dynamic-skill-tree.js';
+export async function createCodexSkillExpectedTree(options) {
+    return createDynamicSkillExpectedTree(options);
+}
+export function createCodexSkillStagingTreeContentDigest(tree) {
+    return createDynamicSkillTreeContentDigest(tree);
+}
+//# sourceMappingURL=codex-skill-staging.js.map

package/dist/src/utils/codex-skill-staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-skill-staging.js","sourceRoot":"","sources":["../../../src/utils/codex-skill-staging.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,GAEpC,MAAM,yBAAyB,CAAC;AAIjC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,OAMlD;IACC,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,IAA2B;IAE3B,OAAO,mCAAmC,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,45 @@
+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';
+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;
+    configInputs: string[];
+    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;

package/dist/src/utils/codex-surface-analysis.js

@@ -0,0 +1,245 @@
+import { resolvePlatformHookDefinitions } from './hooks-contract.js';
+import { resolvePlatformEntries } from './platform-entries.js';
+import { supportsPlatform } from './platform-support.js';
+export const QUALIFIED_CODEX_NATIVE_KINDS = [
+    'skill',
+    'mcp',
+    'hook',
+    'app',
+];
+export class CodexSurfaceAnalysisError extends Error {
+    code;
+    analysis;
+    constructor(analysis) {
+        const code = analysis.errorCode ?? 'codexNativeKindUnsupported';
+        super(`${code}: Codex surface delivery is ambiguous or unsupported.`);
+        this.name = 'CodexSurfaceAnalysisError';
+        this.code = code;
+        this.analysis = analysis;
+    }
+}
+const BOTH_SCOPES = ['project', 'user'];
+const NATIVE_KIND_ORDER = [
+    'skill',
+    'mcp',
+    'hook',
+    'app',
+    'slashCommand',
+];
+const EXTENSION_KIND_ORDER = [
+    'skill',
+    'instruction',
+    'permission',
+    'agent',
+];
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function addNativeComponents(components, kind, key, names) {
+    const canonicalNames = [...new Set(names ?? [])].sort(compareText);
+    if (canonicalNames.length === 0) {
+        components.push({
+            key,
+            kind,
+            owner: 'codex-native',
+            scopes: [...BOTH_SCOPES],
+            dynamic: false,
+        });
+        return;
+    }
+    for (const name of canonicalNames) {
+        components.push({
+            key: `${key}:${name}`,
+            kind,
+            owner: 'codex-native',
+            scopes: [...BOTH_SCOPES],
+            dynamic: false,
+            name,
+        });
+    }
+}
+function addAwComponent(components, component) {
+    components.push({ ...component, owner: 'aw' });
+}
+function collectOwnerCollisions(components) {
+    const byIdentity = new Map();
+    for (const component of components) {
+        if (!component.name)
+            continue;
+        const identity = `${component.kind}\0${component.name}`;
+        const owners = byIdentity.get(identity) ?? new Set();
+        owners.add(component.owner);
+        byIdentity.set(identity, owners);
+    }
+    return [...byIdentity.entries()]
+        .filter(([, owners]) => owners.size > 1)
+        .map(([identity]) => {
+        const [kind, name] = identity.split('\0');
+        return {
+            kind,
+            name,
+            owners: ['codex-native', 'aw'],
+        };
+    })
+        .sort((left, right) => compareText(`${left.kind}\0${left.name}`, `${right.kind}\0${right.name}`));
+}
+export function analyzeCodexSurface(manifest, options = {}) {
+    if (!supportsPlatform(manifest, 'codex')) {
+        return {
+            ok: true,
+            configInputs: [],
+            nativeKinds: [],
+            extensionKinds: [],
+            unsupportedKinds: [],
+            classification: 'empty',
+            deliveryOwner: 'none',
+            scopeOverlap: 'none',
+            components: [],
+            collisions: [],
+            missingNativeIdentityKinds: [],
+        };
+    }
+    const components = [];
+    const nativeKinds = new Set();
+    const extensionKinds = new Set();
+    const unsupportedKinds = new Set();
+    const declareNative = (kind, key) => {
+        nativeKinds.add(kind);
+        addNativeComponents(components, kind, key, options.nativeArtifactNames?.[kind]);
+    };
+    if (manifest.skills)
+        declareNative('skill', 'manifest.skills');
+    if (manifest.mcpServers)
+        declareNative('mcp', 'manifest.mcpServers');
+    if (resolvePlatformHookDefinitions(manifest, 'codex').length > 0) {
+        declareNative('hook', 'manifest.hooks');
+    }
+    if (manifest.apps)
+        declareNative('app', 'manifest.apps');
+    if (manifest.slashCommands)
+        unsupportedKinds.add('slashCommand');
+    const configInputs = Object.keys(manifest.config?.fields ?? {}).sort(compareText);
+    for (const instruction of resolvePlatformEntries(manifest.extensions?.instructions, 'codex')) {
+        extensionKinds.add('instruction');
+        addAwComponent(components, {
+            key: `extensions.instructions:${instruction.name}`,
+            kind: 'instruction',
+            scopes: [...BOTH_SCOPES],
+            dynamic: false,
+            name: instruction.name,
+        });
+    }
+    for (const permission of resolvePlatformEntries(manifest.extensions?.permissions, 'codex')) {
+        extensionKinds.add('permission');
+        addAwComponent(components, {
+            key: `extensions.permissions:${permission.name}`,
+            kind: 'permission',
+            scopes: [...BOTH_SCOPES],
+            dynamic: false,
+            name: permission.name,
+        });
+    }
+    for (const agent of resolvePlatformEntries(manifest.extensions?.agents, 'codex')) {
+        extensionKinds.add('agent');
+        addAwComponent(components, {
+            key: `extensions.agents:${agent.name}`,
+            kind: 'agent',
+            scopes: [...BOTH_SCOPES],
+            dynamic: false,
+            name: agent.name,
+        });
+    }
+    for (const target of manifest.artifacts?.targets ?? []) {
+        if (target.platform !== 'codex')
+            continue;
+        const kind = target.target === 'codex.skill'
+            ? 'skill'
+            : target.target === 'codex.agentRole'
+                ? 'agent'
+                : 'instruction';
+        if (target.target === 'codex.skill' && target.delivery?.mode === 'codex-native') {
+            nativeKinds.add('skill');
+            components.push({
+                key: `artifacts.targets:${target.id}`,
+                kind: 'skill',
+                owner: 'codex-native',
+                scopes: [...target.scopes],
+                dynamic: true,
+                name: target.skillKey,
+            });
+        }
+        else {
+            extensionKinds.add(kind);
+            addAwComponent(components, {
+                key: `artifacts.targets:${target.id}`,
+                kind,
+                scopes: [...target.scopes],
+                dynamic: true,
+                name: target.skillKey ?? target.roleKey ?? target.id,
+            });
+        }
+    }
+    const orderedNativeKinds = NATIVE_KIND_ORDER
+        .filter((kind) => kind !== 'slashCommand' && nativeKinds.has(kind));
+    const orderedExtensionKinds = EXTENSION_KIND_ORDER.filter((kind) => extensionKinds.has(kind));
+    const orderedUnsupportedKinds = NATIVE_KIND_ORDER
+        .filter((kind) => kind === 'slashCommand' && unsupportedKinds.has(kind));
+    const collisions = collectOwnerCollisions(components);
+    const missingNativeIdentityKinds = orderedNativeKinds.filter((kind) => components.some((component) => component.owner === 'aw'
+        && component.dynamic
+        && component.kind === kind)
+        && components.some((component) => component.owner === 'codex-native'
+            && component.kind === kind
+            && !component.name));
+    const errorCode = collisions.length > 0
+        ? 'codexSurfaceOwnerCollision'
+        : missingNativeIdentityKinds.length > 0
+            ? 'codexSurfaceNativeIdentityMissing'
+            : orderedUnsupportedKinds.length > 0
+                ? 'codexNativeKindUnsupported'
+                : undefined;
+    const classification = errorCode
+        ? 'unsupported'
+        : orderedNativeKinds.length > 0 && orderedExtensionKinds.length > 0
+            ? 'mixed'
+            : orderedNativeKinds.length > 0
+                ? 'native'
+                : orderedExtensionKinds.length > 0
+                    ? 'aw-extension'
+                    : 'empty';
+    const deliveryOwner = errorCode
+        ? 'unsupported'
+        : classification === 'mixed'
+            ? 'split'
+            : classification === 'native'
+                ? 'codex-native'
+                : classification === 'aw-extension'
+                    ? 'aw'
+                    : 'none';
+    return {
+        ok: errorCode === undefined,
+        configInputs,
+        nativeKinds: orderedNativeKinds,
+        extensionKinds: orderedExtensionKinds,
+        unsupportedKinds: orderedUnsupportedKinds,
+        classification,
+        deliveryOwner,
+        scopeOverlap: errorCode
+            ? 'none'
+            : orderedExtensionKinds.length > 0
+                ? 'aw-owned-conflict'
+                : orderedNativeKinds.length > 0
+                    ? 'native-compatible'
+                    : 'none',
+        components,
+        collisions,
+        missingNativeIdentityKinds,
+        ...(errorCode ? { errorCode } : {}),
+    };
+}
+export function assertCodexSurfaceSupported(analysis) {
+    if (!analysis.ok)
+        throw new CodexSurfaceAnalysisError(analysis);
+    return analysis;
+}
+//# sourceMappingURL=codex-surface-analysis.js.map

package/dist/src/utils/codex-surface-analysis.js.map

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

package/dist/src/utils/config-value.d.ts

@@ -0,0 +1,3 @@
+export declare const INVALID_CONFIG_JSON_VALUE_MESSAGE = "Invalid JSON value for --value-json: expected a valid JSON literal.";
+export declare function parseConfigValue(value: unknown, valueJson: boolean): unknown;
+export declare function formatConfigCommandValue(value: unknown, valueJson: boolean): string;

package/dist/src/utils/config-value.js

@@ -0,0 +1,23 @@
+export const INVALID_CONFIG_JSON_VALUE_MESSAGE = 'Invalid JSON value for --value-json: expected a valid JSON literal.';
+export function parseConfigValue(value, valueJson) {
+    if (!valueJson)
+        return value;
+    try {
+        const raw = typeof value === 'string' ? value : JSON.stringify(value);
+        if (raw === undefined)
+            throw new Error('undefined JSON value');
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(INVALID_CONFIG_JSON_VALUE_MESSAGE);
+    }
+}
+export function formatConfigCommandValue(value, valueJson) {
+    if (!valueJson)
+        return String(value);
+    if (typeof value === 'string')
+        return value;
+    const serialized = JSON.stringify(value);
+    return serialized === undefined ? String(value) : serialized;
+}
+//# sourceMappingURL=config-value.js.map

package/dist/src/utils/config-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-value.js","sourceRoot":"","sources":["../../../src/utils/config-value.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iCAAiC,GAC5C,qEAAqE,CAAC;AAExE,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,SAAkB;IACjE,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,SAAkB;IACzE,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/D,CAAC"}

package/dist/src/utils/dynamic-skill-tree.d.ts

@@ -0,0 +1,36 @@
+import type { ClaudeSkillArtifact, CodexSkillArtifact } from '../types.js';
+import { type OwnerIdentity } from './ownership.js';
+export declare const SKILL_FILE_PATH = "SKILL.md";
+export declare const CODEX_OPENAI_YAML_PATH = "agents/openai.yaml";
+export declare const AW_PLUGIN_REQUIREMENTS_RECEIPT_PATH = "aw-plugin-requirements.json";
+export interface DynamicSkillTree {
+    skillKey: string;
+    files: Record<string, Buffer>;
+}
+export declare function validatePortableSkillName(value: string, fieldName?: string): void;
+export declare function validateCodexOpenAiYaml(rawContent: string): void;
+export declare function validateClaudeSkillFrontmatter(rawContent: string, expectedSkillName?: string): void;
+export declare function validatePortableSkillFrontmatter(rawContent: string, expectedSkillName?: string): void;
+export declare function parsePortableSkillFrontmatter(rawContent: string): Record<string, unknown>;
+export declare function validatePortableSkillDirectory(rootDir: string): Promise<DynamicSkillTree>;
+export declare function validatePortableSkillDirectoriesRoot(rootDir: string): Promise<DynamicSkillTree[]>;
+export declare function validateSkillDirectory(rootDir: string, target: CodexSkillArtifact['target'] | ClaudeSkillArtifact['target'], options?: {
+    ownerMarkerPolicy?: 'reject' | 'ignore';
+    requirementsReceiptPolicy?: 'reject' | 'allow';
+}): Promise<DynamicSkillTree>;
+export declare function validateSkillDirectoriesRoot(rootDir: string, target: CodexSkillArtifact['target'] | ClaudeSkillArtifact['target']): Promise<DynamicSkillTree[]>;
+export declare function createDynamicSkillExpectedTree(options: {
+    artifact: Pick<CodexSkillArtifact | ClaudeSkillArtifact, 'target' | 'skillKey' | 'state' | 'content'>;
+    sourceDirs?: string[];
+    requireReadme?: boolean;
+    requirementsReceipt?: Buffer;
+    sourceRequirementsReceiptPolicy?: 'reject' | 'allow' | 'ignore';
+}): Promise<DynamicSkillTree>;
+export declare function createDynamicSkillTreeContentDigest(tree: DynamicSkillTree): string;
+export declare function skillDirectoryMatchesExpectedTree(rootDir: string, tree: DynamicSkillTree): Promise<boolean>;
+export declare function writeDynamicSkillTree(rootDir: string, tree: DynamicSkillTree, ownership?: {
+    allowedRoot: string;
+    identity: OwnerIdentity;
+    allowPristineUnowned?: boolean;
+}): Promise<string[]>;
+export declare function readDynamicSkillTree(rootDir: string, target: CodexSkillArtifact['target'] | ClaudeSkillArtifact['target']): Promise<DynamicSkillTree | null>;