@lesliechan721/aw 0.1.0-beta.10

package/dist/src/utils/artifact-renderer.js

@@ -0,0 +1,400 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { assertReadyPluginConfigStore, readPluginConfigStore, resolveEffectivePluginConfig, resolvePluginConfigStorePath, } from './plugin-config.js';
+import { buildNodeScriptInvocation, buildPluginScriptSpawnEnv, calculateFileDigest, collectSensitivePluginConfigValues, defaultPluginProcessRunner, resolveBundledPluginFilePath, resolvePluginScriptTimeoutMs, summarizePluginScriptOutput, truncatePluginScriptOutput, } from './plugin-scripts.js';
+import { resolveAwHome } from './paths.js';
+import { getArtifactSourceBundleRelativePath } from './artifact-sources.js';
+import { resolveArtifactRequest } from './artifact-request.js';
+import { validateArtifactPlan } from './artifact-plan.js';
+const SUPPORTED_ARTIFACT_RENDER_EVENTS = new Set([
+    'install',
+    'refresh',
+    'materialize',
+]);
+function artifactRendererCodexHome(env) {
+    return env.AW_CODEX_HOME || path.join(resolveAwHome(env), 'isolated-codex-home');
+}
+function artifactRendererClaudeHome(env) {
+    return env.AW_CLAUDE_HOME || path.join(resolveAwHome(env), 'isolated-claude-home');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertArtifactRenderEvent(value) {
+    if (!SUPPORTED_ARTIFACT_RENDER_EVENTS.has(value)) {
+        throw new Error(`Artifact renderer only supports install, refresh, and materialize events; received "${value}".`);
+    }
+    return value;
+}
+export async function resolveArtifactRenderConfig(options) {
+    const pluginName = options.pluginName ?? options.manifest.name;
+    const schema = options.manifest.config?.fields;
+    if (!schema) {
+        const userStore = await readPluginConfigStore({
+            sourceId: options.sourceId,
+            sourceIdentity: options.sourceIdentity,
+            pluginName,
+            scope: 'user',
+            cwd: options.cwd,
+            env: options.env,
+        });
+        const projectStore = options.scope === 'user'
+            ? undefined
+            : await readPluginConfigStore({
+                sourceId: options.sourceId,
+                sourceIdentity: options.sourceIdentity,
+                pluginName,
+                scope: 'project',
+                cwd: options.cwd,
+                env: options.env,
+            });
+        assertReadyPluginConfigStore(userStore);
+        if (projectStore)
+            assertReadyPluginConfigStore(projectStore);
+        return {
+            mode: 'artifact-render',
+            targetScope: options.scope,
+            schema: undefined,
+            values: {},
+            sources: {},
+            issues: [],
+            stores: {
+                user: userStore,
+                ...(projectStore ? { project: projectStore } : {}),
+            },
+        };
+    }
+    const effective = await resolveEffectivePluginConfig({
+        sourceId: options.sourceId,
+        sourceIdentity: options.sourceIdentity,
+        pluginName,
+        manifest: options.manifest,
+        targetScope: options.scope,
+        cwd: options.cwd,
+        env: options.env,
+    });
+    return {
+        mode: 'artifact-render',
+        targetScope: options.scope,
+        schema,
+        values: effective.values,
+        sources: effective.sources,
+        issues: effective.issues,
+        stores: effective.stores,
+    };
+}
+export async function resolveArtifactRendererTarget(plugin) {
+    const entry = plugin.manifest.scripts?.artifacts?.render;
+    const bundleRoot = await fs.realpath(plugin.rootDir);
+    const manifestPath = await fs.realpath(plugin.manifestPath);
+    const manifestDigest = await calculateFileDigest(manifestPath);
+    if (!entry) {
+        return {
+            noOp: true,
+            bundleRoot,
+            sourceManifest: plugin.manifest,
+            manifestPath,
+            manifestDigest,
+        };
+    }
+    const entryPath = await resolveBundledPluginFilePath({
+        bundleRoot,
+        pluginRelativePath: entry.path,
+        fieldName: 'Artifact renderer',
+    });
+    return {
+        noOp: false,
+        entry,
+        entryPath,
+        bundleRoot,
+        sourceManifest: plugin.manifest,
+        manifestPath,
+        manifestDigest,
+        rendererDigest: await calculateFileDigest(entryPath),
+    };
+}
+export async function writeArtifactRendererContext(options) {
+    const event = assertArtifactRenderEvent(options.event);
+    if (options.target.noOp ||
+        !options.target.entry ||
+        !options.target.entryPath ||
+        !options.target.bundleRoot ||
+        !options.target.sourceManifest ||
+        !options.target.manifestPath ||
+        !options.target.manifestDigest ||
+        !options.target.rendererDigest) {
+        throw new Error('Cannot write artifact renderer context for a no-op target.');
+    }
+    const config = await resolveArtifactRenderConfig({
+        sourceId: options.sourceId,
+        sourceIdentity: options.sourceIdentity,
+        pluginName: options.target.sourceManifest.name,
+        manifest: options.target.sourceManifest,
+        scope: options.configScope ?? options.scope,
+        cwd: options.cwd,
+        env: options.commandEnv,
+    });
+    const distribution = options.platform === 'agent-skills' ? options.platform : undefined;
+    const platform = distribution ? undefined : options.platform;
+    const request = resolveArtifactRequest({
+        manifest: options.target.sourceManifest,
+        platform: options.platform,
+        scope: options.scope,
+        requestedArtifactIds: options.requestedArtifactIds,
+    });
+    const artifactSources = await Promise.all(request.declarations
+        .map(async (target) => ({
+        id: target.id,
+        target: target.target,
+        sourceDirs: await Promise.all((target.sourceDirs ?? []).map((_, index) => resolveBundledPluginFilePath({
+            bundleRoot: options.target.bundleRoot,
+            pluginRelativePath: `./${getArtifactSourceBundleRelativePath({
+                platform: target.platform,
+                distribution: target.distribution,
+                artifactId: target.id,
+                index,
+            })}`,
+            fieldName: `Artifact source ${target.id}[${index}]`,
+        }))),
+    })));
+    const context = {
+        event,
+        surface: distribution
+            ? { kind: 'distribution', name: distribution }
+            : { kind: 'platform', name: platform },
+        platform,
+        distribution,
+        scope: options.scope,
+        plugin: {
+            name: options.target.sourceManifest.name,
+            version: options.target.sourceManifest.version,
+            rootDir: options.target.bundleRoot,
+        },
+        config: {
+            mode: config.mode,
+            targetScope: config.targetScope,
+            schema: config.schema,
+            values: config.values,
+            sources: config.sources,
+            issues: config.issues,
+        },
+        changedConfigKeys: options.changedConfigKeys ?? [],
+        requestedArtifactIds: request.requestedArtifactIds,
+        previousArtifacts: options.previousArtifacts ?? [],
+        artifactSources,
+        runtimeImports: request.declarations
+            .flatMap((target) => (target.runtimeImports ?? []).map((runtimeImport) => {
+            if (!runtimeImport.resolved) {
+                throw new Error(`Artifact runtime import "${target.id}/${runtimeImport.name}" is not resolved in the bundle.`);
+            }
+            return {
+                artifactId: target.id,
+                name: runtimeImport.name,
+                providerPluginId: runtimeImport.resolved.providerPluginId,
+                exportName: runtimeImport.export,
+                path: path.join(options.target.bundleRoot, runtimeImport.resolved.path.replace(/^\.\//u, '')),
+                digest: runtimeImport.resolved.digest,
+            };
+        })),
+        paths: {
+            awHome: resolveAwHome(options.commandEnv),
+            codexHome: artifactRendererCodexHome(options.commandEnv),
+            claudeHome: artifactRendererClaudeHome(options.commandEnv),
+            manifestPath: options.target.manifestPath,
+            configStores: {
+                user: resolvePluginConfigStorePath({
+                    sourceId: options.sourceId,
+                    pluginName: options.target.sourceManifest.name,
+                    scope: 'user',
+                    cwd: options.cwd,
+                    env: options.commandEnv,
+                }),
+                project: resolvePluginConfigStorePath({
+                    sourceId: options.sourceId,
+                    pluginName: options.target.sourceManifest.name,
+                    scope: 'project',
+                    cwd: options.cwd,
+                    env: options.commandEnv,
+                }),
+            },
+        },
+        renderer: {
+            runner: options.target.entry.runner,
+            path: options.target.entryPath,
+            args: options.target.entry.args ?? [],
+            manifestDigest: options.target.manifestDigest,
+            rendererDigest: options.target.rendererDigest,
+        },
+    };
+    const tempRoot = path.join(resolveAwHome(options.commandEnv), 'tmp');
+    await fs.ensureDir(tempRoot);
+    const tempDir = await fs.mkdtemp(path.join(tempRoot, 'plugin-artifact-render-'));
+    const contextPath = path.join(tempDir, 'context.json');
+    await fs.writeJson(contextPath, context, { spaces: 2 });
+    try {
+        await fs.chmod(contextPath, 0o600);
+    }
+    catch {
+        // Best effort on non-POSIX filesystems.
+    }
+    return {
+        context,
+        contextPath,
+        tempDir,
+        sensitiveValues: collectSensitivePluginConfigValues(options.target.sourceManifest, config.values),
+        cleanup: async () => {
+            await fs.remove(tempDir);
+        },
+    };
+}
+function summarizeRenderOutput(value, sensitiveValues) {
+    const summary = summarizePluginScriptOutput(value, sensitiveValues);
+    return summary === '' ? '<empty>' : summary;
+}
+function assertArtifactPlanEnvelope(value, output) {
+    if (!isRecord(value)) {
+        throw new Error(`Artifact renderer must write a JSON object to stdout. stdout: ${output.stdoutSummary}. stderr: ${output.stderrSummary}`);
+    }
+    if (value.version !== 2) {
+        const migrationHint = value.version === 1
+            ? ' ArtifactPlan V1 is not supported by AW 1.0.0-beta.30; upgrade or reinstall the plugin.'
+            : '';
+        throw new Error(`Artifact renderer returned unsupported plan version "${String(value.version)}".${migrationHint} stderr: ${output.stderrSummary}`);
+    }
+    if (!Array.isArray(value.artifacts)) {
+        throw new Error(`Artifact renderer returned an invalid plan: "artifacts" must be an array. stdout: ${output.stdoutSummary}. stderr: ${output.stderrSummary}`);
+    }
+    return value;
+}
+function buildArtifactRendererInvocation(options) {
+    return buildNodeScriptInvocation({
+        entryPath: options.entryPath,
+        cwd: options.cwd,
+        env: options.env,
+        args: options.entry.args,
+    });
+}
+function assertRefreshKeysForEvent(event, changedConfigKeys) {
+    assertArtifactRenderEvent(event);
+    const keys = changedConfigKeys ? [...changedConfigKeys] : [];
+    if (event === 'refresh' && keys.length === 0) {
+        throw new Error('Artifact renderer refresh requires changedConfigKeys.');
+    }
+    return keys;
+}
+async function runArtifactRendererProcess(options) {
+    const runOptions = {
+        timeoutMs: options.timeoutMs,
+        ...(options.signal ? { signal: options.signal } : {}),
+    };
+    return options.runner
+        ? options.runner.run(options.invocation, runOptions)
+        : defaultPluginProcessRunner.run(options.invocation, {
+            ...runOptions,
+            sensitiveValues: options.sensitiveValues,
+        });
+}
+export async function runArtifactRenderer(options) {
+    options.signal?.throwIfAborted();
+    const event = assertArtifactRenderEvent(options.event);
+    const commandEnv = options.commandEnv ?? process.env;
+    const changedConfigKeys = assertRefreshKeysForEvent(event, options.changedConfigKeys);
+    const target = await resolveArtifactRendererTarget(options.plugin);
+    if (target.noOp) {
+        throw new Error(`Plugin "${options.plugin.manifest.name}" does not declare scripts.artifacts.render.`);
+    }
+    const writtenContext = await writeArtifactRendererContext({
+        sourceId: options.plugin.sourceId,
+        sourceIdentity: options.plugin.sourceIdentity,
+        target,
+        event,
+        platform: options.platform,
+        scope: options.scope,
+        ...(options.configScope ? { configScope: options.configScope } : {}),
+        cwd: options.cwd,
+        commandEnv,
+        changedConfigKeys,
+        previousArtifacts: options.previousArtifacts,
+        requestedArtifactIds: options.requestedArtifactIds,
+    });
+    try {
+        if (writtenContext.context.config.issues.length > 0) {
+            throw new Error(`Invalid AW config for ${writtenContext.context.plugin.name}: ${writtenContext.context.config.issues.map((issue) => `${issue.key} (${issue.type})`).join(', ')}.`);
+        }
+        await fs.ensureDir(path.join(writtenContext.tempDir, 'home'));
+        await fs.ensureDir(path.join(writtenContext.tempDir, 'tmp'));
+        const timeoutMs = resolvePluginScriptTimeoutMs({
+            cliTimeoutMs: options.scriptTimeoutMs,
+            manifestTimeoutMs: undefined,
+        });
+        const spawnEnv = buildPluginScriptSpawnEnv({
+            commandEnv,
+            contextPath: writtenContext.contextPath,
+            tempDir: writtenContext.tempDir,
+            plugin: writtenContext.context.plugin,
+            event,
+            ...(options.platform === 'agent-skills'
+                ? { distribution: options.platform }
+                : { platform: options.platform }),
+            scope: options.scope,
+            bundleRoot: writtenContext.context.plugin.rootDir,
+        });
+        const invocation = buildArtifactRendererInvocation({
+            entry: target.entry,
+            entryPath: target.entryPath,
+            cwd: options.cwd,
+            env: spawnEnv,
+        });
+        const result = await runArtifactRendererProcess({
+            invocation,
+            timeoutMs,
+            sensitiveValues: writtenContext.sensitiveValues,
+            signal: options.signal,
+            runner: options.runner,
+        });
+        const stdoutSummary = summarizeRenderOutput(result.stdout, writtenContext.sensitiveValues);
+        const stderrSummary = summarizeRenderOutput(result.stderr, writtenContext.sensitiveValues);
+        if (result.timedOut) {
+            throw new Error(`Artifact renderer timed out after ${timeoutMs} ms. stderr: ${stderrSummary}`);
+        }
+        if (result.exitCode !== 0) {
+            throw new Error(`Artifact renderer failed with exit code ${result.exitCode}. stderr: ${stderrSummary}`);
+        }
+        const rawStdout = truncatePluginScriptOutput(result.stdout).trim();
+        let parsed;
+        try {
+            parsed = JSON.parse(rawStdout);
+        }
+        catch {
+            throw new Error(`Artifact renderer must write JSON to stdout. stdout: ${stdoutSummary}. stderr: ${stderrSummary}`);
+        }
+        const plan = assertArtifactPlanEnvelope(parsed, {
+            stdoutSummary,
+            stderrSummary,
+        });
+        validateArtifactPlan({
+            manifest: options.plugin.manifest,
+            plan,
+            platform: options.platform,
+            scope: options.scope,
+            requestedArtifactIds: writtenContext.context.requestedArtifactIds,
+            renderConfig: writtenContext.context.config,
+            rendererDigest: target.rendererDigest,
+            manifestDigest: target.manifestDigest,
+        });
+        return {
+            plan,
+            target,
+            context: writtenContext.context,
+            exitCode: result.exitCode,
+            signal: result.signal,
+            stdout: stdoutSummary,
+            stderr: stderrSummary,
+            timedOut: result.timedOut,
+        };
+    }
+    finally {
+        await writtenContext.cleanup();
+    }
+}
+//# sourceMappingURL=artifact-renderer.js.map

package/dist/src/utils/artifact-renderer.js.map

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

package/dist/src/utils/artifact-request.d.ts

@@ -0,0 +1,16 @@
+import type { DistributionName, NormalizedPluginManifest, PlatformName, PluginArtifactTargetDefinition, Scope } from '../types.js';
+export interface ResolvedArtifactRequest {
+    requestedArtifactIds: string[];
+    declarations: PluginArtifactTargetDefinition[];
+}
+export declare function resolveAwDeliveredArtifactIds(options: {
+    manifest: NormalizedPluginManifest;
+    platform: PlatformName | DistributionName;
+    scope: Scope;
+}): string[];
+export declare function resolveArtifactRequest(options: {
+    manifest: NormalizedPluginManifest;
+    platform: PlatformName | DistributionName;
+    scope: Scope;
+    requestedArtifactIds: readonly string[];
+}): ResolvedArtifactRequest;

package/dist/src/utils/artifact-request.js

@@ -0,0 +1,42 @@
+export function resolveAwDeliveredArtifactIds(options) {
+    return (options.manifest.artifacts?.targets ?? [])
+        .filter((target) => (target.platform ?? target.distribution) === options.platform
+        && target.scopes.includes(options.scope)
+        && target.delivery?.mode !== 'codex-native')
+        .map((target) => target.id);
+}
+export function resolveArtifactRequest(options) {
+    if (options.requestedArtifactIds.length === 0) {
+        throw new Error('Artifact renderer requires at least one requested artifact ID.');
+    }
+    const requested = new Set();
+    for (const [index, value] of options.requestedArtifactIds.entries()) {
+        if (typeof value !== 'string' || value.trim() === '') {
+            throw new Error(`Invalid requestedArtifactIds[${index}]: expected a non-empty artifact ID.`);
+        }
+        if (requested.has(value)) {
+            throw new Error(`Invalid requestedArtifactIds[${index}]: duplicate artifact ID "${value}".`);
+        }
+        requested.add(value);
+    }
+    const allowedDeclarations = (options.manifest.artifacts?.targets ?? []).filter((target) => (target.platform ?? target.distribution) === options.platform
+        && target.scopes.includes(options.scope));
+    const allowedById = new Map();
+    for (const declaration of allowedDeclarations) {
+        if (allowedById.has(declaration.id)) {
+            throw new Error(`Artifact renderer request is ambiguous because artifact ID "${declaration.id}" is declared more than once for ${options.platform}/${options.scope}.`);
+        }
+        allowedById.set(declaration.id, declaration);
+    }
+    for (const id of requested) {
+        if (!allowedById.has(id)) {
+            throw new Error(`Requested artifact ID "${id}" is not declared for ${options.platform}/${options.scope}.`);
+        }
+    }
+    const declarations = allowedDeclarations.filter((target) => requested.has(target.id));
+    return {
+        requestedArtifactIds: declarations.map((target) => target.id),
+        declarations,
+    };
+}
+//# sourceMappingURL=artifact-request.js.map

package/dist/src/utils/artifact-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-request.js","sourceRoot":"","sources":["../../../src/utils/artifact-request.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,6BAA6B,CAAC,OAI7C;IACC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC;SAC/C,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACjB,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,QAAQ;WAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;WACrC,MAAM,CAAC,QAAQ,EAAE,IAAI,KAAK,cAAc,CAAC;SAC7C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAKtC;IACC,IAAI,OAAO,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC;QACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,sCAAsC,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,6BAA6B,KAAK,IAAI,CAAC,CAAC;QAC/F,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,mBAAmB,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACxF,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,QAAQ;WAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0C,CAAC;IACtE,KAAK,MAAM,WAAW,IAAI,mBAAmB,EAAE,CAAC;QAC9C,IAAI,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+DAA+D,WAAW,CAAC,EAAE,oCAAoC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,GAAG,CACtJ,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,0BAA0B,EAAE,yBAAyB,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,GAAG,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,OAAO;QACL,oBAAoB,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/src/utils/artifact-sources.d.ts

@@ -0,0 +1,8 @@
+import type { DistributionName, PlatformName } from '../types.js';
+export declare const ARTIFACT_SOURCES_ROOT: string;
+export declare function getArtifactSourceBundleRelativePath(options: {
+    platform?: PlatformName;
+    distribution?: DistributionName;
+    artifactId: string;
+    index: number;
+}): string;

package/dist/src/utils/artifact-sources.js

@@ -0,0 +1,10 @@
+import path from 'node:path';
+export const ARTIFACT_SOURCES_ROOT = path.posix.join('.agents-plugin', 'artifact-sources');
+export function getArtifactSourceBundleRelativePath(options) {
+    const surface = options.platform ?? options.distribution;
+    if (!surface) {
+        throw new Error('Artifact source surface is required.');
+    }
+    return path.posix.join(ARTIFACT_SOURCES_ROOT, surface, options.artifactId, String(options.index));
+}
+//# sourceMappingURL=artifact-sources.js.map

package/dist/src/utils/artifact-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-sources.js","sourceRoot":"","sources":["../../../src/utils/artifact-sources.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAE3F,MAAM,UAAU,mCAAmC,CAAC,OAKnD;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,qBAAqB,EACrB,OAAO,EACP,OAAO,CAAC,UAAU,EAClB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CACtB,CAAC;AACJ,CAAC"}

package/dist/src/utils/aw-home-mutation-lock.d.ts

@@ -0,0 +1,11 @@
+declare const awHomeMutationTokenBrand: unique symbol;
+export type AwHomeMutationToken = Readonly<{
+    [awHomeMutationTokenBrand]: true;
+}>;
+export declare function withAwHomeMutationLock<T>(options: {
+    env?: NodeJS.ProcessEnv;
+    token?: AwHomeMutationToken;
+    signal?: AbortSignal;
+    action: (token: AwHomeMutationToken) => Promise<T>;
+}): Promise<T>;
+export {};

package/dist/src/utils/aw-home-mutation-lock.js

@@ -0,0 +1,83 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { acquireProcessLock } from './process-lock.js';
+import { canonicalizePathThroughExistingAncestorSync, ensureRegularDirectoryPath, resolveAwHome, } from './state-paths.js';
+import { assertTestWritablePath } from './test-path-fence.js';
+const AW_HOME_MUTATION_LOCK_TIMEOUT_MS = 600_000;
+const tokenRoots = new WeakMap();
+function resolveAwHomeMutationCoordinationRoot(env = process.env) {
+    const awHome = canonicalizePathThroughExistingAncestorSync(resolveAwHome(env));
+    const identity = crypto.createHash('sha256')
+        .update(awHome)
+        .digest('hex')
+        .slice(0, 16);
+    return assertTestWritablePath(path.join(path.dirname(awHome), '.aw-local-marketplace-staging', `.runtime-state-${identity}`), 'AW_HOME mutation coordination root', '用 createIsolatedTestEnv() 生成默认 AW_HOME，或登记 AW_HOME 同盘 sibling lock 路径。');
+}
+async function releaseMutationLease(lease) {
+    let lastError;
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            await lease.release();
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            if (!new Set(['EACCES', 'EBUSY', 'EINTR', 'EIO', 'ENOTEMPTY', 'EPERM']).has(error.code ?? '')) {
+                throw error;
+            }
+        }
+    }
+    await lease.release().catch(() => undefined);
+    throw lastError;
+}
+function releaseWarning() {
+    try {
+        process.emitWarning('AW_HOME mutation completed, but its lock release failed.', { code: 'AW_HOME_MUTATION_LOCK_RELEASE_FAILED' });
+    }
+    catch {
+        // Diagnostics cannot replace the action result.
+    }
+}
+export async function withAwHomeMutationLock(options) {
+    const coordinationRoot = resolveAwHomeMutationCoordinationRoot(options.env);
+    if (options.token !== undefined) {
+        options.signal?.throwIfAborted();
+        const tokenRoot = tokenRoots.get(options.token);
+        if (tokenRoot === undefined) {
+            throw new Error('Invalid AW_HOME mutation token.');
+        }
+        if (tokenRoot !== coordinationRoot) {
+            throw new Error('AW_HOME mutation token belongs to a different coordination root.');
+        }
+        return options.action(options.token);
+    }
+    await ensureRegularDirectoryPath(coordinationRoot, 'AW_HOME mutation coordination root');
+    const lease = await acquireProcessLock({
+        lockPath: path.join(coordinationRoot, 'aw-home-mutation.lock'),
+        timeoutMs: AW_HOME_MUTATION_LOCK_TIMEOUT_MS,
+        signal: options.signal,
+    });
+    const token = Object.freeze({});
+    tokenRoots.set(token, coordinationRoot);
+    let result;
+    let actionError;
+    let succeeded = false;
+    try {
+        result = await options.action(token);
+        succeeded = true;
+    }
+    catch (error) {
+        actionError = error;
+    }
+    tokenRoots.delete(token);
+    try {
+        await releaseMutationLease(lease);
+    }
+    catch {
+        releaseWarning();
+    }
+    if (!succeeded)
+        throw actionError;
+    return result;
+}
+//# sourceMappingURL=aw-home-mutation-lock.js.map

package/dist/src/utils/aw-home-mutation-lock.js.map

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

package/dist/src/utils/bundle-integrity.d.ts

@@ -0,0 +1,2 @@
+export declare function calculateFileDigest(filePath: string): Promise<string>;
+export declare function calculatePluginBundleFingerprint(bundleRoot: string): Promise<string>;