@layerzerolabs/vm-tooling 0.2.104 → 0.2.106

package/dist/KN3TRHEZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/docker.ts"],"names":["resolveDockerPlatform","dockerPlatform","undefined","archSegment","split","arch","value","namespace","replace","resolveEffectiveDockerPlatformValue","toolDockerPlatform","envDockerPlatform","env","DOCKER_DEFAULT_PLATFORM","DOCKER_PLATFORM_NATIVE","resolveDockerPlatformExecution","options","_dockerDefaultPlatform","processEnv","args","volumeNameOptions","platform","findImageForTool","context","toolName","version","image","versionCombinations","flatMap","combination","imageId","images","findToolVersionsForCombination","Error","getImageUri","join","getRegistry","getImageDirectory","getImageName","name","getImageTag","versions","patch","Object","entries","sort","flat","qualifyVolumeName","volume","cacheKey","type","components","shared","toolchainKeyed","push","packageName","npm_package_name","basename","architectureIndependent"],"mappings":"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","file":"KN3TRHEZ.js","sourcesContent":["import { basename, join } from 'node:path';\nimport { env } from 'node:process';\n\nimport type { DockerPlatformOverride, DockerPlatformValue, Image, VolumeMapping } from '../config';\nimport { DOCKER_PLATFORM_NATIVE, getImageDirectory, getRegistry } from '../config';\nimport type { ChainContext } from '../context';\nimport { findToolVersionsForCombination, getImageName } from './finder';\n\nexport interface DockerPlatform {\n    /** Raw value, e.g. `linux/amd64`, for Docker `--platform`. */\n    value: string;\n    /** Filesystem-safe token for cache volume names, e.g. `linux-amd64`. */\n    namespace: string;\n    /** Architecture as `docker inspect --format {{.Architecture}}` reports it, e.g. `amd64`. */\n    arch: string;\n}\n\nexport type DockerProcessEnv = Record<string, string | undefined>;\n\nexport interface QualifyVolumeNameOptions {\n    cacheKey?: string;\n    dockerPlatform?: string;\n}\n\nexport interface DockerPlatformResolutionOptions {\n    dockerPlatform?: DockerPlatformOverride;\n    toolDockerPlatform?: DockerPlatformValue;\n    envDockerPlatform?: string;\n}\n\nexport interface DockerPlatformExecution {\n    platform?: DockerPlatform;\n    args: string[];\n    processEnv?: DockerProcessEnv;\n    volumeNameOptions: QualifyVolumeNameOptions;\n}\n\nexport const resolveDockerPlatform = (dockerPlatform?: string): DockerPlatform | undefined => {\n    if (!dockerPlatform) {\n        return undefined;\n    }\n\n    const [, archSegment] = dockerPlatform.split('/');\n    const arch = archSegment || dockerPlatform;\n\n    return {\n        value: dockerPlatform,\n        namespace: dockerPlatform.replace(/\\//g, '-'),\n        arch,\n    };\n};\n\n// Platform precedence is intentional: CLI override > tool default > DOCKER_DEFAULT_PLATFORM.\n// A tool default is an explicit choice made by the tool config (for example Anchor's amd64 pin),\n// so a user's shell env should not override it by accident. DOCKER_DEFAULT_PLATFORM only applies\n// when the tool does not declare a platform.\n// `native` is an escape hatch from forced platform selection: it resolves to no\n// platform value, so Docker commands run without `--platform`.\nexport const resolveEffectiveDockerPlatformValue = ({\n    dockerPlatform,\n    toolDockerPlatform,\n    envDockerPlatform = env.DOCKER_DEFAULT_PLATFORM,\n}: DockerPlatformResolutionOptions): string | undefined => {\n    if (dockerPlatform === DOCKER_PLATFORM_NATIVE) {\n        return undefined;\n    }\n\n    return dockerPlatform ?? toolDockerPlatform ?? envDockerPlatform;\n};\n\nexport const resolveDockerPlatformExecution = (\n    options: DockerPlatformResolutionOptions,\n): DockerPlatformExecution => {\n    if (options.dockerPlatform === DOCKER_PLATFORM_NATIVE) {\n        // Clear DOCKER_DEFAULT_PLATFORM as well, otherwise Docker would still be forced\n        // to use that platform even though this run requested native execution.\n        const { DOCKER_DEFAULT_PLATFORM: _dockerDefaultPlatform, ...processEnv } = env;\n\n        return {\n            args: [],\n            processEnv,\n            volumeNameOptions: { dockerPlatform: undefined },\n        };\n    }\n\n    const platform = resolveDockerPlatform(resolveEffectiveDockerPlatformValue(options));\n\n    return {\n        platform,\n        args: platform ? ['--platform', platform.value] : [],\n        volumeNameOptions: { dockerPlatform: platform?.value },\n    };\n};\n\nexport const findImageForTool = <TImageId extends string>(\n    context: ChainContext<TImageId>,\n    toolName: string,\n    version: string,\n): Image => {\n    const [image] = context.versionCombinations.flatMap((combination) => {\n        const imageId = combination.images[toolName];\n\n        if (!imageId) {\n            return [];\n        }\n\n        const image = context.images[imageId];\n\n        return image && findToolVersionsForCombination(context, combination)[toolName] === version\n            ? [image]\n            : [];\n    });\n\n    if (!image) {\n        throw new Error(\n            `No version combination found for tool ${toolName} with version ${version}`,\n        );\n    }\n\n    return image;\n};\n\nexport const getImageUri = async (image: Image): Promise<string> =>\n    join(\n        await getRegistry(),\n        await getImageDirectory(),\n        `${getImageName(image.name)}:${getImageTag(image)}`,\n    );\n\nexport const getImageTag = ({ versions, patch }: Image): string =>\n    [...Object.entries(versions).sort().flat(), ...(patch ? ['patch', patch] : [])].join('-');\n\nexport const qualifyVolumeName = (\n    volume: VolumeMapping,\n    { cacheKey, dockerPlatform }: QualifyVolumeNameOptions = {\n        dockerPlatform: env.DOCKER_DEFAULT_PLATFORM,\n    },\n): VolumeMapping => {\n    if (volume.type !== 'isolate') {\n        return volume;\n    }\n\n    const components = ['lz-tooling-cache', volume.name];\n\n    if (!volume.shared) {\n        // Opted-in volumes key on the toolchain (image tag) so same-toolchain packages share one\n        // cache; the rest stay package-private. Falls back to package-private without a cacheKey.\n        if (volume.toolchainKeyed && cacheKey) {\n            components.push(cacheKey);\n        } else {\n            const packageName = env.npm_package_name;\n\n            if (!packageName) {\n                throw new Error('npm_package_name environment variable not defined');\n            }\n\n            components.push(basename(packageName));\n        }\n    }\n\n    const platform = resolveDockerPlatform(dockerPlatform);\n    if (platform && !volume.architectureIndependent) {\n        components.push(platform.namespace);\n    }\n\n    return { ...volume, name: components.join('-') };\n};\n"]}

package/dist/{HOFCGMNS.js → TMIYMQW3.js}

@@ -1,3 +1,4 @@
+import { registry, imageDirectory } from './GIFXFMSS.js';
 import { init_esm_shims, __name } from './CWKWODSW.js';
 import { join } from 'path';
 import * as z from 'zod';
@@ -8,12 +9,10 @@ init_esm_shims();
 var registryConfigCache;
 var getRegistryConfig = /* @__PURE__ */ __name(async () => {
   if (!registryConfigCache) {
-    const envRegistry = process.env.VM_TOOLING_REGISTRY;
-    const envImageDirectory = process.env.VM_TOOLING_IMAGE_DIRECTORY;
-    if (envRegistry && envImageDirectory) {
+    if (registry && imageDirectory) {
       registryConfigCache = {
-        registry: envRegistry,
-        imageDirectory: envImageDirectory
+        registry,
+        imageDirectory
       };
     } else {
       const workspaceRoot = await getFullyQualifiedRepoRootPath();
@@ -24,6 +23,7 @@ var getRegistryConfig = /* @__PURE__ */ __name(async () => {
   }
   return registryConfigCache;
 }, "getRegistryConfig");
+var CARGO_TARGET_CACHE_PATH = "/cargo-target";
 var volumeMappingBaseSchema = z.object({
   containerPath: z.string()
 });
@@ -35,12 +35,30 @@ var isolateVolumeMappingSchema = volumeMappingBaseSchema.extend({
   type: z.literal("isolate"),
   name: z.string(),
   shared: z.optional(z.boolean()),
-  locked: z.optional(z.boolean())
+  locked: z.optional(z.boolean()),
+  // Share this cache across packages on the same toolchain instead of per-package. See
+  // qualifyVolumeName. Opt-in — omit to keep it package-private.
+  toolchainKeyed: z.optional(z.boolean()),
+  // Opt out of arch-namespacing for volumes holding no compiled artifacts (config/state).
+  // Suffixing is the safe default: under-splitting an arch-sensitive cache poisons it.
+  architectureIndependent: z.optional(z.boolean())
 });
 var volumeMappingSchema = z.union([
   hostVolumeMappingSchema,
   isolateVolumeMappingSchema
 ]);
+var DOCKER_PLATFORM_VALUES = [
+  "linux/amd64",
+  "linux/arm64"
+];
+var DOCKER_PLATFORM_NATIVE = "native";
+var DOCKER_PLATFORM_OVERRIDE_VALUES = [
+  DOCKER_PLATFORM_NATIVE,
+  ...DOCKER_PLATFORM_VALUES
+];
+var DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION = DOCKER_PLATFORM_OVERRIDE_VALUES.join(", ");
+var dockerPlatformOverrideValueSet = new Set(DOCKER_PLATFORM_OVERRIDE_VALUES);
+var isDockerPlatformOverride = /* @__PURE__ */ __name((input) => typeof input === "string" && dockerPlatformOverrideValueSet.has(input), "isDockerPlatformOverride");
 var DockerRegistryMirror = /* @__PURE__ */ (function(DockerRegistryMirror2) {
   DockerRegistryMirror2["PUBLIC_GAR"] = "public-gar";
   return DockerRegistryMirror2;
@@ -48,6 +66,6 @@ var DockerRegistryMirror = /* @__PURE__ */ (function(DockerRegistryMirror2) {
 var getImageDirectory = /* @__PURE__ */ __name(async () => (await getRegistryConfig()).imageDirectory, "getImageDirectory");
 var getRegistry = /* @__PURE__ */ __name(async () => (await getRegistryConfig()).registry, "getRegistry");
 
-export { DockerRegistryMirror, getImageDirectory, getRegistry, volumeMappingSchema };
-//# sourceMappingURL=HOFCGMNS.js.map
-//# sourceMappingURL=HOFCGMNS.js.map
+export { CARGO_TARGET_CACHE_PATH, DOCKER_PLATFORM_NATIVE, DOCKER_PLATFORM_OVERRIDE_VALUES, DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION, DOCKER_PLATFORM_VALUES, DockerRegistryMirror, getImageDirectory, getRegistry, isDockerPlatformOverride, volumeMappingSchema };
+//# sourceMappingURL=TMIYMQW3.js.map
+//# sourceMappingURL=TMIYMQW3.js.map

package/dist/TMIYMQW3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":["registryConfigCache","getRegistryConfig","registry","imageDirectory","workspaceRoot","getFullyQualifiedRepoRootPath","configPath","join","module","default","CARGO_TARGET_CACHE_PATH","volumeMappingBaseSchema","object","containerPath","string","hostVolumeMappingSchema","extend","type","literal","hostPath","isolateVolumeMappingSchema","name","shared","optional","boolean","locked","toolchainKeyed","architectureIndependent","volumeMappingSchema","union","DOCKER_PLATFORM_VALUES","DOCKER_PLATFORM_NATIVE","DOCKER_PLATFORM_OVERRIDE_VALUES","DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION","dockerPlatformOverrideValueSet","Set","isDockerPlatformOverride","input","has","DockerRegistryMirror","getImageDirectory","getRegistry"],"mappings":";;;;;;;AAAA,cAAA,EAAA;AAcA,IAAIA,mBAAAA;AAEJ,IAAMC,oCAAoB,MAAA,CAAA,YAAA;AACtB,EAAA,IAAI,CAACD,mBAAAA,EAAqB;AACtB,IAAA,IAAgBE,YAAwBC,cAAAA,EAAgB;AACpDH,MAAAA,mBAAAA,GAAsB;AAClBE,QAAAA,QAAAA;AACAC,QAAAA;AACJ,OAAA;IACJ,CAAA,MAAO;AACH,MAAA,MAAMC,aAAAA,GAAgB,MAAMC,6BAAAA,EAAAA;AAC5B,MAAA,MAAMC,aAAaC,IAAAA,CACfH,aAAAA,EACA,SAAA,EACA,YAAA,EACA,UACA,sBAAA,CAAA;AAGJ,MAAA,MAAMI,MAAAA,GAAS,MAAM,OAAOF,UAAAA,CAAAA;AAC5BN,MAAAA,mBAAAA,GAAsBQ,MAAAA,CAAOC,OAAAA;AACjC,IAAA;AACJ,EAAA;AACA,EAAA,OAAOT,mBAAAA;AACX,CAAA,EAtB0B,mBAAA,CAAA;AA2BnB,IAAMU,uBAAAA,GAA0B;AAEvC,IAAMC,0BAA4BC,CAAAA,CAAAA,MAAAA,CAAO;AACrCC,EAAAA,aAAAA,EAAiBC,CAAAA,CAAAA,MAAAA;AACrB,CAAA,CAAA;AAEA,IAAMC,uBAAAA,GAA0BJ,wBAAwBK,MAAAA,CAAO;AAC3DC,EAAAA,IAAAA,EAAQC,UAAQ,MAAA,CAAA;AAChBC,EAAAA,QAAAA,EAAYL,CAAAA,CAAAA,MAAAA;AAChB,CAAA,CAAA;AAEA,IAAMM,0BAAAA,GAA6BT,wBAAwBK,MAAAA,CAAO;AAC9DC,EAAAA,IAAAA,EAAQC,UAAQ,SAAA,CAAA;AAChBG,EAAAA,IAAAA,EAAQP,CAAAA,CAAAA,MAAAA,EAAM;EACdQ,MAAAA,EAAUC,CAAAA,CAAAA,QAAAA,CAAWC,WAAO,CAAA;EAC5BC,MAAAA,EAAUF,CAAAA,CAAAA,QAAAA,CAAWC,WAAO,CAAA;;;EAG5BE,cAAAA,EAAkBH,CAAAA,CAAAA,QAAAA,CAAWC,WAAO,CAAA;;;EAGpCG,uBAAAA,EAA2BJ,CAAAA,CAAAA,QAAAA,CAAWC,WAAO;AACjD,CAAA,CAAA;AAEO,IAAMI,sBAAwBC,CAAAA,CAAAA,KAAAA,CAAM;AAACd,EAAAA,uBAAAA;AAAyBK,EAAAA;AAA2B,CAAA;AAYzF,IAAMU,sBAAAA,GAAyB;AAAC,EAAA,aAAA;AAAe,EAAA;;AAC/C,IAAMC,sBAAAA,GAAyB;AAC/B,IAAMC,+BAAAA,GAAkC;AAC3CD,EAAAA,sBAAAA;AACGD,EAAAA,GAAAA;;AAEA,IAAMG,2CAAAA,GACTD,+BAAAA,CAAgCzB,IAAAA,CAAK,IAAA;AAEzC,IAAM2B,8BAAAA,GAAiC,IAAIC,GAAAA,CAAYH,+BAAAA,CAAAA;AAKhD,IAAMI,wBAAAA,2BAA4BC,KAAAA,KACrC,OAAOA,UAAU,QAAA,IAAYH,8BAAAA,CAA+BI,GAAAA,CAAID,KAAAA,CAAAA,EAD5B,0BAAA;AA4BjC,IAAWE,oBAAAA,6BAAAA,qBAAAA,EAAAA;;AAAAA,EAAAA,OAAAA,qBAAAA;;AAkBX,IAAMC,iBAAAA,mBAAoB,MAAA,CAAA,YAAA,CAAa,MAAMvC,iBAAAA,IAAqBE,cAAAA,EAAxC,mBAAA;AAC1B,IAAMsC,WAAAA,mBAAc,MAAA,CAAA,YAAA,CAAa,MAAMxC,iBAAAA,IAAqBC,QAAAA,EAAxC,aAAA","file":"TMIYMQW3.js","sourcesContent":["import { join } from 'node:path';\nimport * as z from 'zod';\n\nimport { getFullyQualifiedRepoRootPath } from '@layerzerolabs/common-node-utils';\n\nimport type { ChainContext } from './context';\nimport type { ToolCommandExecutionOptions } from './core/tool-executor';\nimport * as environment from './environment';\n\ninterface RegistryConfig {\n    registry: string;\n    imageDirectory: string;\n}\n\nlet registryConfigCache: RegistryConfig | undefined;\n\nconst getRegistryConfig = async (): Promise<RegistryConfig> => {\n    if (!registryConfigCache) {\n        if (environment.registry && environment.imageDirectory) {\n            registryConfigCache = {\n                registry: environment.registry,\n                imageDirectory: environment.imageDirectory,\n            };\n        } else {\n            const workspaceRoot = await getFullyQualifiedRepoRootPath();\n            const configPath = join(\n                workspaceRoot,\n                'configs',\n                'vm-tooling',\n                'values',\n                'docker-image-repo.ts',\n            );\n\n            const module = await import(configPath);\n            registryConfigCache = module.default;\n        }\n    }\n    return registryConfigCache!;\n};\n\n// Container path for the shared cargo build-artifact cache. A VM mounts its toolchain `target/`\n// cache at this path; resolveCargoCacheEnv keys on it to inject CARGO_TARGET_DIR. Single source so\n// the helper's lookup and each VM config's containerPath can't drift apart.\nexport const CARGO_TARGET_CACHE_PATH = '/cargo-target';\n\nconst volumeMappingBaseSchema = z.object({\n    containerPath: z.string(),\n});\n\nconst hostVolumeMappingSchema = volumeMappingBaseSchema.extend({\n    type: z.literal('host'),\n    hostPath: z.string(),\n});\n\nconst isolateVolumeMappingSchema = volumeMappingBaseSchema.extend({\n    type: z.literal('isolate'),\n    name: z.string(),\n    shared: z.optional(z.boolean()),\n    locked: z.optional(z.boolean()),\n    // Share this cache across packages on the same toolchain instead of per-package. See\n    // qualifyVolumeName. Opt-in — omit to keep it package-private.\n    toolchainKeyed: z.optional(z.boolean()),\n    // Opt out of arch-namespacing for volumes holding no compiled artifacts (config/state).\n    // Suffixing is the safe default: under-splitting an arch-sensitive cache poisons it.\n    architectureIndependent: z.optional(z.boolean()),\n});\n\nexport const volumeMappingSchema = z.union([hostVolumeMappingSchema, isolateVolumeMappingSchema]);\n\nexport type VolumeMapping = z.infer<typeof volumeMappingSchema>;\n\nexport interface EnvironmentVariable {\n    name: string;\n    value: string;\n}\n\n// Explicit platform pins currently supported by tool config and the CLI.\n// `native` is a CLI-only escape hatch that runs Docker without `--platform`\n// and clears DOCKER_DEFAULT_PLATFORM for that invocation.\nexport const DOCKER_PLATFORM_VALUES = ['linux/amd64', 'linux/arm64'] as const;\nexport const DOCKER_PLATFORM_NATIVE = 'native';\nexport const DOCKER_PLATFORM_OVERRIDE_VALUES = [\n    DOCKER_PLATFORM_NATIVE,\n    ...DOCKER_PLATFORM_VALUES,\n] as const;\nexport const DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION =\n    DOCKER_PLATFORM_OVERRIDE_VALUES.join(', ');\n\nconst dockerPlatformOverrideValueSet = new Set<string>(DOCKER_PLATFORM_OVERRIDE_VALUES);\n\nexport type DockerPlatformValue = (typeof DOCKER_PLATFORM_VALUES)[number];\nexport type DockerPlatformOverride = (typeof DOCKER_PLATFORM_OVERRIDE_VALUES)[number];\n\nexport const isDockerPlatformOverride = (input: unknown): input is DockerPlatformOverride =>\n    typeof input === 'string' && dockerPlatformOverrideValueSet.has(input);\n\nexport interface Tool {\n    name: string;\n    privileged?: boolean;\n\n    // Docker platform to use when running this tool's image\n    dockerPlatform?: DockerPlatformValue;\n\n    // Default isolate volumes for caching (user volumes can override these)\n    defaultVolumes?: readonly VolumeMapping[];\n\n    // Default environment variables (user env vars can override these)\n    defaultEnv?: readonly EnvironmentVariable[];\n\n    // Optional version parsing and validation functions\n    getSecondaryVersion?: (args: { cwd: string }) => Promise<string>;\n\n    getLocalVersion?: (args: { cwd: string }) => Promise<string>;\n\n    // Optional hook called before every tool command execution (e.g., toolchain sync)\n    preExecute?: (\n        context: ChainContext<string>,\n        options: ToolCommandExecutionOptions,\n    ) => Promise<void>;\n}\n\nexport const enum DockerRegistryMirror {\n    PUBLIC_GAR = 'public-gar',\n}\n\nexport interface Image {\n    name: string;\n    versions: Record<string, string>;\n    dependencies?: Record<string, string>;\n    patch?: number;\n    mirrorRegistries?: DockerRegistryMirror[];\n}\n\nexport interface VersionCombination<TImageId> {\n    images: Record<string, TImageId>;\n    description?: string;\n    stable?: boolean;\n}\n\nexport const getImageDirectory = async () => (await getRegistryConfig()).imageDirectory;\nexport const getRegistry = async () => (await getRegistryConfig()).registry;\n"]}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAgB1D,KAAK,qBAAqB,GAAG,CACzB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,2BAA2B,CAAC,KAC7E,IAAI,CAAC;AAgMV,eAAO,MAAM,MAAM,GAAU,QAAQ,SAAS,MAAM,EAChD,QAAQ,YAAY,CAAC,QAAQ,CAAC,EAC9B,wBAAwB,qBAAqB,KAC9C,OAAO,CAAC,IAAI,CAOd,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAkB1D,KAAK,qBAAqB,GAAG,CACzB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,2BAA2B,CAAC,KAC7E,IAAI,CAAC;AAgNV,eAAO,MAAM,MAAM,GAAU,QAAQ,SAAS,MAAM,EAChD,QAAQ,YAAY,CAAC,QAAQ,CAAC,EAC9B,wBAAwB,qBAAqB,KAC9C,OAAO,CAAC,IAAI,CAOd,CAAC"}

package/dist/cli.js

@@ -1,17 +1,18 @@
-export { runCli } from './TSEHDOF7.js';
+export { runCli } from './GMN3ZEOV.js';
 import './CAPBDIIE.js';
 import './QH3FM6DD.js';
 import './S7YAUZ26.js';
 import './2MO4PR4P.js';
-import './INYD2E56.js';
+import './HN2JUVAX.js';
 import './2XGBQPKA.js';
+import './HC7LYTHL.js';
 import './4SFAVHVD.js';
 import './6L6NUQMM.js';
-import './RVVZQC34.js';
-import './HOFCGMNS.js';
+import './KN3TRHEZ.js';
+import './TMIYMQW3.js';
+import './GIFXFMSS.js';
 import './UBUQDI5Q.js';
 import './3XEUJAQB.js';
-import './HC7LYTHL.js';
 import './CWKWODSW.js';
 //# sourceMappingURL=cli.js.map
 //# sourceMappingURL=cli.js.map

package/dist/config.d.ts

@@ -1,6 +1,7 @@
 import * as z from 'zod';
 import type { ChainContext } from './context';
 import type { ToolCommandExecutionOptions } from './core/tool-executor';
+export declare const CARGO_TARGET_CACHE_PATH = "/cargo-target";
 export declare const volumeMappingSchema: z.ZodUnion<readonly [z.ZodObject<{
     containerPath: z.ZodString;
     type: z.ZodLiteral<"host">;
@@ -11,15 +12,25 @@ export declare const volumeMappingSchema: z.ZodUnion<readonly [z.ZodObject<{
     name: z.ZodString;
     shared: z.ZodOptional<z.ZodBoolean>;
     locked: z.ZodOptional<z.ZodBoolean>;
+    toolchainKeyed: z.ZodOptional<z.ZodBoolean>;
+    architectureIndependent: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>]>;
 export type VolumeMapping = z.infer<typeof volumeMappingSchema>;
 export interface EnvironmentVariable {
     name: string;
     value: string;
 }
+export declare const DOCKER_PLATFORM_VALUES: readonly ["linux/amd64", "linux/arm64"];
+export declare const DOCKER_PLATFORM_NATIVE = "native";
+export declare const DOCKER_PLATFORM_OVERRIDE_VALUES: readonly ["native", "linux/amd64", "linux/arm64"];
+export declare const DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION: string;
+export type DockerPlatformValue = (typeof DOCKER_PLATFORM_VALUES)[number];
+export type DockerPlatformOverride = (typeof DOCKER_PLATFORM_OVERRIDE_VALUES)[number];
+export declare const isDockerPlatformOverride: (input: unknown) => input is DockerPlatformOverride;
 export interface Tool {
     name: string;
     privileged?: boolean;
+    dockerPlatform?: DockerPlatformValue;
     defaultVolumes?: readonly VolumeMapping[];
     defaultEnv?: readonly EnvironmentVariable[];
     getSecondaryVersion?: (args: {
@@ -30,7 +41,7 @@ export interface Tool {
     }) => Promise<string>;
     preExecute?: (context: ChainContext<string>, options: ToolCommandExecutionOptions) => Promise<void>;
 }
-export declare enum DockerRegistryMirror {
+export declare const enum DockerRegistryMirror {
     PUBLIC_GAR = "public-gar"
 }
 export interface Image {

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiDxE,eAAO,MAAM,mBAAmB;;;;;;;;;;mBAAiE,CAAC;AAElG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAG1C,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAG5C,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAG7D,UAAU,CAAC,EAAE,CACT,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,2BAA2B,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,oBAAY,oBAAoB;IAC5B,UAAU,eAAe;CAC5B;AAED,MAAM,WAAW,KAAK;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB,uBAAyD,CAAC;AACxF,eAAO,MAAM,WAAW,uBAAmD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAqCxE,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAwBvD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;mBAAiE,CAAC;AAElG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAKD,eAAO,MAAM,sBAAsB,yCAA0C,CAAC;AAC9E,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAC/C,eAAO,MAAM,+BAA+B,mDAGlC,CAAC;AACX,eAAO,MAAM,2CAA2C,QACV,CAAC;AAI/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtF,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,sBACO,CAAC;AAE3E,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAGrC,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAG1C,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAG5C,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAG7D,UAAU,CAAC,EAAE,CACT,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,2BAA2B,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,0BAAkB,oBAAoB;IAClC,UAAU,eAAe;CAC5B;AAED,MAAM,WAAW,KAAK;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB,uBAAyD,CAAC;AACxF,eAAO,MAAM,WAAW,uBAAmD,CAAC"}

package/dist/config.js

@@ -1,4 +1,5 @@
-export { DockerRegistryMirror, getImageDirectory, getRegistry, volumeMappingSchema } from './HOFCGMNS.js';
+export { CARGO_TARGET_CACHE_PATH, DOCKER_PLATFORM_NATIVE, DOCKER_PLATFORM_OVERRIDE_VALUES, DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION, DOCKER_PLATFORM_VALUES, DockerRegistryMirror, getImageDirectory, getRegistry, isDockerPlatformOverride, volumeMappingSchema } from './TMIYMQW3.js';
+import './GIFXFMSS.js';
 import './CWKWODSW.js';
 //# sourceMappingURL=config.js.map
 //# sourceMappingURL=config.js.map

package/dist/core/index.js

@@ -1,13 +1,14 @@
 import '../2MO4PR4P.js';
-export { executeToolCommand } from '../INYD2E56.js';
+export { executeToolCommand, mergeToolEnv, resolveCargoCacheEnv } from '../HN2JUVAX.js';
 import '../2XGBQPKA.js';
+export { executeLocally } from '../HC7LYTHL.js';
 import '../4SFAVHVD.js';
 export { resolveTypeVersions } from '../6L6NUQMM.js';
-import '../RVVZQC34.js';
-import '../HOFCGMNS.js';
+import '../KN3TRHEZ.js';
+import '../TMIYMQW3.js';
+import '../GIFXFMSS.js';
 import '../UBUQDI5Q.js';
 import '../3XEUJAQB.js';
-export { executeLocally } from '../HC7LYTHL.js';
 import '../CWKWODSW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/core/local-executor.test.js

@@ -1,4 +1,4 @@
-import { describe, it, globalExpect } from '../5PWUQUE5.js';
+import { describe, it, globalExpect } from '../DVALPAAO.js';
 import { executeLocally } from '../HC7LYTHL.js';
 import { init_esm_shims, __name } from '../CWKWODSW.js';
 import process from 'process';

package/dist/core/lock.test.js

@@ -1,5 +1,5 @@
+import { it, globalExpect } from '../DVALPAAO.js';
 import { lock, buildLockFilePath } from '../4SFAVHVD.js';
-import { it, globalExpect } from '../5PWUQUE5.js';
 import { init_esm_shims } from '../CWKWODSW.js';
 import { mkdir, writeFile, stat } from 'fs/promises';
 import { dirname } from 'path';

package/dist/core/tool-executor.d.ts

@@ -1,6 +1,17 @@
 import { type ProcessOutput } from 'zx';
-import type { EnvironmentVariable, VolumeMapping } from '../config';
+import type { DockerPlatformOverride, EnvironmentVariable, VolumeMapping } from '../config';
 import type { ChainContext } from '../context';
+/**
+ * Merge env layers, highest precedence first. On a name collision the earlier layer wins — so the
+ * cache redirect (passed last) can never clobber a user --env or a tool default for the same var.
+ */
+export declare const mergeToolEnv: (...layers: readonly (readonly EnvironmentVariable[])[]) => EnvironmentVariable[];
+/**
+ * Redirect a cache-safe cargo `--script` to the shared `/cargo-target` mount via CARGO_TARGET_DIR.
+ * Skips scripts containing a build (CARGO_BUILD_RE): a build's .so/IDL must reach the host-mounted
+ * target/, not the cache. No-ops for tools that don't mount the cache.
+ */
+export declare const resolveCargoCacheEnv: (script: string | undefined, volumes: readonly VolumeMapping[]) => EnvironmentVariable[];
 export interface ToolCommandExecutionOptions {
     cwd: string;
     volumes: readonly VolumeMapping[];
@@ -12,9 +23,10 @@ export interface ToolCommandExecutionOptions {
     versions?: Record<string, string>;
     defaultVolumesEnabled?: boolean;
     local?: boolean;
+    dockerPlatform?: DockerPlatformOverride;
 }
 /**
  * Enhanced tool command execution using the new version compatibility matrix system
  */
-export declare function executeToolCommand<TImageId extends string>(context: ChainContext<TImageId>, toolName: string, args: string[], { cwd, volumes: userVolumes, customEntrypoint: entrypoint, env: customEnvVars, script, publish, versions, defaultVolumesEnabled, local, }: ToolCommandExecutionOptions): Promise<ProcessOutput>;
+export declare function executeToolCommand<TImageId extends string>(context: ChainContext<TImageId>, toolName: string, args: string[], { cwd, volumes: userVolumes, customEntrypoint: entrypoint, env: customEnvVars, script, publish, versions, defaultVolumesEnabled, local, dockerPlatform: dockerPlatformOverride, }: ToolCommandExecutionOptions): Promise<ProcessOutput>;
 //# sourceMappingURL=tool-executor.d.ts.map

package/dist/core/tool-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/core/tool-executor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAK,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkG/C,MAAM,WAAW,2BAA2B;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,mBAAmB,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,EAC5D,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,EACI,GAAG,EACH,OAAO,EAAE,WAAW,EACpB,gBAAgB,EAAE,UAAU,EAC5B,GAAG,EAAE,aAAa,EAClB,MAAM,EACN,OAAO,EACP,QAAa,EACb,qBAA4B,EAC5B,KAAK,GACR,EAAE,2BAA2B,GAC/B,OAAO,CAAC,aAAa,CAAC,CAiLxB"}
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/core/tool-executor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAK,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAE3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6C/C;;;GAGG;AACH,eAAO,MAAM,YAAY,GACrB,GAAG,QAAQ,SAAS,CAAC,SAAS,mBAAmB,EAAE,CAAC,EAAE,KACvD,mBAAmB,EAA+C,CAAC;AAYtE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC7B,QAAQ,MAAM,GAAG,SAAS,EAC1B,SAAS,SAAS,aAAa,EAAE,KAClC,mBAAmB,EAarB,CAAC;AAmIF,MAAM,WAAW,2BAA2B;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,mBAAmB,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,EAC5D,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,EACI,GAAG,EACH,OAAO,EAAE,WAAW,EACpB,gBAAgB,EAAE,UAAU,EAC5B,GAAG,EAAE,aAAa,EAClB,MAAM,EACN,OAAO,EACP,QAAa,EACb,qBAA4B,EAC5B,KAAK,EACL,cAAc,EAAE,sBAAsB,GACzC,EAAE,2BAA2B,GAC/B,OAAO,CAAC,aAAa,CAAC,CAuMxB"}

package/dist/core/tool-executor.js

@@ -1,12 +1,13 @@
-export { executeToolCommand } from '../INYD2E56.js';
+export { executeToolCommand, mergeToolEnv, resolveCargoCacheEnv } from '../HN2JUVAX.js';
 import '../2XGBQPKA.js';
+import '../HC7LYTHL.js';
 import '../4SFAVHVD.js';
 import '../6L6NUQMM.js';
-import '../RVVZQC34.js';
-import '../HOFCGMNS.js';
+import '../KN3TRHEZ.js';
+import '../TMIYMQW3.js';
+import '../GIFXFMSS.js';
 import '../UBUQDI5Q.js';
 import '../3XEUJAQB.js';
-import '../HC7LYTHL.js';
 import '../CWKWODSW.js';
 //# sourceMappingURL=tool-executor.js.map
 //# sourceMappingURL=tool-executor.js.map

package/dist/core/tool-executor.test.js

@@ -0,0 +1,180 @@
+import { describe, it, globalExpect } from '../DVALPAAO.js';
+import { resolveCargoCacheEnv, mergeToolEnv } from '../HN2JUVAX.js';
+import '../2XGBQPKA.js';
+import '../HC7LYTHL.js';
+import '../4SFAVHVD.js';
+import '../6L6NUQMM.js';
+import '../KN3TRHEZ.js';
+import { CARGO_TARGET_CACHE_PATH } from '../TMIYMQW3.js';
+import '../GIFXFMSS.js';
+import '../UBUQDI5Q.js';
+import '../3XEUJAQB.js';
+import { init_esm_shims } from '../CWKWODSW.js';
+
+// src/core/tool-executor.test.ts
+init_esm_shims();
+var cacheVolume = {
+  type: "isolate",
+  containerPath: CARGO_TARGET_CACHE_PATH,
+  name: "solana-target"
+};
+var withCache = [
+  cacheVolume
+];
+var cacheEnv = [
+  {
+    name: "CARGO_TARGET_DIR",
+    value: CARGO_TARGET_CACHE_PATH
+  }
+];
+describe(resolveCargoCacheEnv, () => {
+  describe("cache-safe scripts redirect at the shared cache", () => {
+    it.each([
+      "cargo test -p anchor-trait --lib --tests",
+      "cargo test --manifest-path macros/examples/vault/Cargo.toml --lib --tests",
+      "cargo test -p rbac --test trybuild -- --ignored",
+      "cargo test --package onesig -- tests --nocapture",
+      "cargo test-ellipse",
+      "cargo test-triangle",
+      "cargo check",
+      "cargo nextest run",
+      "cargo +nightly-2025-06-01 fmt -- --check && cargo clippy --all-targets",
+      // builtin t=test / c=check aliases.
+      "cargo t",
+      "cargo c",
+      "cargo +nightly-2025-06-01 t --lib"
+    ])("%s", (script) => {
+      globalExpect(resolveCargoCacheEnv(script, withCache)).toEqual(cacheEnv);
+    });
+  });
+  describe("artifact-producing builds are never redirected", () => {
+    it.each([
+      "anchor build --no-idl --ignore-keys",
+      "cargo build",
+      "cargo build-sbf",
+      // test-sbf/test-bpf build .so despite the `test-` prefix.
+      "cargo test-sbf",
+      "cargo test-bpf --features foo",
+      // Dashed binary forms (the real protocol `test` script is `cargo-test-sbf`) — the
+      // space-anchored cargo branch misses these, so they need their own alternative.
+      "cargo-test-sbf",
+      "cargo-build-sbf",
+      "cargo-build-bpf --features x"
+    ])("%s", (script) => {
+      globalExpect(resolveCargoCacheEnv(script, withCache)).toEqual([]);
+    });
+    it("skips when a build and a test share one script (build half must reach the host)", () => {
+      globalExpect(resolveCargoCacheEnv("cargo build && cargo test", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("anchor build && cargo test --lib", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("cargo b && cargo test", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("cargo b && cargo t", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("cargo test --lib && anchor idl build -o x.json", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("cargo test --lib && cargo-build-sbf", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("anchor test && cargo test --lib", withCache)).toEqual([]);
+      globalExpect(resolveCargoCacheEnv("cargo rustc -- --emit=obj && cargo test", withCache)).toEqual([]);
+    });
+    it.each([
+      "cargo build; cargo test",
+      "cargo build&&cargo test",
+      "cargo build-sbf;cargo test",
+      "cargo b;cargo test",
+      "cargo b&&cargo t"
+    ])("%s", (script) => {
+      globalExpect(resolveCargoCacheEnv(script, withCache)).toEqual([]);
+    });
+  });
+  describe("commands outside the cache-safe allowlist are not redirected", () => {
+    it.each([
+      "cargo +nightly-2025-06-01 fmt",
+      "cargo +nightly-2025-06-01 fmt -- --check"
+    ])("%s", (script) => {
+      globalExpect(resolveCargoCacheEnv(script, withCache)).toEqual([]);
+    });
+  });
+  it("does nothing when the tool mounts no /cargo-target cache volume", () => {
+    const otherVolumes = [
+      {
+        type: "isolate",
+        containerPath: "/usr/local/cargo",
+        name: "solana-cargo"
+      }
+    ];
+    globalExpect(resolveCargoCacheEnv("cargo test -p oft --lib --tests", otherVolumes)).toEqual([]);
+  });
+  it("returns nothing for an empty or absent script (non --script invocations)", () => {
+    globalExpect(resolveCargoCacheEnv(void 0, withCache)).toEqual([]);
+    globalExpect(resolveCargoCacheEnv("", withCache)).toEqual([]);
+  });
+  it("does not match cargo substrings inside other words", () => {
+    globalExpect(resolveCargoCacheEnv("mycargo testlike", withCache)).toEqual([]);
+  });
+  it("tolerates irregular whitespace around the command", () => {
+    globalExpect(resolveCargoCacheEnv("  cargo   test --lib", withCache)).toEqual(cacheEnv);
+    globalExpect(resolveCargoCacheEnv("cargo	test", withCache)).toEqual(cacheEnv);
+    globalExpect(resolveCargoCacheEnv("cargo   build  &&  cargo test", withCache)).toEqual([]);
+  });
+  it("finds the cache volume by containerPath, regardless of its name", () => {
+    const renamed = [
+      {
+        type: "isolate",
+        containerPath: CARGO_TARGET_CACHE_PATH,
+        name: "custom-target"
+      }
+    ];
+    globalExpect(resolveCargoCacheEnv("cargo test", renamed)).toEqual([
+      {
+        name: "CARGO_TARGET_DIR",
+        value: CARGO_TARGET_CACHE_PATH
+      }
+    ]);
+  });
+});
+describe(mergeToolEnv, () => {
+  const cacheEnv2 = [
+    {
+      name: "CARGO_TARGET_DIR",
+      value: CARGO_TARGET_CACHE_PATH
+    }
+  ];
+  it("keeps the higher-precedence (earlier) layer on a name collision", () => {
+    const userEnv = [
+      {
+        name: "CARGO_TARGET_DIR",
+        value: "/host/target"
+      }
+    ];
+    globalExpect(mergeToolEnv(userEnv, [], [], cacheEnv2)).toEqual(userEnv);
+  });
+  it("applies the cache redirect only when nothing upstream sets the var", () => {
+    globalExpect(mergeToolEnv([], [], [], cacheEnv2)).toEqual(cacheEnv2);
+  });
+  it("preserves order and de-dupes across layers", () => {
+    globalExpect(mergeToolEnv([
+      {
+        name: "A",
+        value: "1"
+      }
+    ], [
+      {
+        name: "B",
+        value: "2"
+      }
+    ], [
+      {
+        name: "A",
+        value: "shadowed"
+      }
+    ])).toEqual([
+      {
+        name: "A",
+        value: "1"
+      },
+      {
+        name: "B",
+        value: "2"
+      }
+    ]);
+  });
+});
+//# sourceMappingURL=tool-executor.test.js.map
+//# sourceMappingURL=tool-executor.test.js.map

package/dist/core/tool-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/tool-executor.test.ts"],"names":["cacheVolume","type","containerPath","CARGO_TARGET_CACHE_PATH","name","withCache","cacheEnv","value","describe","resolveCargoCacheEnv","it","each","script","expect","toEqual","otherVolumes","undefined","renamed","mergeToolEnv","userEnv"],"mappings":"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","file":"tool-executor.test.js","sourcesContent":["import { describe, expect, it } from 'vitest';\n\nimport type { EnvironmentVariable, VolumeMapping } from '../config';\nimport { CARGO_TARGET_CACHE_PATH } from '../config';\nimport { mergeToolEnv, resolveCargoCacheEnv } from './tool-executor';\n\nconst cacheVolume: VolumeMapping = {\n    type: 'isolate',\n    containerPath: CARGO_TARGET_CACHE_PATH,\n    name: 'solana-target',\n};\n\nconst withCache: readonly VolumeMapping[] = [cacheVolume];\nconst cacheEnv = [{ name: 'CARGO_TARGET_DIR', value: CARGO_TARGET_CACHE_PATH }];\n\ndescribe(resolveCargoCacheEnv, () => {\n    describe('cache-safe scripts redirect at the shared cache', () => {\n        it.each([\n            'cargo test -p anchor-trait --lib --tests',\n            'cargo test --manifest-path macros/examples/vault/Cargo.toml --lib --tests',\n            'cargo test -p rbac --test trybuild -- --ignored',\n            'cargo test --package onesig -- tests --nocapture',\n            'cargo test-ellipse',\n            'cargo test-triangle',\n            'cargo check',\n            'cargo nextest run',\n            'cargo +nightly-2025-06-01 fmt -- --check && cargo clippy --all-targets',\n            // builtin t=test / c=check aliases.\n            'cargo t',\n            'cargo c',\n            'cargo +nightly-2025-06-01 t --lib',\n        ])('%s', (script) => {\n            expect(resolveCargoCacheEnv(script, withCache)).toEqual(cacheEnv);\n        });\n    });\n\n    describe('artifact-producing builds are never redirected', () => {\n        it.each([\n            'anchor build --no-idl --ignore-keys',\n            'cargo build',\n            'cargo build-sbf',\n            // test-sbf/test-bpf build .so despite the `test-` prefix.\n            'cargo test-sbf',\n            'cargo test-bpf --features foo',\n            // Dashed binary forms (the real protocol `test` script is `cargo-test-sbf`) — the\n            // space-anchored cargo branch misses these, so they need their own alternative.\n            'cargo-test-sbf',\n            'cargo-build-sbf',\n            'cargo-build-bpf --features x',\n        ])('%s', (script) => {\n            expect(resolveCargoCacheEnv(script, withCache)).toEqual([]);\n        });\n\n        it('skips when a build and a test share one script (build half must reach the host)', () => {\n            expect(resolveCargoCacheEnv('cargo build && cargo test', withCache)).toEqual([]);\n            expect(resolveCargoCacheEnv('anchor build && cargo test --lib', withCache)).toEqual([]);\n            // builtin b=build alias must still defeat the redirect when paired with a test.\n            expect(resolveCargoCacheEnv('cargo b && cargo test', withCache)).toEqual([]);\n            expect(resolveCargoCacheEnv('cargo b && cargo t', withCache)).toEqual([]);\n            // `anchor idl build` emits host IDL JSON — must defeat the redirect like any build.\n            expect(\n                resolveCargoCacheEnv('cargo test --lib && anchor idl build -o x.json', withCache),\n            ).toEqual([]);\n            // Dashed sbf binary glued to a cache-safe verb must still defeat the redirect.\n            expect(resolveCargoCacheEnv('cargo test --lib && cargo-build-sbf', withCache)).toEqual(\n                [],\n            );\n            // `anchor test` builds the program + IDL before running, and `cargo rustc` compiles —\n            // both must defeat the redirect when paired with a cache-safe verb.\n            expect(resolveCargoCacheEnv('anchor test && cargo test --lib', withCache)).toEqual([]);\n            expect(\n                resolveCargoCacheEnv('cargo rustc -- --emit=obj && cargo test', withCache),\n            ).toEqual([]);\n        });\n\n        // The build must be detected even when glued straight to a shell separator with no space\n        // (`;`, `&&`) — otherwise the build half silently redirects its .so/IDL into the cache.\n        it.each([\n            'cargo build; cargo test',\n            'cargo build&&cargo test',\n            'cargo build-sbf;cargo test',\n            'cargo b;cargo test',\n            'cargo b&&cargo t',\n        ])('%s', (script) => {\n            expect(resolveCargoCacheEnv(script, withCache)).toEqual([]);\n        });\n    });\n\n    describe('commands outside the cache-safe allowlist are not redirected', () => {\n        it.each(['cargo +nightly-2025-06-01 fmt', 'cargo +nightly-2025-06-01 fmt -- --check'])(\n            '%s',\n            (script) => {\n                expect(resolveCargoCacheEnv(script, withCache)).toEqual([]);\n            },\n        );\n    });\n\n    it('does nothing when the tool mounts no /cargo-target cache volume', () => {\n        const otherVolumes: readonly VolumeMapping[] = [\n            { type: 'isolate', containerPath: '/usr/local/cargo', name: 'solana-cargo' },\n        ];\n        expect(resolveCargoCacheEnv('cargo test -p oft --lib --tests', otherVolumes)).toEqual([]);\n    });\n\n    it('returns nothing for an empty or absent script (non --script invocations)', () => {\n        expect(resolveCargoCacheEnv(undefined, withCache)).toEqual([]);\n        expect(resolveCargoCacheEnv('', withCache)).toEqual([]);\n    });\n\n    it('does not match cargo substrings inside other words', () => {\n        expect(resolveCargoCacheEnv('mycargo testlike', withCache)).toEqual([]);\n    });\n\n    it('tolerates irregular whitespace around the command', () => {\n        // \\s+ / \\b mean extra spaces, tabs, and leading whitespace do not defeat matching.\n        expect(resolveCargoCacheEnv('  cargo   test --lib', withCache)).toEqual(cacheEnv);\n        expect(resolveCargoCacheEnv('cargo\\ttest', withCache)).toEqual(cacheEnv);\n        // ...and the build exclusion is equally whitespace-insensitive.\n        expect(resolveCargoCacheEnv('cargo   build  &&  cargo test', withCache)).toEqual([]);\n    });\n\n    it('finds the cache volume by containerPath, regardless of its name', () => {\n        // Lookup is keyed on the mount path, not the 'solana-target' name — any isolate volume\n        // mounted at the cache path triggers the redirect.\n        const renamed: readonly VolumeMapping[] = [\n            { type: 'isolate', containerPath: CARGO_TARGET_CACHE_PATH, name: 'custom-target' },\n        ];\n        expect(resolveCargoCacheEnv('cargo test', renamed)).toEqual([\n            { name: 'CARGO_TARGET_DIR', value: CARGO_TARGET_CACHE_PATH },\n        ]);\n    });\n});\n\ndescribe(mergeToolEnv, () => {\n    const cacheEnv: EnvironmentVariable[] = [\n        { name: 'CARGO_TARGET_DIR', value: CARGO_TARGET_CACHE_PATH },\n    ];\n\n    it('keeps the higher-precedence (earlier) layer on a name collision', () => {\n        const userEnv: EnvironmentVariable[] = [\n            { name: 'CARGO_TARGET_DIR', value: '/host/target' },\n        ];\n        // cacheEnv is passed last (lowest precedence); a user override must survive.\n        expect(mergeToolEnv(userEnv, [], [], cacheEnv)).toEqual(userEnv);\n    });\n\n    it('applies the cache redirect only when nothing upstream sets the var', () => {\n        expect(mergeToolEnv([], [], [], cacheEnv)).toEqual(cacheEnv);\n    });\n\n    it('preserves order and de-dupes across layers', () => {\n        expect(\n            mergeToolEnv(\n                [{ name: 'A', value: '1' }],\n                [{ name: 'B', value: '2' }],\n                [{ name: 'A', value: 'shadowed' }],\n            ),\n        ).toEqual([\n            { name: 'A', value: '1' },\n            { name: 'B', value: '2' },\n        ]);\n    });\n});\n"]}

package/dist/environment.d.ts

@@ -0,0 +1,4 @@
+export declare const local: boolean;
+export declare const registry: string | undefined;
+export declare const imageDirectory: string | undefined;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,KAAK,EAAE,OAA4C,CAAC;AACjE,eAAO,MAAM,QAAQ,EAAE,MAAM,GAAG,SAAmC,CAAC;AACpE,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG,SAA0C,CAAC"}

package/dist/environment.js

@@ -0,0 +1,4 @@
+export { imageDirectory, local, registry } from './GIFXFMSS.js';
+import './CWKWODSW.js';
+//# sourceMappingURL=environment.js.map
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"environment.js"}

package/dist/github/index.js

@@ -1,7 +1,8 @@
-export { runGithubMatrixGenerator } from '../SQYDOF2V.js';
-import '../3IQB2ZZF.js';
-import '../RVVZQC34.js';
-import '../HOFCGMNS.js';
+export { runGithubMatrixGenerator } from '../GFKRACRT.js';
+import '../E35WFC4E.js';
+import '../KN3TRHEZ.js';
+import '../TMIYMQW3.js';
+import '../GIFXFMSS.js';
 import '../3XEUJAQB.js';
 import '../CWKWODSW.js';
 //# sourceMappingURL=index.js.map

package/dist/github/matrix.js

@@ -1,6 +1,7 @@
-export { generateGithubMatrix } from '../3IQB2ZZF.js';
-import '../RVVZQC34.js';
-import '../HOFCGMNS.js';
+export { generateGithubMatrix } from '../E35WFC4E.js';
+import '../KN3TRHEZ.js';
+import '../TMIYMQW3.js';
+import '../GIFXFMSS.js';
 import '../3XEUJAQB.js';
 import '../CWKWODSW.js';
 //# sourceMappingURL=matrix.js.map

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './cli';
-export type { EnvironmentVariable, Image, Tool, VersionCombination, VolumeMapping } from './config';
-export { DockerRegistryMirror } from './config';
+export type { DockerPlatformOverride, DockerPlatformValue, EnvironmentVariable, Image, Tool, VersionCombination, VolumeMapping, } from './config';
+export { CARGO_TARGET_CACHE_PATH, DOCKER_PLATFORM_NATIVE, DOCKER_PLATFORM_OVERRIDE_VALUES, DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION, DOCKER_PLATFORM_VALUES, DockerRegistryMirror, isDockerPlatformOverride, } from './config';
 export type * from './context';
 export * from './core';
 export type * from './core/tool-executor';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,mBAAmB,WAAW,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,YAAY,EACR,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,EACL,IAAI,EACJ,kBAAkB,EAClB,aAAa,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,2CAA2C,EAC3C,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GAC3B,MAAM,UAAU,CAAC;AAClB,mBAAmB,WAAW,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,20 +1,21 @@
-export { runGithubMatrixGenerator } from './SQYDOF2V.js';
-import './3IQB2ZZF.js';
-export { runCli } from './TSEHDOF7.js';
+export { runGithubMatrixGenerator } from './GFKRACRT.js';
+import './E35WFC4E.js';
+export { runCli } from './GMN3ZEOV.js';
 import './CAPBDIIE.js';
 import './QH3FM6DD.js';
 import './S7YAUZ26.js';
-export { testTools } from './TMKE5ARZ.js';
+export { testTools } from './EY2G7NK4.js';
 import './2MO4PR4P.js';
-export { executeToolCommand } from './INYD2E56.js';
+export { executeToolCommand, mergeToolEnv, resolveCargoCacheEnv } from './HN2JUVAX.js';
 import './2XGBQPKA.js';
+export { executeLocally } from './HC7LYTHL.js';
 import './4SFAVHVD.js';
 export { resolveTypeVersions } from './6L6NUQMM.js';
-import './RVVZQC34.js';
-export { DockerRegistryMirror } from './HOFCGMNS.js';
+import './KN3TRHEZ.js';
+export { CARGO_TARGET_CACHE_PATH, DOCKER_PLATFORM_NATIVE, DOCKER_PLATFORM_OVERRIDE_VALUES, DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION, DOCKER_PLATFORM_VALUES, DockerRegistryMirror, isDockerPlatformOverride } from './TMIYMQW3.js';
+import './GIFXFMSS.js';
 export { findFileInParentDirectory } from './UBUQDI5Q.js';
 import './3XEUJAQB.js';
-export { executeLocally } from './HC7LYTHL.js';
 import { init_esm_shims } from './CWKWODSW.js';
 
 // src/index.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,cAAA,EAAA","file":"index.js","sourcesContent":["export * from './cli';\nexport type { EnvironmentVariable, Image, Tool, VersionCombination, VolumeMapping } from './config';\nexport { DockerRegistryMirror } from './config';\nexport type * from './context';\nexport * from './core';\nexport type * from './core/tool-executor';\nexport * from './github';\nexport * from './test';\nexport { findFileInParentDirectory } from './utils';\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,cAAA,EAAA","file":"index.js","sourcesContent":["export * from './cli';\nexport type {\n    DockerPlatformOverride,\n    DockerPlatformValue,\n    EnvironmentVariable,\n    Image,\n    Tool,\n    VersionCombination,\n    VolumeMapping,\n} from './config';\nexport {\n    CARGO_TARGET_CACHE_PATH,\n    DOCKER_PLATFORM_NATIVE,\n    DOCKER_PLATFORM_OVERRIDE_VALUES,\n    DOCKER_PLATFORM_OVERRIDE_VALUES_DESCRIPTION,\n    DOCKER_PLATFORM_VALUES,\n    DockerRegistryMirror,\n    isDockerPlatformOverride,\n} from './config';\nexport type * from './context';\nexport * from './core';\nexport type * from './core/tool-executor';\nexport * from './github';\nexport * from './test';\nexport { findFileInParentDirectory } from './utils';\n"]}