@clone-ai/prompt-prediction 0.7.0-bootstrap.0 → 0.7.0

package/package.json

@@ -1,13 +1,108 @@
 {
   "name": "@clone-ai/prompt-prediction",
-  "version": "0.7.0-bootstrap.0",
-  "description": "Registration for Clone SDK trusted publishing. Install version 0.7.0 when available.",
+  "version": "0.7.0",
+  "description": "Context-aware composer suggestions with optional presentation and explicitly started Clone mode.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "docs",
+    "openapi.json",
+    "release-manifest.json",
+    "scripts/create-example.mjs",
+    "scripts/pilot-metrics.mjs",
+    "playwright.config.ts",
+    "tests/browser",
+    "LICENSE",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "examples/react/*.ts",
+    "examples/react/*.tsx",
+    "examples/react/index.html"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./assistant-ui": {
+      "types": "./dist/assistant-ui.d.ts",
+      "import": "./dist/assistant-ui.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "vitest run",
+    "test:browser": "playwright test",
+    "dev": "vite --config examples/react/vite.config.ts",
+    "generate:types": "openapi-typescript openapi.json -o src/generated/api-types.ts --default-non-nullable false",
+    "check:public": "node scripts/check-public.mjs",
+    "prepack": "npm run build && node scripts/release-manifest.mjs",
+    "test:package": "node scripts/test-package.mjs",
+    "test:scripts": "node --test tests/scripts/*.test.mjs",
+    "check": "pnpm check:public && pnpm build && pnpm typecheck && pnpm test && pnpm test:scripts",
+    "typecheck": "tsc -p tsconfig.test.json"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19",
+    "@assistant-ui/react": "0.15.21"
+  },
+  "peerDependenciesMeta": {
+    "@assistant-ui/react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@assistant-ui/react": "0.15.21",
+    "@playwright/test": "1.60.0",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "@types/node": "24.12.2",
+    "openapi-typescript": "7.13.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "typescript": "5.9.3",
+    "vite": "8.0.16",
+    "vitest": "4.1.11"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cloneisyou/clone-sdk.git"
   },
-  "files": [
-    "README.md"
+  "homepage": "https://github.com/cloneisyou/clone-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/cloneisyou/clone-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@11.19.0",
+  "keywords": [
+    "react",
+    "tab-completion",
+    "composer",
+    "assistant-ui",
+    "clone"
   ]
 }

package/playwright.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig, devices } from '@playwright/test';
+
+const port = Number(process.env.CLONE_SDK_TEST_PORT || 4317);
+if (!Number.isInteger(port) || port < 1024 || port > 65535) throw new Error('Invalid CLONE_SDK_TEST_PORT');
+const baseURL = `http://127.0.0.1:${port}`;
+
+export default defineConfig({
+  testDir: './tests/browser', fullyParallel: true, retries: 0,
+  use: { baseURL, trace: 'retain-on-failure' },
+  projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],
+  webServer: { command: `node node_modules/vite/bin/vite.js --config examples/react/vite.config.ts --host 127.0.0.1 --port ${port} --strictPort`,
+    url: baseURL, reuseExistingServer: false },
+});

package/release-manifest.json

@@ -0,0 +1,63 @@
+{
+  "version": "0.7.0",
+  "channel": "preview",
+  "assistantUiVersion": "0.15.21",
+  "generatedAt": "2026-10-02T08:43:57.345Z",
+  "sha256": {
+    "CHANGELOG.md": "e0a95196a481e881a778dfce172188492fe6a363553dd4081bb823defbb5cbb2",
+    "CONTRIBUTING.md": "ac8b335b3d9f5dc917f07c5276e635aefccc1982bef1e64274723ae65f5e940b",
+    "LICENSE": "bfdbf62032d1909e31ee825343d63df2acb35cf64c6309119979d34214c0210f",
+    "README.md": "9d979e45ae21702e9cff7155a95671cdd157159cc0ae09a71ae653f7bc852b9b",
+    "SECURITY.md": "fae4ea6d845b9cec05706bc50ced1b204d48f4980e9e6d49bbf34e032b795879",
+    "dist/assistant-ui.d.ts": "8a3322d7fb6f26428d18776366c6e7a2593308faeac9c8839eca9852a1aa201b",
+    "dist/assistant-ui.js": "60b32371f1243e8a22432ff263542540960c9840df0bfec7cfb311d3bfaa3166",
+    "dist/clone-mode.d.ts": "60b4b419ab686b45448c92337f974b270a4b3a72aaf207415ed431ba217b83b6",
+    "dist/clone-mode.js": "d17fc8ee77e152ed378a021ce04196c0f8c84fe0dac649194c59fa7348c4352a",
+    "dist/controller.d.ts": "412ad9c0aff86a1d3b80b83a6ab3452ee23f69528aed2d42d79a48832f6e83c6",
+    "dist/controller.js": "b11d5cba5b7301c0bc64c39e60f32ebba2e34660119c6b2395450f7812df2b2b",
+    "dist/deadline.d.ts": "9ae44702a2bdd5bcea20ede7f597e78cae4ae06a427f6c2b91251544b58faff6",
+    "dist/deadline.js": "1fd27ec740e7297eba12e476155242edf3c33fcd080a8667556642ea27a2feec",
+    "dist/feedback.d.ts": "2af2ab51506bea2deba97f14c9d64604cba3dec611b4da7b9df270fc8334a1e4",
+    "dist/feedback.js": "61562c68e212768aefe9ba982485099fb12e6b49c4e0044f561a737bf98123d0",
+    "dist/generated/api-types.d.ts": "963c70a5ba6dfb053ed0cdee23d75f763c4947924f46c5d7a227ca97c4b38237",
+    "dist/generated/api-types.js": "09137b30c7060495057e4acb073e6b8a218422d4bb96161d2b3a775a1030105f",
+    "dist/http.d.ts": "19f6887862ee258701caa20db241d95d9ed65a18d10a33014277b23eaca9cfca",
+    "dist/http.js": "a186e08d05379082b331f84134435a4d3aa2e24595389b4606d73e4fa77d904b",
+    "dist/index.d.ts": "760eda93b69ac06ab89c908030de0fabfa1c2bad2222f162284f0254f756952d",
+    "dist/index.js": "3a009a35e96144a41b8044eb44618c89688883c714030917ff0b0d5b9dcf1e6d",
+    "dist/react.d.ts": "6771b55a9aa2d18d3b99ca0d8c51a0444ea7948474125aa90741807215604e73",
+    "dist/react.js": "19c353953a7ae1969c14791a0725b150022559ce6c0fc5c3c689458019dfc85b",
+    "dist/server.d.ts": "4b87d0d482e1d5ed9d2afcefebcb976dfbb7c4ba79a333d65c8344646ea9dff8",
+    "dist/server.js": "e560f70bd4deef79598a8f3bbab051fc0e014a9023a3ebf8c823898e9f79a4f8",
+    "dist/transport.d.ts": "394b85a80c6490e6e6ca9a5f3be71b811412c8d0044628bcccf19a9521d59344",
+    "dist/transport.js": "f6095752c52cdb01fc1aeb357726b2b2b9ce28415b326df9c47bf0894cd722b9",
+    "dist/types.d.ts": "51b2b5f6ef86410aa1978d1f750b00d1be75db0bc46ca906b993168e2deaf57e",
+    "dist/types.js": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
+    "docs/agent-integration.md": "1dd86850621d9f96039e8e38ccfb184be8d82b247fc0df5df472ccdc747c3f50",
+    "docs/api.md": "49403830c6dd1937d05fa1d4c884376e3d52947fd1918264c5eb080eacde81ee",
+    "docs/billing.md": "ef0ea99efd2e278d8b7406f4748a21972117e5d3f418e19a493cdf2cbdd41083",
+    "docs/browser-onboarding.md": "189c80521e9f6b57387b54ee9b3608fcf02f476bc8c5eeef6eca74385168a97e",
+    "docs/clone-mode.md": "5042be93e57fc18d1e7cf03f073dfbef34052371e6f0e8f38413d33bf0b47da6",
+    "docs/context-mapping.md": "b05401f7eef95155f6bb6484789b073a37863e86d88714e59357b1da3ec6db1b",
+    "docs/data-and-service.md": "76069989449bd32b3eff66f54fcd5ab56e5f5ad02554e412c73848733e8b5068",
+    "docs/developer-apps.md": "2a078fe962894115d3b30cc7c2dc0c999e5217fef3b5c1912b2f5af93072e650",
+    "docs/feedback.md": "d759b2f5ffe0c6ab1e484a6cd908bb5fdf181dc30a0b885338a5b63c80c431e8",
+    "docs/pilot-validation.md": "81b3df159bc8715a9aae581dde740fd5a1b2db47cda55b051e1c72debfb733bf",
+    "docs/releases.md": "4e0f87d2c02739e584177f415eec4cb595ba3882cadfb4cc5266e546bffe1d91",
+    "docs/reliability.md": "1401ad877c2421a2fb60cafc65f8fd16242d7cbcf8d6781a36108cd292a29521",
+    "docs/start.md": "a65fb564f1c191a59b45d2c251930b5cf078748dfcdb20f2b1c434805ffbcefe",
+    "examples/react/composer-events.ts": "1d08d6d39416fd5f65a014f3b66675173c14fb1a88f7cad31e0c70eb5bb5f66e",
+    "examples/react/demo.tsx": "96c846a6a7d4fc822b2ba307c0571834503e0e4479292501ab179c72db43c678",
+    "examples/react/index.html": "63ee7716c011fb67a6c1687b9ede0bc2c551565f369ef0abeb9940ff042a4a68",
+    "examples/react/mode-demo.tsx": "0492e114dfbd36e04e54a07e4a7423e545b1739c9b3b22fce8c9176fa5eb658c",
+    "examples/react/pilot-observations.ts": "22f676c47b259c94f856d53d12a638e35844e8511df95405354785afba75eaed",
+    "examples/react/vite.config.ts": "4ef19a5b7463c308e187286fd8e1a34458edfabd5f7b243ebfe4aed3f08de80a",
+    "openapi.json": "1ebde326a7e6bf3eacd754bc2e40525df72e9afe49f11717db115690d81d1e8c",
+    "playwright.config.ts": "07f5515d7e50464f69f019c811c7b83b0b9e8b597b212a219bab175c1ee1fa5c",
+    "scripts/create-example.mjs": "3c4c45c64b40ccc4ca7efd3197463c7b1887442ea71138c847221946f25aa6d4",
+    "scripts/pilot-metrics.mjs": "c848d44ff477632477f76229cd91d18ed0acdf9faea792e251cb62cc0e281fc8",
+    "tests/browser/clone-mode-options.tsx": "0a4ed85d22b0f081e9ee9a185704f3eb4ed83688b0f69de4d63c0b4ba377f160",
+    "tests/browser/clone-mode.spec.ts": "a9fd2e03628eb16d188f38f74629833993a6f3119d63e84bab7931740d68ea5f",
+    "tests/browser/composer.spec.ts": "28a9f3b9ef01012c97d02433706abf44d8f16e595db2dbd3841679951322949d"
+  }
+}

package/scripts/create-example.mjs

@@ -0,0 +1,31 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const [destination, tarball] = process.argv.slice(2);
+if (!destination || !tarball) throw new Error('Usage: node create-example.mjs /new/empty/directory /sdk.tgz');
+const target = resolve(destination);
+await mkdir(target); // Refuse to overwrite an existing project.
+const files = ['scripts/pilot-metrics.mjs', 'examples/react/demo.tsx', 'examples/react/mode-demo.tsx', 'examples/react/composer-events.ts', 'examples/react/pilot-observations.ts', 'examples/react/index.html', 'examples/react/vite.config.ts', 'playwright.config.ts',
+  'tests/browser/composer.spec.ts', 'tests/browser/clone-mode.spec.ts', 'tests/browser/clone-mode-options.tsx'];
+for (const file of files) {
+  let text = await readFile(resolve(root, file), 'utf8');
+  for (const [from, to] of Object.entries({
+    '../../src/react.js': '@clone-ai/prompt-prediction/react', '../../src/assistant-ui.js': '@clone-ai/prompt-prediction/assistant-ui',
+    '../../src/transport.js': '@clone-ai/prompt-prediction', '../../src/types.js': '@clone-ai/prompt-prediction',
+    '../../src/feedback.js': '@clone-ai/prompt-prediction',
+    '../../src/server.js': '@clone-ai/prompt-prediction/server',
+  })) text = text.replaceAll(from, to);
+  await mkdir(dirname(resolve(target, file)), { recursive: true });
+  await writeFile(resolve(target, file), text);
+}
+await writeFile(resolve(target, 'tsconfig.json'), JSON.stringify({ compilerOptions: {
+  target: 'ES2022', module: 'ESNext', moduleResolution: 'Bundler', jsx: 'react-jsx',
+  strict: true, noEmit: true, skipLibCheck: true, lib: ['DOM', 'ES2022'],
+}, include: ['examples'] }, null, 2));
+await writeFile(resolve(target, 'package.json'), JSON.stringify({ name: 'clone-tab-integration-example', private: true, type: 'module',
+  scripts: { dev: 'vite --config examples/react/vite.config.ts', build: 'tsc && vite build --config examples/react/vite.config.ts', test: 'playwright test' },
+  dependencies: { '@clone-ai/prompt-prediction': 'file:' + resolve(tarball), '@assistant-ui/react': '0.15.21', react: '19.2.4', 'react-dom': '19.2.4' },
+  devDependencies: { vite: '8.0.16', typescript: '5.9.3', '@playwright/test': '1.60.0', '@types/node': '24.12.2', '@types/react': '19.2.14', '@types/react-dom': '19.2.3' },
+}, null, 2));
+console.log('Created independent example at', target);

package/scripts/pilot-metrics.mjs

@@ -0,0 +1,91 @@
+import { appendFile, readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export function summarize(records) {
+  const result = { sources: {}, onboarding: [], support_minutes: null, support_records: 0 };
+  const starts = new Map();
+  for (const row of records) {
+    if (row.kind === 'onboarding_started') starts.set(row.pilot, row.recorded_at);
+    if (row.kind === 'integration_verified' && starts.has(row.pilot)) {
+      result.onboarding.push({ pilot: row.pilot, minutes: (row.recorded_at - starts.get(row.pilot)) / 60_000 });
+      starts.delete(row.pilot);
+    }
+    if (row.kind === 'support' && Number.isFinite(row.minutes) && row.minutes >= 0) {
+      result.support_minutes = (result.support_minutes ?? 0) + row.minutes;
+      result.support_records++;
+    }
+  }
+  for (const source of ['fixture', 'fault', 'live']) {
+    const rows = records.filter(row => row.source === source);
+    if (!rows.length) continue;
+    const metrics = rows.filter(row => row.kind === 'metric');
+    const durations = metrics.map(row => row.duration_ms).filter(Number.isFinite).sort((a, b) => a - b);
+    const quantile = fraction => durations.length ? durations[Math.ceil(durations.length * fraction) - 1] : null;
+    const events = new Map();
+    for (const row of rows) {
+      if (['accepted', 'submitted'].includes(row.kind) && row.delivery === 'recorded' && row.request_id) {
+        const request = events.get(row.request_id) ?? {};
+        // Exact ordered funnel uses client occurrence time. Missing timestamps
+        // and failed deliveries stay outside the measured denominator.
+        if (Number.isFinite(row.observed_at)) request[row.kind] = Math.min(request[row.kind] ?? Infinity, row.observed_at);
+        events.set(row.request_id, request);
+      }
+    }
+    const accepted = [...events.values()].filter(event => Number.isFinite(event.accepted));
+    const submitted = accepted.filter(event => Number.isFinite(event.submitted) && event.submitted >= event.accepted);
+    const decisions = new Map();
+    for (const row of rows) {
+      if (row.event_id && row.delivery === 'recorded' && ['rejected', 'feedback', 'outcome'].includes(row.kind)) {
+        decisions.set(row.event_id, { ...decisions.get(row.event_id), ...row });
+      }
+    }
+    const pilotSessions = new Map();
+    for (const row of rows) {
+      if (row.kind === 'session' && row.pilot && row.session_id) {
+        const sessions = pilotSessions.get(row.pilot) ?? new Set();
+        sessions.add(row.session_id); pilotSessions.set(row.pilot, sessions);
+      }
+    }
+    result.sources[source] = {
+      sessions_observed: new Set(rows.filter(row => row.kind === 'session').map(row => row.session_id).filter(Boolean)).size,
+      pilots_with_repeat_sessions: [...pilotSessions.values()].filter(sessions => sessions.size > 1).length,
+      prediction_attempts_observed: rows.filter(row => row.kind === 'prediction').length,
+      distinct_prediction_requests: new Set(rows.filter(row => row.kind === 'prediction').map(row => row.request_id).filter(Boolean)).size,
+      timed_requests: metrics.length, p50_ms: quantile(0.5), p95_ms: quantile(0.95),
+      failures: metrics.filter(row => row.outcome === 'failed').length,
+      timeouts: metrics.filter(row => row.code === 'prediction_timeout').length,
+      cancellations: metrics.filter(row => row.outcome === 'cancelled').length,
+      accepted_with_timestamps: accepted.length, submitted_after_acceptance: submitted.length,
+      observed_accept_to_submit_rate: accepted.length ? submitted.length / accepted.length : null,
+      failed_event_deliveries: rows.filter(row => row.delivery === 'failed').length,
+      explicit_rejections: [...decisions.values()].filter(row => row.kind === 'rejected').length,
+      explicit_evaluations: [...decisions.values()].filter(row => row.kind === 'feedback').length,
+      host_reported_task_successes: [...decisions.values()].filter(row => row.task_outcome === 'succeeded').length,
+      host_reported_task_failures: [...decisions.values()].filter(row => row.task_outcome === 'failed').length,
+    };
+  }
+  result.coverage = 'Local opt-in observations. Sessions are not returning customers. Missing telemetry is unknown, not rejection. Fixture/fault data is not customer adoption or provider capacity.';
+  return result;
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const [command, file, pilot, value] = process.argv.slice(2);
+  if (!file) throw new Error('Usage: pilot-metrics.mjs report FILE | start/verified/support FILE PILOT [MINUTES]');
+  if (command === 'report') {
+    const rows = (await readFile(file, 'utf8')).trim().split('\n').filter(Boolean).map(line => JSON.parse(line));
+    console.log(JSON.stringify(summarize(rows), null, 2));
+  } else {
+    if (!/^[a-zA-Z0-9_-]{1,64}$/.test(pilot ?? '')) throw new Error('Use a non-personal pilot label');
+    const kind = { start: 'onboarding_started', verified: 'integration_verified', support: 'support' }[command];
+    if (!kind) throw new Error('Unknown observation command');
+    const record = { kind, pilot, recorded_at: Date.now() };
+    if (command === 'support') {
+      const minutes = Number(value);
+      if (!Number.isFinite(minutes) || minutes < 0 || minutes > 10_000) throw new Error('Invalid support minutes');
+      record.minutes = minutes;
+    }
+    await appendFile(file, JSON.stringify(record) + '\n', { mode: 0o600 });
+    console.log('Recorded', kind);
+  }
+}

package/tests/browser/clone-mode-options.tsx

@@ -0,0 +1,38 @@
+import { StrictMode, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { useCloneMode } from '../../src/react.js';
+
+/** Isolated browser regression fixture; host receipts deliberately ignore abort. */
+function OptionsFixture() {
+  const [reviewMs, setReviewMs] = useState(1000);
+  const [requestTimeoutMs, setRequestTimeoutMs] = useState(5000);
+  const [receipts, setReceipts] = useState(0);
+  const settle = useRef<((accepted: boolean) => void) | null>(null);
+  const mode = useCloneMode({
+    reviewMs, requestTimeoutMs,
+    input: { scopeId: 'fixture-user:thread', context: { session_id: 'thread', context_revision: '1', messages: [] },
+      draft: '', enabled: true, busy: false },
+    transport: async request => ({
+      request_id: request.request_id, prediction_id: 'fixture-prediction', session_id: request.session_id,
+      connection_id: request.connection_id ?? null, draft_revision: 0, context_revision: request.context_revision,
+      profile_revision: '', grant_revision: 0, status: 'suggested', completion: 'Shorten the introduction.',
+      expires_at: Date.now() / 1000 + 60, context_truncated: false, usage: { prediction_units: 1 },
+    }),
+    onSubmit: async () => {
+      setReceipts(count => count + 1);
+      return new Promise<boolean>(resolve => { settle.current = resolve; });
+    },
+  });
+  return <section aria-label="Options fixture">
+    <button onClick={() => mode.start()}>Start fixture</button>
+    <button onClick={() => setReviewMs(2000)}>Change reviewMs</button>
+    <button onClick={() => setRequestTimeoutMs(6000)}>Change requestTimeoutMs</button>
+    <button onClick={() => settle.current?.(true)}>Settle host receipt</button>
+    <p data-testid="fixture-status">{mode.state.status}: {mode.state.reason}</p>
+    <p data-testid="fixture-receipts">{receipts}</p>
+  </section>;
+}
+
+const fixture = document.createElement('div');
+document.body.append(fixture);
+createRoot(fixture).render(<StrictMode><OptionsFixture /></StrictMode>);

package/tests/browser/clone-mode.spec.ts

@@ -0,0 +1,68 @@
+import { expect, test } from '@playwright/test';
+import { resolve } from 'node:path';
+
+for (const setting of ['reviewMs', 'requestTimeoutMs']) {
+  test(`changing ${setting} retains the pending host send guard`, async ({ page }) => {
+    await page.goto('/');
+    await page.addScriptTag({ type: 'module', url: `/@fs/${resolve('tests/browser/clone-mode-options.tsx')}` });
+    const fixture = page.getByRole('region', { name: 'Options fixture' });
+    await fixture.getByRole('button', { name: 'Start fixture' }).click();
+    await expect(fixture.getByTestId('fixture-status')).toContainText('submitting');
+    await expect(fixture.getByTestId('fixture-receipts')).toHaveText('1');
+    await fixture.getByRole('button', { name: `Change ${setting}`, exact: true }).click();
+    await expect(fixture.getByTestId('fixture-status')).toHaveText('stopped: settings_changed');
+    await fixture.getByRole('button', { name: 'Start fixture' }).click();
+    await page.waitForTimeout(2100);
+    await expect(fixture.getByTestId('fixture-receipts')).toHaveText('1');
+    await expect(fixture.getByTestId('fixture-status')).toHaveText('stopped: settings_changed');
+    await fixture.getByRole('button', { name: 'Settle host receipt' }).click();
+    await fixture.getByRole('button', { name: 'Start fixture' }).click();
+    await expect(fixture.getByTestId('fixture-receipts')).toHaveText('2');
+  });
+
+  test(`changing ${setting} cancels an unsent preview`, async ({ page }) => {
+    await page.goto('/');
+    await page.addScriptTag({ type: 'module', url: `/@fs/${resolve('tests/browser/clone-mode-options.tsx')}` });
+    const fixture = page.getByRole('region', { name: 'Options fixture' });
+    await fixture.getByRole('button', { name: 'Start fixture' }).click();
+    await expect(fixture.getByTestId('fixture-status')).toContainText('reviewing');
+    await fixture.getByRole('button', { name: `Change ${setting}`, exact: true }).click();
+    await expect(fixture.getByTestId('fixture-status')).toHaveText('stopped: settings_changed');
+    await page.waitForTimeout(2100);
+    await expect(fixture.getByTestId('fixture-receipts')).toHaveText('0');
+  });
+}
+
+test('Clone mode waits for a host completion, and Stop cancels the next preview', async ({ page }) => {
+  await page.goto('/?clone-mode=1');
+  await expect(page.getByRole('status')).toContainText('off');
+  await page.getByRole('button', { name: 'Start Clone mode', exact: true }).click();
+  await expect(page.getByTestId('clone-preview')).toHaveText('이 영상을 30초로 줄이고 핵심 장면부터 보여줘.');
+  await expect(page.getByRole('heading', { name: 'Host send receipts: 0' })).toBeVisible();
+  await expect(page.getByRole('status')).toContainText('waiting', { timeout: 6000 });
+  await expect(page.getByRole('heading', { name: 'Host send receipts: 1' })).toBeVisible();
+  await page.waitForTimeout(3300);
+  await expect(page.getByRole('heading', { name: 'Host send receipts: 1' })).toBeVisible();
+  await page.getByRole('button', { name: 'Complete fixture agent turn' }).click();
+  await expect(page.getByRole('status')).toContainText('reviewing');
+  await page.getByRole('button', { name: 'Stop', exact: true }).click();
+  await expect(page.getByTestId('clone-preview')).toHaveCount(0);
+  await page.waitForTimeout(3300);
+  await expect(page.getByRole('heading', { name: 'Host send receipts: 1' })).toBeVisible();
+});
+
+test('typing cancels automatic sending; a hung prediction never blocks manual send', async ({ page }) => {
+  await page.goto('/?clone-mode=1');
+  await page.getByRole('button', { name: 'Start Clone mode', exact: true }).click();
+  await expect(page.getByRole('status')).toContainText('reviewing');
+  const input = page.getByRole('textbox', { name: 'Instruction' });
+  await input.fill('직접 수정');
+  await expect(page.getByRole('status')).toContainText('user_input');
+  await page.getByLabel('Prediction service').selectOption('pending');
+  await input.fill('서버 장애 중에도 전송');
+  await page.waitForTimeout(1700);
+  await input.press('Enter');
+  await expect(page.getByRole('heading', { name: 'Host send receipts: 1' })).toBeVisible();
+  await expect(page.getByText('human: 서버 장애 중에도 전송')).toBeVisible();
+  await expect(page.getByTestId('clone-preview')).toHaveCount(0);
+});