@e2edev/e2e 0.4.0 → 0.5.1

package/dist/config/app.js

@@ -1,98 +1,74 @@
-/** App, command, and service resolution (spec 05-config.md). */
+/**
+ * Per-target app resolution (spec 05-config.md): what an engine declares
+ * about the app it drives, validated where an error can name the target.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
 import { ConfigurationError } from '../internal/errors.js';
+import { obj } from '../internal/objects.js';
 import { isImplicitTestHost, normalizeBaseUrl } from '../internal/urls.js';
 import { httpUrl, positiveInt } from './validate.js';
-const APP_KEYS = new Set([
-    'url',
-    'command',
-    'readyUrl',
-    'services',
-    'allowedOrigins',
-    'environment',
-    'identity',
-]);
-/** App keys that make sense without an app URL; every other key needs one. */
-const URL_FREE_APP_KEYS = new Set(['url', 'command', 'services']);
-export function resolveApp(raw, env) {
-    if (raw.app !== undefined) {
-        for (const key of Object.keys(raw.app)) {
-            if (!APP_KEYS.has(key)) {
-                throw new ConfigurationError('INVALID_CONFIG', `unknown app config key "${key}"`);
-            }
-        }
-    }
-    const services = resolveServices(raw.app?.services);
-    const rawUrl = raw.app?.url ?? env['APP_URL'];
-    if (rawUrl === undefined || rawUrl === '') {
-        // Not every surface has an app URL to point at (a device, a desktop
-        // shell): a synthetic loopback base keeps navigation resolution and
-        // identity digests defined, and `app.open()` fails loud with
-        // APP_URL_REQUIRED the moment a test actually needs one. A configured
-        // app command without a URL is still a mistake worth failing early on.
-        const orphaned = Object.keys(raw.app ?? {}).filter((key) => !URL_FREE_APP_KEYS.has(key));
-        if (orphaned.length > 0) {
-            throw new ConfigurationError('INVALID_CONFIG', `app.${orphaned[0]} requires app.url: set app.url in e2e.config.ts or the APP_URL environment variable`);
-        }
-        if (raw.app?.command === undefined) {
-            return {
-                configured: false,
-                base: normalizeBaseUrl('http://127.0.0.1:1'),
-                readyUrl: 'http://127.0.0.1:1/',
-                allowedOrigins: [],
-                environment: 'test',
-                command: undefined,
-                services,
-                identity: undefined,
-            };
-        }
-        throw new ConfigurationError('APP_URL_REQUIRED', 'an app URL is required alongside app.command: set app.url in e2e.config.ts or the APP_URL environment variable');
+const ENVIRONMENTS = new Set(['test', 'staging', 'production']);
+/**
+ * Resolves one target's app from its engine's `app` declaration. Every fact
+ * is optional: a URL normalizes like any base URL, origins must be serialized
+ * origins, a command needs something to poll, services need one readiness
+ * contract each, and the identity defaults to where the app is served when
+ * the engine gives none. `projectRoot` anchors every command's `log` path.
+ */
+export function resolveTargetApp(targetName, engine, projectRoot) {
+    const declared = engine?.app ?? {};
+    const where = `target "${targetName}" engine ${engine?.name ?? 'none'}`;
+    const base = declared.url === undefined ? undefined : normalizeBaseUrl(declared.url);
+    const environment = declared.environment ??
+        (base !== undefined && !isImplicitTestHost(new URL(base.href).hostname) ? 'production' : 'test');
+    if (!ENVIRONMENTS.has(environment)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${where} declares invalid app.environment "${String(environment)}"`);
     }
-    const base = normalizeBaseUrl(rawUrl);
-    const baseHost = new URL(base.href).hostname;
-    // The environment is a label for the report and the cache/session identity
-    // digest, not a gate: a loopback, `.localhost`, or `.test` host is `test`,
-    // any other host is `production` unless the config says otherwise.
-    const environment = raw.app?.environment ?? (isImplicitTestHost(baseHost) ? 'test' : 'production');
-    if (!['test', 'staging', 'production'].includes(environment)) {
-        throw new ConfigurationError('INVALID_CONFIG', `invalid app.environment "${environment}"`);
+    const allowedOrigins = declared.allowedOrigins ?? (base === undefined ? [] : [base.origin]);
+    if (!Array.isArray(allowedOrigins)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${where} app.allowedOrigins must be an array`);
     }
-    const allowedOrigins = raw.app?.allowedOrigins ?? [base.origin];
     for (const origin of allowedOrigins) {
         let parsed;
         try {
             parsed = new URL(origin);
         }
         catch {
-            throw new ConfigurationError('INVALID_CONFIG', `invalid allowed origin: ${origin}`);
+            throw new ConfigurationError('INVALID_CONFIG', `${where} declares an invalid allowed origin: ${origin}`);
         }
         if (parsed.origin !== origin) {
-            throw new ConfigurationError('INVALID_CONFIG', `allowed origin must be a serialized origin, got ${origin} (expected ${parsed.origin})`);
+            throw new ConfigurationError('INVALID_CONFIG', `${where} allowed origin must be a serialized origin, got ${origin} (expected ${parsed.origin})`);
         }
     }
-    const command = raw.app?.command;
-    if (command !== undefined)
-        validateCommand(command, 'app.command');
-    const identity = raw.app?.identity;
+    const identity = declared.identity;
     if (identity !== undefined && (typeof identity !== 'string' || identity.trim() === '')) {
-        throw new ConfigurationError('INVALID_CONFIG', 'app.identity must be a non-empty string');
+        throw new ConfigurationError('INVALID_CONFIG', `${where} app.identity must be a non-empty string`);
+    }
+    const command = declared.command;
+    if (command !== undefined)
+        validateCommand(command, `${where} app.command`, projectRoot);
+    const readyUrl = httpUrl(declared.readyUrl, `${where} app.readyUrl`) ?? base?.href;
+    if (command !== undefined && readyUrl === undefined) {
+        throw new ConfigurationError('APP_URL_REQUIRED', `${where} declares app.command without a URL to poll: declare url or readyUrl beside it`);
     }
     return {
-        configured: true,
         base,
-        readyUrl: httpUrl(raw.app?.readyUrl, 'app.readyUrl') ?? base.href,
         allowedOrigins,
         environment,
+        identity: identity ?? (base === undefined ? undefined : `${base.origin}${base.basePath}`),
         command,
-        services,
-        identity,
+        readyUrl: command === undefined ? undefined : readyUrl,
+        services: resolveServices(declared.services, projectRoot, `${where} app.services`),
     };
 }
 /**
- * The shape every spawned command shares: a non-empty executable and, when
- * set, positive integer timeouts. A NaN or infinite budget would otherwise
- * make the readiness loop spin without a deadline.
+ * The shape every spawned command shares: a non-empty executable, when set
+ * positive integer timeouts, and when set a `log` path inside the project
+ * root. A NaN or infinite budget would otherwise make the readiness loop spin
+ * without a deadline; a log outside the root would let config write anywhere.
  */
-function validateCommand(command, label) {
+function validateCommand(command, label, projectRoot) {
     if (typeof command !== 'object' || command === null) {
         throw new ConfigurationError('INVALID_CONFIG', `${label} must be an object`);
     }
@@ -101,42 +77,119 @@ function validateCommand(command, label) {
     }
     positiveInt(command.startupTimeout, `${label}.startupTimeout`);
     positiveInt(command.shutdownTimeout, `${label}.shutdownTimeout`);
+    if (command.log !== undefined) {
+        if (typeof command.log !== 'string' || command.log.trim() === '') {
+            throw new ConfigurationError('INVALID_CONFIG', `${label}.log must be a non-empty path`);
+        }
+        if (!insideProjectRoot(projectRoot, path.resolve(projectRoot, command.log))) {
+            throw new ConfigurationError('INVALID_CONFIG', `${label}.log must be a file inside the project root, got ${JSON.stringify(command.log)}`);
+        }
+    }
+    if (command.reuseExisting !== undefined && typeof command.reuseExisting !== 'boolean') {
+        throw new ConfigurationError('INVALID_CONFIG', `${label}.reuseExisting must be a boolean`);
+    }
+}
+/** Only a command with a URL to probe can find something already answering there. */
+function rejectReuse(command, label, reason) {
+    if (command.reuseExisting !== undefined) {
+        throw new ConfigurationError('INVALID_CONFIG', `${label}.reuseExisting needs readyUrl: ${reason}`);
+    }
+}
+/**
+ * `target` with the symlinks of its deepest existing ancestor resolved and the
+ * missing tail appended as written. A log file usually does not exist yet,
+ * but the directory a symlink points at does, so this is what the runner
+ * would actually open.
+ */
+function realpathOfExisting(target) {
+    const tail = [];
+    let current = target;
+    for (;;) {
+        try {
+            return path.join(fs.realpathSync(current), ...tail);
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current)
+                return target;
+            tail.unshift(path.basename(current));
+            current = parent;
+        }
+    }
 }
-/** Services carry no name, so messages name one by its position and command line. */
-function commandLine(command) {
-    return [command.executable, ...(command.args ?? [])].join(' ');
+/**
+ * Whether `target` is a path strictly below the project root once both are
+ * resolved through the filesystem: an in-project symlink pointing outside is
+ * rejected, a symlinked project root still counts as the root, and a name
+ * that merely starts with `..` (`..logs/out.log`) is an ordinary entry.
+ */
+function insideProjectRoot(projectRoot, target) {
+    const relative = path.relative(realpathOfExisting(projectRoot), realpathOfExisting(target));
+    return (relative !== '' &&
+        relative !== '..' &&
+        !relative.startsWith(`..${path.sep}`) &&
+        !path.isAbsolute(relative));
+}
+/** The longest `name` a service may carry; a label, not a description. */
+const SERVICE_NAME_MAX_LENGTH = 64;
+/**
+ * The name a service goes by in errors, reporter output, and the report: the
+ * explicit `name`, trimmed, or the executable's base name (`docker`, `pnpm`,
+ * and for a shell wrapper just `sh`, which is when an explicit name earns its
+ * keep). Explicit names must be unique so two failures never read alike.
+ */
+function serviceName(service, position, taken) {
+    if (service.name === undefined)
+        return path.basename(service.executable);
+    const name = typeof service.name === 'string' ? service.name.trim() : '';
+    if (name.length === 0 || name.length > SERVICE_NAME_MAX_LENGTH) {
+        throw new ConfigurationError('INVALID_CONFIG', `${position}.name must be a non-empty string of at most ${SERVICE_NAME_MAX_LENGTH} characters`);
+    }
+    if (taken.has(name)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${position}.name "${name}" is already used by another service; service names must be unique`);
+    }
+    taken.add(name);
+    return name;
 }
 /**
- * Resolves `app.services`: every service is a command with exactly one
- * readiness contract (`readyUrl` or `waitForExit`), and a `teardown` is a
+ * Resolves a declaration's `services`: every service is a command with exactly
+ * one readiness contract (`readyUrl` or `waitForExit`), and a `teardown` is a
  * command of its own. The service fields that only steer the runner
- * (`readyUrl`, `waitForExit`, `teardown`) are lifted out of the command.
+ * (`name`, `readyUrl`, `waitForExit`, `teardown`) are lifted out of the
+ * command; `reuseExisting` stays on it, and only a `readyUrl` service may set it.
+ * `projectRoot` anchors each `log` path; `prefix` names the declaring target
+ * in errors, so a failing service is traceable to the engine that declared it.
  */
-export function resolveServices(raw) {
+export function resolveServices(raw, projectRoot, prefix = 'app.services') {
     if (raw === undefined)
         return [];
     if (!Array.isArray(raw)) {
-        throw new ConfigurationError('INVALID_CONFIG', 'app.services must be an array');
+        throw new ConfigurationError('INVALID_CONFIG', `${prefix} must be an array`);
     }
+    const names = new Set();
     return raw.map((service, index) => {
-        const position = `app.services[${index}]`;
-        validateCommand(service, position);
-        const { readyUrl: rawReadyUrl, waitForExit, teardown, ...command } = service;
+        const position = `${prefix}[${index}]`;
+        validateCommand(service, position, projectRoot);
+        const { name: _name, readyUrl: rawReadyUrl, waitForExit, teardown, ...command } = service;
         const readyUrl = httpUrl(rawReadyUrl, `${position}.readyUrl`);
         if ((readyUrl !== undefined) === (waitForExit === true)) {
             throw new ConfigurationError('INVALID_CONFIG', `${position} needs exactly one readiness contract: set readyUrl or waitForExit: true`);
         }
         const readiness = readyUrl === undefined ? { waitForExit: true } : { readyUrl };
-        const label = `${position} (${commandLine(command)})`;
-        if (teardown !== undefined)
-            validateCommand(teardown, `${position}.teardown`);
+        if (readyUrl === undefined)
+            rejectReuse(command, position, 'a waitForExit service has nothing to reuse');
+        const name = serviceName(service, position, names);
+        const label = `service "${name}"`;
+        if (teardown !== undefined) {
+            validateCommand(teardown, `${position}.teardown`, projectRoot);
+            rejectReuse(teardown, `${position}.teardown`, 'a teardown command has nothing to reuse');
+        }
         return {
             label,
+            name: service.name === undefined ? undefined : name,
             command,
             readiness,
-            teardown: teardown === undefined
-                ? undefined
-                : { label: `${label} teardown (${commandLine(teardown)})`, command: teardown },
+            teardown: teardown === undefined ? undefined : { label: `${label} teardown`, command: teardown },
         };
     });
 }
@@ -147,22 +200,24 @@ function digestCommand(command) {
     return { ...rest, env: Object.fromEntries(Object.keys(env).map((key) => [key, { envName: key }])) };
 }
 /**
- * The digest view of `app`: `app.command.env`, every service's env, and every
- * service teardown's env become names, so no environment value contributes to
- * the digest. Live values never appear under `app`, so nothing else changes.
+ * The declarative part of an engine's `app` manifest as it enters the config
+ * digest: hooks stripped, and every `command.env`, service env, and service
+ * teardown env value replaced by `{ envName: key }`, so no environment value
+ * contributes to the digest.
  */
-export function digestApp(app) {
-    return {
-        ...app,
-        ...(app.command === undefined ? {} : { command: digestCommand(app.command) }),
-        ...(app.services === undefined
-            ? {}
-            : {
-                services: app.services.map(({ teardown, ...service }) => ({
-                    ...digestCommand(service),
-                    ...(teardown === undefined ? {} : { teardown: digestCommand(teardown) }),
-                })),
-            }),
-    };
+export function digestAppDeclaration(app) {
+    const { url, allowedOrigins, environment, identity, command, readyUrl, services } = app;
+    return obj({
+        url,
+        allowedOrigins,
+        environment,
+        identity,
+        readyUrl,
+        command: command === undefined ? undefined : digestCommand(command),
+        services: services?.map(({ teardown, ...service }) => obj({
+            ...digestCommand(service),
+            teardown: teardown === undefined ? undefined : digestCommand(teardown),
+        })),
+    });
 }
 //# sourceMappingURL=app.js.map

package/dist/config/app.js.map

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

package/dist/config/resolve.d.ts

@@ -1,6 +1,6 @@
 /** Config validation, defaults, and resolution (spec 05-config.md). */
 import type { ArtifactStore, CacheMode, E2EConfig, Platform, SecretProvider, TraceCacheStore } from '../types.ts';
-import { type BackendHandle } from '../backend/index.ts';
+import { type EngineHandle } from '../engine/index.ts';
 import { type ResolvedAgentConfig, type ResolvedLimits } from './agent.ts';
 import { type ResolvedApp } from './app.ts';
 export type { ResolvedAgentConfig, ResolvedLimits } from './agent.ts';
@@ -9,8 +9,10 @@ export interface ResolvedTarget {
     readonly name: string;
     readonly index: number;
     readonly platform: Platform;
-    /** Validated backend; undefined for an agent-tools-only target. */
-    readonly backend: BackendHandle | undefined;
+    /** Validated engine; undefined for an agent-tools-only target. */
+    readonly engine: EngineHandle | undefined;
+    /** The app under test, resolved from the engine's declaration. */
+    readonly app: ResolvedApp;
 }
 export interface ResolvedCredential {
     readonly name: string;
@@ -25,7 +27,6 @@ export interface ResolvedConfig {
     readonly projectRoot: string;
     readonly configPath: string | undefined;
     readonly ci: boolean;
-    readonly app: ResolvedApp;
     readonly targets: readonly ResolvedTarget[];
     readonly tests: readonly string[];
     readonly timeout: number;
@@ -36,7 +37,7 @@ export interface ResolvedConfig {
     readonly retries: number;
     readonly workers: number;
     readonly artifacts: readonly ('trace' | 'screenshot')[];
-    /** True when artifact kinds were set in config, so a backend that cannot produce one is an error. */
+    /** True when artifact kinds were set in config, so an engine that cannot produce one is an error. */
     readonly artifactsExplicit: boolean;
     /** Host store every produced artifact is handed to; undefined keeps files local only. */
     readonly artifactStore: ArtifactStore | undefined;

package/dist/config/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"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"}

package/dist/config/resolve.js

@@ -6,15 +6,14 @@ import { ConfigurationError } from '../internal/errors.js';
 import { canonicalDigest, sha256Hex } from '../internal/ids.js';
 import { isStepExecutor } from '../agent/executor.js';
 import { boundedInt, positiveInt } from './validate.js';
-import { isBackendHandle } from '../backend/index.js';
+import { isEngineHandle } from '../engine/index.js';
 import { isModelInstance, resolveAgentConfig, resolveLimits, } from './agent.js';
-import { digestApp, resolveApp } from './app.js';
+import { digestAppDeclaration, resolveTargetApp } from './app.js';
 const TARGET_NAME_PATTERN = /^[A-Za-z0-9_.-]+$/;
-const TARGET_KEYS = new Set(['name', 'platform', 'backend']);
+const TARGET_KEYS = new Set(['name', 'platform', 'engine']);
 const TOP_LEVEL_KEYS = new Set([
     'specVersion',
     'projectId',
-    'app',
     'targets',
     'tests',
     'timeout',
@@ -58,8 +57,7 @@ export function resolveConfig(raw, options) {
     if (raw.specVersion !== undefined && raw.specVersion !== '0.1') {
         throw new ConfigurationError('INVALID_CONFIG', `unsupported specVersion ${JSON.stringify(raw.specVersion)}; this runner implements 0.1`);
     }
-    const targets = resolveTargets(raw);
-    const app = resolveApp(raw, env);
+    const targets = resolveTargets(raw, options.projectRoot);
     const tests = normalizeTests(raw.tests);
     const timeout = positiveInt(raw.timeout, 'timeout') ?? 120_000;
     const launchTimeout = positiveInt(raw.launchTimeout, 'launchTimeout') ?? 60_000;
@@ -102,7 +100,6 @@ export function resolveConfig(raw, options) {
         projectRoot: options.projectRoot,
         configPath: options.configPath,
         ci,
-        app,
         targets,
         tests,
         timeout,
@@ -129,19 +126,23 @@ export function resolveConfig(raw, options) {
  * Resolves the `cache` key. The cache is opt-out: an unset key means
  * `read-write`, so a project earns replay speed without asking for it, and
  * `cache: 'off'` or `--no-cache` (which wins over the config) turns it off.
- * CI forces the default file store from `read-write` down to `read-only`:
- * committed caches are untrusted input, and a CI run never publishes what it
- * learned (spec 10-determinism.md). A host-supplied `cache.store` is exempt —
- * it is not a committed file cache, and the host states its own trust through
- * the store's `writable` flag.
+ * CI demotes the *defaulted* mode from `read-write` to `read-only`: a
+ * committed cache is untrusted input, and a CI run never publishes what it
+ * learned unless the project says so (spec 10-determinism.md). An explicit
+ * `read-write` in the config is that statement of trust and is honored as
+ * written, as is a host-supplied `cache.store`, which states its own trust
+ * through the store's `writable` flag.
  */
 function resolveCacheConfig(raw, ci, projectRoot, cliMode) {
     const value = raw.cache;
     let mode = 'read-write';
+    /** Whether the config named a mode; only a defaulted mode is demoted in CI. */
+    let explicit = false;
     let store;
     let dir;
     if (typeof value === 'string') {
         mode = value;
+        explicit = true;
     }
     else if (value !== undefined) {
         if (typeof value !== 'object' || value === null || Array.isArray(value)) {
@@ -153,6 +154,7 @@ function resolveCacheConfig(raw, ci, projectRoot, cliMode) {
             }
         }
         mode = value.mode ?? 'read-write';
+        explicit = value.mode !== undefined;
         store = value.store;
         if (store !== undefined && !isTraceCacheStore(store)) {
             throw new ConfigurationError('INVALID_CONFIG', 'cache.store must implement TraceCacheStore: { writable, read(keyHash), write(keyHash, payload) }');
@@ -169,7 +171,7 @@ function resolveCacheConfig(raw, ci, projectRoot, cliMode) {
     }
     if (cliMode !== undefined)
         mode = cliMode;
-    if (ci && mode === 'read-write' && store === undefined)
+    if (ci && mode === 'read-write' && !explicit && store === undefined)
         mode = 'read-only';
     return {
         mode,
@@ -238,10 +240,10 @@ function isTraceCacheStore(value) {
         typeof candidate['read'] === 'function' &&
         typeof candidate['write'] === 'function');
 }
-function resolveTargets(raw) {
+function resolveTargets(raw, projectRoot) {
     if (raw.targets === undefined) {
-        throw new ConfigurationError('INVALID_CONFIG', 'targets is required: declare at least one target and the backend that drives it, ' +
-            'e.g. targets: [{ name, platform, backend }]');
+        throw new ConfigurationError('INVALID_CONFIG', 'targets is required: declare at least one target and the engine that drives it, ' +
+            'e.g. targets: [{ name, platform, engine }]');
     }
     if (!Array.isArray(raw.targets) || raw.targets.length === 0) {
         throw new ConfigurationError('INVALID_CONFIG', 'targets must be a non-empty array');
@@ -257,20 +259,21 @@ function resolveTargets(raw) {
         seen.add(target.name);
         for (const key of Object.keys(target)) {
             if (!TARGET_KEYS.has(key)) {
-                throw new ConfigurationError('INVALID_CONFIG', `target "${target.name}" has unknown key "${key}"; a target is { name, platform, backend? }`);
+                throw new ConfigurationError('INVALID_CONFIG', `target "${target.name}" has unknown key "${key}"; a target is { name, platform, engine? }`);
             }
         }
         if (typeof target.platform !== 'string' || target.platform.trim() === '') {
             throw new ConfigurationError('INVALID_CONFIG', `target "${target.name}" requires a non-empty platform`);
         }
-        if (target.backend !== undefined && !isBackendHandle(target.backend)) {
-            throw new ConfigurationError('INVALID_CONFIG', `target "${target.name}" backend must be a defineBackend(...) handle`);
+        if (target.engine !== undefined && !isEngineHandle(target.engine)) {
+            throw new ConfigurationError('INVALID_CONFIG', `target "${target.name}" engine must be a defineEngine(...) handle`);
         }
         return {
             name: target.name,
             index,
             platform: target.platform,
-            backend: target.backend,
+            engine: target.engine,
+            app: resolveTargetApp(target.name, target.engine, projectRoot),
         };
     });
 }
@@ -324,7 +327,7 @@ function resolveCredentials(raw, env) {
 /**
  * SHA-256/JCS digest of resolved config after replacing credential material
  * with `{ secretName }` and env values with `{ envName }` (13-reporting.md).
- * Live objects (backend handles, model instances) are replaced by their stable
+ * Live objects (engine handles, model instances) are replaced by their stable
  * identity before the JSON clone, so they never enter the digest and cannot
  * make it nondeterministic across processes.
  */
@@ -341,11 +344,9 @@ function computeConfigDigest(raw, projectId) {
     // which is exactly what survives the function-stripping JSON clone below.
     // Every model slot is reduced to its identity: a live instance carries
     // provider settings (and possibly credentials) that must never be digested.
-    // `app` is digested with every command env reduced to names.
     const rawAgent = raw.agent;
     const forClone = {
         ...raw,
-        ...(raw.app === undefined ? {} : { app: digestApp(raw.app) }),
         ...(rawAgent === undefined || isStepExecutor(rawAgent)
             ? {}
             : {
@@ -382,17 +383,19 @@ function computeConfigDigest(raw, projectId) {
     }
     if (raw.targets !== undefined) {
         sanitized['targets'] = raw.targets.map((target) => {
-            // A backend handle holds live functions; its digest identity is the
-            // declaration - name, version, contract version, and capability set.
-            if (isBackendHandle(target.backend)) {
-                const { backend, ...rest } = target;
+            // An engine handle holds live functions; its digest identity is the
+            // declaration - name, version, contract version, capability set, and
+            // what it declares about the app under test.
+            if (isEngineHandle(target.engine)) {
+                const { engine, ...rest } = target;
                 return {
                     ...rest,
-                    backend: {
-                        name: backend.name,
-                        ...(backend.version === undefined ? {} : { version: backend.version }),
-                        spiVersion: backend.spiVersion,
-                        capabilities: [...backend.capabilities].toSorted(),
+                    engine: {
+                        name: engine.name,
+                        ...(engine.version === undefined ? {} : { version: engine.version }),
+                        spiVersion: engine.spiVersion,
+                        capabilities: [...engine.capabilities].toSorted(),
+                        app: digestAppDeclaration(engine.app ?? {}),
                     },
                 };
             }