refactor(evm-wallet-experiment): replace 'interactive' with 'demo' throughout demo stack

Renames: run-interactive-compose.mjs→run-demo-compose.mjs, .env.interactive→.env.demo,
Dockerfile target interactive→demo. Identifier sweep: INTERACTIVE_PACKAGE_ROOT→DEMO_PACKAGE_ROOT,
INTERACTIVE_PAIR_TO_PROFILE→DEMO_PAIR_TO_PROFILE, interactiveDockerComposeArgs→demoDockerComposeArgs,
runInteractiveCompose→runDemoCompose, etc. Env vars: OCAP_INTERACTIVE_PAIR→OCAP_DEMO_PAIR,
DEBUG_OCAP_INTERACTIVE_COMPOSE→DEBUG_OCAP_DEMO_COMPOSE. Docs updated throughout.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: grypez

packages/evm-wallet-experiment/README.md

@@ -712,7 +712,7 @@ yarn workspace @ocap/evm-wallet-experiment build
 yarn workspace @ocap/evm-wallet-experiment lint:fix
 ```
 
-For Docker Compose setup (interactive simulation and E2E tests), see [docs/docker.md](./docs/docker.md). Docker Model Runner with `ai/qwen3.5:4B-UD-Q4_K_XL` is required for the interactive simulation's OpenClaw AI agent.
+For Docker Compose setup (local demo and E2E tests), see [docs/docker.md](./docs/docker.md). Docker Model Runner with `ai/qwen3.5:4B-UD-Q4_K_XL` is required for the local demo's OpenClaw AI agent.
 
 ## Testing
 

packages/evm-wallet-experiment/docker/.env.demo

@@ -0,0 +1,3 @@
+# Used by `yarn docker:demo:up` (--env-file). Switches
+# `kernel-away-bundler-7702` to the `demo` Dockerfile target (OpenClaw).
+KERNEL_AWAY_7702_TARGET=demo

packages/evm-wallet-experiment/docker/.env.interactive

@@ -62,9 +62,9 @@ COPY --from=builder /build /app
 RUN mkdir -p /logs /run/ocap
 
 # ---------------------------------------------------------------------------
-# Target: interactive — kernel + OpenClaw + wallet plugin (used interactively)
+# Target: demo — kernel + OpenClaw + wallet plugin (used in local demo)
 # ---------------------------------------------------------------------------
-FROM kernel AS interactive
+FROM kernel AS demo
 
 # OpenClaw loads local plugins as TypeScript via jiti (no extra TS runner in the image).
 # `package.json` docker:demo:setup starts the gateway via

packages/evm-wallet-experiment/docker/Dockerfile.kernel-base

@@ -30,7 +30,7 @@ Copy the top-level **Digest** (index), then set in `docker-compose.yml`:
 
 Keep the comment above that line in sync with the command you used.
 
-### OpenClaw (interactive image only)
+### OpenClaw (demo image only)
 
 `Dockerfile.kernel-base` installs a **fixed** global CLI version (`openclaw@…`). The gateway loads **`openclaw-plugin/index.ts`** via **jiti**; nothing in the image invokes `tsx`. Bump OpenClaw deliberately when you want new gateway behavior; avoid `@latest` here.
 
@@ -62,16 +62,16 @@ Host-side scripts (e.g. `yarn docker:setup:wallets`) use the workspace **`tsx`**
 
 - **`yarn docker:up`** and **`yarn test:e2e:docker`** expect the full stack, including [**Compose `models`**](https://docs.docker.com/ai/compose/models-and-compose/) on each **`kernel-away-*`** service. That requires **Docker Compose v2.38+** and [**Docker Model Runner**](https://docs.docker.com/ai/model-runner/) enabled.
 - Top-level **`models.llm`** pins **`ai/qwen3.5:4B-UD-Q4_K_XL`** with **`context_size: 32768`** and **`runtime_flags: ['--ctx-size','32768']`** so llama.cpp does not stay at DMR’s 4096 default (OpenClaw + tools need more). Pull if needed: **`docker model pull ai/qwen3.5:4B-UD-Q4_K_XL`**. If requests still hit 4096, run **`docker model configure --context-size 32768 ai/qwen3.5:4B-UD-Q4_K_XL`** on the host and recreate containers.
-- Vitest Docker E2E does **not** call the LLM today, but away containers still receive **`LLM_URL`** / **`LLM_MODEL`** for consistency with interactive OpenClaw and future tests.
+- Vitest Docker E2E does **not** call the LLM today, but away containers still receive **`LLM_URL`** / **`LLM_MODEL`** for consistency with the demo OpenClaw stack and future tests.
 
-## Interactive stack (`docker/.env.interactive` + one pair profile)
+## Demo stack (`docker/.env.demo` + one pair profile)
 
-- **`yarn docker:compose:demo`** runs **`node docker/run-interactive-compose.mjs`**, which passes **`--env-file docker/.env.interactive`** ( **`KERNEL_AWAY_7702_TARGET=interactive`** for the 7702 away image) and **one** **`--profile`** (**`7702`**, **`4337`**, or **`relay`**). Default delegation mode is **`bundler-7702`** → profile **`7702`** (same mode strings as Docker E2E **`DELEGATION_MODE`**).
-- **Choose the pair**: set **`OCAP_INTERACTIVE_PAIR`** to **`bundler-7702`**, **`bundler-hybrid`**, or **`peer-relay`**, or pass **`--pair <value>`** before compose subcommands (after **`yarn … --`** if needed), e.g. **`yarn docker:demo:up -- --pair bundler-hybrid`**.
+- **`yarn docker:compose:demo`** runs **`node docker/run-demo-compose.mjs`**, which passes **`--env-file docker/.env.demo`** ( **`KERNEL_AWAY_7702_TARGET=demo`** for the 7702 away image) and **one** **`--profile`** (**`7702`**, **`4337`**, or **`relay`**). Default delegation mode is **`bundler-7702`** → profile **`7702`** (same mode strings as Docker E2E **`DELEGATION_MODE`**).
+- **Choose the pair**: set **`OCAP_DEMO_PAIR`** to **`bundler-7702`**, **`bundler-hybrid`**, or **`peer-relay`**, or pass **`--pair <value>`** before compose subcommands (after **`yarn … --`** if needed), e.g. **`yarn docker:demo:up -- --pair bundler-hybrid`**.
 - **`yarn docker:demo:setup`** runs wallet setup; OpenClaw **`setup-openclaw.mjs`** + gateway run **only** when the pair is **`bundler-7702`** (the image with OpenClaw). Other pairs skip those steps with a short log line.
 - OpenClaw UI history for 7702 lives under **`$HOME/.openclaw`** on the **`ocap-run`** volume; use **`yarn docker:demo:reset-openclaw`** then **`yarn docker:demo:setup`**, or **`docker compose … down -v`** for a full volume wipe. LLM wiring is **only** in **`docker-compose.yml`** (**`models:`**).
 
-**Raw `docker compose -f docker/docker-compose.yml up`** without **`--profile`** starts **evm** and **bundler** only (no kernels). Prefer **`yarn docker:up`** or the interactive scripts above.
+**Raw `docker compose -f docker/docker-compose.yml up`** without **`--profile`** starts **evm** and **bundler** only (no kernels). Prefer **`yarn docker:up`** or the demo scripts above.
 
 ## `yarn docker:delegate`
 

packages/evm-wallet-experiment/docker/MAINTAINERS.md

@@ -2,10 +2,10 @@
 import { spawnSync } from 'node:child_process';
 
 import {
-  awayServiceForInteractivePair,
-  homeServiceForInteractivePair,
-  interactiveDockerComposeArgs,
-  INTERACTIVE_PACKAGE_ROOT,
+  awayServiceForDemoPair,
+  homeServiceForDemoPair,
+  demoDockerComposeArgs,
+  DEMO_PACKAGE_ROOT,
 } from './demo-compose-lib.mjs';
 
 const [side, ...rest] = process.argv.slice(2);
@@ -15,17 +15,15 @@ if (side !== 'away' && side !== 'home') {
   process.exit(1);
 }
 
-const { pair, dockerArgs } = interactiveDockerComposeArgs(rest);
+const { pair, dockerArgs } = demoDockerComposeArgs(rest);
 const service =
-  side === 'away'
-    ? awayServiceForInteractivePair(pair)
-    : homeServiceForInteractivePair(pair);
+  side === 'away' ? awayServiceForDemoPair(pair) : homeServiceForDemoPair(pair);
 
 const spawned = spawnSync(
   'docker',
   [...dockerArgs, 'exec', '-it', service, 'bash'],
   {
-    cwd: INTERACTIVE_PACKAGE_ROOT,
+    cwd: DEMO_PACKAGE_ROOT,
     stdio: 'inherit',
     env: process.env,
   },

packages/evm-wallet-experiment/docker/attach.mjs

@@ -2,23 +2,23 @@
 import { spawnSync } from 'node:child_process';
 
 import {
-  homeServiceForInteractivePair,
-  interactiveDockerComposeArgs,
-  INTERACTIVE_PACKAGE_ROOT,
+  homeServiceForDemoPair,
+  demoDockerComposeArgs,
+  DEMO_PACKAGE_ROOT,
 } from './demo-compose-lib.mjs';
 
 const SCRIPT_ON_HOST = 'docker/create-delegation.mjs';
 const SCRIPT_IN_CONTAINER =
   '/app/packages/evm-wallet-experiment/docker/create-delegation.mjs';
 
 const argv = process.argv.slice(2);
-const { pair, dockerArgs } = interactiveDockerComposeArgs(argv);
-const home = homeServiceForInteractivePair(pair);
+const { pair, dockerArgs } = demoDockerComposeArgs(argv);
+const home = homeServiceForDemoPair(pair);
 
 const cp = spawnSync(
   'docker',
   [...dockerArgs, 'cp', SCRIPT_ON_HOST, `${home}:${SCRIPT_IN_CONTAINER}`],
-  { cwd: INTERACTIVE_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
+  { cwd: DEMO_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
 );
 if (cp.status !== 0) {
   process.exit(cp.status ?? 1);
@@ -41,6 +41,6 @@ const exec = spawnSync(
     'development',
     SCRIPT_IN_CONTAINER,
   ],
-  { cwd: INTERACTIVE_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
+  { cwd: DEMO_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
 );
 process.exit(exec.status ?? 1);

packages/evm-wallet-experiment/docker/delegate.mjs

@@ -1,31 +1,28 @@
 /* eslint-disable n/no-sync, n/no-process-env, n/no-process-exit, jsdoc/require-jsdoc */
 /**
- * Shared parsing + `docker compose` argv for interactive stack (one home/away pair).
+ * Shared parsing + `docker compose` argv for demo stack (one home/away pair).
  * Keep delegation-mode keys in sync with `test/e2e/docker/helpers/docker-e2e-kernel-services.ts`.
  */
 import { spawnSync } from 'node:child_process';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const dockerLibDir = dirname(fileURLToPath(import.meta.url));
-export const INTERACTIVE_PACKAGE_ROOT = join(dockerLibDir, '..');
+export const DEMO_PACKAGE_ROOT = join(dockerLibDir, '..');
 
-const COMPOSE_FILE = join(
-  INTERACTIVE_PACKAGE_ROOT,
-  'docker/docker-compose.yml',
-);
-const ENV_FILE = join(INTERACTIVE_PACKAGE_ROOT, 'docker/.env.interactive');
+const COMPOSE_FILE = join(DEMO_PACKAGE_ROOT, 'docker/docker-compose.yml');
+const ENV_FILE = join(DEMO_PACKAGE_ROOT, 'docker/.env.demo');
 
 /** @type {Record<string, string>} */
-export const INTERACTIVE_PAIR_TO_PROFILE = {
+export const DEMO_PAIR_TO_PROFILE = {
   'bundler-7702': '7702',
   'bundler-hybrid': '4337',
   'peer-relay': 'relay',
 };
 
-export const DEFAULT_INTERACTIVE_PAIR = 'bundler-7702';
+export const DEFAULT_DEMO_PAIR = 'bundler-7702';
 
-export function awayServiceForInteractivePair(pair) {
+export function awayServiceForDemoPair(pair) {
   if (pair === 'bundler-7702') {
     return 'kernel-away-bundler-7702';
   }
@@ -35,10 +32,10 @@ export function awayServiceForInteractivePair(pair) {
   if (pair === 'peer-relay') {
     return 'kernel-away-peer-relay';
   }
-  throw new Error(`Unknown interactive pair: ${pair}`);
+  throw new Error(`Unknown demo pair: ${pair}`);
 }
 
-export function homeServiceForInteractivePair(pair) {
+export function homeServiceForDemoPair(pair) {
   if (pair === 'bundler-7702') {
     return 'kernel-home-bundler-7702';
   }
@@ -48,29 +45,29 @@ export function homeServiceForInteractivePair(pair) {
   if (pair === 'peer-relay') {
     return 'kernel-home-peer-relay';
   }
-  throw new Error(`Unknown interactive pair: ${pair}`);
+  throw new Error(`Unknown demo pair: ${pair}`);
 }
 
-export function parseInteractiveComposeArgv(argv) {
-  let pair = process.env.OCAP_INTERACTIVE_PAIR ?? DEFAULT_INTERACTIVE_PAIR;
+export function parseDemoComposeArgv(argv) {
+  let pair = process.env.OCAP_DEMO_PAIR ?? DEFAULT_DEMO_PAIR;
   const rest = [...argv];
   const i = rest.indexOf('--pair');
   if (i !== -1 && rest[i + 1]) {
     pair = rest[i + 1];
     rest.splice(i, 2);
   }
-  const profile = INTERACTIVE_PAIR_TO_PROFILE[pair];
+  const profile = DEMO_PAIR_TO_PROFILE[pair];
   if (!profile) {
     console.error(
-      `Unknown pair "${pair}". Use: ${Object.keys(INTERACTIVE_PAIR_TO_PROFILE).join(', ')} (env OCAP_INTERACTIVE_PAIR, or --pair before compose subcommands).`,
+      `Unknown pair "${pair}". Use: ${Object.keys(DEMO_PAIR_TO_PROFILE).join(', ')} (env OCAP_DEMO_PAIR, or --pair before compose subcommands).`,
     );
     process.exit(1);
   }
   return { pair, profile, rest };
 }
 
-export function interactiveDockerComposeArgs(argv) {
-  const { pair, profile, rest } = parseInteractiveComposeArgv(argv);
+export function demoDockerComposeArgs(argv) {
+  const { pair, profile, rest } = parseDemoComposeArgv(argv);
   return {
     pair,
     profile,
@@ -88,15 +85,15 @@ export function interactiveDockerComposeArgs(argv) {
   };
 }
 
-export function runInteractiveCompose(argv) {
-  const { pair, profile, dockerArgs } = interactiveDockerComposeArgs(argv);
-  if (process.env.DEBUG_OCAP_INTERACTIVE_COMPOSE) {
+export function runDemoCompose(argv) {
+  const { pair, profile, dockerArgs } = demoDockerComposeArgs(argv);
+  if (process.env.DEBUG_OCAP_DEMO_COMPOSE) {
     console.error(
-      `[ocap interactive compose] OCAP_INTERACTIVE_PAIR=${pair} profile=${profile}`,
+      `[ocap demo compose] OCAP_DEMO_PAIR=${pair} profile=${profile}`,
     );
   }
   const spawned = spawnSync('docker', dockerArgs, {
-    cwd: INTERACTIVE_PACKAGE_ROOT,
+    cwd: DEMO_PACKAGE_ROOT,
     stdio: 'inherit',
     env: process.env,
   });

packages/evm-wallet-experiment/docker/demo-compose-lib.mjs

@@ -2,13 +2,13 @@
 import { spawnSync } from 'node:child_process';
 
 import {
-  awayServiceForInteractivePair,
-  interactiveDockerComposeArgs,
-  INTERACTIVE_PACKAGE_ROOT,
+  awayServiceForDemoPair,
+  demoDockerComposeArgs,
+  DEMO_PACKAGE_ROOT,
 } from './demo-compose-lib.mjs';
 
 const argv = process.argv.slice(2);
-const { pair, dockerArgs } = interactiveDockerComposeArgs(argv);
+const { pair, dockerArgs } = demoDockerComposeArgs(argv);
 
 if (pair !== 'bundler-7702') {
   console.log(
@@ -17,13 +17,13 @@ if (pair !== 'bundler-7702') {
   process.exit(0);
 }
 
-const away = awayServiceForInteractivePair(pair);
+const away = awayServiceForDemoPair(pair);
 const openclawDir = `/run/ocap/${away}/.openclaw`;
 
 const spawned = spawnSync(
   'docker',
   [...dockerArgs, 'exec', away, 'rm', '-rf', openclawDir],
-  { cwd: INTERACTIVE_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
+  { cwd: DEMO_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
 );
 if (spawned.status !== 0) {
   process.exit(spawned.status ?? 1);

packages/evm-wallet-experiment/docker/demo-reset-openclaw.mjs

@@ -2,31 +2,31 @@
 import { spawnSync } from 'node:child_process';
 
 import {
-  awayServiceForInteractivePair,
-  interactiveDockerComposeArgs,
-  INTERACTIVE_PACKAGE_ROOT,
+  awayServiceForDemoPair,
+  demoDockerComposeArgs,
+  DEMO_PACKAGE_ROOT,
 } from './demo-compose-lib.mjs';
 
 const argv = process.argv.slice(2);
-const { pair, dockerArgs } = interactiveDockerComposeArgs(argv);
+const { pair, dockerArgs } = demoDockerComposeArgs(argv);
 
 const wallets = spawnSync(
   'yarn',
   ['tsx', 'test/e2e/docker/setup-wallets.ts', pair],
   {
-    cwd: INTERACTIVE_PACKAGE_ROOT,
+    cwd: DEMO_PACKAGE_ROOT,
     stdio: 'inherit',
     env: process.env,
   },
 );
 if (wallets.status !== 0) {
   process.exit(wallets.status ?? 1);
 }
-const away = awayServiceForInteractivePair(pair);
+const away = awayServiceForDemoPair(pair);
 
 if (pair !== 'bundler-7702') {
   console.log(
-    'OpenClaw setup skipped (interactive Dockerfile target + OpenClaw run only on kernel-away-bundler-7702).',
+    'OpenClaw setup skipped (demo Dockerfile target + OpenClaw run only on kernel-away-bundler-7702).',
   );
   process.exit(0);
 }
@@ -40,7 +40,7 @@ const setupOpenclaw = spawnSync(
     'node',
     '/app/packages/evm-wallet-experiment/docker/setup-openclaw.mjs',
   ],
-  { cwd: INTERACTIVE_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
+  { cwd: DEMO_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
 );
 if (setupOpenclaw.status !== 0) {
   process.exit(setupOpenclaw.status ?? 1);
@@ -57,12 +57,12 @@ const gateway = spawnSync(
     '/usr/local/lib/node_modules/openclaw/openclaw.mjs',
     'gateway',
   ],
-  { cwd: INTERACTIVE_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
+  { cwd: DEMO_PACKAGE_ROOT, stdio: 'inherit', env: process.env },
 );
 if (gateway.status !== 0) {
   process.exit(gateway.status ?? 1);
 }
 
 console.log(
-  `OpenClaw configured + gateway started (${away}). Shell: OCAP_INTERACTIVE_PAIR=${pair} yarn docker:demo:attach:away`,
+  `OpenClaw configured + gateway started (${away}). Shell: OCAP_DEMO_PAIR=${pair} yarn docker:demo:attach:away`,
 );